CToolBarCtrl::AddStrings

更新 : 2007 年 11 月

ツール バー コントロールで利用できる文字列のリストに、新しい文字列を追加します。

int AddStrings(
   LPCTSTR lpszStrings 
);

パラメータ

  • lpszStrings
    ツール バーの文字列リストに追加される NULL で終わる文字列を 1 つ以上持つバッファのアドレス。最後の文字列は、2 つの NULL 文字で終わります。

戻り値

正常終了した場合は追加された最初の新しい文字列の 0 から始まるインデックスを返します。それ以外の場合は -1 を返します。

解説

バッファ内の文字列は、NULL 文字で区切ります。最後の文字列には 2 つの NULL 文字を持つようにします。有効な文字列定数は、次のように記述します。

// one null added automatically
lpszStrings = _T("Only one string to add\0");   

または、

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");   

CString では 1 つしか NULL 文字を持てないので、この関数に CString オブジェクトは渡せません。

必要条件

ヘッダー : afxcmn.h

参照

参照

CToolBarCtrl クラス

階層図

CToolBarCtrl::AddString

CToolBarCtrl::AddButtons

CToolBarCtrl::InsertButton

CToolBarCtrl::AddBitmap

その他の技術情報

CToolBarCtrl のメンバ