Compartir a través de


Clase de CMFCToolBarButton

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

class CMFCToolBarButton : public CObject

Members

Bb983678.collapse_all(es-es,VS.110).gifConstructores públicos

Name

Descripción

CMFCToolBarButton::CMFCToolBarButton

Las construcciones e inicializan un objeto de CMFCToolBarButton .

CMFCToolBarButton::~CMFCToolBarButton

Un destructor.

Bb983678.collapse_all(es-es,VS.110).gifMé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.

Bb983678.collapse_all(es-es,VS.110).gifmiembros 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);

Jerarquía de herencia

CObject

   CMFCToolBarButton

Requisitos

encabezado: afxtoolbarbutton.h

Vea también

Referencia

Gráfico de jerarquía

Clase de CMFCToolBar

Clase de CMFCToolBarImages

CMFCToolBarButton::OnClick

CMFCToolBarButton::NotifyCommand

Otros recursos

Clases de MFC