Shell. ControlPanelItem, méthode

Exécute l’application du panneau de configuration ( *.cpl) spécifiée. Si l’application est déjà ouverte, elle activera l’instance en cours d’exécution.

Notes

à partir de Windows Vista, la plupart des applications du panneau de configuration sont des éléments de Shell et ne peuvent pas être ouvertes avec cette fonction. Pour ouvrir ces applications du panneau de configuration, transmettez le nom canonique à control.exe. Par exemple :

control.exe /name Microsoft.Personalization

Syntaxe

Shell.ControlPanelItem(
  bstrDir
)

Shell.ControlPanelItem( _
  ByVal bstrDir As BSTR _
)

Paramètres

bstrDir [ dans]

Type : BSTR

Nom de fichier de l’application du panneau de configuration. Toutes les applications du panneau de configuration ont l’extension .cpl.

Valeur de retour

JScript

Cette méthode ne retourne pas de valeur.

VB

Cette méthode ne retourne pas de valeur.

Exemples

L’exemple suivant utilise ControlPanelItem pour exécuter l’élément des propriétés d’affichage du panneau de configuration. l’utilisation appropriée est indiquée pour JScript, VBScript et Visual Basic.

JScript :

<script language="JScript">
    function fnShellControlPanelItemJ()
    {
        var objShell = new ActiveXObject("shell.application");
        
        objShell.ControlPanelItem("desk.cpl");
    }
</script>

VBScript

<script language="VBScript">
    function fnShellControlPanelItemVB()
        dim objShell
        
        set objShell = CreateObject("shell.application")
        objShell.ControlPanelItem("desk.cpl")
       
        set objShell = nothing
    end function
 </script>

Visual Basic :

Private Sub fnShellControlPanelItemVB()
    Dim objShell As Shell
    
    Set objShell = New Shell
    objShell.ControlPanelItem ("desk.cpl")
    
    Set objShell = Nothing
End Sub

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professional, Windows XP [ desktop apps uniquement]
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
En-tête
Shldisp. h
MIDL
Shldisp. idl
DLL
Shell32.dll (version 4,71 ou ultérieure)