RenderOptions.ClearTypeHint Propriété attachée

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Obtient ou définit une valeur qui indique au moteur de rendu si le texte peut être rendu avec ClearType.

see GetClearTypeHint, and SetClearTypeHint

see GetClearTypeHint, and SetClearTypeHint

see GetClearTypeHint, and SetClearTypeHint

Exemples

L’exemple suivant montre comment la ClearTypeHint propriété affecte différentes branches de l’arborescence visuelle. Dans le premier contrôle de bloc de texte, le texte est affiché avec ClearType, car le bloc de texte hérite du paramètre de la fenêtre principale. Dans le deuxième bloc de texte, ClearType n’est pas utilisé, car la propriété de l’élément OpacityMask parent est définie. Dans le troisième bloc de texte, ClearTypeHint est utilisé, mais des problèmes de rendu peuvent se produire.

<Window x:Class="ClearTypeHintDemo.Window1"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Window1" Height="300" Width="300"
        AllowsTransparency="True"
        WindowStyle="None"
        RenderOptions.ClearTypeHint="Enabled"
        Background="White">
    <Window.Resources>
        <LinearGradientBrush x:Key="opacityBrush" >
            <GradientStop Color="#FF000000" Offset="0.0" />
            <GradientStop Color="#00000000" Offset="1.0" />
        </LinearGradientBrush>
    </Window.Resources>

    <StackPanel>
        <TextBlock Text="This text is rendered with ClearType." />
        <StackPanel OpacityMask="{StaticResource opacityBrush}" >
            <TextBlock Text="This text is not rendered with ClearType." />
            <TextBlock RenderOptions.ClearTypeHint="Enabled"
                       Text="This text is rendered with ClearType but may alpha-blend incorrectly." />
        </StackPanel>
    </StackPanel>
</Window>

Remarques

Utilisez la ClearTypeHint propriété jointe pour indiquer que le texte peut être rendu avec ClearType dans une partie spécifique de l’arborescence visuelle.

Le texte ClearType ne s’affiche pas correctement sur un arrière-plan qui n’est pas entièrement opaque. Les cibles de rendu intermédiaires, telles que Effect, VisualBrushOpacityMask, DrawingBrush, Clip, et Opacity, peuvent introduire des arrière-plans qui ne sont pas entièrement opaques. WPF désactive ClearType lorsqu’il détecte que la mémoire tampon dans laquelle le texte est dessiné peut avoir un arrière-plan transparent.

Définissez la propriété Enabled sur pour indiquer qu’une sous-arborescence est sécurisée pour le ClearTypeHint rendu de texte ClearType. Effectuez cette opération uniquement lorsque vous pouvez être certain que le texte est restitué sur un arrière-plan entièrement opaque. Lorsqu’un élément de la sous-arborescence introduit la transparence, vous pouvez activer ClearType ; Toutefois, des problèmes de rendu peuvent se produire. Si une partie de la sous-arborescence introduit davantage de cibles de rendu intermédiaires, vous devez définir ClearTypeHint à nouveau sur les enfants de cette sous-arborescence.

La liste suivante montre comment s’assurer que le texte à afficher avec ClearType s’affiche correctement.

• N’introduisez pas de cibles de rendu intermédiaires entre ClearTypeHint et le texte à afficher avec ClearType.

• Affectez au texte un arrière-plan opaque aussi proche que possible de l’arborescence visuelle.

• N’oubliez pas que ClearTypeHint réactive ClearType pour une sous-arborescence; toutefois, elle ne force pas le rendu ClearType.

• N’oubliez pas que ClearTypeHint ne remplace pas vos paramètres système ou TextRenderingMode paramètres.

Notes

La ClearTypeHint propriété jointe n’affecte pas le TextBox contrôle ; toutefois, elle fonctionne avec le TextBlock contrôle.

Notes

Sur de nombreux contrôles, la ClearTypeHint propriété jointe n’a aucun effet, sauf si vous définissez un arrière-plan opaque derrière le texte.

Pour accéder à cette propriété dans le code, utilisez les GetClearTypeHint méthodes et SetClearTypeHint .