Esempio di collegamento MUI

Questa sezione descrive come aggiungere stringhe di risorse alla tabella collegamento di Windows Installer da usare con l'interfaccia utente multilingue (MUI).

Windows Installer 2.0 e Windows Installer 3.0: Non supportato. Questo esempio richiede Windows Installer 4.0.

Per informazioni su come sviluppare applicazioni abilitate per MUI, vedere la documentazione di Multilingual User Interface (MUI ).

Per aggiungere le stringhe di risorse usate dalle interfacce utente multilingue di Windows Vista a un pacchetto di Windows Installer:

  1. Aggiungere le informazioni per tutti i file linguistici indipendenti dalla lingua e della lingua alla tabella file. Ad esempio, i file possono essere costituiti da un file indipendente dalla lingua (msimsg.dll) e da file di lingua per l'inglese (msimsgen.dll.mui), il giapponese (msimsgja.dll.mui) e il cinese (msimsgcs.dll.mui). Ogni file può appartenere a un componente diverso. Ogni file può avere sia un nome di file lungo che breve. Nel caso di questo esempio, è possibile aggiungere le informazioni seguenti alla tabella file.

    Tabella file (parziale)

    File Componente_ FileName
    msimsgmuija MSIMSG_MUI_JA msimsgja.dll|msimsg.dll.mui
    msimsgmuics MSIMSG_MUI_CS msimsgcs.dll|msimsg.dll.mui
    msimsgmuien MSIMSG_MUI_EN msimsgen.dll|msimsg.dll.mui
    msimsgdll MSIMSG msimsg.dll

     

  2. Aggiungere informazioni alla tabella Component per questi componenti. Ogni componente ha un identificatore GUID univoco che deve essere immesso nel campo ComponentId della tabella Component. Il file appartenente al componente può fungere da KeyPath per tale componente. La directory che contiene ogni componente può essere specificata nel campo Directory_. È possibile aggiungere le informazioni seguenti alla tabella Component.

    Tabella dei componenti (parziale)

    Componente Directory_ KeyPath
    MSIMSG_MUI_JA MUIFolder_JA msimsgmuija
    MSIMSG_MUI_CS MUIFolder_CS msimsgmuics
    MSIMSG_MUI_EN MUIFolder_EN msimsgmuien
    MSIMSG MUIFolder msimsgdll

     

  3. Modificare la tabella Directory in modo che i componenti vengano installati nelle directory corrette. Assicurarsi di includere informazioni sulla directory in cui verrà installato il collegamento. Ad esempio, le informazioni seguenti potrebbero essere aggiunte alla tabella Directory di un pacchetto che installa i componenti e un collegamento disponibile nella directory DesktopFolder.

    Tabella directory (parziale)

    Directory Directory_Parent DefaultDir
    TARGETDIR SourceDir
    MsiTest TARGETDIR MsiTest:.
    MUIFolder MsiTest MUI
    MUIFolder_CS MUIFolder cs-CZ
    MUIFolder_EN MUIFolder it-IT
    MUIFolder_JA MUIFolder ja-JP
    DesktopFolder TARGETDIR .

     

  4. Aggiungere una riga alla tabella Collegamento per ogni collegamento. Ad esempio, la tabella Shortcut può contenere le informazioni seguenti per due collegamenti, Quick1 e Quick2, installati nella directory DirectoryFolder. Ogni collegamento appartiene alla funzionalità specificata nel campo Destinazione. L'icona associata al collegamento può essere specificata nel campo Icon_ e nella tabella Icon .

    Tabella di scelta rapida (parziale)

    Tasto di scelta rapida Directory_ Componente_ Destinazione Icona
    Quick1 DesktopFolder MSIMSG FeatureChild1_Local HelpFileIcon.exe
    Quick2 DesktopFolder MSIMSG FeatureChild1_Local HelpFileIcon.exe

     

  5. Aggiungere informazioni alla tabella Tabella delle funzionalità per il collegamento proprietario della funzionalità. Quando il collegamento viene attivato, il programma di installazione verifica che tutti i componenti appartenenti a questa funzionalità siano installati prima di avviare il file chiave del componente specificato nella colonna Component_ della tabella Collegamento . Nel caso di questo esempio, è possibile aggiungere le informazioni seguenti alla tabella Tabella delle funzionalità per la funzionalità FeatureParent1_Local.

    Tabella delle funzionalità (parziale)

    Funzionalità Feature_Parent Titolo Attributi
    FeatureParent1_Local FeatureParent1_Local 16
    FeatureChild1_Local FeatureParent1_Local FeatureParent1_Local 0

     

  6. Per ogni nuovo collegamento, aggiungere le informazioni sulla stringa di risorsa ai campi DisplayResourceDLL, DisplayResourceId, DescriptionResourceDLL e DescriptionResourceId della tabella Collegamento. I campi DisplayResourceDLL e DescriptionResourceDLL contengono la stringa di risorsa nel formato stringa formattato . La stringa formattata può usare la convenzione [#filekey] del formato formattato . Aggiungere gli indici di visualizzazione e descrizione per le stringhe di risorse nei campi DisplayResourceId e DescriptionResourceId.

    Tabella di scelta rapida (parziale)

    Tasto di scelta rapida DisplayResourceDLL DisplayResourceId DescriptionResourceDLL DescriptionResourceId
    Quick1 [#msimsgdll] 36 [#msimsgdll] 37
    Quick2 [#msimsgdll] 38 [#msimsgdll] 39

     

  7. Dopo aver installato il pacchetto, testare per assicurarsi che l'interfaccia utente multilingue funzioni come previsto.