Visual Studio 2010 初歩的な質問

質問

Visual Studio 2010 の使い方を学習していますが、
基本的なことがよく分からないので教えてください。

1) Webサイトなどで
　「Windows API の詳細については、プラットフォーム SDK の
　　Windows APIで、Win32 SDK に関する記述を参照してください」
　 というような説明をよく見かけるのですが、
　　( http://msdn.microsoft.com/ja-jp/library/172wfck9(v=vs.100).aspx )
　 Win32 SDK に関する記述はどこにあるのでしょうか。

2) Webサイトなどで
　「Windows API で使用される定数の詳細については、
　　プラットフォーム SDK に組み込まれている Windows.h などの
　　ヘッダー ファイルを参照してください。」
　　というような説明をよく見かけるのですが、
　　( http://msdn.microsoft.com/ja-jp/library/172wfck9(v=vs.100).aspx )
　　C:\Program Files\Microsoft SDKs\Windows\v7.0A\Include
　　フォルダの中にWindows.hファイルはありましたが、
　　Windows.hファイルの中身を見ても、
　　定数の説明などは見当たりませんが
　　どこに定数の詳細が書かれているのでしょうか。

初歩的な質問ですがよろしくお願いします。

回答No.2

Wr5 · ベストアンサー

>このページの左上にはホーム、ライブラリ・・・というタブが並んでいて、
>この下には(左端には)NSDNライブラリの配下の階層のツリーが表示されていますが
>検索用のフォームのようなものは見当たりませんが?

階層ツリーの上に「Bing で MSDN を検索」ってありませんか？

>また、このページはMSDNライブラリの中のページと思いますが
>「Win32 SDK に関する記述」というのは「MSDNライブラリ」のことでしょうか。

概ねそうなるかと思います。
ただし、英語の方になると思いますが。
# 日本語ドキュメントの方はイマイチ信用しきれないので。

http://msdn.microsoft.com/ja-jp/library/172wfck9%28v=vs.100%29.aspx
で掲示されているWindowsAPIだと…VBのコード例にあるMessageBoxでしょうかね。
「Bing で MSDN を検索」のところにMessageBoxと入力して、右のオレンジ色の虫眼鏡を押すと
http://social.msdn.microsoft.com/search/ja-jp?query=MessageBox
のように検索結果が表示されます。
左側の「検索の絞り込み」で「ドキュメントおよび記事」にチェックすると少しは減りますかね…。
# さらに右の方の「英語の検索結果を含む」のチェックは必要に応じて付けてください。
# 日本語のページの説明がヘンだったりした場合にチェックつけて英語のページを見るといいでしょう。

表示されるAPIの情報はC言語用となりますからVBで使う場合にはそれなりに手続きが必要になるかと思います。
# VB使いではないので…この辺りはWeb検索してください。

お礼

>階層ツリーの上に「Bing で MSDN を検索」ってありませんか？

ありました。

実は元々あったのですが、
私の画面では上部のほぼ中央に表示されているのと、
Googleなどの一般のツールバーのように見えていたので
今回の件とは関係ないと思っていました。

MessageBoxを入れて検索ボタンをクリックすると検索結果が表示されて
検索結果のMessageBox関数をクリックすると
目的のMessageBox関数の書式が確認できました。

「Windows API の詳細については、プラットフォーム SDK のWindows APIで、Win32 SDK に関する記述を参照してください」

というのは、こういうことだったのですね。分かりました。

もう1つの

「Windows API で使用される定数の詳細については、
　プラットフォーム SDK に組み込まれている Windows.h などの
　ヘッダー ファイルを参照してください。」

についても、

直接Windows.hを見るのではなく、

上記のように、Microsoftのページ(MSDN オンライン)で検索して
下の方に書かれている
「ヘッダーファイル：Winuser.h 内で宣言、Windows.h をインクルード」
を見て、「Winuser.h」より
C:\Program Files\Microsoft SDKs\Windows\v7.0A\Include\Winuser.h
のファイルをエディタで開いて、MessageBoxで検索して
* MessageBox() Flagの行以下に、
MessageBox関数の引数に使用できる定数の一覧が確認できるというわけですね。

なるほど。理解できました。

ありがとうございました。

回答No.1

Wr5

>Win32 SDK に関する記述はどこにあるのでしょうか。

掲示されたページの左上の方に検索用のフォームがあります。
APIの名前(CreateWindowなど)を入力して検索すれば、APIの解説ページが見つかるでしょう。
# 日本語と英語、両方見つかるかと思いますので両方見ておくといいでしょう。
# 日本語のページは機械翻訳で意味がわかりにくかったり、使用される構造体の解説ページなど関連ページへのリンクが無い場合があります。

>Windows.hファイルの中身を見ても、
>定数の説明などは見当たりませんが
>どこに定数の詳細が書かれているのでしょうか。

Windows.hからさらにインクルードされるファイル…などですね。
場合によってはWindows.hとは別、ということもありますが。
# コモンコントロール使うからCommCtrl.hが必要で、HD_ITEM構造体の定義がそっちに書かれている…とか。

たいていは、使用するAPIの定義が書かれているヘッダファイル内に定数や構造体定義が書かれています。
windef.hやwinuser.hとかだったりもしますが。

API名でWeb検索すると使用例とか書かれているページが見つかることがあります。
定数名とかで使用例が書かれているでしょうから、その定数名でヘッダファイルをgrepします。
見つかった周辺に関連する定数が設定されているでしょう。
# CreateWindowで検索したらWS_CHILDとかが見つかる。
# WS_CHILDでヘッダをgrepするとWinUser.hに定義が見つかる。
# 開いてみると、他にもWS_なんちゃらの定義があることが判る。
具体的に定数名の意味がなんなのか…は定数名でWeb検索するか、
Microsoftのサイト(掲示されたサイト)で定数名で検索すると出てくるでしょう。
# WS_DISABLEDで検索したら http://msdn.microsoft.com/ja-jp/library/vstudio/czada357.aspx ってページが見つかる。って具合に。

まぁ、Web検索するにしても最初はMicrosoftのページ(MSDN オンライン)で検索した方がいいでしょうね。
最初に参照すべき一次情報ってヤツです。(英語の方…ね。)
たいして難しい英語でもないですし、翻訳サイトで翻訳もできるでしょう。
# 翻訳結果が意味不明になることも多々ありますが。
慣れれば単語の拾い読みで推測も可能になるかと。

MSDNの説明でも判らん。とか、APIの使用順とかも知りたいってなるとWeb検索ということに。
ものによっては海外のページしか引っかからない…なんてこともありますけどね。

補足

回答ありがとうございます。

> 掲示されたページの左上の方に検索用のフォームがあります。

「掲示されたページ」というのがどのページなのかが分からないのですが
「掲示されたページ」というのは私が質問の中に記載した
( http://msdn.microsoft.com/ja-jp/library/172wfck9(v=vs.100).aspx )
のページのことでしょうか。
このページの左上にはホーム、ライブラリ・・・というタブが並んでいて、
この下には(左端には)NSDNライブラリの配下の階層のツリーが表示されていますが
検索用のフォームのようなものは見当たりませんが?
また、このページはMSDNライブラリの中のページと思いますが
「Win32 SDK に関する記述」というのは「MSDNライブラリ」のことでしょうか。

よろしくお願いします。