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

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

値	意味
CIF_SHOWHELP	ダイアログ ボックスに [ヘルプ ] ボタンが表示されます。
CIF_SELECTCURRENT	入力時に、初期化時に [現在の ] ラジオ ボタンを選択します。 終了時に、ユーザーが [現在] を選択することを指定します。
CIF_SELECTDEFAULT	入力時に、初期化時に [既定 ] ラジオ ボタンを選択します。 終了時に、ユーザーが [既定] を選択することを指定します。
CIF_SELECTFROMFILE	入力時に、初期化時に [ファイルから ] ラジオ ボタンを選択します。 終了時に、ユーザーが [ファイルから] を選択することを指定します。
CIF_USEICONEXE	入力のみ。 クラスから取得するのではなく、 szIconExe メンバーで指定された実行可能ファイルからアイコンを抽出します。 これは、OLE 以外のファイルへの OLE 埋め込みまたはリンクに役立ちます。

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

注釈

注意

oledlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OLEUICHANGEICON を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 10 ビルド 20348
サポートされている最小のサーバー	Windows 10 ビルド 20348
Header	oledlg.h