NMTBRESTORE 구조체(commctrl.h)

도구 모음 상태가 저장되었을 때 애플리케이션이 NMTBSAVE에 배치된 정보를 추출할 수 있습니다. TBN_RESTORE 알림 코드를 받으면 이 구조체가 애플리케이션에 전달됩니다.

구문

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

멤버

hdr

형식: NMHDR

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

pData

형식: DWORD*

저장된 저장 정보를 사용하여 데이터 스트림에 대한 포인터입니다. 여기에는 애플리케이션 정의 블록과 번갈아 가며 각 단추에 대한 셸 정의 정보 블록이 포함되어 있습니다. 애플리케이션은 pData의 시작 부분에 전역 데이터 블록을 배치할 수도 있습니다. 애플리케이션 정의 블록의 형식과 길이는 애플리케이션에 의해 결정됩니다.

pCurrent

형식: DWORD*

애플리케이션 정의 데이터의 현재 블록에 대한 포인터입니다. 데이터를 추출한 후 애플리케이션은 pCurrent 를 블록 끝까지 진행해야 하므로 셸 정의 데이터의 다음 블록을 가리킵니다.

cbData

형식: UINT

pData의 크기입니다.

iItem

형식: int

값이 -1이면 복원이 시작되고 pCurrent 가 데이터 스트림의 시작을 가리킵니다. 그렇지 않으면 0부터 시작하는 단추 인덱스이고 pCurrent 는 현재 단추의 데이터를 가리킵니다.

cButtons

형식: int

단추 수를 예측합니다. 예측값은 데이터 스트림의 크기를 기반으로 하므로 틀렸을 수 있습니다. 클라이언트는 적절하게 업데이트해야 합니다.

cbBytesPerRecord

형식: int

각 단추에 대한 데이터를 보유하는 데 필요한 바이트 수입니다. 복원이 시작되면 cbBytesPerRecord 가 셸 정의 데이터 구조의 크기로 설정됩니다. 애플리케이션 정의 데이터를 보유하는 구조체의 크기로 증분해야 합니다.

tbButton

형식: TBBUTTON

현재 복원 중인 단추에 대한 정보가 포함된 TBBUTTON 구조체입니다. 애플리케이션은 반환하기 전에 필요에 따라 이 구조를 수정해야 합니다.

요구 사항

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