Rect Struktur

Referensi

Definisi

Ruang nama:: Windows.Foundation

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Berisi nilai angka yang mewakili lokasi dan ukuran persegi panjang.

public value class Rect

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
struct Rect

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
public struct Rect

var rect = {
x : /* Your value */,
y : /* Your value */,
width : /* Your value */,
height : /* Your value */
}

Public Structure Rect

<object property="x,y,width,height"/>
-or-
<object property="x y width height"/>

Warisan: ValueType
Rect

Atribut: ContractVersionAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (diperkenalkan dalam v1.0)

Keterangan

Saat diterapkan ke properti yang mewakili informasi UI, nilai lebar dan tinggi nilai Rect mewakili piksel independen perangkat. Nilai x dan y memiliki bingkai referensi yang tidak ditentukan (tergantung pada bagaimana nilai ini diterapkan) tetapi sering mewakili titik di ruang koordinat jendela aplikasi utama.

Javascript: Di JavaScript, Rect adalah objek dengan empat anggota data: x, y, lebar, tinggi. Selain anggota data (bidang), API yang tercantum dalam daftar Anggota rect tidak berlaku untuk pemrograman JavaScript.

Catatan tentang sintaks XAML

Penggunaan atribut objek secara teknis diizinkan oleh aturan penguraian XAML Windows Runtime. Namun, penggunaan tersebut tidak ditampilkan karena tidak umum digunakan.

Anda dapat menggunakan spasi daripada koma sebagai pemisah di antara nilai. Penggunaan pemisah campuran juga diizinkan.

Anda harus menentukan keempat nilai. "0,0" bukan default implisit untuk "x,y", dan tidak ada konvensi lain yang dapat mengurai kurang dari 4 komponen dalam string.

Elemen Rect tidak dapat dinyatakan sebagai sumber daya dalam ResourceDictionary XAML karena Rect bukan jenis yang dapat dibagikan (untuk info selengkapnya lihat Referensi sumber daya ResourceDictionary dan XAML).

Nilai rect dan bagaimana nilai tersebut ditafsirkan oleh properti

Ukuran adalah struktur serupa yang menggunakan metafora tinggi dan lebar yang sama. Namun, Rect menentukan titik asal, sedangkan Ukuran tidak. Biasanya Rect digunakan untuk API pustaka grafis, dan Ukuran digunakan untuk presentasi dan tata letak di antarmuka pengguna aplikasi, terutama untuk tata letak adaptif (di mana posisinya sering otomatis).

Perilaku khas nilai Rect saat diterapkan ke properti mengikuti prinsip-prinsip berikut:

Lebar dan Tinggi tidak boleh negatif.
X dan Y bisa negatif, dengan hasil bahwa definisi Rect berada di luar bingkai koordinat referensi kecuali ada terjemahan tambahan.
X dan Y bisa 0. Nilai 0 juga berlaku untuk Lebar atau Tinggi. (Namun, jika Rect dengan nilai 0 untuk Lebar atau Tinggi diterapkan ke RectangleGeometry, RectangleGeometry yang dihasilkan tidak merender.)
X, Y, Lebar , dan Tinggi dapat menjadi nilai non-bilangan bulat dalam hal nilai yang diizinkan. Namun, Anda biasanya menggunakan nilai bilangan bulat. UI XAML berperilaku paling baik saat lokasi titik dan pengukuran unit tidak menggunakan nilai sub-piksel.

Proyeksi bahasa dan anggota Rect

Jika Anda menggunakan bahasa Microsoft .NET (C# atau Microsoft Visual Basic) atau ekstensi komponen Visual C++ (C++/CX), maka Rect memiliki anggota non-data yang tersedia, dan anggota datanya diekspos sebagai properti baca-tulis, bukan bidang. Lihat Rect di Browser .NET API.

Jika Anda memprogram dengan C++/WinRT atau Windows Runtime C++ Template Library (WRL), maka hanya bidang anggota data yang ada sebagai anggota Rect, dan Anda tidak dapat menggunakan metode utilitas atau properti proyeksi .NET. Kode C++ dapat mengakses metode utilitas serupa yang tersedia dari kelas statis RectHelper .

Tabel ini memperlihatkan metode yang setara yang tersedia di .NET dan C++.

.NET (Rect)	C++ (RectHelper)
Rect(Point, Point)	FromPoints(Point, Point)
Rect(Point, Size)	FromLocationAndSize(Point, Size)
Rect(Double, Double, Double, Double)	FromCoordinatesAndDimensions(Single, Single, Single, Single)
Bawah	GetBottom(Rect)
Kosong	Kosong
IsEmpty	GetIsEmpty(Rect)
Left	GetLeft(Rect)
Kanan	Getright(Rect)
Teratas	GetTop(Rect)
Contains(Point)	Contains(Rect, Point)
Equals	Sama dengan(Rect, Rect)
Intersect(Rect)	Intersect(Rect, Rect)
Union(Point)	Union(Rect, Point)
Union(Rect)	Union(Rect, Rect)

Bidang

Height	Tinggi persegi panjang, dalam piksel.
Width	Lebar persegi panjang, dalam piksel.
X	Koordinat x sudut kiri atas persegi panjang.
Y	Koordinat y dari sudut kiri atas persegi panjang.

Berlaku untuk