CTabCtrl::InsertItem
새 탭은 기존 탭 컨트롤에 삽입합니다.
LONG InsertItem(
int nItem,
TCITEM* pTabCtrlItem
);
LONG InsertItem(
int nItem,
LPCTSTR lpszItem
);
LONG InsertItem(
int nItem,
LPCTSTR lpszItem,
int nImage
);
LONG InsertItem(
UINT nMask,
int nItem,
LPCTSTR lpszItem,
int nImage,
LPARAM lParam
);
LONG InsertItem(
UINT nMask,
int nItem,
LPCTSTR lpszItem,
int nImage,
LPARAM lParam,
DWORD dwState,
DWORD dwStateMask
);
매개 변수
nItem
새 탭의 인덱스 0부터 시작 합니다.pTabCtrlItem
포인터는 TCITEM 탭의 특성을 지정 하는 구조입니다.lpszItem
주소 탭의 텍스트를 포함 하는 null로 끝나는 문자열입니다.nImage
삽입 된 이미지 목록에서 이미지의 인덱스입니다.nMask
지정 TCITEM 구조 특성을 설정 합니다. 0 또는 다음 값 조합이 될 수 있습니다.TCIF_TEXTPszText 멤버 유효 합니다.
TCIF_IMAGEiImage 멤버 유효 합니다.
TCIF_PARAMLParam 멤버 유효 합니다.
TCIF_RTLREADING텍스트의 pszText 히브리어 또는 아랍어 시스템에서 오른쪽에서 왼쪽으로 읽기 순서를 사용 하 여 표시 됩니다.
TCIF_STATEDwState 멤버 유효 합니다.
lParam
탭과 연결 된 응용 프로그램 정의 데이터입니다.dwState
항목의 상태에 대 한 값을 지정합니다. 자세한 내용은 TCITEM 에 있는 Windows SDK.dwStateMask
상태를 설정할 수를 지정 합니다. 자세한 내용은 TCITEM 에 있는 Windows SDK.
반환 값
성공 하면 새 탭의 인덱스입니다. 그렇지 않으면-1입니다.
예제
TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");
m_TabCtrl.InsertItem(0, &tcItem);
요구 사항
헤더: afxcmn.h