Compartilhar via


CToolBarCtrl::AddStrings

Adiciona uma nova cadeia de caracteres ou cadeias de caracteres para a lista de cadeias de caracteres disponíveis para um controle de barra de ferramentas.

int AddStrings(
   LPCTSTR lpszStrings 
);

Parâmetros

  • lpszStrings
    Endereço de um buffer que contém uma ou mais cadeias de caracteres NULL- terminadas para adicionar à lista de cadeia de caracteres de barra de ferramentas.A cadeia de caracteres a última deve ser finalizada com dois caracteres nulos.

Valor de retorno

O índice com base zero da primeira nova cadeia de caracteres com êxito; se adicionada se não – 1.

Comentários

As cadeias de caracteres em buffer devem ser separados por um caractere nulo.Você deve garantir que a cadeia de caracteres a última possui dois terminadores nulos.Para formatar corretamente uma cadeia de caracteres constante, você pode escrevê-la como:

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

ou:

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

Você não deve passar um objeto de CString a essa função pois não é possível ter mais de um caractere nulo em CString.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CToolBarCtrl

Gráfico de hierarquia

CToolBarCtrl::AddString

CToolBarCtrl::AddButtons

CToolBarCtrl::InsertButton

CToolBarCtrl::AddBitmap