Structure TBMETRICS (commctrl.h)

Définit les métriques d’une barre d’outils utilisées pour réduire ou développer des éléments de barre d’outils.

Syntaxe

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

Membres

cbSize

Type : UINT

Taille de la structure TBMETRICS .

dwMask

Type : DWORD

Masque qui détermine la métrique à récupérer. Il peut s’agir de n’importe quelle combinaison des éléments suivants :

Valeur Signification
TBMF_PAD Récupérez les valeurs cxPad et cyPad .
TBMF_BARPAD Récupérez les valeurs cxBarPad et cyBarPad .
TBMF_BUTTONSPACING Récupérez les valeurs cxButtonSpacing et cyButtonSpacing .

cxPad

Type : int

Largeur du remplissage à l’intérieur des boutons de la barre d’outils, entre le contenu et le bord du bouton.

cyPad

Type : int

Hauteur du remplissage à l’intérieur des boutons de la barre d’outils, entre le contenu et le bord du bouton.

cxBarPad

Type : int

Largeur de la barre d’outils. Non utilisé.

cyBarPad

Type : int

Hauteur de la barre d’outils. Non utilisé.

cxButtonSpacing

Type : int

Largeur de l’espace entre les boutons de la barre d’outils.

cyButtonSpacing

Type : int

Hauteur de l’espace entre les boutons de la barre d’outils.

Remarques

Les métriques spécifiées par la structure TBMETRICS sont utilisées pour dimensionner les boutons non animés d’une barre d’outils. Le bouton peut réduire ou se développer afin que tous les éléments visibles tiennent dans la fenêtre.

Les valeurs de remplissage sont utilisées pour créer une zone vide entre le bord du bouton et l’image et/ou le texte du bouton. L’emplacement et la quantité de remplissage réellement appliqués dépendent du type du bouton et de sa valeur d’image. Le remplissage horizontal est appliqué à la fois à droite et à gauche du bouton, et le remplissage vertical est appliqué en haut et en bas du bouton. Le remplissage est appliqué uniquement aux boutons qui ont le style TBSTYLE_AUTOSIZE .

Bien que les valeurs cxBarPad et cyBarPad puissent être définies et récupérées, elles n’ont actuellement aucun effet et ne sont pas utilisées.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête commctrl.h