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

連結函式的指標，該函式會處理用於對話框的訊息。 攔截函式必須傳回零，才能將它未處理的訊息傳回連結庫中的對話框程式。 攔截函式必須傳回非零值，以防止連結庫的對話框程式處理已經處理的訊息。

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 標頭會將 OLEUICHANGEICON 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 10 組建 20348
最低支援的伺服器	Windows 10 組建 20348
標頭	oledlg.h