COleConvertDialog 類別
如需詳細資訊,請參閱 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;
備註
您可以直接或透過成員函式來修改這個結構的成員。
如需詳細資訊,請參閱 Windows SDK 中的 OLEUICONVERT 結構。
另請參閱
意見反映
https://aka.ms/ContentUserFeedback。
即將推出:我們會在 2024 年淘汰 GitHub 問題,並以全新的意見反應系統取代並作為內容意見反應的渠道。 如需更多資訊,請參閱:提交及檢視以下的意見反映: