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

要求

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