Usando o RC (a linha de comando do RC)

  • Artigo

Para iniciar o RC, use o seguinte comando.

RC [opções] script-file

O parâmetro script-file especifica o nome do arquivo de definição de recurso que contém os nomes, tipos, nomes de arquivo e descrições dos recursos a serem compilados.

O RC pode gerar arquivos de recurso separados para aplicativos que têm recursos neutros e específicos do idioma. Os desenvolvedores podem usar um arquivo de configuração de recurso ou definir opções de linha de comando para selecionar quais tipos de recursos e itens são recursos não localizáveis do arquivo de idioma neutro (LN) e quais são recursos localizáveis de arquivos MUI específicos do idioma. Para obter mais informações, consulte a Interface do usuário multilíngue.

O parâmetro options pode ser uma ou mais das seguintes opções de linha de comando.

Opções

/?

Exibe uma lista de opções de linha de comando.

/c

Define uma página de código usada pela conversão NLS.

/d

Define um símbolo para o pré-processador que você pode testar com a diretiva #ifdef.

/fm mresname

O RC cria um arquivo .RES de idioma neutro e um arquivo .RES dependente do idioma (MUI) usando script-file. Esta opção deve ser usada junto com a opção /fo resname. O RC chama o arquivo .RES de idioma neutro de resname.res e o arquivo .RES dependente do idioma (MUI) de mresname.res.

Windows Server 2003 e Windows XP/2000: essa opção não está disponível sem usar também as funções LoadMUILibrary e FreeMUILibrary em um sistema atualizado.

/fo resname

O RC cria um arquivo .RES chamado resname usando script-file.

Se a opção /fm mresname também estiver definida, o RC criará um arquivo .RES de idioma neutro e um arquivo .RES dependente do idioma (MUI).

Windows Server 2003 e Windows XP/2000: essa opção não está disponível sem usar também as funções LoadMUILibrary e FreeMUILibrary em um sistema atualizado.

/g1

Se /g1 estiver definido, o RC gerará um arquivo MUI se o único recurso localizável incluído no arquivo MUI for um recurso de versão. Se /g1 não estiver definido, o RC não gerará um arquivo MUI se o único recurso localizável incluído no arquivo MUI for um recurso de versão.

/h

Exibe a lista de opções da linha de comando.

/I

Pesquisa o diretório especificado antes de pesquisar os diretórios especificados pela variável de ambiente INCLUDE.

/j loctype

Tipos de recursos localizáveis que o RC coloca no arquivo .RES dependente do idioma (MUI). Se a opção /q também estiver definida, essa opção será ignorada e as informações no arquivo de configuração do RC terão precedência.

Windows Server 2003 e Windows XP/2000: essa opção não está disponível sem usar também as funções LoadMUILibrary e FreeMUILibrary em um sistema atualizado.

/k overtype

Tipos de recursos sobrepostos que o RC coloca no arquivo .RES de idioma neutro e no arquivo .RES dependente do idioma (MUI). Os tipos de recursos especificados pela opção /k devem ser um subconjunto daqueles especificados pela opção /j. Por exemplo, ?J2 ?J3 ?K3 especifica que o RC coloca o tipo de recurso 3 nos arquivos de idioma neutro e dependentes de idioma (MUI). Se a opção /q também estiver definida, essa opção será ignorada e as informações no arquivo de configuração do RC terão precedência.

Windows Server 2003 e Windows XP/2000: essa opção não está disponível sem usar também as funções LoadMUILibrary e FreeMUILibrary em um sistema atualizado.

/l langid

Especifica o idioma padrão para a compilação. Por exemplo, -l409 é equivalente a incluir a seguinte instrução na parte superior do arquivo de script de recurso: LANGUAGE LANG_ENGLISH,SUBLANG_ENGLISH_US

Para obter mais informações, consulte Identificadores de idioma.

/n

Termina em nulo todas as cadeias de caracteres na tabela de cadeia de caracteres.

/q Mui.RCConfig

Um arquivo de configuração do RC que segue o formato de arquivo de configuração do RC. O formato de arquivo de configuração do RC permite que os componentes autodescrevam informações de recursos, como controle de versão de recursos, caminho do arquivo MUI, tipos de recursos e itens. Esse arquivo especifica quais recursos vão para o arquivo .RES de idioma neutro e quais recursos vão para o arquivo .RES dependente do idioma (MUI). Essa opção e as informações fornecidas no arquivo de configuração do RC substituem as opções de linha de comando /j e /k.

Windows Server 2003 e Windows XP/2000: essa opção não está disponível sem usar também as funções LoadMUILibrary e FreeMUILibrary em um sistema atualizado.

/r

Ignorado. Fornecido para compatibilidade com makefiles existentes.

/u

Cancela a definição de um símbolo para o pré-processador.

/v

Exibe mensagens que relatam o andamento do compilador.

/x

Impede que o RC verifique a variável de ambiente INCLUDE ao procurar por arquivos de cabeçalho ou arquivos de recurso.

Comentários

As opções não diferenciam maiúsculas de minúsculas e um hífen (-) pode ser usado no lugar de uma barra (/). Você pode combinar opções de letra única se elas não exigirem nenhum parâmetro adicional.

O RC não gerará um arquivo MUI nos seguintes casos.

  • Não existem recursos localizáveis no arquivo .rc.
  • O único ID de idioma do recurso especificado no arquivo .rc é neutro (0x0).
  • O arquivo .rc tem recursos especificados em mais de um idioma. A exceção é que, se o arquivo .rc contiver dois idiomas e um for neutro (0x0), o RC gerará um arquivo MUI.

Para Mais informações, consulte os seguintes tópicos:

Interface do Usuário Multilíngue