정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

TextBlock.Inlines 속성

2013-12-13

TextBlock 내에 있는 인라인 텍스트 요소의 컬렉션을 가져옵니다.

Namespace:  System.Windows.Controls
어셈블리:  System.Windows(System.Windows.dll)
XMLNS for XAML: xmlns에 매핑되지 않습니다.

public InlineCollection Inlines { get; }
<TextBlock
  oneOrMoreInlineElements
</TextBlock>

XAML 값

oneOrMoreInlineElements

Inline에서 파생되는 클래스에 대한 하나 이상의 개체 요소입니다. 일반적으로 이러한 요소는 Windows Phone 클래스 Run 또는 LineBreak입니다.

속성 값

형식: System.Windows.Documents.InlineCollection
TextBlock의 모든 인라인 텍스트 요소가 들어 있는 컬렉션입니다.
기본값은 빈 컬렉션입니다.

InlineCollectionRemove 또는 RemoveAt 메서드를 사용하여 기존 컬렉션에서 요소를 제거할 수 있습니다.

Item 속성을 사용하여 기존 컬렉션의 요소에 액세스하거나 Clear 메서드를 호출하여 전체 컬렉션을 지울 수 있습니다.

TextBlock에는 두 가지 개체 모델이 있는 것으로 볼 수 있습니다.

  • 문자열 콘텐츠만 나타내는 Text 속성을 통한 표현입니다. 이 텍스트에는 TextBlock 수준에서 선언된 서식을 제외하면 어떠한 서식도 포함되지 않습니다.

  • InlineCollection을 통한 표현입니다. 이 컬렉션에는 FontSize 등의 자체 서식 속성을 각각 선언할 수 있는 Run 개체가 주로 들어 있습니다. Text 속성은 값(InlineCollection에서 모든 Run 요소에 추가된 텍스트)을 반환하지만 Run 요소에 적용된 서식은 반환된 값에 포함되지 않습니다. InlineCollection이 XAML에서 TextBlock 개체 요소의 내부 텍스트로 생성되거나 Text 속성을 설정하여 생성되는 경우 InlineCollection에는 해당 텍스트를 포함하는 단일 Run이 있습니다.

개체 모델을 사용하여 작업할 수 있습니다. 하지만 텍스트가 InlineCollection의 개별 서식이 지정된 일련의 텍스트 요소로 이루어져 있고 Text 값에 추가하여 텍스트를 수정하는 경우 이전 InlineCollection 콘텐츠의 서식을 제거하고 새 텍스트와 함께 서식이 없는 단일 Run으로 교체합니다.

TextBlock에는 내부 텍스트와 인라인 요소가 함께 포함될 수 있습니다. 이러한 경우 각 내부 텍스트 섹션이 TextBlock의 순수한 내부 텍스트로 유지되지 않고 구문 분석되어 Run으로 변환됩니다. 이러한 동작으로 인해 내부 텍스트와 자식 요소를 자유롭게 혼합할 수 있습니다. 이는 일반적으로 XAML에서 허용되지 않습니다. TextBlock의 내부 텍스트는 TextBlock의 모든 자식 요소 앞이나 뒤에 나타날 수 있으며 여러 내부 텍스트 블록을 여러 자식 요소와 혼합할 수 있습니다.

TextBlock 콘텐츠를 구문 분석할 때 암시적으로 InlineCollection이 만들어집니다. XAML에서 TextBlock.Inlines를 명시적 속성 요소로 설정할 수 있습니다. 그러나 XML 공백도 TextBlock의 콘텐츠가 될 수 있는 것으로 해석되며 콘텐츠가 감지될 경우 파서가 해당 콘텐츠를 초기 Run으로 사용하여 암시적 InlineCollection으로 채웁니다. 이 속성은 설정하지 않는 것이 좋으므로 구문 섹션에는 속성 요소 구문이 나와 있지 않습니다. 이 속성을 설정한 후 TextBlock.Inlines를 정의하면 Inlines를 두 번 설정하려는 것으로 해석됩니다. 따라서 TextBlock.Inlines를 속성 요소로 지정할 때는 TextBlock 개체 요소와 TextBlock.Inlines 속성 요소 사이에 공백이 없어야 합니다.

Inlines에 대한 XAML 구문은 암시적 컬렉션 구문을 보여 주는 예이며, 여기에서 실제 InlineCollection 개체 요소를 생략할 수 있습니다. 대신 하나 이상의 인라인 형식(RunLineBreak 요소)을 TextBlock의 자식 요소로 포함합니다 인라인 요소의 암시적 컬렉션 구문 이외에도 TextBlock에서는 콘텐츠를 내부 텍스트로 지정하거나 문자열을 사용하여 Text 값을 설정하여 콘텐츠를 지정할 수도 있습니다. 자세한 내용은 TextBlock 클래스 설명을 참조하세요.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시: