Setting user defined image for help button in title bar

[Toby]

Hi, How do I go about setting my own image for the help button shown in the title bar at run-time of a RadForm ? I can get the '?' button up but I want to change this form something else.

Thanks Toby

[Dinko | Tech Support Engineer]

Hello Toby,

You can use the following code snippet to change the default image of the HelpButton.

public RadForm1()
{
    InitializeComponent();
    this.FormElement.TitleBar.HelpButton.Visibility = ElementVisibility.Visible;
    RadImageShape imageShape = new RadImageShape();
    imageShape.Image = Image.FromFile(@"C:\..\..\MyImage.PNG");
    this.FormElement.TitleBar.HelpButton.Image = imageShape.Image;
    this.FormElement.TitleBar.HelpButton.DisplayStyle = DisplayStyle.Image;
}

Keep in mind that you need to set the DisplayStyle property of the HelpButton to Image. Otherwise, the Image property won't be respected.

I hope you find this reply helpful.

Regards,
Dinko
Progress Telerik

[Toby]

I've just tried your suggested solution and it works, but only when the ThemeName of the form is set to something other than ControlDefault. If it is set to ControlDefault i see a '?' rather than my image.

I can reproduce this when a new project and an empty form.

Is it possible to set the image when the ThemeName is set to ControlDefault ?

[Dinko | Tech Support Engineer]

In the ControlDefault theme, the HelpButton is using SVG image for its question mark. The SvgImage of the ImagePrimitive has a higher priority than the Image property. To respect the image property you can reset the SvgImage property value by setting it to null.

public RadForm1()
{
    InitializeComponent();
    this.FormElement.TitleBar.HelpButton.Visibility = ElementVisibility.Visible;
    RadImageShape imageShape = new RadImageShape();
    imageShape.Image = Image.FromFile(@"C:\..\..\MyImage.PNG");
    this.FormElement.TitleBar.HelpButton.ImagePrimitive.SvgImage = null;
    this.FormElement.TitleBar.HelpButton.Image = imageShape.Image;
    this.FormElement.TitleBar.HelpButton.DisplayStyle = DisplayStyle.Image;
}

[Toby]

Perfect, setting SvgImage to null solved the problem for me