Méthode Folder.GetDetailsOf

Article
06/13/2023

Récupère les détails d’un élément dans un dossier. Par exemple, sa taille, son type ou l’heure de sa dernière modification.

Syntaxe

retVal = Folder.GetDetailsOf(
  vItem,
  iColumn
)

Paramètres

vItem

Type : Variant

Élément pour lequel récupérer les informations. Il doit s’agir d’un objet FolderItem .

iColumn

Type : Entier

Valeur Integer qui spécifie les informations à récupérer. Les informations disponibles pour un élément dépendent du dossier dans lequel il est affiché. Cette valeur correspond au numéro de colonne de base zéro affiché dans une vue Shell. Pour un élément du système de fichiers, il peut s’agir de l’une des valeurs suivantes :

(0)

Récupère le nom de l’élément.

(1)

Récupère la taille de l’élément.

(2)

Récupère le type de l’élément.

(3)

Récupère la date et l’heure de la dernière modification de l’élément.

(4)

Récupère les attributs de l’élément.

(-1)

Récupère les informations d’info-bulle pour l’élément.

Valeur retournée

Type : BSTR*

Chaîne contenant le détail récupéré.

Notes

Toutes les méthodes ne sont pas implémentées pour tous les dossiers. Par exemple, la méthode ParseName n’est pas implémentée pour le dossier Panneau de configuration (CSIDL_CONTROLS). Si vous tentez d’appeler une méthode non implémentée, une erreur 0x800A01BD (décimale 445) est générée.

Exemples

L’exemple suivant utilise GetDetailsOf pour récupérer le type du fichier nommé Clock.avi. Une utilisation correcte est indiquée pour JScript, VBScript et Visual Basic.

Jscript:

<script language="JScript">
    function fnGetDetailsOfJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var objFolder = new Object;
        
        objFolder = objShell.NameSpace("C:\\WINDOWS");
        if (objFolder != null)
        {
            var objFolderItem = new Object;

            objFolderItem = objFolder.ParseName("clock.avi");
            if (objFolderItem != null)
            {
                var objInfo = new Object;

                objInfo = objFolder.GetDetailsOf(objFolderItem, 2);
            }
        }
    }
</script>

Vbscript:

<script language="VBScript">
    function fnGetDetailsOfVB()
        dim objShell
        dim objFolder
        
        set objShell = CreateObject("shell.application")
        set objFolder = objShell.NameSpace("C:\WINDOWS")

        if (not objFolder is nothing) then
            dim objFolderItem

            set objFolderItem = objFolder.ParseName("clock.avi")

            if (not objFolderItem Is Nothing) then
                dim objInfo
                        
                objInfo = objFolder.GetDetailsOf(objFolderItem, 2)
            end if
            
            set objFolderItem = nothing
        end if
        
        set objFolder = nothing
        set objShell = nothing
    end function
</script>

Visual Basic :

Private Sub btnGetDetailsOf_Click()
    Dim objShell  As Shell
    Dim objFolder As Folder

    Set objShell = New Shell
    Set objFolder = objShell.NameSpace("C:\WINDOWS")
    
    If (Not objFolder Is Nothing) Then
        Dim objFolderItem As FolderItem
        Set objFolderItem = objFolder.ParseName("clock.avi")
   
        If (Not objFolderItem Is Nothing) Then
            Dim szItem As String
            szItem = objFolder.GetDetailsOf(objFolderItem, 2)
        End If
        
        Set objFolderItem = Nothing
    End If
    
    Set objFolder = Nothing
    Set objShell = Nothing
End Sub

Spécifications

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

Partager via