TB_ADDSTRING mensagem

Adiciona uma nova cadeia de caracteres ao pool de cadeias de caracteres da barra de ferramentas.

Parâmetros

wParam

Manipule para a instância do módulo com um arquivo executável que contém o recurso de cadeia de caracteres. Se lParam , em vez disso, apontar para uma matriz de caracteres com uma ou mais cadeias de caracteres, defina esse parâmetro como NULL.

lParam

Identificador de recurso para o recurso de cadeia de caracteres ou um ponteiro para uma matriz TCHAR. Consulte Observações.

Valor retornado

Retorna o índice da primeira nova cadeia de caracteres se tiver êxito ou -1 caso contrário.

Comentários

Se wParam for NULL, lParam apontará para uma matriz de caracteres com uma ou mais cadeias de caracteres terminadas em nulo. A última cadeia de caracteres na matriz deve ser encerrada com dois caracteres nulos.

Se wParam for o HINSTANCE do aplicativo ou de outro módulo que contém um recurso de cadeia de caracteres, lParam será o identificador de recurso da cadeia de caracteres. Cada item na cadeia de caracteres deve começar com um caractere separador arbitrário e a cadeia de caracteres deve terminar com dois desses caracteres. Por exemplo, o texto de três botões pode aparecer na tabela de cadeia de caracteres como "/New/Open/Save//". A mensagem retorna o índice de "Novo" no pool de cadeias de caracteres da barra de ferramentas e os outros itens estão em posições consecutivas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Commctrl.h
Nomes Unicode e ANSI	TB_ADDSTRINGW (Unicode) e TB_ADDSTRINGA (ANSI)