COlePropertiesDialog 類別

發行項
10/12/2023

封裝 Windows 通用 OLE 物件屬性對話方塊。

語法

class COlePropertiesDialog : public COleDialog

成員

公用建構函式

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

公用方法

名稱	描述
COlePropertiesDialog：:D oModal	顯示對話方塊，並允許使用者進行選取。
COlePropertiesDialog：：OnApplyScale	當檔專案調整已變更時，由架構呼叫。

公用資料成員

名稱	描述
COlePropertiesDialog：：m_gp	結構，用來初始化物件的「一般」頁面 `COlePropertiesDialog` 。
COlePropertiesDialog：：m_lp	結構，用來初始化物件的「Link」頁面 `COlePropertiesDialog` 。
COlePropertiesDialog：：m_op	用來初始化 `COlePropertiesDialog` 物件的結構。
COlePropertiesDialog：：m_psh	用來新增其他自訂屬性頁的結構。
COlePropertiesDialog：：m_vp	結構，用來自訂物件的「檢視」頁面 `COlePropertiesDialog` 。

備註

[通用 OLE 物件屬性] 對話方塊提供簡單的方式來顯示和修改 OLE 檔專案的屬性，方式與 Windows 標準一致。這些屬性包括檔專案所代表之檔案的資訊、顯示圖示和影像縮放的選項，以及專案連結的相關資訊（如果專案已連結）。

若要使用 COlePropertiesDialog 物件，請先使用建 COlePropertiesDialog 構函式建立物件。建構對話方塊之後，請呼叫 DoModal 成員函式來顯示對話方塊，並允許使用者修改專案的任何屬性。 DoModal 會傳回使用者是否選取 [確定] 或 [取消] （IDCANCEL）按鈕。除了 [確定] 和 [取消] 按鈕之外，還有 [套用] 按鈕。當使用者選取 [套用] 時，對檔專案屬性所做的任何變更都會套用至專案，而且會自動更新其影像，但會維持使用中狀態。

m_psh 資料成員是結構的指標 PROPSHEETHEADER ，而且在大多數情況下，您不需要明確地存取它。其中一個例外狀況是當您需要超出預設 [一般]、[檢視] 和 [連結] 頁面以外的其他屬性頁時。在此情況下，您可以先修改 m_psh 資料成員以包含自訂頁面，再呼叫 DoModal 成員函式。

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

繼承階層架構

COlePropertiesDialog

需求

標頭： afxodlgs.h

COlePropertiesDialog：：COlePropertiesDialog

建立 COlePropertiesDialog 物件。

COlePropertiesDialog(
    COleClientItem* pItem,
    UINT nScaleMin = 10,
    UINT nScaleMax = 500,
    CWnd* pParentWnd = NULL);

參數

pItem
要存取其屬性的檔專案指標。

nScaleMin
檔專案影像的最小縮放百分比。

nScaleMax
檔專案影像的縮放百分比上限。

pParentWnd
對話方塊的父代或擁有者指標。

備註

從 COlePropertiesDialog 衍生您的通用 OLE 物件屬性對話方塊類別，以實作檔專案的縮放比例。這個類別實例所實作的任何對話方塊都不支援調整檔專案。

根據預設，[通用 OLE 物件屬性] 對話方塊有三個預設頁面：

一般

此頁面包含所選檔專案所表示之檔案的系統資訊。從此頁面，使用者可以將選取的專案轉換成另一種類型。
檢視

此頁面包含顯示專案、變更圖示，以及變更影像縮放比例的選項。
連結

此頁面包含用來變更連結專案位置及更新連結專案的選項。從此頁面，使用者可以中斷所選項目的連結。

若要新增預設所提供以外的頁面，請先修改 m_psh 成員變數，再結束衍生類別的 COlePropertiesDialog 建構函式。這是建構函式的進階實作 COlePropertiesDialog 。

COlePropertiesDialog：:D oModal

呼叫這個成員函式以顯示 [Windows 通用 OLE 物件屬性] 對話方塊，並允許使用者檢視和/或變更檔專案的各種屬性。

virtual INT_PTR DoModal();

傳回值

如果成功，則為 IDOK 或 IDCANCEL;否則為 0。 IDOK 和 IDCANCEL 是常數，指出使用者是否選取 [確定] 或 [取消] 按鈕。

如果傳回 IDCANCEL，您可以呼叫 Windows CommDlgExtendedError 函式來判斷是否發生錯誤。

COlePropertiesDialog：：m_gp

OLEUIGNRLPROPS 類型的結構，用來初始化 [OLE 物件屬性] 對話方塊的 [一般] 頁面。

OLEUIGNRLPROPS m_gp;

備註

此頁面會顯示內嵌的類型和大小，並允許使用者存取 [轉換] 對話方塊。如果物件是連結，此頁面也會顯示連結目的地。

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

COlePropertiesDialog：：m_lp

OLEUILINKPROPS 類型的結構，用來初始化 [OLE 物件屬性] 對話方塊的 [連結] 頁面。

OLEUILINKPROPS m_lp;

備註

此頁面會顯示連結專案的位置，並允許使用者更新或中斷該專案的連結。

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

COlePropertiesDialog：：m_op

OLEUIOBJECTPROPS 類型的結構，用來初始化通用 OLE 物件屬性對話方塊。

OLEUIOBJECTPROPS m_op;

備註

此結構包含用來初始化 [一般]、[連結] 和 [檢視] 頁面的成員。

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

COlePropertiesDialog：：m_psh

PROPSHEETHEADER 類型的結構，其成員會儲存對話物件的特性。

PROPSHEETHEADER m_psh;

備註

建 COlePropertiesDialog 構物件之後，您可以使用 m_psh 來設定對話方塊的各個層面，再呼叫 DoModal 成員函式。

如果您直接修改 m_psh 資料成員，則會覆寫任何預設行為。

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

COlePropertiesDialog：：m_vp

OLEUIVIEWPROPS 類型的結構，用來初始化 [OLE 物件屬性] 對話方塊的 [檢視] 頁面。

OLEUIVIEWPROPS m_vp;

備註

此頁面可讓使用者在物件的「內容」和「圖示」檢視之間切換，並在容器內變更其縮放比例。它也允許使用者在物件顯示為圖示時存取 [變更圖示] 對話方塊。

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

COlePropertiesDialog：：OnApplyScale

當調整值變更且已選取 [確定] 或 [套用] 時，由架構呼叫。

virtual BOOL OnApplyScale(
    COleClientItem* pItem,
    int nCurrentScale,
    BOOL bRelativeToOrig);

參數

pItem
要存取其屬性的檔專案指標。

nCurrentScale
對話方塊小數位數的數值。

bRelativeToOrig
指出縮放是否適用于檔專案的原始大小。

傳回值

如果已處理，則為非零;否則為 0。

備註

預設實作不做任何動作。您必須覆寫此函式，才能啟用縮放控制項。

注意

顯示通用 OLE 物件屬性對話方塊之前，架構會使用 pItem 的 Null 和 nCurrentScale 的 - 1 來呼叫此函式。這樣做是為了判斷是否應該啟用縮放控制項。

另請參閱

MFC 範例 CIRC
COleDialog 類別
 階層架構圖表
 COleDialog 類別
 CPropertyPage 類別

共用方式為