Compartir a través de


Tabla Shortcut

La tabla Shortcut contiene la información que la aplicación necesita para crear accesos directos en el equipo de la persona usuaria.

La tabla Shortcut tiene las siguientes columnas.

Columna Tipo Clave Nullable
Acceso directo Identificador Y No
Directory_ Identificador No No
Nombre Nombre de archivo No No
Component_ Identificador No No
Destino Acceso directo No No
Argumentos Con formato No Y
Descripción Texto No Y
Tecla de acceso rápido Entero No Y
Icon_ Identificador No Y
IconIndex Entero No Y
ShowCmd Entero No Y
WkDir Identificador No Y
DisplayResourceDLL Formatted No Y
DisplayResourceId Entero No Y
DescriptionResourceDLL Formatted No Y
DescriptionResourceId Entero No Y

 

Columnas

Shortcut

El valor de clave de esta tabla.

Directory_

La clave externa en la primera columna de la tabla Directory. Esta columna especifica el directorio en el que se crea el archivo Shortcut.

Name

El nombre localizable del acceso directo que se va a crear.

Component_

La clave externa en la primera columna de la tabla Component. El instalador usa el estado de instalación del componente especificado en esta columna para determinar si el acceso directo se crea o se elimina. Este componente debe tener una ruta de acceso de clave válida para que se instale el acceso directo. Si la columna Target contiene el nombre de una característica, el archivo iniciado por el acceso directo es el archivo de clave del componente enumerado en esta columna.

Target

El destino del acceso directo.

Para un acceso directo anunciado, esta columna debe ser una clave externa en la primera columna de la tabla Feature. El instalador evalúa la entrada en el campo Target como un identificador y la entrada debe ser una clave externa válida en la tabla Feature. El archivo iniciado por el acceso directo en este caso es el archivo de clave del componente que aparece en la columna Component_. Cuando se activa el acceso directo, el instalador comprueba que todos los componentes de la característica se instalan antes de iniciar este archivo.

Para un acceso directo no anunciado, el instalador evalúa este campo como una cadena Formatted. El campo debería contener un identificador de propiedad entre corchetes ([ ]), que se expande en el archivo o en una carpeta a la que apunta el acceso directo. Para más información, consulte la acción CreateShortcuts.

Arguments

Los argumentos de la línea de comandos para el acceso directo.

Tenga en cuenta que la resolución de propiedades del campo Arguments está limitada. Una propiedad con formato [Property] en este campo solo se puede resolver si la propiedad ya tiene el valor previsto cuando se instala el componente que posee el acceso directo. Por ejemplo, para resolver el valor correcto del argumento "[#MyDoc.doc]", el mismo proceso debe instalar el archivo MyDoc.doc y el componente que posee el acceso directo.

Description

La descripción localizable del acceso directo.

Hotkey

La tecla de acceso rápido del acceso directo. El byte de menor valor contiene el código de clave virtual para la clave y el byte de mayor valor contiene marcas de modificador. Debe ser un número no negativo. Por lo general, se recomienda a quienes creen paquetes de instalación no establecer esta opción, ya que la configuración de esta opción puede agregar teclas de acceso rápido duplicadas al escritorio de una persona usuaria. Además, la práctica de asignar teclas de acceso rápido a accesos directos puede ser problemática para las personas que usan teclas de acceso rápido para la accesibilidad.

Icon_

La clave externa en la columna uno de la tabla Icon.

IconIndex

El índice de iconos del acceso directo. Debe ser un número no negativo.

ShowCmd

El comando Show para la ventana de la aplicación.

Se pueden usar los siguientes valores. Los valores son los definidos para la función ShowWindow de API de Windows.

Value Significado
1 SW_SHOWNORMAL
3 SW_SHOWMAXIMIZED
7 SW_SHOWMINNOACTIVE

 

WkDir

El nombre de la propiedad que tiene la ruta de acceso del directorio de trabajo para el acceso directo. El valor puede usar el formato de Windows para hacer referencia a variables de entorno, por ejemplo %USERPROFILE%. Las referencias se resuelven en una ruta de acceso real cuando el instalador resuelve el directorio de trabajo para crear el acceso directo.

DisplayResourceDLL

Este campo contiene un valor de cadena Formatted para la ruta de acceso completa al archivo ejecutable portátil (LN) independiente del lenguaje que contiene los datos de configuración de recursos (RC Config). La cadena con formato puede usar la convención [#filekey]. Si este campo contiene un valor, se omite la columna Name. Si este campo está vacío, el instalador usa el valor de la columna Name. Cuando este campo contiene un valor, el campo DisplayResourceId también es necesario para contener un valor o se produce un error en la instalación.

Esta columna de la tabla Shortcut solo se usa cuando se ejecuta en Windows Vista o Windows Server 2008, y se omite en cualquier otro caso. Esta columna está disponible con versiones no anteriores a Windows Installer 4.0.

Para obtener información sobre cómo agregar accesos directos a la tabla Shortcut para su uso con recursos MUI (interfaz de usuario multilingüe), consulte Un ejemplo de acceso directo de MUI.

DisplayResourceId

El nombre para mostrar del acceso directo. Debe ser un número no negativo. Cuando este campo contiene un valor, el campo DisplayResourceDLL también debe contener un valor o se produce un error en la instalación.

Esta columna de la tabla Shortcut solo se usa cuando se ejecuta en Windows Vista o Windows Server 2008, y se omite en cualquier otro caso. Esta columna está disponible con versiones no anteriores a Windows Installer 4.0.

DescriptionResourceDLL

Este campo contiene un valor de cadena Formatted para la ruta de acceso completa al archivo ejecutable portátil (LN) independiente del lenguaje que contiene los datos de configuración de recursos (RC Config). La cadena con formato puede usar la convención [#filekey]. Si este campo contiene un valor, se omite la columna Name. Si este campo está vacío, el instalador usa el valor de la columna Description. Cuando este campo contiene un valor, el campo DisplayResourceId también debe contener un valor o se produce un error en la instalación.

Esta columna de la tabla Shortcut solo se usa cuando se ejecuta en Windows Vista o Windows Server 2008, y se omite en cualquier otro caso. Esta columna está disponible con versiones no anteriores a Windows Installer 4.0.

Para obtener información sobre cómo agregar accesos directos a la tabla Shortcut para su uso con recursos MUI (interfaz de usuario multilingüe), consulte Un ejemplo de acceso directo de MUI.

DescriptionResourceId

El índice de nombres de descripción del acceso directo. Debe ser un número no negativo. Cuando este campo contiene un valor, el campo DisplayResourceDLL también debe contener un valor o se produce un error en la instalación.

Esta columna de la tabla Shortcut solo se usa cuando se ejecuta en Windows Vista o Windows Server 2008, y se omite en cualquier otro caso. Esta columna está disponible con versiones no anteriores a Windows Installer 4.0.

Observaciones

La habilitación de una característica crea un acceso directo anunciado solo si la interfaz IShellLink del sistema admite la resolución de descriptores del instalador. Esto es compatible con Microsoft Windows 2000 y los sistemas que ejecutan Microsoft Internet Explorer 4.01. Si no es compatible, el instalador crea un acceso directo no anunciado en la instalación del componente de la característica, ya sea localmente o ejecutado desde el origen.

Tenga en cuenta que los accesos directos anunciados siempre apuntan a una aplicación determinada, identificada por un ProductCode, y no deben compartirse entre aplicaciones. Los accesos directos anunciados solo funcionan para la aplicación instalada más recientemente y se quitan cuando se quita esa aplicación.

Se hace referencia a esta tabla cuando se ejecuta la acción CreateShortcuts y la acción RemoveShortcuts.

Consulte también la propiedad DISABLEADVTSHORTCUTS.

Validación

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