`CDC` Třída

Článek
07/05/2024

Definuje třídu objektů kontextu zařízení.

Syntaxe

class CDC : public CObject

Členové

Veřejné konstruktory

Název	Popis
`CDC::CDC`	`CDC` Vytvoří objekt.

Veřejné metody

Název	Popis
`CDC::AbortDoc`	Ukončí aktuální tiskovou úlohu a vymaže všechno, co aplikace napsala do zařízení od posledního `StartDoc` volání členské funkce.
`CDC::AbortPath`	Zavře a zahodí všechny cesty v kontextu zařízení.
`CDC::AddMetaFileComment`	Zkopíruje komentář z vyrovnávací paměti do zadaného metasouboru rozšířeného formátu.
`CDC::AlphaBlend`	Zobrazí rastrové obrázky, které mají průhledné nebo poloprůhledné pixely.
`CDC::AngleArc`	Nakreslí segment čáry a oblouk a přesune aktuální pozici na koncový bod oblouku.
`CDC::Arc`	Nakreslí elipsický oblouk.
`CDC::ArcTo`	Nakreslí elipsický oblouk. Tato funkce je podobná s tím rozdílem `Arc`, že aktuální pozice je aktualizována.
`CDC::Attach`	Připojí k tomuto `CDC` objektu kontext zařízení s Windows.
`CDC::BeginPath`	Otevře závorku cesty v kontextu zařízení.
`CDC::BitBlt`	Zkopíruje rastrový obrázek ze zadaného kontextu zařízení.
`CDC::Chord`	Nakreslí akord (uzavřený obrázek ohraničený průsečíkem tří teček a segmentu čáry).
`CDC::CloseFigure`	Zavře otevřený obrázek v cestě.
`CDC::CreateCompatibleDC`	Vytvoří kontext paměťového zařízení, který je kompatibilní s jiným kontextem zařízení. Můžete ho použít k přípravě obrázků v paměti.
`CDC::CreateDC`	Vytvoří kontext zařízení pro konkrétní zařízení.
`CDC::CreateIC`	Vytvoří kontext informací pro konkrétní zařízení. To poskytuje rychlý způsob, jak získat informace o zařízení bez vytvoření kontextu zařízení.
`CDC::DeleteDC`	Odstraní kontext zařízení s Windows přidružený k tomuto `CDC` objektu.
`CDC::DeleteTempMap`	Volá se obslužnou rutinou `CWinApp` nečinnosti k odstranění libovolného dočasného `CDC` objektu vytvořeného `FromHandle`. Odpojte také kontext zařízení.
`CDC::Detach`	Odpojte kontext zařízení s Windows od tohoto `CDC` objektu.
`CDC::DPtoHIMETRIC`	Převede jednotky zařízení na `HIMETRIC` jednotky.
`CDC::DPtoLP`	Převede jednotky zařízení na logické jednotky.
`CDC::Draw3dRect`	Nakreslí trojrozměrný obdélník.
`CDC::DrawDragRect`	Při přetahování vymaže a překreslí obdélník.
`CDC::DrawEdge`	Nakreslí okraje obdélníku.
`CDC::DrawEscape`	Přistupuje k možnostem kreslení zobrazení videa, které nejsou přímo dostupné prostřednictvím rozhraní grafického zařízení (GDI).
`CDC::DrawFocusRect`	Nakreslí obdélník ve stylu použitém k označení fokusu.
`CDC::DrawFrameControl`	Nakreslete ovládací prvek rámečku.
`CDC::DrawIcon`	Nakreslí ikonu.
`CDC::DrawState`	Zobrazí obrázek a použije vizuální efekt pro označení stavu.
`CDC::DrawText`	Nakreslí formátovaný text v zadaném obdélníku.
`CDC::DrawTextEx`	Nakreslí formátovaný text v zadaném obdélníku pomocí jiných formátů.
`CDC::Ellipse`	Nakreslí tři tečky.
`CDC::EndDoc`	Ukončí tiskovou úlohu spuštěnou členovou `StartDoc` funkcí.
`CDC::EndPage`	Informuje ovladač zařízení, že stránka končí.
`CDC::EndPath`	Zavře závorku cesty a vybere cestu definovanou závorkou do kontextu zařízení.
`CDC::EnumObjects`	Vytvoří výčet per a štětců dostupných v kontextu zařízení.
`CDC::Escape`	Umožňuje aplikacím přístup k zařízením, které nejsou přímo dostupné z konkrétního zařízení prostřednictvím GDI. Umožňuje také přístup k řídicím funkcím Windows. Řídicí volání provedená aplikací se přeloží a odešlou do ovladače zařízení.
`CDC::ExcludeClipRect`	Vytvoří novou oblast výřezu, která se skládá z existující oblasti výřezu minus zadaný obdélník.
`CDC::ExcludeUpdateRgn`	Zabrání kreslení v neplatných oblastech okna vyloučením aktualizované oblasti v okně z oblasti výřezu.
`CDC::ExtFloodFill`	Vyplní oblast aktuálním štětcem. Poskytuje větší flexibilitu než členová `CDC::FloodFill` funkce.
`CDC::ExtTextOut`	Zapíše řetězec znaků v obdélníkové oblasti pomocí aktuálně vybraného písma.
`CDC::FillPath`	Zavře všechny otevřené obrázky v aktuální cestě a vyplní jeho interiér pomocí aktuálního štětce a polygonového režimu.
`CDC::FillRect`	Vyplní daný obdélník pomocí štětce.
`CDC::FillRgn`	Vyplní konkrétní oblast zadaným štětcem.
`CDC::FillSolidRect`	Vyplní obdélník plnou barvou.
`CDC::FlattenPath`	Transformuje všechny křivky v cestě vybrané na aktuální kontext zařízení a změní každou křivku na posloupnost čar.
`CDC::FloodFill`	Vyplní oblast aktuálním štětcem.
`CDC::FrameRect`	Nakreslí ohraničení kolem obdélníku.
`CDC::FrameRgn`	Nakreslí ohraničení kolem konkrétní oblasti pomocí štětce.
`CDC::FromHandle`	Vrátí ukazatel na `CDC` objekt při zadání popisovače kontextu zařízení. `CDC` Pokud objekt není připojený k popisovači, vytvoří se dočasný `CDC` objekt a připojí se.
`CDC::GetArcDirection`	Vrátí aktuální směr oblouku pro kontext zařízení.
`CDC::GetAspectRatioFilter`	Načte nastavení aktuálního filtru poměru stran.
`CDC::GetBkColor`	Načte aktuální barvu pozadí.
`CDC::GetBkMode`	Načte režim pozadí.
`CDC::GetBoundsRect`	Vrátí aktuální kumulovaný ohraničující obdélník pro zadaný kontext zařízení.
`CDC::GetBrushOrg`	Načte původ aktuálního štětce.
`CDC::GetCharABCWidths`	Načte šířky v logických jednotkách po sobě jdoucích znaků v daném rozsahu z aktuálního písma.
`CDC::GetCharABCWidthsI`	Načte šířky v logických jednotkách po sobě jdoucích indexů glyfů v zadaném rozsahu z aktuálního písma TrueType.
`CDC::GetCharacterPlacement`	Načte různé typy informací o řetězci znaků.
`CDC::GetCharWidth`	Načte desetinné šířky po sobě jdoucích znaků v daném rozsahu z aktuálního písma.
`CDC::GetCharWidthI`	Načte šířky v logických souřadnicích po sobě jdoucích indexů glyfů v zadaném rozsahu od aktuálního písma.
`CDC::GetClipBox`	Načte rozměry nejtěsnějšího ohraničujícího obdélníku kolem aktuální hranice oříznutí.
`CDC::GetColorAdjustment`	Načte hodnoty úprav barev pro kontext zařízení.
`CDC::GetCurrentBitmap`	Vrátí ukazatel na aktuálně vybraný `CBitmap` objekt.
`CDC::GetCurrentBrush`	Vrátí ukazatel na aktuálně vybraný `CBrush` objekt.
`CDC::GetCurrentFont`	Vrátí ukazatel na aktuálně vybraný `CFont` objekt.
`CDC::GetCurrentPalette`	Vrátí ukazatel na aktuálně vybraný `CPalette` objekt.
`CDC::GetCurrentPen`	Vrátí ukazatel na aktuálně vybraný `CPen` objekt.
`CDC::GetCurrentPosition`	Načte aktuální pozici pera (v logických souřadnicích).
`CDC::GetDCBrushColor`	Načte aktuální barvu štětce.
`CDC::GetDCPenColor`	Načte aktuální barvu pera.
`CDC::GetDeviceCaps`	Načte zadaný druh informací specifických pro zařízení o schopnostech daného zařízení pro zobrazení.
`CDC::GetFontData`	Načte informace o metrikách písma ze škálovatelného souboru písma. Informace k načtení jsou identifikovány zadáním posunu do souboru písma a délky informací, které se mají vrátit.
`CDC::GetFontLanguageInfo`	Vrátí informace o aktuálně vybraném písmu pro zadaný kontext zobrazení.
`CDC::GetGlyphOutline`	Načte křivku obrysu nebo rastrový obrázek pro znak osnovy v aktuálním písmu.
`CDC::GetGraphicsMode`	Načte aktuální grafický režim pro zadaný kontext zařízení.
`CDC::GetHalftoneBrush`	Načte půltónový štětec.
`CDC::GetKerningPairs`	Načte dvojice prokládání znaků pro písmo, které je aktuálně vybrané v zadaném kontextu zařízení.
`CDC::GetLayout`	Načte rozložení kontextu zařízení (DC). Rozložení může být zleva doprava (výchozí) nebo zprava doleva (zrcadlené).
`CDC::GetMapMode`	Načte aktuální režim mapování.
`CDC::GetMiterLimit`	Vrátí limit miter pro kontext zařízení.
`CDC::GetNearestColor`	Načte nejbližší logickou barvu k zadané logické barvě, kterou může dané zařízení reprezentovat.
`CDC::GetOutlineTextMetrics`	Načte informace o metrice písma typu TrueType.
`CDC::GetOutputCharWidth`	Načte šířky jednotlivých znaků v po sobě jdoucí skupině znaků z aktuálního písma pomocí kontextu výstupního zařízení.
`CDC::GetOutputTabbedTextExtent`	Vypočítá šířku a výšku řetězce znaků v kontextu výstupního zařízení.
`CDC::GetOutputTextExtent`	Vypočítá šířku a výšku řádku textu ve výstupním kontextu zařízení pomocí aktuálního písma k určení rozměrů.
`CDC::GetOutputTextMetrics`	Načte metriky pro aktuální písmo z kontextu výstupního zařízení.
`CDC::GetPath`	Načte souřadnice definující koncové body čar a kontrolní body křivek nalezených v cestě vybrané v kontextu zařízení.
`CDC::GetPixel`	Načte hodnotu barvy RGB pixelu v zadaném bodě.
`CDC::GetPolyFillMode`	Načte aktuální režim vyplňování mnohoúhelníku.
`CDC::GetROP2`	Načte aktuální režim výkresu.
`CDC::GetSafeHdc`	Vrátí `CDC::m_hDC`kontext výstupního zařízení.
`CDC::GetStretchBltMode`	Načte aktuální režim roztažení rastrového obrázku.
`CDC::GetTabbedTextExtent`	Vypočítá šířku a výšku řetězce znaků v kontextu zařízení atributu.
`CDC::GetTextAlign`	Načte příznaky zarovnání textu.
`CDC::GetTextCharacterExtra`	Načte aktuální nastavení pro množství mezer mezi znaky.
`CDC::GetTextColor`	Načte aktuální barvu textu.
`CDC::GetTextExtent`	Vypočítá šířku a výšku řádku textu v kontextu zařízení atributu pomocí aktuálního písma k určení rozměrů.
`CDC::GetTextExtentExPointI`	Načte počet znaků v zadaném řetězci, který se vejde do zadaného místa, a vyplní matici textovým rozsahem pro každý z těchto znaků.
`CDC::GetTextExtentPointI`	Načte šířku a výšku zadaného pole indexů glyfů.
`CDC::GetTextFace`	Zkopíruje název písma aktuálního písma do vyrovnávací paměti jako řetězec ukončený hodnotou null.
`CDC::GetTextMetrics`	Načte metriky pro aktuální písmo z kontextu zařízení atributu.
`CDC::GetViewportExt`	Načte rozsahy x a y oblasti zobrazení.
`CDC::GetViewportOrg`	Načte souřadnice x a y původu oblasti zobrazení.
`CDC::GetWindow`	Vrátí okno přidružené k kontextu zařízení pro zobrazení.
`CDC::GetWindowExt`	Načte rozsahy x a y přidruženého okna.
`CDC::GetWindowOrg`	Načte souřadnice x a y původu přidruženého okna.
`CDC::GetWorldTransform`	Načte aktuální světovou mezeru na transformaci stránkového prostoru.
`CDC::GradientFill`	Vyplní obdélníkové a trojúhelníkové struktury s barvou známkování.
`CDC::GrayString`	Nakreslí šedě (šedě) text na daném místě.
`CDC::HIMETRICtoDP`	Převede jednotky HIMETRIC na jednotky zařízení.
`CDC::HIMETRICtoLP`	Převede jednotky HIMETRIC na logické jednotky.
`CDC::IntersectClipRect`	Vytvoří novou oblast výřezu vytvořením průsečíku aktuální oblasti a obdélníku.
`CDC::InvertRect`	Invertuje obsah obdélníku.
`CDC::InvertRgn`	Invertuje barvy v oblasti.
`CDC::IsPrinting`	Určuje, jestli se pro tisk používá kontext zařízení.
`CDC::LineTo`	Nakreslí čáru z aktuální pozice nahoru, ale neobsahuje ani bod.
`CDC::LPtoDP`	Převede logické jednotky na jednotky zařízení.
`CDC::LPtoHIMETRIC`	Převede logické jednotky na jednotky HIMETRIC.
`CDC::MaskBlt`	Kombinuje barevná data pro zdrojové a cílové rastrové obrázky pomocí dané masky a rastrové operace.
`CDC::ModifyWorldTransform`	Změní světovou transformaci kontextu zařízení pomocí zadaného režimu.
`CDC::MoveTo`	Přesune aktuální pozici.
`CDC::OffsetClipRgn`	Přesune oblast výřezu daného zařízení.
`CDC::OffsetViewportOrg`	Upraví původ oblasti zobrazení vzhledem ke souřadnicím aktuálního původu oblasti zobrazení.
`CDC::OffsetWindowOrg`	Upraví původ okna vzhledem ke souřadnicím aktuálního původu okna.
`CDC::PaintRgn`	Vyplní oblast vybraným štětcem.
`CDC::PatBlt`	Vytvoří bitový vzor.
`CDC::Pie`	Nakreslí výsečový klín.
`CDC::PlayMetaFile`	Přehraje obsah zadaného metasouboru na daném zařízení. Vylepšená verze zobrazí obrázek uložený v daném metasouboru rozšířeného `PlayMetaFile` formátu. Metasoubor lze přehrát libovolný počet.
`CDC::PlgBlt`	Provede bitový blok přenosu bitů barevných dat ze zadaného obdélníku v kontextu zdrojového zařízení do zadaného paralelogramu v daném kontextu zařízení.
`CDC::PolyBezier`	Nakreslí jednu nebo více čar Bzier. Aktuální pozice se nepoužívá ani neaktualizuje.
`CDC::PolyBezierTo`	Nakreslí jeden nebo více Bzier splines a přesune aktuální pozici na koncový bod posledního Bzier spline.
`CDC::PolyDraw`	Nakreslí sadu segmentů čar a Bzier splines. Tato funkce aktualizuje aktuální pozici.
`CDC::Polygon`	Nakreslí mnohoúhelník skládající se ze dvou nebo více bodů (vrcholů) spojených spojnicemi.
`CDC::Polyline`	Nakreslí sadu segmentů čar spojujících zadané body.
`CDC::PolylineTo`	Nakreslí jednu nebo více rovných čar a přesune aktuální pozici na koncový bod poslední čáry.
`CDC::PolyPolygon`	Vytvoří dva nebo více mnohoúhelníku, které jsou vyplněny pomocí aktuálního režimu mnohoúhelníku. Mnohoúhelníky mohou být oddělené nebo se mohou překrývat.
`CDC::PolyPolyline`	Nakreslí více řad propojených segmentů čar. Tato funkce nepoužívá ani neaktualizuje aktuální pozici.
`CDC::PtVisible`	Určuje, jestli se daný bod nachází v oblasti výřezu.
`CDC::RealizePalette`	Mapuje položky palety v aktuální logické paletě na systémovou paletu.
`CDC::Rectangle`	Nakreslí obdélník pomocí aktuálního pera a vyplní ho pomocí aktuálního štětce.
`CDC::RectVisible`	Určuje, zda některá část daného obdélníku leží v oblasti výřezu.
`CDC::ReleaseAttribDC`	Vydané verze `m_hAttribDC`, kontext zařízení atributu.
`CDC::ReleaseOutputDC`	Vydané verze `m_hDC`, kontext výstupního zařízení.
`CDC::ResetDC`	`m_hAttribDC` Aktualizuje kontext zařízení.
`CDC::RestoreDC`	Obnoví kontext zařízení do předchozího stavu uloženého v `SaveDC`souboru .
`CDC::RoundRect`	Nakreslí obdélník se zaoblenými rohy pomocí aktuálního pera a vyplní aktuálním štětcem.
`CDC::SaveDC`	Uloží aktuální stav kontextu zařízení.
`CDC::ScaleViewportExt`	Upraví rozsah oblasti zobrazení vzhledem k aktuálním hodnotám.
`CDC::ScaleWindowExt`	Upraví rozsahy okna vzhledem k aktuálním hodnotám.
`CDC::ScrollDC`	Posune obdélník bitů vodorovně a svisle.
`CDC::SelectClipPath`	Vybere aktuální cestu jako oblast výřezu kontextu zařízení a zkombinuje novou oblast s jakoukoli existující oblastí výřezu pomocí zadaného režimu.
`CDC::SelectClipRgn`	Kombinuje danou oblast s aktuální oblastí výřezu pomocí zadaného režimu.
`CDC::SelectObject`	Vybere nakreslený objekt GDI, například pero.
`CDC::SelectPalette`	Vybere logickou paletu.
`CDC::SelectStockObject`	Vybere jedno z předdefinovaných per, štětců nebo písem poskytovaných systémem Windows.
`CDC::SetAbortProc`	Nastaví programátorem zadanou funkci zpětného volání, kterou systém Windows volá, pokud je nutné přerušit tiskovou úlohu.
`CDC::SetArcDirection`	Nastaví směr kreslení, který se má použít pro obloukové a obdélníkové funkce.
`CDC::SetAttribDC`	Nastaví `m_hAttribDC`kontext zařízení atributu.
`CDC::SetBkColor`	Nastaví aktuální barvu pozadí.
`CDC::SetBkMode`	Nastaví režim pozadí.
`CDC::SetBoundsRect`	Řídí akumulace informací o ohraničujícího obdélníku pro zadaný kontext zařízení.
`CDC::SetBrushOrg`	Určuje původ dalšího štětce vybraného v kontextu zařízení.
`CDC::SetColorAdjustment`	Nastaví hodnoty úprav barev pro kontext zařízení pomocí zadaných hodnot.
`CDC::SetDCBrushColor`	Nastaví aktuální barvu štětce.
`CDC::SetDCPenColor`	Nastaví aktuální barvu pera.
`CDC::SetGraphicsMode`	Nastaví aktuální grafický režim pro zadaný kontext zařízení.
`CDC::SetLayout`	Změní rozložení kontextu zařízení (DC).
`CDC::SetMapMode`	Nastaví aktuální režim mapování.
`CDC::SetMapperFlags`	Změní algoritmus, který mapovač písem používá, když mapuje logická písma na fyzická písma.
`CDC::SetMiterLimit`	Nastaví limit pro délku spojení miterů pro kontext zařízení.
`CDC::SetOutputDC`	Nastaví `m_hDC`kontext výstupního zařízení.
`CDC::SetPixel`	Nastaví pixel v zadaném bodě na nejbližší aproximaci zadané barvy.
`CDC::SetPixelV`	Nastaví pixel na zadaných souřadnicích na nejbližší aproximaci zadané barvy. `SetPixelV` je rychlejší než `SetPixel` proto, že nemusí vracet barevnou hodnotu namalovaného bodu.
`CDC::SetPolyFillMode`	Nastaví režim mnohoúhelníku.
`CDC::SetROP2`	Nastaví aktuální režim kreslení.
`CDC::SetStretchBltMode`	Nastaví režim rastrového roztažení.
`CDC::SetTextAlign`	Nastaví příznaky zarovnání textu.
`CDC::SetTextCharacterExtra`	Nastaví velikost mezer mezi znaky.
`CDC::SetTextColor`	Nastaví barvu textu.
`CDC::SetTextJustification`	Přidá mezeru ke znakům zalomení v řetězci.
`CDC::SetViewportExt`	Nastaví rozsahy x a y oblasti zobrazení.
`CDC::SetViewportOrg`	Nastaví zdroj oblasti zobrazení.
`CDC::SetWindowExt`	Nastaví rozsahy x a y přidruženého okna.
`CDC::SetWindowOrg`	Nastaví původ okna kontextu zařízení.
`CDC::SetWorldTransform`	Nastaví aktuální světovou mezeru na transformaci stránkového prostoru.
`CDC::StartDoc`	Informuje ovladač zařízení, že se spouští nová tisková úloha.
`CDC::StartPage`	Informuje ovladač zařízení, že se spouští nová stránka.
`CDC::StretchBlt`	V případě potřeby přesune rastrový obrázek ze zdrojového obdélníku a zařízení do cílového obdélníku, roztáhne nebo zkomprimuje rastrový obrázek tak, aby odpovídal rozměrům cílového obdélníku.
`CDC::StrokeAndFillPath`	Zavře všechny otevřené obrázky v cestě, přeškrtá obrys cesty pomocí aktuálního pera a vyplní jeho interiér pomocí aktuálního štětce.
`CDC::StrokePath`	Vykreslí zadanou cestu pomocí aktuálního pera.
`CDC::TabbedTextOut`	Zapíše řetězec znaků do zadaného umístění a rozbalí tabulátory na hodnoty zadané v poli pozic zarážky tabulátoru.
`CDC::TextOut`	Zapíše řetězec znaků do zadaného umístění pomocí aktuálně vybraného písma.
`CDC::TransparentBlt`	Přenese bitové bloky barevných dat ze zadaného kontextu zdrojového zařízení do kontextu cílového zařízení, čímž se v přenosu zobrazí zadaná barva průhledná.
`CDC::UpdateColors`	Aktualizuje oblast klienta kontextu zařízení tím, že odpovídá aktuálním barvám v klientské oblasti se systémovou paletou na pixel-by-pixel.
`CDC::WidenPath`	Předefinuje aktuální cestu jako oblast, která by byla vykreslena, pokud by byla cesta tahována pomocí pera aktuálně vybraného do kontextu zařízení.

Veřejné operátory

Název	Popis
`CDC::operator HDC`	Načte popisovač kontextu zařízení.

Veřejné datové členy

Název	Popis
`CDC::m_hAttribDC`	Kontext atributu zařízení používaný tímto `CDC` objektem.
`CDC::m_hDC`	Kontext výstupního zařízení používaný tímto `CDC` objektem.

Poznámky

Objekt CDC poskytuje členské funkce pro práci s kontextem zařízení, jako je zobrazení nebo tiskárna, a členy pro práci s kontextem zobrazení přidruženým k klientské oblasti okna.

Projděte si všechny členské funkce objektu CDC . Třída poskytuje členské funkce pro operace kontextu zařízení, práce s nástroji kreslení, typově bezpečné rozhraní grafického zařízení (GDI) výběr objektů a práce s barvami a paletami. Poskytuje také členské funkce pro získávání a nastavení atributů výkresu, mapování, práci s oblastí zobrazení, práci s rozsahem okna, převod souřadnic, práci s oblastmi, oříznutí, kreslení čar a kreslení jednoduchých obrazců, elips a mnohoúhelníku. Členské funkce jsou také k dispozici pro kreslení textu, práci s písmy, použití řídicích znaků tiskárny, posouvání a přehrávání metasouborů.

Pokud chcete použít CDC objekt, vytvořte ho a potom volejte jeho členské funkce, které paralelně používají funkce Systému Windows, které používají kontexty zařízení.

Poznámka:

Ve Windows 95/98 jsou všechny souřadnice obrazovky omezené na 16 bitů. int CDC Předání členské funkci proto musí být v rozsahu -32768 až 32767.

Pro konkrétní použití poskytuje knihovna tříd Microsoft Foundation několik tříd odvozených z CDC . CPaintDC zapouzdřuje volání do BeginPaint a EndPaint. CClientDC spravuje kontext zobrazení přidružený k klientské oblasti okna. CWindowDC spravuje kontext zobrazení přidružený k celému okně, včetně jeho rámce a ovládacích prvků. CMetaFileDC přidruží kontext zařízení k metasouboru.

CDC poskytuje dvě členské funkce GetLayout a SetLayoutpro vrácení rozložení kontextu zařízení, které nedědí jeho rozložení z okna. Taková orientace zprava doleva je nezbytná pro aplikace napsané pro jazykové verze, jako je arabština nebo hebrejština, kde rozložení znaků není evropským standardem.

CDC obsahuje dva kontexty zařízení, m_hDC které m_hAttribDCpři vytváření objektu CDC odkazují na stejné zařízení. CDCsměruje všechna volání GDI výstupu do m_hDC a většina volání GDI atributu .m_hAttribDC (Příklad volání atributu je GetTextColor, zatímco SetTextColor je výstupní volání.)

Architektura například používá tyto dva kontexty zařízení k implementaci objektu CMetaFileDC , který bude odesílat výstup do metasouboru při čtení atributů z fyzického zařízení. Náhled tisku se implementuje v rámci podobným způsobem. V kódu specifickém pro aplikaci můžete také použít dva kontexty zařízení podobným způsobem.

Někdy můžete potřebovat informace o textové metrice z m_hDC kontextu zařízení i m_hAttribDC z kontextu zařízení. Následující páry funkcí poskytují tuto funkci:

Používá m_hAttribDC	Používá m_hDC
`GetTextExtent`	`GetOutputTextExtent`
`GetTabbedTextExtent`	`GetOutputTabbedTextExtent`
`GetTextMetrics`	`GetOutputTextMetrics`
`GetCharWidth`	`GetOutputCharWidth`

Další informace najdete v CDCtématu Kontexty zařízení.

Hierarchie dědičnosti

CObject

CDC

Požadavky

Záhlaví: afxwin.h

`CDC::AbortDoc`

Ukončí aktuální tiskovou úlohu a vymaže všechno, co aplikace napsala do zařízení od posledního StartDoc volání členské funkce.

int AbortDoc();

Návratová hodnota

Hodnota větší nebo rovna 0, pokud byla úspěšná, nebo záporná hodnota, pokud došlo k chybě. Následující seznam obsahuje běžné chybové hodnoty a jejich významy:

SP_ERROR Obecná chyba.
SP_OUTOFDISK Není k dispozici dostatek místa na disku pro zařazování a nebude k dispozici žádné další místo.
SP_OUTOFMEMORY Pro zařazování není k dispozici dostatek paměti.
SP_USERABORT Uživatel ukončil úlohu prostřednictvím Správce tisku.

Poznámky

Tato členová funkce nahrazuje řídicí znak tiskárny ABORTDOC .

AbortDoc by měly být použity k ukončení následujících:

Tiskové operace, které nezadávají funkci přerušení pomocí SetAbortProc.
Tiskové operace, které ještě nedosáhly prvního NEWFRAME nebo NEXTBAND řídicího volání.

Pokud aplikace narazí na chybu tisku nebo zrušenou tiskovou operaci, nesmí se pokoušet ukončit operaci pomocí buď EndDoc AbortDoc pomocí nebo členské funkce třídy CDC. GDI automaticky ukončí operaci před vrácením chybové hodnoty.

Pokud aplikace zobrazí dialogové okno, které uživateli umožní zrušit operaci tisku, musí před zničením dialogového okna volat AbortDoc .

Pokud byl správce tisku použit ke spuštění tiskové úlohy, volání AbortDoc vymaže celou úlohu zařazování – tiskárna neobdrží nic. Pokud správce tisku nebyl použit ke spuštění tiskové úlohy, data byla pravděpodobně odeslána do tiskárny předtím, než AbortDoc byla volána. V takovém případě by ovladač tiskárny resetoval tiskárnu (pokud je to možné) a zavřel tiskovou úlohu.

Příklad

Podívejte se na příklad pro CDC::StartDoc.

`CDC::AbortPath`

Zavře a zahodí všechny cesty v kontextu zařízení.

BOOL AbortPath();

Návratová hodnota

Nenulové, pokud je funkce úspěšná; jinak 0.

Poznámky

Pokud je v kontextu zařízení otevřená závorka cesty, zavře se závorka cesty a cesta se zahodí. Pokud je v kontextu zařízení uzavřená cesta, cesta se zahodí.

`CDC::AddMetaFileComment`

Zkopíruje komentář z vyrovnávací paměti do zadaného metasouboru rozšířeného formátu.

BOOL AddMetaFileComment(
    UINT nDataSize,
    const BYTE* pCommentData);

Parametry

nDataSize
Určuje délku vyrovnávací paměti komentáře v bajtech.

pCommentData
Odkazuje na vyrovnávací paměť, která obsahuje komentář.

Návratová hodnota

Nenulové, pokud je funkce úspěšná; jinak 0.

Poznámky

Komentář může obsahovat jakékoli soukromé informace – například zdroj obrázku a datum jeho vytvoření. Komentář by měl začínat podpisem aplikace následovaným daty. Komentáře by neměly obsahovat data specifická pro pozici. Data specifická pro pozici určují umístění záznamu a neměla by být zahrnuta, protože jeden metasoubor může být vložen do jiného metasouboru. Tuto funkci lze použít pouze s rozšířenými metasoubory.

`CDC::AlphaBlend`

Voláním této členské funkce zobrazíte rastrové obrázky, které mají průhledné nebo poloprůhledné pixely.

BOOL AlphaBlend(
    int xDest,
    int yDest,
    int nDestWidth,
    int nDestHeight,
    CDC* pSrcDC,
    int xSrc,
    int ySrc,
    int nSrcWidth,
    int nSrcHeight,
    BLENDFUNCTION blend);

Parametry

xDest
Určuje souřadnici x v logických jednotkách v levém horním rohu cílového obdélníku.

yDest
Určuje souřadnici y v logických jednotkách v levém horním rohu cílového obdélníku.

nDestWidth
Určuje šířku cílového obdélníku v logických jednotkách.

nDestHeight
Určuje výšku cílového obdélníku v logických jednotkách.

pSrcDC
Ukazatel na kontext zdrojového zařízení

xSrc
Určuje souřadnici x v logických jednotkách v levém horním rohu zdrojového obdélníku.

ySrc
Určuje souřadnici y v logických jednotkách v levém horním rohu zdrojového obdélníku.

nSrcWidth
Určuje šířku zdrojového obdélníku v logických jednotkách.

nSrcHeight
Určuje výšku zdrojového obdélníku v logických jednotkách.

blend
Určuje BLENDFUNCTION strukturu.

Návratová hodnota

TRUE v případě úspěchu; jinak FALSE.

Poznámky

Další informace najdete AlphaBlend v sadě Windows SDK.

`CDC::AngleArc`

Nakreslí segment čáry a oblouk.

BOOL AngleArc(
    int x,
    int y,
    int nRadius,
    float fStartAngle,
    float fSweepAngle);

Parametry

x
Určuje logickou souřadnici x středu kruhu.

y
Určuje logickou souřadnici y středu kruhu.

nRadius
Určuje poloměr kruhu v logických jednotkách. Tato hodnota musí být kladná.

fStartAngle
Určuje počáteční úhel ve stupních vzhledem k ose x.

fSweepAngle
Určuje úhel úklidu ve stupních vzhledem k počátečnímu úhlu.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Segment čáry je nakreslen z aktuální pozice na začátek oblouku. Oblouk je nakreslen podél obvodu kruhu s daným poloměrem a středem. Délka oblouku je definována daným počátečním a uklidit úhly.

AngleArc přesune aktuální pozici na koncový bod oblouku. Oblouk nakreslený touto funkcí se může zdát eliptický v závislosti na aktuálním režimu transformace a mapování. Před nakreslením oblouku tato funkce nakreslí segment čáry z aktuální pozice na začátek oblouku. Oblouk je vykreslen vytvořením imaginárního kruhu se zadaným poloměrem kolem zadaného středového bodu. Počáteční bod oblouku je určen měřením proti směru hodinových ručiček z osy x kruhu počtem stupňů v počátečním úhlu. Koncový bod je podobně umístěn měřením proti směru hodinových ručiček od počátečního bodu počtem stupňů v úhlu úklidu.

Pokud je úhel úklidu větší než 360 stupňů, oblouk se několikrát protáhl. Tato funkce nakreslí čáry pomocí aktuálního pera. Obrázek není vyplněný.

`CDC::Arc`

Nakreslí elipsický oblouk.

BOOL Arc(
    int x1,
    int y1,
    int x2,
    int y2,
    int x3,
    int y3,
    int x4,
    int y4);

BOOL Arc(
    LPCRECT lpRect,
    POINT ptStart,
    POINT ptEnd);

Parametry

x1
Určuje souřadnici x levého horního rohu ohraničujícího obdélníku (v logických jednotkách).

y1
Určuje souřadnici y levého horního rohu ohraničujícího obdélníku (v logických jednotkách).

x2
Určuje souřadnici x pravého dolního rohu ohraničujícího obdélníku (v logických jednotkách).

y2
Určuje souřadnici y pravého dolního rohu ohraničujícího obdélníku (v logických jednotkách).

x3
Určuje souřadnici x bodu, který definuje výchozí bod oblouku (v logických jednotkách). Tento bod nemusí lhát přesně na oblouku.

y3
Určuje souřadnici y bodu, který definuje výchozí bod oblouku (v logických jednotkách). Tento bod nemusí lhát přesně na oblouku.

x4
Určuje souřadnici x bodu, který definuje koncový bod oblouku (v logických jednotkách). Tento bod nemusí lhát přesně na oblouku.

y4
Určuje souřadnici y bodu, který definuje koncový bod oblouku (v logických jednotkách). Tento bod nemusí lhát přesně na oblouku.

lpRect
Určuje ohraničující obdélník (v logických jednotkách). Pro tento parametr můžete předat objekt LPRECT nebo CRect objekt.

ptStart
Určuje souřadnice x a y bodu, který definuje výchozí bod oblouku (v logických jednotkách). Tento bod nemusí lhát přesně na oblouku. Pro tento parametr můžete předat POINT strukturu nebo CPoint objekt.

ptEnd
Určuje souřadnice x a y bodu, který definuje koncový bod oblouku (v logických jednotkách). Tento bod nemusí lhát přesně na oblouku. Pro tento parametr můžete předat POINT strukturu nebo CPoint objekt.

Návratová hodnota

Nenulové, pokud je funkce úspěšná; jinak 0.

Poznámky

Oblouk nakreslený pomocí funkce je segment tří teček definovaný zadaným ohraničujícím obdélníkem.

Skutečný počáteční bod oblouku je bod, ve kterém paprsek nakreslený ze středu ohraničujícího obdélníku přes zadaný počáteční bod protíná tři tečky. Skutečný koncový bod oblouku je bod, ve kterém paprsek nakreslený ze středu ohraničujícího obdélníku přes zadaný koncový bod protíná tři tečky. Oblouk je nakreslen proti směru hodinových ručiček. Vzhledem k tomu, že oblouk není uzavřený obrázek, není vyplněný. Šířka i výška obdélníku musí být větší než 2 jednotky a menší než 32 767 jednotek.

Příklad

void CDCView::DrawArc(CDC *pDC)
{
   // Fill the client area with a thin circle. The circle's
   // interior is not filled. The circle's perimeter is
   // blue from 6 o'clock to 3 o'clock and red from 3
   // o'clock to 6 o'clock.

   // Get the client area.
   CRect rectClient;
   GetClientRect(rectClient);

   // Make a couple of pens.
   CPen penBlue;
   CPen penRed;
   CPen *pOldPen;

   penBlue.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(0, 0, 255));
   penRed.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(255, 0, 0));

   // Draw from 3 o'clock to 6 o'clock, counterclockwise,
   // in a blue pen.

   pOldPen = pDC->SelectObject(&penBlue);

   pDC->Arc(rectClient,
            CPoint(rectClient.right, rectClient.CenterPoint().y),
            CPoint(rectClient.CenterPoint().x, rectClient.right));

   // Draw from 6 o'clock to 3 o'clock, counterclockwise,
   // in a red pen.
   pDC->SelectObject(&penRed);

   // Keep the same parameters, but reverse start
   // and end points.
   pDC->Arc(rectClient,
            CPoint(rectClient.CenterPoint().x, rectClient.right),
            CPoint(rectClient.right, rectClient.CenterPoint().y));

   // Restore the previous pen.
   pDC->SelectObject(pOldPen);
}

`CDC::ArcTo`

Nakreslí elipsický oblouk.

BOOL ArcTo(
    int x1,
    int y1,
    int x2,
    int y2,
    int x3,
    int y3,
    int x4,
    int y4);

BOOL ArcTo(
    LPCRECT lpRect,
    POINT ptStart,
    POINT ptEnd);