Editor di risorse di Windows Form (Winres.exe)

  • Articolo

Winres.exe, l'Editor di risorse di Windows Form, è uno strumento di layout visivo appositamente studiato per facilitare la localizzazione delle risorse di interfaccia di Windows Form utilizzate dai form. I file RESX o RESOURCES utilizzati come input per Winres.exe possono essere creati mediante un ambiente di progettazione visiva quale Microsoft Visual Studio. Per informazioni sulla distribuzione delle risorse in applicazioni .NET Framework, vedere Risorse nelle applicazioni.

winres resourceFile 
winres /?

Note

Argomento Descrizione

resourceFile

File di risorse da localizzare. Deve essere un form di Windows Form con estensione RESX o RESOURCES generato dalla finestra di progettazione di Visual Studio. Winres.exe non è in grado di aprire file RESX o RESOURCES generici.
Opzione Descrizione

/?

Visualizza la sintassi e le opzioni dei comandi dello strumento.

Lo stato degli elementi di interfaccia provenienti da un form di un progetto Windows Form viene in genere archiviato nei file di risorse, che possono essere file basati su XML con estensione resx oppure le corrispondenti versioni binarie compilate con estensione resources. Winres.exe fornisce funzionalità di modifica limitate per questi tipi di file all'esterno dell'ambiente di progettazione Visual Studio. In particolare, consente i seguenti tipi di operazioni di modifica:

  • È possibile modificare un file di risorse specifico di una lingua e di un paese, o indipendente dalle impostazioni del paese, per cambiare le proprietà di interfaccia del form o dei relativi controlli, ad esempio il testo, le dimensioni o la posizione.

  • È possibile generare i file di risorse specifici di una lingua e di un paese, o indipendenti dalle impostazioni del paese, a partire dal file di risorse predefinito.

  • È possibile salvare un file di risorse specifico di una lingua come file di risorse per un'altra lingua. Un file di risorse per l'inglese può ad esempio essere salvato come file di risorse per il polacco. Il nuovo file viene in genere successivamente modificato in modo da essere compatibile con la nuova lingua.

Organizzazione gerarchica di risorse per la localizzazione
Organizzazione gerarchica di risorse per la localizzazione
Organizzazione gerarchica di risorse per la localizzazione
Organizzazione gerarchica di risorse per la localizzazione

Non è possibile utilizzare Winres.exe per convertire un file RESX nel file RESOURCES corrispondente. Per effettuare questa operazione, utilizzare lo strumento Resgen.exe. Per ulteriori informazioni su Resgen.exe, vedere Generatore di file di risorse (Resgen.exe).

Winres.exe è un'applicazione grafica che consente di ricreare una versione Design-Time di un form di Windows Form solo dal file di risorse, senza accedere al codice sorgente. In Winres.exe è inclusa la finestra delle proprietà e la finestra di progettazione Windows Form di Visual Studio. Queste funzionalità consentono di modificare visivamente un file RESX o RESOURCES contenente un form di Windows Form. Winres.exe viene in genere utilizzato per modificare le etichette, la posizione e le dimensioni dei controlli durante la fase di localizzazione dell'applicazione, per consentire la corretta visualizzazione delle etichette della lingua di destinazione.

Se Winres.exe non è in grado di individuare il tipo di un controllo, nel file RESX o RESOURCES localizzato verrà creato un controllo segnaposto che verrà visualizzato nel form di Windows Form sotto forma di finestra tratteggiata, con dimensioni e posizione identiche a quelle del controllo reale. Nella finestra delle proprietà sono visualizzate tutte le proprietà localizzabili disponibili per il controllo segnaposto. Le eventuali modifiche apportate al controllo segnaposto vengono salvate nel controllo reale.

Confronto tra Winres.exe e Visual Studio

Prima di iniziare la localizzazione dei form di Windows Form per un'applicazione, è opportuno decidere se utilizzare come strumento di localizzazione Visual Studio .NET oppure Winres.exe. La compatibilità tra versioni, come illustrato di seguito, può infatti impedire di passare da uno strumento all'altro.

Visual Studio presenta il vantaggio di poter essere utilizzato sia per lo sviluppo che per la localizzazione di un'applicazione. Per localizzare un form al termine della fase di sviluppo, impostare il valore di LocalizableAttribute del form (corrispondente alla proprietà Localizable nell'editor delle proprietà) su true e modificare la proprietà Language impostando la lingua di destinazione desiderata. Modificare quindi le stringhe, nonché la posizione e le dimensioni dei controlli, in base alle stringhe della lingua di destinazione. Al momento del salvataggio del file RESX localizzato, nel file verranno scritte solo le proprietà localizzabili, ossia quelle che variano in base alla lingua di destinazione. Verrà inoltre creato automaticamente un assembly satellite per il file RESX localizzato nella directory appropriata. Procedura dettagliata: localizzazione di Windows Form
Procedura dettagliata: localizzazione di Windows Form
Procedura dettagliata: localizzazione di Windows Form
Procedura dettagliata: localizzazione di Windows Form
Procedura dettagliata: localizzazione di Windows Form

Anche se Visual Studio fornisce un ambiente integrato per lo sviluppo e la localizzazione, si consiglia di utilizzare Winres.exe se il processo di localizzazione viene eseguito da terze parti. Essendo uno specifico strumento di localizzazione, Winres.exe consente di distinguere più chiaramente il codice dell'applicazione dai form da localizzare e risulta quindi più funzionale per la gestione di progetti di grandi dimensioni.

Utilizzo di Winres.exe

Per poter essere localizzata con Winres.exe, l'applicazione deve essere sviluppata con una finestra di progettazione visiva come quella disponibile in Visual Studio. NET. Al termine della fase di sviluppo, impostare il valore di LocalizableAttribute del form (corrispondente alla proprietà Localizable nell'editor delle proprietà) su true, quindi passare al team di localizzazione il file RESX relativo alla lingua predefinita. Questo file contiene informazioni aggiuntive che consentono a Winres.exe di ricreare una versione Design-Time del form originale.

Nota di avvisoAttenzione

Winres.exe non può essere utilizzato per modificare il file di risorse predefinito. Tutte le proprietà modificate vengono interpretate come proprietà localizzate e salvate nel file di risorse della lingua di destinazione.

Le versioni finali dei file di risorse specifici della lingua possono essere utilizzate per creare versioni localizzate dell'applicazione. Per ulteriori informazioni, vedere Risorse nelle applicazioni.

Nella versione 2.0 di Winres.exe sono disponibili le seguenti funzionalità:

  • Winres può eseguito in Modalità file unico o in Modalità file di Visual Studio. Quando si utilizza la Modalità file unico, ossia quella preesistente, nel file di risorse vengono archiviate le informazioni sul form e sul relativo contenuto. Quando invece si utilizza la Modalità file di Visual Studio, nel file di risorse vengono archiviate solo le modifiche di tipo linguistico.

  • All'interfaccia è stata aggiunta una finestra di segnalazione degli errori, ancorata nell'area in basso a sinistra della schermata principale.

  • È possibile verificare se sono presenti tasti di scelta duplicati scegliendo Controlla tasti di scelta dal menu Formato.

Compatibilità tra versioni

Poiché il formato dei file di risorse è stato aggiornato da Visual Studio .NET 2002 a Visual Studio 2005, anche Winres.exe è stato modificato per motivi di compatibilità. Come regola generale, si consiglia di utilizzare la versione di Winres.exe rilasciata con la versione di .NET Framework utilizzata per la creazione dell'applicazione. Nella tabella riportata di seguito sono elencate le versioni compatibili.

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

Se si tenta di aprire un file di risorse meno recente con la versione 2.0 di Winres.exe, verrà chiesto di aggiornare il formato del file in modo che sia compatibile con la versione 2.0 di .NET Framework.

Nelle versioni di .NET Framework precedenti la 2.0, i file di risorse (specifici di una lingua e di un paese e indipendenti dalle impostazioni del paese) creati con Winres.exe e con la finestra di progettazione dei form di Visual Studio erano incompatibili. Una volta avviato il processo di localizzazione, era quindi necessario continuare a utilizzare lo stesso strumento. Con la versione 2.0 di Winres.exe è stata aggiunta la Modalità file di Visual Studio, che consente di salvare un file di risorse in modo da poter essere modificato con entrambi gli strumenti.

Nota

Pur offrendo il vantaggio della compatibilità con Visual Studio, la Modalità file di Visual Studio consente di archiviare solo i valori modificati nel file di risorse. È pertanto necessario che i file padre del file di risorse corrente si trovino nella stessa directory. Ad esempio, per modificare TestApp.de-DE.resources, un file di risorse per la lingua tedesca in Germania, è necessario disporre del file di risorse predefinito, TestApp.resx, ed eventualmente anche del file di risorse indipendente dalle impostazioni del paese, ossia TestApp.de.resources.

Esempi

Per localizzare un file RESX o RESOURCES associato a un form

  1. Per eseguire Winres.exe, al prompt dei comandi digitare winres.

  2. Per aprire il file di risorse predefinito relativo al form da localizzare, scegliere il comando Apri dal menu File e selezionare il file desiderato.

    -oppure-

    All'avvio di Winres.exe, specificare il file da aprire dalla riga di comando.

    Il seguente comando avvia Winres.exe e carica il form associato a TestApp.resx nella finestra di progettazione.

    winres TestApp.resx

    Il seguente comando avvia Winres.exe e carica il form associato a TestApp.resources nella finestra di progettazione.

    winres TestApp.resources

    Nota

    Se il form di cui si modificano le risorse è un form ereditato, l'assembly contenuto nel form ereditato e quello incluso nel form di derivazione devono essere entrambi memorizzati nella Global Assembly Cache (GAC) oppure devono trovarsi nella stessa directory di WinRes.exe. Per ulteriori informazioni sull'installazione dei componenti di .NET Framework nella GAC, vedere Global Assembly Cache.

  3. Selezionare i controlli nel form e modificarne la proprietà Text e le altre proprietà in base alla lingua di destinazione. Spostare o ridimensionare i controlli in base al testo nella lingua di destinazione.

  4. Per salvare la versione localizzata del file RESX o RESOURCES, fare clic sull'icona Salva o scegliere il comando corrispondente dal menu File. Verrà visualizzata la finestra Seleziona lingua.

  5. Selezionare la lingua e la modalità file appropriate, quindi scegliere OK. Il file verrà salvato secondo le convenzioni di denominazione previste per i file di risorse localizzati. Se si localizza, ad esempio, il file TestApp.resources per la lingua tedesca in Germania, il file verrà salvato come TestApp.de-DE.resources. Se si localizza TestApp.resx per la lingua tedesca in Germania, il file verrà salvato come TestApp.de-DE.resx. Per ulteriori informazioni sulle convenzioni di denominazione dei file di risorse, vedere Creazione del package e distribuzione delle risorse. Per l'elenco dei nomi di lingua predefiniti utilizzati dal runtime, vedere CultureInfo Class.

Vedere anche

Riferimenti

Strumenti di .NET Framework
LocalizableAttribute
CultureInfo
ResourceManager
ResourceReader
ResourceWriter

Concetti

Risorse nelle applicazioni

Altre risorse

Codifica e localizzazione