Чтение онлайн

ЖАНРЫ

Исчерпывающее руководство по написанию всплывающих подсказок

Джек Роджер

Шрифт:

 CPaintDC DC(this);

 int nSavedDC = DC.SaveDC;

 CRect ClientRect;

 GetClientRect(ClientRect);

 if (IsListBoxOwnerDraw) {

// Доверим рисование элементу "список".

DRAWITEMSTRUCT DrawItemStruct;

DrawItemStruct.CtlType = ODT_LISTBOX;

DrawItemStruct.CtlID = m_pListBox->GetDlgCtrlID;

DrawItemStruct.itemID = m_nItemIndex;

DrawItemStruct.itemAction = ODA_DRAWENTIRE;

DrawItemStruct.hwndItem = m_pListBox->GetSafeHwnd;

DrawItemStruct.hDC = DC.GetSafeHdc;

DrawItemStruct.rcItem = ClientRect;

DrawItemStruct.itemData = m_pListBox->GetItemData(m_nItemIndex);

DrawItemStruct.itemState = (m_pListBox->GetSel(m_nItemIndex) > 0 ? ODS_SELECTED : 0);

if (m_pListBox->GetStyle & LBS_MULTIPLESEL) {

if (m_pListBox->GetCaretIndex == m_nItemIndex) {

DrawItemStruct.itemState |= ODS_FOCUS;

}

} else {

DrawItemStruct.itemState |= ODS_FOCUS;

}

m_pListBox->DrawItem(&DrawItemStruct);

 } else {

//
Рисуем самостоятельно

CFont* pFont = m_pListBox->GetFont;

ASSERT_VALID(pFont);

DC.SelectObject(pFont);

COLORREF clrBackground = RGB(255, 255, 255);

if (m_pListBox->GetSel(m_nItemIndex) > 0) {

DC.SetTextColor(::GetSysColor(COLOR_HIGHLIGHTTEXT));

clrBackground = ::GetSysColor(COLOR_HIGHLIGHT);

}

// Рисуем фон

DC.FillSolidRect(ClientRect, clrBackground);

// Рисуем текст строки

CString strItem;

m_pListBox->GetText(m_nItemIndex, strItem);

ASSERT(!strItem.IsEmpty);

DC.SetBkMode(TRANSPARENT);

DC.TextOut(1, –1, strItem);

 }

 DC.RestoreDC(nSavedDC);

 // Не вызываем CWnd::OnPaint для сообщений отрисовки

}

CTitleTip::CTitleTip регистрирует класс окна вызовом функции AfxRegisterWndClass и сохраняет имя класса в переменной CTitleTip::m_pszWndClass. Я использую функцию AfxRegisterWndClass, чтобы иметь возможность зарегистрировать класс окна с установленным стилем CS_SAVEBITS. Флаг CS_SAVEBITS используется для оптимизации – Windows сохраняет кусок окна, заслоненного элементом TitleTip, как картинку. В результате, этому окну не нужно посылать сообщение WM_PAINT, когда подсказка убирается с экрана. CTitleTip::Create создает подсказку в виде popup-окна. К окну подсказки рамка добавляется только если элемент "список" является обычным, так как Windows автоматически добавляет рамку к элементам "список" с пользовательской отрисовкой перед посылкой сообщения WM_DRAWITEM. Обратите внимание, что значение переменной CTitleTip::m_pszWndClass передается в качестве имени класса окна в функцию CWnd::CreateEx. CTitleTip::IsListBoxOwnerDraw возвращает TRUE, если родительский элемент "список" является элементом с пользовательской отрисовкой. Функция узнает об этом по стилю элемента "список".

Функция CTitleTip::Show отвечает за показ элемента TitleTip. Ее параметр DisplayRect указывает на координаты и размеры подсказки в клиентской системе координат родительского окна. Параметр nItemIndex указывает индекс отображаемой строки в списке. Я оптимизировал функцию, чтобы она только помечала для отрисовки и устанавливала координаты и размеры подсказки только если она изменилась. Для изменения размеров подсказки используется функция CWnd::SetWindowPos.

В качестве ее первого параметра используется wndTopMost, чтобы окно подсказки располагалось поверх всех остальных окон. Чтобы предотвратить получение фокуса ввода этим окном (окну подсказки в любом случае не нужен клавиатурный ввод), используется флаг SWP_NOACTIVATE. Функция CTitleTip::Hide прячет TitleTip вызовом функции CWnd::ShowWindow с параметром SW_HIDE.

CTitleTip::OnPaint по-разному рисует подсказку в зависимости от вида элемента управления "список". Если родительский элемент "список" реализует пользовательскую отрисовку, функция создает и инициализирует структуру DrawItemStruct подобно тому, как это проделывает Windows перед отправкой сообщения WM_DRAWITEM. Разница лишь в том, что вместо того, чтобы установить поле hDC этой структуры равным хэндлу контекста устройства элемента "список", CTitleTip::OnPaint инициализирует это поле значением хэндла контекста устройства окна подсказки. После этого вызывается функция m_pListBox->DrawItem, которой передается адрес заполненной структуры DrawItemStruct. Результатом всех этих действий является то, что элемент "список" рисует одну из своих строк в окне подсказки. Очень умно! Вот в чем преимущество объектно-ориентированного программирования и хорошо продуманных интерфейсов. Элемент управления "список" не знает – или не хочет знать – где он рисует строку, он знает только, как ее нужно рисовать. CTitleTip не умеет рисовать строку списка с пользовательской отрисовкой, но он знает как инициализировать DrawItemStruct и вызвать CListBox::DrawItem. С другой стороны, если родительский список является обычным элементом "список", класс CTitleTip рисует все сам. К счастью, это не так сложно. Функция отрисовки получает нужный текст и шрифт от родительского элемента "список", устанавливает контекст устройства, заполняет фон и рисует текст.

Класс CTitleTipListBox отвечает за управление элементом TitleTip (см. рис.12). В переменной CTitleTipListBox::m_LastMouseMovePoint хранится последняя позиция курсора мыши. CTitleTipListBox::m_bMouseCaptured показывает, производится ли в данный момент захват мыши (mouse capture). CTitleTipListBox::m_TitleTip – это экземпляр класса CTitleTip, указывающий на показываемую подсказку. CTitleTipListBox::m_nNoIndex – это константа, означающая, что в элементе "список" не отображается подсказка ни для одной строки.

Рис.12. CTitleTipListBox

// TitleTipListBox.h : header file

//

/////////////////////////////////////////////////////////////////////////////

// CTitleTipListBox window

#ifndef __TITLETIPLISTBOX_H__

#define __TITLETIPLISTBOX_H__

#include "TitleTip.h"

class CTitleTipListBox : public CListBox { // Construction public:

 CTitleTipListBox;

// Overrides

 // ClassWizard generated virtual function overrides

 //{{AFX_VIRTUAL(CTitleTipListBox)

public:

 virtual BOOL PreTranslateMessage(MSG* pMsg);

 //}}AFX_VIRTUAL

 // Implementation

public:

 virtual ~CTitleTipListBox;

protected:

 const int m_nNoIndex; // Пустой индекс

 CPoint m_LastMouseMovePoint; // Последние координаты курсора мыши

 BOOL m_bMouseCaptured; // Захвачена ли мышь?

 CTitleTip m_TitleTip; // Показываемый элемент TitleTip

 // Этот метод должен быть переопределен элементом "список" с пользовательской отрисовкой.

 virtual int GetIdealItemRect(int nIndex, LPRECT lpRect);

 void AdjustTitleTip(int nNewIndex);

 void CaptureMouse;

Поделиться с друзьями: