Compartilhar via

Um exemplo de atalho MUI

  • Artigo

Esta seção descreve como adicionar cadeias de caracteres de recurso à tabela Shortcut do Windows Installer para uso com MUI (Interface de Uso Multilíngue).

Windows Installer 2.0 e Windows Installer 3.0: sem suporte. Este exemplo requer o Windows Installer 4.0.

Veja a documentação da MUI (Interface de Usuário Multilíngue) para obter informações sobre como desenvolver aplicativos habilitados para MUI.

Para adicionar as cadeias de caracteres de recurso usadas pela Interface de Usuário Multilíngue do Windows Vista a um pacote do Windows Installer:

  1. Adicione as informações de todos os arquivos de idioma neutro e de idioma à Tabela File. Por exemplo, os arquivos podem consistir em um arquivo neutro (msimsg.dll) e arquivos de idioma para inglês (msimsgen.dll.mui), japonês (msimsgja.dll.mui) e chinês (msimsgcs.dll.mui). Cada arquivo pode pertencer a um componente diferente. Cada arquivo pode ter um nome de arquivo longo e curto. No caso deste exemplo, as informações a seguir podem ser adicionadas à Tabela File.

    Tabela File (parcial)

    Arquivo Component_ 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. Adicione informações à tabela Component para esses componentes. Cada componente tem um identificador GUID exclusivo que deve ser inserido no campo ComponentId da tabela Component. O arquivo que pertence ao componente pode servir como o KeyPath desse componente. O diretório que contém cada componente pode ser especificado no campo Directory_. As informações a seguir podem ser adicionadas à tabela Component.

    Tabela Component (parcial)

    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. Edite a tabela Directory para que os componentes sejam instalados nos diretórios corretos. Inclua informações sobre o diretório em que o atalho será instalado. Por exemplo, as informações a seguir podem ser adicionadas à tabela Directory de um pacote que instala os componentes e um atalho localizado no diretório DesktopFolder.

    Tabela Diretório (parcial)

    Diretório Directory_Parent DefaultDir
    TARGETDIR SourceDir
    MsiTest TARGETDIR MsiTest:.
    MUIFolder MsiTest MUI
    MUIFolder_CS MUIFolder cs-CZ
    MUIFolder_EN MUIFolder en-US
    MUIFolder_JA MUIFolder ja-JP
    DesktopFolder TARGETDIR .

     

  4. Adicione uma linha à tabela Shortcut para cada atalho. Por exemplo, a tabela Shortcut pode conter as seguintes informações para dois atalhos, Quick1 e Quick2, instalados no diretório DirectoryFolder. Cada atalho pertence ao recurso especificado no campo Target. O ícone associado ao atalho pode ser especificado no campo Icon_ e na tabela Icon.

    Tabela de Atalhos (parcial)

    Atalho Directory_ Component_ Destino ícone
    Quick1 DesktopFolder MSIMSG FeatureChild1_Local HelpFileIcon.exe
    Quick2 DesktopFolder MSIMSG FeatureChild1_Local HelpFileIcon.exe

     

  5. Adicione informações à tabela Feature à qual pertence o atalho de propriedade do recurso. Quando o atalho é ativado, o instalador verifica se todos os componentes pertencentes a esse recurso estão instalados, antes de iniciar o arquivo de chave do componente especificado na coluna Component_ da tabela Shortcut. No caso deste exemplo, as informações a seguir podem ser adicionadas à tabela Feature do recurso FeatureParent1_Local.

    Tabela Feature (parcial)

    Recurso Feature_Parent Título Atributos
    FeatureParent1_Local FeatureParent1_Local 16
    FeatureChild1_Local FeatureParent1_Local FeatureParent1_Local 0

     

  6. Para cada novo atalho, adicione as informações de cadeia de caracteres de recurso aos campos DisplayResourceDLL, DisplayResourceId, DescriptionResourceDLL e DescriptionResourceId da tabela Shortcut. Os campos DisplayResourceDLL e DescriptionResourceDLL contêm a cadeia de caracteres de recurso no formato de cadeia de caracteres Formatted. A cadeia de caracteres formatada pode usar a convenção [#filekey] do formato Formatted. Adicione os índices de exibição e descrição para as cadeias de caracteres de recurso nos campos DisplayResourceId e DescriptionResourceId.

    Tabela de Atalhos (parcial)

    Atalho DisplayResourceDLL DisplayResourceId DescriptionResourceDLL DescriptionResourceId
    Quick1 [#msimsgdll] 36 [#msimsgdll] 37
    Quick2 [#msimsgdll] 38 [#msimsgdll] 39

     

  7. Depois de instalar o pacote, teste para verificar se a Interface de Usuário Multilíngue está funcionando conforme o esperado.