TBMETRICS-Struktur (commctrl.h)

Definiert die Metriken einer Symbolleiste, die zum Verkleinern oder Erweitern von Symbolleistenelementen verwendet werden.

Syntax

typedef struct {
  UINT  cbSize;
  DWORD dwMask;
  int   cxPad;
  int   cyPad;
  int   cxBarPad;
  int   cyBarPad;
  int   cxButtonSpacing;
  int   cyButtonSpacing;
} TBMETRICS, *LPTBMETRICS;

Member

cbSize

Typ: UINT

Größe der TBMETRICS-Struktur .

dwMask

Typ: DWORD

Maske, die die abzurufende Metrik bestimmt. Dies kann eine beliebige Kombination aus folgendem sein:

Wert	Bedeutung
TBMF_PAD	Rufen Sie die Werte cxPad und cyPad ab.
TBMF_BARPAD	Rufen Sie die Werte cxBarPad und cyBarPad ab.
TBMF_BUTTONSPACING	Rufen Sie die Werte cxButtonSpacing und cyButtonSpacing ab .

cxPad

Typ: int

Breite des Abstands innerhalb der Symbolleistenschaltflächen zwischen dem Inhalt und dem Rand der Schaltfläche.

cyPad

Typ: int

Höhe der Füllung innerhalb der Symbolleistenschaltflächen zwischen dem Inhalt und dem Rand der Schaltfläche.

cxBarPad

Typ: int

Breite der Symbolleiste. Wird nicht verwendet.

cyBarPad

Typ: int

Höhe der Symbolleiste. Wird nicht verwendet.

cxButtonSpacing

Typ: int

Breite des Abstands zwischen Symbolleistenschaltflächen.

cyButtonSpacing

Typ: int

Höhe des Abstands zwischen Symbolleistenschaltflächen.

Hinweise

Die von der TBMETRICS-Struktur angegebenen Metriken werden verwendet, um die Größe der nicht animierenden Schaltflächen auf einer Symbolleiste zu vergrößern. Die Schaltfläche kann verkleinern oder erweitern, sodass alle sichtbaren Elemente in das Fenster passen.

Die Auffüllungswerte werden verwendet, um einen leeren Bereich zwischen dem Rand der Schaltfläche und dem Bild und/oder Text der Schaltfläche zu erstellen. Wo und wie viel Auffüllung tatsächlich angewendet wird, hängt vom Typ der Schaltfläche und davon ab, ob sie ein Bild enthält. Die horizontale Füllung wird sowohl rechts als auch links auf die Schaltfläche angewendet, und die vertikale Füllung wird sowohl auf den oberen als auch auf den unteren Rand der Schaltfläche angewendet. Die Auffüllung wird nur auf Schaltflächen angewendet, die das TBSTYLE_AUTOSIZE Format aufweisen.

Obwohl Werte für cxBarPad und cyBarPad festgelegt und abgerufen werden können, haben sie derzeit keine Auswirkung und werden nicht verwendet.

Anforderungen

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