DlgDirSelectEx
La función DlgDirSelectEx recupera la selección actual desde un list box de selección sencilla. Asume que el list box ha sido llenado por la función DlgDirList y que la selección es una letra de unidad de almacenamiento, un nombre de fichero o de directorio.
Sintaxis
BOOL DlgDirSelectEx( HWND hDlg, // manipulador de cuadro de diálogo con list box LPTSTR lpString, // puntero a buffer para cadena de camino int nCount, // número de caracteres en la cadena de camino int nIDListBox // identificador de list box );
Parámetros
hDlg: identifica el cuadro de diálogo que contiene el list box.
lpString: apunta a un buffer que recibirá el camino seleccionado.
nCount: especifica la longitud, en caracteres, del buffer apuntado por lpString.
nIDListBox: especifica el identificador entero de un list box en el cuadro de diálogo.
Valor de retorno
Si la selección actual es un nombre de directorio, el valor de retorno es distinto de cero.
Si la selección actual no es un nombre de directorio, el valor de retorno es cero. Para obtener información sobre un error, llamar a GetLastError.
Observaciones
la función DlgDirSelectEx copia la selección al buffer apuntado por el parámetro lpString. Si la selección actual es un nombre de directorio o una letra de dispositivo de almacenamiento, DlgDirSelectEx elimina los corchetes delimitadores (y los guiones, para letras de dispositivo), de modo que el nombre o la letra estén preparados para ser insertados en un nuevo camino. Si no hay selección, lpString no cambia.
DlgDirSelectEx envía mensajes LB_GETCURSEL y LB_GETTEXT al list box. La función no permite que se retorne más de un nombre de fichero desde el list box. El list box no debe ser de selección múltiple. Si lo es, esta función no devuelve un valor nulo y lpString permanece sin cambios.