Función DlgDirSelectExA (winuser.h)

Artículo
08/27/2023

Recupera la selección actual de un cuadro de lista de selección única. Se supone que la función DlgDirList ha rellenado el cuadro de lista y que la selección es una letra de unidad, un nombre de archivo o un nombre de directorio.

Sintaxis

BOOL DlgDirSelectExA(
  [in]  HWND  hwndDlg,
  [out] LPSTR lpString,
  [in]  int   chCount,
  [in]  int   idListBox
);

Parámetros

[in] hwndDlg

Tipo: HWND

Identificador del cuadro de diálogo que contiene el cuadro de lista.

[out] lpString

Tipo: LPTSTR

Puntero a un búfer que recibe la ruta de acceso seleccionada.

[in] chCount

Tipo: int

Longitud, en TCHAR, del búfer al que apunta lpString.

[in] idListBox

Tipo: int

Identificador de un cuadro de lista en el cuadro de diálogo.

Valor devuelto

Tipo: BOOL

Si la selección actual es un nombre de directorio, el valor devuelto es distinto de cero.

Si la selección actual no es un nombre de directorio, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función DlgDirSelectEx copia la selección en el búfer al que apunta el parámetro lpString . Si la selección actual es un nombre de directorio o una letra de unidad, DlgDirSelectEx quita los corchetes envolventes (y guiones, para letras de unidad), de modo que el nombre o la letra estén listos para insertarse en una nueva ruta de acceso. Si no hay ninguna selección, lpString no cambia.

Si la cadena es tan larga o más larga que el búfer, el búfer contendrá la cadena truncada con un carácter nulo de terminación.

DlgDirSelectEx envía mensajes LB_GETCURSEL y LB_GETTEXT al cuadro de lista. La función no permite devolver más de un nombre de archivo desde un cuadro de lista. El cuadro de lista no debe ser un cuadro de lista de selección múltiple. Si es así, esta función no devuelve un valor cero y lpString permanece sin cambios.

Windows 95 o posterior: DlgDirSelectExW es compatible con Microsoft Layer para Unicode. Para usarlo, debe agregar determinados archivos a la aplicación, como se describe en Microsoft Layer for Unicode en Windows Me/98/95 Systems.

Ejemplos

Para obtener un ejemplo, vea Crear una lista de directorios en un cuadro de lista de selección única.

Nota

El encabezado winuser.h define DlgDirSelectEx 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o 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 (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll