Structure NMTBRESTORE (commctrl.h)

Permet aux applications d’extraire les informations qui ont été placées dans NMTBSAVE lorsque l’état de la barre d’outils a été enregistré. Cette structure est transmise aux applications lorsqu’elles reçoivent un code de notification TBN_RESTORE .

Syntaxe

typedef struct tagNMTBRESTORE {
  NMHDR    hdr;
  DWORD    *pData;
  DWORD    *pCurrent;
  UINT     cbData;
  int      iItem;
  int      cButtons;
  int      cbBytesPerRecord;
  TBBUTTON tbButton;
} NMTBRESTORE, *LPNMTBRESTORE;

Membres

hdr

Type : NMHDR

Structure NMHDR qui contient des informations supplémentaires sur la notification.

pData

Type : DWORD*

Pointeur vers le flux de données avec les informations d’enregistrement stockées. Il contient des blocs d’informations définis par l’interpréteur de commandes pour chaque bouton, en alternance avec des blocs définis par l’application. Les applications peuvent également placer un bloc de données globales au début de pData. Le format et la longueur des blocs définis par l’application sont déterminés par l’application.

pCurrent

Type : DWORD*

Pointeur vers le bloc actuel de données définies par l’application. Après avoir extrait les données, l’application doit faire avancer pCurrent vers la fin du bloc, de sorte qu’elle pointe vers le bloc suivant de données définies par l’interpréteur de commandes.

cbData

Type : UINT

Taille de pData.

iItem

Type : int

La valeur de -1 indique que la restauration démarre et que pCurrent pointe vers le début du flux de données. Sinon, il s’agit de l’index de bouton de base zéro, et pCurrent pointe vers les données du bouton actuel.

cButtons

Type : int

Estimation du nombre de boutons. Étant donné que l’estimation est basée sur la taille du flux de données, elle peut être incorrecte. Le client doit le mettre à jour le cas échéant.

cbBytesPerRecord

Type : int

Nombre d’octets nécessaires pour contenir les données de chaque bouton. Lorsque la restauration démarre, cbBytesPerRecord est défini sur la taille de la structure de données définie par l’interpréteur de commandes. Vous devez l’incrémenter en fonction de la taille de la structure qui contient les données définies par l’application.

tbButton

Type : TBBUTTON

Structure TBBUTTON qui contient des informations sur le bouton en cours de restauration. Les applications doivent modifier cette structure si nécessaire avant de retourner.

Configuration requise

Condition requise	Valeur
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