Compartir a través de

Método ShellUIHelper.AddDesktopComponent

Agrega un elemento al Escritorio activo de Microsoft.

Sintaxis

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

Parámetros

sURL [in]

Tipo: BSTR

Valor de tipo String que especifica la dirección URL del nuevo elemento favorito.

sType [in]

Tipo: BSTR

Valor de tipo String que especifica el tipo de elemento que se va a agregar. Puede ser uno de los valores siguientes.

(imagen)

El componente es una imagen.

(sitio web)

El componente es un sitio web.

Izquierda [in, opcional]

Tipo: Variant

Posición del borde izquierdo del componente, en coordenadas de pantalla.

Top [in, optional]

Tipo: Variant

Posición del borde superior del componente, en coordenadas de pantalla.

Ancho [in, opcional]

Tipo: Variant

Ancho del componente, en unidades de pantalla.

Alto [in, opcional]

Tipo: Variant

Alto del componente, en unidades de pantalla.

Ejemplos

En el ejemplo siguiente se muestra el uso adecuado de este método para JScript incrustado en HTML y 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

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Exdisp.h
Archivo DLL
Shell32.dll (versión 4.71 o posterior)

 

 

  • Last updated on