TaskbarItemInfo.ThumbnailClipMargin 属性

定义

命名空间:

System.Windows.Shell

程序集:

PresentationFramework.dll

获取或设置一个值，该值指定在任务栏缩略图中显示的应用程序窗口工作区的一部分。

public:
 property System::Windows::Thickness ThumbnailClipMargin { System::Windows::Thickness get(); void set(System::Windows::Thickness value); };

public System.Windows.Thickness ThumbnailClipMargin { get; set; }

member this.ThumbnailClipMargin : System.Windows.Thickness with get, set

Public Property ThumbnailClipMargin As Thickness

属性值

Thickness

一个值，该值指定在任务栏缩略图中显示的应用程序窗口工作区的一部分。 默认值为空 Thickness。

示例

以下示例演示如何在标记中创建 TaskbarItemInfo 并设置 ThumbnailClipMargin 属性。 此示例是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>

注解

默认情况下，Windows 7 任务栏显示应用程序窗口工作区的缩放缩略图。 可以设置该 ThumbnailClipMargin 属性以指定显示在缩略图中的客户端窗口的裁剪区域。 例如，如果要在排除应用程序工具栏时将缩略图放在窗口内容上，则此属性非常有用。 此属性不能用于显示应用程序窗口中尚未可见的缩略图中的内容。

通过设置 Thickness 区域周围的边框来指定缩略图中显示的区域。 边框从客户端窗口的边缘开始，并按指定量向内扩展。 边框内的内容显示在缩略图中。

下图显示了定义这一点的 ThumbnailClipMargin边框。

缩略图剪辑边距边框

下图显示了剪裁的缩略图预览。

Windows 任务栏缩略图预览