Winres.exe (Windows Resource Localization Editor)

Článek
05/09/2023

Windows Resource Localization Editor, Winres.exe, je nástroj pro vizuální rozložení, který pomáhá lokalizačním odborníkům lokalizovat model Windows Forms prostředky uživatelského rozhraní používané formuláři. Můžete vytvořit soubory .resx nebo .resources , které se používají jako vstup pro Winres.exe pomocí prostředí vizuálního návrhu, jako je Microsoft Visual Studio. Informace o nasazování prostředků v aplikacích .NET Framework najdete v tématu Prostředky v aplikacích .NET.

Winres.exe se nainstaluje se sadou Visual Studio. Ke spuštění nástroje použijte Visual Studio Developer Command Prompt nebo Visual Studio Developer PowerShell.

Upozornění

Pomocí tohoto nástroje neotevírejte nedůvěryhodné soubory. Pokud je soubor binární, bude deserializován pomocí binární deserializace, což je nebezpečné. Další informace najdete v tématu Rizika deserializace při použití BinaryFormatter a souvisejících typů.

Syntaxe

winres resourceFile
winres /?

Argumenty

Argument	Description
`resourceFile`	Soubor prostředků k lokalizaci. Tento soubor musí být formulář Windows Forms s příponou .resx nebo .resources vygenerovaný pomocí návrháře sady Visual Studio. Nástroj Winres.exe nedokáže otevřít obecné soubory .resx nebo .resources.

Možnost	Popis
/?	Zobrazí syntaxi příkazu a možnosti nástroje.

Poznámky

Stav prvků uživatelského rozhraní z formuláře v projektu model Windows Forms je obvykle uložen v souborech prostředků, což jsou soubory založené na jazyce XML s příponou .resx nebo odpovídající kompilované binární verze s příponou .resources. Winres.exe je nástroj umožňující omezené úpravy obou typů souborů mimo návrhové prostředí sady Visual Studio. Konkrétně umožňuje následující typy operací úprav:

Chcete-li změnit vlastnosti uživatelského rozhraní (UI) formuláře, můžete upravit soubor prostředků neutrální nebo konkrétní jazykové verze nebo jeho ovládací prvky jako například text, velikost či umístění.
Soubory prostředků neutrální nebo konkrétní jazykové verze mohou být generovány z výchozího souboru prostředků.
Soubor prostředků jazykové verze lze uložit jako soubor prostředků jiné jazykové verze. Například soubor prostředků pro angličtinu (USA) může být uložen jako soubor prostředků pro polštinu. Nový soubor bude obvykle upraven tak, aby byl kompatibilní s novou jazykovou verzí.

Podívejte se také na téma Hierarchické uspořádání prostředků pro lokalizaci nebo Hierarchická organizace prostředků pro lokalizaci.

Nástroj Winres.exe nemůže převést soubor .resx na dopovídající soubor .resources; použijte místo něj nástroj Resgen.exe. Další informace o Resgen.exe najdete v tématu Resgen.exe (Generátor souborů prostředků).

Nástroj Winres.exe je grafická aplikace, která obnoví verzi návrhu formuláře Windows Forms pouze ze souboru prostředků, aniž by měla přístup ke zdrojovému kódu. Winres.exe hostuje okno Návrhář formulářů a vlastnosti model Windows Forms sady Visual Studio. Tyto funkce umožňují provádět vizuální úpravy souboru .resources nebo .resx obsahujícího formulář Windows Forms. Lokalizátory obvykle používají Winres.exe k úpravě popisků ovládacích prvků a úpravě umístění a velikosti ovládacích prvků tak, aby vyhovovaly popiskům pro cílovou jazykovou verzi.

Pokud nástroj Winres.exe nedokáže rozlišit verzi ovládacího prvku, vytvoří v lokalizovaném souboru .resx nebo .resources zástupný text ovládacího prvku. Zástupný text ovládacího prvku se zobrazí ve formuláři Windows Forms jako šrafované okno. Velikost a umístění šrafovaného okna odpovídá skutečnému ovládacímu prvku. Všechny dostupné lokalizovatelné vlastnosti ovládacího prvku zástupného symbolu se zobrazí v okně Vlastnosti . Veškeré změny provedené v zástupném textu ovládacího prvku se uloží pro skutečný ovládací prvek.

Srovnání nástroje Winres.exe a sady Visual Studio

Obecně platí, že dříve než začnete lokalizovat formuláře Windows Forms pro určitou aplikaci, měli byste se rozhodnout, zda chcete k lokalizaci použít sadu Visual Studio, nebo nástroj Winres.exe. Kompatibilita verzí, jak je popsáno dále, může bránit přepínání z jednoho nástroje na druhý.

Výhodou sady Visual Studio je, že ji můžete použít k vývoji i lokalizaci aplikace. Chcete-li lokalizovat formulář, po dokončení vývoje nastavte formulář LocalizableAttribute (vlastnost Lokalizovatelné v editoru Vlastností ) na true a změňte jeho vlastnost Language na požadovanou cílovou jazykovou verzi. Poté změňte řetězce a upravte umístění a velikost ovládacích prvků tak, aby vyhovovaly řetězcům cílové jazykové verze. Při ukládání lokalizovaného souboru .resx sada Visual Studio do souboru zapíše pouze lokalizovatelné vlastnosti (vlastnosti, které se v cílové jazykové verzi změnily). Sada Visual Studio automaticky vytvoří satelitní sestavení pro lokalizovaný soubor .resx ve správném adresáři.

I když Visual Studio poskytuje integrované vývojové a lokalizační prostředí, Winres.exe je doporučeným nástrojem, který se má použít, pokud lokalizaci provádí lokalizátory třetích stran. Protože Winres.exe je pouze lokalizační nástroj, umožňuje jasnější oddělení kódu aplikace od formulářů určených k lokalizaci, což je při řízení velkých projektů praktičtější.

Používání nástroje Winres.exe

Pokud chcete lokalizovat pomocí Winres.exe, musíte nejprve vyvíjet aplikaci pomocí vizuálního návrháře, jako je model Windows Forms Designer v sadě Visual Studio. Po dokončení vývoje nastavte formulář LocalizableAttribute (vlastnost Lokalizovatelné v editoru vlastností ) na truea pak předejte soubor .resx pro výchozí jazykovou verzi lokalizéru třetí strany. Tento soubor .resx obsahuje další informace, které nástroj Winres.exe použije k obnovení verze návrhu původního formuláře.

Poznámka

Nástroj Winres.exe nelze použít k úpravě výchozího souboru prostředků. Nástroj Winres.exe interpretuje všechny změněné vlastnosti jako lokalizované vlastnosti a ukládá je do souboru prostředků cílové jazykové verze.

Konečné verze souborů prostředků jazykové verze lze nakonec použít k vytvoření lokalizovaných verzí aplikace. Další informace najdete v tématu Prostředky v aplikacích .NET.

Winres.exe má následující funkce a možnosti:

Nástroj Winres může pracovat v režimu Single File Mode (SFM) nebo v režimu Visual Studio File Mode (VSFM). SFM je starší režim, ve kterém jsou úplné informace o formuláři a jeho obsahu uloženy do souboru prostředků. Režim VSFM ukládá pouze změny jazykové verze v souboru prostředků.
Okno hlášení chyb ukotvené v levém dolním rohu hlavního okna.
U klávesových zkratek je možné zkontrolovat duplicity: v nabídce Formát klikněte na příkaz Zkontrolovat klávesové zkratky .

Kompatibilita verzí

Měli byste použít verzi Winres.exe, která byla vydána s rozhraním .NET Framework, které používáte. V následující tabulce jsou uvedeny kompatibilní verze:

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 a 3.5	3.0 a 3.5
Visual Studio 2010	4,0	4,0
Visual Studio 2017	4,6	4,6

Poznámka

Ačkoli se režim VSFM vyznačuje výhodou kompatibility se sadou Visual Studio, tak vzhledem k tomu, že do souboru prostředků jsou uloženy pouze změněné hodnoty, nástroj Winres.exe vyžaduje, aby se soubory nadřazené aktuálnímu souboru prostředků nacházely ve stejném adresáři. Například úprava TestApp.de-DE.resourcessouboru prostředku v němčině v Německu vyžaduje přítomnost výchozího souboru TestApp.resxprostředků a případně souboru TestApp.de.resourcesprostředků neutrálních z jazykové verze .

Příklady

Lokalizace souborů .resx nebo .resources spojených s formulářem

Pokud chcete spustit Winres.exe, zadejte winres do příkazového řádku pro vývojáře.
Pokud chcete otevřít výchozí prostředky pro formulář, který se má lokalizovat, vyberte Otevřít soubor > a přejděte k souboru a otevřete ho.

-nebo-

Při spouštění nástroje Winres.exe do příkazového řádku zadejte název otevíraného souboru. Následující příkaz spustí Winres.exe a načte formulář přidružený TestApp.resx k návrháři formulářů.
```
winres TestApp.resx
```
Následující příkaz spustí Winres.exe a načte formulář přidružený TestApp.resources k návrháři formulářů.
```
winres TestApp.resources
```
Poznámka

Jestliže je formulář, jehož prostředky upravujete, zděděným formulářem, sestavení obsahující zděděný formulář i sestavení obsahující odvozený formulář musí být zaregistrována v globální mezipaměti sestavení (GAC) nebo musí být umístěna ve stejném adresáři jako nástroj WinRes.exe. Další informace o instalaci komponent rozhraní .NET Framework do GAC najdete v tématu Globální mezipaměť sestavení (GAC).
Vyberte ovládací prvky ve formuláři a změňte jejich Text a další vlastnosti tak, aby odrážely lokalizovanou jazykovou verzi a její jazyk. Přesuňte ovládací prvky nebo změňte jejich velikost tak, aby vyhovovaly lokalizovanému textu.
Pokud chcete uložit lokalizovanou verzi souboru .resx nebo .resources, klikněte na ikonu Uložit nebo vyberte Uložit soubor>. Nástroj zobrazí okno Vybrat jazykovou verzi .
Vyberte příslušnou jazykovou verzi a režim souborů a klikněte na OK.

Nástroj uloží soubor pomocí zásad vytváření názvů, které modul runtime očekává pro lokalizované soubory prostředků. Pokud například v Německu lokalizujete TestApp.resources němčinu, nástroj soubor uloží jako TestApp.de-DE.resources. Pokud v Německu lokalizujete TestApp.resx němčinu, nástroj soubor uloží jako TestApp.de-DE.resx. Další informace o konvencích vytváření názvů prostředků najdete v tématu Balení a nasazení prostředků. Seznam předdefinovaných názvů jazykových verzí používaných modulem runtime najdete ve CultureInfo třídě .