CDC::GrayString
Texto atenuado de dibuja (atenúe) en la ubicación especificada escribiendo el texto en un mapa de bits de memoria, amortiguando el mapa de bits y, a continuación copiando el mapa de bits en la pantalla.
virtual BOOL GrayString(
CBrush* pBrush,
BOOL ( CALLBACK* lpfnOutput )( HDC, LPARAM, int ),
LPARAM lpData,
int nCount,
int x,
int y,
int nWidth,
int nHeight
);
Parámetros
pBrush
Identifica el pincel que se utilizará para amortiguar (el gris).lpfnOutput
Especifica la dirección de la procedimiento-instancia de la función de devolución de llamada aplicación-proporcionada que dibujará la cadena.Para obtener más información, vea la descripción de Windows OutputFunc función de devolución de llamada.Si este parámetro es NULL, el sistema utiliza la función de Windows TextOut para dibujar la cadena, y lpData se asume que puntero largo en la cadena de caracteres que se generará.lpData
Especifica un puntero lejano a los datos que se van a pasar a la función de salida.Si lpfnOutput es NULL, lpData debe ser un puntero largo a la cadena que se generará.nCount
especifica el número de caracteres que se generará.Si este parámetro es 0, GrayString calcula la longitud de cadena (suponiendo que lpData es un puntero a la cadena).Si es nCount – se muestra 1 y la función designada por a lpfnOutput devuelve 0, la imagen pero no atenuado.x
Especifica la coordenada x lógica de la posición inicial del rectángulo que agrega la cadena.y
Especifica la coordenada y lógica de la posición inicial del rectángulo que agrega la cadena.nWidth
Especifica el ancho (en unidades lógicas) del rectángulo que agrega la cadena.Si nWidth es 0, GrayString calcula el ancho del área, suponiendo que lpData es un puntero a la cadena.nHeight
Especifica el alto (en unidades lógicas) del rectángulo que agrega la cadena.Si nHeight es 0, GrayString calcula el alto del área, suponiendo que lpData es un puntero a la cadena.
Valor devuelto
Distinto de cero si se dibuja la cadena, o 0 si la función de TextOut o la función aplicación-proporcionada de salida devuelve 0, o si hay memoria suficiente para crear un mapa de bits de memoria para amortiguar.
Comentarios
La función atenuado texto sin importar el pincel y el fondo seleccionado.La función miembro de GrayString utiliza la fuente seleccionado actualmente.MM_TEXT que asigna el modo debería seleccionar antes de utilizar esta función.
Una aplicación puede dibujar las cadenas (atenuadas) atenuadas en dispositivos que admiten un color gris sólido sin llamar a la función miembro de GrayString .El color del sistema COLOR_GRAYTEXT es el color del sistema de sólido-gris utilizado el texto disabled draw.La aplicación puede llamar a la función de GetSysColor Windows para recuperar el valor de color de COLOR_GRAYTEXT.Si el color es distinto de 0 (negro), la aplicación puede llamar a la función miembro de SetTextColor para establecer el color de texto al valor de color y después para dibujar la cadena directamente.Si el color recuperado es negro, la aplicación debe llamar a GrayString para amortiguar (gris) el texto.
Si lpfnOutput es NULL, GDI utiliza la función de Windows TextOut , y lpData se asume que puntero lejano al carácter que se generará.Si los caracteres que se generen no se pueden controlar mediante la función miembro de TextOut (por ejemplo, la cadena se almacena como un mapa de bits), la aplicación debe proporcionar su propia función de salida.
Observe también que todas las funciones de devolución de llamada deben las excepciones de la Microsoft foundation class catch antes de volver a Windows, dado que las excepciones no se pueden producir entre límites de devolución de llamada.Para obtener más información sobre excepciones, vea el artículo excepciones.
La función de devolución de llamada pasada a GrayString debe utilizar la convención de llamada de __stdcall y se con __declspec.
Cuando el marco está en modo de vista previa, una llamada a la función miembro de GrayString se convierte en una llamada de TextOut , y la función de devolución de llamada no se denomina.
Requisitos
encabezado: afxwin.h