Наряду с получением полноценной справки по тому или иному интерфейсному
элементу Delphi позволяет формировать краткие однострочные справки по этим
элементам Эти справки выводятся автоматически на экран, когда курсор мыши
находится над соответствующим элементом Они представляют собой небольшие
окна с размещенными на них одним-двумя словами Их основное назначение пояснить элемент управления Такие краткие справки широко используются в самой среде Delphi. Особенно они полезны для интерфейсных элементов (например,
различных кнопок), которые не имеют отображаемых текстов, а только графические изображения, иногда довольно условные. С этой целью у всех компонент Delphi, являющихся потомками класса TControl, имеются средства вывода такой
справки, а приложение Application при своем создании формирует специальное
окно класса THintWindow, выводящее на экран такую справку. Непосредственно к этому окну обращаться практически не приходится, так как все необходимые характеристики для формирования краткой справки доступны через соответствующие компоненты и приложение Application.
Для организации кратких справок у всех элементов управления имеются
свойства Hint, ShowHint и ParentShowHint.
Свойство Hint типа string содержит текст выводимой краткой справки.
У приложения и элементов управления это свойство имеет отличия У элемента управления этот текст может состоять из двух частей, разделенных вертикальной линией | (символ с кодом 124), например:
Кнопка|Кнопка, запрещающая выполнение действий
Первая часть предназначена для вывода краткой справки в окне класса
THintWindow. Вторая часть, как правило, более информативная, помещается
в свойство Hint приложения Application, откуда она тоже может быть взята,
например для размещения в строке состояния. Если второй части информации нет (отсутствует вертикальная линия), вся информация выводится в окне крат
кои справки и одновременно помещается в свойство Hint приложения Applica
tion.
Если строка этого свойства элемента управления пуста, осуществляется
поиск непустого значения этого свойства у его старших компонент, и если
такая строка будет найдена, она будет выводиться в качестве краткой справки.
Свойство ShowHint логического типа определяет возможность вывода краткого
сообщения на экран. Ему задается значение True, если для данного элемента
управления следует выводить краткую справку, и False - в противном случае.
Свойство логического типа ParentShowHint определяет, какую справку следует выводить для элемента управления. Если это свойство имеет значение True, элемент использует свойство ShowHint старшей компоненты. В этом случае свойство ShowHint текущего элемента управления автоматически принимает значение False, в противном случае используется свое свойство ShowHint.
Имеется ряд свойств, определяющих вид выводимой на экран информации.
Так как они едины для всей системы вывода кратких справок, то они все сосредоточены в приложении Application. В связи с этим ими можно управлять
только на стадии выполнения программы, записывая в текст программы соответствующие операторы. К ним относятся следующие свойства класса
TApplication: HintColor, HintHidePause, HintPause, HintShortPause, ShowHint.
Обычно используются значения этих свойств, заданных по умолчанию. Если же их необходимо изменить, они задаются в обработчике события OnCreate главной формы, возникающего при ее создании.
У приложения Application имеются также два события: OnHint, возникающее,
когда курсор мыши оказывается над компонентой, у которой значение свойства
Hint непустое, и OnShowHint возникающее перед выводом краткой справки.
Событие OnHint имеет тип TShowHintEvent:
type
TShowHintEvent = procedure(var HintStr: string;
var CanShow: Boolean; var HintInfo: THintInfo) of object;
где HintStr - выводимая строка; CanShow равно True, если информацию следует вывести на экран, и False - в противном случае (при необходимости именно с помощью этого параметра можно по какой либо причине запретить вывод краткой справки); HintInfo - параметры краткой справки. Тип THintInfo определяется следующим образом:
Здесь HintControl - элемент управления, для которого выводится справка; HintWindowClass - класс окна краткой справки; HintPos - координаты левого верхнего угла окна справки на экране; HintMaxWidth - максимальная ширина окна справки; HintColor - цвет фона окна справки; CursorRect - размеры окна (обычно размеры
элемента управления), при нахождении в котором курсора мыши выводится справка; CursorPos - положение курсора мыши внутри элемента управления при выводе справки; ReshowTimeout - время в миллисекундах, через которое система краткой справки будет запрашивать новую справку; HideTimeout - время в миллисекундах, в течение которого краткая справка выводится на экран; HintStr - строка, выводимая на экран; Hint Data - резервный параметр.
Событие OnShowHint возникает, когда должна быть выведена на экран краткая справка.
При формировании краткой справки используются также стандартные
функции GetShortHint и GetLongHint: GetShortHint(Hint) - получить первую часть краткой справки.
Эта функция имеет тип string и возвращает первую часть (расположенную до вертикальной линии с кодом 124) текста Hint. Используется для формирования содержимого окна с краткой справкой об элементе управления, над которым находится курсор мыши. GetLongHint(Hint) - получить вторую часть краткой справки.
Эта функция также типа string возвращает вторую часть (расположенную после
вертикальной линии с кодом 124) текста Hint Используется для формиро-
вания содержимого свойства Hint приложения Application. Формирование краткой справки осуществляется следующим образом. Когда
курсор мыши находится над компонентой, для которой имеется краткая справка т. е.
непустое значение свойства Hint (у самой компоненты или у ее старшей компо-
ненты) и вывод справки для компоненты разрешен (свойство ShowHint или
ParentShowHint равно True), включается система вывода краткой справки. При
этом формируется событие приложения OnHint. При необходимости это событие
можно использовать для выполнения дополнительных действий, связанных с вы-
водом краткой справки, например для вывода в строку состояния содержимого
свойства Hint приложения Application. Обычно в этом свойстве находится вторая
часть строки (расположенная после вертикальной линии с кодом 124) свойства
Hint того элемента управления, над которым в данный момент находится курсор мыши.
Далее через интервал времени, задаваемый свойством HintPause, формируется событие приложения OnShowHint. По умолчанию этот интервал равен 0,8 сек. Его можно использовать для выполнения каких-либо дополнительных действий, связанных
с выводом краткой справки, например для задания нестандартных параметров
выводимой справки. Если же не использовать обработчик этого события, будет
выведено окно с краткой справкой и характеристиками, задаваемыми по умол-
чанию. Окно остается видимым на экране в течение времени, определяемом
свойством HintHidePause. По умолчанию этот интервал равен 2,5 сек. По исте-
чении этого интервала справка о компоненте исчезает, и для ее повторного
вывода следует сместить курсор мыши с компоненты, а затем снова поместить
на нее.
Опубликовал Kest
December 23 2009 21:27:37 ·
0 Комментариев ·
7125 Прочтений ·
• Не нашли ответ на свой вопрос? Тогда задайте вопрос в комментариях или на форуме! •
Комментарии
Нет комментариев.
Добавить комментарий
Рейтинги
Рейтинг доступен только для пользователей.
Пожалуйста, залогиньтесь или зарегистрируйтесь для голосования.
Нет данных для оценки.
Гость
Вы не зарегистрированны? Нажмите здесь для регистрации.
Главная
Каталог файлов
