CDC::GrayStri&ngnbsp;

virtualBOOLGrayString (CBrush *pBrush,BOOL()llamadaexportación *lpfnOutput) (HDC,LPARAM,int),LPARAMlpData,intnCount,intx,inty,nWidth,intintnHeight);

Valor devuelto

Distinto de cero si la cadena se dibuja o 0 si la función TextOut o la función de salida suministrada de aplicación devuelve 0, o si hay suficiente memoria para crear un mapa de bits de memoria para la atenuación.

Parámetros

pBrush

Identifica el pincel que se utilizará para la atenuación (envejecimiento).

lpfnOutput

Especifica la dirección de procedimiento-instancia de la función de aplicación suministrado callback que sacará la cadena. Para obtener más información, consulte la descripción de lafunción callbackde Windows OutputFunc. Si este parámetro es NULL, el sistema utiliza la función Windows TextOut para dibujar la cadena y lpData se supone que es un puntero a la cadena de caracteres que salida largo .

lpData

Especifica un extremo puntero a los datos que se pasan a la función de salida. Si lpfnOutput es NULL, lpData debe ser un puntero a la cadena ser salida largo.

nCount

Especifica el número de caracteres que salida. Si este parámetro es 0, GrayString calcula la longitud de la cadena (suponiendo lpData es un puntero a la cadena). Si nCount es-1 y la función apuntada por lpfnOutput devuelve 0, la imagen se muestra pero no atenuada.

x

Especifica la coordenada x lógica de la posición inicial del rectángulo que encierra la cadena.

y

Especifica la coordenada y lógica de la posición inicial del rectángulo que encierra la cadena.

nWidth

Especifica el ancho (en unidades lógicas) del rectángulo que encierra la cadena. Si nWidth es 0, GrayString calcula el ancho de la zona, suponiendo que lpData es un puntero a la cadena.

nHeight

Especifica la altura (en unidades lógicas) del rectángulo que encierra la cadena. Si nHeight es 0, GrayString calcula la altura de la zona, suponiendo que lpData es un puntero a la cadena.

Observaciones

Dibuja atenuada (gris) texto en una ubicación determinada por escribir el texto en un mapa de bits de memoria, oscurecimiento del mapa de bits y, a continuación, copia el mapa de bits a la pantalla. La función atenúa el texto independientemente del pincel seleccionada y fondo. La función de miembro de GrayString utiliza la fuente actualmente seleccionada. El modo de asignación de MM_TEXT debe ser seleccionado antes de utilizar esta función.

Una aplicación puede dibujar cadenas (atenuadas) atenuadas en los dispositivos que admiten un color gris sólido sin llamar a la función miembro GrayString . El color del sistema COLOR_GRAYTEXT es el color gris sólido sistema utilizado para dibujar texto deshabilitado. La aplicación puede llamar a la función de Windows GetSysColor 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 de miembro de SetTextColor para establecer el color del texto en el valor de color y, a continuación, dibuje la cadena directamente. Si el color recuperado es negro, la aplicación debe llamar a GrayString al dim (gris) el texto.

Si lpfnOutput es NULL, GDI utiliza las ventanas función TextOut y lpData se supone que un puntero lejos del personaje que salida. Si los caracteres que la salida no pueden ser manipulados por la función de miembro TextOut (por ejemplo, la cadena se almacena como un mapa de bits), la aplicación debe proporcionar su propia función de salida.

También tenga en cuenta que todas las funciones de devolución de llamada deben atrapar excepciones de Microsoft Foundation antes de regresar a Windows, ya que no se producen excepciones a través de límites de devolución de llamada. Para obtener más información sobre las excepciones, consulte el artículo excepciones en la Guía del programador de Visual C++.

La función de devolución de llamada pasada al GrayString debe utilizar __stdcall Convención de llamada y debe exportarse con __declspec.

Cuando el marco está en modo de vista previa, una llamada a la función de miembro de GrayString se traduce a una llamada TextOut y la devolución de llamada no se llama la función.

Visió&n General de CDC |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp; :: GetSysColor, CDC::SetTextColor, CDC::TextOut, :: GrayString

Index