Estructura BROWSEINFOW (shlobj_core.h)
Contiene parámetros para la función SHBrowseForFolder y recibe información sobre la carpeta seleccionada por el usuario.
Sintaxis
typedef struct _browseinfoW {
HWND hwndOwner;
PCIDLIST_ABSOLUTE pidlRoot;
LPWSTR pszDisplayName;
LPCWSTR lpszTitle;
UINT ulFlags;
BFFCALLBACK lpfn;
LPARAM lParam;
int iImage;
} BROWSEINFOW, *PBROWSEINFOW, *LPBROWSEINFOW;
Miembros
hwndOwner
Tipo: HWND
Identificador de la ventana de propietario del cuadro de diálogo.
pidlRoot
Tipo: PCIDLIST_ABSOLUTE
PIDL que especifica la ubicación de la carpeta raíz desde la que se va a iniciar la exploración. Solo la carpeta especificada y sus subcarpetas en la jerarquía del espacio de nombres aparecen en el cuadro de diálogo. Este miembro puede ser NULL; en ese caso, se usa una ubicación predeterminada.
pszDisplayName
Tipo: LPTSTR
Puntero a un búfer para recibir el nombre para mostrar de la carpeta seleccionada por el usuario. Se supone que el tamaño de este búfer es MAX_PATH caracteres.
lpszTitle
Tipo: LPCTSTR
Puntero a una cadena terminada en null que se muestra encima del control de vista de árbol en el cuadro de diálogo. Esta cadena se puede usar para especificar instrucciones al usuario.
ulFlags
Tipo: UINT
Marcas que especifican las opciones del cuadro de diálogo. Este miembro puede ser 0 o una combinación de los valores siguientes. Los números de versión hacen referencia a la versión mínima de Shell32.dll necesaria para SHBrowseForFolder para reconocer las marcas agregadas en versiones posteriores. Consulte Versiones de shell y controles comunes para obtener más información.
BIF_RETURNONLYFSDIRS (0x00000001)
0x00000001. Solo devuelve directorios del sistema de archivos. Si el usuario selecciona carpetas que no forman parte del sistema de archivos, el botón Aceptar aparece atenuado.
BIF_DONTGOBELOWDOMAIN (0x00000002)
0x00000002. No incluya carpetas de red por debajo del nivel de dominio en el control de vista de árbol del cuadro de diálogo.
BIF_STATUSTEXT (0x00000004)
0x00000004. Incluya un área de estado en el cuadro de diálogo. La función de devolución de llamada puede establecer el texto de estado enviando mensajes al cuadro de diálogo. Esta marca no se admite cuando se especifica BIF_NEWDIALOGSTYLE.
BIF_RETURNFSANCESTORS (0x00000008)
0x00000008. Solo devuelve antecesores del sistema de archivos. Un antecesor es una subcarpeta que está debajo de la carpeta raíz de la jerarquía del espacio de nombres. Si el usuario selecciona un antecesor de la carpeta raíz que no forma parte del sistema de archivos, el botón Aceptar está atenuado.
BIF_EDITBOX (0x00000010)
0x00000010. Versión 4.71. Incluya un control de edición en el cuadro de diálogo Examinar que permita al usuario escribir el nombre de un elemento.
BIF_VALIDATE (0x00000020)
0x00000020. Versión 4.71. Si el usuario escribe un nombre no válido en el cuadro de edición, el cuadro de diálogo Examinar llama al BrowseCallbackProc de la aplicación con el mensaje BFFM_VALIDATEFAILED . Esta marca se omite si no se especifica BIF_EDITBOX.
BIF_NEWDIALOGSTYLE (0x00000040)
0x00000040. Versión 5.0. Use la nueva interfaz de usuario. Establecer esta marca proporciona al usuario un cuadro de diálogo mayor que se puede cambiar de tamaño. El cuadro de diálogo tiene varias funcionalidades nuevas, como la funcionalidad de arrastrar y colocar en el cuadro de diálogo, reordenar, menús contextuales, nuevas carpetas, eliminar y otros comandos de menú contextual.
BIF_BROWSEINCLUDEURLS (0x00000080)
0x00000080. Versión 5.0. El cuadro de diálogo Examinar puede mostrar direcciones URL. También se deben establecer las marcas BIF_USENEWUI y BIF_BROWSEINCLUDEFILES. Si no se establece alguna de estas tres marcas, el cuadro de diálogo del explorador rechaza las direcciones URL. Incluso cuando se establecen estas marcas, el cuadro de diálogo Examinar muestra direcciones URL solo si la carpeta que contiene el elemento seleccionado admite direcciones URL. Cuando se llama al método IShellFolder::GetAttributesOf de la carpeta para solicitar los atributos del elemento seleccionado, la carpeta debe establecer la marca de atributo SFGAO_FOLDER . De lo contrario, el cuadro de diálogo Examinar no mostrará la dirección URL.
BIF_USENEWUI
Versión 5.0. Use la nueva interfaz de usuario, incluido un cuadro de edición. Esta marca es equivalente a BIF_EDITBOX | BIF_NEWDIALOGSTYLE.
BIF_UAHINT (0x00000100)
0x00000100. Versión 6.0. Cuando se combina con BIF_NEWDIALOGSTYLE, agrega una sugerencia de uso al cuadro de diálogo, en lugar del cuadro de edición. BIF_EDITBOX invalida esta marca.
BIF_NONEWFOLDERBUTTON (0x00000200)
0x00000200. Versión 6.0. No incluya el botón Nueva carpeta en el cuadro de diálogo Examinar.
BIF_NOTRANSLATETARGETS (0x00000400)
0x00000400. Versión 6.0. Cuando el elemento seleccionado es un acceso directo, devuelve el PIDL del propio acceso directo en lugar de su destino.
BIF_BROWSEFORCOMPUTER (0x00001000)
0x00001000. Solo devuelve equipos. Si el usuario selecciona un elemento distinto a un equipo, el botón Aceptar se atenúa.
BIF_BROWSEFORPRINTER (0x00002000)
0x00002000. Permitir solo la selección de impresoras. Si el usuario selecciona un elemento distinto a una impresora, el botón Aceptar se atenúa.
En Windows XP y sistemas posteriores, el procedimiento recomendado es usar un cuadro de diálogo de estilo Windows XP, estableciendo la raíz del cuadro de diálogo en la carpeta Impresoras y faxes (CSIDL_PRINTERS).
BIF_BROWSEINCLUDEFILES (0x00004000)
0x00004000. Versión 4.71. El cuadro de diálogo Examinar muestra archivos y carpetas.
BIF_SHAREABLE (0x00008000)
0x00008000. Versión 5.0. El cuadro de diálogo Examinar puede mostrar recursos que se pueden compartir en sistemas remotos. Esto está pensado para aplicaciones que quieran exponer recursos compartidos remotos en un sistema local. También se debe establecer la marca BIF_NEWDIALOGSTYLE.
BIF_BROWSEFILEJUNCTIONS (0x00010000)
0x00010000. Windows 7 y versiones posteriores. Permitir que se examinen las uniones de carpetas, como una biblioteca o un archivo comprimido con una extensión de nombre de archivo .zip.
lpfn
Tipo: BFFCALLBACK
Puntero a una función definida por la aplicación a la que llama el cuadro de diálogo cuando se produce un evento. Para obtener más información, consulte la función BrowseCallbackProc . Este miembro puede ser NULL.
lParam
Tipo: LPARAM
Valor definido por la aplicación que el cuadro de diálogo pasa a la función de devolución de llamada, si se especifica uno en lpfn.
iImage
Tipo: int
Valor entero que recibe el índice de la imagen asociada a la carpeta seleccionada, almacenada en la lista de imágenes del sistema.
Comentarios
Nota
El encabezado shlobj_core.h define BROWSEINFO 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 Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP, Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | shlobj_core.h (incluya Shlobj.h, Shlobj_core.h) |