Clase de CMFCToolBarButton

Artículo
02/19/2013

Proporciona funcionalidad del botón en las barras de herramientas.

class CMFCToolBarButton : public CObject

Members

Constructores públicos

Name	Descripción
CMFCToolBarButton::CMFCToolBarButton	Las construcciones e inicializan un objeto de CMFCToolBarButton .
CMFCToolBarButton::~CMFCToolBarButton	Un destructor.

Métodos públicos

Name	Descripción
CMFCToolBarButton::CanBeDropped	Especifica si un usuario puede colocar un botón de una barra de herramientas o menú durante la personalización.
CMFCToolBarButton::CanBeStored	Especifica si el botón puede almacenar.
CMFCToolBarButton::CanBeStretched	Especifica si un usuario puede ajustar el botón durante la personalización.
CMFCToolBarButton::CompareWith	compara esta instancia con el objeto proporcionado de CMFCToolBarButton .
CMFCToolBarButton::CopyFrom	Copia las propiedades de otro botón de la barra de herramientas para el botón actual.
CMFCToolBarButton::CreateFromOleData	Crea un objeto de CMFCToolBarButton del objeto proporcionado de COleDataObject .
CMFCToolBarButton::CreateObject	Utiliza el marco para crear una instancia dinámica de este tipo de clase.
CMFCToolBarButton::EnableWindow	Habilita o deshabilita la entrada del mouse y del teclado.
CMFCToolBarButton::ExportToMenuButton	Copia el texto del botón de la barra de herramientas a un menú.
CMFCToolBarButton::GetClipboardFormat	Recupera el formato global del portapapeles para la aplicación.
CMFCToolBarButton::GetHwnd	Recupera el identificador de ventana que está asociado al botón de la barra de herramientas.
CMFCToolBarButton::GetImage	Recupera el índice del botón.
CMFCToolBarButton::GetInvalidateRect	Recupera la región del área cliente del botón que debe volver a dibujar.
CMFCToolBarButton::GetParentWnd	Recupera la ventana primaria del botón.
CMFCToolBarButton::GetProtectedCommands	recupera la lista de comandos que el usuario no puede personalizar.
CMFCToolBarButton::GetTextSize	Recupera el tamaño del texto del botón.
CMFCToolBarButton::HasFocus	determina si el botón tiene el foco de entrada actual.
CMFCToolBarButton::HaveHotBorder	Determina si un borde del botón de cuando un usuario selecciona el botón.
CMFCToolBarButton::IsDrawImage	Determina si una imagen se muestra en el botón.
CMFCToolBarButton::IsDrawText	Determina si una etiqueta de texto se muestra en el botón.
CMFCToolBarButton::IsDroppedDown	Determina si el botón muestra un submenú.
CMFCToolBarButton::IsEditable	Determina si el botón puede personalizarse.
CMFCToolBarButton::IsExtraSize	Determina si el botón se puede mostrar con un borde extendido.
CMFCToolBarButton::IsFirstInGroup	determina si el botón está en la primera posición en su grupo de botones.
CMFCToolBarButton::IsHidden	Determina si el botón está oculto.
CMFCToolBarButton::IsHorizontal	Determina si el botón se encuentra en una barra de herramientas horizontal.
CMFCToolBarButton::IsLastInGroup	Especifica si el botón está en posición última en su grupo de botones.
CMFCToolBarButton::IsLocked	Determina si el botón está en una barra de herramientas (no-adaptable) para.
CMFCToolBarButton::IsOwnerOf	Determina si el botón es el propietario del identificador de ventana proporcionado.
CMFCToolBarButton::IsVisible	Determina si el botón de la barra de herramientas está visible.
CMFCToolBarButton::IsWindowVisible	Determina si el identificador de ventana subyacente del botón está visible.
CMFCToolBarButton::NotifyCommand	especifica si el botón procesa el mensaje de WM_COMMAND .
CMFCToolBarButton::OnAddToCustomizePage	Llamado por el marco cuando el botón se agrega a un cuadro de diálogo de Personalizar .
CMFCToolBarButton::OnBeforeDrag	Especifica si el botón pueda arrastrar.
CMFCToolBarButton::OnBeforeDrop	Especifica si un usuario puede quitar el botón en la barra de herramientas de destino.
CMFCToolBarButton::OnCalculateSize	Llamado por el marco para calcular el tamaño del botón para el contexto y el estado de vinculación especificados del dispositivo.
CMFCToolBarButton::OnCancelMode	Llamado por el marco para procesar el mensaje de WM_CANCELMODE .
CMFCToolBarButton::OnChangeParentWnd	Llamado por el marco cuando el botón se inserta en una nueva barra de herramientas.
CMFCToolBarButton::OnClick	Llamado por el marco cuando el usuario hace clic en el botón del mouse.
CMFCToolBarButton::OnClickUp	Llamado por el marco cuando el usuario suelta el botón del mouse.
CMFCToolBarButton::OnContextHelp	Llamado por el marco cuando la barra de herramientas principal controla un mensaje de WM_HELPHITTEST .
CMFCToolBarButton::OnCtlColor	Llamado por el marco cuando la barra de herramientas principal controla un mensaje de WM_CTLCOLOR .
CMFCToolBarButton::OnCustomizeMenu	Permite que el botón modifique el menú proporcionado cuando la aplicación muestra un menú contextual en la barra de herramientas principal.
CMFCToolBarButton::OnDblClk	Llamado por el marco cuando la barra de herramientas principal controla un mensaje de WM_LBUTTONDBLCLK .
CMFCToolBarButton::OnDraw	Llamado por el marco para dibujar el botón mediante los estilos y las opciones especificados.
CMFCToolBarButton::OnDrawOnCustomizeList	Llamado por el marco para dibujar el botón del panel de Commandos del cuadro de diálogo de Personalizar .
CMFCToolBarButton::OnGetCustomToolTipText	Llamado por el marco para recuperar el texto de información sobre herramientas personalizado para el botón.
CMFCToolBarButton::OnGlobalFontsChanged	Llamado por el marco cuando la fuente global ha cambiado.
CMFCToolBarButton::OnMove	Llamado por el marco cuando la barra de herramientas principal se mueve.
CMFCToolBarButton::OnShow	Llamado por el marco cuando el botón se vuelve visible o invisible.
CMFCToolBarButton::OnSize	Llamado por el marco cuando la barra de herramientas principal cambia su tamaño o posición y este cambio requiere el botón cambiar el tamaño.
CMFCToolBarButton::OnToolHitTest	Llamado por el marco cuando la barra de herramientas principal debe determinar si un punto está en el rectángulo delimitador del botón.
CMFCToolBarButton::OnUpdateToolTip	Llamado por el marco cuando la barra de herramientas principal actualiza el texto de información sobre herramientas.
CMFCToolBarButton::PrepareDrag	Llamado por el marco cuando el botón está a punto de realizar una operación de arrastrar y colocar.
CMFCToolBarButton::Rect	Recupera el rectángulo delimitador del botón.
CMFCToolBarButton::ResetImageToDefault	Establece el valor predeterminado la imagen que está asociado al botón.
CMFCToolBarButton::SaveBarState	Guarda el estado del botón de la barra de herramientas.
CMFCToolBarButton::Serialize	Lee este objeto de un archivo o de escribe en un archivo.(Reemplaza CObject::Serialize.)
CMFCToolBarButton::SetACCData	Rellena el objeto proporcionado de CAccessibilityData con datos de accesibilidad del botón de la barra de herramientas.
CMFCToolBarButton::SetClipboardFormatName	Cambiar el formato global del portapapeles.
CMFCToolBarButton::SetImage	Establece el índice del botón.
CMFCToolBarButton::SetProtectedCommands	establece la lista de comandos que el usuario no puede personalizar.
CMFCToolBarButton::SetRadio	Llamado por el marco cuando un botón cambia su estado activada.
CMFCToolBarButton::SetRect	Establece el rectángulo delimitador del botón.
CMFCToolBarButton::SetStyle	Establece el estilo de botón.
CMFCToolBarButton::SetVisible	Especifica si el botón está visible.
CMFCToolBarButton::Show	Muestra u oculta el botón.

miembros de datos

Name	Descripción
CMFCToolBarButton::m_bImage	Especifica si una imagen se muestra en el botón.
CMFCToolBarButton::m_bText	Especifica si una etiqueta de texto se muestra en el botón.
CMFCToolBarButton::m_bTextBelow	Especifica si el etiqueta de texto se muestra bajo la imagen en el botón.
CMFCToolBarButton::m_bUserButton	Especifica si el botón con una imagen definido por el usuario.
CMFCToolBarButton::m_bWholeText	Especifica si el botón muestra la etiqueta de texto completo incluso si no cabe en el rectángulo delimitador.
CMFCToolBarButton::m_bWrap	Especifica si el botón situado junto a un separador se colocará en la fila siguiente.
CMFCToolBarButton::m_bWrapText	Especifica si las etiquetas de texto multilínea están habilitados.
CMFCToolBarButton::m_nID	El identificador de comando del botón.
CMFCToolBarButton::m_nStyle	El estilo de botón.
CMFCToolBarButton::m_strText	La etiqueta de texto del botón.

Comentarios

Un objeto de CMFCToolbarButton es un control que residen en una barra de herramientas.Su comportamiento es similar al de un botón normal.Puede asignar una imagen y una etiqueta de texto a este objeto.Un botón de la barra de herramientas también puede tener un identificador de comandoCuando el usuario hace clic en el botón de la barra de herramientas, el marco ejecuta el comando que este identificador especifica.

Normalmente, los botones de la barra de herramientas pueden ser personalizados: el usuario puede arrastrar los botones a partir de una barra de herramientas a otra, y copiar, pegar, delete, y las etiquetas de texto y las imágenes de edición.Para evitar que el usuario personalizar la barra de herramientas, puede bloquear la barra de herramientas de dos maneras.Cualquiera establece la marca de bLocked a TRUE cuando se llama a CMFCToolBar::LoadToolBar, o agrega el identificador de comando de un botón individual de la lista global de comandos protegidos mediante el método de CMFCToolBarButton::SetProtectedCommands .

imágenes de presentación de los objetos deCMFCToolBarButton de las colecciones globales de imágenes de la barra de herramientas en la aplicación.Estas colecciones son mantenidas por la barra de herramientas principal, Clase de CMFCToolBar.Para obtener más información, vea Clase de CMFCToolBarImages.

Cuando el usuario hace clic en un botón de la barra de herramientas, la barra de herramientas principal procesa el mensaje del mouse y comunica acciones adecuados al botón.Si el botón tiene un identificador válido del comando, la barra de herramientas principal envía el mensaje de WM_COMMAND el cuadro primario.

La clase de CMFCToolBarButton es la clase base para otras clases de botón de la barra de herramientas, como Clase de CMFCToolBarMenuButton, Clase de CMFCToolBarEditBoxButton, y Clase de CMFCToolBarComboBoxButton.

Ejemplo

El ejemplo siguiente muestra cómo configurar un objeto de CMFCToolBarButton mediante varios métodos en la clase de CMFCToolBarButton .El ejemplo muestra cómo habilitar la entrada del mouse y del teclado, establecer el índice del botón, establecer el rectángulo delimitador del botón, y crear el botón visible.Este fragmento de código es parte de ejemplo de Tab Control.

    CMFCToolBarButton* pOffice2007 = NULL;
    int nIndex = -1;
    
    for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
    {
        // CMFCToolBar  m_wndToolBarTheme
        nIndex = m_wndToolBarTheme.CommandToIndex (uiCmd);

        CMFCToolBarButton* pButton = m_wndToolBarTheme.GetButton (nIndex);
    
        if (pButton != NULL)
        {
            pOffice2007 = pButton;
            break;
        }
    }


...


    pOffice2007->EnableWindow();
    pOffice2007->SetImage(1);
    pOffice2007->SetRect( CRect(1,1,1,1));
    pOffice2007->SetVisible();
    pOffice2007->Show(true);