CReBarCtrl-Klasse
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::GetTool Tipps | 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::SetTool Tipps | 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.
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
CReBarCtrl
Anforderungen
Header: afxcmn.h
CReBarCtrl::BeginDrag
Implementiert das Verhalten der Win32-Nachricht RB_BEGINDRAG, wie im Windows SDK beschrieben.
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 in der LOWORD enthalten, und die vertikale Koordinate ist im HIWORD enthalten. 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:
Rufen Sie CReBarCtrl auf, um ein
CReBarCtrlObjekt zu erstellen.Rufen Sie diese Memberfunktion auf, die das Windows-Steuerelement für die Erneute Leiste erstellt und an das
CReBarCtrlObjekt anfügt.
Beim Aufrufen Createwerden die allgemeinen Steuerelemente initialisiert.
Beispiel
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
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.
void DragMove(DWORD dwPos = (DWORD)-1);
Parameter
dwPos
Ein DWORD-Wert, der die neuen Mauskoordinaten enthält. Die horizontale Koordinate ist in der LOWORD enthalten, und die vertikale Koordinate ist im HIWORD enthalten. 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.
void EndDrag();
CReBarCtrl::GetBandBorders
Implementiert das Verhalten der Win32-Nachricht RB_GETBANDBORDERS, wie im Windows SDK beschrieben.
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.
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
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
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
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
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::GetTool Tipps
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
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.
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
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.
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
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.
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.
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
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
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.
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.
// 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
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.
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::SetTool Tipps
Ordnet ein QuickInfo-Steuerelement einem Rebar-Steuerelement zu.
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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für