Tabela Shortcut

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

A tabela Shortcut tem as colunas a seguir.

Coluna Tipo Chave Nullable
Atalho Identificador S N
Directory_ Identificador N N
Nome Filename N N
Component_ Identificador N N
Destino Atalho N N
Argumentos Formatted N S
Descrição Texto N S
Tecla de acesso Inteiro N S
Icon_ Identificador N S
IconIndex Inteiro N S
ShowCmd Inteiro N S
WkDir Identificador N S
DisplayResourceDLL Formatado N S
DisplayResourceId Inteiro N S
DescriptionResourceDLL Formatado N S
DescriptionResourceId Inteiro N S

 

Colunas

Shortcut

O valor da chave para esta tabela.

Directory_

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

Name

O nome localizável do atalho a ser criado.

Component_

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

Target

O destino de atalho.

Para um atalho anunciado, essa coluna deve ser uma chave externa na primeira coluna da tabela Feature. O instalador avalia a entrada no campo Target como um Identificador e a entrada deve ser uma chave estrangeira válida na Tabela Feature. O arquivo iniciado pelo atalho nesse caso é o arquivo de chave do componente listado na coluna Component_. Quando o atalho é ativado, o instalador verifica se todos os componentes no recurso foram instalados antes de iniciar esse arquivo.

Para um atalho não anunciado, o instalador avalia esse campo como uma cadeia de caracteres 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, confira a ação CreateShortcuts.

Arguments

Os argumentos de linha de comando do atalho.

Observe que a resolução de propriedades no campo Arguments é limitada. Uma propriedade formatada como [Property] nesse campo só poderá ser resolvida se a propriedade já tiver o valor pretendido, quando o componente que tem o atalho for instalado. Por exemplo, para resolver o valor correto do argumento "[#MyDoc.doc]", o mesmo processo precisa instalar o arquivo MyDoc.doc e o componente que tem o atalho.

Description

Uma descrição localizável do atalho.

Hotkey

A hotkey para o atalho. O byte de baixa ordem contém o código de chave virtual para a chave e o byte de alta ordem contém sinalizadores modificadores. Precisa ser um número não negativo. Em geral, recomenda-se que os autores de pacotes de instalação não definam essa opção, pois a configuração dessa opção pode adicionar hotkeys duplicadas à área de trabalho de um usuário. Além disso, a prática de atribuir hotkeys a atalhos pode ser problemática para usuários que usam hotkeys para acessibilidade.

Icon_

A chave externa para a coluna um da tabela Icon.

IconIndex

O índice de ícone do atalho. Precisa ser um número não negativo.

ShowCmd

O comando Show da janela do aplicativo.

Os valores a seguir podem ser usados. Os valores são 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 do Windows para referenciar 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

Esse campo contém um valor de cadeia de caracteres Formatada para o caminho completo para o executável portátil neutro em linguagem (arquivo LN), que contém os dados de configuração de recurso (configuração de RC). A cadeia de caracteres formatada pode usar a convenção [#filekey]. Se esse campo contiver um valor, a coluna Name será ignorada. Se esse campo estiver vazio, o instalador usará o valor na coluna Name. Quando esse campo contém um valor, o campo DisplayResourceId também deve conter um valor ou a instalação falhará.

Esta coluna da tabela Shortcut é usada somente quando executada no Windows Vista ou no Windows Server 2008 e, então, é ignorada. Essa coluna está disponível nas versões a partir do Windows Installer 4.0.

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

DisplayResourceId

O índice do nome de exibição do atalho. Precisa ser um número não negativo. Quando esse campo contém um valor, o campo DisplayResourceDLL também deve conter um valor ou a instalação falhará.

Esta coluna da tabela Shortcut é usada somente quando executada no Windows Vista ou no Windows Server 2008 e, então, é ignorada. Essa coluna está disponível nas versões a partir do Windows Installer 4.0.

DescriptionResourceDLL

Esse campo contém um valor de cadeia de caracteres Formatada para o caminho completo para o executável portátil neutro em linguagem (arquivo LN), que contém os dados de configuração de recurso (configuração de RC). A cadeia de caracteres formatada pode usar a convenção [#filekey]. Se esse campo contiver um valor, a coluna Name será ignorada. Se esse campo estiver vazio, o instalador usará o valor na coluna Description. Quando esse campo contém um valor, o campo DescriptionResourceId também deve conter um valor ou a instalação falhará.

Esta coluna da tabela Shortcut é usada somente quando executada no Windows Vista ou no Windows Server 2008 e, então, é ignorada. Essa coluna está disponível nas versões a partir do Windows Installer 4.0.

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

DescriptionResourceId

O índice de nome de descrição do atalho. Precisa ser um número não negativo. Quando esse campo contém um valor, o campo DescriptionResourceDLL também deve conter um valor ou a instalação falhará.

Esta coluna da tabela Shortcut é usada somente quando executada no Windows Vista ou no Windows Server 2008 e, então, é ignorada. Essa coluna está disponível nas versões a partir do Windows Installer 4.0.

Comentários

A habilitação de um recurso criará um atalho anunciado somente se a interface IShellLink do sistema for compatível com a resolução do descritor do instalador. Isso é compatível com o Microsoft Windows 2000 e sistemas que executam o Microsoft Internet Explorer 4.01. Se não for compatível, o instalador criará um atalho não anunciado após a instalação do componente do recurso, localmente ou executado na origem.

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 o aplicativo instalado mais recentemente e são removidos quando esse aplicativo é removido.

Essa tabela é referenciada quando a ação CreateShortcuts e a ação RemoveShortcuts são executadas.

Confira também a propriedade DISABLEADVTSHORTCUTS.

Validação

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