Compartir a través de

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

  • Artículo

Muestra un mensaje en el cuadro de diálogo de progreso.

Sintaxis

HRESULT SetLine(
       DWORD   dwLineNum,
  [in] PCWSTR  pwzString,
       BOOL    fCompactPath,
       LPCVOID pvResevered
);

Parámetros

dwLineNum

Tipo: DWORD

Número de línea en el que se va a mostrar el texto. Actualmente hay tres líneas: 1, 2 y 3. Si se incluyó la marca PROGDLG_AUTOTIME en el parámetro dwFlags cuando se llamó a IProgressDialog::StartProgressDialog , solo se pueden usar las líneas 1 y 2. El tiempo estimado se mostrará en la línea 3.

[in] pwzString

Tipo: PCWSTR

Cadena Unicode terminada en null que contiene el texto.

fCompactPath

Tipo: BOOL

TRUE para que las cadenas de ruta de acceso se compacten si son demasiado grandes para caber en una línea. Las rutas de acceso se compactan con PathCompactPath.

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.

Comentarios

Esta función se usa normalmente para mostrar un mensaje como "El elemento XXX se está procesando". Normalmente, los mensajes se muestran en las líneas 1 y 2, con la línea 3 reservada para el tiempo estimado.

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