GrayStringA-Funktion (winuser.h)
Die GrayString--Funktion zeichnet grauen Text an der angegebenen Position. Die Funktion zeichnet den Text, indem er in eine Speicherbitmap kopiert wird, die Bitmap graut und dann die Bitmap auf den Bildschirm kopiert. Die Funktion graut den Text unabhängig vom ausgewählten Pinsel und Hintergrund. GrayString- verwendet die aktuell für den angegebenen Gerätekontext ausgewählte Schriftart.
Wenn der parameterlpOutputFunc NULList, verwendet GDI die TextOut--Funktion, und thelpDataparameter wird als Zeiger auf die auszuzugebende Zeichenzeichenfolge angenommen. Wenn die auszuzugebenden Zeichen nicht von TextOut- behandelt werden können (z. B. wird die Zeichenfolge als Bitmap gespeichert), muss die Anwendung eine eigene Ausgabefunktion bereitstellen.
Syntax
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
);
Parameter
[in] hDC
Ein Handle für den Gerätekontext.
[in] hBrush
Ein Ziehpunkt für den Pinsel, der zum Grauen verwendet werden soll. Wenn dieser Parameter NULL-ist, wird der Text mit demselben Pinsel grau dargestellt, der zum Zeichnen von Fenstertext verwendet wurde.
[in] lpOutputFunc
Ein Zeiger auf die anwendungsdefinierte Funktion, die die Zeichenfolge zeichnet, oder wenn TextOut- zum Zeichnen der Zeichenfolge verwendet werden soll, handelt es sich um einen NULL- Zeiger. Ausführliche Informationen finden Sie in der OutputProc- Rückruffunktion.
[in] lpData
Ein Zeiger auf Daten, die an die Ausgabefunktion übergeben werden sollen. Wenn der lpOutputFunc Parameter NULL-ist, muss lpData- ein Zeiger auf die Zeichenfolge sein, die ausgegeben werden soll.
[in] nCount
Die Anzahl der auszuzugebenden Zeichen. Wenn der nCount-Parameter null ist, berechnet GrayString die Länge der Zeichenfolge (vorausgesetzt, lpData- ist ein Zeiger auf die Zeichenfolge). Wenn nCount 1 ist und die Funktion, auf die durch lpOutputFunc verweist, FALSE-zurückgibt, wird das Bild angezeigt, aber nicht abgeblendet.
[in] X
Die x-Koordinate des Geräts der Startposition des Rechtecks, das die Zeichenfolge einschließt.
[in] Y
Die Gerätekoordinate der Startposition des Rechtecks, das die Zeichenfolge einschließt.
[in] nWidth
Die Breite des Rechtecks, das die Zeichenfolge einschließt, in Geräteeinheiten. Wenn dieser Parameter null ist, berechnet GrayString die Breite des Bereichs, vorausgesetzt, lpData- ist ein Zeiger auf die Zeichenfolge.
[in] nHeight
Die Höhe des Rechtecks in Geräteeinheiten, das die Zeichenfolge einschließt. Wenn dieser Parameter null ist, berechnet GrayString die Höhe des Bereichs, vorausgesetzt, lpData- ein Zeiger auf die Zeichenfolge ist.
Rückgabewert
Wenn die Zeichenfolge gezeichnet wird, ist der Rückgabewert ungleich Null.
Wenn entweder die TextOut--Funktion oder die anwendungsdefinierte Ausgabefunktion Null zurückgegeben hat oder nicht genügend Arbeitsspeicher zum Erstellen einer Speicherbitmap zum Grauen vorhanden war, ist der Rückgabewert Null.
Bemerkungen
Ohne aufrufen GrayString-kann eine Anwendung graue Zeichenfolgen auf Geräten zeichnen, die eine Volltongraufarbe unterstützen. Die Systemfarbe COLOR_GRAYTEXT ist die Volltongrau-Systemfarbe, die zum Zeichnen von deaktiviertem Text verwendet wird. Die Anwendung kann die GetSysColor--Funktion aufrufen, um den Farbwert COLOR_GRAYTEXT abzurufen. Wenn die Farbe nicht null (schwarz) ist, kann die Anwendung die SetTextColor--Funktion aufrufen, um die Textfarbe auf den Farbwert festzulegen und dann die Zeichenfolge direkt zu zeichnen. Wenn die abgerufene Farbe schwarz ist, muss die Anwendung GrayString- aufrufen, um den Text zu grauen.
Anmerkung
Der winuser.h-Header definiert GrayString als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winuser.h (enthalten Windows.h) |
| Library | User32.lib |
| DLL- | User32.dll |