Zusammenführen von Menüelementen im MenuStrip-Steuerelement von Windows Forms
Aktualisiert: November 2007
In einer MDI-(Multiple Document Interface-)Anwendung können Sie Menüelemente oder vollständige Menüs aus dem untergeordneten Formular mit den Menüs aus dem übergeordneten Formular zusammenführen.
In diesem Thema werden die Grundbegriffe des Zusammenführens von Menüelementen in einer MDI-Anwendung beschrieben.
Allgemeine Konzepte
Zusammenführungsverfahren schließen sowohl ein Ziel- als auch eine Quellsteuerelement ein:
Das Ziel ist das MenuStrip-Steuerelement im Hauptformular oder im übergeordneten MDI-Formular, in dem Menüelemente zusammengeführt werden sollen.
Die Quelle ist das MenuStrip-Steuerelement im untergeordneten MDI-Formular, in dem die Menüelemente enthalten sind, die Sie in das Zielmenü überführen möchten.
Die MdiWindowListItem-Eigenschaft identifiziert das Menüelement im aktuellen übergeordneten MDI-Formular, in dessen Dropdownliste die Titel der untergeordneten MDI-Formulare eingefügt werden. Beispielsweise werden in der Regel die untergeordneten MDI-Elemente aufgelistet, die derzeit im Menü Fenster geöffnet sind.
Die IsMdiWindowListEntry-Eigenschaft identifiziert die Menüelemente, die aus einem MenuStrip eines untergeordneten MDI-Formulars stammen.
Menüelemente können manuell oder automatisch zusammengeführt werden. In beiden Fällen werden die Menüelemente auf die gleiche Weise zusammengeführt, die Zusammenführung wird jedoch unterschiedlich aktiviert. Dies wird in den Abschnitten "Manuelles Zusammenführen" und "Automatisches Zusammenführen" in diesem Thema behandelt. Sowohl beim manuellen als auch beim automatischen Zusammenführen beeinflusst jeder Zusammenführungsvorgang den nächsten Zusammenführungsvorgang.
Beim Zusammenführen mit MenuStrip werden Menüelemente aus einem ToolStrip in einen anderen verschoben, während sie mit MainMenu geklont wurden.
MergeAction-Werte
Der Zusammenführungsvorgang von Menüelementen wird in der MenuStrip-Quelle mit der MergeAction-Eigenschaft festgelegt.
In der folgenden Tabelle werden die Bedeutung und typische Verwendung der verfügbaren Zusammenführungsvorgänge beschrieben.
MergeAction-Wert |
Beschreibung |
Typische Verwendung |
|---|---|---|
(Standard) Das Quellelement wird am Ende der Auflistung des Zielelements hinzugefügt. |
Hinzufügen von Menüelementen am Ende des Menüs, wenn ein Bestandteil des Programms aktiviert ist |
|
Das Quellelement wird der Auflistung des Zielelements an der Stelle hinzugefügt, die durch die im Quellelement festgelegte MergeIndex-Eigenschaft festgelegt wurde. |
Hinzufügen von Menüelementen in der Mitte oder am Anfang des Menüs, wenn ein Bestandteil des Programms aktiviert ist Wenn der MergeIndex-Wert für beide Menüelemente der gleiche ist, werden sie in umgekehrter Reihenfolge hinzugefügt. Damit die ursprüngliche Reihenfolge beibehalten wird, muss der richtige MergeIndex festgelegt sein. |
|
Wenn eine Textübereinstimmung festgestellt oder andernfalls der MergeIndex-Wert verwendet wurde, wird das entsprechende Zielmenüelement durch das Quellmenüelement ersetzt. |
Ersetzen eines Zielmenüelements durch ein Quellmenüelement mit dem gleichen Namen und einer anderen Funktion |
|
Wenn eine Textübereinstimmung festgestellt oder andernfalls der MergeIndex-Wert verwendet wurde, werden dem Ziel alle Dropdownelemente der Quelle hinzugefügt. |
Erstellen einer Menüstruktur, mit deren Hilfe Menüelemente in einem Untermenü eingefügt, hinzugefügt oder aus diesem entfernt werden können. Sie können beispielsweise ein Menüelement eines untergeordneten MDI-Formulars dem Menü Speichern unter im Haupt-MenuStrip hinzufügen. Mit MatchOnly navigieren Sie durch die Menüstruktur, ohne eine Aktion auszuführen. Dies bietet eine Möglichkeit zum Auswerten der nachfolgenden Elemente. |
|
Wenn eine Textübereinstimmung festgestellt oder andernfalls der MergeIndex-Wert verwendet wurde, wird das Element aus dem Ziel entfernt. |
Entfernen eines Menüelements aus dem MenuStrip-Ziel. |
Manuelles Zusammenführen
Lediglich MenuStrip-Steuerelemente können automatisch zusammengeführt werden. Wenn Elemente anderer Steuerelemente, beispielsweise ToolStrip-Steuerelemente oder StatusStrip-Steuerelemente, miteinander kombiniert werden sollen, müssen diese manuell zusammengeführt werden, indem Sie in Ihrem Code die jeweils erforderliche Merge-Methode und die RevertMerge-Methode aufrufen.
Automatisches Zusammenführen
Durch Aktivieren des Quellformulars kann das automatische Zusammenführen für MDI-Anwendungen verwendet werden. Um ein MenuStrip in einer MDI-Anwendung zu verwenden, legen Sie die MainMenuStrip-Eigenschaft auf das MenuStrip des Ziels fest, sodass Zusammenführungsvorgänge, die im MenuStrip der Quelle durchgeführt werden, Auswirkungen auf das MenuStrip des Ziels haben.
Das automatische Zusammenführen kann durch Aktivieren des MenuStrip der MDI-Quelle ausgelöst werden. Nach der Aktivierung wird das MenuStrip der Quelle mit dem MDI-Ziel zusammengeführt. Wird ein neues Formular aktiv, wird die Zusammenführung im letzten Formular zurückgesetzt und im neuen Formular ausgelöst. Dieses Verhalten kann durch Festlegen der MergeAction-Eigenschaft für jedes ToolStripItem nach Bedarf gesteuert werden, gleichzeitig durch Festlegen der AllowMerge-Eigenschaft für jedes MenuStrip.
Siehe auch
Aufgaben
Gewusst wie: Erstellen einer MDI-Fensterliste mithilfe von MenuStrip (Windows Forms)