Clase de CMFCCaptionBar

Artículo
02/19/2013

Un objeto de CMFCCaptionBar es una barra de controles que puede mostrar tres elementos: un botón, una etiqueta de texto, y un mapa de bits.Puede mostrar un solo elemento de cada tipo al mismo tiempo.Puede alinear cada elemento a la izquierda o los bordes derecho del control o con el centro.También puede aplicar un plano o un estilo 3D a la parte superior y en el borde inferior de la barra de título.

class CMFCCaptionBar : public CPane

Members

Métodos públicos

Nombre	Descripción
CMFCCaptionBar::Create	Crear el control de barra de título y lo asocia al objeto de CMFCCaptionBar.
CMFCCaptionBar::DoesAllowDynInsertBefore	Indica si otro panel se puede insertar dinámicamente entre la barra de título y su marco primario.(Reemplaza CBasePane::DoesAllowDynInsertBefore.)
CMFCCaptionBar::EnableButton	Habilita o deshabilita el botón de la barra de título.
CMFCCaptionBar::GetAlignment	Devuelve la alineación del elemento especificado.
CMFCCaptionBar::GetBorderSize	Devuelve el tamaño del borde de la barra de título.
CMFCCaptionBar::GetButtonRect	Recupera el rectángulo delimitador del botón en la barra de título.
CMFCCaptionBar::GetMargin	Devuelve la distancia entre el borde de los elementos de la barra de título y el borde del control de barra de título.
CMFCCaptionBar::IsMessageBarMode	Especifica si la barra de título está en modo de barra de mensajes.
CMFCCaptionBar::RemoveBitmap	Quita la imagen de mapa de bits de la barra de título.
CMFCCaptionBar::RemoveButton	Quita el botón de la barra de título.
CMFCCaptionBar::RemoveIcon	Quita el icono de la barra de título.
CMFCCaptionBar::RemoveText	Quita el etiqueta de texto de la barra de título.
CMFCCaptionBar::SetBitmap	Establece la imagen de mapa de bits de la barra de título.
CMFCCaptionBar::SetBorderSize	Establece el tamaño del borde de la barra de título.
CMFCCaptionBar::SetButton	Establece el botón de la barra de título.
CMFCCaptionBar::SetButtonPressed	Especifica si el botón permanece presionado.
CMFCCaptionBar::SetButtonToolTip	Establece la información sobre herramientas para el botón.
CMFCCaptionBar::SetFlatBorder	Establece el estilo de borde de la barra de título.
CMFCCaptionBar::SetIcon	Establece el icono de una barra de título.
CMFCCaptionBar::SetImageToolTip	Establece la información sobre herramientas para la imagen de la barra de título.
CMFCCaptionBar::SetMargin	Establece la distancia entre el borde del elemento de la barra de título y el borde del control de barra de título.
CMFCCaptionBar::SetText	Establece el etiqueta de texto de la barra de título.

Métodos protegidos

Nombre	Descripción
CMFCCaptionBar::OnDrawBackground	Llamado por el marco para rellenar el fondo de la barra de título.
CMFCCaptionBar::OnDrawBorder	Llamado por el marco para dibujar el borde de la barra de título.
CMFCCaptionBar::OnDrawButton	Llamado por el marco para dibujar el botón de la barra de título.
CMFCCaptionBar::OnDrawImage	Llamado por el marco para dibujar la imagen de la barra de título.
CMFCCaptionBar::OnDrawText	Llamado por el marco para dibujar el texto de la barra de título.

Miembros de datos

Nombre	Descripción
CMFCCaptionBar::m_clrBarBackground	El color de fondo de la barra de título.
CMFCCaptionBar::m_clrBarBorder	Color del borde de la barra de título.
CMFCCaptionBar::m_clrBarText	Color del texto de la barra de título.

Comentarios

Para crear una barra de título, siga estos pasos:

Cree el objeto de CMFCCaptionBar.Normalmente, se agrega la barra de título a una clase de ventana de marco.
Llame al método de CMFCCaptionBar::Create para crear el control de barra de título y para adjuntarlo al objeto de CMFCCaptionBar.
Llame a CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcon, y CMFCCaptionBar::SetBitmap para establecer los elementos de la barra de título.

Cuando se establece el elemento de botón, debe asignar un identificador de comando al botón.Cuando el usuario hace clic en el botón, la barra de título enruta los mensajes de WM_COMMAND que tienen este identificador a la ventana de marco principal.

La barra de título también puede funcionar en modo de barra de mensajes, que emula la barra de mensajes que aparece en las aplicaciones de Microsoft Office 2007.En modo de barra de mensajes, la barra de título muestra un mapa de bits, un mensaje, y un botón (que abra normalmente un cuadro de diálogo). Puede asignar una información sobre herramientas al mapa de bits.

Para habilitar el modo de la barra de mensajes, la llamada a CMFCCaptionBar::Create y establecer el cuarto parámetro (bIsMessageBarMode) a TRUE.

Ejemplo

El ejemplo siguiente se muestra cómo utilizar varios métodos en la clase de CMFCCaptionBar.El ejemplo muestra cómo crear un control de la barra de título, establece un borde 3D de la barra de título, establece la distancia, en píxeles, entre el borde de los elementos de la barra de título y el borde del control de barra de título, establece el botón de la barra de título, establece la información sobre herramientas para el botón, establece el etiqueta de texto de la barra de título, establece la imagen de mapa de bits de la barra de título, y establece la información sobre herramientas para la imagen en la barra de título.Este fragmento de código es parte de Ejemplo 2007 de demostración de MS Office.

    CMFCCaptionBar m_wndMessageBar;


...


BOOL CMainFrame::CreateMessageBar()
{
    // The this pointer points to a CMainFrame class which extends the CFrameWndEx class.
    if (!m_wndMessageBar.Create(WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS, this, ID_VIEW_MESSAGEBAR, -1, TRUE))
    {
        TRACE0("Failed to create caption bar\n");
        return FALSE;
    }

    m_wndMessageBar.SetFlatBorder( FALSE );
    m_wndMessageBar.SetMargin(10);
    m_wndMessageBar.SetButton(_T("Options..."), ID_TOOLS_OPTIONS, CMFCCaptionBar::ALIGN_LEFT, FALSE);
    m_wndMessageBar.SetButtonToolTip(_T("Click here to see more options"));

    m_wndMessageBar.SetText(_T("Welcome to the MFC MSOffice2007 demonstration!"), CMFCCaptionBar::ALIGN_LEFT);

    m_wndMessageBar.SetBitmap(IDB_INFO, RGB(255, 255, 255), FALSE, CMFCCaptionBar::ALIGN_LEFT);
    m_wndMessageBar.SetImageToolTip(_T("Important"), _T("Please take a look at MSOffice2007Demo source code to learn how to create advanced user interface in minutes."));

    return TRUE;
}