Barra de la lista desplegableDrop-down Bar

La barra de la lista 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 las listas de Visual C++Visual C++ elementos y Visual C++Visual C++ funciones de 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 de la lista desplegableDrop-down bar

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

  • IVsDropdownBarClient

    Implemente esta interfaz para insertar el contenido de la barra de la lista 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, imágenes de mapa de bits se proporcionan en 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 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, para usar el 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 de la lista desplegable de una ventana de código.Call this interface to either create or destroy the drop-down bar for a code window. Esta interfaz también puede utilizarse para determinar si una barra desplegable ya está conectada a una ventana de código mediante una llamada a 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 de IVsCodeWindow.Call QueryInterface for IVsDropdownBarManager from IVsCodeWindow.

  • IVsDropdownBar

    Llame a esta interfaz para comunicarse directamente con la barra de la lista desplegable.Call this interface to communicate directly with the drop-down bar. Puede utilizar 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 de la lista 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 del servicio de lenguaje, la opción para mostrar u ocultar la barra de la lista 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 de la lista desplegable para una ventana de códigoAttaching a Drop-Down Bar to a Code Window

Para adjuntar una barra de la lista desplegable a la ventana de código cuando se crea, un servicio de lenguaje debe asociarse 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 de la lista desplegable aún 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 la 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

Personalización de ventanas de código mediante la API heredado Customizing 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