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

說明

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

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

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

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

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

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

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

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

主要屬性

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

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

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

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

DisplayMode – 值可以是編輯、檢視停用。 設定卡片中的控制項是否允許使用者輸入 (編輯)、只顯示資料 (檢視) 或者已停用 (停用)。

  • 允許在編輯和檢視模式中使用單一卡片,方法是設定此屬性,此屬性依預設會繫結至表單行為。
  • 檢視 模式中,子控制項 (例如 文字輸入下拉式清單日期選擇器 ) 只會顯示文字值,而不會呈現任何互動項目或裝飾。

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

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

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

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

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

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

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

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

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

WidthFit – 控制項是否會自動水平成長以填滿容器控制項 (例如編輯表單控制項) 中的任何空白空間。 如果多個卡片的這個屬性設定為 true,它們之間的空間會分割。 如需詳細資訊,請參閱了解資料表單版面配置

其他屬性

BorderColor – 控制項框線的色彩。

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

BorderThickness – 控制項框線的粗細。

Fill – 控制項的背景色彩。

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

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

Visible – 控制項顯示或隱藏。

X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。 對於具有多個資料行之容器中的 卡片 控制項,這個屬性會決定卡片出現的資料行。

Y – 控制項上邊緣與其父容器 (沒有父容器時則為螢幕) 上邊緣之間的距離。 對於具有多個資料列之容器中的 卡片 控制項,這個屬性會決定卡片出現的資料列。

範例

請參閱了解資料卡了解資料表單版面配置以取得範例。