Tabella di scelta rapida
La tabella Collegamento contiene le informazioni necessarie all'applicazione per creare collegamenti nel computer dell'utente.
La tabella Shortcut contiene le colonne seguenti.
| Colonna | Digitare | Chiave | Nullable |
|---|---|---|---|
| Scorciatoia | identificatore | Y | N |
| Directory_ | identificatore | N | N |
| Nome | nome file | N | N |
| Componente_ | identificatore | N | N |
| Bersaglio | collegamento | N | N |
| Argomenti | formattato | N | Y |
| Descrizione | testo | N | Y |
| Hotkey | Integer | N | Y |
| Icona_ | identificatore | N | Y |
| IconIndex | Integer | N | Y |
| ShowCmd | Integer | N | Y |
| WkDir | identificatore | N | Y |
| DisplayResourceDLL | formattato | N | Y |
| DisplayResourceId | Integer | N | Y |
| DescriptionResourceDLL | formattato | N | Y |
| DescriptionResourceId | Integer | N | Y |
Colonne
-
collegamento
-
Valore della chiave per questa tabella.
-
Directory_
-
Chiave esterna nella prima colonna della tabella Directory. Questa colonna specifica la directory in cui viene creato il file collegamento.
-
nome
-
Nome localizzabile del collegamento da creare.
-
Component_
-
Chiave esterna nella prima colonna della tabella componente . 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 di tasti 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.
-
destinazione
-
Destinazione del collegamento.
Per un collegamento annunciato, questa colonna deve essere una chiave esterna nella prima colonna della tabella Feature. Il programma di installazione valuta la voce nel campo Destinazione 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 il collegamento viene attivato, il programma di installazione verifica che tutti i componenti della funzionalità siano 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 è 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.
-
tasto di scelta rapida
-
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 di pacchetti di installazione sono in genere consigliabile non impostare questa opzione, perché l'impostazione di questa opzione può aggiungere tasti di scelta rapida duplicati al desktop di un utente. Inoltre, la procedura di assegnazione di tasti di scelta rapida ai tasti di scelta rapida ai tasti di scelta rapida può essere problematica per gli utenti che usano i tasti di scelta rapida per accessibilità.
-
Icon_
-
icona Index
-
Indice dell'icona per il collegamento. Deve essere un numero non negativo.
-
ShowCmd
-
Comando Mostra per la finestra dell'applicazione.
È possibile utilizzare 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 il campo displayResourceId per contenere un valore oppure l'installazione non riesce.
Questa colonna della tabella Collegamento 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 collegamento da usare con le risorse MUI, vedere 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 Collegamento 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.
-
Descrizione ResourceDLL
-
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 il campo DescriptionResourceId per contenere un valore oppure l'installazione non riesce.
Questa colonna della tabella Collegamento 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 collegamento da usare con le risorse MUI, vedere 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 non riesce.
Questa colonna della tabella Collegamento 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.
Osservazioni
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 durante l'installazione del componente della funzionalità, in locale o eseguito dall'origine.
Si noti che i collegamenti annunciati puntano sempre a una particolare applicazione, identificata da un ProductCodee 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 viene eseguita.
Vedere anche la proprietàDISABLEADVTSHORTCUTS.
Convalida