Interfaz IFileDialogCustomize (shobjidl_core.h)

Expone métodos que permiten a una aplicación agregar controles a un cuadro de diálogo de archivo común.

Herencia

La interfaz IFileDialogCustomize hereda de la interfaz IUnknown . IFileDialogCustomize también tiene estos tipos de miembros:

Métodos

La interfaz IFileDialogCustomize tiene estos métodos.

IFileDialogCustomize::AddCheckButton Agrega un botón de verificación (casilla) al cuadro de diálogo.
IFileDialogCustomize::AddComboBox Agrega un cuadro combinado al cuadro de diálogo.
IFileDialogCustomize::AddControlItem Agrega un elemento a un control contenedor en el cuadro de diálogo.
IFileDialogCustomize::AddEditBox Agrega un control de cuadro de edición al cuadro de diálogo.
IFileDialogCustomize::AddMenu Agrega un menú al cuadro de diálogo.
IFileDialogCustomize::AddPushButton Agrega un botón al cuadro de diálogo.
IFileDialogCustomize::AddRadioButtonList Agrega un grupo de botones de opción (también conocido como botón de radio) al cuadro de diálogo.
IFileDialogCustomize::AddSeparator Agrega un separador al cuadro de diálogo, lo que permite una separación visual de los controles.
IFileDialogCustomize::AddText Agrega contenido de texto al cuadro de diálogo.
IFileDialogCustomize::EnableOpenDropDown Habilita una lista desplegable en el botón Abrir o Guardar del cuadro de diálogo.
IFileDialogCustomize::EndVisualGroup Detiene la adición de elementos a un grupo de objetos visuales del cuadro de diálogo.
IFileDialogCustomize::GetCheckButtonState Obtiene el estado actual de un botón de comprobación (casilla) del cuadro de diálogo.
IFileDialogCustomize::GetControlItemState Obtiene el estado actual de un elemento de un control contenedor que se encuentra en el cuadro de diálogo.
IFileDialogCustomize::GetControlState Obtiene la visibilidad actual y los estados habilitados de un control determinado.
IFileDialogCustomize::GetEditBoxText Obtiene el texto actual de un control de cuadro de edición.
IFileDialogCustomize::GetSelectedControlItem Obtiene un elemento determinado a partir de los controles de contenedor especificados en el cuadro de diálogo.
IFileDialogCustomize::MakeProminent Coloca un control en el cuadro de diálogo para que se muestre destacado en comparación con otros controles agregados.
IFileDialogCustomize::RemoveAllControlItems Sin implementar. (IFileDialogCustomize.RemoveAllControlItems)
IFileDialogCustomize::RemoveControlItem Quita un elemento de un control contenedor del cuadro de diálogo.
IFileDialogCustomize::SetCheckButtonState Establece el estado de un botón de verificación (casilla) en el cuadro de diálogo.
IFileDialogCustomize::SetControlItemState Establece el estado actual de un elemento de un control contenedor que se encuentra en el cuadro de diálogo.
IFileDialogCustomize::SetControlItemText Establece el texto de un elemento de control. Por ejemplo, el texto que acompaña a un botón de radio o a un elemento de un menú.
IFileDialogCustomize::SetControlLabel Establece el texto asociado a un control, como el texto de un botón o una etiqueta de cuadro de edición.
IFileDialogCustomize::SetControlState Establece la visibilidad actual y los estados habilitados de un control determinado.
IFileDialogCustomize::SetEditBoxText Establece el texto de un control de cuadro de edición que se encuentra en el cuadro de diálogo.
IFileDialogCustomize::SetSelectedControlItem Establece el estado seleccionado de un elemento determinado de un grupo de botones de opción o un cuadro combinado que se encuentran en el cuadro de diálogo.
IFileDialogCustomize::StartVisualGroup Declara un grupo de objetos visuales en el cuadro de diálogo. Las llamadas posteriores a cualquier método "add" agregan esos elementos a este grupo.

Comentarios

Cuándo implementar

IFileDialogControlEvents se implementa mediante el cuadro de diálogo de apertura de archivo común (CLSID_FileOpenDialog) y el cuadro de diálogo de guardado de archivos (CLSID_FileSaveDialog).

Los controles se agregan al cuadro de diálogo antes de que se muestre el diálogo. Su diseño está implícito en el orden en que se agregan. Una vez que se muestra el cuadro de diálogo, los controles no se pueden agregar o quitar, pero los controles existentes se pueden ocultar o deshabilitar en cualquier momento. Sus etiquetas también se pueden cambiar en cualquier momento.

Los controles de contenedor son controles que pueden tener elementos agregados a ellos. Los controles de contenedor incluyen cuadros combinados, menús, la lista desplegable adjunta al botón Abrir y los grupos de botones de opción. El orden en que aparecen los elementos en un contenedor es el orden en que se agregaron. No hay ningún recurso para reordenarlos. Los identificadores se limitan al control primario. Los controles de contenedor, a excepción de los menús, tienen un elemento seleccionado.

Los elementos con un control de contenedor no se pueden cambiar una vez creados, excepto los estados habilitados y visibles. Sin embargo, se pueden agregar y quitar en cualquier momento. Por ejemplo, si necesita cambiar el texto de un menú, tendría que quitar el menú actual y agregar otro con el texto correcto.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)