Raccourcis Internet
L’objet raccourci Internet est utilisé pour créer des raccourcis de bureau sur 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 présentées.
Création de raccourcis Internet
Vous pouvez créer un raccourci Internet à l’aide d’un contrôle WebBrowser ou de 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 raccourci Internet pour créer des raccourcis de la façon suivante.
- Créez une instance de l’objet raccourci Internet avec CoCreateInstance, à l’aide d’un identificateur de classe (CLSID) du CLSID _ InternetShortcut.
- Transmettez le pointeur à l’interface IUnknown du WebBrowser à l’objet 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 affichée par le contrôle WebBrowser.
Un raccourci sera créé à l’emplacement spécifié dans IPersistFile :: Save. Cet emplacement permet au contrôle WebBrowser de restaurer son état, ce qui comprend la tâche de chargement des documents corrects dans les jeux de frames.
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 établir un lien.
- Créez une instance de l’objet 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 à l’emplacement souhaité.
accès à la propriété Stockage
L’objet raccourci Internet contient plusieurs propriétés auxquelles vous pouvez accéder par le biais de l’interface IPropertySetStorage de l’objet à l’aide de la procédure suivante.
- Pour accéder à l’interface IPropertySetStorage , appelez QueryInterface avec IID _ IPropertySetStorage.
- Accédez au jeu de stockage des propriétés du raccourci Internet en appelant IPropertySetStorage :: Open avec fmtid _ Intshcut ou fmtid _ InternetSite pour obtenir l’interface IPropertyStorage .
- Lisez les informations de stockage des propriétés avec IPropertyStorage :: ReadMultiple en passant l’ID de propriété approprié.
Avec la version 4,70 ou une version 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. 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 _ est une _ URL | _LPWStr VT | URL vers laquelle le raccourci dirige |
| PID _ est le _ nom | _LPWStr VT | Nom du raccourci Internet |
| le PID _ est _ WORKINGDIR | _LPWStr VT | Répertoire de travail pour le raccourci |
| le PID _ est _ Hotkey | _UI2 VT | Raccourci clavier pour le raccourci |
| PID _ est _ SHOWCMD | VT _ | Afficher la commande pour le raccourci |
| le PID _ est _ IndexIcône | VT _ | Index de l’icône |
| le PID _ est _ ICONFILE | _LPWStr VT | Fichier qui contient l’icône |
| PID _ est _ WHATSNEW | _LPWStr VT | Texte des nouveautés |
| PID _ est _ auteur | _LPWStr VT | Auteur |
| PID _ est une _ Description | _LPWStr VT | Texte de description du site |
| PID _ est un _ Commentaire | _LPWStr VT | Commentaire annoté par l’utilisateur |
| PID _ est _ itinérant | 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 | _LPWStr VT | Texte des nouveautés |
| PID _ INTSITE _ auteur | _LPWStr VT | Auteur |
| PID _ INTSITE _ LASTVISIT | de VT _ fileTime | Heure de la dernière visite du site |
| PID _ INTSITE _ LASTMOD | de VT _ fileTime | Heure de la dernière modification du site |
| PID _ INTSITE _ VISITCOUNT | VT _ UI4 | Nombre de fois que l’utilisateur a visité |
| _Description INTSITE _ PID | _LPWStr VT | Texte de description du site |
| PID _ INTSITE, _ Commentaire | _LPWStr VT | Commentaire annoté par l’utilisateur |
| _indicateurs INTSITE _ PID | VT _ UI4 | Indique l’utilisation des _ indicateurs PIDISF (voir ci-dessous) |
| PID _ INTSITE _ CONTENTLEN | N/A | Non prise en charge pour le moment |
| PID _ INTSITE _ CONTENTCODE | N/A | Non prise en charge pour le moment |
| PID _ INTSITE _ recurse | N/A | Non prise en charge pour le moment |
| PID _ INTSITE _ Watch | N/A | Non prise en charge pour le moment |
| PID _ INTSITE _ subscription | _UI8 VT | Valeur SUBSCRIPTIONCOOKIE pour le gestionnaire d’abonnements |
| _URL INTSITE _ PID | _LPWStr VT | URL vers laquelle le raccourci dirige |
| _titre INTSITE _ PID | _LPWStr VT | Titre |
| _page de _ codes PID INTSITE | VT _ UI4 | Page de codes du document |
| _ _ suivi des INTSITE PID | N/A | Non prise en charge pour le moment |
| PID _ INTSITE _ IndexIcône | VT _ | Index de l’icône |
| PID _ INTSITE _ ICONFILE | _LPWStr VT | Fichier qui contient l’icône |
| PID _ INTSITE _ itinérant | VT _ UI4 | L’entrée a été ajoutée en raison de l’itinérance |
Les indicateurs de site Internet sont les suivants.
| Indicateur | Description |
|---|---|
| PIDISF _ RECENTLYCHANGED | Indique qu’un site a été modifié récemment |
| PIDISF _ CACHEDSTICKY | Non prise en charge pour le moment |
| PIDISF _ CACHEIMAGES | Non prise en charge pour le moment |
| PIDISF _ FOLLOWALLLINKS | Non prise en charge pour le moment |
Les valeurs suivantes sont utilisées pour l’historique d’itinérance Internet.
| Valeur du PID _ INTSITE _ itinérante | Description |
|---|---|
| Valeur non définie ou PIDISR _ _ à _ jour | Cette entrée de cache n’a pas été modifiée par l’itinérance. |
| PIDISR _ a besoin d' _ Ajouter | Cette entrée du cache a été ajoutée au cache par itinérance. Définissez PIDISR _ _ à _ jour une fois que le traitement de l’entrée est terminé. |
| PIDISR _ a besoin d’une _ mise à jour | Cette entrée de cache existait déjà sur l’ordinateur local, mais elle a été mise à jour par l’itinérance. Définissez PIDISR _ _ à _ jour une fois que le traitement de l’entrée est terminé. |
| PIDISR _ doit être _ supprimé | L’itinérance a détecté que cette entrée de cache devait être supprimée. Par exemple, l’utilisateur a peut-être effacé l’historique de son navigateur. Supprimez l’entrée à l’aide de DeleteUrlCacheEntry. |
Interfaces
L’objet raccourci Internet expose un certain nombre d’interfaces.
interfaces OLE
Interfaces Shell
Fonctions
Il existe plusieurs fonctions utilitaires qui peuvent être utilisées avec l’objet raccourci Internet.