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 , , Combo Menu |
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 , , Combo Menu |
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 , , Combo Menu |
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 , , Combo Menu |
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. |