Not logged in▾
Log In Register
Forgot Password Resend Validation E-mail
In This Article

Converting to v25.1

Avalonia Dependency

Updated the minimum Avalonia dependency from v11.1.0 to v11.2.0.

User Prompt Icon Updates

With the addition of Icon Presenter and the flexbility it provides for defining icons, all IImage-based properties and methods on the various User Prompt classes (i.e., UserPromptControl and UserPromptBuilder) where changed from IImage? value types to object?.

To ease the transition, the old properties and methods have been deprecated and will be removed in a future release. While no immediate changes should be necessary for most users, it is recommended to stop using the old properties and methods as soon as possible to avoid future breaking changes when they are officially removed.

The following updates should be made for UserPromptControl:

  • Replace references to the FooterImageSource property with the FooterIcon property.
  • Replace references to the StatusImageSource property with the StatusIcon property.
  • Replace references to the HasFooterImage property with the IsFooterIconVisible property.
  • Replace references to the HasStatusImage property with the IsStatusIconVisible property.
  • Any customized templates for UserPromptControl should be able to handle object value types instead of only IImage value types for the status and footer icons.

The following updates should be made for UserPromptBuilder:

  • Replace references to the FooterImage property with the FooterIcon property.
  • Replace references to the StatusImage property with the StatusIcon property.
  • Replace calls to the WithFooterImage method with the WithFooterIcon method.
  • Replace calls to the WithStatusImage method with the WithStatusIcon method.
Tip

See the new Icon Presenter topic for more details on how object-based images are supported.

ImageControlConverter Deprecated

The ImageControlConverter class has been deprecated and will be removed in a future release. Use IconControlConverter instead.

The ImageControlConverter would only convert an IImage to a DynamicImage. By default, the ImageControlConverter will convert an IImage to a ContentControl whose content will be a DynamicImage. IconControlConverter also supports other data types, and the default IDataTemplate for each value type can easily be customized and extended using the IconPresenter.DefaultContentTemplate property.