Block 클래스

정의

모든 블록 수준 콘텐츠 요소에 대한 기본을 제공하는 추상 클래스입니다.

UWP용 동등한 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public ref class Block : TextElement
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Block : TextElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Block : TextElement
Public Class Block
Inherits TextElement
상속
Object IInspectable DependencyObject TextElement Block
파생
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

블록은 모든 유형의 블록 콘텐츠에 적용해야 하는 텍스트 서식 속성을 정의합니다. 이러한 속성은 다음과 LineHeightLineStackingStrategyMarginTextAlignment같습니다. 블록은 텍스트 서식 속성 및 기타 API도 TextElement상속합니다.

Windows 런타임 XAML 어휘에서 유일한 블록 형식은 .입니다Paragraph. 컨트롤 내에 RichTextBlock 표시할 텍스트 블록을 정의하는 데 사용합니다Paragraph. 모든 RichTextBlock 사람은 하나 이상을 Paragraph포함해야 합니다.

BlockCollection 는 속성에서 사용되는 RichTextBlock.Blocks 강력한 형식의 컬렉션 클래스입니다. 내 RichTextBlock의 XAML 개체 요소를 지정하여 블록 텍스트 콘텐츠를 RichTextBlock할당할 수 있습니다. 일반적으로 요소가 XAML 태그의 직접 자식 RichTextBlock 으로 표시되도록 Paragraph 암시적 컬렉션 및 XAML 속성 구문을 사용하여 수행됩니다. 예:

<RichTextBlock>
  <Paragraph>First paragraph.</Paragraph>
  <Paragraph>Second paragraph.</Paragraph>
  <Paragraph>Third paragraph. <Bold>With an inline.</Bold></Paragraph>
</RichTextBlock>

파생 클래스 차단

블록은 .의 부모 클래스입니다 Paragraph.

마이그레이션 정보

Windows 런타임 XAML 어휘는 Section 클래스를 지원하지 않습니다. Windows Presentation Foundation(WPF) 또는 Microsoft Silverlight에서 XAML을 마이그레이션하는 경우 블록 요소를 대신 사용합니다Paragraph.

버전 기록

Windows 버전 SDK 버전 추가된 값
1709 16299 HorizontalTextAlignment

생성자

Block()

파생 클래스에 대한 Block 기본 클래스 초기화 동작을 제공합니다.

속성

AccessKey

이 요소의 액세스 키를 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
AccessKeyScopeOwner

원본 요소의 시각적 트리에 없는 경우에도 이 요소에 대한 액세스 키 범위를 제공하는 원본 요소를 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
AllowFocusOnInteraction

사용자가 상호 작용할 때 요소가 자동으로 포커스를 가져오는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
CharacterSpacing

문자 간의 균일한 간격을 1/1000 단위로 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
ContentEnd

요소에 있는 콘텐츠의 끝을 나타내는 TextPointer를 가져옵니다.

(다음에서 상속됨 TextElement)
ContentStart

요소에 있는 콘텐츠의 시작 부분을 나타내는 TextPointer를 가져옵니다.

(다음에서 상속됨 TextElement)
Dispatcher

이 개체가 CoreDispatcher 연결된 개체를 가져옵니다. 코드 CoreDispatcher 가 비 UI 스레드에서 시작되는 경우에도 UI 스레드에 액세스할 DependencyObject 수 있는 기능을 나타냅니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.Dispatcher(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

(다음에서 상속됨 DependencyObject)
ElementEnd

요소 끝의 바로 뒤 위치를 나타내는 TextPointer를 가져옵니다.

(다음에서 상속됨 TextElement)
ElementStart

요소 시작의 바로 앞 위치를 나타내는 TextPointer를 가져옵니다.

(다음에서 상속됨 TextElement)
ExitDisplayModeOnAccessKeyInvoked

액세스 키를 호출할 때 액세스 키 표시가 해제되는지 여부를 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
FontFamily

요소 콘텐츠에 대해 기본 설정된 최상위 글꼴 패밀리를 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
FontSize

요소의 콘텐츠에 대한 글꼴 크기를 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
FontStretch

선택할 패밀리 글꼴의 문자 모양 너비를 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
FontStyle

이 요소의 콘텐츠에 대한 글꼴 스타일을 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
FontWeight

이 요소의 콘텐츠에 대한 글꼴 패밀리에서 선택할 최상위 글꼴 두께를 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
Foreground

이 요소의 콘텐츠에 Brush 적용할 값을 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
HorizontalTextAlignment

블록에서 텍스트가 정렬되는 방식을 나타내는 값을 가져오거나 설정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.HorizontalTextAlignment(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

HorizontalTextAlignmentProperty

HorizontalTextAlignment 종속성 속성을 식별합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.HorizontalTextAlignmentProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

IsAccessKeyScope

요소가 자체 액세스 키 범위를 정의하는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
IsTextScaleFactorEnabled

시스템 텍스트 크기 설정을 반영하기 위해 자동 텍스트 확대를 사용할지 여부를 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
KeyTipHorizontalOffset

키 설명이 텍스트 요소와 관련하여 얼마나 왼쪽 또는 오른쪽으로 배치되는지를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
KeyTipPlacementMode

텍스트 요소와 관련하여 KeyTip이 배치되는 위치를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
KeyTipVerticalOffset

키 설명이 텍스트 요소와 관련하여 배치되는 거리를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
Language

에 적용되는 TextElement지역화/세계화 언어 정보를 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
LineHeight

콘텐츠 각 줄의 높이를 가져오거나 설정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.LineHeight(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

LineHeightProperty

LineHeight 종속성 속성을 나타냅니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.LineHeightProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

LineStackingStrategy

의 각 텍스트 Block줄에 대해 줄 상자가 결정되는 방식을 나타내는 값을 가져오거나 설정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.LineStackingStrategy(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

LineStackingStrategyProperty

LineStackingStrategy 종속성 속성을 나타냅니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.LineStackingStrategyProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

Margin

요소 주위 Block 의 공간 양을 가져오거나 설정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.Margin(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

MarginProperty

Margin 종속성 속성을 나타냅니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.MarginProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

Name

개체에 대한 고유 ID를 가져오거나 설정합니다. 이름은 XAML의 초기 구문 분석에서만 설정할 수 있습니다.

(다음에서 상속됨 TextElement)
TextAlignment

텍스트 콘텐츠의 가로 맞춤을 가져오거나 설정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.TextAlignment(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

TextAlignmentProperty

TextAlignment 종속성 속성을 나타냅니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Documents.Block.TextAlignmentProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

TextDecorations

텍스트에 적용되는 장식을 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)
XamlRoot

이 요소를 볼 XamlRoot를 가져오거나 설정합니다.

(다음에서 상속됨 TextElement)

메서드

ClearValue(DependencyProperty)

종속성 속성의 로컬 값을 지웁니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ClearValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

(다음에서 상속됨 DependencyObject)
FindName(String)

개체의 x:Name 또는 Name 특성 값을 참조하여 개체 모델/런타임 개체 그래프에서 개체를 검색합니다.

(다음에서 상속됨 TextElement)
GetAnimationBaseValue(DependencyProperty)

애니메이션이 활성화되지 않은 경우에 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetAnimationBaseValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

(다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)

에서 종속성 속성 DependencyObject의 현재 유효 값을 반환합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

(다음에서 상속됨 DependencyObject)
OnDisconnectVisualChildren()

클래스별 콘텐츠 또는 자식 속성에서 항목을 제거할 때 레이아웃 및 논리가 작동하는 방식을 구현하려면 이 메서드를 재정의합니다.

(다음에서 상속됨 TextElement)
ReadLocalValue(DependencyProperty)

로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ReadLocalValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

(다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

DependencyObject 인스턴스의 특정 DependencyProperty 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.RegisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

(다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)

에 종속성 속성 DependencyObject의 로컬 값을 설정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.SetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

(다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

를 호출 RegisterPropertyChangedCallback하여 이전에 등록한 변경 알림을 취소합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.UnregisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

(다음에서 상속됨 DependencyObject)

이벤트

AccessKeyDisplayDismissed

액세스 키 시퀀스가 완료되어 컨트롤이 액세스 키 시각적 개체를 숨겨야 한다고 알릴 때 발생합니다.

(다음에서 상속됨 TextElement)
AccessKeyDisplayRequested

액세스 키 시퀀스가 액세스 키 시각적 개체를 표시해야 한다고 컨트롤에 알리기 시작할 때 발생합니다.

(다음에서 상속됨 TextElement)
AccessKeyInvoked

사용자가 액세스 키 시퀀스를 완료하여 요소에 액세스 키 동작을 호출해야 한다고 알릴 때 발생합니다.

(다음에서 상속됨 TextElement)

적용 대상

추가 정보