Winres.exe (Editor de recursos do Windows Forms)
O Editor de recursos de Formulários do Windows, Winres.exe, é uma ferramenta visual de layout que ajuda especialistas em localização a localizar (traduzir) recursos da interface do usuário (UI) de formulários do Windows os recursos usados por formulários. Os arquivos .resx ou .resources que são usados como entrada para Winres.exe podem ser criados usando um ambiente visual de design como o Microsoft Visual Studio. Para obter informações sobre a implantação de recursos.NET Framework, consulte Recursos em aplicativos.
winres resourceFile
winres /?
Comentários
Argumento |
Descrição |
|---|---|
resourceFile |
O arquivo de recurso para traduzir. Este arquivo deve ser um arquivo Windows Forms. resx ou. Resources formulário gerado pelo designer de Visual Studio. Winres.exe não pode abrir os arquivos. resx ou. Resources genéricos. |
Opção |
Descrição |
|---|---|
/? |
Exibe sintaxe de comando e opções para a ferramenta. |
O estado de elementos de interface do usuário de um formulário em um projeto Windows Forms são normalmente armazenados em arquivos de recursos que são ambos arquivos baseados em XML com a extensão. resx ou correspondente compilado, versões binárias com o. Resources de extensão. Winres.exe é uma ferramenta que permite a edição limitada de qualquer tipo de arquivo fora do ambiente de design do Visual Studio. Especificamente, permite que os seguintes tipos de operações de edição:
Um arquivo de recursos de cultura neutra ou específico pode ser editado para alterar as propriedades da interface do usuário do formulário ou de seus controles, como, por exemplo, seu texto, tamanho ou posição.
Neutro ou arquivos de recursos de cultura específica podem ser gerados a partir do arquivo de recurso padrão.
Um arquivo de recursos de cultura pode ser salvo como outro arquivo de recurso de cultura. Por exemplo, um arquivo de recurso de inglês (EUA) poderia ser salvo como um arquivo de recurso polonês. Normalmente o novo arquivo seria ser editado posteriormente para ser compatível com a cultura de nova.
Para obter mais informações, consulte Organização hierárquica para localização de recursos e Organização hierárquica para localização de recursos e Organização hierárquica para localização de recursos e Organização hierárquica de recursos para localização.
Winres.exe não é possível converter um arquivo. resx em seu arquivo. Resources correspondente; Use a ferramenta ResGen. exe. Para obter mais informações sobre Resgen. exe, consulte Resgen. exe (gerador do arquivo de recurso).
Winres.exe é um aplicativo gráfico que recria uma versão de tempo de design de um formulário do Windows Forms apenas ao arquivo de recurso, sem ter acesso ao código-fonte. Janela do Winres.exe hosts Visual Studio Windows Forms Designer de formulário e propriedades. Esses recursos permitem a edição visual de um arquivo. Resources ou. resx contendo um formulário do Windows Forms. Normalmente os localizadores usam Winres.exe para editar etiquetas de controle e ajustar o local e tamanho dos controles para acomodar os rótulos para a cultura de destino.
Se Winres.exe não é possível resolver o tipo de um controle, ele cria um controle placeholder no arquivo. Resources ou localizadas. resx. O controle do espaço reservado aparece no formulário Windows Forms, como uma janela tracejada. O tamanho e posição da janela tracejada corresponde do controle real. Todas as propriedades localizáveis disponíveis para o controle do espaço reservado aparecem na janela Propriedades. As alterações que você fizer ao controle placeholder são salvas para o controle real.
Winres.exe versus Visual Studio
Em geral, antes de começar a localizar os formulários de um aplicativo Windows Forms, você deve decidir se deseja usar o Visual Studio ou Winres.exe como a ferramenta de localização. Compatibilidade de versão, conforme descrito posteriormente, pode impedir você de alternar de uma ferramenta para outra.
A vantagem de Visual Studio é que você pode usá-lo para desenvolver e localizar um aplicativo. Para localizar um formulário, após a conclusão do desenvolvimento, definir o formulário LocalizableAttribute (o Localizable a propriedade no Editor de propriedades) para true e altere seu idioma propriedade para a cultura de destino desejado. Em seguida, editar seqüências de caracteres e ajustar o local e tamanho dos controles para acomodar as seqüências de caracteres para a cultura de destino. Quando você salva o arquivo. resx de localizadas, Visual Studio grava somente as propriedades localizáveis (propriedades alteradas na cultura de destino) para o arquivo. Visual Studio cria automaticamente um assembly satélite para o arquivo. resx de localizadas no local de diretório correto. Para obter mais informações, consulte Demonstra Passo a passo: Localizando do Windows Forms e Demonstra Passo a passo: Localizando do Windows Forms e Demonstra Passo a passo: Localizando do Windows Forms e Demonstra Passo a passo: Localizando Windows Forms e Demonstra Passo a passo: Localizando Windows Forms e Instruções passo a passo: localizando Windows Forms.
Embora o Visual Studio fornece um ambiente de localização e de desenvolvimento integrado, o Winres.exe é a ferramenta recomendada para usar se localização será feita por terceiros localizadores. Como o Winres.exe é apenas uma ferramenta de localização, ele permite uma separação mais clara do código do aplicativo dos formulários a serem localizados, que é mais prático para gerenciar projetos grandes.
Usando Winres.exe
Para localizar usando Winres.exe, você primeiro deve desenvolver um aplicativo usando um designer visual, como o Designer de formulários em Visual Studio. Quando o desenvolvimento estiver concluído, definir o formulário LocalizableAttribute (a Localizable a propriedade no Editor de propriedades) para truee entregar o arquivo. resx para a cultura padrão para um localizador de terceiros. Este arquivo. resx contém informações extras que usa o Winres.exe para recriar uma versão de tempo de design do formulário original.
.gif "Observação de cuidado") Cuidado |
|---|
Winres.exe não pode ser usado para editar o arquivo de recurso padrão.Winres.exe interpreta alteradas todas as propriedades como propriedades localizadas e salva-as para o arquivo de recursos de cultura de destino. |
Finalmente, últimas versões dos arquivos de recursos de cultura podem ser usadas para criar versões localizadas do aplicativo. Para obter mais informações, consulte Recursos em aplicativos.
A versão 2.0 do Winres.exe tem os seguintes recursos e capacidades:
Winres pode operar em modo de arquivo único (SFM) ou o modo de arquivo de Visual Studio (VSFM). SFM é o modo de legado onde obter informações completas sobre o formulário e seu conteúdo estão armazenadas no arquivo de recurso. VSFM armazena apenas apenas as alterações culturais no arquivo de recurso.
Uma janela de relatório de erros, encaixada na parte inferior esquerda da janela principal, foi adicionada à interface.
Teclas de atalho podem ser verificadas para duplicatas: no menu Formatar, clique no Verificar as teclas de atalho comando.
Compatibilidade de Versão
Porque o formato dos arquivos de recurso alterado entre Visual Studio.NET 2002 e Visual Studio de 2005, Winres.exe, da mesma forma foi alterado para ser compatível. Portanto, como regra geral, você deve usar a versão do Winres.exe que foi lançada com o.NET Framework que você está usando para criar o aplicativo. A tabela a seguir lista as versões compatíveis.
Visual Studio |
.NET Framework |
Winres.exe |
|---|---|---|
Visual Studio .NET 2002 |
1.0 |
1.0 |
Visual Studio .NET 2003 |
1.1 |
1.1 |
Visual Studio 2005 |
2.0 |
2.0 |
Visual Studio 2008 |
3.0 e 3.5 |
3.0 e 3.5 |
Visual Studio 2010 |
4.0 |
4.0 |
Se você tentar abrir um arquivo de recurso antigo com a versão 2.0 do Winres.exe, você será solicitado a atualizar o formato do arquivo para ser compatível com a versão 2.0 do.NET Framework.
Nas versões do.NET Framework anterior à versão 2.0, Winres.exe e o Forms Designer do Visual Studio criado arquivos de recursos de cultura neutra e culture-specific incompatível. Portanto, depois que o processo de localização começou, tinha que continuar a usar somente a mesma ferramenta. No entanto, com a versão 2.0 do Winres.exe, o modo de arquivo de Visual Studio (VSFM) foi adicionado. Como o nome implica, um arquivo de recurso salvo nesse modo de compatibilidade pode ser editado com qualquer uma dessas ferramentas.
Observação
Embora VSFM tem a vantagem de ser compatível com Visual Studio, desde que ele armazena apenas alterado valores no arquivo de recurso, Winres.exe requer que os pais do arquivo de recurso atual estar localizado no mesmo diretório.Por exemplo, edição TestApp.de-DE.resources, um alemão no arquivo de recurso da Alemanha, requer a presença do arquivo de recurso padrão, TestApp.resxe possivelmente o arquivo de recurso de cultura neutra, TestApp.de.resources.
Exemplos
Para localizar um arquivo. resx ou. Resources, associado a um formulário
Tipo de winres no prompt de comando para executar Winres.exe.
Para abrir os recursos padrão para localizar um formulário, clique o Abrir comando sobre o arquivo menu e navegue até o arquivo para abri-lo.
- ou -
Especifique o arquivo seja aberto na linha de comando quando você iniciar o Winres.exe.
O comando a seguir inicia o Winres.exe e carrega o formulário associado TestApp.resx no Designer de formulário.
winres TestApp.resxO comando a seguir inicia o Winres.exe e carrega o formulário associado TestApp.resources no Designer de formulário.
winres TestApp.resourcesObservação
Se o formulário cujos recursos você está editando um formulário herdado, tanto o assembly contido no formulário herdado e o assembly que contém o formulário herdando (derivado) ou deve ser registrado no Global Assembly Cache (GAC) ou deve residir no mesmo diretório do WinRes.exe.Para obter mais informações sobre a instalação.NET Framework componentes no GAC, consulte Cache global de assemblies.
Selecionar controles no formulário e alterar suas Text e outras propriedades para refletir a cultura localizada e idioma. Mova ou redimensione controles conforme necessário para acomodar o texto localizado.
Para salvar a versão localizada do arquivo. resx ou. Resources, clique na Salvar ícone ou no mesmo comando no arquivo menu. A ferramenta exibe o Selecione cultura janela.
Selecione o modo de cultura e o arquivo apropriado e clique em OK. A ferramenta salva o arquivo, usando a convenção de nomenclatura que espera de tempo de execução para os arquivos de recurso localizado. Por exemplo, se você localizar TestApp.resources para alemão na Alemanha, a ferramenta salva o arquivo como TestApp.de-DE.resources. Se você localizar TestApp.resx para alemão na Alemanha, a ferramenta salva o arquivo como TestApp.de-DE.resx. Para obter mais informações sobre convenções de nomenclatura de recursos, consulte Empacotamento e implantação de recursos. Para obter uma lista dos nomes predefinidos cultura usado pelo tempo de execução, consulte o Classe CultureInfo.