BUTTON_SPLITINFO-Struktur (commctrl.h)

Artikel
08/22/2023

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

Freigeben über