CListCtrl::InsertItem
リスト ビュー コントロールに項目を挿入します。
int InsertItem(
const LVITEM* pItem
);
int InsertItem(
int nItem,
LPCTSTR lpszItem
);
int InsertItem(
int nItem,
LPCTSTR lpszItem,
int nImage
);
int InsertItem(
UINT nMask,
int nItem,
LPCTSTR lpszItem,
UINT nState,
UINT nStateMask,
int nImage,
LPARAM lParam
);
パラメーター
pItem
項目の属性を指定する Windows SDKに説明されているように LVITEM の構造体へのポインター。nItem
挿入する項目のインデックス。lpszItem
項目がコールバックの項目が項目のラベルが含まれている文字列のアドレスまたは LPSTR_TEXTCALLBACK。コールバックの項目については、CListCtrl::GetCallbackMaskを参照してください。nImage
項目がコールバックの項目が項目のイメージのインデックス、または I_IMAGECALLBACK。コールバックの項目については、CListCtrl::GetCallbackMaskを参照してください。nMask
nMask のパラメーターはパラメーターが有効であるため、どの項目の属性に合格したかを指定します。これは Windows SDKの LVITEM Structure で説明するマスクの値を一つ以上指定できます。有効値はまたは演算子とビットごとにまとめることができます。nState
項目の状態、状態イメージとオーバーレイ イメージが表示されます。詳細については、Windows SDK のトピック LVITEM Structure、有効なフラグの一覧については、List-View Item States を参照してください。nStateMask
状態のメンバーのすべてのビットを取得または変更する方法を示します。詳細については、Windows SDK の LVITEM Structure を参照してください。lParam
項目に関連付けられた 32 ビット アプリケーション固有の値。このパラメーターを指定した場合、nMask の属性 LVIF_PARAMを設定する必要があります。
戻り値
成功した場合は新しい項目または -1 のインデックス別の方法で。
解説
このメソッドを呼び出すと、LVM_INSERTITEM のメッセージをコントロールのウィンドウに送信される可能性があります。コントロールの関連のメッセージ ハンドラーは、項目のテキストを特定の条件下に設定できなかったことがあります。LVS_OWNERDRAWのようなウィンドウ スタイルの使用など)。これらの要件の詳細については、Windows SDKの LVM_INSERTITEM を参照してください。
使用例
CString strText;
int nColumnCount = m_myListCtrl.GetHeaderCtrl()->GetItemCount();
// Insert 10 items in the list view control.
for (int i = 0; i < 10; i++)
{
strText.Format(TEXT("item %d"), i);
// Insert the item, select every other item.
m_myListCtrl.InsertItem(LVIF_TEXT | LVIF_STATE, i, strText,
(i % 2) == 0 ? LVIS_SELECTED : 0, LVIS_SELECTED, 0, 0);
// Initialize the text of the subitems.
for (int j = 1; j < nColumnCount; j++)
{
strText.Format(TEXT("sub-item %d %d"), i, j);
m_myListCtrl.SetItemText(i, j, strText);
}
}
必要条件
ヘッダー: afxcmn.h