Kontrol dengan Dukungan Built-In Owner-Drawing

Artikel
06/02/2023

Gambar pemilik dalam Formulir Windows, yang juga dikenal sebagai gambar kustom, adalah teknik untuk mengubah tampilan visual kontrol tertentu.

Catatan

Kata "kontrol" dalam topik ini digunakan untuk berarti kelas yang berasal dari Control atau Component.

Biasanya, Windows menangani lukisan secara otomatis dengan menggunakan pengaturan properti seperti BackColor untuk menentukan tampilan kontrol. Dengan gambar pemilik, Anda mengambil alih proses pengecatan, mengubah elemen penampilan yang tidak tersedia dengan menggunakan properti. Misalnya, banyak kontrol memungkinkan Anda mengatur warna teks yang ditampilkan, tetapi Anda terbatas pada satu warna. Gambar pemilik memungkinkan Anda untuk melakukan hal-hal seperti menampilkan bagian teks dalam warna hitam dan sebagian berwarna merah.

Dalam praktiknya, gambar pemilik mirip dengan menggambar grafik pada formulir. Misalnya, Anda dapat menggunakan metode grafis dalam handler untuk acara formulir Paint untuk meniru ListBox kontrol, tetapi Anda harus menulis kode Anda sendiri untuk menangani semua interaksi pengguna. Dengan gambar pemilik, kontrol menggunakan kode Anda untuk menggambar kontennya tetapi sebaliknya mempertahankan semua kemampuan intrinsiknya. Anda dapat menggunakan metode grafis untuk menggambar setiap item dalam kontrol atau untuk menyesuaikan beberapa aspek setiap item saat Anda menggunakan tampilan default untuk aspek lain dari setiap item.

Gambar Pemilik di Kontrol Formulir Windows

Untuk melakukan gambar pemilik dalam kontrol yang mendukungnya, Anda biasanya akan mengatur satu properti dan menangani satu atau beberapa peristiwa.

Sebagian besar kontrol yang mendukung gambar pemilik memiliki OwnerDraw properti atau DrawMode yang menunjukkan apakah kontrol akan meningkatkan peristiwa atau peristiwa terkait gambarnya ketika melukis dirinya sendiri.

Kontrol yang tidak memiliki OwnerDraw properti atau DrawMode mencakup DataGridView kontrol, yang menyediakan peristiwa gambar yang terjadi secara otomatis, dan ToolStrip kontrol, yang digambar menggunakan kelas penyajian eksternal yang memiliki peristiwa terkait gambarnya sendiri.

Ada banyak jenis peristiwa gambar yang berbeda, tetapi peristiwa gambar umum terjadi untuk menggambar satu item dalam kontrol. Penanganan aktivitas menerima EventArgs objek yang berisi informasi tentang item yang digambar dan alat yang dapat Anda gunakan untuk menggambarnya. Misalnya, objek ini biasanya berisi nomor indeks item dalam koleksi induknya, Rectangle yang menunjukkan batas tampilan item, dan Graphics objek untuk memanggil metode cat. Untuk beberapa peristiwa, EventArgs objek menyediakan informasi tambahan tentang item dan metode yang dapat Anda panggil untuk melukis beberapa aspek item secara default, seperti latar belakang atau persegi panjang fokus.

Untuk membuat kontrol yang dapat digunakan kembali yang berisi kustomisasi yang digambar pemilik Anda, buat kelas baru yang berasal dari kelas kontrol yang mendukung gambar pemilik. Daripada menangani peristiwa gambar, sertakan kode gambar pemilik Anda dalam penimpaan untuk metode atau metode EventName yang sesuai Ondi kelas baru. Pastikan Anda memanggil metode atau metode EventName kelas Ondasar dalam hal ini sehingga pengguna kontrol Anda dapat menangani peristiwa gambar pemilik dan memberikan kustomisasi tambahan.

Kontrol Formulir Windows berikut mendukung gambar pemilik di semua versi .NET Framework:

ListBox
ComboBox
MenuItem (digunakan oleh MainMenu dan ContextMenu)
TabControl

Kontrol berikut ini mendukung gambar pemilik hanya di .NET Framework 2.0:

Kontrol berikut mendukung gambar pemilik dan baru di .NET Framework 2.0:

Bagian berikut ini menyediakan detail tambahan untuk setiap kontrol ini.

Kontrol ListBox dan ComboBox

Kontrol ListBox dan ComboBox memungkinkan Anda menggambar item individual dalam kontrol baik dalam satu ukuran, atau dalam berbagai ukuran.

Catatan

CheckedListBox Meskipun kontrol berasal dari ListBox kontrol, kontrol tidak mendukung gambar pemilik.

Untuk menggambar setiap item dengan ukuran yang sama, atur DrawMode properti ke OwnerDrawFixed dan tangani DrawItem peristiwa.

Untuk menggambar setiap item menggunakan ukuran yang berbeda, atur DrawMode properti ke OwnerDrawVariable dan tangani peristiwa MeasureItem dan DrawItem . Kejadian ini MeasureItem memungkinkan Anda menunjukkan ukuran item sebelum peristiwa terjadi untuk item tersebut DrawItem .

Untuk informasi selengkapnya, termasuk contoh kode, lihat topik berikut:

Komponen MenuItem

Komponen MenuItem mewakili satu item menu dalam komponen MainMenu atau ContextMenu .

Untuk menggambar MenuItem, atur propertinya OwnerDraw ke true dan tangani peristiwanya DrawItem . Untuk mengkustomisasi ukuran item menu sebelum DrawItem peristiwa terjadi, tangani peristiwa item MeasureItem .