CTabCtrl クラス

  • [アーティクル]

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、「コントロールと使用」を参照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
タブ コントロールのサイズと位置を指定します。 オブジェクトまたはRECT構造体をCRect指定できます。

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

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

戻り値

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

解説

2 つの手順でオブジェクトを CTabCtrl 構築します。 まず、コンストラクターを呼び出し、次に tab コントロールを作成してオブジェクトにアタッチする呼び出 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 の dwExStyle パラメーター CreateWindowEx を参照してください。

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

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

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

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

戻り値

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

解説

Windows 拡張スタイルのCreate前書WS_EX_きで指定された拡張 Windows スタイルを適用する代わりに使用CreateExします。

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

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_DESELECTALLWin32 メッセージの動作を実装します。

CTabCtrl::DrawItem

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

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

パラメーター

lpDrawItemStruct
塗りつぶす DRAWITEMSTRUCT 項目を記述する構造体へのポインター。

解説

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

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

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

CTabCtrl::GetCurFocus

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

int GetCurFocus() const;

戻り値

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

CTabCtrl::GetCurSel

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

int GetCurSel() const;

戻り値

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

CTabCtrl::GetExtendedStyle

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

DWORD GetExtendedStyle();

戻り値

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

解説

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

CTabCtrl::GetImageList

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

CImageList* GetImageList() const;

戻り値

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

CTabCtrl::GetItem

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

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

パラメーター

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

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

戻り値

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

解説

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

  • mask

    取得または設定する TCITEM 構造体メンバーを指定する値。 このメンバーには、0 または次の値の組み合わせを指定できます。

    • TCIF_TEXTpszText: メンバーは有効です。
    • TCIF_IMAGEiImage: メンバーは有効です。
    • TCIF_PARAMlParam: メンバーは有効です。
    • TCIF_RTLREADING: テキストは pszText 、ヘブライ語またはアラビア語のシステムで右から左への読み取り順序を使用して表示されます。
    • TCIF_STATEdwState: メンバーは有効です。

  • 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 値への参照。 値は、次のいずれかです。

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

解説

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

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
テストする TCHITTESTINFO 画面の位置を指定する Windows SDK の説明に従って、構造体へのポインター。

戻り値

タブの 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_TEXTpszText: メンバーは有効です。
  • TCIF_IMAGEiImage: メンバーは有効です。
  • TCIF_PARAMlParam: メンバーは有効です。
  • TCIF_RTLREADING: テキストは pszText 、ヘブライ語またはアラビア語のシステムで右から左への読み取り順序を使用して表示されます。
  • TCIF_STATEdwState: メンバーは有効です。

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 の説明に従って、前 のタブ コントロールの拡張スタイルを含む 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 、設定する属性を指定します。 メンバーが値をmaskTCIF_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 値への参照。 値は、次のいずれかです。

Value 説明
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 の例を参照してください。

関連項目

CWnd クラス
CHeaderCtrl クラス
CListCtrl クラス
階層図