畫布應用程式中的新增圖片控制項
從本機裝置拍照或載入圖像。
描述
使用者可以使用這個控制項從他們的裝置拍照或上傳圖像檔，並使用此內容更新資料來源。 使用者會在行動裝置上看到裝置的選項對話方塊，可選擇拍照或選取一個已可以使用的圖像。
此控制項是包含以下兩個控制項的群組控制項：圖像和新增圖片按鈕。 圖像控制項會顯示已上傳圖像或者如未上傳任何圖像則會顯示預留位置。 新增圖片按鈕會提示預計上傳的圖像。
請參閱圖像控制項參考資料的Image屬性。
限制
圖片控制項具有下列限制：
- 在 iOS 上使用新增圖片控制項時，使用相機或資源庫匯入的圖像不包含中繼資料，如方向、位置資訊或相機設定。
Add Picture 按鈕屬性
AccessibleLabel – 螢幕報讀軟體的標籤。 應該描述新增圖片的目的。
Align – 文字相對於其控制項水平中心的位置。
BorderColor – 控制項框線的色彩。
BorderStyle – 決定控制項的框線為實線、虛線、點線或無。
BorderThickness – 控制項框線的粗細。
ChangePictureText – 當圖像已更新時，出現在按鈕上的文字。
Color – 控制項文字的色彩。
DisabledBorderColor – 如果控制項的 DisplayMode 屬性設定為 Disabled，該控制項框線的色彩。
DisabledColor – 如果 DisplayMode 屬性設定為 Disabled，該控制項文字的色彩。
DisabledFill – 若其 DisplayMode 屬性設定為 Disabled，該控制項背景的色彩。
DisplayMode – 控制項是否允許使用者輸入 (Edit)、只顯示資料 (View) 或者已停用 (Disabled)。
Error - 如果上傳圖像發生問題，本屬性將包含適當的錯誤字串。
Fill – 控制項背景的色彩。
FocusedBorderColor – 當控制項為焦點時的控制項框線色彩。
FocusedBorderThickness – 當控制項為焦點時的控制項框線粗細。
Font – 文字可使用的字型家族名稱。
FontWeight – 控制項的文字字型粗細︰粗體、半粗體、正常，或較細。
Height – 控制項的頂端和底部邊緣之間的距離。
HoverBorderColor – 使用者將滑鼠游標停留在控制項上時，該控制項框線所呈現的色彩。
HoverColor – 使用者將滑鼠游標停留在控制項上時，該控制項文字所呈現的色彩。
HoverFill – 使用者將滑鼠游標停留在控制項上時，該控制項背景所呈現的色彩。
Italic – 控制項中的文字是否為斜體。
Media – 音訊或視訊控制項播放之剪輯的識別碼。
OnChange – 使用者變更控制項的值 (例如，調整滑桿) 時，要執行的動作。
OnSelect – 在使用者點選或按一下控制項時，要執行的動作。
Padding – 匯入或匯出按鈕上的文字與該按鈕邊緣之間的距離。
PressedBorderColor – 使用者點選或點擊控制項時，該控制項框線所呈現的色彩。
PressedColor – 使用者點選或點擊控制項時，該控制項文字所呈現的色彩。
PressedFill – 使用者點選或點擊控制項時，該控制項背景所呈現的色彩。
Reset – 控制項是否傳回其預設值。
Size – 控制項上文字的字型大小。
Strikethrough – 決定控制項上的文字中間是否有一條線。
TabIndex – 相對於其他控制項的鍵盤導覽順序。
Text – 當尚未上傳圖像時出現在按鈕上的文字。
Tooltip – 使用者將滑鼠停留在控制項上時所顯示的說明文字。
Underline – 決定控制項上的文字底部是否有一條線。
UseMobileCamera – 可使用行動相機時，是否直接使用。 如果是 Android 裝置，此屬性需要開啟實驗性設定改善媒體擷取。
VerticalAlign – 文字相對於其控制項垂直中心的位置。
Visible – 控制項顯示或隱藏。
Width – 控制項左邊緣與右邊緣之間的距離。
X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。
Y – 控制項頂部邊緣與其父容器 (沒有父容器時則為螢幕) 頂部邊緣之間的距離。
相關功能
Patch( DataSource, BaseRecord, ChangeRecord )
範例
新增圖像到圖像資源庫控制項
新增新增圖片控制項，然後點擊三次。
不知道如何 新增、命名和設定控制項 嗎？
在 Open 對話方塊中，點擊或點選圖像檔案，然後點擊或點選 Open。
新增**按鈕** 控制項，將它移到新增圖片控制項下方，並且設定**按鈕** 控制項的 OnSelect 屬性為下列公式：
Collect(MyPix, AddMediaButton1.Media)新增垂直資源庫控制項，並且設定其 Items 屬性為 MyPix。
在資源庫選取**圖像** 控制項並設定其Image屬性為 ThisItem.Value。
按 F5，然後點擊或點選**按鈕** 控制項。
新增圖片控制項的圖像會出現在垂直資源庫控制項中。 如果您的圖像沒有與垂直資源庫控制項中**圖像** 控制項相同的外觀比例，請將**圖像** 控制項的 ImagePosition 屬性設定為 符合。
按一下或點選新增圖片控制項，按一下或點選另一個圖像檔，按一下或點選打開，然後按一下或點選您新增的**按鈕** 控制項。
第二個圖像會出現在圖像資源庫控制項。
(自選) 重複上述步驟一或多次，然後藉由按下 Esc 鍵返回預設工作區。
使用 SaveData 函數在本機儲存圖像或使用 Patch 函數更新資料來源。
協助工具指南
適用與**按鈕** 和**圖像** 相同的指南。 此外，請考慮下列各項：
色彩對比
- 新增圖片按鈕的文字和背景之間必須有足夠的對比。 由於上傳的圖像可能有不同色彩，請在新增圖片按鈕上使用不透明的 Fill 確保對比一致。
螢幕助讀程式支援
- 新增圖片按鈕必須有提示使用者新增或變更圖片的 Text 和 ChangePictureText。
鍵盤支援
- 新增圖片按鈕的 TabIndex 必須是零或大於零，鍵盤使用者才能導覽到它。
- 新增圖片按鈕必須有清楚可見的焦點指標。 使用 FocusedBorderColor 和 FocusedBorderThickness 達成此目的。