共用方式為

CPropExchange 類別

  • 發行項

支援 OLE 控制項的永續性實作。

語法

class AFX_NOVTABLE CPropExchange

成員

公用方法

名稱 描述
CPropExchange：：ExchangeBlobProp 交換二進位大型物件 （BLOB） 屬性。
CPropExchange：：ExchangeFontProp 交換字型屬性。
CPropExchange：：ExchangePersistentProp 在控制項與檔案之間交換 屬性。
CPropExchange：：ExchangeProp 交換任何內建類型的屬性。
CPropExchange：：ExchangeVersion 交換 OLE 控制項的版本號碼。
CPropExchange：：GetVersion 擷取 OLE 控制項的版本號碼。
CPropExchange：：IsAsynchronous 判斷屬性交換是否以非同步方式完成。
CPropExchange：：IsLoading 指出屬性是載入控制項或從控制項儲存。

備註

CPropExchange 沒有基類。

建立屬性交換的內容和方向。

持續性是控制項狀態資訊的交換，通常是由控制項本身與媒體之間的屬性工作表示。

架構會在收到 OLE 控制項屬性要從中載入或儲存至永續性儲存體的通知時，建構衍生自 CPropExchange 的物件。

架構會將這個 CPropExchange 物件的指標傳遞給控制項的 DoPropExchange 函式。 如果您使用精靈來建立控制項的起始檔案，控制項的 DoPropExchange 函式會呼叫 COleControl::DoPropExchange 。 基類版本會交換控制項的股票屬性：您可以修改衍生類別的版本，以交換已新增至控制項的屬性。

CPropExchange 可用來序列化控制項的屬性，或在載入或建立控制項時初始化控制項的屬性。 的 ExchangeProp 和 ExchangeFontProp 成員函式 CPropExchange 能夠儲存屬性，並從不同的媒體載入屬性。

如需使用 CPropExchange 的詳細資訊，請參閱 MFC ActiveX 控制項：屬性頁 一文 。

繼承階層架構

CPropExchange

需求

標頭： afxctl.h

CPropExchange：：ExchangeBlobProp

序列化儲存二進位大型物件 （BLOB） 資料的屬性。

virtual BOOL ExchangeBlobProp(
    LPCTSTR pszPropName,
    HGLOBAL* phBlob,
    HGLOBAL hBlobDefault = NULL) = 0;

參數

pszPropName
要交換之屬性的名稱。

phBlob
指向屬性儲存位置之變數的指標（變數通常是類別的成員）。

hBlobDefault
屬性的預設值。

傳回值

如果交換成功，則為非零;如果失敗，則為 0。

備註

屬性的值會視需要讀取或寫入 phBlob 所 參考的變數。 如果 指定 hBlobDefault ，則會使用它作為屬性的預設值。 如果基於任何原因，控制項的序列化失敗，就會使用這個值。

函式 CArchivePropExchange::ExchangeBlobProp 、 CResetPropExchange::ExchangeBlobProp 和 CPropsetPropExchange::ExchangeBlobProp 會覆寫這個純虛擬函式。

CPropExchange：：ExchangeFontProp

交換儲存媒體與控制項之間的字型屬性。

virtual BOOL ExchangeFontProp(
    LPCTSTR pszPropName,
    CFontHolder& font,
    const FONTDESC* pFontDesc,
    LPFONTDISP pFontDispAmbient) = 0;

參數

pszPropName
要交換之屬性的名稱。

字體
包含字型屬性的 CFontHolder 物件的參考 。

pFontDesc
當 pFontDispAmbient 為 Null 時 ，FONTDESC 結構的指標 ，包含初始化字型屬性預設狀態的值。

pFontDispAmbient
要用來初始化字型屬性之預設狀態之字型介面的指標 IFontDisp 。

傳回值

如果交換成功，則為非零;如果失敗，則為 0。

備註

如果要將字型屬性從媒體載入控制項，則會從中型擷取字型的特性，並使用 CFontHolder 它們初始化字型所 參考的物件。 如果要儲存字型屬性，字型物件中的特性會寫入媒體。

函式 CArchivePropExchange::ExchangeFontProp 、 CResetPropExchange::ExchangeFontProp 和 CPropsetPropExchange::ExchangeFontProp 會覆寫這個純虛擬函式。

CPropExchange：：ExchangePersistentProp

在 控制項與檔案之間交換 屬性。

virtual BOOL ExchangePersistentProp(
    LPCTSTR pszPropName,
    LPUNKNOWN* ppUnk,
    REFIID iid,
    LPUNKNOWN pUnkDefault) = 0;

參數

pszPropName
要交換之屬性的名稱。

ppUnk
變數的指標，其中包含屬性介面的 IUnknown 指標（這個變數通常是類別的成員）。

Iid
控制項將使用之 屬性上的介面介面識別碼。

pUnkDefault
屬性的預設值。

傳回值

如果交換成功，則為非零;如果失敗，則為 0。

備註

如果屬性是從檔案載入至 控制項，則會從檔案建立並初始化 屬性。 如果正在儲存屬性，則會將其值寫入檔案。

函式 CArchivePropExchange::ExchangePersistentProp 、 CResetPropExchange::ExchangePersistentProp 和 CPropsetPropExchange::ExchangePersistentProp 會覆寫這個純虛擬函式。

CPropExchange：：ExchangeProp

在儲存媒體與 控制項之間交換 屬性。

virtual BOOL ExchangeProp(
    LPCTSTR pszPropName,
    VARTYPE vtProp,
    void* pvProp,
    const void* pvDefault = NULL) = 0 ;

參數

pszPropName
要交換之屬性的名稱。

vtProp
指定所交換之屬性類型的符號。 可能的值包括：

符號 屬性類型
VT_I2 short
VT_I4 long
VT_BOOL BOOL
VT_BSTR CString
VT_CY CY
VT_R4 float
VT_R8 double

pvProp
屬性值的指標。

pvDefault
屬性之預設值的指標。

傳回值

如果交換成功，則為非零;如果失敗，則為 0。

備註

如果屬性是從媒體載入至控制項，則會從中型擷取屬性的值，並儲存在 pvProp 所 指向的物件中。 如果屬性儲存至媒體，pvProp 所 指向的物件值會寫入媒體。

函式 CArchivePropExchange::ExchangeProp 、 CResetPropExchange::ExchangeProp 和 CPropsetPropExchange::ExchangeProp 會覆寫這個純虛擬函式。

CPropExchange：：ExchangeVersion

由架構呼叫以處理版本號碼的持續性。

virtual BOOL ExchangeVersion(
    DWORD& dwVersionLoaded,
    DWORD dwVersionDefault,
    BOOL bConvert);

參數

dwVersionLoaded
要載入之永續性資料的版本號碼將儲存的變數參考。

dwVersionDefault
控制項的目前版本號碼。

bConvert
指出是否要將永續性資料轉換成目前版本，或將它保留在已載入的相同版本。

傳回值

如果函式成功，則為非零;否則為 0。

CPropExchange：：GetVersion

呼叫此函式以擷取控制項的版本號碼。

DWORD GetVersion();

傳回值

控制項的版本號碼。

CPropExchange：：IsAsynchronous

判斷屬性交換是否以非同步方式完成。

BOOL IsAsynchronous();

傳回值

如果以非同步方式交換屬性，則傳回 TRUE，否則傳回 FALSE。

CPropExchange：：IsLoading

呼叫此函式，以判斷屬性是載入控制項還是從控制項儲存。

BOOL IsLoading();

傳回值

如果正在載入屬性，則為非零;否則為 0。

另請參閱

階層架構圖表
COleControl：:D oPropExchange