Función DlgDirListComboBoxA (winuser.h)
Reemplaza el contenido de un cuadro combinado por los nombres de los subdirectorios y los archivos de un directorio especificado. Puede filtrar la lista de nombres especificando un conjunto de atributos de archivo. La lista de nombres puede incluir letras de unidad asignadas.
Sintaxis
int DlgDirListComboBoxA(
[in] HWND hDlg,
[in, out] LPSTR lpPathSpec,
[in] int nIDComboBox,
[in] int nIDStaticPath,
[in] UINT uFiletype
);
Parámetros
[in] hDlg
Tipo: HWND
Identificador del cuadro de diálogo que contiene el cuadro combinado.
[in, out] lpPathSpec
Tipo: LPTSTR
Puntero a un búfer que contiene una cadena terminada en null que especifica una ruta de acceso absoluta, una ruta de acceso relativa o un nombre de archivo. Una ruta de acceso absoluta puede comenzar con una letra de unidad (por ejemplo, d:) o un nombre UNC (por ejemplo, \\nombreDeEquipo \sharename).
La función divide la cadena en un directorio y un nombre de archivo. La función busca nombres en el directorio que coinciden con el nombre de archivo. Si la cadena no especifica un directorio, la función busca en el directorio actual.
Si la cadena incluye un nombre de archivo, el nombre de archivo debe contener al menos un carácter comodín (? o ). Si la cadena no incluye un nombre de archivo, la función se comporta como si hubiera especificado el carácter comodín asterisco () como nombre de archivo. Todos los nombres del directorio especificado que coinciden con el nombre de archivo y que tienen los atributos especificados por el parámetro uFiletype se agregan a la lista que se muestra en el cuadro combinado.
[in] nIDComboBox
Tipo: int
Identificador de un cuadro combinado en el cuadro de diálogo hDlg . Si este parámetro es cero, DlgDirListComboBox no intenta rellenar un cuadro combinado.
[in] nIDStaticPath
Tipo: int
Identificador de un control estático en el cuadro de diálogo hDlg . DlgDirListComboBox establece el texto de este control para mostrar la unidad y el directorio actuales. Este parámetro puede ser cero si no desea mostrar la unidad y el directorio actuales.
[in] uFiletype
Tipo: UINT
Conjunto de marcas de bits que especifican los atributos de los archivos o directorios que se van a agregar al cuadro combinado. Este parámetro puede ser una combinación de los valores siguientes.
| Value | Significado |
|---|---|
|
Incluye archivos archivados. |
|
Incluye subdirectorios, que se incluyen entre corchetes ([ ]). |
|
Todas las unidades asignadas se agregan a la lista. Las unidades se muestran con el formato [-x-], donde x es la letra de unidad. |
|
Solo incluye archivos con los atributos especificados. De forma predeterminada, los archivos de lectura y escritura se muestran incluso si no se especifica DDL_READWRITE. |
|
Incluye archivos ocultos. |
|
Incluye archivos de solo lectura. |
|
Incluye archivos de lectura y escritura sin atributos adicionales. Esta es la configuración predeterminada. |
|
Incluye archivos del sistema. |
|
Si se establece esta marca, DlgDirListComboBox usa la función PostMessage para enviar mensajes al cuadro combinado. Si no se establece esta marca, DlgDirListComboBox usa la función SendMessage . |
Valor devuelto
Tipo: int
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Por ejemplo, si la cadena especificada por lpPathSpec no es una ruta de acceso válida, se produce un error en la función. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Si lpPathSpec especifica un directorio, DlgDirListComboBox cambia el directorio actual al directorio especificado antes de rellenar el cuadro combinado. El texto del control estático identificado por el parámetro nIDStaticPath se establece en el nombre del nuevo directorio actual.
DlgDirListComboBox envía el CB_RESETCONTENT y CB_DIR mensajes al cuadro combinado.
Microsoft Windows NT 4.0 y versiones posteriores: si uFiletype incluye la marca DDL_DIRECTORY y lpPathSpec especifica un directorio de primer nivel, como C:\TEMP, el cuadro combinado siempre incluirá una entrada ".." para el directorio raíz. Esto es true incluso si el directorio raíz tiene atributos ocultos o del sistema y las marcas de DDL_HIDDEN y DDL_SYSTEM no se especifican. El directorio raíz de un volumen NTFS tiene atributos ocultos y del sistema.
Advertencia de seguridad: El uso incorrecto de esta función podría poner en peligro la seguridad del programa. El uso incorrecto de esta función incluye tener lpPathSpec indica un búfer que no se puede escribir o un búfer sin terminación NULL. Debe revisar las consideraciones de seguridad: controles de Microsoft Windows antes de continuar.
Microsoft Windows NT 4.0 y versiones posteriores: en la lista se muestran nombres de archivo largos, si los hay.
Windows 95 o posterior: la lista muestra nombres de archivo cortos (el formulario 8.3). Puede usar las funciones SHGetFileInfo o GetFullPathName para obtener el nombre de archivo largo correspondiente.
Windows 95 o posterior: DlgDirListComboBoxW es compatible con Microsoft Layer para Unicode. Para usarlo, debe agregar determinados archivos a la aplicación, como se describe en Microsoft Layer para Unicode en Windows Me/98/95 Systems.
Nota
El encabezado winuser.h define DlgDirListComboBox como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluya Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
Consulte también
Referencia