Freigeben über

REBARBANDINFOA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen, die ein 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;

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
RBBIM_BACKGROUND
 Das hbmBack-Element ist gültig oder muss festgelegt werden.
RBBIM_CHILD
 Das hwndChild-Element ist gültig oder muss festgelegt werden.
RBBIM_CHILDSIZE
 Die Elemente cxMinChild, cyMinChild, cyChild, cyMaxChild und cyIntegral sind gültig oder müssen festgelegt werden.
RBBIM_COLORS
 Die Member clrFore und clrBack sind gültig oder müssen festgelegt werden.
RBBIM_HEADERSIZE

Version 4.71. Das cxHeader-Element ist gültig oder muss festgelegt werden.
RBBIM_IDEALSIZE

Version 4.71. Das cxIdeal-Element ist gültig oder muss festgelegt werden.
RBBIM_ID
 Der wID-Member ist gültig oder muss festgelegt werden.
RBBIM_IMAGE
 Das iImage-Element ist gültig oder muss festgelegt werden.
RBBIM_LPARAM

Version 4.71. Das lParam-Element ist gültig oder muss festgelegt werden.
RBBIM_SIZE
 Das cx-Element ist gültig oder muss festgelegt werden.
RBBIM_STYLE
 Das fStyle-Element ist gültig oder muss festgelegt werden.
RBBIM_TEXT
 Das lpText-Element ist gültig oder muss festgelegt werden.
RBBIM_CHEVRONLOCATION
 Das rcChevronLocation-Element ist gültig oder muss festgelegt werden.
RBBIM_CHEVRONSTATE
 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
RBBS_BREAK
 Die Band befindet sich in einer neuen Linie.
RBBS_CHILDEDGE
 Das Band hat eine Kante am oberen und unteren Rand des untergeordneten Fensters.
RBBS_FIXEDBMP
 Die Hintergrundbitbitbit wird nicht verschoben, wenn die Größe des Bandes geändert wird.
RBBS_FIXEDSIZE
 Die Band kann nicht bemessen werden. Bei diesem Stil wird der Größengriff nicht auf dem Band angezeigt.
RBBS_GRIPPERALWAYS

Version 4.71. Das Band hat immer einen Größengriff, auch wenn es das einzige Band im Balken ist.
RBBS_HIDDEN
 Das Band ist nicht sichtbar.
RBBS_NOGRIPPER

Version 4.71. Das Band wird nie einen Größengriff haben, auch wenn mehr als ein Band im Balken vorhanden ist.
RBBS_USECHEVRON

Version 5.80. Zeigen Sie eine Chevrontaste an, wenn das Band kleiner als cxIdeal ist.
RBBS_VARIABLEHEIGHT

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.
RBBS_NOVERT
 Nicht anzeigen, wenn vertikal.
RBBS_HIDETITLE
 Lassen Sie den Bandtitel ausgeblendet.
RBBS_TOPALIGN
 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 mit einer 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 Zeichenbenachrichtigungen 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ößern 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 diese Breite zu legen.

lParam

Typ: LPARAM

Version 4.71. Anwendungsdefinierter Wert.

cxHeader

Typ: UINT

Version 4.71. Größe des Headers des Bandes 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, werden die normalen Headerdimensionen überschrieben, 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 Rebar-Steuerung 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile commctrl.h