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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de