COleConvertDialog 類別

發行項
10/12/2023

如需詳細資訊，請參閱 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_SELECTACTI加值稅EAS 指定呼叫對話方塊時，一開始會選取 [啟動身分] 選項按鈕。
CF_SETCONVERTDEFAULT 指定當選取 [轉換成] 選項按鈕時，結構成員 m_cv 所 clsidConvertDefault 指定 CLSID 的類別，將做為類別清單方塊中的預設選取專案。
CF_SETACTI加值稅EDEFAULT 指定當選取 [啟動為] 選項按鈕時，結構成員所 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;

備註

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