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

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

Sintaks

HRESULT SetOffsetX(
  [in] float offsetX
);

Parameter

[in] offsetX

Jenis: float

Offset baru visual di sepanjang sumbu x, 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 offsetX adalah NaN, infinity positif, atau infinity negatif.

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

Transformasi yang ditentukan oleh properti Transformasi diterapkan setelah properti OffsetX. Dengan kata lain, efek pengaturan properti Transformasi dan properti OffsetX sama dengan mengatur hanya properti Transformasi pada objek grup transformasi di mana anggota pertama grup adalah objek IDCompositionTranslateTransform yang memiliki nilai OffsetX yang sama dengan offsetX. Namun, Anda harus menggunakan IDCompositionVisual::SetOffsetX 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 OffsetX 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::SetOffsetY

IDCompositionVisual::SetTransform