다음을 통해 공유

Application.SetCompatibleTextRenderingDefault(Boolean) 메서드

  • 참조

정의

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

특정 컨트롤에 정의된 속성에 UseCompatibleTextRendering 대한 애플리케이션 전체 기본값을 설정합니다.

public:
 static void SetCompatibleTextRenderingDefault(bool defaultValue);
public static void SetCompatibleTextRenderingDefault (bool defaultValue);
static member SetCompatibleTextRenderingDefault : bool -> unit
Public Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)

매개 변수

defaultValue
Boolean

새 컨트롤에 사용할 기본값입니다. 이면 true를 지원하는 UseCompatibleTextRendering 새 컨트롤이 텍스트 렌더링에 GDI+ 기반 Graphics 클래스를 사용합니다. 이면 false새 컨트롤은 GDI 기반 TextRenderer 클래스를 사용합니다.

예외

InvalidOperationException

Windows Forms 애플리케이션에서 첫 번째 창이 만들어진 후에 이 메서드를 호출한 경우

예제

중요

Visual Basic 2005 이상에서 의 기본값을 UseCompatibleTextRendering 설정하려면 을 참조하세요 WindowsFormsApplicationBase.UseCompatibleTextRendering.

C# 앱의 경우 Visual Studio는 Program.cs 파일에서 에 대한 호출 SetCompatibleTextRenderingDefault 을 자동으로 추가합니다. 텍스트 렌더링 기본값을 변경하려면 생성된 코드를 수정합니다.

static class Program
{
    /// <summary>
    /// The main entry point for the application.
    /// </summary>
    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        Application.Run(new Form1());
    }
}

설명

특정 Windows Forms 컨트롤은 GDI 그래픽 라이브러리를 기반으로 하는 클래스 또는 Graphics GDI+ 그래픽 라이브러리를 기반으로 하는 클래스를 사용하여 TextRenderer 텍스트를 렌더링할 수 있습니다. 이 변경 내용은 GDI+의 성능 및 지역화 문제로 인해 .NET Framework 2.0에서 수행되었습니다. 를 사용하여 SetCompatibleTextRenderingDefault 해당 속성을 지원하는 컨트롤에 UseCompatibleTextRendering 대한 속성의 기본값을 설정합니다.

속성은 UseCompatibleTextRendering 클래스를 사용하여 텍스트를 렌더링하는 Windows Forms 컨트롤과 클래스를 사용하여 TextRenderer 사용자 지정 텍스트 렌더링을 Graphics 수행하는 앱 간의 시각적 호환성을 제공하기 위한 것입니다. 대부분의 경우 애플리케이션이 .NET Framework 1.0 또는 .NET Framework 1.1에서 업그레이드되지 않는 경우 를 기본값false으로 설정하는 것이 UseCompatibleTextRendering 좋습니다.

GDI 기반 TextRenderer 클래스는 .NET Framework 2.0에서 도입되어 성능을 향상시키고, 텍스트를 더 잘 보이게 하고, 국제 글꼴에 대한 지원을 개선했습니다. 이전 버전의 .NET Framework GDI+ 기반 Graphics 클래스는 모든 텍스트 렌더링을 수행하는 데 사용되었습니다. GDI는 문자 간격 및 단어 래핑을 GDI+와 다르게 계산합니다. 사용 하는 Windows Forms 애플리케이션을 Graphics 텍스트를 렌더링 하는 클래스를 사용 하는 컨트롤의 텍스트 발생할 수 있습니다 TextRenderer 애플리케이션의 다른 텍스트와에서 다르게 표시 합니다. 이 비호환성을 resolve 위해 속성을 true로 UseCompatibleTextRendering 설정할 수 있습니다. 애플리케이션에서 지원되는 모든 컨트롤에 대해 로 설정 UseCompatibleTextRenderingtrue 하려면 인수true를 SetCompatibleTextRenderingDefault 사용하여 메서드를 호출합니다.

Windows Forms 코드는 Internet Explorer와 같은 다른 애플리케이션에서 호스팅되는 경우이 메서드는 호출 하지 말아야 합니다. 만 독립 실행형 Windows Forms 애플리케이션에서이 메서드를 호출 합니다.

적용 대상

추가 정보