Partilhar 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 CToolBarCtrl

Gráfico da hierarquia

CToolBarCtrl::AddString

CToolBarCtrl::AddButtons

CToolBarCtrl::InsertButton

CToolBarCtrl::AddBitmap