CTabCtrl Klasa

Udostępnia funkcje kontrolki typowej karty systemu Windows.

Składnia

class CTabCtrl : public CWnd

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
CTabCtrl::CTabCtrl	CTabCtrl Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CTabCtrl::AdjustRect	Oblicza obszar wyświetlania kontrolki tabulatora na podstawie prostokąta okna lub oblicza prostokąt okna, który odpowiada danym obszarowi wyświetlania.
CTabCtrl::Create	Tworzy kontrolkę tabulatora i dołącza ją do wystąpienia TabCtrl obiektu
CTabCtrl::CreateEx	Tworzy kontrolkę tabulatora z określonymi stylami rozszerzonymi systemu Windows i dołącza ją do wystąpienia CTabCtrl obiektu.
CTabCtrl::DeleteAllItems	Usuwa wszystkie elementy z kontrolki karty.
CTabCtrl::DeleteItem	Usuwa element z kontrolki karty.
CTabCtrl::DeselectAll	Resetuje elementy w kontrolce karty, czyszcząc wszystkie naciśnięcie.
CTabCtrl::DrawItem	Rysuje określony element kontrolki karty.
CTabCtrl::GetCurFocus	Pobiera kartę z bieżącym fokusem kontrolki karty.
CTabCtrl::GetCurSel	Określa aktualnie wybraną kartę w kontrolce karty.
CTabCtrl::GetExtendedStyle	Pobiera style rozszerzone, które są obecnie używane dla kontrolki karty.
CTabCtrl::GetImageList	Pobiera listę obrazów skojarzona z kontrolką karty.
CTabCtrl::GetItem	Pobiera informacje o karcie w kontrolce karty.
CTabCtrl::GetItemCount	Pobiera liczbę kart w kontrolce karty.
CTabCtrl::GetItemRect	Pobiera prostokąt ograniczenia dla karty w kontrolce karty.
CTabCtrl::GetItemState	Pobiera stan wskazanego elementu kontrolki karty.
CTabCtrl::GetRowCount	Pobiera bieżącą liczbę wierszy kart w kontrolce karty.
CTabCtrl::GetToolTips	Pobiera uchwyt kontrolki porad narzędzia skojarzonej z kontrolką tabulacji.
CTabCtrl::HighlightItem	Ustawia stan wyróżnienia elementu karty.
CTabCtrl::HitTest	Określa, która karta, jeśli istnieje, znajduje się na określonej pozycji ekranu.
CTabCtrl::InsertItem	Wstawia nową kartę w kontrolce karty.
CTabCtrl::RemoveImage	Usuwa obraz z listy obrazów kontrolki karty.
CTabCtrl::SetCurFocus	Ustawia fokus na określoną kartę w kontrolce karty.
CTabCtrl::SetCurSel	Wybiera kartę w kontrolce karty.
CTabCtrl::SetExtendedStyle	Ustawia rozszerzone style dla kontrolki karty.
CTabCtrl::SetImageList	Przypisuje listę obrazów do kontrolki karty.
CTabCtrl::SetItem	Ustawia niektóre lub wszystkie atrybuty karty.
CTabCtrl::SetItemExtra	Ustawia liczbę bajtów na kartę zarezerwowaną dla danych zdefiniowanych przez aplikację w kontrolce karty.
CTabCtrl::SetItemSize	Ustawia szerokość i wysokość elementu.
CTabCtrl::SetItemState	Ustawia stan wskazanego elementu kontrolki karty.
CTabCtrl::SetMinTabWidth	Ustawia minimalną szerokość elementów w kontrolce karty.
CTabCtrl::SetPadding	Ustawia ilość miejsca (dopełnienie) wokół każdej ikony tabulatorów i etykiety w kontrolce karty.
CTabCtrl::SetToolTips	Przypisuje kontrolkę porad narzędzia do kontrolki karty.

Uwagi

Kontrolka "tabulacji" jest analogiczna do rozdzielaczy w notesie lub etykietach w szafce plików. Za pomocą kontrolki tabulatora aplikacja może definiować wiele stron dla tego samego obszaru okna lub okna dialogowego. Każda strona składa się z zestawu informacji lub grupy kontrolek wyświetlanych przez aplikację, gdy użytkownik wybierze odpowiednią kartę. Specjalny typ kontrolki tabulacji wyświetla karty, które wyglądają jak przyciski. Kliknięcie przycisku powinno natychmiast wykonać polecenie zamiast wyświetlać stronę.

Ta kontrolka CTabCtrl (i dlatego klasa) jest dostępna tylko dla programów działających w systemach Windows 95/98 i Windows NT w wersji 3.51 lub nowszej.

Aby uzyskać więcej informacji na temat CTabCtrlprogramu , zobacz Controls and Using CTabCtrl.

Hierarchia dziedziczenia

CObject
CCmdTarget
CWnd

CTabCtrl

Wymagania

Nagłówka:afxcmn.h

CTabCtrl::AdjustRect

Oblicza obszar wyświetlania kontrolki tabulatora na podstawie prostokąta okna lub oblicza prostokąt okna, który odpowiada danym obszarowi wyświetlania.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Parametry

bLarger
Wskazuje, która operacja ma być wykonywana. Jeśli ten parametr to TRUE, lpRect określa prostokąt wyświetlania i odbiera odpowiedni prostokąt okna. Jeśli ten parametr to FALSE, lpRect określa prostokąt okna i odbiera odpowiedni prostokąt wyświetlania.

lpRect
Wskaźnik do RECT struktury, która określa dany prostokąt i otrzymuje prostokąt obliczeniowy.

Przykład

void CTabDlg::OnSize(UINT nType, int cx, int cy)
{
   CDialog::OnSize(nType, cx, cy);

   if (m_TabCtrl.m_hWnd == NULL)
      return; // Return if window is not created yet.

   RECT rect;

   // Get size of dialog window.
   GetClientRect(&rect);

   // Adjust the rectangle to fit the tab control into the
   // dialog's client rectangle.
   m_TabCtrl.AdjustRect(FALSE, &rect);

   // Move the tab control to the new position and size.
   m_TabCtrl.MoveWindow(&rect, TRUE);
}

CTabCtrl::Create

Tworzy kontrolkę tabulacji i dołącza ją do wystąpienia CTabCtrl obiektu.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametry

dwStyle
Określa styl kontrolki karty. Zastosuj dowolną kombinację stylów kontrolek tabulacji opisanych w zestawie Windows SDK. Zobacz Uwagi dotyczące listy stylów okien, które można również zastosować do kontrolki.

rect
Określa rozmiar i położenie kontrolki karty. Może to być CRect obiekt lub RECT struktura.

pParentWnd
Określa okno nadrzędne kontrolki karty, zwykle CDialog. Nie może to być NULL.

nID
Określa identyfikator kontrolki tabulatora.

Wartość zwracana

TRUE jeśli inicjowanie obiektu zakończyło się pomyślnie; w przeciwnym razie FALSE.

Uwagi

Obiekt jest konstruowany CTabCtrl w dwóch krokach. Najpierw wywołaj konstruktor, a następnie wywołaj Createmetodę , która tworzy kontrolkę tabulacji i dołącza ją do CTabCtrl obiektu.

Oprócz stylów kontrolek tabulacji można zastosować następujące style okna do kontrolki karty:

• WS_CHILD: tworzy okno podrzędne reprezentujące kontrolkę karty. Nie można używać z stylem WS_POPUP.
• WS_VISIBLE: Tworzy kontrolkę karty, która początkowo jest widoczna.
• WS_DISABLED: Tworzy okno, które jest początkowo wyłączone.
• WS_GROUP: Określa pierwszą kontrolkę grupy kontrolek, w której użytkownik może przejść z jednej kontrolki do następnej za pomocą klawiszy strzałek. Wszystkie kontrolki zdefiniowane za pomocą WS_GROUPstylu : po pierwszej kontrolce należą do tej samej grupy. Następna kontrolka z stylem WS_GROUP: kończy grupę stylów i uruchamia następną grupę (czyli jedną grupę kończy się, gdzie rozpoczyna się następny).
• WS_TABSTOP: określa jedną z dowolnej liczby kontrolek, za pomocą których użytkownik może przenosić za pomocą klawisza TAB. Klawisz TAB przenosi użytkownika do następnej WS_TABSTOPkontrolki określonej przez styl :.

Aby utworzyć kontrolkę karty z rozszerzonymi stylami okien, wywołaj metodę CTabCtrl::CreateEx zamiast Create.

Przykład

// Assuming you have a member variable m_TabCtrl, that is a CTabCtrl
// object, you can use the following to create a tab control.

m_TabCtrl.Create(TCS_TABS | TCS_FIXEDWIDTH | WS_CHILD | WS_VISIBLE,
                 rect, this, IDC_MYTAB);

// This creates a tab control with the given styles, and with
// an ID of IDC_MYTAB.

CTabCtrl::CreateEx

Tworzy kontrolkę (okno podrzędne) i kojarzy ją z obiektem CTabCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametry

dwExStyle
Określa rozszerzony styl tworzonej kontrolki. Aby uzyskać listę rozszerzonych stylów systemu Windows, zobacz dwExStyle parametr dla CreateWindowEx w zestawie Windows SDK.

dwStyle
Określa styl kontrolki karty. Zastosuj dowolną kombinację stylów kontrolek tabulacji opisanych w zestawie Windows SDK. Zobacz uwagi w Create sekcji , aby uzyskać listę stylów okien, które można również zastosować do kontrolki.

rect
Odwołanie do RECT struktury opisującej rozmiar i położenie okna do utworzenia w współrzędnych pParentWndklienta .

pParentWnd
Wskaźnik do okna, który jest elementem nadrzędnym kontrolki.

nID
Identyfikator okna podrzędnego kontrolki.

Wartość zwracana

Wartość niezerowa, jeśli operacja zakończyła się powodzeniem, w przeciwnym razie 0.

Uwagi

Create Zamiast CreateEx stosować rozszerzone style systemu Windows określone w rozszerzonym prefiksie WS_EX_stylu systemu Windows.

CreateEx tworzy kontrolkę z rozszerzonymi stylami systemu Windows określonymi przez dwExStyle. Ustaw style rozszerzone specyficzne dla kontrolki przy użyciu polecenia SetExtendedStyle. Na przykład użyj polecenia CreateEx , aby ustawić takie style jak WS_EX_CONTEXTHELP, ale użyj polecenia SetExtendedStyle , aby ustawić takie style jak TCS_EX_FLATSEPARATORS. Aby uzyskać więcej informacji, zobacz style opisane w temacie Tab Control Extended Styles in the Windows SDK (Style rozszerzone kontrolki tabulacji w zestawie Windows SDK).

CTabCtrl::CTabCtrl

CTabCtrl Tworzy obiekt.

CTabCtrl();

CTabCtrl::DeleteAllItems

Usuwa wszystkie elementy z kontrolki karty.

BOOL DeleteAllItems();

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

CTabCtrl::DeleteItem

Usuwa określony element z kontrolki karty.

BOOL DeleteItem(int nItem);

Parametry

nItem
Wartość zerowa elementu do usunięcia.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Przykład

// This example assumes that there is a CTabCtrl member of the
// CTabDlg class named m_TabCtrl.  On a button handler
// called OnDeleteItem of the dialog box the tab control will
// delete the 0 indexed item.

void CTabDlg::OnDeleteItem()
{
   // Delete the first item in the tab control.
   m_TabCtrl.DeleteItem(0);
}

CTabCtrl::DeselectAll

Resetuje elementy w kontrolce karty, czyszcząc wszystkie naciśnięcie.

void DeselectAll(BOOL fExcludeFocus);

Parametry

fExcludeFocus
Flaga określająca zakres usuwania zaznaczenia elementu. Jeśli ten parametr ma wartość FALSE, wszystkie przyciski kart zostaną zresetowane. Jeśli jest ustawiona na TRUEwartość , wszystkie elementy karty z wyjątkiem aktualnie wybranego elementu zostaną zresetowane.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu Win32, TCM_DESELECTALLzgodnie z opisem w zestawie Windows SDK.

CTabCtrl::DrawItem

Wywoływana przez platformę, gdy zmienia się wizualny aspekt kontrolki karty właściciela.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parametry

lpDrawItemStruct
Wskaźnik do DRAWITEMSTRUCT struktury opisującej element do malowania.

Uwagi

Element itemAction członkowski DRAWITEMSTRUCT struktury definiuje akcję rysunku do wykonania.

Domyślnie ta funkcja składowa nic nie robi. Zastąpi tę funkcję składową, aby zaimplementować rysunek dla obiektu rysowania CTabCtrl właściciela.

Aplikacja powinna przywrócić wszystkie obiekty interfejsu urządzenia graficznego (GDI) wybrane dla kontekstu wyświetlania podanego w lpDrawItemStruct przed zakończeniem tej funkcji składowej.

CTabCtrl::GetCurFocus

Pobiera indeks karty z bieżącym fokusem.

int GetCurFocus() const;

Wartość zwracana

Indeks oparty na zerach karty z bieżącym fokusem.

CTabCtrl::GetCurSel

Pobiera aktualnie wybraną kartę w kontrolce karty.

int GetCurSel() const;

Wartość zwracana

Indeks na podstawie zera wybranej karty, jeśli operacja powiedzie się lub -1, jeśli nie wybrano żadnej karty.

CTabCtrl::GetExtendedStyle

Pobiera style rozszerzone, które są obecnie używane dla kontrolki karty.

DWORD GetExtendedStyle();

Wartość zwracana

Reprezentuje style rozszerzone używane obecnie dla kontrolki karty. Ta wartość jest kombinacją rozszerzonych stylów kontrolki tabulacji, zgodnie z opisem w zestawie Windows SDK.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TCM_GETEXTENDEDSTYLEWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CTabCtrl::GetImageList

Pobiera listę obrazów skojarzona z kontrolką karty.

CImageList* GetImageList() const;

Wartość zwracana

Jeśli to się powiedzie, wskaźnik do listy obrazów kontrolki karty; w przeciwnym razie, NULL.

CTabCtrl::GetItem

Pobiera informacje o karcie w kontrolce karty.

BOOL GetItem(int nItem,   TCITEM* pTabCtrlItem) const;

Parametry

nItem
Indeks na karcie oparty na wartości zerowej.

pTabCtrlItem
Wskaźnik do TCITEM struktury, używany do określania informacji do pobrania. Służy również do odbierania informacji o karcie. Ta struktura jest używana z funkcjami składowymi InsertItem, GetItemi SetItem .

Wartość zwracana

Zwraca wartość w przypadku powodzenia TRUE ; FALSE w przeciwnym razie.

Uwagi

Po wysłaniu komunikatu element mask członkowski określa, które atrybuty mają zostać zwrócone. mask Jeśli element członkowski określa TCIF_TEXT wartość, pszText element członkowski musi zawierać adres buforu, który odbiera tekst elementu, a cchTextMax element członkowski musi określić rozmiar buforu.

• mask

  Wartość określająca, które TCITEM elementy członkowskie struktury mają być pobierane lub ustawiane. Ten element członkowski może mieć wartość zero lub kombinację następujących wartości:

  • TCIF_TEXT: Element pszText członkowski jest prawidłowy.
  • TCIF_IMAGE: Element iImage członkowski jest prawidłowy.
  • TCIF_PARAM: Element lParam członkowski jest prawidłowy.
  • TCIF_RTLREADING: Tekst pszText jest wyświetlany przy użyciu kolejności czytania od prawej do lewej w systemach hebrajskich lub arabskich.
  • TCIF_STATE: Element dwState członkowski jest prawidłowy.

• pszText

  Wskaźnik do ciągu zakończonego wartości null zawierającego tekst tabulatora, jeśli struktura zawiera informacje o karcie. Jeśli struktura odbiera informacje, ten element członkowski określa adres buforu odbierającego tekst karty.

• cchTextMax

  Rozmiar buforu wskazywanego przez pszText. Ten element członkowski jest ignorowany, jeśli struktura nie otrzymuje informacji.

• iImage Zaindeksuj do listy obrazów kontrolki karty lub -1, jeśli nie ma obrazu karty.

• lParam

  Dane zdefiniowane przez aplikację skojarzone z kartą. Jeśli na karcie istnieje więcej niż 4 bajty danych zdefiniowanych przez aplikację, aplikacja musi zdefiniować strukturę i użyć jej zamiast TCITEM struktury. Pierwszy element członkowski struktury zdefiniowanej przez aplikację musi być strukturą TCITEMHEADER. Struktura jest identyczna TCITEMHEADER ze strukturą TCITEM , ale bez elementu lParam członkowskiego. Różnica między rozmiarem struktury a rozmiarem TCITEMHEADER struktury powinna być równa liczbie dodatkowych bajtów na kartę.

Przykład

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

CTabCtrl::GetItemCount

Pobiera liczbę kart w kontrolce karty.

int GetItemCount() const;

Wartość zwracana

Liczba elementów w kontrolce karty.

Przykład

Zobacz przykład dla elementu CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Pobiera prostokąt ograniczenia dla określonej karty w kontrolce karty.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Parametry

nItem
Indeks oparty na zerowym elemencie karty.

lpRect
Wskaźnik do RECT struktury, która odbiera prostokąt ograniczenia karty. Te współrzędne używają bieżącego trybu mapowania widoku.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Przykład

Zobacz przykład dla elementu CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Pobiera stan elementu kontrolki karty zidentyfikowanego przez nItemelement .

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Parametry

nItem
Numer indeksu zerowego elementu, dla którego mają być pobierane informacje o stanie.

dwMask
Maskuj, określając, które flagi stanu elementu mają być zwracane. Aby uzyskać listę wartości, zobacz składową maski TCITEM struktury zgodnie z opisem w zestawie Windows SDK.

Wartość zwracana

Odwołanie do wartości DWORD odbierające informacje o stanie. Może być jedną z następujących wartości:

Wartość	Opis
TCIS_BUTTONPRESSED	Zaznaczono element kontrolki karty.
TCIS_HIGHLIGHTED	Element kontrolki karty jest wyróżniony, a karta i tekst są rysowane przy użyciu bieżącego koloru wyróżnienia. W przypadku używania koloru wyróżnienia będzie to prawdziwa interpolacja, a nie kolor różnicowy.

Uwagi

Stan elementu jest określany przez dwState element członkowski TCITEM struktury.

CTabCtrl::GetRowCount

Pobiera bieżącą liczbę wierszy w kontrolce karty.

int GetRowCount() const;

Wartość zwracana

Liczba wierszy kart w kontrolce karty.

Uwagi

Tylko kontrolki tabulacji TCS_MULTILINE , które mają styl, mogą zawierać wiele wierszy kart.

CTabCtrl::GetToolTips

Pobiera uchwyt kontrolki porad narzędzia skojarzonej z kontrolką tabulacji.

CToolTipCtrl* GetToolTips() const;

Wartość zwracana

Obsługa kontrolki porad narzędzia w przypadku powodzenia; w przeciwnym razie NULL.

Uwagi

Kontrolka tabulacji tworzy kontrolkę porad narzędzia, jeśli ma TCS_TOOLTIPS styl. Kontrolkę porad narzędzia można również przypisać do kontrolki tabulacji przy użyciu funkcji składowej SetToolTips .

CTabCtrl::HighlightItem

Ustawia stan wyróżnienia elementu karty.

BOOL HighlightItem(int idItem,  BOOL fHighlight = TRUE);

Parametry

idItem
Indeks oparty na zerowym elemencie kontrolki karty.

fHighlight
Wartość określająca stan wyróżnienia do ustawienia. Jeśli ta wartość to TRUE, karta jest wyróżniona; jeśli FALSEkarta jest ustawiona na stan domyślny.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Ta funkcja składowa implementuje komunikat TCM_HIGHLIGHTITEMWin32 zgodnie z opisem w zestawie Windows SDK.

CTabCtrl::HitTest

Określa, która karta, jeśli istnieje, znajduje się na określonej pozycji ekranu.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Parametry

pHitTestInfo
Wskaźnik do struktury, zgodnie z opisem TCHITTESTINFO w zestawie Windows SDK, który określa położenie ekranu do przetestowania.

Wartość zwracana

Zwraca indeks na podstawie zera karty lub -1, jeśli żadna karta nie znajduje się na określonej pozycji.

CTabCtrl::InsertItem

Wstawia nową kartę w istniejącej kontrolce karty.

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

Parametry

nItem
Indeks nowej karty oparty na wartości zerowej.

pTabCtrlItem
Wskaźnik do TCITEM struktury, która określa atrybuty karty.

lpszItem
Adres ciągu o wartości null, który zawiera tekst karty.

nImage
Zerowy indeks obrazu do wstawienia z listy obrazów.

nMask
Określa, które TCITEM atrybuty struktury mają być ustawione. Może to być zero lub kombinacja następujących wartości:

• TCIF_TEXT: Element pszText członkowski jest prawidłowy.
• TCIF_IMAGE: Element iImage członkowski jest prawidłowy.
• TCIF_PARAM: Element lParam członkowski jest prawidłowy.
• TCIF_RTLREADING: Tekst pszText jest wyświetlany przy użyciu kolejności czytania od prawej do lewej w systemach hebrajskich lub arabskich.
• TCIF_STATE: Element dwState członkowski jest prawidłowy.

lParam
Dane zdefiniowane przez aplikację skojarzone z kartą.

dwState
Określa wartości stanów elementu. Aby uzyskać więcej informacji, zobacz TCITEM w zestawie Windows SDK.

dwStateMask
Określa, które stany mają być ustawione. Aby uzyskać więcej informacji, zobacz TCITEM w zestawie Windows SDK.

Wartość zwracana

W przypadku powodzenia indeks nowej karty oparty na wartości zerowej; w przeciwnym razie -1.

Przykład

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Usuwa określony obraz z listy obrazów kontrolki karty.

void RemoveImage(int nImage);

Parametry

nImage
Indeks obrazu oparty na wartości zerowej do usunięcia.

Uwagi

Kontrolka karty aktualizuje indeks obrazu każdej karty, tak aby każda karta pozostała skojarzona z tym samym obrazem.

CTabCtrl::SetCurFocus

Ustawia fokus na określoną kartę w kontrolce karty.

void SetCurFocus(int nItem);

Parametry

nItem
Określa indeks karty, która pobiera fokus.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TCM_SETCURFOCUSWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CTabCtrl::SetCurSel

Wybiera kartę w kontrolce karty.

int SetCurSel(int nItem);

Parametry

nItem
Indeks zerowy elementu do wybrania.

Wartość zwracana

Indeks na podstawie zera wcześniej wybranej karty, jeśli się powiedzie, w przeciwnym razie -1.

Uwagi

Kontrolka karty nie wysyła komunikatu TCN_SELCHANGING powiadomienia lub TCN_SELCHANGE po wybraniu karty przy użyciu tej funkcji. Te powiadomienia są wysyłane przy użyciu polecenia WM_NOTIFY, gdy użytkownik kliknie lub użyje klawiatury do zmiany kart.

CTabCtrl::SetExtendedStyle

Ustawia rozszerzone style dla kontrolki karty.

DWORD SetExtendedStyle(DWORD dwNewStyle, DWORD dwExMask = 0);

Parametry

dwNewStyle
Wartość określająca kombinację stylów rozszerzonych kontrolki tabulacji.

dwExMask
Wartość DWORD wskazująca, na które style dwNewStyle mają mieć wpływ. Tylko style rozszerzone w programie dwExMask zostaną zmienione. Wszystkie inne style będą utrzymywane w następujący sposób. Jeśli ten parametr ma wartość zero, wszystkie style w programie dwNewStyle będą miały wpływ.

Wartość zwracana

Wartość DWORD zawierająca poprzednie style rozszerzone kontrolki karty, zgodnie z opisem w zestawie WINDOWS SDK.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TCM_SETEXTENDEDSTYLEWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CTabCtrl::SetImageList

Przypisuje listę obrazów do kontrolki karty.

CImageList* SetImageList(CImageList* pImageList);

Parametry

pImageList
Wskaźnik do listy obrazów, który ma zostać przypisany do kontrolki karty.

Wartość zwracana

Zwraca wskaźnik do poprzedniej listy obrazów lub NULL jeśli nie ma poprzedniej listy obrazów.

CTabCtrl::SetItem

Ustawia niektóre lub wszystkie atrybuty karty.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Parametry

nItem
Indeks elementu oparty na wartości zerowej.

pTabCtrlItem
Wskaźnik do TCITEM struktury zawierającej nowe atrybuty elementu. Element mask członkowski określa, które atrybuty mają być ustawione. mask Jeśli element członkowski określa TCIF_TEXT wartość, element pszText członkowski jest adresem ciągu zakończonego wartością null, a cchTextMax element członkowski jest ignorowany.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Przykład

Zobacz przykład dla elementu GetItem.

CTabCtrl::SetItemExtra

Ustawia liczbę bajtów na kartę zarezerwowaną dla danych zdefiniowanych przez aplikację w kontrolce karty.

BOOL SetItemExtra(int nBytes);

Parametry

nBytes
Liczba dodatkowych bajtów do ustawienia.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TCM_SETITEMEXTRAWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CTabCtrl::SetItemSize

Ustawia szerokość i wysokość elementów kontrolki karty.

CSize SetItemSize(CSize size);

Parametry

size
Nowa szerokość i wysokość w pikselach elementów kontrolki tabulacji.

Wartość zwracana

Zwraca starą szerokość i wysokość elementów kontrolki tabulacji.

CTabCtrl::SetItemState

Ustawia stan elementu kontrolki karty zidentyfikowany przez nItemelement .

BOOL SetItemState(
    int nItem,
    DWORD dwMask,
    DWORD dwState);

Parametry

nItem
Numer indeksu zerowego elementu, dla którego mają być ustawiane informacje o stanie.

dwMask
Maska określająca, które flagi stanu elementu mają być ustawione. Aby uzyskać listę wartości, zobacz składową maski TCITEM struktury zgodnie z opisem w zestawie Windows SDK.

dwState
Odwołanie do wartości DWORD zawierającej informacje o stanie. Może być jedną z następujących wartości:

Wartość	Opis
TCIS_BUTTONPRESSED	Zaznaczono element kontrolki karty.
TCIS_HIGHLIGHTED	Element kontrolki karty jest wyróżniony, a karta i tekst są rysowane przy użyciu bieżącego koloru wyróżnienia. W przypadku używania koloru wyróżnienia będzie to prawdziwa interpolacja, a nie kolor różnicowy.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

CTabCtrl::SetMinTabWidth

Ustawia minimalną szerokość elementów w kontrolce karty.

int SetMinTabWidth(int cx);

Parametry

cx
Minimalna szerokość, która ma być ustawiona dla elementu kontrolki tabulacji. Jeśli ten parametr ma wartość -1, kontrolka będzie używać domyślnej szerokości karty.

Wartość zwracana

Poprzednia minimalna szerokość karty.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TCM_SETMINTABWIDTHWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CTabCtrl::SetPadding

Ustawia ilość miejsca (wypełnienie) wokół ikony i etykiety każdej karty w kontrolce karty.

void SetPadding(CSize size);

Parametry

size
Ustawia ilość miejsca (wypełnienie) wokół ikony i etykiety każdej karty w kontrolce karty.

CTabCtrl::SetToolTips

Przypisuje kontrolkę porad narzędzia do kontrolki karty.

void SetToolTips(CToolTipCtrl* pWndTip);

Parametry

pWndTip
Uchwyt kontrolki porad narzędzia.

Uwagi

Kontrolkę porad narzędzia skojarzona z kontrolką tabulacji można uzyskać, wywołując metodę GetToolTips.

Przykład

Zobacz przykład dla elementu CPropertySheet::GetTabControl.

Zobacz też

CWnd Klasa
CHeaderCtrl Klasa
CListCtrl Klasa
Wykres hierarchii