Compartir vía


mensaje de CB_DIR

Agrega nombres a la lista mostrada por el cuadro combinado. El mensaje agrega los nombres de directorios y archivos que coinciden con una cadena especificada y un conjunto de atributos de archivo. CB_DIR también puede agregar letras de unidad asignadas a la lista.

Parámetros

wParam

Atributos de los archivos o directorios que se van a agregar al cuadro combinado. Este parámetro puede ser uno o más de los siguientes valores.

Value Significado
DDL_ARCHIVE
Incluye archivos archivados.
DDL_DIRECTORY
Incluye subdirectorios, que se incluyen entre corchetes ([ ]).
DDL_DRIVES
Todas las unidades asignadas se agregan a la lista. Las unidades se muestran con el formato [-x-], donde x es la letra de unidad.
DDL_EXCLUSIVE
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.
DDL_HIDDEN
Incluye archivos ocultos.
DDL_READONLY
Incluye archivos de solo lectura.
DDL_READWRITE
Incluye archivos de lectura y escritura sin atributos adicionales. Este es el valor predeterminado.
DDL_SYSTEM
Incluye archivos del sistema.

lParam

Puntero LPCTSTR a 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, \\machinename\sharename). Si la cadena especifica un nombre de archivo o directorio que tiene los atributos especificados por el parámetro wParam , el nombre de archivo o directorio se agrega a la lista. Si el nombre de archivo o el nombre del directorio contiene caracteres comodín (? o *), todos los archivos o directorios que coinciden con la expresión de carácter comodín y tienen los atributos especificados por el parámetro wParam se agregan a la lista que se muestra en el cuadro combinado.

Valor devuelto

Si el mensaje se realiza correctamente, el valor devuelto es el índice de base cero del apellido agregado a la lista.

Si se produce un error, el valor devuelto es CB_ERR. Si no hay espacio suficiente para almacenar las nuevas cadenas, se CB_ERRSPACE el valor devuelto.

Comentarios

Si wParam incluye la marca DDL_DIRECTORY y lParam especifica todos los subdirectorios de un directorio de primer nivel, como C:\TEMP\*, el cuadro de lista 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.

La lista muestra nombres de archivo largos, si los hay.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Winuser.h (incluye Windows.h)

Consulte también

Referencia

CB_ADDSTRING

CB_INSERTSTRING

DlgDirListComboBox