共用方式為


Power Apps 中的清單方塊控制項

使用者可以在其中選取一或多個項目的清單。

Description

清單方塊控制項一律會顯示所有可用的選項 (與下拉式控制項不同) ,而且使用者可以一次選擇多個項目 (與無線電控制項不同)。

索引鍵屬性

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

備註

您只能有一個預設選取的項目。 如果您需要多個選取的項目,請使用 Combo Box 控制項。

項目 — 出現在控制項 (例如圖庫、清單或圖表) 中的資料來源。

當您新增資源庫、清單或圖表時,屬性清單預設會顯示 [項目] ,以便您可以輕鬆指定新控制項應顯示的資料。 例如,您可以將資源庫的 Items 屬性設定為 Salesforce 中的 [帳戶 ] 資料表、您在 Excel 中建立並上傳至雲端的名為 [清查] 的資料表,或名為 ConferenceSpeakers 的清單。

其他屬性

AccessibleLabel — 螢幕助讀程式的標籤。

BorderColor – 控制項框線的色彩。

BorderStyle – 控制項的框線是 SolidDashedDoted 還是 None

BorderThickness — 控制項邊框的粗細。

顏色 – 控制項中文字的顏色。

DisplayMode – 控制項是否允許使用者輸入 (編輯) 、只顯示資料 (檢視) 或停用 (已停用) 。

DisabledBorderColor -如果控制項的 DisplayMode 屬性設定為 Disabled,則控制項框線的色彩。

DisabledColor – 控制項中文字的色彩,如果其 DisplayMode 屬性設定為 Disabled

DisabledFill – 控制項的背景色彩 (如果控制項的 DisplayMode 屬性設定為 Disabled)。

填滿 – 控制項的背景色彩。

FocusedBorderColor – 控制項聚焦時控制項框線的色彩。

FocusedBorderThickness – 控制項聚焦時控制項框線的粗細。

字型 — 顯示文字的字型系列名稱。

FontWeight – 控制項中文字的粗細: 粗體半粗體正常較輕

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

HoverBorderColor – 當使用者將滑鼠指標保留在控制項上時,控制項框線的色彩。

HoverColor – 當使用者將滑鼠指標放在控制項上時,控制項中文字的色彩。

HoverFill – 當使用者將滑鼠指標放在控制項上時,控制項的背景色彩。

斜體 – 控制項中的文字是否為斜體。

ItemPaddingLeft — 清單方塊中的文字與其左邊緣之間的距離。

LineHeight — 例如,清單中的文字行或項目之間的距離。

OnChange — 使用者變更控制項值時要執行的動作 (例如,透過調整滑桿)。

OnSelect – 使用者點選或按一下控制項時要執行的動作。

PaddingBottom – 控制項中的文字與該控制項底部邊緣之間的距離。

PaddingLeft – 控制項中文字與該控制項左邊緣之間的距離。

PaddingRight – 控制項中的文字與該控制項右邊緣之間的距離。

PaddingTop – 控制項中的文字與該控制項的上邊緣之間的距離。

PressedBorderColor – 使用者點選或按一下控制項時,控制項框線的色彩。

PressedColor – 使用者點選或按一下控制項時,控制項中的文字色彩。

PressedFill – 使用者點選或按一下控制項時控制項的背景色彩。

重設 — 控制項是否還原為其預設值。

已選取 — 代表所選項目的資料記錄。

備註

您只能有一個預設選取的項目。 如果您需要多個選取的項目,請使用 Combo Box 控制項。

所選項目 - 唯讀。 代表多重選取清單方塊所選項目的資料表。

選取項目文字 - 唯讀。 代表多重選取清單方塊之所選項目文字的資料表。

SelectedText (已棄用) — 代表所選項目的字串值。

SelectionColor – 清單中所選項目或項目的文字色彩,或手寫筆控制項中選取工具的色彩。

SelectionFill – 清單中一或多個項目的背景色彩,或手寫筆控制項的選取區域。

SelectMultiple — 使用者是否可以在清單方塊中選取多個項目。

大小 – 控制項上顯示之文字的字型大小。

刪除線 – 是否顯示在控制項上顯示的文字中顯示一行。

TabIndex – 與其他控制項相關的鍵盤導覽順序。

工具提示 – 當使用者將滑鼠停留在控制項上時出現的說明文字。

底線 – 是否顯示在控制項上顯示的文字下方顯示一行。

可見 — 控制項是否顯示或隱藏。

寬度 – 控制項的左右邊緣之間的距離。

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

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

DistinctDataSourceColumnName

Example

  1. 新增 List box 控制項,將其命名為 CategoryList,並將其 Items 屬性設定為下列公式:
    [“地毯”,“硬木”,“瓷磚”]

    不知道如何 新增、命名和設定控制項

    清單框中的地板類別。

  2. 新增三個 下拉 式控制項,將它們移至 CategoryList 底下,並命名為 CarpetListHardwoodListTileList

  3. 將每個下拉式控制項的 Items 屬性設定為下列其中一個值:

    • 地毯清單: [“Caserta Stone Beige”,“Ageless Beauty Clay”,“Lush II Tundra”]

    • 硬木清單: [“金柚木”、“天然山核桃木”、“維多利亞桃花心木”]

    • TileList: [“蜂蜜縞瑪瑙大理石”,“印度秋季石板”,“Panaria Vitality 陶瓷”]

      下拉列表中的地板名稱。

  4. 將每個下拉式控制項的 Visible 屬性設定為下列其中一個值:

    • CarpetList: If(CategoryList.SelectedItems.Value, true) 中的「Carpet」

    • HardwoodList: If(“CategoryList.SelectedItems.Value中的”Hardwood“,true)

    • TileList: If(“CategoryList.SelectedItems.Value中的”Tile“,true)

      想要有關 If 函數或其他 函數的更多資訊嗎?

  5. 按 F5,然後在 CategoryList 中選擇一或多個專案。

    適當的 [下拉式] 控制項或控制項會根據您的選擇顯示。

    選取的清單。

  6. (選用)按 Esc 返回預設工作區。

協助工具指導方針

色彩對比

以下兩者之間必須有足夠的色彩對比:

這是 對標準顏色對比度要求的補充。

支援螢幕助讀程式

鍵盤支援

  • TabIndex 必須為零或更大,鍵盤使用者才能流覽至它。

  • 焦點指示器必須清晰可見。 使用 FocusedBorderColorFocusedBorderThickness 來達成此目的。

    備註

    Tab 鍵會導覽至 [清單] 方塊或離開 [清單] 方塊。 方向鍵可導覽 [清單] 方塊的內容。