Шаг 795 - CDC::GrayString

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

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

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

Замечания
Выводит серый текст в данном расположении, записывая текст в точечном рисунке памяти, сделав точечный рисунок серым, и затем копируя точечный рисунок на дисплей. Функция потускнеет текст независимо от выбранной кисти и фонового режима. GrayString функция использует в настоящее время выбранный шрифт. MM_TEXT режим отображения должен быть выбран перед использованием этой функции.
Прикладная программа может выводить, серые строки на устройствах, которые поддерживают твердый серый цвет без того, чтобы вызвать GrayString функцию. Цвет системы COLOR_GRAYTEXT - твердо серый цвет системы, используемый, чтобы вывести заблокированный текст. Прикладная программа может вызывать функцию GetSysColor Windows, чтобы получить цветное значение COLOR_GRAYTEXT. Если цвет - другой чем 0 (черный), прикладная программа может вызывать SetTextColor функцию, чтобы установить текстовый цвет к цветному значению и затем выводить строку непосредственно. Если полученный цвет черный, прикладная программа должна вызвать GrayString, чтобы вывести серый цвет.
Если lpfnOutput NULL, GDI использует функцию Windows TextOut, и lpData принят, чтобы быть далеким указателем на символ, который нужно вывести. Если символы, которые нужно вывести не могут быть обработаны TextOut функцией (например, строка сохранена как точечный рисунок), прикладная программа должна обеспечить собственную функцию вывода.
Также обратите внимание, что все функции повторного вызова должны перехватывать исключительные ситуации перед возвратом Windows, так как исключительные ситуации не могут быть брошены поперек границ повторного вызова.
Когда рамка находится в режиме предварительного просмотра, обращение к GrayString функции транслируется к обращению TextOut, и функция повторного вызова не вызвана.


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 5.02.2002