NMTBSAVE 구조체(commctrl.h)

TBN_SAVE 알림 코드를 받으면 이 구조체가 애플리케이션에 전달됩니다. 여기에는 현재 저장 중인 단추에 대한 정보가 있습니다. 애플리케이션은 멤버 값을 수정하여 추가 정보를 저장할 수 있습니다.

구문

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

멤버

hdr

형식: NMHDR

알림에 대한 추가 정보를 포함하는 NMHDR 구조체입니다.

pData

형식: DWORD*

저장 정보를 저장하는 데 사용되는 데이터 스트림에 대한 포인터입니다. 완료되면 애플리케이션에서 정의한 블록과 번갈아 가며 각 단추에 대한 셸 정의 정보 블록이 포함됩니다. 또한 애플리케이션은 pData 시작 부분에 전역 데이터 블록을 배치하도록 선택할 수도 있습니다. 애플리케이션 정의 블록의 형식과 길이는 애플리케이션에 의해 결정됩니다. 저장이 시작되면 셸은 cbData에 필요한 메모리 양을 전달하지만 메모리는 할당되지 않습니다. pData가 데이터를 저장할 수 있는 충분한 메모리와 셸을 할당해야 합니다.

pCurrent

형식: DWORD*

데이터 스트림의 사용되지 않는 부분의 시작 부분에 대한 포인터입니다. 여기에 데이터를 로드한 다음 pCurrent 를 사용하지 않은 나머지 부분의 시작 부분으로 진행해야 합니다. 그런 다음 셸은 다음 단추에 대한 정보를 로드하고 pCurrent를 진행합니다.

cbData

형식: UINT

데이터 스트림의 크기입니다. 저장이 시작되면 cbData 는 셸에 필요한 데이터 양으로 설정됩니다. 할당된 총 금액으로 변경해야 합니다.

iItem

형식: int

이 매개 변수는 일반적으로 현재 저장 중인 단추의 인덱스(0부터 시작)입니다. 저장이 시작 중임을 나타내기 위해 -1로 설정됩니다.

cButtons

형식: int

단추 수의 추정값입니다. 데이터 스트림의 크기를 기반으로 하므로 올바르지 않을 수 있습니다. 클라이언트는 적절하게 업데이트해야 합니다.

tbButton

형식: TBBUTTON

현재 저장 중인 단추에 대한 정보를 포함하는 TBBUTTON 구조체입니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	commctrl.h