CDC::GrayString
Draws è inattivo (grigio) il testo nella posizione specificata scrive il testo in una bitmap di memoria, attenuando la bitmap e quindi copiando la bitmap alla visualizzazione.
virtual BOOL GrayString(
CBrush* pBrush,
BOOL ( CALLBACK* lpfnOutput )( HDC, LPARAM, int ),
LPARAM lpData,
int nCount,
int x,
int y,
int nWidth,
int nHeight
);
Parametri
pBrush
Identifica il pennello da utilizzare per l'attenuazione (ingrigire).lpfnOutput
Specificare l'indirizzo di routine- istanza della funzione di callback applicazione fornita che disegnerà la stringa.Per ulteriori informazioni, vedere la descrizione di Windows OutputFunc funzione di callback.Se questo parametro è NULL, il sistema utilizza la funzione di Windows TextOut per disegnare la stringa e lpData sia un puntatore lungo la stringa di caratteri da restituire.lpData
Specifica un puntatore lontano ai dati da passare alla funzione di output.Se lpfnOutput è NULL, lpData deve essere un puntatore lungo la stringa da restituire.nCount
Specifica il numero di caratteri da restituire.Se questo parametro è 0, GrayString calcola la lunghezza della stringa (presupponendo che lpData è un puntatore alla stringa.Se nCount è a 1 e la funzione indicata da lpfnOutput restituiscono 0, l'immagine vengono visualizzati ma non sono attenuati.x
Specifica la coordinata x logica della posizione iniziale del rettangolo che contiene la stringa.y
Specifica la coordinata y logica della posizione iniziale del rettangolo che contiene la stringa.nWidth
Specifica la larghezza (in unità logiche) rettangolo che contiene la stringa.Se nWidth è 0, GrayString calcola la larghezza dell'area, presupponendo lpData è un puntatore alla stringa.nHeight
Specifica l'altezza (in unità logiche) rettangolo che contiene la stringa.Se nHeight è 0, GrayString calcola l'altezza dell'area, presupponendo lpData è un puntatore alla stringa.
Valore restituito
Diverso da zero se la stringa viene disegnata, oppure 0 se la funzione TextOut o la funzione di output applicazione fornita restituisce 0, o se fosse memoria insufficiente per creare una bitmap di memoria per un'attenuazione.
Note
La funzione per attenuare il testo indipendentemente dal pennello e dai precedenti selezionati.La funzione membro GrayString utilizza il tipo attualmente selezionata.La modalità di mapping MM_TEXT è necessario selezionare prima di utilizzare questa funzione.
Un'applicazione può creazione di stringhe (grigio) in grigio in dispositivi che supportano un oggetto a tinta unita ingrigiscono il colore senza chiamare la funzione membro GrayString.Il colore di sistema COLOR_GRAYTEXT è il colore di sistema solido- viene utilizzato per disegnare gli handicappati il testo.L'applicazione può chiamare la funzione Windows GetSysColor per recuperare il valore del colore COLOR_GRAYTEXT.Se il colore è diverso da 0 (il nero), l'applicazione può chiamare la funzione membro SetTextColor per impostare il colore del testo al valore di colore e quindi per disegnare direttamente la stringa.Se il colore recuperato è nero, l'applicazione deve chiamare GrayString per limitare (ingrigire) il testo.
Se lpfnOutput è NULL, GDI utilizza la funzione di Windows TextOut e lpData sia un puntatore lontano il carattere da restituire.Se i caratteri da restituire non possono essere gestiti dalla funzione membro TextOut (ad esempio, la stringa viene memorizzata come bitmap), l'applicazione deve fornire la propria funzione di output.
Si noti inoltre che tutte le funzioni di callback devono intercettare le eccezioni (Microsoft Foundation class) prima di restituire a Windows, poiché le eccezioni non possono essere generate oltre i limiti di callback.Per ulteriori informazioni sulle eccezioni, vedere l'articolo Eccezioni.
La funzione di callback passata a GrayString deve utilizzare la convenzione di chiamata __stdcall e deve essere esportato con __declspec.
Quando il framework è in modalità di anteprima, una chiamata alla funzione membro GrayString viene convertito in una chiamata TextOut e la funzione di callback non viene chiamata.
Requisiti
Header: afxwin.h