CDC::GrayString

Artykuł
02/27/2013

Rysuje wygaszone (szare) tekstu w danej lokalizacji pisania tekstu w bitmapy w pamięci, Zaciemnienie bitmapy, a następnie kopiując bitmapy do wyświetlania.

virtual BOOL GrayString(
   CBrush* pBrush,
   BOOL ( CALLBACK* lpfnOutput )( HDC, LPARAM, int ),
   LPARAM lpData,
   int nCount,
   int x,
   int y,
   int nWidth,
   int nHeight
);

Parametry

pBrush
Identyfikuje pędzla służące przygasania (graying).
lpfnOutput
Określa adres procedury instancji funkcji zwrotnej dostarczonych przez aplikację, która będzie rysować ciąg.Aby uzyskać więcej informacji, zobacz opis systemu Windows OutputFunc funkcji wywołania zwrotnego.Jeśli ten parametr jest NULL, system używa systemu Windows TextOut funkcji do narysowania, i lpData zakłada się wskaźnik długa wyprowadzenie ciąg znaków.
lpData
Określa wskaźnik far dane przekazywane do funkcji danych wyjściowych.Jeśli lpfnOutput jest NULL, lpData musi być długie wskaźnik do ciągu wyprowadzenie.
nCount
Określa liczbę znaków wyprowadzenie.Jeśli ten parametr ma wartość 0, GrayString oblicza długość ciągu (przy założeniu, że lpData jest wskaźnik do ciągu).Jeśli nCount jest –1 i funkcja wskazywanej przez lpfnOutput zwraca wartość 0, obraz jest wyświetlany, ale nie wygaszone.
x
Określa logiczną x współrzędnych pozycji początkowej prostokąt ograniczający ciąg.
y
Określa logiczną y współrzędnych pozycji początkowej prostokąt ograniczający ciąg.
nWidth
Określa szerokość prostokąt ograniczający ciąg (w jednostkach logicznych).Jeśli nWidth jest 0, GrayString oblicza szerokość obszaru, przy założeniu lpData jest wskaźnik do ciągu.
nHeight
Określa wysokość prostokąt ograniczający ciąg (w jednostkach logicznych).Jeśli nHeight jest 0, GrayString oblicza wysokość obszaru, przy założeniu lpData jest wskaźnik do ciągu.

Wartość zwracana

Niezerowa, jeśli ciąg jest rysowane, lub 0, jeżeli albo TextOut funkcji lub funkcji dostarczonych aplikacji dane wyjściowe zwracane 0, lub za mało pamięci, aby utworzyć mapę bitową pamięć dla przyciemnianie.

Uwagi

Funkcja przyciemnia tekstu niezależnie od pędzla i tła.GrayString Członkowskich funkcja używa obecnie wybranej czcionki.MM_TEXT Przed użyciem tej funkcji należy wybrać tryb mapowania.

Aplikację można rysować wygaszone ciągi (wygaszone) na urządzeniach obsługujących pełny kolor szary bez wywołania GrayString funkcji składowej.Kolor systemowy COLOR_GRAYTEXT jest kolor szary pełny system do rysowania wyłączony tekst.Aplikacja może wywołać GetSysColor funkcji systemu Windows do pobierania wartości koloru COLOR_GRAYTEXT.Jeśli kolor jest równa 0 (czarny), aplikacja może wywołać SetTextColor Członkowskich funkcji ustawiony na wartość koloru kolor tekstu, a następnie narysuj ciąg bezpośrednio.Jeśli pobrano kolorem jest czarny, aplikacja musi wywołać GrayString do dim (szarym) tekstu.

Jeśli lpfnOutput jest NULL, korzysta z interfejsu GDI systemu Windows TextOut funkcji i lpData zakłada się daleko wskaźnik do znaku wyprowadzenie.Jeśli znaki mają być dane wyjściowe nie obsługiwane przez TextOut Członkowskie funkcji (na przykład ciąg jest przechowywany jako bitmapy), podać własne dane wyjściowe funkcji aplikacji.

Należy również zauważyć, że wszystkie funkcje wywołania zwrotnego musi zalewki wyjątki Microsoft Foundation przed powrotem do systemu Windows, ponieważ wyjątki nie zgłoszony przez granice wywołania zwrotnego.Aby uzyskać więcej informacji dotyczących wyjątków, zobacz artykuł Wyjątki.

Funkcja wywołania zwrotnego GrayString należy użyć __stdcall konwencji wywoływania i muszą zostać wywiezione z __declspec.

Gdy ramach jest w trybie podglądu, wywołanie GrayString Członkowskich funkcji jest tłumaczony TextOut wywołania i funkcji wywołania zwrotnego nie jest wywoływana.