ShellUIHelper.AddDesktopComponent-Methode

Fügt Microsoft Active Desktop ein Element hinzu.

Syntax

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

Parameter

sURL [in]

Typ: BSTR

Ein String-Wert , der die URL des neuen Favoritenelements angibt.

sType [in]

Typ: BSTR

Ein String-Wert , der den Typ des hinzugefügten Elements angibt. Dies kann einer der folgenden Werte sein.

(Bild)

Die Komponente ist ein Image.

(Website)

Die Komponente ist eine Website.

Left [in, optional]

Typ: Variant

Die Position des linken Rands der Komponente in Bildschirmkoordinaten.

Top [in, optional]

Typ: Variant

Die Position des oberen Rands der Komponente in Bildschirmkoordinaten.

Breite [in, optional]

Typ: Variant

Die Breite der Komponente in Bildschirmeinheiten.

Höhe [in, optional]

Typ: Variant

Die Höhe der Komponente in Bildschirmeinheiten.

Beispiele

Das folgende Beispiel zeigt die ordnungsgemäße Verwendung dieser Methode für JScript, die in HTML und Visual Basic eingebettet ist.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Exdisp.h
DLL
Shell32.dll (Version 4.71 oder höher)