IShellDispatch4.GetSetting, méthode

Récupère un paramètre shell global.

Syntaxe

retVal = IShellDispatch4.GetSetting(
  lSetting
)

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

Paramètres

lSetting [in]

Type : long

Valeur qui spécifie le paramètre Shell actuel à récupérer. Un seul paramètre peut être récupéré dans chaque appel. Les valeurs suivantes sont reconnues par cette méthode.

SSF_AUTOCHECKSELECT (0x00800000)

Windows Vista et versions ultérieures. État de l’option Utiliser case activée zones pour sélectionner des éléments. Cette option est activée automatiquement lorsque le système dispose d’un périphérique d’entrée de stylet configuré.

SSF_DESKTOPHTML (0x00000200)

Non utilisé.

SSF_DONTPRETTYPATH (0x00000800)

État de l’option Autoriser tous les noms en majuscules . Depuis Windows Vista, cette option de dossier n’est plus disponible.

SSF_DOUBLECLICKINWEBVIEW (0x00000080)

État de l’option Double-cliquer pour ouvrir un élément (simple clic pour sélectionner).

SSF_FILTER (0x00010000)

Non utilisé.

SSF_HIDDENFILEEXTS (0x00000004)

Non utilisé.

SSF_HIDEICONS (0x00004000)

L’état de l’icône s’affiche dans l’affichage de liste Windows Explorer. Si cette option est active, aucune icône n’est affichée dans l’affichage liste.

SSF_ICONSONLY (0x01000000)

Windows Vista et versions ultérieures. L’état du nom d’affichage s’affiche dans l’affichage de liste Windows Explorer. Si cette option est active, les icônes s’affichent dans l’affichage liste, mais pas les noms complets.

SSF_MAPNETDRVBUTTON (0x00001000)

État de l’option Afficher le lecteur réseau de la carte dans la barre d’outils . À compter de Windows Vista, cette option n’est plus disponible.

SSF_NOCONFIRMRECYCLE (0x00008000)

État de l’option de confirmation Afficher la suppression de la Corbeille.

SSF_NONETCRAWLING (0x00100000)

État de l’option Rechercher automatiquement les dossiers réseau et les imprimantes . À compter de Windows Vista, cette option n’est plus disponible.

SSF_SEPPROCESS (0x00080000)

État de l’option Lancer le dossier dans un processus distinct .

SSF_SERVERADMINUI (0x00000004)

Non utilisé.

SSF_SHOWALLOBJECTS (0x00000001)

État de l’option Fichiers et dossiers masqués .

SSF_SHOWATTRIBCOL (0x00000100)

État de l’option Afficher les attributs de fichier en mode Détail . À compter de Windows Vista, cette option n’est plus disponible.

SSF_SHOWCOMPCOLOR (0x00000008)

État de l’option Afficher les fichiers NTFS chiffrés ou compressés en couleur .

SSF_SHOWEXTENSIONS (0x00000002)

État de l’option Masquer les extensions pour les types de fichiers connus .

SSF_SHOWINFOTIP (0x00002000)

État de l’option Afficher la description contextuelle des éléments de dossier et de bureau .

SSF_SHOWSTARTPAGE (0x00400000)

Non utilisé.

SSF_SHOWSUPERHIDDEN (0x00040000)

État de l’option Masquer les fichiers de système d’exploitation protégés .

SSF_SHOWSYSFILES (0x00000020)

État de l’option Fichiers et dossiers masqués . Dans Windows Vista et versions ultérieures, cela équivaut à SSF_SHOWALLOBJECTS. Dans les versions de Windows antérieures à Windows Vista, cette valeur faisait référence à l’état de l’option Ne pas afficher les fichiers et dossiers masqués .

SSF_SHOWTYPEOVERLAY (0x02000000)

Windows Vista et versions ultérieures. État de l’option Afficher l’icône du fichier sur les miniatures . Si cette option est active, une superposition de type de fichier est appliquée lorsqu’un fichier fournit une représentation miniature.

SSF_SORTCOLUMNS (0x00000010)

Non utilisé.

SSF_STARTPANELON (0x00200000)

État de l’option d’affichage Windows XP, qui sélectionne entre le style Windows XP et le style classique. À compter de Windows Vista, cette option n’est plus disponible.

SSF_WEBVIEW (0x00020000)

État de l’option Afficher en tant qu’affichage web. À compter de Windows Vista, cette option n’est plus disponible.

SSF_WIN95CLASSIC (0x00000400)

État de l’option Style classique . À compter de Windows Vista, cette option n’est plus disponible.

Valeur retournée

JScript

Type : VARIANT_BOOL*

Définissez sur true si le paramètre existe ; sinon, false.

VB

Type : VARIANT_BOOL*

Définissez sur true si le paramètre existe ; sinon, false.

Exemples

Les exemples suivants montrent l’utilisation de GetSetting pour JScript, VBScript et 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
</script>

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (version 6.0 ou ultérieure)