IPicture::get_CurDC method (ocidl.h)

Mengambil handel konteks perangkat saat ini. Properti ini hanya valid untuk gambar bitmap.

Sintaks

HRESULT get_CurDC(
  [out] HDC *phDC
);

Parameter

[out] phDC

Penunjuk variabel yang menerima konteks perangkat.

Nilai kembali

Metode ini mendukung nilai pengembalian standar E_FAIL, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Bit atribut berhasil dikembalikan.
E_POINTER	Nilai phDC tidak valid. Misalnya, mungkin NULL.

Keterangan

Properti CurDC dan metode IPicture::SelectPicture ada untuk menghindari pembatasan di Windows; secara khusus, bahwa objek hanya dapat dipilih ke dalam tepat satu konteks perangkat pada satu waktu. Dalam beberapa kasus, objek gambar dapat dipilih secara permanen ke dalam konteks perangkat tertentu (misalnya, kontrol dapat menggunakan gambar tertentu untuk latar belakang). Untuk menggunakan properti gambar ini di tempat lain, properti harus dibatalkan sementara dari konteks perangkat lamanya, dipilih ke konteks perangkat baru untuk operasi, lalu dipilih kembali ke konteks perangkat lama. Metode IPicture::get_CurDC mengembalikan handel konteks perangkat tempat gambar saat ini dipilih. Metode IPicture::SelectPicture memilih gambar ke dalam konteks perangkat baru, mengembalikan konteks perangkat lama dan handel GDI gambar. Penelepon harus memilih gambar kembali ke konteks perangkat lama ketika pemanggil selesai dengannya, seperti biasa untuk kode Windows.

Catatan untuk Penelepon

Penelepon selalu memiliki konteks perangkat apa pun yang diteruskan antara itu dan objek gambar. Karena objek gambar mempertahankan salinan HDC, pemanggil harus menggunakan konteks perangkat memori (dibuat dengan fungsi CreateCompatibleDC ) dan bukan konteks perangkat layar (dari GetDC, CreateDC, atau BeginPaint), karena konteks perangkat layar adalah sumber daya sistem terbatas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ocidl.h

Lihat juga

IPicture

IPicture::SelectPicture