RichEditBox クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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)]
class RichEditBox : Control
[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)]
public class RichEditBox : Control
Public Class RichEditBox
Inherits Control
<RichEditBox .../>
- 継承
- 属性
Windows の要件
デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
例
ヒント
詳細、設計ガイダンス、およびコード例については、「 リッチ エディット ボックス」を参照してください。
WinUI 2 ギャラリー アプリがインストールされている場合は、ここをクリックしてアプリを開き、RichEditBox の動作を確認してください。
この例では、 ITextDocument.SetText メソッドを使用して、プログラムによって RichEditBox にテキストを追加する方法を示します。
<RichEditBox x:Name="richEditBox" Width="500" Header="Notes"/>
richEditBox.Document.SetText(Windows.UI.Text.TextSetOptions.None, "This is some sample text");
この例では、RichEditBox でリッチ テキスト形式 (.rtf) ファイルの編集、読み込み、保存を行う方法を示します。
<RelativePanel Margin="20" HorizontalAlignment="Stretch">
<RelativePanel.Resources>
<Style TargetType="AppBarButton">
<Setter Property="IsCompact" Value="True"/>
</Style>
</RelativePanel.Resources>
<AppBarButton x:Name="openFileButton" Icon="OpenFile"
Click="OpenButton_Click" ToolTipService.ToolTip="Open file"/>
<AppBarButton Icon="Save" Click="SaveButton_Click"
ToolTipService.ToolTip="Save file"
RelativePanel.RightOf="openFileButton" Margin="8,0,0,0"/>
<AppBarButton Icon="Bold" Click="BoldButton_Click" ToolTipService.ToolTip="Bold"
RelativePanel.LeftOf="italicButton" Margin="0,0,8,0"/>
<AppBarButton x:Name="italicButton" Icon="Italic" Click="ItalicButton_Click"
ToolTipService.ToolTip="Italic" RelativePanel.LeftOf="underlineButton" Margin="0,0,8,0"/>
<AppBarButton x:Name="underlineButton" Icon="Underline" Click="UnderlineButton_Click"
ToolTipService.ToolTip="Underline" RelativePanel.AlignRightWithPanel="True"/>
<RichEditBox x:Name="editor" Height="200" RelativePanel.Below="openFileButton"
RelativePanel.AlignLeftWithPanel="True" RelativePanel.AlignRightWithPanel="True"/>
</RelativePanel>
private async void OpenButton_Click(object sender, RoutedEventArgs e)
{
// Open a text file.
Windows.Storage.Pickers.FileOpenPicker open =
new Windows.Storage.Pickers.FileOpenPicker();
open.SuggestedStartLocation =
Windows.Storage.Pickers.PickerLocationId.DocumentsLibrary;
open.FileTypeFilter.Add(".rtf");
Windows.Storage.StorageFile file = await open.PickSingleFileAsync();
if (file != null)
{
try
{
Windows.Storage.Streams.IRandomAccessStream randAccStream =
await file.OpenAsync(Windows.Storage.FileAccessMode.Read);
// Load the file into the Document property of the RichEditBox.
editor.Document.LoadFromStream(Windows.UI.Text.TextSetOptions.FormatRtf, randAccStream);
}
catch (Exception)
{
ContentDialog errorDialog = new ContentDialog()
{
Title = "File open error",
Content = "Sorry, I couldn't open the file.",
PrimaryButtonText = "Ok"
};
await errorDialog.ShowAsync();
}
}
}
private async void SaveButton_Click(object sender, RoutedEventArgs e)
{
Windows.Storage.Pickers.FileSavePicker savePicker = new Windows.Storage.Pickers.FileSavePicker();
savePicker.SuggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.DocumentsLibrary;
// Dropdown of file types the user can save the file as
savePicker.FileTypeChoices.Add("Rich Text", new List<string>() { ".rtf" });
// Default file name if the user does not type one in or select a file to replace
savePicker.SuggestedFileName = "New Document";
Windows.Storage.StorageFile file = await savePicker.PickSaveFileAsync();
if (file != null)
{
// Prevent updates to the remote version of the file until we
// finish making changes and call CompleteUpdatesAsync.
Windows.Storage.CachedFileManager.DeferUpdates(file);
// write to file
Windows.Storage.Streams.IRandomAccessStream randAccStream =
await file.OpenAsync(Windows.Storage.FileAccessMode.ReadWrite);
editor.Document.SaveToStream(Windows.UI.Text.TextGetOptions.FormatRtf, randAccStream);
// Let Windows know that we're finished changing the file so the
// other app can update the remote version of the file.
Windows.Storage.Provider.FileUpdateStatus status = await Windows.Storage.CachedFileManager.CompleteUpdatesAsync(file);
if (status != Windows.Storage.Provider.FileUpdateStatus.Complete)
{
Windows.UI.Popups.MessageDialog errorBox =
new Windows.UI.Popups.MessageDialog("File " + file.Name + " couldn't be saved.");
await errorBox.ShowAsync();
}
}
}
private void BoldButton_Click(object sender, RoutedEventArgs e)
{
Windows.UI.Text.ITextSelection selectedText = editor.Document.Selection;
if (selectedText != null)
{
Windows.UI.Text.ITextCharacterFormat charFormatting = selectedText.CharacterFormat;
charFormatting.Bold = Windows.UI.Text.FormatEffect.Toggle;
selectedText.CharacterFormat = charFormatting;
}
}
private void ItalicButton_Click(object sender, RoutedEventArgs e)
{
Windows.UI.Text.ITextSelection selectedText = editor.Document.Selection;
if (selectedText != null)
{
Windows.UI.Text.ITextCharacterFormat charFormatting = selectedText.CharacterFormat;
charFormatting.Italic = Windows.UI.Text.FormatEffect.Toggle;
selectedText.CharacterFormat = charFormatting;
}
}
private void UnderlineButton_Click(object sender, RoutedEventArgs e)
{
Windows.UI.Text.ITextSelection selectedText = editor.Document.Selection;
if (selectedText != null)
{
Windows.UI.Text.ITextCharacterFormat charFormatting = selectedText.CharacterFormat;
if (charFormatting.Underline == Windows.UI.Text.UnderlineType.None)
{
charFormatting.Underline = Windows.UI.Text.UnderlineType.Single;
}
else {
charFormatting.Underline = Windows.UI.Text.UnderlineType.None;
}
selectedText.CharacterFormat = charFormatting;
}
}
注釈
ヒント
詳細、設計ガイダンス、およびコード例については、「 リッチ エディット ボックス」を参照してください。
RichEditBox は、太字、斜体、下線などの書式設定されたテキストをユーザーが入力できるコントロールです。 RichEditBox では、ハイパーリンクや画像 (.jpg、.png など) を含むリッチ テキスト形式 (.rtf) ドキュメントを表示することもできます。 このコントロールは、高度なテキスト編集シナリオ向けに設計されています。 フォームのような単純なプレーン テキスト入力の場合は、 TextBox の使用を検討してください。
RichEditBox のコンテンツを取得するには、このコントロールの Document プロパティを使います。 RichEditBox の内容は Windows.UI.Text.ITextDocument オブジェクトであり、基になる Text オブジェクト モデル API にアクセスできます。 テキスト ドキュメントの操作に使用できる API については、 Windows.UI.Text 名前空間を参照してください。
詳細と例については、 RichEditBox コントロール ガイドを参照してください。
ペン入力
Windows 10 バージョン 1803 以降では、XAML テキスト入力ボックスは、Windows Ink を使用したペン入力の埋め込みをサポートしています。 ユーザーが Windows ペンを使用してテキスト入力ボックスでタップすると、テキスト ボックスは変換され、ユーザーは別の入力パネルを開かなくても、ペンを使用して直接書き込むことができます。
詳細については、「手書きビューでのテキスト入力」をご覧ください。
コントロールのスタイルとテンプレート
既定の スタイル と ControlTemplate を変更して、コントロールに一意の外観を与えることができます。 コントロールのスタイルとテンプレートの変更については、「コントロールの スタイル設定」を参照してください。 コントロールの外観を定義する既定のスタイル、テンプレート、およびリソースがファイルに generic.xaml
含まれます。 は、設計目的で generic.xaml
、SDK または NuGet パッケージのインストールでローカルで使用できます。
-
WinUI スタイル (推奨): WinUI から更新されたスタイルについては、「」を参照してください
\Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml
。 -
WinUI 以外のスタイル: 組み込みのスタイルについては、「」を参照してください
%ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml
。
インストールをカスタマイズした場合、場所が異なる場合があります。 SDK の異なるバージョンのスタイルとリソースの値が異なる場合があります。
XAML には、コントロール テンプレートを変更せずに、さまざまなビジュアル状態のコントロールの色を変更するために使用できるリソースも含まれています。 これらのリソースを変更することは、 Background や Foreground などのプロパティを設定する場合に適 しています。 詳細については、XAML スタイルに関する記事の「軽量スタイル設定」セクションを参照してください。 軽量のスタイル設定リソースは、Windows 10 バージョン 1607 (SDK 14393) 以降で使用できます。
でTextControl
始まるリソースは、TextBox、PasswordBox、および RichEditBox
AutoSuggestBox によって共有されます。 これらのリソースに対する変更は、4 つのすべてのコントロールに影響します。
バージョン履歴
Windows のバージョン | SDK バージョン | 追加された値 |
---|---|---|
1511 | 10586 | ClipboardCopyFormat |
1511 | 10586 | GetLinguisticAlternativesAsync |
1703 | 15063 | MaxLength |
1703 | 15063 | SelectionHighlightColorWhenNotFocused |
1709 | 16299 | CharacterCasing |
1709 | 16299 | CopyingToClipboard |
1709 | 16299 | CuttingToClipboard |
1709 | 16299 | DisabledFormattingAccelerators |
1709 | 16299 | HorizontalTextAlignment |
1803 | 17134 | ContentLinkBackgroundColor |
1803 | 17134 | ContentLinkChanged |
1803 | 17134 | ContentLinkForegroundColor |
1803 | 17134 | ContentLinkInvoked |
1803 | 17134 | ContentLinkProviders |
1803 | 17134 | HandwritingView |
1803 | 17134 | IsHandwritingViewEnabled |
1809 | 17763 | 説明 |
1809 | 17763 | ProofingMenuFlyout |
1809 | 17763 | SelectionChanging |
1809 | 17763 | SelectionFlyout |
1809 | 17763 | TextDocument |
コンストラクター
RichEditBox() |
RichEditBox クラスの新しいインスタンスを初期化します。 |
プロパティ
AcceptsReturn |
Enter キーまたは RETURN キーを押したときに 、RichEditBox で改行文字または戻り文字を許可して表示するかどうかを示す値を取得または設定します。 |
AcceptsReturnProperty |
AcceptsReturn 依存関係プロパティを識別します。 |
AccessKey |
この要素のアクセス キー (ニーモニック) を取得または設定します。 (継承元 UIElement) |
AccessKeyScopeOwner |
ソース要素のビジュアル ツリーにない場合でも、この要素のアクセス キー スコープを提供するソース要素を取得または設定します。 (継承元 UIElement) |
ActualHeight |
FrameworkElement のレンダリングされた高さを取得します。 「解説」を参照してください。 (継承元 FrameworkElement) |
ActualOffset |
レイアウト プロセスの配置パス中に計算された、親を基準としたこの UIElement の位置を取得します。 (継承元 UIElement) |
ActualSize |
レイアウト プロセスの配置パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
ActualTheme |
要素で現在使用されている UI テーマを取得します。 これは RequestedTheme とは異なる場合があります。 (継承元 FrameworkElement) |
ActualWidth |
FrameworkElement のレンダリングされた幅を取得します。 「解説」を参照してください。 (継承元 FrameworkElement) |
AllowDrop |
この UIElement をドラッグ アンド ドロップ操作の目的でドロップ ターゲットにできるかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
AllowFocusOnInteraction |
ユーザーが操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 FrameworkElement) |
AllowFocusWhenDisabled |
無効なコントロールがフォーカスを受け取ることができるかどうかを取得または設定します。 (継承元 FrameworkElement) |
Background |
コントロールの背景を提供するブラシを取得または設定します。 (継承元 Control) |
BackgroundSizing |
この要素の境界線に対する背景の延長距離を示す値を取得または設定します。 (継承元 Control) |
BaseUri |
XAML 読み込み時に XAML で構築されたオブジェクトのベース URI (Uniform Resource Identifier) を表す Uniform Resource Identifier (URI) を取得します。 このプロパティは、実行時の URI (Uniform Resource Identifier) 解決に役立ちます。 (継承元 FrameworkElement) |
BorderBrush |
コントロールの境界線の塗りつぶしを表すブラシを取得または設定します。 (継承元 Control) |
BorderThickness |
コントロールの境界線の太さを取得または設定します。 (継承元 Control) |
CacheMode |
レンダリングされたコンテンツを可能な限り複合ビットマップとしてキャッシュする必要があることを示す値を取得または設定します。 (継承元 UIElement) |
CanBeScrollAnchor |
UIElement をスクロール アンカーの候補にできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
CanDrag |
要素をドラッグ アンド ドロップ操作でデータとしてドラッグできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
CenterPoint |
要素の中心点 (回転またはスケーリングが発生するポイント) を取得または設定します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
CharacterCasing |
入力時に、コントロールが文字の大文字と小文字を変更する方法を示す値を取得または設定します。 |
CharacterCasingProperty |
CharacterCasing 依存関係プロパティを識別します。 |
CharacterSpacing |
em の 1/1000 単位の文字間の均一な間隔を取得または設定します。 (継承元 Control) |
Clip |
UIElement の内容のアウトラインを定義するために使用する RectangleGeometry を取得または設定します。 (継承元 UIElement) |
ClipboardCopyFormat |
テキストをすべての形式でコピーするか、プレーン テキストとしてのみコピーするかを指定する値を取得または設定します。 |
ClipboardCopyFormatProperty |
ClipboardCopyFormat 依存関係プロパティを識別します。 |
CompositeMode |
親レイアウトとウィンドウ内の要素の代替合成モードとブレンド モードを宣言するプロパティを取得または設定します。 これは、混合 XAML/Microsoft DirectX UI に関連する要素に関連します。 (継承元 UIElement) |
ContentLinkBackgroundColor |
リンクの背景の色付けに使用するブラシを取得または設定します。 |
ContentLinkBackgroundColorProperty |
ContentLinkBackgroundColor 依存関係プロパティを識別します。 |
ContentLinkForegroundColor |
リンク テキストの色付けに使用するブラシを取得または設定します。 |
ContentLinkForegroundColorProperty |
ContentLinkForegroundColor 依存関係プロパティを識別します。 |
ContentLinkProviders |
この RichEditBox で使用される ContentLink の種類を定義する ContentLinkProviderのコレクションを取得または設定します。 |
ContentLinkProvidersProperty |
ContentLinkProviders 依存関係プロパティを識別します。 |
ContextFlyout |
この要素に関連付けられているポップアップを取得または設定します。 (継承元 UIElement) |
CornerRadius |
コントロールの境界線の角の半径を取得または設定します。 (継承元 Control) |
DataContext |
FrameworkElement のデータ コンテキストを取得または設定します。 データ コンテキストの一般的な用途は、 FrameworkElement が {Binding} マークアップ拡張機能を使用し、データ バインディングに参加する場合です。 (継承元 FrameworkElement) |
DefaultStyleKey |
コントロールの既定のスタイルを参照するキーを取得または設定します。 カスタム コントロールの作成者は、このプロパティを使用して、コントロールが使用するスタイルの既定値を変更します。 (継承元 Control) |
DefaultStyleResourceUri |
コントロールの既定のスタイルを含むリソース ファイルへのパスを取得または設定します。 (継承元 Control) |
Description |
コントロールの下に表示されるコンテンツを取得または設定します。 コンテンツは、コントロールによって期待される入力に関するガイダンスを提供する必要があります。 |
DescriptionProperty |
Description 依存関係プロパティを識別します。 |
DesiredCandidateWindowAlignment |
入力メソッド エディター (IME) の優先配置を示す値を取得または設定します。 |
DesiredCandidateWindowAlignmentProperty |
DesiredCandidateWindowAlignment 依存関係プロパティを識別します。 |
DesiredSize |
レイアウト プロセスのメジャー パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
DisabledFormattingAccelerators |
書式設定が無効になっているキーボード ショートカットを示す値を取得または設定します。 |
DisabledFormattingAcceleratorsProperty |
DisabledFormattingAccelerators 依存関係プロパティを識別します。 |
Dispatcher |
このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject) |
Document |
RichEditBox に含まれるテキストのテキスト オブジェクト モデルにアクセスできるようにするオブジェクトを取得します。 |
ElementSoundMode |
サウンドを再生するかどうかのコントロールの設定を指定する値を取得または設定します。 (継承元 Control) |
ExitDisplayModeOnAccessKeyInvoked |
アクセス キーが呼び出されたときにアクセス キーの表示を閉じるかどうかを指定する値を取得または設定します。 (継承元 UIElement) |
FlowDirection |
レイアウトを制御する任意の親要素内でテキストやその他の UI 要素が流れる方向を取得または設定します。 このプロパティは、 LeftToRight または RightToLeft のいずれかに設定できます。 任意の要素で FlowDirection を RightToLeft に設定すると、配置が右に設定され、読み取り順序が右から左に設定され、コントロールのレイアウトが右から左にフローします。 (継承元 FrameworkElement) |
FocusState |
このコントロールにフォーカスがあるかどうかを示す値と、フォーカスが取得されたモードを取得します。 (継承元 Control) |
FocusVisualMargin |
FrameworkElement のフォーカス ビジュアルの外側の余白を取得または設定します。 (継承元 FrameworkElement) |
FocusVisualPrimaryBrush |
FrameworkElement の または |
FocusVisualPrimaryThickness |
FrameworkElement の または フォーカス ビジュアルの外側の境界線の |
FocusVisualSecondaryBrush |
FrameworkElement の または |
FocusVisualSecondaryThickness |
FrameworkElement の または フォーカス ビジュアルの内側の境界線の |
FontFamily |
コントロール内にテキストを表示するために使用されるフォントを取得または設定します。 (継承元 Control) |
FontSize |
このコントロール内のテキストのサイズを取得または設定します。 (継承元 Control) |
FontStretch |
画面上でのフォントの縮小率または拡大率を取得または設定します。 (継承元 Control) |
FontStyle |
テキストをレンダリングするスタイルを取得または設定します。 (継承元 Control) |
FontWeight |
指定したフォントの太さを取得または設定します。 (継承元 Control) |
Foreground |
前景色を表すブラシを取得または設定します。 (継承元 Control) |
HandwritingView |
このテキスト コントロールに関連付けられている HandwritingView を 取得または設定します。 |
HandwritingViewProperty |
HandwritingView 依存関係プロパティを識別します。 |
Header |
コントロールのヘッダーの内容を取得または設定します。 |
HeaderProperty |
Header 依存関係プロパティを識別します。 |
HeaderTemplate |
コントロールのヘッダーの内容を表示するために使用する DataTemplate を取得または設定します。 |
HeaderTemplateProperty |
HeaderTemplate 依存関係プロパティを識別します。 |
Height |
FrameworkElement の推奨される高さを取得または設定します。 (継承元 FrameworkElement) |
HighContrastAdjustment |
ハイ コントラスト テーマが有効になっている場合に、フレームワークが要素のビジュアル プロパティを自動的に調整するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
HorizontalAlignment |
パネルや項目コントロールなど、レイアウトの親で構成されている場合に FrameworkElement に適用される水平方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
HorizontalContentAlignment |
コントロールのコンテンツの水平方向の配置を取得または設定します。 (継承元 Control) |
HorizontalTextAlignment |
RichEditBox でのテキストの配置方法を示す値を取得または設定します。 |
HorizontalTextAlignmentProperty |
HorizontalTextAlignment 依存関係プロパティを識別します。 |
InputScope |
この RichEditBox で使用される入力のコンテキストを取得または設定します。 |
InputScopeProperty |
InputScope 依存関係プロパティを識別します。 |
IsAccessKeyScope |
要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
IsColorFontEnabled |
Segoe UI Emoji などのカラー レイヤーを含むフォント グリフを色でレンダリングするかどうかを決定する値を取得または設定します。 |
IsColorFontEnabledProperty |
IsColorFontEnabled 依存関係プロパティを識別します。 |
IsDoubleTapEnabled |
DoubleTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsEnabled |
ユーザーがコントロールと対話できるかどうかを示す値を取得または設定します。 (継承元 Control) |
IsFocusEngaged |
コントロール境界内でフォーカスが制限されているかどうかを示す値を取得または設定します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
IsFocusEngagementEnabled |
コントロール境界内でフォーカスを制限できるかどうかを示す値を取得または設定します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
IsHandwritingViewEnabled |
ユーザーが手書きビューにテキストを入力できるかどうかを示す値を取得または設定します。 |
IsHandwritingViewEnabledProperty |
IsHandwritingViewEnabled 依存関係プロパティを識別します。 |
IsHitTestVisible |
この UIElement の包含領域がヒット テストの true 値を返すことができるかどうかを取得または設定します。 (継承元 UIElement) |
IsHoldingEnabled |
Holding イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsLoaded |
要素が要素ツリーに追加され、操作の準備ができているかどうかを示す値を取得します。 (継承元 FrameworkElement) |
IsReadOnly |
ユーザーが RichEditBox 内のテキストを変更できるかどうかを示す値を取得または設定します。 |
IsReadOnlyProperty |
IsReadOnly 依存関係プロパティを識別します。 |
IsRightTapEnabled |
RightTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsSpellCheckEnabled |
テキスト入力がスペル チェック エンジンと対話するかどうかを示す値を取得または設定します。 |
IsSpellCheckEnabledProperty |
IsSpellCheckEnabled 依存関係プロパティを識別します。 |
IsTabStop |
コントロールがタブ ナビゲーションに含まれるかどうかを示す値を取得または設定します。 (継承元 Control) |
IsTapEnabled |
Tapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsTextPredictionEnabled |
この RichEditBox に対してテキスト予測機能 ("オートコンプリート") が有効かどうかを示す値を取得または設定します。 |
IsTextPredictionEnabledProperty |
IsTextPredictionEnabled 依存関係プロパティを識別します。 |
IsTextScaleFactorEnabled |
システム のテキスト サイズ設定を反映するように、自動テキストの拡大を有効にするかどうかを取得または設定します。 (継承元 Control) |
KeyboardAcceleratorPlacementMode |
コントロール のヒント に、関連付けられているキーボード アクセラレータのキーの組み合わせを表示するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
KeyboardAcceleratorPlacementTarget |
アクセラレータ キーの組み合わせを表示 するコントロールヒント を示す値を取得または設定します。 (継承元 UIElement) |
KeyboardAccelerators |
キーボードを使用してアクションを呼び出すキーの組み合わせのコレクションを取得します。 アクセラレータは通常、ボタンまたはメニュー項目に割り当てられます。
|
KeyTipHorizontalOffset |
UIElement に関連してキー ヒントを左右に配置する距離を示す値を取得または設定します。 (継承元 UIElement) |
KeyTipPlacementMode |
アクセス キーのキー ヒントが UIElement の境界に対して配置される場所を示す値を取得または設定します。 (継承元 UIElement) |
KeyTipTarget |
アクセス キーのキー ヒントの対象となる要素を示す値を取得または設定します。 (継承元 UIElement) |
KeyTipVerticalOffset |
UI 要素に関連してキー ヒントを配置する距離を示す値を取得または設定します。 (継承元 UIElement) |
Language |
FrameworkElement に適用されるローカライズ/グローバリゼーション言語情報と、オブジェクト表現と UI の現在の FrameworkElement のすべての子要素を取得または設定します。 (継承元 FrameworkElement) |
Lights |
この要素にアタッチされている XamlLight オブジェクトのコレクションを取得します。 (継承元 UIElement) |
ManipulationMode |
UIElement の動作とジェスチャとの対話に使用される ManipulationModes 値を取得または設定します。 この値を設定すると、アプリ コードでこの要素から操作イベントを処理できます。 (継承元 UIElement) |
Margin |
FrameworkElement の外側の余白を取得または設定します。 (継承元 FrameworkElement) |
MaxHeight |
FrameworkElement の最大高さ制約を取得または設定します。 (継承元 FrameworkElement) |
MaxLength |
ユーザー入力に使用できる最大文字数を指定する値を取得または設定します。 |
MaxLengthProperty |
MaxLength 依存関係プロパティを識別します。 |
MaxWidth |
FrameworkElement の最大幅制約を取得または設定します。 (継承元 FrameworkElement) |
MinHeight |
FrameworkElement の最小高さ制約を取得または設定します。 (継承元 FrameworkElement) |
MinWidth |
FrameworkElement の最小幅制約を取得または設定します。 (継承元 FrameworkElement) |
Name |
オブジェクトの識別名を取得または設定します。 XAML プロセッサが XAML マークアップからオブジェクト ツリーを作成する場合、ランタイム コードはこの名前で XAML で宣言されたオブジェクトを参照できます。 (継承元 FrameworkElement) |
Opacity |
オブジェクトの不透明度の程度を取得または設定します。 (継承元 UIElement) |
OpacityTransition |
Opacity プロパティへの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
Padding |
コントロールのパディングを取得または設定します。 (継承元 Control) |
Parent |
オブジェクト ツリー内のこの FrameworkElement の親オブジェクトを取得します。 (継承元 FrameworkElement) |
PlaceholderText |
ユーザー アクションまたはその他の操作によって値が変更されるまでコントロールに表示されるテキストを取得または設定します。 |
PlaceholderTextProperty |
PlaceholderText 依存関係プロパティを識別します。 |
PointerCaptures |
Pointer 値として表されるすべてのキャプチャされたポインターのセット を取得します 。 (継承元 UIElement) |
PreventKeyboardDisplayOnProgrammaticFocus |
コントロールがプログラムでフォーカスを受け取ったときにスクリーン キーボードを表示するかどうかを示す値を取得または設定します。 |
PreventKeyboardDisplayOnProgrammaticFocusProperty |
PreventKeyboardDisplayOnProgrammaticFocus 依存関係プロパティを識別します。 |
Projection |
この要素をレンダリングするときに適用するパースペクティブ プロジェクション (3-D 効果) を取得または設定します。 (継承元 UIElement) |
ProofingMenuFlyout |
校正コマンドを示すポップアップを取得します。 |
ProofingMenuFlyoutProperty |
ProofingMenuFlyout 依存関係プロパティを識別します。 |
RenderSize |
UIElement の最終的なレンダリング サイズを取得します。 使用は推奨されません。「解説」を参照してください。 (継承元 UIElement) |
RenderTransform |
UIElement のレンダリング位置に影響する変換情報を取得または設定します。 (継承元 UIElement) |
RenderTransformOrigin |
UIElement の境界を基準にして、RenderTransform によって宣言された可能なレンダー変換の原点を取得または設定します。 (継承元 UIElement) |
RequestedTheme |
リソースを決定するために UIElement (およびその子要素) によって使用される UI テーマを取得または設定します。 RequestedTheme で指定した UI テーマは、アプリ レベルの RequestedTheme をオーバーライドできます。 (継承元 FrameworkElement) |
RequiresPointer |
UI 要素がマウス モードをサポートするかどうかを取得または設定します。これは、ゲーム パッドやリモート コントロールなどのポインター以外の入力デバイスとのポインター操作エクスペリエンスをエミュレートします。 (継承元 Control) |
Resources |
ローカルで定義されたリソース ディクショナリを取得します。 XAML では、XAML の暗黙的なコレクション構文を使用して、プロパティ要素の |
Rotation |
時計回りの回転角度を度単位で取得または設定します。 RotationAxis と CenterPoint を基準にして回転します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
RotationAxis |
要素を回転させる軸を取得または設定します。 (継承元 UIElement) |
RotationTransition |
Rotation プロパティの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
Scale |
要素のスケールを取得または設定します。 要素の CenterPoint を基準にスケールします。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
ScaleTransition |
Scale プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
SelectionFlyout |
マウス、タッチ、またはペンを使用してテキストを選択したときに表示されるポップアップを取得または設定します。ポップアップが表示されない場合は null 。 |
SelectionFlyoutProperty |
SelectionFlyout 依存関係プロパティを識別します。 |
SelectionHighlightColor |
選択したテキストを強調表示するために使用するブラシを取得または設定します。 |
SelectionHighlightColorProperty |
SelectionHighlightColor 依存関係プロパティを識別します。 |
SelectionHighlightColorWhenNotFocused |
RichEditBox にフォーカスがない場合に、選択したテキストを強調表示するために使用するブラシを取得または設定します。 |
SelectionHighlightColorWhenNotFocusedProperty |
SelectionHighlightColorWhenNotFocused 依存関係プロパティを識別します。 |
Shadow |
要素によってキャストされる影の効果を取得または設定します。 (継承元 UIElement) |
Style |
レイアウトとレンダリング中にこのオブジェクトに適用されるインスタンス Style を取得または設定します。 (継承元 FrameworkElement) |
TabFocusNavigation |
このコントロールのタブと TabIndex の動作方法を変更する値を取得または設定します。 (継承元 UIElement) |
TabIndex |
ユーザーが Tab キーを使用してアプリ UI 内を移動したときに要素がフォーカスを受け取る順序を示す値を取得または設定します。 (継承元 Control) |
TabNavigation |
このコントロールのタブと TabIndex の動作方法を変更する値を取得または設定します。 注意 Windows 10 Creators Update (ビルド 10.0.15063) 以降では、UiElement 基本クラスで TabFocusNavigation プロパティを使用して、ControlTemplate を使用しないタブ シーケンスにオブジェクトを含めることができます。 |
Tag |
このオブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (継承元 FrameworkElement) |
Template |
コントロール テンプレートを取得または設定します。 コントロール テンプレートは UI でコントロールの視覚的な外観を定義し、XAML マークアップで定義されます。 (継承元 Control) |
TextAlignment |
RichEditBox でのテキストの配置方法を示す値を取得または設定します。 |
TextAlignmentProperty |
TextAlignment 依存関係プロパティを識別します。 |
TextDocument |
RichEditBox に含まれるテキストのテキスト オブジェクト モデルにアクセスできるようにするオブジェクトを取得します。 |
TextReadingOrder |
RichEditBox の読み取り順序の決定方法を示す値を取得または設定します。 |
TextReadingOrderProperty |
TextReadingOrder 依存関係プロパティを識別します。 |
TextWrapping |
テキストの行が RichEditBox の使用可能な幅を超えた場合にテキストの折り返しがどのように行われるかを示す値を取得または設定します。 |
TextWrappingProperty |
TextWrapping 依存関係プロパティを識別します。 |
Transform3D |
この要素をレンダリングするときに適用する 3-D 変換効果を取得または設定します。 (継承元 UIElement) |
TransformMatrix |
要素に適用する変換マトリックスを取得または設定します。 (継承元 UIElement) |
Transitions |
UIElement に適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 UIElement) |
Translation |
要素の x、y、z のレンダリング位置を取得または設定します。 (継承元 UIElement) |
TranslationTransition |
Translation プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
Triggers |
FrameworkElement に対して定義されているアニメーションのトリガーのコレクションを取得します。 一般的に使用されません。 「解説」を参照してください。 (継承元 FrameworkElement) |
UIContext |
要素のコンテキスト識別子を取得します。 (継承元 UIElement) |
UseLayoutRounding |
オブジェクトとそのビジュアル サブツリーのレンダリングで、レンダリングをピクセル全体に合わせた丸め動作を使用するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
UseSystemFocusVisuals |
コントロールがシステムによって描画されるフォーカス ビジュアルを使用するか、コントロール テンプレートで定義されたフォーカス ビジュアルを使用するかを示す値を取得または設定します。 (継承元 Control) |
VerticalAlignment |
パネルや項目コントロールなどの親オブジェクトで構成されている場合に FrameworkElement に適用される垂直方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
VerticalContentAlignment |
コントロールのコンテンツの垂直方向の配置を取得または設定します。 (継承元 Control) |
Visibility |
UIElement の可視性を取得または設定します。 表示されない UIElement はレンダリングされず、目的のサイズをレイアウトに伝達しません。 (継承元 UIElement) |
Width |
FrameworkElement の幅を取得または設定します。 (継承元 FrameworkElement) |
XamlRoot |
この要素が表示される を |
XYFocusDown |
ユーザーが方向パッド (D パッド) を押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
XYFocusDownNavigationStrategy |
ダウン ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusKeyboardNavigation |
キーボード方向矢印を使用してナビゲーションを有効または無効にする値を取得または設定します。 (継承元 UIElement) |
XYFocusLeft |
ユーザーが方向パッド (D パッド) を左に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
XYFocusLeftNavigationStrategy |
左側のナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusRight |
ユーザーが方向パッド (D パッド) を右に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
XYFocusRightNavigationStrategy |
右ナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusUp |
ユーザーが方向パッド (D パッド) を上に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
XYFocusUpNavigationStrategy |
アップ ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
メソッド
イベント
AccessKeyDisplayDismissed |
アクセス キーが表示されなくなったときに発生します。 (継承元 UIElement) |
AccessKeyDisplayRequested |
ユーザーがアクセス キーの表示を要求したときに発生します。 (継承元 UIElement) |
AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了したときに発生します。 (継承元 UIElement) |
ActualThemeChanged |
ActualTheme プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
BringIntoViewRequested |
この要素またはその子孫のいずれかで StartBringIntoView が呼び出されたときに発生します。 (継承元 UIElement) |
CandidateWindowBoundsChanged |
入力メソッド エディター (IME) ウィンドウを開いたり、更新したり、閉じたりしたときに発生します。 |
CharacterReceived |
1 つの構成済み文字が入力キューによって受信されたときに発生します。 (継承元 UIElement) |
ContentLinkChanged |
コンテンツ リンクが追加、削除、または編集されたときに発生します。 |
ContentLinkInvoked |
ユーザーの操作によってリンクがアクティブ化されるときに発生します。 |
ContextCanceled |
コンテキスト入力ジェスチャが操作ジェスチャに続き、コンテキスト ポップアップを開くべきではないことを要素に通知するときに発生します。 (継承元 UIElement) |
ContextMenuOpening |
システムがコンテキスト メニューを表示する対話式操作を処理するときに発生します。 |
ContextRequested |
ユーザーが右クリックなどのコンテキスト入力ジェスチャを完了したときに発生します。 (継承元 UIElement) |
CopyingToClipboard |
コピーしたテキストがクリップボードに移動する前に発生します。 |
CuttingToClipboard |
切り取りテキストがクリップボードに移動する前に発生します。 |
DataContextChanged |
FrameworkElement.DataContext プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
DoubleTapped |
この要素のヒット テスト領域で、それ以外の方法でハンドルされない DoubleTap 相互作用が発生したときに発生します。 (継承元 UIElement) |
DragEnter |
入力システムが、この要素をターゲットとして使用して基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
DragLeave |
入力システムが、この要素を原点として基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
DragOver |
この要素がドロップ先となる可能性のある、基になるドラッグ イベントを入力システムが報告したときに発生します。 (継承元 UIElement) |
DragStarting |
ドラッグ操作が開始されたときに発生します。 (継承元 UIElement) |
Drop |
入力システムがこの要素をドロップ先とするドロップ イベントを報告したときに発生します。 (継承元 UIElement) |
DropCompleted |
ソースとしてこの要素を使用したドラッグ アンド ドロップ操作が終了したときに発生します。 (継承元 UIElement) |
EffectiveViewportChanged |
FrameworkElement の有効なビューポートが変更されたときに発生します。 (継承元 FrameworkElement) |
FocusDisengaged |
コントロール境界からフォーカスが離されたときに発生します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
FocusEngaged |
コントロールの境界内でフォーカスが制限されている場合に発生します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
GettingFocus |
UIElement がフォーカスを受け取る前に発生します。 このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
GotFocus |
UIElement がフォーカスを受け取ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
Holding |
この要素のヒット テスト領域で、それ以外の場合はハンドルされない 保留 操作が発生したときに発生します。 (継承元 UIElement) |
IsEnabledChanged |
IsEnabled プロパティが変更されたときに発生します。 (継承元 Control) |
KeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
KeyUp |
UIElement にフォーカスがあるときにキーボード キーが解放されたときに発生します。 (継承元 UIElement) |
LayoutUpdated |
レイアウト関連のプロパティが値を変更したり、レイアウトを更新するその他のアクションが原因で、ビジュアル ツリーのレイアウトが変更されたときに発生します。 (継承元 FrameworkElement) |
Loaded |
FrameworkElement が構築され、オブジェクト ツリーに追加され、操作の準備ができたときに発生します。 (継承元 FrameworkElement) |
Loading |
FrameworkElement の読み込みが開始されたときに発生します。 (継承元 FrameworkElement) |
LosingFocus |
UIElement がフォーカスを失う前に発生します。 このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
LostFocus |
UIElement がフォーカスを失ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
ManipulationCompleted |
UIElement の操作が完了したときに発生します。 (継承元 UIElement) |
ManipulationDelta |
操作中に入力デバイスが位置を変更したときに発生します。 (継承元 UIElement) |
ManipulationInertiaStarting |
操作中に入力デバイスが UIElement オブジェクトとのコンタクトを失ったときと慣性が開始したときに発生します。 (継承元 UIElement) |
ManipulationStarted |
入力デバイスが UIElement に対する操作を開始すると発生します。 (継承元 UIElement) |
ManipulationStarting |
操作プロセッサを初めて作成するときに発生します。 (継承元 UIElement) |
NoFocusCandidateFound |
ユーザーが (タブまたは方向矢印を使用して) フォーカスを移動しようとしたときに、フォーカス候補が移動方向に見つからないため、フォーカスが移動しない場合に発生します。 (継承元 UIElement) |
Paste |
テキストがコントロールに貼り付けられたときに発生します。 |
PointerCanceled |
接触したポインターが異常に接触を失ったときに発生します。 (継承元 UIElement) |
PointerCaptureLost |
この要素によって以前に保持されていたポインター キャプチャが別の要素または別の場所に移動したときに発生します。 (継承元 UIElement) |
PointerEntered |
ポインターがこの要素のヒット テスト領域に入ったときに発生します。 (継承元 UIElement) |
PointerExited |
ポインターがこの要素のヒット テスト領域から離れると発生します。 (継承元 UIElement) |
PointerMoved |
ポインターがこの要素のヒット テスト領域内に残っている間にポインターが移動したときに発生します。 (継承元 UIElement) |
PointerPressed |
ポインター デバイスがこの要素内で Press アクションを開始したときに発生します。 (継承元 UIElement) |
PointerReleased |
この要素内で、以前に Press アクションを開始したポインター デバイスが解放されたときに発生します。 Press アクションの終了が PointerReleased イベントを発生させる保証はされないことに注意してください。他のイベントが発生する可能性があります。 詳細については、「解説」を参照してください。 (継承元 UIElement) |
PointerWheelChanged |
ポインター ホイールのデルタ値が変更されたときに発生します。 (継承元 UIElement) |
PreviewKeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
PreviewKeyUp |
UIElement にフォーカスがあるときにキーボード キーが解放されたときに発生します。 (継承元 UIElement) |
ProcessKeyboardAccelerators |
キーボード ショートカット (またはアクセラレータ) が押されたときに発生します。 (継承元 UIElement) |
RightTapped |
ポインターが 要素の上にある間に右タップ入力刺激が発生したときに発生します。 (継承元 UIElement) |
SelectionChanged |
テキスト選択が変更されたときに発生します。 |
SelectionChanging |
テキストの選択が変更され始めると発生します。 |
SizeChanged |
ActualHeight または ActualWidth プロパティが FrameworkElement の値を変更したときに発生します。 (継承元 FrameworkElement) |
Tapped |
この要素のヒット テスト領域で、それ以外の場合はハンドルされない Tap 操作が発生したときに発生します。 (継承元 UIElement) |
TextChanged |
RichEditBox でコンテンツが変更されたときに発生します。 |
TextChanging |
編集ボックス内のテキストの変更が開始され、レンダリングされる前に同期的に発生します。 |
TextCompositionChanged |
入力メソッド エディター (IME) を使用してテキストが構成されている場合に発生します。 |
TextCompositionEnded |
ユーザーが入力メソッド エディター (IME) を使用してテキストの作成を停止したときに発生します。 |
TextCompositionStarted |
ユーザーが入力メソッド エディター (IME) を使用してテキストの作成を開始したときに発生します。 |
Unloaded |
このオブジェクトがメイン オブジェクト ツリーに接続されなくなったときに発生します。 (継承元 FrameworkElement) |