Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен

}

Работа с окном Document Outline

В главе 24 вы узнали, что при проектировании элемента управления WPF со сложным содержимым удобно пользоваться окном Document Outline (Схема документа) в Visual Studio (открываемое через меню View►Other Windows (Вид►Другие окна)). Для создаваемого элемента Window отображается логическое дерево XAML, а щелчок на любом узле в дереве приводит к его автоматическому выбору в визуальном конструкторе и в редакторе XAML для редактирования.

В текущей версии Visual Studio окно Document Outline имеет несколько дополнительных средств, которые вы можете счесть полезными. Справа от любого узла находится значок, напоминающий глазное яблоко. Щелчок на нем позволяет скрывать или отображать элемент в визуальном конструкторе, что оказывается удобным, когда необходимо сосредоточить внимание на отдельном сегменте, подлежащем редактированию (следует отметить, что элемент будет сокрыт только на поверхности визуального конструктора, но не во время выполнения).

Справа от значка с глазным яблоком есть еще один значок, который позволяет блокировать элемент в визуальном конструкторе. Как и можно было догадаться, это удобно, когда нужно воспрепятствовать случайному изменению разметки XAML для заданного элемента вами или коллегами по разработке. На самом деле блокировка элемента делает его допускающим только чтение на этапе проектирования (но вы можете изменять состояние объекта во время выполнения).

Управление компоновкой содержимого с использованием панелей

Приложение WPF неизменно содержит определенное количество элементов пользовательского интерфейса (например, элементов ввода, графического содержимого, систем меню и строк состояния), которые должны быть хорошо организованы внутри разнообразных окон. После размещения элементов пользовательского интерфейса необходимо гарантировать их запланированное поведение, когда конечный пользователь изменяет размер окна или его части (как в случае окна с разделителем). Чтобы обеспечить сохранение элементами управления WPF своих позиций внутри окна, в котором они находятся, можно задействовать множество типов панелей (также известных как диспетчеры компоновки).

По умолчанию новый WPF-элемент Window, созданный с помощью Visual Studio, будет применять диспетчер компоновки типа Grid (вскоре мы опишем его более подробно). Тем не менее, пока что рассмотрим элемент Window без каких-либо объявленных диспетчеров компоновки:

<Window x:Class="MyWPFApp.MainWindow"

  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

  Title="Fun with Panels!" Height="285" Width="325">

</Window>

Когда элемент управления объявляется прямо внутри окна, в котором не используются панели, он позиционируется по центру контейнера. Рассмотрим показанное далее простое объявление окна, содержащего единственный элемент управления Button. Независимо от того, как изменяются размеры окна, этот виджет пользовательского интерфейса всегда будет находиться на равном удалении от всех четырех границ клиентской области. Размер элемента Button определяется установленными значениями его свойств Height и Width.

<! -- Эта кнопка всегда находится в центре окна -->

<Window x:Class="MyWPFApp.MainWindow"

  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

  Title="Fun with Panels!" Height="285" Width="325">

  <Button x:Name="btnOK" Height = "100" Width="80" Content="OK"/>

</Window>

Также вспомните, что попытка помещения внутрь области Window сразу нескольких элементов вызовет ошибки разметки и компиляции. Причина в том, что свойству Content окна (или по существу любого потомка ContentControl) может быть присвоен только один объект. Следовательно, приведенная далее разметка XAML приведет к ошибкам разметки и компиляции:

<!-- Ошибка! Свойство Content неявно устанавливается более одного раза! -->

<Window x:Class="MyWPFApp.MainWindow"

  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

  Title="Fun with Panels!" Height="285" Width="325">

  <!-- Ошибка! Два непосредственных дочерних элемента в <Window>! -->

   <Label x:Name="lblInstructions" Width="328" Height="27"

       FontSize="15" Content="Enter Information"/>

  <Button x:Name="btnOK" Height = "100" Width="80" Content="OK"/>

</Window>

Понятно, что от окна, допускающего наличие только одного элемента управления, мало толку. Когда окно должно содержать несколько элементов, их потребуется расположить внутри любого числа панелей. В панель будут помещены все элементы пользовательского интерфейса, которые представляют окно, после чего сама панель выступает в качестве единственного объекта, присваиваемого свойству Content окна. Пространство имен System.Windows.Controls предлагает многочисленные панели, каждая из которых по-своему обслуживает внутренние элементы. С помощью панелей можно устанавливать поведение элементов управления при изменении размеров окна пользователем — будут они оставаться в тех же местах, где были размещены на этапе проектирования, располагаться свободным потоком слева направо или сверху вниз и т.д.

Элементы управления типа панелей также разрешено помещать внутрь других панелей (например, элемент управления DockPanel может содержать StackPanel со своими элементами), чтобы обеспечить высокую гибкость и степень управления. В табл. 25.2 кратко описаны некоторые распространенные элементы управления типа панелей WPF.

В последующих нескольких разделах вы узнаете, как применять распространенные типы панелей, копируя заранее определенную разметку XAML в редактор Kaxaml, который был установлен в главе 24. Все необходимые файлы XAML находятся в подкаталоге PanelMarkup внутри Chapter_25. Во время работы с Kaxaml для эмуляции изменения размеров окна нужно изменить высоту или ширину элемента Page в разметке.

Позиционирование содержимого внутри панелей Canvas

При наличии опыта работы с Windows Forms панель Canvas вероятно покажется наиболее привычной, т.к. она делает возможным абсолютное позиционирование содержимого пользовательского интерфейса. Если конечный пользователь изменяет размер окна, делая его меньше, чем размер компоновки, обслуживаемой панелью Canvas, то внутреннее содержимое будет невидимым до тех пор, пока контейнер не увеличится до размера, равного или превышающего размер области Canvas.

Чтобы добавить содержимое к Canvas, сначала понадобится определить требуемые элементы управления внутри области между открывающим и закрывающим дескрипторами Canvas. Затем для каждого элемента управления необходимо указать левый верхний угол с использованием свойств Canvas.Тор и Canvas.Left; именно здесь должна начинаться визуализация. Правый нижний угол каждого элемента управления можно задать неявно, устанавливая свойства Canvas.Height и Canvas.Width, либо явно с применением свойств Canvas.Right и Canvas.Bottom.

Для демонстрации Canvas в действии откройте готовый файл SimpleCanvas.xaml в редакторе Kaxaml. Определение Canvas должно иметь следующий вид (в случае загрузки примеров в приложение WPF дескриптор Page нужно будет заменить дескриптором Window):

<Page

  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

  Title="Fun with Panels!" Height="285" Width="325">

  <Canvas Background="LightSteelBlue">

    <Button x:Name="btnOK" Canvas.Left="212" Canvas.Top="203"

        Width="80" Content="OK"/>

    <Label x:Name="lblInstructions" Canvas.Left="17" Canvas.Top="14"

        Width="328" Height="27" FontSize="15" Content="Enter Car