Freigeben über


Befehlskennzeichnungselement

Ändert das übergeordnete Element.

Syntax

<CommandFlag>DynamicVisibility</CommandFlag>

Attribute und Elemente

Im folgenden Abschnitt werden gültige Elementwerte beschrieben.

Attribute

Keine

Untergeordnete Elemente

Wert Beschreibung
AllowParams Gibt an, dass Benutzer Befehlsparameter in das Befehlsfenster eingeben können, wenn sie den kanonischen Namen des Befehls eingeben.

Gültig für: Button
Alwayscreate Das Menü wird auch dann erstellt, wenn es keine Gruppen oder Schaltflächen enthält.

Gültig für: Menu
CaseSensitive Bei Benutzereinträgen wird zwischen Groß- und Kleinschreibung unterschieden.

Gültig für: Combo
CommandWellOnly Wenden Sie dieses Kennzeichen an, wenn der Befehl nicht im Menü der obersten Ebene angezeigt wird und Sie es für zusätzliche Shellanpassungen verfügbar machen möchten, z. B. zum Binden an eine Tastenkombination. Nachdem das VSPackage installiert wurde, können Sie diese Befehle anpassen, indem Sie das Dialogfeld "Optionen " öffnen und dann die Befehlsplatzierung unter der Kategorie "Tastaturumgebung " bearbeiten. Dieses Kennzeichen wirkt sich nicht auf die Platzierung in Kontextmenüs, Symbolleisten, Menücontrollern oder Untermenüs aus.

Gültig für: Button, Combo
DefaultDisabled Der Befehl ist standardmäßig deaktiviert, wenn das VSPackage, das es implementiert, nicht geladen wird oder die QueryStatus Methode nicht aufgerufen wurde.

Gültig für: Button, Combo
DefaultDocked Standardmäßig angedockt. Diese Einstellung gilt nicht mehr für Symbolleisten, da sie immer angedockt sind.
DefaultInvisible Standardmäßig ist der Befehl unsichtbar, wenn das VSPackage, das es implementiert, nicht geladen wird oder die QueryStatus Methode nicht aufgerufen wurde.

Es wird empfohlen, dies mit der DynamicVisibility Kennzeichnung zu kombinieren.

Gültig für: Button, , ComboMenu
DontCache Die Entwicklungsumgebung speichert die QueryStatus Methodenergebnisse für diesen Befehl nicht zwischen.

Bei einem Menü wird ein Menücontroller aufgefordert, den Text seiner Menüelemente nicht zwischenzuspeichern. Verwenden Sie dieses Kennzeichen, wenn das Menü dynamische Elemente oder Elemente mit dynamischem Text enthält.

Gültig für: Button, Menu
DynamicAutomationName Gibt den QueryStatus-Handler an, der auf OLECMDTEXTFEXT_AUTOMATIONNAME reagiert und eine Zeichenfolge zurückgibt, die als Automatisierungsname für Ihr Steuerelement verwendet werden soll. Wenn Sie OleMenuCommand verwenden, können Sie die AutomationName-Eigenschaft in Ihrem BeforeQueryStatus-Handler festlegen, wenn diese Kennzeichnung festgelegt ist.

Bei Verwendung in einem Menüelement gilt dieses Kennzeichen nur für Menüs vom Typ MenuController oder MenuControllerLatched.

Gültig für: Button, , ComboMenu
DynamicItemStart Gibt den Anfang einer dynamischen Liste an. Dadurch kann die Umgebung eine Liste erstellen, indem die QueryStatus Methode für Listenelemente nacheinander aufgerufen wird, bis das OLECMDERR_E_UNSUPPORTED Flag zurückgegeben wird. Dies eignet sich gut für Elemente wie zuletzt verwendete Listen und Fensterlisten.

Gültig für: Button
DynamicVisibility Die Sichtbarkeit des Befehls kann über die QueryStatus Methode oder eine Kontext-GUID geändert werden, die VisibilityConstraints im Abschnitt enthalten ist.

Gilt für Befehle, die in Menüs und Symbolleisten des Toolfensters angezeigt werden, jedoch nicht auf Symbolleisten der obersten Ebene, die im Standard-Fenster angezeigt werden. Symbolleistenelemente der obersten Ebene können deaktiviert, aber nicht ausgeblendet werden, wenn das flag OLECMDF_INVISIBLE von der QueryStatus Methode zurückgegeben wird. Symbolleistenbefehle, die auf Symbolleisten des Toolfensters angezeigt werden, können ausgeblendet werden.

In einem Menü gibt dieses Kennzeichen auch an, dass es automatisch ausgeblendet werden soll, wenn alle elemente ausgeblendet sind. Dieses Flag wird in der Regel Untermenüs zugewiesen, da Menüs der obersten Ebene bereits dieses Verhalten aufweisen.

Diese Kennzeichnung sollte mit der DefaultInvisible Kennzeichnung kombiniert werden.

Gültig für: Button, , ComboMenu
FilterKeys Weitere Informationen finden Sie im Thema "Filterschlüssel" unter "Combo-Element".

Gültig für: Combo
FixMenuController Wenn dieser Befehl auf einem Menücontroller positioniert ist, ist der Befehl immer der Standardwert. d. h. der Befehl wird ausgewählt, wenn die Menücontrollerschaltfläche selbst ausgewählt ist. Wenn der Menücontroller die TextIsAnchorCommand Kennzeichnung festgelegt hat, übernimmt der Menücontroller auch den Text des Befehls mit der FixMenuController Kennzeichnung.

Nur ein Befehl auf einem Menücontroller sollte die FixMenuController Kennzeichnung aufweisen. Wenn mehr als ein Befehl so markiert ist, wird der letzte Befehl im Menü zum Standardbefehl.

Gültig für: Button
IconAndText Zeigen Sie ein Symbol und text im Menü und auf der Symbolleiste an.

Gültig für: Button, , ComboMenu
NoAutoComplete Das Feature "AutoVervollständigen" ist deaktiviert.

Gültig für: Combo
NoButtonCustomize Lassen Sie den Benutzer diese Schaltfläche nicht anpassen.

Gültig für: Button, Combo
NoKeyCustomize Tastaturanpassung nicht aktivieren.

Gültig für: Button, Combo
NoShowOnMenuController Wenn dieser Befehl auf einem Menücontroller positioniert ist, wird der Befehl nicht in der Dropdownliste angezeigt.

Gültig für: Button
NotInTBList Wird nicht in der Liste der verfügbaren Symbolleisten angezeigt. Dies gilt nur für Symbolleistenmenütypen.

Gültig für: Menu
NoToolbarClose Der Benutzer kann die Symbolleiste nicht schließen. Dies gilt nur für Symbolleistenmenütypen.

Gültig für: Menu
Pict Nur ein Symbol auf einer Symbolleiste anzeigen, aber nur Text in einem Menü. Wenn kein Symbol angegeben ist, wird ein klickbarer Leerraum auf einer Symbolleiste angezeigt.

Gültig für: Button
PostExec Macht den Befehl nicht blockierend. Die Ausführung der Entwicklungsumgebung wird zurückgestellt, bis alle Vorverarbeitungsabfragen abgeschlossen sind.

Gültig für: Button
RouteToDocs Der Befehl wird an das aktive Dokument weitergeleitet.

Gültig für: Button
StretchHorizontally Wenn diese Kennzeichnung festgelegt ist, wird die Breite zur Mindestbreite für das Kombinationsfeld, und wenn platz auf der Symbolleiste vorhanden ist, wird das Kombinationsfeld gestreckt, um den verfügbaren Platz zu füllen. Dies tritt nur auf, wenn die Symbolleiste horizontal angedockt ist und nur ein Kombinationsfeld auf der Symbolleiste das Flag verwenden kann (das Flag wird nur für das erste Kombinationsfeld ignoriert).

Gültig für: Combo
TextChanges Der Befehls- oder Menütext kann zur Laufzeit geändert werden, in der Regel über die QueryStatus Methode.

Gültig für: Button, Menu
TextChangesButton Gültig für: Button
TextIsAnchorCommand Bei einem Menücontroller wird der Text des Menüs vom Standardbefehl (Anker) übernommen. Ein Ankerbefehl ist der letzte ausgewählte oder geriegelte Befehl. Wenn dieses Kennzeichen nicht festgelegt ist, verwendet der Menücontroller ein eigenes MenuText Feld. Wenn Sie jedoch auf den Menücontroller klicken, wird der zuletzt ausgewählte Befehl weiterhin vom Controller aus aktiviert.

Es wird empfohlen, diese Kennzeichnung mit der TextChanges Kennzeichnung zu kombinieren.

Dieses Flag gilt nur für Menüs vom Typ "MenuController" oder "MenuControllerLatched".

Gültig für: Menu
TextMenuCtrlUseMenu Verwenden Sie das MenuText Feld auf Menücontrollern. Das Standardfeld ist ButtonText.

Gültig für: Button
TextMenuUseButton Verwenden Sie das ButtonText Feld für Menüs. Das Standardfeld ist MenuText , wenn es angegeben ist.

Gültig für: Button
TextOnly Nur Text auf einer Symbolleiste oder einem Menü anzeigen, aber kein Symbol, auch wenn das Symbol angegeben ist.

Gültig für: Button
TogglePatternAvailable Gibt an, dass Ihre Schaltfläche aktiviert/geriegelt wird (d. a. kann OLEMCDF_LATCHED zurückgeben oder die Checked-Eigenschaft auf OleMenuCommand festlegen). Auf diese Weise kann die Automatisierungsebene das Umschaltmuster verfügbar machen, sodass Bildschirmsprachausgaben den aktivierten/deaktivierten Zustand zusammen mit dem Schaltflächentext lesen.

Gültig für: Button

Übergeordnete Elemente

Element Beschreibung
Buttons-Element Stellt eine Gruppe für Button-Elementelemente bereit.
Menus-Element Definiert alle Menüs, die ein VSPackage implementiert.

Siehe auch