CDC::GrayString

Статья
02/20/2013

Draws снижает яркость текст (серого) в заданном месте с помощью написания текста в растровом изображении памяти, уменьшить яркость растровое изображение, а затем скопировать растровое изображение для отображения.

virtual BOOL GrayString(
   CBrush* pBrush,
   BOOL ( CALLBACK* lpfnOutput )( HDC, LPARAM, int ),
   LPARAM lpData,
   int nCount,
   int x,
   int y,
   int nWidth,
   int nHeight
);

Параметры

pBrush
Определяет кисть, используемая для уменьшения яркость (graying).
lpfnOutput
Указывает адрес процедура- экземпляра приложение- заданной функции обратного вызова, которая рисует строка.Дополнительные сведения см. в описании Windows OutputFunc функция обратного вызова.Если этот параметр NULL, система использует функцию Windows TextOut для рисования строки, и предполагается, что lpData длинным указателем на символьную строку для вывода.
lpData
Определяет далекий указатель на данные, передаваемые функции вывода.Если lpfnOutputNULL, то должно быть lpData длинным указателем на строку для вывода.
nCount
Указывает число символов для вывода.Если этот параметр равен 0, то GrayString вычисляет длину строки (предполагается, что lpData указатель на строку).Если nCount – отображаются, но не уменьшить яркость 1, и функция возвращает 0, указанную в lpfnOutput образ.
x
Идентифицирует логический координату x начальной позиции прямоугольника, ограничивающий строки.
y
Идентифицирует логический координату y начальной позиции прямоугольника, ограничивающий строки.
nWidth
Задает ширину (в логических единицах) прямоугольника, ограничивающий строки.Если nWidth 0, то GrayString вычисляет ширину области, предполагая, что lpData указатель на строку.
nHeight
Указывает высоту (в логических единицах) прямоугольника, ограничивающий строки.Если nHeight 0, то GrayString вычисляет высоту области, предполагая, что lpData указатель на строку.

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

Ненулевой нарисована если строка или 0, если функция TextOut или приложение- предоставленной функции вывода или возвращали значение 0, если недостаточно памяти для создания растрового изображения памяти для уменьшения яркость.

Заметки

Функция снизит яркость текста независимо от выбранных кисти и фона.Функция-член GrayString использует текущий выбранный шрифт.MM_TEXT режим сопоставления должен быть выделен перед использованием этой функции.

Приложение может создать уменьшен яркостьые (отображается серым цветом) строки на устройствах, поддерживающих серый цвет сплошной GrayString без вызова функции-члена.Цвет COLOR_GRAYTEXT системы тверд- grey системы, используемый для текста отключенного рисования.Приложение может вызвать функцию GetSysColor Windows для получения значения цвета COLOR_GRAYTEXT.Если цвет за исключением 0 (черный), приложение может вызвать функцию-член SetTextColor, чтобы задать цвет текста к значению цвета, а затем создать строку непосредственно.Если полученный цвет черн, то приложение должно вызвать GrayString чтобы уменьшить яркость (серый цвет) текст.

Если lpfnOutputNULL, GDI использует функцию Windows TextOut, и предполагается, что lpData далеким указателем на символ для вывода.Если символы для вывода не могут быть обработаны функцией-членом TextOut (например, строка хранится в виде растрового изображения), то приложение должно предоставить собственную функцию вывода.

Также обратите внимание, что все функции обратного вызова исключения должны поглотить Microsoft foundation перед возвратом к Windows, поскольку исключения нельзя вызвать через границы обратного вызова.Дополнительные сведения об исключениях см. в статье исключения.

Функция обратного вызова, передаваемая GrayString должна использовать соглашение о вызовах __stdcall и должна быть экспортироватьа с __declspec.

Когда структура в режиме предварительного просмотра, то вызов к функции-члену GrayString преобразуется к вызову TextOut, и функция обратного вызова не называется.