Partager via

Méthode ShellUIHelper.AddFavorite

Affiche l’interface utilisateur par défaut pour créer un élément favori. L’interface utilisateur est initialisée selon les paramètres spécifiés.

Syntaxe

iRetVal = ShellUIHelper.AddFavorite(
  sURL,
  [ vTitle ]
)

Paramètres

sURL [in]

Type : BSTR

Valeur string qui spécifie l’URL de l’élément à ajouter au dossier Favoris .

vTitle [in, facultatif]

Type : Variant*

Valeur Variant qui spécifie le nom de l’élément.

Exemples

L’exemple suivant montre l’utilisation appropriée de cette méthode pour JScript incorporé dans HTML et Visual Basic.

Jscript:

<html>
<head>
<title></title>

<object id="ShellUIHelper"
        classid="CLSID:64AB4BB7-111E-11d1-8F79-00C04FC2FBE1"
        width=0
        height=0
        VIEWASTEXT>
</object>

<script language="JavaScript">
    function fnShellUIHelperAddFavoriteJ()
    {
        ShellUIHelper.AddFavorite("https://www.msn.com", "MSN Home Page");
    }
</script>

</head>
<body onload=fnShellUIHelperAddFavoriteJ()>
</body>
</html>

Visual Basic :

Private Sub fnShellUIHelperAddFavoriteVB()
    Dim objShellUIHelper As ShellUIHelper
    
    Set objShellUIHelper = New ShellUIHelper
        objShellUIHelper.AddFavorite "https://www.msn.com", "MSN Home Page"
    Set objShellUIHelper = Nothing
End Sub

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows 2000 Server [applications de bureau uniquement]
En-tête
Exdisp.h
DLL
Shell32.dll (version 4.71 ou ultérieure)