다음을 통해 공유


Span 클래스

정의

다른 인라인 콘텐츠 요소를 그룹화합니다. 굵게, 하이퍼링크, 기울임꼴밑줄에 대한 부모 클래스입니다.

/// [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 : Inline
Public 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은 특정 서식 규칙을 사용하여 인라인 텍스트 영역을 정의하는 여러 파생 클래스의 부모 클래스입니다.

생성자

Span()

Span 클래스의 새 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)
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)

메서드

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)

적용 대상

추가 정보