Membuat Kontrol Kotak Alat WPF

Artikel
12/21/2023

Templat Kontrol Kotak Alat WPF (Windows Presentation Framework) memungkinkan Anda membuat kontrol WPF yang secara otomatis ditambahkan ke Kotak Alat saat ekstensi diinstal. Panduan ini menunjukkan cara menggunakan templat untuk membuat kontrol Kotak Alat yang dapat Anda distribusikan ke pengguna lain.

Membuat Kontrol Kotak Alat

Membuat ekstensi dengan Kontrol Kotak Alat WPF

Buat proyek VSIX bernama MyToolboxControl. Anda dapat menemukan templat proyek VSIX dalam dialog Proyek Baru dengan mencari "vsix".
Saat proyek terbuka, tambahkan templat item Kontrol Kotak Alat WPF bernama MyToolboxControl. Di Penjelajah Solusi, klik kanan simpul proyek dan pilih Tambahkan>Item Baru. Dalam dialog Tambahkan Item Baru, buka Visual C#>Ekstensibilitas dan pilih Kontrol Kotak Alat WPF. Di bidang Nama di bagian bawah jendela, ubah nama file perintah menjadi MyToolboxControl.cs.

Solusinya sekarang berisi kontrol pengguna, ProvideToolboxControlAttribute RegistrationAttribute yang menambahkan kontrol ke Kotak Alat, dan entri Aset Microsoft.VisualStudio.ToolboxControl dalam manifes VSIX untuk penyebaran.

Untuk membuat UI kontrol

Buka MyToolboxControl.xaml di perancang.

Perancang memperlihatkan Grid kontrol yang berisi Button kontrol.
Atur tata letak kisi. Saat Anda memilih Grid kontrol, bilah kontrol biru muncul di tepi atas dan kiri kisi. Anda dapat menambahkan baris dan kolom ke kisi dengan mengklik bilah.
Tambahkan kontrol anak ke kisi. Anda dapat memposisikan kontrol anak dengan menyeretnya dari Kotak Alat ke bagian kisi, atau dengan mengatur atribut dan Grid.Column di Grid.Row XAML. Contoh berikut menambahkan dua label di baris atas kisi dan tombol pada baris kedua.
```
<Grid>
    <Label Grid.Row="0" Grid.Column="0" Name="label1" />
    <Label Grid.Row="0" Grid.Column="1" Name="label2" />
    <Button Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
</Grid>
```

Mengganti nama kontrol

Secara default, kontrol Anda akan muncul di Kotak Alat sebagai MyToolboxControl dalam grup bernama MyToolboxControl.MyToolboxControl. Anda dapat mengubah nama-nama ini dalam file MyToolboxControl.xaml.cs .

Buka MyToolboxControl.xaml.cs dalam tampilan kode.
MyToolboxControl Temukan kelas dan ganti namanya menjadi TestControl. (Cara tercepat untuk melakukan ini adalah dengan mengganti nama kelas, lalu pilih Ganti nama dari menu konteks dan selesaikan langkah-langkahnya. (Untuk informasi selengkapnya tentang Ganti nama perintah, lihat Mengganti nama pemfaktoran ulang (C#).)
ProvideToolboxControl Buka atribut dan ubah nilai parameter pertama menjadi Uji. Ini adalah nama grup yang akan berisi kontrol di Kotak Alat.

Kode yang dihasilkan akan terlihat seperti ini:
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

Membangun, menguji, dan menyebarkan

Saat men-debug proyek, Anda harus menemukan kontrol yang diinstal di Kotak Alat instans eksperimental Visual Studio.

Untuk membangun dan menguji kontrol

Bangun ulang proyek dan mulai penelusuran kesalahan.
Dalam instans baru Visual Studio, buat proyek Aplikasi WPF. Pastikan XAML Designer terbuka.
Temukan kontrol Anda di Kotak Alat dan seret ke permukaan desain.
Mulai debugging aplikasi WPF.
Verifikasi bahwa kontrol Anda muncul.

Untuk menyebarkan kontrol

Setelah membuat proyek yang diuji, Anda dapat menemukan file .vsix di folder *\bin\debug* proyek.
Anda dapat menginstalnya di komputer lokal dengan mengklik dua kali file .vsix dan mengikuti prosedur penginstalan. Untuk menghapus instalan kontrol, buka >Ekstensi Alat dan Pembaruan dan cari ekstensi kontrol, lalu klik Hapus instalan.
Unggah file .vsix ke jaringan atau ke situs Web.

Jika Anda mengunggah file ke situs Web Visual Studio Marketplace, pengguna lain dapat menggunakan >Ekstensi alat dan Pembaruan di Visual Studio untuk menemukan kontrol secara online dan menginstalnya.

Bagikan melalui

Membuat Kontrol Kotak Alat WPF