Winres.exe (Editor de Localização de Recursos do Windows)

O Editor de Localização de Recursos do Windows, Winres.exe, é uma ferramenta de layout visual que ajuda especialistas em localização a localizar recursos da interface de utilizador (UI) do Windows Forms usados pelos formulários. Pode criar os ficheiros .resx ou .resources que são usados como entrada para Winres.exe usando um ambiente de design visual como o Microsoft Visual Studio. Para informações sobre a implementação de recursos em aplicações .NET Framework, consulte Recursos em aplicações .NET.

Winres.exe está instalado com o Visual Studio. Para executar a ferramenta, utilize o Prompt de Comando do Visual Studio Developer ou o PowerShell do Visual Studio Developer.

Sintaxe

winres resourceFile
winres /?

Arguments

Observações

O estado dos elementos da interface de utilizador de um formulário num projeto Windows Forms é normalmente armazenado em ficheiros de recursos, que são ou ficheiros baseados em XML com a extensão .resx ou as versões compiladas e binárias correspondentes com a extensão .resources. Winres.exe é uma ferramenta que permite edição limitada de qualquer tipo de ficheiro fora do ambiente de design Visual Studio. Especificamente, permite os seguintes tipos de operações de edição:

• Um ficheiro de recurso de cultura neutro ou específico pode ser editado para alterar as propriedades da interface do formulário ou dos seus controlos, como texto, tamanho ou posição.
• Ficheiros de recursos de cultura neutros ou específicos podem ser gerados a partir do ficheiro de recurso predefinido.
• Um ficheiro de recurso de cultura pode ser guardado como outro ficheiro de recurso de cultura. Por exemplo, um ficheiro de recurso em inglês (EUA) podia ser guardado como um ficheiro de recurso em polaco. Normalmente, o novo ficheiro era posteriormente editado para ser compatível com a nova cultura.

Veja também Organização Hierárquica de Recursos para Localização ou Organização Hierárquica de Recursos para Localização.

Winres.exe não pode converter um ficheiro .resx no seu ficheiro .resources correspondente; Usa antes a ferramenta Resgen.exe. Para mais informações sobre Resgen.exe, consulte Resgen.exe (Gerador de Ficheiros de Recursos).

Winres.exe é uma aplicação gráfica que recria uma versão em tempo de design de um formulário Windows Forms apenas a partir do ficheiro de recurso, sem ter acesso ao código-fonte. Winres.exe aloja o Windows Forms Designer e Properties a janela do Visual Studio. Estas funcionalidades permitem a edição visual de um ficheiro .resources ou .resx contendo um formulário Windows Forms. Normalmente, os localizadores usam Winres.exe para editar etiquetas de controlo e ajustar a localização e o tamanho dos controlos para acomodar as etiquetas da cultura alvo.

Se Winres.exe não conseguir resolver o tipo de controlo, cria um controlo marcador no ficheiro .resx ou .resources localizado. O controlo marcador aparece no formulário Windows Forms como uma janela com hachura. O tamanho e a posição da janela com hachuras correspondem aos do controlo real. Todas as propriedades localizáveis disponíveis para o controlo provisório aparecem na Properties janela. Quaisquer alterações que faças ao controlo provisório são guardadas para o controlo propriamente dito.

Winres.exe versus Visual Studio

De um modo geral, antes de começar a localizar os formulários Windows Forms de uma aplicação, deve decidir se quer usar o Visual Studio ou o Winres.exe como ferramenta de localização. A compatibilidade de versões, como descrito mais adiante, pode impedi-lo de mudar de uma ferramenta para outra.

A vantagem do Visual Studio é que pode usá-lo tanto para desenvolver como para localizar uma aplicação. Para localizar um formulário, após a conclusão do desenvolvimento, defina os formulários LocalizableAttribute (a Localizable propriedade no Properties editor) para true e altere a sua Language propriedade para a cultura alvo desejada. Depois, edita as cadeias e ajusta a localização e o tamanho dos controlos para acomodar as cadeias para a cultura alvo. Quando guarda o ficheiro .resx localizado, o Visual Studio escreve apenas as propriedades localizáveis (propriedades que mudaram na cultura de destino) no ficheiro. O Visual Studio cria automaticamente um assembly de satélite para o ficheiro .resx localizado na localização correta do diretório.

Embora o Visual Studio ofereça um ambiente integrado de desenvolvimento e localização, Winres.exe é a ferramenta recomendada a utilizar se a localização for feita por localizadores terceiros. Como Winres.exe é apenas uma ferramenta de localização, permite uma separação mais limpa do código de uma aplicação dos formulários a localizar, o que é mais prático para gerir grandes projetos.

Usar Winres.exe

Para localizar usando Winres.exe, deve primeiro desenvolver uma aplicação usando um designer visual como o Windows Forms Designer no Visual Studio. Quando o desenvolvimento estiver concluído, defina o LocalizableAttribute formulário (a Localizable propriedade no Properties editor) para true, e depois entregue o ficheiro .resx da cultura padrão a um localizador de terceiros. Este ficheiro .resx contém informação extra que Winres.exe utiliza para recriar uma versão em tempo de design do formulário original.

As versões finais dos ficheiros de recursos de cultura podem finalmente ser usadas para criar versões localizadas da aplicação. Para mais informações, consulte Recursos em aplicações .NET.

Winres.exe possui as seguintes funcionalidades e capacidades:

• Os Winres podem operar em Modo de Ficheiro Único (SFM) ou Modo de Ficheiro Visual Studio (VSFM). O SFM é o modo legado onde a informação completa sobre o formulário e o seu conteúdo é armazenada no ficheiro de recursos. O VSFM armazena apenas as alterações culturais no ficheiro de recurso.

• Uma janela de reporte de erros, acoplada no canto inferior esquerdo da janela principal.

• Os atalhos podem ser verificados para duplicados: no Format menu, clique no comando Verificar Atalhos.

Compatibilidade de versões

Deves usar a versão do Winres.exe que foi lançada com o .NET Framework que estás a usar. A tabela seguinte lista as versões compatíveis:

Examples

Para localizar um ficheiro .resx ou .resources associado a um formulário

1. Para executar Winres.exe, introduza winres o prompt de comandos do programador.

2. Para abrir os recursos predefinidos de um formulário a localizar, selecione Ficheiro > Abrir e navegue até ao ficheiro para o abrir.

   -ou-

   Especifique o ficheiro a abrir na linha de comandos quando iniciar Winres.exe. O comando seguinte começa Winres.exe e carrega o formulário associado a TestApp.resx no Designer de Formulários.

   winres TestApp.resx
   

   O comando seguinte começa Winres.exe e carrega o formulário associado a TestApp.resources no Designer de Formulários.

   winres TestApp.resources
   

   Observação

   Se o formulário cujos recursos está a editar for um formulário herdado, tanto o assembly contém o formulário herdado como o assembly que contém o formulário herdeiro (derivado) devem estar registados no Global Assembly Cache (GAC), ou residir no mesmo diretório que WinRes.exe. Para mais informações sobre a instalação de componentes do .NET Framework no GAC, consulte Global Assembly Cache.

3. Selecione os controlos no formulário e altere as suas Text e outras propriedades para refletir a cultura localizada e a sua língua. Mover ou redimensionar os controlos conforme necessário para acomodar o texto localizado.

4. Para guardar a versão localizada do ficheiro .resx ou .resources, clique no Save ícone ou selecione Guardar ficheiro>. A ferramenta mostra a janela Selecionar Cultura .

5. Selecione a cultura e o modo de ficheiro apropriados e depois clique em OK.

   A ferramenta guarda o ficheiro usando a convenção de nomenclatura que o runtime espera para ficheiros de recursos localizados. Por exemplo, se localizar TestApp.resources para alemão na Alemanha, a ferramenta guarda o ficheiro como TestApp.de-DE.resources. Se localizar TestApp.resx para alemão na Alemanha, a ferramenta guarda o ficheiro como TestApp.de-DE.resx. Para mais informações sobre convenções de nomenclatura de recursos, consulte Pacotes e Implementação de recursos. Para uma lista dos nomes de cultura pré-definidos usados pelo runtime, veja a CultureInfo classe.

Consulte também

• LocalizableAttribute
• CultureInfo
• ResourceManager
• ResourceReader
• ResourceWriter
• Tools
• Recursos em aplicações .NET
• Globalização e localização