다음을 통해 공유

TabCtrl_GetItem 매크로(commctrl.h)

  • 아티클

탭 컨트롤의 탭에 대한 정보를 검색합니다. 이 매크로를 사용하거나 TCM_GETITEM 메시지를 명시적으로 보낼 수 있습니다.

통사론

BOOL TabCtrl_GetItem(
   HWND     hwnd,
   int      iItem,
   LPTCITEM pitem
);

매개 변수

hwnd

형식: HWND

탭 컨트롤에 대한 핸들입니다.

iItem

형식: int

탭의 인덱스입니다.

pitem

형식: LPTCITEM

검색할 정보를 지정하고 탭에 대한 정보를 수신하는 TCITEM 구조체에 대한 포인터입니다. 메시지가 전송되면 마스크 멤버는 반환할 특성을 지정합니다. 마스크 멤버가 TCIF_TEXT 값을 지정하는 경우 pszText 멤버는 항목 텍스트를 받는 버퍼의 주소를 포함해야 하며, cchTextMax 멤버는 버퍼의 크기를 지정해야 합니다.

반환 값

형식: BOOL

성공하면 TRUE 반환하거나, 그렇지 않으면 FALSE .

발언

TCIF_TEXT 플래그가 TCITEM 구조체의 마스크 멤버에 설정된 경우 컨트롤은 요청된 텍스트로 버퍼를 채우는 대신 새 텍스트를 가리키도록 구조체의 pszText 멤버를 변경할 수 있습니다. 컨트롤은 pszText 멤버를 NULL 설정하여 항목과 연결된 텍스트가 없음을 나타낼 수 있습니다.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commctrl.h