Bagikan melalui

SnapLine Kelas

Definisi

Ruang nama:
System.Windows.Forms.Design.Behavior
Rakitan:
System.Design.dll
Rakitan:
System.Windows.Forms.Design.dll
Rakitan:
System.Design.dll, System.Windows.Forms.Design.dll
Sumber:
SnapLine.cs
Sumber:
SnapLine.cs
Sumber:
SnapLine.cs
Sumber:
SnapLine.cs
Sumber:
SnapLine.cs

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
Object
SnapLine

Keterangan

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

Modus Deskripsi
Bentuk bebas Memungkinkan Anda untuk bebas meletakkan kontrol.
Jaringan Menampilkan kisi berlapis 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 snapline horizontal dan vertikal yang ditentukan; untuk kontrol persegi panjang, biasanya diperluas dari keempat tepi.

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

Harta benda 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 memiliki orientasi horizontal atau vertikal.

Kelas ControlDesigner menyimpan snapline untuk jenis kontrol yang sesuai di SnapLines properti . Penanganan snapline kelas dasar ini akan cukup untuk sebagian besar kontrol, karena mendefinisikan Leftsnapline , , RightTop, dan Bottom , 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

Nama Deskripsi
SnapLine(SnapLineType, Int32, SnapLinePriority)

Menginisialisasi instans SnapLine baru kelas menggunakan jenis snapline, offset, dan prioritas yang ditentukan.
SnapLine(SnapLineType, Int32, String, SnapLinePriority)

Menginisialisasi instans SnapLine baru kelas menggunakan jenis snapline, offset, nama filter, 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)

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

Properti

Nama Deskripsi
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

Nama Deskripsi
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 Type instans saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
ShouldSnap(SnapLine, SnapLine)

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

Mengembalikan representasi string dari snapline saat ini.

Berlaku untuk

Lihat juga