Spread Windows Forms 17
Spread Windows Forms 17.0 Product Documentation / Developer's Guide / Keyboard Interaction / Changing the Default Keyboard Map
In This Topic
    Changing the Default Keyboard Map
    In This Topic

    The default input map defines the behavior of the component for end user interaction with the keyboard. For example, by default, when the end user presses the Enter key in an active cell, the edit mode turns on for that cell. You can change this default behavior, by changing the default input map.

    Using Code

    1. Create an InputMap object.
    2. Use the GetInputMap method.

    Example

    This example changes the behavior so that pressing the Enter key moves the active cell to the next row.

    C#
    Copy Code
    private void Form1_Load(object sender, System.EventArgs e)
    {
       FarPoint.Win.Spread.InputMap im = new FarPoint.Win.Spread.InputMap();
       
       // Define the operation of pressing Enter key in cells not being edited as "Move to the next row".
       im = fpSpread1.GetInputMap(FarPoint.Win.Spread.InputMapMode.WhenFocused);
       im.Put(new FarPoint.Win.Spread.Keystroke(Keys.Enter, Keys.None), FarPoint.Win.Spread.SpreadActions.MoveToNextRow);
       
       // Define the operation of pressing Enter key in cells being edited as "Move to the next row".
       im = fpSpread1.GetInputMap(FarPoint.Win.Spread.InputMapMode.WhenAncestorOfFocused);
       im.Put(new FarPoint.Win.Spread.Keystroke(Keys.Enter, Keys.None), FarPoint.Win.Spread.SpreadActions.MoveToNextRow);
    }
    
    VB
    Copy Code
    Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load
       Dim im As New FarPoint.Win.Spread.InputMap
       
       ' Define the operation of pressing Enter key in cells not being edited as "Move to the next row".
       im = fpSpread1.GetInputMap(FarPoint.Win.Spread.InputMapMode.WhenFocused)
       im.Put(New FarPoint.Win.Spread.Keystroke(Keys.Enter, Keys.None), FarPoint.Win.Spread.SpreadActions.MoveToNextRow)
       
       ' Define the operation of pressing Enter key in cells being edited as "Move to the next row".
    im = fpSpread1.GetInputMap(FarPoint.Win.Spread.InputMapMode.WhenAncestorOfFocused)
    im.Put(New FarPoint.Win.Spread.Keystroke(Keys.Enter, Keys.None), FarPoint.Win.Spread.SpreadActions.MoveToNextRow)
    End Sub
    

    Example

    This example deactivates the F2 key.

    C#
    Copy Code
    private void Form1_Load(object sender, System.EventArgs e)
    {
       FarPoint.Win.Spread.InputMap im = new FarPoint.Win.Spread.InputMap();
       
       // Deactivate F2 key in cells not being edited.
       im = fpSpread1.GetInputMap(FarPoint.Win.Spread.InputMapMode.WhenFocused);
       im.Put(new FarPoint.Win.Spread.Keystroke(Keys.F2, Keys.None), FarPoint.Win.Spread.SpreadActions.None);
       
       // Deactivate F2 key in cells being edited.
       im = fpSpread1.GetInputMap(FarPoint.Win.Spread.InputMapMode.WhenAncestorOfFocused);
    im.Put(new FarPoint.Win.Spread.Keystroke(Keys.F2, Keys.None), FarPoint.Win.Spread.SpreadActions.None);
    }
    
    VB
    Copy Code
    Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load
       Dim im As New FarPoint.Win.Spread.InputMap
       ' Deactivate F2 key in cells not being edited.
       im = fpSpread1.GetInputMap(FarPoint.Win.Spread.InputMapMode.WhenFocused)
       im.Put(New FarPoint.Win.Spread.Keystroke(Keys.F2, Keys.None), FarPoint.Win.Spread.SpreadActions.None)
       ' Deactivate F2 key in cells being edited.
       im = fpSpread1.GetInputMap(FarPoint.Win.Spread.InputMapMode.WhenAncestorOfFocused)
       im.Put(New FarPoint.Win.Spread.Keystroke(Keys.F2, Keys.None), FarPoint.Win.Spread.SpreadActions.None)
    End Sub
    
    See Also