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

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

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

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

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

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

デフォルトではAdvancedComboBoxコントロールはアイテムの表示名を表示しますが、AdvancedComboBoxコントロールのDisplayFieldNameプロパティを使って別のアイテムフィールドを選択して表示できます。

SPEAKはデフォルトでAdvancedComboBoxコントロールの最初(上)のアイテムを選択します。つまり、AdvancedComboBoxコントロールにアイテムがあっても、selectItemメンバーはnullを返しません。

AdvancedComboBoxコントロールのプロパティはさまざまな方法で設定できます。以下の構文でリバインド関数を使用することを推奨します:

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

selectedValueとselectedItemの両方のプロパティを提供すれば、AdvancedComboBoxコントロールはselectedItemを使用します。

AdvancedComboBoxのコントロールはComboBoxのコントロールに似ていますが、以下の追加機能があります:

  • AdvancedComboBoxコントロールはドロップダウンリストに検索ボックスを表示します。ユーザーはこの検索ボックスに検索文字列を入力し、入力中に表示される項目をフィルタリングします(増分検索)。
  • GroupFieldNameプロパティでフィールド名を指定すると、 AdvancedComboBox コントロールはリスト内のアイテムをこのフィールドでグループ化し、各グループごとにフィールド名をラベルとして表示します。フィールド名やトークン(例: $templateName)を指定することもできます。

性質

名称

概要

デフォルト

外見

WidthPolicy

SPEAKがコントロールの幅をどのように解釈するかを指定します。以下を指定できます:

  • デフォルト
    。
  • BlockLevel
    。

デフォルト

データ

ディスプレイフィールドネーム

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

$displayName

GroupFieldName(グループフィールドネーム)

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

  • itemId(アイテムID)
  • itemName(アイテム名)
  • $displayName(表示名)
  • $database(アイテムが属するデータベース名)
  • $language(アイテムの言語)
  • $version(アイテムのバージョン)
  • $templateName(アイテムの元となるテンプレートの名前)
  • $templateId(このテンプレートのアイテムのID)
  • $hasChildren(子項目があるかどうか表示)
  • $path(アイテムのSitecoreパス)
  • $url(SitecooreのURLです)
  • $mediaurl(アイテムのアイコン資産のSitecore URL)
  • $icon(アイテムのアイコンのSitecore経路)

アイテム

コントロールをデータソースにバインドすると、 AdvancedComboBox コントロールでそのデータソースから取得されたアイテムが表示されます。

itemId

選択アイテム

選択されたアイテムを名前で指定してください。

最初の(トップ)アイテム

SelectedValue

選択したアイテムを値(ID)で指定します。

ValueFieldName

AdvancedComboBoxコントロールがオプション値として使用するアイテムフィールド(そしてselectValueとして返される)を指定します。

アイテムのID

構成

AdvancedComboBoxコントロールの設定項目は、AdvancedComboBoxパラメータテンプレートに基づいてアイテムを作成することで作成できます。

設定項目には以下の特定のフィールドがあります:

  • ディスプレイフィールドネーム

以下の場を継承します:

  • IsEnabled
  • IsVisible(見えるもの)
  • アクセスキー
  • ツールチップ
  • 行動
  • ID
この記事を改善するための提案がある場合は、 お知らせください!