`CDC` osztály

Az eszközkörnyezeti objektumok osztályát határozza meg.

Syntax

class CDC : public CObject

Members

Public Constructors

Name	Description
`CDC::CDC`	Egy `CDC` objektumot hoz létre.

Public Methods

Name	Description
`CDC::AbortDoc`	Leállítja az aktuális nyomtatási feladatot, és töröl mindent, amit az alkalmazás írt az eszközre a `StartDoc` tagfüggvény utolsó hívása óta.
`CDC::AbortPath`	Bezárja és elveti az eszközkörnyezetben lévő elérési utakat.
`CDC::AddMetaFileComment`	Másolja a megjegyzést egy pufferből egy megadott továbbfejlesztett formátumú metafájlba.
`CDC::AlphaBlend`	Áttetsző vagy félig transzparens képpontokkal rendelkező bitképeket jelenít meg.
`CDC::AngleArc`	Rajzol egy vonalszegmenst és egy ívet, és az aktuális pozíciót az ív végpontjára helyezi.
`CDC::Arc`	Egy háromliptikus ívet rajzol.
`CDC::ArcTo`	Egy háromliptikus ívet rajzol. Ez a függvény hasonló `Arc`ahhoz, kivéve, hogy az aktuális pozíció frissül.
`CDC::Attach`	Windows-eszközkörnyezetet csatol ehhez az `CDC` objektumhoz.
`CDC::BeginPath`	Megnyílik egy elérésiút-zárójel az eszközkörnyezetben.
`CDC::BitBlt`	Bitkép másolása egy megadott eszközkörnyezetből.
`CDC::Chord`	Von egy húrt (egy három pont és egy vonalszegmens metszete által határolt zárt alakzatot).
`CDC::CloseFigure`	Bezár egy nyitott ábrát egy elérési úton.
`CDC::CreateCompatibleDC`	Olyan memória-eszköz környezetet hoz létre, amely kompatibilis egy másik eszközkörnyezettel. Ezzel előkészítheti a memóriában lévő képeket.
`CDC::CreateDC`	Eszközkörnyezetet hoz létre egy adott eszközhöz.
`CDC::CreateIC`	Egy adott eszköz információs környezetét hozza létre. Így gyorsan lekérheti az eszköz adatait anélkül, hogy eszközkörnyezetet hoz létre.
`CDC::DeleteDC`	Törli az objektumhoz `CDC` társított Windows-eszközkörnyezetet.
`CDC::DeleteTempMap`	Az üresjárati idő kezelője `CWinApp` meghívta a rendszer által létrehozott `CDC`ideiglenes `FromHandle` objektumok törlésére. Leválasztja az eszközkörnyezetet is.
`CDC::Detach`	Leválasztja a Windows-eszközkörnyezetet erről az `CDC` objektumról.
`CDC::DPtoHIMETRIC`	Az eszközegységeket egységekké `HIMETRIC` alakítja.
`CDC::DPtoLP`	Az eszközegységeket logikai egységekké alakítja.
`CDC::Draw3dRect`	Háromdimenziós téglalapot rajzol.
`CDC::DrawDragRect`	Húzás közben törli és újrarajzolta a téglalapot.
`CDC::DrawEdge`	Egy téglalap széleit rajzolja meg.
`CDC::DrawEscape`	A grafikus eszköz felületén (GDI) keresztül közvetlenül nem elérhető videómegjelenítés rajzfunkcióihoz fér hozzá.
`CDC::DrawFocusRect`	A fókusz jelzésére használt stílusban téglalapot rajzol.
`CDC::DrawFrameControl`	Keretvezérlő rajzolása.
`CDC::DrawIcon`	Rajzol egy ikont.
`CDC::DrawState`	Megjelenít egy képet, és vizualizációs effektust alkalmaz az állapot jelzésére.
`CDC::DrawText`	Formázott szöveget rajzol a megadott téglalapban.
`CDC::DrawTextEx`	Formázott szöveget rajzol a megadott téglalapban más formátumok használatával.
`CDC::Ellipse`	Három pontot rajzol.
`CDC::EndDoc`	A tagfüggvény által `StartDoc` indított nyomtatási feladat befejezése.
`CDC::EndPage`	Tájékoztatja az eszközillesztőt, hogy egy oldal véget ér.
`CDC::EndPath`	Bezár egy elérésiút-szögletes zárójelet, és kiválasztja a szögletes zárójel által definiált útvonalat az eszközkörnyezetbe.
`CDC::EnumObjects`	Az eszközkörnyezetben elérhető tollak és ecsetek számbavétele.
`CDC::Escape`	Lehetővé teszi az alkalmazások számára, hogy elérhessék azokat a létesítményeket, amelyek nem érhetők el közvetlenül egy adott eszközről a GDI-en keresztül. Emellett lehetővé teszi a Windows-feloldó függvények elérését is. Az alkalmazás által indított feloldóhívásokat a rendszer lefordítja és elküldi az eszközillesztőnek.
`CDC::ExcludeClipRect`	Létrehoz egy új kivágási régiót, amely a meglévő kivágási régióból és a megadott téglalapból áll.
`CDC::ExcludeUpdateRgn`	Megakadályozza, hogy az ablak érvénytelen területein belül rajzoljon, ha kizár egy frissített régiót az ablakban egy kivágási régióból.
`CDC::ExtFloodFill`	Kitölt egy területet az aktuális ecsettel. Nagyobb rugalmasságot biztosít, mint a `CDC::FloodFill` tagfüggvény.
`CDC::ExtTextOut`	Egy négyszögletes régióban lévő karaktersztringet ír az aktuálisan kijelölt betűtípussal.
`CDC::FillPath`	Bezárja az aktuális útvonal minden nyitott ábráját, és kitölti az útvonal belső terét az aktuális ecset és sokszög kitöltési móddal.
`CDC::FillRect`	Egy adott téglalapot egy adott ecsettel tölt ki.
`CDC::FillRgn`	Kitölt egy adott régiót a megadott ecsettel.
`CDC::FillSolidRect`	Egy téglalap kitöltése egyszínű színnel.
`CDC::FlattenPath`	Átalakítja a kijelölt elérési út görbéit az aktuális eszközkörnyezetbe, és az egyes görbéket vonalak sorozatává alakítja.
`CDC::FloodFill`	Kitölt egy területet az aktuális ecsettel.
`CDC::FrameRect`	Szegélyt rajzol egy téglalap köré.
`CDC::FrameRgn`	Ecsettel szegélyt rajzol egy adott régió körül.
`CDC::FromHandle`	Mutatót ad vissza egy `CDC` objektumhoz, ha egy fogópontot ad egy eszközkörnyezetnek. Ha egy `CDC` objektum nincs csatolva a leíróhoz, egy ideiglenes `CDC` objektum jön létre és csatolva.
`CDC::GetArcDirection`	Az eszközkörnyezet aktuális ívirányát adja vissza.
`CDC::GetAspectRatioFilter`	Lekéri az aktuális méretarány-szűrő beállításait.
`CDC::GetBkColor`	Lekéri az aktuális háttérszínt.
`CDC::GetBkMode`	Lekéri a háttérmódot.
`CDC::GetBoundsRect`	A megadott eszközkörnyezet aktuális halmozott határolókeretét adja vissza.
`CDC::GetBrushOrg`	Lekéri az aktuális ecset eredetét.
`CDC::GetCharABCWidths`	Lekéri egy adott tartomány egymást követő karaktereinek szélességét logikai egységekben az aktuális betűtípustól.
`CDC::GetCharABCWidthsI`	Lekéri az egymást követő karakterjelindexek szélességét logikai egységekben egy megadott tartományban az aktuális TrueType betűtípustól.
`CDC::GetCharacterPlacement`	Egy karaktersztring különböző típusú információit kéri le.
`CDC::GetCharWidth`	Egy adott tartomány egymást követő karaktereinek törtszélességeit kéri le az aktuális betűtípusból.
`CDC::GetCharWidthI`	Lekéri az egymást követő karakterjelindexek szélességét logikai koordinátákban egy megadott tartományban az aktuális betűtípustól.
`CDC::GetClipBox`	Lekéri az aktuális kivágási határ körüli legszűkebb határoló téglalap méreteit.
`CDC::GetColorAdjustment`	Lekéri az eszközkörnyezet színbeállítási értékeit.
`CDC::GetCurrentBitmap`	Az aktuálisan kijelölt objektumra mutató mutatót ad `CBitmap` vissza.
`CDC::GetCurrentBrush`	Az aktuálisan kijelölt objektumra mutató mutatót ad `CBrush` vissza.
`CDC::GetCurrentFont`	Az aktuálisan kijelölt objektumra mutató mutatót ad `CFont` vissza.
`CDC::GetCurrentPalette`	Az aktuálisan kijelölt objektumra mutató mutatót ad `CPalette` vissza.
`CDC::GetCurrentPen`	Az aktuálisan kijelölt objektumra mutató mutatót ad `CPen` vissza.
`CDC::GetCurrentPosition`	Lekéri a toll aktuális pozícióját (logikai koordinátákban).
`CDC::GetDCBrushColor`	Lekéri az aktuális ecsetszínt.
`CDC::GetDCPenColor`	Lekéri a toll aktuális színét.
`CDC::GetDeviceCaps`	Adott típusú eszközspecifikus információkat kér le egy adott megjelenítési eszköz képességeiről.
`CDC::GetFontData`	Lekéri a betűmetrika adatait egy méretezhető betűtípusfájlból. A lekérni kívánt információ a betűtípusfájl eltolásának és a visszaadandó információk hosszának megadásával azonosítható.
`CDC::GetFontLanguageInfo`	A megadott megjelenítési környezethez jelenleg kijelölt betűtípussal kapcsolatos információkat adja vissza.
`CDC::GetGlyphOutline`	Lekéri a vázlatgörbét vagy a bitképet az aktuális betűtípusban lévő szerkezeti karakterhez.
`CDC::GetGraphicsMode`	Lekéri a megadott eszközkörnyezet aktuális grafikus módját.
`CDC::GetHalftoneBrush`	Lekéri a félhangos ecsetet.
`CDC::GetKerningPairs`	Lekéri a megadott eszközkörnyezetben jelenleg kijelölt betűtípus karakterkerítési párjait.
`CDC::GetLayout`	Lekéri az eszközkörnyezet (DC) elrendezését. Az elrendezés lehet balról jobbra (alapértelmezett) vagy jobbról balra (tükrözött).
`CDC::GetMapMode`	Lekéri az aktuális leképezési módot.
`CDC::GetMiterLimit`	Az eszközkörnyezet korlátját adja vissza.
`CDC::GetNearestColor`	Lekéri a legközelebbi logikai színt egy adott logikai színhez, amelyet az adott eszköz képviselhet.
`CDC::GetOutlineTextMetrics`	Beolvassa a TrueType betűtípusok betűmetrikáinak adatait.
`CDC::GetOutputCharWidth`	Lekéri az egyes karakterek szélességét egy egymást követő karaktercsoportban az aktuális betűtípusból a kimeneti eszköz környezetével.
`CDC::GetOutputTabbedTextExtent`	Kiszámítja egy karaktersztring szélességét és magasságát a kimeneti eszköz környezetében.
`CDC::GetOutputTextExtent`	Kiszámítja egy szövegsor szélességét és magasságát a kimeneti eszköz környezetében az aktuális betűtípussal a méretek meghatározásához.
`CDC::GetOutputTextMetrics`	Lekéri az aktuális betűtípus metrikáit a kimeneti eszköz környezetéből.
`CDC::GetPath`	Lekéri a vonalak végpontjait meghatározó koordinátákat és az eszközkörnyezetbe kijelölt útvonalon található görbék vezérlőpontjait.
`CDC::GetPixel`	Lekéri a képpont RGB-színértékét a megadott ponton.
`CDC::GetPolyFillMode`	Lekéri az aktuális sokszögkitöltési módot.
`CDC::GetROP2`	Lekéri az aktuális rajzmódot.
`CDC::GetSafeHdc`	Visszaadja `CDC::m_hDC`a kimeneti eszköz környezetét.
`CDC::GetStretchBltMode`	Lekéri az aktuális bitkép-nyújtás módot.
`CDC::GetTabbedTextExtent`	Kiszámítja egy karaktersztring szélességét és magasságát az attribútumeszköz környezetében.
`CDC::GetTextAlign`	Lekéri a szövegigazítási jelzőket.
`CDC::GetTextCharacterExtra`	Lekéri az aktuális beállítást az intercharacter térközének mennyiségéhez.
`CDC::GetTextColor`	Lekéri az aktuális szövegszínt.
`CDC::GetTextExtent`	Kiszámítja egy szövegsor szélességét és magasságát az attribútumeszköz környezetében az aktuális betűtípussal a dimenziók meghatározásához.
`CDC::GetTextExtentExPointI`	Lekéri egy adott sztring azon karaktereinek számát, amelyek elférnek egy adott területen belül, és kitölt egy tömböt az egyes karakterek szövegének terjedelmével.
`CDC::GetTextExtentPointI`	Lekéri a megadott karakterjelindexek tömbjének szélességét és magasságát.
`CDC::GetTextFace`	Az aktuális betűtípus betűtípusának nevét null értékű sztringként másolja egy pufferbe.
`CDC::GetTextMetrics`	Lekéri az aktuális betűtípus metrikáit az attribútumeszköz környezetéből.
`CDC::GetViewportExt`	Lekéri a nézetport x és y kiterjedésű részeit.
`CDC::GetViewportOrg`	Lekéri a nézetport forrásának x és y koordinátáit.
`CDC::GetWindow`	A megjelenítési eszköz környezetéhez társított ablakot adja vissza.
`CDC::GetWindowExt`	Lekéri a társított ablak x és y kiterjedéseit.
`CDC::GetWindowOrg`	Lekéri a társított ablak eredetének x és y koordinátáit.
`CDC::GetWorldTransform`	Lekéri az aktuális világteret a laptér átalakításához.
`CDC::GradientFill`	Téglalap- és háromszögszerkezeteket tölt ki osztályozási színnel.
`CDC::GrayString`	Halványított (szürkén) szöveget rajzol az adott helyen.
`CDC::HIMETRICtoDP`	A HIMETRIC egységeket eszközegységekké alakítja.
`CDC::HIMETRICtoLP`	A HIMETRIC-egységeket logikai egységekké alakítja.
`CDC::IntersectClipRect`	Új kivágási régiót hoz létre az aktuális régió metszetének és egy téglalapnak a kialakításával.
`CDC::InvertRect`	Egy téglalap tartalmának megfordítása.
`CDC::InvertRgn`	Egy régió színeinek megfordítása.
`CDC::IsPrinting`	Meghatározza, hogy az eszközkörnyezetet használja-e nyomtatáshoz.
`CDC::LineTo`	Egy vonalat rajzol az aktuális pozíciótól egy pontig, de nem beleértendőig.
`CDC::LPtoDP`	A logikai egységeket eszközegységekké alakítja.
`CDC::LPtoHIMETRIC`	A logikai egységeket HIMETRIC-egységekké alakítja.
`CDC::MaskBlt`	A forrás- és célbitképek színadatait egyesíti az adott maszk és raszter művelettel.
`CDC::ModifyWorldTransform`	Az eszközkörnyezet világátalakítását a megadott mód használatával módosítja.
`CDC::MoveTo`	Az aktuális pozíció áthelyezése.
`CDC::OffsetClipRgn`	Áthelyezi az adott eszköz kivágási régióját.
`CDC::OffsetViewportOrg`	Módosítja a nézetport forrását az aktuális nézetport-forrás koordinátáihoz képest.
`CDC::OffsetWindowOrg`	Módosítja az ablak eredetét az aktuális ablak forrásának koordinátáihoz viszonyítva.
`CDC::PaintRgn`	Kitölt egy régiót a kijelölt ecsettel.
`CDC::PatBlt`	Létrehoz egy bitmintát.
`CDC::Pie`	Kör alakú ék rajzolása.
`CDC::PlayMetaFile`	A megadott metafájl tartalmát játssza le az adott eszközön. A továbbfejlesztett verzió `PlayMetaFile` megjeleníti az adott továbbfejlesztett formátumú metafájlban tárolt képet. A metafájl tetszőleges számú alkalommal lejátszható.
`CDC::PlgBlt`	Bitblokkos átvitelt hajt végre a színadatok bitjeinek a forráseszköz környezetében megadott téglalapból a megadott párhuzamossági értékre az adott eszközkörnyezetben.
`CDC::PolyBezier`	Egy vagy több Bzier splines rajzolása. Az aktuális pozíció nincs használatban vagy frissítve.
`CDC::PolyBezierTo`	Egy vagy több Bzier spline rajzolása, majd az aktuális pozíció áthelyezése az utolsó Bzier spline végpontjára.
`CDC::PolyDraw`	Vonalszegmenseket és Bzier-gördvonalakat rajzol. Ez a függvény frissíti az aktuális pozíciót.
`CDC::Polygon`	Vonallal összekapcsolt két vagy több pontból (csúcspontból) álló sokszöget rajzol.
`CDC::Polyline`	A megadott pontokat összekötő vonalszegmensek halmazát rajzolja meg.
`CDC::PolylineTo`	Egy vagy több egyenes vonal rajzolása, és az aktuális pozíció áthelyezése az utolsó sor végpontjára.
`CDC::PolyPolygon`	Két vagy több olyan sokszöget hoz létre, amelyek az aktuális sokszögkitöltési móddal vannak kitöltve. A sokszögek különállóak lehetnek, vagy átfedésben lehetnek.
`CDC::PolyPolyline`	Több összekapcsolt vonalszakaszt rajzol. A függvény nem használja vagy frissíti az aktuális pozíciót.
`CDC::PtVisible`	Megadja, hogy az adott pont a kivágási régión belül van-e.
`CDC::RealizePalette`	Az aktuális logikai palettán lévő palettabejegyzéseket a rendszerkatalógusra képezi le.
`CDC::Rectangle`	Téglalapot rajzol az aktuális tollal, és kitölti az aktuális ecsettel.
`CDC::RectVisible`	Meghatározza, hogy a megadott téglalap bármely része a kivágási régión belül található-e.
`CDC::ReleaseAttribDC`	`m_hAttribDC`Kiadások , az attribútumeszköz-környezet.
`CDC::ReleaseOutputDC`	`m_hDC`Kiadások , a kimeneti eszköz környezete.
`CDC::ResetDC`	Frissíti az `m_hAttribDC` eszközkörnyezetet.
`CDC::RestoreDC`	Visszaállítja az eszközkörnyezetet a következővel mentett korábbi állapotra `SaveDC`: .
`CDC::RoundRect`	Egy téglalapot rajzol lekerekített sarkokkal az aktuális tollal, és kitölti az aktuális ecsettel.
`CDC::SaveDC`	Menti az eszközkörnyezet aktuális állapotát.
`CDC::ScaleViewportExt`	Módosítja a nézetportok mértékét az aktuális értékekhez képest.
`CDC::ScaleWindowExt`	Módosítja az ablak terjedelmét az aktuális értékekhez képest.
`CDC::ScrollDC`	Vízszintesen és függőlegesen görgeti a bitek téglalapját.
`CDC::SelectClipPath`	Kiválasztja az aktuális elérési utat az eszközkörnyezet kivágási régiójaként, és a megadott móddal kombinálja az új régiót bármely meglévő kivágási régióval.
`CDC::SelectClipRgn`	A megadott móddal egyesíti az adott régiót az aktuális kivágási régióval.
`CDC::SelectObject`	Kiválaszt egy GDI rajzobjektumot, például tollat.
`CDC::SelectPalette`	Kiválasztja a logikai palettát.
`CDC::SelectStockObject`	Kiválasztja a Windows által biztosított előre definiált tollak, ecsetek vagy betűtípusok egyikét.
`CDC::SetAbortProc`	Beállít egy programozó által megadott visszahívási függvényt, amelyet a Windows hív meg, ha egy nyomtatási feladatot le kell szakítanak.
`CDC::SetArcDirection`	Beállítja az ív- és téglalapfüggvényekhez használandó rajzirányt.
`CDC::SetAttribDC`	Beállítja `m_hAttribDC`az attribútumeszköz környezetét.
`CDC::SetBkColor`	Beállítja az aktuális háttérszínt.
`CDC::SetBkMode`	Beállítja a háttérmódot.
`CDC::SetBoundsRect`	A megadott eszközkörnyezethez tartozó határolókeret-információk felhalmozódását szabályozza.
`CDC::SetBrushOrg`	Megadja az eszközkörnyezetbe kijelölt következő ecset forrását.
`CDC::SetColorAdjustment`	Az eszközkörnyezet színbeállítási értékeit a megadott értékekkel állítja be.
`CDC::SetDCBrushColor`	Beállítja az aktuális ecsetszínt.
`CDC::SetDCPenColor`	Beállítja az aktuális tollszínt.
`CDC::SetGraphicsMode`	Beállítja az aktuális grafikus módot a megadott eszközkörnyezethez.
`CDC::SetLayout`	Az eszközkörnyezet (DC) elrendezésének módosítása.
`CDC::SetMapMode`	Beállítja az aktuális leképezési módot.
`CDC::SetMapperFlags`	Módosítja a betűtípus-leképező által használt algoritmust, amikor logikai betűtípusokat képez le fizikai betűtípusokra.
`CDC::SetMiterLimit`	Beállítja az eszközkörnyezethez tartozó gércsatlakozások hosszának korlátját.
`CDC::SetOutputDC`	A kimeneti eszköz környezetének beállítása `m_hDC`.
`CDC::SetPixel`	Beállítja a képpontot a megadott ponton a megadott szín legközelebbi közelítésére.
`CDC::SetPixelV`	Beállítja a képpontot a megadott koordinátákon a megadott szín legközelebbi közelítésére. `SetPixelV` gyorsabb, mint `SetPixel` mert nem kell visszaadnia a pont színértékét.
`CDC::SetPolyFillMode`	Beállítja a sokszög kitöltési módot.
`CDC::SetROP2`	Beállítja az aktuális rajzmódot.
`CDC::SetStretchBltMode`	Beállítja a bitkép-nyújtás módot.
`CDC::SetTextAlign`	Beállítja a szövegigazítási jelzőket.
`CDC::SetTextCharacterExtra`	Beállítja az intercharacter térközét.
`CDC::SetTextColor`	Beállítja a szöveg színét.
`CDC::SetTextJustification`	Szóközt ad a sztring töréskaraktereihez.
`CDC::SetViewportExt`	Beállítja a nézetport x és y kiterjedésű részeit.
`CDC::SetViewportOrg`	Beállítja a nézet forrását.
`CDC::SetWindowExt`	Beállítja a társított ablak x és y kiterjedéseit.
`CDC::SetWindowOrg`	Beállítja az eszközkörnyezet ablakának eredetét.
`CDC::SetWorldTransform`	Az aktuális világteret oldaltér-átalakításra állítja.
`CDC::StartDoc`	Tájékoztatja az eszközillesztőt, hogy egy új nyomtatási feladat indul el.
`CDC::StartPage`	Tájékoztatja az eszközillesztőt, hogy egy új lap indul el.
`CDC::StretchBlt`	A bitképet áthelyezi egy forrás téglalapból és eszközből egy cél téglalapba, és szükség esetén kinyújtja vagy tömöríti a bitképet, hogy elférjen a cél téglalap mérete.
`CDC::StrokeAndFillPath`	Bezárja az elérési út nyitott ábráit, az aktuális tollal megüti az út körvonalát, és az aktuális ecsettel kitölti a belső térét.
`CDC::StrokePath`	A megadott elérési utat az aktuális tollal jeleníti meg.
`CDC::TabbedTextOut`	Karaktersztringet ír egy megadott helyre, és a tabulátorpozíciók tömbjében megadott értékekre bontja a tabulátorokat.
`CDC::TextOut`	Egy karaktersztringet ír egy megadott helyre az aktuálisan kijelölt betűtípus használatával.
`CDC::TransparentBlt`	A színadatok bitblokkját a megadott forráseszköz-környezetből egy céleszköz-környezetbe továbbítja, és transzparenssé teszi a megadott színt az átvitelben.
`CDC::UpdateColors`	Frissíti az eszközkörnyezet ügyfélterületét úgy, hogy képpontonként megfelelteti az ügyfélterület aktuális színeit a rendszerkatalógusnak.
`CDC::WidenPath`	Az aktuális útvonal újradefiniálja azt a területet, amely akkor lenne festve, ha az elérési utat az eszköz környezetébe jelenleg kijelölt tollal vonnák be.

Public Operators

Name	Description
`CDC::operator HDC`	Lekéri az eszközkörnyezet leíróját.

Nyilvános adatok tagjai

Name	Description
`CDC::m_hAttribDC`	Az objektum által `CDC` használt attribútum-eszköz környezet.
`CDC::m_hDC`	Az objektum által `CDC` használt kimeneti-eszköz környezet.

Remarks

Az CDC objektum tagfüggvényeket biztosít az eszközkörnyezetek, például kijelzők vagy nyomtatók használatához, valamint az ablak ügyfélterületéhez társított megjelenítési környezettel kapcsolatos tagok számára.

Végezze el az objektumok tagfüggvényeinek végigrajzolását CDC . Az osztály tagfüggvényeket biztosít az eszközkörnyezeti műveletekhez, a rajzeszközökkel való munkához, a típusbiztos grafikus eszközillesztő (GDI) objektum kiválasztásához, valamint a színek és paletták kezeléséhez. Tagfüggvényeket is biztosít a rajzattribútumok lekéréséhez és beállításához, a leképezéshez, a nézetporttal való munkához, az ablak kiterjedésének kezeléséhez, a koordináták konvertálásához, a régiókkal való munkához, a kivágáshoz, a rajzvonalakhoz és az egyszerű alakzatok, három pontra és sokszögek rajzolásához. A tagfüggvények a szöveg rajzolására, a betűtípusok használatára, a nyomtató menekülésére, a görgetésre és a metafájlok lejátszására is használhatók.

Objektum CDC használatához hozza létre, majd hívja meg az eszközkörnyezetet használó Windows-függvényeket párhuzamos tagfüggvényeket.

Note

A Windows 95/98 rendszerben az összes képernyőkoordináta 16 bitre korlátozódik. Ezért a int tagfüggvénynek átadott függvénynek CDC a -32768 és a 32767 közötti tartományban kell lennie.

Bizonyos célokra a Microsoft Foundation osztálykönyvtára több osztályt CDC is biztosít. CPaintDC beágyazza a hívásokat a következőre BeginPaint : és EndPaint. CClientDC kezeli az ablak ügyfélterületéhez társított megjelenítési környezetet. CWindowDC Egy teljes ablakhoz társított megjelenítési környezetet kezel, beleértve annak keretét és vezérlőit is. CMetaFileDC egy eszközkörnyezetet társít egy metafájlhoz.

CDC két tagfüggvényt biztosít, GetLayout és SetLayoutaz eszközkörnyezet elrendezésének megfordítására, amely nem örökli az elrendezését egy ablakból. Ilyen jobbról balra tájolás szükséges olyan kultúrákhoz írt alkalmazásokhoz, mint az arab vagy a héber, ahol a karakterelrendezés nem európai szabvány.

CDC két eszközkörnyezetet tartalmaz, m_hDC és m_hAttribDCamelyek egy CDC objektum létrehozásakor ugyanarra az eszközre hivatkoznak. CDC Az összes kimeneti GDI-hívást a GDI-hívásokhoz irányítja, m_hDC és a legtöbb attribútumot a következőre m_hAttribDCirányítja: . (Az attribútumhívásra GetTextColorpélda, míg SetTextColor kimeneti hívás.)

A keretrendszer például ezt a két eszközkörnyezetet használja egy CMetaFileDC objektum implementálásához, amely kimenetet küld egy metafájlnak, miközben attribútumokat olvas egy fizikai eszközről. A nyomtatási kép hasonló módon van implementálva a keretrendszerben. A két eszközkörnyezetet az alkalmazásspecifikus kódhoz hasonlóan is használhatja.

Előfordulhat, hogy szöveges metrikaadatokra van szüksége mind az eszközkörnyezetből, mind pedig az m_hDCm_hAttribDC eszközkörnyezetből. A következő függvénypárok biztosítják ezt a képességet:

Uses m_hAttribDC	Uses m_hDC
`GetTextExtent`	`GetOutputTextExtent`
`GetTabbedTextExtent`	`GetOutputTabbedTextExtent`
`GetTextMetrics`	`GetOutputTextMetrics`
`GetCharWidth`	`GetOutputCharWidth`

További információ: CDCEszközkörnyezetek.

Inheritance Hierarchy

CObject

CDC

Requirements

Header:afxwin.h

`CDC::AbortDoc`

Leállítja az aktuális nyomtatási feladatot, és törli az alkalmazás által az eszközre írt összes adatot a StartDoc tagfüggvény utolsó hívása óta.

int AbortDoc();

Return Value

Sikeres esetben 0-nál nagyobb vagy egyenlő érték, hiba esetén negatív érték. Az alábbi lista a gyakori hibaértékeket és jelentésüket mutatja be:

SP_ERROR Általános hiba.
SP_OUTOFDISK Jelenleg nem áll rendelkezésre elegendő lemezterület a várólistához, és nem lesz több szabad hely.
SP_OUTOFMEMORY Nincs elegendő memória a várólistához.
SP_USERABORT A felhasználó megszakította a feladatot a Nyomtatókezelőn keresztül.

Remarks

Ez a tagfüggvény helyettesíti a nyomtató menekülését ABORTDOC .

AbortDoc a következők leállításához kell használni:

Olyan nyomtatási műveletek, amelyek nem adnak meg megszakításfüggvényt a használatával SetAbortProc.
Azok a nyomtatási műveletek, amelyek még nem érték el az első NEWFRAME vagy NEXTBAND a menekülési hívásukat.

Ha egy alkalmazás nyomtatási hibát vagy megszakított nyomtatási műveletet tapasztal, nem kísérelheti meg a műveletet az osztály CDCvagy AbortDoc a EndDoc tagfüggvények használatával leállítani. A GDI a hibaérték visszaadása előtt automatikusan leállítja a műveletet.

Ha az alkalmazás megjelenít egy párbeszédpanelt, amely lehetővé teszi, hogy a felhasználó megszakítsa a nyomtatási műveletet, a párbeszédpanel megsemmisítése előtt fel kell hívnia AbortDoc .

Ha a Nyomtatási kezelővel indítják el a nyomtatási feladatot, a hívás AbortDoc törli a teljes nyomtatásisor-feladatot – a nyomtató semmit sem kap. Ha a Nyomtatókezelőt nem használták a nyomtatási feladat elindításához, előfordulhat, hogy az adatok a hívás előtt AbortDoc lettek elküldve a nyomtatónak. Ebben az esetben a nyomtatóillesztő alaphelyzetbe állította a nyomtatót (ha lehetséges), és bezárta a nyomtatási feladatot.

Example

Lásd a példát a CDC::StartDoc.

`CDC::AbortPath`

Bezárja és elveti az eszközkörnyezetben lévő elérési utakat.

BOOL AbortPath();

Return Value

Nonzero, ha a függvény sikeres; egyéb esetben 0.

Remarks

Ha az eszközkörnyezetben van egy nyitott elérésiút-szögletes zárójel, az elérési út szögletes zárójele bezárul, és az elérési út el lesz vetve. Ha az eszközkörnyezetben van egy zárt elérési út, a rendszer elveti az elérési utat.

`CDC::AddMetaFileComment`

Másolja a megjegyzést egy pufferből egy megadott továbbfejlesztett formátumú metafájlba.

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

Parameters

nDataSize
A megjegyzéspuffer bájtban megadott hosszát adja meg.

pCommentData
A megjegyzést tartalmazó pufferre mutat.

Return Value

Nonzero, ha a függvény sikeres; egyéb esetben 0.

Remarks

A megjegyzések tartalmazhatnak bármilyen személyes információt – például a kép forrását és a létrehozás dátumát. A megjegyzésnek egy alkalmazás-aláírással kell kezdődnie, amelyet az adatok követnek. A megjegyzések nem tartalmazhatnak pozícióspecifikus adatokat. A helyspecifikus adatok egy rekord helyét határozzák meg, és nem szabad belefoglalni, mert előfordulhat, hogy egy metafájl egy másik metafájlba van beágyazva. Ez a függvény csak továbbfejlesztett metafájlokkal használható.

`CDC::AlphaBlend`

Ennek a tagfüggvénynek a meghívása áttetsző vagy félig transzparens képpontokkal rendelkező bitképek megjelenítéséhez.

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

Parameters

xDest
A cél téglalap bal felső sarkának x koordinátáját adja meg logikai egységekben.

yDest
A cél téglalap bal felső sarkának y koordinátáját adja meg logikai egységekben.

nDestWidth
A cél téglalap szélességét adja meg logikai egységekben.

nDestHeight
A cél téglalap magasságát adja meg logikai egységekben.

pSrcDC
Mutató a forráseszköz környezetére.

xSrc
A forrás téglalap bal felső sarkának x koordinátáját adja meg logikai egységekben.

ySrc
A forrás téglalap bal felső sarkának y koordinátáját adja meg logikai egységekben.

nSrcWidth
A forrás téglalap szélességét adja meg logikai egységekben.

nSrcHeight
A forrás téglalap magasságát adja meg logikai egységekben.

blend
Egy struktúrát BLENDFUNCTION határoz meg.

Return Value

sikeres TRUE; egyéb esetben FALSE.

Remarks

További AlphaBlend információt a Windows SDK-ban talál.

`CDC::AngleArc`

Vonalszegmens és ív rajzolása.

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

Parameters

x
A kör középpontjának logikai x koordinátáját adja meg.

y
A kör középpontjának logikai y koordinátáját adja meg.

nRadius
Logikai egységekben adja meg a kör sugarát. Ennek az értéknek pozitívnak kell lennie.

fStartAngle
Megadja az x tengelyhez viszonyított kezdő szöget fokban.

fSweepAngle
A kezdő szöghez viszonyított fokban adja meg a söprési szöget.

Return Value

Nonzero, ha sikeres; egyéb esetben 0.

Remarks

A vonalszegmens az aktuális pozíciótól az ív elejéig húzódik. Az ívet egy kör szegélye mentén rajzolják meg a megadott sugárral és középponttal. Az ív hosszát a megadott kezdő- és söprési szögek határozzák meg.

AngleArc az aktuális pozíciót az ív végpontjára helyezi át. A függvény által rajzolt ív az aktuális átalakítási és leképezési módtól függően elliptikusnak tűnhet. Az ív rajzolása előtt ez a függvény az aktuális pozíciótól az ív elejéig rajzolja a vonalszegmenst. Az ívet úgy rajzolja meg, hogy egy képzeletbeli kört hoz létre a megadott sugárral a megadott középpont körül. Az ív kezdőpontját úgy határozzuk meg, hogy az óramutató járásával ellentétes irányban méri a kör x tengelyét a kezdő szögben lévő fokok számával. A végpont hasonlóképpen helyezkedik el úgy, hogy az óramutató járásával ellentétes irányban méri a kezdőpontot a söprési szögben lévő fokok számával.

Ha a söprési szög nagyobb, mint 360 fok, az ívet többször söpörik. Ez a függvény vonalakat rajzol az aktuális tollal. Az ábra nincs kitöltve.

`CDC::Arc`

Egy háromliptikus ívet rajzol.

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);

Parameters

x1
A határoló téglalap bal felső sarkának x koordinátáját adja meg (logikai egységekben).

y1
A határoló téglalap bal felső sarkának y koordinátáját adja meg (logikai egységekben).

x2
A határoló téglalap jobb alsó sarkának x koordinátáját adja meg (logikai egységekben).

y2
A határoló téglalap jobb alsó sarkának y koordinátáját adja meg (logikai egységekben).

x3
Az ív kiindulási pontját meghatározó pont x koordinátáját adja meg (logikai egységekben). Ennek a pontnak nem kell pontosan az íven feküdnie.

y3
Az ív kiindulási pontját meghatározó pont y koordinátáját adja meg (logikai egységekben). Ennek a pontnak nem kell pontosan az íven feküdnie.

x4
Az arc végpontját meghatározó pont x koordinátáját adja meg (logikai egységekben). Ennek a pontnak nem kell pontosan az íven feküdnie.

y4
Az arc végpontját meghatározó pont y koordinátáját adja meg (logikai egységekben). Ennek a pontnak nem kell pontosan az íven feküdnie.

lpRect
A határoló téglalapot adja meg (logikai egységekben). A paraméterhez átadhat egy LPRECT vagy egy CRect objektumot.

ptStart
Az ív kiindulási pontját meghatározó pont x- és y koordinátáit adja meg (logikai egységekben). Ennek a pontnak nem kell pontosan az íven feküdnie. Ennek a paraméternek egy struktúrát POINT vagy objektumot CPoint is átadhat.

ptEnd
Az ív végpontját meghatározó pont x- és y koordinátáit adja meg (logikai egységekben). Ennek a pontnak nem kell pontosan az íven feküdnie. Ennek a paraméternek egy struktúrát POINT vagy objektumot CPoint is átadhat.

Return Value

Nonzero, ha a függvény sikeres; egyéb esetben 0.

Remarks

A függvény használatával rajzolt ív a megadott határolókeret által meghatározott három pont szegmense.

Az ív tényleges kiindulási pontja az a pont, ahol a határoló téglalap közepéről a megadott kezdőponton át rajzolt sugár metszi a három pontot. Az ív tényleges végpontja az a pont, ahol a határoló téglalap közepéről a megadott végponton át rajzolt sugár metszi a három pontot. Az ív az óramutató járásával ellentétes irányban van rajzolva. Mivel az ívek nem zárt ábrák, nincs kitöltve. A téglalap szélességének és magasságának egyaránt 2 egységnél nagyobbnak és 32 767 egységnél kisebbnek kell lennie.

Example

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`

Egy háromliptikus ívet rajzol.

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);