Partilhar via

Preparando um arquivo de configuração de recurso

Os utilitários MUIRCT e RC Compiler descritos em Resource Utilities fornecem uma opção de linha de comando que permite especificar um arquivo de configuração de recursos para os recursos do idioma base. O uso deste arquivo XML público e legível por humanos permite mais controle sobre a divisão de recursos do que pode ser obtido usando as opções de linha de comando regulares dos utilitários. No entanto, mesmo que você não forneça um arquivo de configuração de recurso como entrada, o LN e os arquivos de recursos específicos do idioma conterão dados de configuração de recursos.

Todos os arquivos de configuração de recursos para aplicativos Win32 começam e terminam de forma idêntica:

<?xml version="1.0" encoding="utf-8"?> 
<localization>

<resources>
        
        <!-- a single win32Resources element goes here -->

</resources>
</localization>

Este tópico se concentra nos aspetos do esquema XML que são úteis na criação de código não gerenciado no Windows Vista e posterior. Em particular, ele está preocupado apenas com o comportamento do elemento win32Resources.

Elemento win32Resources

O elemento win32Resources tem os atributos descritos na tabela a seguir.

Nome do atributo Obrigatório Descrição
Tipo de ficheiro Não Tipo de ficheiro. Deve ser sempre "Aplicação".
soma de verificação Não Valor de soma de verificação a ser exibido nos dados de configuração de recursos do arquivo LN e arquivos de recursos específicos do idioma. Por exemplo, esse atributo permite copiar a soma de verificação de um único arquivo de recurso específico do idioma, por convenção o de inglês (Estados Unidos), e colocar a soma de verificação em um arquivo de recurso específico de idioma diferente. A soma de verificação pode ser especificada como uma cadeia numérica hexadecimal que não tem mais de 32 caracteres. O valor numérico deve ser contido em um número de 128 bits.
Idioma Não Marca de idioma compatível com IETF BCP 47 (Windows Vista e posterior), por exemplo, en-US para inglês (Estados Unidos).
ultimateFallbackLanguage Não Idioma a ser inserido nos dados de configuração de recursos para o arquivo LN, representando o idioma de fallback final a ser usado em uma pesquisa por um arquivo de recurso específico do idioma correspondente. Se o gerenciador de recursos não conseguir carregar um ficheiro de recurso solicitado a partir dos idiomas de interface do utilizador preferidos da thread, utilizará um idioma de recurso final como sua última tentativa. A etiqueta de idioma compatível com IETF BCP 47 (Windows Vista e posterior), por exemplo, en-US para o inglês (Estados Unidos).
ultimateFallbackLocalização Não Local de recurso. Especifique "interno" se os recursos finais de fallback estiverem compilados no ficheiro LN. Especifique "externo" (padrão) se o arquivo LN for fazer referência a um arquivo de recurso específico do idioma para seus recursos de fallback finais.

No arquivo de configuração de recurso, o elemento win32Resources tem os subelementos descritos na tabela a seguir.

Nome do elemento Descrição
recursosLocalizados Recursos que encapsulam informações sobre os tipos de recursos e recursos individuais contidos em um arquivo de recurso específico do idioma.
neutral Recursos Recursos que encapsulam informações sobre os tipos de recursos contidos em um arquivo LN.

Elemento localizedResources

Elemento de recursos localizados. Por padrão, esse elemento não tem atributos e apenas um tipo de subelemento. É apenas um contêiner para elementos resourceType.

Nome do atributo Descrição
tipoDeRecurso Tipo de um recurso individual contido em um arquivo de recurso específico do idioma.

elemento neutralResources

Elemento de recursos neutros. Este elemento é apenas um contêiner para elementos resourceType.

Nome do atributo Descrição
tipoDeRecurso Tipo de um único recurso contido em um arquivo LN.

Elemento resourceType

O elemento resourceType encapsula informações sobre um único tipo de recurso ou recurso individual. Tem os atributos listados abaixo.

Atenção

Alguns defeitos de configuração de recursos são detetados apenas pelo Compilador RC ou MUIRCT, dependendo do arquivo de recurso de entrada ou do conteúdo do arquivo binário. Os erros resourceType no arquivo de configuração de recurso que não existem no arquivo de entrada não são detetados, resultando em um comportamento inesperado. Os usuários podem estar usando um arquivo de configuração de recurso defeituoso e não sabem até que introduzam binários que usam as partes quebradas do arquivo de configuração de recurso, o que cria a aparência de que as quebras são dos binários atuais.

Nome do atributo Obrigatório Descrição
typeNameId Sim Digite o nome ou identificador do recurso. Especifique um nome de cadeia de caracteres ou um número. Se estiver usando um número, coloque a cadeia de caracteres com um "#" para indicar que ela representa um número. Cada elemento resourceType deve ter apenas um atributo typeNameId.
nome do item Não Cadeia de caracteres de nome de item para o recurso, a ser colocada no arquivo de recurso específico do idioma. Você pode especificar vários nomes, separados por espaços em branco, por exemplo, "HTML MOFDATA".
itemId Não Identificador do item de recurso individual, a ser colocado no arquivo de recurso específico do idioma. O item pode ser especificado como um intervalo (por exemplo, "1-12") ou por identificadores individuais separados por espaços em branco (por exemplo, "1 3 4").
stringId Não Identificador de cadeia de caracteres para item de recurso individual, a ser colocado no arquivo de recurso específico do idioma. A cadeia de caracteres pode ser especificada como um intervalo (por exemplo, "1-12") ou por identificadores individuais separados por espaços em branco (por exemplo, "1 3 4"). Este atributo permite a especificação de entradas de tabela de cadeia de caracteres localizáveis e não localizáveis. Deve ser usado em conjunto com o typeNameId valor "6", denotando um tipo de recurso de entrada de tabela de strings.
As cadeias de caracteres são armazenadas em blocos de 16 em uma tabela de cadeia de caracteres. Por exemplo, as cadeias de caracteres de 0 a 15 são armazenadas em um único bloco de item de recurso e podem ser referenciadas no arquivo de configuração de recursos como itemId 1 ou como stringId "0-15". Por exemplo, se houver cinco cadeias de caracteres localizáveis e três cadeias de caracteres não localizáveis, você deverá atribuir identificadores de cadeia de caracteres 0-4 para as cadeias de caracteres localizáveis e identificadores de cadeia de caracteres 16-18 para as cadeias de caracteres não localizáveis. Se você não organizar cadeias de caracteres dessa maneira, os blocos afetados de cadeias de caracteres serão colocados no arquivo LN e no arquivo de recurso específico do idioma.

Se especificar os atributos itemName, itemIde/ou stringId para um determinado tipo de recurso no elemento localizedResource, somente esses itens ou cadeias de caracteres especificados para o tipo de recurso designado serão colocados no ficheiro de recursos específico do idioma. Se um elemento resourceType for especificado sem qualquer nome de item explícito, identificador de item ou identificador de cadeia de caracteres, todos os itens do tipo de recurso especificado serão colocados no arquivo de recurso específico do idioma. Itens ou tipos não listados em qualquer elemento localizedResource são colocados no arquivo LN.

A seguir estão os tipos de recursos padrão e seus identificadores numéricos:

  • CURSOR(1)
  • BITMAP(2)
  • ÍCONE(3)
  • EMENTA(4)
  • DIÁLOGO(5)
  • CORDA(6)
  • FONTDIR(7)
  • FONTE(8)
  • ACELERADORES(9)
  • RCDATA(10)
  • TABELA DE MENSAGENS(11)
  • GROUP_CURSOR(12)
  • GROUP_ICON(14)
  • VERSÃO(16)
  • HTML(23)

Exemplo

<?xml version="1.0" encoding="utf-8"?> 
<localization>
  <resources>
    <win32Resources fileType="Application">
      <neutralResources>
        <resourceType
           typeNameId="#16"
        />
      </neutralResources>
      <localizedResources> 
         <resourceType
                typeNameId="#2"
                itemId="5 6 7 8 9 10 11 12"
                itemName="HTML PRI"
         />
         <resourceType
                typeNameId="#4"
         />
         <resourceType
                typeNameId="#5"
         />
         <resourceType
                typeNameId="#6"
         />
         <resourceType
                typeNameId="#9"
         />
         <resourceType
                typeNameId="#11"
         />
         <resourceType
                typeNameId="#16"
         />
         <resourceType
                typeNameId="HTML"
         />
         <resourceType
                typeNameId="#23"
         />
         <resourceType
                typeNameId="#240"
         />
         <resourceType
                typeNameId="#1024"
         />
         <resourceType
                typeNameId="MY_TYPE"
         />
      </localizedResources> 
    </win32Resources>
  </resources>
</localization>

Comentários

Se você incluir qualquer tipo de recurso ICON(3), DIALOG(5), STRING(6) ou VERSION(16) no elemento neutralResources, será necessário duplicar essa entrada no elemento localizedResources. Você pode ver isso ilustrado no exemplo acima, onde o tipo de recurso 16 aparece nas seções de recursos neutros e localizados.

Preparação de recursos

  • Last updated on