Grundleisten-Steuerelemente und Bänder

  • Artikel

Der Standard Zweck eines Rebar-Steuerelements besteht darin, als Container für untergeordnete Fenster, allgemeine Dialogsteuerelemente, Menüs, Symbolleisten usw. zu fungieren. Diese Eindämmung wird durch das Konzept einer "Band" unterstützt. Jeder Ziehleistenband kann eine beliebige Kombination aus Ziehleiste, Bitmap, Textbeschriftung und einem untergeordneten Fenster enthalten.

Die Klasse CReBarCtrl verfügt über viele Memberfunktionen, mit denen Sie Informationen für einen bestimmten Balken abrufen und bearbeiten können:

  • GetBandCount Ruft die Anzahl der aktuellen Bänder im Rebar-Steuerelement ab.

  • GetBandInfo Initialisiert eine REBARBANDINFO-Struktur mit Informationen aus dem angegebenen Band. Es gibt eine entsprechende SetBandInfo-Memberfunktion .

  • GetRect Ruft das umgebende Rechteck eines angegebenen Bandes ab.

  • GetRowCount Ruft die Anzahl der Bandzeilen in einem Rebar-Steuerelement ab.

  • IDToIndex Ruft den Index eines angegebenen Bandes ab.

  • GetBandBorders Ruft die Rahmen eines Bandes ab.

Zusätzlich zur Manipulation werden mehrere Memberfunktionen bereitgestellt, mit denen Sie bestimmte Bänder für die Leiste verwenden können.

InsertBand - und DeleteBand-Bänder hinzufügen und entfernen. MinimierenBand und MaximizeBand wirken sich auf die aktuelle Größe eines bestimmten Balkens aus. MoveBand ändert den Index eines bestimmten Leistenbands. ShowBand blendet einen Leistenband vom Benutzer ein oder aus.

Das folgende Beispiel veranschaulicht das Hinzufügen eines Symbolleistenbands (m_wndToolBar) zu einem vorhandenen Rebar-Steuerelement (m_wndReBar). Das Band wird beschrieben, indem die rbi Struktur initialisiert und dann die InsertBand Memberfunktion aufgerufen wird:

//load bitmap for toolbar background
m_RebarBitmap.LoadBitmap(IDB_BITMAP1);

//create a toolbar band
m_Toolbar1.Create(this, TBSTYLE_TRANSPARENT | TBSTYLE_FLAT);
m_Toolbar1.LoadToolBar(IDR_MAINFRAME);

REBARBANDINFO rbi = { 0 };
rbi.cbSize = sizeof(REBARBANDINFO);
rbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD | RBBIM_CHILDSIZE |
RBBIM_STYLE | RBBIM_TEXT;
rbi.fStyle = RBBS_GRIPPERALWAYS;
rbi.cxMinChild = 300;
rbi.cyMinChild = 50;
rbi.lpText = _T("Band #1");
rbi.cch = 7;
rbi.cx = 300;
rbi.hbmBack = (HBITMAP)m_RebarBitmap;
rbi.hwndChild = (HWND)m_Toolbar1;
m_Rebar.GetReBarCtrl().InsertBand(0, &rbi);

Siehe auch

Verwenden von CReBarCtrl
Steuerelemente