TextBlock.Text 속성

2013-12-13

TextBlock의 텍스트 콘텐츠를 가져오거나 설정합니다.

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

‘선언
Public Property Text As String
<TextBlock>string</TextBlock>
<TextBlock Text="string"/>

속성 값

형식: System.String
TextBlock의 텍스트 콘텐츠를 지정하는 문자열입니다.
기본값은 빈 문자열입니다.

종속성 속성 식별자 필드: TextProperty

TextBlock 개체는 Windows Phone 응용프로그램에서 텍스트를 표시하는 기본 텍스트 요소입니다.

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

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

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

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

TextBlock에서 텍스트를 설정할 때 XAML에서 Text 속성을 명시적으로 지정할 필요가 없습니다. 다음 예제와 같이 TextBlock 컨테이너에 텍스트를 콘텐츠 또는 내부 텍스트로 배치할 수 있습니다.

<TextBlock>Hello, world!</TextBlock>
참고참고:

Text 속성을 설정할 때 선행 공백이나 후행 공백이 유지되지 않습니다.

다음 XAML 예제에서는 TextBlock 요소를 정의하고 Text 속성을 문자열로 설정하는 방법을 보여 줍니다.

<TextBlock Text="Hello, world!" />

다음 그림에서는 앞의 XAML 콘텐츠 예제의 결과를 보여 줍니다.

예제 결과

"Hello, world!" textblock.

Windows Phone OS

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

Windows Phone

표시:
© 2014 Microsoft