Comandos, menús y barras de herramientas

Los menús y las barras de herramientas son la forma en que los usuarios acceden a los comandos en vsPackage. Los comandos son funciones que realizan tareas, como imprimir un documento, actualizar una vista o crear un nuevo archivo. Los menús y las barras de herramientas son formas gráficas cómodas de presentar los comandos a los usuarios. Normalmente, los comandos relacionados se agrupan en clústeres en el mismo menú o barra de herramientas.

Normalmente, los menús se muestran como cadenas de una sola palabra agrupadas en una fila en la parte superior del entorno de desarrollo integrado (IDE) o una ventana de herramientas. Los menús también se pueden mostrar como resultado de un evento de clic derecho y se conocen como menús contextuales en ese contexto. Al hacer clic en ellos, los menús se expanden para mostrar uno o varios comandos. Los comandos, cuando se hace clic, pueden llevar a cabo tareas o iniciar submenús que contienen comandos adicionales. Algunos nombres de menú conocidos son Archivo, Editar, Ver y Ventana. Para obtener más información, vea Extender menús y comandos.
Las barras de herramientas suelen ser filas de botones y otros controles, como cuadros combinados, cuadros de lista, cuadros de texto y controladores de menú. Todos los controles de barra de herramientas están asociados a comandos. Al hacer clic en un botón de barra de herramientas, se activa su comando asociado. Los botones de la barra de herramientas suelen tener iconos que sugieren los comandos subyacentes, como una impresora para un comando Imprimir. En un control de lista desplegable, cada elemento de la lista está asociado a un comando diferente. Un controlador de menú es un híbrido en el que un lado del control es un botón de barra de herramientas y el otro lado es una flecha hacia abajo que muestra comandos adicionales cuando se hace clic en él. Para obtener más información, vea Agregar un controlador de menú a una barra de herramientas.
Al crear un comando, también debe crear un controlador de eventos para él. El controlador de eventos determina cuándo el comando está visible o habilitado, le permite modificar su texto y garantiza que el comando responda correctamente ("rutas") cuando se activa. En la mayoría de los casos, el IDE controla los comandos mediante la IOleCommandTarget interfaz . Los comandos de Visual Studio se enrutan de forma jerárquica, comenzando con el contexto de comandos más interno, basado en la selección local, y procediendo al contexto más externo, basado en la selección global. Los comandos agregados al menú principal están disponibles inmediatamente para el scripting. Para obtener más información, vea MenuCommands vs. OleMenuCommands y Objetos de selección de contexto.

Para definir nuevos menús y barras de herramientas, debe describirlos en un archivo de tabla de comandos (.vsct) de Visual Studio. La plantilla de paquete de Visual Studio crea este archivo automáticamente, junto con los elementos necesarios para admitir los comandos, las barras de herramientas y los editores seleccionados en la plantilla. Como alternativa, puede escribir su propio archivo .vsct mediante el esquema XML que se describe aquí: Referencia de esquema XML de VSCT.

Para obtener más información sobre cómo trabajar con archivos .vsct, vea Archivos de tabla de comandos de Visual Studio (.vsct).

En los temas de esta sección se explica cómo funcionan los comandos, menús y barras de herramientas en VSPackages.