Fix issue with tint not applying to loaded images

[myix765]

Description of Change

On Windows, if an image was already loaded (ie. after loading the page then navigating away and back to the page) the tint color is no longer applied because the ImageOpened event is not triggered. Adding a check for if the image is already loaded fixes this, but then causes an issue with the ToggleImageSource button. This was fixed by adding another check to see if the WImage source and the View source was the same, if not that means the toggle hasn't happened yet so we wait for the ImageOpened event to apply the tint.

This change also fixes the issue with the change tint color button not working in the sample app.

Linked Issues

• Fixes [BUG] Windows IconTintColorBehavior Navigate away and then back to a page and the tint is removed #1595
• Fixes [BUG] IconTintColorBehavior is reset when navigate to another page then back #1957 (seem to be referring to the same issue as above)
• Fixes [BUG] IconTintColorBehavior sample not working as expected on windows #1734

PR Checklist

• Has a linked Issue, and the Issue has been approved(bug) or Championed (feature/proposal)
• Has tests (if omitted, state reason in description)
• Has samples (if omitted, state reason in description)
• Rebased on top of main at time of PR
• Changes adhere to coding standard
• Documentation created or updated: https://github.com/MicrosoftDocs/CommunityToolkit/pulls

Additional information

OS: Windows 10

Testing the behavior is fixed: go to the IconTintColorBehavior page, click on a different page in the FlyoutMenu, then click back on Behaviors (which should still show the IconTintColorBehavior). Before these changes, when navigating back some tint colors weren't applied.

[akhilesh-hexagon]

Hi @brminnick
We are working on maui winui and icons are having issue while navigate back.
Do you have any timeline to merge this PR?
We are waiting for this PR.

[TheCodeTraveler]

Thanks @myix765! Could you please update the IconTintColorBehaviorPage in the sample app to provide an example that hits every new branch in void LoadAndApplyImageTintColor(IView, WImage, Color)?

In my review, I've left a comment on the two branches in void LoadAndApplyImageTintColor(IView, WImage, Color) that I am unable to reach using the sample app.

We are working on maui winui and icons are having issue while navigate back.
Do you have any timeline to merge this PR?
We are waiting for this PR.

@akhilesh-hexagon If you're also able to help provide a sample that covers these two new branches in void LoadAndApplyImageTintColor(IView, WImage, Color), I can merge this PR as soon as you provide it!

[TheCodeTraveler]

Could you please update the IconTintColorBehaviorPage in the sample app to include a use-case that hits this specific line of code where this specific if statement resolves to true?

if (element is IImageElement { Source: FileImageSource fileImageSource }
 				&& image.Source is BitmapImage bitmapImage
 				&& Uri.Compare(new Uri($"{bitmapImage.UriSource.Scheme}:///{fileImageSource.File}"), bitmapImage.UriSource, UriComponents.Path, UriFormat.Unescaped, StringComparison.OrdinalIgnoreCase) is not 0)

I cannot reach this branch using the Sample App and am unable to test it and verify it works.

[TheCodeTraveler]

Could you please update the IconTintColorBehaviorPage in the sample app to include a use-case that hits this specific line of code where this specific else block resolves?

else
{
    ApplyTimeColor();
}

I cannot reach this branch using the Sample App and am unable to test it and verify it works.

[Copilot]

Pull Request Overview

This PR addresses an issue on Windows where tint colors were not applied to already loaded images by centralizing the TintColor change handling and adding checks for image load state.

• Extracted inline PropertyChanged handler into OnIconTintColorBehaviorPropertyChanged
• Switched parameters from View to IView for consistency
• Added logic to detect image.IsLoaded and either apply tint immediately or defer until ImageOpened

[Copilot]

After tinting in the ImageOpened handler, unsubscribe this event (e.g., image.ImageOpened -= OnImageOpened;) to avoid memory leaks and duplicate invocations when the image reloads.

Suggested change

	{
	{
	image.ImageOpened -= OnImageOpened; // Unsubscribe first to prevent duplicate subscriptions

[Copilot]

[nitpick] The logic inside this handler duplicates the tint-application flow; consider extracting it into a shared helper method to reduce code duplication and improve readability.