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