CDC::GrayStri&ngnbsp;

ВиртуальныйBOOLGrayString (CBrush *pBrush,BOOL()ОБРАТНОГОэкспорта *lpfnOutput) (HDC,LPARAM,int),LPARAMlpData,intnCount,intx,inty,intnWidth,intnHeight);

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

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

Параметры

pBrush

Идентифицирует brush для затемнения (седых).

lpfnOutput

Указывает адрес процедуры экземпляр функции обратного вызова, поставляемых приложений, рисующий строки. Для получения дополнительной информации смотрите описание Windows OutputFunc функции обратного вызова. Если этот параметр имеет значение NULL, система использует функцию TextOut Windows для рисования строки и lpData предполагается является длинный указатель символьной строки для вывода.

lpData

Определяет далеко указатель на данные, которые должны быть переданы функции вывода. Если lpfnOutput имеет значение NULL, lpData должны быть длинный указатель на строку для вывода.

nCount

Определяет количество символов для вывода. Если этот параметр равен 0, GrayString вычисляет длину строки (если lpData является указателем на строку). Если nCount имеет 1 и возвращает значение 0, функция, который указывает lpfnOutput , изображение показано, но не заблокированы.

x

Указывает координату x логическое положение прямоугольника, ограничивающий строки.

y

Определяет логический-координату y начальной позиции прямоугольник, ограничивающий строки.

nWidth

Определяет ширину (в логических единицах) прямоугольник, ограничивающий строки. Если значение nWidth равно 0, GrayString вычисляет ширину области, при условии, что lpData является указателем на строку.

nHeight

Указывает высоту (в логических единицах) прямоугольник, ограничивающий строки. Если значение nHeight равно 0, GrayString вычисляет высоту области, при условии, что lpData является указателем на строку.

Примечания

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

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

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

Также Обратите внимание, что все функции обратного вызова должны перехватить исключения Microsoft Foundation до возвращения в Windows, так как исключения не могут вызываться через границы обратного вызова. Для получения дополнительных сведений об исключениях, см. статью исключения в Руководстве Visual C++ программист.

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

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

CDC обзорЧлены класса | Иерархическая схема

См. такжеnbsp; :: GetSysColor, CDC::SetTextColor, CDC::TextOut, :: GrayString

Index