REBARBANDINFOW-Struktur (commctrl.h)
Enthält Informationen, die ein Band in einem Rebar-Steuerelement definieren.
Syntax
typedef struct tagREBARBANDINFOW {
UINT cbSize;
UINT fMask;
UINT fStyle;
COLORREF clrFore;
COLORREF clrBack;
LPWSTR lpText;
UINT cch;
int iImage;
HWND hwndChild;
UINT cxMinChild;
UINT cyMinChild;
UINT cx;
HBITMAP hbmBack;
UINT wID;
UINT cyChild;
UINT cyMaxChild;
UINT cyIntegral;
UINT cxIdeal;
LPARAM lParam;
UINT cxHeader;
RECT rcChevronLocation;
UINT uChevronState;
} REBARBANDINFOW, *LPREBARBANDINFOW;
Member
cbSize
Typ: UINT
Größe dieser Struktur in Bytes. Ihre Anwendung muss diesen Member ausfüllen, bevor Nachrichten gesendet werden, die die Adresse dieser Struktur als Parameter verwenden.
fMask
Typ: UINT
Flags, die angeben, welche Elemente dieser Struktur gültig sind oder ausgefüllt werden müssen. Dieser Wert kann eine Kombination aus folgenden Werten sein:
| Wert | Bedeutung |
|---|---|
|
Das hbmBack-Element ist gültig oder muss festgelegt werden. |
|
Das hwndChild-Element ist gültig oder muss festgelegt werden. |
|
Die Elemente cxMinChild, cyMinChild, cyChild, cyMaxChild und cyIntegral sind gültig oder müssen festgelegt werden. |
|
Die Member clrFore und clrBack sind gültig oder müssen festgelegt werden. |
|
Version 4.71. Das cxHeader-Element ist gültig oder muss festgelegt werden. |
|
Version 4.71. Das cxIdeal-Element ist gültig oder muss festgelegt werden. |
|
Der wID-Member ist gültig oder muss festgelegt werden. |
|
Das iImage-Element ist gültig oder muss festgelegt werden. |
|
Version 4.71. Das lParam-Element ist gültig oder muss festgelegt werden. |
|
Das cx-Element ist gültig oder muss festgelegt werden. |
|
Das fStyle-Element ist gültig oder muss festgelegt werden. |
|
Das lpText-Element ist gültig oder muss festgelegt werden. |
|
Das rcChevronLocation-Element ist gültig oder muss festgelegt werden. |
|
Der uChevronState-Member ist gültig oder muss festgelegt werden. |
fStyle
Typ: UINT
Flags, die den Bandstil angeben. Dieser Wert kann eine Kombination aus folgenden Werten sein:
| Wert | Bedeutung |
|---|---|
|
Die Band befindet sich in einer neuen Linie. |
|
Das Band hat eine Kante am oberen und unteren Rand des untergeordneten Fensters. |
|
Die Hintergrundbitbitbit wird nicht verschoben, wenn die Größe des Bandes geändert wird. |
|
Die Band kann nicht bemessen werden. Bei diesem Stil wird der Größengriff nicht auf dem Band angezeigt. |
|
Version 4.71. Das Band hat immer einen Größengriff, auch wenn es das einzige Band im Balken ist. |
|
Das Band ist nicht sichtbar. |
|
Version 4.71. Das Band wird nie einen Größengriff haben, auch wenn mehr als ein Band im Balken vorhanden ist. |
|
Version 5.80. Zeigen Sie eine Chevrontaste an, wenn das Band kleiner als cxIdeal ist. |
|
Version 4.71. Die Größe des Bandes kann durch das Rebar-Steuerelement geändert werden. cyIntegral und cyMaxChild wirken sich darauf aus, wie die Rebar die Bandgröße ändert. |
|
Nicht anzeigen, wenn vertikal. |
|
Lassen Sie den Bandtitel ausgeblendet. |
|
Halten Sie band in der oberen Zeile. |
clrFore
Typ: COLORREF
Vordergrundfarben banden.
clrBack
Typ: COLORREF
Hintergrundfarben banden. Wenn hbmBack eine Hintergrund-Bitmap angibt, werden diese Elemente ignoriert. Standardmäßig verwendet das Band die Hintergrundfarbe des Rebar-Steuerelementsatzes mit der RB_SETBKCOLOR Nachricht. Wenn hier eine Hintergrundfarbe angegeben wird, wird stattdessen diese Hintergrundfarbe verwendet.
lpText
Typ: LPTSTR
Zeiger auf einen Puffer, der den Anzeigetext für das Band enthält. Wenn Bandinformationen vom Steuerelement angefordert werden und RBBIM_TEXT in fMask angegeben ist, muss dieses Element an die Adresse des Puffers initialisiert werden, der den Text empfängt.
cch
Typ: UINT
Größe des Puffers bei lpText in Bytes. Wenn keine Informationen vom Steuerelement angefordert werden, wird dieses Element ignoriert.
iImage
Typ: int
Nullbasierter Index jedes Bilds, das im Band angezeigt werden soll. Die Bildliste wird mithilfe der RB_SETBARINFO-Nachricht festgelegt.
hwndChild
Typ: HWND
Handle für das untergeordnete Fenster, das im Band enthalten ist, falls vorhanden.
cxMinChild
Typ: UINT
Mindestbreite des untergeordneten Fensters in Pixel. Das Band darf nicht kleiner als dieser Wert sein.
cyMinChild
Typ: UINT
Mindesthöhe des untergeordneten Fensters in Pixel. Das Band darf nicht kleiner als dieser Wert sein.
cx
Typ: UINT
Länge des Bandes in Pixel.
hbmBack
Typ: HBITMAP
Handle für eine Bitmap, die als Hintergrund für dieses Band verwendet wird.
wID
Typ: UINT
UINT-Wert, der vom Steuerelement verwendet wird, um dieses Band für benutzerdefinierte Zeichnungsbenachrichtigungen zu identifizieren.
cyChild
Typ: UINT
Version 4.71. Anfangshöhe des Bandes in Pixel. Dieser Member wird ignoriert, es sei denn, die RBBS_VARIABLEHEIGHT Formatvorlage wird angegeben.
cyMaxChild
Typ: UINT
Version 4.71. Maximale Höhe des Bandes in Pixel. Dieser Member wird ignoriert, es sei denn, die RBBS_VARIABLEHEIGHT Formatvorlage wird angegeben.
cyIntegral
Typ: UINT
Version 4.71. Schrittwert, um den das Band in Pixel vergrößert oder verkleinern kann. Wenn die Größe des Bandes geändert wird, wird die Größe in den schritten geändert, die durch diesen Wert angegeben werden. Dieser Member wird ignoriert, es sei denn, die RBBS_VARIABLEHEIGHT Formatvorlage wird angegeben.
cxIdeal
Typ: UINT
Version 4.71. Ideale Breite des Bandes in Pixel. Wenn das Band auf die ideale Breite maximiert wird (siehe RB_MAXIMIZEBAND), versucht das Rebar-Steuerelement, das Band in dieser Breite festzulegen.
lParam
Typ: LPARAM
Version 4.71. Anwendungsdefinierter Wert.
cxHeader
Typ: UINT
Version 4.71. Größe des Bandheaders in Pixel. Der Bandheader ist der Bereich zwischen dem Rand des Bandes und dem Rand des untergeordneten Fensters. Dies ist der Bereich, in dem Bandtext und Bilder angezeigt werden, sofern sie angegeben sind. Wenn dieser Wert angegeben wird, überschreibt er die normalen Headerdimensionen, die das Steuerelement für das Band berechnet.
rcChevronLocation
Typ: RECT
Version 6. Position des Chevrons.
uChevronState
Typ: UINT
Version 6. Eine Kombination der Objektzustandskonstanten.
Hinweise
Die Member "cxMinChild", "cyMinChild" und "cx " stellen Informationen zu Dimensionen im Verhältnis zur Ausrichtung des Steuerelements bereit. Das heißt, für eine horizontale Bebalkensteuerung sind cxMinChild und cx horizontale Messungen und cyMinChild ist eine vertikale Messung. Wenn das Steuerelement jedoch den CCS_VERT Stil verwendet, sind cxMinChild und cx vertikale Messungen, und cyMinChild ist eine horizontale Messung.
Hinweis
Der commctrl.h-Header definiert REBARBANDINFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | commctrl.h |
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