TaskbarItemInfo.Overlay 속성

정의

네임스페이스:

System.Windows.Shell

어셈블리:

PresentationFramework.dll

작업 표시줄 단추의 프로그램 아이콘 위에 표시되는 이미지를 가져오거나 설정합니다.

public:
 property System::Windows::Media::ImageSource ^ Overlay { System::Windows::Media::ImageSource ^ get(); void set(System::Windows::Media::ImageSource ^ value); };

public System.Windows.Media.ImageSource Overlay { get; set; }

member this.Overlay : System.Windows.Media.ImageSource with get, set

Public Property Overlay As ImageSource

속성 값

ImageSource

작업 표시줄 단추의 프로그램 아이콘 위에 표시되는 이미지입니다. 기본값은 null입니다.

예제

다음 예제에서는 태그에서 만들고 TaskbarItemInfo 속성을 설정 하는 방법을 보여 줍니다 Overlay . 이 예제는 클래스에 제공된 더 큰 예제의 TaskbarItemInfo 일부입니다.

<Window.TaskbarItemInfo>
    <TaskbarItemInfo x:Name="taskBarItemInfo1" 
                     Overlay="{StaticResource ResourceKey=StopImage}"
                     ThumbnailClipMargin="80,0,80,140"
                     Description="Taskbar Item Info Sample">
        <TaskbarItemInfo.ThumbButtonInfos>
            <ThumbButtonInfoCollection>
                <ThumbButtonInfo
                    DismissWhenClicked="False"
                    Command="MediaCommands.Play"
                    CommandTarget="{Binding ElementName=btnPlay}"
                    Description="Play"
                    ImageSource="{StaticResource ResourceKey=PlayImage}"/>
                <ThumbButtonInfo
                    DismissWhenClicked="True"
                    Command="MediaCommands.Stop"
                    CommandTarget="{Binding ElementName=btnStop}"
                    Description="Stop"
                    ImageSource="{StaticResource ResourceKey=StopImage}"/>
            </ThumbButtonInfoCollection>
        </TaskbarItemInfo.ThumbButtonInfos>
    </TaskbarItemInfo>
</Window.TaskbarItemInfo>

다음 예제에서는 코드에서 속성을 설정하는 Overlay 방법을 보여줍니다.

this.taskBarItemInfo1.Overlay = (DrawingImage)this.FindResource("StopImage");

Me.taskBarItemInfo1.Overlay = Me.FindResource("StopImage")

설명

작업 표시줄 단추의 프로그램 아이콘에 이미지를 추가하여 애플리케이션 상태를 사용자에게 전달할 수 있습니다. 오버레이는 작업 표시줄 단추에서 아이콘의 오른쪽 아래 모서리 위에 배치되는 정적 또는 애니메이션 ImageSource 효과를 사용합니다. 사용자가 작업 표시줄에 작은 아이콘을 표시하도록 설정하면 오버레이가 표시되지 않습니다.

작업 표시줄의 맨 오른쪽에 있는 알림 영역의 프로그램 아이콘은 일반적으로 애플리케이션 상태를 사용자에게 전달하는 데 사용됩니다. Windows 7에서는 알림 영역의 프로그램 아이콘이 기본적으로 숨겨지므로 상태를 전달하는 데 유용하지 않습니다. Windows 7의 작업 표시줄 단추 오버레이를 사용하여 알림 영역의 아이콘이 숨겨져 있을 때 상태를 전달할 수 있습니다. 애플리케이션은 Windows 버전을 검색하고 운영 체제에 적합한 방식으로 알림을 제공할 수 있습니다.

오버레이 이미지는 적절한 크기로 렌더링됩니다. 해당 비트 ImageSource 깊이를 Icon나타내는 경우 적절한 비트 깊이도 사용됩니다.

다음 그림에서는 작업 표시줄 Overlay을 보여 줍니다.

Windows 작업 표시줄 오버레이

추가 정보

• Version
• OSVersion