다음을 통해 공유


TextElement 클래스

정의

또한 추상 블록인라인 클래스의 기본 클래스로 사용되는 추상 클래스입니다. TextElement는 텍스트 크기, 글꼴 패밀리 등을 제어하는 속성과 같이 XAML 텍스트 개체 모델과 관련된 클래스에 대한 일반적인 API를 지원합니다.

public ref class TextElement : DependencyObject
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class TextElement : DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class TextElement : DependencyObject
Public Class TextElement
Inherits DependencyObject
상속
Object Platform::Object IInspectable DependencyObject TextElement
파생
특성

설명

TextElement에서 정의한 다양한 속성은 XAML 텍스트 개체 모델과 관련된 클래스에 대한 일반적인 API를 지원합니다. 다음은 가장 일반적으로 사용되는 속성 목록입니다.

TextElement 속성을 설정하면 블록과 인라인 모두에서 텍스트에 공통 텍스트 서식 속성을 적용할 수 있습니다. 텍스트 서식을 지정하는 추가 방법도 있지만 TextElement에서 직접 지원하지는 않습니다. 대신 Typography 클래스의 연결된 속성을 사용할 수 있습니다. 입력 체계 연결 속성은 일반적으로 모든 글꼴에서 반드시 지원되지 않는 글꼴 수준에서 정의된 입력 기능에 액세스하는 것과 같은 고급 입력 체계 기능 또는 규칙을 지원합니다. 예를 들어 Typography.Variants를 모든 텍스트 블록 또는 인라인에서 연결된 속성으로 설정할 수 있으며, 이는 해당 텍스트 요소에서 FontFamily 를 설정하기 위해 선택한 특정 글꼴에서 사용하도록 설정된 글꼴 변형 동작에 영향을 줍니다.

TextElement는 기본적으로 XAML 시각적 트리에 대한 연결점을 정의하지 않습니다. 즉, TextElement는 해당 텍스트 내에서 텍스트 및 텍스트 개체 모델을 정의하지만 UI 내에서 해당 텍스트를 표시할 수는 없습니다. 이를 위해 UIElement 의 하위 항목이며 XAML 트리 및 앱 창의 루트 시각적 개체에 연결할 수 있는 컨트롤 또는 요소 중 하나를 사용해야 합니다. Windows 런타임 다음과 같은 두 가지 요소가 있습니다.

  • TextBlock: Inlines 컬렉션에서만 인라인의 텍스트 개체 모델을 지원합니다.
  • RichTextBlock: Blocks 컬렉션을 사용하여 블록 텍스트 개체 모델을 지원합니다. 블록에는 블록과 인라인이 포함될 수 있습니다.

참고

PasswordBox, RichEditBoxTextBox 는 TextElement를 기반으로 하는 텍스트 개체 모델을 지원하지 않습니다. RichEditBoxITextDocument 인터페이스를 통해 다른 텍스트 개체 모델에 프로그래밍 방식으로 액세스할 수 있도록 합니다.

TextElement는 XAML을 구문 분석한 후 텍스트 개체 모델을 프로그래밍 개체로 검사할 수 있도록 지원하는 API를 정의합니다. 특히 TextElement는 FrameworkElement에서 동일한 이름의 병렬 속성인 NameLanguage를 구현합니다. TextElement는 또한 FindName (초기 XAML에서 Name 이 설정된 방법에 따라 런타임에 개체를 찾는 유틸리티 메서드) 및 OnDisconnectVisualChildren (고급 시나리오 및 디자이너 지원용)를 구현합니다.

TextElement에는 텍스트 내에서 TextPointer 개체에 대한 액세스를 제공하는 네 가지 속성이 있습니다. 이러한 속성은 ContentStart, ContentEnd, ElementStart, ElementEnd입니다. Windows 런타임 TextPointer 개체는 콘텐츠 순회를 위한 진입점을 제공합니다. 자세한 내용은 TextPointer를 참조하세요.

TextElement는 DependencyObject에서 파생된 클래스입니다. 즉, 종속성 속성을 정의할 수 있으며 TextElement의 각 읽기-쓰기 속성은 종속성 속성이며 해당 속성 식별자도 TextElement로 정의됩니다. 종속성 속성에서 사용할 수 있는 항목에 대한 자세한 내용은 종속성 속성 개요를 참조하세요.

TextElement 파생 클래스

TextElement는 텍스트 개체 모델을 블록인라인의 두 텍스트 사용 규칙으로 분할하는 두 파생 클래스의 부모 클래스입니다. 블록인라인 은 모두 기본 클래스로 간주되며(일반적으로 XAML에 태그가 <Block> 표시되지 않음) 계층 구조에 주로 다른 실용적인 텍스트 요소의 부모 클래스로 존재합니다. 예를 들어 BlockParagraph의 부모 클래스입니다. 블록 및 인라인 요소를 사용하는 방법에 대한 자세한 내용은 텍스트 블록을 참조하세요.

속성

AccessKey

이 요소의 액세스 키를 가져오거나 설정합니다.

AccessKeyProperty

AccessKey 종속성 속성을 식별합니다.

AccessKeyScopeOwner

원본 요소의 시각적 트리에 없는 경우에도 이 요소에 대한 액세스 키 scope 제공하는 원본 요소를 가져오거나 설정합니다.

AccessKeyScopeOwnerProperty

AccessKeyScopeOwner 종속성 속성을 식별합니다.

AllowFocusOnInteraction

사용자가 상호 작용할 때 요소가 자동으로 포커스를 가져오는지 여부를 나타내는 값을 가져오거나 설정합니다.

AllowFocusOnInteractionProperty

AllowFocusOnInteraction 종속성 속성을 식별합니다.

CharacterSpacing

문자 간의 균일한 간격을 1/1000 단위로 가져오거나 설정합니다.

CharacterSpacingProperty

CharacterSpacing 종속성 속성을 식별합니다.

ContentEnd

요소의 콘텐츠 끝을 나타내는 TextPointer 를 가져옵니다.

ContentStart

요소의 콘텐츠 시작을 나타내는 TextPointer 를 가져옵니다.

Dispatcher

항상 Windows 앱 SDK 앱에서 를 반환 null 합니다. 대신 DispatcherQueue 를 사용합니다.

(다음에서 상속됨 DependencyObject)
DispatcherQueue

DispatcherQueue 이 개체가 연결된 을 가져옵니다. 는 DispatcherQueue 코드가 비 UI 스레드에 의해 시작되더라도 UI 스레드에서 에 액세스할 DependencyObject 수 있는 기능을 나타냅니다.

(다음에서 상속됨 DependencyObject)
ElementEnd

요소의 끝 바로 뒤의 위치를 나타내는 TextPointer 를 가져옵니다.

ElementStart

요소 시작 바로 앞의 위치를 나타내는 TextPointer 를 가져옵니다.

ExitDisplayModeOnAccessKeyInvoked

액세스 키를 호출할 때 액세스 키 표시가 해제되는지 여부를 지정하는 값을 가져오거나 설정합니다.

ExitDisplayModeOnAccessKeyInvokedProperty

ExitDisplayModeOnAccessKeyInvoked 종속성 속성을 식별합니다.

FontFamily

요소 콘텐츠에 대해 기본 설정된 최상위 글꼴 패밀리를 가져오거나 설정합니다.

FontFamilyProperty

FontFamily 종속성 속성을 식별합니다.

FontSize

요소의 콘텐츠에 대한 글꼴 크기를 가져오거나 설정합니다.

FontSizeProperty

FontSize 종속성 속성을 식별합니다.

FontStretch

선택할 패밀리의 글꼴 문자 모양 너비를 가져오거나 설정합니다.

FontStretchProperty

FontStretch 종속성 속성을 식별합니다.

FontStyle

이 요소의 콘텐츠에 대한 글꼴 스타일을 가져오거나 설정합니다.

FontStyleProperty

FontStyle 종속성 속성을 식별합니다.

FontWeight

이 요소의 콘텐츠에 대한 글꼴 패밀리에서 선택할 최상위 글꼴 두께를 가져오거나 설정합니다.

FontWeightProperty

FontWeight 종속성 속성을 식별합니다.

Foreground

이 요소의 콘텐츠에 적용할 Brush 를 가져오거나 설정합니다.

ForegroundProperty

포그라운드 종속성 속성을 식별합니다.

IsAccessKeyScope

요소가 자체 액세스 키 scope 정의하는지 여부를 나타내는 값을 가져오거나 설정합니다.

IsAccessKeyScopeProperty

IsAccessKeyScope 종속성 속성을 식별합니다.

IsTextScaleFactorEnabled

시스템 텍스트 크기 설정을 반영하기 위해 자동 텍스트 확대를 사용할지 여부를 가져오거나 설정합니다.

IsTextScaleFactorEnabledProperty

IsTextScaleFactorEnabled 종속성 속성을 식별합니다.

KeyTipHorizontalOffset

키 설명이 텍스트 요소와 관련하여 배치되는 왼쪽 또는 오른쪽의 정도를 나타내는 값을 가져오거나 설정합니다.

KeyTipHorizontalOffsetProperty

KeyTipHorizontalOffset 종속성 속성을 식별합니다.

KeyTipPlacementMode

Text 요소와 관련하여 KeyTip이 배치되는 위치를 나타내는 값을 가져오거나 설정합니다.

KeyTipPlacementModeProperty

KeyTipPlacementMode 종속성 속성을 식별합니다.

KeyTipVerticalOffset

키 설명이 텍스트 요소와 관련하여 배치되는 거리를 나타내는 값을 가져오거나 설정합니다.

KeyTipVerticalOffsetProperty

KeyTipVerticalOffset 종속성 속성을 식별합니다.

Language

TextElement에 적용되는 지역화/세계화 언어 정보를 가져오거나 설정합니다.

LanguageProperty

Language 종속성 속성을 식별합니다.

Name

개체에 대한 고유 ID를 가져오거나 설정합니다. 이름은 XAML의 초기 구문 분석에서만 설정할 수 있습니다.

TextDecorations

텍스트에 적용되는 장식을 나타내는 값을 가져오거나 설정합니다.

TextDecorationsProperty

TextDecorations 종속성 속성을 식별합니다.

XamlRoot

이 요소를 볼 XamlRoot를 가져오거나 설정합니다.

메서드

ClearValue(DependencyProperty)

종속성 속성의 로컬 값을 지웁니다.

(다음에서 상속됨 DependencyObject)
FindName(String)

개체의 x:Name 또는 Name 특성 값을 참조하여 개체 모델/런타임 개체 그래프에서 개체를 검색합니다.

GetAnimationBaseValue(DependencyProperty)

애니메이션이 활성화되지 않은 경우에 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)

DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
OnDisconnectVisualChildren()

클래스별 콘텐츠 또는 자식 속성에서 항목을 제거할 때 레이아웃 및 논리가 작동하는 방식을 구현하려면 이 메서드를 재정의합니다.

ReadLocalValue(DependencyProperty)

로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

DependencyObject instance 특정 DependencyProperty에 대한 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다.

(다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)

DependencyObject에 대한 종속성 속성의 로컬 값을 설정합니다.

(다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다.

(다음에서 상속됨 DependencyObject)

이벤트

AccessKeyDisplayDismissed

액세스 키 시퀀스가 완료되어 액세스 키 시각적 개체를 숨겨야 한다는 것을 컨트롤에 알릴 때 발생합니다.

AccessKeyDisplayRequested

액세스 키 시퀀스가 액세스 키 시각적 개체를 표시해야 한다는 것을 컨트롤에 알리기 시작할 때 발생합니다.

AccessKeyInvoked

사용자가 액세스 키 시퀀스를 완료하여 요소에 액세스 키 동작을 호출해야 한다고 알릴 때 발생합니다.

적용 대상

추가 정보