Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Klassen ToolStrip und ToolStripItem bieten ein flexibles, erweiterbares System zum Anzeigen von Symbolleisten, Status- und Menüelementen. Diese Klassen sind alle im System.Windows.Forms Namespace enthalten und werden in der Regel mit dem Präfix "ToolStrip" (z ToolStripOverflow. B. ) oder mit dem Suffix "Strip" (z MenuStrip. B. ) benannt.
ToolStrip
In den folgenden Themen werden ToolStrip und die Steuerelemente beschrieben, die daraus abgeleitet sind.
ToolStrip ist die abstrakte Basisklasse für MenuStrip, StatusStripund ContextMenuStrip. Das folgende Objektmodell zeigt die ToolStrip Vererbungshierarchie.
Sie können auf alle Elemente in einer ToolStrip über die Items-Sammlung zugreifen. Sie können auf alle Elemente in einer ToolStripDropDownItem über die DropDownItems-Sammlung zugreifen. In einer von einer Klasse abgeleiteten ToolStripKlasse können Sie auch die DisplayedItems Eigenschaft verwenden, um nur auf die Elemente zuzugreifen, die derzeit angezeigt werden. Dies sind die Elemente, die sich derzeit nicht in einem Überlaufmenü befinden.
Die folgenden Elemente sind speziell darauf ausgelegt, nahtlos mit beiden ToolStripSystemRenderer und ToolStripProfessionalRenderer in allen Ausrichtungen zu arbeiten. Sie sind standardmäßig zur Entwurfszeit für das ToolStrip Steuerelement verfügbar:
MenuStrip
MenuStrip ist der Container der obersten Ebene, der abgelöst wird MainMenu. Sie bietet außerdem Schlüsselbehandlungsfunktionen und mehrere MDI-Funktionen (Document Interface). Funktional arbeiten ToolStripDropDownItem und ToolStripMenuItem zusammen mit MenuStrip, obwohl sie von ToolStripItem abgeleitet wurden.
Die folgenden Elemente sind speziell darauf ausgelegt, nahtlos mit beiden ToolStripSystemRenderer und ToolStripProfessionalRenderer in allen Ausrichtungen zu arbeiten. Sie sind standardmäßig zur Entwurfszeit für das MenuStrip Steuerelement verfügbar:
StatusStrip
StatusStrip ersetzt das StatusBar Steuerelement. Zu den speziellen Features von StatusStrip gehören ein benutzerdefiniertes Tabellenlayout, Unterstützung für die Größenänderung und das Verschieben des Formulars sowie die Spring
Eigenschaft, mit der ein ToolStripStatusLabel den verfügbaren Platz automatisch füllen kann.
Die folgenden Elemente sind speziell darauf ausgelegt, nahtlos mit beiden ToolStripSystemRenderer und ToolStripProfessionalRenderer in allen Ausrichtungen zu arbeiten. Sie sind standardmäßig zur Entwurfszeit für das StatusStrip Steuerelement verfügbar:
ContextMenuStrip
ContextMenuStrip ersetzt ContextMenu. Sie können ein beliebiges ContextMenuStrip mit einem Steuerelement zuordnen, und mit der rechten Maustaste wird automatisch das Kontextmenü (oder Verknüpfungsmenü) angezeigt. Sie können ein ContextMenuStrip programmatisch mithilfe der Show Methode anzeigen. ContextMenuStrip unterstützt abbruchfähige Opening- und Closing-Ereignisse zur Behandlung von dynamischen Populationen und Mehrfachklick-Szenarien. ContextMenuStrip unterstützt Bilder, Status der Menüelementüberprüfung, Text, Zugriffstasten, Tastenkombinationen und kaskadierende Menüs.
Die folgenden Elemente sind speziell darauf ausgelegt, nahtlos mit beiden ToolStripSystemRenderer und ToolStripProfessionalRenderer in allen Ausrichtungen zu arbeiten. Sie sind standardmäßig zur Entwurfszeit für das ContextMenuStrip Steuerelement verfügbar:
Generische Features von ToolStrip
In den folgenden Themen werden Features und Verhalten beschrieben, die generisch für die ToolStrip und abgeleiteten Steuerelemente sind.
Gemälde
Sie können benutzerdefiniertes Malen in ToolStrip Steuerelementen auf verschiedene Arten ausführen. Wie bei anderen Windows Forms-Steuerelementen verfügen sowohl die ToolStrip als auch die ToolStripItem über überschreibbare OnPaint
Methoden und Paint
Ereignisse. Wie bei der regulären Malerei ist das Koordinatensystem relativ zum Clientbereich des Steuerelements; d. h. die obere linke Ecke des Steuerelements ist 0, 0. Das Paint
Ereignis und die OnPaint
Methode für ein ToolStripItem verhalten sich wie andere Steuerelement-Zeichenereignisse.
Die ToolStrip Steuerelemente bieten außerdem einen feineren Zugriff auf das Rendern der Elemente und des Containers über die ToolStripRenderer Klasse, die überschreibbare Methoden zum Zeichnen des Hintergrunds, des Elementhintergrunds, des Elementbilds, des Elementpfeils, des Elementtexts und des Rahmens des ToolStripElements verfügt. Die Ereignisargumente für diese Methoden machen mehrere Eigenschaften verfügbar, z. B. Rechtecke, Farben und Textformate, die Sie nach Bedarf anpassen können.
Wenn Sie nur einige Aspekte der Bemalung eines Objekts anpassen möchten, überschreiben Sie typischerweise die ToolStripRenderer.
Wenn Sie ein neues Element schreiben und alle Aspekte des Gemäldes steuern möchten, überschreiben Sie die OnPaint
Methode. Innerhalb von OnPaint
können Sie Methoden von ToolStripRenderer verwenden.
Standardmäßig wird die ToolStrip doppelt gepuffert, wobei die OptimizedDoubleBuffer Einstellung genutzt wird.
Erziehung
Das Konzept des Besitzes und der hierarchischen Beziehungen von Containern ist bei ToolStrip-Steuerelementen komplexer als bei anderen Windows Forms-Containersteuerelementen. Dies ist erforderlich, um dynamische Szenarien wie Überlauf, Freigabe von Dropdownelementen über mehrere ToolStrip Elemente hinweg zu unterstützen und um die Generierung eines ContextMenuStrip aus einem Steuerelement zu ermöglichen.
In der folgenden Liste werden Mitglieder im Zusammenhang mit der Elternschaft beschrieben und deren Verwendung erläutert.
OwnerItem greift auf das Element zu, das die Quelle des Dropdownelements ist. Dies ähnelt SourceControl, aber statt eines Steuerelements gibt es ein ToolStripItem zurück.
SourceControl bestimmt, welches Steuerelement die Quelle ist ContextMenuStrip, wenn mehrere Steuerelemente dasselbe ContextMenuStrip verwenden.
GetCurrentParent ist ein schreibgeschützter Accessor für die Parent Eigenschaft. Ein Elternteil unterscheidet sich von einem Besitzer darin, dass ein Elternteil die zurückgegebene aktuelle Ansicht ToolStrip angibt, in der das Element angezeigt wird, das sich möglicherweise im Überlaufbereich befindet.
Owner gibt das ToolStrip zurück, dessen Item-Auflistung die aktuelle ToolStripItem enthält. Dies ist die beste Möglichkeit, auf ImageList oder andere Eigenschaften in der obersten Ebene ToolStrip zu verweisen, ohne speziellen Code zum Behandeln von Überlauf zu schreiben.
Verhalten von geerbten Steuerelementen
Die folgenden Steuerelemente sind gesperrt, wenn sie in der Vererbung verwendet werden:
ToolStripPanel das die Panels in einem ToolStripContainer und auch einzelne ToolStripPanel Steuerelemente enthält.
Erstellen Sie beispielsweise eine neue Windows Forms-Anwendung mithilfe eines oder mehrerer Steuerelemente in der vorherigen Liste. Legen Sie den Zugriffsmodifizierer eines oder mehrerer Steuerelemente auf public
oder protected
, und erstellen Sie dann das Projekt. Fügen Sie ein Formular hinzu, das vom ersten Formular erbt, und wählen Sie dann ein geerbtes Steuerelement aus. Das Steuerelement wird gesperrt angezeigt und verhält sich so, als ob der Zugriffsmodifizierer private
wäre.
ToolStripContainer-Unterstützung der Vererbung
Das ToolStripContainer Steuerelement unterstützt eingeschränkte geerbte Szenarien, ähnlich dem folgenden Beispiel:
Erstellen Sie eine neue Windows Forms-Anwendung.
Fügen Sie dem Formular ToolStripContainer hinzu.
Setzen Sie den Zugriffsmodifizierer von ToolStripContainer auf
public
oderprotected
.Fügen Sie eine beliebige Kombination aus ToolStrip, MenuStripund ContextMenuStrip Steuerelementen zu den ToolStripPanel Bereichen der ToolStripContainer.
Projekt erstellen.
Fügen Sie ein Formular hinzu, das vom ersten Formular erbt.
Wählen Sie das geerbte ToolStripContainer im Formular aus.
Geerbtes Verhalten von untergeordneten Steuerelementen
Nachdem Sie die vorherigen Schritte abgeschlossen haben, tritt das folgende geerbte Verhalten auf:
Im Designer wird das Steuerelement mit einem geerbten Symbol angezeigt.
Die ToolStripPanel Steuerelemente sind gesperrt. Sie können deren Inhalt nicht auswählen oder neu anordnen.
Sie können Steuerelemente zum ToolStripContentPanel hinzufügen, die Steuerelemente verschieben und untergeordnete Steuerelemente des ToolStripContentPanel erstellen.
Ihre Änderungen bleiben nach dem Erstellen des Formulars erhalten.
Hinweis
Entfernen Sie die Zugriffsmodifizierer aus allen ToolStripPanel Steuerelementen, die Teil eines Steuerelements ToolStripContainersind. Der Zugriffsmodifizierer der ToolStripContainer steuert das gesamte Steuerelement.
Partielle Vertrauensstellung
Die Einschränkungen von ToolStrip
s unter teilweisem Vertrauen sind so ausgelegt, dass die versehentliche Eingabe personenbezogener Informationen verhindert wird, die von unbefugten Personen oder Diensten genutzt werden könnten. Die Schutzmaßnahmen sind wie folgt:
ToolStripDropDown
-Steuerelemente erfordern AllWindows, um Elemente in einem ToolStripControlHost anzuzeigen. Dies gilt sowohl für systeminterne Steuerelemente wie ToolStripTextBox, ToolStripComboBoxals ToolStripProgressBar auch für vom Benutzer erstellte Steuerelemente. Wenn diese Anforderung nicht erfüllt ist, werden diese Elemente nicht angezeigt. Es wird keine Ausnahme ausgelöst.Das Festlegen der AutoClose-Eigenschaft auf
false
ist nicht erlaubt, und der stornierbare Closing-Ereignisparameter wird ignoriert. Dadurch ist es unmöglich, mehr als einen Tastenanschlag einzugeben, ohne das Dropdownelement zu verwerfen. Wenn diese Anforderung nicht erfüllt ist, werden diese Elemente nicht angezeigt. Es wird keine Ausnahme ausgelöst.Viele Tastatureingabebehandlungsereignisse werden nicht ausgelöst, wenn sie in teilweisen Vertrauenskontexten auftreten, die nicht AllWindows sind.
Zugriffstasten werden nicht verarbeitet, wenn AllWindows nicht gewährt wird.
Verwendung
Die folgenden Verwendungsmuster wirken sich auf ToolStrip Layout, Tastaturinteraktion und Endbenutzerverhalten aus:
Beigetreten in einer ToolStripPanel
Das ToolStrip kann innerhalb des ToolStripPanel und über ToolStripPanels hinweg neu positioniert werden. Die
Dock
Eigenschaft wird ignoriert, und wenn die Stretch Eigenschaftfalse
ist, wächst die Größe der ToolStrip, wenn Elemente zu ToolStripPanel hinzugefügt werden. In der Regel ist ToolStrip nicht Teil der Tabulatorreihenfolge.Angedockt
Das ToolStrip Objekt wird an einer Seite eines Containers an einer festen Position platziert, und seine Größe wird über den gesamten Rand erweitert, an dem er verankert ist. In der Regel ist ToolStrip nicht Teil der Tabulatorreihenfolge.
Absolut positioniert
Das ToolStrip ist wie andere Steuerelemente, da es von der Location Eigenschaft platziert wird, eine feste Größe aufweist und in der Regel an der Tab-Reihenfolge teilnimmt.
Tastaturinteraktion
Zugriffstasten
In Kombination mit oder nach der ALT-Taste sind Zugriffstasten eine Möglichkeit, ein Steuerelement mithilfe der Tastatur zu aktivieren.
ToolStrip unterstützt sowohl explizite als auch implizite Zugriffstasten. Explizite Definition verwendet ein kaufmännisches Und-Zeichen (&) vor dem Buchstaben. Die implizite Definition verwendet einen Algorithmus, der versucht, ein übereinstimmende Element basierend auf der Reihenfolge der Zeichen in einer bestimmten Text
Eigenschaft zu finden.
Tastenkombinationen
Die Tastenkombinationen einer MenuStrip werden durch die Kombination der Keys-Aufzählung (die nicht ordnungsspezifisch ist) definiert. Sie können die ShortcutKeyDisplayString-Eigenschaft auch verwenden, um ein Tastenkürzel nur mit Text anzuzeigen, z. B. "Entf" anstelle von "Löschen".
Navigationssystem
Die Alt-Taste aktiviert die Funktion, die mit MenuStrip von MainMenuStrip verknüpft ist. Von dort navigiert STRG+TAB zwischen ToolStrip Steuerelementen innerhalb der ToolStripPanel
s. Die TAB-TASTE und die Pfeiltasten auf der Zehnertastatur navigieren zwischen Elementen in einem ToolStrip. Ein spezieller Algorithmus behandelt die Navigation im Überlaufbereich. LEERTASTE wählt ein ToolStripButton, ToolStripDropDownButton, oder ToolStripSplitButton.
Fokus und Validierung
Bei Aktivierung durch die ALT-Taste nehmen MenuStrip oder ToolStrip im Allgemeinen weder den Fokus auf, noch entfernen sie ihn von dem Steuerelement, das derzeit den Fokus hat. Wenn ein Steuerelement in der MenuStrip oder in einem Dropdown-Menü des MenuStrip gehostet wird, erhält das Steuerelement den Fokus, wenn der Benutzer die TAB-TASTE drückt. Im Allgemeinen werden die Ereignisse GotFocus, LostFocus, Enter und Leave von MenuStrip möglicherweise nicht ausgelöst, wenn sie von der Tastatur aktiviert werden. Verwenden Sie in solchen Fällen stattdessen die MenuActivate- und MenuDeactivate-Ereignisse.
Standardmäßig ist CausesValidationfalse
. Rufen Sie Validate explizit auf Ihrem Formular auf, um eine Überprüfung durchzuführen.
Gestaltung
Sie steuern das Layout von ToolStrip, indem Sie ein Mitglied von ToolStripLayoutStyle mit der Eigenschaft LayoutStyle auswählen.
Stapellayouts
Stapeln ist das Anordnen von Elementen nebeneinander an beiden Enden der ToolStrip. In der folgenden Liste werden die Stapellayouts beschrieben.
StackWithOverflow ist die Standardeinstellung. Diese Einstellung bewirkt, dass das ToolStrip Layout automatisch entsprechend der Orientation Eigenschaft geändert wird, um Zieh- und Andockszenarien zu verarbeiten.
VerticalStackWithOverflow Rendert die ToolStrip Elemente nebeneinander vertikal.
HorizontalStackWithOverflow Rendert die ToolStrip Elemente nebeneinander horizontal.
Weitere Features von Stapellayouts
Alignment bestimmt das Ende des ToolStrip, zu dem das Objekt ausgerichtet ist.
Wenn Elemente nicht in ToolStrip passen, erscheint automatisch eine Überlaufschaltfläche. Die Overflow Eigenschaftseinstellung bestimmt, ob ein Element im Überlaufbereich immer, nach Bedarf oder nie angezeigt wird.
Im LayoutCompleted Ereignis können Sie die Placement Eigenschaft überprüfen, um festzustellen, ob ein Element im Hauptbereich ToolStrip, im Überlaufbereich ToolStrip oder derzeit überhaupt nicht angezeigt wird. Die typischen Gründe, warum ein Element nicht angezeigt wird, sind, dass das Element nicht in den Hauptteil ToolStrip passt und seine Overflow Eigenschaft auf Never gesetzt war.
Machen Sie eine ToolStrip beweglich, indem Sie sie in eine ToolStripPanel legen und GripStyle auf Visible setzen.
Weitere Layoutoptionen
Die anderen Layoutoptionen sind Flow und Table.
Flow-Layout
Flow Layout ist die Standardeinstellung für ContextMenuStrip, ToolStripDropDownMenuund ToolStripOverflow. Es ist vergleichbar mit dem FlowLayoutPanel. Die Layoutfunktionen Flow sind wie folgt:
Alle Funktionen von FlowLayoutPanel werden durch die LayoutSettings-Eigenschaft verfügbar gemacht. Sie müssen die LayoutSettings Klasse in eine FlowLayoutSettings Klasse umwandeln.
Mit den Dock Eigenschaften und Anchor Eigenschaften im Code können Sie die Elemente innerhalb der Zeile ausrichten.
Die Alignment Eigenschaft wird ignoriert.
Im Falle des LayoutCompleted Ereignisses können Sie die Placement Eigenschaft inspizieren, um zu bestimmen, ob ein Element auf dem Hauptbereich ToolStrip platziert wurde oder nicht hineinpasst.
Der Griff wird nicht gerendert und daher kann ein ToolStrip im Flow Layoutstil in einem ToolStripPanel nicht verschoben werden.
Die ToolStrip Überlauf-Schaltfläche wird nicht gerendert und Overflow ignoriert.
Tabellenaufbau
Table Layout ist die Standardeinstellung für StatusStrip. Es ist ähnlich wie TableLayoutPanel. Die Layoutfunktionen Flow sind wie folgt:
Alle Funktionen von TableLayoutPanel werden durch die LayoutSettings-Eigenschaft verfügbar gemacht. Sie müssen die LayoutSettings Klasse in eine TableLayoutSettings Klasse umwandeln.
Mit den Dock Eigenschaften und Anchor Eigenschaften im Code können Sie die Elemente in der Tabellenzelle ausrichten.
Die Alignment Eigenschaft wird ignoriert.
Im Falle des LayoutCompleted Ereignisses können Sie die Placement Eigenschaft inspizieren, um zu bestimmen, ob ein Element auf dem Hauptbereich ToolStrip platziert wurde oder nicht hineinpasst.
Der Griff wird nicht gerendert und daher kann ein ToolStrip im Table Layoutstil in einem ToolStripPanel nicht verschoben werden.
Die ToolStrip Überlauf-Schaltfläche wird nicht gerendert und Overflow ignoriert.
ToolStripItem
In den folgenden Themen werden ToolStripItem und die Steuerelemente beschrieben, die daraus abgeleitet sind.
ToolStripItem ist die abstrakte Basisklasse für alle Elemente, die in eine ToolStrip. Das folgende Objektmodell zeigt die ToolStripItem Vererbungshierarchie.
ToolStripItem-Klassen erben entweder direkt von ToolStripItem, oder sie erben indirekt von ToolStripItem durch ToolStripControlHost oder ToolStripDropDownItem.
ToolStripItem Steuerelemente müssen in einem ToolStrip, MenuStrip, StatusStrip oder ContextMenuStrip enthalten sein und können nicht direkt zu einem Formular hinzugefügt werden. Die verschiedenen Containerklassen sind so konzipiert, dass sie eine entsprechende Teilmenge von ToolStripItem Steuerelementen enthalten.
In der folgenden Tabelle sind die Bestandssteuerelemente ToolStripItem und die Container aufgeführt, in denen sie am besten aussehen. Obwohl jedes ToolStrip Element in einem beliebigen ToolStripabgeleiteten Container gehostet werden kann, wurden diese Elemente so konzipiert, dass sie in den folgenden Containern am besten aussehen:
Hinweis
ToolStripDropDown wird nicht in der Designer-Toolbox angezeigt.
Enthaltenes Element | ToolStrip | MenuStrip | ContextMenuStrip | StatusStrip | ToolStripDropDown |
---|---|---|---|---|---|
ToolStripButton | Ja | Nein | Nein | Nein | Ja |
ToolStripComboBox | Ja | Ja | Ja | Nein | Ja |
ToolStripSplitButton | Ja | Nein | Nein | Ja | Ja |
ToolStripLabel | Ja | Nein | Nein | Ja | Ja |
ToolStripSeparator | Ja | Ja | Ja | Nein | Ja |
ToolStripDropDownButton | Ja | Nein | Nein | Ja | Ja |
ToolStripTextBox | Ja | Ja | Ja | Nein | Ja |
ToolStripMenuItem | Nein | Ja | Ja | Nein | Nein |
ToolStripStatusLabel | Nein | Nein | Nein | Ja | Nein |
ToolStripProgressBar | Ja | Nein | Nein | Ja | Nein |
ToolStripControlHost | Ja | Ja | Nein | Ja | Ja |
ToolStripButton
ToolStripButton ist das Schaltflächenelement für ToolStrip. Sie können sie mit verschiedenen Rahmenarten anzeigen und sie verwenden, um Betriebszustände darzustellen und zu aktivieren. Sie können es auch so definieren, dass es standardmäßig den Fokus hat.
ToolStripLabel
Das ToolStripLabel bietet Bezeichnungsfunktionen in ToolStrip-Steuerelementen an. Das ToolStripLabel ist wie ein ToolStripButton, das standardmäßig nicht den Fokus erhält und nicht als gedrückt oder hervorgehoben dargestellt wird.
ToolStripLabel als gehostetes Element unterstützt Zugriffsschlüssel.
Verwenden Sie die LinkColor, LinkVisited und LinkBehavior Eigenschaften in einem ToolStripLabel zur Unterstützung der Linksteuerung in einem ToolStrip.
ToolStripStatusLabel (Statusleisten-Beschriftung)
ToolStripStatusLabel ist eine speziell für die Verwendung in ToolStripLabel entwickelte Version von StatusStrip. Zu den speziellen Merkmalen gehören BorderStyle, BorderSidesund Spring.
ToolStripSeparator
Das ToolStripSeparator fügt einer Symbolleiste oder einem Menü, je nach Ausrichtung, eine vertikale oder horizontale Linie hinzu. Sie stellt eine Gruppierung oder Unterscheidung zwischen Elementen bereit, z. B. elemente in einem Menü.
Sie können ein ToolStripSeparator zur Entwurfszeit einfügen, indem Sie es aus einer Dropdown-Liste auswählen. Sie können jedoch auch automatisch ein ToolStripSeparator durch Eingabe eines Bindestrichs (-) im Knoten der Designvorlage oder in der Methode Add erstellen.
ToolStripControlHost
ToolStripControlHost ist die abstrakte Basisklasse für ToolStripComboBox, ToolStripTextBoxund ToolStripProgressBar. ToolStripControlHost kann andere Steuerelemente, einschließlich benutzerdefinierter Steuerelemente, auf zwei Arten hosten:
Erstellen Sie ein ToolStripControlHost mit einer Klasse, die von Control abgeleitet ist. Um vollständig auf das gehostete Steuerelement und die gehosteten Eigenschaften zuzugreifen, müssen Sie die Control Eigenschaft wieder in die tatsächliche Klasse umwandeln, die sie darstellt.
Erweitern Sie ToolStripControlHost, und im parameterlosen Konstruktor der abgeleiteten Klasse rufen Sie den Basisklassenkonstruktor auf, indem Sie eine Klasse instanziieren, die von Control abgeleitet ist. Mit dieser Option können Sie allgemeine Steuerelementmethoden und -eigenschaften in einem ToolStrip bündeln, um einen einfachen Zugriff zu ermöglichen.
ToolStripComboBox
ToolStripComboBox ist die für das Hosting in einer ComboBox optimierte ToolStrip. Eine Teilmenge der Eigenschaften und Ereignisse des gehosteten Steuerelements wird auf der ToolStripComboBox Ebene verfügbar gemacht, aber auf das zugrunde liegende ComboBox Steuerelement kann über die ComboBox Eigenschaft vollständig zugegriffen werden.
ToolStripTextBox
ToolStripTextBox ist die für das Hosting in einer TextBox optimierte ToolStrip. Eine Teilmenge der Eigenschaften und Ereignisse des gehosteten Steuerelements wird auf der ToolStripTextBox Ebene verfügbar gemacht, aber auf das zugrunde liegende TextBox Steuerelement kann über die TextBox Eigenschaft vollständig zugegriffen werden.
ToolStrip-Fortschrittsleiste
ToolStripProgressBar ist die für das Hosting in einer ProgressBar optimierte ToolStrip. Eine Teilmenge der Eigenschaften und Ereignisse des gehosteten Steuerelements wird auf der ToolStripProgressBar Ebene verfügbar gemacht, aber auf das zugrunde liegende ProgressBar Steuerelement kann über die ProgressBar Eigenschaft vollständig zugegriffen werden.
ToolStripDropDownElement
ToolStripDropDownItem ist die abstrakte Basisklasse für ToolStripMenuItem, ToolStripDropDownButtonund ToolStripSplitButton, die Elemente direkt hosten oder zusätzliche Elemente in einem Dropdowncontainer hosten kann. Sie tun dies, indem Sie die DropDown-Eigenschaft auf eine ToolStripDropDown-Wert einstellen und die Items-Eigenschaft von ToolStripDropDown festlegen. Greifen Sie direkt über die DropDownItems Eigenschaft auf diese Dropdownelemente zu.
ToolStripMenuItem
ToolStripMenuItem ist eine ToolStripDropDownItem, die mit ToolStripDropDownMenu und ContextMenuStrip zusammenarbeitet, um die spezielle Hervorhebung, das Layout und die Spaltenanordnung für Menüs zu behandeln.
ToolStrip-Dropdown-Schaltfläche
ToolStripDropDownButton sieht wie ToolStripButtonaus, zeigt aber einen Dropdownbereich an, wenn der Benutzer darauf klickt. Blenden Sie den Dropdownpfeil aus, oder zeigen Sie den Dropdownpfeil an, indem Sie die ShowDropDownArrow Eigenschaft festlegen. ToolStripDropDownButton hostet ein ToolStripOverflowButton, das Elemente anzeigt, die über die ToolStrip hinausgehen.
ToolStripSplitButton
ToolStripSplitButton kombiniert die Funktionalität von Schaltflächen und Dropdown-Schaltflächen.
Verwenden Sie die DefaultItem Eigenschaft, um das Click Ereignis des ausgewählten Dropdownelements mit dem auf der Schaltfläche angezeigten Element zu synchronisieren.
Generische Features von ToolStripItem
ToolStripItem stellt die folgenden generischen Features und Optionen zum Erben von Steuerelementen bereit:
Kernereignisse
Bildverarbeitung
Ausrichtung
Text- und Bildbeziehung
Anzeigestil
Kernereignisse
ToolStripItem Steuerelemente erhalten eigene Klick-, Maus- und Paint-Ereignisse und können auch einige Tastaturvorverarbeitungen ausführen.
Bildverarbeitung
Die Image, ImageAlign, ImageIndex, ImageKeyund ImageScaling Eigenschaften beziehen sich auf verschiedene Aspekte der Bildverarbeitung. Verwenden Sie Bilder in ToolStrip Steuerelementen, indem Sie diese Eigenschaften direkt oder durch Festlegen der Nur-Laufzeit-Eigenschaft ImageList festlegen.
Die Bildskalierung wird durch die Interaktion von Eigenschaften in beiden ToolStrip und ToolStripItemwie folgt bestimmt:
ImageScalingSize ist die Skalierung des endgültigen Bildes, bestimmt durch die Kombination der Einstellung des ImageScaling Bildes und der Einstellung des Containers AutoSize.
Wenn AutoSize
true
(Standard) ist und ToolStripItemImageScalingSizeToFit ist, erfolgt keine Bildskalierung, und die Größe von ToolStrip entspricht der des größten Elements oder einer vorgeschriebenen Mindestgröße.Wenn AutoSize
false
ist und ToolStripItemImageScalingNone ist, tritt weder die Bild- noch die ToolStrip-Skalierung auf.
Ausrichtung
Der Wert der Alignment Eigenschaft bestimmt das Ende des ToolStrip Elements, an dem ein Objekt angezeigt wird. Die Alignment Eigenschaft funktioniert nur, wenn das Layoutformat der ToolStrip Eigenschaft auf einen der Stapelüberlaufwerte festgelegt ist.
Elemente werden auf der ToolStrip in der Reihenfolge platziert, wie sie in der Elemente-Sammlung erscheinen. Wenn Sie programmgesteuert ändern möchten, wo ein Element angeordnet ist, verwenden Sie die Insert Methode, um das Element in der Auflistung zu verschieben. Diese Methode verschiebt das Element, dupliziert es jedoch nicht.
Text- und Bildbeziehung
Die TextImageRelation Eigenschaft definiert die relative Platzierung des Bilds in Bezug auf den Text in einem ToolStripItem. Elemente mit fehlendem Bild, Text oder beides werden als Sonderfälle behandelt, sodass für ToolStripItem das fehlende Element oder die fehlenden Elemente keine leere Stelle angezeigt wird.
Anzeigeformat
DisplayStyle ermöglicht es Ihnen, die Werte der Text- und Bildeigenschaften eines Elements festzulegen, während nur das gewünschte Element angezeigt wird. Dies wird in der Regel verwendet, um nur die Anzeigeformatvorlage zu ändern, wenn dasselbe Element in einem anderen Kontext angezeigt wird.
Zubehörklassen
Klassen, die verschiedene andere Funktionen bereitstellen, umfassen:
ToolStripManager unterstützt ToolStrip-bezogene Aufgaben für ganze Anwendungen, z. B. Zusammenführen, Einstellungen und Rendereroptionen.
ToolStripRenderer ermöglicht es Ihnen, eine bestimmte Stilrichtung oder ein bestimmtes Thema ganz einfach auf ToolStrip anzuwenden.
ToolStripProfessionalRenderer erstellt Stifte und Pinsel basierend auf einer austauschbaren Farbtabelle (ProfessionalColorTable).
ToolStripSystemRenderer wendet Systemfarben und einen flachen visuellen Stil auf ToolStrip Anwendungen an.
ToolStripContainer ist ähnlich wie SplitContainer. Es verwendet vier angedockte Seitenbereiche (Instanzen von ToolStripPanel) und ein zentrales Panel (eine Instanz von ToolStripContentPanel) zum Erstellen einer typischen Anordnung. Sie können die Seitenbereiche nicht entfernen, aber Sie können sie ausblenden. Sie können den zentralen Bereich weder entfernen noch ausblenden. Sie können ein oder mehrere ToolStrip-, MenuStrip- oder StatusStrip-Steuerelemente in den Seitenbereichen anordnen und den zentralen Bereich für andere Steuerelemente verwenden. Dies ToolStripContentPanel bietet auch eine Möglichkeit, Renderer-Unterstützung in den Hauptteil Ihres Formulars zu erhalten, um ein einheitliches Erscheinungsbild zu erzielen. ToolStripContainer unterstützt nicht mehrere Dokumentschnittstellen (MDI).
ToolStripPanel bietet Platz zum Verschieben und Anordnen von ToolStrip Steuerelementen. Sie können nur ein Panel verwenden, wenn Sie sich dafür entscheiden, und ToolStripPanel funktioniert in MDI-Szenarien gut.
Siehe auch
.NET Desktop feedback