다음을 통해 공유

Window.Icon 속성

  • 참조

정의

네임스페이스:
System.Windows
어셈블리:
PresentationFramework.dll

창의 아이콘을 가져오거나 설정합니다.

public:
 property System::Windows::Media::ImageSource ^ Icon { System::Windows::Media::ImageSource ^ get(); void set(System::Windows::Media::ImageSource ^ value); };
public System.Windows.Media.ImageSource Icon { get; [System.Security.SecurityCritical] set; }
public System.Windows.Media.ImageSource Icon { get; set; }
[<set: System.Security.SecurityCritical>]
member this.Icon : System.Windows.Media.ImageSource with get, set
member this.Icon : System.Windows.Media.ImageSource with get, set
Public Property Icon As ImageSource

속성 값

ImageSource

아이콘을 나타내는 ImageSource 개체입니다.

특성
SecurityCriticalAttribute

예제

다음 예제에서는 창 아이콘을 설정하는 방법을 보여줍니다.

<Window
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.MainWindow"
    Icon="WPFIcon1.ico">
</Window>

// Set an icon using code
Uri iconUri = new Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute);
this.Icon = BitmapFrame.Create(iconUri);

' Set an icon using code
Dim iconUri As New Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute)
Me.Icon = BitmapFrame.Create(iconUri)

설명

Windows Presentation Foundation (WPF) 독립 실행형 애플리케이션에는 두 가지 유형의 아이콘이 있습니다.

  • 사용 하 여 지정 된 어셈블리 아이콘을 <ApplicationIcon> 애플리케이션의 프로젝트 속성 파일을 빌드합니다. 이 아이콘은 어셈블리의 바탕 화면 아이콘으로 사용됩니다.

    참고

    Visual Studio 디버깅할 때 호스팅 프로세스로 인해 아이콘이 표시되지 않을 수 있습니다. 실행 파일을 실행하면 아이콘이 표시됩니다. 자세한 내용은 호스팅 프로세스(vshost.exe)를 참조하세요.

  • 를 설정 Icon하여 지정한 창당 하나의 아이콘 각 창에 대 한 해당 ALT + TAB 애플리케이션 선택 목록 항목의 작업 표시줄 단추가 제목 표시줄에이 아이콘이 사용 됩니다.

WPF 창에는 항상 아이콘이 표시됩니다. 설정 Icon으로 제공되지 않는 경우 WPF는 다음 규칙에 따라 표시할 아이콘을 선택합니다.

  1. 지정된 경우 어셈블리 아이콘을 사용합니다.

  2. 어셈블리 아이콘을 지정하지 않으면 기본 Microsoft Windows 아이콘을 사용합니다.

사용 하는 경우 Icon 사용자 지정 창 아이콘을 지정 하려면 기본 애플리케이션 아이콘을 설정 하 여 복원할 수 있습니다 Icon 에 null입니다.

단일 아이콘은 창의 제목 표시줄, 창의 작업 표시줄, ALT+TAB 파일 선택 목록에 표시되는 등 Windows 다양한 방법으로 사용할 수 있습니다. 각각 다른 크기를 사용하여 아이콘을 표시합니다. 16x16 픽셀 아이콘은 창의 제목 표시줄과 작업 표시줄에 표시되고 32x32 픽셀 아이콘은 ALT+TAB 파일 선택 목록에 표시됩니다. Microsoft Windows Explorer와 같은 일부 애플리케이션에서는 보려는 아이콘의 크기를 선택할 수 있는 보기 메뉴를 제공합니다.

다양한 디스플레이 크기를 수용하기 위해 아이콘 파일은 하나 이상의 실제 아이콘으로 구성되며, 각 아이콘은 특정 크기와 색 깊이를 대상으로 하는 아이콘 버전을 나타냅니다. 예를 들어 한 아이콘에는 16가지 색이 있는 단일 16x16 픽셀 아이콘만 있을 수 있으며, 다른 아이콘에는 16x16 픽셀과 16가지 색과 256색이 모두 있는 32x32 픽셀 아이콘이 포함될 수 있습니다.

가능한 모든 크기와 색 깊이에 대한 아이콘이 아이콘 파일 Window 내에 있는 경우 적절한 아이콘을 사용합니다. 아이콘 파일에 가능한 모든 아이콘 Window 의 하위 집합만 포함된 경우 크기 및 색 깊이를 줄이기 위해 다음으로 가장 적합한 아이콘을 사용합니다.

그 결과 사용되는 아이콘이 필요한 크기와 색 깊이를 대상으로 하지 않을 수 있지만 아이콘은 항상 사용됩니다 Window. 예를 들어 16가지 색이 있는 16x16 픽셀 아이콘을 256색의 32x32 픽셀 아이콘으로 표시할 수 있습니다. 이로 인해 픽실레이션과 같은 바람직하지 않은 시각 효과가 발생할 수 있지만 모든 대상 크기와 색 깊이에 대한 아이콘을 만들어서 방지할 수 있습니다.

참고

창이 브라우저에서 호스트되는 경우 이 속성을 설정하거나 가져올 수 없습니다.

종속성 속성 정보
식별자 필드 IconProperty
메타 데이터 속성 설정 true 없음

적용 대상