OLEUICHANGEICONA 構造体 (oledlg.h)

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

構文

typedef struct tagOLEUICHANGEICONA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  CHAR          szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONA, *POLEUICHANGEICONA, *LPOLEUICHANGEICONA;

メンバー

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が含まれていない限り、このメンバーは無視されます。

注釈

要件