Megosztás:

CTabCtrl osztály

A Windows gyakori lap vezérlőelem funkcióit biztosítja.

Szemantika

class CTabCtrl : public CWnd

Tagok

Nyilvános konstruktorok

Név Leírás
CTabCtrl::CTabCtrl Egy CTabCtrl objektumot hoz létre.

Nyilvános metódusok

Név Leírás
CTabCtrl::AdjustRect Kiszámítja a tabulátor megjelenítési területét egy ablak téglalapja alapján, vagy kiszámítja azt az ablak téglalapot, amely egy adott megjelenítési területnek felel meg.
CTabCtrl::Create Tabulátor vezérlőelem létrehozása és csatolása egy TabCtrl objektum egy példányához
CTabCtrl::CreateEx Létrehoz egy tabulátorvezérlőt a megadott Bővített Windows-stílusokkal, és csatolja egy CTabCtrl objektumpéldányhoz.
CTabCtrl::DeleteAllItems Eltávolítja az összes elemet egy tabulátor vezérlőelemből.
CTabCtrl::DeleteItem Eltávolít egy elemet egy tabulátor vezérlőelemből.
CTabCtrl::DeselectAll Alaphelyzetbe állítja a tabulátor vezérlőelem elemeit, és törli a lenyomott elemeket.
CTabCtrl::DrawItem Egy tabulátor vezérlőelem megadott elemének rajzolása.
CTabCtrl::GetCurFocus Lekéri a tabulátor aktuális fókuszát tartalmazó lapot.
CTabCtrl::GetCurSel Meghatározza a tabulátor vezérlőelem jelenleg kijelölt lapfülét.
CTabCtrl::GetExtendedStyle Lekéri a tabulátorvezérlőhöz jelenleg használt bővített stílusokat.
CTabCtrl::GetImageList Lekéri a tabulátor vezérlőelemhez társított képlistát.
CTabCtrl::GetItem Lekéri a tabulátor vezérlőelem egyik lapjának adatait.
CTabCtrl::GetItemCount Lekéri a tabulátor vezérlőelem lapjainak számát.
CTabCtrl::GetItemRect Lekéri a tabulátor vezérlőelem egyik lapjának határolókeretét.
CTabCtrl::GetItemState Lekéri a jelzett lap vezérlőelem állapotát.
CTabCtrl::GetRowCount Lekéri a tabulátor vezérlőelemben lévő fülsorok aktuális számát.
CTabCtrl::GetToolTips Lekéri a tabulátor vezérlőelemhez társított eszköztipp vezérlőelem fogópontját.
CTabCtrl::HighlightItem Egy tabulátorelem kiemelési állapotát állítja be.
CTabCtrl::HitTest Meghatározza, hogy melyik lap van adott képernyőpozícióban, ha van ilyen.
CTabCtrl::InsertItem Új lap beszúrása egy tabulátor vezérlőelembe.
CTabCtrl::RemoveImage Eltávolít egy képet egy tabulátorvezérlő képlistájából.
CTabCtrl::SetCurFocus Beállítja a fókuszt egy adott lapfülre egy tabulátor vezérlőelemben.
CTabCtrl::SetCurSel A tabulátor vezérlőelem egyik lapfülét jelöli ki.
CTabCtrl::SetExtendedStyle A tabulátor vezérlőelem kiterjesztett stílusainak beállítása.
CTabCtrl::SetImageList Képlistát rendel egy tabulátor vezérlőelemhez.
CTabCtrl::SetItem Egy lap attribútumainak egy részét vagy egészét állítja be.
CTabCtrl::SetItemExtra Az alkalmazás által definiált adatokhoz fenntartott laponkénti bájtok számát állítja be egy tabulátor vezérlőelemben.
CTabCtrl::SetItemSize Egy elem szélességét és magasságát állítja be.
CTabCtrl::SetItemState A jelzett lap vezérlőelem állapotát állítja be.
CTabCtrl::SetMinTabWidth A tabulátor vezérlőelem elemeinek minimális szélességét állítja be.
CTabCtrl::SetPadding Beállítja a lapfülek ikonjai és címkéi körüli térközt (kitöltést) egy tabulátor vezérlőelemben.
CTabCtrl::SetToolTips Eszköztipp-vezérlőt rendel egy tabulátor vezérlőelemhez.

Megjegyzések

A "tabulátor" hasonló a jegyzetfüzet elválasztóihoz vagy a fájlszekrény címkéihez. Egy tabulátor vezérlőelem használatával az alkalmazások több lapot is meghatározhatnak egy ablak vagy párbeszédpanel ugyanazon területéhez. Minden lap olyan információkészletből vagy vezérlőkből áll, amelyeket az alkalmazás megjelenít, amikor a felhasználó kiválasztja a megfelelő lapot. Egy speciális típusú tabulátorgomb gombnak tűnő lapokat jelenít meg. Ha rákattint egy gombra, azonnal végre kell hajtania egy parancsot a lap megjelenítése helyett.

Ez a vezérlő (és ezért a CTabCtrl osztály) csak a Windows 95/98 és a Windows NT 3.51-es és újabb verzióiban futó programokhoz érhető el.

További információ: CTabCtrlVezérlők és használatCTabCtrl.

Öröklési hierarchia

CObject
CCmdTarget
CWnd

CTabCtrl

Követelmények

fejléc:afxcmn.h

CTabCtrl::AdjustRect

Kiszámítja a tabulátor megjelenítési területét egy ablak téglalapja alapján, vagy kiszámítja azt az ablak téglalapot, amely egy adott megjelenítési területnek felel meg.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Paraméterek

bLarger
Azt jelzi, hogy melyik műveletet kell elvégeznie. Ha ez a paraméter, TRUElpRect megjelenítendő téglalapot ad meg, és megkapja a megfelelő ablak téglalapot. Ha ez a paraméter, FALSElpRect egy ablak téglalapot ad meg, és megkapja a megfelelő megjelenítési téglalapot.

lpRect
Mutasson egy RECT struktúrára, amely megadja az adott téglalapot, és megkapja a számított téglalapot.

példa

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

Tabulátor vezérlőelemet hoz létre, és csatolja egy objektum egy CTabCtrl példányához.

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

Paraméterek

dwStyle
Megadja a tabulátor stílusát. A Windows SDK-ban leírt fülvezérlési stílusok bármilyen kombinációját alkalmazhatja. A vezérlőelemre is alkalmazható ablakstílusok listáját lásd: Megjegyzések.

rect
Megadja a lapvezérlő méretét és pozícióját. CRect Lehet objektum vagy RECT struktúra.

pParentWnd
A tabulátor vezérlőelem szülőablakát adja meg, általában egy CDialog. Nem lehet NULL.

nID
A tabulátor vezérlőelem azonosítóját adja meg.

Visszaadott érték

TRUE ha az objektum inicializálása sikeres volt; egyéb esetben FALSE.

Megjegyzések

Egy objektumot CTabCtrl két lépésben hozhat létre. Először hívja meg a konstruktort, majd hívja meg Create, amely létrehozza a tabulátorvezérlőt, és csatolja az CTabCtrl objektumhoz.

A tabulátorstílusok mellett a következő ablakstílusokat is alkalmazhatja egy tabulátor vezérlőelemre:

  • WS_CHILD: Létrehoz egy gyermekablakot, amely a tabulátor vezérlőelemet jelöli. Nem használható WS_POPUP stílussal.
  • WS_VISIBLE: Létrehoz egy kezdetben látható tabulátorvezérlőt.
  • WS_DISABLED: Létrehoz egy ablakot, amely kezdetben le van tiltva.
  • WS_GROUP: Egy vezérlőcsoport első vezérlőjét adja meg, amelyben a felhasználó a nyílbillentyűkkel az egyik vezérlőről a másikra léphet. Az első vezérlőelem utáni : stílussal WS_GROUPdefiniált összes vezérlő ugyanahhoz a csoporthoz tartozik. A következő vezérlőelem a WS_GROUPkövetkező stílussal véget vet a stíluscsoportnak, és elindítja a következő csoportot (vagyis az egyik csoport ott végződik, ahol a következő kezdődik).
  • WS_TABSTOP: Megadja azoknak a vezérlőknek az egyikét, amelyeken keresztül a felhasználó a TAB billentyűvel mozoghat. A TAB billentyű a következő vezérlőelemre helyezi át a felhasználót, amelyet a WS_TABSTOPkövetkező stílus határoz meg.

Ha bővített ablakstílusokat tartalmazó tabulátor vezérlőelemet szeretne létrehozni, hívja meg ahelyettCTabCtrl::CreateEx, hogy a Create .

példa

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

Létrehoz egy vezérlőt (egy gyermekablakot), és társítja azt a CTabCtrl objektummal.

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

Paraméterek

dwExStyle
A létrehozott vezérlőelem kiterjesztett stílusát adja meg. A bővített Windows-stílusok listáját a dwExStyle Windows SDK paraméterében CreateWindowEx találja.

dwStyle
Megadja a tabulátor stílusát. A Windows SDK-ban leírt fülvezérlési stílusok bármilyen kombinációját alkalmazhatja. A vezérlőelemre is alkalmazható ablakstílusokCreate listájához lásd a Megjegyzések című témakört.

rect
Hivatkozás a RECT létrehozandó ablak méretét és pozícióját leíró struktúrára a következő ügyfélkoordinátáiban pParentWnd: .

pParentWnd
A vezérlő szülőablakára mutató mutató.

nID
A vezérlő gyermekablak-azonosítója.

Visszaadott érték

Nonzero, ha sikeres, egyébként 0.

Megjegyzések

CreateEx A Create bővített Windows-stílusok helyett használja a Windows bővített stílus előszavában WS_EX_megadott stílusokat.

CreateEx a vezérlőt a megadott kiterjesztett Windows-stílusokkal dwExStylehozza létre. A vezérlőelemre jellemző kiterjesztett stílusok beállítása a következővel SetExtendedStyle: . Például az olyan stílusok beállítására használható CreateEx , mint WS_EX_CONTEXTHELPpéldául a , de az olyan stílusok beállítására, SetExtendedStyle mint a TCS_EX_FLATSEPARATORS. További információkért tekintse meg a Windows SDK-ban a Tab Control Extended Styles (Bővített stílusok) című témakört.

CTabCtrl::CTabCtrl

Egy CTabCtrl objektumot hoz létre.

CTabCtrl();

CTabCtrl::DeleteAllItems

Eltávolítja az összes elemet egy tabulátor vezérlőelemből.

BOOL DeleteAllItems();

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

CTabCtrl::DeleteItem

Eltávolítja a megadott elemet egy tabulátorvezérlőből.

BOOL DeleteItem(int nItem);

Paraméterek

nItem
A törölni kívánt elem nullaalapú értéke.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

példa

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

Alaphelyzetbe állítja a tabulátor vezérlőelem elemeit, és törli a lenyomott elemeket.

void DeselectAll(BOOL fExcludeFocus);

Paraméterek

fExcludeFocus
Az elem kijelölésének hatókörét meghatározó jelző. Ha ez a paraméter be van állítva FALSE, az összes tabulátorgomb alaphelyzetbe áll. Ha be van állítva TRUE, akkor az aktuálisan kijelölt kivételével minden tabulátorelem alaphelyzetbe áll.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet viselkedését a TCM_DESELECTALLWindows SDK-ban leírtak szerint.

CTabCtrl::DrawItem

A keretrendszer meghívja, amikor egy tulajdonosi rajz lap vizuális aspektusa megváltozik.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Paraméterek

lpDrawItemStruct
Mutató a DRAWITEMSTRUCT festendő elemet leíró szerkezetre.

Megjegyzések

A itemAction struktúra tagja DRAWITEMSTRUCT határozza meg a végrehajtandó rajzműveletet.

Alapértelmezés szerint ez a tagfüggvény nem tesz semmit. A tagfüggvény felülbírálása egy tulajdonosi rajzobjektum CTabCtrl rajzának implementálásához.

Az alkalmazásnak vissza kell állítania az összes grafikus eszközillesztő (GDI) objektumot, amely a tagfüggvény leállása előtt megadott megjelenítési környezethez lpDrawItemStruct van kiválasztva.

CTabCtrl::GetCurFocus

Lekéri a lap indexét az aktuális fókuszsal.

int GetCurFocus() const;

Visszaadott érték

A tabulátor nulla alapú indexe az aktuális fókuszsal.

CTabCtrl::GetCurSel

Lekéri az aktuálisan kijelölt lapot egy tabulátor vezérlőelemben.

int GetCurSel() const;

Visszaadott érték

A kijelölt lap nulla alapú indexe sikeres vagy -1, ha nincs kijelölve lap.

CTabCtrl::GetExtendedStyle

Lekéri a tabulátorvezérlőhöz jelenleg használt bővített stílusokat.

DWORD GetExtendedStyle();

Visszaadott érték

A tabulátor vezérlőelemhez jelenleg használt bővített stílusokat jelöli. Ez az érték a Bővített stílusok lapvezérlésének kombinációja, a Windows SDK-ban leírtak szerint.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TCM_GETEXTENDEDSTYLEviselkedését a Windows SDK-ban leírtak szerint.

CTabCtrl::GetImageList

Lekéri a tabulátor vezérlőelemhez társított képlistát.

CImageList* GetImageList() const;

Visszaadott érték

Ha sikeres, a tabulátor vezérlőelem képlistájára mutató mutató; egyéb esetben. NULL

CTabCtrl::GetItem

Lekéri a tabulátor vezérlőelem egyik lapjának adatait.

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

Paraméterek

nItem
A lap nullaalapú indexe.

pTabCtrlItem
Mutató egy TCITEM struktúrára, amely a lekérendő információk megadására szolgál. A lap információinak fogadására is szolgál. Ez a struktúra a , InsertItemés GetItem tagfüggvényekkel SetItemhasználható.

Visszaadott érték

TRUE Eredmény, ha sikeres; FALSE ellenkező esetben.

Megjegyzések

Az üzenet elküldésekor a mask tag megadja, hogy mely attribútumokat adja vissza. Ha a mask tag megadja az TCIF_TEXT értéket, a pszText tagnak tartalmaznia kell az elem szövegét fogadó puffer címét, a cchTextMax tagnak pedig meg kell adnia a puffer méretét.

  • mask

    Érték, amely meghatározza, hogy mely TCITEM struktúratagok kérhetők le vagy állíthatók be. Ez a tag lehet nulla vagy a következő értékek kombinációja:

    • TCIF_TEXT: A pszText tag érvényes.
    • TCIF_IMAGE: A iImage tag érvényes.
    • TCIF_PARAM: A lParam tag érvényes.
    • TCIF_RTLREADING: A szöveg pszText jobbról balra olvasási sorrendben jelenik meg héber vagy arab rendszereken.
    • TCIF_STATE: A dwState tag érvényes.

  • pszText

    Mutasson a tabulátorszöveget tartalmazó null értékű sztringre, ha a struktúra információkat tartalmaz egy lapról. Ha a struktúra információt kap, a tag megadja a tabulátor szövegét fogadó puffer címét.

  • cchTextMax

    A puffer mérete, amely pszTexta következő szerint mutat: . A rendszer figyelmen kívül hagyja ezt a tagot, ha a struktúra nem kap információt.

  • iImage Indexelje a tabulátor képlistájába, vagy -1, ha nincs kép a laphoz.

  • lParam

    A laphoz társított alkalmazás által definiált adatok. Ha laponként 4 bájtnál több alkalmazás által definiált adat van, az alkalmazásnak meg kell határoznia egy struktúrát, és azt a struktúra helyett kell TCITEM használnia. Az alkalmazás által definiált struktúra első tagjának egy struktúrának TCITEMHEADER kell lennie. A TCITEMHEADER struktúra megegyezik a TCITEM szerkezettel, de a lParam tag nélkül. A struktúra mérete és a szerkezet mérete TCITEMHEADER közötti különbségnek meg kell egyezik a laponkénti plusz bájtok számával.

példa

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

Lekéri a tabulátor vezérlőelem lapjainak számát.

int GetItemCount() const;

Visszaadott érték

A tabulátor vezérlőelem elemeinek száma.

példa

Lásd a példát a CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Lekéri a tabulátor vezérlőelem megadott lapjának határolókeretét.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Paraméterek

nItem
A tabulátorelem nulla alapú indexe.

lpRect
Mutasson egy RECT szerkezetre, amely megkapja a lap határoló téglalapját. Ezek a koordináták a nézetport aktuális leképezési módját használják.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

példa

Lásd a példát a CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Lekéri a tabulátorvezérlő elem által nItemazonosított állapotát.

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Paraméterek

nItem
Annak az elemnek a nullaalapú indexszáma, amelyhez az állapotinformációkat le szeretné kérni.

dwMask
Maszk, amely megadja, hogy az elem melyik állapotjelzőjét adja vissza. Az értékek listájáért tekintse meg a TCITEM struktúra maszkjának tagját a Windows SDK-ban leírtak szerint.

Visszaadott érték

Az állapotinformációkat fogadó DWORD-értékre mutató hivatkozás. Az alábbi értékek egyike lehet:

Érték Leírás
TCIS_BUTTONPRESSED A tabulátor vezérlőelem ki van jelölve.
TCIS_HIGHLIGHTED A tabulátor vezérlőeleme ki van emelve, a lap és a szöveg pedig az aktuális kiemelési színnel lesz rajzolva. A kiemelési szín használata esetén ez valódi interpoláció lesz, nem pedig színelválasztó.

Megjegyzések

Az elem állapotát a dwState struktúra tagja TCITEM határozza meg.

CTabCtrl::GetRowCount

Lekéri a tabulátor vezérlőelemben lévő sorok aktuális számát.

int GetRowCount() const;

Visszaadott érték

A tabulátorok sorainak száma a tabulátor vezérlőelemben.

Megjegyzések

Csak a stílust TCS_MULTILINE tartalmazó lapvezérlők tartalmazhatnak több sornyi tabulátort.

CTabCtrl::GetToolTips

Lekéri a tabulátor vezérlőelemhez társított eszköztipp vezérlőelem fogópontját.

CToolTipCtrl* GetToolTips() const;

Visszaadott érték

A szerszámhegy vezérlőelem kezelése, ha sikeres; egyéb esetben NULL.

Megjegyzések

A tabulátor vezérlőelemek akkor hoznak létre egy eszköztipp-vezérlőt, ha az rendelkezik a stílussal TCS_TOOLTIPS . A tagfüggvény használatával eszköztipp-vezérlőt is hozzárendelhet egy SetToolTips tabulátor vezérlőelemhez.

CTabCtrl::HighlightItem

Egy tabulátorelem kiemelési állapotát állítja be.

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

Paraméterek

idItem
Tabulátor vezérlőelem nulla alapú indexe.

fHighlight
A beállítani kívánt kiemelési állapotot meghatározó érték. Ha ez az TRUEérték, a lap ki van emelve; ha FALSEa lap alapértelmezett állapotra van állítva.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ez a tagfüggvény implementálja a Win32 üzenetet TCM_HIGHLIGHTITEMa Windows SDK-ban leírtak szerint.

CTabCtrl::HitTest

Meghatározza, hogy melyik lap van a megadott képernyőpozícióban, ha van ilyen.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Paraméterek

pHitTestInfo
Mutasson egy TCHITTESTINFO szerkezetre a Windows SDK-ban leírtak szerint, amely megadja a tesztelni kívánt képernyőpozíciót.

Visszaadott érték

A lap nulla alapú indexét adja vissza, vagy -1, ha nincs lap a megadott pozícióban.

CTabCtrl::InsertItem

Új lap beszúrása meglévő lap vezérlőelembe.

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

Paraméterek

nItem
Az új lap nullaalapú indexe.

pTabCtrlItem
Mutató a TCITEM lap attribútumait meghatározó struktúrára.

lpszItem
A lap szövegét tartalmazó null értékű sztring címe.

nImage
A képlistából beszúrni kívánt kép nullaalapú indexe.

nMask
Meghatározza, hogy mely TCITEM struktúraattribútumokat kell beállítani. Lehet nulla vagy a következő értékek kombinációja:

  • TCIF_TEXT: A pszText tag érvényes.
  • TCIF_IMAGE: A iImage tag érvényes.
  • TCIF_PARAM: A lParam tag érvényes.
  • TCIF_RTLREADING: A szöveg pszText jobbról balra olvasási sorrendben jelenik meg héber vagy arab rendszereken.
  • TCIF_STATE: A dwState tag érvényes.

lParam
A laphoz társított alkalmazás által definiált adatok.

dwState
Az elem állapotának értékeit adja meg. További információt a Windows SDK-ban talál TCITEM .

dwStateMask
Megadja, hogy mely állapotokat kell beállítani. További információt a Windows SDK-ban talál TCITEM .

Visszaadott érték

Az új lap nulla alapú indexe, ha sikeres; egyéb esetben -1.

példa

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

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Eltávolítja a megadott képet egy tabulátorvezérlő képlistájából.

void RemoveImage(int nImage);

Paraméterek

nImage
Az eltávolítandó kép nullaalapú indexe.

Megjegyzések

A tabulátorvezérlő frissíti az egyes lapok képindexét, így minden lap ugyanahhoz a képhez lesz társítva.

CTabCtrl::SetCurFocus

Beállítja a fókuszt egy adott lapfülre egy tabulátor vezérlőelemben.

void SetCurFocus(int nItem);

Paraméterek

nItem
A fókuszt lekérő lap indexét adja meg.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TCM_SETCURFOCUSviselkedését a Windows SDK-ban leírtak szerint.

CTabCtrl::SetCurSel

A tabulátor vezérlőelem egyik lapfülét jelöli ki.

int SetCurSel(int nItem);

Paraméterek

nItem
A kijelölendő elem nulla alapú indexe.

Visszaadott érték

Ha sikeres, akkor a korábban kijelölt lap nulla alapú indexe, ellenkező esetben -1.

Megjegyzések

A tabulátorvezérlők nem küldenek TCN_SELCHANGINGTCN_SELCHANGE vagy nem küldenek értesítési üzenetet, ha egy tabulátor van kijelölve ezzel a függvénnyel. Ezeket az értesítéseket a rendszer akkor küldi el, WM_NOTIFYamikor a felhasználó a billentyűzetre kattint, vagy a billentyűzet használatával módosítja a lapokat.

CTabCtrl::SetExtendedStyle

A tabulátor vezérlőelem kiterjesztett stílusainak beállítása.

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

Paraméterek

dwNewStyle
A tabulátorstílusok kombinációját meghatározó érték.

dwExMask
Egy DWORD érték, amely azt jelzi, hogy mely stílusokat dwNewStyle kell érinteni. Csak a bővített stílusok dwExMask módosulnak. Minden más stílus megmarad, ahogy van. Ha ez a paraméter nulla, akkor a program az összes stílust dwNewStyle érinti.

Visszaadott érték

Az előző lapfület tartalmazó DWORD-érték a bővített stílusokat szabályozza a Windows SDK-ban leírtak szerint.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TCM_SETEXTENDEDSTYLEviselkedését a Windows SDK-ban leírtak szerint.

CTabCtrl::SetImageList

Képlistát rendel egy tabulátor vezérlőelemhez.

CImageList* SetImageList(CImageList* pImageList);

Paraméterek

pImageList
Mutasson a tabulátor vezérlőelemhez hozzárendelendő képlistára.

Visszaadott érték

Az előző képlistára mutató mutatót ad vissza, vagy NULL ha nincs korábbi képlista.

CTabCtrl::SetItem

Egy lap attribútumainak egy részét vagy egészét állítja be.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Paraméterek

nItem
Az elem nulla alapú indexe.

pTabCtrlItem
Mutató az TCITEM új elemattribútumokat tartalmazó struktúrára. A mask tag megadja, hogy mely attribútumokat kell beállítani. Ha a mask tag megadja az TCIF_TEXT értéket, a pszText tag egy null értékű sztring címe, és a cchTextMax tag figyelmen kívül lesz hagyva.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

példa

Lásd a példát a GetItem.

CTabCtrl::SetItemExtra

Az alkalmazás által definiált adatokhoz fenntartott laponkénti bájtok számát állítja be egy tabulátor vezérlőelemben.

BOOL SetItemExtra(int nBytes);

Paraméterek

nBytes
A beállítandó további bájtok száma.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TCM_SETITEMEXTRAviselkedését a Windows SDK-ban leírtak szerint.

CTabCtrl::SetItemSize

A tabulátor vezérlőelemeinek szélességét és magasságát állítja be.

CSize SetItemSize(CSize size);

Paraméterek

size
A tabulátorelemek új szélessége és magassága képpontban.

Visszaadott érték

A tabulátor vezérlőelemek régi szélességét és magasságát adja vissza.

CTabCtrl::SetItemState

A tabulátorvezérlő elem által azonosított nItemállapotának beállítása.

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

Paraméterek

nItem
Annak az elemnek a nullaalapú indexszáma, amelyhez állapotinformációt szeretne beállítani.

dwMask
Maszk, amely megadja az elem állapotjelzőinek beállítását. Az értékek listájáért tekintse meg a TCITEM struktúra maszkjának tagját a Windows SDK-ban leírtak szerint.

dwState
Az állapotinformációkat tartalmazó DWORD-értékre mutató hivatkozás. Az alábbi értékek egyike lehet:

Érték Leírás
TCIS_BUTTONPRESSED A tabulátor vezérlőelem ki van jelölve.
TCIS_HIGHLIGHTED A tabulátor vezérlőeleme ki van emelve, a lap és a szöveg pedig az aktuális kiemelési színnel lesz rajzolva. A kiemelési szín használata esetén ez valódi interpoláció lesz, nem pedig színelválasztó.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

CTabCtrl::SetMinTabWidth

A tabulátor vezérlőelem elemeinek minimális szélességét állítja be.

int SetMinTabWidth(int cx);

Paraméterek

cx
A tabulátorvezérlőelem minimális szélessége. Ha ez a paraméter -1 értékre van állítva, a vezérlő az alapértelmezett lapszélességgel fog használni.

Visszaadott érték

Az előző minimális lapszélesség.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TCM_SETMINTABWIDTHviselkedését a Windows SDK-ban leírtak szerint.

CTabCtrl::SetPadding

A tabulátor ikonja és címkéje körüli térközt (kitöltést) állítja be egy tabulátor vezérlőelemben.

void SetPadding(CSize size);

Paraméterek

size
A tabulátor ikonja és címkéje körüli térközt (kitöltést) állítja be egy tabulátor vezérlőelemben.

CTabCtrl::SetToolTips

Eszköztipp-vezérlőt rendel egy tabulátor vezérlőelemhez.

void SetToolTips(CToolTipCtrl* pWndTip);

Paraméterek

pWndTip
A szerszámhegy vezérlőjének fogópontja.

Megjegyzések

A tabulátor vezérlőelemhez tartozó eszköztipp-vezérlőt meghívhatja a következőre GetToolTips: .

példa

Lásd a példát a CPropertySheet::GetTabControl.

Lásd még

CWnd osztály
CHeaderCtrl osztály
CListCtrl osztály
hierarchiadiagram

  • Last updated on