Partilhar via


Editor de cadeias de caracteres (C++)

Uma tabela de cadeia de caracteres é um recurso do Windows que contém uma lista de IDs, valores e legendas para todas as cadeias de caracteres do seu aplicativo. Por exemplo, os prompts da barra de status estão localizados na tabela de strings.

Ao desenvolver um aplicativo, você pode ter várias tabelas de cadeia de caracteres — uma para cada idioma ou condição. No entanto, um módulo executável tem apenas uma tabela de cadeia de caracteres. Um aplicativo em execução pode fazer referência a várias tabelas de cadeia de caracteres se você colocar as tabelas em DLLs diferentes.

As tabelas de cadeia de caracteres facilitam a localização do aplicativo em diferentes idiomas. Se todas as cadeias de caracteres estiverem em uma tabela de cadeias de caracteres, você poderá localizar o aplicativo traduzindo as cadeias de caracteres (e outros recursos) sem alterar o código-fonte. Esta situação é mais desejável do que encontrar e substituir manualmente várias cadeias de caracteres em arquivos de origem.

Observação

O Windows não permite a criação de tabelas de cadeia de caracteres vazias. Se você criar uma tabela de cadeia de caracteres sem entradas, ela será excluída automaticamente quando você salvar o arquivo de recurso.

Como Fazer

O String Editor permite:

Para localizar um recurso de cadeia de caracteres na tabela de cadeia de caracteres

  1. Abra a tabela de strings clicando duas vezes no seu ícone na Vista de Recursos.

  2. Vá para o menu Editar>Localizar e Substituir e escolha Localizar.

  3. Na caixa Localizar, selecione uma frase de pesquisa anterior da lista pendente ou insira o texto da legenda ou o identificador de recurso da frase que pretende localizar.

  4. Selecione uma das opções Localizar e selecione Localizar próximo.

Sugestão

Para usar expressões regulares ao pesquisar arquivos, use o comando Localizar em arquivos no menu Editar .

Digite uma expressão regular que corresponda a um padrão ou selecione o botão à direita da caixa Localizar o quê para exibir uma lista das expressões regulares de pesquisa. Quando se seleciona uma expressão desta lista, ela é substituída pelo texto de pesquisa na caixa Localizar.

Se você usar expressões regulares, verifique se a caixa de seleção Usar: expressões regulares está marcada.

Para adicionar ou excluir um recurso de cadeia de caracteres

Você pode inserir ou excluir rapidamente entradas na tabela de cadeia de caracteres usando o Editor de Cadeia de Caracteres. Novas cadeias de caracteres são colocadas no final da tabela e recebem o próximo identificador disponível. Você pode editar as propriedades ID, Valor ou Legenda na janela Propriedades , conforme necessário.

O Editor de Cadeia de Caracteres garante que você não use uma ID que já esteja em uso. Se você selecionar um ID já em uso, o Editor de Cadeia de Caracteres irá notificá-lo e, em seguida, atribuir um ID exclusivo genérico, por exemplo IDS_STRING58113.

Para adicionar uma entrada de tabela de cadeia de caracteres

  1. Abra a tabela de strings clicando duas vezes no seu ícone na Vista de Recursos.

  2. Clique com o botão direito do mouse na tabela de cadeia de caracteres e escolha Nova cadeia de caracteres.

  3. No Editor de Cadeia de Caracteres, selecione um ID na lista suspensa ID ou digite um ID diretamente no local.

  4. Edite o Valor, se necessário.

  5. Digite uma entrada para a legenda.

    Observação

    Cadeias de caracteres nulas não são permitidas em tabelas de cadeia de caracteres do Windows. Se você criar uma entrada na tabela de cadeia de caracteres que seja uma cadeia de caracteres nula, receberá uma mensagem solicitando que insira uma cadeia de caracteres para essa entrada de tabela.

Para eliminar uma entrada de tabela de cadeia de caracteres

Selecione a entrada que deseja excluir e siga um destes procedimentos:

  • Vá para o menu Editar>excluir.

  • Clique com o botão direito do mouse na cadeia de caracteres para excluir e escolha Excluir.

  • Pressione a tecla Delete .

Para mover uma cadeia de caracteres de um arquivo de script de recurso para outro

  1. Abra as tabelas de cadeia de caracteres em ambos os arquivos .rc.

  2. Clique com o botão direito do mouse na cadeia de caracteres para mover e escolha Recortar.

  3. Coloque o cursor na janela do Editor de Cadeia de Caracteres de destino.

  4. No arquivo .rc para o qual você deseja mover a cadeia de caracteres, clique com o botão direito do mouse e escolha Colar.

Observação

Se a ID ou Valor da cadeia de caracteres movida entrar em conflito com uma ID ou valor existente no arquivo de destino, essa ID ou o Valor da cadeia de caracteres movida será alterado.

Para alterar as propriedades de um recurso de cadeia de caracteres

Você pode usar a edição no local para alterar as propriedades ID, Value e Caption.

Observação

Você também pode editar as propriedades de uma cadeia de caracteres na janela Propriedades.

Para alterar uma cadeia de caracteres ou seu identificador

  1. Abra a tabela de strings clicando duas vezes no seu ícone na Vista de Recursos.

  2. Selecione a cadeia de caracteres que deseja editar e clique duas vezes na coluna ID, Valor ou Legenda , então você pode:

    • Selecione um ID na lista suspensa ID ou digite um ID diretamente no local.

    • Digite um número diferente na coluna Valor .

    • Digite as edições na coluna Legenda.

Para alterar a propriedade caption de vários recursos de cadeia de caracteres

  1. Abra a tabela de strings clicando duas vezes no seu ícone na Vista de Recursos.

  2. Selecione as cadeias de caracteres que deseja alterar mantendo pressionada a tecla Ctrl enquanto seleciona cada uma delas.

  3. Na janela Propriedades, digite um novo valor para a propriedade que você deseja alterar.

  4. Pressione Enter.

Para adicionar formatação ou caracteres especiais a um recurso de cadeia de caracteres

  1. Abra a tabela de strings clicando duas vezes no seu ícone na Vista de Recursos.

  2. Selecione a cadeia de caracteres que deseja modificar.

  3. Na janela Propriedades, adicione qualquer uma das sequências de escape padrão listadas abaixo ao texto na caixa Legenda e pressione Enter.

    Para conseguir isso... Digite isto...
    Nova linha \n
    Retorno de carro \r
    Separador \t
    Barra inversa (\) \\
    Caractere ASCII \ddd (notação octal)
    Alerta (campainha) \um

    Observação

    O Editor de Cadeia de Caracteres não suporta o conjunto completo de caracteres ASCI escapados. Você só pode usar os listados acima.

Requerimentos

Win32

Ver também

Editores de Recursos
Cadeias de caracteres
Sobre o Strings
Personalizando layouts de janela