InlineUIContainer クラス

定義

名前空間:

Microsoft.UI.Xaml.Documents

UiElement 型を RichTextBlock のコンテンツに埋め込むインライン コンテンツ要素を提供します。

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 : Inline

Public NotInheritable Class InlineUIContainer
Inherits Inline

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

継承

Object Platform::Object IInspectable DependencyObject TextElement Inline InlineUIContainer

属性

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

例

次のコード例は、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 オブジェクトを使用する最も一般的なシナリオは、画像をテキスト コンテンツに導入することです。 InlineUIContainer の子コンテンツとして、イメージに新しい Image オブジェクトを使用します。 画像を自然なイメージ サイズにスケーリングしない場合は、[ 高さ] と [ 幅] を設定します。

複数の要素を同じ位置にインライン化する場合は、1 つのパネルを 1 つの InlineUIContainer 子として使用し、そのパネル内に複数の要素を配置することを検討してください。

InlineUIContainer 内に配置された場合でも、フォーカスできるコントロールは最上位のタブ シーケンスに表示されます。

対話型テキストが必要な場合は、Button などの Button で InlineUIContainer を使用するのではなく、Hyperlink 要素 (Inline の種類) を使用することを検討してください。 リンクについては、「ガイドライン」を参照してください。

InlineUIContainer は TextElement クラスからプロパティを継承します。 ただし、これらのプロパティのほとんどが表示効果を持っていません。 InlineUIContainer オブジェクト要素のコンテンツとしてインライン化する単一の子要素を持つ属性 ( x:Name 属性を除く) が設定されていない状態で、XAML で InlineUIContainer オブジェクト要素を宣言するのが最も一般的です。

InlineUIContainer で、テキスト要素の文字行の高さ ( FontSize、 FontFamily など) に影響するプロパティを設定しても、レンダリングと外観には影響しません。 コンテンツは、サイズと InlineUIContainer サイズをそれに合わせて決定します。

子コンテンツ内にさらにテキストがある場合 ( TextBlock.Text や入れ子になった RichTextBlock 内の他のテキスト要素など)、InlineUIContainer 親の text 要素プロパティはコンテンツに継承されません。これらは無視されます。

コンストラクター

InlineUIContainer()

InlineUIContainer クラスの新しいインスタンスを初期化します。

プロパティ

AccessKey	この要素のアクセス キーを取得または設定します。 (継承元 TextElement)
AccessKeyScopeOwner	ソース要素のビジュアル ツリーにない場合でも、この要素のアクセス キー スコープを提供するソース要素を取得または設定します。 (継承元 TextElement)
AllowFocusOnInteraction	ユーザーが操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 TextElement)
CharacterSpacing	em の 1/1000 単位の文字間の均一な間隔を取得または設定します。 (継承元 TextElement)
Child	InlineUIContainer によってホストされる UIElement を取得または設定します。
ContentEnd	要素内のコンテンツの末尾を表す TextPointer を取得します。 (継承元 TextElement)
ContentStart	要素内のコンテンツの開始位置を表す TextPointer を取得します。 (継承元 TextElement)
Dispatcher	常に Windows アプリ SDK アプリで を返しますnull。 代わりに DispatcherQueue を使用してください。 (継承元 DependencyObject)
DispatcherQueue	このオブジェクトが DispatcherQueue 関連付けられている を取得します。 は DispatcherQueue 、コードが 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	要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 TextElement)
IsTextScaleFactorEnabled	システム テキスト サイズの設定を反映するように、自動テキストの拡大を有効にするかどうかを取得または設定します。 (継承元 TextElement)
KeyTipHorizontalOffset	テキスト要素に対してキーヒントを配置する距離を示す値を取得または設定します。 (継承元 TextElement)
KeyTipPlacementMode	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 インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject)

イベント

AccessKeyDisplayDismissed	アクセス キー のビジュアルを非表示にする必要があることをコントロールに通知するためにアクセス キー シーケンスが完了したときに発生します。 (継承元 TextElement)
AccessKeyDisplayRequested	アクセス キー のビジュアルを表示する必要があることをコントロールに通知するためにアクセス キー シーケンスが開始されたときに発生します。 (継承元 TextElement)
AccessKeyInvoked	ユーザーがアクセス キー シーケンスを完了して、アクセス キー アクションを呼び出す必要があることを要素に通知すると発生します。 (継承元 TextElement)

こちらもご覧ください

• Inline
• RichTextBlock
• UIElement