索引標籤 （Windows 控制件）

本節包含與索引標籤搭配使用之程式設計專案的相關信息。

概觀

主題	目錄
關於索引標籤控件	「索引標籤控制項」類似於筆記本裡的分隔頁或檔案櫃中的標籤。 藉由使用索引標籤控制項，應用程式可以定義視窗或對話方塊中同一個區域的多個頁面。
使用索引標籤控件	本主題包含兩個使用 Tab 控制件的範例。

巨集

主題	目錄
TabCtrl_AdjustRect	根據視窗矩形計算定位控制元件的顯示區域，或計算對應至指定顯示區域的視窗矩形。 您可以使用這個宏，或明確傳送 TCM_ADJUSTRECT 訊息。
TabCtrl_DeleteAllItems	從索引標籤控件移除所有專案。 您可以使用這個宏，或明確傳送 TCM_DELETEALLITEMS 訊息。
TabCtrl_DeleteItem	從索引標籤控件移除專案。 您可以使用這個宏，或明確傳送 TCM_DELETEITEM 訊息。
TabCtrl_DeselectAll	重設索引標籤的專案，清除任何設定為 TCIS_BUTTONPRESSED 狀態的專案。 您可以使用這個宏，或明確傳送 TCM_DESELECTALL 訊息。
TabCtrl_GetCurFocus	傳回索引標籤控件中具有焦點的專案索引。 您可以使用這個宏，或明確傳送 TCM_GETCURFOCUS 訊息。
TabCtrl_GetCurSel	決定索引標籤控件中目前選取的索引標籤。 您可以使用這個宏，或明確傳送 TCM_GETCURSEL 訊息。
TabCtrl_GetExtendedStyle	擷取目前用於選項卡控件的延伸樣式。 您可以使用這個宏，或明確傳送 TCM_GETEXTENDEDSTYLE 訊息。
TabCtrl_GetImageList	擷取與索引標籤相關聯的影像清單。 您可以使用這個宏，或明確傳送 TCM_GETIMAGELIST 訊息。
TabCtrl_GetItem	擷取索引標籤中索引卷標的相關信息。 您可以使用這個宏，或明確傳送 TCM_GETITEM 訊息。
TabCtrl_GetItemCount	擷取索引標籤中的索引標籤。 您可以使用這個宏，或明確傳送 TCM_GETITEMCOUNT 訊息。
TabCtrl_GetItemRect	擷取索引標籤中索引卷標的周框。 您可以使用這個宏，或明確傳送 TCM_GETITEMRECT 訊息。
TabCtrl_GetRowCount	擷取索引標籤中目前索引標籤的資料列數目。 您可以使用這個宏，或明確傳送 TCM_GETROWCOUNT 訊息。
TabCtrl_GetTool提示	擷取與選項卡控件相關聯的工具提示控件句柄。 您可以使用這個宏，或明確傳送 TCM_GETTOOLTIPS 訊息。
TabCtrl_GetUnicodeFormat	擷取 控件的 UNICODE 字元格式旗標。 您可以使用這個宏，或明確傳送 TCM_GETUNICODEFORMAT 訊息。
TabCtrl_HighlightItem	設定索引標籤專案的醒目提示狀態。 您可以使用這個宏，或明確傳送 TCM_HIGHLIGHTITEM 訊息。
TabCtrl_HitTest	判斷哪個索引標籤，如果有的話，位於指定的螢幕位置。 您可以使用這個宏，或明確傳送 TCM_HITTEST 訊息。
TabCtrl_InsertItem	在索引標籤控件中插入新的索引標籤。 您可以使用這個宏，或明確傳送 TCM_INSERTITEM 訊息。
TabCtrl_RemoveImage	從索引標籤控件的影像清單中移除影像。 您可以使用這個宏，或明確傳送 TCM_REMOVEIMAGE 訊息。
TabCtrl_SetCurFocus	將焦點設定為索引標籤件中的指定索引標籤。 您可以使用這個宏，或明確傳送 TCM_SETCURFOCUS 訊息。
TabCtrl_SetCurSel	選取索引標籤的索引標籤。 您可以使用這個宏，或明確傳送 TCM_SETCURSEL 訊息。
TabCtrl_SetExtendedStyle	設定索引標籤控件將使用的擴充樣式。 您可以使用這個宏，或明確傳送 TCM_SETEXTENDEDSTYLE 訊息。
TabCtrl_SetImageList	將影像清單指派給索引標籤。 您可以使用這個宏，或明確傳送 TCM_SETIMAGELIST 訊息。
TabCtrl_SetItem	設定索引標籤的部分或所有屬性。 您可以使用這個宏，或明確傳送 TCM_SETITEM 訊息。
TabCtrl_SetItemExtra	設定索引標籤控件中針對應用程式定義數據保留的每個索引標籤位元組數目。 您可以使用這個宏，或明確傳送 TCM_SETITEMEXTRA 訊息。
TabCtrl_SetItemSize	設定固定寬度或擁有者繪製索引標籤的索引標籤寬度和高度。 您可以使用這個宏，或明確傳送 TCM_SETITEMSIZE 訊息。
TabCtrl_SetMinTabWidth	設定索引標籤控件中專案的最小寬度。 您可以使用這個宏，或明確傳送 TCM_SETMINTABWIDTH 訊息。
TabCtrl_SetPadding	設定索引標籤控件中每個索引標籤圖示和標籤周圍的空間量（填補）。 您可以使用這個宏，或明確傳送 TCM_SETPADDING 訊息。
TabCtrl_SetTool提示	將工具提示控件指派給索引標籤控制項。 您可以使用這個宏，或明確傳送 TCM_SETTOOLTIPS 訊息。
TabCtrl_SetUnicodeFormat	設定控件的 Unicode 字元格式旗標。 此訊息可讓您在運行時間變更控件所使用的字元集，而不需要重新建立控件。 您可以使用這個宏，或明確傳送 TCM_SETUNICODEFORMAT 訊息。

訊息

主題	目錄
TCM_ADJUSTRECT	根據視窗矩形計算定位控制元件的顯示區域，或計算對應至指定顯示區域的視窗矩形。 您可以明確傳送此訊息，或使用 TabCtrl_AdjustRect 宏。
TCM_DELETEALLITEMS	從索引標籤控件移除所有專案。 您可以明確傳送此訊息，或使用 TabCtrl_DeleteAllItems 宏。
TCM_DELETEITEM	從索引標籤控件移除專案。 您可以明確傳送此訊息，或使用 TabCtrl_DeleteItem 宏。
TCM_DESELECTALL	重設索引標籤的專案，清除任何設定為 TCIS_BUTTONPRESSED 狀態的專案。 您可以明確傳送此訊息，或使用 TabCtrl_DeselectAll 宏。
TCM_GETCURFOCUS	傳回索引標籤控件中具有焦點的專案索引。 您可以明確傳送此訊息，或使用 TabCtrl_GetCurFocus 宏。
TCM_GETCURSEL	決定索引標籤控件中目前選取的索引標籤。 您可以明確傳送此訊息，或使用 TabCtrl_GetCurSel 宏。
TCM_GETEXTENDEDSTYLE	擷取目前用於選項卡控件的延伸樣式。 您可以明確傳送此訊息，或使用 TabCtrl_GetExtendedStyle 宏。
TCM_GETIMAGELIST	擷取與索引標籤相關聯的影像清單。 您可以明確傳送此訊息，或使用 TabCtrl_GetImageList 宏。
TCM_GETITEM	擷取索引標籤中索引卷標的相關信息。 您可以明確傳送此訊息，或使用 TabCtrl_GetItem 宏。
TCM_GETITEMCOUNT	擷取索引標籤中的索引標籤。 您可以明確傳送此訊息，或使用 TabCtrl_GetItemCount 宏。
TCM_GETITEMRECT	擷取索引標籤中索引卷標的周框。 您可以明確傳送此訊息，或使用 TabCtrl_GetItemRect 宏。
TCM_GETROWCOUNT	擷取索引標籤中目前索引標籤的資料列數目。 您可以明確傳送此訊息，或使用 TabCtrl_GetRowCount 宏。
TCM_GETTOOLTIPS	擷取與選項卡控件相關聯的工具提示控件句柄。 您可以明確傳送此訊息，或使用 TabCtrl_GetTool提示 宏。
TCM_GETUNICODEFORMAT	擷取 控件的 Unicode 字元格式旗標。 您可以明確傳送此訊息，或使用 TabCtrl_GetUnicodeFormat 宏。
TCM_HIGHLIGHTITEM	設定索引標籤專案的醒目提示狀態。 您可以明確傳送此訊息，或使用 TabCtrl_HighlightItem 宏。
TCM_HITTEST	判斷哪個索引標籤，如果有的話，位於指定的螢幕位置。 您可以明確傳送此訊息，或使用 TabCtrl_HitTest 宏。
TCM_INSERTITEM	在索引標籤控件中插入新的索引標籤。 您可以明確傳送此訊息，或使用 TabCtrl_InsertItem 宏。
TCM_REMOVEIMAGE	從索引標籤控件的影像清單中移除影像。 您可以明確傳送此訊息，或使用 TabCtrl_RemoveImage 宏。
TCM_SETCURFOCUS	將焦點設定為索引標籤件中的指定索引標籤。 您可以明確傳送此訊息，或使用 TabCtrl_SetCurFocus 宏。
TCM_SETCURSEL	選取索引標籤的索引標籤。 您可以明確傳送此訊息，或使用 TabCtrl_SetCurSel 宏。
TCM_SETEXTENDEDSTYLE	設定索引標籤控件將使用的擴充樣式。 您可以明確傳送此訊息，或使用 TabCtrl_SetExtendedStyle 宏。
TCM_SETIMAGELIST	將影像清單指派給索引標籤。 您可以明確傳送此訊息，或使用 TabCtrl_SetImageList 宏。
TCM_SETITEM	設定索引標籤的部分或所有屬性。 您可以明確傳送此訊息，或使用 TabCtrl_SetItem 宏。
TCM_SETITEMEXTRA	設定索引標籤控件中針對應用程式定義數據保留的每個索引標籤位元組數目。 您可以明確傳送此訊息，或使用 TabCtrl_SetItemExtra 宏。
TCM_SETITEMSIZE	設定固定寬度或擁有者繪製索引標籤的索引標籤寬度和高度。 您可以明確傳送此訊息，或使用 TabCtrl_SetItemSize 宏。
TCM_SETMINTABWIDTH	設定索引標籤控件中專案的最小寬度。 您可以明確傳送此訊息，或使用 TabCtrl_SetMinTabWidth 宏。
TCM_SETPADDING	設定索引標籤控件中每個索引標籤圖示和標籤周圍的空間量（填補）。 您可以明確傳送此訊息，或使用 TabCtrl_SetPadding 宏。
TCM_SETTOOLTIPS	將工具提示控件指派給索引標籤控制項。 您可以明確傳送此訊息，或使用 TabCtrl_SetTool提示 宏。
TCM_SETUNICODEFORMAT	設定控件的 Unicode 字元格式旗標。 此訊息可讓您在運行時間變更控件所使用的字元集，而不需要重新建立控件。 您可以明確傳送此訊息，或使用 TabCtrl_SetUnicodeFormat 宏。

Notifications

主題	目錄
NM_CLICK （索引標籤）	通知選項卡控制件的父視窗，使用者已按下控件內的滑鼠左鍵。 此通知碼會以WM_NOTIFY訊息的形式傳送。
NM_DBLCLK （索引標籤）	通知索引標籤控件的父視窗，使用者已按兩下控制件內的滑鼠左鍵。 此通知會以WM_NOTIFY訊息的形式傳送。
NM_RCLICK （索引標籤）	通知選項卡控制件的父視窗，使用者已按下控件內的滑鼠右鍵。 此通知碼會以WM_NOTIFY訊息的形式傳送。
NM_RDBLCLK （索引標籤）	通知選項卡控件的父視窗，使用者已在控制件內按兩下滑鼠右鍵。 此通知碼會以WM_NOTIFY訊息的形式傳送。
NM_RELEASEDCAPTURE （索引標籤）	通知索引標籤控件的父視窗，控制件正在釋放滑鼠擷取。 此通知碼會以WM_NOTIFY訊息的形式傳送。
TCN_FOCUSCHANGE	通知索引標籤控件的父視窗按鈕焦點已變更。 此通知碼會以WM_NOTIFY訊息的形式傳送。
TCN_GETOBJECT	當索引標籤具有 TCS_EX_REGISTERDROP 延伸樣式，且物件會拖曳至控件中的索引卷標專案時傳送。 此通知碼會以WM_NOTIFY訊息的形式傳送。
TCN_KEYDOWN	通知索引標籤控件的父視窗已按下按鍵。 此通知碼會以WM_NOTIFY訊息的形式傳送。
TCN_SELCHANGE	通知索引標籤控件的父視窗，目前選取的索引標籤已變更。 此通知碼會以WM_NOTIFY訊息的形式傳送。
TCN_SELCHANGING	通知索引標籤的父視窗，目前選取的索引標籤即將變更。 此通知碼會以WM_NOTIFY訊息的形式傳送。

結構

主題	目錄
NMTCKEYDOWN	包含 Tab 控制件中按鍵按下的相關信息。 它會與TCN_KEYDOWN通知程序代碼搭配使用。 這個結構會取代 TC_KEYDOWN 結構。
TCHITTESTINFO	包含點擊測試的相關信息。 這個結構會取代 TC_HITTESTINFO 結構。
TCITEM	指定或接收索引標籤項目的屬性。 它會與TCM_INSERTITEM、TCM_GETITEM和TCM_SETITEM訊息搭配使用。 這個結構會取代 TC_ITEM 結構。
TCITEMHEADER	指定或接收索引標籤的屬性。它會與TCM_INSERTITEM、TCM_GETITEM和TCM_SETITEM訊息搭配使用。 這個結構會取代 TC_ITEMHEADER 結構。

常數

主題	目錄
Tab 控件擴充樣式	索引標籤控件現在支援擴充樣式。 這些樣式是使用TCM_GETEXTENDEDSTYLE和TCM_SETEXTENDEDSTYLE訊息來操作，不應與傳遞至 CreateWindowEx 的延伸窗口樣式混淆。
Tab 控件項目狀態	Tab 控件專案現在支援支援TCM_DESELECTALL訊息的項目狀態。 此外， TCITEM 結構支援項目狀態值。
Tab 控件樣式	本節列出支援的索引標籤控件樣式。