InlineUIContainer 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
RichTextBlock의 콘텐츠에 UIElement 형식을 포함할 수 있는 인라인 콘텐츠 요소를 제공합니다.
public ref class InlineUIContainer sealed : Inline/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Child")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [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 InlineUIContainer final : Inline[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Child")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[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 sealed class InlineUIContainer : InlinePublic NotInheritable Class InlineUIContainer
Inherits Inline<InlineUIContainer .../>
-or-
<InlineUIContainer ...>
singleChild
</InlineUIContainer>
- 상속
- 특성
예제
다음 코드 예제에서는 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 내에 배치된 경우 포커스가 있을 수 있는 컨트롤이 최상위 탭 시퀀스에 계속 표시됩니다.
대화형 텍스트를 원하는 경우 Button 또는 이와 유사한 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 |
항상 Windows 앱 SDK 앱에서 를 반환 |
| DispatcherQueue |
|
| 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) |
메서드
이벤트
| AccessKeyDisplayDismissed |
액세스 키 시퀀스가 완료되어 액세스 키 시각적 개체를 숨겨야 한다는 것을 컨트롤에 알릴 때 발생합니다. (다음에서 상속됨 TextElement) |
| AccessKeyDisplayRequested |
액세스 키 시퀀스가 액세스 키 시각적 개체를 표시해야 한다는 것을 컨트롤에 알리기 시작할 때 발생합니다. (다음에서 상속됨 TextElement) |
| AccessKeyInvoked |
사용자가 액세스 키 시퀀스를 완료하여 요소에 액세스 키 동작을 호출해야 한다고 알릴 때 발생합니다. (다음에서 상속됨 TextElement) |