winuser.h


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.