CFileDialog::CFileDialog

CFileDialog ( BOOL bOpenFileDialog, LPCTSTR lpszDefExt = NULL, LPCTSTR lpszFileName = NULL, DWORD dwFlags = OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT, LPCTSTR lpszFilter = Nulo, CWnd * pParentWnd = Nulo );

Parámetros

bOpenFileDialog

Se establece en TRUE para construir un cuadro de diálogo Abrir archivo o falsa para construir un cuadro de diálogo Guardar archivo como.

lpszDefExt

La extensión de nombre de archivo predeterminado. Si el usuario no incluye una extensión en el cuadro Nombre de archivo, la extensión especificada por lpszDefExt se agrega automáticamente al nombre del archivo. Si este parámetro es NULL, no se anexa ninguna extensión de archivo.

lpszFileName

Cuadro editar el nombre del archivo inicial que aparece en el nombre del archivo. Si aparece inicialmente nula, ningún nombre de archivo.

dwFlags

Una combinación de uno o más indicadores que permiten personalizar el cuadro de diálogo. Encontrará una descripción de estos indicadores, la OPENFILENAME estructura en la documentación del SDK de Win32. Si modifica el m_ofn de .Banderas miembros de la estructura, utilice un operador OR bit a bit en los cambios para mantener intacto el comportamiento predeterminado.

lpszFilter

Una serie de pares de cadena que especifica los filtros se puede aplicar al archivo. Si se especifican filtros de archivo, sólo los archivos seleccionados aparecerán en el cuadro de lista de archivos. Vea la sección Comentarios para obtener más información sobre cómo trabajar con filtros de archivo.

pParentWnd

Un puntero a la ventana de principal o propietario del objeto de cuadro de diálogo de archivo.

Observaciones

Llamada objeto de cuadro de diálogo de archivo de esta función para construir un estándar de Windows. Cuadro de diálogo Abrir archivo o guardar archivo como se construye, en función del valor de bOpenFileDialog.

Para permitir al usuario seleccionar varios archivos, establecer el indicador OFN_ALLOWMULTISELECT antes de llamar a DoModal. Es necesario proporcionar su propio búfer de nombre de archivo para dar cabida a la lista de nombres de archivos múltiples. Para ello, reemplazando a m_ofn.lpstrFile con un puntero a un búfer que se ha asignado, después de construir el CFileDialog, pero antes de llamar a DoModal. Además, debe establecer m_ofn.nMaxFile con el número de caracteres en el buffer apuntado por m_ofn.lpstrFile.

Para permitir al usuario cambiar el tamaño de un cuadro de diálogo de estilo explorador mediante el ratón o el teclado, establecer el indicador OFN_ENABLESIZING . Establecer este indicador es necesario sólo si se proporciona un procedimiento de gancho o una plantilla personalizada. La bandera sólo funciona con un cuadro de diálogo estilo de Explorer; cuadros de diálogo de estilo antiguo no permiten cambiar el tamaño.

El parámetro lpszFilter se utiliza para determinar el tipo de nombre de archivo que debe tener un archivo que se mostrará en el cuadro de lista de archivos. La primera cadena en el par de cadena describe el filtro; la segunda cadena indica la extensión del archivo a utilizar. Varias extensiones pueden especificarse mediante ';' como delimitador. La cadena termina con dos ' |' caracteres, seguidos de un carácter NULL . También se puede utilizar un objeto CString para este parámetro.

Por ejemplo, Microsoft Excel permite a los usuarios abrir los archivos con extensiones.XLC (gráfico) o.XLS (hoja de cálculo), entre otros. El filtro de Excel puede escribirse como:

static char BASED_CODE szFilter [] = "archivos de gráfico (*.xlc) | *. xlc|Archivos de hoja de cálculo (*.xls) | *. xls|Archivos de datos (*.xlc; *.xls) | * .xlc; *. xls|Todos los archivos (*. *) | *. * || " 

Visió&n General de CFileDialog |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CFileDialog::DoModal, :: GetOpenFileName, :: GetSaveFileName, OPENFILENAME

Index