Collegamenti Internet
L'oggetto collegamento Internet viene usato per creare collegamenti desktop ai siti Internet. Come i collegamenti agli elementi nel file system, i collegamenti a Internet prendono la forma di un'icona sul desktop. Quando l'utente fa clic sull'icona, il browser viene avviato e visualizza il sito associato al collegamento.
Gli argomenti seguenti vengono illustrati.
Creazione di collegamenti Internet
È possibile creare un collegamento a Internet usando un controllo WebBrowser o con l'URL della pagina.
Creazione di un collegamento Internet da un controllo WebBrowser
Se l'applicazione ospita un controllo WebBrowser, è possibile usare l'oggetto collegamento Internet per creare collegamenti nel modo seguente.
- Creare un'istanza dell'oggetto collegamento Internet con CoCreateInstance usando un identificatore di classe (CLSID) di CLSID_InternetShortcut.
- Passare il puntatore all'interfaccia IUnknown di WebBrowser all'oggetto collegamento Internet con IObjectWithSite::SetSite.
- Chiamare il metodo IPersistFile dell'oggetto collegamento Internet::Save quando si vuole creare un collegamento alla pagina visualizzata dal controllo WebBrowser.
Verrà creato un collegamento nel percorso specificato in IPersistFile::Save. Questa posizione consente al controllo WebBrowser di ripristinare lo stato, che include l'attività di caricamento dei documenti corretti nei set di fotogrammi.
Creazione di un collegamento Internet da un URL
È anche possibile creare un collegamento a Internet se si ha l'URL della pagina a cui si vuole collegare.
- Creare un'istanza dell'oggetto collegamento Internet con CoCreateInstance usando un CLSID di CLSID_InternetShortcut.
- Usare il metodo IUniformResourceLocator::SetURL per impostare l'URL nel collegamento.
- Usare il metodo IPersistFile::Save per salvare il file di collegamento in un percorso desiderato.
Accesso all'archiviazione delle proprietà
L'oggetto collegamento Internet contiene diverse proprietà che è possibile accedere tramite l'interfaccia IPropertySetStorage dell'oggetto con la procedura seguente.
- Ottenere l'interfaccia IPropertySetStorage chiamando QueryInterface con IID_IPropertySetStorage.
- Accedere all'archiviazione delle proprietà di collegamento Internet chiamando IPropertySetStorage::Open con FMTID_Intshcut o FMTID_InternetSite per ottenere l'interfaccia IPropertyStorage .
- Leggere le informazioni sull'archiviazione delle proprietà con IPropertyStorage::ReadMultiple passando l'ID proprietà appropriato.
Con la versione 4.70 o successiva di Shell32.dll, è anche possibile recuperare l'interfaccia IPropertySetStorage chiamando IShellFolder::BindToStorage con il parametro pidl impostato su . File URL e parametro riid impostato su IID_IPropertySetStorage.
Gli ID delle proprietà seguenti possono essere richiesti per FMTID_Intshcut.
| PROPID | Tipo variante | Descrizione |
|---|---|---|
| PID_IS_URL | VT_LPWSTR | URL a cui conduce il collegamento |
| PID_IS_NAME | VT_LPWSTR | Nome del collegamento a Internet |
| PID_IS_WORKINGDIR | VT_LPWSTR | Directory di lavoro per il collegamento |
| PID_IS_HOTKEY | VT_UI2 | Tasti di scelta rapida per il collegamento |
| PID_IS_SHOWCMD | VT_I4 | Mostra comando per il collegamento |
| PID_IS_ICONINDEX | VT_I4 | Indice dell'icona |
| PID_IS_ICONFILE | VT_LPWSTR | File contenente l'icona |
| PID_IS_WHATSNEW | VT_LPWSTR | Nuovo testo |
| PID_IS_AUTHOR | VT_LPWSTR | Autore |
| PID_IS_DESCRIPTION | VT_LPWSTR | Testo della descrizione del sito |
| PID_IS_COMMENT | VT_LPWSTR | Commento annotato dall'utente |
| PID_IS_ROAMED | VT_BOOL | True quando viene eseguito il roaming per la prima volta |
Gli ID delle proprietà seguenti possono essere richiesti per FMTID_InternetSite.
| PROPID | Tipo variante | Descrizione |
|---|---|---|
| PID_INTSITE_WHATSNEW | VT_LPWSTR | Nuovo testo |
| PID_INTSITE_AUTHOR | VT_LPWSTR | Autore |
| PID_INTSITE_LASTVISIT | VT_FILETIME | Il sito dell'ora è stato visitato l'ultima volta |
| PID_INTSITE_LASTMOD | VT_FILETIME | Il sito ora è stato modificato per l'ultima volta |
| PID_INTSITE_VISITCOUNT | VT_UI4 | Numero di volte in cui l'utente ha visitato |
| PID_INTSITE_DESCRIPTION | VT_LPWSTR | Testo della descrizione del sito |
| PID_INTSITE_COMMENT | VT_LPWSTR | Commento con annotazioni utente |
| PID_INTSITE_FLAGS | VT_UI4 | Indica l'uso di flag PIDISF_ (vedere di seguito) |
| PID_INTSITE_CONTENTLEN | N/D | Attualmente non supportato |
| PID_INTSITE_CONTENTCODE | N/D | Attualmente non supportato |
| PID_INTSITE_RECURSE | N/D | Attualmente non supportato |
| PID_INTSITE_WATCH | N/D | Attualmente non supportato |
| PID_INTSITE_SUBSCRIPTION | VT_UI8 | Valore SUBSCRIPTIONCOOKIE per gestione sottoscrizioni |
| PID_INTSITE_URL | VT_LPWSTR | URL a cui conduce il collegamento |
| PID_INTSITE_TITLE | VT_LPWSTR | Titolo |
| PID_INTSITE_CODEPAGE | VT_UI4 | Tabella codici del documento |
| PID_INTSITE_TRACKING | N/D | Attualmente non supportato |
| PID_INTSITE_ICONINDEX | VT_I4 | Indice dell'icona |
| PID_INTSITE_ICONFILE | VT_LPWSTR | File contenente l'icona |
| PID_INTSITE_ROAMED | VT_UI4 | La voce è stata aggiunta a causa del roaming |
Di seguito sono riportati i flag del sito Internet.
| Flag | Descrizione |
|---|---|
| PIDISF_RECENTLYCHANGED | Indica che un sito è stato modificato di recente |
| PIDISF_CACHEDSTICKY | Attualmente non supportato |
| PIDISF_CACHEIMAGES | Attualmente non supportato |
| PIDISF_FOLLOWALLLINKS | Attualmente non supportato |
I valori seguenti vengono usati per la cronologia roaming Internet.
| Valore di PID_INTSITE_ROAMED | Descrizione |
|---|---|
| Valore non impostato o PIDISR_UP_TO_DATE | Questa voce della cache non è stata modificata dal roaming. |
| PIDISR_NEEDS_ADD | Questa voce della cache è stata aggiunta alla cache tramite roaming. Impostare PIDISR_UP_TO_DATE al termine dell'elaborazione della voce. |
| PIDISR_NEEDS_UPDATE | Questa voce della cache esiste già nel computer locale, ma è stata aggiornata tramite roaming. Impostare PIDISR_UP_TO_DATE al termine dell'elaborazione della voce. |
| PIDISR_NEEDS_DELETE | Roaming ha rilevato che questa voce della cache deve essere eliminata. Ad esempio, l'utente potrebbe aver cancellato la cronologia del browser. Eliminare la voce usando DeleteUrlCacheEntry. |
Interfacce
L'oggetto collegamento Internet espone una serie di interfacce.
OLE (interfacce)
Interfacce della shell
Funzioni
Esistono diverse funzioni di utilità che possono essere usate con l'oggetto collegamento a Internet.
Funzioni dell'utilità collegamento a Internet