CTabCtrl Třída

Poskytuje funkce běžného ovládacího prvku karta Windows.

Syntaxe

class CTabCtrl : public CWnd

Členové

Veřejné konstruktory

Název	Popis
CTabCtrl::CTabCtrl	CTabCtrl Vytvoří objekt.

Veřejné metody

Název	Popis
CTabCtrl::AdjustRect	Vypočítá oblast zobrazení ovládacího prvku karty zadanou obdélníkem okna nebo vypočítá obdélník okna, který odpovídá dané oblasti zobrazení.
CTabCtrl::Create	Vytvoří ovládací prvek tab a připojí ho k instanci objektu TabCtrl .
CTabCtrl::CreateEx	Vytvoří ovládací prvek tabulátoru se zadanými rozšířenými styly Windows a připojí ho k instanci objektu CTabCtrl .
CTabCtrl::DeleteAllItems	Odebere všechny položky z ovládacího prvku karta.
CTabCtrl::DeleteItem	Odebere položku z ovládacího prvku karta.
CTabCtrl::DeselectAll	Obnoví položky v ovládacím prvku karta a vymaže všechny položky, které byly stisknuty.
CTabCtrl::DrawItem	Nakreslí zadanou položku ovládacího prvku tab.
CTabCtrl::GetCurFocus	Načte kartu s aktuálním fokusem ovládacího prvku karta.
CTabCtrl::GetCurSel	Určuje aktuálně vybranou kartu v ovládacím prvku karta.
CTabCtrl::GetExtendedStyle	Načte rozšířené styly, které se aktuálně používají pro ovládací prvek karta.
CTabCtrl::GetImageList	Načte seznam obrázků přidružený k ovládacímu prvku karta.
CTabCtrl::GetItem	Načte informace o kartě v ovládacím prvku karta.
CTabCtrl::GetItemCount	Načte počet karet v ovládacím prvku karta.
CTabCtrl::GetItemRect	Načte ohraničující obdélník pro ouško v ovládacím prvku tab.
CTabCtrl::GetItemState	Načte stav označené položky ovládacího prvku tab.
CTabCtrl::GetRowCount	Načte aktuální počet řádků karet v ovládacím prvku karta.
CTabCtrl::GetToolTips	Načte popisovač ovládacího prvku popisku nástroje přidruženého k ovládacímu prvku tab.
CTabCtrl::HighlightItem	Nastaví stav zvýraznění položky karty.
CTabCtrl::HitTest	Určuje, která karta je v případě potřeby na zadané pozici obrazovky.
CTabCtrl::InsertItem	Vloží novou kartu do ovládacího prvku karta.
CTabCtrl::RemoveImage	Odebere obrázek ze seznamu obrázků ovládacího prvku karty.
CTabCtrl::SetCurFocus	Nastaví fokus na zadanou kartu v ovládacím prvku karta.
CTabCtrl::SetCurSel	Vybere kartu v ovládacím prvku karta.
CTabCtrl::SetExtendedStyle	Nastaví rozšířené styly ovládacího prvku karta.
CTabCtrl::SetImageList	Přiřadí seznam obrázků ovládacímu prvku karta.
CTabCtrl::SetItem	Nastaví některé nebo všechny atributy karty.
CTabCtrl::SetItemExtra	Nastaví počet bajtů na kartu vyhrazenou pro data definovaná aplikací v ovládacím prvku karta.
CTabCtrl::SetItemSize	Nastaví šířku a výšku položky.
CTabCtrl::SetItemState	Nastaví stav označené položky ovládacího prvku tab.
CTabCtrl::SetMinTabWidth	Nastaví minimální šířku položek v ovládacím prvku tabulátoru.
CTabCtrl::SetPadding	Nastaví velikost místa (odsazení) kolem každé ikony karet a popisku v ovládacím prvku tabulátoru.
CTabCtrl::SetToolTips	Přiřadí ovládací prvek popisku nástroje ovládacímu prvku tab.

Poznámky

Ovládací prvek tabulátoru je podobný rozdělovačům v poznámkovém bloku nebo popiskům v souborové skříni. Pomocí ovládacího prvku karta může aplikace definovat více stránek pro stejnou oblast okna nebo dialogového okna. Každá stránka se skládá ze sady informací nebo skupiny ovládacích prvků, které aplikace zobrazí, když uživatel vybere odpovídající kartu. Speciální typ ovládacího prvku tab zobrazuje karty, které vypadají jako tlačítka. Kliknutí na tlačítko by mělo okamžitě provést příkaz místo zobrazení stránky.

Tento ovládací prvek (a proto CTabCtrl třída) je k dispozici pouze pro programy spuštěné v systémech Windows 95/98 a systém Windows NT verze 3.51 a novější.

Další informace o CTabCtrlovládacích prvcích a používání CTabCtrl.

Hierarchie dědičnosti

CObject
CCmdTarget
CWnd

CTabCtrl

Požadavky

Záhlaví: afxcmn.h

CTabCtrl::AdjustRect

Vypočítá oblast zobrazení ovládacího prvku karty zadanou obdélníkem okna nebo vypočítá obdélník okna, který odpovídá dané oblasti zobrazení.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Parametry

bLarger
Určuje, která operace se má provést. Pokud je TRUEtento parametr , lpRect určuje obdélník zobrazení a přijme odpovídající obdélník okna. Pokud je FALSEtento parametr , lpRect určuje obdélník okna a obdrží odpovídající obdélník zobrazení.

lpRect
Ukazatel na RECT strukturu, která určuje daný obdélník a přijímá počítaný obdélník.

Příklad

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

Vytvoří ovládací prvek tab a připojí ho k instanci objektu CTabCtrl .

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

Parametry

dwStyle
Určuje styl ovládacího prvku tab. Použijte libovolnou kombinaci stylů ovládacích prvků karet popsaných v sadě Windows SDK. Viz Poznámky pro seznam stylů oken, které můžete použít také u ovládacího prvku.

rect
Určuje velikost a umístění ovládacího prvku tab. Může to být CRect objekt nebo RECT struktura.

pParentWnd
Určuje nadřazené okno ovládacího prvku karty, obvykle znak .CDialog Nesmí to být NULL.

nID
Určuje ID ovládacího prvku karty.

Návratová hodnota

TRUE pokud inicializace objektu byla úspěšná; jinak FALSE.

Poznámky

Objekt vytvoříte CTabCtrl ve dvou krocích. Nejprve zavolejte konstruktor a potom volání Create, který vytvoří ovládací prvek tab a připojí ho k objektu CTabCtrl .

Kromě stylů ovládacích prvků karet můžete u ovládacího prvku tabulátoru použít následující styly oken:

• WS_CHILD: Vytvoří podřízené okno, které představuje ovládací prvek tab. Nelze použít se stylem WS_POPUP.
• WS_VISIBLE: Vytvoří ovládací prvek karty, který je zpočátku viditelný.
• WS_DISABLED: Vytvoří okno, které je původně zakázáno.
• WS_GROUP: Určuje první ovládací prvek skupiny ovládacích prvků, ve kterých může uživatel přejít z jednoho ovládacího prvku na další pomocí kláves se šipkami. Všechny ovládací prvky definované stylem WS_GROUP: po prvním ovládacím prvku patří do stejné skupiny. Další ovládací prvek se stylem WS_GROUPkončí skupinu stylů a spustí další skupinu (to znamená, že jedna skupina končí tam, kde začíná další).
• WS_TABSTOP: Určuje jeden z libovolných ovládacích prvků, pomocí kterých se uživatel může pohybovat pomocí klávesy TAB. Klávesa TAB přesune uživatele na další ovládací prvek určený stylem WS_TABSTOP: .

Chcete-li vytvořit ovládací prvek karty s rozšířenými styly oken, místo volání CTabCtrl::CreateEx Create.

Příklad

// 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

Vytvoří ovládací prvek (podřízené okno) a přidruží ho k objektu CTabCtrl .

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

Parametry

dwExStyle
Určuje rozšířený styl vytvářeného ovládacího prvku. Seznam rozšířených stylů Windows najdete v parametru dwExStyle sady CreateWindowEx Windows SDK.

dwStyle
Určuje styl ovládacího prvku tab. Použijte libovolnou kombinaci stylů ovládacích prvků karet popsaných v sadě Windows SDK. Podívejte se na poznámky v Create seznamu stylů oken, které můžete použít také u ovládacího prvku.

rect
Odkaz na RECT strukturu popisující velikost a umístění okna, které se má vytvořit, v souřadnicích pParentWndklienta .

pParentWnd
Ukazatel na okno, které je nadřazeným objektem ovládacího prvku.

nID
ID podřízeného okna ovládacího prvku.

Návratová hodnota

Nenulové, pokud je úspěšné jinak 0.

Poznámky

Create Místo CreateEx použití rozšířených stylů Windows určených předmětu WS_EX_rozšířeného stylu Windows .

CreateEx vytvoří ovládací prvek s rozšířenými styly Windows určenými dwExStyle. Nastavte rozšířené styly specifické pro ovládací prvek pomocí SetExtendedStyle. Slouží CreateEx například k nastavení takových stylů, jako WS_EX_CONTEXTHELPje , ale slouží SetExtendedStyle k nastavení takových stylů jako TCS_EX_FLATSEPARATORS. Další informace naleznete v stylech popsaných v ovládacím prvku Tab Extended Styles v sadě Windows SDK.

CTabCtrl::CTabCtrl

CTabCtrl Vytvoří objekt.

CTabCtrl();

CTabCtrl::DeleteAllItems

Odebere všechny položky z ovládacího prvku karta.

BOOL DeleteAllItems();

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

CTabCtrl::DeleteItem

Odebere zadanou položku z ovládacího prvku tab.

BOOL DeleteItem(int nItem);

Parametry

nItem
Nulová hodnota položky, kterou chcete odstranit.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Příklad

// 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

Obnoví položky v ovládacím prvku karta a vymaže všechny položky, které byly stisknuty.

void DeselectAll(BOOL fExcludeFocus);

Parametry

fExcludeFocus
Příznak, který určuje rozsah zrušení výběru položky. Pokud je tento parametr nastavený na FALSE, všechna tlačítka tabulátoru budou resetována. Pokud je nastavená na TRUEhodnotu , všechny položky tabulátoru s výjimkou aktuálně vybrané položky budou resetovat.

Poznámky

Tato členová funkce implementuje chování zprávy Win32, TCM_DESELECTALLjak je popsáno v sadě Windows SDK.

CTabCtrl::DrawItem

Volá se architekturou, když se změní vizuální aspekt ovládacího prvku karta kreslení vlastníka.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parametry

lpDrawItemStruct
Ukazatel na DRAWITEMSTRUCT strukturu popisující položku, která má být vykreslena.

Poznámky

Člen itemAction DRAWITEMSTRUCT struktury definuje akci výkresu, která se má provést.

Ve výchozím nastavení tato členová funkce nic nedělá. Přepište tuto členovou funkci tak, aby implementovaly výkres pro objekt pro kreslení CTabCtrl vlastníka.

Aplikace by měla obnovit všechny objekty rozhraní grafického zařízení (GDI) vybrané pro kontext zobrazení zadaný před lpDrawItemStruct ukončením této členské funkce.

CTabCtrl::GetCurFocus

Načte index karty s aktuálním fokusem.

int GetCurFocus() const;

Návratová hodnota

Index karty založený na nule s aktuálním fokusem.

CTabCtrl::GetCurSel

Načte aktuálně vybranou kartu v ovládacím prvku karta.

int GetCurSel() const;

Návratová hodnota

Pokud je vybraná karta úspěšná, index založený na nule nebo -1, pokud není vybrána žádná karta.

CTabCtrl::GetExtendedStyle

Načte rozšířené styly, které se aktuálně používají pro ovládací prvek karta.

DWORD GetExtendedStyle();

Návratová hodnota

Představuje rozšířené styly, které se aktuálně používají pro ovládací prvek karta. Tato hodnota je kombinací rozšířených stylů ovládacích prvků karet, jak je popsáno v sadě Windows SDK.

Poznámky

Tato členová funkce implementuje chování zprávy TCM_GETEXTENDEDSTYLEWin32, jak je popsáno v sadě Windows SDK.

CTabCtrl::GetImageList

Načte seznam obrázků přidružený k ovládacímu prvku karta.

CImageList* GetImageList() const;

Návratová hodnota

V případě úspěchu ukazatel na seznam obrázků ovládacího prvku Tab; v opačném případě . NULL

CTabCtrl::GetItem

Načte informace o kartě v ovládacím prvku karta.

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

Parametry

nItem
Index karty založený na nule.

pTabCtrlItem
Ukazatel na TCITEM strukturu, která slouží k určení informací, které se mají načíst. Slouží také k příjmu informací o kartě. Tato struktura se používá s funkcemi InsertItem, GetItema SetItem členské funkce.

Návratová hodnota

Vrátí TRUE hodnotu v případě úspěchu. FALSE V opačném případě.

Poznámky

Po odeslání mask zprávy člen určuje, které atributy se mají vrátit. mask Pokud člen určuje TCIF_TEXT hodnotu, pszText člen musí obsahovat adresu vyrovnávací paměti, která přijímá text položky a cchTextMax člen musí zadat velikost vyrovnávací paměti.

• mask

  Hodnota určující, které TCITEM členy struktury se mají načíst nebo nastavit Tento člen může být nulový nebo kombinací následujících hodnot:

  • TCIF_TEXT: Člen pszText je platný.
  • TCIF_IMAGE: Člen iImage je platný.
  • TCIF_PARAM: Člen lParam je platný.
  • TCIF_RTLREADING: Text pszText se zobrazí pomocí pořadí čtení zprava doleva v systémech hebrejštiny nebo arabštiny.
  • TCIF_STATE: Člen dwState je platný.

• pszText

  Ukazatel na řetězec ukončený hodnotou null obsahující text tabulátoru, pokud struktura obsahuje informace o kartě. Pokud struktura přijímá informace, tento člen určuje adresu vyrovnávací paměti, která přijímá text tabulátoru.

• cchTextMax

  Velikost vyrovnávací paměti, na kterou pszTextodkazuje . Tento člen je ignorován, pokud struktura nepřijímá informace.

• iImage Indexujte do seznamu obrázků ovládacího prvku karta nebo -1, pokud pro kartu neexistuje žádný obrázek.

• lParam

  Data definovaná aplikací přidružená k kartě Pokud je na kartě více než 4 bajty dat definovaných aplikací, musí aplikace definovat strukturu a používat ji místo TCITEM struktury. Prvním členem struktury definované aplikací musí být TCITEMHEADERstruktura. Struktura TCITEMHEADER je stejná jako TCITEM struktura, ale bez člena lParam . Rozdíl mezi velikostí struktury a velikostí TCITEMHEADER struktury by se měl rovnat počtu nadbytečných bajtů na každou kartu.

Příklad

// 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

Načte počet karet v ovládacím prvku karta.

int GetItemCount() const;

Návratová hodnota

Počet položek v ovládacím prvku karta

Příklad

Podívejte se na příklad pro CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Načte ohraničující obdélník pro zadanou kartu v ovládacím prvku tab.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Parametry

nItem
Index položky karty založený na nule

lpRect
Ukazatel na RECT strukturu, která přijímá ohraničující obdélník karty. Tyto souřadnice používají aktuální režim mapování oblasti zobrazení.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Příklad

Podívejte se na příklad pro CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Načte stav položky ovládacího prvku tab identifikovaný .nItem

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Parametry

nItem
Číslo indexu založeného na nule položky, pro kterou chcete načíst informace o stavu.

dwMask
Maska určující, které příznaky stavu položky se mají vrátit. Seznam hodnot naleznete v masce TCITEM člen struktury, jak je popsáno v sadě Windows SDK.

Návratová hodnota

Odkaz na hodnotu DWORD, která přijímá informace o stavu. Může to být jedna z následujících hodnot:

Hodnota	Popis
TCIS_BUTTONPRESSED	Je vybrána položka ovládacího prvku karta.
TCIS_HIGHLIGHTED	Položka ovládacího prvku karta je zvýrazněná a karta a text se nakreslují pomocí aktuální barvy zvýraznění. Při použití barvy zvýraznění se jedná o skutečnou interpolaci, nikoli o diterovanou barvu.

Poznámky

Stav položky je určen dwState členem TCITEM struktury.

CTabCtrl::GetRowCount

Načte aktuální počet řádků v ovládacím prvku tab.

int GetRowCount() const;

Návratová hodnota

Počet řádků karet v ovládacím prvku karta

Poznámky

Pouze ovládací prvky karet, které mají TCS_MULTILINE styl, můžou mít více řádků karet.

CTabCtrl::GetToolTips

Načte popisovač ovládacího prvku popisku nástroje přidruženého k ovládacímu prvku tab.

CToolTipCtrl* GetToolTips() const;

Návratová hodnota

Popisovač ovládacího prvku popisku nástroje v případě úspěchu; jinak NULL.

Poznámky

Ovládací prvek tab vytvoří ovládací prvek popisku nástroje, pokud má TCS_TOOLTIPS styl. Ovládací prvek popisku tlačítek můžete také přiřadit ovládacímu prvku tab pomocí SetToolTips členské funkce.

CTabCtrl::HighlightItem

Nastaví stav zvýraznění položky karty.

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

Parametry

idItem
Nulový index položky ovládacího prvku karty.

fHighlight
Hodnota určující stav zvýraznění, který se má nastavit. Pokud je TRUEtato hodnota , karta je zvýrazněna. Pokud FALSEje karta nastavena na výchozí stav.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Tato členová funkce implementuje zprávu TCM_HIGHLIGHTITEMWin32 , jak je popsáno v sadě Windows SDK.

CTabCtrl::HitTest

Určuje, která karta je v případě potřeby na zadané pozici obrazovky.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Parametry

pHitTestInfo
Ukazatel na TCHITTESTINFO strukturu, jak je popsáno v sadě Windows SDK, která určuje pozici obrazovky, která se má testovat.

Návratová hodnota

Vrátí index založený na nule tabulátoru nebo -1, pokud není na zadané pozici žádná tabulátor.

CTabCtrl::InsertItem

Vloží novou kartu do existujícího ovládacího prvku karta.

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
Index založený na nule nové karty

pTabCtrlItem
Ukazatel na TCITEM strukturu, která určuje atributy karty.

lpszItem
Adresa řetězce ukončeného hodnotou null, který obsahuje text karty.

nImage
Index obrázku založený na nule, který se má vložit ze seznamu obrázků.

nMask
Určuje, které TCITEM atributy struktury se mají nastavit. Může to být nula nebo kombinace následujících hodnot:

• TCIF_TEXT: Člen pszText je platný.
• TCIF_IMAGE: Člen iImage je platný.
• TCIF_PARAM: Člen lParam je platný.
• TCIF_RTLREADING: Text pszText se zobrazí pomocí pořadí čtení zprava doleva v systémech hebrejštiny nebo arabštiny.
• TCIF_STATE: Člen dwState je platný.

lParam
Data definovaná aplikací přidružená k kartě

dwState
Určuje hodnoty pro stavy položky. Další informace najdete TCITEM v sadě Windows SDK.

dwStateMask
Určuje, které stavy se mají nastavit. Další informace najdete TCITEM v sadě Windows SDK.

Návratová hodnota

Nulový index nové karty v případě úspěchu; jinak -1.

Příklad

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

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Odebere zadaný obrázek ze seznamu obrázků ovládacího prvku karty.

void RemoveImage(int nImage);

Parametry

nImage
Index image založený na nule, který chcete odebrat.

Poznámky

Ovládací prvek karta aktualizuje index obrázků jednotlivých karet tak, aby každá karta zůstala přidružená ke stejnému obrázku.

CTabCtrl::SetCurFocus

Nastaví fokus na zadanou kartu v ovládacím prvku karta.

void SetCurFocus(int nItem);

Parametry

nItem
Určuje index karty, která získá fokus.

Poznámky

Tato členová funkce implementuje chování zprávy TCM_SETCURFOCUSWin32, jak je popsáno v sadě Windows SDK.

CTabCtrl::SetCurSel

Vybere kartu v ovládacím prvku karta.

int SetCurSel(int nItem);

Parametry

nItem
Index položky, který se má vybrat, je založený na nule.

Návratová hodnota

Index založený na nule dříve vybrané karty v případě úspěchu, jinak -1.

Poznámky

Ovládací prvek karta neodesílá zprávu s TCN_SELCHANGE oznámenímTCN_SELCHANGING, pokud je vybrána karta pomocí této funkce. Tato oznámení se posílají pomocí , WM_NOTIFYkdyž uživatel klikne nebo použije klávesnici ke změně karet.

CTabCtrl::SetExtendedStyle

Nastaví rozšířené styly ovládacího prvku karta.

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

Parametry

dwNewStyle
Hodnota určující kombinaci rozšířených stylů ovládacího prvku tabulátoru

dwExMask
Hodnota DWORD, která označuje, které styly dwNewStyle mají být ovlivněny. Změní se pouze rozšířené styly dwExMask . Všechny ostatní styly budou zachovány tak, jak jsou. Pokud je tento parametr nula, ovlivní to všechny styly.dwNewStyle

Návratová hodnota

Hodnota DWORD, která obsahuje předchozí ovládací prvek karty rozšířené styly, jak je popsáno v sadě Windows SDK.

Poznámky

Tato členová funkce implementuje chování zprávy TCM_SETEXTENDEDSTYLEWin32, jak je popsáno v sadě Windows SDK.

CTabCtrl::SetImageList

Přiřadí seznam obrázků ovládacímu prvku karta.

CImageList* SetImageList(CImageList* pImageList);

Parametry

pImageList
Ukazatel na seznam obrázků, který se má přiřadit ovládacímu prvku tab.

Návratová hodnota

Vrátí ukazatel na předchozí seznam obrázků nebo NULL pokud neexistuje žádný předchozí seznam obrázků.

CTabCtrl::SetItem

Nastaví některé nebo všechny atributy karty.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Parametry

nItem
Index položky založený na nule

pTabCtrlItem
Ukazatel na TCITEM strukturu, která obsahuje atributy nové položky. Člen mask určuje, které atributy se mají nastavit. mask Pokud člen určuje TCIF_TEXT hodnotu, pszText člen je adresa řetězce s ukončenou hodnotou null a cchTextMax člen je ignorován.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Příklad

Podívejte se na příklad pro GetItem.

CTabCtrl::SetItemExtra

Nastaví počet bajtů na kartu vyhrazenou pro data definovaná aplikací v ovládacím prvku karta.

BOOL SetItemExtra(int nBytes);

Parametry

nBytes
Počet dalších bajtů, které se mají nastavit.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Tato členová funkce implementuje chování zprávy TCM_SETITEMEXTRAWin32, jak je popsáno v sadě Windows SDK.

CTabCtrl::SetItemSize

Nastaví šířku a výšku ovládacích prvků karty.

CSize SetItemSize(CSize size);

Parametry

size
Nová šířka a výška ovládacích prvků karty v pixelech

Návratová hodnota

Vrátí starou šířku a výšku položek ovládacího prvku tab.

CTabCtrl::SetItemState

Nastaví stav položky ovládacího prvku tab identifikovaný znakem nItem.

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

Parametry

nItem
Číslo indexu založeného na nule položky, pro kterou chcete nastavit informace o stavu.

dwMask
Maskování určující, které příznaky stavu položky se mají nastavit. Seznam hodnot naleznete v masce TCITEM člen struktury, jak je popsáno v sadě Windows SDK.

dwState
Odkaz na hodnotu DWORD obsahující informace o stavu. Může to být jedna z následujících hodnot:

Hodnota	Popis
TCIS_BUTTONPRESSED	Je vybrána položka ovládacího prvku karta.
TCIS_HIGHLIGHTED	Položka ovládacího prvku karta je zvýrazněná a karta a text se nakreslují pomocí aktuální barvy zvýraznění. Při použití barvy zvýraznění se jedná o skutečnou interpolaci, nikoli o diterovanou barvu.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

CTabCtrl::SetMinTabWidth

Nastaví minimální šířku položek v ovládacím prvku tabulátoru.

int SetMinTabWidth(int cx);

Parametry

cx
Minimální šířka nastavená pro položku ovládacího prvku karty. Pokud je tento parametr nastaven na hodnotu -1, bude ovládací prvek používat výchozí šířku tabulátoru.

Návratová hodnota

Předchozí minimální šířka tabulátoru.

Poznámky

Tato členová funkce implementuje chování zprávy TCM_SETMINTABWIDTHWin32, jak je popsáno v sadě Windows SDK.

CTabCtrl::SetPadding

Nastaví velikost místa (odsazení) kolem ikony a popisku každé karty v ovládacím prvku karta.

void SetPadding(CSize size);

Parametry

size
Nastaví velikost místa (odsazení) kolem ikony a popisku každé karty v ovládacím prvku karta.

CTabCtrl::SetToolTips

Přiřadí ovládací prvek popisku nástroje ovládacímu prvku tab.

void SetToolTips(CToolTipCtrl* pWndTip);

Parametry

pWndTip
Úchyt ovládacího prvku popisku.

Poznámky

Ovládací prvek popisku tlačítka přidružený k ovládacímu prvku tab můžete získat voláním GetToolTips.

Příklad

Podívejte se na příklad pro CPropertySheet::GetTabControl.

Viz také

CWnd Třída
CHeaderCtrl Třída
CListCtrl Třída
Graf hierarchie