Aracılığıyla paylaş

RenderOptions.ClearTypeHint İliştirilmiş Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Media
Bütünleştirilmiş Kod:
PresentationCore.dll

İşleme altyapısına metnin ClearType ile işlenip işlenemeyeceğini belirten bir değer alır veya ayarlar.

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

Örnekler

Aşağıdaki örnekte özelliğin görsel ağacının ClearTypeHint farklı dallarını nasıl etkilediği gösterilmektedir. İlk metin bloğu denetiminde, metin bloğu ayarı ana pencereden devraldığından metin ClearType ile işlenir. İkinci metin bloğunda, üst öğenin OpacityMask özelliği ayarlandığından ClearType kullanılmaz. Üçüncü metin bloğunda ClearTypeHint kullanılır, ancak işleme sorunları oluşabilir.

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

Açıklamalar

Metnin görsel ağacının ClearTypeHint belirli bir bölümünde ClearType ile işlenebileceğini belirtmek için ekli özelliğini kullanın.

ClearType metni, tamamen opak olmayan bir arka planda doğru görüntülenmez. , OpacityMask, , , DrawingBrushVisualBrushClipve Opacitygibi Effectara işleme hedefleri, tamamen opak olmayan arka planlar oluşturabilir. WPF, metnin çizildiği arabelleğin saydam bir arka plana sahip olabileceğini algıladığında ClearType'ı devre dışı bırakır.

Bir alt ağacın ClearTypeHint ClearType metin işleme için güvenli olduğunu belirtmek için özelliğini Enabled olarak ayarlayın. Bunu yalnızca metnin tamamen donuk bir arka plana işlendiğinden emin olabileceğiniz durumlarda yapın. Alt ağaçtaki bir öğe saydamlık sağladığında ClearType'ı etkinleştirebilirsiniz; ancak işleme sorunları oluşabilir. Alt ağacının bir bölümünde daha fazla ara işleme hedefi varsa, bu alt ağacının alt öğelerini yeniden ayarlamanız ClearTypeHint gerekir.

Aşağıdaki listede ClearType ile işlenecek metnin doğru göründüğünden nasıl emin olunacağı gösterilmektedir.

  • Ile ClearType ile işlenecek metin arasında ClearTypeHint ara işleme hedeflerini tanıtmayın.

  • Görsel ağaçta metne olabildiğince yakın, opak bir arka plan atayın.

  • Bir alt ağaç için ClearType'ı yeniden etkinleştirdiğini ClearTypeHint unutmayın; ancak ClearType işlemesini zorlamaz.

  • Sistem ayarlarınızı veya TextRenderingMode ayarlarınızı geçersiz kılmadığını unutmayınClearTypeHint.

Not

ClearTypeHint Ekli özellik denetimi etkilemezTextBox; ancak denetimle TextBlock çalışır.

Not

Birçok denetimde ClearTypeHint , metnin arkasında opak bir arka plan ayarlamadığınız sürece ekli özelliğin hiçbir etkisi olmaz.

Kodda bu özelliğe erişmek için ve SetClearTypeHint yöntemlerini kullanınGetClearTypeHint.

Şunlara uygulanır