Interface IActionProgress (shobjidl_core.h)

Representa a classe base abstrata da qual as operações orientadas por progresso podem herdar.

Herança

A interface IActionProgress herda da interface IUnknown . IActionProgress também tem estes tipos de membros:

Métodos

A interface IActionProgress tem esses métodos.

IActionProgress::Begin Chamado quando uma ação é iniciada que exige que seu progresso seja exibido para o usuário.
IActionProgress::End Indica que a ação associada a essa implementação de progresso terminou.
IActionProgress::QueryCancel Fornece informações sobre se a ação está sendo cancelada.
IActionProgress::ResetCancel Redefine a caixa de diálogo de progresso após a conclusão de um cancelamento.
IActionProgress::UpdateProgress Atualizações o progresso de uma ação para a interface do usuário.
IActionProgress::UpdateText Chamado se o texto descritivo associado à ação for alterado.

Comentários

Essa classe é uma classe abstrata que pode não ser instanciada. Ele fornece uma estrutura que as classes derivadas podem usar para implementar um retorno de chamada de progresso. Esse retorno de chamada pode ser usado por aplicativos para relatar o progresso das ações para a interface do usuário. Aqui, "Ações" refere-se a operações que podem levar um tempo significativo, como baixar ou copiar arquivos e durante as quais uma indicação de progresso visível seria apropriada.

Os aplicativos normalmente não implementam essa interface. Grande parte da funcionalidade com a qual os usuários interagem durante as ações é fornecida pela classe CProgressDialog (CLSID_ProgressDialog) que implementa IActionProgress e exibe o progresso em uma caixa de diálogo. Se uma solução que exige um mecanismo diferente de uma caixa de diálogo for necessária, IActionProgress poderá ser usada para fornecer a funcionalidade básica do indicador de progresso.

Depois de implementadas, as classes devem chamar IActionProgress::Begin quando uma ação é iniciada. Periodicamente, IActionProgress::UpdateProgress deve ser chamado para atualizar a interface do usuário com informações de progresso e informações textuais detalhadas devem ser transmitidas para a interface do usuário chamando IActionProgress::UpdateText. IActionProgress::QueryCancel e IActionProgress::ResetCancel devem ser chamados para lidar com solicitações de cancelamento. Depois que a operação terminar, IActionProgress::End deverá ser chamado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

IProgressDialog