Structure NMTBSAVE (commctrl.h)

Cette structure est passée aux applications lorsqu’elles reçoivent un code de notification TBN_SAVE . Il contient des informations sur le bouton en cours d’enregistrement. Les applications peuvent modifier les valeurs des membres pour enregistrer des informations supplémentaires.

Syntaxe

typedef struct tagNMTBSAVE {
  NMHDR    hdr;
  DWORD    *pData;
  DWORD    *pCurrent;
  UINT     cbData;
  int      iItem;
  int      cButtons;
  TBBUTTON tbButton;
} NMTBSAVE, *LPNMTBSAVE;

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 utilisé pour stocker les informations d’enregistrement. Une fois l’opération terminée, elle contient des blocs d’informations définies par l’interpréteur de commandes pour chaque bouton, en alternance avec des blocs définis par l’application. Les applications peuvent également choisir de 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. Lorsque l’enregistrement démarre, l’interpréteur de commandes transmet la quantité de mémoire dont il a besoin dans cbData, mais aucune mémoire n’est allouée. Vous devez allouer suffisamment de mémoire pour que pData contienne vos données, plus celui de l’interpréteur de commandes.

pCurrent

Type : DWORD*

Pointeur vers le début de la partie inutilisée du flux de données. Vous devez charger vos données ici, puis avancer pCurrent jusqu’au début de la partie inutilisée restante. L’interpréteur de commandes charge ensuite les informations du bouton suivant, avance pCurrent, etc.

cbData

Type : UINT

Taille du flux de données. Lorsque l’enregistrement démarre, cbData est défini sur la quantité de données requise par l’interpréteur de commandes. Vous devez le remplacer par le montant total alloué.

iItem

Type : int

Ce paramètre est généralement l’index de base zéro du bouton en cours d’enregistrement. Elle est définie sur -1 pour indiquer qu’un enregistrement démarre.

cButtons

Type : int

Estimation du nombre de boutons. Étant donné qu’il est basé sur la taille du flux de données, il peut être incorrect. Le client doit le mettre à jour comme il convient.

tbButton

Type : TBBUTTON

Structure TBBUTTON qui contient des informations sur le bouton en cours d’enregistrement.

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