Clase CReBar

Barra de control que proporciona información de diseño, persistencia y estado para controles rebar.

Sintaxis

class CReBar : public CControlBar

Miembros

Métodos públicos

Nombre	Descripción
CReBar::AddBar	Agrega una banda a un rebar.
CReBar::Create	Crea el control rebar y lo asocia al objeto CReBar.
CReBar::GetReBarCtrl	Permite el acceso directo al control común subyacente.

Comentarios

Un objeto rebar puede contener varias ventanas secundarias, normalmente otros controles, incluidos cuadros de edición, barras de herramientas y cuadros de lista. Un objeto rebar puede mostrar sus ventanas secundarias en un mapa de bits especificado. La aplicación puede cambiar automáticamente el tamaño del rebar. El usuario también puede cambiar manualmente el tamaño del rebar si hace clic en su barra de redimensionamiento y la arrastra.

Control rebar

Un objeto rebar se comporta de forma similar a un objeto de barra de herramientas. Un rebar usa el mecanismo de clic y arrastre para cambiar el tamaño de sus bandas. Un control rebar puede contener una o varias bandas, y cada una de ellas puede tener cualquier combinación de una barra de agarre, un mapa de bits, una etiqueta de texto y una ventana secundaria. Aun así, las bandas no pueden contener más de una ventana secundaria.

CReBar usa la clase CReBarCtrl para proporcionar su implementación. Puede acceder al control rebar mediante GetReBarCtrl para aprovechar las opciones de personalización del control. Para obtener más información sobre los controles rebar, consulte CReBarCtrl. Para obtener más información sobre el uso de controles rebar, consulte Uso de CReBarCtrl.

Precaución

Los objetos rebar y control rebar no admiten acoplamiento de barras de control MFC. Si se llama a CRebar::EnableDocking, la aplicación lo indicará.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CControlBar

CReBar

Requisitos

Encabezado: afxext.h

CReBar::AddBar

Llame a esta función miembro para agregar una banda al 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
Puntero a un objeto CWnd que es la ventana secundaria que se insertará en el rebar. El objeto al que se hace referencia debe tener WS_CHILD.

lpszText
Puntero a una cadena que contiene el texto que aparecerá en el rebar. NULL de forma predeterminada. El texto contenido en lpszText no forma parte de la ventana secundaria; está en el propio rebar.

pbmp
Puntero a un objeto CBitmap que se mostrará en el fondo del rebar. NULL de forma predeterminada.

dwStyle
DWORD que contiene el estilo que se aplicará al rebar. Consulte la descripción de la función fStyle en la estructura Win32 REBARBANDINFO para obtener una lista completa de los estilos de banda.

clrFore
Valor COLORREF que representa el color de primer plano del rebar.

clrBack
Valor COLORREF que representa el color de fondo del rebar.

Valor devuelto

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.

Ejemplo

// Define a CRebar in your class definition,
// such as: CReBar m_wndReBar;
m_wndReBar.Create(this);
m_wndDlgBar.Create(this, IDD_DIALOGBAR, CBRS_ALIGN_TOP,
                   IDD_DIALOGBAR);
m_wndReBar.AddBar(&m_wndDlgBar);

CReBar::Create

Llame a esta función miembro para crear un rebar.

virtual 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
Puntero al objeto CWnd cuya ventana de Windows es el elemento primario de la barra de estado. Normalmente, es la ventana de marco.

dwCtrlStyle
Estilo del control rebar. De forma predeterminada es RBS_BANDBORDERS, que muestra líneas estrechas para separar bandas adyacentes dentro del control rebar. Para obtener una lista de los estilos, consulte los estilos del control rebar en Windows SDK.

dwStyle
Estilos de ventana del rebar.

Nid
Identificador de la ventana secundaria del rebar.

Valor devuelto

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.

Ejemplo

Consulte el ejemplo de CReBar::AddBar.

CReBar::GetReBarCtrl

Esta función miembro permite el acceso directo al control común subyacente.

CReBarCtrl& GetReBarCtrl() const;

Valor devuelto

Referencia a un objeto CReBarCtrl.

Comentarios

Llame a esta función miembro para usar la funcionalidad del control rebar común de Windows al personalizar el rebar. Cuando se llama a GetReBarCtrl, devuelve un objeto de referencia al objeto CReBarCtrl para que se pueda usar cualquiera de los conjuntos de funciones miembro.

Para obtener más información sobre cómo usar CReBarCtrl para personalizar el rebar, consulte Uso de CReBarCtrl.

Ejemplo

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

UINT nBandCount = refReBarCtrl.GetBandCount();
CString msg;
msg.Format(_T("Band Count is: %u"), nBandCount);
AfxMessageBox(msg);

Vea también

Ejemplo MFCIE de MFC
CControlBar Class
Gráfico de jerarquías