CTabCtrl::GetItem
탭 컨트롤에서 탭에 대 한 정보를 검색합니다.
BOOL GetItem(
int nItem,
TCITEM* pTabCtrlItem
) const;
매개 변수
nItem
탭의 인덱스 0부터 시작 합니다.pTabCtrlItem
포인터는 TCITEM 구조를 검색 하는 정보를 지정 하는 데 사용 합니다.탭에 대 한 정보를 사용.이 구조에 사용 되는 InsertItem, GetItem, 및 SetItem 멤버 함수입니다.
반환 값
반환 TRUE 성공 하면. False 이면 그렇지.
설명
메시지를 보낼 때의 마스크 멤버가 반환 될 특성을 지정 합니다.경우는 마스크 멤버를 지정의 TCIF_TEXT 값을는 pszText 구성원 항목 텍스트를 받는 버퍼의 주소를 포함 해야 합니다 및 cchTextMax 멤버 버퍼의 크기를 지정 합니다.
마스크(mask)
값은 지정 TCITEM 구조체 멤버를 검색 하거나 설정 합니다.이 멤버는 0 또는 다음 값의 조합 될 수 있습니다.TCIF_TEXTPszText 멤버 유효 합니다.
TCIF_IMAGEiImage 멤버 유효 합니다.
TCIF_PARAMLParam 멤버 유효 합니다.
TCIF_RTLREADING텍스트의 pszText 히브리어 또는 아랍어 시스템에서 오른쪽에서 왼쪽으로 읽기 순서를 사용 하 여 표시 됩니다.
TCIF_STATEDwState 멤버 유효 합니다.
pszText
구조 탭에 대 한 정보가 포함 된 경우 탭 텍스트를 포함 하는 null로 끝나는 문자열에 대 한 포인터입니다.구조 정보를 보내는 경우이 멤버는 탭 텍스트를 받는 버퍼의 주소를 지정 합니다.cchTextMax
버퍼의 크기 여를 가리키는 pszText.구조 정보를 받지 않는 경우이 멤버가 무시 됩니다.iImage
탭 이미지가 없을 경우 탭 컨트롤 이미지 목록에 1 – 인덱스입니다.lParam
탭과 연결 된 응용 프로그램 정의 데이터입니다.응용 프로그램 정의 데이터 탭 당 4 바이트 이상 있는 경우 응용 프로그램 구조를 정의 하 고 대신 사용 해야는 TCITEM 구조.응용 프로그램 정의 구조의 첫째 멤버 여야 합니다의 TCITEMHEADER구조.TCITEMHEADER 구조는 동일 하는 TCITEM 있지만 구조는 lParam 멤버.크기의 구조와 크기의 차이 TCITEMHEADER 구조 탭 추가 바이트 수가 일치 해야 합니다.
예제
// In this example a CTabCtrl data member, m_TabCtrl, changes the
// text of the tabs in the tab control. A call to GetItem is used
// to get the current text, and then the text is changed. A call
// to SetItem is used to update the tab with the new text.
void CTabDlg::OnChangeItem()
{
TCITEM tcItem;
CString pszString;
// Get text for the tab item.
GetDlgItemText(IDC_ITEM_TEXT, pszString);
// Get the current tab item text.
TCHAR buffer[256] = {0};
tcItem.pszText = buffer;
tcItem.cchTextMax = 256;
tcItem.mask = TCIF_TEXT;
m_TabCtrl.GetItem(0, &tcItem);
TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);
// Set the new text for the item.
tcItem.pszText = pszString.LockBuffer();
// Set the item in the tab control.
m_TabCtrl.SetItem(0, &tcItem);
pszString.UnlockBuffer();
}
요구 사항
헤더: afxcmn.h