Manage focus

Manage focus

Available in Radical.Windows.Presentation from version 1.0.3.0*

In the Model View ViewModel world there are a lot of things that can be considered borderline, focus management is one of those things. On the other side managing focus in a desktop application based on WPF is other then a trivial task, focus in desktop application has many facets and lots of corner cases that must be taken into account, there is logical focus, keyboard focus and input scopes that determine the focus behavior.

In Radical we support a basic focus management where we completely ignore input scopes and we consider logical focus and keyboard focus to be always related to the same control at the same time.

The View

In order to manage focus on the view side we need to introduce on each control we want to participate the following behavior:

<TextBox Margin="10" Text="{markup:EditorBinding Path=SampleText}">
    <i:Interaction.Behaviors>
        <lb:Focus ControlledBy="{Binding Path=FocusedElementKey}" UsingKey="SampleText" />
    </i:Interaction.Behaviors>
</TextBox>

where the “lb” xml namespace is defined as follows:

xmlns:lb="clr-namespace:Topics.Radical.Windows.Presentation.Behaviors;assembly=Radical.Windows.Presentation"

the definition is currently in preview, when we definitely release the feature the xml namespace will follow the typical Radical conventions.

The Focus behavior defines which property of the ViewModel controls the focused element (ControlledBy) and which is the key (UsingKey) that uniquely identifies the control among all the others, in this case we are using, as key, exactly the same name name as the property the control is bound to: “SampleText”.

The ViewModel

On the ViewModel side, if we inherit from the base AbstractViewModel, we just need to decide which should be the “focused” key:

class MainViewModel : AbstractViewModel
{
    public void SetFocus() 
    {
        this.MoveFocusTo( () => this.SampleText );
    }

    public String SampleText
    {
        get { return this.GetPropertyValue( () => this.SampleText ); }
        set { this.SetPropertyValue( () => this.SampleText, value ); }
    }
}

At runtime each time we call MoveFocusTo, exposed by the base view model we inherit from, the focus is moved to the UI element identified by the given key.