📚
Siticone Docs
HomePricing PlansSuggest a FeatureMy LicenseChangelogDownloads
  • Dear Developer!
  • Quick Start Guide
    • Install Siticone UI Library
    • Register for 1 month free trial
    • Register for Premium License
  • Net Framework | Net Core UI
    • Input Controls
      • Siticone TextBox
        • Appearance and Styling
        • Text and Placeholder Config.
        • Input, Validation and Read-Only Behavior
        • User Interaction & Shortcuts
        • System Theme Integration
        • Events and Callbacks
      • Siticone TextArea
        • Always Multiline
        • Custom Font
        • Vertical Scrollbars
        • Border-less Design
        • Dynamic Resizing
        • Margin Spacing
      • Siticone CheckBox
        • Visual Style
        • State Management
        • Interaction Effects
        • Container Layout
        • Container Style
        • Container States
        • State Colors
        • Border Configuration
        • Layout
        • Focus Appearance
        • Text Property
        • Trigger Feedback
      • Siticone RadialButton
        • Appearance
        • Behavior
        • Layout Management
        • User Assistance
        • Animation Timing
        • Events and Callbacks
      • Siticone ToggleButton
        • Toggle Functionality
        • Appearance and Text
        • Border Settings
        • Corner Radius
        • Animation Settings
        • Ripple & Interaction Effects
        • Read-only and Feedback
        • Sizing and Layout
        • Context Menu Integration
        • State Persistence
        • Accessibility
        • Events and Callback
      • Siticone ToggleSwitch
        • Core Toggle Functionality
        • Appearance and Theming
        • Logging and Diagnostics
        • Interactive Effects
        • Labels and Icons
        • Audio Feedback
        • Thumb Customization
        • Animation Settings
        • Context Menu Integration
        • Tool-tip Capabilities
        • Events and Callbacks
      • Siticone UpDown
        • Behavior and Data Config
        • Appearance Customization
        • Feedback and Animation
        • Events and Callbacks
      • Siticone PhoneNumberBox
        • Page 1
        • Phone Number Config
        • Country Flag Display
        • Shadow Effects
        • Input Validation
        • Border and Background
        • Placeholder and Animation
        • Text & Cursor Customization
        • Font and Text Style
        • Corner and Fill Config
        • System Theme (Preview)
        • Public Methods & Text
        • Events and Callbacks
      • Siticone Otp
        • Security & Input Protection
        • Interactive Feedback
        • Input Validation
        • Box Appearance & Layout
        • Data Extraction & Display
        • State Analysis
        • Events and Callbacks
        • Additional Public Methods
    • Buttons and Elements
      • Siticone Button
        • Animation Effects
        • Theme & System Integration
        • User Assist & Interaction
        • Layout & Content
        • Visual Effects & Styling
        • Badge Configuration
        • Manage State & Behavior
        • Performance and Rendering
        • Events for Control Updates
      • Siticone TileButton
        • Animation Effects
        • Color Settings
        • Visual Style
        • Icon Settings
        • Advanced Styling
        • Badge Display
        • Loading Indicator
        • State Management
        • Tool-tip Settings
        • Accessibility
        • Corner Radius
      • Siticone ImageButton
        • Content Presentation
        • Interaction and Behavior
        • Feedback and Animations
        • Visual Style and Layout
        • Badge Features
        • Theme Integration
        • Events and Callbacks
      • Siticone MenuButton
        • Appearance and Visual Style
        • Icon Customization
        • Animation Features
        • Behavior and Interaction
        • Events and Callbacks
      • Siticone CloseButton
        • Appearance Customization
        • Animation and Visual Effects
        • Behavioral Settings
        • Accessibility Features
        • Tool-tip Configuration
        • Countdown Display Config
        • Events and Callbacks
      • Siticone CopyButton
        • Appearance & Visual Effects
        • Corner and Shape Config
        • Behavior & Target Copy
        • Notification Customization
        • Context Menu Customization
        • Accessibility Features
        • Events and Callbacks
      • Siticone DashboardButton
        • Visual Effects
        • Visual Appearance
        • Notification Badge
        • Selection Indicator
        • Layout and Text
        • State Management & Colors
        • Animation Settings
        • Shape Customization
        • Accessibility
        • User Interaction Events
      • Siticone NavBackButton
        • Behavior and Feedback
        • Visual Appearance
        • Dimensions & Icon Styling
        • Animation Effects
        • Visual Style Enhancements
        • Events and Callbacks
      • Siticone NavForwardBtn
        • Behavior & Read-Only Config
        • Icon Customization
        • Colors & Visual Feedback
        • Button Dimensions & Shape
        • Animation Features
        • Visual Style and Effects
        • Events for Animation
        • Control Overrides
        • Events and Callbacks
      • Siticone NotificationBtn
        • Tool-tip Features
        • Layout & Size Customization
        • Bell Appearance & Behavior
        • Badge (Count) Features
        • Interaction and Gesture
        • Visual Effects and Animation
        • Visual Style and Shadow
        • Additional Behavior Settings
        • Events for Feedback
        • Events and Callbacks
      • Siticone PlayPauseBtn
        • Progress Indicator
        • Animation Effects
        • Visual Style
        • Shape Customization
        • Shape Customization
        • Icon Customization
        • Behavior
        • Events and Callbacks
    • Container and Layout
      • Siticone Panel
        • Border Customization
        • Corner Curvature
        • Background Appearance
        • Gradient Effects
        • Interactive Ripple Effects
        • Backdrop Effects
        • Event Notifications
      • Siticone AdvancedPanel
        • Essential Styling
        • Motion and Animation
        • Color and Gradient
        • Depth and Shadow
        • Border Enhancements
        • Interactive States
        • Background Effects
        • Content Management
        • Events and Callback
      • Siticone FlatPanel
        • Appearance and Styling
        • Performance & Rendering
        • Design-Time Integration
      • Siticone FlowPanel
        • Appearance & Visual Effects
        • Layout Customization
        • Performance Optimization
        • Interaction and Behavior
        • Theme & DPI Integration
        • Events and Callbacks
      • Siticone Container
        • Color and Gradients
        • Border Design and Styling
        • Corner and Shape Config
        • Shadow & Elevation Effects
        • Interactive and Animations
        • Badge Configuration
        • Content Management
        • Context Menu Integration
        • Dragging and Interaction
        • Security and Feedback
        • Events and Callbacks
      • Siticone SplitContainer
        • Event Handling
        • Splitter Movement & Behavior
        • Animation & Smooth Drag
        • Appearance and Styling
        • State Management
        • Accessibility & Keyboard Navigation
        • Context Menu Integration
        • System Theme Integration
        • Drag and Drop Panel Reordering
      • Siticone GroupBox
        • Theming and Aesthetics
        • Border & Edge Effects
        • Text & Title Styling
        • Layout Configuration
        • Chevron Styling
        • Badge Config & Animation
        • Collapsible Features
        • Interaction Behavior & Events
        • Status Elements
      • Siticone NativeGroupBox
        • Border Customization
        • Appearance & Layout
      • Siticone DragPanel
        • Layout Customization
        • Appearance Customization
        • Rendering Quality
        • Interactive Behavior
      • Siticone Card
        • Color and Gradients
        • Border Config & Styling
        • Corner and Shape Config
        • Shadow and Elevation
        • Interactive Effects and Animations
        • Hover Effects
        • Visual Effects
        • Badge Configuration
        • Security and Feedback Settings
        • Dynamic Content & Context Menu
        • Drag-and-Drop Interaction
        • Front-Facing Events
      • Siticone TabControl
        • General Layout and Sizing
        • Appearance and Color Customization
        • Close Button Customization
        • Pin Functionality
        • Tab Management and Navigation
        • Animation and Visual Effects
        • Context Menu Customization
        • Events and Callbacks
      • Siticone Workbook (Preview)
    • Progress and Loading
      • Siticone HProgressBar
        • Rounded Corners & Shape Customization
        • Progress Value & Range Management
        • Orientation & Layout
        • Animation & Indeterminate Mode
        • Progress State Colors & Thresholds
        • Gradient & Bar Styling
        • Label & Tooltip Customization
        • Read‑Only Mode
        • Ripple Effects
        • User Experience Enhancements
        • System Theme Tracking
        • Events and Callbacks
      • Siticone VProgressBar
        • Appearance & Styling
        • Behavior, Animation & Interaction
        • System Integration & Events
      • Siticone HBarsProgress
        • Animation Control
        • Progress Value Management
        • Appearance and Styling
        • Display and Interaction
        • Events and Callbacks
      • Siticone VBarsProgress
        • Animation Features
        • Progress and Range Settings
        • Line Configuration
        • Color and Appearance
        • Display Options
        • User Interaction
        • Events and Callbacks
      • Siticone HLineProgress
        • Range Settings
        • Animation Settings
        • Color and Gradient Design
        • Visual Effects
        • Pulse Animation Settings
        • Corner Radius Customization
        • Page
      • Siticone VLineProgress
        • Range Settings
        • Animation Settings
        • Color and Gradient Customization
        • Background and Highlight Effects
        • Pulse Animation Settings
        • Corner Radius Settings
      • Siticone CircularSpinner
        • Visual Customization
        • Geometry and Layout
        • Motion and Animation
        • Progress Indication
        • Events
      • Siticone LoadingSpinner
        • General Control Methods & Events
        • Animation Settings
        • Appearance & Visual Customization
        • Progress Display Customization
        • Size & Radius Customization
        • Ring & Spoke Customization
        • Special Effects
        • Events and Callbacks
      • Siticone RadialProgress
        • Core Configuration
        • Visual Styling
        • Interaction and Control
        • Animation and Motion
        • Advanced Effects & Readonly State
        • Color Customization
        • Indeterminate Mode
        • Events
      • Siticone SmoothCSpinner
        • Appearance Customization
        • Animation Control
        • Arc Dimension Settings
      • Siticone SmoothLProgress
        • Dual-Bar Behavior
        • Visual Appearance
        • Motion Dynamics
        • Animation Control
    • Sliders and Range
      • Siticone HSlider
        • Appearance and Layout
        • Read-Only Customization
        • Visual Effects & Animations
        • Interaction & Behavior
        • Data Binding & State Management
        • Events & Accessibility
        • Built-In Context Menu Operations
      • Siticone VSlider
        • Data & Value Management
        • Appearance Customization
        • Read-Only Mode Appearance
        • Visual Effects & Animations
        • Interaction & Feedback Settings
        • Events & Event Handling
        • State Management
        • Accessibility & Data Binding Support
      • Siticone HTrackBar
        • Data & Value Management
        • Appearance Customization
        • Animation & Interaction Effects
        • Behavior & Interaction
        • Accessibility & Data Binding
        • Events
      • Siticone VTrackBar
        • Value and Range Configuration
        • Appearance Customization
        • Animation and Interaction Customization
        • Feedback Mechanisms
        • Context Menu and Tooltip Features
        • Accessibility and Keyboard Support
        • State Management and Data Binding
        • Events
      • Siticone HRangeSlider
        • Behavior & Value Management
        • Appearance Customization
        • User Interaction
        • Events
      • Siticone HRangeTrackBar
        • Behavior Settings
        • Appearance Settings
        • Event Handling
        • Built-In Context Menu Functionality
        • Keyboard and Mouse Interaction
    • Data Display and Grid
      • Siticone DataGrid
        • Data Management & Binding
        • Theming and Appearance Customization
        • Behavior & Interaction
        • Built-In Data Import/Export and Encryption
        • Search and Filtering Capabilities
        • Text Formatting and Cell Styling (Ribbon Toolbar)
        • User Interaction Enhancements
        • Events and Callbacks
      • Siticone Label
        • Text and Content
        • Transparent Background
        • Layout & Rendering Enhancements
        • Standard Layout Properties (Inherited)
      • Siticone LinkedLabel
        • Text and Link Behavior
        • Color Properties
        • Font and Appearance
        • Events
      • Siticone ShimmerLabel
        • Shimmer Appearance
        • Shimmer Behavior
        • Shimmer Text
    • Form Design Framework
      • Siticone Form
        • Window Behavior & Layout
        • Title Bar Customization
        • Control Box (Window Buttons) Customization
        • Theme and Appearance
        • Animation & Visual Effects
        • Events and Public Methods
      • Siticone EmptyForm
        • Visual Appearance & Styling
        • Rendering and Performance Enhancements
      • Siticone DragForm
        • Drag Functionality
        • Accessibility and Keyboard Navigation
        • Performance Optimizations
        • Appearance Customization
    • Gauges and Measurement
      • Siticone GaugeClock
        • Value Hand Customization
        • Core Appearance & Theme
        • Typography & Labeling
        • Gauge Configuration & Value Range
        • 3D Effects and Metallic Appearance
        • Visual Effects and Enhancements
        • Gradient Customization
        • Display & Format Options
        • Scale and Tick Mark Configuration
        • Animation & Interaction
        • Export/Import and Context Menu Options
        • Section Management
        • Events and Callbacks
      • Siticone GaugeDigital
        • Gauge Core Settings
        • LED Display Settings
        • Visual Style and Themes
        • 3D Effects
        • Lighting Effects
        • Typography and Scale
        • Custom Gradients and Texture
        • Animation and Interactivity
        • Context Menu Operations
        • Events
      • Siticone GaugeNumeric
        • Gauge Display & Value
        • Scale and Markers
        • Typography & Text
        • Color Customization
        • 3D and Special Effects
        • Interaction & Tool-tip
        • Additional Features & Events
      • Siticone GaugeZone
        • ZonePasswordForm (Password Dialog Control)
        • Control Features
    • Chip and Group Controls
      • Siticone Chip
        • Appearance & Color Scheme
        • Corner and Shape Customization
        • Visual Effects
        • Interaction & Behavior
        • Close Button Customization
        • Selection Indicator Customization
        • Visual Content
        • Events
      • Siticone GroupChip
        • Group Management
        • Visual Effects
        • State Colors
        • Close Button Styling & Layout
        • Selection Indicator
        • Visual Elements
        • Color Scheme
        • Border Customization
        • Corner Customization
        • Interactive Features
        • Animation Settings
        • Behavior
        • Events
      • Siticone GroupChipPanel
        • Drag-and-Drop Customization
        • Chip Selection Customization
        • Chip Management API
        • Chip Events
      • Siticone GroupButton
        • Material Design Effects
        • Surface Styling
        • Screen Reader Support
        • Alert System (Badge Features)
        • Selection and Interactive States
        • Selection Markers and Indicator Customization
        • Content Layout
        • Animation and Motion
        • Corner and Shape Customization
        • Events and Callbacks
    • Media and Graphics
      • Siticone Audio
        • Basic Behavior and State
        • Appearance Customization
        • Sound Wave Animation and Style
        • Visual Effects and Animations
        • Events and Callbacks
      • Siticone PictureBox
        • Image Loading and Display
        • Layout and Sizing
        • Shape and Border Config
        • Image Quality and Effects
        • Image Transformations
        • Slideshow Functionality
        • Interaction & Behavior
        • Performance & Display
      • Signature Pad
        • Context Menu Customization
        • Template Customization
        • Animation Features
        • Stroke Aesthetics and Dynamics
        • Input Processing and Guides
        • Visual Guides
        • Rendering Quality
        • Performance
        • User Experience
        • Public Methods for Signature Handling
        • Public Events for Integration
        • Events
    • Separator Controls
      • Siticone HSeparator
        • Segment Configuration
        • Line Multiplication
        • Visual Styling
      • Siticone VSeparator
        • Segment Configuration
        • Line Multiplication
        • Visual Styling
        • Enumerations
    • Utility Controls
      • Siticone BackgroundWkr
        • Worker Initialization and Configuration
        • Custom Progress Reporting Functionality
      • Siticone SystemInfo
        • System and Service Information
        • Security and User Information
        • Performance and Memory Metrics
        • System Hardware and Operating System Details
        • Peripherals and Additional Devices
        • Hardware (Detailed)
        • Display Details
        • Network Information
        • Configuration Options
        • Methods for Data Retrieval and Export
        • Events and Callbacks
      • Siticone TaskbarBadgeS.
        • Badge Display & Formatting
        • Animation Effects
        • Notification Effects
        • Flash / Highlight Effects
        • System Theme Integration
        • Parent Form Integration
        • Events and Callbacks
      • Siticone ThemeSwitcher
        • Layout and Spacing
        • Visual Effects and Animation
        • Icon Customization
        • Border and Corner Configuration
        • Color Scheme
        • Behavior and State
        • Accessibility
      • Siticone ThemeTracker
        • Theme and Accent Information
        • Theme Application and Automation
        • Theme & Accent Events
        • Initialization
      • Siticone IdGen
        • Unique ID Customization
        • Character Set Customization
        • ID Generation Strategy and Distribution Settings
        • ID Generation and Collision Handling
    • Data Formatting and Display
      • Siticone Humanizer Date..
        • Data Management
        • Formatting Settings
        • Calculation Options
        • Custom Translations
      • Siticone HumanizerDec..
        • Input Value Configuration
        • Automatic Humanized Output
        • Customizable Humanization
      • Siticone HumanizerFloat
        • Formatting Features
        • Validation Features
        • Currency Features
        • Localization Features
        • Value and Precision Features
        • Read-Only Display Features
        • Additional Public Methods
        • Enumerations (for Customization)
      • Siticone HumanizerInt
        • Core Number Conversion
        • Text Customization and Styling Options
        • Number Scale & Localization
        • Currency Features
        • Performance and Asynchronous Processing
        • Caching Mechanism and Management
        • Settings Change Notifications
      • Siticone HumanizerLong
        • Core Number Conversion
        • Formatting and Localization Options
        • Security and Data Integrity
        • Performance and Caching
        • Events for Developer Integration
    • Special Purpose Controls
      • Siticone CardNumber
        • Appearance Customization
        • Credit Card Specific Features
        • Input and Validation
        • Read-Only Customization
        • Shadow & Animation Effects
        • Selection and Text Editing
        • Context Menu Support
        • Credit Card Events
      • Siticone CopyUrl
        • URL Display and Core Functionality
        • Icon Management
        • Copy Button Customization
        • Text Styling
        • Background & Border Styling
        • Corner Styling
        • Animation Effects
        • Interaction Behavior
        • Notification System
        • Additional Built-In Features
      • Siticone Rating
        • Rating Functionality
        • Appearance Customization
        • Layout and Sizing Customization
        • Behavior Customization
        • Animation Customization
        • Focus and Accessibility Customization
        • Right‑Click Context Menu Customization
      • Siticone RatingEmoji
        • Theme Management
        • Emoji Customization
        • Visual Enhancement
        • Selection and Rating
        • Animation and Interaction Dynamics
        • User Feedback
        • Data Persistence
Powered by GitBook
On this page
  • Overview
  • Key Points
  • Best Practices
  • Common Pitfalls
  • Real Life Usage Scenarios
  • Troubleshooting Tips
  • Property Reference
  • Code Examples
  • Frequently Asked Questions
  • Integration Checklist
  • Review
  • Summary
  1. Net Framework | Net Core UI
  2. Input Controls
  3. Siticone TextBox

User Interaction & Shortcuts

User Interaction & Shortcuts provides a comprehensive set of keyboard and mouse event handlers along with context menu actions to facilitate efficient text editing and navigation.

Overview

This section documents the behaviors and properties related to user interactions, including keyboard shortcuts, mouse events, context menu operations, and command key processing. These features ensure that developers can leverage built‐in support for common editing commands and custom shortcuts for an enhanced user experience.


Key Points

Aspect
Description

Keyboard Navigation

Supports arrow keys, Home, End, Page Up/Down, and other navigation keys to move the cursor and modify selection.

Editing Shortcuts

Implements common editing shortcuts such as Ctrl+Z (Undo), Ctrl+Y (Redo), Ctrl+B (Bold), Ctrl+I (Italic), and Ctrl+U (Underline).

Mouse Interactions

Handles mouse clicks, double-clicks, dragging for selection, and right-click context menu invocation for editing commands.

Context Menu Operations

Provides standard options (Copy, Cut, Paste, Delete, Select All) via a context menu for ease of text manipulation.


Best Practices

Practice Area
Recommendation

Consistent Shortcut Usage

Leverage the built‐in shortcuts to meet user expectations; avoid overloading keys to prevent conflicts with standard Windows shortcuts.

Preserve Default Behavior

When extending key handling, ensure that navigation and essential editing keys are not inadvertently suppressed.

Context Menu Customization

If extending the context menu, maintain the order and availability of core actions (Copy, Cut, Paste, etc.) to preserve usability.

Accessibility Considerations

Ensure that keyboard shortcuts are documented and accessible, allowing users who rely on keyboard navigation to operate the control efficiently.


Common Pitfalls

Pitfall
Description

Overriding Navigation Keys

Customizing key events without preserving arrow and navigation key functionality may lead to unexpected or non-intuitive cursor behavior.

Shortcut Conflicts

Assigning non-standard shortcuts or interfering with system-wide commands can confuse users and degrade the overall experience.

Inadequate Context Menu Feedback

Failing to update the context menu state (e.g., enabling/disabling items based on selection) may lead to user confusion or unintended actions.

Ignoring Modifier Keys

Not correctly handling combinations with Control, Shift, or Alt may result in missing out on intended behaviors such as selection extension or formatting toggles.


Real Life Usage Scenarios

Scenario
Description

Text Editors and IDEs

Utilize the full range of keyboard shortcuts and context menu actions to provide a familiar editing experience similar to modern code editors.

Data Entry Applications

Enable efficient navigation and editing for forms with extensive text input, leveraging Undo/Redo and selection shortcuts.

Rich Text Input Controls

Support advanced formatting commands (e.g., bold, italic) via keyboard shortcuts to empower users in content creation scenarios.

Accessibility-Focused Interfaces

Offer robust keyboard support to ensure users who rely on non-mouse navigation have complete control over text editing and selection.


Troubleshooting Tips

Issue
Suggested Solution

Keyboard Shortcuts Not Working

Verify that key event handlers (OnKeyDown, OnKeyPress) are correctly wired and that the control is focused when shortcuts are used.

Context Menu Actions Disabled

Ensure that the context menu items (Copy, Cut, Paste, etc.) are correctly configured based on the selection state and the control’s read-only status.

Navigation Keys Behaving Unexpectedly

Check that custom key handling logic preserves the default behavior for arrow keys and other navigation keys, especially when modifier keys are pressed.

Shortcut Conflicts with External Tools

Review any custom shortcut assignments to avoid conflicts with standard Windows shortcuts or other application-level keyboard bindings.


Property Reference

While User Interaction & Shortcuts are primarily managed through event handling rather than individual properties, the following related properties and methods are critical:

Property/Method Name
Type/Return
Description

IsInputKey(Keys keyData)

bool

Determines whether the specified key is recognized as an input key, ensuring proper handling of navigation and editing keys.

OnKeyDown(KeyEventArgs e)

void

Handles key down events for navigation, command shortcuts (e.g., Ctrl+Z, Ctrl+Y), and formatting toggles (e.g., Ctrl+B, Ctrl+I, Ctrl+U).

OnKeyPress(KeyPressEventArgs e)

void

Processes character input and updates the text content accordingly.

ProcessCmdKey(ref Message msg, Keys keyData)

bool

Overrides command key processing to handle undo, redo, and other keyboard shortcuts.

ContextMenuStrip

ContextMenuStrip

Provides a context menu with standard actions like Copy, Cut, Paste, Delete, and Select All.


Code Examples

Below are several code examples that demonstrate the usage of User Interaction & Shortcuts features.

Example 1: Using Keyboard Shortcuts for Editing

This example shows how the control processes keyboard shortcuts to perform actions such as undo, redo, and toggling font styles.

using System;
using System.Drawing;
using System.Windows.Forms;
using SiticoneNetFrameworkUI;

public class KeyboardShortcutForm : Form
{
    public KeyboardShortcutForm()
    {
        var customTextBox = new SiticoneTextBox
        {
            Text = "Press Ctrl+Z to Undo, Ctrl+Y to Redo, Ctrl+B for Bold, Ctrl+I for Italic, and Ctrl+U for Underline.",
            Location = new Point(20, 20),
            Size = new Size(400, 60)
        };

        Controls.Add(customTextBox);
        Text = "Keyboard Shortcuts Demo";
        Size = new Size(460, 140);
    }

    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new KeyboardShortcutForm());
    }
}

Example 2: Context Menu for Copy, Cut, Paste

This example demonstrates how the built-in context menu is used to provide editing commands via right-click.

using System;
using System.Drawing;
using System.Windows.Forms;
using SiticoneNetFrameworkUI;

public class ContextMenuForm : Form
{
    public ContextMenuForm()
    {
        var customTextBox = new SiticoneTextBox
        {
            Text = "Right-click to see the context menu with Copy, Cut, Paste, Delete, and Select All options.",
            Location = new Point(20, 20),
            Size = new Size(400, 60)
        };

        Controls.Add(customTextBox);
        Text = "Context Menu Demo";
        Size = new Size(460, 140);
    }

    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new ContextMenuForm());
    }
}

Example 3: Handling Custom Shortcut Actions

This example demonstrates adding additional custom shortcut logic in the control's key handling routines.

using System;
using System.Drawing;
using System.Windows.Forms;
using SiticoneNetFrameworkUI;

public class CustomShortcutForm : Form
{
    public CustomShortcutForm()
    {
        var customTextBox = new SiticoneTextBox
        {
            Text = "Custom shortcuts can be implemented in addition to built-in commands.",
            Location = new Point(20, 20),
            Size = new Size(400, 60)
        };

        // Attach an event handler for key down events to add a custom shortcut (e.g., Ctrl+M to show a message)
        customTextBox.KeyDown += (sender, e) =>
        {
            if (e.Control && e.KeyCode == Keys.M)
            {
                MessageBox.Show("Custom shortcut Ctrl+M triggered!", "Shortcut", MessageBoxButtons.OK, MessageBoxIcon.Information);
                e.Handled = true;
            }
        };

        Controls.Add(customTextBox);
        Text = "Custom Shortcut Demo";
        Size = new Size(460, 140);
    }

    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new CustomShortcutForm());
    }
}

Frequently Asked Questions

Question
Answer

How does the control support keyboard navigation and editing?

The control overrides key event handlers (OnKeyDown, OnKeyPress, ProcessCmdKey) to capture navigation keys, editing shortcuts, and command key combinations.

What default shortcuts are supported?

Common shortcuts include Ctrl+Z (Undo), Ctrl+Y (Redo), Ctrl+B (Bold), Ctrl+I (Italic), and Ctrl+U (Underline), in addition to standard navigation keys.

How is the context menu activated?

The context menu is shown on right-click and includes options such as Copy, Cut, Paste, Delete, and Select All, with availability based on the current selection state.

Can I add my own custom shortcuts?

Yes, you can handle additional key events (e.g., Ctrl+M) in the OnKeyDown event to implement custom shortcuts without interfering with default behavior.

How do I ensure that shortcut keys do not conflict with system commands?

Verify that custom shortcuts are chosen carefully and test in your application environment to ensure they do not interfere with standard Windows shortcuts.


Integration Checklist

Step
Verification

Keyboard Navigation Functionality

Confirm that the arrow keys, Home, End, and other navigation keys work as expected when the control is focused.

Shortcut Handling

Test built-in shortcuts (Ctrl+Z, Ctrl+Y, Ctrl+B, Ctrl+I, Ctrl+U) to ensure they trigger the intended actions.

Context Menu Availability

Verify that the context menu appears on right-click and that all menu items (Copy, Cut, Paste, Delete, Select All) are enabled/disabled appropriately.

Custom Shortcut Implementation

Check that any added custom shortcuts do not interfere with default functionality and that they trigger the correct custom logic.

Event Propagation

Ensure that key and mouse events are correctly processed and that essential events are not inadvertently suppressed.

Consistency Across States

Test the control in different states (editable, read-only, disabled) to ensure that user interactions behave consistently.

Accessibility Compliance

Verify that keyboard interactions are fully accessible and that shortcuts are documented for users relying on non-mouse input.


Review

Review Aspect
Details

Interaction Responsiveness

The control effectively processes a wide range of keyboard and mouse events, providing a responsive and intuitive editing experience.

Shortcut Consistency

Built-in and custom shortcuts are implemented to meet common user expectations, aligning with standard Windows behavior.

Context Menu Integration

The integrated context menu ensures that standard editing operations are readily available, enhancing usability.

Customization Flexibility

Developers can extend and customize key handling to add additional shortcuts or override default behavior as needed.


Summary

User Interaction & Shortcuts enhances the text box control by providing robust support for keyboard and mouse event handling, built-in editing shortcuts, and context menu operations.

These features ensure that users can navigate and manipulate text efficiently while enabling developers to extend and customize the interaction model as required.

PreviousInput, Validation and Read-Only BehaviorNextSystem Theme Integration

Last updated 4 months ago