Winres.exe (editor di risorse di Windows Form)
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 |
Oggetto di 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 |
Oggetto di 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 di impostazioni cultura specifiche o non associate ad alcun 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 di impostazioni cultura specifiche o non associate ad alcun paese a partire dal file di risorse predefinito.
È possibile salvare un file di risorse di determinate impostazioni cultura come file di risorse per altre impostazioni cultura. 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 le nuove impostazioni cultura.
Per ulteriori informazioni, vedere Organizzazione gerarchica di risorse per la localizzazione e Organizzazione gerarchica di risorse per la localizzazione e Organizzazione gerarchica di risorse per la localizzazione e 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 Resgen.exe (generatore di file di risorse).
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 delle impostazioni cultura 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 specificando le impostazioni cultura di destinazione desiderate. Modificare quindi le stringhe, nonché la posizione e le dimensioni dei controlli, in base alle stringhe delle impostazioni cultura di destinazione. Al momento del salvataggio del file RESX localizzato, nel file verranno scritte solo le proprietà localizzabili, ossia quelle che variano in base alle impostazioni cultura di destinazione. Verrà inoltre creato automaticamente un assembly satellite per il file RESX localizzato nella directory appropriata. Per ulteriori informazioni, vedere Procedura dettagliata: localizzazione di Windows Form e Procedura dettagliata: localizzazione di Windows Form e Procedura dettagliata: localizzazione di Windows Form e Procedura dettagliata: localizzazione di Windows Form e 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 alle impostazioni cultura predefinite. Questo file contiene informazioni aggiuntive che consentono a Winres.exe di ricreare una versione Design-Time del form originale.
Attenzione |
---|
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 delle impostazioni cultura di destinazione. |
Le versioni finali dei file di risorse delle impostazioni cultura 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 legacy, 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 |
Visual Studio 2008 |
3.0 e 3.5 |
3.0 e 3.5 |
Visual Studio 2010 |
4.0 |
4.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 delle impostazioni cultura e indipendenti dalle impostazioni cultura) 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 cultura, ossia TestApp.de.resources. |
Esempi
Per localizzare un file RESX o RESOURCES associato a un form
Per eseguire Winres.exe, al prompt dei comandi digitare winres.
Per aprire il file di risorse predefinito relativo al form da localizzare, scegliere il comando Apri dal menu File e selezionare il file desiderato.
In alternativa
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 in GAC, vedere Global Assembly Cache.
Selezionare i controlli nel form e modificarne la proprietà Text e le altre proprietà in base alla lingua e alle impostazioni cultura di destinazione. Spostare o ridimensionare i controlli in base al testo nella lingua di destinazione.
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 impostazioni cultura.
Selezionare le impostazioni cultura 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 impostazioni cultura predefiniti utilizzati dal runtime, vedere CultureInfo Class.