`CTabCtrl` クラス

[アーティクル]
11/22/2024

Windows のコモンタブコントロールの機能が用意されています。

構文

class CTabCtrl : public CWnd

メンバー

パブリックコンストラクター

名前	説明
`CTabCtrl::CTabCtrl`	`CTabCtrl` オブジェクトを構築します。

パブリックメソッド

名前	説明
`CTabCtrl::AdjustRect`	ウィンドウの四角形を指定してタブコントロールの表示領域を計算するか、特定の表示領域に対応するウィンドウの四角形を計算します。
`CTabCtrl::Create`	タブコントロールを作成し、 `TabCtrl` オブジェクトのインスタンスにアタッチします。
`CTabCtrl::CreateEx`	指定した Windows 拡張スタイルを持つタブコントロールを作成し、 `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`	タブコントロールにツールヒントコントロールを割り当てます。

解説

"タブコントロール" は、ノートブックの分割線やファイルキャビネット内のラベルに似ています。タブコントロールを使用すると、アプリケーションでウィンドウまたはダイアログボックスの同じ領域に複数のページを定義できます。各ページは、ユーザーが対応するタブを選択したときにアプリケーションに表示される一連の情報またはコントロールのグループで構成されます。特殊な種類のタブコントロールには、ボタンのようなタブが表示されます。ボタンをクリックすると、ページが表示されるのではなく、すぐにコマンドが実行されます。

このコントロール (したがって、 CTabCtrl クラス) は、Windows 95/98 および Windows NT バージョン 3.51 以降で実行されているプログラムでのみ使用できます。

CTabCtrlの詳細については、「Controlsと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 で説明されている tab コントロールスタイルの任意の組み合わせを適用します。コントロール 適用できるウィンドウスタイルの一覧については、「 Remarks」を参照してください。

rect
タブコントロールのサイズと位置を指定します。 CRect オブジェクトまたはRECT構造体のいずれかを指定できます。

pParentWnd
タブコントロールの親ウィンドウ (通常は CDialog) を指定します。 NULLすることはできません。

nID
タブコントロールの ID を指定します。

戻り値

TRUE オブジェクトの初期化が成功した場合。それ以外の場合は FALSE。

解説

CTabCtrl オブジェクトは、2 つの手順で作成します。まず、コンストラクターを呼び出し、 Createを呼び出します。これにより、タブコントロールが作成され、 CTabCtrl オブジェクトにアタッチされます。

タブコントロールのスタイルに加えて、次のウィンドウスタイルをタブコントロールに適用できます。

WS_CHILD: タブコントロールを表す子ウィンドウを作成します。 WS_POPUP スタイルでは使用できません。
WS_VISIBLE: 最初に表示されるタブコントロールを作成します。
WS_DISABLED: 最初に無効になっているウィンドウを作成します。
WS_GROUP: ユーザーが方向キーを使用して 1 つのコントロールから次のコントロールに移動できるコントロールのグループの最初のコントロールを指定します。最初のコントロールの後の WS_GROUP: スタイルで定義されているすべてのコントロールは、同じグループに属します。 WS_GROUP: スタイルを持つ次のコントロールは、スタイルグループを終了し、次のグループを開始します (つまり、1 つのグループが次のグループの開始位置で終了します)。
WS_TABSTOP: TAB キーを使用してユーザーが移動できる任意の数のコントロールのいずれかを指定します。 Tab キーを押すと、ユーザーは 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 スタイルの一覧については、Windows SDK のCreateWindowExの dwExStyle パラメーターを参照してください。

dwStyle
タブコントロールのスタイルを指定します。 Windows SDK で説明されている tab コントロールスタイルの任意の組み合わせを適用します。コントロール適用できるウィンドウスタイルの一覧については、Createの「Remarks」を参照してください。

rect
pParentWndのクライアント座標で、作成するウィンドウのサイズと位置を記述するRECT構造体への参照。

pParentWnd
コントロールの親であるウィンドウへのポインター。

nID
コントロールの子ウィンドウ ID。

戻り値

成功した場合は 0 以外の場合は 0。

解説

CreateではなくCreateExを使用して、Windows 拡張スタイルの前置WS_EX_で指定された拡張 Windows スタイルを適用します。

CreateEx は、 dwExStyleで指定された拡張 Windows スタイルを使用してコントロールを作成します。 SetExtendedStyleを使用して、コントロールに固有の拡張スタイルを設定します。たとえば、 CreateEx を使用して WS_EX_CONTEXTHELPなどのスタイルを設定しますが、 SetExtendedStyle を使用して TCS_EX_FLATSEPARATORSなどのスタイルを設定します。詳細については、Windows SDK の「 Tab コントロール拡張スタイルで説明されているスタイルを参照してください。

`CTabCtrl::CTabCtrl`

CTabCtrl オブジェクトを構築します。

CTabCtrl();

`CTabCtrl::DeleteAllItems`

タブコントロールからすべてのアイテムを削除します。

BOOL DeleteAllItems();

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

`CTabCtrl::DeleteItem`

指定した項目をタブコントロールから削除します。

BOOL DeleteItem(int nItem);

パラメーター

nItem
削除する項目の 0 から始まる値。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 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`

タブコントロール内の項目をリセットし、押された項目をクリアします。

void DeselectAll(BOOL fExcludeFocus);

パラメーター

fExcludeFocus
項目の選択解除のスコープを指定するフラグ。このパラメーターを FALSE に設定すると、すべてのタブボタンがリセットされます。 TRUEに設定されている場合は、現在選択されているタブ項目を除くすべてのタブ項目がリセットされます。

解説

このメンバー関数は、Windows SDK で説明されているように、 TCM_DESELECTALL Win32 メッセージの動作を実装します。

`CTabCtrl::DrawItem`

所有者描画タブコントロールの視覚的な側面が変更されたときにフレームワークによって呼び出されます。

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

パラメーター

lpDrawItemStruct
描画する項目を記述する DRAWITEMSTRUCT 構造体へのポインター。

解説

DRAWITEMSTRUCT構造体のitemAction メンバーは、実行する描画アクションを定義します。

既定では、このメンバー関数は何も行いません。このメンバー関数をオーバーライドして、所有者描画 CTabCtrl オブジェクトの描画を実装します。

アプリケーションは、このメンバー関数が終了する前に、 lpDrawItemStruct で指定された表示コンテキストに対して選択されているすべてのグラフィックスデバイスインターフェイス (GDI) オブジェクトを復元する必要があります。

`CTabCtrl::GetCurFocus`

現在のフォーカスを持つタブのインデックスを取得します。

int GetCurFocus() const;

戻り値

現在のフォーカスを持つタブの 0 から始まるインデックス。

`CTabCtrl::GetCurSel`

タブコントロールで現在選択されているタブを取得します。

int GetCurSel() const;

戻り値

成功した場合は選択したタブの 0 から始まるインデックス、タブが選択されていない場合は -1。

`CTabCtrl::GetExtendedStyle`

タブコントロールに現在使用されている拡張スタイルを取得します。

DWORD GetExtendedStyle();

戻り値

タブコントロールに現在使用されている拡張スタイルを表します。この値は、Windows SDK で説明されているように、 tab コントロールの拡張スタイルの組み合わせです。

解説

このメンバー関数では、Windows SDK で説明されているように、Win32 メッセージ TCM_GETEXTENDEDSTYLE の動作が実装されます。

`CTabCtrl::GetImageList`

タブコントロールに関連付けられているイメージリストを取得します。

CImageList* GetImageList() const;

戻り値

成功した場合は、タブコントロールの画像リストへのポインター。それ以外の場合は NULL。

`CTabCtrl::GetItem`

タブコントロール内のタブに関する情報を取得します。

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

パラメーター

nItem
タブの 0 から始まるインデックス。

pTabCtrlItem
取得する情報を指定するために使用される、 TCITEM 構造体へのポインター。タブに関する情報を受け取るためにも使用されます。この構造体は、 InsertItem、 GetItem、および SetItem メンバー関数と共に使用されます。

戻り値

成功した場合は TRUE を返し、それ以外の場合 FALSE 返します。

解説

メッセージが送信されると、 mask メンバーは返す属性を指定します。 mask メンバーがTCIF_TEXT値を指定する場合、pszText メンバーには項目テキストを受け取るバッファーのアドレスが含まれている必要があり、cchTextMax メンバーはバッファーのサイズを指定する必要があります。

mask

取得または設定する構造体メンバー TCITEM 指定する値。このメンバーには、0 または次の値の組み合わせを指定できます。
- 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`

タブコントロール内の指定したタブの外接する四角形を取得します。

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

パラメーター

nItem
タブ項目の 0 から始まるインデックス。

lpRect
タブの外接する四角形を受け取る RECT 構造体へのポインター。これらの座標は、ビューポートの現在のマッピングモードを使用します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

例

CPropertySheet::GetTabControl の例を参照してください。

`CTabCtrl::GetItemState`

nItemによって識別されるタブコントロール項目の状態を取得します。

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

パラメーター

nItem
状態情報を取得する項目の 0 から始まるインデックス番号。

dwMask
返す項目の状態フラグを指定するマスク。値の一覧については、Windows SDK の説明に従って、 TCITEM 構造体のマスクメンバーを参照してください。

戻り値

状態情報を受け取る DWORD 値への参照。値は、次のいずれかです。

値	説明
`TCIS_BUTTONPRESSED`	タブコントロール項目が選択されています。
`TCIS_HIGHLIGHTED`	タブコントロール項目が強調表示され、現在の強調表示の色を使用してタブとテキストが描画されます。強調表示の色を使用する場合、これはディザリングされた色ではなく、真の補間になります。

解説

項目の状態は、TCITEM構造体のdwState メンバーによって指定されます。

`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
タブコントロール項目の 0 から始まるインデックス。

fHighlight
設定する強調表示状態を指定する値。この値が TRUEの場合、タブは強調表示されます。 FALSE場合、タブは既定の状態に設定されます。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TCM_HIGHLIGHTITEMを実装します。

`CTabCtrl::HitTest`

指定した画面位置にあるタブ (存在する場合) を決定します。

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

パラメーター

pHitTestInfo
テストする画面の位置を指定する Windows SDK の説明に従って、 TCHITTESTINFO 構造体へのポインター。

戻り値

タブの 0 から始まるインデックスを返します。指定した位置にタブがない場合は -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
新しいタブの 0 から始まるインデックス。

pTabCtrlItem
タブの属性を指定する TCITEM 構造体へのポインター。

lpszItem
タブのテキストを含む null で終わる文字列のアドレス。

nImage
イメージリストから挿入するイメージの 0 から始まるインデックス。

nMask
設定する TCITEM 構造体属性を指定します。 0 または次の値の組み合わせを指定できます。

TCIF_TEXT: pszText メンバーが有効です。
TCIF_IMAGE: iImage メンバーが有効です。
TCIF_PARAM: lParam メンバーが有効です。
TCIF_RTLREADING: pszText のテキストは、ヘブライ語またはアラビア語のシステムで右から左への読み取り順序を使用して表示されます。
TCIF_STATE: dwState メンバーが有効です。

lParam
タブに関連付けられているアプリケーション定義データ。

dwState
アイテムの状態の値を指定します。詳細については、Windows SDK の TCITEM に関する記事を参照してください。

dwStateMask
設定する状態を指定します。詳細については、Windows SDK の TCITEM に関する記事を参照してください。

戻り値

成功した場合の新しいタブの 0 から始まるインデックス。それ以外の場合は -1。

例

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

m_TabCtrl.InsertItem(0, &tcItem);

`CTabCtrl::RemoveImage`

タブコントロールのイメージリストから、指定したイメージを削除します。

void RemoveImage(int nImage);

パラメーター

nImage
削除するイメージの 0 から始まるインデックス。

解説

タブコントロールは、各タブのイメージインデックスを更新して、各タブが同じイメージに関連付けられたままになるようにします。

`CTabCtrl::SetCurFocus`

フォーカスをタブコントロール内の指定したタブに設定します。

void SetCurFocus(int nItem);

パラメーター

nItem
フォーカスを取得するタブのインデックスを指定します。

解説

このメンバー関数では、Windows SDK で説明されているように、Win32 メッセージ TCM_SETCURFOCUS の動作が実装されます。

`CTabCtrl::SetCurSel`

タブコントロール内のタブを選択します。

int SetCurSel(int nItem);

パラメーター

nItem
選択する項目の 0 から始まるインデックス。

戻り値

成功した場合は、以前に選択したタブの 0 から始まるインデックス。それ以外の場合は -1。

解説

タブコントロールは、この関数を使用してタブが選択されている場合、 TCN_SELCHANGING または TCN_SELCHANGE 通知メッセージを送信しません。これらの通知は、ユーザーがキーボードをクリックまたは使用してタブを変更するときに、 WM_NOTIFYを使用して送信されます。

`CTabCtrl::SetExtendedStyle`

タブコントロールの拡張スタイルを設定します。

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

パラメーター

dwNewStyle
タブコントロールの拡張スタイルの組み合わせを指定する値。

dwExMask
影響を受ける dwNewStyle のスタイルを示す DWORD 値。 dwExMaskの拡張スタイルのみが変更されます。他のすべてのスタイルは、そのまま維持されます。このパラメーターが 0 の場合、 dwNewStyle 内のすべてのスタイルが影響を受ける可能性があります。

戻り値

Windows SDK で説明されているように、前の tab コントロールの拡張スタイルを含む DWORD 値。

解説

このメンバー関数では、Windows SDK で説明されているように、Win32 メッセージ TCM_SETEXTENDEDSTYLE の動作が実装されます。

`CTabCtrl::SetImageList`

タブコントロールに画像リストを割り当てます。

CImageList* SetImageList(CImageList* pImageList);

パラメーター

pImageList
タブコントロールに割り当てるイメージリストへのポインター。

戻り値

前のイメージリストへのポインターを返すか、前のイメージリストがない場合は NULL を返します。

`CTabCtrl::SetItem`

タブの属性の一部またはすべてを設定します。

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

パラメーター

nItem
項目の 0 から始まるインデックス。

pTabCtrlItem
新しい項目属性を含む TCITEM 構造体へのポインター。 mask メンバーは、設定する属性を指定します。 mask メンバーがTCIF_TEXT値を指定した場合、pszText メンバーは null で終わる文字列のアドレスであり、cchTextMax メンバーは無視されます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

例

GetItem の例を参照してください。

`CTabCtrl::SetItemExtra`

タブコントロール内のアプリケーション定義データ用に予約されたタブあたりのバイト数を設定します。

BOOL SetItemExtra(int nBytes);

パラメーター

nBytes
設定する余分なバイト数。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

このメンバー関数では、Windows SDK で説明されているように、Win32 メッセージ TCM_SETITEMEXTRA の動作が実装されます。

`CTabCtrl::SetItemSize`

タブコントロール項目の幅と高さを設定します。

CSize SetItemSize(CSize size);

パラメーター

size
タブコントロール項目の新しい幅と高さ (ピクセル単位)。

戻り値

タブコントロール項目の古い幅と高さを返します。

`CTabCtrl::SetItemState`

nItemで識別されるタブコントロール項目の状態を設定します。

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

パラメーター

nItem
状態情報を設定する項目の 0 から始まるインデックス番号。

dwMask
設定する項目の状態フラグを指定するマスク。値の一覧については、Windows SDK の説明に従って、 TCITEM 構造体のマスクメンバーを参照してください。

dwState
状態情報を含む DWORD 値への参照。値は、次のいずれかです。

値	説明
`TCIS_BUTTONPRESSED`	タブコントロール項目が選択されています。
`TCIS_HIGHLIGHTED`	タブコントロール項目が強調表示され、現在の強調表示の色を使用してタブとテキストが描画されます。強調表示の色を使用する場合、これはディザリングされた色ではなく、真の補間になります。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

`CTabCtrl::SetMinTabWidth`

タブコントロール内の項目の最小幅を設定します。

int SetMinTabWidth(int cx);

パラメーター

cx
タブコントロール項目に設定する最小幅。このパラメーターが -1 に設定されている場合、コントロールは既定のタブ幅を使用します。

戻り値

前の最小タブ幅。

解説

このメンバー関数では、Windows SDK で説明されているように、Win32 メッセージ TCM_SETMINTABWIDTH の動作が実装されます。

`CTabCtrl::SetPadding`

タブコントロール内の各タブのアイコンとラベルの周囲のスペース (パディング) の量を設定します。

void SetPadding(CSize size);

パラメーター

size
タブコントロール内の各タブのアイコンとラベルの周囲のスペース (パディング) の量を設定します。

`CTabCtrl::SetToolTips`

タブコントロールにツールヒントコントロールを割り当てます。

void SetToolTips(CToolTipCtrl* pWndTip);

パラメーター

pWndTip
ツールヒントコントロールのハンドル。

解説

タブコントロールに関連付けられているツールヒントコントロールを取得するには、 GetToolTipsを呼び出します。

例

CPropertySheet::GetTabControl の例を参照してください。

次の方法で共有

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`