CDC::GrayString
Nakreslí aktivní (šedá) text v daném umístění psaní textu v paměti bitmapy, ztlumení bitmapy a potom kopírování rastrového obrázku pro zobrazení.
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
Identifikuje stopy pro ztlumení (graying).lpfnOutput
Určuje adresu procedury instance funkce poskytované aplikací zpětné volání, která bude kreslit řetězec.Další informace naleznete v popisu systému Windows OutputFunc zpětného volání funkce.Pokud je tento parametr NULL, použije systém Windows TextOut funkce kreslení řetězec, a lpData považován za dlouhý ukazatel na řetězec znaků, bude výstup.lpData
Určuje daleko ukazatele údaje předávané výstup funkce.Pokud lpfnOutput je NULL, lpData musí být dlouhé ukazatel na řetězec, který má být výstup.nCount
Určuje počet znaků, bude výstup.Pokud je tento parametr 0, GrayString vypočítá délka řetězce (za předpokladu, že lpData je ukazatel na řetězec).Pokud nCount je –1 a na kterou odkazuje funkce lpfnOutput vrátí 0, obraz je zobrazen, ale nejsou zobrazeny šedě.x
Určuje logické souřadnici x pozice obdélníku, který ohraničuje řetězec.y
Určuje logické souřadnici y počáteční pozice obdélník ohraničující řetězec.nWidth
Určuje šířku obdélník ohraničující řetězce (v logické jednotky).Pokud nWidth 0, GrayString vypočítá šířku oblasti, za předpokladu, že lpData je ukazatel na řetězec.nHeight
Určuje výšku obdélníku, který ohraničuje řetězce (v logické jednotky).Pokud nHeight 0, GrayString vypočítá výška oblasti, za předpokladu, že lpData je ukazatel na řetězec.
Vrácená hodnota
Nenulová hodnota, pokud je nakreslena řetězce, nebo 0, pokud TextOut funkce nebo funkce poskytované aplikací výstupu vrátí 0 nebo pokud nedostatek paměti k vytvoření rastru paměti pro ztlumení.
Poznámky
Funkce nevýrazně text bez ohledu na vybrané stopy a pozadí. GrayString Členské funkce používá aktuálně vybrané písmo. MM_TEXT Mapování režimu musí být vybrána před použitím této funkce.
Aplikace můžete nakreslit šedě řetězce (šedě) na zařízení, která podporují plné šedé barvy bez zastávky GrayString členské funkce.Systémové barvy COLOR_GRAYTEXT je plná šedé systémové barvy se použije k nakreslení neaktivní text.Aplikace může zavolat GetSysColor funkce systému Windows načíst hodnotu barvy COLOR_GRAYTEXT.Pokud je barva různé od 0 (černá), aplikace může zavolat SetTextColor nastavena na hodnotu barvy barvu textu a potom nakreslete řetězec přímo členské funkce.Pokud načtený barva je černá, musí aplikace volat GrayString ztlumíte (šedá) text.
Pokud lpfnOutput je NULL, používá rozhraní GDI systému Windows TextOut funkci, a lpData považován za zcela ukazatel na znak, bude výstup.Pokud nelze zpracovat znaků bude výstup TextOut členské funkce (například řetězec je uložen jako rastr), aplikace musíte zadat svůj vlastní výstup funkce.
Všimněte si také, že všechny funkce zpětného volání musí soutisk Microsoft Foundation výjimky před návratem k systému Windows, protože výjimky nemůže být vyvolána přes hranice zpětného volání.Další informace o výjimkách naleznete v článku výjimky.
Předaný funkci zpětného volání GrayString musí používat __stdcall konvence volání a musí být vyvezeny s __declspec .
Pokud rámci je v režimu náhledu, volání GrayString členské funkce je přeložen do TextOut není zavolána volání a funkci zpětného volání.
Požadavky
Záhlaví: afxwin.h