Método IProgressDialog::StartProgressDialog (shlobj_core.h)

Artigo
03/02/2024

Inicia a caixa de diálogo de progresso.

Sintaxe

HRESULT StartProgressDialog(
  [in] HWND     hwndParent,
       IUnknown *punkEnableModless,
       DWORD    dwFlags,
       LPCVOID  pvResevered
);

Parâmetros

[in] hwndParent

Digite: HWND

Um identificador para a janela pai da caixa de diálogo.

punkEnableModless

Tipo: IUnknown*

Reservado. Defina como NULL.

dwFlags

Tipo: DWORD

Sinalizadores que controlam a operação da caixa de diálogo de progresso. Uma combinação dos seguintes valores:

PROGDLG_NORMAL

Comportamento normal da caixa de diálogo de progresso.

PROGDLG_MODAL

A caixa de diálogo de progresso será modal para a janela especificada por hwndParent. Por padrão, uma caixa de diálogo de progresso é sem formatar.

PROGDLG_AUTOTIME

Estime automaticamente o tempo restante e exiba a estimativa na linha 3. Se esse sinalizador estiver definido, IProgressDialog::SetLine só poderá ser usado para exibir texto nas linhas 1 e 2.

PROGDLG_NOTIME

Não mostre o texto "tempo restante".

PROGDLG_NOMINIMIZE

Não exiba um botão minimizar na barra de legenda da caixa de diálogo.

PROGDLG_NOPROGRESSBAR

Não exiba uma barra de progresso. Normalmente, um aplicativo pode determinar quantitativamente quanto da operação permanece e passar periodicamente esse valor para IProgressDialog::SetProgress. A caixa de diálogo progresso usa essas informações para atualizar sua barra de progresso. Normalmente, esse sinalizador é definido quando o aplicativo de chamada deve aguardar a conclusão de uma operação, mas não tem nenhuma informação quantitativa que possa ser usada para atualizar a caixa de diálogo.

PROGDLG_MARQUEEPROGRESS

Windows Vista e posterior. Define a barra de progresso como modo de letreiro. Isso faz com que a barra de progresso role horizontalmente, semelhante a uma exibição de letreiro. Use isso quando desejar indicar que o progresso está sendo feito, mas o tempo necessário para a operação é desconhecido.

PROGDLG_NOCANCEL

Windows Vista e posterior. Não exiba um botão Cancelar. A operação não pode ser cancelada. Use isso somente quando absolutamente necessário.

pvResevered

Tipo: LPCVOID

Reservado. Defina como NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, 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	shlobj_core.h
DLL	Shell32.dll (versão 5.0 ou posterior)

Confira também

IProgressDialog

Compartilhar via