Interfaz IActionProgress (shobjidl_core.h)

  • Artículo

Representa la clase base abstracta de la que pueden heredar las operaciones controladas por progreso.

Herencia

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

Métodos

La interfaz IActionProgress tiene estos métodos.

 
IActionProgress::Begin

Se llama cuando se inicia una acción que requiere que se muestre su progreso al usuario.
IActionProgress::End

Indica que la acción asociada a esta implementación de progreso ha finalizado.
IActionProgress::QueryCancel

Proporciona información sobre si la acción se está cancelando.
IActionProgress::ResetCancel

Restablece el cuadro de diálogo de progreso una vez completada una cancelación.
IActionProgress::UpdateProgress

Novedades el progreso de una acción en la interfaz de usuario.
IActionProgress::UpdateText

Se llama si se cambiará el texto descriptivo asociado a la acción.

Comentarios

Esta clase es una clase abstracta que puede no crear instancias. Proporciona un marco que las clases derivadas pueden usar para implementar una devolución de llamada de progreso. Las aplicaciones pueden usar esta devolución de llamada para notificar el progreso de las acciones a la interfaz de usuario. En este caso, "Acciones" hace referencia a las operaciones que pueden tardar un período de tiempo significativo, como descargar o copiar archivos, y durante las cuales una indicación de progreso visible sería adecuada.

Normalmente, las aplicaciones no implementan esta interfaz. Gran parte de la funcionalidad con la que interactúan los usuarios durante las acciones se proporciona mediante la clase CProgressDialog (CLSID_ProgressDialog) que implementa IActionProgress y muestra el progreso en un cuadro de diálogo. Si se requiere una solución que requiera un mecanismo distinto de un cuadro de diálogo, se puede usar IActionProgress para proporcionar funcionalidad básica del indicador de progreso.

Una vez implementadas, las clases deben llamar a IActionProgress::Begin cuando se inicia una acción. Periódicamente, se debe llamar a IActionProgress::UpdateProgress para actualizar la interfaz de usuario con información de progreso y se debe transmitir información textual detallada a la interfaz de usuario llamando a IActionProgress::UpdateText. Se debe llamar a IActionProgress::QueryCancel e IActionProgress::ResetCancel para controlar las solicitudes de cancelación. Una vez finalizada la operación, se debe llamar a IActionProgress::End .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)

Consulte también

IProgressDialog