Tabella di scelta rapida
La tabella Collegamento contiene le informazioni necessarie all'applicazione per creare collegamenti nel computer dell'utente.
La tabella Collegamento contiene le colonne seguenti.
| Colonna | Tipo | Chiave | Nullable |
|---|---|---|---|
| Tasto di scelta rapida | Identificatore | S | N |
| Directory_ | Identificatore | N | N |
| Nome | Filename | N | N |
| Componente_ | Identificatore | N | N |
| Destinazione | Scelte rapide | N | N |
| Argomenti | Formattato | N | S |
| Descrizione | Text | N | S |
| Tasto di scelta rapida | Integer | N | S |
| Icona_ | Identificatore | N | S |
| IconIndex | Integer | N | S |
| ShowCmd | Integer | N | S |
| WkDir | Identificatore | N | S |
| DisplayResourceDLL | Formattato | N | S |
| DisplayResourceId | Integer | N | S |
| DescriptionResourceDLL | Formattato | N | S |
| DescriptionResourceId | Integer | N | S |
Colonne
-
Scelta rapida
-
Valore chiave per questa tabella.
-
Directory_
-
Chiave esterna nella prima colonna della tabella Directory. Questa colonna specifica la directory in cui viene creato il file di collegamento.
-
Nome
-
Nome localizzabile del collegamento da creare.
-
Componente_
-
Chiave esterna nella prima colonna della tabella Component. Il programma di installazione usa lo stato di installazione del componente specificato in questa colonna per determinare se il collegamento viene creato o eliminato. Questo componente deve avere un percorso chiave valido per l'installazione del collegamento. Se la colonna Target contiene il nome di una funzionalità, il file avviato dal collegamento è il file chiave del componente elencato in questa colonna.
-
Bersaglio
-
Destinazione del collegamento.
Per un collegamento annunciato, questa colonna deve essere una chiave esterna nella prima colonna della tabella Funzionalità. Il programma di installazione valuta la voce nel campo Target come identificatore e la voce deve essere una chiave esterna valida nella tabella delle funzionalità. Il file avviato dal collegamento in questo caso è il file chiave del componente elencato nella colonna Component_. Quando viene attivato il collegamento, il programma di installazione verifica che tutti i componenti della funzionalità vengano installati prima di avviare questo file.
Per un collegamento non annunciato, il programma di installazione valuta questo campo come stringa formattata . Il campo deve contenere un identificatore di proprietà racchiuso tra parentesi quadre ([ ]), espanso nel file o in una cartella a cui punta il collegamento. Per altre informazioni, vedere l'azione CreateShortcuts.
-
Argomenti
-
Argomenti della riga di comando per il collegamento.
Si noti che la risoluzione delle proprietà nel campo Argomenti è limitata. Una proprietà formattata come [Property] in questo campo può essere risolta solo se la proprietà ha già il valore previsto quando il componente proprietario del collegamento viene installato. Ad esempio, per risolvere il valore corretto per l'argomento "[#MyDoc.doc]", lo stesso processo deve installare il file MyDoc.doc e il componente proprietario del collegamento.
-
Descrizione
-
Descrizione localizzabile del collegamento.
-
Hotkey
-
Tasto di scelta rapida per il collegamento. Il byte con ordine basso contiene il codice della chiave virtuale per la chiave e il byte di ordine elevato contiene flag di modificatore. Deve essere un numero non negativo. Gli autori dei pacchetti di installazione sono in genere sconsigliati di impostare questa opzione, perché l'impostazione di questa opzione può aggiungere tasti di scelta rapida duplicati al desktop di un utente. Inoltre, la pratica di assegnare i tasti di scelta rapida ai tasti di scelta rapida può essere problematica per gli utenti che usano i tasti di scelta rapida per l'accessibilità.
-
Icona_
-
Chiave esterna alla colonna 1 della tabella Icon.
-
IconIndex
-
Indice dell'icona per il collegamento. Deve essere un numero non negativo.
-
ShowCmd
-
Comando Mostra per la finestra dell'applicazione.
È possibile usare i valori seguenti. I valori sono definiti per la funzione API Windows ShowWindow.
Valore Significato 1 SW_SHOWNORMAL 3 SW_SHOWMAXIMIZED 7 SW_SHOWMINNOACTIVE -
WkDir
-
Nome della proprietà con il percorso della directory di lavoro per il collegamento. Il valore può usare il formato Windows per fare riferimento alle variabili di ambiente, ad esempio %USERPROFILE%. I riferimenti vengono risolti in un percorso effettivo quando il programma di installazione risolve la directory di lavoro per creare il collegamento.
-
DisplayResourceDLL
-
Questo campo contiene un valore stringa formattato per il percorso completo del file eseguibile portabile indipendente dalla lingua (file LN) che contiene i dati di configurazione della risorsa (RC Config). La stringa formattata può usare la convenzione [#filekey]. Se questo campo contiene un valore, la colonna Name viene ignorata. Se questo campo è vuoto, il programma di installazione usa il valore nella colonna Nome. Quando questo campo contiene un valore, è necessario anche che il campo DisplayResourceId contenga un valore o che l'installazione non riesca.
Questa colonna della tabella Shortcut viene utilizzata solo quando è in esecuzione in Windows Vista o Windows Server 2008 e viene altrimenti ignorata. Questa colonna è disponibile con versioni non precedenti a Windows Installer 4.0.
Per informazioni su come aggiungere collegamenti alla tabella di collegamento da usare con le risorse MUI, vedere Un esempio di collegamento MUI.
-
DisplayResourceId
-
Indice del nome visualizzato per il collegamento. Deve essere un numero non negativo. Quando questo campo contiene un valore, è necessario che il campo DisplayResourceDLL contenga anche un valore o che l'installazione non riesca.
Questa colonna della tabella Shortcut viene utilizzata solo quando è in esecuzione in Windows Vista o Windows Server 2008 e viene altrimenti ignorata. Questa colonna è disponibile con versioni non precedenti a Windows Installer 4.0.
-
DescriptionResourceDLL
-
Questo campo contiene un valore stringa formattato per il percorso completo del file eseguibile portabile indipendente dalla lingua (file LN) che contiene i dati di configurazione della risorsa (RC Config). La stringa formattata può usare la convenzione [#filekey]. Se questo campo contiene un valore, la colonna Name viene ignorata. Se questo campo è vuoto, il programma di installazione usa il valore nella colonna Descrizione. Quando questo campo contiene un valore, è necessario anche che il campo DescriptionResourceId contenga un valore o che l'installazione non riesca.
Questa colonna della tabella Shortcut viene utilizzata solo quando è in esecuzione in Windows Vista o Windows Server 2008 e viene altrimenti ignorata. Questa colonna è disponibile con versioni non precedenti a Windows Installer 4.0.
Per informazioni su come aggiungere collegamenti alla tabella di collegamento da usare con le risorse MUI, vedere Un esempio di collegamento MUI.
-
DescriptionResourceId
-
Indice del nome della descrizione per il collegamento. Deve essere un numero non negativo. Quando questo campo contiene un valore, il campo DescriptionResourceDLL deve contenere anche un valore o l'installazione ha esito negativo.
Questa colonna della tabella Shortcut viene utilizzata solo quando è in esecuzione in Windows Vista o Windows Server 2008 e viene altrimenti ignorata. Questa colonna è disponibile con versioni non precedenti a Windows Installer 4.0.
Commenti
L'abilitazione di una funzionalità crea un collegamento annunciato solo se l'interfaccia IShellLink del sistema supporta la risoluzione del descrittore del programma di installazione. Questa funzionalità è supportata da Microsoft Windows 2000 e dai sistemi che eseguono Microsoft Internet Explorer 4.01. Se non è supportato, il programma di installazione crea un collegamento non annunciato all'installazione del componente della funzionalità, in locale o eseguito dall'origine.
Si noti che i collegamenti annunciati puntano sempre a una determinata applicazione, identificata da un codice ProductCode, e non devono essere condivisi tra le applicazioni. I collegamenti annunciati funzionano solo per l'applicazione installata più di recente e vengono rimossi quando tale applicazione viene rimossa.
Questa tabella viene definita quando viene eseguita l'azione CreateShortcuts e l'azione RemoveShortcuts .
Vedere anche la proprietà DISABLEADVTSHORTCUTS .
Convalida