次の方法で共有

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

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

値 意味
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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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