Función DlgDirSelectComboBoxExA (winuser.h)

Recupera la selección actual de un cuadro combinado rellenado mediante la función dlgDirListComboBox . La selección se interpreta como una letra de unidad, un archivo o un nombre de directorio.

Sintaxis

BOOL DlgDirSelectComboBoxExA(
  [in]  HWND  hwndDlg,
  [out] LPSTR lpString,
  [in]  int   cchOut,
  [in]  int   idComboBox
);

Parámetros

[in] hwndDlg

Tipo: HWND

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

[out] lpString

Tipo: LPTSTR de

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

[in] cchOut

Tipo: int

Longitud, en caracteres, del búfer al que apunta el parámetro lpString.

[in] idComboBox

Tipo: int

Identificador entero del control de cuadro combinado 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

Si la selección actual especifica un nombre de directorio o una letra de unidad, la función DlgDirSelectComboBoxEx quita los corchetes envolventes (y guiones para letras de unidad), por lo que el nombre o la letra están listos para insertarse en una nueva ruta de acceso o nombre de archivo. Si no hay ninguna selección, el contenido del búfer al que apunta lpString no cambia.

La función DlgDirSelectComboBoxEx no permite devolver más de un nombre de archivo desde un cuadro combinado.

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

dlgDirSelectComboBoxEx envía CB_GETCURSEL y CB_GETLBTEXT mensajes al cuadro combinado.

Puede usar esta función con los tres tipos de cuadros combinados (CBS_SIMPLE, CBS_DROPDOWNy CBS_DROPDOWNLIST).

advertencia de seguridad: uso incorrecto de esta función puede causar problemas para la aplicación. Por ejemplo, el parámetro nCount debe establecerse correctamente para las versiones ANSI y Unicode. Si no lo hace, podría provocar un desbordamiento del búfer. Debe revisar Consideraciones de seguridad: Microsoft Windows Controls antes de continuar.

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

Nota

El encabezado winuser.h define DlgDirSelectComboBoxEx 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

CB_GETCURSEL

CB_GETLBTEXT

dlgDirListComboBox de

de referencia de