Eigenschaftenseiten (MFC)

Eigenschaftenseiten zeigen die aktuellen Werte bestimmter OLE-Steuerelementeigenschaften in einer anpassbaren, grafischen Oberfläche zum Anzeigen und Bearbeiten an, indem sie einen Datenzuordnungsmechanismus basierend auf Dialogdatenaustausch (DDX) unterstützen.

Dieser Datenzuordnungsmechanismus ordnet Eigenschaftenseitensteuerelemente den einzelnen Eigenschaften des OLE-Steuerelements zu. Der Wert der Steuerelementeigenschaft gibt den Status oder den Inhalt des Eigenschaftenseitensteuerelements wieder. Die Zuordnung zwischen Eigenschaftenseitensteuerelementen und Eigenschaften wird durch DDP_ Funktionsaufrufe in der Memberfunktion der Eigenschaftenseite DoDataExchange angegeben. Es folgt eine Liste der DDP_ Funktionen, die mithilfe der Eigenschaftenseite Ihres Steuerelements eingegebene Daten austauschen:

Datenübertragung der Eigenschaftenseite

Name	Beschreibung
DDP_CBIndex	Verknüpft den Index der ausgewählten Zeichenfolge in einem Kombinationsfeld mit der Eigenschaft eines Steuerelements.
DDP_CBString	Verknüpft die ausgewählte Zeichenfolge in einem Kombinationsfeld mit der Eigenschaft eines Steuerelements. Die ausgewählte Zeichenfolge kann mit denselben Buchstaben wie der Wert der Eigenschaft beginnen, muss aber nicht vollständig übereinstimmen.
DDP_CBStringExact	Verknüpft die ausgewählte Zeichenfolge in einem Kombinationsfeld mit der Eigenschaft eines Steuerelements. Die ausgewählte Zeichenfolge und der Zeichenfolgenwert der Eigenschaft müssen exakt übereinstimmen.
DDP_Check	Verknüpft ein Kontrollkästchen auf der Eigenschaftenseite des Steuerelements mit der Eigenschaft eines Steuerelements.
DDP_LBIndex	Verknüpft den Index der ausgewählten Zeichenfolge in einem Listenfeld mit der Eigenschaft eines Steuerelements.
DDP_LBString	Verknüpft die ausgewählte Zeichenfolge in einem Listenfeld mit der Eigenschaft eines Steuerelements. Die ausgewählte Zeichenfolge kann mit denselben Buchstaben wie der Wert der Eigenschaft beginnen, muss aber nicht vollständig übereinstimmen.
DDP_LBStringExact	Verknüpft die ausgewählte Zeichenfolge in einem Listenfeld mit der Eigenschaft eines Steuerelements. Die ausgewählte Zeichenfolge und der Zeichenfolgenwert der Eigenschaft müssen exakt übereinstimmen.
DDP_PostProcessing	Beendet die Übertragung von Eigenschaftswerten aus dem Steuerelement.
DDP_Radio	Verknüpft eine Optionsfeldgruppe auf der Eigenschaftenseite des Steuerelements mit der Eigenschaft eines Steuerelements.
DDP_Text	Verknüpft ein Steuerelement auf der Eigenschaftenseite des Steuerelements mit der Eigenschaft eines Steuerelements. Diese Funktion behandelt verschiedene Arten von Eigenschaften, z double. B. , shortBSTR und long.

Weitere Informationen zu den DoDataExchange Funktions- und Eigenschaftenseiten finden Sie im Artikel ActiveX-Steuerelemente: Eigenschaftenseiten.

Im Folgenden finden Sie eine Liste von Makros, die zum Erstellen und Verwalten von Eigenschaftenseiten für ein OLE-Steuerelement verwendet werden:

Eigenschaftenseiten

Name	Beschreibung
BEGIN_PROPPAGEIDS	Beginnt die Liste der Eigenschaftenseiten-IDs.
END_PROPPAGEIDS	Beendet die Liste der Eigenschaftenseiten-IDs.
PROPPAGEID	Deklariert eine Eigenschaftenseite der Steuerelementklasse.

DDP_CBIndex

Rufen Sie diese Funktion in der Eigenschaftsseitesfunktion DoDataExchange auf, um den Wert einer ganzzahligen Eigenschaft mit dem Index der aktuellen Auswahl in einem Kombinationsfeld auf der Eigenschaftenseite zu synchronisieren.

void AFXAPI DDP_CBIndex(
    CDataExchange* pDX,
    int id,
    int& member,
    LPCTSTR pszPropName);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

id
Die Ressourcen-ID des Kombinationsfeld-Steuerelements, das der durch pszPropName angegebenen Steuerelementeigenschaft zugeordnet ist.

member
Die Membervariable, die dem eigenschaftenseitensteuerelement zugeordnet ist, das durch id und die durch pszPropName angegebene Eigenschaft angegeben ist.

pszPropName
Der Eigenschaftenname der Steuerelementeigenschaft, die mit dem kombinationsfeld-Steuerelement ausgetauscht werden soll, das durch die ID angegeben wird.

Hinweise

Diese Funktion sollte vor dem entsprechenden DDX_CBIndex Funktionsaufruf aufgerufen werden.

Anforderungen

Header afxctl.h

DDP_CBString

Rufen Sie diese Funktion in der Funktion der Eigenschaftenseite DoDataExchange auf, um den Wert einer Zeichenfolgeneigenschaft mit der aktuellen Auswahl in einem Kombinationsfeld auf der Eigenschaftenseite zu synchronisieren.

void AFXAPI DDP_CBString(
    CDataExchange* pDX,
    int id,
    CString& member,
    LPCTSTR pszPropName);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

id
Die Ressourcen-ID des Kombinationsfeld-Steuerelements, das der durch pszPropName angegebenen Steuerelementeigenschaft zugeordnet ist.

member
Die Membervariable, die dem eigenschaftenseitensteuerelement zugeordnet ist, das durch id und die durch pszPropName angegebene Eigenschaft angegeben ist.

pszPropName
Der Eigenschaftenname der Steuerelementeigenschaft, die mit der durch id angegebenen Kombinationsfeldzeichenfolge ausgetauscht werden soll.

Hinweise

Diese Funktion sollte vor dem entsprechenden DDX_CBString Funktionsaufruf aufgerufen werden.

Anforderungen

Header afxctl.h

DDP_CBStringExact

Rufen Sie diese Funktion in der Funktion der Eigenschaftenseite DoDataExchange auf, um den Wert einer Zeichenfolgeneigenschaft zu synchronisieren, die exakt der aktuellen Auswahl in einem Kombinationsfeld auf der Eigenschaftenseite entspricht.

void AFXAPI DDP_CBStringExact(
    CDataExchange* pDX,
    int id,
    CString& member,
    LPCTSTR pszPropName);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

id
Die Ressourcen-ID des Kombinationsfeld-Steuerelements, das der durch pszPropName angegebenen Steuerelementeigenschaft zugeordnet ist.

member
Die Membervariable, die dem eigenschaftenseitensteuerelement zugeordnet ist, das durch id und die durch pszPropName angegebene Eigenschaft angegeben ist.

pszPropName
Der Eigenschaftenname der Steuerelementeigenschaft, die mit der durch id angegebenen Kombinationsfeldzeichenfolge ausgetauscht werden soll.

Hinweise

Diese Funktion sollte vor dem entsprechenden DDX_CBStringExact Funktionsaufruf aufgerufen werden.

Anforderungen

Header afxctl.h

DDP_Check

Rufen Sie diese Funktion in der Eigenschaftsseitesfunktion DoDataExchange auf, um den Wert der Eigenschaft mit dem Kontrollkästchen-Steuerelement der zugeordneten Eigenschaftenseite zu synchronisieren.

void AFXAPI DDP_Check(
    CDataExchange* pDX,
    int id,
    int & member,
    LPCSTR pszPropName);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

id
Die Ressourcen-ID des Kontrollkästchen-Steuerelements, das der durch pszPropName angegebenen Steuerelementeigenschaft zugeordnet ist.

member
Die Membervariable, die dem eigenschaftenseitensteuerelement zugeordnet ist, das durch id und die durch pszPropName angegebene Eigenschaft angegeben ist.

pszPropName
Der Eigenschaftenname der Steuerelementeigenschaft, die mit dem durch die ID angegebenen Kontrollkästchen-Steuerelement ausgetauscht werden soll.

Hinweise

Diese Funktion sollte vor dem entsprechenden DDX_Check Funktionsaufruf aufgerufen werden.

Anforderungen

Header afxctl.h

DDP_LBIndex

Rufen Sie diese Funktion in der Funktion der Eigenschaftenseite DoDataExchange auf, um den Wert einer ganzzahligen Eigenschaft mit dem Index der aktuellen Auswahl in einem Listenfeld auf der Eigenschaftenseite zu synchronisieren.

void AFXAPI DDP_LBIndex(
    CDataExchange* pDX,
    int id,
    int& member,
    LPCTSTR pszPropName);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

id
Die Ressourcen-ID des Listenfeld-Steuerelements, das der durch pszPropName angegebenen Steuerelementeigenschaft zugeordnet ist.

member
Die Membervariable, die dem eigenschaftenseitensteuerelement zugeordnet ist, das durch id und die durch pszPropName angegebene Eigenschaft angegeben ist.

pszPropName
Der Eigenschaftsname der Steuerelementeigenschaft, die mit der durch id angegebenen Listenfeldzeichenfolge ausgetauscht werden soll.

Hinweise

Diese Funktion sollte vor dem entsprechenden DDX_LBIndex Funktionsaufruf aufgerufen werden.

Anforderungen

Header afxctl.h

DDP_LBString

Rufen Sie diese Funktion in der Funktion Ihrer Eigenschaftsseite DoDataExchange auf, um den Wert einer Zeichenfolgeneigenschaft mit der aktuellen Auswahl in einem Listenfeld auf der Eigenschaftenseite zu synchronisieren.

void AFXAPI DDP_LBString(
    CDataExchange* pDX,
    int id,
    CString& member,
    LPCTSTR pszPropName);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

id
Die Ressourcen-ID des Listenfeld-Steuerelements, das der durch pszPropName angegebenen Steuerelementeigenschaft zugeordnet ist.

member
Die Membervariable, die dem eigenschaftenseitensteuerelement zugeordnet ist, das durch id und die durch pszPropName angegebene Eigenschaft angegeben ist.

pszPropName
Der Eigenschaftsname der Steuerelementeigenschaft, die mit der durch id angegebenen Listenfeldzeichenfolge ausgetauscht werden soll.

Hinweise

Diese Funktion sollte vor dem entsprechenden DDX_LBString Funktionsaufruf aufgerufen werden.

Anforderungen

Header afxctl.h

DDP_LBStringExact

Rufen Sie diese Funktion in der Funktion der Eigenschaftenseite DoDataExchange auf, um den Wert einer Zeichenfolgeneigenschaft zu synchronisieren, die exakt der aktuellen Auswahl in einem Listenfeld auf der Eigenschaftenseite entspricht.

void AFXAPI DDP_LBStringExact(
    CDataExchange* pDX,
    int id,
    CString& member,
    LPCTSTR pszPropName);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

id
Die Ressourcen-ID des Listenfeld-Steuerelements, das der durch pszPropName angegebenen Steuerelementeigenschaft zugeordnet ist.

member
Die Membervariable, die dem eigenschaftenseitensteuerelement zugeordnet ist, das durch id und die durch pszPropName angegebene Eigenschaft angegeben ist.

pszPropName
Der Eigenschaftsname der Steuerelementeigenschaft, die mit der durch id angegebenen Listenfeldzeichenfolge ausgetauscht werden soll.

Hinweise

Diese Funktion sollte vor dem entsprechenden DDX_LBStringExact Funktionsaufruf aufgerufen werden.

Anforderungen

Header afxctl.h

DDP_PostProcessing

Rufen Sie diese Funktion in der Eigenschaftsseite-Funktion DoDataExchange auf, um die Übertragung von Eigenschaftswerten von der Eigenschaftenseite zu Ihrem Steuerelement abzuschließen, wenn Eigenschaftswerte gespeichert werden.

void AFXAPI DDP_PostProcessing(CDataExchange * pDX);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

Hinweise

Diese Funktion sollte aufgerufen werden, nachdem alle Datenaustauschfunktionen abgeschlossen wurden. Zum Beispiel:

void CMyAxPropPage::DoDataExchange(CDataExchange *pDX)
{
   DDP_Text(pDX, IDC_POSITIONEDIT, m_NeedlePosition, _T("NeedlePosition"));
   DDX_Text(pDX, IDC_POSITIONEDIT, m_NeedlePosition);
   DDV_MinMaxInt(pDX, m_NeedlePosition, 0, 3);
   DDP_PostProcessing(pDX);
}

Anforderungen

Header afxctl.h

DDP_Radio

Rufen Sie diese Funktion in der Funktion Ihres Steuerelements DoPropExchange auf, um den Wert der Eigenschaft mit dem zugehörigen Optionsfeld-Steuerelement der Eigenschaftenseite zu synchronisieren.

void AFXAPI DDP_Radio(
    CDataExchange* pDX,
    int id,
    int & member,
    LPCTSTR pszPropName);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

id
Die Ressourcen-ID des Optionsfeld-Steuerelements, das der durch pszPropName angegebenen Steuerelementeigenschaft zugeordnet ist.

member
Die Membervariable, die dem eigenschaftenseitensteuerelement zugeordnet ist, das durch id und die durch pszPropName angegebene Eigenschaft angegeben ist.

pszPropName
Der Eigenschaftsname der Steuerelementeigenschaft, die mit dem Optionsfeld-Steuerelement ausgetauscht werden soll, das durch die ID angegeben wird.

Hinweise

Diese Funktion sollte vor dem entsprechenden DDX_Radio Funktionsaufruf aufgerufen werden.

Anforderungen

Header afxctl.h

DDP_Text

Rufen Sie diese Funktion in der Funktion Ihres Steuerelements DoDataExchange auf, um den Wert der Eigenschaft mit dem zugeordneten Eigenschaftenseitensteuerelement zu synchronisieren.

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    BYTE & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    int & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    UINT & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    long & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    DWORD & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    float & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    double & member,
    LPCTSTR pszPropName);

void AFXAPI DDP_Text(
    CDataExchange* pDX,
    int id,
    CString & member,
    LPCTSTR pszPropName);

Parameter

pDX
Zeiger auf ein CDataExchange Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

id
Die Ressourcen-ID des Steuerelements, das der durch pszPropName angegebenen Steuerelementeigenschaft zugeordnet ist.

member
Die Membervariable, die dem eigenschaftenseitensteuerelement zugeordnet ist, das durch id und die durch pszPropName angegebene Eigenschaft angegeben ist.

pszPropName
Der Eigenschaftsname der Steuerelementeigenschaft, die mit dem durch die ID angegebenen Steuerelement ausgetauscht werden soll.

Hinweise

Diese Funktion sollte vor dem entsprechenden DDX_Text Funktionsaufruf aufgerufen werden.

Anforderungen

Header afxctl.h

BEGIN_PROPPAGEIDS

Beginnt mit der Definition der Liste der Eigenschaftenseiten-IDs ihres Steuerelements.

BEGIN_PROPPAGEIDS(class_name,  count)

Parameter

class_name
Der Name der Steuerelementklasse, für die Eigenschaftenseiten angegeben werden.

count
Die Anzahl der Eigenschaftenseiten, die von der Steuerelementklasse verwendet werden.

Hinweise

Starten Sie in der Implementierungsdatei (.cpp), die die Memberfunktionen für Ihre Klasse definiert, die Eigenschaftenseitenliste mit dem BEGIN_PROPPAGEIDS Makro, fügen Sie dann Makroeinträge für jede Ihrer Eigenschaftenseiten hinzu, und schließen Sie die Eigenschaftenseitenliste mit dem END_PROPPAGEIDS Makro ab.

Weitere Informationen zu Eigenschaftenseiten finden Sie im Artikel ActiveX-Steuerelemente: Eigenschaftenseiten.

Anforderungen

Header afxctl.h

END_PROPPAGEIDS

Beendet die Definition der Eigenschaftenseiten-ID-Liste.

END_PROPPAGEIDS(class_name)

Parameter

class_name
Der Name der Steuerelementklasse, die die Eigenschaftenseite besitzt.

Anforderungen

Header afxctl.h

PROPPAGEID

Fügt eine Eigenschaftenseite für die Verwendung durch Ihr OLE-Steuerelement hinzu.

PROPPAGEID(clsid)

Parameter

clsid
Die eindeutige Klassen-ID einer Eigenschaftenseite.

Hinweise

Alle PROPPAGEID-Makros müssen zwischen dem BEGIN_PROPPAGEIDS und END_PROPPAGEIDS Makros in der Implementierungsdatei Ihres Steuerelements platziert werden.

Anforderungen

Header afxctl.h

Siehe auch

Makros und Globalen