CTabCtrl::InsertItem
更新 : 2007 年 11 月
既存のタブ コントロールに新しいタブを挿入します。
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);
必要条件
ヘッダー : afxcmn.h