共用方式為

COleChangeIconDialog 類別

  • 發行項

用於 OLE 的 [變更圖示] 對話方塊。

語法

class COleChangeIconDialog : public COleDialog

成員

公用建構函式

名稱 描述
COleChangeIconDialog：：COleChangeIconDialog 建構 COleChangeIconDialog 物件。

公用方法

名稱 描述
COleChangeIconDialog：:D oChangeIcon 執行對話方塊中指定的變更。
COleChangeIconDialog：:D oModal 顯示 [OLE 2 變更圖示] 對話方塊。
COleChangeIconDialog：：GetIconicMetafile 取得與這個專案之圖示形式相關聯的中繼檔控制碼。

公用資料成員

名稱 描述
COleChangeIconDialog：：m_ci 結構，控制對話方塊的行為。

備註

當您要呼叫此對話方塊時，請建立 類別 COleChangeIconDialog 的物件。 COleChangeIconDialog建構 物件之後，您可以使用 m_ci 結構，初始化對話方塊中控制項的值或狀態。 結構 m_ci 的類型為 OLEUICHANGEICON。 如需使用此對話方塊類別的詳細資訊，請參閱 DoModal 成員函式。

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

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

繼承階層架構

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeIconDialog

需求

標頭： afxodlgs.h

COleChangeIconDialog：：COleChangeIconDialog

此函式只會 COleChangeIconDialog 建構 物件。

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

參數

pItem
指向要轉換的專案。

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

  • CIF_SELECTCURRENT 指定呼叫對話方塊時，一開始會選取 [目前] 選項按鈕。 這是預設值。

  • CIF_SELECTDEFAULT 指定呼叫對話方塊時，一開始會選取 [預設] 選項按鈕。

  • CIF_SELECTFROMFILE 指定呼叫對話方塊時，一開始會選取 [從檔案] 選項按鈕。

  • CIF_SHOWHELP 指定呼叫對話方塊時，會顯示 [說明] 按鈕。

  • CIF_USEICONEXE 指定應該從 m_ci 欄位中 指定的 szIconExe 可執行檔擷取圖示，而不是從 類型擷取。 這對於內嵌或連結至非 OLE 檔案很有用。

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

備註

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

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

COleChangeIconDialog：:D oChangeIcon

呼叫此函式，將代表專案之圖示變更為 DoModal 傳回 IDOK 之後 對話方塊中選取的圖示。

BOOL DoChangeIcon(COleClientItem* pItem);

參數

pItem
指向圖示正在變更的專案。

傳回值

如果變更成功，則為非零;否則為 0。

COleChangeIconDialog：:D oModal

呼叫此函式以顯示 [OLE 變更圖示] 對話方塊。

virtual INT_PTR DoModal();

傳回值

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

  • 如果對話方塊已成功顯示，則為 IDOK。

  • 如果使用者取消對話方塊，IDCANCEL。

  • 如果發生錯誤，則為 IDABORT。 如果傳回 IDABORT，請呼叫 COleDialog::GetLastError 成員函式以取得所發生錯誤類型的詳細資訊。 如需可能錯誤的清單，請參閱 Windows SDK 中的 OleUIChangeIcon 函式。

備註

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

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

COleChangeIconDialog：：GetIconicMetafile

呼叫此函式，以取得包含所選項目之圖示層面的中繼檔控制碼。

HGLOBAL GetIconicMetafile() const;

傳回值

如果對話方塊是透過選擇 [確定 ] 關閉對話方塊，則為包含新圖示圖示之圖示層面的中繼檔控制碼，否則為對話方塊顯示前的圖示。

COleChangeIconDialog：：m_ci

OLEUICHANGEICON 類型的結構，用來控制 [變更圖示] 對話方塊的行為。

OLEUICHANGEICON m_ci;

備註

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

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

另請參閱

COleDialog 類別
階層架構圖表
COleDialog 類別