Compartir a través de


CToolBarCtrl Class

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:

  1. Cree el objeto de CToolBarCtrl .

  2. 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.

  3. 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.

  4. Agregue las estructuras del botón en la barra de herramientas llamando a AddButtons.

  5. 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.

  6. 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.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CToolBarCtrl

Requisitos

encabezado: afxcmn.h

Vea también

Referencia

CWnd (clase)

Gráfico de jerarquías

CToolBar Class

Conceptos

ejemplo CMNCTRL1 de MFC

ejemplo MFCIE de MFC