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
Referencia