プロパティ シート

ここでは、プロパティ シートで使用されるプログラミング要素について説明します。

概要

トピック 内容
プロパティ シートの概要 プロパティ シートは、ユーザーがアイテムのプロパティを表示および編集できるウィンドウです。
ウィザードの作成 ウィザードとはプロパティ シートの一種であり、手順をユーザーに解説するための簡単かつ強力な手段です。
プロパティ シートの使用 このセクションでは、プロパティ シートを操作するための実装の詳細とコード例を示します。

関数

トピック 内容
AddPropSheetPageProc プロパティ シート拡張機能がプロパティ シートにページを追加するために使用する、アプリケーション定義のコールバック関数を指定します。
CreatePropertySheetPage プロパティ シートの新しいページを作成します。
DestroyPropertySheetPage プロパティ シート ページを破棄します。 アプリケーションは、PropertySheet 関数に渡されていないページに対してこの関数を呼び出す必要があります。
PropertySheet プロパティ シートを作成し、指定したプロパティ シート ヘッダー構造体で定義されているページを追加します。
PropSheetPageProc ページの作成時および破棄されようとしている際に、プロパティ シートが呼び出すアプリケーション定義のコールバック関数を指定します。 アプリケーションはこの関数を使用して、ページの初期化操作とクリーンアップ操作を実行できます。
PropSheetProc プロパティ シートの作成と初期化時にシステムが呼び出すアプリケーション定義のコールバック関数。

[メッセージ]

トピック 内容
PSM_ADDPAGE 既存のプロパティ シートの末尾に新しいページを追加します。 このメッセージを明示的に送信するか、PropSheet_AddPage マクロを使用します。
PSM_APPLY [適用] ボタンの選択をシミュレートし、1 つ以上のページが変更され、変更を検証して記録する必要があることを示します。
PSM_CANCELTOCLOSE キャンセルできない最新の PSN_APPLY 通知以降に変更が実行されたときに、アプリケーションが送信します。 このメッセージを明示的に送信するか、PropSheet_CancelToClose マクロを使用します。
PSM_CHANGED ページ内の情報が変更されたことをプロパティ シートに通知します。 このメッセージを明示的に送信するか、PropSheet_Changed マクロを使用します。
PSM_ENABLEWIZBUTTONS Aero ウィザードの標準ボタンを有効または無効にします。 このメッセージを明示的に送信するか、PropSheet_EnableWizButtons マクロを使用します。
PSM_GETCURRENTPAGEHWND プロパティ シートの現在のページのウィンドウへのハンドルを取得します。 このメッセージを明示的に送信するか、PropSheet_GetCurrentPageHwnd マクロを使用します。
PSM_GETRESULT PropertySheet によってモーダル プロパティ シートに返される情報を取得するために、モードレス プロパティ シートが使用します。 このメッセージを明示的に送信するか、PropSheet_GetResult マクロを使用します。
PSM_GETTABCONTROL プロパティ シートのタブ コントロールへのハンドルを取得します。 このメッセージを明示的に送信するか、PropSheet_GetTabControl マクロを使用します。
PSM_HWNDTOINDEX プロパティ シート ページのウィンドウ ハンドルを取得し、その 0 から始まるインデックスを返します。 このメッセージを明示的に送信するか、PropSheet_HwndToIndex マクロを使用します。
PSM_IDTOINDEX プロパティ シート ページのリソース ID を取得し、その 0 から始まるインデックスを返します。 このメッセージを明示的に送信するか、PropSheet_IdToIndex マクロを使用します。
PSM_INDEXTOHWND プロパティ シート ページのインデックスを取得し、そのウィンドウ ハンドルを返します。 このメッセージを明示的に送信するか、PropSheet_IndexToHwnd マクロを使用します。
PSM_INDEXTOID プロパティ シート ページのインデックスを取得し、そのリソース ID を返します。 このメッセージを明示的に送信するか、PropSheet_IndexToId マクロを使用します。
PSM_INDEXTOPAGE プロパティ シート ページのインデックスを取得し、その HPROPSHEETPAGE ハンドルを返します。 このメッセージを明示的に送信するか、PropSheet_IndexToPage マクロを使用します。
PSM_INSERTPAGE 既存のプロパティ シートに新しいページを挿入します。 ページは、指定したインデックスまたは指定したページの後に挿入できます。 このメッセージを明示的に送信するか、PropSheet_InsertPage マクロを使用します。
PSM_ISDIALOGMESSAGE プロパティ シートのダイアログ ボックスにメッセージを渡し、ダイアログ ボックスがメッセージを処理したかどうかを示します。 このメッセージを明示的に送信するか、PropSheet_IsDialogMessage マクロを使用します。
PSM_PAGETOINDEX プロパティ シート ページの HPROPSHEETPAGE ハンドルを取得し、その 0 から始まるインデックスを返します。 このメッセージを明示的に送信するか、PropSheet_PageToIndex マクロを使用します。
PSM_PRESSBUTTON [プロパティ シート] ボタンの選択をシミュレートします。 このメッセージを明示的に送信するか、PropSheet_PressButton マクロを使用します。
PSM_QUERYSIBLINGS プロパティ シートに送信され、メッセージが各ページに転送されます。 このメッセージを明示的に送信するか、PropSheet_QuerySiblings マクロを使用します。
PSM_REBOOTSYSTEM 変更を有効にするには、システムを再起動する必要があることを示します。 PSM_REBOOTSYSTEM メッセージを明示的に送信することも、PropSheet_RebootSystem PropSheet_RebootSystem を使用して送信することもできます。
PSM_RECALCPAGESIZES ページが追加または削除された後、標準またはウィザードのプロパティ シートのページ サイズを再計算します。 このメッセージを明示的に送信するか、PropSheet_RecalcPageSizes マクロを使用します。
PSM_REMOVEPAGE プロパティ シートからページを削除します。 このメッセージを明示的に送信するか、PropSheet_RemovePage マクロを使用します。
PSM_RESTARTWINDOWS 変更を有効にするには、Windows を再起動する必要があることを示します。
PSM_SETBUTTONTEXT Aero ウィザードのボタンのテキストを設定します。 このメッセージを明示的に送信するか、PropSheet_SetButtonText マクロを使用します。
PSM_SETCURSEL プロパティ シート内の指定したページをアクティブにします。 このメッセージは、明示的に送信することも、PropSheet_SetCurSel マクロを使用して送信することもできます。
PSM_SETCURSELID ページのリソース識別子に基づいて、プロパティ シート内の特定のページをアクティブにします。 このメッセージは、明示的に送信することも、PropSheet_SetCurSelByID マクロを使用して送信することもできます。
PSM_SETFINISHTEXT ウィザードの [完了] ボタンのテキストを設定し、ボタンの表示と有効化を行い、[次へ] ボタンと [戻る] ボタンを非表示にします。 このメッセージは、明示的に送信することも、PropSheet_SetFinishText マクロを使用して送信することもできます。
PSM_SETHEADERBITMAP このメッセージは実装されていません。
PSM_SETHEADERBITMAPRESOURCE このメッセージは実装されていません。
PSM_SETHEADERSUBTITLE ウィザードの内部ページのヘッダーのサブタイトル テキストを設定します。 このメッセージを明示的に送信するか、PropSheet_SetHeaderSubTitle マクロを使用します。
PSM_SETHEADERTITLE ウィザードの内部ページのヘッダーのタイトル テキストを設定します。 このメッセージを明示的に送信するか、PropSheet_SetHeaderTitle マクロを使用します。
PSM_SETNEXTTEXT ウィザードの [次へ] ボタンのテキストを設定します。 このメッセージは、明示的に送信することも、PropSheet_SetNextText マクロを使用して送信することもできます。
PSM_SETTITLE プロパティ シートのタイトルを設定します。 このメッセージは、明示的に送信することも、PropSheet_SetTitle マクロを使用して送信することもできます。
PSM_SETWIZBUTTONS ウィザードの [戻る][次へ][完了] ボタンを有効または無効にします。 PropSheet_SetWizButtons マクロを使用してメッセージを投稿することもできます。
PSM_SHOWWIZBUTTONS ウィザードのボタンを表示または非表示にします。 このメッセージは、明示的に送信することも、PropSheet_ShowWizButtons マクロを使用して送信することもできます。
PSM_UNCHANGED ページ内の情報が以前に保存された状態に戻されたことをプロパティ シートに通知します。 このメッセージを明示的に送信するか、PropSheet_UnChanged マクロを使用します。

通知

トピック 内容
PSN_APPLY ユーザーが [OK]、[閉じる]、または [適用] ボタンをクリックし、すべての変更を有効にすることを示すために、プロパティ シートのすべてのページに送信されます。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_GETOBJECT カーソルがタブ コントロールのボタンの 1 つを通過したときにドロップ ターゲット オブジェクトを要求するためにプロパティ シートが送信します。
PSN_HELP ユーザーが [ヘルプ] ボタンをクリックしたことをページに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_KILLACTIVE 別のページがアクティブ化されているか、ユーザーが [OK] ボタンをクリックしたために、アクティブ化が失われようとしていることをページに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_QUERYCANCEL ユーザーがプロパティ シートを取り消したことを示します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_QUERYINITIALFOCUS プロパティ シート ページに、最初のフォーカスを受け取るダイアログ ボックス コントロールを指定する機会を提供するために、プロパティ シートが送信します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_RESET プロパティ シートが破棄されようとしていることをページに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_SETACTIVE アクティブ化しようとしていることをページに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_TRANSLATEACCELERATOR キーボード メッセージが受信されたことをプロパティ シートに通知します。 このページでは、プライベート キーボード アクセラレータの翻訳を行う機会を提供します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_WIZBACK ユーザーがウィザードの [戻る] ボタンをクリックしたことをページに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_WIZFINISH ユーザーがウィザードの [完了] ボタンをクリックしたことをページに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
PSN_WIZNEXT ユーザーがウィザードの [次へ] ボタンをクリックしたことをページに通知します。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。

構造体

トピック 内容
PROPSHEETHEADER プロパティ シートのフレームとページを定義します。
PROPSHEETPAGE プロパティ シート内のページを定義します。
PSHNOTIFY プロパティ シートの通知コードの情報が含まれています。