Elemento de marca de comandos

Modifica su elemento primario.

Sintaxis

<CommandFlag>DynamicVisibility</CommandFlag>

Atributos y elementos

En la sección siguiente se describen los valores de elemento válidos.

Atributos

Ninguno.

Elementos secundarios

Value Descripción
AllowParams Indica que los usuarios pueden escribir parámetros de comando en la ventana Comando cuando escriben el nombre canónico del comando.

Válido para: Button
AlwaysCreate El menú se crea incluso si no tiene grupos ni botones.

Válido para: Menu
CaseSensitive Las entradas del usuario distinguen mayúsculas de minúsculas.

Válido para: Combo
CommandWellOnly Aplique esta marca si el comando no aparece en el menú de nivel superior y quiere que esté disponible para la personalización adicional del shell, por ejemplo, para enlazarlo a un método abreviado de teclado. Después de instalar VSPackage, puede personalizar estos comandos abriendo el cuadro de diálogo Opciones y editando la ubicación del comando en la categoría Entorno de teclado. Esta marca no afecta a la colocación en menús contextuales, barras de herramientas, controladores de menú o submenús.

Válido para: Button, Combo
DefaultDisabled De forma predeterminada, el comando está deshabilitado si no se ha cargado el VSPackage que implementa o no se ha llamado al QueryStatus método .

Válido para: Button, Combo
DefaultDocked Acoplado de forma predeterminada. Esta configuración ya no se aplica a las barras de herramientas porque siempre están acopladas.
DefaultInvisible De forma predeterminada, el comando es invisible si no se carga el VSPackage que implementa o no se ha llamado al QueryStatus método .

Se recomienda combinarlo con la DynamicVisibility marca .

Válido para: Button, , ComboMenu
DontCache El entorno de desarrollo no almacena en caché los resultados del QueryStatus método para este comando.

Para un menú, esto indica a un controlador de menú que no almacene en caché el texto de sus elementos de menú. Use esta marca cuando el menú contenga elementos dinámicos o elementos que tengan texto dinámico.

Válido para: Button, Menu
DynamicAutomationName Especifica que el controlador QueryStatus responderá a OLECMDTEXTFEXT_AUTOMATIONNAME y devolverá una cadena que se usará como nombre de automatización del control. Si usa OleMenuCommand, puede establecer la propiedad AutomationName en el controlador BeforeQueryStatus si tiene esta marca establecida.

Cuando se usa en un elemento Menu, esta marca solo se aplica a los menús de tipo MenuController o MenuControllerLatched.

Válido para: Button, , ComboMenu
DynamicItemStart Indica el principio de una lista dinámica. Esto permite que el entorno compile una lista llamando sucesivamente al QueryStatus método en los elementos de lista hasta que se devuelva la marca OLECMDERR_E_UNSUPPORTED. Esto funciona bien para los elementos, como las listas de ventanas y listas de ventanas usadas más recientemente.

Válido para: Button
DynamicVisibility La visibilidad del comando se puede cambiar a través del QueryStatus método o a través de un GUID de contexto que se incluye en la VisibilityConstraints sección .

Se aplica a los comandos que aparecen en menús y barras de herramientas de ventana, pero no en las barras de herramientas de nivel superior que aparecen en la ventana principal. Los elementos de la barra de herramientas de nivel superior se pueden deshabilitar pero no ocultar, cuando se devuelve la QueryStatus marca OLECMDF_INVISIBLE del método . Los comandos de la barra de herramientas que aparecen en las barras de herramientas de la ventana de herramientas se pueden ocultar.

En un menú, esta marca también indica que se debe ocultar automáticamente cuando todos sus miembros están ocultos. Esta marca normalmente se asigna a submenús porque los menús de nivel superior ya tienen este comportamiento.

Esta marca debe combinarse con la DefaultInvisible marca .

Válido para: Button, , ComboMenu
Filterkeys Consulte el tema Filtering Keys (Claves de filtrado) en Combo Element (Elemento combinado).

Válido para: Combo
FixMenuController Si este comando se coloca en un controlador de menú, el comando siempre es el valor predeterminado; es decir, el comando se selecciona cada vez que se selecciona el propio botón del controlador de menús. Si el controlador de menú tiene la TextIsAnchorCommand marca establecida, el controlador de menús también toma su texto del comando que tiene la FixMenuController marca .

Solo un comando de un controlador de menú debe tener la FixMenuController marca . Si hay más de un comando tan marcado, el último comando del menú se convierte en el comando predeterminado.

Válido para: Button
IconAndText Mostrar un icono y texto en el menú y la barra de herramientas.

Válido para: Button, , ComboMenu
NoAutoComplete La característica autocompletar está deshabilitada.

Válido para: Combo
NoButtonCustomize No deje que el usuario personalice este botón.

Válido para: Button, Combo
NoKeyCustomize No habilite la personalización del teclado.

Válido para: Button, Combo
NoShowOnMenuController Si este comando se coloca en un controlador de menú, el comando no aparece en la lista desplegable.

Válido para: Button
NotInTBList No aparece en la lista de barras de herramientas disponibles. Esto solo es válido para los tipos de menú Barra de herramientas.

Válido para: Menu
NoToolbarClose El usuario no puede cerrar la barra de herramientas. Esto solo es válido para los tipos de menú Barra de herramientas.

Válido para: Menu
Pict Mostrar solo un icono en una barra de herramientas, pero solo texto en un menú. Si no se especifica ningún icono, muestra un espacio en blanco en blanco en una barra de herramientas.

Válido para: Button
PostExec Hace que el comando no bloquee. El entorno de desarrollo aplaza la ejecución hasta que se completan todas las consultas de preprocesamiento.

Válido para: Button
RouteToDocs El comando se enruta al documento activo.

Válido para: Button
StretchHorizontally Cuando se establece esta marca, el ancho se convierte en el ancho mínimo del cuadro combinado y, si hay espacio en la barra de herramientas, el cuadro combinado se extiende para rellenar el espacio disponible. Esto solo se produce si la barra de herramientas está acoplada horizontalmente y solo un cuadro combinado de la barra de herramientas puede usar la marca (la marca se omite en todo excepto en el primer cuadro combinado).

Válido para: Combo
TextChanges El texto del menú o comando se puede cambiar en tiempo de ejecución, normalmente a través del QueryStatus método .

Válido para: Button, Menu
TextChangesButton Válido para: Button
TextIsAnchorCommand Para un controlador de menú, el texto del menú se toma del comando predeterminado (delimitador). Un comando de delimitador es el último comando seleccionado o bloqueado. Si no se establece esta marca, el controlador de menú usa su propio MenuText campo. Sin embargo, al hacer clic en el controlador de menús todavía se habilita el último comando seleccionado de ese controlador.

Se recomienda combinar esta marca con la TextChanges marca .

Esta marca solo se aplica a los menús de tipo MenuController o MenuControllerLatched.

Válido para: Menu
TextMenuCtrlUseMenu Use el MenuText campo en los controladores de menú. El campo predeterminado es ButtonText.

Válido para: Button
TextMenuUseButton Use el ButtonText campo para los menús. El campo predeterminado es MenuText si se especifica.

Válido para: Button
TextOnly Muestra solo texto en una barra de herramientas o un menú, pero no hay ningún icono aunque se especifique el icono.

Válido para: Button
TogglePatternAvailable Indica que el botón admite la comprobación o bloqueo temporal (es decir, puede devolver OLEMCDF_LATCHED o establecer la propiedad Checked en OleMenuCommand). Esto permite que la capa de automatización exponga el patrón de alternancia para que los lectores de pantalla lean el estado activado o desactivado junto con el texto del botón.

Válido para: Button

Elementos primarios

Elemento Descripción
Elemento Buttons Proporciona un grupo para los elementos de elemento Button.
Elemento Menus Define todos los menús que implementa un VSPackage.

Consulte también