Power Apps 中的文字輸入控制項
使用者可在其中鍵入文字、數字和其他資料的方塊。
描述
使用者可藉由鍵入文字輸入控制項來指定資料。 根據您組態應用程式的方式，資料可能新增到資料來源，以便用來計算暫存值或以其他方式併入。
主要屬性
Default – 控制項在遭到使用者變更之前的初始值。
Text – 控制項上顯示的文字，或使用者在控制項中輸入的文字。
其他屬性
AccessibleLabel – 螢幕報讀軟體的標籤。
Align – 文字相對於其控制項水平中心的位置。
BorderColor – 控制項框線的色彩。
BorderStyle – 決定控制項的框線為實線、虛線、點線或無。
BorderThickness – 控制項框線的粗細。
Clear – text-input 控制項是否顯示 「X」，讓使用者可點選或點擊清除該控制項的內容。 僅適用於單行模式。
Color – 控制項文字的色彩。
DelayOutput – 當設為 true 時，使用者輸入會在延遲半秒後登記。 對延遲高額作業極為管用，直到使用者完成輸入文字 (也就是當輸入用於其他公式時進行篩選)。
DisplayMode – 控制項是否允許使用者輸入 (Edit)、只顯示資料 (View) 或者已停用 (Disabled)。
DisabledBorderColor – 如果控制項的 DisplayMode 屬性設定為 Disabled，該控制項框線的色彩。
DisabledColor – 如果 DisplayMode 屬性設定為 Disabled，該控制項文字的色彩。
DisabledFill – 若其 DisplayMode 屬性設定為 Disabled，該控制項背景的色彩。
EnableSpellCheck – 文字輸入控制項是否應使用瀏覽器的拼寫檢查功能。 Power Apps for Windows 不支援此屬性。
Fill – 控制項背景的色彩。
FocusedBorderColor – 當控制項為焦點時的控制項框線色彩。
FocusedBorderThickness – 當控制項為焦點時的控制項框線粗細。
Font – 文字可使用的字型家族名稱。
FontWeight – 控制項的文字字型粗細︰粗體、半粗體、正常，或較細。
Format – 使用者輸入是否僅限於數字或可以是任何文字。 設定為數字時，只能輸入數字和某些數字記號。 支援的符號和格式會依據瀏覽器語言而不同，且無法在各個控制項上設定。
Height – 控制項的頂端和底部邊緣之間的距離。
HintText – 如果是空白的，即會在文字輸入控制項顯示淺灰色文字。
HoverBorderColor – 使用者將滑鼠游標停留在控制項上時，該控制項框線所呈現的色彩。
HoverColor – 使用者將滑鼠游標停留在控制項上時，該控制項文字所呈現的色彩。
HoverFill – 使用者將滑鼠游標停留在控制項上時，該控制項背景所呈現的色彩。
Italic – 控制項中的文字是否為斜體。
LineHeight – 兩者之間的距離，例如文字行或清單中項目之間的距離。
MaxLength – 使用者可以鍵入文字輸入控制項中的字元數。
Mode – 控制項處於 SingleLine、MultiLine 或Password 模式。
OnChange – 使用者變更控制項的值 (例如，調整滑桿) 時，要執行的動作。
OnSelect – 在使用者點選或點擊控制項時，要執行的動作。
PaddingBottom – 控制項中文字與該控制項下邊緣之間的距離。
PaddingLeft – 控制項中文字與該控制項左邊緣之間的距離。
PaddingRight – 控制項中文字與該控制項右邊緣之間的距離。
PaddingTop – 控制項中文字與該控制項上邊緣之間的距離。
PressedBorderColor – 使用者點選或點擊控制項時，該控制項框線所呈現的色彩。
PressedColor – 使用者點選或點擊控制項時，該控制項文字所呈現的色彩。
PressedFill – 使用者點選或點擊控制項時，該控制項背景所呈現的色彩。
RadiusBottomLeft – 控制項左下角的角度 (四捨五入)。
RadiusBottomRight – 控制項右下角的角度 (四捨五入)。
RadiusTopLeft – 控制項左上角的角度 (四捨五入)。
RadiusTopRight – 控制項右上角的角度 (四捨五入)。
Reset – 控制項是否傳回其預設值。
Size – 控制項上文字的字型大小。
Strikethrough – 決定控制項上的文字中間是否有一條線。
TabIndex – 相對於其他控制項的鍵盤導覽順序。
Tooltip – 使用者將滑鼠停留在控制項上時所顯示的說明文字。
Underline – 決定控制項上的文字底部是否有一條線。
VirtualKeyboardMode – 出現在應用程式使用者的觸控螢幕上的虛擬鍵盤類型 (文字或數字)。 Format 屬性判定預設值。 裝置支援會有所不同。 執行 iOS 的裝置版本必須為 12.2 以上。 建議使用的 Android 版本為 9.0，而數字鍵盤的功能因 Android 裝置而異。 Windows 10 不支援此屬性。
Visible – 控制項顯示或隱藏。
Width – 控制項左邊緣與右邊緣之間的距離。
X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。
Y – 控制項頂部邊緣與其父容器 (沒有父容器時則為螢幕) 頂部邊緣之間的距離。
相關函數
範例
收集資料
新增兩個文字輸入控制項，並將它們命名為 inputFirst 和 inputLast。
不知道如何 新增、命名和設定控制項 嗎？
新增按鈕，將其**Text** 屬性設定為 Add，並且將其 OnSelect 屬性設定為以下公式：
Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})以直向/垂直方向新增文字庫，將其 Items 屬性設定為 Names，並且將 Subtitle1 的**Text** 屬性設定為 ThisItem.FirstName。
(非必要) 在範本資源庫中，刪除名為 Body1 的底端標籤，並且將資源庫的 TemplateSize 屬性設定為 80。
按下 F5 鍵，將文字字串鍵入 inputFirst 和 inputLast，然後點擊或點選 Add 按鈕。
(非必要) 新增更多名稱到集合物件，然後按 Esc 鍵返回預設工作區。
提示輸入密碼
新增文字輸入控制項、將它命名為 inputPassword，並且將其 Mode 屬性設定為 Password。
新增標籤，並將其**Text** 屬性設定為下列公式：
If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")按 F5 鍵，然後在 inputPassword 中鍵入 P@ssw0rd。
當您完成輸入密碼時，標籤會停止顯示 Access denied，並且開始顯示 Access granted。
若要返回預設工作區，請按 Esc 鍵。
(非必要) 新增控制項如箭頭，組態它以瀏覽至另一個畫面控制項，僅在使用者輸入密碼之後才顯示。
(非必要) 新增按鈕，設定其**Text** 屬性顯示 Sign in，新增計時器，如果使用者鍵入錯誤的密碼，停用文字輸入控制項一段特定時間，然後點擊或點選 Sign in 按鈕。
協助工具指南
色彩對比
- 適用 標準色彩對比需求。
螢幕助讀程式支援
- AccessibleLabel 必須存在。
鍵盤支援
- TabIndex 必須是零或大於零，鍵盤使用者才能導覽到該處。
- 焦點指標必須清楚可見。 使用 FocusedBorderColor 和 FocusedBorderThickness 達成此目的。