Appearance

Customize the visual styling of the Siticone RadialButton to create a visually appealing and consistent user interface.

Overview

The Appearance feature of the SiticoneRadialButton control encompasses all properties related to the visual styling of the button. This includes configuration of badges, borders, background effects, text presentation, images, shadows, glows, and particle effects. By leveraging these properties, developers can tailor the button's look and feel to align with their application's design language, ensuring a modern and engaging user experience.


1.1 Badge Configuration

Badges provide a way to display notifications, counters, or status indicators overlaid on the button.

Properties

Property
Description
Default Value

BadgeText

Sets the text displayed in the button's badge. Use for notifications, counters, or status indicators overlaid on the button.

"" (empty string)

BadgeColor

Defines the background color of the badge. Choose contrasting colors for optimal visibility against the button's background.

Color.Red

BadgeTextColor

Sets the color of the text within the badge. Ensure sufficient contrast with the badge background for readability.

Color.White

BadgeFont

Specifies the font used for the badge text. Consider using condensed or smaller fonts for compact badges.

new Font("Segoe UI", 8f, FontStyle.Bold)

Key Points to Note

Point
Description

Badge Positioning

The badge is automatically positioned at the top-right corner of the button. Ensure that the button size accommodates the badge without overlapping important UI elements.

Visibility Control

A badge is only visible when BadgeText is not empty. Use it to indicate new messages, notifications, or status updates relevant to the button's action.

Dynamic Updates

Updating BadgeText dynamically reflects changes immediately, allowing real-time notification updates.

Accessibility Considerations

Ensure that badge text is accessible by providing meaningful descriptions for assistive technologies.

Code Example

// Creating a SiticoneRadialButton with a notification badge
SiticoneRadialButton radialButton = new SiticoneRadialButton
{
    Text = "Messages",
    BadgeText = "5",
    BadgeColor = Color.Green,
    BadgeTextColor = Color.White,
    BadgeFont = new Font("Arial", 10f, FontStyle.Bold)
};

Best Practices

Practice
Description

Consistent Styling

Use a consistent color scheme for badges across your application to maintain a uniform look.

Minimal Text

Keep badge text concise (e.g., single digits) to avoid clutter and ensure readability.

High Contrast

Choose BadgeColor and BadgeTextColor with high contrast to enhance visibility and readability.

Purposeful Usage

Use badges sparingly to indicate genuinely important information, preventing user desensitization to frequent notifications.

Common Pitfalls and Design Considerations

Pitfall
Description

Overlapping Content

Ensure that the badge does not obscure the button's main content or image, especially with larger badge sizes or long texts.

Dynamic Badge Sizes

Varying BadgeText lengths can cause inconsistent badge sizes. Implement size constraints or dynamic sizing logic to maintain uniformity.

Accessibility Neglect

Without proper descriptions, badges may not be accessible to users relying on assistive technologies. Provide meaningful AccessibleDescription.

Performance Impact

Excessive use of badges with frequent updates can impact rendering performance. Optimize update logic to minimize performance overhead.


1.2 Border Styling

Borders define the outline of the button, adding emphasis and separation from other UI elements.

Properties

Property
Description
Default Value

BorderColor

Defines the color of the button's border. Use to create visual boundaries or emphasis.

Color.FromArgb(94, 148, 255)

BorderWidth

Controls the thickness of the button's border in pixels. Minimum value is 2 for visible borders.

2

Key Points to Note

Point
Description

Visibility Threshold

A minimum BorderWidth of 2 ensures that the border is visible. Adjust as necessary to match design requirements.

Color Coordination

Align BorderColor with the button's BaseColor and other color properties to maintain a cohesive design.

Scaling

When resizing the button, ensure that BorderWidth scales appropriately to maintain visual consistency.

Code Example

// Configuring border properties
radialButton.BorderColor = Color.DarkBlue;
radialButton.BorderWidth = 3;

Best Practices

Practice
Description

Subtle Borders

Use border colors that complement rather than overpower the button's background color to maintain visual harmony.

Consistent Thickness

Maintain uniform border widths across similar buttons to enhance visual consistency and professional appearance.

Responsive Borders

Adjust BorderWidth responsively based on button size to ensure borders remain proportionate and aesthetically pleasing.

Common Pitfalls and Design Considerations

Pitfall
Description

Too Thick Borders

Excessively thick borders can make the button look bulky and may interfere with other UI elements, reducing overall aesthetic appeal.

Low Contrast Colors

Borders with low contrast relative to the background may become hard to distinguish, reducing visual clarity and user feedback.

Inconsistent Styling

Varying border styles across similar buttons can create a disjointed and unprofessional user interface.


1.3 Background Effects

Background properties control the button's primary appearance, including base color and gradient fills.

Properties

Property
Description
Default Value

BaseColor

Sets the primary background color of the button in its default state. Forms the foundation of the button's visual identity.

Color.FromArgb(94, 148, 255)

HoverColor

Defines the background color when hovering over the button. Creates an interactive color transition effect.

Color.FromArgb(114, 168, 255)

PressedColor

Specifies the background color when the button is pressed. Provides visual feedback for user interaction.

Color.FromArgb(74, 128, 235)

GradientBackground

Enables gradient background filling. When true, creates a smooth color transition between BaseColor and GradientColor.

false

GradientColor

Sets the secondary color used in gradient backgrounds. Blends with BaseColor to create smooth color transitions.

Color.FromArgb(114, 168, 255)

GradientMode

Determines the direction of the gradient fill. Options include vertical, horizontal, and diagonal gradients.

LinearGradientMode.Vertical

Key Points to Note

Point
Description

Gradient Usage

When GradientBackground is enabled, the button will display a gradient between BaseColor and GradientColor. Ensure these colors complement each other.

State Colors

HoverColor and PressedColor should provide clear visual cues for interactive states, enhancing user experience.

Color Harmony

Select BaseColor and GradientColor that harmonize with each other and the overall application theme for a cohesive appearance.

Code Example

// Configuring background with gradient effect
radialButton.BaseColor = Color.Blue;
radialButton.HoverColor = Color.LightBlue;
radialButton.PressedColor = Color.DarkBlue;
radialButton.GradientBackground = true;
radialButton.GradientColor = Color.CornflowerBlue;
radialButton.GradientMode = LinearGradientMode.Horizontal;

Best Practices

Practice
Description

Complementary Colors

Choose BaseColor and GradientColor that work well together to create aesthetically pleasing gradients.

Consistent Gradient Direction

Maintain consistent gradient directions across similar controls to ensure uniformity in the UI.

Responsive Design

Ensure gradients scale appropriately with button size to maintain visual integrity across different resolutions and device sizes.

State Differentiation

Utilize distinct HoverColor and PressedColor to provide clear and immediate visual feedback for user interactions.

Common Pitfalls and Design Considerations

Pitfall
Description

Overwhelming Gradients

Avoid using too many bright or clashing colors in gradients, which can distract users and create visual noise.

Performance Impact

Complex gradient rendering may impact performance, especially on lower-end systems or with numerous controls on screen.

Inconsistent Gradient Usage

Applying gradients inconsistently across controls can lead to a fragmented and unprofessional user interface.

Poor Color Selection

Selecting GradientColor that clashes with BaseColor can result in an unattractive and disjointed appearance.


1.4 Text Presentation

Text properties manage the appearance of the button's label, including color and font styles.

Properties

Property
Description
Default Value

TextColor

Sets the default text color of the button. Should provide sufficient contrast with the background color.

Color.White

HoverTextColor

Specifies the text color when the mouse hovers over the button. Creates subtle visual feedback for user interaction.

Color.White

DisabledTextColor

Specifies the text color when the button is disabled. Should indicate non-interactive state while maintaining readability.

Color.FromArgb(150, 150, 150)

ReadOnlyTextColor

Defines the text color when the button is in read-only mode. Visually distinguishes non-interactive state from disabled state.

Color.FromArgb(100, 100, 100)

NormalFontStyle

Sets the font style used in the button's normal state. This is the default appearance of the button text.

FontStyle.Regular

HoverFontStyle

Defines the font style applied when hovering over the button. Use for subtle typographic feedback.

FontStyle.Regular

PressedFontStyle

Specifies the font style used when the button is pressed. Creates visual distinction for active state.

FontStyle.Regular

Key Points to Note

Point
Description

Contrast and Readability

Ensure that TextColor, HoverTextColor, DisabledTextColor, and ReadOnlyTextColor provide adequate contrast against the button's background for readability.

Font Style Consistency

Use NormalFontStyle, HoverFontStyle, and PressedFontStyle to indicate different states, enhancing user feedback and maintaining a cohesive design.

Responsive Text Scaling

Ensure text remains legible across different button sizes by choosing appropriate font sizes and styles.

Mnemonic Support

Incorporate mnemonics (e.g., &File) in button text for keyboard accessibility, ensuring that AccessibleName and AccessibleDescription are properly set.

Code Example

// Configuring text presentation properties
radialButton.Text = "Submit";
radialButton.TextColor = Color.White;
radialButton.HoverTextColor = Color.LightYellow;
radialButton.DisabledTextColor = Color.Gray;
radialButton.ReadOnlyTextColor = Color.DarkGray;
radialButton.NormalFontStyle = FontStyle.Regular;
radialButton.HoverFontStyle = FontStyle.Bold;
radialButton.PressedFontStyle = FontStyle.Italic;
radialButton.Font = new Font("Segoe UI", 10f, FontStyle.Regular);

Best Practices

Practice
Description

Readable Fonts

Choose font styles and sizes that are easily readable, avoiding overly decorative fonts that may hinder comprehension.

Consistent Text Styles

Maintain consistent use of font styles across buttons to ensure a cohesive design and professional appearance.

State Differentiation

Utilize different font styles for Hover and Pressed states to provide clear visual cues to users, enhancing interactivity and feedback.

Accessible Text

Ensure text is accessible by supporting keyboard navigation and screen readers through proper use of mnemonics and accessibility properties.

Common Pitfalls and Design Considerations

Pitfall
Description

Low Contrast

Avoid using text colors that blend with the background, making text difficult to read, especially for users with visual impairments.

Overuse of Styles

Excessive changes in font styles across different states can be distracting and reduce the clarity of feedback provided to users.

Inconsistent Sizing

Inconsistent font sizes across buttons can lead to a disjointed and unprofessional user interface.

Accessibility Neglect

Failing to support keyboard navigation and screen readers can make the button less accessible to users with disabilities.


1.5 Image Configuration

Image properties allow the inclusion of icons or images alongside the button's text, enhancing visual appeal and conveying additional information.

Properties

Property
Description
Default Value

ButtonImage

Sets the image displayed on the button. Supports icons, logos, or decorative elements alongside text.

null (no image)

ImageSize

Defines the dimensions of the button's image in pixels. Maintains consistent image sizing across different button states.

new Size(16, 16)

ImageAlign

Controls the positioning of the image within the button using the nine-grid alignment system.

ContentAlignment.MiddleLeft

ImagePadding

Sets the spacing between the image and other button elements in pixels. Ensures proper visual separation.

5 pixels

Key Points to Note

Point
Description

Image Placement

ImageAlign determines where the image appears relative to the text, such as left, right, top, bottom, or center.

Image Sizing

Consistent ImageSize across buttons ensures uniformity and prevents layout inconsistencies.

Padding and Spacing

ImagePadding controls the space between the image and text, preventing overcrowding and maintaining visual clarity.

Right-to-Left Support

ImageAlign adapts based on the RightToLeft property to support languages that read from right to left.

Code Example

// Configuring image properties
radialButton.ButtonImage = Image.FromFile("upload_icon.png");
radialButton.ImageSize = new Size(24, 24);
radialButton.ImageAlign = ContentAlignment.MiddleRight;
radialButton.ImagePadding = 10;

Best Practices

Practice
Description

High-Quality Images

Use clear and high-resolution images to maintain visual quality, especially when scaling is involved.

Consistent Alignment

Align images consistently across similar buttons to create a harmonious UI.

Appropriate Padding

Adjust ImagePadding to balance the space between images and text, preventing overcrowding and ensuring readability.

Meaningful Icons

Use images that add value by conveying the button's purpose or enhancing its functionality, avoiding purely decorative images.

Common Pitfalls and Design Considerations

Pitfall
Description

Image Overlap

Ensure that the image and text do not overlap, especially when using larger images or longer text.

Unsupported Formats

Use standard image formats (e.g., PNG, JPEG) supported by .NET to avoid rendering issues.

Scalability Issues

Be mindful of how images scale with different ImageSize settings to maintain aspect ratios and prevent distortion.

Performance Impact

Large images or high-resolution icons can impact rendering performance. Optimize image sizes for better performance.


1.6 Shadow Effects

Shadow effects add depth and elevation to the button, enhancing its visual prominence and making it stand out from the background.

Properties

Property
Description
Default Value

EnableShadow

Toggles the visibility of the button's shadow effect. Use this for creating hierarchy and depth in your interface design.

false

ShadowColor

Defines the color of the button's drop shadow, adding depth and elevation to the interface. Adjust alpha for shadow intensity.

Color.FromArgb(100, Color.Black)

ShadowOffset

Specifies the X and Y offset of the shadow relative to the button. Larger values create more pronounced shadows suggesting greater elevation.

new Point(2, 2)

ShadowBlur

Controls the softness of the shadow edge. Higher values create a more diffused, natural-looking shadow effect.

5 pixels

Key Points to Note

Point
Description

Shadow Direction

ShadowOffset determines the direction in which the shadow is cast, adding a sense of light source directionality.

Blur and Intensity

Adjust ShadowBlur and the alpha component of ShadowColor to control the softness and visibility of the shadow, balancing between subtlety and prominence.

Performance Considerations

Excessive shadow blur or large offsets can impact rendering performance, especially with multiple buttons on screen.

Code Example

// Configuring shadow properties
radialButton.EnableShadow = true;
radialButton.ShadowColor = Color.FromArgb(120, Color.Gray);
radialButton.ShadowOffset = new Point(4, 4);
radialButton.ShadowBlur = 10;

Best Practices

Practice
Description

Subtle Shadows

Use subtle shadow effects to avoid overpowering the button's main content while still providing depth.

Consistent Shadow Direction

Maintain a consistent shadow direction across all buttons to reflect a unified light source in your application's design.

Performance Optimization

Optimize ShadowBlur and ShadowOffset values to balance visual appeal with application performance.

Complementary Colors

Select ShadowColor that complements the button's BaseColor and overall application theme for a cohesive look.

Common Pitfalls and Design Considerations

Pitfall
Description

Overly Dark Shadows

Shadows with high opacity can make the button appear too heavy or disconnected from the background.

Misaligned Shadows

Incorrect ShadowOffset values can lead to shadows that appear unrealistic or inconsistent with the overall UI.

Excessive Blur

High ShadowBlur values can make shadows appear too diffused, reducing their effectiveness in adding depth and separation.

Performance Impact

Large shadow blurs and multiple shadow-enabled buttons can negatively affect rendering performance, especially on lower-end devices.


1.7 Glow Effects

Glow effects create an illuminated appearance around the button, enhancing visual feedback during interactions like hover.

Properties

Property
Description
Default Value

CanGlow

Activates a dynamic glow effect on hover. Creates an illuminated appearance for enhanced visual feedback.

false

GlowColor

Sets the color of the glow effect. Choose colors that complement the button's design theme.

Color.FromArgb(100, Color.White)

GlowRadius

Controls the size of the glow effect's radius in pixels. Larger values create a more diffused glow.

20f pixels

GlowIntensity

Determines the brightness of the glow effect on a scale of 0-255. Higher values create more intense glow.

100

Key Points to Note

Point
Description

Activation

The glow effect is typically activated on hover or other interactive states, providing immediate visual feedback to users.

Color Selection

GlowColor should be chosen to complement BaseColor and other color properties, enhancing the overall aesthetic without clashing.

Radius and Intensity

Adjust GlowRadius and GlowIntensity to control the spread and brightness of the glow, balancing visibility with subtlety.

Performance Impact

Continuous or complex glow animations may affect performance, especially on devices with limited graphics capabilities.

Code Example

// Configuring glow properties
radialButton.CanGlow = true;
radialButton.GlowColor = Color.FromArgb(120, Color.Yellow);
radialButton.GlowRadius = 25f;
radialButton.GlowIntensity = 150;

Best Practices

Practice
Description

Balanced Glow

Ensure the glow effect is noticeable without overwhelming the button or causing visual fatigue.

Complementary Colors

Select GlowColor that harmonizes with BaseColor and other color properties for a cohesive look.

Consistent Application

Apply similar glow effects across related buttons to maintain a uniform interactive experience.

Performance Optimization

Optimize GlowRadius and GlowIntensity to balance visual appeal with application performance.

Common Pitfalls and Design Considerations

Pitfall
Description

Overglowing

Excessive glow intensity or radius can make the button appear garish or distract from other UI elements.

Inconsistent Glow Usage

Applying glow effects inconsistently across buttons can lead to a fragmented and unprofessional user interface.

Performance Impact

High GlowRadius and intense glow colors can increase rendering load, impacting application responsiveness and performance.


1.8 Particle Effects

Particle effects add dynamic visual feedback through animated particles upon user interactions like clicks.

Properties

Property
Description
Default Value

UseParticles

Enables particle animation effects on click. Creates engaging visual feedback through animated particles.

false

ParticleCount

Specifies the number of particles generated on click. Higher values create denser particle effects.

15

ParticleColor

Sets the color of particles generated during click animations. Should complement the button's color scheme.

Color.FromArgb(255, 200, 200, 200)

Key Points to Note

Point
Description

Activation

Particle effects are triggered on user interactions like button clicks, enhancing the tactile feedback and visual engagement.

Customization

Adjust ParticleCount and ParticleColor to control the density and visual appearance of the particles, aligning with the application's design theme.

Performance Considerations

Higher ParticleCount can lead to increased CPU and GPU usage. Optimize the number of particles to balance visual appeal with performance.

Lifecycle Management

Particles are transient and managed internally. Ensure that UseParticles is enabled only when necessary to prevent unnecessary resource usage.

Code Example

// Configuring particle properties
radialButton.UseParticles = true;
radialButton.ParticleCount = 20;
radialButton.ParticleColor = Color.FromArgb(255, 255, 0, 0); // Red particles

Best Practices

Practice
Description

Subtlety

Use particle effects sparingly to avoid overwhelming the user or causing visual clutter.

Color Coordination

Ensure ParticleColor complements the button's BaseColor and overall application theme to maintain a harmonious design.

Performance Optimization

Optimize ParticleCount to balance visual appeal with application performance, especially on lower-end systems.

Responsive Effects

Ensure particle effects scale appropriately with button size to maintain visual integrity across different resolutions and device sizes.

Common Pitfalls and Design Considerations

Pitfall
Description

Performance Overhead

High ParticleCount can lead to increased CPU and GPU usage, impacting application responsiveness and overall performance.

Visual Distraction

Excessive or brightly colored particles may distract users or detract from the primary content, reducing the effectiveness of the UI.

Inconsistent Effects

Applying particle effects inconsistently across buttons can create a fragmented and unprofessional user interface.

Resource Management

Ensure that particle resources are efficiently managed and disposed of to prevent memory leaks and unnecessary resource consumption.


Key Points to Note

Key Point
Description

Comprehensive Customization

The Appearance feature offers extensive customization options to tailor the button's look and feel, ensuring it fits seamlessly within various UI designs.

Interdependent Properties

Some properties, such as GradientBackground and GradientColor, work in conjunction to produce desired visual effects. Ensure understanding of these dependencies for effective customization.

Performance Considerations

Advanced visual effects like shadows, glows, and particles enhance aesthetics but may impact performance. Balance visual appeal with application responsiveness.

Consistency and Cohesion

Maintain consistent styling across similar buttons and UI elements to create a unified and professional user interface.

Accessibility and Readability

Always prioritize text readability and contrast, ensuring that button labels are clear and accessible to all users.


Best Practices to Follow to Create Beautiful UI and Apps

Best Practice
Description

Maintain Visual Hierarchy

Use border colors and shadows to create a sense of depth and hierarchy, guiding users' attention to interactive elements.

Use Complementary Colors

Select colors that complement each other to create a harmonious and visually pleasing interface, enhancing overall aesthetic appeal.

Ensure Readability

Choose text colors and font styles that are easily readable against the button's background, enhancing usability and accessibility.

Leverage Subtle Animations

Implement animations like glows and ripples to provide feedback without overwhelming the user, creating an engaging and responsive experience.

Consistent Image Usage

Use images that align with the application's overall design language, maintaining consistency across UI components and preventing visual dissonance.

Optimize for Performance

Balance the use of visual effects with application performance to ensure smooth user interactions, especially on lower-end systems.

Responsive Design

Ensure that the button's appearance adapts gracefully to different sizes and resolutions, maintaining visual integrity across devices and layouts.

Accessibility Compliance

Adhere to accessibility standards by ensuring adequate contrast, readable text, and support for assistive technologies, making the UI inclusive.


Common Pitfalls and Design Considerations

Pitfall
Description

Overuse of Effects

Applying too many visual effects can lead to a cluttered interface and reduce usability, making the UI appear busy and overwhelming.

Low Contrast

Insufficient contrast between text and background colors can impair readability, especially for users with visual impairments or color blindness.

Inconsistent Styling

Inconsistent use of colors, borders, and effects across buttons can create a disjointed and unprofessional user interface, confusing users.

Performance Impact

High-intensity effects like heavy shadows or numerous particles can negatively affect application performance, leading to lag and reduced responsiveness.

Accessibility Neglect

Ignoring accessibility standards can make the application less usable for individuals with disabilities, limiting your user base and violating guidelines.

Ignoring Right-to-Left Languages

Failing to support RightToLeft alignment can limit the application's usability in regions with RTL languages, excluding a segment of potential users.

Improper Image Scaling

Images that are not properly scaled may appear distorted or pixelated, detracting from the overall aesthetic and professionalism of the UI.


Review and Summary

The Appearance feature of the SiticoneRadialButton control offers a robust set of properties to customize the button's visual aspects, including badges, borders, backgrounds, text, images, shadows, glows, and particles. By strategically configuring these properties, developers can create buttons that not only align with their application's design language but also enhance user experience through visual feedback and aesthetic appeal.

Key Considerations:

  • Consistency: Maintain consistent styling across similar buttons and UI elements to ensure a unified and professional interface.

  • Readability and Accessibility: Prioritize text readability and contrast, and ensure that all visual elements are accessible to users with disabilities.

  • Performance Optimization: Balance the use of advanced visual effects with application performance to prevent lag and ensure smooth user interactions.

  • Purposeful Customization: Use visual effects purposefully to enhance user experience without overwhelming or distracting the user.

By adhering to these best practices and being mindful of common pitfalls, developers can effectively leverage the Appearance feature to craft intuitive, engaging, and visually stunning user interfaces.


Additional Sections

Customization Examples

Example 1: Notification Badge with Gradient Background

This example demonstrates how to create a button with a notification badge and a gradient background, enhancing both functionality and aesthetics.

// Creating a SiticoneRadialButton with a notification badge and gradient background
SiticoneRadialButton radialButton = new SiticoneRadialButton
{
    Text = "Notifications",
    BadgeText = "3",
    BadgeColor = Color.Red,
    BadgeTextColor = Color.White,
    BadgeFont = new Font("Segoe UI", 9f, FontStyle.Bold),
    BaseColor = Color.FromArgb(94, 148, 255),
    GradientBackground = true,
    GradientColor = Color.FromArgb(114, 168, 255),
    GradientMode = LinearGradientMode.Vertical,
    BorderColor = Color.DarkBlue,
    BorderWidth = 2,
    TextColor = Color.White,
    Font = new Font("Segoe UI", 10f, FontStyle.Regular)
};

Example 2: Button with Image and Shadow

This example showcases a button with an accompanying image and shadow effect, adding depth and visual interest.

// Configuring a SiticoneRadialButton with an image and shadow
SiticoneRadialButton radialButton = new SiticoneRadialButton
{
    Text = "Upload",
    ButtonImage = Image.FromFile("upload_icon.png"),
    ImageSize = new Size(20, 20),
    ImageAlign = ContentAlignment.MiddleLeft,
    ImagePadding = 8,
    BaseColor = Color.FromArgb(100, 149, 237), // Cornflower Blue
    BorderColor = Color.FromArgb(70, 130, 180), // Steel Blue
    BorderWidth = 3,
    EnableShadow = true,
    ShadowColor = Color.FromArgb(80, Color.Gray),
    ShadowOffset = new Point(3, 3),
    ShadowBlur = 7,
    TextColor = Color.White,
    Font = new Font("Segoe UI", 10f, FontStyle.Bold)
};

FAQs

Question

Answer

Q1: How do I disable the badge on the button?

A1: To disable the badge, simply set the BadgeText property to an empty string.

Q2: Can I use custom fonts for the button's text and badge?

A2: Yes, you can customize the font styles using the NormalFontStyle, HoverFontStyle, PressedFontStyle, and BadgeFont properties.

Q3: How do I align the image to the right side of the button?

A3: Set the ImageAlign property to ContentAlignment.MiddleRight.

Q4: Is it possible to have multiple badges on a single button?

A4: The current implementation supports only a single badge per button. For multiple indicators, consider customizing the control or using additional visual elements.

Q5: How do I change the glow effect dynamically based on user interactions?

A5: Adjust properties like GlowColor, GlowRadius, and GlowIntensity programmatically in response to user interactions to create dynamic glow effects.

Q6: What image formats are supported for ButtonImage?

A6: The ButtonImage property supports standard image formats such as PNG and JPEG. Ensure that images are optimized for web and desktop applications to prevent rendering issues.

Troubleshooting

Issue

Solution

Badge is not displaying even after setting BadgeText.

- Ensure that BadgeText is not an empty string.- Verify that EnableShadow or other overlapping visual effects are not hiding the badge.- Confirm that the button size accommodates the badge.

Text is not readable against the background color.

- Adjust the TextColor to a color with higher contrast relative to the BaseColor or GradientColor.- Utilize tools or guidelines to ensure accessibility compliance.

Performance lags when using multiple visual effects.

- Optimize the use of effects by reducing properties like GlowRadius, GlowIntensity, and ParticleCount.- Disable unnecessary effects to enhance performance.

Image appears distorted or pixelated.

- Ensure that the image used has sufficient resolution.- Verify that ImageSize maintains the image's aspect ratio to prevent distortion.- Use vector-based images where possible.

Shadow effect not visible.

- Confirm that EnableShadow is set to true.- Check that ShadowColor has sufficient opacity.- Ensure that ShadowOffset is appropriately set to make the shadow visible.

Glow effect does not activate on hover.

- Verify that CanGlow is set to true.- Ensure that GlowColor, GlowRadius, and GlowIntensity are configured correctly.- Confirm that the hover state is being triggered.

Happy UI development!

Last updated