COleConvertDialog 類別

發行項
08/04/2024

如需詳細資訊，請參閱 Windows SDK 中的 OLEUICONVERT 結構。

語法

class COleConvertDialog : public COleDialog

成員

公用建構函式

名稱	描述
COleConvertDialog：：COleConvertDialog	建構 `COleConvertDialog` 物件。

公用方法

名稱	描述
COleConvertDialog：:D oConvert	執行對話框中指定的轉換。
COleConvertDialog：:D oModal	顯示 [OLE 變更專案] 對話框。
COleConvertDialog：：GetClassID	取得與所選項目相關聯的CLSID。
COleConvertDialog：：GetDrawAspect	指定是否要將項目繪製為圖示。
COleConvertDialog：：GetIconicMetafile	取得與這個專案之圖示形式相關聯的元檔句柄。
COleConvertDialog：：GetSelectionType	取得選擇的選取類型。

公用資料成員

名稱	描述
COleConvertDialog：：m_cv	結構，控制對話框的行為。

備註

注意

應用程式精靈產生的容器程式代碼會使用此類別。

如需 OLE 特定對話框的詳細資訊，請參閱 OLE 中的對話框一文。

繼承階層架構

COleConvertDialog

需求

標頭： afxodlgs.h

COleConvertDialog：：COleConvertDialog

只 COleConvertDialog 建構物件。

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

參數

pItem
指向要轉換或啟動的專案。

dwFlags
建立旗標，其中包含使用位或運算子結合的下列任何數目值：

CF_SELECTCONVERTTO 指定呼叫對話框時，一開始會選取 [轉換成] 單選按鈕。這是預設值。
CF_SELECTACTIVATEAS 指定呼叫對話框時，一開始會選取 [啟動身分] 單選按鈕。
CF_SETCONVERTDEFAULT 指定當選取 [轉換成] 單選按鈕時，結構成員m_cv所clsidConvertDefault指定CLSID的類別，將做為類別清單框中的預設選取專案。
CF_SETACTIVATEDEFAULT 指定當選取 [啟動為] 單選按鈕時，結構成員所 clsidActivateDefault 指定CLSID的 m_cv 類別，將做為類別清單框中的預設選取專案。
CF_SHOWHELPBUTTON 指定呼叫對話框時，會顯示 [說明] 按鈕。

pClassID
指向要轉換或啟動之專案的CLSID。如果為 NULL，則會使用與 pItem 相關聯的 CLSID。

pParentWnd
指向對話框物件所屬的父視窗對象或擁有者視窗物件（屬於類型 CWnd）。如果是 NULL，對話框的父視窗會設定為主要應用程式視窗。

備註

若要顯示對話框，請呼叫 DoModal 函式。

如需詳細資訊，請參閱 CLSID 金鑰和 OLEUICONVERT 結構。

COleConvertDialog：:D oConvert

從 DoModal 成功傳回之後呼叫此函式，以轉換或啟動 COleClientItem 類型的物件。

BOOL DoConvert(COleClientItem* pItem);

參數

pItem
指向要轉換或啟動的專案。不可以是 NULL。

傳回值

如果成功則為非零；否則為 0。

備註

項目會根據使用者在 [轉換] 對話框中選取的信息來轉換或啟用。

COleConvertDialog：:D oModal

呼叫此函式以顯示 [OLE 轉換] 對話框。

virtual INT_PTR DoModal();

傳回值

對話框的完成狀態。下列其中一個值：

如果對話框已成功顯示，則為IDOK。
如果使用者取消對話框，IDCANCEL。
如果發生錯誤，則為IDABORT。如果傳回IDABORT，請呼叫 COleDialog：：GetLastError 成員函式，以取得所發生錯誤類型的詳細資訊。如需可能錯誤的清單，請參閱 Windows SDK 中的 OleUIConvert 函式。

備註

如果您要藉由設定 m_cv 結構的成員來初始化各種對話框控制件，您應該先執行此動作，再呼叫 DoModal，但在建構對話框對象之後。

如果 DoModal 傳回 IDOK，您可以呼叫其他成員函式，將使用者輸入的設定或資訊擷取到對話框中。

COleConvertDialog：：GetClassID

呼叫此函式，以取得與 [轉換] 對話框中選取之用戶專案相關聯的 CLSID。

REFCLSID GetClassID() const;

傳回值

與 [轉換] 對話框中選取之專案的 CLSID 相關聯。

備註

只有在 DoModal 傳回 IDOK 之後，才呼叫此函式。

如需詳細資訊，請參閱 Windows SDK 中的 CLSID 金鑰。

COleConvertDialog：：GetDrawAspect

呼叫此函式，以判斷使用者是否選擇將選取的項目顯示為圖示。

DVASPECT GetDrawAspect() const;

傳回值

轉譯物件所需的方法。

DVASPECT_CONTENT如果未核取 [顯示為圖示] 複選框，則會傳回。
勾選此選項，顯示為圖示，則會傳回DVASPECT_ICON 。

備註

只有在 DoModal 傳回 IDOK 之後，才呼叫此函式。

如需繪圖層面的詳細資訊，請參閱 Windows SDK 中的 FORMATETC 數據結構。

COleConvertDialog：：GetIconicMetafile

呼叫此函式，以取得包含所選專案之圖示層面的元檔句柄。

HGLOBAL GetIconicMetafile() const;

傳回值

如果選取 [確定] 關閉對話框時已核取 [顯示為圖示] 複選框，則為包含所選取項目的圖示外觀之元檔句柄;否則為 NULL。

COleConvertDialog：：GetSelectionType

呼叫此函式，以判斷在 [轉換] 對話框中選取的轉換類型。

UINT GetSelectionType() const;

傳回值

所做的選取類型。

備註

傳回型別值是由 Selection 類別中宣告的 COleConvertDialog 列舉型別所指定。

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

這些值的簡短描述如下：

COleConvertDialog::noConversion 如果對話框已取消，或使用者未選取任何轉換，則傳回。如果 COleConvertDialog::DoModal 傳回 IDOK，則使用者可能選取的圖示與先前選取的圖示不同。
COleConvertDialog::convertItem 如果已核取 [轉換為] 單選按鈕，用戶選取了要轉換成的不同專案，並 DoModal 傳回 IDOK。
COleConvertDialog::activateAs 如果核取 [啟動身分] 單選按鈕，用戶選取了要啟動的不同專案，並 DoModal 傳回IDOK。

COleConvertDialog：：m_cv

OLEUICONVERT 類型的結構，用來控制 [轉換] 對話框的行為。

OLEUICONVERT m_cv;

備註

您可以直接或透過成員函式來修改這個結構的成員。