Поделиться через

Класс CMFCPropertyGridToolTipCtrl

  • Статья

Реализует элемент управления подсказкой, используемый классом CMFCPropertyGridCtrl для отображения подсказок.

Синтаксис

class CMFCPropertyGridToolTipCtrl : public CWnd

Участники

Открытые конструкторы

Имя Описание
CMFCPropertyGridToolTipCtrl::CMFCPropertyGridToolTipCtrl Формирует объект CMFCPropertyGridToolTipCtrl.
CMFCPropertyGridToolTipCtrl::~CMFCPropertyGridToolTipCtrl Деструктор.

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

Имя Описание
CMFCPropertyGridToolTipCtrl::Create Создает окно для элемента управления подсказки.
CMFCPropertyGridToolTipCtrl::D eactivate Деактивирует и скрывает элемент управления подсказки.
CMFCPropertyGridToolTipCtrl::GetLastRect Возвращает координаты последней позиции элемента управления подсказки.
CMFCPropertyGridToolTipCtrl::Hide Скрывает элемент управления подсказки.
CMFCPropertyGridToolTipCtrl::PreTranslateMessage Используется классом CWinApp для преобразования сообщений окна перед их передачей функциям Windows TranslateMessage и DispatchMessage . (Переопределяет CWnd::PreTranslateMessage.)
CMFCPropertyGridToolTipCtrl::SetTextMargin Задает интервал между текстом подсказки и границой окна подсказки.
CMFCPropertyGridToolTipCtrl::Track Отображает элемент управления подсказки.

Замечания

Подсказки отображаются, когда указатель находится в имени свойства. Класс CMFCPropertyGridToolTipCtrl отображает подсказку, чтобы она была легко прочитана пользователем. Обычно позиция подсказки определяется положением указателя. Используя этот класс, подсказка отображается по имени свойства и напоминает расширение естественного свойства, чтобы имя свойства было полностью видимым.

MFC автоматически создает этот элемент управления и использует его в классе CMFCPropertyGridCtrl.

Пример

В следующем примере показано, как создать объект CMFCPropertyGridToolTipCtrl класса и как отобразить элемент управления подсказкой.

CMFCPropertyGridToolTipCtrl *pToolTipCtrl = new CMFCPropertyGridToolTipCtrl();
CRect crect(1, 1, 50, 50);
pToolTipCtrl->Track(crect, _T("this is a tool tip control"));

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

CObject

CCmdTarget

CWnd

CMFCPropertyGridToolTipCtrl

Требования

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

CMFCPropertyGridToolTipCtrl::CMFCPropertyGridToolTipCtrl

Формирует объект CMFCPropertyGridToolTipCtrl.

CMFCPropertyGridToolTipCtrl::CMFCPropertyGridToolTipCtrl();

CMFCPropertyGridToolTipCtrl::Create

Создает окно для элемента управления подсказки.

BOOL Create(CWnd* pWndParent);

Параметры

pWndParent
[in] Указатель на родительское окно.

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

ЗНАЧЕНИЕ TRUE, если окно успешно создано; в противном случае — ЗНАЧЕНИЕ FALSE.

CMFCPropertyGridToolTipCtrl::D eactivate

Деактивирует и скрывает элемент управления подсказки.

void Deactivate();

Замечания

Этот метод задает последнюю позицию и текст пустым значениям, чтобы будущие вызовы CMFCPropertyGridToolTipCtrl::Track отображали подсказку.

CMFCPropertyGridToolTipCtrl::GetLastRect

Возвращает координаты последней позиции элемента управления подсказки.

void GetLastRect(CRect& rect) const;

Параметры

rect
[out] Содержит последнюю позицию элемента управления подсказки.

CMFCPropertyGridToolTipCtrl::Hide

Скрывает элемент управления подсказки.

void Hide();

CMFCPropertyGridToolTipCtrl::SetTextMargin

Задает интервал между текстом подсказки и границой окна подсказки.

void SetTextMargin(int nTextMargin);

Параметры

nTextMargin
[in] Задает интервал между текстом элемента управления подсказки и границей окна подсказки. Значение по умолчанию — 10 пикселей.

CMFCPropertyGridToolTipCtrl::Track

Отображает элемент управления подсказки.

void Track(
    CRect rect,
    const CString& strText);

Параметры

rect
[in] Задает позицию и размер элемента управления подсказки.

strText
[in] Указывает текст, отображаемый в подсказке.

Замечания

Этот метод отображает элемент управления подсказки по позиции и размеру, указанному в прямоугольнику. Если позиция, размер и текст не изменились с момента последнего вызова этого метода, этот метод не действует.

См. также

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