Vorgehensweise: Hinzufügen, Bearbeiten oder Löschen von Steuerelementen (C++)

Mit dem Dialogfeld-Editor können Sie Steuerelemente in Dialogfeldern hinzufügen, größe ändern, bearbeiten und löschen. Sie können auch die Eigenschaften eines Steuerelements bearbeiten, z. B. seine ID, oder ob es zur Laufzeit anfangs sichtbar ist.

Die Registerkarte "Dialog-Editor " wird im Toolboxfenster angezeigt, wenn Sie im Dialogfeld-Editor arbeiten. Sie können auch das Toolboxfenster für eine einfachere Verwendung anpassen. Weitere Informationen finden Sie unter Verwenden der Toolbox und Anzeigen oder Ausblenden des Toolboxfensters.

Tipp

Während Sie den Dialogfeld-Editor verwenden, können Sie in vielen Fällen die rechte Maustaste auswählen, um ein Kontextmenü mit häufig verwendeten Befehlen anzuzeigen.

Hinzufügen von Steuerelementen

So fügen Sie ein Steuerelement hinzu

  1. Stellen Sie sicher, dass das Dialogfeld im Registerkartenformat das aktuelle Dokument im Editor-Fenster darstellt. Wenn ein Dialogfeld nicht das aktuelle Dokument ist, wird die Registerkarte "Dialog-Editor" in der Toolbox nicht angezeigt.

  2. Wählen Sie auf der Registerkarte "Dialogfeld-Editor " des Toolboxfensters das gewünschte Steuerelement und dann eine der folgenden Optionen aus:

    • Wählen Sie das Dialogfeld an der Stelle aus, an der Sie das Steuerelement platzieren möchten, und das Steuerelement wird an der ausgewählten Stelle angezeigt.

    • Ziehen Sie das Steuerelement aus dem Toolboxfenster an die Position im Dialogfeld, und legen Sie es ab. Anschließend können Sie das Steuerelement verschieben oder dessen Größe und Form ändern.

    • Doppelklicken Sie im Toolboxfenster auf das Steuerelement, und wird im Dialogfeld angezeigt. Positionieren Sie das Steuerelement an der gewünschten Position.

So fügen Sie mehrere Steuerelemente hinzu

  1. Wählen Sie beim Gedrückthalten der STRG-TASTE ein Steuerelement im Toolboxfenster aus.

  2. Lassen Sie die STRG-TASTE los, und wählen Sie das Dialogfeld so oft aus, wie Sie das jeweilige Steuerelement hinzufügen möchten.

  3. Drücken Sie ESC , um das Platzieren von Steuerelementen zu beenden.

So vergrößern Sie ein Steuerelement, während Sie es hinzufügen

  1. Wählen Sie ein Steuerelement im Toolboxfenster aus.

  2. Platzieren Sie den Cursor, der als Fadenkreuz angezeigt wird, an der sich die obere linke Ecke des neuen Steuerelements im Dialogfeld befinden soll.

  3. Wählen Sie die Maustaste aus, und halten Sie sie gedrückt, um die obere linke Ecke des Steuerelements im Dialogfeld zu verankern. Ziehen Sie dann den Cursor nach rechts und unten, bis das Steuerelement die gewünschte Größe aufweist.

    Hinweis

    Sie können jede der vier Ecken des Steuerelements verankern, das Sie zeichnen. Bei dieser Prozedur wird die obere linke Ecke als Beispiel verwendet.

  4. Lassen Sie die Maustaste los. Das Steuerelement wird in der von Ihnen angegebenen Größe auf das Dialogfeld gesetzt.

Tipp

Sie können die Größe des Steuerelements nach dem Ablegen im Dialogfeld ändern, indem Sie die Ziehpunkte am Rand des Steuerelements verschieben. Weitere Informationen finden Sie unter Sizing Individual Controls.

So fügen Sie ein benutzerdefiniertes Steuerelement hinzu

Sie können dem Dialogfeld benutzerdefinierte Steuerelemente hinzufügen. Wählen Sie das Symbol "Benutzerdefiniertes Steuerelement " in der Toolbox aus, und ziehen Sie es in Das Dialogfeld. Um ein Syslink Steuerelement hinzuzufügen, fügen Sie ein benutzerdefiniertes Steuerelement hinzu, und ändern Sie dann die Class-Eigenschaft des Steuerelements in Syslink. Diese Aktion bewirkt, dass die Eigenschaften aktualisiert und die Syslink Steuerelementeigenschaften angezeigt werden. Informationen zur MFC-Wrapperklasse finden Sie unter CLinkCtrl.

Steuerelemente bearbeiten

So bearbeiten Sie die Eigenschaften eines Steuerelements oder Steuerelements

  1. Wählen Sie im Dialogfeld das Steuerelement aus, das Sie ändern möchten.

    Hinweis

    Wenn Sie mehrere Steuerelemente auswählen, können nur die Eigenschaften bearbeitet werden, die den ausgewählten Steuerelementen gemeinsam sind.

  2. Ändern Sie in der Eigenschaftenfenster die Eigenschaften Des Steuerelements.

    Hinweis

    Wenn Sie die Bitmap-Eigenschaft für eine Schaltfläche, ein Optionsfeld oder ein Kontrollkästchen-Steuerelement auf " True" festlegen, wird die Formatvorlage BS_BITMAP für Ihr Steuerelement implementiert. Weitere Informationen finden Sie unter Schaltflächenformatvorlagen. Ein Beispiel zum Zuordnen einer Bitmap zu einem Steuerelement finden Sie unter "CButton::SetBitmap". Bitmaps werden nicht auf Ihrem Steuerelement angezeigt, während Sie sich im Dialogfeld-Editor befinden.

So können Sie Änderungen an den Eigenschaften eines Steuerelements rückgängig machen

  1. Stellen Sie sicher, dass das Steuerelement im Dialog-Editor den Fokus hat.

  2. Wechseln Sie zum Menü "Rückgängig bearbeiten>". Wenn sich der Fokus nicht auf dem Steuerelement befindet, ist der Befehl "Rückgängig " nicht verfügbar.

So definieren Sie eine Membervariable für ein Dialogfeld-Steuerelement (kein Schaltflächen-Steuerelement)

Hinweis

Dieser Vorgang gilt nur für Dialogsteuerelemente innerhalb eines MFC-Projekts. ATL-Projekte sollten das Dialogfeld "Neue Windows-Nachrichten und Ereignishandler" verwenden. Weitere Informationen finden Sie unter Message Types Associated with User-Interface Objects, Editing a Message Handler, and Defining a Message Handler for a Reflected Message.

  1. Wählen Sie im Dialogfeld-Editor ein Steuerelement aus.

  2. Doppelklicken Sie beim Drücken der STRG-TASTE auf das Dialogfeld-Steuerelement.

    Der Assistent zum Hinzufügen von Membervariablen wird angezeigt.

  3. Geben Sie die entsprechenden Informationen im Assistenten zum Hinzufügen von Membervariablen ein. Weitere Informationen finden Sie unter Dialog Data Exchange.

  4. Wählen Sie 'OK' aus, um zum Dialogfeld-Editor zurückzukehren.

Tipp

Doppelklicken Sie auf das Steuerelement, um von einem Dialogfeld-Steuerelement zu seinem vorhandenen Handler zu wechseln.

Sie können auch die Registerkarte "Membervariablen " im MFC-Klassen-Assistenten verwenden, um neue Membervariablen für eine angegebene Klasse hinzuzufügen und bereits definierte Membervariablen anzuzeigen.

Steuerelemente löschen

Wählen Sie im Dialogfeld das Steuerelement aus, drücken Sie dann die ENTF-TASTE, oder wechseln Sie zum Menü "Löschen bearbeiten">.

Andere Probleme

Problembehandlung

Nachdem Sie einem Dialogfeld ein allgemeines Steuerelement oder ein Rich-Edit-Steuerelement hinzugefügt haben, wird es beim Testen des Dialogfelds nicht angezeigt. Oder das Dialogfeld selbst wird nicht angezeigt. Beispiel:

  1. Erstellen Sie ein Win32-Projekt, und ändern Sie die Anwendungseinstellungen, sodass Sie eine Windows-Anwendung (keine Konsolen-App) erstellen.

  2. Doppelklicken Sie in der Ressourcenansicht auf die RC-Datei .

  3. Doppelklicken Sie unter der Dialogfeldoption auf das Feld "Info ".

  4. Fügen Sie dem Dialogfeld ein IP-Adresssteuerelement hinzu.

  5. Alles speichern und neu erstellen.

  6. Führen Sie das Programm aus.

  7. Wählen Sie im Hilfemenü des Dialogfelds den Befehl "Info" aus, und beobachten Sie, dass kein Dialogfeld angezeigt wird.

Derzeit fügt der Dialogfeld-Editor Ihrem Projekt nicht automatisch Code hinzu, wenn Sie die folgenden allgemeinen Steuerelemente oder Rich-Edit-Steuerelemente in ein Dialogfeld ziehen und ablegen. Visual Studio gibt auch keinen Fehler oder eine Warnung an, wenn dieses Problem auftritt. Um dies zu beheben, fügen Sie den Code für das Steuerelement manuell hinzu.

Animationssteuerelement
Benutzerdefiniertes Steuerelement
Datums-/Zeitauswahl
Erweitertes Kombinationsfeld

Hot Key
IP-Adressensteuerelement
Listensteuerelement
Month Calendar

Statussteuerelement
Rich Edit 2.0-Steuerelement
Rich Edit Control
Schieberegler-Steuerelement

Drehsteuerung
Registerkartensteuerelement
Struktursteuerelement

Um allgemeine Steuerelemente in einem Dialogfeld zu verwenden, müssen Sie InitCommonControlsEx oder AFXInitCommonControls vor dem Erstellen des Dialogfelds aufrufen.

Um RichEdit-Steuerelemente zu verwenden, müssen Sie aufrufen LoadLibrary. Weitere Informationen finden Sie unter "Informationen zu Rich Edit Controls " im Windows SDK und "Overview of the Rich Edit Control".

Hinweis

Um ein RichEdit-Steuerelement mit MFC zu verwenden, müssen Sie zuerst AfxInitRichEdit2 aufrufen, um das RichEdit 2.0-Steuerelement (RICHED20.DLL) zu laden oder AfxInitRichEdit aufzurufen, um das ältere RichEdit 1.0-Steuerelement (RICHED32.DLL) zu laden.

Sie können die aktuelle CRichEditCtrl-Klasse mit dem älteren RichEdit 1.0-Steuerelement verwenden, ist jedoch CRichEditCtrl nur für die Unterstützung des RichEdit 2.0-Steuerelements konzipiert. Da RichEdit 1.0 und RichEdit 2.0 ähnlich sind, funktionieren die meisten Methoden. Es gibt jedoch einige Unterschiede zwischen den Steuerelementen 1.0 und 2.0, sodass einige Methoden möglicherweise falsch funktionieren oder überhaupt nicht funktionieren.

Einfügen von ActiveX-Steuerelementen

Visual Studio ermöglicht Ihnen das Einfügen von ActiveX-Steuerelementen in Ihr Dialogfeld. Weitere Informationen finden Sie unter MFC ActiveX-Steuerelemente und ActiveX-Steuerelementcontainer.

Mit dem Dialogfeld "ActiveX-Steuerelement einfügen" können Sie ActiveX-Steuerelemente in Ihr Dialogfeld einfügen, während Sie den Dialogfeld-Editor verwenden. Dieses Dialogfeld enthält die folgenden Eigenschaften:

Eigenschaft Beschreibung
ActiveX-Steuerelement Zeigt eine Liste von ActiveX-Steuerelementen an.

Durch das Einfügen eines Steuerelements aus diesem Dialogfeld wird keine Wrapperklasse generiert. Wenn Sie eine Wrapperklasse benötigen, verwenden Sie die Klassenansicht , um eine klasse zu erstellen, siehe Hinzufügen einer Klasse.

Wenn in diesem Dialogfeld kein ActiveX-Steuerelement angezeigt wird, versuchen Sie, das Steuerelement gemäß den Anweisungen des Herstellers zu installieren.
Path Zeigt die Datei an, in der das ActiveX-Steuerelement gefunden wird.

Achtung

Der Vertrieb ist möglicherweise nicht für alle ActiveX-Steuerelemente auf Ihrem System rechtlich zulässig. Verweisen Sie auf den Lizenzvertrag für die Software, die die Steuerelemente installiert hat, oder wenden Sie sich an das Softwareunternehmen.

So fügen Sie ein ActiveX-Steuerelement hinzu

  1. Öffnen Sie ein Dialogfeld im Dialogfeld-Editor.

  2. Klicken Sie mit der rechten Maustaste auf eine beliebige Stelle im Textkörper des Dialogfelds, und wählen Sie "ActiveX-Steuerelement einfügen" aus.

    Das Dialogfeld ActiveX-Steuerelement einfügen wird angezeigt und stellt alle ActiveX-Steuerelemente auf dem System dar. Unten im Dialogfeld wird der Pfad der Datei des ActiveX-Steuerelements angezeigt.

  3. Wählen Sie das Steuerelement aus, das Sie ihrem Dialogfeld hinzufügen möchten, und wählen Sie "OK" aus.

    Das Steuerelement wird im Dialogfeld angezeigt, wo Sie es bearbeiten oder Handler für es erstellen können, ganz wie bei jedem anderen Steuerelement.

Tipp

Sie können das Kontextmenü im Dialogfeld-Editor verwenden, um einem Dialogfeld schnell registrierte ActiveX-Steuerelemente hinzuzufügen, oder sie können activeX-Steuerelemente zum Toolboxfenster hinzufügen, um einfachen Zugriff zu ermöglichen.

So bearbeiten Sie Eigenschaften für ein ActiveX-Steuerelement

ActiveX-Steuerelemente, die von unabhängigen Anbietern bereitgestellt werden, können mit ihren eigenen Eigenschaften und Eigenschaften ausgestattet sein. Diese Eigenschaften werden im Eigenschaftenfenster angezeigt. Alle Eigenschaftenseiten, die von den Autoren des ActiveX-Steuerelements erstellt wurden, werden im Dialogfeld Eigenschaftenseiten angezeigt. (So zeigen Sie die Eigenschaftenseite für ein bestimmtes ActiveX-Steuerelement, wählen Sie im Eigenschaftenfenster die Schaltfläche "Eigenschaftenseite" aus).

  • Wählen Sie das ActiveX-Steuerelement aus, und wechseln Sie zum Menü "Eigenschaftenseite anzeigen>", um die Eigenschaften anzuzeigen. Nehmen Sie änderungen nach Bedarf auf der Eigenschaftenseite vor.

    Auf der Eigenschaftenseite für ein ActiveX-Steuerelement werden verschiedene Registerkarten angezeigt, abhängig von den Eigenschaftenblättern, die als Teil des ActiveX-Steuerelements enthalten sind.

Hinweis

Dieses Verfahren gilt für die Verwendung der Eigenschaftenseite zum Bearbeiten von ActiveX-Steuerelementen. Sie können auch ActiveX-Eigenschaften im neuen Eigenschaftenfenster durchsuchen und bearbeiten.

Anforderungen

Win32

Siehe auch

Verwalten von Dialogfeldsteuerelementen
Vorgehensweise: Layoutsteuerelemente
How to: Define Control Access and Values