MFC-ActiveX-Steuerelemente: Eigenschaftenseiten
Mithilfe von Eigenschaftenseiten können Benutzer die Eigenschaften von ActiveX-Steuerelementen anzeigen und ändern.Der Zugriff auf diese Eigenschaften erfolgt über ein Dialogfeld für die Steuerelementeigenschaften. Dieses enthält eine oder mehrere Eigenschaftenseiten, die eine angepasste grafische Oberfläche zum Anzeigen und Bearbeiten der Steuerelementeigenschaften bereitstellen.
ActiveX-Steuerelement-Eigenschaftenseiten werden auf zwei Arten angezeigt:
Wenn die Eigenschaft des Steuerelements verb OLEIVERB_PROPERTIES() aufgerufen wird, öffnet das Steuerelement ein modales Dialogfeld Eigenschaften, die die Eigenschaftenseiten des Steuerelements enthält.
Der Container kann über ein eigenes nicht modales Dialogfeld an, das die Eigenschaftenseiten des ausgewählten Steuerelements angezeigt wird.
Das Eigenschaftendialogfeld (wird in der folgenden Abbildung) besteht aus einer Region zum Anzeigen der aktuellen Eigenschaftenseite, der Registerkarten für das Umschalten zwischen der Auflistung und Eigenschaftenseiten Schaltflächen, die häufige Aufgaben wie das Schließen des Dialogfelds Eigenschaftenseiten ausführen, bricht alle vorgenommenen Änderungen anwendet oder alle Änderungen des ActiveX-Steuerelements.
Eigenschaft-Dialogfeld
.gif "Dialogfeld \"Circ3-Eigenschaften\"")
Dieser Artikel enthält Themen, die die Verwendung von Eigenschaftenseiten in einem ActiveX-Steuerelement verknüpft sind.Dazu gehören:
Die Eigenschaftenseite für ein ActiveX-Steuerelement implementieren
Hinzufügen von Steuerelementen zu einer Eigenschaftenseite
Die DoDataExchange-Funktion anpassen
Weitere Informationen über die Verwendung von Eigenschaftenseiten in einem ActiveX-Steuerelement finden Sie in den folgenden Artikeln:
MFC-ActiveX-Steuerelemente: Hinzufügen einer anderen benutzerdefinierten Eigenschaftenseite
MFC-ActiveX-Steuerelemente: Verwenden vordefinierter Eigenschaftenseiten
Weitere Informationen über die Verwendung von Eigenschaftenblättern in einer MFC-Anwendung Gegensatz zu einem ActiveX-Steuerelement finden Sie unter Eigenschaftenblätter (MFC).
Die Eigenschaftenseite implementieren
Wenn Sie mit dem ActiveX-Steuerelement-Assistenten verwenden, um das Steuerelementprojekt erstellen, stellt der ActiveX-Steuerelement-Assistent eine Klasse für Eigenschaftenseiten für das Steuerelement bereit, das von COlePropertyPage-Klasse abgeleitet ist.Diese Eigenschaftenseite ist zunächst leer. Sie können jedoch ein beliebiges Dialogfeld-Steuerelement oder mehrere Steuerelemente hinzufügen.Da der ActiveX-Steuerelement-Assistent Klasse nur eine Eigenschaftenseiten standardmäßig erstellt wird, müssen zusätzliche Eigenschaftenseiten (auch Klassen abgeleitet von COlePropertyPage) mithilfe von der Klassenansicht erstellt werden.Weitere Informationen zu diesem Verfahren finden Sie unter MFC-ActiveX-Steuerelemente: Hinzufügen einer anderen benutzerdefinierten Eigenschaftenseite.
Eine Eigenschaftenseite zu implementieren (in diesem Fall die Standardeinstellung) ist ein drei Schritten:
So implementieren Sie eine Eigenschaftenseite
Fügen Sie das Steuerelementprojekt COlePropertyPage abgeleitete Klasse hinzu.Wenn das Projekt mit dem ActiveX-Steuerelement-Assistenten (in diesem Fall) erstellt wurde, ist die standardmäßige Eigenschaftenseiten bereits - Klasse.
Verwenden Sie den Dialog-Editor Sie alle Steuerelemente der Vorlage Eigenschaftenseiten hinzufügen.
Passen Sie die DoDataExchange-Funktion COlePropertyPage abgeleiteten Klasse den Gegenwerten zwischen dem ActiveX-Steuerelement und die Steuerung Eigenschaftenseiten an.
Zwecke, z. B. die folgenden Schritte ausführen ein einfaches Steuerelement (mit dem Namen "Beispiel").Beispiel wurde mit dem ActiveX-Steuerelement-Assistenten erstellt und nur die vordefinierte Caption-Eigenschaft enthält.
Hinzufügen von Steuerelementen zu einer Eigenschaftenseite
So fügen Sie Steuerelemente einer Eigenschaftenseite hinzufügen
Mit dem Steuerelementprojekt geöffnet, offene Ressourcenansicht.
Doppelklicken Sie auf das Symbol für das Verzeichnis Dialogfeld.
Öffnen Sie das Dialogfeld IDD_PROPPAGE_SAMPLE .
Der ActiveX-Steuerelement-Assistent fügt den Namen des Projekts an das Ende der Dialogfeld ID in diesem Fall Beispiel gezeigt.
Drag & Drop das ausgewählte Steuerelement aus der Toolbox in den Bereich des Dialogfelds.
Für dieses Beispiel eine Beschriftung steuer "Beschriftung: " und ein Eingabefeld die Steuerung mit einem IDC_CAPTION Bezeichner sind ausreichend.
Klicken Sie auf der Symbolleiste auf Speichern, um die Änderungen zu speichern.
Nachdem die Benutzeroberfläche geändert wurde, muss das Eingabefeld mit der Caption-Eigenschaft verknüpfen.Dies ist im folgenden Abschnitt hierzu die CSamplePropPage::DoDataExchange-Funktion behandelt.
Die DoDataExchange-Funktion anpassen
Die Eigenschaftenseite CWnd::DoDataExchange-Funktion ermöglicht die Eigenschaftenseiten Link Werte mit den Werten der Eigenschaften im Steuerelement.Um Links zu erstellen, müssen Sie die entsprechenden Felder Eigenschaftenseiten zu ihren jeweiligen Steuerelementeigenschaften zugeordnet sind.
Diese Zuordnungen werden mithilfe der Eigenschaftenseite DDP_-Funktionen implementiert.Die DDP_-Funktionen wie die DDX_-Funktionen, die in Standard-MFC-Dialogfeldern mit einer Ausnahme verwendet werden.Zusätzlich zum Verweis auf eine Membervariable Funktionen akzeptieren DDP_ den Namen der Steuerelementeigenschaft.Im Folgenden wird ein typischer Eintrag in der DoDataExchange-Funktion für eine Eigenschaftenseite.
DDP_Text(pDX, IDC_CAPTION, m_caption, _T("Caption"));
Diese Funktion ordnet die m_caption-Membervariable der Eigenschaftenseite mit der Beschriftung mithilfe der DDP_TEXT-Funktion auf.
Nachdem Sie die Eigenschaftenseiten für einfügen lassen, müssen Sie einen Link zwischen dem Steuerelement und IDC_CAPTION-Eigenschaftenseiten der tatsächlichen Steuerelementeigenschaft mithilfe der angegebenen Beschriftung, DDP_Text-Funktion erstellen, wie oben beschrieben.
Eigenschaftenseiten (MFC) sind für andere Dialogfeld steuerelementtypen, z. B. Kontrollkästchen, Optionsfeldern und Listenfelder verfügbar.Die folgende Tabelle zeigt den gesamten Satz von Eigenschaftenseite DDP_-Funktionen und deren Zwecken:
Eigenschaftenseiten-Funktionen
Funktionsname |
Verwenden Sie diese Funktion, um zu verknüpfen |
|---|---|
DDP_CBIndex |
Der ausgewählte Index der Zeichenfolge in einem Kombinationsfeld mit einer Steuerelementeigenschaft. |
DDP_CBString |
Die ausgewählte Zeichenfolge in einem Kombinationsfeld mit einer Steuerelementeigenschaft.Die ausgewählte Zeichenfolge kann mit denselben Buchstaben als Wert der Eigenschaft beginnen muss jedoch nicht ihn vollständig übereinstimmen. |
DDP_CBStringExact |
Die ausgewählte Zeichenfolge in einem Kombinationsfeld mit einer Steuerelementeigenschaft.Die ausgewählte Zeichenfolge und der Zeichenfolgenwert der Eigenschaft müssen übereinstimmen. |
DDP_Check |
Ein Kontrollkästchen mit einer Steuerelementeigenschaft. |
DDP_LBIndex |
Der ausgewählte Index der Zeichenfolge in einem Listenfeld mit einer Steuerelementeigenschaft. |
DDP_LBString |
Die ausgewählte Zeichenfolge in einem Listenfeld mit einer Steuerelementeigenschaft.Die ausgewählte Zeichenfolge kann mit denselben Buchstaben als Wert der Eigenschaft beginnen muss jedoch nicht ihn vollständig übereinstimmen. |
DDP_LBStringExact |
Die ausgewählte Zeichenfolge in einem Listenfeld mit einer Steuerelementeigenschaft.Die ausgewählte Zeichenfolge und der Zeichenfolgenwert der Eigenschaft müssen übereinstimmen. |
DDP_Radio |
Ein Optionsfeld zu einer Steuerelementeigenschaft. |
DDP_Text |
Text mit einer Steuerelementeigenschaft. |