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. Beispiel:
void CMFCActiveXControlCtrl::DoPropExchange(CPropExchange* pPX)
{
ExchangeVersion(pPX, MAKELONG(_wVerMinor, _wVerMajor));
COleControl::DoPropExchange(pPX);
if (IsConvertingVBX())
PX_VBXFontConvert(pPX, InternalGetFont());
}
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für