Span クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
/// [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="Inlines")]
class Span : 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="Inlines")]
public class Span : InlinePublic Class Span
Inherits Inline<Span .../>
-or-
<Span ...>
oneOrMoreInlines
</Span>
-or-
<Span ...>
mixedContent
</Span>
- 継承
- 派生
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
注釈
テキストを囲むには、XAML のオブジェクト要素として Span を使用できます。 これにより、HTML で タグを使用する方法と同様の使用方法が span 可能になります。 この使用法では、 TextElement でサポートされる属性 ( FontSize や FontFamily など) を設定して、これらのテキスト書式設定の決定を、囲まれたテキスト範囲に適用できるようにします。 Run には 、テキスト範囲に TextElement プロパティを適用する機能と同様の機能がありますが、 Run では混合コンテンツはサポートされていません ( その Run.Text XAML コンテンツ プロパティにはテキストのみを含めることができますが、混在コンテンツやそれ以上のインラインは含められません)。
SPAN では、XAML でコンテンツを設定した場合、混合コンテンツがサポートされます。 つまり、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 要素にはテキストが含まれていますが、それ以外の場合はプロパティが設定されていません。
注意
Span は Inlines プロパティが XAML コンテンツ プロパティであることを示しているため、タグまたはテキストを Span 要素内に直接配置するかどうかに関係なく、XAML コンテンツを配置できます。 XAML コンテンツ プロパティの詳細については、XAML 構文ガイドの「XAML コンテンツ プロパティ」セクションを参照してください。
Span 要素は通常、InlineCollection 内の要素として使用されます。Paragraph の子要素 (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 |
このオブジェクトが関連付けられている 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) |
| Inlines |
Span の内容を含む最上位のインライン要素を含む InlineCollection を取得 します。 |
| 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) |