Metode IDCompositionVisual::SetOffsetY(float) (dcomp.h)

Mengubah nilai properti OffsetY dari visual ini. Properti OffsetY menentukan offset baru visual di sepanjang sumbu y, relatif terhadap visual induk.

Sintaks

HRESULT SetOffsetY(
  [in] float offsetY
);

Parameter

[in] offsetY

Jenis: float

Offset baru visual di sepanjang sumbu y, dalam piksel.

Nilai kembali

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.

Keterangan

Metode ini gagal jika parameter offsetY adalah NaN, infinity positif, atau infinity negatif.

Mengubah properti OffsetY mengubah sistem koordinat seluruh subtree visual yang berakar pada visual ini. Jika properti Klip visual ini ditentukan, persegi panjang klip juga diubah.

Transformasi yang ditentukan oleh properti Transformasi diterapkan setelah properti OffsetY. Dengan kata lain, efek pengaturan properti Transformasi dan properti OffsetY sama dengan mengatur hanya properti Transformasi pada objek grup transformasi di mana anggota pertama grup adalah objek IDCompositionTranslateTransform yang memiliki nilai OffsetY yang sama dengan offsetY. Namun, Anda harus menggunakan IDCompositionVisual::SetOffsetY jika memungkinkan karena sedikit lebih cepat.

Jika properti OffsetX dan OffsetY diatur ke 0, dan properti Transformasi diatur ke NULL, sistem koordinat visual sama dengan induknya.

Jika properti OffsetY sebelumnya dianimasikan, metode ini menghapus animasi dan mengatur properti ke nilai statis yang ditentukan.

Contoh

Misalnya, lihat Cara Membangun Pohon Visual Sederhana.

Persyaratan

Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	dcomp.h
Pustaka	Dcomp.lib
DLL	Dcomp.dll

Lihat juga

IDCompositionVisual

IDCompositionVisual::SetOffsetX

IDCompositionVisual::SetTransform