Funzione GrayStringA (winuser.h)

Articolo
08/27/2023

La funzione GrayString disegna testo grigio nella posizione specificata. La funzione disegna il testo copiandolo in una bitmap di memoria, grigio la bitmap e quindi copiando la bitmap sullo schermo. La funzione grigio il testo indipendentemente dal pennello e dallo sfondo selezionato. GrayString usa il tipo di carattere attualmente selezionato per il contesto del dispositivo specificato.

Se illpOutputFuncparameter è NULL, GDI usa la funzione TextOut e illpDataparameter deve essere un puntatore alla stringa di caratteri da restituire. Se i caratteri da restituire non possono essere gestiti da TextOut (ad esempio, la stringa viene archiviata come bitmap), l'applicazione deve fornire la propria funzione di output.

Sintassi

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
);

Parametri

[in] hDC

Handle nel contesto del dispositivo.

[in] hBrush

Handle per il pennello da usare per l'grigio. Se questo parametro è NULL, il testo viene grigio con lo stesso pennello usato per disegnare il testo della finestra.

[in] lpOutputFunc

Puntatore alla funzione definita dall'applicazione che disegna la stringa oppure, se TextOut deve essere usato per disegnare la stringa, è un puntatore NULL . Per informazioni dettagliate, vedere la funzione di callback OutputProc .

[in] lpData

Puntatore ai dati da passare alla funzione di output. Se il parametro lpOutputFunc è NULL, lpData deve essere un puntatore alla stringa da restituire.

[in] nCount

Numero di caratteri da restituire. Se il parametro nCount è zero, GrayString calcola la lunghezza della stringa (presupponendo che lpData sia un puntatore alla stringa). Se nCount è 1 e la funzione puntata da lpOutputFunc restituisce FALSE, l'immagine viene visualizzata ma non disattivata.

[in] X

Coordinata x del dispositivo della posizione iniziale del rettangolo che racchiude la stringa.

[in] Y

Coordinata y del dispositivo della posizione iniziale del rettangolo che racchiude la stringa.

[in] nWidth

Larghezza, in unità dispositivo, del rettangolo che racchiude la stringa. Se questo parametro è zero, GrayString calcola la larghezza dell'area, presupponendo che lpData sia un puntatore alla stringa.

[in] nHeight

Altezza, in unità dispositivo, del rettangolo che racchiude la stringa. Se questo parametro è zero, GrayString calcola l'altezza dell'area, presupponendo che lpData sia un puntatore alla stringa.

Valore restituito

Se la stringa viene disegnata, il valore restituito è diverso da zero.

Se la funzione TextOut o la funzione di output definita dall'applicazione ha restituito zero oppure è presente memoria insufficiente per creare una bitmap di memoria per il grigio, il valore restituito è zero.

Commenti

Senza chiamare GrayString, un'applicazione può disegnare stringhe grigie nei dispositivi che supportano un colore grigio a tinta unita. Il colore di sistema COLOR_GRAYTEXT è il colore del sistema a tinta unita usata per disegnare testo disabilitato. L'applicazione può chiamare la funzione GetSysColor per recuperare il valore del colore di COLOR_GRAYTEXT. Se il colore è diverso da zero (nero), l'applicazione può chiamare la funzione SetTextColor per impostare il colore di testo sul valore del colore e quindi disegnare direttamente la stringa. Se il colore recuperato è nero, l'applicazione deve chiamare GrayString in grigio il testo.

Nota

L'intestazione winuser.h definisce GrayString come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll