ImageIcon 클래스

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

이미지를 콘텐츠로 사용하는 아이콘을 나타냅니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ImageIcon : IconElement

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ImageIcon : IconElement

Public Class ImageIcon
Inherits IconElement

상속

IconElement

ImageIcon

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

예제

팁

자세한 정보, 디자인 지침 및 코드 예제는 Windows 앱용 아이콘을 참조하세요.

WinUI 3 갤러리 및 WinUI 2 갤러리 앱에는 대부분의 WinUI 3 및 WinUI 2 컨트롤, 특징, 기능의 대화형 예제가 포함되어 있습니다.

이미 설치된 경우 WinUI 3 갤러리 또는 WinUI 2 갤러리 링크를 클릭하여 갤러리를 엽니다.

설치되지 않은 경우 Microsoft Store에서 WinUI 3 갤러리 및 WinUI 2 갤러리를 다운로드할 수 있습니다.

GitHub에서 두 갤러리의 소스 코드를 가져올 수도 있습니다(WinUI 3는 main 분기, WinUI 2는 winui2 분기 사용).

다음 예제에서는 가 인 AppBarButton 을 보여 주는 예제입니다 ImageIcon. 원본 은 앱 패키지에 포함된 이미지를 지정합니다.

<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->

<AppBarButton Label="ImageIcon">
    <AppBarButton.Icon>
        <muxc:ImageIcon Source="ms-appx:///Assets/globe.png"/>
    </AppBarButton.Icon>
</AppBarButton>

여기서는 비트맵 스트림에서 을 로드하는 ImageIcon 방법을 보여 드립니다.

// using muxc = Microsoft.UI.Xaml.Controls;

var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new muxc.ImageIcon() { Source = bitmapSource };

설명

지원되는 이미지 유형은 .bmp, .gif, .jpg, .png, .wdp 및 .tiff입니다.

이미지는 투명한 배경에서 견고해야 합니다.

다중 프레임 이미지의 첫 번째 프레임만 사용됩니다. 애니메이션 아이콘을 사용하려면 AnimatedIcon을 참조하세요.

지원되는 ImageIcon 파일 형식으로 인해 는 Foreground 속성을 무시하므로 다른 IconSource 파생 컨트롤에서처럼 전경색을 변경할 수 없습니다.

ImageIcon 는 일반적으로 AppBarButton과 함께 사용되지만 를 사용할 수 있는 모든 IconElement 곳에서 사용할 수 있습니다.

생성자

ImageIcon()

ImageIcon 클래스의 새 인스턴스를 초기화합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

속성

Source	아이콘으로 사용할 이미지 파일의 URI를 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SourceProperty	Source 종속성 속성을 나타냅니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

추가 정보

• IconSource
• AppBarButton
• 이미지
• UWP 앱용 아이콘