Método Shell.ControlPanelItem

Artigo
06/13/2023

Executa o aplicativo de Painel de Controle (*.cpl) especificado. Se o aplicativo já estiver aberto, ele ativará a instância em execução.

Observação

A partir do Windows Vista, a maioria dos aplicativos Painel de Controle são itens do Shell e não podem ser abertos com essa função. Para abrir esses aplicativos Painel de Controle, passe o nome canônico para control.exe. Por exemplo:

control.exe /name Microsoft.Personalization

Sintaxe

Shell.ControlPanelItem(
  bstrDir
)


Shell.ControlPanelItem( _
  ByVal bstrDir As BSTR _
)

Parâmetros

bstrDir [in]

Tipo: BSTR

O Painel de Controle nome do arquivo do aplicativo. Todos os aplicativos Painel de Controle têm a extensão .cpl.

Valor retornado

JScript

Esse método não retorna um valor.

VB

Esse método não retorna um valor.

Exemplos

O exemplo a seguir usa ControlPanelItem para executar o item Propriedades de Exibição do Painel de Controle. O uso adequado é mostrado para JScript, VBScript e 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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (versão 4.71 ou posterior)

Compartilhar via