Compartir a través de

Clase CMFCReBar

  • Artículo

Un objeto CMFCReBar es una barra de control que proporciona información de diseño, persistencia y estado de los controles rebar. Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

Sintaxis

class CMFCReBar : public CPane

Miembros

Métodos públicos

Nombre Descripción
CMFCReBar::AddBar Agrega una banda a un rebar.
CMFCReBar::CalcFixedLayout (Invalida CBasePane::CalcFixedLayout).
CMFCReBar::CanFloat (Reemplaza a CBasePane::CanFloat).
CMFCReBar::Create Crea el control rebar y lo asocia al objeto CMFCReBar.
CMFCReBar::EnableDocking (Reemplaza a CBasePane::EnableDocking.)
CMFCReBar::GetReBarBandInfoSize
CMFCReBar::GetReBarCtrl Proporciona acceso directo al control común CReBarCtrl subyacente.
CMFCReBar::OnShowControlBarMenu (Invalida CPane::OnShowControlBarMenu).
CMFCReBar::OnToolHitTest (Reemplaza a CWnd::OnToolHitTest).
CMFCReBar::OnUpdateCmdUI (Reemplaza a CBasePane::OnUpdateCmdUI).
CMFCReBar::SetPaneAlignment (Reemplaza a CBasePane::SetPaneAlignment).

Comentarios

Un objeto CMFCReBar puede contener diversas ventanas secundarias. Esto incluye cuadros de edición, barras de herramientas y cuadros de lista. Puede cambiar el tamaño del control rebar mediante programación o el usuario puede cambiar manualmente el tamaño arrastrando su barra de redimensionamiento. También puede establecer el fondo de un objeto rebar en un mapa de bits de su elección.

Un objeto rebar se comporta de forma similar a un objeto de barra de herramientas. Un control rebar puede contener una o varias bandas, y cada una de ellas puede contener una barra de redimensionamiento, un mapa de bits, una etiqueta de texto y una ventana secundaria.

Ejemplo

En el siguiente ejemplo se muestra cómo usar los distintos métodos en la clase CMFCReBar . En el ejemplo se muestra cómo crear un control rebar y cómo agregarle una banda. La banda funciona como una barra de herramientas interna. Este fragmento de código forma parte del Ejemplo de prueba del control rebar.

CMFCReBar m_wndReBar;

// Each rebar pane will ocupy its own row:
DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP | RBBS_BREAK;
// CMFCMenuBar m_wndMenuBar
// CMFCToolBar m_wndToolBar
if (!m_wndReBar.Create(this) ||
    !m_wndReBar.AddBar(&m_wndMenuBar) ||
    !m_wndReBar.AddBar(&m_wndToolBar, NULL, NULL, dwStyle))
{
   TRACE0("Failed to create rebar\n");
   return -1; // fail to create
}

Jerarquía de herencia

CObject
└ CCmdTarget
 └ CWnd
  └ CBasePane
   └ CPane
    └ CMFCReBar

Requisitos

Encabezado: afxRebar.h

CMFCReBar::AddBar

Agrega una banda a un rebar.

BOOL AddBar(
    CWnd* pBar,
    LPCTSTR pszText = NULL,
    CBitmap* pbmp = NULL,
    DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP);

BOOL AddBar(
    CWnd* pBar,
    COLORREF clrFore,
    COLORREF clrBack,
    LPCTSTR pszText = NULL,
    DWORD dwStyle = RBBS_GRIPPERALWAYS);

Parámetros

pBar
[in, out] Puntero a la ventana secundaria que se insertará en el rebar. El objeto al que se hace referencia debe tener el estilo de ventana WS_CHILD.

pszText
[in] Especifica el texto que aparecerá en el control rebar. El texto no forma parte de la ventana secundaria. En su lugar, aparece en el propio control rebar.

pbmp
[in, out] Especifica el mapa de bits que se va a mostrar en el fondo del control rebar.

dwStyle
[in] Contiene el estilo que se va a aplicar a la banda. Para obtener una lista completa de los estilos de banda, consulte la descripción de fStyle en la estructura REBARBANDINFO de la documentación de Windows SDK.

clrFore
[in] Representa el color de primer plano del control rebar.

clrBack
[in] Representa el color de fondo del control rebar.

Valor devuelto

TRUE si la banda se agregó correctamente al control rebar; de lo contrario, FALSE.

CMFCReBar::Create

Crea el control rebar y lo asocia al objeto CMFCReBar.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = RBS_BANDBORDERS,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_TOP,
    UINT nID = AFX_IDW_REBAR);

Parámetros

pParentWnd
[in, out] Puntero a la ventana primaria de este control rebar.

dwCtrlStyle
[in] Especifica el estilo del control rebar. El valor predeterminado del estilo es RBS_BANDBORDERS, que muestra líneas estrechas para separar bandas adyacentes en el control rebar. Para obtener una lista de estilos válidos, consulte los estilos del control rebar en la documentación de Windows SDK.

dwStyle
[in] Estilo de ventana del control rebar. Para obtener una lista de estilos válidos, consulte Estilos de ventana.

Nid
[in] Identificador de la ventana secundaria del rebar.

Valor devuelto

TRUE si el control rebar se crea correctamente; de lo contrario, FALSE.

Comentarios

CMFCReBar::GetReBarCtrl

Proporciona acceso directo a CReBarCtrl, el control común subyacente de los objetos CMFCReBar.

CReBarCtrl& GetReBarCtrl() const;

Valor devuelto

Referencia al objeto subyacente CReBarCtrl.

Comentarios

Llame a este método para usar la funcionalidad del control rebar común de Windows al personalizar el rebar.

CMFCReBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parámetros

[in] bStretch
[in] bHorz

Valor devuelto

Comentarios

CMFCReBar::CanFloat

virtual BOOL CanFloat() const;

Valor devuelto

Comentarios

CMFCReBar::EnableDocking

void EnableDocking(DWORD dwDockStyle);

Parámetros

[in] dwDockStyle

Comentarios

CMFCReBar::GetReBarBandInfoSize

UINT GetReBarBandInfoSize() const;

Valor devuelto

Comentarios

CMFCReBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Parámetros

[in] CPoint

Valor devuelto

Comentarios

CMFCReBar::OnToolHitTest

virtual INT_PTR OnToolHitTest(
    CPoint point,
    TOOLINFO* pTI) const;

Parámetros

[in] point
[in] pTI

Valor devuelto

Comentarios

CMFCReBar::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parámetros

[in] pTarget
[in] bDisableIfNoHndler

Comentarios

CMFCReBar::SetPaneAlignment

virtual void SetPaneAlignment(DWORD dwAlignment);

Parámetros

[in] dwAlignment

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CReBarCtrl (clase)
CPane (clase)