共用方式為

索引標籤 （Windows 控制件）

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

綜述

主題 內容
關於索引標籤控件的 索引標籤機控件類似於筆記本中的分隔符或檔案櫃中的標籤。 藉由使用索引標籤件，應用程式可以針對視窗或對話框的相同區域定義多個頁面。
使用製表元控件 本主題包含兩個使用 Tab 控制件的範例。

巨集

主題 內容
TabCtrl_AdjustRect 根據視窗矩形計算定位控制元件的顯示區域，或計算對應至指定顯示區域的視窗矩形。 您可以使用這個巨集，或明確傳送 TCM_ADJUSTRECT 訊息。
TabCtrl_DeleteAllItems 從索引標籤控件移除所有專案。 您可以使用這個巨集，或明確傳送 TCM_DELETEALLITEMS 訊息。
TabCtrl_DeleteItem 從索引標籤控件移除專案。 您可以使用這個巨集，或明確傳送 TCM_DELETEITEM 訊息。
TabCtrl_DeselectAll 重設 Tab 控制項中的專案，清除已設定為 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_GetToolTips 擷取與選項卡控件相關聯的工具提示控件句柄。 您可以使用這個巨集，或明確傳送 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_SetToolTips 將工具提示控件指派給索引標籤控制項。 您可以使用這個巨集，或明確傳送 TCM_SETTOOLTIPS 訊息。
TabCtrl_SetUnicodeFormat 設定控件的 Unicode 字元格式旗標。 此訊息可讓您在運行時間變更控件所使用的字元集，而不需要重新建立控件。 您可以使用這個巨集，或明確傳送 TCM_SETUNICODEFORMAT 訊息。

消息

主題 內容
TCM_ADJUSTRECT 根據視窗矩形計算定位控制元件的顯示區域，或計算對應至指定顯示區域的視窗矩形。 您可以明確傳送此訊息，或使用 TabCtrl_AdjustRect 巨集。
TCM_DELETEALLITEMS 從索引標籤控件移除所有專案。 您可以明確傳送此訊息，或使用 TabCtrl_DeleteAllItems 巨集。
TCM_DELETEITEM 從索引標籤控件移除專案。 您可以明確傳送此訊息，或使用 TabCtrl_DeleteItem 巨集。
TCM_DESELECTALL 重設 Tab 控制項中的專案，清除已設定為 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_GetToolTips 巨集。
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_SetToolTips 巨集。
TCM_SETUNICODEFORMAT 設定控件的 Unicode 字元格式旗標。 此訊息可讓您在運行時間變更控件所使用的字元集，而不需要重新建立控件。 您可以明確傳送此訊息，或使用 TabCtrl_SetUnicodeFormat 巨集。

通知

主題 內容
NM_CLICK （tab） 通知選項卡控制件的父視窗，使用者已按下控件內的滑鼠左鍵。 此通知碼會以 WM_NOTIFY 訊息的形式傳送。
NM_DBLCLK （tab） 通知索引標籤控件的父視窗，使用者已按兩下控制件內的滑鼠左鍵。 此通知會以 WM_NOTIFY 訊息的形式傳送。
NM_RCLICK （tab） 通知選項卡控制件的父視窗，使用者已按下控件內的滑鼠右鍵。 此通知碼會以 WM_NOTIFY 訊息的形式傳送。
NM_RDBLCLK （tab） 通知選項卡控件的父視窗，使用者已在控制件內按兩下滑鼠右鍵。 此通知碼會以 WM_NOTIFY 訊息的形式傳送。
NM_RELEASEDCAPTURE （tab） 通知索引標籤控件的父視窗，控制件正在釋放滑鼠擷取。 此通知碼會以 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 控制項項目狀態 索引標籤控件項目現在支援支援 TCM_DESELECTALL 訊息的項目狀態。 此外，TCITEM 結構支援項目狀態值。
Tab 控件樣式 本節列出支援的索引標籤控件樣式。
  • Last updated on