Siticone Currency Text Box

The SiticoneCurrencyTextBox is a specialized input control designed for financial applications. It goes beyond simple text entry by enforcing numeric input, handling currency symbols and thousand separators automatically, and providing real-time validation for value ranges.

Currency Configuration

Configure the financial logic of the control to match local or international standards.

Validation & Limits

Enforce business rules directly within the control by setting numeric boundaries.

Data Access

Retrieve the input value in a type-safe manner.

Appearance & Styling

Customize the visual presentation to match your application's theme.

Interaction Features

Programmatic Methods

Control the component logic from your code-behind.

Images & Icons

Add visual context with icons that can change based on the control's state.

Events

React to user actions, lifecycle changes, and validation results.

Key Events

// Fired when the user presses Enter while the control is focused.
// Provides access to the parsed value and validation state immediately.
txtAmount.EnterKeyPressed += (s, e) => 
{
                // e is CurrencyInputEnterKeyEventArgs
                if (e.IsValid)
    {
                // Safe to proceed with the transaction
        ProcessPayment(e.Value); 
    }
                else
    {
        MessageBox.Show("Invalid Amount: " + e.ValidationErrors[0]);
    }
};

// Fired when the text changes.
txtAmount.TextContentChangedEnhanced += (s, e) => 
{
                // Check the numeric value directly
                if (txtAmount.Value > 1000)
    {
        lblStatus.Text = "High value transaction";
    }
};

Lifecycle & State Events

Designer Support

The SiticoneCurrencyTextBox offers extensive design-time support via Smart Tags.

Usage Examples

Example 1: Basic USD Input

Standard setup for dollar amounts.

private void SetupDollarInput()
{
    txtPrice.CurrencySymbol = "$";
    txtPrice.DecimalPlaces = 2;
    txtPrice.CurrencySymbolPosition = CurrencySymbolPosition.Left;
    txtPrice.PlaceholderText = "$0.00";
}

Example 2: European Format (Euro)

Configuring for regions that use commas as decimal separators.

private void SetupEuroInput()
{
    txtEuro.CurrencySymbol = "€";
    txtEuro.CurrencySymbolPosition = CurrencySymbolPosition.Right;
    
                // Critical for "1.234,56" format
    txtEuro.AllowCommaAsDecimalSeparator = true;
}

Example 3: Range Validation

Enforcing a price range for a product input.

private void SetupPriceLimits()
{
    txtBid.ValidationEnabled = true;
    txtBid.MinValue = 10.00m;  // Minimum bid
    txtBid.MaxValue = 500.00m; // Maximum buy-now price
    
    txtBid.ErrorColor = Color.Red;
    txtBid.ValidationChangedEnhanced += (s, e) => 
    {
        btnSubmitBid.Enabled = txtBid.IsValid;
    };
}