TaskbarItemInfo.ThumbnailClipMargin Propriété

Définition

Espace de noms:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Obtient ou définit une valeur qui spécifie la partie de la zone cliente de la fenêtre d'application qui est affichée dans la miniature de la barre des tâches.

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

Valeur de propriété

Thickness

Valeur qui spécifie la partie de la zone cliente de la fenêtre d'application qui est affichée dans la miniature de la barre des tâches. La valeur par défaut correspond à une Thickness vide.

Exemples

L’exemple suivant montre comment créer un TaskbarItemInfo balisage et définir la ThumbnailClipMargin propriété. Cet exemple fait partie d’un exemple plus grand fourni pour la TaskbarItemInfo classe.

<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>

Remarques

Par défaut, la barre des tâches Windows 7 affiche une miniature mise à l’échelle de la zone cliente d’une fenêtre d’application. Vous pouvez définir la ThumbnailClipMargin propriété pour spécifier une zone rognée de la fenêtre cliente affichée dans la miniature. Par exemple, cette propriété est utile si vous souhaitez concentrer la miniature sur le contenu de la fenêtre pendant que vous excluez les barres d’outils de l’application. Cette propriété ne peut pas être utilisée pour afficher du contenu dans la miniature qui n’est pas déjà visible dans la fenêtre de l’application.

Vous spécifiez la zone affichée dans la miniature en définissant la Thickness bordure autour de la zone. La bordure commence au bord de la fenêtre cliente et s’étend vers l’intérieur par la quantité spécifiée. Le contenu à l’intérieur de la bordure s’affiche dans la miniature.

L’illustration suivante montre les bordures qui définissent le ThumbnailClipMargin.

Bordure de marge de découpage miniature

L’illustration suivante montre l’aperçu miniature clippé.

aperçu de la barre des tâches Windows