Méthode IConsole2 ::SetStatusText (mmc.h)

La méthode IConsole2 ::SetStatusText permet au composant logiciel enfichable de modifier le texte dans la barre de status. N’oubliez pas que cela est utilisé uniquement par les instances d’IComponent.

Syntaxe

HRESULT SetStatusText(
  [in] LPOLESTR pszStatusText
);

Paramètres

[in] pszStatusText

Pointeur vers une chaîne terminée par un caractère Null qui contient du texte à afficher dans la barre de status.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Remarques

La barre status comporte trois sections, qui sont délimitées par le caractère de canal (|). Par exemple, affectez au texte de la barre status la valeur « Left | Milieu| À droite » place « Left » dans la section la plus à gauche de la barre status, « Middle » dans la section du milieu et « Right » dans la section la plus à droite.

Si plus de trois champs sont délimités (c’est-à-dire qu’il y a plus de deux canaux), tout ce qui serait placé dans les quatrièmes champs et les champs supérieurs est omis.

En outre, la section centrale est conçue pour fonctionner comme une barre de progression. Cette fonctionnalité est appelée en passant le caractère « % » comme premier caractère, suivi d’un nombre compris entre 0 et 100, dans la section centrale. Au lieu de texte, cette section affiche ensuite une barre de progression de zéro à 100 %. Par exemple, le passage de « Terminé|%75 » place « Terminé » dans la section de gauche et une barre de progression terminée à 75 % dans la section centrale.

Pour afficher une chaîne qui commence par '%' dans la section centrale de la barre de status, commencez la chaîne par '%%'. Cela entraîne l’affichage du texte dans la section centrale et la suppression du premier « % ». Par exemple : « Today is|%%Wednesday% » aboutit à la section de gauche qui contient « Today is » et à la section du milieu qui contient « %Wednesday% ». Si un nombre non valide ou du texte non numérique est entré dans la section centrale après un « % », la section du milieu est vide. Si un « % » est le seul caractère de la section, il s’affiche sous forme de texte.

Cette méthode doit être appelée à partir d’un pointeur d’interface IConsole2 obtenu via IComponent.

Seul le composant logiciel enfichable qui possède l’élément d’étendue actuellement sélectionné peut modifier le texte de la barre status.

Dans MMC version 1.1 et ultérieures, chaque fenêtre enfant MDI (Multi-Document Interface) a une barre de status.

Configuration requise

Voir aussi

IConsole2