`CTabCtrl` 類別

發行項
06/16/2023

提供 Windows 通用索引標籤控制項的功能。

語法

class CTabCtrl : public CWnd

成員

公用建構函式

名稱	描述
`CTabCtrl::CTabCtrl`	建構 `CTabCtrl` 物件。

公用方法

名稱	描述
`CTabCtrl::AdjustRect`	計算指定視窗矩形的索引標籤控制項顯示區域，或計算對應至指定顯示區域的視窗矩形。
`CTabCtrl::Create`	建立索引標籤控制項並將它附加至物件的實例 `TabCtrl`
`CTabCtrl::CreateEx`	使用指定的 Windows 擴充樣式建立索引標籤控制項，並將它附加至物件的實例 `CTabCtrl` 。
`CTabCtrl::DeleteAllItems`	從索引標籤控制項移除所有專案。
`CTabCtrl::DeleteItem`	從索引標籤控制項移除專案。
`CTabCtrl::DeselectAll`	重設 Tab 控制項中的專案，清除已按下的任何專案。
`CTabCtrl::DrawItem`	繪製索引標籤控制項的指定專案。
`CTabCtrl::GetCurFocus`	擷取具有索引標籤控制項目前焦點的索引標籤。
`CTabCtrl::GetCurSel`	決定索引標籤控制項中目前選取的索引標籤。
`CTabCtrl::GetExtendedStyle`	擷取目前用於索引標籤控制項的延伸樣式。
`CTabCtrl::GetImageList`	擷取與索引標籤控制項相關聯的影像清單。
`CTabCtrl::GetItem`	擷取索引標籤控制項中索引標籤的相關資訊。
`CTabCtrl::GetItemCount`	擷取索引標籤控制項中的索引標籤數目。
`CTabCtrl::GetItemRect`	擷取索引標籤控制項中索引標籤的周框。
`CTabCtrl::GetItemState`	擷取指示之索引標籤控制項專案的狀態。
`CTabCtrl::GetRowCount`	擷取索引標籤控制項中目前索引標籤的資料列數目。
`CTabCtrl::GetToolTips`	擷取與索引標籤控制項相關聯的工具提示控制項控制碼。
`CTabCtrl::HighlightItem`	設定索引標籤專案的醒目提示狀態。
`CTabCtrl::HitTest`	判斷哪個索引標籤，如果有的話，位於指定的螢幕位置。
`CTabCtrl::InsertItem`	在索引標籤控制項中插入新的索引標籤。
`CTabCtrl::RemoveImage`	從索引標籤控制項的影像清單中移除影像。
`CTabCtrl::SetCurFocus`	將焦點設定為索引標籤控制項中的指定索引標籤。
`CTabCtrl::SetCurSel`	選取索引標籤控制項中的索引標籤。
`CTabCtrl::SetExtendedStyle`	設定索引標籤控制項的延伸樣式。
`CTabCtrl::SetImageList`	將影像清單指派給索引標籤控制項。
`CTabCtrl::SetItem`	設定索引標籤的部分或所有屬性。
`CTabCtrl::SetItemExtra`	設定索引標籤控制項中針對應用程式定義資料保留的每個索引標籤位元組數目。
`CTabCtrl::SetItemSize`	設定專案的寬度和高度。
`CTabCtrl::SetItemState`	設定指示之索引標籤控制項專案的狀態。
`CTabCtrl::SetMinTabWidth`	設定索引標籤控制項中專案的最小寬度。
`CTabCtrl::SetPadding`	設定索引標籤控制項中每個索引標籤圖示和標籤周圍的空間量（填補）。
`CTabCtrl::SetToolTips`	將工具提示控制項指派給索引標籤控制項。

備註

「索引標籤控制項」類似于筆記本中的分隔符號或檔案櫃中的標籤。藉由使用索引標籤控制項，應用程式可以定義視窗或對話方塊中同一個區域的多個頁面。每一頁都包含一組資訊或應用程式在使用者選取對應索引標籤時所顯示的控制項群組。特殊類型的索引標籤控制項會顯示看起來像按鈕的索引標籤。按一下按鈕應該會立即執行命令，而不是顯示頁面。

此控制項（因此類別 CTabCtrl ）僅適用于在 Windows 95/98 和 Windows NT 3.51 版和更新版本下執行的程式。

如需的詳細資訊 CTabCtrl ，請參閱控制項和使用 CTabCtrl 。

繼承階層

CObject
CCmdTarget
CWnd

CTabCtrl

需求

標頭：afxcmn.h

`CTabCtrl::AdjustRect`

計算指定視窗矩形的索引標籤控制項顯示區域，或計算對應至指定顯示區域的視窗矩形。

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

參數

bLarger
指出要執行的作業。如果此參數為 TRUE ， lpRect 則指定顯示矩形，並接收對應的視窗矩形。如果此參數為 FALSE ， lpRect 則指定視窗矩形，並接收對應的顯示矩形。

lpRect
RECT指定指定矩形並接收匯出矩形之結構的指標。

範例

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`

建立索引標籤控制項，並將它附加至物件的實例 CTabCtrl 。

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

參數

dwStyle
指定索引標籤控制項的樣式。套用 Windows SDK 中所述之索引標籤控制項樣式的任何組合。如需您也可以套用至控制項的視窗樣式清單，請參閱 < 備註>。

rect
指定索引標籤控制項的大小和位置。它可以是 CRect 物件或 RECT 結構。

pParentWnd
指定索引標籤控制項的父視窗，通常是 CDialog 。它不得為 NULL 。

nID
指定索引標籤控制項的識別碼。

傳回值

TRUE 如果物件的初始化成功，則為 ;否則 FALSE 為。

備註

您會在兩個步驟中建構 CTabCtrl 物件。首先，呼叫建構函式，然後呼叫 Create ，這會建立索引標籤控制項並將它附加至 CTabCtrl 物件。

除了索引標籤控制項樣式之外，您還可以將下列視窗樣式套用至索引標籤控制項：

WS_CHILD：建立代表索引標籤控制項的子視窗。無法搭配WS_POPUP樣式使用。
WS_VISIBLE：建立一開始可見的索引標籤控制項。
WS_DISABLED：建立一開始停用的視窗。
WS_GROUP：指定控制項群組的第一個控制項，使用者可以使用方向鍵從一個控制項移至下一個控制項。使用 WS_GROUP ：樣式定義的所有控制項後，第一個控制項屬於相同的群組。下一個控制項與 WS_GROUP ：樣式結束樣式群組，並啟動下一個群組（也就是，下一個群組開始處結束）。
WS_TABSTOP：指定使用者可以使用 TAB 鍵移動的任意數目控制項之一。 TAB 鍵會將使用者移至：style 所 WS_TABSTOP 指定的下一個控制項。

若要建立具有延伸視窗樣式的 Create 索引標籤控制項，請呼叫 CTabCtrl::CreateEx 而非。

範例

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

建立控制項（子視窗），並將它與 CTabCtrl 物件產生關聯。

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

參數

dwExStyle
指定要建立之控制項的擴充樣式。如需擴充 Windows 樣式的清單，請參閱 dwExStyle Windows SDK 中的參數 CreateWindowEx 。

dwStyle
指定索引標籤控制項的樣式。套用 Windows SDK 中所述之索引標籤控制項樣式的任何組合。如需您也可以套用至控制項的視窗樣式清單，請參閱 中的 Create < 備註>。

rect
結構的參考 RECT ，描述要建立之視窗的大小和位置，在的用戶端座標中 pParentWnd 。

pParentWnd
控制項父系之視窗的指標。

nID
控制項的子視窗識別碼。

傳回值

如果成功則為非零，否則為 0。

備註

使用 CreateEx 而不是 Create 套用延伸的 Windows 樣式，由 Windows 擴充樣式前置詞 WS_EX_ 所指定。

CreateEx 使用所 dwExStyle 指定的擴充 Windows 樣式來建立控制項。使用 SetExtendedStyle 設定控制項特有的擴充樣式。例如，使用 CreateEx 來設定之類的樣式 WS_EX_CONTEXTHELP ，但使用 SetExtendedStyle 來設定這類樣式。 TCS_EX_FLATSEPARATORS 如需詳細資訊，請參閱 Windows SDK 中 Tab 控制項擴充樣式中所述的樣式。

`CTabCtrl::CTabCtrl`

建構 CTabCtrl 物件。

CTabCtrl();

`CTabCtrl::DeleteAllItems`

從索引標籤控制項移除所有專案。

BOOL DeleteAllItems();

傳回值

如果成功則為非零；否則為 0。

`CTabCtrl::DeleteItem`

從索引標籤控制項中移除指定的專案。

BOOL DeleteItem(int nItem);

參數

nItem
要刪除之專案的以零起始值。

傳回值

如果成功則為非零；否則為 0。

範例

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

重設 Tab 控制項中的專案，清除已按下的任何專案。

void DeselectAll(BOOL fExcludeFocus);

參數

fExcludeFocus
指定專案取消選取範圍的旗標。如果此參數設定為 FALSE ，則會重設所有索引標籤按鈕。如果設定為 TRUE ，則會重設目前選取的索引標籤專案以外的所有索引標籤專案。

備註

此成員函式會實作 Win32 訊息的行為， TCM_DESELECTALL 如 Windows SDK 中所述。

`CTabCtrl::DrawItem`

當擁有者繪製索引標籤控制項的視覺層面變更時，由架構呼叫。

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

參數

lpDrawItemStruct
結構的指標， DRAWITEMSTRUCT 描述要繪製的專案。

備註

結構 itemAction 的成員 DRAWITEMSTRUCT 會定義要執行的繪圖動作。

根據預設，此成員函式不會執行任何動作。覆寫這個成員函式，以實作擁有者繪製物件的繪圖 CTabCtrl 。

應用程式應該還原為此成員函式終止之前，針對所提供 lpDrawItemStruct 顯示內容選取的所有圖形裝置介面（GDI）物件。

`CTabCtrl::GetCurFocus`

擷取具有目前焦點之索引標籤的索引。

int GetCurFocus() const;

傳回值

具有目前焦點之索引標籤的以零起始的索引。

`CTabCtrl::GetCurSel`

擷取索引標籤控制項中目前選取的索引標籤。

int GetCurSel() const;

傳回值

如果成功，則為選取索引標籤的以零起始的索引，如果沒有選取索引標籤，則為 -1。

`CTabCtrl::GetExtendedStyle`

擷取目前用於索引標籤控制項的延伸樣式。

DWORD GetExtendedStyle();

傳回值

表示目前用於索引標籤控制項的擴充樣式。此值是 Tab 控制項擴充樣式的組合，如 Windows SDK 中所述。

備註

此成員函式會實作 Win32 訊息 TCM_GETEXTENDEDSTYLE 的行為，如 Windows SDK 中所述。

`CTabCtrl::GetImageList`

擷取與索引標籤控制項關聯的影像清單。

CImageList* GetImageList() const;

傳回值

如果成功，索引標籤控制項影像清單的指標;否則為 NULL 。

`CTabCtrl::GetItem`

擷取索引標籤控制項中索引標籤的相關資訊。

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

參數

nItem
索引標籤以零起始的索引。

pTabCtrlItem
TCITEM結構的指標，用來指定要擷取的資訊。也用來接收索引標籤的相關資訊。這個結構會與、 GetItem 和 SetItem 成員函式搭配 InsertItem 使用。

傳回值

如果成功，則傳 TRUE 回， FALSE 否則傳回。

備註

傳送訊息時， mask 成員會指定要傳回的屬性。 mask如果成員指定 TCIF_TEXT 值，成員 pszText 必須包含接收專案文字的緩衝區位址，而且 cchTextMax 成員必須指定緩衝區的大小。

mask

值，指定要擷取或設定的結構 TCITEM 成員。這個成員可以是零或下列值的組合：
- TCIF_TEXT：成員 pszText 有效。
- TCIF_IMAGE：成員 iImage 有效。
- TCIF_PARAM：成員 lParam 有效。
- TCIF_RTLREADING：的文字 pszText 會使用希伯來文或阿拉伯文系統上的由右至左讀取順序來顯示。
- TCIF_STATE：成員 dwState 有效。
pszText

如果結構包含索引標籤的相關資訊，則為包含索引標籤文字之 Null 終止字串的指標。如果結構正在接收資訊，這個成員會指定接收索引標籤文字之緩衝區的位址。
cchTextMax

所 pszText 指向之緩衝區的大小。如果結構未接收資訊，則會忽略這個成員。
iImage 索引到索引標籤控制項的影像清單，如果沒有索引標籤的影像，則為 -1。
lParam

與索引標籤相關聯的應用程式定義資料。如果每個索引標籤有超過 4 個位元組的應用程式定義資料，應用程式必須定義結構，並使用它，而不是 TCITEM 結構。應用程式定義結構的第一個 TCITEMHEADER 成員必須是結構。結構 TCITEMHEADER 與 TCITEM 結構相同，但沒有 lParam 成員。結構大小與結構大小 TCITEMHEADER 之間的差異應該等於每個索引標籤的額外位元組數目。

範例

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

擷取索引標籤控制項中的索引標籤數目。

int GetItemCount() const;

傳回值

索引標籤控制項中的專案數。

範例

請參閱的 CPropertySheet::GetTabControl 範例。

`CTabCtrl::GetItemRect`

擷取 Tab 控制項中指定索引標籤的周框。

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

參數

nItem
索引標籤專案的以零起始的索引。

lpRect
RECT接收索引標籤周框之結構的指標。這些座標會使用檢視區的目前對應模式。

傳回值

如果成功則為非零；否則為 0。

範例

請參閱的 CPropertySheet::GetTabControl 範例。

`CTabCtrl::GetItemState`

擷取所 nItem 識別之索引標籤控制項專案的狀態。

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

參數

nItem
要為其擷取狀態資訊之專案的以零起始的索引編號。

dwMask
遮罩，指定要傳回的專案狀態旗標。如需值清單，請參閱結構的遮罩成員 TCITEM ，如 Windows SDK 中所述。

傳回值

接收狀態資訊的 DWORD 值參考。可以是下列值之一：

值	Description
`TCIS_BUTTONPRESSED`	已選取索引標籤控制項專案。
`TCIS_HIGHLIGHTED`	索引標籤控制項專案會反白顯示，並使用目前的醒目提示色彩繪製索引標籤和文字。使用醒目提示色彩時，這會是真正的插補點，而不是重複的色彩。

備註

專案的狀態是由 dwState 結構的成員 TCITEM 所指定。

`CTabCtrl::GetRowCount`

擷取索引標籤控制項中目前的資料列數目。

int GetRowCount() const;

傳回值

索引標籤控制項中的索引標籤列數。

備註

只有具有樣式的 TCS_MULTILINE 索引標籤控制項可以有多個索引標籤資料列。

`CTabCtrl::GetToolTips`

擷取與索引標籤控制項相關聯的工具提示控制項控制碼。

CToolTipCtrl* GetToolTips() const;

傳回值

如果成功，工具提示控制項的控制碼;否則 NULL 為。

備註

如果索引標籤控制項具有樣式， TCS_TOOLTIPS 則會建立工具提示控制項。您也可以使用 SetToolTips 成員函式，將工具提示控制項指派給索引標籤控制項。

`CTabCtrl::HighlightItem`

設定索引標籤專案的醒目提示狀態。

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

參數

idItem
索引標籤控制項專案的以零起始的索引。

fHighlight
值，指定要設定的醒目提示狀態。如果此值為 TRUE ，則會反白顯示索引標籤;如果 FALSE 為，則索引標籤會設定為其預設狀態。

傳回值

如果成功則不為零，否則為 0。

備註

此成員函式會實作 Win32 訊息 TCM_HIGHLIGHTITEM ，如 Windows SDK 中所述。

`CTabCtrl::HitTest`

判斷哪個索引標籤，如果有的話，位於指定的螢幕位置。

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

參數

pHitTestInfo
TCHITTESTINFO結構的指標，如 Windows SDK 中所述，它會指定要測試的螢幕位置。

傳回值

如果沒有索引標籤位於指定的位置，則傳回以零起始的索引標籤或 -1。

`CTabCtrl::InsertItem`

在現有的索引標籤控制項中插入新的索引標籤。

LONG InsertItem(
    int nItem,
    TCITEM* pTabCtrlItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam,
    DWORD dwState,
    DWORD dwStateMask);

參數

nItem
以零起始的新索引標籤。

pTabCtrlItem
TCITEM指定索引標籤屬性之結構的指標。

lpszItem
包含索引標籤文字之 Null 終止字串的位址。

nImage
要從影像清單插入之影像之以零起始的索引。

nMask
指定要設定的結構 TCITEM 屬性。可以是零或下列值的組合：

TCIF_TEXT：成員 pszText 有效。
TCIF_IMAGE：成員 iImage 有效。
TCIF_PARAM：成員 lParam 有效。
TCIF_RTLREADING：的文字 pszText 會使用希伯來文或阿拉伯文系統上的由右至左讀取順序來顯示。
TCIF_STATE：成員 dwState 有效。

lParam
與索引標籤相關聯的應用程式定義資料。

dwState
指定專案狀態的值。如需詳細資訊，請參閱 TCITEM Windows SDK 中的。

dwStateMask
指定要設定的狀態。如需詳細資訊，請參閱 TCITEM Windows SDK 中的。

傳回值

如果成功，則為新索引標籤的以零起始的索引;否則為 -1。

範例

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

m_TabCtrl.InsertItem(0, &tcItem);

`CTabCtrl::RemoveImage`

從索引標籤控制項的影像清單中移除指定的影像。

void RemoveImage(int nImage);

參數

nImage
要移除之影像的以零起始的索引。

備註

索引標籤控制項會更新每個索引標籤的影像索引，讓每個索引標籤維持與相同影像的關聯。

`CTabCtrl::SetCurFocus`

將焦點設定為索引標籤控制項中的指定索引標籤。

void SetCurFocus(int nItem);

參數

nItem
指定取得焦點之索引標籤的索引。

備註

此成員函式會實作 Win32 訊息 TCM_SETCURFOCUS 的行為，如 Windows SDK 中所述。

`CTabCtrl::SetCurSel`

選取索引標籤控制項中的索引標籤。

int SetCurSel(int nItem);

參數

nItem
要選取之專案之以零起始的索引。

傳回值

如果成功，則為先前選取索引標籤的以零起始的索引，否則為 -1。

備註

使用這個函式選取索引標籤時，索引標籤控制項不會傳送 TCN_SELCHANGING 或 TCN_SELCHANGE 通知訊息。當使用者按一下或使用鍵盤變更索引標籤時，會使用 WM_NOTIFY 傳送這些通知。

`CTabCtrl::SetExtendedStyle`

設定索引標籤控制項的延伸樣式。

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

參數

dwNewStyle
值，指定索引標籤控制項延伸樣式的組合。

dwExMask
DWORD 值，指出中要受影響的樣式 dwNewStyle 。只會變更中的 dwExMask 擴充樣式。所有其他樣式都會維持不變。如果此參數為零，則中的所有 dwNewStyle 樣式都會受到影響。

傳回值

包含上一個索引標籤控制項擴充樣式的 DWORD 值，如 Windows SDK 中所述。

備註

此成員函式會實作 Win32 訊息 TCM_SETEXTENDEDSTYLE 的行為，如 Windows SDK 中所述。

`CTabCtrl::SetImageList`

將影像清單指派給索引標籤控制項。

CImageList* SetImageList(CImageList* pImageList);

參數

pImageList
要指派給索引標籤控制項之影像清單的指標。

傳回值

傳回上一個影像清單的指標， NULL 如果沒有上一個影像清單，則傳回指標。

`CTabCtrl::SetItem`

設定索引標籤的部分或所有屬性。

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

參數

nItem
專案以零起始的索引。

pTabCtrlItem
TCITEM包含新專案屬性之結構的指標。成員 mask 會指定要設定的屬性。 mask如果成員指定 TCIF_TEXT 值，則 pszText 成員是 Null 終止字串的位址，而且 cchTextMax 會忽略成員。

傳回值

如果成功則為非零；否則為 0。

範例

請參閱的 GetItem 範例。

`CTabCtrl::SetItemExtra`

設定索引標籤控制項中針對應用程式定義資料保留的每個索引標籤位元組數目。

BOOL SetItemExtra(int nBytes);

參數

nBytes
要設定的額外位元組數目。

傳回值

如果成功則不為零，否則為 0。

備註

此成員函式會實作 Win32 訊息 TCM_SETITEMEXTRA 的行為，如 Windows SDK 中所述。

`CTabCtrl::SetItemSize`

設定索引標籤控制項項目的寬度和高度。

CSize SetItemSize(CSize size);

參數

size
索引標籤控制項項目的新寬度和高度 (以像素為單位)。

傳回值

傳回索引標籤控制項項目的舊寬度和高度。

`CTabCtrl::SetItemState`

設定所 nItem 識別之索引標籤控制項專案的狀態。

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

參數

nItem
要設定狀態資訊之專案的以零起始的索引編號。

dwMask
遮罩，指定要設定的專案狀態旗標。如需值清單，請參閱結構的遮罩成員 TCITEM ，如 Windows SDK 中所述。

dwState
包含狀態資訊的 DWORD 值的參考。可以是下列值之一：

值	Description
`TCIS_BUTTONPRESSED`	已選取索引標籤控制項專案。
`TCIS_HIGHLIGHTED`	索引標籤控制項專案會反白顯示，並使用目前的醒目提示色彩繪製索引標籤和文字。使用醒目提示色彩時，這會是真正的插補點，而不是重複的色彩。

傳回值

如果成功則為非零；否則為 0。

`CTabCtrl::SetMinTabWidth`

設定索引標籤控制項中專案的最小寬度。

int SetMinTabWidth(int cx);

參數

cx
要為索引標籤控制項專案設定的最小寬度。如果此參數設定為 -1，控制項會使用預設索引標籤寬度。

傳回值

前一個索引標籤寬度下限。

備註

此成員函式會實作 Win32 訊息 TCM_SETMINTABWIDTH 的行為，如 Windows SDK 中所述。

`CTabCtrl::SetPadding`

設定索引標籤控制項中每個索引標籤圖示和標籤周圍的空間量（填補）。

void SetPadding(CSize size);

參數

size
設定索引標籤控制項中每個索引標籤圖示和標籤周圍的空間量（填補）。

`CTabCtrl::SetToolTips`

將工具提示控制項指派給索引標籤控制項。

void SetToolTips(CToolTipCtrl* pWndTip);

參數

pWndTip
工具提示控制項的控制碼。

備註

您可以呼叫 GetToolTips 來取得與索引標籤控制項相關聯的工具提示控制項。

範例

請參閱的 CPropertySheet::GetTabControl 範例。

另請參閱

CWnd 類
 CHeaderCtrl 類
 CListCtrl 類
 階層架構圖表

共用方式為

CTabCtrl 類別

語法

成員

公用建構函式

公用方法

備註

繼承階層

需求

CTabCtrl::AdjustRect

參數

範例

CTabCtrl::Create

參數

傳回值

備註

範例

CTabCtrl::CreateEx

參數

傳回值

備註

CTabCtrl::CTabCtrl

CTabCtrl::DeleteAllItems

傳回值

CTabCtrl::DeleteItem

參數

傳回值

範例

CTabCtrl::DeselectAll

參數

備註

CTabCtrl::DrawItem

參數

備註

CTabCtrl::GetCurFocus

傳回值

CTabCtrl::GetCurSel

傳回值

CTabCtrl::GetExtendedStyle

傳回值

備註

CTabCtrl::GetImageList

傳回值

CTabCtrl::GetItem

參數

傳回值

備註

範例

CTabCtrl::GetItemCount

傳回值

範例

CTabCtrl::GetItemRect

參數

傳回值

範例

CTabCtrl::GetItemState

參數

傳回值

備註

CTabCtrl::GetRowCount

傳回值

備註

CTabCtrl::GetToolTips

傳回值

備註

CTabCtrl::HighlightItem

參數

傳回值

備註

CTabCtrl::HitTest

參數

傳回值

CTabCtrl::InsertItem

參數

傳回值

範例

CTabCtrl::RemoveImage

參數

備註

CTabCtrl::SetCurFocus

`CTabCtrl` 類別

`CTabCtrl::AdjustRect`

`CTabCtrl::Create`

`CTabCtrl::CreateEx`

`CTabCtrl::CTabCtrl`

`CTabCtrl::DeleteAllItems`

`CTabCtrl::DeleteItem`

`CTabCtrl::DeselectAll`

`CTabCtrl::DrawItem`

`CTabCtrl::GetCurFocus`

`CTabCtrl::GetCurSel`

`CTabCtrl::GetExtendedStyle`

`CTabCtrl::GetImageList`

`CTabCtrl::GetItem`

`CTabCtrl::GetItemCount`

`CTabCtrl::GetItemRect`

`CTabCtrl::GetItemState`

`CTabCtrl::GetRowCount`

`CTabCtrl::GetToolTips`

`CTabCtrl::HighlightItem`

`CTabCtrl::HitTest`

`CTabCtrl::InsertItem`

`CTabCtrl::RemoveImage`

`CTabCtrl::SetCurFocus`

`CTabCtrl::SetCurSel`

`CTabCtrl::SetExtendedStyle`

`CTabCtrl::SetImageList`

`CTabCtrl::SetItem`

`CTabCtrl::SetItemExtra`

`CTabCtrl::SetItemSize`

`CTabCtrl::SetItemState`

`CTabCtrl::SetMinTabWidth`

`CTabCtrl::SetPadding`

`CTabCtrl::SetToolTips`