Función DlgDirSelectExA (winuser.h)

Recupera la selección actual de un cuadro de lista de selección única. Se supone que el cuadro de lista se ha rellenado por la función DlgDirList 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 de

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 de

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.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll

Consulte también

dlgDirList de

dlgDirListComboBox de

DlgDirSelectComboBoxEx

LB_GETCURSEL

LB_GETTEXT

de referencia de