CreateToolbarEx 함수(commctrl.h)

도구 모음 창을 만들고 지정된 단추를 도구 모음에 추가합니다.

참고 이 함수는 도구 모음의 모든 기능을 지원하지 않으므로 더 이상 사용되지 않습니다. 대신 CreateWindowEx를 사용합니다. 예제는 Toolbar 컨트롤 사용을 참조하세요.

 

구문

HWND CreateToolbarEx(
  HWND        hwnd,
  DWORD       ws,
  UINT        wID,
  int         nBitmaps,
  HINSTANCE   hBMInst,
  UINT_PTR    wBMID,
  LPCTBBUTTON lpButtons,
  int         iNumButtons,
  int         dxButton,
  int         dyButton,
  int         dxBitmap,
  int         dyBitmap,
  UINT        uStructSize
);

매개 변수

hwnd

형식: HWND

도구 모음의 부모 창에 대한 핸들입니다.

ws

형식: DWORD

도구 모음의 창 스타일입니다. WS_CHILD 스타일은 기본적으로 포함됩니다. 이 매개 변수는 도구 모음 컨트롤 및 단추 스타일에 설명된 대로 스타일의 조합을 포함할 수도 있습니다.

wID

형식: UINT

도구 모음의 컨트롤 식별자입니다.

nBitmaps

형식: int

hBMInst 및 wBMID로 지정된 비트맵에 포함된 단추 이미지 수입니다.

hBMInst

형식: HINSTANCE

모듈은 비트맵 리소스가 포함된 실행 파일로 instance.

wBMID

형식: UINT_PTR

비트맵 리소스에 대한 리소스 식별자입니다. hBMInst가 NULL인 경우 이 매개 변수는 유효한 비트맵 핸들이어야 합니다.

lpButtons

형식: LPCTBBUTTON

도구 모음에 추가할 단추에 대한 정보가 포함된 TBBUTTON 구조체 배열에 대한 포인터입니다.

iNumButtons

형식: int

도구 모음에 추가할 단추 수입니다.

dxButton

형식: int

도구 모음에 추가할 단추의 너비(픽셀)입니다.

dyButton

형식: int

도구 모음에 추가할 단추의 높이(픽셀)입니다.

dxBitmap

형식: int

도구 모음의 단추에 추가할 단추 이미지의 너비(픽셀)입니다.

dyBitmap

형식: int

도구 모음의 단추에 추가할 단추 이미지의 높이(픽셀)입니다.

uStructSize

형식: UINT

TBBUTTON 구조체의 크기입니다.

반환 값

형식: HWND

성공하면 도구 모음에 창 핸들을 반환하고, 그렇지 않으면 NULL 을 반환합니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.

설명

Windows 95: 시스템은 최대 16,364개의 창 핸들을 지원할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	commctrl.h
라이브러리	Comctl32.lib
DLL	Comctl32.dll
API 세트	ext-ms-win-shell-comctl32-window-l1-1-0(Windows 10 버전 10.0.14393에 도입됨)