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
新しいタブのインデックス。pTabCtrlItem
タブの属性を指定する TCITEM の構造体へのポインター。lpszItem
タブのテキストを含む null で終わる文字列のアドレス。nImage
イメージ リストから挿入するイメージのインデックス。nMask
TCITEM のすべての構造体を設定するには、属性と属性を使用するかを指定します。次の値の数は、組み合わせがあります:TCIF_TEXTpszText のメンバーは有効です。
TCIF_IMAGEiImage のメンバーは有効です。
TCIF_PARAMlParam のメンバーは有効です。
TCIF_RTLREADING は、アラビア語またはヘブライ語のシステムの右から左への読み取り順序を使用して pszText のテキストが表示されます。
TCIF_STATEdwState のメンバーは有効です。
lParam
タブに関連付けられたアプリケーション定義データ。dwState
項目の状態の値を指定します。詳細については、Windows SDKの TCITEM を参照してください。dwStateMask
どの状態を設定する必要があるかを指定します。詳細については、Windows SDKの TCITEM を参照してください。
戻り値
成功した場合は新しいタブのインデックス; は– 1。
使用例
TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");
m_TabCtrl.InsertItem(0, &tcItem);
必要条件
ヘッダー: afxcmn.h