RichEditBox 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示支援格式化文字、超連結和其他豐富內容的 RTF 編輯控制件。
/// [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 RichEditBox : Control[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 RichEditBox : ControlPublic Class RichEditBox
Inherits Control<RichEditBox .../>
- 繼承
- 屬性
範例
提示
如需詳細資訊、設計指引和程式碼範例，請參閱 豐富編輯方塊。
WinUI 3 資源庫應用程式包含大部分 WinUI 3 控制件、特性和功能的互動式範例。 從 Microsoft Store 取得應用程式，或在 GitHub 上取得原始程式碼
此範例示範如何使用 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 格式 (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 也可以顯示 RTF 格式 (.rtf) 檔，包括超連結和影像 (.jpg、.png 等) 。 此控件是針對進階文字編輯案例所設計。 針對簡單的純文本輸入，例如在窗體上，請考慮使用 TextBox。
您可以使用 RichEditBox 的 Document 屬性取得其內容。 RichEditBox 的內容是 Windows.UI.Text.ITextDocument 物件，可讓您存取基礎 文字物件模型 API。 如需可用來處理文字檔的 API，請參閱 Windows.UI.Text 命名空間。
如需詳細資訊和範例，請參閱 RichEditBox 控件指南。
手寫筆輸入
XAML 文字輸入方塊使用 Windows Ink 特別提供手寫筆輸入的內嵌支援。 當使用者使用 Windows 手寫筆點選文字輸入方塊時，文字方塊會改變形式，讓使用者使用手寫筆直接在其中書寫，而不是開啟另一個輸入面板。
如需詳細資訊，請參閱含手寫檢視的文字輸入。
控件樣式和範本
您可以修改預設 的 Style 和 ControlTemplate ，讓控件具有唯一的外觀。 如需修改控件樣式和範本的相關信息，請參閱 XAML 樣式。 定義控件外觀的預設樣式、範本和資源會包含在檔案中 generic.xaml 。 為了設計目的，generic.xaml會與 Windows 應用程式 SDK NuGet 套件一起安裝。 根據預設，此位置為 \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml。 不同 SDK 版本的樣式和資源可能會有不同的值。
XAML 也包含可用來修改不同視覺狀態中控件色彩的資源，而不需修改控件範本。 建議您修改這些資源來設定 背景 和 前景等屬性。 如需詳細資訊，請參閱 XAML 樣式一文的輕量樣式一節。
開頭TextControl的資源是由 TextBox、PasswordBox 和 RichEditBoxAutoSuggestBox 共用。 這些資源的變更會影響這四個控件。
建構函式
| 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 |
取得統一資源識別元 (URI) ，代表 XAML 載入時間 XAML 建構物件的基底 URI。 此屬性適用於運行時間的 URI 解析。 (繼承來源 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) |
| ContextFlyout |
取得或設定與這個項目相關聯的飛出視窗。 (繼承來源 UIElement) |
| CornerRadius |
取得或設定控件框線角落的半徑。 (繼承來源 Control) |
| DataContext |
取得或設定 FrameworkElement 的數據內容。 數據內容的常見用法是當 |
| DefaultStyleKey |
取得或設定參考控件預設樣式的索引鍵。 自定義控件的作者會使用此屬性來變更其控件所使用的樣式預設值。 (繼承來源 Control) |
| DefaultStyleResourceUri |
取得或設定資源文件的路徑，其中包含控件的默認樣式。 (繼承來源 Control) |
| Description |
取得或設定控制件下方顯示的內容。 內容應該提供控件預期之輸入的指引。 |
| DescriptionProperty |
識別 Description 相依性屬性。 |
| DesiredCandidateWindowAlignment |
取得或設定值，這個值表示輸入法 編輯器 (輸入法) 慣用的對齊方式。 |
| DesiredCandidateWindowAlignmentProperty |
識別 DesiredCandidateWindowAlignment 相依性屬性。 |
| DesiredSize |
取得這個 UIElement 在版面配置程式的量值階段期間計算的大小。 (繼承來源 UIElement) |
| DisabledFormattingAccelerators |
取得或設定值，這個值表示停用格式化的鍵盤快捷方式。 |
| DisabledFormattingAcceleratorsProperty |
識別 DisabledFormattingAccelerators 相依性屬性。 |
| Dispatcher |
一律會在 Windows 應用程式 SDK 應用程式中傳回 |
| DispatcherQueue |
|
| Document |
取得 對象，這個物件可讓您存取 RichEditBox 中所包含之文字的文字物件模型。 |
| ElementSoundMode |
取得或設定值，指定是否播放音效的控件喜好設定。 (繼承來源 Control) |
| ExitDisplayModeOnAccessKeyInvoked |
取得或設定值，指定叫用存取金鑰時是否關閉存取金鑰顯示。 (繼承來源 UIElement) |
| FlowDirection |
取得或設定文字和其他UI元素在控制其版面配置的任何父元素內流動的方向。 這個屬性可以設定為 |
| FocusState |
取得值，指定這個控件是否有焦點，以及取得焦點的模式。 (繼承來源 UIElement) |
| FocusVisualMargin |
取得或設定 FrameworkElement 焦點視覺效果的外部邊界。 (繼承來源 FrameworkElement) |
| FocusVisualPrimaryBrush |
取得或設定筆刷，用來繪製 FrameworkElement 之或 |
| FocusVisualPrimaryThickness |
取得或設定 FrameworkElement 之外部 |
| FocusVisualSecondaryBrush |
取得或設定筆刷，用來繪製 FrameworkElement 之或 |
| FocusVisualSecondaryThickness |
取得或設定 FrameworkElement 之 |
| FontFamily |
取得或設定顯示控制項的文字所用的字型。 (繼承來源 Control) |
| FontSize |
取得或設定這個控制件中的文字大小。 (繼承來源 Control) |
| FontStretch |
取得或設定螢幕上字型緊縮或加寬的程度。 (繼承來源 Control) |
| FontStyle |
取得或設定轉譯文字的樣式。 (繼承來源 Control) |
| FontWeight |
取得或設定指定字型的粗細。 (繼承來源 Control) |
| Foreground |
取得或設定描述前景色彩的筆刷。 (繼承來源 Control) |
| Header |
取得或設定控件標頭的內容。 |
| HeaderProperty |
識別 標頭 相依性屬性。 |
| 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 |
取得或設定值，指出當使用者按下遊戲控制器上的 A/Select 按鈕時，焦點是否受限於控件。 (繼承來源 Control) |
| IsFocusEngagementEnabled |
取得或設定值，指出當使用者按下遊戲控制器上的 A/Select 按鈕時，焦點是否可以限制為控件。 (繼承來源 Control) |
| IsHitTestVisible |
取得或設定這個 UIElement 的自主區域是否可以傳回真正的值來進行點擊測試。 (繼承來源 UIElement) |
| IsHoldingEnabled |
取得或設定值，這個值會決定 Holding 事件是否可以來自該專案。 (繼承來源 UIElement) |
| IsLoaded |
取得值，這個值表示專案是否已加入至專案樹狀結構，且已準備好進行互動。 (繼承來源 FrameworkElement) |
| IsReadOnly |
取得或設定值，這個值表示使用者是否可以變更 RichEditBox 中的文字。 |
| IsReadOnlyProperty |
識別 IsReadOnly 相依性屬性。 |
| IsRightTapEnabled |
取得或設定值，這個值會判斷 RightTapped 事件是否可以來自該專案。 (繼承來源 UIElement) |
| IsSpellCheckEnabled |
取得或設定值，這個值表示文字輸入是否應該與拼字檢查引擎互動。 |
| IsSpellCheckEnabledProperty |
識別 IsSpellCheckEnabled 相依性屬性。 |
| IsTabStop |
取得或設定值，這個值表示控制項是否包含於索引標籤巡覽。 (繼承來源 UIElement) |
| 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 |
取得或設定 ScalarTransition，以動畫顯示 Opacity 屬性的變更。 (繼承來源 UIElement) |
| Padding |
取得或設定控制項內部的邊框間距。 (繼承來源 Control) |
| Parent |
取得物件樹狀結構中這個 FrameworkElement 的父物件。 (繼承來源 FrameworkElement) |
| PlaceholderText |
取得或設定控制件中顯示的文字，直到使用者動作或其他作業變更值為止。 |
| PlaceholderTextProperty |
識別 PlaceholderText 相依性屬性。 |
| PointerCaptures |
取得所有擷取指標的集合，表示為 指標 值。 (繼承來源 UIElement) |
| PreventKeyboardDisplayOnProgrammaticFocus |
取得或設定值，這個值表示當控件以程序設計方式接收焦點時是否顯示螢幕上的鍵盤。 |
| PreventKeyboardDisplayOnProgrammaticFocusProperty | |
| Projection |
取得或設定轉譯這個專案時要套用的 3D 效果) (3D 效果。 (繼承來源 UIElement) |
| ProofingMenuFlyout |
取得顯示校訂命令的飛出視窗。 |
| ProofingMenuFlyoutProperty |
識別 ProofingMenuFlyout 相依性屬性。 |
| ProtectedCursor |
取得或設定指標在這個專案上方時所顯示的游標。 默認值為 null，表示數據指標沒有變更。 (繼承來源 UIElement) |
| RasterizationScale |
取得值，表示每個檢視圖元的原始 (實體) 像素數目。 (繼承來源 UIElement) |
| RenderSize |
取得 UIElement的最終轉譯大小。 不建議使用，請參閱。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定會影響 UIElement轉譯位置的轉換資訊。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform 所宣告之任何可能轉譯轉換的原點，相對於 UIElement 的界限。 (繼承來源 UIElement) |
| RequestedTheme |
取得或設定 UIElement (及其子元素) 用於資源判斷的 UI 主題。 您指定的 |
| RequiresPointer |
取得或設定UI元素是否支援滑鼠模式，以模擬指標互動體驗與非指標輸入設備，例如鍵盤或遊戲控制器。 (繼承來源 Control) |
| Resources |
取得本機定義的資源字典。 在 XAML 中，您可以透過 XAML 隱含集合語法，將資源專案建立為屬性專案的子物件專案 |
| Rotation |
取得或設定順時針旋轉的角度，以度為單位。 相對於 RotationAxis 和 CenterPoint 旋轉。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| RotationAxis |
取得或設定座標軸，以繞著旋轉專案。 (繼承來源 UIElement) |
| RotationTransition |
取得或設定 ScalarTransition，以動畫顯示 Rotation 屬性的變更。 (繼承來源 UIElement) |
| Scale |
取得或設定專案的刻度。 相對於專案的 CenterPoint 進行調整。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| ScaleTransition |
取得或設定 Vector3Transition，以動畫顯示 Scale 屬性的變更。 (繼承來源 UIElement) |
| SelectionFlyout |
取得或設定使用滑鼠、觸控或手寫筆選取文字時所顯示的飛出視窗;如果未顯示飛出視窗，則為 null 。 |
| SelectionFlyoutProperty |
識別 SelectionFlyout 相依性屬性。 |
| SelectionHighlightColor |
取得或設定筆刷，用來反白顯示選取的文字。 |
| SelectionHighlightColorProperty |
識別 SelectionHighlightColor 相依性屬性。 |
| SelectionHighlightColorWhenNotFocused |
取得或設定筆刷，當 RichEditBox 沒有焦點時，用來反白顯示選取的文字。 |
| SelectionHighlightColorWhenNotFocusedProperty |
識別 SelectionHighlightColorWhenNotFocused 相依性屬性。 |
| Shadow |
取得或設定 元素所轉換的陰影效果。 (繼承來源 UIElement) |
| Style |
取得或設定配置和轉譯期間針對這個物件套用的實例 Style 。 (繼承來源 FrameworkElement) |
| TabFocusNavigation |
取得或設定值，這個值會修改Tabbing和 TabIndex 對此控件的運作方式。 (繼承來源 UIElement) |
| TabIndex |
取得或設定值，決定當使用者使用 Tab 鍵瀏覽控制項時，元素接收焦點的順序。 (繼承來源 UIElement) |
| TabNavigation |
取得或設定值，這個值會修改Tabbing和 UIElement.TabIndex 對此控件的運作方式。 注意 針對 Windows 10 Creators Update (組建 10.0.15063) 和更新版本，TABFocusNavigation 屬性可在 UIElement 基類上使用，以在不使用 ControlTemplate 的索引卷標序列中包含物件。 |
| Tag |
取得或設定任意物件值，可用來儲存這個物件的自定義資訊。 (繼承來源 FrameworkElement) |
| Template |
取得或設定控制項範本。 控件範本會定義 UI 中控制件的視覺外觀，並在 XAML 標記中定義。 (繼承來源 Control) |
| TextAlignment |
取得或設定值，指出 RichEditBox 中的文字對齊方式。 |
| TextAlignmentProperty |
識別 TextAlignment 相依性屬性。 |
| TextDocument |
取得 對象，這個物件可讓您存取 RichEditBox 中包含的文字文字物件模型。 |
| TextReadingOrder |
取得或設定值，這個值表示 RichEditBox 的讀取順序如何決定。 |
| TextReadingOrderProperty |
識別 TextReadingOrder 相依性屬性。 |
| TextWrapping |
取得或設定值，這個值表示如果文字行超出 RichEditBox 的可用寬度，則文字換行的方式。 |
| TextWrappingProperty |
識別 TextWrapping 相依性屬性。 |
| Transform3D |
取得或設定轉譯這個專案時要套用的 3D 轉換效果。 (繼承來源 UIElement) |
| TransformMatrix |
取得或設定要套用至項目的轉換矩陣。 (繼承來源 UIElement) |
| Transitions |
取得或設定套用至 UIElement 的 Transition 樣式專案集合。 (繼承來源 UIElement) |
| Translation |
取得或設定專案的 x、y 和 z 轉譯位置。 (繼承來源 UIElement) |
| TranslationTransition |
取得或設定 Vector3Transition，以動畫顯示 Translation 屬性的變更。 (繼承來源 UIElement) |
| Triggers |
取得針對 FrameworkElement 定義的動畫觸發程式集合。 不常使用。 請參閱＜備註＞。 (繼承來源 FrameworkElement) |
| UseLayoutRounding |
取得或設定值，這個值會決定物件及其視覺子樹的轉譯是否應該使用四捨五入行為，將轉譯對齊整個圖元。 (繼承來源 UIElement) |
| UseSystemFocusVisuals |
取得或設定值，這個值表示控件是否使用由系統繪製的焦點視覺效果，或控件範本中定義的焦點視覺效果。 (繼承來源 UIElement) |
| VerticalAlignment |
取得或設定在面板或專案控件等父物件中撰寫時套用至 FrameworkElement 的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalContentAlignment |
取得或設定控制項內容的垂直對齊。 (繼承來源 Control) |
| Visibility |
取得或設定 UIElement的可見性。 |
| Width |
取得或設定 FrameworkElement 的寬度。 (繼承來源 FrameworkElement) |
| XamlRoot |
取得或設定 |
| XYFocusDown |
取得或設定當使用者按下遊戲控制器的 Directional Pad (D-pad) 時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusDownNavigationStrategy |
取得或設定值，指定用來判斷向下導覽目標元素的策略。 (繼承來源 UIElement) |
| XYFocusKeyboardNavigation |
取得或設定值，這個值會啟用或停用使用鍵盤方向箭號的流覽。 (繼承來源 UIElement) |
| XYFocusLeft |
取得或設定當用戶在遊戲控制器的 Directional Pad (D-pad) 左鍵時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusLeftNavigationStrategy |
取得或設定值，指定用來判斷左側導覽目標元素的策略。 (繼承來源 UIElement) |
| XYFocusRight |
取得或設定當使用者在遊戲控制器的 Directional Pad (D-pad) 上按下滑鼠右鍵時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusRightNavigationStrategy |
取得或設定值，指定用來判斷右導覽之目標元素的策略。 (繼承來源 UIElement) |
| XYFocusUp |
取得或設定當使用者按下遊戲控制器的 Directional Pad (D-pad) 時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusUpNavigationStrategy |
取得或設定值，指定用來判斷向上瀏覽目標元素的策略。 (繼承來源 UIElement) |
方法
事件
| AccessKeyDisplayDismissed |
發生於不應再顯示存取金鑰時。 (繼承來源 UIElement) |
| AccessKeyDisplayRequested |
發生於使用者要求顯示存取金鑰時。 (繼承來源 UIElement) |
| AccessKeyInvoked |
發生於使用者完成存取金鑰序列時。 (繼承來源 UIElement) |
| ActualThemeChanged |
發生於 ActualTheme 屬性值已變更時。 (繼承來源 FrameworkElement) |
| BringIntoViewRequested |
在這個專案或其中一個子代上呼叫 StartBringIntoView 時發生。 (繼承來源 UIElement) |
| CandidateWindowBoundsChanged |
當輸入法 編輯器 (輸入法) 視窗開啟、更新或關閉時發生。 |
| CharacterReceived |
發生於輸入佇列收到單一、撰寫的字元時。 (繼承來源 UIElement) |
| 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 |
當使用者按下遊戲控制器上的 B/上一頁按鈕時，會從控件放開焦點時發生。 (繼承來源 Control) |
| FocusEngaged |
發生於使用者按下遊戲控制器上的 A/Select 按鈕時，焦點受限於控件。 (繼承來源 Control) |
| GettingFocus |
發生於 UIElement 收到焦點之前。 此事件會同步引發，以確保事件反升時不會移動焦點。 (繼承來源 UIElement) |
| GotFocus |
發生於 UIElement 收到焦點時。 此事件會以異步方式引發，因此焦點可以在反升完成之前再次移動。 (繼承來源 UIElement) |
| Holding |
發生於在此元素的點擊測試區域上發生未處理的 保留 互動時。 (繼承來源 UIElement) |
| IsEnabledChanged |
發生於 IsEnabled 屬性變更時。 (繼承來源 Control) |
| KeyDown |
在 UIElement 有焦點時按下鍵盤按鍵時發生。 (繼承來源 UIElement) |
| KeyUp |
發生於 UIElement 有焦點時放開鍵盤按鍵時。 (繼承來源 UIElement) |
| LayoutUpdated |
發生於可視化樹狀結構的版面配置變更時，因為配置相關屬性變更值或重新整理版面配置的其他動作。 (繼承來源 FrameworkElement) |
| Loaded |
發生於 架構Element 已建構並新增至物件樹狀結構，並準備好進行互動時。 (繼承來源 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 |
發生於先前起始 按下 動作的指標裝置放開時，同時在此元素內。 請注意， 按下動作的 結尾不保證會引發 |
| PointerWheelChanged |
發生於指標滾輪的差異值變更時。 (繼承來源 UIElement) |
| PreviewKeyDown |
在 UIElement 有焦點時按下鍵盤按鍵時發生。 (繼承來源 UIElement) |
| PreviewKeyUp |
發生於 UIElement 有焦點時放開鍵盤按鍵時。 (繼承來源 UIElement) |
| ProcessKeyboardAccelerators |
發生於按下 鍵盤快捷方式 (或快捷鍵) 時。 (繼承來源 UIElement) |
| RightTapped |
發生於在指標位於 元素上方時發生右鍵輸入回應時。 (繼承來源 UIElement) |
| SelectionChanged |
文字選取變更時發生。 |
| SelectionChanging |
發生於文字選取範圍開始變更時。 |
| SizeChanged |
發生於 ActualHeight 或 ActualWidth 屬性變更 FrameworkElement 上的值時。 (繼承來源 FrameworkElement) |
| Tapped |
發生於未處理的 點 選互動發生於這個項目的點擊測試區域。 (繼承來源 UIElement) |
| TextChanged |
發生於 RichEditBox 中的內容變更時。 |
| TextChanging |
當編輯方塊中的文字開始變更，但在轉譯之前，就會同步發生。 |
| TextCompositionChanged |
發生於透過輸入法撰寫的文字 編輯器 (輸入法) 變更時。 |
| TextCompositionEnded |
發生於使用者透過輸入法 編輯器 (輸入法) 停止撰寫文字時。 |
| TextCompositionStarted |
發生於使用者透過輸入法開始撰寫文字時，編輯器 (輸入法) 。 |
| Unloaded |
當這個物件不再連接到主物件樹狀結構時發生。 (繼承來源 FrameworkElement) |
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應