Winres.exe (Editor lokalizace prostředků Systému Windows)

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

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

Výstraha

V tomto nástroji neotevírejte nedůvěryhodné soubory. Pokud je soubor binárním souborem, bude deserializován pomocí binární deserializace, což je nebezpečné. Další informace naleznete v tématu Deserializace rizika při použití BinaryFormatter a souvisejících typů.

Syntaxe

winres resourceFile
winres /?

Arguments

Argument Description
resourceFile Soubor prostředku, který se má lokalizovat. Tento soubor musí být soubor .resx nebo .resources formuláře Windows Forms vygenerovaný návrhářem sady Visual Studio. Winres.exe nelze otevřít obecné soubory .resx nebo .resources.
Možnost Description
/? Zobrazí syntaxi příkazu a možnosti nástroje.

Poznámky

Stav prvků uživatelského rozhraní z formuláře v projektu 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, který umožňuje omezené úpravy některého typu souboru mimo prostředí návrhu sady Visual Studio. Konkrétně umožňuje následující typy operací úprav:

  • Neutrální nebo specifický soubor prostředků jazykové verze lze upravit tak, aby se změnily vlastnosti uživatelského rozhraní formuláře nebo jeho ovládacích prvků, jako je jejich text, velikost nebo pozice.
  • Neutrální nebo specifické soubory prostředků jazykové verze lze vygenerovat z výchozího souboru prostředků.
  • Soubor prostředků jazykové verze lze uložit jako jiný soubor prostředku jazykové verze. Například soubor prostředků v angličtině (USA) může být uložen jako polský soubor prostředků. Nový soubor by se obvykle upravoval tak, aby byl kompatibilní s novou jazykovou verzí.

Viz také hierarchická organizace prostředků pro lokalizaci nebo hierarchickou organizaci prostředků pro lokalizaci.

Winres.exe nelze převést soubor .resx na odpovídající soubor .resources; místo toho použijte nástroj Resgen.exe. Další informace o Resgen.exenajdete v tématu Resgen.exe (generátor souborů prostředků).

Winres.exe je grafická aplikace, která znovu vytvoří návrhovou verzi formuláře Modelu Windows Forms pouze ze souboru prostředků, aniž by měla přístup ke zdrojovému kódu. Winres.exe hostuje Návrhář a Properties okno formuláře v sadě Visual Studio. Tyto funkce umožňují vizuální úpravy souboru .resources nebo .resx obsahujícího formulář Windows Forms. Lokalizace 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 cílové jazykové verze.

Pokud Winres.exe typ ovládacího prvku nelze přeložit, vytvoří zástupný ovládací prvek v lokalizovaném souboru .resx nebo .resources. Zástupný ovládací prvek 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 okně se zobrazí Properties všechny dostupné lokalizovatelné vlastnosti pro zástupný ovládací prvek. Všechny změny provedené v ovládacím prvku zástupného symbolu se uloží pro samotný ovládací prvek.

Winres.exe versus Visual Studio

Obecně platí, že než začnete lokalizovat formuláře Windows Forms aplikace, měli byste se rozhodnout, jestli chcete jako lokalizační nástroj použít Visual Studio nebo Winres.exe. Kompatibilita verzí, jak je popsáno později, může zabránit přepnutí z jednoho nástroje na druhý.

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

I když Visual Studio poskytuje integrované vývojové a lokalizační prostředí, Winres.exe je doporučeným nástrojem pro použití, pokud lokalizace provádí lokalizátory třetích stran. Vzhledem k tomu, že Winres.exe je pouze lokalizační nástroj, umožňuje čistěji oddělit kód aplikace od formulářů, které se mají lokalizovat, což je praktičtější pro správu velkých projektů.

Použití Winres.exe

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

Poznámka:

Winres.exe nelze použít k úpravě výchozího souboru prostředků. Winres.exe interpretuje všechny změněné vlastnosti jako lokalizované vlastnosti a uloží 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:

  • Winres může fungovat v režimu SFM (Single File Mode) nebo v režimu souborů sady Visual Studio (VSFM). SFM je starší režim, ve kterém se do souboru prostředků ukládají úplné informace o formuláři a jeho obsah. VSFM ukládá pouze kulturní změny v souboru prostředků.

  • Okno pro hlášení chyb, které je ukotvené vlevo dole v hlavním okně.

  • Klávesové zkratky lze zkontrolovat u duplicit: v Format nabídce 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:

I když má VSFM výhodu, že je kompatibilní se sadou Visual Studio, protože ukládá pouze změněné hodnoty v souboru prostředků, Winres.exe vyžaduje, aby nadřazené položky aktuálního souboru prostředků byly umístěny ve stejném adresáři. Například úpravy TestApp.de-DE.resources, němčina v Německém souboru prostředků, vyžaduje přítomnost výchozího souboru prostředků , TestApp.resxa případně soubor prostředků neutrální jazykové verze , TestApp.de.resources.

Examples

Lokalizace souboru .resx nebo .resources přidruženého k formuláři

  1. Pokud chcete spustit Winres.exe, zadejte winres do příkazového řádku vývojáře.

  2. Pokud chcete otevřít výchozí prostředky formuláře k lokalizaci, vyberte Otevřít soubor > a přejděte na soubor, který chcete otevřít.

    -or-

    Zadejte soubor, který se má otevřít na příkazovém řádku při spuštění Winres.exe. Následující příkaz spustí Winres.exe a načte formulář přidružený TestApp.resx v Návrháři formulářů.

    winres TestApp.resx

    Následující příkaz spustí Winres.exe a načte formulář přidružený TestApp.resources v Návrháři formulářů.

    winres TestApp.resources

    Poznámka:

    Pokud je formulář, jehož prostředky upravujete, zděděný formulář, musí být sestavení obsaženo v zděděné i sestavení obsahující dědění (odvozené) formulář buď musí být registrován v globální mezipaměti sestavení (GAC), nebo musí být umístěn ve stejném adresáři jako WinRes.exe. Další informace o instalaci komponent rozhraní .NET Framework do GAC naleznete v tématu Globální mezipaměť sestavení.

  3. 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. Podle potřeby přesuňte nebo změňte velikost ovládacích prvků tak, aby vyhovovaly lokalizovaný text.

  4. Pokud chcete uložit lokalizovanou verzi souboru .resx nebo .resources, klikněte na Save ikonu nebo vyberte Uložit soubor>. Nástroj zobrazí okno Vybrat jazykovou verzi .

  5. Vyberte příslušnou jazykovou verzi a režim souboru a klepněte na tlačítko OK.

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

Viz také

  • Last updated on