Интеграция контекстно-зависимой справки в приложение WPF после MVVM

Question

Я пытаюсь реализовать функцию справки для моего приложения wpf, которое следует шаблону MVVM. У меня есть файл справки, который содержит много страниц в зависимости от приложения. Теперь мне нужно интегрировать это в свое приложение.

Вот мои требования:

1. Нажатие F1 открывает определенную страницу в файле справки в зависимости от модели представления. Для этого, мне кажется, мне нужно привязать команду F1 к моей модели вида. Как мы связываем ключи в представлениях?
2. Нажатие F1 в текстовом поле открывает справку для этого текстового поля. Я думаю, что это будет то же самое, что и требование 1. Но проблема здесь в том, как я узнаю, что выбрано определенное текстовое поле, кнопка или переключатель?

Answer 1

1. Прослушайте ключ в представлении (или базовый класс представления) и вызовите execute для HelpCommand в DataContext.

2. Передайте элемент управления, имеющий фокус (или его идентификатор, или тег,...) в качестве аргумента в HelpCommand.

Альтернативный способ найти сфокусированный элемент управления с помощью FocusManager

Вот пример:

ContextHelp C#:

public static class ContextHelp
{
    public static readonly DependencyProperty KeywordProperty =
        DependencyProperty.RegisterAttached(
            "Keyword",
            typeof(string),
            typeof(ContextHelp));

    public static void SetKeyword(UIElement target, string value)
    {
        target.SetValue(KeywordProperty, value);
    }

    public static string GetKeyword(UIElement target)
    {
        return (string)target.GetValue(KeywordProperty);
    }
}

ViewBase:

public abstract class ViewBase : UserControl
{
    public ViewBase()
    {
        this.KeyUp += ViewBase_KeyUp;
        this.GotFocus += ViewBase_GotFocus;
    }

    void ViewBase_GotFocus(object sender, RoutedEventArgs e)
    {
        FocusManager.SetIsFocusScope(this, true);
    }

    void ViewBase_KeyUp(object sender, System.Windows.Input.KeyEventArgs e)
    {
        if (e.Key == Key.F1)
        {
            var viewModel = this.DataContext as ViewModelBase;
            if (viewModel != null)
            {
                var helpTopic = "Index";
                var focusedElement = 
                    FocusManager.GetFocusedElement(this) as FrameworkElement;
                if (focusedElement != null)
                {
                    var keyword = ContextHelp.GetKeyword(focusedElement);
                    if (!String.IsNullOrWhiteSpace(keyword))
                    {
                        helpTopic = keyword;
                    }
                }
                viewModel.HelpCommand.Execute(helpTopic);
            }
        }
    }
}

ViewModelBase:

public abstract class ViewModelBase: INotifyPropertyChanged
{
    public ICommand HelpCommand { get; set; }

    public event PropertyChangedEventHandler PropertyChanged;

    protected void OnPropertyChanged([CallerMemberName] string propertyName="")
    {
        var p = PropertyChanged;
        if (p != null)
        {
            p(this, new PropertyChangedEventArgs(propertyName));
        }
    }
}

AViewModel:

class AViewModel : ViewModelBase
{
    public AViewModel()
    {
        HelpCommand = new RelayCommand(HelpCommandExecuted, (p)=>true);
    }

    private void HelpCommandExecuted(object parameter)
    {
        var topic = parameter as string;
        if (!String.IsNullOrWhiteSpace(topic))
        {
            HelpText = String.Format("Information on the interesting topic: {0}.", topic);
        }
    }

    private string _helpText;

    public string HelpText
    {
        get { return _helpText; }
        private set
        {
            if (_helpText != value)
            {
                _helpText = value;
                OnPropertyChanged();
            }
        }
    }
}

AView C#:

public partial class AView : ViewBase
{
    public AView()
    {
        InitializeComponent();
    }
}

AView XAML:

<local:ViewBase x:Class="WpfApplication2.AView"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
             xmlns:local="clr-namespace:WpfApplication2"
             mc:Ignorable="d" 
             d:DesignHeight="300" d:DesignWidth="300">
    <Grid>
        <Label Content="{Binding HelpText}" Margin="10,254,10,0" VerticalAlignment="Top" Height="36"/>
        <Button local:ContextHelp.Keyword="Button Info" Content="Button" HorizontalAlignment="Left" Margin="192,32,0,0" VerticalAlignment="Top" Width="75"/>
        <TextBox local:ContextHelp.Keyword="TextBox Info" HorizontalAlignment="Left" Height="23" Margin="29,32,0,0" TextWrapping="Wrap" Text="TextBox" VerticalAlignment="Top" Width="120"/>
        <CheckBox local:ContextHelp.Keyword="CheckBox Info" Content="CheckBox" HorizontalAlignment="Left" Margin="29,80,0,0" VerticalAlignment="Top"/>
        <ComboBox local:ContextHelp.Keyword="ComboBox Info" HorizontalAlignment="Left" Margin="138,80,0,0" VerticalAlignment="Top" Width="120"/>
    </Grid>
</local:ViewBase>

MainWindow XAML:

<Window
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:WpfApplication2" x:Class="WpfApplication2.MainWindow"
        Title="MainWindow" Height="700" Width="500">
    <Grid x:Name="ViewPlaceholder">
    </Grid>
</Window>

MainWindow C#:

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();

        var view = new AView();
        var viewModel = new AViewModel();
        view.DataContext = viewModel;
        ViewPlaceholder.Children.Clear();
        ViewPlaceholder.Children.Add(view);
    }
}