CToolBarCtrl Class

Artículo
06/10/2015

Proporciona la funcionalidad de controles comunes de la barra de herramientas de Windows.

class CToolBarCtrl : public CWnd

Miembros

Constructores públicos

Name	Descripción
CToolBarCtrl::CToolBarCtrl	Crea un objeto CToolBarCtrl.

Métodos públicos

Name	Descripción
CToolBarCtrl::AddBitmap	Agrega una o varias imágenes de botón bitmap en la lista de imágenes de botón disponibles para un control toolbar.
CToolBarCtrl::AddButtons	Agregue uno o varios botones a un control toolbar.
CToolBarCtrl::AddString	Agrega una nueva cadena, como Id. de recurso, a la lista de la barra de herramientas de cadenas.
CToolBarCtrl::AddStrings	Agrega una nueva cadena o cadenas, pasadas como un puntero a un búfer de cadenas nulo-separadas, a la lista de la barra de herramientas de cadenas.
CToolBarCtrl::AutoSize	Cambia el tamaño de un control toolbar.
CToolBarCtrl::ChangeBitmap	Cambia el mapa de bits para un botón del control toolbar actual.
CToolBarCtrl::CheckButton	Las comprobaciones o desactive un botón determinado en un control toolbar.
CToolBarCtrl::CommandToIndex	Recupera el índice de base cero del botón asociado al identificador de comandos especificado.
CToolBarCtrl::Create	Crea un control de barra de herramientas y lo asocia a un objeto de CToolBarCtrl .
CToolBarCtrl::CreateEx	Crea un control toolbar con Windows especificado extendidas estilos y lo asocia a un objeto de CToolBarCtrl .
CToolBarCtrl::Customize	Muestra el cuadro de diálogo de la barra de herramientas de personalizar.
CToolBarCtrl::DeleteButton	Elimina un botón del control de barra de herramientas.
CToolBarCtrl::EnableButton	Habilita o deshabilita el botón especificado en un control toolbar.
CToolBarCtrl::GetAnchorHighlight	Recupera la configuración de resaltado de delimitación de una barra de herramientas.
CToolBarCtrl::GetBitmap	Recupera el índice del mapa de bits asociado con un botón de una barra de herramientas.
CToolBarCtrl::GetBitmapFlags	Obtiene los indicadores asociado al mapa de bits de la barra de herramientas.
CToolBarCtrl::GetButton	Recupera información sobre el botón especificado en un control toolbar.
CToolBarCtrl::GetButtonCount	recupera un recuento de los botones actualmente en el control de barra de herramientas.
CToolBarCtrl::GetButtonInfo	Recupera información para un botón de una barra de herramientas.
CToolBarCtrl::GetButtonSize	recupera el ancho y el alto actuales de botones de la barra de herramientas, en píxeles.
CToolBarCtrl::GetColorScheme	Recupera la combinación de colores del control toolbar actual.
CToolBarCtrl::GetDisabledImageList	Recupera la imagen mostrada que un control toolbar utiliza para mostrar los botones deshabilitados.
CToolBarCtrl::GetDropTarget	Recupera la interfaz de IDropTarget para un control toolbar.
CToolBarCtrl::GetExtendedStyle	Recupera los estilos extendidos para un control toolbar.
CToolBarCtrl::GetHotImageList	Recupera la imagen mostrada que un control toolbar utiliza para mostrar los botones “activo”. Un botón activo aparece resaltada cuando el puntero del mouse está encima de él.
CToolBarCtrl::GetHotItem	Recupera el índice de caso muy actual en una barra de herramientas.
CToolBarCtrl::GetImageList	Recupera la imagen mostrada que un control toolbar utiliza para mostrar botones en su estado predeterminado.
CToolBarCtrl::GetInsertMark	recupera la marca de inserción actual para la barra de herramientas.
CToolBarCtrl::GetInsertMarkColor	Recupera el color utilizado para dibujar la marca de inserción para la barra de herramientas.
CToolBarCtrl::GetItemRect	Recupera el rectángulo delimitador de un botón en un control toolbar.
CToolBarCtrl::GetMaxSize	Recupera el tamaño total de los botones y separadores visible en la barra de herramientas.
CToolBarCtrl::GetMaxTextRows	Recupera el número máximo de filas de texto que aparecen en un botón de la barra de herramientas.
CToolBarCtrl::GetMetrics	Recupera las métricas de un control toolbar.
CToolBarCtrl::GetPadding	Recupera el relleno horizontal y vertical del control toolbar actual.
CToolBarCtrl::GetPressedImageList	Recupera la imagen mostrada que el control toolbar actual utiliza para representar los botones en el estado presionado.
CToolBarCtrl::GetRect	recupera el rectángulo delimitador para un botón de la barra de herramientas especificado.
CToolBarCtrl::GetRows	Recupera el número de filas de botones mostrados actualmente en la barra de herramientas.
CToolBarCtrl::GetState	Recupera información sobre el estado del botón especificado en un control de barra de herramientas, por ejemplo si está habilitado, presionado, o comprobado.
CToolBarCtrl::GetString	recupera una cadena de la barra de herramientas.
CToolBarCtrl::GetStyle	Recupera los estilos actualmente en uso para un control toolbar.
CToolBarCtrl::GetToolTips	Recupera el identificador del control de información sobre herramientas, si existe, asociado al control de barra de herramientas.
CToolBarCtrl::HideButton	Oculta o muestra el botón especificado en un control toolbar.
CToolBarCtrl::HitTest	Determina si un punto está en un control toolbar.
CToolBarCtrl::Indeterminate	Establece o borrar el estado (deshabilitada) indeterminado de botón especificado en un control toolbar.
CToolBarCtrl::InsertButton	Inserta un botón en un control toolbar.
CToolBarCtrl::InsertMarkHitTest	Recupera información de marca de inserción de un punto en una barra de herramientas.
CToolBarCtrl::IsButtonChecked	Indica si el botón especificado en un control de barra de herramientas está activado.
CToolBarCtrl::IsButtonEnabled	Indica si el botón especificado en un control de barra de herramientas está habilitado.
CToolBarCtrl::IsButtonHidden	Indica si el botón especificado en un control de barra de herramientas está oculto.
CToolBarCtrl::IsButtonHighlighted	Comprueba el estado del resaltado del botón de la barra de herramientas.
CToolBarCtrl::IsButtonIndeterminate	Indica si el estado del botón especificado en un control toolbar es indeterminado (gris).
CToolBarCtrl::IsButtonPressed	Indica si el botón especificado en un control de barra de herramientas está presionado.
CToolBarCtrl::LoadImages	Mapas de bits de las cargas de la lista de imágenes de un control toolbar.
CToolBarCtrl::MapAccelerator	Asigna un carácter de aceleradores a un botón de la barra de herramientas.
CToolBarCtrl::MarkButton	Establece el estado del resaltado de un botón determinado en un control toolbar.
CToolBarCtrl::MoveButton	mueve un botón a partir de un índice a otro.
CToolBarCtrl::PressButton	Presione o libere el botón especificado en un control toolbar.
CToolBarCtrl::ReplaceBitmap	Reemplaza el mapa de bits existente en el control de barra de herramientas actual a un nuevo mapa de bits.
CToolBarCtrl::RestoreState	Restaura el estado de control toolbar.
CToolBarCtrl::SaveState	Guarda el estado de control toolbar.
CToolBarCtrl::SetAnchorHighlight	Establece la configuración de resaltado de delimitación de una barra de herramientas.
CToolBarCtrl::SetBitmapSize	Establece el tamaño de las imágenes trazadas un mapa de bits que se van a un control toolbar.
CToolBarCtrl::SetButtonInfo	establece la información para un botón existente en una barra de herramientas.
CToolBarCtrl::SetButtonSize	Establece el tamaño de los botones que se van a un control toolbar.
CToolBarCtrl::SetButtonStructSize	Especifica el tamaño de la estructura de TBBUTTON .
CToolBarCtrl::SetButtonWidth	Establece el ancho mínimos y máximos de botón en el control de barra de herramientas.
CToolBarCtrl::SetCmdID	Establece el identificador de comandos se envía a la ventana propietaria cuando se presiona el botón especificado.
CToolBarCtrl::SetColorScheme	Establece la combinación de colores del control toolbar actual.
CToolBarCtrl::SetDisabledImageList	Establece la imagen mostrada que el control toolbar utilizará para mostrar los botones deshabilitados.
CToolBarCtrl::SetDrawTextFlags	Establece los marcadores de la función DrawText, que de Win32 se utiliza para dibujar texto en el rectángulo especificado, formato según cómo se establecen los marcadores.
CToolBarCtrl::SetExtendedStyle	Establece los estilos extendidos para un control toolbar.
CToolBarCtrl::SetHotImageList	Establece la imagen mostrada que el control toolbar utilizará para mostrar botones “activo”.
CToolBarCtrl::SetHotItem	Establece el caso muy actual en una barra de herramientas.
CToolBarCtrl::SetImageList	Establece la imagen mostrada que la barra de herramientas utilizará para mostrar botones que están en su estado predeterminado.
CToolBarCtrl::SetIndent	Establece la sangría para el primer botón en un control toolbar.
CToolBarCtrl::SetInsertMark	establece la marca de inserción actual para la barra de herramientas.
CToolBarCtrl::SetInsertMarkColor	Establece el color utilizado para dibujar la marca de inserción para la barra de herramientas.
CToolBarCtrl::SetMaxTextRows	Establece el número máximo de filas de texto que aparecen en un botón de la barra de herramientas.
CToolBarCtrl::SetMetrics	Establece las métricas de un control toolbar.
CToolBarCtrl::SetOwner	Establece la ventana para recibir mensajes de notificación de control toolbar.
CToolBarCtrl::SetPadding	Establece el relleno horizontal y vertical del control toolbar actual.
CToolBarCtrl::SetPressedImageList	Establece la imagen mostrada que el control toolbar actual utiliza para representar los botones en el estado presionado.
CToolBarCtrl::SetRows	Establece el número de filas de botones mostrados en la barra de herramientas.
CToolBarCtrl::SetState	Establece el estado del botón especificado en un control toolbar.
CToolBarCtrl::SetStyle	Establece los estilos de un control toolbar.
CToolBarCtrl::SetToolTips	Asocia un control de información sobre herramientas al control de barra de herramientas.
CToolBarCtrl::SetWindowTheme	Establece el estilo visual de un control toolbar.

Comentarios

Este control (y por consiguiente la clase de CToolBarCtrl ) sólo está disponible para los programas que se ejecutan en versión 3,51 de Windows 95 /98 y Windows NT y posterior.

Un control común de la barra de herramientas de Windows es una ventana secundaria rectangular que contiene uno o varios botones. Estos botones pueden mostrar una imagen de mapa de bits, una cadena, o ambas. Cuando el usuario elige un botón, envía un mensaje de comando a la ventana propietaria de la barra de herramientas. Normalmente, los botones de una barra de herramientas corresponden a los elementos del menú de la aplicación; proporcionan una manera más sencilla para que el usuario tiene acceso a los comandos de una aplicación.

los objetos deCToolBarCtrl contienen varias estructuras de datos internas importantes: una lista de mapas de bits del botón o una lista de imágenes, una lista de cadenas de la etiqueta del botón, y una lista de estructuras de TBBUTTON que asocie una imagen o una cadena con la posición, el estilo, estado, y el identificador de comando del botón. Cada uno de los elementos de estas estructuras de datos se está haciendo referencia por un índice de base cero. Antes de poder utilizar un objeto de CToolBarCtrl , debe configurar estas estructuras de datos. La lista de cadenas sólo se puede utilizar para las etiquetas del botón; no se puede recuperar cadenas de la barra de herramientas.

Para utilizar un objeto de CToolBarCtrl , realizará normalmente estos pasos:

Cree el objeto de CToolBarCtrl .
Llame a Crear para crear el control común de la barra de herramientas de Windows y para adjuntarlo al objeto de CToolBarCtrl . Indica el estilo de la barra de herramientas mediante estilos, como TBSTYLE_TRANSPARENT de una barra de herramientas transparente o TBSTYLE_DROPDOWN de una barra de herramientas que admita botones desplegables de estilo.
Identificar cómo desea los botones de la barra de herramientas muestra:
- Para utilizar imágenes de mapa de bits en los botones, agregue los mapas de bits del botón en la barra de herramientas llamando a AddBitmap.
- Para utilizar imágenes mostradas de una imagen que aparece para los botones, especifique la imagen lista llamando a SetImageList, SetHotImageList, o SetDisabledImageList.
- Para utilizar las etiquetas de la cadena en los botones, agregue las cadenas a la barra de herramientas llamando a AddString y/o AddStrings.
Agregue las estructuras del botón en la barra de herramientas llamando a AddButtons.
Si desea que la información sobre herramientas de un botón de la barra de herramientas en una ventana propietaria que no es CFrameWnd, deberá controlar los mensajes de TTN_NEEDTEXT en la ventana propietaria de la barra de herramientas como se describe en Administrar notificaciones de información sobre herramientas. Si la ventana primaria de la barra de herramientas es derivada de CFrameWnd, la información sobre herramientas se muestran sin ningún esfuerzo adicional de se porque CFrameWnd proporciona un controlador predeterminado.
Si desea que el usuario pueda personalizar la barra de herramientas, los mensajes de notificación de personalización de identificador en la ventana propietaria como se describe en Administrar notificaciones de personalización.

Puede utilizar SaveState para guardar el estado actual de un control de barra de herramientas en el registro y RestoreState para restaurar el estado basándose en la información anteriormente almacenada en el registro. Además de guardar el estado de la barra de herramientas entre usos de la aplicación, aplicaciones almacenan normalmente el estado antes de que el usuario personalizar la barra de herramientas en caso de que el usuario desee después para restaurar la barra de herramientas a su estado original.

Compatibilidad con la versión 4,0 de Internet Explorer y Later

Para admitir la funcionalidad introducida en Internet Explorer, la versión 4,0 y posterior, MFC proporciona compatibilidad con la lista de imágenes y estilos transparente y planos para los controles de barra de herramientas.

Una barra de herramientas transparente permite al cliente en la barra de herramientas muestra a través de. Para crear una barra de herramientas transparente, utilice estilos de TBSTYLE_FLAT y de TBSTYLE_TRANSPARENT . Seguimiento activo de la característica transparente de las barras de herramientas; es decir, cuando el puntero del mouse se mueve sobre un botón activo en la barra de herramientas, cambia el aspecto del botón. Las barras de herramientas creadas con solo el estilo de TBSTYLE_FLAT contendrán los botones que no son transparentes.

Compatibilidad con la lista de imágenes ofrece a control mayor flexibilidad para el comportamiento predeterminado, imágenes activo, y las imágenes deshabilitadas. Utilice GetImageList, GetHotImageList, y GetDisabledImageList con la barra de herramientas transparente para manipular la imagen según el estado:

Para obtener más información sobre cómo utilizar CToolBarCtrl, vea Controles y Mediante CToolBarCtrl.