Auf Englisch lesen

Freigeben über

CReBarCtrl-Klasse

  • Artikel

Kapselt die Funktionalität eines Grundleisten-Steuerelements. Dabei handelt es sich um einen Container für ein untergeordnetes Fenster.

Syntax

class CReBarCtrl : public CWnd

Member

Öffentliche Konstruktoren

Name Beschreibung
CReBarCtrl::CReBarCtrl Erstellt ein CReBarCtrl-Objekt.

Öffentliche Methoden

Name Beschreibung
CReBarCtrl::BeginDrag Platziert das Rebar-Steuerelement in den Drag-and-Drop-Modus.
CReBarCtrl::Create Erstellt das Rebar-Steuerelement und fügt es an das CReBarCtrl Objekt an.
CReBarCtrl::CreateEx Erstellt ein Rebar-Steuerelement mit den angegebenen erweiterten Windows-Formatvorlagen und fügt es an ein CReBarCtrl Objekt an.
CReBarCtrl::D eleteBand Löscht ein Band aus einem Rebar-Steuerelement.
CReBarCtrl::D ragMove Aktualisiert die Ziehposition im Rebar-Steuerelement nach einem Aufruf von BeginDrag.
CReBarCtrl::EndDrag Beendet den Drag-and-Drop-Vorgang des Rebar-Steuerelements.
CReBarCtrl::GetBandBorders Ruft die Rahmen eines Bandes ab.
CReBarCtrl::GetBandCount Ruft die Anzahl der Bänder ab, die sich derzeit im Rebar-Steuerelement befinden.
CReBarCtrl::GetBandInfo Ruft Informationen zu einem angegebenen Band in einem Rebar-Steuerelement ab.
CReBarCtrl::GetBandMargins Ruft die Ränder eines Bandes ab.
CReBarCtrl::GetBarHeight Ruft die Höhe des Rebar-Steuerelements ab.
CReBarCtrl::GetBarInfo Ruft Informationen über das Rebar-Steuerelement und die von ihr verwendete Bildliste ab.
CReBarCtrl::GetBkColor Ruft die Standardhintergrundfarbe eines Rebar-Steuerelements ab.
CReBarCtrl::GetColorScheme Ruft die COLORSCHEME-Struktur ab, die dem Rebar-Steuerelement zugeordnet ist.
CReBarCtrl::GetDropTarget Ruft den Schnittstellenzeiger eines Rebar-Steuerelements IDropTarget ab.
CReBarCtrl::GetExtendedStyle Ruft die erweiterte Formatvorlage des aktuellen Rebar-Steuerelements ab.
CReBarCtrl::GetImageList Ruft die Bildliste ab, die einem Rebar-Steuerelement zugeordnet ist.
CReBarCtrl::GetPalette Ruft die aktuelle Palette des Rebar-Steuerelements ab.
CReBarCtrl::GetRect Ruft das umgebende Rechteck für ein bestimmtes Band in einem Rebar-Steuerelement ab.
CReBarCtrl::GetRowCount Ruft die Anzahl der Bandzeilen in einem Rebar-Steuerelement ab.
CReBarCtrl::GetRowHeight Ruft die Höhe einer angegebenen Zeile in einem Rebar-Steuerelement ab.
CReBarCtrl::GetTextColor Ruft die Standardtextfarbe eines Rebar-Steuerelements ab.
CReBarCtrl::GetToolTips Ruft den Ziehpunkt zu jedem Tooltipp-Steuerelement ab, das dem Rebar-Steuerelement zugeordnet ist.
CReBarCtrl::HitTest Bestimmt, welcher Teil eines Rebarbands sich an einem bestimmten Punkt auf dem Bildschirm befindet, wenn an diesem Punkt ein Balkenband vorhanden ist.
CReBarCtrl::IDToIndex Wandelt einen Bandbezeichner (ID) in einen Bandindex in ein Rebar-Steuerelement um.
CReBarCtrl::InsertBand Fügt ein neues Band in ein Rebar-Steuerelement ein.
CReBarCtrl::MaximizeBand Ändert die Größe eines Bandes in einem Rebar-Steuerelement auf seine größte Größe.
CReBarCtrl::MinimizeBand Ändert die Größe eines Bandes in einem Rebar-Steuerelement auf seine kleinste Größe.
CReBarCtrl::MoveBand Verschiebt ein Band von einem Index in einen anderen.
CReBarCtrl::P ushChevron Verschiebt programmgesteuert ein Chevron.
CReBarCtrl::RestoreBand Ändert die Größe eines Bandes in einem Rebar-Steuerelement auf seine ideale Größe.
CReBarCtrl::SetBandInfo Legt die Merkmale eines vorhandenen Bandes in einem Rebar-Steuerelement fest.
CReBarCtrl::SetBandWidth Legt die Breite des angegebenen verankerten Bandes im aktuellen Rebar-Steuerelement fest.
CReBarCtrl::SetBarInfo Legt die Merkmale eines Rebar-Steuerelements fest.
CReBarCtrl::SetBkColor Legt die Standardhintergrundfarbe eines Rebar-Steuerelements fest.
CReBarCtrl::SetColorScheme Legt das Farbschema für die Schaltflächen eines Rebar-Steuerelements fest.
CReBarCtrl::SetExtendedStyle Legt die erweiterten Formatvorlagen für das aktuelle Rebar-Steuerelement fest.
CReBarCtrl::SetImageList Legt die Bildliste eines Rebar-Steuerelements fest.
CReBarCtrl::SetOwner Legt das Besitzerfenster eines Rebar-Steuerelements fest.
CReBarCtrl::SetPalette Legt die aktuelle Palette des Rebar-Steuerelements fest.
CReBarCtrl::SetTextColor Legt die Standardtextfarbe eines Rebar-Steuerelements fest.
CReBarCtrl::SetToolTips Ordnet ein QuickInfo-Steuerelement dem Rebar-Steuerelement zu.
CReBarCtrl::SetWindowTheme Legt die visuelle Formatvorlage des Rebar-Steuerelements fest.
CReBarCtrl::ShowBand Blendet ein bestimmtes Band in einem Rebar-Steuerelement ein oder aus.
CReBarCtrl::SizeToRect Passt ein Rebar-Steuerelement an ein angegebenes Rechteck an.

Hinweise

Die Anwendung, in der sich das Rebar-Steuerelement befindet, weist dem Leistenband das untergeordnete Fenster zu, das vom Rebar-Steuerelement enthalten ist. Das untergeordnete Fenster ist in der Regel ein weiteres gängiges Steuerelement.

Rebar-Steuerelemente enthalten einen oder mehrere Bänder. Jedes Band kann eine Kombination aus einem Ziehelementbalken, einer Bitmap, einer Textbezeichnung und einem untergeordneten Fenster enthalten. Das Band kann nur eines dieser Elemente enthalten.

Das Rebar-Steuerelement kann das untergeordnete Fenster über einer angegebenen Hintergrundbitmap anzeigen. Alle Bänder für die Leiste können geändert werden, mit Ausnahme der Steuerelemente, die die RBBS_FIXEDSIZE Formatvorlage verwenden. Beim Ändern der Position oder Größenänderung eines Leisten-Steuerelementbands verwaltet das Rebar-Steuerelement die Größe und Position des untergeordneten Fensters, das diesem Band zugewiesen ist. Zum Ändern der Größe oder Änderung der Reihenfolge von Bändern innerhalb des Steuerelements klicken und ziehen Sie die Ziehleiste eines Bandes.

Die folgende Abbildung zeigt ein Rebar-Steuerelement mit drei Bändern:

  • Band 0 enthält ein flaches, transparentes Symbolleistensteuerelement.

  • Band 1 enthält sowohl transparente Standard- als auch transparente Dropdownschaltflächen.

  • Band 2 enthält ein Kombinationsfeld und vier Standardschaltflächen.

    Beispiel für ein Menü

Rebar-Steuerelement

Unterstützung für Steuerelemente für die Leiste:

  • Bildlisten.

  • Nachrichtenverarbeitung.

  • Benutzerdefinierte Zeichenfunktion.

  • Eine Vielzahl von Steuerelementformatvorlagen zusätzlich zu Standardfensterformatvorlagen. Eine Liste dieser Formatvorlagen finden Sie unter Rebar Control Styles im Windows SDK.

Weitere Informationen finden Sie unter Verwenden von CReBarCtrl.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CReBarCtrl

Anforderungen

Header: afxcmn.h

CReBarCtrl::BeginDrag

Implementiert das Verhalten der Win32-Nachricht RB_BEGINDRAG, wie im Windows SDK beschrieben.

C++ 
void BeginDrag(
    UINT uBand,
    DWORD dwPos = (DWORD)-1);

Parameter

uBand
Nullbasierter Index des Bandes, den der Drag-and-Drop-Vorgang beeinflusst.

dwPos
Ein DWORD-Wert, der die Start mauskoordinaten enthält. Die horizontale Koordinate ist im LOWORD enthalten und die vertikale Koordinate imHIWORD. Wenn Sie (DWORD)-1 übergeben, verwendet das Rebar-Steuerelement die Position der Maus, wenn der Thread des Steuerelements zuletzt aufgerufen oder PeekMessageaufgerufen GetMessage wird.

CReBarCtrl::Create

Erstellt das Rebar-Steuerelement und fügt es an das CReBarCtrl Objekt an.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Gibt die Kombination der auf das Steuerelement angewendeten Formatvorlagen für das Rebar-Steuerelement an. Eine Liste der unterstützten Formatvorlagen finden Sie unter Rebar Control Styles im Windows SDK.

rect
Ein Verweis auf ein CRect-Objekt oder eine RECT-Struktur, die die Position und Größe des Rebar-Steuerelements darstellt.

pParentWnd
Ein Zeiger auf ein CWnd-Objekt , das das übergeordnete Fenster des Rebar-Steuerelements ist. Er darf nicht NULL sein.

Nid
Gibt die Steuerelement-ID des Rebar-Steuerelements an.

Rückgabewert

Nonzero, wenn das Objekt erfolgreich erstellt wurde; andernfalls 0.

Hinweise

Erstellen Eines Rebar-Steuerelements in zwei Schritten:

  1. Rufen Sie CReBarCtrl auf, um ein CReBarCtrl Objekt zu erstellen.

  2. Rufen Sie diese Memberfunktion auf, die das Windows-Steuerelement für die Erneute Leiste erstellt und an das CReBarCtrl Objekt anfügt.

Beim Aufrufen Createwerden die allgemeinen Steuerelemente initialisiert.

Beispiel

C++ 
CReBarCtrl *pReBarCtrl = new CReBarCtrl();
CRect rect;
GetWindowRect(rect);
pReBarCtrl->Create(RBS_BANDBORDERS, rect, this, AFX_IDW_REBAR);

// Use ReBar Control.

delete pReBarCtrl;

CReBarCtrl::CreateEx

Erstellt ein Steuerelement (ein untergeordnetes Fenster) und ordnet es dem Objekt zu CReBarCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Gibt die erweiterte Formatvorlage des zu erstellenden Steuerelements an. Eine Liste der erweiterten Windows-Stile finden Sie unter dem dwExStyle-Parameter für CreateWindowEx im Windows SDK.

dwStyle
Gibt die Kombination der auf das Steuerelement angewendeten Formatvorlagen für das Rebar-Steuerelement an. Eine Liste der unterstützten Formatvorlagen finden Sie unter "Rebar Control Styles " im Windows SDK.

rect
Ein Verweis auf eine RECT-Struktur , die die Größe und Position des zu erstellenden Fensters in Clientkoordinaten von pParentWnd beschreibt.

pParentWnd
Ein Zeiger auf das Fenster, das das übergeordnete Steuerelement ist.

Nid
Die Untergeordnete Fenster-ID des Steuerelements.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Verwenden Sie CreateEx anstelle von "Erstellen ", um erweiterte Windows-Formatvorlagen anzuwenden, die durch die erweiterte Windows-Formatvorlage WS_EX_ angegeben werden.

CReBarCtrl::CReBarCtrl

Erstellt ein CReBarCtrl-Objekt.

CReBarCtrl();

Beispiel

Sehen Sie sich das Beispiel für CReBarCtrl::Create an.

CReBarCtrl::D eleteBand

Implementiert das Verhalten der Win32-Nachricht RB_DELETEBAND, wie im Windows SDK beschrieben.

BOOL DeleteBand(UINT uBand);

Parameter

uBand
Nullbasierter Index des zu löschenden Bandes.

Rückgabewert

Nonzero, wenn das Band erfolgreich gelöscht wurde; andernfalls 0.

Beispiel

C++ 
UINT nCount = m_wndReBar.GetReBarCtrl().GetBandCount();

if (nCount > 0)
   m_wndReBar.GetReBarCtrl().DeleteBand(nCount - 1);

CReBarCtrl::D ragMove

Implementiert das Verhalten der Win32-Nachricht RB_DRAGMOVE, wie im Windows SDK beschrieben.

C++ 
void DragMove(DWORD dwPos = (DWORD)-1);

Parameter

dwPos
Ein DWORD-Wert, der die neuen Mauskoordinaten enthält. Die horizontale Koordinate ist im LOWORD enthalten und die vertikale Koordinate imHIWORD. Wenn Sie (DWORD)-1 übergeben, verwendet das Rebar-Steuerelement die Position der Maus, wenn der Thread des Steuerelements zuletzt aufgerufen oder PeekMessageaufgerufen GetMessage wird.

CReBarCtrl::EndDrag

Implementiert das Verhalten der Win32-Nachricht RB_ENDDRAG, wie im Windows SDK beschrieben.

C++ 
void EndDrag();

CReBarCtrl::GetBandBorders

Implementiert das Verhalten der Win32-Nachricht RB_GETBANDBORDERS, wie im Windows SDK beschrieben.

C++ 
void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

Parameter

uBand
Nullbasierter Index des Bandes, für den die Rahmen abgerufen werden.

vr china
Ein Zeiger auf eine RECT-Struktur , die die Rahmenrahmen empfängt. Wenn das Rebar-Steuerelement die RBS_BANDBORDERS Formatvorlage aufweist, erhält jedes Element dieser Struktur die Anzahl der Pixel auf der entsprechenden Seite des Bandes, die den Rahmen darstellt. Wenn das Rebar-Steuerelement nicht über die RBS_BANDBORDERS Formatvorlage verfügt, empfängt nur das linke Element dieser Struktur gültige Informationen. Eine Beschreibung der Formatvorlagen für das Rebar-Steuerelement finden Sie unter "Rebar Control Styles " im Windows SDK.

CReBarCtrl::GetBandCount

Implementiert das Verhalten der Win32-Nachricht RB_GETBANDCOUNT, wie im Windows SDK beschrieben.

UINT GetBandCount() const;

Rückgabewert

Die Anzahl der dem Steuerelement zugewiesenen Bänder.

CReBarCtrl::GetBandInfo

Implementiert das Verhalten der Win32-Nachricht RB_GETBANDINFO wie im Windows SDK beschrieben.

BOOL GetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi) const;

Parameter

uBand
Nullbasierter Index des Bandes, für den die Informationen abgerufen werden.

prbbi
Ein Zeiger auf eine REBARBANDINFO-Struktur , um die Bandinformationen zu empfangen. Sie müssen das cbSize Element dieser Struktur sizeof(REBARBANDINFO) auf die Elemente festlegen, fMask die Sie abrufen möchten, bevor Sie diese Nachricht senden.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

CReBarCtrl::GetBandMargins

Ruft die Ränder des Bandes ab.

C++ 
void GetBandMargins(PMARGINS pMargins);

Parameter

pMargins
Ein Zeiger auf eine MARGINS-Struktur, die die Informationen empfängt.

Hinweise

Diese Memberfunktion emuliert die Funktionalität der RB_GETBANDMARGINS Nachricht, wie im Windows SDK beschrieben.

CReBarCtrl::GetBarHeight

Ruft die Höhe der Leiste ab.

UINT GetBarHeight() const;

Rückgabewert

Wert, der die Höhe des Steuerelements in Pixel darstellt.

CReBarCtrl::GetBarInfo

Implementiert das Verhalten der Win32-Nachrichten-RB_GETBARINFO, wie im Windows SDK beschrieben.

BOOL GetBarInfo(REBARINFO* prbi) const;

Parameter

prbi
Ein Zeiger auf eine REBARINFO-Struktur , die die Informationen zum Rebar-Steuerelement empfängt. Sie müssen das cbSize-Element dieser Struktur festlegen, sizeof(REBARINFO) bevor Sie diese Nachricht senden.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

CReBarCtrl::GetBkColor

Implementiert das Verhalten der Win32-Nachrichten-RB_GETBKCOLOR, wie im Windows SDK beschrieben.

COLORREF GetBkColor() const;

Rückgabewert

Ein COLORREF-Wert, der die aktuelle Standardhintergrundfarbe darstellt.

CReBarCtrl::GetColorScheme

Ruft die COLORSCHEME-Struktur für das Rebar-Steuerelement ab.

BOOL GetColorScheme(COLORSCHEME* lpcs);

Parameter

lpcs
Ein Zeiger auf eine COLORSCHEME-Struktur , wie im Windows SDK beschrieben.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Die COLORSCHEME Struktur enthält die Hervorhebungsfarbe der Schaltfläche und die Schattenfarbe der Schaltfläche.

CReBarCtrl::GetDropTarget

Implementiert das Verhalten der Win32-Nachrichten-RB_GETDROPTARGET, wie im Windows SDK beschrieben.

IDropTarget* GetDropTarget() const;

Rückgabewert

Ein Zeiger auf eine IDropTarget-Schnittstelle .

CReBarCtrl::GetExtendedStyle

Ruft die erweiterten Formatvorlagen des aktuellen Rebar-Steuerelements ab.

DWORD GetExtendedStyle() const;

Rückgabewert

Eine bitweise Kombination (OR) von Flags, die die erweiterten Formatvorlagen angeben. Die möglichen Kennzeichen sind RBS_EX_SPLITTER und RBS_EX_TRANSPARENT. Weitere Informationen finden Sie im dwMask-Parameter der CReBarCtrl::SetExtendedStyle-Methode .

Hinweise

Diese Methode sendet die RB_GETEXTENDEDSTYLE Nachricht, die im Windows SDK beschrieben wird.

CReBarCtrl::GetImageList

Ruft das Objekt ab, das CImageList einem Rebar-Steuerelement zugeordnet ist.

CImageList* GetImageList() const;

Rückgabewert

Ein Zeiger auf ein CImageList-Objekt . Gibt NULL zurück, wenn keine Bildliste für das Steuerelement festgelegt ist.

Hinweise

Diese Memberfunktion verwendet Größen- und Maskierungsinformationen, die in der REBARINFO-Struktur gespeichert sind, wie im Windows SDK beschrieben.

CReBarCtrl::GetPalette

Ruft die aktuelle Palette des Rebar-Steuerelements ab.

CPalette* GetPalette() const;

Rückgabewert

Ein Zeiger auf ein CPalette -Objekt, das die aktuelle Palette des Rebar-Steuerelements angibt.

Hinweise

Beachten Sie, dass diese Memberfunktion anstelle einer HPALETTE ein CPalette Objekt als Rückgabewert verwendet.

Beispiel

C++ 
CPalette *pPalette = m_wndReBar.GetReBarCtrl().GetPalette();
if (pPalette)
{
   int nEntries = pPalette->GetEntryCount();
   CString msg;
   msg.Format(_T("Number of palette entries: %d"), nEntries);
   AfxMessageBox(msg);
}
else
{
   AfxMessageBox(_T("No palette!"));
}

CReBarCtrl::GetRect

Implementiert das Verhalten der Win32-Nachricht RB_GETRECT, wie im Windows SDK beschrieben.

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

Parameter

uBand
Nullbasierter Index eines Bandes im Rebar-Steuerelement.

vr china
Ein Zeiger auf eine RECT-Struktur , die die Grenzen des Balkenbands empfängt.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Beispiel

C++ 
CRect rc;
m_wndReBar.GetReBarCtrl().GetRect(0, &rc);
CString msg;
msg.Format(_T("rect.left = %d, rect.top = %d, ")
           _T("rect.right = %d, rect.bottom = %d"),
           rc.left,
           rc.top, rc.right, rc.bottom);
AfxMessageBox(msg);

CReBarCtrl::GetRowCount

Implementiert das Verhalten der Win32-Nachricht RB_GETROWCOUNT, wie im Windows SDK beschrieben.

UINT GetRowCount() const;

Rückgabewert

Ein UINT-Wert, der die Anzahl der Bandzeilen im Steuerelement darstellt.

Beispiel

C++ 
UINT nRowCount = m_wndReBar.GetReBarCtrl().GetRowCount();
CString msg;
msg.Format(_T("Row Count is %d"), nRowCount);
AfxMessageBox(msg);

CReBarCtrl::GetRowHeight

Implementiert das Verhalten der Win32-Nachricht RB_GETROWHEIGHT, wie im Windows SDK beschrieben.

UINT GetRowHeight(UINT uRow) const;

Parameter

uRow
Nullbasierter Index des Bandes, der seine Höhe abgerufen hat.

Rückgabewert

Ein UINT-Wert, der die Zeilenhöhe in Pixel darstellt.

Beispiel

C++ 
int nCount = m_wndReBar.GetReBarCtrl().GetRowCount();
for (int i = 0; i < nCount; i++)
{
   UINT nHeight = m_wndReBar.GetReBarCtrl().GetRowHeight(i);
   CString msg;
   msg.Format(_T("Height of row %d is %u"), i, nHeight);
   AfxMessageBox(msg);
}

CReBarCtrl::GetTextColor

Implementiert das Verhalten der Win32-Nachrichten-RB_GETTEXTCOLOR, wie im Windows SDK beschrieben.

COLORREF GetTextColor() const;

Rückgabewert

Ein COLORREF-Wert, der die aktuelle Standardtextfarbe darstellt.

CReBarCtrl::GetToolTips

Implementiert das Verhalten der Win32-Nachricht RB_GETTOOLTIPS, wie im Windows SDK beschrieben.

CToolTipCtrl* GetToolTips() const;

Rückgabewert

Ein Zeiger auf ein CToolTipCtrl-Objekt .

Hinweise

Beachten Sie, dass die MFC-Implementierung eines GetToolTips Zeigers auf einen CToolTipCtrlZeiger anstelle eines HWND zurückgibt.

CReBarCtrl::HitTest

Implementiert das Verhalten der Win32-Nachricht RB_HITTEST, wie im Windows SDK beschrieben.

int HitTest(RBHITTESTINFO* prbht);

Parameter

prbht
Ein Zeiger auf eine RBHITTESTINFO-Struktur . Vor dem Senden der Nachricht muss das pt Mitglied dieser Struktur an den Punkt initialisiert werden, der in Clientkoordinaten getestet wird.

Rückgabewert

Der nullbasierte Index des Bereichs am angegebenen Punkt oder -1, wenn kein Balkenbalken am Punkt war.

CReBarCtrl::IDToIndex

Implementiert das Verhalten der Win32-Nachricht RB_IDTOINDEX, wie im Windows SDK beschrieben.

int IDToIndex(UINT uBandID) const;

Parameter

uBandID
Der anwendungsdefinierte Bezeichner des angegebenen Bandes, der beim Einfügen des Bandes in das wID Element der REBARBANDINFO-Struktur übergeben wird.

Rückgabewert

Der nullbasierte Bandindex, falls erfolgreich, oder -1 andernfalls. Wenn doppelte Bandindizes vorhanden sind, wird der erste zurückgegeben.

CReBarCtrl::InsertBand

Implementiert das Verhalten der Win32-Nachrichten-RB_INSERTBAND, wie im Windows SDK beschrieben.

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

Parameter

uIndex
Nullbasierter Index der Position, an der das Band eingefügt wird. Wenn Sie diesen Parameter auf -1 festlegen, fügt das Steuerelement das neue Band am letzten Speicherort hinzu.

prbbi
Ein Zeiger auf eine REBARBANDINFO-Struktur , die das einzufügende Band definiert. Sie müssen das cbSize-Element dieser Struktur festlegen, sizeof(REBARBANDINFO) bevor Sie diese Funktion aufrufen.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Beispiel

C++ 
REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);

TCHAR szText[80];
rbbi.lpText = szText;
rbbi.cch = sizeof(szText) / sizeof(szText[0]);

rbbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD |
             RBBIM_CHILDSIZE | RBBIM_COLORS | RBBIM_HEADERSIZE |
             RBBIM_IDEALSIZE | RBBIM_ID | RBBIM_IMAGE |
             RBBIM_LPARAM | RBBIM_SIZE | RBBIM_STYLE | RBBIM_TEXT;

m_wndReBar.GetReBarCtrl().GetBandInfo(0, &rbbi);

m_wndReBar.GetReBarCtrl().InsertBand(1, &rbbi);

CReBarCtrl::MaximizeBand

Ändert die Größe eines Bandes in einem Rebar-Steuerelement auf seine größte Größe.

C++ 
void MaximizeBand(UINT uBand);

Parameter

uBand
Nullbasierter Index des zu maximierenden Bereichs.

Hinweise

Implementiert das Verhalten der Win32-Nachricht RB_MAXIMIZEBAND mit fIdeal 0, wie im Windows SDK beschrieben.

Beispiel

C++ 
CReBarCtrl& refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MaximizeBand(i);

CReBarCtrl::MinimizeBand

Ändert die Größe eines Bandes in einem Rebar-Steuerelement auf seine kleinste Größe.

C++ 
void MinimizeBand(UINT uBand);

Parameter

uBand
Nullbasierter Index des zu minimierenden Bereichs.

Hinweise

Implementiert das Verhalten der Win32-Nachricht RB_MINIMIZEBAND, wie im Windows SDK beschrieben.

Beispiel

C++ 
CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MinimizeBand(i);

CReBarCtrl::MoveBand

Implementiert das Verhalten der Win32-Nachrichten-RB_MOVEBAND, wie im Windows SDK beschrieben.

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

Parameter

uFrom
Nullbasierter Index des zu verschiebenden Bandes.

uTo
Nullbasierter Index der neuen Bandposition. Dieser Parameterwert darf niemals größer sein als die Anzahl der Bänder minus 1. Rufen Sie GetBandCount auf, um die Anzahl der Bänder abzurufen.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

CReBarCtrl::P ushChevron

Implementiert das Verhalten der Win32-Nachricht RB_PUSHCHEVRON, wie im Windows SDK beschrieben.

C++ 
void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

Parameter

uBand
Nullbasierter Index des Bandes, dessen Chevron verschoben werden soll.

lAppValue
Eine Anwendung hat einen 32-Bit-Wert definiert. Siehe "lAppValue " in RB_PUSHCHEVRON im Windows SDK.

CReBarCtrl::RestoreBand

Ändert die Größe eines Bandes in einem Rebar-Steuerelement auf seine ideale Größe.

C++ 
void RestoreBand(UINT uBand);

Parameter

uBand
Nullbasierter Index des zu maximierenden Bereichs.

Hinweise

Implementiert das Verhalten der Win32-Nachricht RB_MAXIMIZEBAND , die fIdeal auf 1 festgelegt ist, wie im Windows SDK beschrieben.

Beispiel

C++ 
CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.RestoreBand(i);

CReBarCtrl::SetBandInfo

Implementiert das Verhalten der Win32-Nachricht RB_SETBANDINFO, wie im Windows SDK beschrieben.

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

Parameter

uBand
Nullbasierter Index des Bandes, um die neuen Einstellungen zu erhalten.

prbbi
Zeiger auf eine REBARBANDINFO-Struktur , die das einzufügende Band definiert. Sie müssen das cbSize Element dieser Struktur festlegen, sizeof(REBARBANDINFO) bevor Sie diese Nachricht senden.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Beispiel

C++ 
int nCount = m_wndReBar.GetReBarCtrl().GetBandCount();
CString strText;
REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);
for (int i = 0; i < nCount; i++)
{
   strText.Format(_T("Band #: %d"), i);
   rbbi.lpText = strText.GetBuffer();
   rbbi.cch = strText.GetLength() + 1;
   rbbi.fMask = RBBIM_TEXT;

   m_wndReBar.GetReBarCtrl().SetBandInfo(i, &rbbi);

   strText.ReleaseBuffer();
}

CReBarCtrl::SetBandWidth

Legt die Breite des angegebenen verankerten Bandes im aktuellen Rebar-Steuerelement fest.

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

Parameter

uBand
[in] Nullbasierter Index eines Balkenbands.

cxWidth
[in] Neue Breite des Leistenbands in Pixel.

Rückgabewert

TRUE, wenn die Methode erfolgreich ist; andernfalls FALSE.

Hinweise

Diese Methode sendet die RB_SETBANDWIDTH Nachricht, die im Windows SDK beschrieben wird.

Beispiel

Im ersten Codebeispiel wird die Variable definiert, m_rebardie für den Zugriff auf das aktuelle Rebar-Steuerelement verwendet wird. Diese Variable wird im nächsten Beispiel verwendet.

C++ 
public:
CReBarCtrl m_rebar;
BOOL bRet;
static const int TOTAL_BANDS = 5;
static const int BUFFER_SIZE = 10;

Im nächsten Codebeispiel wird festgelegt, dass jedes Rebarband dieselbe Breite aufweist.

C++ 
// Set the width of each band.
m_rebar.GetClientRect(&rect);
int iWidth = rect.Width() / TOTAL_BANDS;
for (int iIndex = 0; iIndex < TOTAL_BANDS; iIndex++)
   bRet = m_rebar.SetBandWidth(iIndex, iWidth);

CReBarCtrl::SetBarInfo

Implementiert das Verhalten der Win32-Nachricht RB_SETBARINFO, wie im Windows SDK beschrieben.

BOOL SetBarInfo(REBARINFO* prbi);

Parameter

prbi
Ein Zeiger auf eine REBARINFO-Struktur , die die festzulegenden Informationen enthält. Sie müssen das cbSize Element dieser Struktur sizeof(REBARINFO) vor dem Senden dieser Nachricht auf

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Beispiel

C++ 
REBARINFO rbi = {0};
rbi.cbSize = sizeof(REBARINFO);
rbi.fMask = 0;
rbi.himl = 0;
m_wndReBar.GetReBarCtrl().SetBarInfo(&rbi);

CReBarCtrl::SetBkColor

Implementiert das Verhalten der Win32-Nachricht RB_SETBKCOLOR, wie im Windows SDK beschrieben.

COLORREF SetBkColor(COLORREF clr);

Parameter

clr
Der COLORREF-Wert, der die neue Standardhintergrundfarbe darstellt.

Rückgabewert

Ein COLORREF-Wert , der die vorherige Standardhintergrundfarbe darstellt.

Hinweise

Weitere Informationen zum Festlegen der Hintergrundfarbe und zum Festlegen der Standardeinstellung finden Sie in diesem Thema.

CReBarCtrl::SetColorScheme

Legt das Farbschema für die Schaltflächen eines Rebar-Steuerelements fest.

C++ 
void SetColorScheme(const COLORSCHEME* lpcs);

Parameter

lpcs
Ein Zeiger auf eine COLORSCHEME-Struktur , wie im Windows SDK beschrieben.

Hinweise

Die COLORSCHEME Struktur enthält sowohl die Hervorhebungsfarbe der Schaltfläche als auch die Schattenfarbe der Schaltfläche.

CReBarCtrl::SetExtendedStyle

Legt die erweiterten Formatvorlagen für das aktuelle Rebar-Steuerelement fest.

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

Parameter

dwMask
[in] Eine bitweise Kombination (OR) von Flags, die angeben, welche Flags im dwStyleEx-Parameter angewendet werden. Verwenden Sie einen oder mehrere der folgenden Werte:

  • RBS_EX_SPLITTER: Standardmäßig zeigen Sie den Teiler unten im horizontalen Modus und rechts im vertikalen Modus an.
  • RBS_EX_TRANSPARENT: Leitet die WM_ERASEBKGND Nachricht an das übergeordnete Fenster weiter.

dwStyleEx
[in] Eine bitweise Kombination (OR) von Flags, die die anzuwendenden Formatvorlagen angeben. Um eine Formatvorlage festzulegen, geben Sie dasselbe Flag an, das im dwMask-Parameter verwendet wird. Um eine Formatvorlage zurückzusetzen, geben Sie die binäre Null an.

Rückgabewert

Die vorherige erweiterte Formatvorlage.

Hinweise

Diese Methode sendet die RB_SETEXTENDEDSTYLE Nachricht, die im Windows SDK beschrieben wird.

CReBarCtrl::SetImageList

Weist einem Rebar-Steuerelement eine Bildliste zu.

BOOL SetImageList(CImageList* pImageList);

Parameter

pImageList
Ein Zeiger auf ein CImageList-Objekt , das die Bildliste enthält, die dem Rebar-Steuerelement zugewiesen werden soll.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

CReBarCtrl::SetOwner

Implementiert das Verhalten der Win32-Nachricht RB_SETPARENT, wie im Windows SDK beschrieben.

CWnd* SetOwner(CWnd* pWnd);

Parameter

pWnd
Ein Zeiger auf ein CWnd Objekt, das als Besitzer des Rebar-Steuerelements festgelegt werden soll.

Rückgabewert

Ein Zeiger auf ein CWnd-Objekt , das der aktuelle Besitzer des Rebar-Steuerelements ist.

Hinweise

Beachten Sie, dass diese Memberfunktion Zeiger auf CWnd Objekte sowohl für den aktuellen als auch für den ausgewählten Besitzer des Rebar-Steuerelements anstelle von Handles für Fenster verwendet.

Hinweis

Diese Memberfunktion ändert nicht das tatsächliche übergeordnete Element, das beim Erstellen des Steuerelements festgelegt wurde; stattdessen werden Benachrichtigungen an das von Ihnen angegebene Fenster gesendet.

CReBarCtrl::SetPalette

Implementiert das Verhalten der Win32-Nachricht RB_SETPALETTE, wie im Windows SDK beschrieben.

CPalette* SetPalette(HPALETTE hPal);

Parameter

hPal
Eine HPALETTE, die die neue Palette angibt, die vom Rebar-Steuerelement verwendet wird.

Rückgabewert

Ein Zeiger auf ein CPalette -Objekt, das die vorherige Palette des Rebar-Steuerelements angibt.

Hinweise

Beachten Sie, dass diese Memberfunktion anstelle einer HPALETTE ein CPalette Objekt als Rückgabewert verwendet.

CReBarCtrl::SetTextColor

Implementiert das Verhalten der Win32-Nachricht RB_SETTEXTCOLOR, wie im Windows SDK beschrieben.

COLORREF SetTextColor(COLORREF clr);

Parameter

clr
Ein COLORREF-Wert, der die neue Textfarbe im CReBarCtrl Objekt darstellt.

Rückgabewert

Der COLORREF-Wert , der die vorherige Textfarbe darstellt, die dem CReBarCtrl Objekt zugeordnet ist.

Hinweise

Es wird bereitgestellt, um die Flexibilität der Textfarbe in einem Rebar-Steuerelement zu unterstützen.

CReBarCtrl::SetToolTips

Ordnet ein QuickInfo-Steuerelement einem Rebar-Steuerelement zu.

C++ 
void SetToolTips(CToolTipCtrl* pToolTip);

Parameter

pToolTip
Ein Zeiger auf ein CToolTipCtrl-Objekt

Hinweise

Sie müssen das CToolTipCtrl Objekt zerstören, wenn Sie damit fertig sind.

CReBarCtrl::SetWindowTheme

Legt die visuelle Formatvorlage des Rebar-Steuerelements fest.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameter

pszSubAppName
Ein Zeiger auf eine Unicode-Zeichenfolge, die den festzulegenden visuellen Formatvorlagen für die Leiste enthält.

Rückgabewert

Der Rückgabewert wird nicht verwendet.

Hinweise

Diese Memberfunktion emuliert die Funktionalität der RB_SETWINDOWTHEME Nachricht, wie im Windows SDK beschrieben.

CReBarCtrl::ShowBand

Implementiert das Verhalten der Win32-Nachricht RB_SHOWBAND, wie im Windows SDK beschrieben.

BOOL ShowBand(
    UINT uBand,
    BOOL fShow = TRUE);

Parameter

uBand
Nullbasierter Index eines Bandes im Rebar-Steuerelement.

fShow
Gibt an, ob das Band angezeigt oder ausgeblendet werden soll. Wenn dieser Wert WAHR ist, wird das Band angezeigt. Andernfalls wird das Band ausgeblendet.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

CReBarCtrl::SizeToRect

Implementiert das Verhalten der Win32-Nachricht RB_SIZETORECT, wie im Windows SDK beschrieben.

BOOL SizeToRect(CRect& rect);

Parameter

rect
Ein Verweis auf ein CRect-Objekt , das das Rechteck angibt, auf das das Rebar-Steuerelement angepasst werden soll.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Beachten Sie, dass diese Memberfunktion anstelle einer RECT Struktur ein CRect Objekt als Parameter verwendet.

Siehe auch

CWnd-Klasse
Hierarchiediagramm