Tabla de acceso directo
La tabla Shortcut contiene la información que la aplicación necesita para crear accesos directos en el equipo del usuario.
La tabla Shortcut tiene las columnas siguientes.
| Columna | Tipo | Llave | Nullable |
|---|---|---|---|
| Atajo | identificador | Y | N |
| Directorio_ | identificador | N | N |
| Nombre | nombre de archivo | N | N |
| Componente_ | identificador | N | N |
| Blanco | de acceso directo de | N | N |
| Argumentos | con formato | N | Y |
| Descripción | text | N | Y |
| Hotkey | entero | N | Y |
| Icono_ | identificador | N | Y |
| IconIndex | entero | N | Y |
| ShowCmd | entero | N | Y |
| WkDir | identificador | N | Y |
| DisplayResourceDLL | con formato | N | Y |
| DisplayResourceId | entero | N | Y |
| DescripciónResourceDLL | con formato | N | Y |
| DescripciónResourceId | entero | N | Y |
Columnas
-
Acceso directo de
-
Valor de clave de esta tabla.
-
Directory_
-
Clave externa en la primera columna de la tabla Directory. Esta columna especifica el directorio en el que se crea el archivo de acceso directo.
-
nombre de
-
Nombre localizable del acceso directo que se va a crear.
-
Component_
-
Clave externa en la primera columna de la tabla componente de . El instalador usa el estado de instalación del componente especificado en esta columna para determinar si el acceso directo se crea o elimina. Este componente debe tener una ruta de acceso de clave válida para que se instale el acceso directo. Si la columna Destino contiene el nombre de una característica, el archivo iniciado por el acceso directo es el archivo clave del componente que aparece en esta columna.
-
destino de
-
Destino del acceso directo.
Para un acceso directo anunciado, esta columna debe ser una clave externa en la primera columna de la tabla de características de . El instalador evalúa la entrada en el campo Destino como Identificador y la entrada debe ser una clave externa válida en la tabla de características . 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 de con formato. El campo debe 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 obtener más información, consulte la acción CreateShortcuts.
-
argumentos de
-
Argumentos de la línea de comandos para el acceso directo.
Tenga en cuenta que la resolución de propiedades en el campo Argumentos 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.
-
descripción de
-
Descripción localizable del acceso directo.
-
tecla de acceso rápido
-
Tecla de acceso rápido del acceso directo. El byte de orden bajo contiene el código de clave virtual para la clave y el byte de orden alto contiene marcas modificadoras. Debe ser un número no negativo. Por lo general, se recomienda a los autores de paquetes de instalación que no establezcan esta opción, ya que la configuración de esta opción puede agregar teclas de acceso rápido duplicadas al escritorio de un usuario. Además, la práctica de asignar teclas de acceso rápido a métodos abreviados puede ser problemática para los usuarios que usan teclas de acceso rápido para accesibilidad.
-
Icon_
-
icono de Index
-
Índice de icono del acceso directo. Debe ser un número no negativo.
-
ShowCmd
-
Comando Mostrar para la ventana de la aplicación.
Se pueden usar los siguientes valores. Los valores son los definidos para la función de API de Windows ShowWindow.
Valor Significado 1 SW_SHOWNORMAL 3 SW_SHOWMAXIMIZED 7 SW_SHOWMINNOACTIVE -
WkDir de
-
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 con formato 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 Nombre. Si este campo está vacío, el instalador usa el valor de la columna Nombre. Cuando este campo contiene un valor, también se requiere el campo DisplayResourceId 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 de otro modo. 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 de acceso directo para su uso con recursos MUI, consulte ejemplo de acceso directo A MUI.
-
DisplayResourceId
-
Índice de nombre para mostrar del acceso directo. Debe ser un número no negativo. Cuando este campo contiene un valor, se requiere el campo DisplayResourceDLL para contener también 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 de otro modo. Esta columna está disponible con versiones no anteriores a Windows Installer 4.0.
-
DescriptionResourceDLL
-
Este campo contiene un valor de cadena con formato 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 Nombre. Si este campo está vacío, el instalador usa el valor de la columna Descripción. Cuando este campo contiene un valor, también se requiere el campo DescriptionResourceId 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 de otro modo. 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 de acceso directo para su uso con recursos MUI, consulte ejemplo de acceso directo A MUI.
-
DescriptionResourceId
-
Índice de nombre de descripción del acceso directo. Debe ser un número no negativo. Cuando este campo contiene un valor, se requiere el campo DescriptionResourceDLL para contener también 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 de otro modo. 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 del descriptor del instalador. Esto es compatible con Microsoft Windows 2000 y los sistemas que ejecutan Microsoft Internet Explorer 4.01. Si no se admite, el instalador crea un acceso directo no anunciado en la instalación del componente de la característica, ya sea localmente o se ejecuta desde el origen.
Tenga en cuenta que los accesos directos anunciados siempre apuntan a una aplicación determinada, identificada por un ProductCodey 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.
Esta tabla se conoce cuando se ejecuta la acción CreateShortcuts y se ejecuta la acción RemoveShortcuts.
Consulte también la propiedadDISABLEADVTSHORTCUTS.
Validación