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

Inicia el cuadro de diálogo de progreso.

Sintaxis

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

Parámetros

[in] hwndParent

Tipo: HWND

Identificador de la ventana primaria del cuadro de diálogo.

punkEnableModless

Tipo: IUnknown*

Reservado. Se establece en NULL.

dwFlags

Tipo: DWORD

Marcas que controlan la operación del cuadro de diálogo de progreso. Combinación de las marcas de los valores siguientes:

PROGDLG_NORMAL

Comportamiento normal del cuadro de diálogo de progreso.

PROGDLG_MODAL

El cuadro de diálogo de progreso será modal en la ventana especificada por hwndParent. De forma predeterminada, un cuadro de diálogo de progreso es modeless.

PROGDLG_AUTOTIME

Calcule automáticamente el tiempo restante y muestre la estimación en la línea 3. Si se establece esta marca, IProgressDialog::SetLine solo se puede usar para mostrar texto en las líneas 1 y 2.

PROGDLG_NOTIME

No muestre el texto "tiempo restante".

PROGDLG_NOMINIMIZE

No muestre un botón minimizar en la barra de subtítulo del cuadro de diálogo.

PROGDLG_NOPROGRESSBAR

No muestre una barra de progreso. Normalmente, una aplicación puede determinar cuantitativamente cuánto permanece la operación y pasar periódicamente ese valor a IProgressDialog::SetProgress. El cuadro de diálogo progreso usa esta información para actualizar su barra de progreso. Esta marca se establece normalmente cuando la aplicación que realiza la llamada debe esperar a que finalice una operación, pero no tiene ninguna información cuantitativa que pueda usar para actualizar el cuadro de diálogo.

PROGDLG_MARQUEEPROGRESS

Windows Vista y versiones posteriores. Establece la barra de progreso en modo de marquesina. Esto hace que la barra de progreso se desplace horizontalmente, similar a una pantalla de marquesina. Úselo cuando desee indicar que se está realizando el progreso, pero se desconoce el tiempo necesario para la operación.

PROGDLG_NOCANCEL

Windows Vista y versiones posteriores. No muestre un botón cancelar. No se puede cancelar la operación. Úselo solo cuando sea absolutamente necesario.

pvResevered

Tipo: LPCVOID

Reservado. Se establece en NULL.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Consulte también

IProgressDialog