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

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

예외

InvalidOperationException

Windows Forms 애플리케이션에서 첫 번째 창을 만들기 전에만 이 메서드를 호출할 수 있습니다.

예제

Important

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

UseCompatibleTextRendering 속성은 TextRenderer 클래스를 사용하여 텍스트를 렌더링하는 Windows Forms 컨트롤과 Graphics 클래스를 사용하여 사용자 지정 텍스트 렌더링을 수행하는 앱 간의 시각적 호환성을 제공하기 위한 것입니다. 대부분의 경우 기본값UseCompatibleTextRendering으로 설정하는 것이 false 좋습니다.

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

Windows Forms 코드가 Internet Explorer 같은 다른 애플리케이션에서 호스트되는 경우 이 메서드를 호출해서는 안 됩니다. 독립 실행형 Windows Forms 애플리케이션에서만 이 메서드를 호출합니다.

적용 대상

추가 정보