InlineUIContainer 클래스

정의

네임스페이스:

Windows.UI.Xaml.Documents

RichTextBlock의 콘텐츠에 UIElement 형식을 포함할 수 있도록 하는 인라인 콘텐츠 요소를 제공합니다.

public ref class InlineUIContainer sealed : Inline

/// [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)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Child")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class InlineUIContainer final : Inline

[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)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Child")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class InlineUIContainer : Inline

Public NotInheritable Class InlineUIContainer
Inherits Inline

<InlineUIContainer .../>
-or-
<InlineUIContainer ...>
  singleChild
</InlineUIContainer>

상속

Object Platform::Object IInspectable DependencyObject TextElement Inline InlineUIContainer

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows 요구 사항

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

예제

다음 코드 예제에서는 InlineUIContainer를 사용하여 RichTextBlock 에 이미지를 삽입하는 방법을 보여줍니다.

<RichTextBlock>
    <Paragraph>
        <Italic>This is an inline image.</Italic>

        <InlineUIContainer>
            <Image Source="Assets/SmallLogo.png" Height="30" Width="30"/>
        </InlineUIContainer>

        Mauris auctor tincidunt auctor.
    </Paragraph>
</RichTextBlock>

설명

InlineUIContainer 개체를 사용하는 가장 일반적인 시나리오는 이미지를 텍스트 콘텐츠에 도입하는 것입니다. 이미지에 새 Image 개체를 InlineUIContainer의 자식 콘텐츠로 사용합니다. 자연 이미지 크기로 크기를 조정하지 않으려면 이미지에서 높이 및 너비 를 설정합니다.

동일한 위치에 둘 이상의 요소를 인라인하려는 경우 패널을 단일 InlineUIContainer 자식으로 사용한 다음 해당 패널 내에 여러 요소를 배치하는 것이 좋습니다.

InlineUIContainer 내에 배치된 경우 포커스가 있을 수 있는 컨트롤이 최상위 탭 시퀀스에 계속 표시됩니다.

대화형 텍스트를 원하는 경우 단추 또는 이와 유사한 단추가 있는 InlineUIContainer를 사용하는 대신 Hyperlink 요소(인라인 형식)를 사용하는 것이 좋습니다. 링크에 대한 지침을 참조하세요.

InlineUIContainer는 TextElement 클래스에서 속성을 상속합니다. 그러나 이러한 속성의 대부분은 눈에 띄는 효과가 없습니다. InlineUIContainer 개체 요소의 콘텐츠로 인라인하는 단일 자식 요소를 사용하여 특성 집합( x:Name 특성 제외)이 설정되지 않고 XAML에서 InlineUIContainer 개체 요소를 선언하는 것이 가장 일반적입니다.

텍스트 요소의 문자 줄 높이(예: FontSize, FontFamily)에 영향을 주는 InlineUIContainer의 속성을 설정해도 렌더링 및 모양에는 영향을 주지 않습니다. 콘텐츠는 크기에 맞게 InlineUIContainer 크기를 지정합니다.

자식 콘텐츠 내에 추가 텍스트(예: TextBlock.Text 또는 중첩 된 RichTextBlock 내의 다른 텍스트 요소)가 있는 경우 InlineUIContainer 부모의 텍스트 요소 속성은 콘텐츠에 상속되지 않습니다.

생성자

InlineUIContainer()

InlineUIContainer 클래스의 새 instance 초기화합니다.

속성

AccessKey	이 요소의 액세스 키를 가져오거나 설정합니다. (다음에서 상속됨 TextElement)
AccessKeyScopeOwner	원본 요소의 시각적 트리에 없는 경우에도 이 요소에 대한 액세스 키 scope 제공하는 원본 요소를 가져오거나 설정합니다. (다음에서 상속됨 TextElement)
AllowFocusOnInteraction	사용자가 상호 작용할 때 요소가 자동으로 포커스를 받는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 TextElement)
CharacterSpacing	문자 사이의 균일한 간격을 1/1000 단위로 가져오거나 설정합니다. (다음에서 상속됨 TextElement)
Child	InlineUIContainer에서 호스트하는 UIElement를 가져오거나 설정합니다.
ContentEnd	요소의 콘텐츠 끝을 나타내는 TextPointer 를 가져옵니다. (다음에서 상속됨 TextElement)
ContentStart	요소의 콘텐츠 시작을 나타내는 TextPointer 를 가져옵니다. (다음에서 상속됨 TextElement)
Dispatcher	이 개체가 연결된 CoreDispatcher 를 가져옵니다. CoreDispatcher는 코드가 비 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)
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)

추가 정보

• Inline
• RichTextBlock
• UIElement