Partilhar via


CToolBarCtrl::AddStrings

Adiciona uma nova seqüência de caracteres ou seqüências de caracteres à lista de seqüências de caracteres disponível para um controle de barra de ferramentas.

int AddStrings(
   LPCTSTR lpszStrings 
);

Parâmetros

  • lpszStrings
    Endereço de um buffer que contém um ou mais seqüências de terminação nula para adicionar à lista de seqüência de caracteres da barra de ferramentas.Última seqüência de caracteres deve ser terminada com dois caracteres nulo.

Valor de retorno

O índice baseado em zero da primeira seqüência de caracteres novo adicionado se bem-sucedida; caso contrário, – 1.

Comentários

Cadeias de caracteres no buffer devem ser separadas por um caractere nulo.Certifique-se de que a última seqüência de caracteres tem dois terminadores nulo.Para formatar uma seqüência de caracteres constante corretamente, você pode escrever sistema autônomo:

// 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 CString objeto para essa função, pois ele não é possível ter mais de um caractere nulo em uma CString.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe CToolBarCtrl

Gráfico de hierarquia

CToolBarCtrl::AddString

CToolBarCtrl::AddButtons

CToolBarCtrl::InsertButton

CToolBarCtrl::AddBitmap

Outros recursos

CToolBarCtrl membros