CTabCtrl::GetItem
タブ コントロールのタブの情報を取得します。
BOOL GetItem(
int nItem,
TCITEM* pTabCtrlItem
) const;
パラメーター
nItem
タブのインデックス。pTabCtrlItem
情報を取得するように指定する TCITEM の構造体へのポインター。また、タブに関する情報を受け取るために使用します。この構造は InsertItem、GetItemと SetItem のメンバー関数で使用されます。
戻り値
正常終了した場合はを返します [真] ; 別の方法で FALSE。
解説
メッセージが送信されると、mask のメンバーは、取得する属性を指定します。mask のメンバーが TCIF_TEXT の値を指定した場合、pszText のメンバーは、項目のテキストを受け取り、cchTextMax のメンバーがバッファーのサイズを指定する必要があるバッファーのアドレスを含める必要があります。
マスク
取得または設定する TCITEM の構成要素を評価します。このメンバーは、次の値のゼロ B または組み合わせのいずれかです: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();
}
必要条件
ヘッダー: afxcmn.h