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