Run 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
서식이 지정되거나 서식이 지정되지 않은 텍스트의 개별 섹션을 나타냅니다.
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 : InlinePublic NotInheritable Class Run
Inherits Inline<Run .../>
-or-
<Run ...>text</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 앱에서 를 반환 |
| DispatcherQueue |
|
| 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) |
메서드
이벤트
| AccessKeyDisplayDismissed |
액세스 키 시퀀스가 완료되어 액세스 키 시각적 개체를 숨겨야 한다는 것을 컨트롤에 알릴 때 발생합니다. (다음에서 상속됨 TextElement) |
| AccessKeyDisplayRequested |
액세스 키 시퀀스가 액세스 키 시각적 개체를 표시해야 한다는 것을 컨트롤에 알리기 시작할 때 발생합니다. (다음에서 상속됨 TextElement) |
| AccessKeyInvoked |
사용자가 액세스 키 시퀀스를 완료하여 요소에 액세스 키 동작을 호출해야 한다고 알릴 때 발생합니다. (다음에서 상속됨 TextElement) |
적용 대상
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기