Método Shell.GetSetting

Recupera uma configuração global do Shell.

Sintaxe

retVal = Shell.GetSetting(
  lSetting
)

Shell.GetSetting( _
  ByVal lSetting As long _
) As VARIANT_BOOL

Parâmetros

lSetting [in]

Tipo: long

Um valor que especifica a configuração atual do Shell a ser recuperada. Somente uma configuração pode ser recuperada em cada chamada. Os valores a seguir são reconhecidos por esse método.

SSF_AUTOCHECKSELECT (0x00800000)

Windows Vista e posterior. O estado das caixas Usar marcar para selecionar itens. Essa opção é habilitada automaticamente quando o sistema tem um dispositivo de entrada de caneta configurado.

SSF_DESKTOPHTML (0x00000200)

Não usado.

SSF_DONTPRETTYPATH (0x00000800)

O estado da opção Permitir todos os nomes maiúsculos . A partir do Windows Vista, essa opção de pasta não está mais disponível.

SSF_DOUBLECLICKINWEBVIEW (0x00000080)

O estado da opção Clique duas vezes para abrir um item (clique único para selecionar).

SSF_FILTER (0x00010000)

Não usado.

SSF_HIDDENFILEEXTS (0x00000004)

Não usado.

SSF_HIDEICONS (0x00004000)

O estado da exibição do ícone no modo de exibição de lista do Windows Explorer. Se essa opção estiver ativa, nenhum ícone será exibido no modo de exibição de lista.

SSF_ICONSONLY (0x01000000)

Windows Vista e posterior. O estado da exibição do nome de exibição no modo de exibição de lista do Windows Explorer. Se essa opção estiver ativa, os ícones serão exibidos no modo de exibição de lista, mas os nomes de exibição não serão.

SSF_MAPNETDRVBUTTON (0x00001000)

O estado da opção Mostrar unidade de rede do mapa na barra de ferramentas . A partir do Windows Vista, essa opção não está mais disponível.

SSF_NOCONFIRMRECYCLE (0x00008000)

O estado da opção de caixa de diálogo de confirmação Exibir exclusão da Lixeira.

SSF_NONETCRAWLING (0x00100000)

O estado da opção Pesquisar pastas e impressoras de rede automaticamente . A partir do Windows Vista, essa opção não está mais disponível.

SSF_SEPPROCESS (0x00080000)

O estado das janelas da pasta Iniciar em uma opção de processo separada.

SSF_SERVERADMINUI (0x00000004)

Não usado.

SSF_SHOWALLOBJECTS (0x00000001)

O estado da opção Arquivos e pastas ocultos .

SSF_SHOWATTRIBCOL (0x00000100)

O estado da opção Mostrar Atributos de Arquivo no Modo de Exibição de Detalhes . A partir do Windows Vista, essa opção não está mais disponível.

SSF_SHOWCOMPCOLOR (0x00000008)

O estado da opção Mostrar arquivos NTFS criptografados ou compactados em cores .

SSF_SHOWEXTENSIONS (0x00000002)

O estado da opção Ocultar extensões para tipos de arquivo conhecidos .

SSF_SHOWINFOTIP (0x00002000)

O estado da opção Mostrar descrição pop-up para itens de pasta e área de trabalho .

SSF_SHOWSTARTPAGE (0x00400000)

Não usado.

SSF_SHOWSUPERHIDDEN (0x00040000)

O estado da opção Ocultar arquivos do sistema operacional protegido .

SSF_SHOWSYSFILES (0x00000020)

O estado da opção Arquivos e pastas ocultos . No Windows Vista e posteriores, isso é equivalente a SSF_SHOWALLOBJECTS. Em versões do Windows antes do Windows Vista, esse valor se referia ao estado da opção Não mostrar arquivos e pastas ocultos .

SSF_SHOWTYPEOVERLAY (0x02000000)

Windows Vista e posterior. O estado da opção Exibir ícone de arquivo em miniaturas . Se essa opção estiver ativa, uma sobreposição de tipo de arquivo será aplicada quando um arquivo fornecer uma representação em miniatura.

SSF_SORTCOLUMNS (0x00000010)

Não usado.

SSF_STARTPANELON (0x00200000)

O estado da opção de exibição do Windows XP, que seleciona entre o estilo do Windows XP e o estilo clássico. A partir do Windows Vista, essa opção não está mais disponível.

SSF_WEBVIEW (0x00020000)

O estado da opção Exibir como um modo de exibição da Web. A partir do Windows Vista, essa opção não está mais disponível.

SSF_WIN95CLASSIC (0x00000400)

O estado da opção Estilo Clássico . A partir do Windows Vista, essa opção não está mais disponível.

Valor retornado

JScript

Tipo: VARIANT_BOOL*

Defina como true se a configuração existir; caso contrário, false.

VB

Tipo: VARIANT_BOOL*

Defina como true se a configuração existir; caso contrário, false.

Exemplos

Os exemplos a seguir mostram o uso de GetSetting para JScript, VBScript e Visual Basic.

Jscript:

<script language="JavaScript">
    function fnIShellDispatch4GetSettingJ()
    {
        var objIShellDispatch4 = new ActiveXObject("Shell.Application");
        var vReturn;
        var ssfSHOWALLOBJECTS = 1;

        vReturn = objIShellDispatch4.GetSetting(ssfSHOWALLOBJECTS);
        alert(vReturn);
    }
</script>

Vbscript:

<script language="VBScript">
    function fnIShellDispatch4GetSettingVB()
        dim objIShellDispatch4
        
        set objIShellDispatch4 = CreateObject("Shell.Application")
        if (not objIShellDispatch4 is nothing) then
            dim vReturn
            dim ssfSHOWALLOBJECTS
            
            ssfSHOWALLOBJECTS = 1
            vReturn = objIShellDispatch4.GetSetting(ssfSHOWALLOBJECTS)
            alert(vReturn)
        end if
        set objIShellDispatch4 = nothing
    end function

Visual Basic:

Private Sub fnIShellDispatch4GetSetting()
    Dim objIShellDispatch4 As Shell
    
    Set objIShellDispatch4 = New Shell
    If (Not objIShellDispatch4 Is Nothing) Then
        Dim vReturn As Variant
        Dim ssfSHOWALLOBJECTS As Long
        
        ssfSHOWALLOBJECTS = 1
        vReturn = objIShellDispatch4.GetSetting(ssfSHOWALLOBJECTS)
        Debug.Print vReturn
    End If
    Set objIShellDispatch4 = Nothing
End Sub

Requisitos

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