NMTBSAVE-Struktur (commctrl.h)

Diese Struktur wird an Anwendungen übergeben, wenn sie einen TBN_SAVE Benachrichtigungscode erhalten. Sie enthält Informationen zur Schaltfläche, die derzeit gespeichert wird. Anwendungen können die Werte der Member ändern, um zusätzliche Informationen zu speichern.

Syntax

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

Member

hdr

Typ: NMHDR

Eine NMHDR-Struktur , die zusätzliche Informationen zur Benachrichtigung enthält.

pData

Typ: DWORD*

Ein Zeiger auf den Datenstrom, der zum Speichern der Speicherinformationen verwendet wird. Nach Abschluss des Vorgangs enthält sie Blöcke mit shelldefinierte Informationen für jede Schaltfläche, abwechselnd mit Blöcken, die von der Anwendung definiert werden. Anwendungen können auch einen Block globaler Daten am Anfang von pData platzieren. Das Format und die Länge der anwendungsdefinierte Blöcke werden von der Anwendung bestimmt. Wenn das Speichern beginnt, übergibt die Shell die Menge an Arbeitsspeicher, die sie in cbData benötigt, aber kein Arbeitsspeicher wird zugewiesen. Sie müssen genügend Arbeitsspeicher zuweisen, damit pData Ihre Daten und die der Shell speichern kann.

pCurrent

Typ: DWORD*

Ein Zeiger auf den Anfang des nicht verwendeten Teils des Datenstroms. Sie sollten Ihre Daten hier laden und dann pCurrent bis zum Beginn des verbleibenden nicht verwendeten Teils fortführen. Die Shell lädt dann die Informationen für die nächste Schaltfläche, erweitert pCurrent usw.

cbData

Typ: UINT

Die Größe des Datenstroms. Wenn das Speichern beginnt, wird cbData auf die Von der Shell benötigte Datenmenge festgelegt. Sie sollten es in den zugewiesenen Gesamtbetrag ändern.

iItem

Typ: int

Dieser Parameter ist normalerweise der nullbasierte Index der Schaltfläche, die derzeit gespeichert wird. Sie ist auf -1 festgelegt, um anzugeben, dass eine Speicherung gestartet wird.

cButtons

Typ: int

Eine Schätzung der Anzahl von Schaltflächen. Da er auf der Größe des Datenstroms basiert, ist er möglicherweise falsch. Der Client sollte ihn nach Bedarf aktualisieren.

tbButton

Typ: TBBUTTON

Eine TBBUTTON-Struktur , die Informationen zur schaltfläche enthält, die derzeit gespeichert wird.

Anforderungen

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