ImageIconSource 클래스

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

이미지 형식을 콘텐츠로 사용하는 아이콘 원본을 나타냅니다. 현재 지원되는 이미지 유형은 .bmp, .gif, .jpg, .png, .wdp 및 .tiff.

/// [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 ImageIconSource : IconSource

[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 ImageIconSource : IconSource

Public Class ImageIconSource
Inherits IconSource

상속

Object IInspectable DependencyObject IconSource ImageIconSource

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

예제

팁

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

WinUI 3 갤러리 앱을 열고 아이콘실행 중인 IconElement를 참조하세요.

WinUI 3 갤러리 앱에는 대부분의 WinUI 3 컨트롤, 기능 및 기능에 대한 대화형 예제가 포함되어 있습니다. Microsoft Store에서 앱을 다운로드하거나 GitHub에서 소스 코드를 가져오세요.

다음 예제에서는 ImageIconSource가 있는 AppBarButton 을 보여줍니다. ImageSource 는 앱 패키지에 포함된 이미지를 지정합니다.

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

<AppBarButton >
    <AppBarButton.Icon>
        <IconSourceElement>
            <muxc:ImageIconSource ImageSource="ms-appx:///Assets/globe.png"/>
        </IconSourceElement>
    </AppBarButton.Icon>
</AppBarButton>

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

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

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

설명

ImageIconSource는 ImageIcon과 유사합니다. 그러나 FrameworkElement가 아니므로 공유할 수 있습니다.

생성자

ImageIconSource()

ImageIconSource 클래스의 새 인스턴스를 초기화합니다.

속성

Dispatcher	항상 Windows 앱 SDK 앱에서 를 반환 null 합니다. 대신 DispatcherQueue 를 사용합니다. (다음에서 상속됨 DependencyObject)
DispatcherQueue	DispatcherQueue 이 개체가 연결된 을 가져옵니다. 는 DispatcherQueue 코드가 비 UI 스레드에 의해 시작되는 경우에도 UI 스레드에서 에 액세스할 DependencyObject 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject)
Foreground	컨트롤의 전경색을 그리는 브러시를 가져오거나 설정합니다. (다음에서 상속됨 IconSource)
ImageSource	아이콘 원본으로 사용할 이미지 파일의 URI를 가져오거나 설정합니다.
ImageSourceProperty	ImageSource 종속성 속성을 나타냅니다.

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. (다음에서 상속됨 DependencyObject)
CreateIconElement()	아이콘 UI 요소를 만듭니다. (다음에서 상속됨 IconSource)
CreateIconElementCore()	아이콘 UI 요소를 만듭니다. (다음에서 상속됨 IconSource)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 모든 기본 값을 반환합니다. (다음에서 상속됨 DependencyObject)
GetIconElementPropertyCore(DependencyProperty)	IconSource 속성을 IconElementProperties에 매핑합니다. (다음에서 상속됨 IconSource)
GetValue(DependencyProperty)	DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject instance 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. (다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject에서 종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다. (다음에서 상속됨 DependencyObject)

추가 정보

• IconElement
• AppBarButton
• Image
• UWP 앱용 아이콘