共用方式為

OLEUICONVERTW 結構 (oledlg.h)

  • 發行項

包含 OLE 使用者介面連結庫用來初始化 [轉換 ] 對話框的資訊，以及關閉對話框時連結庫傳回信息的空間。

語法

typedef struct tagOLEUICONVERTW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPWSTR        lpszUserType;
  BOOL          fObjectsIconChanged;
  LPWSTR        lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;

成員

cbStruct

結構的大小，以位元組為單位。 此成員必須填入輸入。

dwFlags

在輸入時，此欄位會指定初始化和建立旗標。 結束時，它會指定用戶的選項。 這可能是下列旗標的組合。

值 意義
CF_SHOWHELPBUTTON
 對話框會顯示 [ 說明 ] 按鈕。 此旗標是在輸入上設定。
CF_SETCONVERTDEFAULT
 CLSID是由 clsidConvertDefault 所指定的類別，將會作為預設選取範圍。 選取 [ 轉換為] 單選按鈕時，此選取專案會出現在類別清單框中。 此旗標是在輸入上設定。
CF_SETACTIVATEDEFAULT
 CLSID是由 clsidActivateDefault 所指定的類別，將會作為預設選取專案。 選取 [ 啟動為 ] 單選按鈕時，此選取專案會出現在類別清單框中。 此旗標是在輸入上設定。
CF_SELECTCONVERTTO
 在輸入時，此旗標會指定在預設行為) (選取 [轉換至 ]。 如果使用者關閉對話框，則會在輸出上設定此旗標。
CF_SELECTACTIVATEAS
 在輸入時，此旗標會指定一開始會選取 [ 啟動身 分]。 如果使用者關閉對話框時已選取 [啟動身 分]，則會在輸出上設定此旗標。
CF_DISABLEDISPLAYASICON
 初始化時將會停用 [ 顯示為圖示 ] 按鈕。
CF_DISABLEACTIVATEAS
 初始化時將會停用 [ 啟用身 分] 單選按鈕。
CF_HIDECHANGEICON
 [ 變更圖示 ] 按鈕將會隱藏在 [ 轉換 ] 對話框中。
CF_CONVERTONLY
 [轉換] 對話框中將會停用 [啟動為] 單選按鈕。

hWndOwner

擁有對話框的視窗。 此成員不應為 NULL。

lpszCaption

要作為對話框標題的字串指標。 如果 為 NULL，則連結庫會使用 Convert。

lpfnHook

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

lCustData

連結庫傳遞給 lpfnHook 成員所指向之攔截函式的應用程式定義數據。 連結庫會在WM_INITDIALOG訊息的 lParam 參數中傳遞 OLEUICONVERT 結構的指標;這個指標可用來擷取 lCustData 成員。

hInstance

實例，其中包含 lpszTemplate 成員所指定的對話框範本。 如果 lpszTemplate 成員為 NULL 或無效，則會忽略這個成員。

lpszTemplate

Null 終止字串的指標，指定要取代連結庫之 [轉換 ] 對話框範本之對話框範本的資源檔名稱。

hResource

自訂對話框的資源句柄。 如果這個成員是 NULL，則連結庫會使用標準 [轉換 ] 對話框範本，如果它是有效的，則連結庫是由 lpszTemplate 成員命名的範本。

clsid

要轉換或啟動之物件的CLSID。 此成員是在輸入上設定的。

clsidConvertDefault

選取 [轉換為 ] 時，要作為默認類別使用的 CLSID。 如果 dwFlags 成員不包含CF_SETCONVERTDEFAULT，則會忽略此成員。 此成員是在輸入上設定的。

clsidActivateDefault

選取 [ 啟用身 分] 時，要使用的 CLSID 作為預設類別。 如果 dwFlags 成員不包含CF_SETACTIVATEDEFAULT，則會忽略這個成員。 此成員是在輸入上設定的。

clsidNew

所選類別的 CLSID。 這個成員是在輸出上設定的。

dvAspect

對象的層面。 這必須是DVASPECT_CONTENT或DVASPECT_ICON。 如果 dvAspect 在輸入時DVASPECT_ICON，則會核取 [ 顯示身分圖示 ] 方塊，並顯示對象的圖示。 此成員是在輸入和輸出上設定。 如需詳細資訊，請參閱 DVASPECT。

wFormat

要轉換或啟動之物件的數據格式。

fIsLinkedObject

如果對象已連結，則為TRUE。 此成員是在輸入上設定的。

hMetaPict

包含圖示層面的 METAFILEPICT 。 此成員是在輸入和輸出上設定。

lpszUserType

要轉換或啟動之物件的使用者類型名稱指標。 如果此值為 NULL，則對話框會從登錄中擷取使用者類型名稱。 此字串會在結束時釋出。

fObjectsIconChanged

如果對象的圖示已變更，則為TRUE。 (也就是說，如果呼叫 OleUIChangeIcon 且未取消。) 。 這個成員是在輸出上設定的。

lpszDefLabel

要用於圖示的默認標籤指標。 如果 為 NULL，則會使用簡短的使用者類型名稱。 如果對像是連結，呼叫端應該傳遞連結來源的顯示名稱。 這會在結束時釋出。

cClsidExclude

lpClsidExclude 中的 CLSID 數目。

lpClsidExclude

要從清單中排除之 CLSID 清單的指標。

備註

注意

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 oledlg.h

另請參閱

OleUIChangeIcon

OleUIConvert