PropertySheetW

プロパティシートを作成し、指定されたプロパティシートヘッダ構造体で定義されたページを追加する。(Unicode)

PropertySheetW param0

param0 : [var] 

(プラグイン / モジュール : comctl32.dll)

解説

プロパティシートを作成し、指定されたプロパティシートヘッダ構造体で定義されたページを追加する。(Unicode)

[戻り値]
型: INT_PTR モーダルプロパティシートの場合、戻り値は次のとおりである。
（以下省略）

[備考]
拡張エラー情報を取得するには GetLastError を呼び出す。プロパティシートに 100
ページ以上追加しようとすると、この関数は失敗するが、エラー原因は示されない。PropertySheet は -1
を返すが、GetLastError は 0 を返す。メモ: 以降の注意事項は、Aero ウィザードスタイル
(PSH_AEROWIZARD)
を使用しないウィザードおよびウィザードでないプロパティシートにのみ該当する。既定では、PropertySheet
関数はモーダルダイアログボックスを作成する。PROPSHEETHEADER 構造体の dwFlags メンバで PSH_MODELESS
フラグが指定されている場合、PropertySheet
はモードレスダイアログボックスを作成し、作成直後に戻る。この場合、PropertySheet
の戻り値はモードレスダイアログボックスのウィンドウハンドルである。モードレスプロパティシートの場合、メッセージループは
PSM_ISDIALOGMESSAGE
を使用してプロパティシートダイアログボックスにメッセージを渡す必要がある。メッセージループは、ダイアログボックスを破棄するタイミングを判断するために
PSM_GETCURRENTPAGEHWND を使用する必要がある。ユーザーが OK または Cancel
ボタンをクリックすると、PSM_GETCURRENTPAGEHWND は NULL を返す。その後、DestroyWindow
関数を使用してダイアログボックスを破棄できる。
バージョン 5.80。PropertySheet
の戻り値は、モーダルプロパティシートとモードレスプロパティシートで異なる情報を持つ。場合によっては、モードレスプロパティシートがモーダルであった場合に
PropertySheet から受け取るはずだった情報を必要とすることがある。特に、ID_PSREBOOTSYSTEM または
ID_PSRESTARTWINDOWS
が返されたはずかどうかを知る必要があるかもしれない。モードレスプロパティシートは、PSM_GETCURRENTPAGEHWND が
NULL を返すまで待ち、その後 PSM_GETRESULT メッセージを送信することで、モーダルプロパティシートが
PropertySheet から受け取るはずだった値を取得できる。
> [!NOTE] > prsht.h ヘッダは PropertySheet をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に応じて ANSI または Unicode
版を自動的に選択する。エンコーディング中立でないコードと中立エイリアスを混在させると、コンパイルまたは実行時エラーにつながる不整合が生じる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報