• При наведении на ссылку курсор приобретает форму руки. Обратите внимание, что под Windows 2000 класс CHyperLinkиспользует системный курсор, а в других версиях Windows создаёт его на лету, избавляя вас от необходимости включать его в ресурсы во всех случаях. Кроме того, следует отметить, что курсор должен располагаться именно на надписи, а не в любой точке статического контрола, даже если вы нарисовали его очень большим.
• Если задержать курсор над ссылкой, появляется всплывающая подсказка с адресом, по которому будет осуществляться переход.
• Класс CHyperLinkподдерживает не только мышиный, но и клавиатурный интерфейс. Ссылка, на которую установлен фокус ввода, выделяется пунктирной рамкой. При этом можно перейти по ней, нажав Enter или Space.
ПРИМЕЧАНИЕ
В типичном модальном диалоге Enter не будет попадать в ссылку, так как диалог преобразует его в нажатие кнопки по умолчанию. При желании изменить это поведение можно, переопределив обработчик OnGetDlgCodeкласса CHyperLink.
Переход по ссылке реализован через функцию ShellExecute. Эта функция понимает как адреса сайтов (при этом открывается броузер), так и почтовые адреса (при этом запускается почтовый клиент).
Список методов класса CHyperLinkприведён в таблице 8.
Метод |
Описание |
CHyperLinkImpl() |
Конструктор. Записывает в переменные объекта значения по умолчанию. |
~CHyperLinkImpl() |
Деструктор. Освобождает ресурсы, распределённые в процессе инициализации. |
bool GetLabel(LPTSTR lpstrBuffer, int nLength) const |
Возвращает метку гиперссылки (то есть строку, которую пользователь видит на экране). |
bool SetLabel(LPCTSTR lpstrLabel) |
Устанавливает метку гиперссылки. Текст сохраняется внутри объекта класса. Память для него распределяется динамически. По умолчанию в качестве метки используется содержимое статического контрола, который связывается с объектом класса. Поэтому часто удаётся обойтись и без метода SetLabel. |
bool GetHyperLink(LPTSTR lpstrBuffer, int nLength) const |
Возвращает адрес гиперссылки, по которому осуществляется фактический переход. |
bool SetHyperLink(LPCTSTR lpstrLink) |
Устанавливает адрес гиперссылки. Адрес также сохраняется внутри объекта класса в динамически распределяемой памяти. Иногда адрес совпадает с меткой. В этом случае устанавливать его вызовом SetHyperLinkнеобязательно, так как класс CHyperLinkсделает это за вас. |
BOOL SubclassWindow(HWND hWnd) |
Подменяет оконную процедуру окна, подключая к нему объект класса. |
bool Navigate() |
Осуществляет переход по ссылке. |
void Init() |
Инициализирует объект класса: создаёт или загружает курсор в виде руки, создаёт подчёркнутый фонт и тултип для ссылки, загружает из реестра цвета, которые использует IE. |
void DoPaint(CDCHandle dc) |
Рисует ссылку. Вы можете переопределить этот метод в производном классе, чтобы изменить её внешний вид. |
ПРИМЕЧАНИЕ
Обратите внимание: если метка и адрес гиперссылки у вас отличаются, метод SetHyperLinkследует вызывать до связывания объекта класса с контролом. Дело в том, что в момент связывания (в функции Init, которая вызывается из SubclassWindow) для ссылки создаётся тултип, в который записывается адрес ссылки. Если адрес ещё не задан, в тултип запишется метка.
Класс CMultiPaneStatusBarCtrlImpl
Класс CMultiPaneStatusBarпризван облегчить вашу жизнь при работе со строками состояния. Стандартный контрол status bar из набора общих контролов Windows позволяет создать на строке состояния до 256 панелей, в которых можно отображать текст и иконки. Но он не предоставляет никаких средств для автоматического перемещения этих панелей. Программисту на чистом API приходится передвигать их вручную всякий раз, когда строка состояния изменяет свой размер. В MFC эту работу берёт на себя класс CStatusBar. А в WTL вам поможет класс CMultiPaneStatusBar.
Посмотрим, каким образом используется класс CMultiPaneStatusBar. Сначала объект класса связывается с существующей строкой состояния при помощи DDX_CONTROL. Можно и создать строку состояния с нуля, используя метод Create. Затем задаётся набор панелей для строки состояния. Для этого предназначен метод SetPanes. Он принимает количество панелей и массив с их идентификаторами. Идентификаторы используются для последующего обращения к панелям. Одной из панелей можно назначить стандартный идентификатор ID_DEFAULT_PANE. Панель с таким идентификатором растягивается, занимая всё свободное пространство в строке состояния. Остальные панели имеют фиксированный размер (который всегда можно изменить, используя метод SetPaneWidth). О корректном перемещении панелей заботится WTL. Вам остаётся только изменять текст панелей, их иконки и всплывающие подсказки в соответствии с вашими нуждами.
Читать дальше