Partilhar via


Tabela de atalho

A tabela Atalho contém as informações de que o aplicativo precisa para criar atalhos no computador do usuário.

A tabela de atalho tem as seguintes colunas.

Coluna Tipo Chave Nulo
Atalho Identificador Y N
Directory_ Identificador N N
Designação Nome do arquivo N N
Component_ Identificador N N
Público-alvo de atalho N N
Argumentos Formatado N Y
Descrição de texto N Y
Tecla de atalho inteiro N Y
Icon_ Identificador N Y
IconIndex inteiro N Y
ShowCmd inteiro N Y
WkDir Identificador N Y
DisplayResourceDLL Formatado N Y
DisplayResourceId inteiro N Y
DescriçãoResourceDLL Formatado N Y
DescriçãoResourceId inteiro N Y

 

Colunas

Atalho

O valor-chave para esta tabela.

Directory_

A chave externa na primeira coluna da tabela Directory. Esta coluna especifica o diretório no qual o arquivo de atalho é criado.

Nome

O nome localizável do atalho a ser criado.

Component_

A chave externa na primeira coluna da tabela Componente . O instalador usa o estado de instalação do componente especificado nesta coluna para determinar se o atalho é criado ou excluído. Este componente deve ter um caminho de chave válido para o atalho a ser instalado. Se a coluna Destino contiver o nome de um recurso, o arquivo iniciado pelo atalho será o arquivo chave do componente listado nesta coluna.

Alvo

O destino de atalho.

Para um atalho anunciado, esta coluna deve ser uma chave externa na primeira coluna da tabela Recurso. O instalador avalia a entrada no campo Destino como uma de Identificador de e a entrada deve ser uma chave estrangeira válida na Tabela de Recursos . O arquivo iniciado pelo atalho, neste caso, é o arquivo chave do componente listado na coluna Component_. Quando o atalho é ativado, o instalador verifica se todos os componentes do recurso estão instalados antes de iniciar este arquivo.

Para um atalho não anunciado, o instalador avalia este campo como uma cadeia de formatada. O campo deve conter um identificador de propriedade entre colchetes ([ ]), que é expandido para o arquivo ou uma pasta apontada pelo atalho. Para obter mais informações, consulte a ação CriarAtalhos.

Argumentos

Os argumentos de linha de comando para o atalho.

Observe que a resolução de propriedades no campo Argumentos é limitada. Uma propriedade formatada como [Property] neste campo só pode ser resolvida se a propriedade já tiver o valor pretendido quando o componente proprietário do atalho estiver instalado. Por exemplo, para resolver com o valor correto para o argumento "[#MyDoc.doc]", o mesmo processo deve estar instalando o arquivo MyDoc.doc e o componente que possui o atalho.

Descrição

A descrição localizável do atalho.

Tecla de atalho

A tecla de atalho para o atalho. O byte de ordem baixa contém o código de chave virtual para a chave e o byte de ordem alta contém sinalizadores modificadores. Este deve ser um número não negativo. Os autores de pacotes de instalação geralmente são recomendados a não definir essa opção, porque a configuração dessa opção pode adicionar teclas de atalho duplicadas à área de trabalho de um usuário. Além disso, a prática de atribuir teclas de atalho a atalhos pode ser problemática para os utilizadores que utilizam teclas de atalho para acessibilidade.

Icon_

A chave externa para a coluna um da tabela Icon.

IconIndex

O índice de ícones para o atalho. Este deve ser um número não negativo.

ShowCmd

O comando Mostrar para a janela do aplicativo.

Podem ser utilizados os seguintes valores: Os valores são os definidos para a função de API do Windows ShowWindow.

Valor Significado
1 SW_SHOWNORMAL
3 SW_SHOWMAXIMIZED
7 SW_SHOWMINNOACTIVE

 

WkDir

O nome da propriedade que tem o caminho do diretório de trabalho para o atalho. O valor pode usar o formato Windows para fazer referência a variáveis de ambiente, por exemplo, %USERPROFILE%. As referências são resolvidas para um caminho real quando o instalador resolve o diretório de trabalho para criar o atalho.

DisplayResourceDLL

Este campo contém um valor de cadeia de caracteres Formatado para o caminho completo para o executável portátil (arquivo LN) com neutralidade de idioma que contém os dados de configuração de recursos (RC Config). A cadeia de caracteres formatada pode usar a convenção [#filekey]. Se este campo contiver um valor, a coluna Nome será ignorada. Se este campo estiver vazio, o instalador usa o valor na coluna Nome. Quando este campo contém um valor, o campo DisplayResourceId também é necessário para conter um valor, ou a instalação falha.

Esta coluna da tabela de atalho é usada somente quando executada no Windows Vista ou Windows Server 2008 e é ignorada. Esta coluna está disponível com versões não anteriores ao Windows Installer 4.0.

Para obter informações sobre como adicionar atalhos à tabela de atalhos para uso com recursos MUI, consulte um exemplo de atalho MUI.

DisplayResourceId

O índice de nome de exibição para o atalho. Este deve ser um número não negativo. Quando este campo contém um valor, o campo DisplayResourceDLL é necessário para também conter um valor ou a instalação falha.

Esta coluna da tabela de atalho é usada somente quando executada no Windows Vista ou Windows Server 2008 e é ignorada. Esta coluna está disponível com versões não anteriores ao Windows Installer 4.0.

DescriçãoResourceDLL

Este campo contém um valor de cadeia de caracteres Formatado para o caminho completo para o executável portátil (arquivo LN) com neutralidade de idioma que contém os dados de configuração de recursos (RC Config). A cadeia de caracteres formatada pode usar a convenção [#filekey]. Se este campo contiver um valor, a coluna Nome será ignorada. Se esse campo estiver vazio, o instalador usará o valor na coluna Descrição. Quando esse campo contém um valor, o campo DescriptionResourceId também é necessário para conter um valor, ou a instalação falha.

Esta coluna da tabela de atalho é usada somente quando executada no Windows Vista ou Windows Server 2008 e é ignorada. Esta coluna está disponível com versões não anteriores ao Windows Installer 4.0.

Para obter informações sobre como adicionar atalhos à tabela de atalhos para uso com recursos MUI, consulte um exemplo de atalho MUI.

DescriptionResourceId

O índice de nome da descrição para o atalho. Este deve ser um número não negativo. Quando este campo contém um valor, o campo DescriptionResourceDLL é necessário para também conter um valor ou a instalação falha.

Esta coluna da tabela de atalho é usada somente quando executada no Windows Vista ou Windows Server 2008 e é ignorada. Esta coluna está disponível com versões não anteriores ao Windows Installer 4.0.

Comentários

A ativação de um recurso cria um atalho anunciado somente se a interface IShellLink do sistema suportar a resolução do descritor do instalador. Isso é suportado pelo Microsoft Windows 2000 e sistemas que executam o Microsoft Internet Explorer 4.01. Se não for suportado, o instalador cria um atalho não anunciado após a instalação do componente do recurso, localmente ou executado a partir da fonte.

Observe que os atalhos anunciados sempre apontam para um aplicativo específico, identificado por um ProductCode, e não devem ser compartilhados entre aplicativos. Os atalhos anunciados só funcionam para a aplicação instalada mais recentemente e são removidos quando essa aplicação é removida.

Esta tabela é referida quando a ação CreateShortcuts e a ação RemoveShortcuts é executada.

Consulte também o DISABLEADVTSHORTCUTS propriedade.

Validação

ICE03
ICE06
ICE19
ICE32
ICE36
ICE46
ICE50
ICE57
ICE59
ICE67
ICE69
ICE80
ICE90
ICE91
ICE94