Funzione GrayStringA (winuser.h)

Articolo
11/20/2024

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

Se thelpOutputFuncparameter è NULL, GDI usa la funzione TextOut e si presuppone che il parametrolpDataparameter sia 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 per il contesto del dispositivo.

[in] hBrush

Handle per il pennello da utilizzare per la visualizzazione in grigio. Se questo parametro è NULL, il testo viene disattivato con lo stesso pennello utilizzato per disegnare il testo della finestra.

[in] lpOutputFunc

Puntatore alla funzione definita dall'applicazione che disegnare la stringa oppure, se TextOut deve essere utilizzato per disegnare la stringa, si tratta di 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 a cui punta 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 del dispositivo y della posizione iniziale del rettangolo che racchiude la stringa.

[in] nWidth

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

[in] nHeight

Altezza, in unità di 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 se la memoria non è sufficiente per creare una bitmap di memoria per la visualizzazione in grigio, il valore restituito è zero.

Osservazioni

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 di sistema a tinta unita utilizzato per disegnare testo disabilitato. L'applicazione può chiamare la funzione GetSysColor per recuperare il valore di colore di COLOR_GRAYTEXT. Se il colore è diverso da zero (nero), l'applicazione può chiamare la funzione SetTextColor per impostare il colore del 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 indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll