Класс CMFCLinkCtrl

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Класс CMFCLinkCtrl отображает кнопку в виде гиперссылки и вызывает целевой объект ссылки при нажатии кнопки.

Синтаксис

class CMFCLinkCtrl : public CMFCButton

Участники

Открытые методы

Имя	Описание
CMFCLinkCtrl::SetURL	Отображает указанный URL-адрес в виде текста кнопки.
CMFCLinkCtrl::SetURLPrefix	Задает неявный протокол (например, http:) URL-адреса.
CMFCLinkCtrl::SizeToContent	Изменяет размер кнопки, чтобы она содержала текст кнопки или растровое изображение.

Защищенные методы

Имя	Описание
CMFCLinkCtrl::OnDrawFocusRect	Вызывается платформой перед рисованием прямоугольника фокуса кнопки.

Замечания

При нажатии кнопки, производной от CMFCLinkCtrl класса, платформа передает URL-адрес кнопки в качестве параметра методу ShellExecute . ShellExecute Затем метод открывает целевой объект URL-адреса.

Пример

В следующем примере показано, как задать размер CMFCLinkCtrl объекта и как задать URL-адрес и подсказку в объекте CMFCLinkCtrl . Этот пример является частью примера "Новые элементы управления".

CMFCLinkCtrl m_btnLink;

m_btnLink.SetURL(_T("http://www.microsoft.com"));
m_btnLink.SetTooltip(_T("Visit Microsoft site"));
// resize the button to contain the button text or bitmap
m_btnLink.SizeToContent();

Иерархия наследования

CObject

CCmdTarget

CWnd

CButton

CMFCButton

CMFCLinkCtrl

Требования

Заголовок: afxlinkctrl.h

CMFCLinkCtrl::OnDrawFocusRect

Вызывается платформой перед рисованием прямоугольника фокуса кнопки.

virtual void OnDrawFocusRect(
    CDC* pDC,
    const CRect& rectClient);

Параметры

pDC
[in] Указатель на контекст устройства.

rectClient
[in] Прямоугольник, ограничивающий элемент управления ссылкой.

Замечания

Переопределите этот метод, если вы хотите использовать собственный код для рисования прямоугольника фокуса кнопки.

CMFCLinkCtrl::SetURL

Отображает указанный URL-адрес в виде текста кнопки.

void SetURL(LPCTSTR lpszURL);

Параметры

lpszURL
[in] Отображаемый текст кнопки.

Замечания

CMFCLinkCtrl::SetURLPrefix

Задает неявный протокол (например, http:) URL-адреса.

void SetURLPrefix(LPCTSTR lpszPrefix);

Параметры

lpszPrefix
[in] Префикс протокола URL-адреса.

Замечания

Используйте этот метод, чтобы задать префикс URL-адреса. Префикс не отображается на лице кнопки, но его можно использовать для перехода к целевому объекту URL-адреса.

CMFCLinkCtrl::SizeToContent

Изменяет размер кнопки, чтобы она содержала текст кнопки или растровое изображение.

virtual CSize SizeToContent(
    BOOL bVCenter=FALSE,
    BOOL bHCenter=FALSE);

Параметры

bVCenter
[in] TRUE, чтобы центрировать текст кнопки и растровое изображение по вертикали между верхней и нижней частью элемента управления ссылкой; в противном случае — ЗНАЧЕНИЕ FALSE. Значение по умолчанию — FALSE.

bHCenter
[in] Значение TRUE для выравнивания текста кнопки и растрового рисунка по горизонтали между левой и правой стороны элемента управления ссылкой; в противном случае — ЗНАЧЕНИЕ FALSE. Значение по умолчанию — FALSE.

Возвращаемое значение

Объект CSize, содержащий новый размер элемента управления ссылкой.

Замечания

См. также

Диаграмма иерархии
Классы
Класс CLinkCtrl
Класс CMFCButton