OLEUICHANGEICONW 構造体 (oledlg.h)

[アーティクル]
11/20/2024

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	入力時に、初期化時に Default ラジオボタンを選択します。終了時に、ユーザーが既定の選択したことを指定します。
CIF_SELECTFROMFILE	入力時に、初期化時にファイルからラジオボタンを選択します。終了時に、ユーザーが [ファイルから]を選択指定します。
CIF_USEICONEXE	入力のみ。クラスから取得するのではなく、szIconExe メンバーで指定された実行可能ファイルからアイコンを抽出します。これは、OLE 以外のファイルへの OLE 埋め込みまたはリンクに役立ちます。

hWndOwner

ダイアログボックスを所有するウィンドウ。このメンバーは NULLしないでください。

lpszCaption

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

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

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

hResource

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

hMetaPict

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

clsid

入力のみ。 Default アイコンの取得に使用するクラス。

szIconExe[MAX_PATH]

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

cchIconExe

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

備考

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 10 ビルド 20348
サポートされる最小サーバー	Windows 10 ビルド 20348
ヘッダー	oledlg.h

次の方法で共有

OLEUICHANGEICONW 構造体 (oledlg.h)

構文

メンバーズ

備考

必要条件

フィードバック

その他のリソース