На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GrayString



The GrayString function draws gray text at the specified location. The function draws the text by copying it into a memory bitmap, graying the bitmap, and then copying the bitmap to the screen. The function grays the text regardless of the selected brush and background. GrayString uses the font currently selected for the specified device context.

If the lpOutputFunc parameter is NULL, GDI uses the TextOut function, and the lpData parameter is assumed to be a pointer to the character string to be output. If the characters to be output cannot be handled by TextOut (for example, the string is stored as a bitmap), the application must supply its own output function.

BOOL GrayString(

HDC hDC, // handle to the device context
HBRUSH hBrush, // handle to the brush for graying
GRAYSTRINGPROC lpOutputFunc, // pointer to the callback function
LPARAM lpData, // pointer to application-defined data
int nCount, // number of characters to output
int X, // horizontal position
int Y, // vertical position
int nWidth, // width
int nHeight // height
);


Parameters

hDC

Identifies the device context.

hBrush

Identifies the brush to be used for graying. If this parameter is NULL, the text is grayed with the same brush that was used to draw window text.

lpOutputFunc

Points to the application-defined function that will draw the string, or, if TextOut is to be used to draw the string, it is a NULL pointer. For details, see the OutputProc callback function.

lpData

Specifies a pointer to data to be passed to the output function. If the lpOutputFunc parameter is NULL, lpData must be a pointer to the string to be output.

nCount

Specifies the number of characters to be output. If the nCount parameter is zero, GrayString calculates the length of the string (assuming lpData is a pointer to the string). If nCount is -1 and the function pointed to by lpOutputFunc returns FALSE, the image is shown but not grayed.

X

Specifies the device x-coordinate of the starting position of the rectangle that encloses the string.

Y

Specifies the device y-coordinate of the starting position of the rectangle that encloses the string.

nWidth

Specifies the width, in device units, of the rectangle that encloses the string. If this parameter is zero, GrayString calculates the width of the area, assuming lpData is a pointer to the string.

nHeight

Specifies the height, in device units, of the rectangle that encloses the string. If this parameter is zero, GrayString calculates the height of the area, assuming lpData is a pointer to the string.



Return Values

If the string is drawn, the return value is nonzero.
If either the TextOut function or the application-defined output function returned zero, or there was insufficient memory to create a memory bitmap for graying, the return value is zero.

Remarks

Without calling GrayString, an application can draw grayed strings on devices that support a solid gray color. The system color COLOR_GRAYTEXT is the solid-gray system color used to draw disabled text. The application can call the GetSysColor function to retrieve the color value of COLOR_GRAYTEXT. If the color is other than zero (black), the application can call the SetTextColor function to set the text color to the color value and then draw the string directly. If the retrieved color is black, the application must call GrayString to gray the text.

See Also

DrawText, GetSysColor, OutputProc, SetTextColor, TabbedTextOut, TextOut


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GrayString



Функция GrayString делает серым текстом в определенной позиции. Функция делает текстом копируя это в побитовое отображение памяти, graying побитовое отображение, и затем копируя побитовое отображение на экран. Функциональный серый текст независимо от выбранной щетки и фона. GrayString ИСПОЛЬЗУЕТ шрифт к настоящему времени выбранный для определенного контекста устройства.

Если параметр lpOutputFunc НЕДЕЙСТВИТЕЛЕН, GDI использует функцию TextOut, и параметр lpData принят, чтобы быть указателем в символьной строке, чтобы - выходным. Если символы, чтобы быть выходом не мочь быть прооперировано TextOut (например, строка сохранена как побитовое отображение), приложение должно поставить своему собственному выходу функцию.

BOOL GrayString(

HDC hDC, // РУЧКА в контекст устройства HBRUSH hBrush, // ручка в щетку для graying GRAYSTRINGPROC lpOutputFunc, // указателя в функцию возврата LPARAM lpData, // указателя в определенные прикладные данные int nCount, // количество символов на выход int X, // горизонтальная позиция int Y, // вертикальная позиция int nWidth, // ширина высоты int nHeight //
);


Параметры

hDC

Идентифицирует контекст устройства.

hBrush

Идентифицирует щетку, которая нужно использоваться для graying. Если этот параметр НЕДЕЙСТВИТЕЛЕН, текст - grayed с той же щеткой, которая была использована, чтобы делать текстом окна.

lpOutputFunc

Точки на определенную прикладную функцию, что сделает строкой, или, если TextOut должен быть использован, чтобы делать строкой, это - НЕДЕЙСТВИТЕЛЬНЫЙ указатель. Относительно деталей, смотри функцию возврата OutputProc.

lpData

Определяет указатель в данные, которые нужно проходить в выходную функцию. Если параметр lpOutputFunc НЕДЕЙСТВИТЕЛЕН, lpData должен быть указателем в строке, чтобы - выходным.

nCount

Определяет количество символов, чтобы - выходным. Если параметр nCount является нулем, GrayString вычисляет длину строки (предположим, lpData - указатель в строке). Если nCount - -1 и функция указывалась, чтобы ЛОЖЬЮ возврата lpOutputFunc, образ показан но не grayed.

X

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

Y

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

nWidth

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

nHeight

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



Обратные Величины

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

Замечания

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

Смотри Также

DrawText, GetSysColor, OutputProc, SetTextColor, TabbedTextOut, TextOut


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz