Método IConsole2::SetStatusText (mmc.h)
El método IConsole2::SetStatusText permite al complemento cambiar el texto de la barra de estado. Tenga en cuenta que esto solo lo usan las instancias de IComponent.
Sintaxis
HRESULT SetStatusText(
[in] LPOLESTR pszStatusText
);
Parámetros
[in] pszStatusText
Puntero a una cadena terminada en null que contiene texto que se va a mostrar en la barra de estado.
Valor devuelto
Este método puede devolver uno de estos valores.
Comentarios
La barra de estado tiene tres secciones, que están delineadas por el carácter de barra vertical (|). Por ejemplo, al establecer el texto de la barra de estado en "Left| Medio | Right" coloca "Left" en la sección situada más a la izquierda de la barra de estado, "Middle" en la sección central y "Right" en la sección situada más a la derecha.
Si se delimitan más de tres campos (es decir, hay más de dos canalizaciones), se omite todo lo que se colocaría en los campos cuarto y superior.
Además, la sección central está diseñada para funcionar como una barra de progreso. Esta funcionalidad se invoca pasando el carácter '%' como primer carácter, seguido de un número comprendido entre 0 y 100, en la sección central. En lugar de texto, esta sección muestra una barra de progreso que es cero a 100 % completada. Por ejemplo, si se pasa "Listo|%75" se coloca "Listo" en la sección izquierda y se completa un 75 % en la barra de progreso en la sección central.
Para mostrar una cadena que comienza por '%' en la sección central de la barra de estado, comience la cadena con '%%'. Esto hace que la sección central muestre texto y quite el primer '%'. Por ejemplo: "Hoy es|%%miércoles%" da como resultado la sección izquierda que contiene "Hoy es" y la sección central que contiene "%miércoles%". Si se escribe un número no válido o texto no numérico en la sección central después de "%", la sección central está vacía. Si un '%' es el único carácter de la sección, se mostrará como texto.
Se debe llamar a este método desde un puntero de interfaz IConsole2 obtenido a través de IComponent.
Solo el complemento que posee el elemento de ámbito seleccionado actualmente puede cambiar el texto de la barra de estado.
En MMC versión 1.1 y posteriores, cada ventana secundaria de la interfaz de varios documentos (MDI) tiene una barra de estado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | mmc.h |
| Archivo DLL | Mmcndmgr.dll |