Clase CMFCToolBarButton
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
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)
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de