Barra desplegableDrop-down bar

La barra desplegable se proporciona en la parte superior de la ventana de código y contiene dos listas desplegables.The drop-down bar is provided at the top of the code window and contains two drop-down lists.

En Visual C++Visual C++, por ejemplo, la barra de la lista desplegable contiene listas para Visual C++Visual C++ elementos y Visual C++Visual C++ funciones miembro de los elementos, como se muestra en la siguiente imagen.In Visual C++Visual C++, for example, the drop-down bar contains lists for Visual C++Visual C++ Items and Visual C++Visual C++ Items Member Functions, as shown in the following picture.

Quitar-abajo barrasDrop-down Bars
Barra desplegableDrop-down bar

Al implementar una barra desplegable, hay cuatro interfaces de importancia primordial:When implementing a drop-down bar, there are four interfaces of primary importance:

  • IVsDropdownBarClient

    Implemente esta interfaz para insertar el contenido de la barra desplegable.Implement this interface to insert the content of the drop-down bar. Cada combinación de la lista desplegable puede contener texto sin formato o texto decorativo (negrita, subrayado o cursiva), puede tener el color de fuente del texto de ventana o color de fuente gris y, opcionalmente, puede proporcionar un mapa de bits pequeño situado junto al elemento de lista desplegable.Each drop-down combination can contain plain text or fancy text (bold, underline, or italic), can have window text font coloring or grayed out font coloring, and can optionally provide a small bitmap next to the drop-down item. Similar a la IVsCompletionSet interfaz, las imágenes de mapa de bits se proporcionan en las listas de imágenes.Similar to the IVsCompletionSet interface, bitmap images are provided in image lists. Cada combinación de la lista desplegable puede tener una lista de imágenes diferentes; Sin embargo, cada lista de imágenes debe contener las imágenes de la misma altura.Each drop-down combination can have a different image list; however, each image list must contain images of the same height. Además, el uso de la GetComboTipText método, puede proporcionar información sobre herramientas para cada combinación.Additionally, using the GetComboTipText method, you can provide a tooltip for each combination.

  • IVsDropdownBarManager

    Llame a esta interfaz para crear o destruir la barra desplegable para una ventana de código.Call this interface to either create or destroy the drop-down bar for a code window. También puede utilizarse para determinar si una barra desplegable ya está asociada a una ventana de código mediante una llamada a esta interfaz la GetDropdownBar método.This interface can also be used to determine whether a drop-down bar is already attached to a code window by calling the GetDropdownBar method. Llame a QueryInterface para IVsDropdownBarManager desde IVsCodeWindow.Call QueryInterface for IVsDropdownBarManager from IVsCodeWindow.

  • IVsDropdownBar

    Llame a esta interfaz para comunicarse directamente con la barra desplegable.Call this interface to communicate directly with the drop-down bar. Puede usar esta interfaz para forzar una actualización de la lista desplegable de la barra contenido o para cambiar la selección de uno de los cuadros de lista.You can use this interface to force a refresh of the drop-down bar contents or to change the selection in one of the list boxes.

  • IVsTextManagerEvents

    Si se ha registrado el ShowDropdownBarOption en la clave del registro del servicio de lenguaje, a continuación, el Administrador de ventanas de código debe supervisar este evento para sincronizar con las preferencias del usuario con respecto a si se debe mostrar la barra desplegable.If you have registered the ShowDropdownBarOption in your language service registry key, then your code window manager must monitor this event to synchronize with user preferences regarding whether the drop-down bar should be displayed. Si no registra esta opción en la clave de servicio de lenguaje, a continuación, la opción para mostrar u ocultar la barra desplegable está deshabilitada en el opciones menú.If you do not register this option in your language service key, then the option to show or hide the drop-down bar is disabled on the Options menu.

Adjuntar una barra desplegable a una ventana de códigoAttach a drop-down bar to a code window

Para adjuntar una barra desplegable a la ventana de código cuando se crea, un servicio de lenguaje se debe asociar a la lista desplegable barra cuando el AddAdornments se llama al método.To attach a drop-down bar to the code window when it is created, a language service should attach to the drop-down bar when the AddAdornments method is called. Si una llamada a la GetDropdownBar método indica que una barra desplegable ya no existe, a continuación, llamar a AddDropdownBar.If a call to the GetDropdownBar method indicates that a drop-down bar does not already exist, then call AddDropdownBar. Para tener acceso a la IVsDropdownBarManager interfaz, llame a QueryInterface desde el IVsCodeWindow puntero devuelto cuando su IVsCodeWindowManager implementación se ha adjuntado.To access the IVsDropdownBarManager interface, call QueryInterface from the IVsCodeWindow pointer returned to you when your IVsCodeWindowManager implementation was attached.

Vea tambiénSee also

Personalizar las ventanas de código mediante el uso de la API heredada Customize code windows by using the legacy API
Compatibilidad con la barra de navegación en un servicio de lenguaje heredadoSupport for the Navigation bar in a legacy language service