使用者可以在其中繪製、清除和醒目提示影像區域的控制項。
Description
用戶可以像白板一樣使用此控件，繪製圖表和編寫可以轉換為鍵入文本的單詞。
局限性
手寫筆輸入控制項有下列限制：
- 手寫筆控制項僅部分支援在 Windows 應用程式中使用滑鼠或觸控輸入進行繪圖。 中風可能是間歇性的。 為了順利繪圖，請使用筆或在瀏覽器中運行應用程序。
索引鍵屬性
Image — 代表一般使用者繪製的影像的輸出屬性。
顏色 — 輸入筆劃的顏色。
模式 – 控制項處於 繪製 或 清除 模式。 選取模式已被取代。
其他屬性
AccessibleLabel — 螢幕助讀程式的標籤。 可用來描述控制項的用途，以及替代的輸入方法。
BorderColor – 控制項框線的色彩。
BorderStyle – 控制項的框線是 Solid、 Dashed、 Doted 還是 None。
BorderThickness — 控制項邊框的粗細。
DisplayMode – 控制項是否允許使用者輸入 （編輯） 、只顯示資料 （檢視） 或停用 （已停用） 。
填滿 – 控制項的背景色彩。
高度 – 控制項頂部和底部邊緣之間的距離。
輸入 — 已棄用。 輸入是否支援滑鼠、手寫筆或觸控輸入。 預設值 （7） 支援這三個。
OnSelect – 使用者點選或按一下控制項時要執行的動作。
SelectionColor – 清單中所選項目或項目的文字色彩，或手寫筆控制項中選取工具的色彩。
SelectionThickness — 手寫筆輸入控制項的選取工具粗細。
ShowControls -例如，音訊或視訊播放器是否顯示播放按鈕和音量滑桿，以及手寫筆控制項是否顯示繪圖、清除和清除的圖示。
大小 – 控制項上顯示之文字的字型大小。
工具提示 – 當使用者將滑鼠停留在控制項上時出現的說明文字。
可見 — 控制項是否顯示或隱藏。
寬度 – 控制項的左右邊緣之間的距離。
X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。
Y – 控制項頂部邊緣與其上層容器 (沒有上層容器時則為螢幕) 頂部邊緣之間的距離。
相關功能
Example
建立一組影像
新增 Pen 輸入 控制項，將其命名為 MyDoodles，並將其 ShowControls 屬性設定為 true。
不知道如何 新增、命名和設定控制項？
新增 Button 控制項，將它移至 MyDoodles 下方，然後將 Button 控制項的 Text 屬性設定為顯示 Add。
將 Button 控制項的 OnSelect 屬性設定為下列公式：
收集（塗鴉，{Sketch：MyDoodles.Image}）新增 [影像庫 ] 控制項，將它移至 [按鈕 ] 控制項下方，然後縮小 [影像庫 ] 控制項的寬度，直到顯示三個項目為止。
將 [影像庫] 控制項的 [項目] 屬性設定為 [塗鴉]，然後按 F5。
在 MyDoodles 中繪製影像，然後按一下或點選 [按鈕] 控制項。
您繪製的影像會出現在 [影像庫 ] 控制項中。
（選用）在 [ 手寫筆輸入 ] 控制項中，按一下或點選 [圖示] 以清除您繪製的影像，繪製其他影像，然後按一下或點選 [按鈕] 控制項。
在 Image gallery 控制項中，將 Image 控制項的 OnSelect 屬性設定為下列公式：
刪除（塗鴉，ThisItem）按一下或點選 [ 影像庫 ] 控制項中的繪圖，以移除繪圖。
使用 SaveData 函數將圖面儲存在本端，或使用 Patch 函數將其儲存至資料來源。
協助工具指導方針
色彩對比
以下兩者之間必須有足夠的色彩對比：
- BorderColor 和控制項外部的色彩 （如果有框線）
- 填滿和 控制項外部的色彩 （如果沒有框線）
支援螢幕助讀程式
AccessibleLabel 應該存在。
這很重要
螢幕助讀程式使用者無法存取手寫筆輸入。 一律提供替代形式的輸入。 例如，如果需要草圖，請考慮新增 [ 新增圖片 ] 控制項，讓使用者上傳影像。 兩種方法都可以提供，用戶可以選擇他們更舒服的一種。
鍵盤支援
這很重要
鍵盤使用者無法存取手寫筆輸入。 一律提供替代形式的輸入。 例如，如果需要簽名，請考慮新增 文字輸入 ，讓使用者輸入其名稱。 兩種方法都可以提供，用戶可以選擇他們更舒服的一種。