Метод IConsole2::SetStatusText (mmc.h)
Метод IConsole2::SetStatusText позволяет оснастке изменять текст в строке состояния. Имейте в виду, что этот параметр используется только экземплярами IComponent.
Синтаксис
HRESULT SetStatusText(
[in] LPOLESTR pszStatusText
);
Параметры
[in] pszStatusText
Указатель на строку, завершающуюся null, которая содержит текст, отображаемый в строке состояния.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Комментарии
Строка состояния содержит три раздела, которые разделены символом канала (|). Например, установите для текста в строке состояния значение "Left| Средний| Right" помещает "Left" в крайнем левом разделе строки состояния, "Middle" в средней части и "Right" в крайнем правом разделе.
Если имеется более трех полей (то есть имеется более двух каналов), то все, что будет помещено в четвертое и более высокое поля, опущено.
Кроме того, средний раздел предназначен для работы в качестве индикатора выполнения. Эта функция вызывается путем передачи символа "%" в качестве первого символа, за которым следует число от 0 до 100, в средний раздел. Вместо текста в этом разделе отображается индикатор выполнения от нуля до 100 процентов. Например, при передаче "Готово|%75" в левом разделе будет выполнено, а индикатор выполнения — на 75 % в среднем.
Чтобы отобразить строку, начинающуюся с "%" в средней части строки состояния, начните строку с "%%". Это приводит к отображению текста в среднем разделе и удалению первого "%". Например: "Сегодня |%%Среда%" приводит к левому разделу, который содержит "Сегодня есть", и в средней части, содержащей "%Среда%". Если в среднем разделе после "%" введено недопустимое число или нечисловый текст, средний раздел пуст. Если символ "%" является единственным символом в разделе, он будет отображаться в виде текста.
Этот метод следует вызывать из указателя интерфейса IConsole2 , полученного через IComponent.
Только оснастка, владеющая текущим выбранным элементом область, может изменить текст строки состояния.
В MMC версии 1.1 и более поздних версиях каждое дочернее окно интерфейса с несколькими документами (MDI) имеет строку состояния.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |
| DLL | Mmcndmgr.dll |