OLEUICHANGEICONW 構造体 (oledlg.h)

OLE ユーザー インターフェイス ライブラリが [ アイコンの変更 ] ダイアログ ボックスの初期化に使用する情報と、ダイアログ ボックスが閉じられたときにライブラリが情報を返す領域を含みます。

構文

typedef struct tagOLEUICHANGEICONW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  WCHAR         szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONW, *POLEUICHANGEICONW, *LPOLEUICHANGEICONW;

メンバー

cbStruct

この構造体のサイズ (バイト単位)。 このフィールドは入力時に入力する必要があります。

dwFlags

入力時に、初期化フラグと作成フラグを指定します。 終了時に、ユーザーの選択肢を指定します。 次のフラグを組み合わせて使用できます。

hWndOwner

ダイアログ ボックスを所有するウィンドウ。 このメンバーは NULL にすることはできません。

lpszCaption

ダイアログ ボックスのタイトルとして使用する文字列へのポインター。 NULL の場合、ライブラリは変更アイコンを使用します。

lpfnHook

ダイアログ ボックス用のメッセージを処理するフック関数へのポインター。 フック関数は、処理されなかったというメッセージをライブラリのダイアログ ボックス プロシージャに渡すには、0 を返す必要があります。 フック関数は、ライブラリのダイアログ ボックス プロシージャが既に処理したメッセージを処理できないように、0 以外の値を返す必要があります。

lCustData

ライブラリが lpfnHook メンバーが指すフック関数に渡すアプリケーション定義データ。 ライブラリは、WM_INITDIALOG メッセージの lParam パラメーターで OLEUICHANGEICON 構造体へのポインターを渡します。このポインターを使用して、 lCustData メンバーを取得できます。

hInstance

lpTemplateName メンバーによって指定されたダイアログ ボックス テンプレートを含むインスタンス。

lpszTemplate

ライブラリの [アイコンの変更 ] ダイアログ ボックス テンプレートに置き換えるダイアログ ボックス テンプレートのリソース ファイルの名前を指定する、null で終わる文字列へのポインター。

hResource

カスタマイズされたテンプレート ハンドル。

hMetaPict

現在と最後の画像。 アイコンのソースは、メタファイル自体に埋め込まれています。

clsid

入力のみ。 既定のアイコンを取得するために使用するクラス。

szIconExe[MAX_PATH]

入力のみ。 既定のアイコンを抽出する実行可能ファイルへのポインター。 dwFlags メンバーにCIF_USEICONEXEが含まれ、指定した CLSID からクラス アイコンを取得しようとして失敗しない限り、このメンバーは無視されます。

cchIconExe

入力のみ。 szIconExe の文字数。 dwFlags メンバーにCIF_USEICONEXEが含まれていない限り、このメンバーは無視されます。

注釈

要件