1. コンポーネントライブラリ

アドバンスコンボボックス

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

AdvancedComboBoxコントロールには、項目のドロップダウン リストが表示されます。ユーザーがリストから項目を選択すると、AdvancedComboBoxコントロールは選択した項目の値を (selectedValueとして) 返します。

AdvancedComboBoxコントロールをItemsプロパティでデータ ソースにバインドすると、AdvancedComboBoxコントロールには、データ ソースが取得するすべての項目が表示されます。

既定では、AdvancedComboBoxコントロールには項目の表示名が表示されますが、AdvancedComboBoxコントロールのDisplayFieldNameプロパティを使用して、表示する別の項目フィールドを選択できます。

SPEAKは、デフォルトでAdvancedComboBoxコントロールの最初 (上) の項目を選択します。つまり、selectedItemコントロールに項目がある場合、AdvancedComboBoxメンバーはnullを返しません。

AdvancedComboBoxコントロールのプロパティは、さまざまな方法で設定できます。rebind関数は、次の構文で使用することをお勧めします。

rebind (items, selectedItem, selectedValue, displayFieldName, valueFieldName)

selectedValueプロパティとselectedItemプロパティの両方を指定すると、AdvancedComboBoxコントロールはselectedItemを使用します。

AdvancedComboBoxコントロールはComboBoxコントロールと似ていますが、次の追加機能があります。

  • AdvancedComboBoxコントロールのドロップダウン リストに検索ボックスが表示されます。ユーザーはこの検索ボックスに検索文字列を入力し、コントロールはユーザーが入力するときにこの文字列で表示される項目をフィルター処理します (増分検索)。

  • GroupFieldNameプロパティでフィールド名を指定すると、AdvancedComboBoxコントロールはリスト内の項目をこのフィールドによってグループ化し、フィールド名を各グループのラベルとして表示します。フィールド名またはトークンを指定できます (例: $templateName)。

プロパティ

Name

Description

Default

Appearance

幅ポリシー

SPEAKがコントロールの幅を解釈する方法を指定します。以下を指定できます。

  • デフォルト: コントロールのデフォルトの幅が使用されます。

  • BlockLevel: 幅はコンテナの幅に対して相対的に設定されます。

デフォルト

Data

DisplayFieldName (ディスプレイフィールド名)

AdvancedComboBoxコントロールに表示される項目フィールドの名前を指定します。

$displayName

グループフィールド名

AdvancedComboBoxコントロールがアイテムをグループ化するために使用するアイテム フィールドの名前を指定します。フィールドの名前、または次のいずれかのトークンを入力できます。

  • itemId (アイテムID)

  • itemName (アイテム名)

  • $displayName (表示名)

  • $database (アイテムが属するデータベースの名前)

  • $language (アイテムの言語)

  • $version (アイテムのバージョン)

  • $templateName (アイテムの基になっているテンプレートの名前)

  • $templateId(このテンプレートのアイテムID)

  • $hasChildren (アイテムに子アイテムがあるかどうかを示します)

  • $path (アイテムのSitecoreパス)

  • $url (アイテムのSitecoore URL)

  • $mediaurl (アイテムのアイコン アセットのSitecore URL)

  • $icon (アイテムのアイコンのSitecoreパス)

項目

コントロールをデータ ソースにバインドすると、AdvancedComboBoxコントロールには、このデータ ソースによって取得された項目が表示されます。

アイテムID

選択済みアイテム

選択した項目を名前で指定します。

最初(一番上)のアイテム

選択値

選択した項目を値 (ID) で指定します。

値フィールド名

AdvancedComboBoxコントロールがオプション値として使用する (selectedValueとして返す) 項目フィールドを指定します。

アイテムのID

構成

AdvancedComboBoxコントロールの構成項目を作成するには、AdvancedComboBox Parametersテンプレートに基づいて項目を作成します。

構成アイテムには、次の特定のフィールドがあります。

  • DisplayFieldName (ディスプレイフィールド名)

次のフィールドを継承します。

  • イズ・イネーブルド

  • 目に見える

  • アクセスキー

  • ツールチップ

  • 動作

  • 身分証明書

この記事を改善するための提案がある場合は、 お知らせください!