Span クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
/// [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 Span : Inline[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
[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 class Span : InlinePublic Class Span
Inherits Inline<Span .../>
-or-
<Span ...>
oneOrMoreInlines
</Span>
-or-
<Span ...>
mixedContent
</Span>
- 継承
- 派生
- 属性
注釈
テキストを囲むには、XAML でオブジェクト要素として Span を使用できます。 これにより、HTML で span タグを使用する方法と同様の使用方法が可能になります。 この使用法では、FontSize や FontFamily などの TextElement でサポートされる属性を設定して、囲まれたテキスト範囲にこれらのテキスト書式設定の決定を適用できるようにします。
Run にはテキスト範囲に TextElement プロパティを適用するのと同様の機能がありますが、 Run は混合コンテンツをサポートしていません ( その Run.Text XAML コンテンツ プロパティには、混合コンテンツおよびそれ以降のインラインではなく、テキストのみを含めることができます)。
XAML でコンテンツを設定した場合、Span では混合コンテンツがサポートされます。 つまり、Run、Bold などのインライン タグと XAML テキスト コンテンツ (プレーン テキスト) を混在させることができます。タグとテキストの順序に制限はありません。 プレーン テキストでも インライン タグで囲まれているとしても、すべてのテキストは、混合コンテンツでテキストが定義されている順序でレンダリングされます。 たとえば、これは有効な XAML です。
<RichTextBlock>
<Paragraph>
<Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
</Paragraph>
</RichTextBlock>
混合コンテンツが XAML から解析され、テキスト オブジェクト モデルが実行時に調べられた場合、プレーン テキストから取得されたすべてのテキスト領域は、実行時アクセスを可能にする InlineCollection コレクション クラス内の適切な読み取り順序の位置に Run オブジェクトを生成します。 その Run 要素にはテキストが含まれていますが、それ以外の場合はプロパティが設定されていません。
Note
タグまたはテキストを Span 要素内に直接配置する XAML コンテンツはサポートされています。Span は Inlines プロパティが XAML コンテンツ プロパティであることを示しているためです。 XAML コンテンツ プロパティの詳細については、XAML 構文ガイドの「XAML コンテンツ プロパティ」セクションを参照してください。
Span 要素は通常、 InlineCollection 内の要素として使用されます。 段落 の子要素 ( Paragraph.Inlines の一部になります) または別の Span のコンテンツ ( Span.Inlines の一部になります) として使用されます。
Span 派生クラス
Span は、特定の書式設定規則を使用してインライン テキスト領域を定義するいくつかの派生クラスの親クラスです。
ハイパーリンク を使用すると、 NavigateUri に移動するクリック動作が有効になります。 他の Span 派生クラスは、テキストにクラス固有の装飾と考えることができ、それ以外の場合は相互作用を追加しません。
コンストラクター
| 名前 | 説明 |
|---|---|
| Span() |
Span クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| AccessKey |
この要素のアクセス キーを取得または設定します。 (継承元 TextElement) |
| AccessKeyScopeOwner |
ソース要素のビジュアル ツリーにない場合でも、この要素のアクセス キー スコープを提供するソース要素を取得または設定します。 (継承元 TextElement) |
| AllowFocusOnInteraction |
ユーザーが要素を操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 TextElement) |
| CharacterSpacing |
em の 1/1000 単位で文字間の均一な間隔を取得または設定します。 (継承元 TextElement) |
| 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 |
この要素のコンテンツに適用する ブラシ を取得または設定します。 (継承元 TextElement) |
| Inlines |
Span の内容を含む最上位のインライン要素を含む InlineCollection を取得 します。 |
| IsAccessKeyScope |
要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 TextElement) |
| IsTextScaleFactorEnabled |
システム テキスト サイズの設定を反映するために、自動テキスト拡大を有効にするかどうかを取得または設定します。 (継承元 TextElement) |
| KeyTipHorizontalOffset |
テキスト要素に対してキーヒントを配置する距離を示す値を取得または設定します。 (継承元 TextElement) |
| KeyTipPlacementMode |
テキスト要素に関連してキーヒントが配置される場所を示す値を取得または設定します。 (継承元 TextElement) |
| KeyTipVerticalOffset |
テキスト要素に対するキーヒントの配置距離を示す値を取得または設定します。 (継承元 TextElement) |
| Language |
TextElement に適用されるローカライズ/グローバリゼーション言語情報を取得または設定します。 (継承元 TextElement) |
| Name |
オブジェクトの一意の ID を取得または設定します。 名前は、XAML の最初の解析からのみ設定できます。 (継承元 TextElement) |
| TextDecorations |
テキストに適用される装飾を示す値を取得または設定します。 (継承元 TextElement) |
| XamlRoot |
この要素が表示される XamlRoot を取得または設定します。 (継承元 TextElement) |
メソッド
イベント
| 名前 | 説明 |
|---|---|
| AccessKeyDisplayDismissed |
アクセス キー のビジュアルを非表示にする必要があることをコントロールに通知するためにアクセス キー シーケンスが完了したときに発生します。 (継承元 TextElement) |
| AccessKeyDisplayRequested |
アクセス キー のビジュアルを表示する必要があることをコントロールに通知するためにアクセス キー シーケンスが開始されたときに発生します。 (継承元 TextElement) |
| AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了して、アクセス キー アクションを呼び出す必要があることを要素に通知したときに発生します。 (継承元 TextElement) |