---
description: >-
  Developers can modify the appearance of the text within the control by
  toggling font styles and applying text transformations, ensuring that the
  control’s typography matches the app, etc.
---

# Font and Text Style

## Overview

The Font & Text Style Customization feature is managed through several public properties that control the font styling and text transformation behavior. This includes toggling bold, italic, underline, and strike-through styles, as well as specifying whether the text should appear in its normal form or be converted to uppercase or lowercase.

| Property        | Type            | Default | Description                                                                                                                    |
| --------------- | --------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
| IsBold          | bool            | false   | When set to true, renders the text in a bold font style.                                                                       |
| IsItalic        | bool            | false   | When enabled, displays the text in italic style.                                                                               |
| IsUnderline     | bool            | false   | When set to true, underlines the text.                                                                                         |
| IsStrikeThrough | bool            | false   | When enabled, draws a strike-through line over the text.                                                                       |
| TextCaseMode    | TextCase (enum) | Normal  | Determines whether the text is displayed as typed (Normal), transformed to all uppercase (Upper), or to all lowercase (Lower). |

The control applies these styles dynamically, updating the font via an internal helper (e.g., UpdateFont) whenever one of these properties changes. This ensures that any modifications to the font style or text case are immediately reflected in the rendered output.

***

### Key Points

| Aspect               | Detail                                                                                                                                |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Dynamic Font Styling | The IsBold, IsItalic, IsUnderline, and IsStrikeThrough properties allow for real-time toggling of font appearance.                    |
| Text Transformation  | The TextCaseMode property ensures that text can be standardized (all uppercase or lowercase) to meet formatting requirements.         |
| Immediate Feedback   | Changes to any text styling property automatically trigger an update of the control’s font, ensuring the user sees changes instantly. |

***

### Best Practices

| Practice                            | Explanation                                                                                                                              |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Consistent Styling Across Controls  | Use the same combination of font styles (bold, italic, underline, strike-through) across similar controls for a uniform user experience. |
| Use Text Transformation Judiciously | Apply TextCaseMode only where necessary to maintain the intended meaning and readability of the text.                                    |
| Test Different Combinations         | Verify that various combinations of IsBold, IsItalic, IsUnderline, and IsStrikeThrough do not conflict and are visually balanced.        |
| Integrate with Overall UI Theme     | Ensure that the chosen font styles and text transformation settings align with your application’s typography and overall theme.          |

***

### Common Pitfalls

| Pitfall                         | How to Avoid                                                                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Overuse of Multiple Font Styles | Applying too many styles simultaneously (e.g., bold, italic, underline, strike-through) may reduce readability; choose a clear visual hierarchy. |
| Ignoring TextCaseMode Effects   | When converting text to upper or lower case, ensure that the underlying data is not adversely affected if case sensitivity is important.         |
| Inconsistent Font Updates       | Avoid manually setting the Font property outside of the provided styling properties; instead, rely on the control’s internal UpdateFont logic.   |

***

### Usage Scenarios

| Scenario                                        | Example Use Case                                                                                                                                       |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Emphasizing Important Information               | Use IsBold or IsUnderline to highlight critical parts of a phone number or accompanying instructional text.                                            |
| Standardizing Input Data                        | Apply TextCaseMode to automatically convert user input to uppercase or lowercase, ensuring consistency for storage or display.                         |
| Creating Read-Only Displays with Distinct Style | Combine multiple font styling properties (e.g., italic with strike-through) to indicate that the displayed text is non-editable or marked as obsolete. |

***

### Code Examples

Example 1: Basic Font Style Customization\
This sample demonstrates how to enable bold and italic styling on the phone number text.

```csharp
// Instantiate the control
SiticonePhoneNumberBox phoneNumberBox = new SiticonePhoneNumberBox();

// Enable bold and italic font styling
phoneNumberBox.IsBold = true;
phoneNumberBox.IsItalic = true;

// Set text alignment and case mode (optional)
phoneNumberBox.TextAlign = TextAlignment.Left;
phoneNumberBox.TextCaseMode = TextCase.Normal;

// Position and add to the form
phoneNumberBox.Location = new Point(20, 20);
phoneNumberBox.Size = new Size(250, 40);
this.Controls.Add(phoneNumberBox);
```

Example 2: Applying Underline and Strike-Through\
This example shows how to toggle underline and strike-through for a distinct visual effect.

```csharp
SiticonePhoneNumberBox phoneNumberBox = new SiticonePhoneNumberBox();

// Enable underline and strike-through styling
phoneNumberBox.IsUnderline = true;
phoneNumberBox.IsStrikeThrough = true;

// Optional: Set text transformation to uppercase for standardization
phoneNumberBox.TextCaseMode = TextCase.Upper;

// Position the control
phoneNumberBox.Location = new Point(20, 80);
phoneNumberBox.Size = new Size(250, 40);
this.Controls.Add(phoneNumberBox);
```

Example 3: Enforcing Text Case Transformation\
This sample demonstrates how to convert all entered text to lowercase for consistency.

```csharp
SiticonePhoneNumberBox phoneNumberBox = new SiticonePhoneNumberBox();

// Set text case mode to convert all text to lowercase
phoneNumberBox.TextCaseMode = TextCase.Lower;

// Position and configure the control
phoneNumberBox.Location = new Point(20, 140);
phoneNumberBox.Size = new Size(250, 40);
this.Controls.Add(phoneNumberBox);
```

***

### Review

| Aspect                          | Review Comment                                                                                                                         |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Styling Flexibility             | The feature provides comprehensive options to control font appearance, offering flexibility through multiple style toggles.            |
| Immediate Visual Updates        | The internal UpdateFont mechanism ensures that any change to the font styling properties is immediately rendered.                      |
| Text Transformation Consistency | The TextCaseMode property simplifies ensuring that input adheres to a desired format, which is especially useful for data consistency. |

***

### Summary

The Font & Text Style Customization feature of the SiticonePhoneNumberBox control empowers developers to tailor the visual presentation of text. By leveraging properties such as IsBold, IsItalic, IsUnderline, IsStrikeThrough, and TextCaseMode, you can ensure that the text displayed within the control matches your application’s design requirements and data formatting standards. This results in a more polished and consistent user interface.

***

### Additional Notes

| Note Type        | Detail                                                                                                                                          |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Extensibility    | The font styling properties can be modified at runtime, allowing dynamic adjustments based on user interactions or theme changes.               |
| Integration Tips | Combine text style customization with other visual features (such as border and background settings) for a cohesive overall design.             |
| Debugging        | Monitor changes to the control’s font and verify that UpdateFont is invoked appropriately when any of the text styling properties are modified. |







