CW&nd::DlgDirListnbsp;

intDlgDirList (LPTSTRlpPathSpec,intnIDListBox,intUINTnIDStaticPath,nFileType);

Valeur de retour

Différent de zéro si la fonction est réussie ; sinon 0.

Paramètres

lpPathSpec

Pointe vers une chaîne terminée par null qui contient le chemin d'accès ou le nom de fichier. DlgDirList modifie cette chaîne, qui doit être suffisamment long pour contenir les modifications. Pour plus d'informations, reportez-vous à la section « Remarques » ci-dessous.

nIDListBox

Spécifie l'identificateur d'une zone de liste. Si nIDListBox est 0, DlgDirList suppose qu'aucune zone de liste existe et qu'il ne cherche pas à combler un.

nIDStaticPath

Spécifie l'identificateur du contrôle texte statique utilisé pour afficher le lecteur et le répertoire. Si nIDStaticPath est 0, DlgDirList suppose que tel aucun contrôle de texte n'est présent.

nFileType

Spécifie les attributs des fichiers s'affiche. Il peut être n'importe quelle combinaison des valeurs suivantes:

• DDL_READWRITE  ;  Fichiers de données de lecture-écriture avec aucun des attributs supplémentaires.
  
  
• DDL_READO&NLYnbsp ;  Fichiers en lecture seule.
  
  
• DDL_HIDDE&Nnbsp ;  Fichiers cachés.
  
  
• DDL_SYSTEM  ;  Fichiers système.
  
  
• DDL_DIRECTORY  ;  Annuaires.
  
  
• DDL_ARCHIVE  ;  Archives.
  
  
• DDL_POSTMSGS  ;  Drapeau de la LB_DIR . Si l'indicateur LB_DIR est défini, Windows place les messages générés par DlgDirList dans la file d'attente de l'application ; sinon, elles sont envoyées directement à la procédure de la boîte de dialogue.
  
  
• DDL_DRIVES  ;  Lecteurs. Si l'indicateur DDL_DRIVES est défini, l'indicateur DDL_EXCLUSIVE est défini automatiquement. Par conséquent, pour créer une liste de répertoires qui comprend des disques et des fichiers, vous devez appeler DlgDirList deux fois : une fois avec le DDL_DRIVES drapeau ensemble et une fois avec les drapeaux pour le reste de la liste.
  
  
• DDL_EXCLUSIVE  ;  Bit exclusif. Si le bit exclusif est défini, uniquement les fichiers du type spécifié sont répertoriés ; sinon les fichiers normaux et les fichiers du type spécifié sont répertoriés.

Remarques

Remplit une zone de liste avec une liste de fichier ou un répertoire. Envoie DlgDirList LB_RESETCONTENT et LB_DIR messages dans la zone de liste. Remplit la zone de liste spécifiée par nIDListBox avec les noms de tous les fichiers qui correspondent à la voie donnée par lpPathSpec.

Le paramètre lpPathSpec a la forme suivante:

[lecteur:] [[\u]répertoire[\irépertoire]... \u] [NomFichier]

Dans cet exemple, drive est une lettre de lecteur, répertoire est un nom de répertoire valide et nom de fichier est un nom de fichier valide doit contenir au moins un caractère générique. Les caractères génériques sont un point d'interrogation (?), qui signifie correspondre à n'importe quel caractère et un astérisque (**), signifiant correspond à un nombre quelconque de caractères.

Si vous spécifiez une chaîne de longueur 0 pour lpPathSpec, ou si vous spécifiez uniquement un nom de répertoire, mais ne comprennent pas toute spécification de fichier, la chaîne sera remplacée par "*. * ».

Si lpPathSpec inclut un nom de répertoire ou de lecteur, le lecteur et le répertoire sont modifiées pour le lecteur désigné et le répertoire avant la zone de liste est remplie. Le contrôle de texte identifié par nIDStaticPath est également mis à jour avec le nouveau lecteur et le nom du répertoire.

Après que la zone de liste est remplie, lpPathSpec est mis à jour en supprimant la partie lecteur ou de répertoire du chemin d'accès.

Aperçu de CWnd |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CWnd::DlgDirListComboBox, :: DlgDirList