Recurso STRINGTABLE

Define um ou mais recursos de cadeia de caracteres para um aplicativo. Os recursos de cadeia de caracteres são simplesmente cadeias de caracteres Unicode ou ASCII terminadas em nulo que podem ser carregadas quando necessário do arquivo executável, usando a função LoadString .

Há duas maneiras de formatar uma instrução STRINGTABLE :

STRINGTABLE  [optional-statements] {stringID string  ...}

- ou -

STRINGTABLE
  [optional-statements]
BEGIN
stringID string
. . .
END

Parâmetros

instruções opcionais

Esse parâmetro pode ser zero ou mais das instruções a seguir.

Instrução	Descrição
Dword CHARACTERISTICS	Informações definidas pelo usuário sobre um recurso que pode ser usado por ferramentas que leem e gravam arquivos de recurso. Para obter mais informações, consulte CARACTERÍSTICAS.
IDIOMA,sublanguagem	Especifica o idioma do recurso. Para obter mais informações, consulte LANGUAGE.
VERSIONdword	Número de versão definido pelo usuário para o recurso que pode ser usado por ferramentas que leem e gravam arquivos de recurso. Para obter mais informações, consulte VERSÃO.

 

stringID

Inteiro de 16 bits sem sinal que identifica o recurso.

cadeia de caracteres

Uma ou mais cadeias de caracteres, entre aspas. A cadeia de caracteres não deve ter mais de 4097 caracteres e deve ocupar uma única linha no arquivo de origem (a menos que um '\' seja usado como uma continuação de linha). Para adicionar um retorno de carro à cadeia de caracteres, use esta sequência de caracteres: \012. Por exemplo, "Linha um\012Line dois" define uma cadeia de caracteres que é exibida da seguinte maneira:

Line one
Line two

Para inserir aspas na cadeia de caracteres, use a seguinte sequência: "". Por exemplo, """Linha três""" define uma cadeia de caracteres que é exibida da seguinte maneira:

"Line three"

Para codificar caracteres Unicode, use um "L" seguido pelos caracteres Unicode entre aspas. Consulte a seção Exemplos para obter um exemplo.

O compilador de recursos também dá suporte a continuações de linha na cadeia de caracteres. Consulte a seção Exemplos para obter um exemplo.

Determinados atributos também têm suporte para compatibilidade com versões anteriores. Para obter mais informações, consulte Atributos de recurso comuns.

Comentários

O RC aloca 16 cadeias de caracteres por seção e usa o valor do identificador para determinar qual seção deve conter a cadeia de caracteres. Cadeias de caracteres cujos identificadores diferem apenas nos 4 bits inferiores são colocadas na mesma seção.

Exemplos

O exemplo a seguir demonstra o uso da instrução STRINGTABLE para exibir cadeias de caracteres ASCII:

#define IDS_HELLO    1
#define IDS_GOODBYE  2

STRINGTABLE
{
    IDS_HELLO,   "Hello"
    IDS_GOODBYE, "Goodbye"
} 

O exemplo a seguir mostra como codificar caracteres Unicode:

STRINGTABLE
BEGIN
IDS_CHINESESTRING L"\x5e2e\x52a9"
IDS_RUSSIANSTRING L"\x0421\x043f\x0440\x0430\x0432\x043a\x0430"
IDS_ARABICSTRING L"\x062a\x0639\x0644\x064a\x0645\x0627\x062a"
END

O exemplo a seguir mostra cadeias de caracteres com ASCII e Unicode. Observe que as cadeias de caracteres sem o "L" inicial usam o formato de escape de 2 dígitos:

STRINGTABLE
BEGIN
IDS_1 L"5\x00BC-Inch Floppy Disk"
IDS_1a "5\xBC-Inch Floppy Disk"
IDS_2 L"Don't confuse \x2229 (intersection) with \x222A (union)"
IDS_3 "Copyright \xA92001"
IDS_3a L"Copyright \x00a92001"
END

O exemplo a seguir mostra como as continuações de linha podem ser usadas:

STRINGTABLE
BEGIN
IDS_VERYLONGSTRING "blah blah blah blah blah blah \
blah blah blah blah blah blah \
blah blah blah blah blah blah \
blah blah blah blah blah blah"
END

Confira também

Loadstring

ACELERADORES

CARACTERÍSTICAS

LÍNGUA

MENU

RCDATA

VERSÃO