ScreenSaverConfigureDialog 関数 (scrnsave.h)

  • [アーティクル]

スクリーン セーバーの構成ダイアログ ボックスに送信されたメッセージを受信します。 ユーザー構成を許可するスクリーン セーバーは、この関数を定義する必要があります。

構文

BOOL ScreenSaverConfigureDialog(
  HWND   hDlg,
  UINT   message,
  WPARAM wParam,
  LPARAM lParam
);

パラメーター

hDlg

型: HWND

構成ダイアログ ボックスの識別子。

message

型: UINT

スクリーン セーバーの構成ダイアログ ボックスに送信されたメッセージ。

wParam

型: WPARAM

追加のメッセージ固有情報。

lParam

型: LPARAM

追加のメッセージ固有情報。

戻り値

種類: BOOL

関数がメッセージを正常に処理した場合は、 TRUE を返す必要があります。 そうでない場合は、WM_INITDIALOG メッセージへの応答を除き、FALSE を返す必要があります。 WM_INITDIALOG メッセージに応答して、ScreenSaverConfigureDialog は、SetFocus 関数を呼び出して、ダイアログ ボックスのいずれかのコントロールにキーボード フォーカスを設定する場合に FALSE を返す必要があります。 それ以外の場合、関数は TRUE を返す必要があります。この場合、システムは、フォーカスを与えることができるダイアログ ボックスの最初のコントロールにキーボード フォーカスを設定します。

注釈

構成ダイアログ ボックスのダイアログ ボックス テンプレートには 、DLG_SCRNSAVECONFIGURE 識別子が必要です。

ダイアログ ボックス プロシージャは、アプリケーションがダイアログ ボックスの既定のウィンドウ クラス (WC_DIALOG) を指定している場合にのみ使用されます。 ダイアログ ボックス テンプレートに明示的なクラスが指定されていない場合、アプリケーションは既定のクラスを使用します。 ダイアログ ボックス プロシージャはウィンドウ プロシージャに似ていますが、望ましくないメッセージを処理するために DefWindowProc 関数を呼び出してはなりません。 不要なメッセージは、既定のダイアログ ボックス プロシージャによって内部的に処理されます。

ScreenSaverConfigureDialog 関数は、アプリケーションのモジュール定義 (.def) ファイルの EXPORTS ステートメントに含めることでエクスポートする必要があります。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー scrnsave.h
Library Scrnsave.lib
[DLL] なし

関連項目

RegisterDialogClasses