CW&nd::DlgDirListnbsp;

intDlgDirList (nIDStaticPath,LPTSTRlpPathSpec,intnIDListBox,intUINTnFileType);

Valor devuelto

Distinto de cero si la función es correcta; caso contrario 0.

Parámetros

lpPathSpec

Puntos a una cadena terminada en nulo que contiene la ruta de acceso o nombre de archivo. DlgDirList modifica esta cadena, que debe ser lo suficientemente largos para contener las modificaciones. Para obtener más información, consulte la siguiente sección de "Observaciones".

nIDListBox

Especifica el identificador de un cuadro de lista. Si nIDListBox es 0, DlgDirList se supone que ningún cuadro de lista existe y no intentar llenar uno.

nIDStaticPath

Especifica el identificador del control de texto estático utilizado para mostrar la unidad y el directorio. Si nIDStaticPath es 0, DlgDirList supone que dicho control de texto no está presente.

nFileType

Especifica los atributos de los archivos que se mostrarán. Puede ser cualquier combinación de los siguientes valores:

• DDL_READWRITE   Archivos de datos de lectura y escritura sin atributos adicionales.
  
  
• DDL_READO&NLYnbsp;  Archivos de sólo lectura.
  
  
• DDL_HIDDE&Nnbsp;  Archivos ocultos.
  
  
• DDL_SYSTEM   Archivos de sistema.
  
  
• DDL_DIRECTORY   Directorios.
  
  
• DDL_ARCHIVE   Archivos.
  
  
• DDL_POSTMSGS   Bandera LB_DIR . Si se establece el indicador LB_DIR , Windows coloca los mensajes generados por DlgDirList en la cola de la aplicación; de lo contrario, se envían directamente al procedimiento de cuadro de diálogo.
  
  
• DDL_DRIVES   Unidades. Si se establece el indicador DDL_DRIVES , la bandera DDL_EXCLUSIVE se establece automáticamente. Por lo tanto, para crear una lista de directorios que incluye unidades y archivos, se debe llamar DlgDirList dos veces: una vez con el DDL_DRIVES pabellón conjunto y una vez con las banderas para el resto de la lista.
  
  
• DDL_EXCLUSIVE   Bits exclusiva. Si está establecido el bit exclusivo, aparecen sólo los archivos del tipo especificado; de lo contrario se enumeran los archivos normales y los archivos del tipo especificado.

Observaciones

Llena un cuadro de lista con un listado de archivo o directorio. Envía DlgDirList LB_RESETCONTENT y LB_DIR mensajes al cuadro de lista. Rellena el cuadro de lista especificado por nIDListBox con los nombres de todos los archivos que coincidan con la ruta de acceso dada por lpPathSpec.

El parámetro lpPathSpec tiene el siguiente formulario:

[unidad:] [[\u]directorio[\idirectorio]... \u] [nombre de archivo]

En este ejemplo, unidad es una letra de unidad, directorio es un nombre de directorio válido y nombre de archivo es un nombre de archivo válido debe contener al menos un comodín. Los comodines son un signo de interrogación (?), que significa coincide con cualquier carácter y un asterisco (**), lo que significa que coincide con cualquier número de caracteres.

Si se especifica una cadena de longitud 0 para lpPathSpec, o si especifica sólo un nombre de directorio pero no incluyen cualquier especificación de archivo, la cadena se cambiará a "*. *".

Si lpPathSpec incluye un nombre de unidad o directorio, la unidad y el directorio se cambian a la unidad designada y el directorio antes de que se rellena el cuadro de lista. El control de texto identificado por nIDStaticPath también se actualiza con la nueva unidad o el nombre del directorio.

Después se rellena el cuadro de lista, lpPathSpec se actualiza mediante la eliminación de la unidad o directorio de parte de la ruta.

Visión General de CWnd |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CWnd::DlgDirListComboBox, :: DlgDirList