Formanty z wbudowaną obsługą rysowania przez właściciela

Artykuł
10/18/2023

Rysunek właściciela w formularzach systemu Windows, nazywany również rysunkiem niestandardowym, jest techniką zmiany wyglądu wizualizacji niektórych kontrolek.

Uwaga

Słowo "control" w tym temacie służy do oznaczania klas, które pochodzą z Control klasy lub Component.

Zazwyczaj system Windows automatycznie obsługuje malowanie przy użyciu ustawień właściwości, takich jak BackColor określanie wyglądu kontrolki. Za pomocą rysunku właściciela przejmujesz proces malowania, zmieniając elementy wyglądu, które nie są dostępne przy użyciu właściwości. Na przykład wiele kontrolek umożliwia ustawienie koloru wyświetlanego tekstu, ale jest ograniczony do jednego koloru. Rysunek właściciela umożliwia wykonywanie takich czynności, jak wyświetlanie części tekstu w kolorze czarnym i części czerwonej.

W praktyce rysunek właściciela jest podobny do rysunku grafiki na formularzu. Na przykład można użyć metod graficznych w procedurze obsługi zdarzenia formularza Paint w celu emulowania ListBox kontrolki, ale trzeba byłoby napisać własny kod do obsługi całej interakcji użytkownika. Za pomocą rysunku właściciela kontrolka używa kodu do rysowania jego zawartości, ale w przeciwnym razie zachowuje wszystkie jego możliwości wewnętrzne. Metody graficzne umożliwiają rysowanie każdego elementu w kontrolce lub dostosowywanie niektórych aspektów każdego elementu podczas używania domyślnego wyglądu dla innych aspektów każdego elementu.

Rysunek właściciela w kontrolkach formularzy systemu Windows

Aby wykonać rysunek właściciela w kontrolkach, które go obsługują, zazwyczaj ustawisz jedną właściwość i obsłużysz co najmniej jedno zdarzenie.

Większość kontrolek obsługujących rysunek właściciela ma OwnerDraw właściwość lub DrawMode , która wskazuje, czy kontrolka zgłosi zdarzenie lub zdarzenia związane z rysunkiem podczas malowania.

Kontrolki, które nie mają OwnerDraw właściwości lub DrawMode , obejmują kontrolkę DataGridView , która zapewnia zdarzenia rysunku, które występują automatycznie, oraz kontrolkę ToolStrip , która jest rysowana przy użyciu klasy renderowania zewnętrznego, która ma własne zdarzenia związane z rysunkiem.

Istnieje wiele różnych rodzajów zdarzeń rysunku, ale typowe zdarzenie rysunku występuje w celu narysowania pojedynczego elementu w kontrolce. Procedura obsługi zdarzeń odbiera EventArgs obiekt zawierający informacje o rysowanym elemencie i narzędzia, których można użyć do narysowania. Na przykład ten obiekt zazwyczaj zawiera numer indeksu elementu w kolekcji nadrzędnej, który Rectangle wskazuje granice wyświetlania elementu i Graphics obiekt do wywoływania metod malowania. W przypadku niektórych zdarzeń obiekt zawiera dodatkowe informacje o elemencie i metodach, EventArgs które można wywołać w celu malowania niektórych aspektów elementu domyślnie, takich jak tło lub prostokąt fokusu.

Aby utworzyć kontrolkę wielokrotnego użytku zawierającą dostosowania rysowane przez właściciela, utwórz nową klasę pochodzącą z klasy kontrolnej obsługującej rysunek właściciela. Zamiast obsługiwać zdarzenia rysunku, dołącz kod rysunku właściciela do przesłonięć dla odpowiedniej Onmetody lub metod EventName w nowej klasie. Upewnij się, że w tym przypadku wywołasz metodę lub metody klasy Onbazowej EventName , aby użytkownicy kontrolki mogli obsługiwać zdarzenia rysunku właściciela i udostępniać dodatkowe dostosowania.

Następujące kontrolki Windows Forms obsługują rysunek właściciela we wszystkich wersjach programu .NET Framework:

ListBox
ComboBox
MenuItem (używane przez MainMenu i ContextMenu)
TabControl

Następujące kontrolki obsługują rysunek właściciela tylko w programie .NET Framework 2.0:

Następujące kontrolki obsługują rysunek właściciela i są nowe w programie .NET Framework 2.0:

Poniższe sekcje zawierają dodatkowe szczegóły dla każdej z tych kontrolek.

Kontrolki ListBox i ComboBox

Kontrolki ListBox i ComboBox umożliwiają rysowanie poszczególnych elementów w kontrolce w jednym rozmiarze lub w różnych rozmiarach.

Uwaga

Mimo że kontrolka CheckedListBox pochodzi z kontrolki, nie obsługuje rysunku ListBox właściciela.

Aby narysować każdy element o tym samym rozmiarze, ustaw DrawMode właściwość na OwnerDrawFixed i obsłuż DrawItem zdarzenie.

Aby narysować każdy element przy użyciu innego rozmiaru DrawMode , ustaw właściwość na OwnerDrawVariable i obsłuż zarówno zdarzenia, jak MeasureItem i DrawItem . Zdarzenie MeasureItem umożliwia wskazanie rozmiaru elementu przed DrawItem wystąpieniem zdarzenia dla tego elementu.

Aby uzyskać więcej informacji, w tym przykłady kodu, zobacz następujące tematy:

MenuItem, składnik

Składnik MenuItem reprezentuje pojedynczy element menu w elemencie MainMenu lub ContextMenu .

Aby narysować obiekt MenuItem, ustaw jej OwnerDraw właściwość na true wartość i obsłuż jej DrawItem zdarzenie. Aby dostosować rozmiar elementu menu przed DrawItem wystąpieniem zdarzenia, obsłuż zdarzenie elementu MeasureItem .