IViewObject::Metode pembekuan (oleidl.h)

Artikel
03/15/2023

Membekukan representasi objek yang digambar sehingga tidak akan berubah hingga metode IViewObject::Unfreeze dipanggil. Penggunaan paling umum dari metode ini adalah untuk pencetakan ber pita.

Sintaks

HRESULT Freeze(
  [in]  DWORD dwDrawAspect,
  [in]  LONG  lindex,
  [in]  void  *pvAspect,
  [out] DWORD *pdwFreeze
);

Parameter

[in] dwDrawAspect

Menentukan bagaimana objek akan diwakili. Representasi mencakup konten, ikon, gambar mini, atau dokumen yang dicetak. Nilai yang valid diambil dari DVASPECT enumerasi. Lihat enumerasi DVASPECT untuk informasi selengkapnya.

[in] lindex

Bagian dari objek yang menarik untuk operasi gambar. Interpretasinya bervariasi menurut dwAspect. Lihat enumerasi DVASPECT untuk informasi selengkapnya.

[in] pvAspect

Penunjuk ke informasi tambahan tentang tampilan objek yang ditentukan dalam dwAspect. Karena tidak ada aspek saat ini yang mendukung informasi tambahan, pvAspect harus selalu NULL.

[out] pdwFreeze

Pointer ke tempat kunci DWORD yang mengidentifikasi dikembalikan. Kunci unik ini kemudian digunakan untuk membatalkan pembekuan dengan memanggil IViewObject::Unfreeze. Kunci ini adalah indeks yang digunakan cache default untuk melacak objek mana yang dibekukan.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
VIEW_S_ALREADY_FROZEN	Presentasi telah dibekukan. Nilai pdwFreeze adalah kunci identifikasi dari objek yang sudah dibekukan.
OLE_E_BLANK	Presentasi tidak dalam cache.
DV_E_LINDEX	Nilai tidak valid untuk lindex; Sedang; hanya -1 yang didukung.
DV_E_DVASPECT	Nilai tidak valid untuk dwAspect.

Keterangan

Metode IViewObject::Freeze menyebabkan objek tampilan membekukan representasi yang digambarnya hingga panggilan berikutnya ke IViewObject::Unfreeze merilisnya. Setelah memanggil IViewObject::Freeze, panggilan berturut-turut ke IViewObject::D raw dengan parameter yang sama menghasilkan gambar yang sama sampai IViewObject::Unfreeze dipanggil.

IViewObject::Freeze bukan bagian dari status persisten objek dan tidak berlanjut di seluruh bongkar dan muat ulang objek.

Penggunaan paling umum dari metode ini adalah untuk pencetakan ber pita.

Saat dalam keadaan beku, pemberitahuan tampilan tidak dikirim. Pemberitahuan tampilan tertunda ditangguhkan ke panggilan berikutnya ke IViewObject::Unfreeze.

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	oleidl.h

Lihat juga

DVASPECT

IViewObject

IViewObject::Unfreeze

Bagikan melalui