Clase CReBarCReBar Class

Barra de control que proporciona información de diseño, persistencia y estado para controles rebar.A control bar that provides layout, persistence, and state information for rebar controls.

SintaxisSyntax

class CReBar : public CControlBar

MiembrosMembers

Métodos públicosPublic Methods

NombreName DescripciónDescription
CReBar::AddBarCReBar::AddBar Agrega una banda a una armadura.Adds a band to a rebar.
CReBar::CrearCReBar::Create Crea el control de armadura y CReBar lo adjunta al objeto.Creates the rebar control and attaches it to the CReBar object.
CreBar::GetReBarCtrlCReBar::GetReBarCtrl Permite el acceso directo al control común subyacente.Allows direct access to the underlying common control.

ObservacionesRemarks

Un objeto de armadura puede contener una variedad de ventanas secundarias, normalmente otros controles, incluidos cuadros de edición, barras de herramientas y cuadros de lista.A rebar object can contain a variety of child windows, usually other controls, including edit boxes, toolbars, and list boxes. Un objeto de armadura puede mostrar sus ventanas secundarias sobre un mapa de bits especificado.A rebar object can display its child windows over a specified bitmap. La aplicación puede cambiar automáticamente el tamaño de la armadura, o el usuario puede cambiar manualmente el tamaño de la armadura haciendo clic o arrastrando su barra de pinzamiento.Your application can automatically resize the rebar, or the user can manually resize the rebar by clicking or dragging its gripper bar.

Ejemplo de RebarMenuExample of RebarMenu

Control de armaduraRebar Control

Un objeto de armadura se comporta de forma similar a un objeto de barra de herramientas.A rebar object behaves similarly to a toolbar object. Una armadura utiliza el mecanismo de hacer clic y arrastrar para cambiar el tamaño de sus bandas.A rebar uses the click-and-drag mechanism to resize its bands. Un control de armadura puede contener una o más bandas, con cada banda que tenga cualquier combinación de una barra de pinzamiento, un mapa de bits, una etiqueta de texto y una ventana secundaria.A rebar control can contain one or more bands, with each band having any combination of a gripper bar, a bitmap, a text label, and a child window. Sin embargo, las bandas no pueden contener más de una ventana secundaria.However, bands cannot contain more than one child window.

CReBarutiliza la clase CReBarCtrl para proporcionar su implementación.CReBar uses the CReBarCtrl class to provide its implementation. Puede tener acceso al control de armadura a través de GetReBarCtrl para aprovechar las opciones de personalización del control.You can access the rebar control through GetReBarCtrl to take advantage of the control's customization options. Para obtener más información acerca CReBarCtrlde los controles de armadura, consulte .For more information about rebar controls, see CReBarCtrl. Para obtener más información sobre el uso de controles de armadura, vea Uso de CReBarCtrl.For more information about using rebar controls, see Using CReBarCtrl.

Precaución

Los objetos de control de armadura y armadura no admiten el acoplamiento de barras de control MFC.Rebar and rebar control objects do not support MFC control bar docking. Si CRebar::EnableDocking se llama, la aplicación se afirmará.If CRebar::EnableDocking is called, your application will assert.

Jerarquía de herenciaInheritance Hierarchy

CObjectCObject

CCmdTargetCCmdTarget

CWndCWnd

CControlBarCControlBar

CReBar

RequisitosRequirements

Encabezado: afxext.hHeader: afxext.h

CReBar::AddBarCReBar::AddBar

Llame a esta función miembro para agregar una banda a la armadura.Call this member function to add a band to the 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ámetrosParameters

pBarpBar
Puntero a CWnd un objeto que es la ventana secundaria que se va a insertar en la armadura.A pointer to a CWnd object that is the child window to be inserted into the rebar. El objeto al que se hace referencia debe tener un WS_CHILD.The referenced object must have a WS_CHILD.

lpszTextlpszText
Puntero a una cadena que contiene el texto que aparecerá en la armadura.A pointer to a string containing the text to appear on the rebar. NULL de forma predeterminada.NULL by default. El texto contenido en lpszText no forma parte de la ventana secundaria; está en la armadura en sí.The text contained in lpszText is not part of the child window; it is on the rebar itself.

pbmppbmp
Puntero a CBitmap un objeto que se mostrará en el fondo de armadura.A pointer to a CBitmap object to be displayed on the rebar background. NULL de forma predeterminada.NULL by default.

dwStyledwStyle
DWORD que contiene el estilo que se aplicará a la armadura.A DWORD containing the style to apply to the rebar. Consulte fStyle la descripción de la función en la estructura Win32 REBARBANDINFO para obtener una lista completa de los estilos de banda.See the fStyle function description in the Win32 structure REBARBANDINFO for a complete list of band styles.

clrForeclrFore
Un valor COLORREF que representa el color de primer plano de la armadura.A COLORREF value that represents the foreground color of the rebar.

clrBackclrBack
Un valor COLORREF que representa el color de fondo de la armadura.A COLORREF value that represents the background color of the rebar.

Valor devueltoReturn Value

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.Nonzero if successful; otherwise 0.

EjemploExample

// 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::CrearCReBar::Create

Llame a esta función miembro para crear una armadura.Call this member function to create a 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ámetrosParameters

pParentWndpParentWnd
Puntero al CWnd objeto cuya ventana de Windows es el elemento primario de la barra de estado.Pointer to the CWnd object whose Windows window is the parent of the status bar. Normalmente la ventana de marco.Normally your frame window.

dwCtrlStyledwCtrlStyle
El estilo de control de armadura.The rebar control style. De forma predeterminada, RBS_BANDBORDERS, que muestra líneas estrechas para separar las bandas adyacentes dentro del control de armadura.By default, RBS_BANDBORDERS, which displays narrow lines to separate adjacent bands within the rebar control. Consulte Estilos de control de armadura en el Windows SDK para obtener una lista de estilos.See Rebar Control Styles in the Windows SDK for a list of styles.

dwStyledwStyle
Los estilos de la ventana de armadura.The rebar window styles.

nIDnID
Identificación de la ventana secundaria de la armadura.The rebar's child-window ID.

Valor devueltoReturn Value

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.Nonzero if successful; otherwise 0.

EjemploExample

Vea el ejemplo de CReBar::AddBar.See the example for CReBar::AddBar.

CreBar::GetReBarCtrlCReBar::GetReBarCtrl

Esta función miembro permite el acceso directo al control común subyacente.This member function allows direct access to the underlying common control.

CReBarCtrl& GetReBarCtrl() const;

Valor devueltoReturn Value

Una referencia a un CReBarCtrl objeto.A reference to a CReBarCtrl object.

ObservacionesRemarks

Llame a esta función miembro para aprovechar la funcionalidad de la armadura de Windows control común en la personalización de la armadura.Call this member function to take advantage of the functionality of the Windows rebar common control in customizing your rebar. Cuando se GetReBarCtrlllama a , devuelve CReBarCtrl un objeto de referencia al objeto para que pueda utilizar cualquiera de los conjuntos de funciones miembro.When you call GetReBarCtrl, it returns a reference object to the CReBarCtrl object so you can use either set of member functions.

Para obtener más CReBarCtrl información sobre el uso de la armadura, consulte Uso de CReBarCtrl.For more information about using CReBarCtrl to customize your rebar, see Using CReBarCtrl.

EjemploExample

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

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

Consulte tambiénSee also

Ejemplo MFCIE de MFCMFC Sample MFCIE
CControlBar (clase)CControlBar Class
Gráfico de jerarquíasHierarchy Chart