SnapLine Kelas
Definisi
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.
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. |