用于数据输入的基本WPF窗口功能

<wwl:CheckedWindow x:Class="Samples.SampleWindow"

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

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

        xmlns:wwl="clr-namespace:WpfWindowsLib;assembly=WpfWindowsLib">
  <StackPanel>
    <wwl:CheckedTextBox x:Name="TestCheckedTextBox" MinWidth="100" 

                        MaxLength="20" IsRequired="True"/>
    <Button x:Name="SaveButton" Content="_Save"/>
  </StackPanel>
</wwl:CheckedWindow>

CheckedTextBox从TextBox继承，添加ICheck功能（请参见下面的说明）和IsRequired属性。当设置为true时，用户必须在“保存”按钮可用之前提供一个值（即Text.Length>0）：

用于数据输入的基本WPF窗口功能

与XAML一样，在后面的代码中，窗口也必须继承自CheckedWindow：

using System.Windows;
using WpfWindowsLib;

namespace Samples {
  public partial class SampleWindow: CheckedWindow {
    public SampleWindow() {
      InitializeComponent();

      //write some code here to display data coming from a database, etc.
      TestCheckedTextBox.Text = database.Read(...);
      SaveButton.Click += saveButton_Click;
      updateSaveButtonIsEnabled();
    }

    private void saveButton_Click(object sender, RoutedEventArgs e) {
      //write some code here to save the data the user has entered
      database.Write(..., TestCheckedTextBox.Text);
      Close();
    }

    private void updateSaveButtonIsEnabled() {
      SaveButton.IsEnabled = HasICheckChanged && IsAvailable;
    }

    protected override void OnICheckChanged() {
      updateSaveButtonIsEnabled();
    }

    protected override void OnIsAvailableChanged() {
      updateSaveButtonIsEnabled();
    }
  }
}

只需要很少的代码就可以添加到该窗口：

保存按钮

窗口的外观没有要求。但是很可能会有一个“保存”按钮。当某些数据已更改（=HasICheckChanged）并且输入了所有必需的数据（=IsAvailable）时，启用此按钮。

调用updateSaveButtonIsEnabled()

HasICheckChanged和IsAvailable是CheckedWindow的属性。如果他们改变，CheckedWindow调用OnICheckChanged()或者OnIsAvailableChanged()，这需要重写更新保存按钮状态。

幕后发生了什么

所使用的控件需要提供ICHeck接口的功能。WpfWindowsLib将提供下列控件：

AutoCompleteBox
CheckBox
ComboBox
DatePicker
DecimalTextBox
EmailTextBox
IntegerTextBox
PhoneTextBox
TextBox

一个不仅限于这些控件，还可以从任何现有控件中继承并添加IChecker，以实现ICheck接口功能：

namespace WpfWindowsLib {

  public interface ICheck {

    /// <summary>
    /// Has the user changed the initial value of the control ?
    /// </summary>
    bool HasChanged { get; }

    /// <summary>
    /// Needs the user to change the initial value of the control ?
    /// </summary>
    bool IsRequired { get; }

    /// <summary>
    /// Has the user changed the initial value of the required control ?
    /// </summary>
    bool IsAvailable { get; }

    /// <summary>
    /// Raised when the user changes the initial value of the control 
    /// or when the user undoes any change and
    /// enters the initial value again.
    /// </summary>
    event Action  HasChangedEvent;

    /// <summary>
    /// Raised when the user changes the initial value of the required value control 
    /// or when the user undoes 
    /// any change and enters the initial value again.
    /// </summary>
    event Action  IsAvailableEvent;

    /// <summary>
    /// Tells the control to use the present value as initial value.
    /// </summary>
    void ResetHasChanged();

    /// <summary>
    /// Changes the background color of the control if its value is now 
    /// different than the initial value 
    /// and isChanged is true. If isChanged is false, the background color 
    /// gets displayed from when the
    /// control got initialised.
    /// </summary>
    /// <param name="isChanged"></param>
    void ShowChanged(bool isChanged);
  }
}

在初始化期间，ICheck控件搜索其所在窗口。如果该窗口继承自CheckedWindow，则向该窗口注册。在该注册期间，CheckedWindow订阅者订阅控件的HasChangedEvent和IsAvailableEvent事件。
当用户然后更改控件中的某些数据并导致HasChanged或IsAvailable更改时，控件将引发相应的事件，该事件将发出警报CheckedWindow。CheckedWindow查询所有已注册控件以评估其控件HasICheckChanged或IsAvailable属性是否需要更改，然后调用OnICheckChanged和OnIsAvailableChanged，从而为继承窗口提供了启用或禁用“保存”按钮的机会。
当用户尝试关闭窗口时，CheckedWindow检查是否有任何控件具有未保存的数据。如果是这样，它将标记这些控件，以便用户可以看到尚未保存的内容。CheckedWindow然后询问用户是否真的要关闭窗口并丢失输入的数据。

用于数据输入的基本WPF窗口功能

获取WpfWindowsLib

可从Github获得最新版本：https://github.com/PeterHuberSg/WpfWindowsLib。

将所有内容下载或克隆到您的PC，这为您提供了以下项目的WpfWindowsLib解决方案：

WpfWindowsLib：(.Dll)从其他解决方案中引用
Samples：WPF Core应用程序显示所有WpfWindowsLib控件
WpfWindowsLibTest：几乎没有WpfWindowsLib单元测试

上一篇： Mac下Sublime Text的Emmet无法补全React代码

下一篇： windows 下sublime text 3 配置python 环境详解