提供顯示表單編輯表單控制項的單一欄位的顯示和編輯體驗。

說明

顯示表單編輯表單控制項做為顯示和檢視整個記錄的容器。 每個容器都可以保存一組卡片控制項,以顯示個別欄位或提供方法來更新這些欄位。 每張卡片都有 DataField 屬性,可指定它所處理的記錄的欄位。

會針對不同的資料類型和使用者體驗定義預先定義的卡片。 例如,可能有一張卡片編輯具有文字輸入控制項 (最適合與鍵盤搭配使用) 的數字欄位。 另一張卡片可能支援改用滑桿控制項來編輯數字。 選取表單控制項後,即可在右窗格中根據欄位輕鬆選取卡片。

卡片本身會包含控制項。 卡片的控制項構成單一欄位的顯示和編輯體驗。 例如,數字卡片可能包含標籤控制項以提供欄位的顯示名稱,以及文字輸入控制項以提供欄位值的編輯者。 卡片也可能有標籤控制項可顯示任何發生的驗證錯誤,以及常見星號的標籤控制項以表示是必要欄位。

您可以自訂預先定義卡片的控制項,方法是調整其大小、移動它、隱藏它、新增其控制項,以及進行其他變更。 您也可以從可從頭新增控制項的完全空白卡片 (自訂卡片) 開始。

預設會「鎖定」預先定義的卡片。 在鎖定的卡片中,您只能修改卡片的某些屬性或卡片內的控制項,而不能刪除鎖定的卡片。 您可以顯示卡片鎖定,並在 [進階] 檢視的 [檢視] 索引標籤上將其解除鎖定。 如果鎖定屬性,因此無法進行修改,則其名稱旁邊會顯示鎖定圖示。 解除鎖定卡片是一項進階活動,執行時請小心,因為將無法再進行卡片的自動公式產生,而且您無法重新鎖定卡片。

在表單的容器內,有 ThisItem 記錄可供使用,並包含記錄的所有欄位。 例如,卡片的 Default 屬性通常會設定為 ThisItem.*FieldName*。

您可以使用 Parent參考,來設定控制項以參考卡片的內容。 例如,控制項應該使用 Parent.Default 來讀取資料來源中欄位的初始狀態。 使用 Parent 而非直接存取您想要的資訊,可更適當地封裝卡片,而且您可以將它變更為不同的欄位,而不中斷內部公式。

如需如何自訂、解除鎖定以及建立卡片的範例,請參閱了解數據卡

主要屬性

DataField – 這張卡片所顯示和編輯的記錄內的欄位名稱。

  • 將名稱指定為以雙引號括住的單一靜態字串 (例如,"Name"),而非公式。
  • 將其 DataField 屬性設定為「空白」,以將卡片解除繫結。 會忽略已解除繫結的卡片的 ValidUpdate 屬性。

Default – 控制項在使用者變更之前的初始值。

  • 針對卡片中的每個控制項,將此屬性設定為 Parent.Default,以根據資料來源來參考欄位的預設值。 例如,將滑桿的 Default 屬性設定為 Parent.Default,確保使用者使用該滑桿的一般值開始。

DisplayName – 資料來源中欄位的使用者易記名稱。

  • DataSourceInfo 函式會提供資料來源中的這個中繼資料。
  • 卡片內的控制項應該使用 Parent.DisplayName 來參考欄位的名稱。

Error – 驗證失敗時,針對此欄位所顯示的使用者易記錯誤訊息。

  • 呼叫 SubmitForm 時,會設定這個屬性。
  • 此訊息會根據資料來源的中繼資料,並檢查卡片的 Required 屬性,來描述驗證問題。

Required – 編輯資料來源的欄位的卡片是否必須包含值。

  • DataSourceInfo 函式會提供資料來源中的必要中繼資料。
  • 卡片內的控制項應該使用 Parent.Required 來判斷該卡片的欄位是否為必要的。

Update – 要寫回欄位的資料來源的值。

  • 使用這個屬性的公式,提取卡片編輯控制項中的值,以寫回資料來源。 例如,將卡片的 Update 屬性設定為 Slider.Value,以使用該卡片中的滑桿值來更新資料來源。

其他屬性

BorderColor – 控制項框線的色彩。

BorderStyle – 決定控制項的框線為實線虛線點線

BorderThickness – 控制項框線的粗細。

Fill – 控制項的背景色彩。

Height – 控制項的頂端和底部邊緣之間的距離。

Valid卡片編輯表單控制項是否包含已可提交給資料來源的有效項目。

Visible – 控制項顯示或隱藏。

Width – 控制項左邊緣與右邊緣之間的距離。

X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。

Y – 控制項上邊緣與其父容器 (沒有父容器時則為螢幕) 上邊緣之間的距離。

範例

如需範例,請參閱了解數據卡