RenderOptions.ClearTypeHint Ansluten egenskap

Definition

Namnområde:
System.Windows.Media
Sammansättning:
PresentationCore.dll

Hämtar eller anger ett värde som anger för återgivningsmotorn om text kan återges med ClearType.

see GetClearTypeHint, and SetClearTypeHint
see GetClearTypeHint, and SetClearTypeHint
see GetClearTypeHint, and SetClearTypeHint

Exempel

I följande exempel visas hur egenskapen ClearTypeHint påverkar olika grenar i det visuella trädet. I den första textblockkontrollen återges text med ClearType eftersom textblocket ärver inställningen från huvudfönstret. I det andra textblocket används inte ClearType eftersom det överordnade elementets egenskap har angetts OpacityMask . I det tredje textblocket ClearTypeHint används, men renderingsproblem kan uppstå.

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

Kommentarer

Använd den ClearTypeHint bifogade egenskapen för att ange att text kan återges med ClearType i en specifik del av det visuella trädet.

ClearType-text visas inte korrekt i en bakgrund som inte är helt ogenomskinlig. Mellanliggande återgivningsmål, till exempel Effect, OpacityMask, VisualBrushDrawingBrush, Clipoch Opacity, kan introducera bakgrunder som inte är helt ogenomskinliga. WPF inaktiverar ClearType när den identifierar att bufferten som texten ritas till kan ha en transparent bakgrund.

Ange egenskapen ClearTypeHint till Enabled för att ange att ett underträd är säkert för ClearType-textåtergivning. Gör detta bara när du kan vara säker på att texten återges till en helt ogenomskinlig bakgrund. När ett element i underträdet introducerar transparens kan du aktivera ClearType. Renderingsproblem kan dock uppstå. Om en del av underträdet introducerar fler mellanliggande renderingsmål måste du ange ClearTypeHint igen på underordnade i det underträdet.

I följande lista visas hur du ser till att texten som ska återges med ClearType visas korrekt.

  • Introducera inte mellanliggande återgivningsmål mellan ClearTypeHint och texten som ska återges med ClearType.

  • Tilldela en ogenomskinlig bakgrund som är så nära texten som möjligt i det visuella trädet.

  • Tänk på att ClearTypeHint återaktivering av ClearType för ett underträd, men det tvingar inte ClearType-återgivning.

  • Tänk på att ClearTypeHint inte åsidosätter systeminställningarna TextRenderingMode .

Note

Den ClearTypeHint anslutna egenskapen påverkar TextBox inte kontrollen, men den fungerar med TextBlock kontrollen.

Note

På många kontroller har den ClearTypeHint bifogade egenskapen ingen effekt om du inte anger en ogenomskinlig bakgrund bakom texten.

Använd metoderna och GetClearTypeHint för att komma åt den här egenskapen i kodSetClearTypeHint.

Gäller för