Функция DrawFocusRect


Функция DrawFocusRect рисует прямоугольник в стиле, используемом для того, чтобы указать, что у прямоугольника есть фокус.

Синтаксис

BOOL DrawFocusRect(
  HDC hDC,          // дескриптор контекста устройства
  CONST RECT* lprc  // логические координаты
);

Параметры

hDC

[in] Дескриптор контекста устройства.

lprc

[in] Указатель на структуру RECT, которая содержит логические координаты прямоугольника.

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

Если функция завершается успешно, возвращаемое значение - не нуль.

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Функция DrawFocusRect работает только в режиме MM_TEXT.

Поскольку DrawFocusRect - XOR-функция, вызывая её второй раз для того же самого прямоугольника, она удаляет прямоугольник с экрана.

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

Windows XP: Прямоугольник фокуса может теперь быть более толстым, чем 1 пиксель, таким образом более видимым для дисплеев высокой разрешающей способности, с высокой плотностью размещения пикселей и необходимой доступности. Он обрабатывается при помощи флажков SPI_SETFOCUSBORDERWIDTH и SPI_SETFOCUSBORDERHEIGHT в функции SystemParametersInfo.

Демонстрационный код

Пример смотри в статье, "Создание собственного Окна со списком (List Box)" в разделе Использование Окон со списком (List Box).

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисования, FrameRect, RECT

Размещение и совместимость DrawFocusRect

К Windows Vista Да
л Windows XP Да
и Windows 2000 Professional Да
е Windows NT Workstation Да версии 3.1 и выше
н Windows Me Да
т Windows 98 Да
  Windows 95 Да
С Windows Server 2008 Да
е Windows Server 2003 Да
р Windows 2000 Server Да
в Windows NT Server Да версии 3.1 и выше
е
р
Используемая библиотека User32.lib
Используемая DLL -
Заголовочный файл
- объявлено в Winuser.h
- включено в Windows.h
Unicode -
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz