RenderOptions.ClearTypeHint 연결된 속성

  • 참조

정의

네임스페이스:
System.Windows.Media
어셈블리:
PresentationCore.dll

텍스트를 ClearType으로 렌더링할 수 있는지 여부를 렌더링 엔진에 알려 주는 값을 가져오거나 설정합니다.

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

예제

다음 예제에서는 속성 시각적 트리의 다른 분기에 영향을 미치는 방법을 ClearTypeHint 보여 줍니다. 첫 번째 텍스트 블록 컨트롤에서는 텍스트 블록이 주 창에서 설정을 상속하므로 ClearType으로 텍스트를 렌더링합니다. 두 번째 텍스트 블록에서는 부모 요소의 OpacityMask 속성이 설정되었기 때문에 ClearType이 사용되지 않습니다. 세 번째 텍스트 블록 ClearTypeHint 에서 사용되지만 렌더링 문제가 발생할 수 있습니다.

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

설명

ClearTypeHint 연결된 속성을 사용하여 시각적 트리의 특정 부분에서 ClearType으로 텍스트를 렌더링할 수 있음을 나타냅니다.

ClearType 텍스트가 완전히 불투명하지 않은 배경에 올바르게 표시되지 않습니다. 중간 렌더링 대상(예: Effect, OpacityMask, VisualBrush, DrawingBrushClip및Opacity)은 완전히 불투명하지 않은 배경을 도입할 수 있습니다. WPF는 텍스트가 그려지는 버퍼에 투명한 배경이 있을 수 있음을 감지하면 ClearType을 사용하지 않도록 설정합니다.

ClearTypeHint 하위 트리가 ClearType 텍스트 렌더링에 안전함을 나타내도록 Enabled 속성을 설정합니다. 텍스트가 완전히 불투명한 배경으로 렌더링되고 있는지 확신할 수 있는 경우에만 이 작업을 수행합니다. 하위 트리의 요소에서 투명도가 도입되면 ClearType을 사용하도록 설정할 수 있습니다. 그러나 렌더링 문제가 발생할 수 있습니다. 하위 트리의 일부가 더 많은 중간 렌더링 대상을 도입하는 경우 해당 하위 트리의 자식에 다시 설정 ClearTypeHint 해야 합니다.

다음 목록에서는 ClearType을 사용하여 렌더링할 텍스트가 올바르게 표시되는지 확인하는 방법을 보여 줍니다.

  • ClearType을 사용하여 렌더링할 텍스트 간에 ClearTypeHint 중간 렌더링 대상을 도입하지 마세요.

  • 시각적 트리에서 가능한 한 가까운 불투명 배경을 텍스트에 할당합니다.

  • ClearTypeHint 하위 트리에 대해 ClearType을 다시 사용하도록 설정해야 하지만 ClearType 렌더링을 강제하지는 않습니다.

  • ClearTypeHint 시스템 설정 또는 TextRenderingMode 설정을 재정의하지 않습니다.

참고

연결된 속성은 ClearTypeHint 컨트롤에 TextBox 영향을 주지 않지만 컨트롤에서 TextBlock 작동합니다.

참고

여러 컨트롤 ClearTypeHint 에서 텍스트 뒤에 불투명 배경을 설정하지 않으면 연결된 속성이 적용되지 않습니다.

코드에서 이 속성에 액세스하려면 해당 및 SetClearTypeHint 메서드를 GetClearTypeHint 사용합니다.

적용 대상