다음을 통해 공유


Run 클래스

정의

서식이 지정되거나 서식이 지정되지 않은 텍스트의 개별 섹션을 나타냅니다.

public ref class Run sealed : Inline
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Text")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [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 Run final : Inline
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Text")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[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 sealed class Run : Inline
Public NotInheritable Class Run
Inherits Inline
<Run .../>
-or-
<Run ...>text</Run>
상속
Object Platform::Object IInspectable DependencyObject TextElement Inline Run
특성

예제

여기에 표시된 각 예제는 동일한 결과를 렌더링합니다. 그러나 TextBlock에서 직접 Text 속성을 설정하면 성능이 가장 좋습니다.

<!-- Set the TextBlock.Text property directy for best performance. -->
<TextBlock Text="This is some text."/>

<TextBlock><Run>This is some text.</Run></TextBlock>

<TextBlock><Run Text="This is some text."></Run></TextBlock>
// Set the TextBlock.Text property directy for best performance.
TextBlock textblock = new TextBlock();
textblock.Text = "This is some text.";

TextBlock textblock = new TextBlock();
Run run = new Run();
run.Text = "This is some text.";
textblock.Inlines.Add(run);

설명

실행은 서식이 지정되거나 서식이 지정되지 않은 텍스트의 개별 섹션을 나타내며 TextBlock 또는 RichTextBlock에서 사용할 수 있습니다. Span 내에 여러 Run 요소를 배치할 수 있습니다.

TextBlock을 사용하는 경우 최상의 성능을 위해 TextBlock.Text 속성을 직접 설정합니다. 일반적으로 TextBlock 내에서 텍스트의 개별 섹션에 서식을 지정하려는 경우에만 Run 요소를 사용합니다.

자세한 예제는 다음을 참조하세요.

생성자

Run()

Run 클래스의 새 instance 초기화합니다.

속성

AccessKey

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

(다음에서 상속됨 TextElement)
AccessKeyScopeOwner

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

(다음에서 상속됨 TextElement)
AllowFocusOnInteraction

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

(다음에서 상속됨 TextElement)
CharacterSpacing

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

(다음에서 상속됨 TextElement)
ContentEnd

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

(다음에서 상속됨 TextElement)
ContentStart

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

(다음에서 상속됨 TextElement)
Dispatcher

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

(다음에서 상속됨 DependencyObject)
DispatcherQueue

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

(다음에서 상속됨 DependencyObject)
ElementEnd

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

(다음에서 상속됨 TextElement)
ElementStart

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

(다음에서 상속됨 TextElement)
ExitDisplayModeOnAccessKeyInvoked

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

(다음에서 상속됨 TextElement)
FlowDirection

텍스트 및 기타 사용자 인터페이스 요소가 레이아웃을 제어하는 Run 요소 내에서 흐르는 방향을 가져오거나 설정합니다.

FlowDirectionProperty

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

FontFamily

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

(다음에서 상속됨 TextElement)
FontSize

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

(다음에서 상속됨 TextElement)
FontStretch

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

(다음에서 상속됨 TextElement)
FontStyle

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

(다음에서 상속됨 TextElement)
FontWeight

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

(다음에서 상속됨 TextElement)
Foreground

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

(다음에서 상속됨 TextElement)
IsAccessKeyScope

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

(다음에서 상속됨 TextElement)
IsTextScaleFactorEnabled

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

(다음에서 상속됨 TextElement)
KeyTipHorizontalOffset

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

(다음에서 상속됨 TextElement)
KeyTipPlacementMode

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

(다음에서 상속됨 TextElement)
KeyTipVerticalOffset

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

(다음에서 상속됨 TextElement)
Language

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

(다음에서 상속됨 TextElement)
Name

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

(다음에서 상속됨 TextElement)
Text

실행의 텍스트 내용을 가져오거나 설정합니다.

TextDecorations

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

(다음에서 상속됨 TextElement)
XamlRoot

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

(다음에서 상속됨 TextElement)

메서드

ClearValue(DependencyProperty)

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

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

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

(다음에서 상속됨 TextElement)
GetAnimationBaseValue(DependencyProperty)

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

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

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

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

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

(다음에서 상속됨 TextElement)
ReadLocalValue(DependencyProperty)

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

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

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

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

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

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

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

(다음에서 상속됨 DependencyObject)

이벤트

AccessKeyDisplayDismissed

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

(다음에서 상속됨 TextElement)
AccessKeyDisplayRequested

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

(다음에서 상속됨 TextElement)
AccessKeyInvoked

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

(다음에서 상속됨 TextElement)

적용 대상

추가 정보