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) |