GrayStringA-Funktion (winuser.h)

Artikel
08/27/2023

Die GrayString-Funktion zeichnet grauen Text an der angegebenen Position. Die Funktion zeichnet den Text, indem sie ihn in eine Speicherbitbitte kopiert, die Bitmap graut und dann die Bitmap auf den Bildschirm kopiert. Die Funktion graut den Text unabhängig vom ausgewählten Pinsel und Hintergrund ab. GrayString verwendet die Schriftart, die derzeit für den angegebenen Gerätekontext ausgewählt ist.

Wenn der parameterlpOutputFuncc NULL ist, verwendet GDI die TextOut-Funktion , und thelpDataparameter wird als Zeiger auf die ausgabede Zeichenfolge angenommen. Wenn die auszugebenden Zeichen nicht von TextOut verarbeitet 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 abgeblendet, der zum Zeichnen von Fenstertext verwendet wurde.

[in] lpOutputFunc

Ein Zeiger auf die anwendungsdefinierte Funktion, die die Zeichenfolge zeichnet. Wenn TextOut zum Zeichnen der Zeichenfolge verwendet werden soll, handelt es sich um einen NULL-Zeiger . Weitere Informationen finden Sie in der Callbackfunktion OutputProc .

[in] lpData

Ein Zeiger auf Daten, die an die Ausgabefunktion übergeben werden sollen. Wenn der lpOutputFunc-ParameterNULL ist, muss lpData ein Zeiger auf die ausgabede Zeichenfolge sein.

[in] nCount

Die Anzahl der auszugebenden Zeichen. Wenn der nCount-Parameter null ist, berechnet GrayString die Länge der Zeichenfolge (vorausgesetzt , dass lpData ein Zeiger auf die Zeichenfolge ist). Wenn nCount 1 ist und die Funktion, auf die von lpOutputFunc verwiesen wird, 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 umschließt.

[in] Y

Die y-Koordinate des Geräts der Startposition des Rechtecks, das die Zeichenfolge umschließt.

[in] nWidth

Die Breite des Rechtecks, das die Zeichenfolge umschließt, in Geräteeinheiten. Wenn dieser Parameter null ist, berechnet GrayString die Breite des Bereichs, vorausgesetzt , dass lpData ein Zeiger auf die Zeichenfolge ist.

[in] nHeight

Die Höhe des Rechtecks, das die Zeichenfolge umschließt, in Geräteeinheiten. Wenn dieser Parameter null ist, berechnet GrayString die Höhe des Bereichs, vorausgesetzt , dass 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 0 (null) zurückgegeben hat oder nicht genügend Arbeitsspeicher vorhanden ist, um eine Speicherbitbitte für das Grauen zu erstellen, ist der Rückgabewert null.

Hinweise

Ohne Den Aufruf von GrayString kann eine Anwendung graue Zeichenfolgen auf Geräten zeichnen, die eine einfarbige graue Farbe unterstützen. Die Systemfarbe COLOR_GRAYTEXT ist die einfarbige graue Systemfarbe, die zum Zeichnen von deaktiviertem Text verwendet wird. Die Anwendung kann die GetSysColor-Funktion aufrufen, um den Farbwert von COLOR_GRAYTEXT abzurufen. Wenn die Farbe nicht 0 (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 ergrauen.

Hinweis

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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll