タブ (Windows コントロール)
このセクションでは、タブ コントロールで使用されるプログラミング要素について説明します。
概要
トピック | 内容 |
---|---|
タブ コントロールについて | タブ コントロールは、ノートの仕切ページまたはファイル キャビネットのラベルに似ています。 タブ コントロールを使用すると、アプリケーションでウィンドウまたはダイアログ ボックスの同じ領域に複数のページを定義できます。 |
タブ コントロールの使用 | このトピックには、タブ コントロールを使用する 2 つの例が含まれています。 |
マクロ
トピック | 内容 |
---|---|
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_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 | タブ コントロール内の項目をリセットし、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 (タブ) | ユーザーが、コントロール内のマウスの左ボタンをクリックしたことをタブ コントロールの親ウィンドウに通知します。 この通知コードは、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 | タブ コントロールのキー押下に関する情報が含まれます。 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 構造体より優先されます。 |
定数
トピック | 内容 |
---|---|
タブ コントロールの拡張スタイル | タブ コントロールで拡張スタイルがサポートされるようになりました。 これらのスタイルは、TCM_GETEXTENDEDSTYLE および TCM_SETEXTENDEDSTYLE メッセージを使用して操作します。また、CreateWindowEx に渡される拡張ウィンドウ スタイルと混同しないでください。 |
タブ コントロール項目の状態 | タブ コントロール項目でTCM_DESELECTALL メッセージをサポートするアイテム状態がサポートされるようになりました。 さらに、TCITEM 構造体はアイテム状態値をサポートします。 |
タブ コントロール スタイル | このセクションでは、サポートされているタブ コントロール スタイルの一覧を示します。 |