`CDC` Klasa

Artykuł
04/07/2023

Definiuje klasę obiektów kontekstu urządzenia.

Składnia

class CDC : public CObject

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
`CDC::CDC`	`CDC` Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
`CDC::AbortDoc`	Przerywa bieżące zadanie drukowania, wymazując wszystko, co aplikacja zapisała na urządzeniu od ostatniego wywołania funkcji składowej `StartDoc` .
`CDC::AbortPath`	Zamyka i odrzuca wszystkie ścieżki w kontekście urządzenia.
`CDC::AddMetaFileComment`	Kopiuje komentarz z buforu do określonego metapliku w formacie rozszerzonym.
`CDC::AlphaBlend`	Wyświetla mapy bitowe, które mają przezroczyste lub półprzezroczyste piksele.
`CDC::AngleArc`	Rysuje segment liniowy i łuk oraz przenosi bieżącą pozycję do punktu końcowego łuku.
`CDC::Arc`	Rysuje łuk wielokropowy.
`CDC::ArcTo`	Rysuje łuk wielokropowy. Ta funkcja jest podobna do `Arc`funkcji , z tą różnicą, że bieżące położenie jest aktualizowane.
`CDC::Attach`	Dołącza kontekst urządzenia z systemem Windows do tego `CDC` obiektu.
`CDC::BeginPath`	Otwiera nawias ścieżki w kontekście urządzenia.
`CDC::BitBlt`	Kopiuje mapę bitową z określonego kontekstu urządzenia.
`CDC::Chord`	Rysuje akord (zamknięta postać ograniczona przez przecięcie wielokropka i segment linii).
`CDC::CloseFigure`	Zamyka otwartą postać w ścieżce.
`CDC::CreateCompatibleDC`	Tworzy kontekst urządzenia pamięci zgodny z innym kontekstem urządzenia. Można go użyć do przygotowania obrazów w pamięci.
`CDC::CreateDC`	Tworzy kontekst urządzenia dla określonego urządzenia.
`CDC::CreateIC`	Tworzy kontekst informacji dla określonego urządzenia. Zapewnia to szybki sposób uzyskiwania informacji o urządzeniu bez tworzenia kontekstu urządzenia.
`CDC::DeleteDC`	Usuwa kontekst urządzenia z systemem Windows skojarzony z tym `CDC` obiektem.
`CDC::DeleteTempMap`	Wywoływana `CWinApp` przez program obsługi bezczynności w celu usunięcia dowolnego obiektu tymczasowego utworzonego `CDC` przez `FromHandle`program . Odłącza również kontekst urządzenia.
`CDC::Detach`	Odłącza kontekst urządzenia z systemem Windows od tego `CDC` obiektu.
`CDC::DPtoHIMETRIC`	Konwertuje jednostki urządzeń na `HIMETRIC` jednostki.
`CDC::DPtoLP`	Konwertuje jednostki urządzeń na jednostki logiczne.
`CDC::Draw3dRect`	Rysuje trójwymiarowy prostokąt.
`CDC::DrawDragRect`	Usuwa i ponownie rysuje prostokąt podczas przeciągania.
`CDC::DrawEdge`	Rysuje krawędzie prostokąta.
`CDC::DrawEscape`	Uzyskuje dostęp do możliwości rysowania wyświetlacza wideo, które nie są dostępne bezpośrednio za pośrednictwem interfejsu urządzenia graficznego (GDI).
`CDC::DrawFocusRect`	Rysuje prostokąt w stylu używanym do wskazywania fokusu.
`CDC::DrawFrameControl`	Rysuj kontrolkę ramki.
`CDC::DrawIcon`	Rysuje ikonę.
`CDC::DrawState`	Wyświetla obraz i stosuje efekt wizualny, aby wskazać stan.
`CDC::DrawText`	Rysuje sformatowany tekst w określonym prostokątze.
`CDC::DrawTextEx`	Rysuje sformatowany tekst w określonym prostokątze przy użyciu innych formatów.
`CDC::Ellipse`	Rysuje wielokropek.
`CDC::EndDoc`	Kończy zadanie drukowania uruchomione przez funkcję składową `StartDoc` .
`CDC::EndPage`	Informuje sterownik urządzenia o zakończeniu strony.
`CDC::EndPath`	Zamyka nawias ścieżki i wybiera ścieżkę zdefiniowaną przez nawias w kontekście urządzenia.
`CDC::EnumObjects`	Wylicza pióra i szczotki dostępne w kontekście urządzenia.
`CDC::Escape`	Umożliwia aplikacjom dostęp do obiektów, które nie są bezpośrednio dostępne z określonego urządzenia za pośrednictwem interfejsu GDI. Umożliwia również dostęp do funkcji ucieczki systemu Windows. Wywołania ucieczki wykonywane przez aplikację są tłumaczone i wysyłane do sterownika urządzenia.
`CDC::ExcludeClipRect`	Tworzy nowy region wycinków, który składa się z istniejącego regionu wycinkowania pomniejszonego o określony prostokąt.
`CDC::ExcludeUpdateRgn`	Uniemożliwia rysowanie w nieprawidłowych obszarach okna, wykluczając zaktualizowany region w oknie z regionu wycinkowania.
`CDC::ExtFloodFill`	Wypełnia obszar bieżącym pędzlem. Zapewnia większą elastyczność niż funkcja składowa `CDC::FloodFill` .
`CDC::ExtTextOut`	Zapisuje ciąg znaków w regionie prostokątnym przy użyciu aktualnie wybranej czcionki.
`CDC::FillPath`	Zamyka wszystkie otwarte figury w bieżącej ścieżce i wypełnia wnętrze ścieżki przy użyciu bieżącego pędzla i trybu wypełniania wielokątnego.
`CDC::FillRect`	Wypełnia dany prostokąt przy użyciu określonego pędzla.
`CDC::FillRgn`	Wypełnia określony region określonym pędzlem.
`CDC::FillSolidRect`	Wypełnia prostokąt stałym kolorem.
`CDC::FlattenPath`	Przekształca wszystkie krzywe w ścieżce wybranej w bieżący kontekst urządzenia i zamienia każdą krzywą w sekwencję linii.
`CDC::FloodFill`	Wypełnia obszar bieżącym pędzlem.
`CDC::FrameRect`	Rysuje obramowanie wokół prostokąta.
`CDC::FrameRgn`	Rysuje obramowanie wokół określonego regionu przy użyciu pędzla.
`CDC::FromHandle`	Zwraca wskaźnik do `CDC` obiektu, gdy dana dojście do kontekstu urządzenia. `CDC` Jeśli obiekt nie jest dołączony do uchwytu, zostanie utworzony i dołączony obiekt tymczasowy`CDC`.
`CDC::GetArcDirection`	Zwraca bieżący kierunek łuku dla kontekstu urządzenia.
`CDC::GetAspectRatioFilter`	Pobiera ustawienie dla bieżącego filtru współczynnika proporcji.
`CDC::GetBkColor`	Pobiera bieżący kolor tła.
`CDC::GetBkMode`	Pobiera tryb tła.
`CDC::GetBoundsRect`	Zwraca bieżący skumulowany prostokąt ograniczenia dla określonego kontekstu urządzenia.
`CDC::GetBrushOrg`	Pobiera źródło bieżącego pędzla.
`CDC::GetCharABCWidths`	Pobiera szerokości w jednostkach logicznych z kolejnych znaków w danym zakresie z bieżącej czcionki.
`CDC::GetCharABCWidthsI`	Pobiera szerokości w jednostkach logicznych kolejnych indeksów glifów w określonym zakresie z bieżącej czcionki TrueType.
`CDC::GetCharacterPlacement`	Pobiera różne typy informacji na temat ciągu znaków.
`CDC::GetCharWidth`	Pobiera szerokości ułamkowe kolejnych znaków w danym zakresie z bieżącej czcionki.
`CDC::GetCharWidthI`	Pobiera szerokości w współrzędnych logicznych kolejnych indeksów glifów w określonym zakresie od bieżącej czcionki.
`CDC::GetClipBox`	Pobiera wymiary najostrzejszego prostokąta ograniczenia wokół bieżącej granicy przycinania.
`CDC::GetColorAdjustment`	Pobiera wartości korekty kolorów dla kontekstu urządzenia.
`CDC::GetCurrentBitmap`	Zwraca wskaźnik do aktualnie wybranego `CBitmap` obiektu.
`CDC::GetCurrentBrush`	Zwraca wskaźnik do aktualnie wybranego `CBrush` obiektu.
`CDC::GetCurrentFont`	Zwraca wskaźnik do aktualnie wybranego `CFont` obiektu.
`CDC::GetCurrentPalette`	Zwraca wskaźnik do aktualnie wybranego `CPalette` obiektu.
`CDC::GetCurrentPen`	Zwraca wskaźnik do aktualnie wybranego `CPen` obiektu.
`CDC::GetCurrentPosition`	Pobiera bieżącą pozycję pióra (we współrzędnych logicznych).
`CDC::GetDCBrushColor`	Pobiera bieżący kolor pędzla.
`CDC::GetDCPenColor`	Pobiera bieżący kolor pióra.
`CDC::GetDeviceCaps`	Pobiera określony rodzaj informacji specyficznych dla urządzenia dotyczących możliwości danego urządzenia wyświetlania.
`CDC::GetFontData`	Pobiera informacje o metryce czcionek z skalowalnego pliku czcionek. Informacje do pobrania są identyfikowane przez określenie przesunięcia do pliku czcionki i długości informacji do zwrócenia.
`CDC::GetFontLanguageInfo`	Zwraca informacje o aktualnie wybranej czcionki dla określonego kontekstu wyświetlania.
`CDC::GetGlyphOutline`	Pobiera krzywą konturu lub mapę bitową dla znaku konspektu w bieżącej czcionki.
`CDC::GetGraphicsMode`	Pobiera bieżący tryb graficzny dla określonego kontekstu urządzenia.
`CDC::GetHalftoneBrush`	Pobiera szczotkę półtonową.
`CDC::GetKerningPairs`	Pobiera pary kerning znaków dla czcionki, która jest obecnie zaznaczona w określonym kontekście urządzenia.
`CDC::GetLayout`	Pobiera układ kontekstu urządzenia (DC). Układ może być od lewej do prawej (domyślnie) lub od prawej do lewej (dublowany).
`CDC::GetMapMode`	Pobiera bieżący tryb mapowania.
`CDC::GetMiterLimit`	Zwraca limit miter dla kontekstu urządzenia.
`CDC::GetNearestColor`	Pobiera najbliższy kolor logiczny do określonego koloru logicznego, który może reprezentować dane urządzenie.
`CDC::GetOutlineTextMetrics`	Pobiera informacje o metryce czcionki dla czcionek TrueType.
`CDC::GetOutputCharWidth`	Pobiera szerokości poszczególnych znaków w kolejnej grupie znaków z bieżącej czcionki przy użyciu kontekstu urządzenia wyjściowego.
`CDC::GetOutputTabbedTextExtent`	Oblicza szerokość i wysokość ciągu znaków w kontekście urządzenia wyjściowego.
`CDC::GetOutputTextExtent`	Oblicza szerokość i wysokość wiersza tekstu w kontekście urządzenia wyjściowego przy użyciu bieżącej czcionki w celu określenia wymiarów.
`CDC::GetOutputTextMetrics`	Pobiera metryki dla bieżącej czcionki z kontekstu urządzenia wyjściowego.
`CDC::GetPath`	Pobiera współrzędne definiujące punkty końcowe linii i punkty kontrolne krzywych znalezionych w ścieżce wybranej w kontekście urządzenia.
`CDC::GetPixel`	Pobiera wartość koloru RGB piksela w określonym punkcie.
`CDC::GetPolyFillMode`	Pobiera bieżący tryb wypełniania wielokątowego.
`CDC::GetROP2`	Pobiera bieżący tryb rysunku.
`CDC::GetSafeHdc`	Zwraca `CDC::m_hDC`wartość , kontekst wyjściowego urządzenia.
`CDC::GetStretchBltMode`	Pobiera bieżący tryb rozciągnięcia mapy bitowej.
`CDC::GetTabbedTextExtent`	Oblicza szerokość i wysokość ciągu znaków w kontekście urządzenia atrybutu.
`CDC::GetTextAlign`	Pobiera flagi wyrównania tekstu.
`CDC::GetTextCharacterExtra`	Pobiera bieżące ustawienie dla liczby odstępów międzycharakterowych.
`CDC::GetTextColor`	Pobiera bieżący kolor tekstu.
`CDC::GetTextExtent`	Oblicza szerokość i wysokość wiersza tekstu w kontekście urządzenia atrybutu przy użyciu bieżącej czcionki w celu określenia wymiarów.
`CDC::GetTextExtentExPointI`	Pobiera liczbę znaków w określonym ciągu, który będzie mieścił się w określonym obszarze i wypełnia tablicę zakresem tekstu dla każdego z tych znaków.
`CDC::GetTextExtentPointI`	Pobiera szerokość i wysokość określonej tablicy indeksów glifów.
`CDC::GetTextFace`	Kopiuje nazwę czcionki bieżącej czcionki do buforu jako ciąg zakończony o wartości null.
`CDC::GetTextMetrics`	Pobiera metryki dla bieżącej czcionki z kontekstu urządzenia atrybutu.
`CDC::GetViewportExt`	Pobiera zakresy x i yportu widoku.
`CDC::GetViewportOrg`	Pobiera współrzędne x-i y źródła widoku.
`CDC::GetWindow`	Zwraca okno skojarzone z kontekstem urządzenia wyświetlania.
`CDC::GetWindowExt`	Pobiera zakresy x i y skojarzonego okna.
`CDC::GetWindowOrg`	Pobiera współrzędne x-i y źródła skojarzonego okna.
`CDC::GetWorldTransform`	Pobiera bieżącą przestrzeń światową do transformacji przestrzeni stronicowej.
`CDC::GradientFill`	Wypełnia prostokąty i struktury trójkątów z kolorem stopniowania.
`CDC::GrayString`	Rysuje wygaszony (szary) tekst w danej lokalizacji.
`CDC::HIMETRICtoDP`	Konwertuje jednostki HIMETRIC na jednostki urządzeń.
`CDC::HIMETRICtoLP`	Konwertuje jednostki HIMETRIC na jednostki logiczne.
`CDC::IntersectClipRect`	Tworzy nowy region wycinków, tworząc przecięcie bieżącego regionu i prostokąta.
`CDC::InvertRect`	Odwraca zawartość prostokąta.
`CDC::InvertRgn`	Odwraca kolory w regionie.
`CDC::IsPrinting`	Określa, czy kontekst urządzenia jest używany do drukowania.
`CDC::LineTo`	Rysuje linię z bieżącej pozycji do, ale nie uwzględnia punktu.
`CDC::LPtoDP`	Konwertuje jednostki logiczne na jednostki urządzeń.
`CDC::LPtoHIMETRIC`	Konwertuje jednostki logiczne na jednostki HIMETRIC.
`CDC::MaskBlt`	Łączy dane kolorów dla źródłowych i docelowych map bitowych przy użyciu danej maski i operacji rastrowania.
`CDC::ModifyWorldTransform`	Zmienia transformację świata dla kontekstu urządzenia przy użyciu określonego trybu.
`CDC::MoveTo`	Przenosi bieżącą pozycję.
`CDC::OffsetClipRgn`	Przenosi obszar wycinków danego urządzenia.
`CDC::OffsetViewportOrg`	Modyfikuje źródło widoku względem współrzędnych bieżącego źródła widoku.
`CDC::OffsetWindowOrg`	Modyfikuje źródło okna względem współrzędnych bieżącego źródła okna.
`CDC::PaintRgn`	Wypełnia region wybranym pędzlem.
`CDC::PatBlt`	Tworzy wzorzec bitowy.
`CDC::Pie`	Rysuje klina w kształcie kołowego.
`CDC::PlayMetaFile`	Odtwarza zawartość określonego metapliku na danym urządzeniu. Ulepszona wersja `PlayMetaFile` wyświetla obraz przechowywany w danym metapliku w formacie rozszerzonym. Metaplik można odtworzyć dowolną liczbę razy.
`CDC::PlgBlt`	Wykonuje bitowy transfer bitów danych kolorów z określonego prostokąta w kontekście urządzenia źródłowego do określonego równoległegoogramu w danym kontekście urządzenia.
`CDC::PolyBezier`	Rysuje co najmniej jedną krzywą Bzier. Bieżące położenie nie jest używane ani aktualizowane.
`CDC::PolyBezierTo`	Rysuje co najmniej jedną krzywą Bziera i przenosi bieżącą pozycję do punktu końcowego ostatniej linii Bzier.
`CDC::PolyDraw`	Rysuje zestaw segmentów linii i krzywych Bzier. Ta funkcja aktualizuje bieżące położenie.
`CDC::Polygon`	Rysuje wielokąt składający się z co najmniej dwóch punktów (wierzchołków) połączonych liniami.
`CDC::Polyline`	Rysuje zestaw segmentów linii łączących określone punkty.
`CDC::PolylineTo`	Rysuje co najmniej jedną prostą linię i przenosi bieżącą pozycję do punktu końcowego ostatniego wiersza.
`CDC::PolyPolygon`	Tworzy co najmniej dwa wielokąty wypełnione przy użyciu bieżącego trybu wypełniania wielokątowego. Wielokąty mogą być rozłączne lub nakładają się na siebie.
`CDC::PolyPolyline`	Rysuje wiele serii połączonych segmentów linii. Bieżące położenie nie jest używane ani aktualizowane przez tę funkcję.
`CDC::PtVisible`	Określa, czy dany punkt znajduje się w regionie wycinkowania.
`CDC::RealizePalette`	Mapuje wpisy palety w bieżącej palecie logicznej na paletę systemowa.
`CDC::Rectangle`	Rysuje prostokąt przy użyciu bieżącego pióra i wypełnia go za pomocą bieżącego pędzla.
`CDC::RectVisible`	Określa, czy jakakolwiek część danego prostokąta znajduje się w regionie wycinkowania.
`CDC::ReleaseAttribDC`	Zwalnia `m_hAttribDC`element , kontekst urządzenia atrybutu.
`CDC::ReleaseOutputDC`	Zwalnia `m_hDC`, kontekst wyjściowego urządzenia.
`CDC::ResetDC`	`m_hAttribDC` Aktualizuje kontekst urządzenia.
`CDC::RestoreDC`	Przywraca kontekst urządzenia do poprzedniego stanu zapisanego za pomocą `SaveDC`polecenia .
`CDC::RoundRect`	Rysuje prostokąt z zaokrąglonymi rogami przy użyciu bieżącego pióra i wypełniany za pomocą bieżącego pędzla.
`CDC::SaveDC`	Zapisuje bieżący stan kontekstu urządzenia.
`CDC::ScaleViewportExt`	Modyfikuje zakres widoku względem bieżących wartości.
`CDC::ScaleWindowExt`	Modyfikuje zakresy okien względem bieżących wartości.
`CDC::ScrollDC`	Przewija prostokąt bitów w poziomie i w pionie.
`CDC::SelectClipPath`	Wybiera bieżącą ścieżkę jako region wycinków dla kontekstu urządzenia, łącząc nowy region z dowolnym istniejącym regionem wycinków przy użyciu określonego trybu.
`CDC::SelectClipRgn`	Łączy dany region z bieżącym regionem wycinków przy użyciu określonego trybu.
`CDC::SelectObject`	Wybiera obiekt rysunkowy GDI, taki jak pióro.
`CDC::SelectPalette`	Wybiera paletę logiczną.
`CDC::SelectStockObject`	Wybiera jedną ze wstępnie zdefiniowanych długopisów, pędzli lub czcionek dostarczonych przez system Windows.
`CDC::SetAbortProc`	Ustawia funkcję wywołania zwrotnego dostarczonego przez programistę, którą system Windows wywołuje, jeśli zadanie drukowania musi zostać przerwane.
`CDC::SetArcDirection`	Ustawia kierunek rysunku, który ma być używany dla funkcji łuku i prostokąta.
`CDC::SetAttribDC`	Ustawia `m_hAttribDC`, atrybut kontekstu urządzenia.
`CDC::SetBkColor`	Ustawia bieżący kolor tła.
`CDC::SetBkMode`	Ustawia tryb tła.
`CDC::SetBoundsRect`	Steruje akumulacją informacji o ograniczeniach prostokąta dla określonego kontekstu urządzenia.
`CDC::SetBrushOrg`	Określa początek następnego pędzla wybranego w kontekście urządzenia.
`CDC::SetColorAdjustment`	Ustawia wartości korekty kolorów dla kontekstu urządzenia przy użyciu określonych wartości.
`CDC::SetDCBrushColor`	Ustawia bieżący kolor pędzla.
`CDC::SetDCPenColor`	Ustawia bieżący kolor pióra.
`CDC::SetGraphicsMode`	Ustawia bieżący tryb graficzny dla określonego kontekstu urządzenia.
`CDC::SetLayout`	Zmienia układ kontekstu urządzenia (DC).
`CDC::SetMapMode`	Ustawia bieżący tryb mapowania.
`CDC::SetMapperFlags`	Zmienia algorytm używany przez maper czcionek podczas mapowania czcionek logicznych na czcionki fizyczne.
`CDC::SetMiterLimit`	Ustawia limit długości sprzężeń miter dla kontekstu urządzenia.
`CDC::SetOutputDC`	Ustawia `m_hDC`kontekst urządzenia wyjściowego .
`CDC::SetPixel`	Ustawia piksel w określonym punkcie na najbliższe przybliżenie określonego koloru.
`CDC::SetPixelV`	Ustawia piksel na określonych współrzędnych do najbliższego przybliżenia określonego koloru. `SetPixelV` jest szybszy niż `SetPixel` dlatego, że nie musi zwracać wartości koloru punktu malowanego.
`CDC::SetPolyFillMode`	Ustawia tryb wypełniania wielokątowego.
`CDC::SetROP2`	Ustawia bieżący tryb rysunku.
`CDC::SetStretchBltMode`	Ustawia tryb rozciągnięcia mapy bitowej.
`CDC::SetTextAlign`	Ustawia flagi wyrównania tekstu.
`CDC::SetTextCharacterExtra`	Ustawia odstęp międzycharakterowy.
`CDC::SetTextColor`	Ustawia kolor tekstu.
`CDC::SetTextJustification`	Dodaje spację do znaków przerwania w ciągu.
`CDC::SetViewportExt`	Ustawia zakresy x i yportu widoku.
`CDC::SetViewportOrg`	Ustawia źródło widoku.
`CDC::SetWindowExt`	Ustawia zakresy x-i y skojarzonego okna.
`CDC::SetWindowOrg`	Ustawia źródło okna kontekstu urządzenia.
`CDC::SetWorldTransform`	Ustawia bieżącą przestrzeń światową na transformację przestrzeni stronicowej.
`CDC::StartDoc`	Informuje sterownik urządzenia o uruchomieniu nowego zadania drukowania.
`CDC::StartPage`	Informuje sterownik urządzenia o uruchomieniu nowej strony.
`CDC::StretchBlt`	Przenosi mapę bitową ze źródłowego prostokąta i urządzenia do prostokąta docelowego, rozciągając lub kompresując mapę bitową, jeśli to konieczne, aby dopasować wymiary prostokąta docelowego.
`CDC::StrokeAndFillPath`	Zamyka wszystkie otwarte figury w ścieżce, uderza w kontur ścieżki przy użyciu bieżącego pióra i wypełnia jego wnętrze za pomocą bieżącego pędzla.
`CDC::StrokePath`	Renderuje określoną ścieżkę przy użyciu bieżącego pióra.
`CDC::TabbedTextOut`	Zapisuje ciąg znaków w określonej lokalizacji, rozwijając karty do wartości określonych w tablicy pozycji tabulatora.
`CDC::TextOut`	Zapisuje ciąg znaków w określonej lokalizacji przy użyciu aktualnie wybranej czcionki.
`CDC::TransparentBlt`	Przesyła bitowy blok danych kolorów z określonego kontekstu urządzenia źródłowego do kontekstu urządzenia docelowego, co powoduje przezroczystość określonego koloru w transferze.
`CDC::UpdateColors`	Aktualizuje obszar klienta kontekstu urządzenia, dopasowując bieżące kolory w obszarze klienta do palety systemowej na podstawie pikseli.
`CDC::WidenPath`	Ponownie definiuje bieżącą ścieżkę jako obszar, który będzie malowany, jeśli ścieżka została pociągnięta przy użyciu pióra aktualnie wybranego w kontekście urządzenia.

Operatory publiczne

Nazwa/nazwisko	opis
`CDC::operator HDC`	Pobiera uchwyt kontekstu urządzenia.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
`CDC::m_hAttribDC`	Kontekst atrybutu urządzenia używany przez ten `CDC` obiekt.
`CDC::m_hDC`	Kontekst urządzenia wyjściowego używany przez ten `CDC` obiekt.

Uwagi

Obiekt CDC udostępnia funkcje składowe do pracy z kontekstem urządzenia, takim jak wyświetlacz lub drukarka, oraz elementy członkowskie do pracy z kontekstem wyświetlania skojarzonym z obszarem klienta okna.

Wykonaj wszystkie rysunki za pomocą funkcji składowych CDC obiektu. Klasa udostępnia funkcje składowe na potrzeby operacji kontekstowych urządzeń, pracy z narzędziami do rysowania, wyborem obiektów interfejsu graficznego (GDI, type-safe graphics device interface) oraz pracą z kolorami i paletami. Udostępnia również funkcje składowe do pobierania i ustawiania atrybutów rysunku, mapowania, pracy z widokiem, pracy z zakresem okna, konwertowania współrzędnych, pracy z regionami, wycinania, linii rysunkowych i rysowania prostych kształtów, wielokropków i wielokątów. Funkcje składowe są również udostępniane do rysowania tekstu, pracy z czcionkami, używania ucieczki drukarki, przewijania i odtwarzania metaplików.

Aby użyć obiektu, skonstruuj CDC go, a następnie wywołaj jego funkcje członkowskie, które równoległe funkcje systemu Windows korzystające z kontekstów urządzeń.

Uwaga

W systemie Windows 95/98 wszystkie współrzędne ekranu są ograniczone do 16 bitów. W związku z tym przekazana int do funkcji składowej CDC musi znajdować się w zakresie od -32768 do 32767.

W przypadku określonych zastosowań biblioteka klas programu Microsoft Foundation udostępnia kilka klas pochodzących z CDC klasy . CPaintDC hermetyzuje wywołania metod BeginPaint i EndPaint. CClientDC zarządza kontekstem wyświetlania skojarzonym z obszarem klienta okna. CWindowDC zarządza kontekstem wyświetlania skojarzonym z całym oknem, w tym ramką i kontrolkami. CMetaFileDC kojarzy kontekst urządzenia z metaplikiem.

CDC Udostępnia dwie funkcje GetLayout składowe i SetLayout, w przypadku odwracania układu kontekstu urządzenia, który nie dziedziczy układu z okna. Taka orientacja od prawej do lewej jest niezbędna dla aplikacji napisanych dla kultur, takich jak arabski lub hebrajski, gdzie układ znaków nie jest standardem europejskim.

CDC Zawiera dwa konteksty urządzenia i m_hDC m_hAttribDC, które podczas tworzenia CDC obiektu odwołują się do tego samego urządzenia. CDCkieruje wszystkie wyjściowe wywołania interfejsu GDI do m_hDC i większość wywołań GDI atrybutu do .m_hAttribDC (Przykładem wywołania atrybutu jest GetTextColor, a element SetTextColor jest wywołaniem wyjściowym).

Na przykład struktura używa tych dwóch kontekstów urządzenia do zaimplementowania CMetaFileDC obiektu, który będzie wysyłać dane wyjściowe do metapliku podczas odczytywania atrybutów z urządzenia fizycznego. Podgląd wydruku jest implementowany w strukturze w podobny sposób. Możesz również użyć dwóch kontekstów urządzenia w podobny sposób w kodzie specyficznym dla aplikacji.

Czasami mogą być potrzebne informacje o metryce tekstowej zarówno z kontekstów urządzenia, jak m_hDC i m_hAttribDC . Następujące pary funkcji zapewniają tę możliwość:

Używa m_hAttribDC	Używa m_hDC
`GetTextExtent`	`GetOutputTextExtent`
`GetTabbedTextExtent`	`GetOutputTabbedTextExtent`
`GetTextMetrics`	`GetOutputTextMetrics`
`GetCharWidth`	`GetOutputCharWidth`

Aby uzyskać więcej informacji na temat CDCprogramu , zobacz Konteksty urządzeń.

Hierarchia dziedziczenia

CObject

CDC

Wymagania

Nagłówek: afxwin.h

`CDC::AbortDoc`

Przerywa bieżące zadanie drukowania i usuwa wszystkie elementy, które aplikacja zapisała na urządzeniu od ostatniego wywołania funkcji składowej StartDoc .

int AbortDoc();

Wartość zwracana

Wartość większa niż lub równa 0 w przypadku powodzenia lub wartość ujemna, jeśli wystąpił błąd. Na poniższej liście przedstawiono typowe wartości błędów i ich znaczenie:

SP_ERROR Błąd ogólny.
SP_OUTOFDISK Za mało miejsca na dysku jest obecnie dostępne na potrzeby buforowania i nie będzie dostępne żadne miejsce.
SP_OUTOFMEMORY Za mało pamięci jest dostępna do buforowania.
SP_USERABORT Użytkownik przerwał zadanie za pośrednictwem Menedżera wydruku.

Uwagi

Ta funkcja składowa zastępuje ucieczkę ABORTDOC drukarki.

AbortDoc należy użyć do zakończenia następujących czynności:

Operacje drukowania, które nie określają funkcji przerwania przy użyciu polecenia SetAbortProc.
Operacje drukowania, które nie osiągnęły jeszcze pierwszego NEWFRAME połączenia lub NEXTBAND ucieczki.

Jeśli aplikacja napotka błąd drukowania lub anulowaną operację drukowania, nie może podjąć próby zakończenia operacji przy użyciu EndDoc funkcji składowych klasy CDClub AbortDoc . GDI automatycznie kończy operację przed zwróceniem wartości błędu.

Jeśli aplikacja wyświetla okno dialogowe umożliwiające użytkownikowi anulowanie operacji drukowania, musi wywołać AbortDoc ją przed zniszczeniem okna dialogowego.

Jeśli Menedżer wydruku został użyty do uruchomienia zadania drukowania, wywołanie metody AbortDoc wymazuje całe zadanie buforowania — drukarka nie otrzyma niczego. Jeśli Menedżer wydruku nie był używany do uruchamiania zadania drukowania, dane mogły zostać wysłane do drukarki przed AbortDoc wywołaniem. W takim przypadku sterownik drukarki zresetowałby drukarkę (jeśli to możliwe) i zamknął zadanie drukowania.

Przykład

Zobacz przykład dla elementu CDC::StartDoc.

`CDC::AbortPath`

Zamyka i odrzuca wszystkie ścieżki w kontekście urządzenia.

BOOL AbortPath();

Wartość zwracana

Różne od zera, jeśli funkcja zakończyła się pomyślnie; w przeciwnym razie 0.

Uwagi

Jeśli w kontekście urządzenia znajduje się nawias ścieżki otwartej, nawias ścieżki zostanie zamknięty i ścieżka zostanie odrzucona. Jeśli w kontekście urządzenia znajduje się zamknięta ścieżka, ścieżka zostanie odrzucona.

`CDC::AddMetaFileComment`

Kopiuje komentarz z buforu do określonego metapliku w formacie rozszerzonym.

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

Parametry

nDataSize
Określa długość buforu komentarza w bajtach.

pCommentData
Wskazuje bufor zawierający komentarz.

Wartość zwracana

Różne od zera, jeśli funkcja zakończyła się pomyślnie; w przeciwnym razie 0.

Uwagi

Komentarz może zawierać wszelkie informacje prywatne — na przykład źródło obrazu i datę utworzenia. Komentarz powinien zaczynać się od podpisu aplikacji, a następnie danych. Komentarze nie powinny zawierać danych specyficznych dla pozycji. Dane specyficzne dla pozycji określają lokalizację rekordu i nie powinny być uwzględniane, ponieważ jeden metaplik może być osadzony w innym metapliku. Tej funkcji można używać tylko z rozszerzonymi metaplikami.

`CDC::AlphaBlend`

Wywołaj tę funkcję składową, aby wyświetlić mapy bitowe z przezroczystymi lub półprzezroczystymi pikselami.

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

Parametry

xDest
Określa współrzędną x w jednostkach logicznych lewego górnego rogu prostokąta docelowego.

yDest
Określa współrzędną y w jednostkach logicznych lewego górnego rogu prostokąta docelowego.

nDestWidth
Określa szerokość w jednostkach logicznych prostokąta docelowego.

nDestHeight
Określa wysokość w jednostkach logicznych prostokąta docelowego.

pSrcDC
Wskaźnik do kontekstu urządzenia źródłowego.

xSrc
Określa współrzędną x w jednostkach logicznych lewego górnego rogu prostokąta źródłowego.

ySrc
Określa współrzędną y w jednostkach logicznych lewego górnego rogu prostokąta źródłowego.

nSrcWidth
Określa szerokość w jednostkach logicznych prostokąta źródłowego.

nSrcHeight
Określa wysokość w jednostkach logicznych prostokąta źródłowego.

blend
Określa BLENDFUNCTION strukturę.

Wartość zwracana

TRUE w przypadku powodzenia; w przeciwnym razie FALSE.

Uwagi

Aby uzyskać więcej informacji, zobacz AlphaBlend w zestawie Windows SDK.

`CDC::AngleArc`

Rysuje segment liniowy i łuk.

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

Parametry

x
Określa logiczną współrzędną x środka okręgu.

y
Określa logiczną współrzędną y środka okręgu.

nRadius
Określa promień okręgu w jednostkach logicznych. Ta wartość musi być dodatnia.

fStartAngle
Określa kąt początkowy w stopniach względem osi x.

fSweepAngle
Określa kąt zamiatania w stopniach względem kąta początkowego.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Segment linii jest rysowany z bieżącej pozycji do początku łuku. Łuk jest rysowany wzdłuż obwodu okręgu z danym promieniem i środek. Długość łuku jest definiowana przez podane kąty początku i zamiatania.

AngleArc przenosi bieżącą pozycję do punktu końcowego łuku. Łuk narysowany przez tę funkcję może wydawać się wielokropek, w zależności od bieżącego trybu transformacji i mapowania. Przed rysowaniem łuku ta funkcja rysuje segment linii z bieżącej pozycji na początek łuku. Łuk jest rysowany przez skonstruowanie wyimaginowanego okręgu z określonym promieńem wokół określonego punktu środkowego. Punkt początkowy łuku jest określany przez pomiar w kierunku odwrotnym od osi x okręgu przez liczbę stopni w kątze początkowym. Punkt końcowy znajduje się podobnie, mierząc odwrotnie od punktu początkowego przez liczbę stopni w kątze zamiatania.

Jeśli kąt zamiatania jest większy niż 360 stopni, łuk jest przetoczył się wiele razy. Ta funkcja rysuje linie przy użyciu bieżącego pióra. Ilustracja nie jest wypełniona.

`CDC::Arc`

Rysuje łuk wielokropowy.

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
Określa współrzędną x lewego górnego rogu prostokąta ograniczenia (w jednostkach logicznych).

y1
Określa współrzędną y lewego górnego rogu prostokąta ograniczenia (w jednostkach logicznych).

x2
Określa współrzędną x prawego dolnego rogu prostokąta ograniczenia (w jednostkach logicznych).

y2
Określa współrzędną y prawego dolnego rogu prostokąta ograniczenia (w jednostkach logicznych).

x3
Określa współrzędną x punktu, który definiuje punkt początkowy łuku (w jednostkach logicznych). Ten punkt nie musi leżeć dokładnie na łuku.

y3
Określa współrzędną y punktu, który definiuje punkt początkowy łuku (w jednostkach logicznych). Ten punkt nie musi leżeć dokładnie na łuku.

x4
Określa współrzędną x punktu definiującego punkt końcowy łuku (w jednostkach logicznych). Ten punkt nie musi leżeć dokładnie na łuku.

y4
Określa współrzędną y punktu, który definiuje punkt końcowy łuku (w jednostkach logicznych). Ten punkt nie musi leżeć dokładnie na łuku.

lpRect
Określa prostokąt ograniczenia (w jednostkach logicznych). Można przekazać LPRECT obiekt lub dla tego parametru CRect .

ptStart
Określa współrzędne x-i y punktu definiujące punkt początkowy łuku (w jednostkach logicznych). Ten punkt nie musi leżeć dokładnie na łuku. Można przekazać POINT strukturę lub obiekt dla tego parametru CPoint .

ptEnd
Określa współrzędne x-i y punktu, który definiuje punkt końcowy łuku (w jednostkach logicznych). Ten punkt nie musi leżeć dokładnie na łuku. Można przekazać POINT strukturę lub obiekt dla tego parametru CPoint .

Wartość zwracana

Różne od zera, jeśli funkcja zakończyła się pomyślnie; w przeciwnym razie 0.

Uwagi

Łuk rysowany przy użyciu funkcji jest segmentem wielokropka zdefiniowanego przez określony prostokąt ograniczenia.

Rzeczywisty punkt początkowy łuku to punkt, w którym promienie pobierane z środka prostokąta ograniczenia przez określony punkt początkowy przecina wielokropek. Rzeczywisty punkt końcowy łuku jest punktem, w którym promienie pobierane z środka prostokąta ograniczenia przez określony punkt końcowy przecina wielokropek. Łuk jest rysowany w kierunku przeciwkręciowym. Ponieważ łuk nie jest zamkniętą postacią, nie jest wypełniony. Zarówno szerokość, jak i wysokość prostokąta muszą być większe niż 2 jednostki i mniejsze niż 32 767 jednostek.

Przykład

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`

Rysuje łuk wielokropowy.

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