Partilhar via


Como criar símbolos (C++)

Quando você está iniciando um novo projeto, pode ser conveniente mapear os nomes de símbolo necessários antes de criar os recursos aos quais eles serão atribuídos.

Observação

Se o projeto ainda não contiver um arquivo .rc, consulte Como criar recursos.

A caixa de diálogo Símbolos de Recurso permite que você adicione novos símbolos de recurso, altere os símbolos exibidos ou pule para o local no código-fonte em que um símbolo está em uso.

Esta caixa de diálogo contém as seguintes propriedades:

Propriedade Descrição
Nome Exibe o nome do símbolo.

Para obter mais informações, consulte Restrições de nome de símbolo.
Valor Exibe o valor numérico do símbolo.

Para obter mais informações, consulte Restrições de valor de símbolo.
Em uso Quando selecionado, especifica que o símbolo está sendo usado por um ou mais recursos.

O recurso ou os recursos são listados na caixa Usado por.
Exibe símbolos somente leitura Quando selecionado, exibe recursos somente leitura.

Por padrão, a caixa de diálogo Símbolo de Recurso exibe apenas os recursos modificáveis em seu arquivo de script de recurso, mas com essa opção selecionada, recursos modificáveis aparecem em texto em negrito e recursos somente leitura aparecem em texto sem formatação.
Usado por Exibe o recurso ou os recursos usando o símbolo selecionado na lista de símbolos.

Para mover para o editor de um determinado recurso, selecione o recurso na caixa Usado por e escolha Exibir Uso.
Novo Abre a caixa de diálogo Novo Símbolo, que permite definir o nome e, se necessário, um valor para um novo identificador de recurso simbólico.
Altere Abre a caixa de diálogo Alterar Símbolo, que permite alterar o nome ou o valor de um símbolo.

Se o símbolo for para um controle ou recurso em uso, o símbolo poderá ser alterado somente no editor de recursos correspondente. Para mais informações, consulte Gerenciar símbolos.
Exibir Uso Abre o recurso que contém o símbolo no respectivo editor de recursos.

Criar símbolos

Para criar um novo símbolo

  1. Na caixa de diálogo Símbolos de Recurso, escolha Novo.

  2. Na caixa Nome, digite um nome de símbolo.

  3. Aceite o valor do símbolo atribuído ou digite um novo valor na caixa Valor.

  4. Selecione OK para adicionar o novo símbolo à lista de símbolos.

Observação

Se você digitar um nome de símbolo que já existe, uma caixa de mensagem será exibida informando que um símbolo com esse nome já está definido. Você não pode definir dois ou mais símbolos com o mesmo nome, mas pode definir símbolos diferentes com o mesmo valor numérico.

Para exibir símbolos de recurso

No Modo de Exibição de Recurso, clique com o botão direito do mouse no arquivo .rc e selecione Símbolos de Recurso para exibir uma tabela de símbolos de recurso na caixa de diálogo Símbolos de Recurso.

Observação

Para ver símbolos predefinidos, marque a caixa de seleção Mostrar símbolos somente leitura.

Para abrir o editor de recursos para um determinado símbolo

Ao navegar por símbolos nos Símbolos de Recurso, talvez você queira mais informações sobre como um símbolo específico é usado. O botão Exibir Uso fornece uma maneira rápida de obter essas informações.

  1. Na caixa de diálogo Símbolos de Recurso na caixa Nome, selecione um símbolo.

  2. Na caixa Usado por, selecione o tipo de recurso de seu interesse.

  3. Selecione o botão Exibir Uso.

    O recurso aparece na janela apropriada do editor.

Requisitos

Win32

Confira também

Identificadores de recursos (símbolos)
Como gerenciar símbolos
IDs de símbolos predefinidos