InlineUIContainer クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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>
- 継承
- 属性
例
次のコード例は、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 アプリで を返します |
DispatcherQueue |
このオブジェクトが |
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) |
メソッド
イベント
AccessKeyDisplayDismissed |
アクセス キー のビジュアルを非表示にする必要があることをコントロールに通知するためにアクセス キー シーケンスが完了したときに発生します。 (継承元 TextElement) |
AccessKeyDisplayRequested |
アクセス キー のビジュアルを表示する必要があることをコントロールに通知するためにアクセス キー シーケンスが開始されたときに発生します。 (継承元 TextElement) |
AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了して、アクセス キー アクションを呼び出す必要があることを要素に通知すると発生します。 (継承元 TextElement) |