winuser.h


DlgDirListComboBox

La función DlgDirListComboBox llena el combo box especificado con los nombres de todos los ficheros, unidades o directorios que se ajusten a los atributos y caminos especificados.

Sintaxis

int DlgDirListComboBox(
    HWND hDlg,          // manipulador de cuadro de diálogo con combo box
    LPTSTR lpPathSpec,  // puntero a cadena de camino o nombre de fichero
    int nIDComboBox,     // identificador de combo box
    int nIDStaticPath,  // identificador de control estático
    UINT uFileType      // atributos de fichero a mostrar
   );

Parámetros

hDlg: identifica el cuadro de diálogo que contiene el combo box.

lpPathSpec: apunta a una cadena terminada en cero con el formato siguiente:

[drive:][\]][directory\[...]][filename]

Si la cadena especifica incluye una unidad de disco o un camino de directorio, la función DlgDirListComboBox cambia la unidad y el directorio actual antes de llenar la lista, la unidad y el camino del directorio se eliminan de la cadena especificada por el parámetro lpPathSpec.

nIDComboBox: especifica el identificador de un control combo box en un cuadro de diálogo. Si este parámetro es cero, DlgDirListComboBox asume que no existe combo box y no intenta llenarlo.

nIDStaticPath: especifica el identificador del control estático usado para mostrar el disco y directorio actuales. Si este parámetro es cero, DlgDirListComboBox asume que no existe tal control.

uFileType: especifica los atributos de los ficheros a mostrar. Este parámetro puede ser cualquier combinación de los siguientes valores:

Valor Descripción
DDL_ARCHIVE Incluye los ficheros con bit de archivo.
DDL_DIRECTORY Incluye subdirectorios. Los nombres de subdirectorio se muestran entre corchetes ([ ]).
DDL_DRIVES Incluye unidades. Las unidades de almacenamiento se listan en el formato [-x-], donde x es la letra de la unidad.
DDL_EXCLUSIVE Incluye sólo ficheros con los atributos especificados. Por defecto, se muestran los ficheros de lectura-escritura aunque no se especifique el valor DDL_READWRITE.
DDL_HIDDEN Incluye ficheros ocultos.
DDL_READONLY Incluye ficheros de sólo lectura.
DDL_READWRITE Incluye ficheros de lectura-escritura sin atributos adicionales.
DDL_SYSTEM Incluye ficheros de sistema.
DDL_POSTMSGS Envía los mensajes lentos (post) a la cola de mensajes de la aplicación. Por defecto, DlgDirListComboBox envía los mensajes directamente al procedimiento de diálogo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Por ejemplo, sila cadena de entrada no contiene un camino de búsqueda válido, la función falla. Para obtener información adicional sobre el error llamar a la función GetLastError.

Observaciones

Si se especifica una cadena de longitud cero para el parámetro lpPathSpec o si se especifica sólo un nombre de directorio, una unidad, o ambos, pero sin nombre de fichero, se asume la cadena *.* para el nombre de fichero.

Windows NT: el listado de directorios muestra nombres de ficheros largos, si hay alguno.

Windows 95: el listado de directorios muestra nombres de ficheros cortos, (en el formato 8.3). Se pueden usar las funciones SHGetFileInfo o GetFullPathName para obtener el nombre largo correspondiente.