CW&nd::DlgDirListComboBoxnbsp;

intDlgDirListComboBox (LPTSTRlpPathSpec,intnIDComboBox,intUINTnIDStaticPath,nFileType);

Valeur de retour

Spécifie le résultat de la fonction. Il est différent de zéro si une liste a été faite, même une liste vide. Une valeur de retour 0 implique que la chaîne d'entrée ne contenait pas un chemin de recherche valide.

Paramètres

lpPathSpec

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

nIDComboBox

Spécifie l'identificateur d'une liste déroulante dans une boîte de dialogue. Si nIDComboBox est 0, DlgDirListComboBox suppose qu'aucune liste déroulante existe et qu'il ne cherche pas à combler l'une.

nIDStaticPath

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

nFileType

Spécifie les attributs de fichier DOS 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 CB_DIR . Si l'indicateur CB_DIR est défini, Windows place les messages générés par DlgDirListComboBox 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 DlgDirListComboBox 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 la zone de liste d'une zone de liste déroulante avec une liste de fichier ou un répertoire. Envoie DlgDirListComboBox CB_RESETCONTENT et CB_DIR les messages de la liste déroulante. Remplit la zone de liste de la zone de liste modifiable spécifiée par nIDComboBox 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 (**), qui signifie correspondre à un nombre quelconque de caractères.

Si vous spécifiez une chaîne de longueur zéro 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 zone de liste modifiable 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::DlgDirList, CWnd::DlgDirSelect, :: DlgDirListComboBox