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

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

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

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) para 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 que se devuelva 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_DROPDOWN y CBS_DROPDOWNLIST).

Advertencia de seguridad: El 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: Controles de Microsoft Windows antes de continuar.

Windows 95 o posterior: DlgDirSelectComboBoxExW es compatible con Microsoft Layer para Unicode (MSLU). Para usarlo, debe agregar determinados archivos a la aplicación, como se describe en Microsoft Layer para 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll

Consulte también

CB_GETCURSEL

CB_GETLBTEXT

DlgDirListComboBox

Referencia