CDC::GrayString

Artikel
02/26/2013

Draws blendete (Ausblenden) ab, Text am angegebenen Speicherort ab, indem der Text in einer Speicherbitmap geschrieben hat abblendete, die Bitmap, und dann die Bitmap zur Anzeige kopierte.

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

Parameter

pBrush
Identifiziert den für das Abblenden (Abblenden) verwendet werden, Pinsel.
lpfnOutput
Gibt die ProzedurInstanz Adresse der von der Anwendung bereitgestellten Rückruffunktion an, die die Zeichenfolge werden.Weitere Informationen finden Sie in der Beschreibung Windows OutputFunc Rückruffunktion.Wenn dieser Parameter NULL ist, verwendet das System die Funktion Windows TextOut, um die Zeichenfolge zu zeichnen, und lpData wird davon ausgegangen, dass ein langer Zeiger auf die ausgegeben werden Zeichenfolge zu, sein.
lpData
Gibt einen weiten Zeiger auf auf der Ausgabefunktion übergeben werden Daten.Wenn lpfnOutputNULL ist, muss lpData ein langer Zeiger auf die Zeichenfolge ausgegeben werden, sein.
nCount
Gibt die Anzahl der ausgegeben werden, Zeichen an.Wenn dieser Parameter 0 ist, berechnet GrayString die Länge der Zeichenfolge (vorausgesetzt, dass lpData ein Zeiger auf die Zeichenfolge ist).Wenn nCount ist - 1 und die Funktion, die auf durch lpfnOutput gezeigt wird, gibt 0 zurück, das Bild wird jedoch nicht abgeblendet angezeigt.
x
Gibt die logische x-Koordinate der Startposition des Rechtecks an, das die Zeichenfolge enthält.
y
Gibt die logische y-Koordinate der Startposition des Rechtecks an, das die Zeichenfolge enthält.
nWidth
Gibt die Breite (in logischen Einheiten) des Rechtecks an, das die Zeichenfolge enthält.Wenn nWidth 0 ist, berechnet GrayString die Breite des Bereichs wird angenommen, dass lpData ein Zeiger auf die Zeichenfolge ist.
nHeight
Gibt die Höhe (in logischen Einheiten) des Rechtecks an, das die Zeichenfolge enthält.Wenn nHeight 0 ist, berechnet GrayString die Höhe des Bereichs wird angenommen, dass lpData ein Zeiger auf die Zeichenfolge ist.

Rückgabewert

Ungleich 0 (null), wenn die Zeichenfolge gezeichnet wird oder 0, wenn entweder die TextOut-Funktion oder die von der Anwendung bereitgestellte Ausgabefunktion 0 zurückgaben oder wenn nicht genügend Arbeitsspeicher hat, um eine Speicherbitmaps für das Abblenden zu erstellen.

Hinweise

Die Funktion blendet den Text unabhängig vom ausgewählten Pinsel und den Hintergrund ab.Die GrayString-Memberfunktion verwendet die aktuell ausgewählte Schriftart.Vor der Verwendung dieser Funktion der MM_TEXT Zuordnungsmodus muss ausgewählt werden.

Eine Anwendung kann abgeblendete (abgeblendete) Zeichenfolgen auf Geräten zeichnen, die eine Körpergraufarbe unterstützen, ohne die GrayString-Memberfunktion aufzurufen.Die Systemfarbe COLOR_GRAYTEXT ist die Körpergrau Systemfarbe, die verwendet wird, um deaktiviertem zu zeichnen, Text.Die Anwendung kann die GetSysColor Windows-Funktion aufrufen, um den Farbwert aus COLOR_GRAYTEXT abzurufen.Wenn die Farbe auf 0 (schwarz) ist, kann die Anwendung die SetTextColor-Memberfunktion aufrufen, um die Textfarbe auf den Farbwert festzulegen und die Zeichenfolge dann direkt zu zeichnen.Wenn die abgerufene Farbe schwarz ist, muss die Anwendung aufrufen, um GrayString (grau) den Text abzublenden.

Wenn lpfnOutputNULL ist, verwendet die Funktion GDI Windows TextOut, und lpData wird davon ausgegangen, dass ein weiter Zeiger auf ausgegeben werden Zeichen zu, sein.Wenn die ausgegeben werden Zeichen nicht durch die TextOut-Memberfunktion behandelt werden können (beispielsweise, wird die Zeichenfolge als Bitmap gespeichert), muss die Anwendung über eine eigene Ausgabefunktion bereitstellen.

Beachten Sie auch, dass alle Rückruffunktionen Microsoft Foundations-Ausnahmen Felder müssen, bevor sie in Windows zurückgeben, da Ausnahmen nicht über Rückrufgrenzen ausgelöst werden können.Weitere Informationen zu Ausnahmen, finden Sie im Artikel Ausnahmen.

Die Rückruffunktion, die zu GrayString übergeben wird, muss die __stdcall Aufrufkonvention verwenden und muss mit __declspec exportiert werden.

Wenn das Framework in der Seitenansicht ist, wird die GrayString-Memberfunktion zu einem TextOut Aufruf übersetzt, und die Rückruffunktion wird nicht aufgerufen.