CTabCtrl::GetItem

아티클
06/10/2015

탭 컨트롤에서 탭에 대 한 정보를 검색합니다.

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();
}