`CDC` Kelas

Artikel
04/06/2023

Menentukan kelas objek konteks perangkat.

Sintaks

class CDC : public CObject

Anggota

Konstruktor Publik

Nama	Deskripsi
`CDC::CDC`	Membuat `CDC` objek.

Metode Publik

Nama	Deskripsi
`CDC::AbortDoc`	Mengakhiri pekerjaan cetak saat ini, menghapus semua yang telah ditulis aplikasi ke perangkat sejak panggilan terakhir fungsi `StartDoc` anggota.
`CDC::AbortPath`	Menutup dan membuang jalur apa pun dalam konteks perangkat.
`CDC::AddMetaFileComment`	Menyalin komentar dari buffer ke dalam metafile format yang disempurnakan tertentu.
`CDC::AlphaBlend`	Menampilkan bitmap yang memiliki piksel transparan atau semitransparan.
`CDC::AngleArc`	Menggambar segmen garis dan busur, dan memindahkan posisi saat ini ke titik akhir busur.
`CDC::Arc`	Menggambar busur elips.
`CDC::ArcTo`	Menggambar busur elips. Fungsi ini mirip `Arc`dengan , kecuali bahwa posisi saat ini diperbarui.
`CDC::Attach`	Melampirkan konteks perangkat Windows ke objek ini `CDC` .
`CDC::BeginPath`	Membuka braket jalur dalam konteks perangkat.
`CDC::BitBlt`	Menyalin bitmap dari konteks perangkat tertentu.
`CDC::Chord`	Menggambar akord (gambar tertutup yang dibatasi oleh persimpangan elips dan segmen garis).
`CDC::CloseFigure`	Menutup gambar terbuka di jalur.
`CDC::CreateCompatibleDC`	Membuat konteks perangkat memori yang kompatibel dengan konteks perangkat lain. Anda dapat menggunakannya untuk menyiapkan gambar dalam memori.
`CDC::CreateDC`	Membuat konteks perangkat untuk perangkat tertentu.
`CDC::CreateIC`	Membuat konteks informasi untuk perangkat tertentu. Ini menyediakan cara cepat untuk mendapatkan informasi tentang perangkat tanpa membuat konteks perangkat.
`CDC::DeleteDC`	Menghapus konteks perangkat Windows yang terkait dengan objek ini `CDC` .
`CDC::DeleteTempMap`	Dipanggil oleh handler `CWinApp` idle-time untuk menghapus objek sementara `CDC` yang dibuat oleh `FromHandle`. Juga melepaskan konteks perangkat.
`CDC::Detach`	Copot konteks perangkat Windows dari objek ini `CDC` .
`CDC::DPtoHIMETRIC`	Mengonversi unit perangkat menjadi `HIMETRIC` satuan.
`CDC::DPtoLP`	Mengonversi unit perangkat menjadi unit logis.
`CDC::Draw3dRect`	Menggambar persegi tiga dimensi.
`CDC::DrawDragRect`	Menghapus dan menggambar ulang persegi panjang saat diseret.
`CDC::DrawEdge`	Menggambar tepi persegi panjang.
`CDC::DrawEscape`	Mengakses kemampuan menggambar tampilan video yang tidak tersedia secara langsung melalui antarmuka perangkat grafis (GDI).
`CDC::DrawFocusRect`	Menggambar persegi panjang dalam gaya yang digunakan untuk menunjukkan fokus.
`CDC::DrawFrameControl`	Gambar kontrol bingkai.
`CDC::DrawIcon`	Menggambar ikon.
`CDC::DrawState`	Menampilkan gambar dan menerapkan efek visual untuk menunjukkan status.
`CDC::DrawText`	Gambar teks yang diformat dalam persegi panjang yang ditentukan.
`CDC::DrawTextEx`	Gambar teks yang diformat dalam persegi panjang yang ditentukan menggunakan format lain.
`CDC::Ellipse`	Menggambar elips.
`CDC::EndDoc`	Mengakhiri pekerjaan cetak yang dimulai oleh `StartDoc` fungsi anggota.
`CDC::EndPage`	Menginformasikan driver perangkat bahwa halaman berakhir.
`CDC::EndPath`	Menutup tanda kurung jalur dan memilih jalur yang ditentukan oleh tanda kurung ke dalam konteks perangkat.
`CDC::EnumObjects`	Menghitung pena dan kuas yang tersedia dalam konteks perangkat.
`CDC::Escape`	Memungkinkan aplikasi mengakses fasilitas yang tidak tersedia secara langsung dari perangkat tertentu melalui GDI. Juga memungkinkan akses ke fungsi escape Windows. Panggilan escape yang dilakukan oleh aplikasi diterjemahkan dan dikirim ke driver perangkat.
`CDC::ExcludeClipRect`	Membuat wilayah kliping baru yang terdiri dari wilayah kliping yang ada dikurangi persegi panjang yang ditentukan.
`CDC::ExcludeUpdateRgn`	Mencegah gambar dalam area jendela yang tidak valid dengan mengecualikan wilayah yang diperbarui di jendela dari wilayah kliping.
`CDC::ExtFloodFill`	Mengisi area dengan kuas saat ini. Memberikan lebih banyak fleksibilitas daripada `CDC::FloodFill` fungsi anggota.
`CDC::ExtTextOut`	Menulis string karakter dalam wilayah persegi panjang menggunakan font yang saat ini dipilih.
`CDC::FillPath`	Menutup tokoh terbuka di jalur saat ini dan mengisi interior jalur dengan menggunakan mode kuas dan pengisian poligon saat ini.
`CDC::FillRect`	Mengisi persegi panjang tertentu dengan menggunakan kuas tertentu.
`CDC::FillRgn`	Mengisi wilayah tertentu dengan kuas yang ditentukan.
`CDC::FillSolidRect`	Mengisi persegi panjang dengan warna solid.
`CDC::FlattenPath`	Mengubah kurva apa pun di jalur yang dipilih ke konteks perangkat saat ini, dan mengubah setiap kurva menjadi urutan garis.
`CDC::FloodFill`	Mengisi area dengan kuas saat ini.
`CDC::FrameRect`	Menggambar batas di sekitar persegi panjang.
`CDC::FrameRgn`	Menggambar batas di sekitar wilayah tertentu menggunakan kuas.
`CDC::FromHandle`	Mengembalikan penunjuk ke `CDC` objek saat diberikan handel ke konteks perangkat. `CDC` Jika objek tidak dilampirkan ke handel, objek sementara `CDC` dibuat dan dilampirkan.
`CDC::GetArcDirection`	Mengembalikan arah busur saat ini untuk konteks perangkat.
`CDC::GetAspectRatioFilter`	Mengambil pengaturan untuk filter rasio aspek saat ini.
`CDC::GetBkColor`	Mengambil warna latar belakang saat ini.
`CDC::GetBkMode`	Mengambil mode latar belakang.
`CDC::GetBoundsRect`	Mengembalikan persegi panjang batas akumulasi saat ini untuk konteks perangkat yang ditentukan.
`CDC::GetBrushOrg`	Mengambil asal kuas saat ini.
`CDC::GetCharABCWidths`	Mengambil lebar, dalam unit logis, dari karakter berturut-turut dalam rentang tertentu dari font saat ini.
`CDC::GetCharABCWidthsI`	Mengambil lebar, dalam unit logis, indeks glyph berturut-turut dalam rentang tertentu dari font TrueType saat ini.
`CDC::GetCharacterPlacement`	Mengambil berbagai jenis informasi pada string karakter.
`CDC::GetCharWidth`	Mengambil lebar pecahan karakter berturut-turut dalam rentang tertentu dari font saat ini.
`CDC::GetCharWidthI`	Mengambil lebar, dalam koordinat logis, indeks glyph berturut-turut dalam rentang tertentu dari font saat ini.
`CDC::GetClipBox`	Mengambil dimensi persegi panjang pembatas terketat di sekitar batas kliping saat ini.
`CDC::GetColorAdjustment`	Mengambil nilai penyesuaian warna untuk konteks perangkat.
`CDC::GetCurrentBitmap`	Mengembalikan penunjuk ke objek yang saat ini dipilih `CBitmap` .
`CDC::GetCurrentBrush`	Mengembalikan penunjuk ke objek yang saat ini dipilih `CBrush` .
`CDC::GetCurrentFont`	Mengembalikan penunjuk ke objek yang saat ini dipilih `CFont` .
`CDC::GetCurrentPalette`	Mengembalikan penunjuk ke objek yang saat ini dipilih `CPalette` .
`CDC::GetCurrentPen`	Mengembalikan penunjuk ke objek yang saat ini dipilih `CPen` .
`CDC::GetCurrentPosition`	Mengambil posisi pena saat ini (dalam koordinat logis).
`CDC::GetDCBrushColor`	Mengambil warna kuas saat ini.
`CDC::GetDCPenColor`	Mengambil warna pena saat ini.
`CDC::GetDeviceCaps`	Mengambil jenis informasi spesifik perangkat tertentu tentang kemampuan perangkat tampilan tertentu.
`CDC::GetFontData`	Mengambil informasi metrik font dari file font yang dapat diskalakan. Informasi yang akan diambil diidentifikasi dengan menentukan offset ke dalam file font dan panjang informasi yang akan dikembalikan.
`CDC::GetFontLanguageInfo`	Mengembalikan informasi tentang font yang saat ini dipilih untuk konteks tampilan yang ditentukan.
`CDC::GetGlyphOutline`	Mengambil kurva kerangka atau bitmap untuk karakter kerangka dalam font saat ini.
`CDC::GetGraphicsMode`	Mengambil mode grafis saat ini untuk konteks perangkat yang ditentukan.
`CDC::GetHalftoneBrush`	Mengambil sikat halftone.
`CDC::GetKerningPairs`	Mengambil pasangan kerning karakter untuk font yang saat ini dipilih dalam konteks perangkat yang ditentukan.
`CDC::GetLayout`	Mengambil tata letak konteks perangkat (DC). Tata letak dapat berupa kiri ke kanan (default) atau kanan ke kiri (dicerminkan).
`CDC::GetMapMode`	Mengambil mode pemetaan saat ini.
`CDC::GetMiterLimit`	Mengembalikan batas miter untuk konteks perangkat.
`CDC::GetNearestColor`	Mengambil warna logis terdekat ke warna logis tertentu yang dapat diwakili perangkat tertentu.
`CDC::GetOutlineTextMetrics`	Mengambil informasi metrik font untuk font TrueType.
`CDC::GetOutputCharWidth`	Mengambil lebar karakter individual dalam sekelompok karakter berturut-turut dari font saat ini menggunakan konteks perangkat output.
`CDC::GetOutputTabbedTextExtent`	Menghitung lebar dan tinggi string karakter pada konteks perangkat output.
`CDC::GetOutputTextExtent`	Menghitung lebar dan tinggi baris teks pada konteks perangkat output menggunakan font saat ini untuk menentukan dimensi.
`CDC::GetOutputTextMetrics`	Mengambil metrik untuk font saat ini dari konteks perangkat output.
`CDC::GetPath`	Mengambil koordinat yang menentukan titik akhir garis dan titik kontrol kurva yang ditemukan di jalur yang dipilih ke dalam konteks perangkat.
`CDC::GetPixel`	Mengambil nilai warna RGB piksel pada titik yang ditentukan.
`CDC::GetPolyFillMode`	Mengambil mode pengisian poligon saat ini.
`CDC::GetROP2`	Mengambil mode gambar saat ini.
`CDC::GetSafeHdc`	Mengembalikan `CDC::m_hDC`, konteks perangkat output.
`CDC::GetStretchBltMode`	Mengambil mode peregangan bitmap saat ini.
`CDC::GetTabbedTextExtent`	Menghitung lebar dan tinggi string karakter pada konteks perangkat atribut.
`CDC::GetTextAlign`	Mengambil bendera perataan teks.
`CDC::GetTextCharacterExtra`	Mengambil pengaturan saat ini untuk jumlah penspasian antarkarakter.
`CDC::GetTextColor`	Mengambil warna teks saat ini.
`CDC::GetTextExtent`	Menghitung lebar dan tinggi baris teks pada konteks perangkat atribut menggunakan font saat ini untuk menentukan dimensi.
`CDC::GetTextExtentExPointI`	Mengambil jumlah karakter dalam string tertentu yang akan pas dalam spasi tertentu dan mengisi array dengan tingkat teks untuk masing-masing karakter tersebut.
`CDC::GetTextExtentPointI`	Mengambil lebar dan tinggi array indeks glyph yang ditentukan.
`CDC::GetTextFace`	Menyalin nama typeface font saat ini ke dalam buffer sebagai string null-terminated.
`CDC::GetTextMetrics`	Mengambil metrik untuk font saat ini dari konteks perangkat atribut.
`CDC::GetViewportExt`	Mengambil tingkat x dan y dari viewport.
`CDC::GetViewportOrg`	Mengambil koordinat x dan y dari asal viewport.
`CDC::GetWindow`	Mengembalikan jendela yang terkait dengan konteks perangkat tampilan.
`CDC::GetWindowExt`	Mengambil tingkat x dan y dari jendela terkait.
`CDC::GetWindowOrg`	Mengambil koordinat x dan y dari asal jendela terkait.
`CDC::GetWorldTransform`	Mengambil transformasi ruang-dunia ke ruang halaman saat ini.
`CDC::GradientFill`	Mengisi struktur persegi panjang dan segitiga dengan warna memutakhirkan.
`CDC::GrayString`	Menggambar teks redup (abu-abu) di lokasi tertentu.
`CDC::HIMETRICtoDP`	Mengonversi unit HIMETRIC menjadi unit perangkat.
`CDC::HIMETRICtoLP`	Mengonversi unit HIMETRIC menjadi unit logis.
`CDC::IntersectClipRect`	Membuat wilayah kliping baru dengan membentuk persimpangan wilayah saat ini dan persegi panjang.
`CDC::InvertRect`	Balikkan isi persegi panjang.
`CDC::InvertRgn`	Mengalihkan warna di suatu wilayah.
`CDC::IsPrinting`	Menentukan apakah konteks perangkat sedang digunakan untuk pencetakan.
`CDC::LineTo`	Menggambar garis dari posisi saat ini ke atas, tetapi tidak termasuk, titik.
`CDC::LPtoDP`	Mengonversi unit logis menjadi unit perangkat.
`CDC::LPtoHIMETRIC`	Mengonversi unit logis menjadi unit HIMETRIC.
`CDC::MaskBlt`	Menggabungkan data warna untuk bitmap sumber dan tujuan menggunakan operasi masker dan raster yang diberikan.
`CDC::ModifyWorldTransform`	Mengubah transformasi dunia untuk konteks perangkat menggunakan mode yang ditentukan.
`CDC::MoveTo`	Memindahkan posisi saat ini.
`CDC::OffsetClipRgn`	Memindahkan wilayah kliping perangkat yang diberikan.
`CDC::OffsetViewportOrg`	Memodifikasi asal viewport relatif terhadap koordinat asal viewport saat ini.
`CDC::OffsetWindowOrg`	Memodifikasi asal jendela relatif terhadap koordinat asal jendela saat ini.
`CDC::PaintRgn`	Mengisi wilayah dengan kuas yang dipilih.
`CDC::PatBlt`	Membuat pola bit.
`CDC::Pie`	Menggambar gulma berbentuk pai.
`CDC::PlayMetaFile`	Memutar isi metafile yang ditentukan pada perangkat tertentu. Versi `PlayMetaFile` yang disempurnakan menampilkan gambar yang disimpan dalam metafile format yang disempurnakan yang diberikan. Metafile dapat diputar berapa kali.
`CDC::PlgBlt`	Melakukan transfer bit-block dari bit data warna dari persegi panjang yang ditentukan dalam konteks perangkat sumber ke parallelogram yang ditentukan dalam konteks perangkat tertentu.
`CDC::PolyBezier`	Menggambar satu atau beberapa spline Bzier. Posisi saat ini tidak digunakan atau diperbarui.
`CDC::PolyBezierTo`	Menggambar satu atau beberapa spline Bzier, dan memindahkan posisi saat ini ke titik akhir spline Bzier terakhir.
`CDC::PolyDraw`	Menggambar sekumpulan segmen garis dan spline Bzier. Fungsi ini memperbarui posisi saat ini.
`CDC::Polygon`	Menggambar poligon yang terdiri dari dua titik atau lebih (simpul) yang disambungkan oleh garis.
`CDC::Polyline`	Menggambar sekumpulan segmen garis yang menghubungkan titik yang ditentukan.
`CDC::PolylineTo`	Menggambar satu atau beberapa garis lurus dan memindahkan posisi saat ini ke titik akhir baris terakhir.
`CDC::PolyPolygon`	Membuat dua poligon atau lebih yang diisi menggunakan mode pengisian poligon saat ini. Poligon mungkin terputus-putus atau mungkin tumpang tindih.
`CDC::PolyPolyline`	Menggambar beberapa rangkaian segmen garis yang tersambung. Posisi saat ini tidak digunakan atau diperbarui oleh fungsi ini.
`CDC::PtVisible`	Menentukan apakah titik yang diberikan berada dalam wilayah kliping.
`CDC::RealizePalette`	Memetakan entri palet di palet logis saat ini ke palet sistem.
`CDC::Rectangle`	Menggambar persegi panjang menggunakan pena saat ini dan mengisinya menggunakan kuas saat ini.
`CDC::RectVisible`	Menentukan apakah ada bagian dari persegi panjang yang diberikan terletak di dalam wilayah kliping.
`CDC::ReleaseAttribDC`	Rilis `m_hAttribDC`, konteks perangkat atribut.
`CDC::ReleaseOutputDC`	Rilis `m_hDC`, konteks perangkat output.
`CDC::ResetDC`	`m_hAttribDC` Memperbarui konteks perangkat.
`CDC::RestoreDC`	Memulihkan konteks perangkat ke status sebelumnya yang disimpan dengan `SaveDC`.
`CDC::RoundRect`	Menggambar persegi panjang dengan sudut bulat menggunakan pena saat ini dan diisi menggunakan kuas saat ini.
`CDC::SaveDC`	Menyimpan status konteks perangkat saat ini.
`CDC::ScaleViewportExt`	Memodifikasi tingkat viewport relatif terhadap nilai saat ini.
`CDC::ScaleWindowExt`	Memodifikasi jangkauan jendela relatif terhadap nilai saat ini.
`CDC::ScrollDC`	Menggulir persegi panjang bit secara horizontal dan vertikal.
`CDC::SelectClipPath`	Memilih jalur saat ini sebagai wilayah kliping untuk konteks perangkat, menggabungkan wilayah baru dengan wilayah kliping yang ada dengan menggunakan mode yang ditentukan.
`CDC::SelectClipRgn`	Menggabungkan wilayah yang diberikan dengan wilayah kliping saat ini dengan menggunakan mode yang ditentukan.
`CDC::SelectObject`	Memilih objek gambar GDI seperti pena.
`CDC::SelectPalette`	Memilih palet logis.
`CDC::SelectStockObject`	Memilih salah satu pena stok, kuas, atau font yang telah ditentukan sebelumnya yang disediakan oleh Windows.
`CDC::SetAbortProc`	Mengatur fungsi panggilan balik yang disediakan programmer yang dipanggil Windows jika pekerjaan cetak harus dibatalkan.
`CDC::SetArcDirection`	Mengatur arah gambar yang akan digunakan untuk fungsi busur dan persegi panjang.
`CDC::SetAttribDC`	Set , `m_hAttribDC`konteks perangkat atribut.
`CDC::SetBkColor`	Menyetel warna latar belakang saat ini.
`CDC::SetBkMode`	Mengatur mode latar belakang.
`CDC::SetBoundsRect`	Mengontrol akumulasi informasi persegi panjang pembatas untuk konteks perangkat yang ditentukan.
`CDC::SetBrushOrg`	Menentukan asal untuk kuas berikutnya yang dipilih ke dalam konteks perangkat.
`CDC::SetColorAdjustment`	Mengatur nilai penyesuaian warna untuk konteks perangkat menggunakan nilai yang ditentukan.
`CDC::SetDCBrushColor`	Mengatur warna kuas saat ini.
`CDC::SetDCPenColor`	Menyetel warna pena saat ini.
`CDC::SetGraphicsMode`	Mengatur mode grafis saat ini untuk konteks perangkat yang ditentukan.
`CDC::SetLayout`	Mengubah tata letak konteks perangkat (DC).
`CDC::SetMapMode`	Mengatur mode pemetaan saat ini.
`CDC::SetMapperFlags`	Mengubah algoritma yang digunakan pemeta font saat memetakan font logis ke font fisik.
`CDC::SetMiterLimit`	Mengatur batas untuk panjang gabungan miter untuk konteks perangkat.
`CDC::SetOutputDC`	Set , `m_hDC`konteks perangkat output.
`CDC::SetPixel`	Mengatur piksel pada titik yang ditentukan ke perkiraan terdekat dari warna yang ditentukan.
`CDC::SetPixelV`	Mengatur piksel pada koordinat yang ditentukan ke perkiraan terdekat dari warna yang ditentukan. `SetPixelV` lebih cepat daripada `SetPixel` karena tidak perlu mengembalikan nilai warna titik yang dicat.
`CDC::SetPolyFillMode`	Mengatur mode pengisian poligon.
`CDC::SetROP2`	Mengatur mode gambar saat ini.
`CDC::SetStretchBltMode`	Mengatur mode peregangan bitmap.
`CDC::SetTextAlign`	Mengatur bendera perataan teks.
`CDC::SetTextCharacterExtra`	Mengatur jumlah penspasian antarkarakter.
`CDC::SetTextColor`	Mengatur warna teks.
`CDC::SetTextJustification`	Menambahkan spasi ke karakter pemisah dalam string.
`CDC::SetViewportExt`	Mengatur tingkat x dan y dari viewport.
`CDC::SetViewportOrg`	Mengatur asal viewport.
`CDC::SetWindowExt`	Mengatur tingkat x dan y dari jendela terkait.
`CDC::SetWindowOrg`	Mengatur asal jendela konteks perangkat.
`CDC::SetWorldTransform`	Mengatur transformasi ruang-dunia saat ini ke ruang halaman.
`CDC::StartDoc`	Menginformasikan pengandar perangkat bahwa tugas cetak baru sedang dimulai.
`CDC::StartPage`	Menginformasikan driver perangkat bahwa halaman baru sedang dimulai.
`CDC::StretchBlt`	Memindahkan bitmap dari persegi panjang sumber dan perangkat ke persegi panjang tujuan, meregangkan atau mengompresi bitmap jika perlu agar pas dengan dimensi persegi panjang tujuan.
`CDC::StrokeAndFillPath`	Menutup setiap tokoh terbuka di jalur, menyerang garis luar jalur dengan menggunakan pena saat ini, dan mengisi interiornya dengan menggunakan kuas saat ini.
`CDC::StrokePath`	Merender jalur yang ditentukan dengan menggunakan pena saat ini.
`CDC::TabbedTextOut`	Menulis string karakter di lokasi tertentu, memperluas tab ke nilai yang ditentukan dalam array posisi perhentian tab.
`CDC::TextOut`	Menulis string karakter pada lokasi tertentu menggunakan font yang saat ini dipilih.
`CDC::TransparentBlt`	Mentransfer bit-blok data warna dari konteks perangkat sumber yang ditentukan ke dalam konteks perangkat tujuan, merender warna tertentu transparan dalam transfer.
`CDC::UpdateColors`	Memperbarui area klien konteks perangkat dengan mencocokkan warna saat ini di area klien ke palet sistem berdasarkan piksel demi piksel.
`CDC::WidenPath`	Mendefiniskan ulang jalur saat ini sebagai area yang akan dicat jika jalur di-stroke menggunakan pena yang saat ini dipilih ke dalam konteks perangkat.

Operator Publik

Nama	Deskripsi
`CDC::operator HDC`	Mengambil handel konteks perangkat.

Anggota Data Publik

Nama	Deskripsi
`CDC::m_hAttribDC`	Konteks atribut-perangkat yang digunakan oleh objek ini `CDC` .
`CDC::m_hDC`	Konteks perangkat output yang digunakan oleh objek ini `CDC` .

Keterangan

Objek CDC menyediakan fungsi anggota untuk bekerja dengan konteks perangkat, seperti tampilan atau printer, dan anggota untuk bekerja dengan konteks tampilan yang terkait dengan area klien jendela.

Lakukan semua menggambar melalui fungsi CDC anggota objek. Kelas ini menyediakan fungsi anggota untuk operasi konteks perangkat, bekerja dengan alat menggambar, pemilihan objek antarmuka perangkat grafis (GDI) jenis aman, dan bekerja dengan warna dan palet. Ini juga menyediakan fungsi anggota untuk mendapatkan dan mengatur atribut gambar, pemetaan, bekerja dengan viewport, bekerja dengan jangkauan jendela, mengonversi koordinat, bekerja dengan wilayah, kliping, garis gambar, dan menggambar bentuk sederhana, elipsis, dan poligon. Fungsi anggota juga disediakan untuk menggambar teks, bekerja dengan font, menggunakan escape printer, menggulir, dan memutar metafiles.

Untuk menggunakan CDC objek, buat, lalu panggil fungsi anggotanya yang paralel fungsi Windows yang menggunakan konteks perangkat.

Catatan

Di bawah Windows 95/98, semua koordinat layar dibatasi hingga 16 bit. Oleh karena itu, fungsi anggota yang int CDC diteruskan harus terletak pada rentang -32768 hingga 32767.

Untuk penggunaan tertentu, Pustaka Kelas Microsoft Foundation menyediakan beberapa kelas yang berasal dari CDC . CPaintDC merangkum panggilan ke BeginPaint dan EndPaint. CClientDC mengelola konteks tampilan yang terkait dengan area klien jendela. CWindowDC mengelola konteks tampilan yang terkait dengan seluruh jendela, termasuk bingkai dan kontrolnya. CMetaFileDC mengaitkan konteks perangkat dengan metafile.

CDC menyediakan dua fungsi anggota, GetLayout dan SetLayout, untuk mengembalikan tata letak konteks perangkat, yang tidak mewarisi tata letaknya dari jendela. Orientasi kanan-ke-kiri seperti itu diperlukan untuk aplikasi yang ditulis untuk budaya, seperti Arab atau Ibrani, di mana tata letak karakter bukan standar Eropa.

CDC berisi dua konteks perangkat, m_hDC dan m_hAttribDC, yang, pada pembuatan CDC objek, lihat perangkat yang sama. CDC mengarahkan semua panggilan GDI output ke m_hDC dan sebagian besar atribut panggilan GDI ke m_hAttribDC. (Contoh panggilan atribut adalah GetTextColor, sementara SetTextColor adalah panggilan output.)

Misalnya, kerangka kerja menggunakan kedua konteks perangkat ini untuk mengimplementasikan CMetaFileDC objek yang akan mengirim output ke metafile saat membaca atribut dari perangkat fisik. Pratinjau cetak diimplementasikan dalam kerangka kerja dengan cara yang sama. Anda juga dapat menggunakan dua konteks perangkat dengan cara yang sama dalam kode khusus aplikasi Anda.

Ada kalanya Anda mungkin memerlukan informasi metrik teks dari m_hDC konteks perangkat dan m_hAttribDC . Pasangan fungsi berikut menyediakan kemampuan ini:

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

Untuk informasi selengkapnya tentang CDC, lihat Konteks Perangkat.

Hierarki Warisan

CObject

CDC

Persyaratan

Header: afxwin.h

`CDC::AbortDoc`

Mengakhiri pekerjaan cetak saat ini dan menghapus semua yang telah ditulis aplikasi ke perangkat sejak panggilan terakhir ke StartDoc fungsi anggota.

int AbortDoc();

Tampilkan Nilai

Nilai yang lebih besar dari atau sama dengan 0 jika berhasil, atau nilai negatif jika terjadi kesalahan. Daftar berikut ini memperlihatkan nilai kesalahan umum dan artinya:

SP_ERROR Kesalahan umum.
SP_OUTOFDISK Ruang disk tidak cukup saat ini tersedia untuk penampungan, dan tidak ada lagi ruang yang akan tersedia.
SP_OUTOFMEMORY Memori tidak cukup tersedia untuk penampungan.
SP_USERABORT Pengguna mengakhiri pekerjaan melalui Print Manager.

Keterangan

Fungsi anggota ini menggantikan ABORTDOC escape printer.

AbortDoc harus digunakan untuk mengakhiri hal-hal berikut:

Operasi pencetakan yang tidak menentukan fungsi batalkan menggunakan SetAbortProc.
Operasi pencetakan yang belum mencapai panggilan pertama NEWFRAME atau NEXTBAND escape mereka.

Jika aplikasi mengalami kesalahan pencetakan atau operasi cetak yang dibatalkan, aplikasi tidak boleh mencoba mengakhiri operasi dengan menggunakan EndDoc fungsi atau AbortDoc anggota kelas CDC. GDI secara otomatis mengakhiri operasi sebelum mengembalikan nilai kesalahan.

Jika aplikasi menampilkan kotak dialog untuk memungkinkan pengguna membatalkan operasi cetak, aplikasi harus memanggil AbortDoc sebelum menghancurkan kotak dialog.

Jika Print Manager digunakan untuk memulai pekerjaan cetak, panggilan AbortDoc akan menghapus seluruh pekerjaan spool—printer tidak menerima apa pun. Jika Print Manager tidak digunakan untuk memulai pekerjaan cetak, data mungkin telah dikirim ke printer sebelum AbortDoc dipanggil. Dalam hal ini, pengandar pencetak akan mengatur ulang pencetak (jika memungkinkan) dan menutup pekerjaan cetak.

Contoh

Lihat contoh untuk CDC::StartDoc.

`CDC::AbortPath`

Menutup dan membuang jalur apa pun dalam konteks perangkat.

BOOL AbortPath();

Tampilkan Nilai

Bukan nol jika fungsi berhasil; jika tidak, 0.

Keterangan

Jika ada braket jalur terbuka dalam konteks perangkat, tanda kurung siku jalur ditutup dan jalur dibuang. Jika ada jalur tertutup dalam konteks perangkat, jalur akan dibuang.

`CDC::AddMetaFileComment`

Menyalin komentar dari buffer ke dalam metafile format yang disempurnakan tertentu.

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

Parameter

nDataSize
Menentukan panjang buffer komentar, dalam byte.

pCommentData
Arahkan ke buffer yang berisi komentar.

Tampilkan Nilai

Bukan nol jika fungsi berhasil; jika tidak, 0.

Keterangan

Komentar dapat menyertakan informasi privat apa pun — misalnya, sumber gambar dan tanggal pembuatannya. Komentar harus dimulai dengan tanda tangan aplikasi, diikuti oleh data. Komentar tidak boleh berisi data khusus posisi. Data khusus posisi menentukan lokasi rekaman, dan tidak boleh disertakan karena satu metafile dapat disematkan dalam metafile lain. Fungsi ini hanya dapat digunakan dengan metafiles yang ditingkatkan.

`CDC::AlphaBlend`

Panggil fungsi anggota ini untuk menampilkan bitmap yang memiliki piksel transparan atau semitransparan.

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

Parameter

xDest
Menentukan koordinat x, dalam unit logis, dari sudut kiri atas persegi panjang tujuan.

yDest
Menentukan koordinat y, dalam unit logis, dari sudut kiri atas persegi panjang tujuan.

nDestWidth
Menentukan lebar, dalam unit logis, dari persegi panjang tujuan.

nDestHeight
Menentukan tinggi, dalam unit logis, dari persegi panjang tujuan.

pSrcDC
Penunjuk ke konteks perangkat sumber.

xSrc
Menentukan koordinat x, dalam unit logis, dari sudut kiri atas persegi panjang sumber.

ySrc
Menentukan koordinat y, dalam unit logis, dari sudut kiri atas persegi panjang sumber.

nSrcWidth
Menentukan lebar, dalam unit logis, dari persegi panjang sumber.

nSrcHeight
Menentukan tinggi, dalam unit logis, dari persegi panjang sumber.

blend
BLENDFUNCTION Menentukan struktur.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

Lihat AlphaBlend di Windows SDK untuk informasi selengkapnya.

`CDC::AngleArc`

Menggambar segmen garis dan busur.

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

Parameter

x
Menentukan koordinat x logis dari pusat lingkaran.

y
Menentukan koordinat y logis dari pusat lingkaran.

nRadius
Menentukan radius lingkaran dalam unit logis. Nilai ini harus positif.

fStartAngle
Menentukan sudut awal dalam derajat relatif terhadap sumbu x.

fSweepAngle
Menentukan sudut sapuan dalam derajat relatif terhadap sudut awal.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Segmen garis ditarik dari posisi saat ini ke awal busur. Busur digambar di sepanjang perimeter lingkaran dengan radius dan tengah yang diberikan. Panjang busur didefinisikan oleh sudut mulai dan sapuan yang diberikan.

AngleArc memindahkan posisi saat ini ke titik akhir busur. Busur yang digambar oleh fungsi ini mungkin tampak elips, tergantung pada transformasi saat ini dan mode pemetaan. Sebelum menggambar busur, fungsi ini menarik segmen garis dari posisi saat ini ke awal busur. Busur digambar dengan membangun lingkaran imajiner dengan radius yang ditentukan di sekitar titik tengah yang ditentukan. Titik awal busur ditentukan dengan mengukur berlawanan arah jarum jam dari sumbu x lingkaran dengan jumlah derajat dalam sudut awal. Titik akhir juga terletak sama dengan mengukur berlawanan arah jarum arah dari titik awal dengan jumlah derajat dalam sudut sapuan.

Jika sudut pembersihan lebih besar dari 360 derajat busur disapu beberapa kali. Fungsi ini menggambar garis dengan menggunakan pena saat ini. Gambarnya tidak terisi.

`CDC::Arc`

Menggambar busur elips.

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

Parameter

x1
Menentukan koordinat x dari sudut kiri atas persegi panjang pembatas (dalam unit logis).

y1
Menentukan koordinat y dari sudut kiri atas persegi panjang pembatas (dalam unit logis).

x2
Menentukan koordinat x dari sudut kanan bawah persegi panjang pembatas (dalam unit logis).

y2
Menentukan koordinat y dari sudut kanan bawah persegi panjang pembatas (dalam unit logis).

x3
Menentukan koordinat x titik yang menentukan titik awal busur (dalam unit logis). Titik ini tidak harus berbohong persis di busur.

y3
Menentukan koordinat y dari titik yang menentukan titik awal busur (dalam unit logis). Titik ini tidak harus berbohong persis di busur.

x4
Menentukan koordinat x titik yang menentukan titik akhir busur (dalam unit logis). Titik ini tidak harus berbohong persis di busur.

y4
Menentukan koordinat y dari titik yang menentukan titik akhir busur (dalam unit logis). Titik ini tidak harus berbohong persis di busur.

lpRect
Menentukan persegi panjang pembatas (dalam unit logis). Anda dapat meneruskan LPRECT objek atau CRect untuk parameter ini.

ptStart
Menentukan koordinat x dan y dari titik yang menentukan titik awal busur (dalam unit logis). Titik ini tidak harus berbohong persis di busur. Anda dapat meneruskan POINT struktur atau CPoint objek untuk parameter ini.

ptEnd
Menentukan koordinat x dan y dari titik yang menentukan titik akhir busur (dalam unit logis). Titik ini tidak harus berbohong persis di busur. Anda dapat meneruskan POINT struktur atau CPoint objek untuk parameter ini.

Tampilkan Nilai

Bukan nol jika fungsi berhasil; jika tidak, 0.

Keterangan

Busur yang digambar dengan menggunakan fungsi adalah segmen elips yang ditentukan oleh persegi panjang pembatas yang ditentukan.

Titik awal aktual busur adalah titik di mana sinar ditarik dari tengah persegi panjang pembatas melalui titik awal yang ditentukan bersinggungan dengan elips. Titik akhir aktual busur adalah titik di mana sinar ditarik dari tengah persegi panjang pembatas melalui titik akhir yang ditentukan bersinggungan dengan elips. Busur digambar ke arah berlawanan arah jaga. Karena busur bukan figur tertutup, itu tidak terisi. Lebar dan tinggi persegi panjang harus lebih besar dari 2 unit dan kurang dari 32.767 unit.

Contoh

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`

Menggambar busur elips.

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