This article is currently in the process of being translated into Ukrainian (~21% done).


Introduction to WPF panels

Панелі - одні з найважливіших контролерів у WPF. Вони працюють як контейнери для інших контролерів і відповідають за план(розташування елементів) вікна або сторінки. У той час, коли вікно(йдеться про елемент Window) може мати лише ОДИН дочірній елемент, панель часто застосовується для розділу простору на частини, де кожна частина можу включати в себе контролер або іншу панель(яка, звичайно, також є контролером).

Є декілька різновидностей панелей, кожна з них має власний спосіб розташування елементів та дочірніх контролерів. Вибір правильної панелі, яка виконує основні функції для досягнення бажаної поведінки та розташування, є задачею, особливо напочатку WPF кар'єри, важкою. У наступній частині буде коротко описаний кожнен вид панелей і можливості їх застосування. Після цього, починаючи з наступної частини, у якій кожна панель буде описана більш детально.


A simple panel, which mimics the WinForms way of doing things. It allows you to assign specific coordinates to each of the child controls, giving you total control of the layout. This is not very flexible though, because you have to manually move the child controls around and make sure that they align the way you want them to. Use it (only) when you want complete control of the child control positions.


The WrapPanel will position each of its child controls next to the other, horizontally (default) or vertically, until there is no more room, where it will wrap to the next line and then continue. Use it when you want a vertical or horizontal list controls that automatically wraps when there's no more room.


The StackPanel acts much like the WrapPanel, but instead of wrapping if the child controls take up too much room, it simply expands itself, if possible. Just like with the WrapPanel, the orientation can be either horizontal or vertical, but instead of adjusting the width or height of the child controls based on the largest item, each item is stretched to take up the full width or height. Use the StackPanel when you want a list of controls that takes up all the available room, without wrapping.


The DockPanel allows you to dock the child controls to the top, bottom, left or right. By default, the last control, if not given a specific dock position, will fill the remaining space. You can achieve the same with the Grid panel, but for the simpler situations, the DockPanel will be easier to use. Use the DockPanel whenever you need to dock one or several controls to one of the sides, like for dividing up the window into specific areas.


The Grid is probably the most complex of the panel types. A Grid can contain multiple rows and columns. You define a height for each of the rows and a width for each of the columns, in either an absolute amount of pixels, in a percentage of the available space or as auto, where the row or column will automatically adjust its size depending on the content. Use the Grid when the other panels doesn't do the job, e.g. when you need multiple columns and often in combination with the other panels.


The UniformGrid is just like the Grid, with the possibility of multiple rows and columns, but with one important difference: All rows and columns will have the same size! Use this when you need the Grid behavior without the need to specify different sizes for the rows and columns.

This article has been fully translated into the following languages: Is your preferred language not on the list? Click here to help us translate this article into your language!