Función GrayStringA (winuser.h)
La función GrayString dibuja texto gris en la ubicación especificada. La función dibuja el texto copiandolo en un mapa de bits de memoria, atenuando el mapa de bits y, a continuación, copiando el mapa de bits en la pantalla. La función grisiza el texto independientemente del pincel y el fondo seleccionados. GrayString usa la fuente seleccionada actualmente para el contexto de dispositivo especificado.
Si thelpOutputFuncparameter es NULL, GDI usa la función TextOut y se supone que el parámetrolpDataparameter es un puntero a la cadena de caracteres que se va a generar. Si los caracteres que se van a generar no se pueden controlar mediante TextOut (por ejemplo, la cadena se almacena como un mapa de bits), la aplicación debe proporcionar su propia función de salida.
Sintaxis
BOOL GrayStringA(
[in] HDC hDC,
[in] HBRUSH hBrush,
[in] GRAYSTRINGPROC lpOutputFunc,
[in] LPARAM lpData,
[in] int nCount,
[in] int X,
[in] int Y,
[in] int nWidth,
[in] int nHeight
);
Parámetros
[in] hDC
Identificador del contexto del dispositivo.
[in] hBrush
Identificador del pincel que se va a usar para atenuar. Si este parámetro es NULL, el texto está atenuado con el mismo pincel que se usó para dibujar texto de la ventana.
[in] lpOutputFunc
Puntero a la función definida por la aplicación que dibujará la cadena o, si TextOut se va a usar para dibujar la cadena, es un puntero NULL. Para obtener más información, consulte la función de devolución de llamada OutputProc.
[in] lpData
Puntero a los datos que se van a pasar a la función de salida. Si el parámetro lpOutputFunc
[in] nCount
Número de caracteres que se van a generar. Si el parámetro
[in] X
Coordenada x del dispositivo de la posición inicial del rectángulo que incluye la cadena.
[in] Y
Coordenada y del dispositivo de la posición inicial del rectángulo que incluye la cadena.
[in] nWidth
Ancho, en unidades de dispositivo, del rectángulo que incluye la cadena. Si este parámetro es cero, GrayString calcula el ancho del área, suponiendo que lpData es un puntero a la cadena.
[in] nHeight
Alto, en unidades de dispositivo, del rectángulo que incluye la cadena. Si este parámetro es cero, GrayString calcula el alto del área, suponiendo que lpData es un puntero a la cadena.
Valor devuelto
Si se dibuja la cadena, el valor devuelto es distinto de cero.
Si la función TextOut o la función de salida definida por la aplicación devolvieron cero, o si no había memoria suficiente para crear un mapa de bits de memoria para atenuar, el valor devuelto es cero.
Observaciones
Sin llamar a GrayString, una aplicación puede dibujar cadenas atenuadas en dispositivos que admiten un color gris sólido. El color del sistema COLOR_GRAYTEXT es el color del sistema de gris sólido que se usa para dibujar texto deshabilitado. La aplicación puede llamar a la función getSysColor de
Nota
El encabezado winuser.h define GrayString como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winuser.h (incluya Windows.h) |
| biblioteca de |
User32.lib |
| DLL de |
User32.dll |
Consulte también
tabbedTextOut de