InlineUIContainer クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
UiElement 型を RichTextBlock のコンテンツに埋め込むインライン コンテンツ要素を提供します。
public ref class InlineUIContainer sealed : Inline
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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")]
class InlineUIContainer final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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")]
public sealed class InlineUIContainer : 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>
- 継承
- 属性
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 オブジェクトを使用する最も一般的なシナリオは、テキスト コンテンツに画像を導入することです。 InlineUIContainer の子コンテンツとして、イメージに新しい Image オブジェクトを使用します。 イメージを自然なイメージ サイズにスケーリングしない場合は、イメージの [高さ] と [ 幅] を設定します。
複数の要素を同じ位置にインライン化する場合は、1 つのパネルを 1 つの InlineUIContainer 子として使用し、そのパネル内に複数の要素を配置することを検討してください。
InlineUIContainer 内に配置した場合でも、フォーカスできるコントロールは最上位のタブ シーケンスに表示されます。
対話型テキストが必要な場合は、InlineUIContainer を Button または類似の Button で使用するのではなく、Hyperlink 要素 (Inline の種類) を使用することを検討してください。 リンクについては、「ガイドライン」を参照してください。
InlineUIContainer は TextElement クラスからプロパティを継承します。 ただし、これらのプロパティのほとんどは表示効果を持っていません。 InlineUIContainer オブジェクト要素のコンテンツとしてインライン化する単一の子要素を持つ属性 ( x:Name 属性を除く) が設定されていない状態で、XAML で InlineUIContainer オブジェクト要素を宣言するのが最も一般的です。
テキスト要素の文字行の高さに影響する InlineUIContainer のプロパティ ( FontSize、 FontFamily など) の設定は、レンダリングと外観には影響しません。 コンテンツによって、そのサイズと InlineUIContainer サイズがそれに合わせて決まります。
子コンテンツ内にさらにテキストがある場合 ( TextBlock.Text や入れ子になった RichTextBlock 内の他のテキスト要素など)、InlineUIContainer 親のテキスト要素プロパティはコンテンツに継承されません。無視されます。
コンストラクター
InlineUIContainer() |
InlineUIContainer クラスの新しいインスタンスを初期化します。 |
プロパティ
AccessKey |
この要素のアクセス キーを取得または設定します。 (継承元 TextElement) |
AccessKeyScopeOwner |
ソース要素のビジュアル ツリーにない場合でも、この要素のアクセス キー スコープを提供するソース要素を取得または設定します。 (継承元 TextElement) |
AllowFocusOnInteraction |
ユーザーが操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 TextElement) |
CharacterSpacing |
em の 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 |
要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 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) |