Span 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
/// [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 Span : Inline[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
[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 Span : InlinePublic Class Span
Inherits Inline<Span .../>
-or-
<Span ...>
oneOrMoreInlines
</Span>
-or-
<Span ...>
mixedContent
</Span>
- 상속
- 파생
- 특성
설명
XAML에서 Span을 개체 요소로 사용하여 텍스트를 묶을 수 있습니다. 이렇게 하면 HTML에서 태그를 사용하는 방법과 비슷한 용도로 span 사용할 수 있습니다. 이 사용의 경우 TextElement 에서 지원하는 특성(예: FontSize 또는 FontFamily)을 설정하여 이러한 텍스트 서식 결정을 묶은 텍스트 범위에 적용할 수 있습니다. Run 은 텍스트 범위에 TextElement 속성을 적용하는 기능과 비슷하지만 Run 은 혼합 콘텐츠를 지원하지 않습니다( Run.Text XAML 콘텐츠 속성은 혼합 콘텐츠 및 추가 인라인이 아닌 텍스트만 포함할 수 있음).
XAML에서 콘텐츠를 설정하는 경우 Span은 혼합 콘텐츠를 지원합니다. 즉, 실행, 굵게 등과 같은 인라인 태그를 XAML 텍스트 콘텐츠(일반 텍스트)와 혼합할 수 있으며 태그와 텍스트가 표시되어야 하는 순서에는 제한이 없습니다. 일반 텍스트이든 인 라인 태그로 묶든 모든 텍스트는 텍스트가 혼합 콘텐츠에 정의된 순서대로 렌더링됩니다. 예를 들어 이는 유효한 XAML입니다.
<RichTextBlock>
<Paragraph>
<Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
</Paragraph>
</RichTextBlock>
XAML에서 혼합 콘텐츠를 구문 분석하고 런타임에 텍스트 개체 모델을 검사하면 일반 텍스트에서 온 모든 텍스트 영역은 런타임 액세스를 가능하게 하는 InlineCollection 컬렉션 클래스의 적절한 읽기 순서 위치에 Run 개체를 생성합니다. 해당 Run 요소는 텍스트를 포함하지만 그렇지 않으면 속성이 설정되지 않습니다.
참고
Span은 Inlines 속성이 XAML 콘텐츠 속성임을 표시하기 때문에 Span 요소 내에서 직접 태그 또는 텍스트가 지원되는지 여부에 관계없이 XAML 콘텐츠를 배치할 수 있습니다. XAML 콘텐츠 속성에 대한 자세한 내용은 XAML 구문 가이드의 "XAML 콘텐츠 속성" 섹션을 참조하세요.
Span 요소는 일반적으로 Paragraph의 자식 요소(Paragraph.Inlines의 일부가 됨) 또는 다른 Span 의 콘텐츠(Span.Inlines의 일부가 됨)로 InlineCollection 내의 요소로 사용됩니다.
파생 클래스 범위
Span은 특정 서식 규칙을 사용하여 인라인 텍스트 영역을 정의하는 여러 파생 클래스의 부모 클래스입니다.
- 굵게
- 하이퍼링크
- 기울임꼴
- 밑줄하이퍼링크 를 사용하면 NavigateUri로 이동하는 클릭 동작을 사용할 수 있습니다. 다른 Span 파생 클래스는 텍스트에 대한 클래스별 장식으로 간주될 수 있으며, 그렇지 않으면 상호 작용을 추가하지 않습니다.
생성자
| Span() |
Span 클래스의 새 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) |
| FontFamily |
요소 콘텐츠에 대해 기본 설정된 최상위 글꼴 패밀리를 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| FontSize |
요소의 콘텐츠에 대한 글꼴 크기를 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| FontStretch |
선택할 패밀리 글꼴의 문자 모양 너비를 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| FontStyle |
이 요소의 콘텐츠에 대한 글꼴 스타일을 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| FontWeight |
이 요소의 콘텐츠에 대한 글꼴 패밀리에서 선택할 최상위 글꼴 두께를 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| Foreground |
이 요소의 콘텐츠에 적용할 Brush 를 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| Inlines |
Span의 내용을 포함하는 최상위 인라인 요소가 포함된 InlineCollection을 가져옵니다. |
| IsAccessKeyScope |
요소가 자체 액세스 키 scope 정의하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| IsTextScaleFactorEnabled |
시스템 텍스트 크기 설정을 반영하기 위해 자동 텍스트 확대를 사용할지 여부를 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| KeyTipHorizontalOffset |
키 설명이 텍스트 요소와 관련하여 배치되는 왼쪽 또는 오른쪽의 정도를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| KeyTipPlacementMode |
Text 요소와 관련하여 KeyTip이 배치되는 위치를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| KeyTipVerticalOffset |
키 설명이 텍스트 요소와 관련하여 얼마나 위 또는 아래로 배치되는지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| Language |
TextElement에 적용되는 지역화/세계화 언어 정보를 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| Name |
개체에 대한 고유 ID를 가져오거나 설정합니다. 이름은 XAML의 초기 구문 분석에서만 설정할 수 있습니다. (다음에서 상속됨 TextElement) |
| TextDecorations |
텍스트에 적용되는 장식을 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
| XamlRoot |
이 요소를 볼 XamlRoot를 가져오거나 설정합니다. (다음에서 상속됨 TextElement) |
메서드
이벤트
| AccessKeyDisplayDismissed |
액세스 키 시퀀스가 완료되면 액세스 키 시각적 개체를 숨겨야 한다는 것을 컨트롤에 알릴 때 발생합니다. (다음에서 상속됨 TextElement) |
| AccessKeyDisplayRequested |
액세스 키 시퀀스가 액세스 키 시각적 개체를 표시해야 한다는 것을 컨트롤에 알리기 시작할 때 발생합니다. (다음에서 상속됨 TextElement) |
| AccessKeyInvoked |
사용자가 액세스 키 시퀀스를 완료하여 요소에 액세스 키 동작을 호출해야 한다고 알릴 때 발생합니다. (다음에서 상속됨 TextElement) |
적용 대상
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기