BUTTON_SPLITINFO-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zum Definieren einer geteilten Schaltfläche (BS_SPLITBUTTON - und BS_DEFSPLITBUTTON-Formatvorlagen ). Wird mit den BCM_GETSPLITINFO - und BCM_SETSPLITINFO-Nachrichten verwendet.

Syntax

typedef struct tagBUTTON_SPLITINFO {
  UINT       mask;
  HIMAGELIST himlGlyph;
  UINT       uSplitStyle;
  SIZE       size;
} BUTTON_SPLITINFO, *PBUTTON_SPLITINFO;

Member

mask

Typ: UINT

Eine Reihe von Flags, die angeben, welche Member dieser Struktur festzulegende Daten enthalten oder welche Elemente angefordert werden. Legen Sie dieses Element auf mindestens eines der folgenden Flags fest.

Wert Bedeutung
BCSIF_GLYPH
 himlGlyphe ist gültig.
BCSIF_IMAGE
 himlGlyphe ist gültig. Verwenden Sie, wenn uSplitStyle auf BCSS_IMAGE festgelegt ist.
BCSIF_SIZE
 Die Größe ist gültig.
BCSIF_STYLE
 uSplitStyle ist gültig.

himlGlyph

Typ: HIMAGELIST

Ein Handle für die Bildliste. Der Anbieter behält das Eigentum an der Imageliste und ist letztendlich für deren Entsorgung verantwortlich.

uSplitStyle

Typ: UINT

Das Format der geteilten Schaltfläche. Der Wert muss mindestens eins der folgenden Flags sein.

Wert Bedeutung
BCSS_ALIGNLEFT
 Richten Sie das Bild oder die Glyphe horizontal am linken Rand aus.
BCSS_IMAGE
 Zeichnen Sie ein Symbolbild als Glyphe.
BCSS_NOSPLIT
 Keine Aufteilung.
BCSS_STRETCH
 Strecken Sie die Glyphe, aber versuchen Sie, das Seitenverhältnis beizubehalten.

size

Typ: SIZE

Eine SIZE-Struktur , die die Größe der Glyphe in himlGlyphe angibt.

Hinweise

Die Glyphe ist das Bild, das auf dem Teil der Schaltfläche angezeigt wird, die die Dropdownliste aktiviert. Standardmäßig handelt es sich hierbei um ein invertiertes Dreieck. Mehrere Bilder können zur Bildliste hinzugefügt werden, um verschiedene Glyphen für verschiedene Zustände der Schaltfläche bereitzustellen, z. B. heiß und gedrückt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile commctrl.h

Weitere Informationen

Schaltflächenübersicht