CTabCtrl Sınıf

Windows ortak sekme denetiminin işlevselliğini sağlar.

Sözdizimi

class CTabCtrl : public CWnd

Üyeler

Ortak oluşturucular

Veri Akışı Adı	Açıklama
CTabCtrl::CTabCtrl	Bir CTabCtrl nesne oluşturur.

Genel yöntemler

Veri Akışı Adı	Açıklama
CTabCtrl::AdjustRect	Bir pencere dikdörtgeni verilip sekme denetiminin görüntüleme alanını hesaplar veya belirli bir görüntüleme alanına karşılık gelen pencere dikdörtgenini hesaplar.
CTabCtrl::Create	Sekme denetimi oluşturur ve bir nesnenin TabCtrl örneğine ekler
CTabCtrl::CreateEx	Belirtilen Windows genişletilmiş stilleriyle bir sekme denetimi oluşturur ve bunu bir CTabCtrl nesnenin örneğine ekler.
CTabCtrl::DeleteAllItems	Sekme denetimindeki tüm öğeleri kaldırır.
CTabCtrl::DeleteItem	Sekme denetiminden bir öğeyi kaldırır.
CTabCtrl::DeselectAll	Sekme denetimindeki öğeleri sıfırlar ve basılan öğeleri temizler.
CTabCtrl::DrawItem	Sekme denetiminin belirtilen bir öğesini çizer.
CTabCtrl::GetCurFocus	Sekme denetiminin geçerli odağına sahip sekmeyi alır.
CTabCtrl::GetCurSel	Sekme denetiminde seçili durumdaki sekmeyi belirler.
CTabCtrl::GetExtendedStyle	Sekme denetimi için kullanılmakta olan genişletilmiş stilleri alır.
CTabCtrl::GetImageList	Sekme denetimiyle ilişkili görüntü listesini alır.
CTabCtrl::GetItem	Sekme denetimindeki bir sekme hakkındaki bilgileri alır.
CTabCtrl::GetItemCount	Sekme denetimindeki sekme sayısını alır.
CTabCtrl::GetItemRect	Sekme denetimindeki bir sekme için sınırlayıcı dikdörtgeni alır.
CTabCtrl::GetItemState	Belirtilen sekme denetim öğesinin durumunu alır.
CTabCtrl::GetRowCount	Bir sekme denetimindeki geçerli sekme satır sayısını alır.
CTabCtrl::GetToolTips	Sekme denetimiyle ilişkili araç ipucu denetiminin tutamacını alır.
CTabCtrl::HighlightItem	Sekme öğesinin vurgu durumunu ayarlar.
CTabCtrl::HitTest	Varsa, hangi sekmenin belirtilen ekran konumunda olduğunu belirler.
CTabCtrl::InsertItem	Sekme denetimine yeni bir sekme ekler.
CTabCtrl::RemoveImage	Sekme denetiminin görüntü listesinden bir görüntüyü kaldırır.
CTabCtrl::SetCurFocus	Odağı, sekme denetiminde belirtilen bir sekmeye ayarlar.
CTabCtrl::SetCurSel	Sekme denetimindeki bir sekmeyi seçer.
CTabCtrl::SetExtendedStyle	Sekme denetimi için genişletilmiş stilleri ayarlar.
CTabCtrl::SetImageList	Sekme denetimine bir resim listesi atar.
CTabCtrl::SetItem	Sekmenin özniteliklerinin bazılarını veya tümünü ayarlar.
CTabCtrl::SetItemExtra	Sekme denetiminde uygulama tanımlı veriler için ayrılmış sekme başına bayt sayısını ayarlar.
CTabCtrl::SetItemSize	Öğenin genişliğini ve yüksekliğini ayarlar.
CTabCtrl::SetItemState	Belirtilen sekme denetim öğesinin durumunu ayarlar.
CTabCtrl::SetMinTabWidth	Sekme denetimindeki öğelerin en düşük genişliğini ayarlar.
CTabCtrl::SetPadding	Bir sekme denetimindeki her sekme simgesinin ve etiketin etrafındaki boşluk miktarını (doldurma) ayarlar.
CTabCtrl::SetToolTips	Sekme denetimine bir araç ipucu denetimi atar.

Açıklamalar

"Sekme denetimi", not defterindeki ayırıcılara veya dosya dolabındaki etiketlere benzer. Bir uygulama, sekme denetimi kullanarak bir pencerenin veya iletişim kutusunun aynı alanı için birden çok sayfa tanımlayabilir. Her sayfa, kullanıcı ilgili sekmeyi seçtiğinde uygulamanın görüntülediği bir dizi bilgi veya denetimden oluşur. Özel bir sekme denetimi türü, düğmelere benzeyen sekmeleri görüntüler. Bir düğmeye tıklanması, sayfayı görüntülemek yerine hemen bir komut gerçekleştirmelidir.

Bu denetim (ve dolayısıyla CTabCtrl sınıfı) yalnızca Windows 95/98 ve Windows NT sürüm 3.51 ve üzeri altında çalışan programlarda kullanılabilir.

hakkında CTabCtrldaha fazla bilgi için bkz. Denetimler ve Kullanma CTabCtrl.

Devralma hiyerarşisi

CObject
CCmdTarget
CWnd

CTabCtrl

Gereksinimler

Üstbilgi: afxcmn.h

CTabCtrl::AdjustRect

Bir pencere dikdörtgeni verilip sekme denetiminin görüntüleme alanını hesaplar veya belirli bir görüntüleme alanına karşılık gelen pencere dikdörtgenini hesaplar.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Parametreler

bLarger
Hangi işlemin gerçekleştirildiğini gösterir. Bu parametre ise TRUE, lpRect bir görüntü dikdörtgeni belirtir ve ilgili pencere dikdörtgenini alır. Bu parametre ise FALSE, lpRect bir pencere dikdörtgeni belirtir ve ilgili görüntü dikdörtgenini alır.

lpRect
Verilen dikdörtgeni belirten ve hesaplanan dikdörtgeni alan bir RECT yapı işaretçisi.

Örnek

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

Sekme denetimi oluşturur ve bir nesnenin CTabCtrl örneğine ekler.

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

Parametreler

dwStyle
Sekme denetiminin stilini belirtir. Windows SDK'sında açıklanan sekme denetimi stillerinin herhangi bir bileşimini uygulayın. Denetime uygulayabileceğiniz pencere stillerinin listesi için açıklamalar bölümüne bakın.

rect
Sekme denetiminin boyutunu ve konumunu belirtir. Nesne veya RECT yapı olabilirCRect.

pParentWnd
Sekme denetiminin üst penceresini ( genellikle bir CDialog) belirtir. Bu olmamalıdır NULL.

nID
Sekme denetiminin kimliğini belirtir.

Dönüş Değeri

TRUE nesnenin başlatılması başarılı olursa; aksi takdirde FALSE.

Açıklamalar

İki adımda bir CTabCtrl nesne oluşturursunuz. İlk olarak oluşturucuyu çağırın ve sonra sekme denetimini oluşturan ve nesnesine ekleyen öğesini çağırınCreateCTabCtrl.

Sekme denetimi stillerine ek olarak, bir sekme denetimine aşağıdaki pencere stillerini uygulayabilirsiniz:

• WS_CHILD: Sekme denetimini temsil eden bir alt pencere oluşturur. WS_POPUP stiliyle kullanılamaz.
• WS_VISIBLE: Başlangıçta görünen bir sekme denetimi oluşturur.
• WS_DISABLED: Başlangıçta devre dışı bırakılmış bir pencere oluşturur.
• WS_GROUP: Kullanıcının ok tuşlarıyla bir denetimden diğerine geçebileceği bir denetim grubunun ilk denetimini belirtir. İlk denetimden WS_GROUPsonra ile tanımlanan tüm denetimler: stili aynı gruba aittir. : stiline WS_GROUPsahip sonraki denetim, stil grubunu sonlandırır ve sonraki grubu başlatır (diğer bir ifadeyle, bir grup bir sonrakinin başladığı yerde biter).
• WS_TABSTOP: Kullanıcının SEKME tuşunu kullanarak taşıyabileceği herhangi bir sayıda denetimden birini belirtir. SEKME tuşu, kullanıcıyı : stiliyle belirtilen sonraki denetime WS_TABSTOPtaşır.

Genişletilmiş pencere stilleriyle sekme denetimi oluşturmak için yerine öğesini çağırın CTabCtrl::CreateEx Create.

Örnek

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

Bir denetim (alt pencere) oluşturur ve bunu nesnesiyle CTabCtrl ilişkilendirir.

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

Parametreler

dwExStyle
Oluşturulan denetimin genişletilmiş stilini belirtir. Genişletilmiş Windows stillerinin listesi için Windows SDK'sında parametresine CreateWindowEx bakındwExStyle.

dwStyle
Sekme denetiminin stilini belirtir. Windows SDK'sında açıklanan sekme denetimi stillerinin herhangi bir bileşimini uygulayın. Denetime Create uygulayabileceğiniz pencere stillerinin listesi için içindeki açıklamalar bölümüne bakın.

rect
oluşturulacak pencerenin boyutunu ve konumunu istemci koordinatlarında pParentWndaçıklayan bir RECT yapı başvurusu.

pParentWnd
Denetimin üst öğesi olan pencere işaretçisi.

nID
Denetimin alt pencere kimliği.

Dönüş Değeri

Aksi takdirde başarılı olursa sıfır olmayan 0.

Açıklamalar

Create Yerine, Windows genişletilmiş stil ön biçimi WS_EX_tarafından belirtilen genişletilmiş Windows stilleri uygulamak için kullanınCreateEx.

CreateEx tarafından dwExStylebelirtilen genişletilmiş Windows stilleriyle denetimi oluşturur. kullanarak SetExtendedStylebir denetime özgü genişletilmiş stilleri ayarlayın. Örneğin, gibi WS_EX_CONTEXTHELPstilleri ayarlamak için kullanınCreateEx, ancak gibi TCS_EX_FLATSEPARATORSstilleri ayarlamak için kullanınSetExtendedStyle. Daha fazla bilgi için Windows SDK'sında Sekme Denetimi Genişletilmiş Stilleri'nde açıklanan stiller bölümüne bakın.

CTabCtrl::CTabCtrl

Bir CTabCtrl nesne oluşturur.

CTabCtrl();

CTabCtrl::DeleteAllItems

Sekme denetimindeki tüm öğeleri kaldırır.

BOOL DeleteAllItems();

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

CTabCtrl::DeleteItem

Belirtilen öğeyi sekme denetiminden kaldırır.

BOOL DeleteItem(int nItem);

Parametreler

nItem
Silinecek öğenin sıfır tabanlı değeri.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Örnek

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

Sekme denetimindeki öğeleri sıfırlar ve basılan öğeleri temizler.

void DeselectAll(BOOL fExcludeFocus);

Parametreler

fExcludeFocus
Öğe silme işleminin kapsamını belirten bayrak. Bu parametre olarak FALSEayarlanırsa, tüm sekme düğmeleri sıfırlanır. olarak ayarlandıysa TRUE, o anda seçili olan dışındaki tüm sekme öğeleri sıfırlanır.

Açıklamalar

Bu üye işlevi, TCM_DESELECTALLWindows SDK'da açıklandığı gibi Win32 iletisinin davranışını uygular.

CTabCtrl::DrawItem

Sahip çizim sekme denetiminin görsel bir yönü değiştiğinde çerçeve tarafından çağrılır.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parametreler

lpDrawItemStruct
Boyanacak öğeyi açıklayan bir DRAWITEMSTRUCT yapı işaretçisi.

Açıklamalar

Yapının itemAction üyesi DRAWITEMSTRUCT , yapılacak çizim eylemini tanımlar.

Varsayılan olarak, bu üye işlevi hiçbir şey yapmaz. Sahip çizim CTabCtrl nesnesi için çizim uygulamak için bu üye işlevini geçersiz kılın.

Uygulama, bu üye işlevi sonlanmadan önce içinde lpDrawItemStruct sağlanan görüntü bağlamı için seçilen tüm grafik cihaz arabirimi (GDI) nesnelerini geri yüklemelidir.

CTabCtrl::GetCurFocus

Geçerli odakla sekmenin dizinini alır.

int GetCurFocus() const;

Dönüş Değeri

Geçerli odağı olan sekmenin sıfır tabanlı dizini.

CTabCtrl::GetCurSel

Bir sekme denetiminde seçili durumdaki sekmeyi alır.

int GetCurSel() const;

Dönüş Değeri

Başarılı olursa seçili sekmenin sıfır tabanlı dizini veya seçili sekme yoksa -1.

CTabCtrl::GetExtendedStyle

Sekme denetimi için kullanılmakta olan genişletilmiş stilleri alır.

DWORD GetExtendedStyle();

Dönüş Değeri

Sekme denetimi için kullanılmakta olan genişletilmiş stilleri temsil eder. Bu değer, Windows SDK'da açıklandığı gibi sekme denetimi genişletilmiş stillerinin bir bileşimidir.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TCM_GETEXTENDEDSTYLEdavranışını uygular.

CTabCtrl::GetImageList

Sekme denetimiyle ilişkili görüntü listesini alır.

CImageList* GetImageList() const;

Dönüş Değeri

Başarılı olursa, sekme denetiminin görüntü listesinin işaretçisi; aksi takdirde , NULL.

CTabCtrl::GetItem

Sekme denetimindeki bir sekme hakkındaki bilgileri alır.

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

Parametreler

nItem
Sekmenin sıfır tabanlı dizini.

pTabCtrlItem
Alınacak bilgileri belirtmek için kullanılan bir TCITEM yapı işaretçisi. Sekme hakkında bilgi almak için de kullanılır. Bu yapı , GetItemve SetItem üye işlevleriyle InsertItembirlikte kullanılır.

Dönüş Değeri

Başarılı olursa döndürür TRUE ; FALSE aksi takdirde.

Açıklamalar

İleti gönderildiğinde, mask üye döndürülecek öznitelikleri belirtir. mask Üye değeri belirtirseTCIF_TEXT, pszText üye öğe metnini alan arabelleğin adresini içermeli ve cchTextMax üye arabellek boyutunu belirtmelidir.

• mask

  Hangi TCITEM yapı üyelerinin alınacağını veya ayarlandığını belirten değer. Bu üye sıfır veya aşağıdaki değerlerin birleşimi olabilir:

  • TCIF_TEXT: Üye pszText geçerli.
  • TCIF_IMAGE: Üye iImage geçerli.
  • TCIF_PARAM: Üye lParam geçerli.
  • TCIF_RTLREADING: metni pszText İbranice veya Arapça sistemlerde sağdan sola okuma sırası kullanılarak görüntülenir.
  • TCIF_STATE: Üye dwState geçerli.

• pszText

  Yapı bir sekme hakkında bilgi içeriyorsa, sekme metnini içeren null olarak sonlandırılan bir dizenin işaretçisi. Yapı bilgi alıyorsa, bu üye sekme metnini alan arabelleğin adresini belirtir.

• cchTextMax

  tarafından pszTextişaret edilen arabelleğin boyutu. Yapı bilgi almıyorsa bu üye yoksayılır.

• iImage Sekme denetiminin görüntü listesinde dizin oluşturun veya sekme için görüntü yoksa -1.

• lParam

  Sekmeyle ilişkili uygulama tanımlı veriler. Sekme başına 4 bayttan fazla uygulama tanımlı veri varsa, uygulamanın bir yapı tanımlaması ve yapı yerine TCITEM bunu kullanması gerekir. Uygulama tanımlı yapının ilk üyesi bir TCITEMHEADERyapı olmalıdır. Yapı TCITEMHEADER , üye olmadan yapıyla TCITEM lParam aynıdır. Yapınızın boyutu ile yapı boyutu TCITEMHEADER arasındaki fark, sekme başına fazladan bayt sayısına eşit olmalıdır.

Örnek

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

Sekme denetimindeki sekme sayısını alır.

int GetItemCount() const;

Dönüş Değeri

Sekme denetimindeki öğe sayısı.

Örnek

örneğine CPropertySheet::GetTabControlbakın.

CTabCtrl::GetItemRect

Bir sekme denetiminde belirtilen sekme için sınırlayıcı dikdörtgeni alır.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Parametreler

nItem
Sekme öğesinin sıfır tabanlı dizini.

lpRect
Sekmenin sınırlayıcı dikdörtgenini alan bir RECT yapı işaretçisi. Bu koordinatlar görünüm penceresi geçerli eşleme modunu kullanır.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Örnek

örneğine CPropertySheet::GetTabControlbakın.

CTabCtrl::GetItemState

tarafından nItemtanımlanan sekme denetim öğesinin durumunu alır.

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Parametreler

nItem
Durum bilgilerinin alındığı öğenin sıfır tabanlı dizin numarası.

dwMask
Öğenin durum bayraklarından hangilerinin döndürüleceğini belirten maske. Değerlerin listesi için, Windows SDK'da açıklandığı gibi yapının maske üyesine TCITEM bakın.

Dönüş Değeri

Durum bilgilerini alan bir DWORD değerine başvuru. Aşağıdaki değerlerden biri olabilir:

Value	Açıklama
TCIS_BUTTONPRESSED	Sekme denetim öğesi seçilidir.
TCIS_HIGHLIGHTED	Sekme denetim öğesi vurgulanır ve sekme ve metin geçerli vurgu rengi kullanılarak çizilir. Vurgu rengi kullanılırken bu, titrek bir renk değil, gerçek bir ilişkilendirme olacaktır.

Açıklamalar

Öğenin durumu, yapı üyesi TCITEM tarafından dwState belirtilir.

CTabCtrl::GetRowCount

Sekme denetimindeki geçerli satır sayısını alır.

int GetRowCount() const;

Dönüş Değeri

Sekme denetimindeki sekme satırlarının sayısı.

Açıklamalar

Yalnızca stili olan TCS_MULTILINE sekme denetimlerinde birden çok sekme satırı olabilir.

CTabCtrl::GetToolTips

Sekme denetimiyle ilişkili araç ipucu denetiminin tutamacını alır.

CToolTipCtrl* GetToolTips() const;

Dönüş Değeri

Başarılı olursa araç ipucu denetiminin tutamacı; aksi takdirde NULL.

Açıklamalar

Sekme denetimi, stile sahipse TCS_TOOLTIPS bir araç ipucu denetimi oluşturur. Üye işlevini kullanarak SetToolTips sekme denetimine bir araç ipucu denetimi de atayabilirsiniz.

CTabCtrl::HighlightItem

Sekme öğesinin vurgu durumunu ayarlar.

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

Parametreler

idItem
Sekme denetim öğesinin sıfır tabanlı dizini.

fHighlight
Ayarlanacak vurgu durumunu belirten değer. Bu değer ise TRUE, sekme vurgulanır; ise FALSE, sekme varsayılan durumuna ayarlanır.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisini TCM_HIGHLIGHTITEMuygular.

CTabCtrl::HitTest

Varsa, hangi sekmenin belirtilen ekran konumunda olduğunu belirler.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Parametreler

pHitTestInfo
Windows SDK'sında açıklandığı gibi, test etmek için ekran konumunu belirten bir TCHITTESTINFO yapı işaretçisi.

Dönüş Değeri

Sekmenin sıfır tabanlı dizinini veya belirtilen konumda sekme yoksa -1'i döndürür.

CTabCtrl::InsertItem

Var olan bir sekme denetimine yeni bir sekme ekler.

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

Parametreler

nItem
Yeni sekmenin sıfır tabanlı dizini.

pTabCtrlItem
Sekmenin özniteliklerini belirten bir TCITEM yapı işaretçisi.

lpszItem
Sekme metnini içeren null olarak sonlandırılan dizenin adresi.

nImage
Görüntü listesinden eklenecek görüntünün sıfır tabanlı dizini.

nMask
Ayarlanacağı TCITEM yapı özniteliklerini belirtir. Sıfır veya aşağıdaki değerlerin birleşimi olabilir:

• TCIF_TEXT: Üye pszText geçerli.
• TCIF_IMAGE: Üye iImage geçerli.
• TCIF_PARAM: Üye lParam geçerli.
• TCIF_RTLREADING: metni pszText İbranice veya Arapça sistemlerde sağdan sola okuma sırası kullanılarak görüntülenir.
• TCIF_STATE: Üye dwState geçerli.

lParam
Sekmeyle ilişkili uygulama tanımlı veriler.

dwState
Öğenin durumlarının değerlerini belirtir. Daha fazla bilgi için bkz TCITEM . Windows SDK'sı.

dwStateMask
Hangi durumların ayarlandığını belirtir. Daha fazla bilgi için bkz TCITEM . Windows SDK'sı.

Dönüş Değeri

Başarılı olursa yeni sekmenin sıfır tabanlı dizini; aksi takdirde -1.

Örnek

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

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Belirtilen görüntüyü sekme denetiminin görüntü listesinden kaldırır.

void RemoveImage(int nImage);

Parametreler

nImage
Kaldırılacak görüntünün sıfır tabanlı dizini.

Açıklamalar

Sekme denetimi, her sekmenin görüntü dizinini güncelleştirir, böylece her sekme aynı görüntüyle ilişkili kalır.

CTabCtrl::SetCurFocus

Odağı, sekme denetiminde belirtilen bir sekmeye ayarlar.

void SetCurFocus(int nItem);

Parametreler

nItem
Odağı alan sekmenin dizinini belirtir.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TCM_SETCURFOCUSdavranışını uygular.

CTabCtrl::SetCurSel

Sekme denetimindeki bir sekmeyi seçer.

int SetCurSel(int nItem);

Parametreler

nItem
Seçilecek öğenin sıfır tabanlı dizini.

Dönüş Değeri

Başarılı olursa önceden seçilen sekmenin sıfır tabanlı dizini, aksi takdirde -1.

Açıklamalar

Bu işlev kullanılarak bir TCN_SELCHANGING sekme seçildiğinde sekme denetimi veya TCN_SELCHANGE bildirim iletisi göndermez. Bu bildirimler, WM_NOTIFYkullanıcı sekmeleri değiştirmek için klavyeye tıkladığında veya kullandığında kullanılarak gönderilir.

CTabCtrl::SetExtendedStyle

Sekme denetimi için genişletilmiş stilleri ayarlar.

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

Parametreler

dwNewStyle
Sekme denetimi genişletilmiş stillerinin birleşimini belirten değer.

dwExMask
Hangi stillerin dwNewStyle etkileneceğini gösteren DWORD değeri. Yalnızca içindeki dwExMask genişletilmiş stiller değiştirilir. Diğer tüm stiller olduğu gibi korunur. Bu parametre sıfırsa içindeki tüm stiller dwNewStyle etkilenir.

Dönüş Değeri

Windows SDK'da açıklandığı gibi, önceki sekme denetimi genişletilmiş stillerini içeren bir DWORD değeri.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TCM_SETEXTENDEDSTYLEdavranışını uygular.

CTabCtrl::SetImageList

Sekme denetimine bir resim listesi atar.

CImageList* SetImageList(CImageList* pImageList);

Parametreler

pImageList
Sekme denetimine atanacak resim listesinin işaretçisi.

Dönüş Değeri

Önceki resim listesine veya NULL önceki görüntü listesi yoksa bir işaretçi döndürür.

CTabCtrl::SetItem

Sekmenin özniteliklerinin bazılarını veya tümünü ayarlar.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Parametreler

nItem
Öğenin sıfır tabanlı dizini.

pTabCtrlItem
Yeni öğe özniteliklerini içeren bir TCITEM yapıya yönelik işaretçi. mask Üye, ayarlanacağı öznitelikleri belirtir. mask Üye değeri belirtirseTCIF_TEXT, pszText üye null olarak sonlandırılan dizenin adresidir ve cchTextMax üye yoksayılır.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Örnek

örneğine GetItembakın.

CTabCtrl::SetItemExtra

Sekme denetiminde uygulama tanımlı veriler için ayrılmış sekme başına bayt sayısını ayarlar.

BOOL SetItemExtra(int nBytes);

Parametreler

nBytes
Ayarlanacağı fazladan bayt sayısı.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TCM_SETITEMEXTRAdavranışını uygular.

CTabCtrl::SetItemSize

Sekme denetim öğelerinin genişliğini ve yüksekliğini ayarlar.

CSize SetItemSize(CSize size);

Parametreler

size
Sekme denetim öğelerinin piksel cinsinden yeni genişliği ve yüksekliği.

Dönüş Değeri

Sekme denetim öğelerinin eski genişliğini ve yüksekliğini döndürür.

CTabCtrl::SetItemState

tarafından nItemtanımlanan sekme denetim öğesinin durumunu ayarlar.

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

Parametreler

nItem
Durum bilgilerinin ayarlanacağı öğenin sıfır tabanlı dizin numarası.

dwMask
Öğenin durum bayraklarından hangisinin ayarlandığını belirten maske. Değerlerin listesi için, Windows SDK'da açıklandığı gibi yapının maske üyesine TCITEM bakın.

dwState
Durum bilgilerini içeren bir DWORD değerine başvuru. Aşağıdaki değerlerden biri olabilir:

Value	Açıklama
TCIS_BUTTONPRESSED	Sekme denetim öğesi seçilidir.
TCIS_HIGHLIGHTED	Sekme denetim öğesi vurgulanır ve sekme ve metin geçerli vurgu rengi kullanılarak çizilir. Vurgu rengi kullanılırken bu, titrek bir renk değil, gerçek bir ilişkilendirme olacaktır.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

CTabCtrl::SetMinTabWidth

Sekme denetimindeki öğelerin en düşük genişliğini ayarlar.

int SetMinTabWidth(int cx);

Parametreler

cx
Sekme denetim öğesi için ayarlanacak en düşük genişlik. Bu parametre -1 olarak ayarlanırsa, denetim varsayılan sekme genişliğini kullanır.

Dönüş Değeri

Önceki en düşük sekme genişliği.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TCM_SETMINTABWIDTHdavranışını uygular.

CTabCtrl::SetPadding

Bir sekme denetiminde her sekmenin simgesinin ve etiketinin etrafındaki boşluk miktarını (doldurma) ayarlar.

void SetPadding(CSize size);

Parametreler

size
Bir sekme denetiminde her sekmenin simgesinin ve etiketinin etrafındaki boşluk miktarını (doldurma) ayarlar.

CTabCtrl::SetToolTips

Sekme denetimine bir araç ipucu denetimi atar.

void SetToolTips(CToolTipCtrl* pWndTip);

Parametreler

pWndTip
Araç ipucu denetiminin tutamacı.

Açıklamalar

öğesine çağrı GetToolTipsyaparak sekme denetimiyle ilişkili araç ipucu denetimini alabilirsiniz.

Örnek

örneğine CPropertySheet::GetTabControlbakın.

Ayrıca bkz.

CWnd Sınıf
CHeaderCtrl Sınıf
CListCtrl Sınıf
Hiyerarşi Grafiği