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

  <Grid.ColumnDefinitions>

    <ColumnDefinition />

    <ColumnDefinition />

  </Grid.ColumnDefinitions>

   <GridSplitter Grid.Column ="0" Width ="5" Background ="Gray" />

  <StackPanel Grid.Column="0" VerticalAlignment ="Stretch" >

    <Label Name="lblSpellingInstructions" FontSize="14" Margin="10,10,0,0">

     Spelling Hints

    </Label>

    <Expander Name="expanderSpelling" Header ="Try these!"

              Margin="10,10,10,10">

      <!-- Будет заполняться программно -->

      <Label Name ="lblSpellingHints" FontSize ="12"/>

    </Expander>

  </StackPanel>

  <!-- Это будет областью для ввода -->

  <TextBox  Grid.Column ="1"

            SpellCheck.IsEnabled ="True"

            AcceptsReturn ="True"

            Name ="txtData" FontSize ="14"

            BorderBrush ="Blue"

            VerticalScrollBarVisibility="Auto"

            HorizontalScrollBarVisibility="Auto">

  </TextBox>

</Grid>

Реализация обработчиков событий MouseEnter/MouseLeave

К настоящему моменту пользовательский интерфейс окна готов. Понадобится лишь предоставить реализации оставшихся обработчиков событий. Начните с обновления файла кода C# так, чтобы каждый из обработчиков событий MouseEnter и MouseLeave устанавливал в текстовой панели строки состояния подходящее сообщение, которое окажет помощь конечному пользователю:

public partial class MainWindow : System.Windows.Window

{

  ...

  protected void MouseEnterExitArea(object sender, RoutedEventArgs args)

  {

    statBarText.Text = "Exit the Application";

  }

  protected void MouseEnterToolsHintsArea(object sender, RoutedEventArgs args)

  {

    statBarText.Text = "Show Spelling Suggestions";

  }

  protected void MouseLeaveArea(object sender, RoutedEventArgs args)

  {

    statBarText.Text = "Ready";

  }

}

Теперь приложение можно запустить. Текст в строке состояния должен изменяться в зависимости от того, над каким пунктом меню или кнопкой панели инструментов находится курсор.

Реализация логики проверки правописания

Инфраструктура WPF имеет встроенную поддержку проверки правописания, независимую от продуктов Microsoft Office. Это значит, что использовать уровень взаимодействия с СОМ для обращения к функции проверки правописания Microsoft Word не понадобится: та же самая функциональность добавляется с помощью всего нескольких строк кода.

Вспомните, что при определении элемента управления TextBox свойство Spellcheck.IsEnabled устанавливается в true. В результате неправильно написанные слова подчеркиваются красной волнистой линией, как происходит в Microsoft Office. Более того, лежащая в основе программная модель предоставляет доступ к механизму проверки правописания, который позволяет получить список предполагаемых вариантов для слов, написанных с ошибкой.

Добавьте в метод ToolsSpellingHints_Click() следующий код:

protected void ToolsSpellingHints_Click(object sender, RoutedEventArgs args)

{

  string spellingHints = string.Empty;

  // Попробовать получить ошибку правописания

  // в текущем положении курсора ввода.

  SpellingError error = txtData.GetSpellingError(txtData.CaretIndex);

  if (error != null)

  {

    // Построить строку с предполагаемыми вариантами правописания.

    foreach (string s in error.Suggestions)

    {

      spellingHints += $"{s}n";

    }

    // Отобразить предполагаемые варианты и раскрыть элемент Expander.

    lblSpellingHints.Content = spellingHints;

    expanderSpelling.IsExpanded = true;

  }

}

Приведенный выше код довольно прост. С применением свойства CaretIndex извлекается объект SpellingError и вычисляется текущее положение курсора ввода в текстовом поле. Если в указанном месте присутствует ошибка (т.е. значение error не равно null), тогда осуществляется проход в цикле по списку предполагаемых вариантов с использованием свойства Suggestions. После того, как все предполагаемые варианты для неправильно написанного слова получены, они помещаются в элемент Label внутри элемента Expander.

Вот и все! С помощью нескольких строк процедурного кода (и приличной порции разметки XAML) заложены основы для функционирования текстового процессора. После изучения управляющих команд будут добавлены дополнительные возможности.

Понятие команд WPF

Инфраструктура WPF предлагает поддержку того, что может считаться независимыми от элементов управления событиями, через архитектуру команд. Обычное событие .NET Core определяется внутри некоторого базового класса и может использоваться только этим классом или его потомками. Следовательно, нормальные события .NET Core тесно привязаны к классу, в котором они определены.

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

В то время как другие инструментальные наборы, ориентированные на построение пользовательских интерфейсов (вроде Windows Forms), предлагают для таких целей стандартные события, их применение обычно дает в результате избыточный и трудный в сопровождении код. Внутри модели WPF в качестве альтернативы можно использовать команды. Итогом обычно оказывается более компактная и гибкая кодовая база.

Внутренние объекты команд

Инфраструктура WPF поставляется с множеством встроенных команд, каждую из которых можно ассоциировать с соответствующей клавиатурной комбинацией (или другим входным жестом). С точки зрения программирования команда WPF — это любой объект, поддерживающий свойство (часто называемое Command), которое возвращает объект, реализующий показанный ниже интерфейс ICommand:

public interface ICommand

{

  // Возникает, когда происходят изменения, влияющие

  // на то, должна выполняться команда или нет.

  event EventHandler CanExecuteChanged;

  // Определяет метод, который выясняет, может ли

  // команда выполняться в ее текущем состоянии.

  bool CanExecute(object parameter);

  // Определяет метод для вызова при обращении к команде.

  void Execute(object parameter);

}

В WPF предлагаются разнообразные классы команд, которые открывают доступ к примерно сотне готовых объектов команд. В таких классах определены многочисленные свойства, представляющие специфические объекты команд, каждый из которых реализует интерфейс ICommand. В табл. 25.3 кратко описаны избранные стандартные объекты команд.

Подключение команд к свойству Command

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

<Menu