Clase CMFCToolBarButton

  • Artículo

Proporciona funcionalidad de botón a las barras de herramientas.

Sintaxis

class CMFCToolBarButton : public CObject

Miembros

Constructores públicos

Nombre Descripción
CMFCToolBarButton::CMFCToolBarButton Construye e inicializa un objeto CMFCToolBarButton.
CMFCToolBarButton::~CMFCToolBarButton Destructor.

Métodos públicos

Nombre Descripción
CMFCToolBarButton::CanBeDropped Especifica si un usuario puede colocar un botón en una barra de herramientas o menú durante la personalización.
CMFCToolBarButton::CanBeStored Especifica si se puede almacenar el botón.
CMFCToolBarButton::CanBeStretched Especifica si un usuario puede ajustar el botón durante la personalización.
CMFCToolBarButton::CompareWith Compara esta instancia con el objeto CMFCToolBarButton proporcionado.
CMFCToolBarButton::CopyFrom Copia las propiedades de otro botón de la barra de herramientas en el botón actual.
CMFCToolBarButton::CreateFromOleData Crea un objeto CMFCToolBarButton a partir del objeto COleDataObject proporcionado.
CMFCToolBarButton::CreateObject Usado por el marco de trabajo para crear una instancia dinámica de este tipo de clase.
CMFCToolBarButton::EnableWindow Habilita o deshabilita la entrada de mouse y de teclado.
CMFCToolBarButton::ExportToMenuButton Copia el texto del botón de la barra de herramientas en un menú.
CMFCToolBarButton::GetClipboardFormat Recupera el formato global del Portapapeles para la aplicación.
CMFCToolBarButton::GetHwnd Recupera el manipulador de ventana asociado al botón de la barra de herramientas.
CMFCToolBarButton::GetImage Recupera el índice de imagen del botón.
CMFCToolBarButton::GetInvalidateRect Recupera la región del área cliente del botón que se 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 se muestra un borde del botón cuando un usuario selecciona el botón.
CMFCToolBarButton::IsDrawImage Determina si se muestra una imagen en el botón.
CMFCToolBarButton::IsDrawText Determina si se muestra una etiqueta de texto en el botón.
CMFCToolBarButton::IsDroppedDown Determina si el botón muestra un submenú.
CMFCToolBarButton::IsEditable Determina si el botón se puede personalizar.
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 de 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 la última posición de su grupo de botones.
CMFCToolBarButton::IsLocked Determina si el botón está en una barra de herramientas bloqueada (no personalizable).
CMFCToolBarButton::IsOwnerOf Determina si el botón es el propietario del manipulador de ventana proporcionado.
CMFCToolBarButton::IsVisible Determina si el botón de la barra de herramientas está visible.
CMFCToolBarButton::IsWindowVisible Determina si el manipulador de ventana subyacente del botón está visible.
CMFCToolBarButton::NotifyCommand Especifica si el botón procesa el mensaje WM_COMMAND.
CMFCToolBarButton::OnAddToCustomizePage Lo llama el marco cuando se agrega el botón a un cuadro de diálogo Personalizar.
CMFCToolBarButton::OnBeforeDrag Especifica si se puede arrastrar el botón.
CMFCToolBarButton::OnBeforeDrop Especifica si un usuario puede colocar el botón en la barra de herramientas de destino.
CMFCToolBarButton::OnCalculateSize Lo llama el marco para calcular el tamaño del botón para el contexto de dispositivo y el estado de acoplamiento especificados.
CMFCToolBarButton::OnCancelMode Lo llama el marco para administrar el mensaje WM_CANCELMODE.
CMFCToolBarButton::OnChangeParentWnd Lo llama el marco cuando el botón se inserta en una barra de herramientas nueva.
CMFCToolBarButton::OnClick Lo llama el marco cuando el usuario pulsa el botón del mouse.
CMFCToolBarButton::OnClickUp Lo llama el marco cuando el usuario suelta el botón del mouse.
CMFCToolBarButton::OnContextHelp Lo llama el marco cuando la barra de herramientas primaria controla un mensaje de WM_HELPHITTEST.
CMFCToolBarButton::OnCtlColor Lo llama el marco cuando la barra de herramientas primaria maneja 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 primaria.
CMFCToolBarButton::OnDblClk Lo llama el marco cuando la barra de herramientas primaria manipula un mensaje WM_LBUTTONDBLCLK.
CMFCToolBarButton::OnDraw Lo llama el marco para dibujar el botón mediante las opciones y los estilos especificados.
CMFCToolBarButton::OnDrawOnCustomizeList Lo llama el marco para dibujar el botón en el panel Comandos del cuadro de diálogo Personalizar.
CMFCToolBarButton::OnGetCustomToolTipText Lo llama el marco para recuperar el texto de información sobre herramientas personalizado para el botón.
CMFCToolBarButton::OnGlobalFontsChanged Lo llama el el marco cuando cambia la fuente general.
CMFCToolBarButton::OnMove Lo llama el marco cuando se mueve la barra de herramientas primaria.
CMFCToolBarButton::OnShow Lo llama el marco cuando el botón se vuelve visible o invisible.
CMFCToolBarButton::OnSize Lo llama el marco cuando la barra de herramientas primaria cambia de tamaño o posición y este cambio requiere que el botón cambie de tamaño.
CMFCToolBarButton::OnToolHitTest Lo llama el marco cuando la barra de herramientas primaria debe determinar si un punto está en el rectángulo delimitador del botón.
CMFCToolBarButton::OnUpdateToolTip Lo llama el marco cuando la barra de herramientas primaria actualiza su texto de información sobre herramientas.
CMFCToolBarButton::PrepareDrag Lo llama 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 en el valor predeterminado la imagen asociada al botón.
CMFCToolBarButton::SaveBarState Guarda el estado del botón de la barra de herramientas.
CMFCToolBarButton::Serialize Lee este objeto desde un archivo o lo escribe en un archivo. (Invalida CObject::Serialize).
CMFCToolBarButton::SetACCData Rellena el objeto proporcionado CAccessibilityData con datos de accesibilidad desde el botón de la barra de herramientas.
CMFCToolBarButton::SetClipboardFormatName Cambia el nombre del formato global del Portapapeles.
CMFCToolBarButton::SetImage Establece el índice de imagen del botón.
CMFCToolBarButton::SetProtectedCommands Establece la lista de comandos que el usuario no puede personalizar.
CMFCToolBarButton::SetRadio Lo llama el marco cuando un botón cambia su estado activado.
CMFCToolBarButton::SetRect Establece el rectángulo delimitador del botón.
CMFCToolBarButton::SetStyle Establece el estilo del botón.
CMFCToolBarButton::SetVisible Especifica si el botón está visible.
CMFCToolBarButton::Show Muestra u oculta el botón.

Miembros de datos

Nombre Descripción
CMFCToolBarButton::m_bImage Especifica si se muestra una imagen en el botón.
CMFCToolBarButton::m_bText Especifica si se muestra una etiqueta de texto en el botón.
CMFCToolBarButton::m_bTextBelow Especifica si la etiqueta de texto se muestra debajo de la imagen del botón.
CMFCToolBarButton::m_bUserButton Especifica si el botón tiene una imagen definida por el usuario.
CMFCToolBarButton::m_bWholeText Especifica si el botón muestra su etiqueta de texto completa incluso si no cabe en el rectángulo delimitador.
CMFCToolBarButton::m_bWrap Especifica si el botón ubicado junto a un separador se colocará en la fila siguiente.
CMFCToolBarButton::m_bWrapText Especifica si las etiquetas de texto de varias líneas están habilitadas.
CMFCToolBarButton::m_nID Identificador de comando del botón.
CMFCToolBarButton::m_nStyle Estilo del botón.
CMFCToolBarButton::m_strText Etiqueta de texto del botón.

Comentarios

Un objeto CMFCToolbarButton es un control que reside 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 comando. Cuando el usuario hace clic en el botón de la barra de herramientas, el marco ejecuta el comando que este identificador especifica.

Por lo general, los botones de la barra de herramientas se pueden personalizar: el usuario puede arrastrar botones de una barra de herramientas a otra y copiar, pegar, eliminar y editar etiquetas de texto e imágenes. Para evitar que el usuario personalice la barra de herramientas, puede bloquear la barra de herramientas de una de estas dos maneras. Establezca la marca bLocked en TRUE cuando llame a CMFCToolBar::LoadToolBar, o bien agregue el identificador de comando de un botón individual a la lista global de comandos protegidos a través del método CMFCToolBarButton::SetProtectedCommands.

Los objetos CMFCToolBarButton muestran imágenes de las colecciones globales de imágenes de la barra de herramientas en la aplicación. La barra de herramientas primaria, clase CMFCToolBar, mantiene estas colecciones. Para más información, consulte Clase CMFCToolBarImages.

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

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

Ejemplo

En el ejemplo siguiente se muestra cómo configurar un objeto CMFCToolBarButton mediante varios métodos de la clase CMFCToolBarButton. En el ejemplo, se ilustra cómo habilitar la entrada de mouse y teclado, establecer el índice de imagen del botón, establecer el rectángulo delimitador del botón y hacer que el botón sea visible. Este fragmento de código forma parte del ejemplo de Control de pestaña.

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

CMFCToolBarButton::CanBeDropped

Especifica si un usuario puede colocar un botón en una barra de herramientas o menú durante la personalización.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Parámetros

pToolbar
[in] Sin utilizar.

Valor devuelto

Este método devuelve TRUE.

Comentarios

De manera predeterminada, se puede colocar un botón de la barra de herramientas en cada barra de herramientas personalizable (es decir, no bloqueada).

La implementación predeterminada de este método devuelve TRUE. Invalide este método y devuelva FALSE si desea impedir que el usuario cambie la posición del botón.

CMFCToolBarButton::CanBeStored

Determina si se puede almacenar el botón.

virtual BOOL CanBeStored() const;

Valor devuelto

Este método devuelve TRUE.

Comentarios

El marco usa este método para determinar si el botón puede participar en una operación de arrastrar y colocar.

La implementación predeterminada devuelve TRUE. Invalide este método si el botón no se puede almacenar como parte de una operación de arrastrar y colocar. Para más información sobre las operaciones de arrastrar y colocar, consulte Funciones OLE de arrastrar y colocar.

CMFCToolBarButton::CanBeStretched

Especifica si un usuario puede ajustar el botón durante la personalización.

virtual BOOL CanBeStretched() const;

Valor devuelto

Este método devuelve FALSE.

Comentarios

El marco utiliza este método para determinar si el botón se puede ajustar en modo de personalización.

La implementación predeterminada de este método devuelve FALSE. Invalide este método para devolver TRUE para un control de ancho variable, como un cuadro combinado o un control deslizante.

Para más información sobre el modo de personalización, consulte CMFCToolBar::SetCustomizeMode.

CMFCToolBarButton::CMFCToolBarButton

Construye e inicializa un objeto CMFCToolBarButton.

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

Parámetros

uiID
[in] Identificador de comando del botón.

iImage
[in] Índice de imagen del botón en la colección de imágenes.

lpszText
[in] Etiqueta de texto del botón. Puede ser NULL.

bUserButton
[in] Valor booleano que determina si el botón está definido por el usuario. Si este parámetro es TRUE, el botón está definido por el usuario. De lo contrario, la imagen del botón se carga desde un recurso.

bLocked
[in] Valor booleano que determina si se puede personalizar el botón. Si este parámetro es TRUE, no se puede personalizar el botón. De lo contrario, el botón se puede personalizar.

CMFCToolBarButton::CompareWith

Compara esta instancia con el objeto CMFCToolBarButton proporcionado.

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parámetros

other
[in] Referencia al objeto que se va a comparar con esta instancia.

Valor devuelto

Distinto de cero si el objeto proporcionado es igual al valor de esta instancia; de lo contrario, 0.

Comentarios

La implementación predeterminada determina si el identificador de comando del objeto proporcionado es igual al identificador de comando de esta instancia. Invalide este método si debe realizar un procesamiento adicional para determinar si dos objetos CMFCToolBarButton son iguales.

CMFCToolBarButton::CopyFrom

Copia las propiedades de otro botón de la barra de herramientas en el botón actual.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parámetros

src
[in] Referencia al botón de origen desde el que se va a copiar.

Comentarios

Llame a este método para copiar otro botón de la barra de herramientas en este botón de la barra de herramientas.

CMFCToolBarButton::CreateFromOleData

Crea un objeto CMFCToolBarButton a partir del objeto COleDataObject proporcionado.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Parámetros

pDataObject
[in] Objeto de datos OLE de origen.

Valor devuelto

Objeto CMFCToolBarButton creado.

Comentarios

El marco usa este método para realizar la transferencia de datos en varios formatos. Por ejemplo, el método CMFCOutlookBarPane::OnDragOver usa este método para realizar operaciones de arrastrar y colocar.

CMFCToolBarButton::EnableWindow

Habilita o deshabilita la entrada de mouse y de teclado.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parámetros

bEnable
[in] Establezca este parámetro en TRUE para habilitar la entrada o en FALSE para deshabilitarla.

Comentarios

Este método llama a la función EnableWindow para habilitar o deshabilitar la entrada. Para más información, consulte EnableWindow en Windows SDK.

CMFCToolBarButton::ExportToMenuButton

Copia el texto del botón de la barra de herramientas en un menú.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parámetros

menuButton
[in] Referencia al botón de menú de destino.

Valor devuelto

Este método devuelve TRUE.

Comentarios

El marco llama a este método para copiar el texto de un botón de la barra de herramientas a un botón del menú. La implementación predeterminada copia la etiqueta de texto del botón. Si la etiqueta de texto está vacía, este método copia el texto de información sobre herramientas del botón.

La implementación predeterminada de este método devuelve TRUE. Invalide este método si quiere realizar acciones adicionales cuando el marco convierte un objeto que deriva de CMFCToolbarButton en un botón del menú.

CMFCToolBarButton::GetClipboardFormat

Recupera el formato global del Portapapeles para la aplicación.

static CLIPFORMAT __stdcall GetClipboardFormat();

Valor devuelto

El valor CLIPFORMAT global para la aplicación.

Comentarios

El marco llama a este método para recuperar el formato del Portapapeles para las operaciones de transferencia de datos OLE. Por ejemplo, el método CMFCToolBarButton::CreateFromOleData utiliza este método para copiar datos de un objeto de datos OLE de origen.

Este método establece el valor CLIPFORMAT global la primera vez que se llama a este método. Todas las llamadas subsiguientes a este método devuelven este valor.

Para permitir que se produzcan operaciones de arrastrar y colocar entre aplicaciones, llame al método CMFCToolBarButton::SetClipboardFormatName.

Para más información sobre los Portapapeles en MFC, consulte Portapapeles.

CMFCToolBarButton::GetHwnd

Recupera el manipulador de ventana asociado al botón de la barra de herramientas.

virtual HWND GetHwnd();

Valor devuelto

El manipulador de ventana asociado con el botón de la barra de herramientas o NULL si el botón de la barra de herramientas no tiene ningún manipulador de ventana asociado.

Comentarios

La implementación predeterminada de este método devuelve NULL. Invalide este método para devolver el manipulador de ventana de su control específico.

CMFCToolBarButton::GetImage

Recupera el índice de imagen del botón.

int GetImage() const;

Valor devuelto

El índice de la imagen asociada a este botón.

Comentarios

Si el botón tiene una imagen definida por el usuario (es decir, si bUserButton era TRUE en el constructor), el índice devuelto especifica una imagen en la colección de imágenes definidas por el usuario (consulte CMFCToolBar::GetUserImages). De lo contrario, el índice especifica una imagen en la colección de imágenes que se cargan desde un archivo de recursos (consulte CMFCToolBar::GetImages). Para más información sobre los archivos de recursos, consulte Trabajar con archivos de recursos.

CMFCToolBarButton::GetInvalidateRect

Recupera la región del área cliente del botón que se debe volver a dibujar.

virtual const CRect GetInvalidateRect() const;

Valor devuelto

Objeto CRect que especifica la región que se debe volver a dibujar.

Comentarios

La implementación predeterminada de este método devuelve toda el área cliente. Invalide este método si desea que se vuelva a dibujar un área distinta.

CMFCToolBarButton::GetParentWnd

Recupera la ventana primaria del botón.

CWnd* GetParentWnd() const;

Valor devuelto

Ventana primaria del botón.

CMFCToolBarButton::GetProtectedCommands

Recupera la lista de comandos que el usuario no puede personalizar.

static const CList<UINT,UINT>& GetProtectedCommands();

Valor devuelto

La lista de comandos protegidos.

Comentarios

En el modo de personalización, el marco deshabilita los comandos de botón de la barra de herramientas que están protegidos. El usuario no puede realizar operaciones de arrastrar y colocar ni de editar en botones de la barra de herramientas deshabilitados.

Use el método CMFCToolBarButton::SetProtectedCommands para definir la lista de comandos protegidos.

CMFCToolBarButton::GetTextSize

Recupera el tamaño del texto del botón.

SIZE GetTextSize() const;

Valor devuelto

Objeto SIZE que contiene el tamaño, en píxeles, del texto del botón.

CMFCToolBarButton::HasFocus

Determina si el botón tiene el foco de entrada actual.

virtual BOOL HasFocus() const;

Valor devuelto

Distinto de cero si el botón tiene el foco de entrada; de lo contrario, 0.

Comentarios

La implementación predeterminada de este método devuelve un valor distinto de cero si el botón tiene el foco de entrada o es una ventana secundaria o descendiente de la ventana que tiene el foco de entrada. Para personalizar este comportamiento, puede invalidar esta función.

CMFCToolBarButton::HaveHotBorder

Determina si se muestra un borde del botón cuando un usuario selecciona el botón.

virtual BOOL HaveHotBorder() const;

Valor devuelto

Este método devuelve TRUE.

Comentarios

El marco llama a este método para determinar si el botón de la barra de herramientas debe mostrar su borde cuando un usuario lo selecciona.

La implementación predeterminada devuelve TRUE. Para personalizar este comportamiento, puede invalidar este método.

CMFCToolBarButton::IsDrawImage

Determina si se muestra una imagen en el botón.

BOOL IsDrawImage() const;

Valor devuelto

Distinto de cero si se muestra una imagen en el botón; de lo contrario, 0.

Comentarios

Este método devuelve FALSE si el botón de la barra de herramientas no tiene ninguna imagen asociada (CMFCToolBarButton::GetImage devuelve -1) o si CMFCToolBarButton::m_bImage está establecido en FALSE.

CMFCToolBarButton::IsDrawText

Determina si se muestra una etiqueta de texto en el botón.

BOOL IsDrawText() const;

Valor devuelto

Distinto de cero si se muestra una etiqueta de texto; de lo contrario, 0.

Comentarios

Este método devuelve FALSE si el botón de la barra de herramientas no tiene ninguna etiqueta de texto asociada (CMFCToolBarButton::m_strText está vacío) o si CMFCToolBarButton::m_bText está establecido en FALSE.

CMFCToolBarButton::IsDroppedDown

Determina si el botón muestra un submenú.

virtual BOOL IsDroppedDown() const;

Valor devuelto

Este método devuelve FALSE.

Comentarios

La implementación predeterminada de este método devuelve FALSE. Invalide este método para devolver TRUE si el control muestra un submenú.

CMFCToolBarButton::IsEditable

Determina si el botón se puede personalizar.

virtual BOOL IsEditable() const;

Valor devuelto

Distinto de cero si el usuario puede personalizar un botón; de lo contrario, 0.

Comentarios

El marco llama a este método para determinar si el usuario puede personalizar el botón de la barra de herramientas mediante operaciones de arrastrar y colocar o de editar.

La implementación predeterminada devuelve FALSE si el identificador de comando del botón es un comando estándar (puede determinar esto mediante una llamada a la función IsStandardCommand) o si el identificador de comando está en la lista de comandos protegidos. Para más información sobre los comandos protegidos, consulte CMFCToolBarButton::GetProtectedCommands y CMFCToolBarButton::SetProtectedCommands.

Invalide este método para personalizar su comportamiento.

CMFCToolBarButton::IsExtraSize

Determina si el botón se puede mostrar con un borde extendido.

virtual BOOL IsExtraSize() const;

Valor devuelto

Distinto de cero si el botón de la barra de herramientas se puede mostrar con un borde extendido; de lo contrario, 0.

Comentarios

Varias máscaras usan tamaño adicional para los bordes de los botones de la barra de herramientas (por ejemplo, botones redondos).

Si el usuario mueve este botón de una barra de herramientas a otra, el marco llama al método CMFCToolBarButton::OnChangeParentWnd. El método CMFCToolBarButton::OnChangeParentWnd establece la marca de tamaño adicional en la de la barra de herramientas primaria nueva (para más información, consulte CMFCToolBar::IsButtonExtraSizeAvailable).

CMFCToolBarButton::IsFirstInGroup

Determina si el botón está en la primera posición de su grupo de botones.

virtual BOOL IsFirstInGroup() const;

Valor devuelto

TRUE si el botón es el primero de su grupo de botones; de lo contrario, FALSE.

Comentarios

Este método define un grupo de botones como un conjunto vecino de botones que están colocados en la misma fila y limitados por separadores o el borde de la barra de herramientas. Este método devuelve FALSE si el botón de la barra de herramientas hace referencia al botón Personalizar. Para más información sobre el botón Personalizar, consulte CMFCToolBar::GetCustomizeButton.

Llame al método CMFCToolBarButton::IsLastInGroup para determinar si el botón se encuentra en la última posición de su grupo de botones.

CMFCToolBarButton::IsHidden

Determina si el botón está oculto.

BOOL IsHidden() const;

Valor devuelto

Distinto de cero si el botón está oculto (invisible); de lo contrario, 0.

Comentarios

El marco llama a este método cuando se ajusta la barra de herramientas primaria para determinar si el botón de la barra de herramientas está visible.

Si usa el método CMFCToolBarButton::SetVisible para establecer que el botón sea invisible, use CMFCToolBarButton::IsVisible para determinar que el botón de la barra de herramientas sea visible.

De manera predeterminada, todos los botones de la barra de herramientas son visibles. Use el método CMFCToolBarButton::Show para ocultar o mostrar los botones de la barra de herramientas.

CMFCToolBarButton::IsHorizontal

Determina si el botón se encuentra en una barra de herramientas horizontal.

BOOL IsHorizontal() const;

Valor devuelto

Distinto de cero si un botón de la barra de herramientas se encuentra en una barra de herramientas horizontal; de lo contrario, 0.

Comentarios

El marco llama a este método para determinar el diseño de los botones de la barra de herramientas.

Este método devuelve el miembro de datos m_bHorz. El valor predeterminado del miembro de datos m_bHorz es TRUE; se restablece en cada llamada al método CMFCToolBarButton::OnDraw.

CMFCToolBarButton::IsLastInGroup

Especifica si el botón está en la última posición de su grupo de botones.

virtual BOOL IsLastInGroup() const;

Valor devuelto

TRUE si el botón es el último de su grupo de botones; de lo contrario, FALSE.

Comentarios

Este método define un grupo de botones como un conjunto vecino de botones que están colocados en la misma fila y limitados por separadores o el borde de la barra de herramientas. Este método devuelve FALSE si el botón de la barra de herramientas no tiene barra de herramientas primaria o si el botón de la barra de herramientas hace referencia al botón Personalizar. Para más información sobre el botón Personalizar, consulte CMFCToolBar::GetCustomizeButton.

Llame al método CMFCToolBarButton::IsFirstInGroup para determinar si el botón está en la primera posición en su grupo de botones.

CMFCToolBarButton::IsLocked

Determina si el botón está en una barra de herramientas bloqueada (no personalizable).

BOOL IsLocked() const;

Valor devuelto

Distinto de cero si el botón está en una barra de herramientas bloqueada; de lo contrario, 0.

Comentarios

El marco llama a este método para determinar si el usuario puede personalizar el botón de la barra de herramientas mediante operaciones de arrastrar y colocar o de editar. Establezca el atributo bloqueado en la barra de herramientas primaria mediante el método CMFCToolBar::LoadToolBar. El marco pasa el valor de este atributo al constructor de cada botón de la barra de herramientas (CMFCToolbarButton) que inserta en la barra de herramientas primaria.

CMFCToolBarButton::IsOwnerOf

Determina si el botón es el propietario del manipulador de ventana proporcionado.

virtual BOOL IsOwnerOf(HWND hwnd);

Parámetros

hwnd
[in] Identificador de ventana.

Valor devuelto

Distinto de cero si el botón es el propietario del manipulador de ventana proporcionado; de lo contrario, 0.

Comentarios

Este método devuelve un valor distinto de cero si hwnd hace referencia al manipulador de ventana directo o si es un elemento secundario del manipulador de ventana que está asociado al botón. Este método devuelve 0 si hwnd es NULL.

CMFCToolBarButton::IsVisible

Determina si el botón de la barra de herramientas está visible.

BOOL IsVisible() const;

Valor devuelto

Distinto de cero si el botón de la barra de herramientas es visible; de lo contrario, 0.

Comentarios

Puede mostrar u ocultar el botón de la barra de herramientas mediante el método CMFCToolBarButton::SetVisible. Llame al método CPane::AdjustSizeImmediate en la barra de herramientas primaria después de llamar a CMFCToolBarButton::SetVisible para recalcular el diseño de una barra de herramientas primaria.

CMFCToolBarButton::IsWindowVisible

Determina si el manipulador de ventana subyacente del botón está visible.

virtual BOOL IsWindowVisible();

Valor devuelto

Distinto de cero si el manipulador de ventana subyacente del botón es visible; de lo contrario, 0.

Comentarios

Este método devuelve un valor distinto de cero si el atributo de estilos del manipulador de ventana subyacente contiene el estilo WS_VISIBLE. Este método devuelve FALSE si el manipulador de ventana subyacente del botón es NULL.

CMFCToolBarButton::m_bImage

Especifica si se muestra una imagen en el botón.

BOOL m_bImage;

Comentarios

Si este miembro de datos se establece en TRUE, el marco muestra la imagen asociada al botón de la barra de herramientas; de lo contrario, el marco no muestra la imagen. Este miembro afecta al valor devuelto del método CMFCToolBarButton::m_bImage.

CMFCToolBarButton::m_bText

Especifica si se muestra una etiqueta de texto en el botón.

BOOL m_bText;

Comentarios

Si este miembro de datos se establece en TRUE, el marco muestra la etiqueta de texto del botón de la barra de herramientas; de lo contrario, el marco no muestra la etiqueta de texto. Este miembro afecta el valor devuelto del método CMFCToolBarButton::m_bText.

CMFCToolBarButton::m_bTextBelow

Especifica si la etiqueta de texto se muestra debajo de la imagen del botón.

BOOL m_bTextBelow;

Comentarios

Si esta variable miembro está establecida en TRUE, el marco muestra el texto del botón debajo de la imagen. El valor predeterminado de este miembro es FALSE.

CMFCToolBarButton::m_bUserButton

Especifica si el botón tiene una imagen definida por el usuario.

BOOL m_bUserButton;

Comentarios

Este miembro de datos se establece en TRUE cuando el botón tiene asociada una imagen definida por el usuario.

CMFCToolBarButton::m_bWholeText

Especifica si el botón muestra su etiqueta de texto completa incluso si no cabe en el rectángulo delimitador.

BOOL m_bWholeText;

Comentarios

Si este miembro de datos se establece en TRUE, el marco agranda el botón para mostrar la etiqueta de texto completa. De lo contrario, el marco se trunca y anexa puntos suspensivos (…) a la etiqueta de texto.

CMFCToolBarButton::m_bWrap

Especifica si el botón ubicado junto a un separador se colocará en la fila siguiente.

BOOL m_bWrap;

Comentarios

El marco establece este miembro de datos en TRUE cuando el botón de la barra de herramientas no cabe en la fila actual o cuando se especifica un diseño (por ejemplo, un número específico de botones de la barra de herramientas por fila).

El marco coloca este botón en la fila siguiente si este miembro de datos está establecido en TRUE y la barra de herramientas está acoplada de manera horizontal o flotante.

El valor predeterminado de este miembro de datos es FALSE.

CMFCToolBarButton::m_bWrapText

Especifica si las etiquetas de texto de varias líneas están habilitadas.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Comentarios

Si esta variable miembro estática es TRUE, el marco permite que todas las barras de herramientas muestren etiquetas de texto de varias líneas en los botones de la barra de herramientas.

El valor predeterminado de este miembro de datos es FALSE.

CMFCToolBarButton::m_nID

Identificador de comando del botón.

UINT m_nID;

Comentarios

Un identificador de comando de -1 indica que el botón es un separador. Todos los separadores de botones tienen el estilo TBBS_SEPARATOR. Consulte CMFCToolBarButton::m_nStyle para más información sobre los estilos de botón.

CMFCToolBarButton::m_nStyle

Estilo del botón.

UINT m_nStyle;

Comentarios

Consulte Estilos de control ToolBar para ver la lista de estilos de botón de barra de herramientas disponibles.

CMFCToolBarButton::m_strText

Etiqueta de texto del botón.

CString m_strText;

Comentarios

Este miembro de datos contiene la etiqueta de texto del botón. La etiqueta de texto puede estar vacía.

CMFCToolBarButton::NotifyCommand

Especifica si el botón procesa el mensaje WM_COMMAND.

virtual BOOL NotifyCommand(int iNotifyCode);

Parámetros

iNotifyCode
[in] El mensaje de notificación asociado al comando.

Valor devuelto

Este método devuelve FALSE.

Comentarios

El marco llama a este método cuando está a punto de enviar un mensaje WM_COMMAND a la ventana primaria.

De manera predeterminada, este método devuelve FALSE. Invalide este método para devolver TRUE si desea procesar el mensaje WM_COMMAND o FALSE para indicar que la barra de herramientas primaria debe manipular el mensaje.

CMFCToolBarButton::OnAddToCustomizePage

Lo llama el marco cuando se agrega el botón a un cuadro de diálogo Personalizar.

virtual void OnAddToCustomizePage();

Comentarios

La implementación predeterminada de este método no hace nada. Invalide este método si desea realizar alguna acción cuando se agrega el botón a un cuadro de diálogo Personalizar.

CMFCToolBarButton::OnBeforeDrag

Especifica si se puede arrastrar el botón.

virtual BOOL OnBeforeDrag() const;

Valor devuelto

TRUE si se puede arrastrar el botón; de lo contrario, FALSE.

Comentarios

El marco llama a este método antes de que el usuario empiece a arrastrar el botón.

La implementación predeterminada de este método devuelve TRUE. Invalide este método para devolver FALSE a fin de deshabilitar el arrastre del botón.

CMFCToolBarButton::OnBeforeDrop

Especifica si un usuario puede colocar el botón en la barra de herramientas de destino.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Parámetros

pTarget
[in] Destino de la operación de arrastrar y colocar.

Valor devuelto

TRUE si el botón se puede colocar en la barra de herramientas de destino proporcionada; en caso contrario, FALSE.

Comentarios

El marco llama a este método antes de colocar el botón en una barra de herramientas.

La implementación predeterminada de este método devuelve TRUE. Invalide este método para devolver FALSE a fin de deshabilitar la operación de colocación en el destino especificado.

CMFCToolBarButton::OnCalculateSize

Lo llama el marco para calcular el tamaño del botón para el contexto de dispositivo y el estado de acoplamiento especificados.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parámetros

pDC
[in] Contexto de dispositivo que muestra el botón.

sizeDefault
[in] Tamaño predeterminado del botón.

bHorz
[in] Estado de acoplamiento de la barra de herramientas primaria. Este parámetro es TRUE si la barra de herramientas está acoplada de manera horizontal o si flota, o bien FALSE si la barra de herramientas está acoplada de manera vertical.

Valor devuelto

Estructura SIZE que contiene las dimensiones del botón, en píxeles.

Comentarios

El marco llama a este método para determinar el tamaño del botón de la barra de herramientas para el contexto de dispositivo y el estado de acoplamiento especificados.

La implementación predeterminada tiene en cuenta los tamaños de texto e imagen (si se muestran), las posiciones de texto e imagen (el texto siguiente o en el lado derecho de la imagen) y el estado de acoplamiento de la barra de herramientas.

Invalide este método si desea proporcionar el tamaño de un botón no estándar (por ejemplo, un botón de cuadro de edición).

CMFCToolBarButton::OnCancelMode

Lo llama el marco para administrar el mensaje WM_CANCELMODE.

virtual void OnCancelMode();

Comentarios

La implementación predeterminada de este método no hace nada. Invalide este método si desea manipular el mensaje WM_CANCELMODE.

CMFCToolBarButton::OnChangeParentWnd

Lo llama el marco cuando el botón se inserta en una barra de herramientas nueva.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parámetros

pWndParent
[in] Ventana primaria nueva.

Comentarios

El botón se inserta en una barra de herramientas, por ejemplo, cuando el usuario lo arrastra de una barra de herramientas a otra.

La implementación predeterminada de este método no hace nada.

CMFCToolBarButton::OnClick

Lo llama el marco cuando el usuario pulsa el botón del mouse.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay=TRUE);

Parámetros

pWnd
[in] Ventana primaria del botón de la barra de herramientas.

bDelay
[in] TRUE si el mensaje se debe manipular con un retraso.

Valor devuelto

Este método devuelve FALSE.

Comentarios

El marco llama a este método cuando el usuario hace clic en el botón de la barra de herramientas.

La implementación predeterminada no hace nada y devuelve FALSE. Invalide este método para devolver un valor distinto de cero si el botón procesa el mensaje de clic.

CMFCToolBarButton::OnClickUp

Lo llama el marco cuando el usuario suelta el botón del mouse.

virtual BOOL OnClickUp();

Valor devuelto

Este método devuelve FALSE.

Comentarios

El marco llama a este método cuando el usuario suelta el botón de la barra de herramientas.

La implementación predeterminada no hace nada y devuelve FALSE. Invalide este método para devolver un valor distinto de cero si el botón procesa el mensaje de clic.

CMFCToolBarButton::OnContextHelp

Lo llama el marco cuando la barra de herramientas primaria controla un mensaje de WM_HELPHITTEST.

virtual BOOL OnContextHelp(CWnd* pWnd);

Parámetros

pWnd
[in] Ventana primaria del botón de la barra de herramientas.

Valor devuelto

Este método devuelve FALSE.

Comentarios

La implementación predeterminada de este método no hace nada y devuelve FALSE. Invalide este método para devolver un valor distinto de cero si el botón procesa el mensaje de ayuda.

Para más información sobre el mensaje WM_HELPHITTEST, consulte TN028: Compatibilidad con la ayuda contextual.

CMFCToolBarButton::OnCtlColor

Lo llama el marco cuando la barra de herramientas primaria maneja un mensaje de WM_CTLCOLOR.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parámetros

pDC
[in] Contexto de dispositivo que muestra el botón.

nCtlColor
[in] Notificación de color específica.

Valor devuelto

Manipulador del objeto brush que el marco utiliza para pintar el fondo del botón.

Comentarios

El marco llama a este método cuando la barra de herramientas primaria procesa el mensaje WM_CTLCOLOR para un botón de la barra de herramientas que contiene un control de Windows. El marco no llama a este método si el botón de la barra de herramientas no tiene ventana.

El marco llama a este método cuando el marco de la barra de herramientas está en modo de personalización y el botón de la barra de herramientas está desbloqueado. Para más información sobre el modo de personalización, consulte CMFCToolBar::SetCustomizeMode. Para más información sobre cómo bloquear los botones de la barra de herramientas, consulte CMFCToolBarButton::IsLocked.

La implementación predeterminada no hace nada y devuelve NULL.

CMFCToolBarButton::OnCustomizeMenu

Permite que el botón modifique el menú proporcionado cuando la aplicación muestra un menú contextual en la barra de herramientas primaria.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Parámetros

pMenu
[in] Menú que se va a personalizar.

Valor devuelto

Este método devuelve FALSE.

Comentarios

La implementación predeterminada no hace nada y devuelve FALSE. Invalide este método y devuelva un valor distinto de cero si desea modificar el contenido del menú proporcionado.

CMFCToolBarButton::OnDblClk

Lo llama el marco cuando la barra de herramientas primaria manipula un mensaje WM_LBUTTONDBLCLK.

virtual void OnDblClk(CWnd* pWnd);

Parámetros

pWnd
[in] - Ventana primaria del botón.

Comentarios

El método CMFCToolBar::OnLButtonDblClk llama a este método cuando la barra de herramientas primaria manipula un mensaje WM_LBUTTONDBLCLK.

La implementación predeterminada de este método no hace nada.

CMFCToolBarButton::OnDraw

Lo llama el marco para dibujar el botón mediante las opciones y los estilos especificados.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz=TRUE,
    BOOL bCustomizeMode=FALSE,
    BOOL bHighlight=FALSE,
    BOOL bDrawBorder=TRUE,
    BOOL bGrayDisabledButtons=TRUE);

Parámetros

pDC
[in] Contexto de dispositivo que muestra el botón.

rect
[in] Rectángulo delimitador del botón.

pImages
[in] Colección de imágenes de barra de herramientas asociada al botón.

bHorz
[in] Estado de acoplamiento de la barra de herramientas primaria. Este parámetro es TRUE cuando el botón está acoplado de manera horizontal y FALSE cuando lo está verticalmente.

bCustomizeMode
[in] Especifica si la barra de herramientas está en modo de personalización. Este parámetro es TRUE cuando la barra de herramientas está en modo de personalización y FALSE cuando no lo está.

bHighlight
[in] Especifica si el botón está resaltado. Este parámetro es TRUE cuando el botón está resaltado y FALSE cuando no lo está.

bDrawBorder
[in] Especifica si el botón debe mostrar su borde. Este parámetro es TRUE cuando se debe mostrar el borde del botón y FALSE cuando no es así.

bGrayDisabledButtons
[in] Especifica si los botones deshabilitados se deben sombrear o si se debe usar la colección de imágenes deshabilitadas. Este parámetro es TRUE cuando se deben sombrear los botones deshabilitados y FALSE cuando este método debe usar la colección de imágenes deshabilitadas.

Comentarios

Invalide este método para personalizar el dibujo del botón de la barra de herramientas.

CMFCToolBarButton::OnDrawOnCustomizeList

Lo llama el marco para dibujar el botón en el panel Comandos del cuadro de diálogo Personalizar.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parámetros

pDC
[in] Contexto de dispositivo que muestra el botón.

rect
[in] Rectángulo delimitador del botón.

bSelected
[in] Especifica si el botón está seleccionado. Si el parámetro es TRUE, el botón está seleccionado. Si el parámetro es FALSE, el botón no está seleccionado.

Valor devuelto

Ancho, en píxeles, del botón en el contexto de dispositivo especificado.

Comentarios

El cuadro de diálogo de personalización (pestaña Comandos) llama a este método cuando el botón está a punto de mostrarse en el cuadro de lista dibujado por el propietario.

La implementación predeterminada de este método muestra la imagen y la etiqueta de texto del botón si están disponibles. Si la etiqueta de texto del botón no está disponible, el método muestra el texto de información sobre herramientas.

Invalide este método para realizar un dibujo personalizado.

CMFCToolBarButton::OnGetCustomToolTipText

Lo llama el marco para recuperar el texto de información sobre herramientas personalizado para el botón.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Parámetros

strToolTip
[out] Objeto CString que recibe el texto de información sobre herramientas.

Valor devuelto

Este método devuelve FALSE.

Comentarios

El marco llama a este método cuando muestra la información sobre herramientas para el botón de la barra de herramientas. Si este método devuelve FALSE, el marco usa una información sobre herramientas predeterminada.

La implementación predeterminada no hace nada y devuelve FALSE. Invalide este método y devuelva un valor distinto de cero para proporcionar texto de información sobre herramientas personalizado para el botón de la barra de herramientas.

CMFCToolBarButton::OnGlobalFontsChanged

Lo llama el el marco cuando cambia la fuente general.

virtual void OnGlobalFontsChanged();

Comentarios

La implementación predeterminada de este método no hace nada. Invalide este método para actualizar la fuente que se usa para mostrar el texto del botón.

CMFCToolBarButton::OnMove

Lo llama el marco cuando se mueve la barra de herramientas primaria.

virtual void OnMove();

Comentarios

La implementación predeterminada de este método no hace nada. Invalide este método para cambiar la posición del botón cuando se mueve la barra de herramientas primaria.

CMFCToolBarButton::OnShow

Lo llama el marco cuando el botón se vuelve visible o invisible.

virtual void OnShow(BOOL bShow);

Parámetros

bShow
[in] Especifica si el botón está visible. Si este parámetro es TRUE, el botón está visible. De lo contrario, no lo está.

Comentarios

La implementación predeterminada de este método no hace nada. Invalide este método para actualizar la visibilidad del botón.

CMFCToolBarButton::OnSize

Lo llama el marco cuando la barra de herramientas primaria cambia de tamaño o posición y este cambio hace que el botón cambie de tamaño.

virtual void OnSize(int iSize);

Parámetros

iSize
[in] Ancho nuevo del botón.

Comentarios

La implementación predeterminada de este método no hace nada. Invalide este método para cambiar el tamaño del botón cuando cambia la barra de herramientas primaria cambia de tamaño o posición.

CMFCToolBarButton::OnToolHitTest

Lo llama el marco cuando la barra de herramientas primaria debe determinar si un punto está en el rectángulo delimitador del botón.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

Parámetros

pWnd
[in] Ventana primaria del botón. Puede ser NULL.

pTI
[in] Una estructura TOOLINFO que contiene información de una herramienta en un control de información sobre herramientas.

Valor devuelto

Resultado de OnMenuButtonToolHitTest si el botón puede recuperar un puntero a la ventana del marco primario; en caso contrario, FALSE.

Comentarios

Este método llama a uno de los métodos siguientes si puede convertir la ventana primaria en un objeto de marco válido:

CMFCToolBarButton::OnUpdateToolTip

Lo llama el marco cuando la barra de herramientas primaria actualiza su texto de información sobre herramientas.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parámetros

pWndParent
[in] La ventana primaria.

iButtonIndex
[in] Índice de base cero del botón en la colección de botones primaria.

wndToolTip
[in] El control que muestra el texto de información sobre herramientas.

str
[out] Objeto CString que recibe el texto de información sobre herramientas actualizado.

Valor devuelto

Este método devuelve FALSE.

Comentarios

La implementación predeterminada de este método no hace nada y devuelve FALSE. Invalide este método para devolver un valor distinto de cero si proporciona una cadena de texto de información sobre herramientas.

CMFCToolBarButton::PrepareDrag

Lo llama el marco cuando el botón está a punto de realizar una operación de arrastrar y colocar.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Parámetros

srcItem
[in] Un objeto COleDataSource que almacena información de estado sobre la operación de arrastrar y colocar.

Valor devuelto

TRUE si la operación se realiza correctamente; de lo contrario, FALSE.

Comentarios

El marco llama a este método para preparar el botón de la barra de herramientas para almacenar su estado en el objeto COleDataSource proporcionado. Este método almacena su estado serializándose en un archivo compartido y pasando ese archivo al método COleDataSource::CacheGlobalData. Para más información sobre la serialización de botones de la barra de herramientas, consulte CMFCToolBarButton::Serialize.

Este método no hace nada y devuelve TREU si no se puede almacenar el botón (el método CMFCToolBarButton::CanBeStored devuelve FALSE). Devuelve FALSE si se produce una excepción durante la serialización de objetos.

Para más información sobre las operaciones OLE de arrastrar y colocar, consulte Funciones OLE de arrastrar y colocar.

CMFCToolBarButton::Rect

Recupera el rectángulo delimitador del botón.

const CRect& Rect() const;

Valor devuelto

Objeto CRect que contiene el rectángulo delimitador de un botón.

CMFCToolBarButton::ResetImageToDefault

Establece en el valor predeterminado la imagen asociada al botón.

virtual void ResetImageToDefault();

Comentarios

Este método recupera la imagen predeterminada de su barra de herramientas primaria mediante el método CMFCToolBar::GetDefaultImage. Si el botón no tiene ninguna imagen predeterminada asociada, este método establece la etiqueta de texto del botón en función de su recurso de cadena mediante el método CStringT::LoadString. Para más información sobre los recursos de cadena, consulte Trabajar con archivos de recursos.

Este método no hace nada si el botón tiene una imagen definida por el usuario.

CMFCToolBarButton::SaveBarState

Guarda el estado del botón de la barra de herramientas.

virtual void SaveBarState();

Comentarios

El marco llama a este método cuando crea un objeto CMFCToolBarButton como resultado de una operación de arrastrar y colocar.

La implementación predeterminada de este método no hace nada. Invalide este método para guardar el estado del botón de la barra de herramientas en un origen de datos externo.

CMFCToolBarButton::Serialize

Lee este objeto desde un archivo o lo escribe en un archivo.

virtual void Serialize(CArchive& ar);

Parámetros

Ar
[in] Objeto CArchive del que se va a serializar o al que se va a serializar.

Comentarios

Este método admite procesos de transferencia de datos, como operaciones de arrastrar y colocar o Portapapeles. Lee o escribe las propiedades del botón, como el identificador, la etiqueta de texto y el identificador de imagen del objeto CArchive proporcionado.

Para obtener ejemplos de serialización, consulte Serialización: Serializar un objeto.

CMFCToolBarButton::SetACCData

Rellena el objeto proporcionado CAccessibilityData con datos de accesibilidad desde el botón de la barra de herramientas.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parámetros

pParent
[in] Ventana primaria del botón de la barra de herramientas.

data
[in] Objeto CAccessibilityData que se rellena con los datos de accesibilidad del botón de la barra de herramientas.

Valor devuelto

Este método devuelve TRUE.

Comentarios

Invalide este método para devolver FALSE si el botón de la barra de herramientas no proporciona datos de accesibilidad.

CMFCToolBarButton::SetClipboardFormatName

Cambia el nombre del formato global del Portapapeles.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Parámetros

lpszName
[in] Nombre nuevo del formato global del Portapapeles. No puede ser NULL.

Comentarios

Este método permite que se produzcan operaciones de arrastrar y colocar entre varias aplicaciones. Cada aplicación debe proporcionar el mismo nombre de formato del Portapapeles.

Debe llamar a este método antes de que el marco llame a CMFCToolBarButton::GetClipboardFormat.

CMFCToolBarButton::SetImage

Establece el índice de imagen del botón.

virtual void SetImage(int iImage);

Parámetros

iImage
[in] Índice la imagen en la colección de imágenes de la barra de herramientas.

Comentarios

Si el botón de la barra de herramientas es un separador, iImage hace referencia al ancho nuevo del botón separador.

Si el valor de iImage es menor que cero, este método deshabilita el dibujo de la imagen y habilita el dibujo de la etiqueta de texto del botón.

CMFCToolBarButton::SetProtectedCommands

Establece la lista de comandos que el usuario no puede personalizar.

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

Parámetros

lstCmds
[in] Lista de comandos protegidos.

Comentarios

En el modo de personalización, el marco deshabilita los comandos de botón de la barra de herramientas que están protegidos. El usuario no puede realizar operaciones de arrastrar y colocar ni de editar en botones de la barra de herramientas deshabilitados.

Use el método CMFCToolBarButton::GetProtectedCommands para recuperar la lista de comandos protegidos.

CMFCToolBarButton::SetRadio

Lo llama el marco cuando un botón cambia su estado activado.

virtual void SetRadio();

Comentarios

La implementación predeterminada de este método no hace nada. Invalide este método para realizar una acción personalizada cuando el botón cambie su estado activado.

CMFCToolBarButton::SetRect

Establece el rectángulo delimitador del botón.

void SetRect(const CRect rect);

Parámetros

rect
[in] Rectángulo delimitador nuevo del botón.

Comentarios

Este método llama al método CMFCToolBarButton::OnMove después de establecer el rectángulo delimitador nuevo.

CMFCToolBarButton::SetStyle

Establece el estilo del botón.

virtual void SetStyle(UINT nStyle);

Parámetros

nStyle
[in] Estilo nuevo del botón.

Comentarios

La implementación predeterminada establece el miembro de datos CMFCToolBarButton::m_nStyle en nStyle. Invalide este método si desea realizar un procesamiento adicional para manipular el cambio de estilo. Consulte Estilos de control de la barra de herramientas para obtener una lista de marcas de estilo válidas.

CMFCToolBarButton::SetVisible

Especifica si el botón está visible.

void SetVisible(BOOL bShow=TRUE);

Parámetros

bShow
[in] Valor booleano que especifica si se debe mostrar u ocultar el botón. Si este parámetro es TRUE, se muestra el botón. Si el parámetro es FALSE, el botón está oculto.

Comentarios

Use esta función para ocultar o mostrar un botón de la barra de herramientas determinado. Llame al método CPane::AdjustSizeImmediate después de llamar a este método.

CMFCToolBarButton::Show

Muestra u oculta el botón.

void Show(BOOL bShow);

Parámetros

bShow
[in] Valor booleano que especifica si se debe mostrar u ocultar el botón. Si este parámetro es TRUE, se muestra el botón. Si el parámetro es FALSE, el botón está oculto.

Comentarios

El marco llama a este método para actualizar la visibilidad de los botones de la barra de herramientas cuando se cambia el tamaño de la barra de herramientas primaria. El marco llama a este método con bShow establecido en FALSE cuando el botón ya no cabe dentro de los límites de la barra de herramientas. El marco llama a este método con bShow establecido en TRUE cuando, después de cambiar el tamaño del botón, vuelve a caber dentro de los límites de la barra de herramientas.

Use el método CMFCToolBarButton::SetVisible para establecer la visibilidad general del botón.

Este método llama al método CMFCToolBarButton::OnShow después de que actualiza el estado de la visibilidad del botón.

Consulte también

Gráfico de jerarquías
Clases
CMFCToolBar (clase)
CMFCToolBarImages (clase)