CDC::GrayStri&ngnbsp;

wirtualne BOOL GrayString ( CBrush * Ustawienie pBrush, BOOL ( wywołania zwrotnego wywóz * lpfnOutput ) ( HDC, FIKCYJNYMI, int ), FIKCYJNYMI lpData, int nCount, int x, int y, int nWidth właściwości, int nHeight );

Wartość zwracany

Różna od zera, jeśli ciąg jest rysowany lub 0 Jeśli funkcję TextOut lub funkcji dostarczanych aplikacji dane wyjściowe zwracane 0 lub jeśli było za mało pamięci, aby utworzyć mapę bitową pamięć dla wygaszanie.

Parametry

ustawienie pBrush

Identyfikuje pędzla stosowaną do dimming (graying).

lpfnOutput

Określa adres procedury wystąpienie funkcji wywołania zwrotnego dostarczone aplikacji, która będzie sznurkami. Aby uzyskać więcej informacji zobacz opis systemu Windows OutputFunc funkcji wywołania zwrotnego. Jeśli ten parametr ma wartość NULL, system używa funkcji Windows TextOut aby narysować ciąg i zakłada się, że lpData się długo wskaźnik ciąg znaków do produkcji.

lpData

Określa wskaźnik daleko dane mają być przekazywane do funkcji dane wyjściowe. Jeśli lpfnOutput ma wartość NULL, lpData musi być długie wskaźnik ciąg, który ma być przekazywane na wyjście.

nCount

Określa liczbę znaków, które mają być przekazywane na wyjście. Jeśli ten parametr ma wartość 0, GrayString oblicza długość ciągu (przy założeniu, że tej lpData jest wskaźnik do ciągu). Jeśli nCount jest –1, a funkcja wskazywanego przez lpfnOutput zwraca 0, obraz jest widoczne, ale nie wygaszone.

x

Określa logiczne współrzędną x pozycję początkową prostokąt ograniczający ciąg.

y

Określa logiczne współrzędna y pozycję początkową prostokąt ograniczający ciąg.

nWidth właściwości

Określa szerokość (w jednostkach logicznych) prostokąt ograniczający ciąg. Jeśli nWidth właściwości jest równa 0, GrayString oblicza szerokość obszaru, przy założeniu, że lpData jest wskaźnik do ciągu.

nHeight

Określa wysokość (w jednostkach logicznych) prostokąt ograniczający ciąg. Jeśli nHeight jest 0, GrayString oblicza wysokość obszaru, przy założeniu, że lpData jest wskaźnik do ciągu.

Uwagi

Rysuje wygaszone (szare) tekstu w danym miejscu przez pisanie tekstu w bitmapie pamięci, Zaciemnienie bitmapy, a następnie kopiując mapę bitową do wyświetlania. Funkcja powoduje tekstu niezależnie od pędzla i tła. GrayString Członkowskich funkcja korzystająca obecnie wybrana czcionka. Przed użyciem tej funkcji należy wybrać tryb mapowania MM_TEXT.

Aplikację można narysować wygaszony ciągi (wygaszone) w urządzeniach, które obsługują pełny kolor szary bez wywoływania funkcji członek GrayString . Kolor systemu COLOR_GRAYTEXT jest stałe szary systemu umożliwia rysowanie tekstu wyłączone. Aplikacja może wywołać funkcję Windows GetSysColor pobieranie wartości kolorów COLOR_GRAYTEXT. Jeśli kolor jest różna od 0 (czarny), aplikacji można wywołać funkcję Państwa SetTextColor , aby ustawić kolor tekstu do wartości koloru, a następnie narysuj ciąg bezpośrednio. Jeśli pobrano kolorem jest czarny, aplikacja musi wywołać tekst GrayString aby przyciemnić (szary).

Jeśli lpfnOutput ma wartość NULL, GDI używa systemu Windows funkcji TextOut i lpData zakłada się daleko wskaźnik znaków do wyjścia. Jeśli znaków, które mają być przekazywane na wyjście nie mogą być obsługiwane przez funkcję Państwa TextOut (na przykład ciąg jest przechowywane jako bitmapy), wniosek musi dostarczyć ma własną funkcję wyjście.

Należy również zauważyć, że wszystkie funkcje wywołania zwrotnego musi przechwytują wyjątki Microsoft Foundation zanim wrócił do systemu Windows, ponieważ wyjątków nie może zostać wygenerowany granicami wywołania zwrotnego. Aby uzyskać więcej informacji dotyczących wyjątków, zobacz artykuł wyjątków w Visual C++ Programmer's Guide.

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

Gdy ramach jest w trybie podglądu, wywołanie funkcji członek GrayString jest tłumaczony na wywołanie TextOut i wywołanie zwrotne nie jest wywoływana funkcja.

Omówie&nie CDC |nbsp; Klasa członków | Wykres hierarchii

Zobacz teżnbsp; :: GetSysColor, CDC::SetTextColor, CDC::TextOut, :: GrayString

Index