Bagikan melalui


SnapLine Kelas

Definisi

Mewakili segmen garis horizontal dan vertikal yang dibuat secara dinamis di antarmuka pengguna (UI) untuk membantu tata letak kontrol waktu desain dalam kontainer. Kelas ini tidak dapat diwariskan.

public ref class SnapLine sealed
public sealed class SnapLine
type SnapLine = class
Public NotInheritable Class SnapLine
Warisan
SnapLine

Keterangan

Tabel berikut mencantumkan mode umum yang didukung alat desain visual untuk membantu Anda memposisikan dan mengubah ukuran kontrol pada permukaan desain.

Mode Deskripsi
Bentuk bebas Memungkinkan Anda untuk bebas meletakkan kontrol.
Kotak Menampilkan kisi yang dilapisi statis yang membantu Anda meletakkan kontrol.
Garis Snapline Menampilkan garis panduan yang membantu Anda meletakkan kontrol kontainer relatif satu sama lain. Snapline berasal dari kontrol dan kontainernya.

Kelas SnapLine dan jenis terkait membantu mendukung mode Snapline.

Snapline dihasilkan secara dinamis dan otomatis saat tepi kontrol bergerak di dekat kontrol lain atau di dekat batas kontainernya. Ini dapat terjadi ketika kontrol ditambahkan dari kotak alat, atau dipindahkan atau diubah ukurannya oleh operasi mouse atau perintah keyboard. Kontrol biasanya memiliki garis bayangan horizontal dan vertikal yang ditentukan; untuk kontrol persegi panjang, ini biasanya meluas dari keempat tepi.

Kelas SnapLine hanya menggunakan beberapa properti untuk menjelaskan setiap snapline, seperti yang ditunjukkan dalam tabel berikut.

Properti Deskripsi
SnapLineType Menentukan lokasi dan arah garis sehubungan dengan kontrol terkait. Biasanya, hanya snapline dari jenis serupa yang akan secara otomatis selaras satu sama lain.
Offset Menentukan jarak dalam piksel dari asal, yang merupakan sudut kiri atas kontrol, ke tempat snapline dimulai.
Priority Menentukan kepentingan relatif dari snapline. Selama titik keputusan tata letak tertentu, hanya snapline yang aktif dan memiliki prioritas tertinggi yang ditampilkan.
Filter Menentukan kategori snapline kustom. Ini adalah string opsional.
IsHorizontal dan IsVertical Menunjukkan apakah snapline masing-masing memiliki orientasi horizontal atau vertikal.

Kelas ControlDesigner menyimpan snapline untuk jenis kontrol yang sesuai di SnapLines properti . Penanganan kelas dasar snapline ini akan cukup untuk sebagian besar kontrol, karena mendefinisikan Left, , RightTop, dan Bottom snapline, yang selaras di sepanjang tepi kontrol. Ketika Anda mengembangkan kontrol kustom, jika organisasi default ini tidak cukup, ambil alih SnapLines properti kelas yang berasal dari ControlDesigner. Misalnya, Anda mungkin ingin meratakan garis snapline horizontal kontrol berbasis teks, seperti label, dengan garis atas dan dasar teks (bukan tepi atas dan bawah kontrol).

Kelas SnapLineType tidak dapat berasal dari.

Ada dukungan ekstensif untuk fitur ini di Visual Studio, lihat Panduan: Mengatur Kontrol pada Formulir Windows Menggunakan Snapline.

Konstruktor

SnapLine(SnapLineType, Int32)

Menginisialisasi instans SnapLine baru kelas menggunakan jenis snapline dan offset yang ditentukan.

SnapLine(SnapLineType, Int32, SnapLinePriority)

Menginisialisasi instans SnapLine baru kelas menggunakan jenis snapline, offset, dan prioritas yang ditentukan.

SnapLine(SnapLineType, Int32, String)

Menginisialisasi instans SnapLine baru kelas menggunakan jenis snapline, offset, dan nama filter yang ditentukan.

SnapLine(SnapLineType, Int32, String, SnapLinePriority)

Menginisialisasi instans SnapLine baru kelas menggunakan jenis snapline, offset, nama filter, dan prioritas yang ditentukan.

Properti

Filter

Mendapatkan kategori filter yang ditentukan programmer yang terkait dengan snapline ini.

IsHorizontal

Mendapatkan nilai yang menunjukkan apakah snapline memiliki orientasi horizontal.

IsVertical

Mendapatkan nilai yang menunjukkan apakah snapline memiliki orientasi vertikal.

Offset

Mendapatkan jumlah piksel yang diimbangi snapline dari asal kontrol terkait.

Priority

Mendapatkan nilai yang menunjukkan kepentingan relatif dari snapline.

SnapLineType

Mendapatkan jenis snapline, yang menunjukkan lokasi dan orientasi umum.

Metode

AdjustOffset(Int32)

Offset Menyesuaikan properti snapline.

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
ShouldSnap(SnapLine, SnapLine)

Mengembalikan nilai yang menunjukkan apakah yang ditentukan SnapLine harus diposisikan ke nilai lain SnapLine.

ToString()

Mengembalikan representasi string dari snapline saat ini.

Berlaku untuk

Lihat juga