TextElement 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
public ref class TextElement : DependencyObject/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class TextElement : DependencyObjectPublic Class TextElement
Inherits DependencyObject- 상속
- 파생
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
설명
TextElement에서 정의한 다양한 속성은 XAML 텍스트 개체 모델과 관련된 클래스에 대한 공통 API를 지원합니다. 다음은 가장 일반적으로 사용되는 속성 목록입니다.
TextElement 속성을 설정하면 블록과 인라인 모두에서 일반 텍스트 서식 속성을 텍스트에 적용할 수 있습니다. 텍스트 서식을 지정하는 추가 방법도 있지만 TextElement에서 직접 지원하지는 않습니다. 대신 Typography 클래스의 연결된 속성을 사용할 수 있습니다. 입력 체계 연결 속성은 일반적으로 모든 글꼴에서 반드시 지원되지 않는 글꼴 수준에서 정의된 입력 기능에 액세스하는 것과 같은 고급 입력 기능 또는 규칙을 지원합니다. 예를 들어 모든 텍스트 블록 또는 인라인에서 Typography.Variants 를 연결된 속성으로 설정할 수 있으며, 이는 해당 텍스트 요소에서 FontFamily 를 설정하기 위해 선택한 특정 글꼴에서 사용하도록 설정된 글꼴 변형 동작에 영향을 줍니다.
TextElement는 기본적으로 XAML 시각적 트리에 대한 연결점을 정의하지 않습니다. 즉, TextElement는 해당 텍스트 내에서 텍스트 및 텍스트 개체 모델을 정의하지만 아직 UI 내에서 해당 텍스트를 표시할 수 없습니다. 이를 위해 UIElement 의 하위 항목이며 XAML 트리 및 앱 창의 루트 시각적 개체에 연결할 수 있는 컨트롤 또는 요소 중 하나를 사용해야 합니다. Windows 런타임 다음과 같은 두 가지 요소가 있습니다.
- TextBlock: Inlines 컬렉션에서만 인라인의 텍스트 개체 모델을 지원합니다.
- RichTextBlock: Blocks 컬렉션을 사용하여 블록 텍스트 개체 모델을 지원합니다. 블록에는 블록과 인라인이 포함될 수 있습니다.
참고
PasswordBox, RichEditBox 및 TextBox 는 TextElement를 기반으로 하는 텍스트 개체 모델을 지원하지 않습니다. RichEditBox 는 ITextDocument 인터페이스를 통해 다른 텍스트 개체 모델에 프로그래밍 방식으로 액세스할 수 있도록 합니다.
TextElement는 XAML을 구문 분석한 후 텍스트 개체 모델을 프로그래밍 개체로 검사할 수 있도록 지원하는 API를 정의합니다. 특히 TextElement는 FrameworkElement에서 동일한 이름의 병렬 속성인 Name 및 Language를 구현합니다. 또한 TextElement는 FindName (초기 XAML에서 Name 이 설정된 방법에 따라 런타임에 개체를 찾는 유틸리티 메서드) 및 OnDisconnectVisualChildren (고급 시나리오 및 디자이너 지원용)를 구현합니다.
TextElement에는 텍스트 내에서 TextPointer 개체에 대한 액세스를 제공하는 네 가지 속성이 있습니다. 이러한 속성은 ContentStart, ContentEnd, ElementStart, ElementEnd입니다. Windows 런타임 TextPointer 개체는 콘텐츠 통과를 위한 진입점을 제공합니다. 자세한 내용은 TextPointer를 참조하세요.
TextElement는 DependencyObject에서 파생된 클래스입니다. 즉, 종속성 속성을 정의할 수 있으며 TextElement의 각 읽기-쓰기 속성은 종속성 속성이며 해당 속성 식별자도 TextElement로 정의됩니다. 종속성 속성이 사용하도록 설정하는 방법에 대한 자세한 내용은 종속성 속성 개요를 참조하세요.
TextElement 파생 클래스
TextElement는 텍스트 개체 모델을 블록 및 인라인의 두 텍스트 사용 규칙으로 분할하는 두 파생 클래스의 부모 클래스입니다. 블록 및 인라인 은 모두 기본 클래스로 간주되며(일반적으로 XAML에서 태그가 <Block> 표시되지 않음) 계층 구조에 주로 다른 실용적인 텍스트 요소의 부모 클래스로 존재합니다. 예를 들어 Block 은 Paragraph의 부모 클래스입니다. 블록 및 인라인 요소를 사용하는 방법에 대한 자세한 내용은 빠른 시작: 텍스트 표시를 참조하세요.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1607 | 14393 | AccessKey |
| 1607 | 14393 | AllowFocusOnInteraction |
| 1607 | 14393 | ExitDisplayModeOnAccessKeyInvoked |
| 1703 | 15063 | AccessKeyDisplayDismissed |
| 1703 | 15063 | AccessKeyDisplayRequested |
| 1703 | 15063 | AccessKeyInvoked |
| 1703 | 15063 | AccessKeyScopeOwner |
| 1703 | 15063 | IsAccessKeyScope |
| 1703 | 15063 | KeyTipHorizontalOffset |
| 1703 | 15063 | KeyTipPlacementMode |
| 1703 | 15063 | KeyTipVerticalOffset |
| 1703 | 15063 | TextDecorations |
| 1903 | 18362 | XamlRoot |
속성
| AccessKey |
이 요소의 액세스 키를 가져오거나 설정합니다. |
| AccessKeyProperty |
AccessKey 종속성 속성을 식별합니다. |
| AccessKeyScopeOwner |
원본 요소의 시각적 트리에 없는 경우에도 이 요소에 대한 액세스 키 scope 제공하는 원본 요소를 가져오거나 설정합니다. |
| AccessKeyScopeOwnerProperty |
AccessKeyScopeOwner 종속성 속성을 식별합니다. |
| AllowFocusOnInteraction |
사용자가 상호 작용할 때 요소가 자동으로 포커스를 받는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| AllowFocusOnInteractionProperty |
AllowFocusOnInteraction 종속성 속성을 식별합니다. |
| CharacterSpacing |
문자 사이의 균일한 간격을 1/1000 단위로 가져오거나 설정합니다. |
| CharacterSpacingProperty |
CharacterSpacing 종속성 속성을 식별합니다. |
| ContentEnd |
요소의 콘텐츠 끝을 나타내는 TextPointer 를 가져옵니다. |
| ContentStart |
요소의 콘텐츠 시작을 나타내는 TextPointer 를 가져옵니다. |
| Dispatcher |
이 개체가 연결된 CoreDispatcher 를 가져옵니다. CoreDispatcher는 코드가 비 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 |
언어 종속성 속성을 식별합니다. |
| Name |
개체에 대한 고유 ID를 가져오거나 설정합니다. 이름은 XAML의 초기 구문 분석에서만 설정할 수 있습니다. |
| TextDecorations |
텍스트에 적용되는 장식을 나타내는 값을 가져오거나 설정합니다. |
| TextDecorationsProperty |
TextDecorations 종속성 속성을 식별합니다. |
| XamlRoot |
이 요소를 볼 XamlRoot를 가져오거나 설정합니다. |
메서드
이벤트
| AccessKeyDisplayDismissed |
액세스 키 시퀀스가 완료되면 액세스 키 시각적 개체를 숨겨야 한다는 것을 컨트롤에 알릴 때 발생합니다. |
| AccessKeyDisplayRequested |
액세스 키 시퀀스가 액세스 키 시각적 개체를 표시해야 한다는 것을 컨트롤에 알리기 시작할 때 발생합니다. |
| AccessKeyInvoked |
사용자가 액세스 키 시퀀스를 완료하여 요소에 액세스 키 동작을 호출해야 한다고 알릴 때 발생합니다. |
적용 대상
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기