mensaje de LB_DIR

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

Parámetros

wParam

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

Value	Significado
DDL_ARCHIVE	Incluye archivos archivados.
DDL_DIRECTORY	Incluye subdirectorios. Los nombres de subdirectorio 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. Esta es la configuración predeterminada.
DDL_SYSTEM	Incluye archivos del sistema.

lParam

Puntero a la 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, \\ nombre_recursocompartido de nombre_\ equipo).

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 directorio contiene caracteres comodín (? o *), todos los archivos o directorios que coincidan con la expresión de caracteres comodín y tengan los atributos especificados por el parámetro wParam se agregan a la lista.

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 LB_ERR. Si no hay espacio suficiente para almacenar las nuevas cadenas, se LB_ERRSPACE el valor devuelto.

Observaciones

El LB_INITSTORAGE mensaje ayuda a acelerar la inicialización de cuadros de lista que tienen un gran número de elementos (más de 100). Reserva la cantidad de memoria especificada para que los mensajes de LB_DIR posteriores tarden el menor tiempo posible. Puede usar estimaciones para los parámetros wParam y lParam . Si se sobrestima, se asigna la memoria adicional; si subestima, la asignación normal se usa para los elementos que superan la cantidad solicitada.

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.

En la lista se muestran nombres de archivo largos, si los hay.

Para una aplicación ANSI, el sistema convierte el texto de un cuadro de lista en Unicode mediante CP_ACP. Esto puede causar problemas. Por ejemplo, los caracteres romanos acentuados en un cuadro de lista no Unicode en Windows japonés aparecerán desagrados. Para corregirlo, compile la aplicación como Unicode o use un cuadro de lista dibujado por el propietario.

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)

Vea también

DlgDirList