Compartilhar via


Método IShellDispatch.ControlPanelItem

Executa o aplicativo Painel de Controle 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

IShellDispatch.ControlPanelItem(
  bstrDir
)

IShellDispatch.ControlPanelItem( _
  ByVal bstrDir As BSTR _
)

Parâmetros

bstrDir [in]

Tipo: BSTR

O nome do arquivo do aplicativo Painel de Controle.

Valor retornado

JScript

Esse método não retorna um valor.

VB

Esse método não retorna um valor.

Comentários

Esse método é implementado e acessado por meio do método Shell.ControlPanelItem .

Exemplos

Os exemplos a seguir usam ControlPanelItem para executar o item Propriedades de Exibição do Painel de Controle. O uso é mostrado para JScript, VBScript e Visual Basic.

Jscript:

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

Vbscript:

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

Visual Basic:

Private Sub fnShellControlPanelItemVB()
    Dim objShell As Shell
    
    Set objShell = New Shell
    objshell.Shell_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)