TBBUTTONINFOW 구조체(commctrl.h)

도구 모음의 특정 단추에 대한 정보를 포함하거나 받습니다.

구문

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPWSTR    pszText;
  int       cchText;
} TBBUTTONINFOW, *LPTBBUTTONINFOW;

멤버

cbSize

형식: UINT

구조체의 크기(바이트)입니다. 연결된 메시지를 보내기 전에 이 멤버를 입력해야 합니다.

dwMask

형식: DWORD

유효한 정보를 포함하는 멤버를 나타내는 플래그 집합입니다. 연결된 메시지를 보내기 전에 이 멤버를 입력해야 합니다. 다음 값 중 하나 이상일 수 있습니다.

값	의미
TBIF_BYINDEX	버전 5.80. TB_GETBUTTONINFO 또는 TB_SETBUTTONINFO 메시지와 함께 전송된 wParam은 식별자가 아닌 인덱스입니다.
TBIF_COMMAND	idCommand 멤버에 유효한 정보가 포함되어 있거나 요청 중입니다.
TBIF_IMAGE	iImage 멤버에 유효한 정보가 포함되어 있거나 요청 중입니다.
TBIF_LPARAM	lParam 멤버에 유효한 정보가 포함되어 있거나 요청 중입니다.
TBIF_SIZE	cx 멤버에 유효한 정보가 포함되거나 요청되고 있습니다.
TBIF_STATE	fsState 멤버는 유효한 정보를 포함하거나 요청 중입니다.
TBIF_STYLE	fsStyle 멤버에 유효한 정보가 포함되어 있거나 요청 중입니다.
TBIF_TEXT	pszText 멤버는 유효한 정보를 포함하거나 요청 중입니다.

idCommand

형식: int

단추의 명령 식별자입니다.

iImage

형식: int

단추의 이미지 인덱스입니다. 이 멤버를 I_IMAGECALLBACK 설정하면 도구 모음에서 필요할 때 이미지 인덱스 검색을 위해 TBN_GETDISPINFO 알림 코드를 보냅니다.

버전 5.81. 단추에 이미지가 없음을 나타내려면 이 멤버를 I_IMAGENONE 설정합니다. 단추 레이아웃에는 비트맵을 위한 공간이 포함되지 않고 텍스트만 포함됩니다.

fsState

형식: BYTE

단추의 상태 플래그입니다. 도구 모음 단추 상태에 나열된 값 중 하나 이상일 수 있습니다.

fsStyle

형식: BYTE

단추의 스타일 플래그입니다. 도구 모음 컨트롤 및 단추 스타일에 나열된 값 중 하나 이상일 수 있습니다.

cx

형식: WORD

단추의 너비(픽셀)입니다.

lParam

형식: DWORD_PTR

단추와 연결된 애플리케이션 정의 값입니다.

pszText

형식: LPTSTR

단추 텍스트를 포함하거나 받는 문자 버퍼의 주소입니다.

cchText

형식: int

pszText의 버퍼 크기입니다. 단추 정보가 설정되면 이 멤버는 무시됩니다.

설명

참고

commctrl.h 헤더는 TBBUTTONINFO를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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