REBARBANDINFOA-Struktur (commctrl.h)
Enthält Informationen, die einen Band in einem Rebar-Steuerelement definieren.
Syntax
typedef struct tagREBARBANDINFOA {
UINT cbSize;
UINT fMask;
UINT fStyle;
COLORREF clrFore;
COLORREF clrBack;
LPSTR 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;
} REBARBANDINFOA, *LPREBARBANDINFOA;
Angehörige
cbSize
Typ: UINT-
Größe dieser Struktur in Byte. Ihre Anwendung muss dieses Element 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 folgendem Sein:
| Wert | Bedeutung |
|---|---|
|
Das hbmBack Member ist gültig oder muss festgelegt werden. |
|
Das hwndChild Member ist gültig oder muss festgelegt werden. |
|
Die cxMinChild, cyMinChild, cyChild, cyMaxChildund cyIntegral Member sind gültig oder müssen festgelegt werden. |
|
Die clrFore und clrBack- Member sind gültig oder müssen festgelegt werden. |
|
Version 4.71. Das cxHeader- Member ist gültig oder muss festgelegt werden. |
|
Version 4.71. Das cxIdeal Member ist gültig oder muss festgelegt werden. |
|
Das wID Member ist gültig oder muss festgelegt werden. |
|
Das iImage Member ist gültig oder muss festgelegt werden. |
|
Version 4.71. Das lParam Member ist gültig oder muss festgelegt werden. |
|
Das cx Member ist gültig oder muss festgelegt werden. |
|
Der fStyle- Member ist gültig oder muss festgelegt werden. |
|
Das lpText Member ist gültig oder muss festgelegt werden. |
|
Das rcChevronLocation Member ist gültig oder muss festgelegt werden. |
|
Das uChevronState Member ist gültig oder muss festgelegt werden. |
fStyle
Typ: UINT-
Flags, die die Bandformatvorlage angeben. Dieser Wert kann eine Kombination aus folgendem Sein:
| Wert | Bedeutung |
|---|---|
|
Das Band befindet sich in einer neuen Zeile. |
|
Das Band hat einen Rand am oberen und unteren Rand des untergeordneten Fensters. |
|
Die Hintergrundbitmap wird nicht verschoben, wenn die Größe des Bandes geändert wird. |
|
Das Band kann nicht angepasst werden. Mit diesem Stil wird der Ziehgriff nicht auf dem Band angezeigt. |
|
Version 4.71. Das Band wird immer einen Ziehgriff haben, auch wenn es sich um das einzige Band im Balken handelt. |
|
Das Band ist nicht sichtbar. |
|
Version 4.71. Das Band wird nie einen Ziehgriff haben, auch wenn mehr als ein Band in der Leiste vorhanden ist. |
|
Version 5.80. Zeigen Sie eine Chevronschaltfläche an, wenn das Band kleiner als cxIdeal-ist. |
|
Version 4.71. Das Band kann durch das Rebar-Steuerelement geändert werden. cyIntegral und cyMaxChild beeinflussen, wie die Größe des Balkens geändert wird. |
|
Wird nicht angezeigt, wenn vertikal. |
|
Den Bandtitel ausgeblendet lassen. |
|
Band in oberster Zeile beibehalten. |
clrFore
Typ: COLORREF-
Vordergrundfarben banden.
clrBack
Typ: COLORREF-
Hintergrundfarben für banden. Wenn hbmBack- eine Hintergrundbitmap angibt, werden diese Elemente ignoriert. Standardmäßig verwendet das Band die Hintergrundfarbe des Rebar-Steuerelements, das mit der RB_SETBKCOLOR Nachricht festgelegt ist. Wenn hier eine Hintergrundfarbe angegeben wird, wird stattdessen diese Hintergrundfarbe verwendet.
lpText
Typ: LPTSTR-
Zeigen Sie auf einen Puffer, der den Anzeigetext für das Band enthält. Wenn Bandinformationen vom Steuerelement angefordert werden und RBBIM_TEXT in fMask-angegeben wird, 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 Byte. Wenn keine Informationen vom Steuerelement angefordert werden, wird dieses Element ignoriert.
iImage
Typ: int
Nullbasierter Index aller Bilder, die im Band angezeigt werden sollen. Die Bildliste wird mithilfe der RB_SETBARINFO Nachricht festgelegt.
hwndChild
Typ: HWND-
Handle zum untergeordneten Fenster, das im Band enthalten ist, falls vorhanden.
cxMinChild
Typ: UINT-
Mindestbreite des untergeordneten Fensters in Pixel. Der Bereich kann nicht kleiner als dieser Wert sein.
cyMinChild
Typ: UINT-
Mindesthöhe des untergeordneten Fensters in Pixel. Der Bereich kann nicht kleiner als dieser Wert sein.
cx
Typ: UINT-
Länge des Bandes in Pixel.
hbmBack
Typ: HBITMAP-
Behandeln Sie eine Bitmap, die als Hintergrund für dieses Band verwendet wird.
wID
Typ: UINT-
UINT-Wert, den das Steuerelement verwendet, um dieses Band für benutzerdefinierte Draw-Benachrichtigungen zu identifizieren.
cyChild
Typ: UINT-
Version 4.71. Anfangshöhe des Bandes in Pixeln. Dieses Element wird ignoriert, es sei denn, die RBBS_VARIABLEHEIGHT Formatvorlage ist angegeben.
cyMaxChild
Typ: UINT-
Version 4.71. Maximale Höhe des Bandes in Pixel. Dieses Element wird ignoriert, es sei denn, die RBBS_VARIABLEHEIGHT Formatvorlage ist angegeben.
cyIntegral
Typ: UINT-
Version 4.71. Schrittwert, um den das Band in Pixel vergrößern oder verkleinern kann. Wenn die Größe des Bandes geändert wird, wird die Größe in schritten geändert, die durch diesen Wert angegeben werden. Dieses Element wird ignoriert, es sei denn, die RBBS_VARIABLEHEIGHT Formatvorlage ist angegeben.
cxIdeal
Typ: UINT-
Version 4.71. Ideale Breite des Bandes in Pixeln. Wenn das Band auf die ideale Breite maximiert ist (siehe RB_MAXIMIZEBAND), versucht das Rebar-Steuerelement, das Band für diese Breite festzulegen.
lParam
Typ: LPARAM-
Version 4.71. Anwendungsdefinierter Wert.
cxHeader
Typ: UINT-
Version 4.71. Größe der Kopfzeile des Bandes in Pixel. Die Bandkopfzeile 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, wenn sie angegeben werden. Wenn dieser Wert angegeben ist, überschreibt es die normalen Kopfzeilenabmessungen, die das Steuerelement für das Band berechnet.
rcChevronLocation
Typ: RECT-
Version 6. Position des Chevrons.
uChevronState
Typ: UINT-
Version 6. Eine Kombination der Object State-Konstanten.
Bemerkungen
Die cxMinChild, cyMinChildund cx Member liefern Informationen zu Dimensionen relativ zur Ausrichtung des Steuerelements. Für ein horizontales Rebar-Steuerelement sind cxMinChild und cx horizontale Maße und cyMinChild eine vertikale Messung. Wenn das Steuerelement jedoch die CCS_VERT Formatvorlage verwendet, sind cxMinChild und cx vertikale Maße und cyMinChild eine horizontale Maßeinheit.
Anmerkung
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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Header- | commctrl.h |