Función GetOpenFileNameA (commdlg.h)
[A partir de Windows Vista, los cuadros de diálogo comunes Abrir y guardar como común se han reemplazado por el cuadro de diálogo elemento común. Se recomienda usar Common Item Dialog API en lugar de estos cuadros de diálogo de la biblioteca de cuadros de diálogo comunes.
Crea un cuadro de diálogo Abrir que permite al usuario especificar la unidad, el directorio y el nombre de un archivo o un conjunto de archivos que se van a abrir.
Sintaxis
BOOL GetOpenFileNameA(
[in, out] LPOPENFILENAMEA unnamedParam1
);
Parámetros
[in, out] unnamedParam1
Tipo: LPOPENFILENAME
Puntero a una estructura OPENFILENAME que contiene información utilizada para inicializar el cuadro de diálogo. Cuando GetOpenFileName, esta estructura contiene información sobre la selección de archivos del usuario.
Valor devuelto
Tipo: BOOL de
Si el usuario especifica un nombre de archivo y hace clic en el botón Aceptar, el valor devuelto es distinto de cero. El búfer al que apunta el lpstrFile miembro del OPENFILENAME estructura contiene la ruta de acceso completa y el nombre de archivo especificados por el usuario.
Si el usuario cancela o cierra el cuadro de diálogo Abrir
Observaciones
El cuadro de diálogo Abrir estilo explorador proporciona características de interfaz de usuario similares al Explorador de Windows. Puede proporcionar un procedimiento de enlace de OFNHookProc para un cuadro de diálogo abrir estilo explorador. Para habilitar el procedimiento de enlace, establezca las marcas OFN_EXPLORER y OFN_ENABLEHOOK en el miembro Flags del miembro OPENFILENAME y especifique la dirección del procedimiento de enlace en el miembro lpfnHook.
Windows sigue admitiendo el cuadro de diálogo Abrir de estilo antiguo para las aplicaciones que quieran mantener una interfaz de usuario coherente con la interfaz de usuario de estilo anterior. Para mostrar el cuadro de diálogo Abrir estilo antiguo, habilite un procedimiento de enlace de OFNHookProcOldStyle y asegúrese de que la marca OFN_EXPLORER no esté establecida.
Para mostrar un cuadro de diálogo que permita al usuario seleccionar un directorio en lugar de un archivo, llame a la función SHBrowseForFolder.
Tenga en cuenta que, al seleccionar varios archivos, el límite total de caracteres de los nombres de archivo depende de la versión de la función.
- ANSI: límite de 32 k
- Unicode: sin restricción
Ejemplos
Para obtener un ejemplo, vea Abrir un archivo.
Nota
El encabezado commdlg.h define GetOpenFileName 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
commdlg.h (incluya Windows.h) |
| biblioteca de |
Comdlg32.lib |
| DLL de |
Comdlg32.dll |
| conjunto de API de |
ext-ms-win-shell-comdlg32-l1-1-1 (introducido en Windows 10, versión 10.0.14393) |
Consulte también
biblioteca de cuadros de diálogo común de
conceptual de
otros recursos
de referencia de