Raccourcis Internet
L’objet de raccourci Internet est utilisé pour créer des raccourcis de bureau vers des sites Internet. Comme les raccourcis vers les éléments du système de fichiers, les raccourcis Internet prennent la forme d’une icône sur le bureau. Lorsque l’utilisateur clique sur l’icône, le navigateur est lancé et affiche le site associé au raccourci.
Les rubriques suivantes sont abordées.
- création de raccourcis Internet
- accès au stockage de propriétés
-
interfaces
- interfaces OLE
- interfaces Shell
- Functions
Création de raccourcis Internet
Vous pouvez créer un raccourci Internet à l’aide d’un contrôle WebBrowser ou avec l’URL de la page.
Création d’un raccourci Internet à partir d’un contrôle WebBrowser
Si votre application héberge un contrôle WebBrowser, vous pouvez utiliser l’objet de raccourci Internet pour créer des raccourcis de la manière suivante.
- Créez une instance de l’objet de raccourci Internet avec CoCreateInstance, à l’aide d’un identificateur de classe (CLSID) de CLSID_InternetShortcut.
- Passez le pointeur à l’interface IUnknown de WebBrowser à l’objet de raccourci Internet avec IObjectWithSite ::SetSite.
- Appelez la méthode iPersistFile ::Save de l’objet de raccourci Internet lorsque vous souhaitez créer un raccourci vers la page en cours d’affichage par le contrôle WebBrowser.
Un raccourci est créé à l’emplacement spécifié dans IPersistFile ::Save. Cet emplacement permet au contrôle WebBrowser de restaurer son état, ce qui inclut la tâche de chargement des documents appropriés dans des framesets.
Création d’un raccourci Internet à partir d’une URL
Vous pouvez également créer un raccourci Internet si vous avez l’URL de la page à laquelle vous souhaitez lier.
- Créez une instance de l’objet de raccourci Internet avec CoCreateInstance, à l’aide d’un CLSID de CLSID_InternetShortcut.
- Utilisez la méthode IUniformResourceLocator ::SetURL pour définir l’URL dans le raccourci.
- Utilisez la méthode IPersistFile ::Save pour enregistrer le fichier de raccourci à un emplacement souhaité.
Accès au stockage de propriétés
L’objet de raccourci Internet contient plusieurs propriétés auxquelles vous pouvez accéder via l’interface IPropertySetStorage de l’objet avec la procédure suivante.
- Obtenez l’interface IPropertySetStorage en appelant QueryInterface avec IID_IPropertySetStorage.
- Accédez au stockage de propriétés de raccourci Internet défini en appelant IPropertySetStorage ::Open avec FMTID_Intshcut ou FMTID_InternetSite pour obtenir l’interface IPropertyStorage.
- Lisez les informations de stockage de propriétés avec IPropertyStorage ::ReadMultiple en transmettant l’ID de propriété approprié.
Avec version 4.70 ou ultérieure de Shell32.dll, vous pouvez également récupérer l’interface IPropertySetStorage en appelant IShellFolder ::BindToStorage avec le paramètre pidl défini sur le . Fichier URL et paramètre riid défini sur IID_IPropertySetStorage.
Les ID de propriété suivants peuvent être demandés pour FMTID_Intshcut.
PROPID | Type de variante | Description |
---|---|---|
PID_IS_URL | VT_LPWSTR | URL vers laquelle le raccourci mène |
PID_IS_NAME | VT_LPWSTR | Nom du raccourci Internet |
PID_IS_WORKINGDIR | VT_LPWSTR | Répertoire de travail pour le raccourci |
PID_IS_HOTKEY | VT_UI2 | Touche d’accès rapide pour le raccourci |
PID_IS_SHOWCMD | VT_I4 | Afficher la commande pour le raccourci |
PID_IS_ICONINDEX | VT_I4 | Index de l’icône |
PID_IS_ICONFILE | VT_LPWSTR | Fichier qui contient l’icône |
PID_IS_WHATSNEW | VT_LPWSTR | Nouveautés |
PID_IS_AUTHOR | VT_LPWSTR | Auteur |
PID_IS_DESCRIPTION | VT_LPWSTR | Texte de description du site |
PID_IS_COMMENT | VT_LPWSTR | Commentaire annoté par l’utilisateur |
PID_IS_ROAMED | VT_BOOL | True lorsque le raccourci est itinérant pour la première fois |
Les ID de propriété suivants peuvent être demandés pour FMTID_InternetSite.
PROPID | Type de variante | Description |
---|---|---|
PID_INTSITE_WHATSNEW | VT_LPWSTR | Nouveautés |
PID_INTSITE_AUTHOR | VT_LPWSTR | Auteur |
PID_INTSITE_LASTVISIT | VT_FILETIME | Le site d’heure a été visité pour la dernière fois |
PID_INTSITE_LASTMOD | VT_FILETIME | Heure de dernière modification du site |
PID_INTSITE_VISITCOUNT | VT_UI4 | Nombre de fois que l’utilisateur a visité |
PID_INTSITE_DESCRIPTION | VT_LPWSTR | Texte de description du site |
PID_INTSITE_COMMENT | VT_LPWSTR | Commentaire annoté par l’utilisateur |
PID_INTSITE_FLAGS | VT_UI4 | Indique l’utilisation des indicateurs de PIDISF_ (voir ci-dessous) |
PID_INTSITE_CONTENTLEN | N/A | Non pris en charge actuellement |
PID_INTSITE_CONTENTCODE | N/A | Non pris en charge actuellement |
PID_INTSITE_RECURSE | N/A | Non pris en charge actuellement |
PID_INTSITE_WATCH | N/A | Non pris en charge actuellement |
PID_INTSITE_SUBSCRIPTION | VT_UI8 | Valeur SUBSCRIPTIONCOOKIE pour le gestionnaire d’abonnements |
PID_INTSITE_URL | VT_LPWSTR | URL vers laquelle le raccourci mène |
PID_INTSITE_TITLE | VT_LPWSTR | Titre |
PID_INTSITE_CODEPAGE | VT_UI4 | Page de codes du document |
PID_INTSITE_TRACKING | N/A | Non pris en charge actuellement |
PID_INTSITE_ICONINDEX | VT_I4 | Index de l’icône |
PID_INTSITE_ICONFILE | VT_LPWSTR | Fichier qui contient l’icône |
PID_INTSITE_ROAMED | VT_UI4 | L’entrée a été ajoutée en raison de l’itinérance |
Voici les indicateurs de site Internet.
Drapeau | Description |
---|---|
PIDISF_RECENTLYCHANGED | Indique qu’un site a été récemment modifié |
PIDISF_CACHEDSTICKY | Non pris en charge actuellement |
PIDISF_CACHEIMAGES | Non pris en charge actuellement |
PIDISF_FOLLOWALLLINKS | Non pris en charge actuellement |
Les valeurs suivantes sont utilisées pour l’historique d’itinérance Internet.
Valeur de PID_INTSITE_ROAMED | Description |
---|---|
Valeur non définie ou PIDISR_UP_TO_DATE | Cette entrée de cache n’a pas été modifiée par itinérance. |
PIDISR_NEEDS_ADD | Cette entrée de cache a été ajoutée au cache en itinérance. Définissez PIDISR_UP_TO_DATE une fois le traitement de l’entrée terminé. |
PIDISR_NEEDS_UPDATE | Cette entrée de cache existait déjà sur l’ordinateur local, mais elle a été mise à jour par itinérance. Définissez PIDISR_UP_TO_DATE une fois le traitement de l’entrée terminé. |
PIDISR_NEEDS_DELETE | Itinérance a détecté que cette entrée de cache doit être supprimée. Par exemple, l’utilisateur peut avoir effacé son historique de navigateur. Supprimez l’entrée à l’aide de DeleteUrlCacheEntry. |
Interfaces
L’objet de raccourci Internet expose un certain nombre d’interfaces.
Interfaces OLE
- IDataObject
- IPersistFile
- IPersistStream
- IOleCommandTarget
- IPropertySetStorage
- IObjectWithSite
Interfaces shell
Fonctions
Il existe plusieurs fonctions utilitaires qui peuvent être utilisées avec l’objet de raccourci Internet.
Fonctions utilitaires de raccourci Internet
- InetIsOffline
- MIMEAssociationDialog
- TranslateURL
- URLAssociationDialog