Freigeben über


Persistenz der OLE-Steuerelemente

Eine Funktion von OLE-Steuerelementen ist die Eigenschaftspersistenz (oder Serialisierung), mit der das OLE-Steuerelement Eigenschaftswerte in und aus einer Datei oder einem Datenstrom lesen oder schreiben kann. Eine Containeranwendung kann die Serialisierung verwenden, um die Eigenschaftswerte eines Steuerelements zu speichern, auch nachdem die Anwendung das Steuerelement zerstört hat. Die Eigenschaftswerte des OLE-Steuerelements können dann aus der Datei oder dem Datenstrom gelesen werden, wenn eine neue Instanz des Steuerelements zu einem späteren Zeitpunkt erstellt wird.

Persistenz der OLE-Steuerelemente

Name Beschreibung
PX_Blob Austauscht eine Steuerelementeigenschaft, die BLOB-Daten (Binary Large Object) speichert.
PX_Bool Austauscht eine Steuerelementeigenschaft vom Typ BOOL.
PX_Color Wechselt eine Farbeigenschaft eines Steuerelements.
PX_Currency Austauscht eine Steuerelementeigenschaft vom Typ CY.
PX_DataPath Austauscht eine Steuerelementeigenschaft vom Typ CDataPathProperty.
PX_Double Austauscht eine Steuerelementeigenschaft vom Typ double.
PX_Font Tauscht eine Schriftarteigenschaft eines Steuerelements aus.
PX_Float Austauscht eine Steuerelementeigenschaft vom Typ float.
PX_IUnknown Austauscht eine Steuerelementeigenschaft des nicht definierten Typs.
PX_Long Austauscht eine Steuerelementeigenschaft vom Typ long.
PX_Picture Austausch einer Bildeigenschaft eines Steuerelements.
PX_Short Austauscht eine Steuerelementeigenschaft vom Typ short.
PX_ULong Austauscht eine Steuerelementeigenschaft vom Typ ULONG.
PX_UShort Austauscht eine Steuerelementeigenschaft vom Typ USHORT.
PXstring Austausch einer Zeichenfolgen-Steuerelementeigenschaft.
PX_VBXFontConvert Tauscht die schriftartbezogenen Eigenschaften eines VBX-Steuerelements in eine OLE-Steuerelementschriftarteigenschaft um.

Darüber hinaus wird die AfxOleTypeMatchGuid globale Funktion bereitgestellt, um eine Übereinstimmung zwischen einem TYPEDESC und einer bestimmten GUID zu testen.

PX_Blob

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft zu serialisieren oder zu initialisieren, die BLOB-Daten (Binary Large Object) speichert.

BOOL PX_Blob(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    HGLOBAL& hBlob,
    HGLOBAL hBlobDefault = NULL);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

hBlob
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

hBlobDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf aus der Variablen gelesen oder in die Variable geschrieben, auf die von hBlob verwiesen wird. Diese Variable sollte vor dem ersten Aufruf PX_Blob auf NULL initialisiert werden (in der Regel kann dies im Konstruktor des Steuerelements erfolgen). Wenn hBlobDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn der Initialisierungs- oder Serialisierungsprozess des Steuerelements aus irgendeinem Grund fehlschlägt.

Die Handles hBlob und hBlobDefault verweisen auf einen Speicherblock, der Folgendes enthält:

  • Ein DWORD, das die Länge der folgenden Binärdaten in Byte enthält, gefolgt von

  • Ein Speicherblock, der die tatsächlichen Binärdaten enthält.

Beachten Sie, dass PX_Blob beim Laden von BLOB-Typeigenschaften Arbeitsspeicher mithilfe der GlobalAlloc-API von Windows zugewiesen wird. Sie sind dafür verantwortlich, diesen Speicher freizugeben. Daher sollte der Destruktor Ihres Steuerelements GlobalFree für alle BLOB-Eigenschaftshandles aufrufen, um alle Speicher freizugeben, die Ihrem Steuerelement zugeordnet sind.

PX_Bool

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ BOOL zu serialisieren oder zu initialisieren.

BOOL PX_Bool(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    BOOL& bValue);

BOOL PX_Bool(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    BOOL& bValue,
    BOOL bDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

bValue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

bDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf aus der Variablen gelesen oder in die Variable geschrieben, auf die von bValue verwiesen wird. Wenn bDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_Color

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ OLE_COLOR zu serialisieren oder zu initialisieren.

BOOL PX_Color(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    OLE_COLOR& clrValue);

BOOL PX_Color(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    OLE_COLOR& clrValue,
    OLE_COLOR clrDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

clrValue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

clrDefault
Standardwert für die Eigenschaft, wie vom Steuerelemententwickler definiert.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf aus der Variablen gelesen oder in die Variable geschrieben, auf die von clrValue verwiesen wird. Wenn clrDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_Currency

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ "Währung" zu serialisieren oder zu initialisieren.

BOOL PX_Currency(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    CY& cyValue);

BOOL PX_Currency(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    CY& cyValue,
    CY cyDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

cyValue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

cyDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf von cyValue gelesen oder in die Variable geschrieben, auf die von cyValue verwiesen wird. Wenn cyDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_DataPath

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Datenpfadeigenschaft vom Typ CDataPathProperty zu serialisieren oder zu initialisieren.

BOOL PX_DataPath(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    CDataPathProperty& dataPathProperty);

BOOL PX_DataPath(
    CPropExchange* pPX,
    CDataPathProperty& dataPathProperty);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

dataPathProperty
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Datenpfadeigenschaften implementieren asynchrone Steuerelementeigenschaften. Der Wert der Eigenschaft wird nach Bedarf aus der Variablen gelesen oder in die Variable geschrieben, auf die von dataPathProperty verwiesen wird.

PX_Double

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ doublezu serialisieren oder zu initialisieren.

BOOL PX_Double(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    double& doubleValue);

BOOL PX_Double(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    double& doubleValue,
    double doubleDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

doubleValue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

doubleDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf ausgelesen oder in die Variable geschrieben, auf die von doubleValue verwiesen wird. Wenn doubleDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_Font

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ "Schriftart" zu serialisieren oder zu initialisieren.

BOOL PX_Font(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    CFontHolder& font,
    const FONTDESC FAR* pFontDesc = NULL,
    LPFONTDISP pFontDispAmbient = NULL);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

Schriftart
Ein Verweis auf ein CFontHolder Objekt, das die Schriftarteigenschaft enthält.

pFontDesc
Ein Zeiger auf eine FONTDESC Struktur, die die Werte enthält, die beim Initialisieren des Standardzustands der Schriftarteigenschaft verwendet werden sollen, falls pFontDispAmbient NULL ist.

pFontDispAmbient
Ein Zeiger auf die IFontDisp Schnittstelle einer Schriftart, die beim Initialisieren des Standardzustands der Schriftarteigenschaft verwendet werden soll.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird bei Bedarf aus einem Verweis gelesen oder in fontdiese CFontHolder geschrieben. Wenn pFontDesc und pFontDispAmbient angegeben werden, werden sie bei Bedarf zum Initialisieren des Standardwerts der Eigenschaft verwendet. Diese Werte werden verwendet, wenn der Serialisierungsprozess des Steuerelements aus irgendeinem Grund fehlschlägt. In der Regel übergeben Sie NULL für pFontDesc und den Umgebungswert, der für pFontDispAmbient zurückgegeben wirdCOleControl::AmbientFont. Beachten Sie, dass das von einem Aufruf der IFontDisp::Release Memberfunktion zurückgegebene COleControl::AmbientFont Schriftartobjekt freigegeben werden muss.

PX_Float

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ floatzu serialisieren oder zu initialisieren.

BOOL PX_Float(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    float& floatValue);

BOOL PX_Float(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    float& floatValue,
    float floatDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

floatValue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

floatDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf aus der Variablen gelesen oder in die Variable geschrieben, auf die von floatValue verwiesen wird. Wenn floatDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_IUnknown

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft zu serialisieren oder zu initialisieren, die durch ein Objekt mit einer IUnknownabgeleiteten Schnittstelle dargestellt wird.

BOOL PX_IUnknown(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    LPUNKNOWN& pUnk,
    REFIID iid,
    LPUNKNOWN pUnkDefault = NULL);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

Punk
Verweis auf eine Variable, die die Schnittstelle des Objekts enthält, das den Wert der Eigenschaft darstellt.

iid
Eine Schnittstellen-ID, die angibt, welche Schnittstelle des Eigenschaftsobjekts vom Steuerelement verwendet wird.

pUnkDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf ausgelesen oder in die Variable geschrieben, auf die von pUnk verwiesen wird. Wenn pUnkDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_Long

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ longzu serialisieren oder zu initialisieren.

BOOL PX_Long(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    long& lValue);

BOOL PX_Long(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    long& lValue,
    long lDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

Lvalue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

lDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf aus der Variablen gelesen oder in die Variable geschrieben, auf die von lValue verwiesen wird. Wenn lDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_Picture

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements auf, um eine Bildeigenschaft ihres Steuerelements DoPropExchange zu serialisieren oder zu initialisieren.

BOOL PX_Picture(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    CPictureHolder& pict);

BOOL PX_Picture(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    CPictureHolder& pict,
    CPictureHolder& pictDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

Pict
Verweis auf ein CPictureHolder -Objekt, in dem die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

pictDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf aus der Variablen gelesen oder in die Variable geschrieben, auf die von Pict verwiesen wird. Wenn pictDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_Short

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ shortzu serialisieren oder zu initialisieren.

BOOL PX_Short(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    short& sValue);

BOOL PX_Short(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    short& sValue,
    short sDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

sValue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

sDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf aus der Variablen gelesen oder in die Variable geschrieben, auf die von sValue verwiesen wird. Wenn sDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_ULong

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ ULONG zu serialisieren oder zu initialisieren.

BOOL PX_ULong(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    ULONG& ulValue);

BOOL PX_ULong(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    ULONG& ulValue,
    long ulDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Name des ausgetauschten Eigentums.

ulValue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

ulDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf ausgelesen oder in die Variable geschrieben, auf die von ulValue verwiesen wird. Wenn ulDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_UShort

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Eigenschaft vom Typ unsigned shortzu serialisieren oder zu initialisieren.

BOOL PX_UShort(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    USHORT& usValue);

BOOL PX_UShort(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    USHORT& usValue,
    USHORT usDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Name des ausgetauschten Eigentums.

usValue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

usDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf ausgelesen oder in die Variable geschrieben, auf die von usValue verwiesen wird. Wenn usDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PXstring

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Zeichenfolgeneigenschaft zu serialisieren oder zu initialisieren.

BOOL PXstring(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    CString& strValue);

BOOL PXstring(
    CPropExchange* pPX,
    LPCTSTR pszPropName,
    CString& strValue,
    CString strDefault);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

pszPropName
Der Name des ausgetauschten Eigentums.

strValue
Verweis auf die Variable, in der die Eigenschaft gespeichert ist (in der Regel eine Membervariable Der Klasse).

strDefault
Standardwert für die Eigenschaft.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Der Wert der Eigenschaft wird nach Bedarf ausgelesen oder in die Variable geschrieben, auf die von strValue verwiesen wird. Wenn strDefault angegeben wird, wird sie als Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn aus irgendeinem Grund der Serialisierungsprozess des Steuerelements fehlschlägt.

PX_VBXFontConvert

Rufen Sie diese Funktion in der Memberfunktion Ihres Steuerelements DoPropExchange auf, um eine Schriftarteigenschaft zu initialisieren, indem Sie die schriftartbezogenen Eigenschaften eines VBX-Steuerelements konvertieren.

BOOL PX_VBXFontConvert(
    CPropExchange* pPX,
    CFontHolder& font);

Parameter

pPX
Zeiger auf das CPropExchange-Objekt (in der Regel als Parameter übergeben anDoPropExchange).

Schriftart
Die Schriftarteigenschaft des OLE-Steuerelements, das die konvertierten VBX-Schriftarteigenschaften enthält.

Rückgabewert

Nonzero, wenn der Austausch erfolgreich war; 0, wenn dies nicht erfolgreich ist.

Hinweise

Diese Funktion sollte nur von einem OLE-Steuerelement verwendet werden, das als direkter Ersatz für ein VBX-Steuerelement konzipiert ist. Wenn die Visual Basic-Entwicklungsumgebung ein Formular mit einem VBX-Steuerelement konvertiert, um das entsprechende Ersatz-OLE-Steuerelement zu verwenden, ruft sie die Funktion des IDataObject::SetData Steuerelements auf, und übergibt einen Eigenschaftensatz, der die Eigenschaftendaten des VBX-Steuerelements enthält. Dieser Vorgang wiederum bewirkt, dass die Funktion des Steuerelements DoPropExchange aufgerufen wird. DoPropExchange kann aufrufen PX_VBXFontConvert , um die schriftartbezogenen Eigenschaften des VBX-Steuerelements (z. B. "FontName", "FontSize" usw.) in die entsprechenden Komponenten der Schriftarteigenschaft des OLE-Steuerelements zu konvertieren.

PX_VBXFontConvert sollte nur aufgerufen werden, wenn das Steuerelement tatsächlich aus einer VBX-Formularanwendung konvertiert wird. Zum Beispiel:

void CMFCActiveXControlCtrl::DoPropExchange(CPropExchange* pPX)
{
   ExchangeVersion(pPX, MAKELONG(_wVerMinor, _wVerMajor));
   COleControl::DoPropExchange(pPX);

   if (IsConvertingVBX())
      PX_VBXFontConvert(pPX, InternalGetFont());
}

Siehe auch

Makros und Globalen