UITextField 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
文字輸入控制項。
[Foundation.Register("UITextField", true)]
public class UITextField : UIKit.UIControl, IDisposable, UIKit.IUIContentSizeCategoryAdjusting, UIKit.IUITextDraggable, UIKit.IUITextDroppable
type UITextField = class
inherit UIControl
interface IUITextInputTraits
interface INativeObject
interface IDisposable
interface IUIContentSizeCategoryAdjusting
interface IUIKeyInput
interface IUIPasteConfigurationSupporting
interface IUITextDraggable
interface IUITextInput
interface IUITextDroppable
interface IUITextPasteConfigurationSupporting
- 繼承
- 屬性
- 實作
備註
Xamarin API 支援兩種事件通知樣式:使用委派類別的 Objective-C 樣式,或使用事件通知的 C# 樣式。
C# 樣式可讓使用者藉由指派給這個類別屬性的事件,在執行時間新增或移除事件處理常式。 事件處理常式可以是任何方法、匿名方法或 Lambda 運算式。 使用 C# 樣式事件或屬性會將任何手動設定覆寫到 Objective-C 委派或 WeakDelegate 設定。
Objective-C 樣式需要使用者建立衍生自 UITextFieldDelegate 類別的新類別,並將它指派給屬性。 或者,針對低階控制項,建立衍生自 NSObject 的類別,其每個進入點都以 [Export] 屬性正確裝飾。 接著可以將這個物件的實例指派給 WeakDelegate 屬性。
建構函式
UITextField() |
預設建構函式,這個建構函式會初始化這個類別的新實例,不含任何參數。 |
UITextField(CGRect) |
使用指定的框架初始化 UITextField。 |
UITextField(IntPtr) |
建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。 |
UITextField(NSCoder) |
從儲存在 unarchiver 物件中的資料初始化 物件的建構函式。 |
UITextField(NSObjectFlag) |
呼叫衍生類別的建構函式,以略過初始化,並只配置 物件。 |
屬性
AccessibilityActivationPoint |
協助工具專案的螢幕座標。 (繼承來源 UIView) |
AccessibilityAssistiveTechnologyFocusedIdentifiers |
文字輸入控制項。 (繼承來源 UIResponder) |
AccessibilityAttributedHint |
屬性字串,提供協助工具專案行為的簡短描述。 (繼承來源 UIView) |
AccessibilityAttributedLabel |
描述 用途的 UIView 簡短屬性字串。 (繼承來源 UIView) |
AccessibilityAttributedValue |
當 其值與 AccessibilityAttributedLabel 不同時,保存 的值 UIView 的屬性字串。 (繼承來源 UIView) |
AccessibilityCustomActions |
允許將方法加入為 AccessibilityCustomActions 協助工具支援的補充動作。 (繼承來源 UIResponder) |
AccessibilityDragSourceDescriptors |
文字輸入控制項。 (繼承來源 UIResponder) |
AccessibilityDropPointDescriptors |
文字輸入控制項。 (繼承來源 UIResponder) |
AccessibilityElementsHidden |
檢視的協助工具專案是否可見。 (繼承來源 UIView) |
AccessibilityFrame |
協助工具元素的 Frame,以螢幕座標表示。 (繼承來源 UIView) |
AccessibilityHint |
協助工具專案所執行動作的簡短描述。 (繼承來源 UIView) |
AccessibilityIdentifier |
為了協助工具的目的,可唯一識別 |
AccessibilityIgnoresInvertColors |
取得或設定 是否會 UIView 反轉其色彩,以回應這類協助工具要求。 (繼承來源 UIView) |
AccessibilityLabel |
協助工具專案的當地語系化識別碼。 (繼承來源 UIView) |
AccessibilityLanguage |
用來讀出協助工具元素元件之語言的 BCP 47 語言標記。 (繼承來源 UIView) |
AccessibilityNavigationStyle |
取得或設定導覽樣式。 (繼承來源 UIView) |
AccessibilityPath |
允許協助工具專案為非矩形。 (繼承來源 UIView) |
AccessibilityTraits |
的 UIAccessibilityTrait |
AccessibilityValue |
協助工具專案的值。 (繼承來源 UIView) |
AccessibilityViewIsModal |
Voice Over 是否應該忽略同層級元素。 (繼承來源 UIView) |
AdjustsFontForContentSizeCategory |
取得或設定裝置的內容大小類別變更時,是否 UITextField 變更其字型。 |
AdjustsFontSizeToFitWidth |
, Boolean 可控制字型是否應該向下縮放,以確保文字元合控制項。 |
AlignmentRectInsets |
Frame與自動設定搭配使用的 調整。 (繼承來源 UIView) |
AllControlEvents |
與此 UIControl 相關聯的控制項事件。 (繼承來源 UIControl) |
AllowsEditingTextAttributes |
輸入或貼上的文字是否可以變更內容的屬性。 |
AllTargets |
與此 UIControl 相關聯的目標物件。 (繼承來源 UIControl) |
Alpha |
控制檢視的透明度 (Alpha) 值。 (繼承來源 UIView) |
Appearance |
傳回此類別之 UIAppearance 類別的強型別屬性。 |
AttributedPlaceholder |
將預留位置的內容設定為屬性字串。 |
AttributedText |
使用屬性字串設定文字欄位的內容。 |
AutocapitalizationType |
此屬性可控制使用者輸入期間,系統應該如何大寫單字。 |
AutocorrectionType |
此屬性可控制系統在使用者輸入期間應如何套用自動校正。 |
AutoresizingMask |
位元遮罩,指定當接收者超檢視界限變更時,接收者應該如何自行調整大小。 (繼承來源 UIView) |
AutosizesSubviews |
指定當接收者 Bounds 變更時,接收者是否應該自動調整大小 Subviews 。 (繼承來源 UIView) |
Background |
這個屬性包含啟用控制項背景時會顯示的影像。 |
BackgroundColor |
設定 的背景色彩 UIView 。 (繼承來源 UIView) |
BeginningOfDocument |
指定檔開頭的文字位置。 唯讀。 |
BorderStyle |
框線樣式。 |
BottomAnchor |
, NSLayoutYAxisAnchor 定義這個 UIView 的底部。 (繼承來源 UIView) |
Bounds |
檢視的可用框架,使用檢視本身的座標系統指定。 (繼承來源 UIView) |
CanBecomeFirstResponder |
判斷此 UIREsponder 是否願意成為第一個回應者。 (繼承來源 UIResponder) |
CanBecomeFocused |
這 UIView 是否可以成為焦點檢視。 (繼承來源 UIView) |
CanResignFirstResponder |
判斷此 UIResponder 是否願意放棄其第一個回應者狀態。 (繼承來源 UIResponder) |
Center |
容器座標空間中檢視的中心。 (繼承來源 UIView) |
CenterXAnchor |
, NSLayoutXAxisAnchor 定義這個 UIView 的 X 軸中心。 (繼承來源 UIView) |
CenterYAnchor |
, NSLayoutYAxisAnchor 定義這個 UIView 的 Y 軸中心。 (繼承來源 UIView) |
Class |
文字輸入控制項。 (繼承來源 NSObject) |
ClassHandle |
這個類別的控制碼。 |
ClearButtonMode |
此屬性會控制文字欄位中出現 [清除] 按鈕的時機。 |
ClearsContextBeforeDrawing |
指定在呼叫之前清除繪圖緩衝區 DrawRect(CGRect, UIViewPrintFormatter) (繼承來源 UIView) |
ClearsOnBeginEditing |
這個屬性工作表示控制項是否會在編輯之前刪除任何現有的文字。 |
ClearsOnInsertion |
貼上作業是否應該取代現有的內容。 |
ClipsToBounds |
指定 是否 Subviews 受限於 Bounds 接收者的 。 (繼承來源 UIView) |
CollisionBoundingPath |
UIBezierPath取得要用於衝突偵測的 。 (繼承來源 UIView) |
CollisionBoundsType |
取得 , UIDynamicItemCollisionBoundsType 描述用於偵測到衝突的界限類型。 (繼承來源 UIView) |
Constraints |
這個 上的 UIView 自動設定所使用的條件約束。 (繼承來源 UIView) |
ContentMode |
控制檢視界限變更時,檢視的快取點陣圖如何呈現。 (繼承來源 UIView) |
ContentScaleFactor |
每個邏輯座標點的裝置圖元數目。 (繼承來源 UIView) |
ContentStretch |
開發人員不應該使用此已被取代的屬性。 開發人員應該改用 'CreateResizableImage'。 (繼承來源 UIView) |
CoordinateSpace |
傳回 UIView 的座標空間實作。 (繼承來源 UIView) |
CurrentInputModeDidChangeNotification |
CurrentInputModeDidChange 的通知常數 |
DebugDescription |
此物件的開發人員有意義描述。 (繼承來源 NSObject) |
Delegate |
作為類別委派之 UIKit.IUITextFieldDelegate 模型類別的實例。 |
Description |
物件的描述,ToString 的 Objective-C 版本。 (繼承來源 NSObject) |
DidEndEditingReasonKey |
文字輸入控制項。 |
DirectionalLayoutMargins |
取得或設定配置邊界,以配置符合目前語言方向的內容。 (繼承來源 UIView) |
DisabledBackground |
停用控制項時,要顯示在背景中的影像。 |
EffectiveContentHorizontalAlignment |
取得目前的水準對齊方式。 (繼承來源 UIControl) |
EffectiveUserInterfaceLayoutDirection |
取得排列檢視內容的版面配置方向。 (繼承來源 UIView) |
Enabled |
是否啟用此 UIControl。 (繼承來源 UIControl) |
EnablesReturnKeyAutomatically |
值,控制是否自動啟用傳回索引鍵。 |
EndOfDocument |
檔結尾的文字位置。 |
ExclusiveTouch |
限制事件傳遞至此檢視。 (繼承來源 UIView) |
FirstBaselineAnchor |
, NSLayoutYAxisAnchor 根據這個 UIView 中第一行文字的基準定義條件約束。 (繼承來源 UIView) |
Focused |
UIView是否為焦點檢視。 (繼承來源 UIView) |
FocusItemContainer |
取得焦點容器,提供空間資訊給子焦點專案。 (繼承來源 UIView) |
Font |
用於顯示文字的字型。 |
Frame |
相對於其容器的檢視座標。 (繼承來源 UIView) |
GestureRecognizers |
這個 UIView 的 UIGestureRecognizer 陣列。 (繼承來源 UIView) |
Handle |
處理非受控物件標記法) (指標。 (繼承來源 NSObject) |
HasAmbiguousLayout |
|
HasText |
值,表示檢視中是否有文字。 |
HeightAnchor |
, NSLayoutDimension 定義這個 UIView 的高度。 (繼承來源 UIView) |
Hidden |
指定是否 UIView 顯示 。 (繼承來源 UIView) |
Highlighted |
此 UIControl 是否反白顯示。 (繼承來源 UIControl) |
HorizontalAlignment |
此 UIControl 內容的水準對齊方式。 (繼承來源 UIControl) |
InputAccessoryView |
當此控制項成為第一個回應者時要顯示的自訂檢視。 |
InputAccessoryViewController |
取得當成為第一個回應程式時 |
InputAssistantItem |
取得將用來設定快捷方式列的助理。 (繼承來源 UIResponder) |
InputDelegate |
這個 UITextField 的輸入委派物件。 |
InputView |
控制項變成第一個回應者時要使用的自訂檢視。 |
InputViewController |
取得當成為第一個回應程式時 |
InsetsLayoutMarginsFromSafeArea |
取得或設定布林值,控制邊界是否調整為永遠落在安全區域內。 預設為 |
Interactions |
取得或設定目前的互動集。 (繼承來源 UIView) |
IntrinsicContentSize |
的內部內容 UIView 大小。 (繼承來源 UIView) |
IsAccessibilityElement |
|
IsDirectBinding |
文字輸入控制項。 (繼承來源 NSObject) |
IsEditing |
值,指出使用者是否正在編輯檢視中的文字。 唯讀。 |
IsFirstResponder |
傳回這個 UIResponder 是否為第一個回應者。 (繼承來源 UIResponder) |
IsProxy |
文字輸入控制項。 (繼承來源 NSObject) |
KeyboardAppearance |
與檢視搭配使用的鍵盤樣式。 |
KeyboardType |
要與檢視搭配使用的鍵盤類型。 |
KeyCommands |
應該在此 UIResponder 上觸發動作的索引鍵命令。 唯讀。 (繼承來源 UIResponder) |
LastBaselineAnchor |
, NSLayoutYAxisAnchor 根據這個 UIView 中第一行文字的基準定義條件約束。 (繼承來源 UIView) |
Layer |
用於轉譯的核心動畫層。 (繼承來源 UIView) |
LayoutGuides |
UILayoutGuide為此 UIView 定義的 物件。 (繼承來源 UIView) |
LayoutMargins |
配置邊界。 (繼承來源 UIView) |
LayoutMarginsGuide |
定義邊界屬性。 (繼承來源 UIView) |
LeadingAnchor |
, NSLayoutXAxisAnchor 定義這個 UIView 的前置邊緣。 (繼承來源 UIView) |
LeftAnchor |
, NSLayoutXAxisAnchor 定義這個 UIView 的左邊緣。 (繼承來源 UIView) |
LeftView |
顯示在檢視左側的重迭。 |
LeftViewMode |
屬性,決定 LeftView 何時會顯示 。 |
MarkedTextRange |
檔中標示文字的範圍。 唯讀。 |
MarkedTextStyle |
屬性的 , NSDictionary 描述 的 MarkedTextRange 樣式。 |
MaskView |
傳回遮罩檢視。 (繼承來源 UIView) |
MinimumFontSize |
這個屬性代表可用於文字的最小字型大小。 |
MotionEffects |
此檢視的目前動作效果集。 (繼承來源 UIView) |
MultipleTouchEnabled |
控制 UIView 是否可以處理 multitouch 事件。 (繼承來源 UIView) |
NextResponder |
回應鏈結上的下一個回應程式 (繼承來源 UIResponder) |
Opaque |
判斷檢視是否不透明。 (繼承來源 UIView) |
ParentFocusEnvironment |
取得父焦點環境。 (繼承來源 UIView) |
PasswordRules |
取得或設定在 UITextView 中輸入密碼的密碼規則。 |
PasteConfiguration |
物件 UIPasteConfiguration 支援的 |
PasteDelegate |
取得處理文字貼上和文字置放的委派。 |
Placeholder |
這個屬性代表在檢視中沒有文字時要顯示的文字。 |
PreferredFocusedView |
傳 UIView 回應該實際專注的 。 (繼承來源 UIView) |
PreferredFocusEnvironments |
由系統遞迴搜尋的 IUIFocusEnvironment 陣列,以尋找預設焦點檢視。 (繼承來源 UIView) |
PreservesSuperviewLayoutMargins |
保留超級檢視的版面配置邊界。 (繼承來源 UIView) |
ReadableContentGuide |
使用者可以使用最少頭部移動來讀取的區域。 (繼承來源 UIView) |
RestorationIdentifier |
如果不是 |
RetainCount |
傳回物件的目前 Objective-C 保留計數。 (繼承來源 NSObject) |
ReturnKeyType |
屬性是用來取得或設定 UIReturnKeyType 「return」 索引鍵的 。 「return」 索引鍵會根據此屬性顯示不同的文字。 |
RightAnchor |
, NSLayoutXAxisAnchor 定義這個 UIView 的右邊緣。 (繼承來源 UIView) |
RightView |
此屬性會保留文字欄位右側顯示的重迭。 |
RightViewMode |
這個屬性會控制 RightView 何時會出現 。 |
SafeAreaInsets |
取得放置內容的內嵌,讓導覽列、工具列和其他內容不會遮蔽內容的檢視。 (繼承來源 UIView) |
SafeAreaLayoutGuide |
取得放置內容的版面配置指南,讓導覽列、工具列和其他內容不會遮蔽內容的檢視。 (繼承來源 UIView) |
SecureTextEntry |
這個屬性會控制是否應該隱藏所顯示的文字。 |
Selected |
是否選取此 UIControl。 (繼承來源 UIControl) |
SelectedTextRange |
此屬性會傳回選取的文字範圍。 |
SelectionAffinity |
設定值,控制資料指標是否顯示在多行選取範圍的最後一行或最後一行的結尾。 |
Self |
文字輸入控制項。 (繼承來源 NSObject) |
SemanticContentAttribute |
指定 搭配由右至左配置使用時,應該 UIView 維持其配置或翻轉。 (繼承來源 UIView) |
ShouldBeginEditing |
由 物件叫用的委派以取得值。 |
ShouldChangeCharacters |
由 物件叫用的委派以取得值。 |
ShouldClear |
由 物件叫用的委派以取得值。 |
ShouldEndEditing |
由 物件叫用的委派以取得值。 |
ShouldGroupAccessibilityChildren |
UIView不論其位於畫面上的位置為何,是否應該針對語音傳送來分組的子系。 (繼承來源 UIView) |
ShouldReturn |
由 物件叫用的委派以取得值。 |
SmartDashesType |
取得或設定目前的 UITextSmartDashesType ,決定如何處理兩個連字號。 |
SmartInsertDeleteType |
取得或設定目前的 UITextSmartInsertDeleteType ,決定在剪下或貼上文字時如何處理空格。 |
SmartQuotesType |
取得或設定目前的 UITextSmartQuotesType ,判斷單引號是否轉換成引號字元。 |
SpellCheckingType |
此屬性可控制輸入期間是否啟用或停用拼字檢查。 |
State |
表示此 UIControl 狀態的位元遮罩。 唯讀。 (繼承來源 UIControl) |
Subviews |
的陣列 UIView ,包含在 內 |
Superclass |
文字輸入控制項。 (繼承來源 NSObject) |
SuperHandle |
用來表示這個 NSObject 基類中方法的控制碼。 (繼承來源 NSObject) |
Superview |
UIView,如果有任何 ,則包含 |
Tag |
可用來識別特定 UIView 實例的整數。 (繼承來源 UIView) |
Text |
要顯示的文字。 |
TextAlignment |
Text應該如何對齊 。 |
TextBackgroundColorKey |
開發人員不應該使用此已被取代的屬性。 開發人員應該使用 'NSAttributedString.BackgroundColorAttributeName'。 |
TextColor |
的 Text 色彩。 |
TextColorKey |
屬性會保存索引鍵,該索引鍵應該用來從 NSDictionary 擷取文字色彩的值。 |
TextContentType |
欄位應該包含 (資料類型的提示必須是來自 UITextContentType) 的值。 |
TextDidBeginEditingNotification |
TextDidBeginEditing 的通知常數 |
TextDidEndEditingNotification |
TextDidEndEditing 的通知常數 |
TextDragActive |
取得布林值,指出拖曳會話是否為文字檢視使用中。 |
TextDragDelegate |
取得或設定管理拖曳來源行為的委派。 |
TextDragInteraction |
取得文字檢視上的拖曳互動。 |
TextDragOptions |
取得值,控制如何在拖曳的文字中顯示格式。 |
TextDropActive |
取得布林值,指出檢視上是否有使用中文字置放會話。 |
TextDropDelegate |
取得或設定管理文字置放行為的委派。 |
TextDropInteraction |
取得文字檢視上的置放互動。 |
TextFieldTextDidChangeNotification |
TextFieldTextDidChange 的通知常數 |
TextFontKey |
屬性會保存索引鍵,該索引鍵應該用來從 NSDictionary 擷取文字的字型值。 |
TextInputContextIdentifier |
識別碼,指出此 UIResponder 應該保留其文字輸入模式資訊。 唯讀。 (繼承來源 UIResponder) |
TextInputMode |
此 UIResponder 的文字輸入模式。 唯讀。 (繼承來源 UIResponder) |
TextInputView |
這是提供座標系統的檢視。 唯讀。 |
TintAdjustmentMode |
套用至這個 UIView 或其其中一個父檢視的色調調整。 (繼承來源 UIView) |
TintColor |
反白顯示色彩,應該用來指出互動式控制項。 (繼承來源 UIView) |
Tokenizer |
此屬性提供權杖化程式的相關資訊,可用來將文字分成字元、單字、行和段落等單位。 |
TopAnchor |
, NSLayoutYAxisAnchor 定義這個 UIView 的頂端。 (繼承來源 UIView) |
TouchInside |
觸控是否在此 UIControl 內。 唯讀。 (繼承來源 UIControl) |
Tracking |
此 UIControl 是否追蹤與事件相關的觸控。 唯讀。 (繼承來源 UIControl) |
TrailingAnchor |
, NSLayoutXAxisAnchor 定義這個 UIView 的前置邊緣。 (繼承來源 UIView) |
TraitCollection |
傳回特徵集合。 (繼承來源 UIView) |
Transform |
相對於其界限中心之 的 UIView 轉換。 (繼承來源 UIView) |
TranslatesAutoresizingMaskIntoConstraints |
指定自動調整大小遮罩是否應該轉譯為自動設定的條件約束。 (繼承來源 UIView) |
TypingAttributes |
要套用至新類型文字的屬性索引鍵。 |
UndoManager |
回應程式鏈結中最近的共用 NSUndoManager。 唯讀。 (繼承來源 UIResponder) |
UserActivity |
封裝此回應程式所支援之使用者活動的動作。 (繼承來源 UIResponder) |
UserInteractionEnabled |
判斷這個檢視是否處理輸入事件。 (繼承來源 UIView) |
VerticalAlignment |
此 UIControl 內容的垂直對齊方式。 (繼承來源 UIControl) |
ViewForBaselineLayout |
傳 UIView 回應套用基準條件約束的 。 (繼承來源 UIView) |
ViewForFirstBaselineLayout |
覆寫時,可讓應用程式開發人員傳回子檢視作為基準條件約束的基礎。 (繼承來源 UIView) |
ViewForLastBaselineLayout |
覆寫時,可讓應用程式開發人員傳回子檢視作為基準條件約束的基礎。 (繼承來源 UIView) |
ViewPrintFormatter |
傳 UIViewPrintFormatter 回適合 的 UIView 。 (繼承來源 UIView) |
WeakDefaultTextAttributes |
不會防止垃圾收集之文字屬性的參考。 |
WeakDelegate |
物件,可回應此類型的委派通訊協定 |
WeakInputDelegate |
物件,可回應插入文字的委派通訊協定。 |
WeakTokenizer |
此屬性提供權杖化程式的相關資訊,可用來將文字分成字元、單字、行和段落等單位。 |
WidthAnchor |
, NSLayoutDimension 定義這個 UIView 的水準範圍。 (繼承來源 UIView) |
Window | (繼承來源 UIView) |
Zone |
文字輸入控制項。 (繼承來源 NSObject) |
方法
事件
AllEditingEvents |
在任何產生的編輯事件上引發。 (繼承來源 UIControl) |
AllEvents |
針對產生的任何事件引發。 (繼承來源 UIControl) |
AllTouchEvents |
針對產生的任何觸控事件引發。 (繼承來源 UIControl) |
EditingChanged |
元件已變更。 (繼承來源 UIControl) |
EditingDidBegin |
編輯已啟動時引發。 (繼承來源 UIControl) |
EditingDidEnd |
編輯結束時引發。 (繼承來源 UIControl) |
EditingDidEndOnExit |
在 didEndOnexit 上引發 (繼承來源 UIControl) |
Ended |
編輯結束時引發。 |
EndedWithReason |
編輯結束時引發的事件。 |
PrimaryActionTriggered |
與 最可能的行為 UIControl 相關聯的事件。 (繼承來源 UIControl) |
Started |
編輯開始時引發。 |
TouchCancel |
觸控事件已取消。 (繼承來源 UIControl) |
TouchDown |
當使用者觸碰控制項時引發。 (繼承來源 UIControl) |
TouchDownRepeat |
當使用者按兩下控制項時引發。 (繼承來源 UIControl) |
TouchDragEnter |
在 TouchDragEnter 事件上引發。 (繼承來源 UIControl) |
TouchDragExit |
在 TouchDragExit 事件上引發。 (繼承來源 UIControl) |
TouchDragInside |
引發 oN TouchDragInside 事件。 (繼承來源 UIControl) |
TouchDragOutside |
在 TouchDragOutside 事件上引發。 (繼承來源 UIControl) |
TouchUpInside |
在 TouchUpInside 事件上引發。 (繼承來源 UIControl) |
TouchUpOutside |
在 TouchUpOutside 事件上引發。 (繼承來源 UIControl) |
ValueChanged |
值已變更。 (繼承來源 UIControl) |