Condividi tramite

Metodo ShellUIHelper.AddDesktopComponent

  • Articolo

Aggiunge un elemento a Microsoft Active Desktop.

Sintassi

iRetVal = ShellUIHelper.AddDesktopComponent(
  sURL,
  sType,
  [ Left ],
  [ Top ],
  [ Width ],
  [ Height ]
)

Parametri

sURL [in]

Tipo: BSTR

Valore String che specifica l'URL del nuovo elemento preferito.

sType [in]

Tipo: BSTR

Valore String che specifica il tipo di elemento aggiunto. Questo può essere uno dei valori seguenti.

(immagine)

Il componente è un'immagine.

(sito Web)

Il componente è un sito Web.

A sinistra [in, facoltativo]

Tipo: Variant

Posizione del bordo sinistro del componente, nelle coordinate dello schermo.

Top [in, facoltativo]

Tipo: Variant

Posizione del bordo superiore del componente, nelle coordinate dello schermo.

Larghezza [in, facoltativa]

Tipo: Variant

Larghezza del componente, nelle unità dello schermo.

Altezza [in, facoltativa]

Tipo: Variant

Altezza del componente, nelle unità dello schermo.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo appropriato di questo metodo per JScript incorporato in HTML e 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 fnShellUIHelperAddDesktopComponentJ()
    {
        ShellUIHelper.AddDesktopComponent("https://www.microsoft.com/", "website");
    }
</script>

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

Visual Basic:

Private Sub fnShellUIHelperAddDesktopComponentVB()
    Dim objShellUIHelper As ShellUIHelper
    
    Set objShellUIHelper = New ShellUIHelper
        objShellUIHelper.AddDesktopComponent "https://www.microsoft.com/", "website"
    Set objShellUIHelper = Nothing
End Sub

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]
Intestazione
Exdisp.h
DLL
Shell32.dll (versione 4.71 o successiva)