4D Documentation

Edit

ドロップダウンリスト

Drop-down lists are form objects that allow the user to select from a list. You manage the items displayed in the drop-down list using an object, an array, a choice list, or a standard action.

macOS においては、ドロップダウンリストは "ポップアップメニュー" とも呼ばれます。 どちらの名前も同じタイプのオブジェクトを指します。 次の例に示すように、ドロップダウンリストの外観はプラットフォームによって若干異なります:

Drop-down list types

You can create different types of drop-down lists with different features. To define a type, select the appropriate Expression Type and Data Type values in the Property list, or use their JSON equivalent.

タイプFeatures式の型/式タイプデータタイプJSON definition
オブジェクトBuilt upon a collectionオブジェクトNumeric, Text, Date, or TimedataSourceTypeHint: object + numberFormat: <format> or textFormat: <format> or dateFormat: <format> or timeFormat: <format>
配列Built upon an array配列Numeric, Text, Date, or TimedataSourceTypeHint: arrayNumber or arrayText or arrayDate or arrayTime
Choice list saved as valueBuilt upon a choice list (standard)ListSelected item valuedataSourceTypeHint: text + saveAs: value
Choice list saved as referenceBuilt upon a choice list. Item position is savedListSelected item referencedataSourceTypeHint: integer + saveAs: reference
Hierarchical choice listCan display hierarchical contentsListList referencedataSourceTypeHint: integer
標準アクションAutomatically built by the actionanyany except List referenceany definition + action: <action> (+ focusable: false for actions applying to other areas)

Handling drop-down lists

オブジェクトの使用

An object encapsulating a collection can be used as the data source of a drop-down list. このオブジェクトには、次のプロパティが格納されていなくてはなりません:

プロパティタイプ説明
valuesコレクション必須 - スカラー値のコレクション。 すべての同じ型の値でなくてはなりません。 サポートされている型:
  • 文字列
  • 数値
  • 日付
  • 時間
    • If empty or not defined, the drop-down list is empty
    indexnumberIndex of the currently selected item (value between 0 and collection.length-1). If you set -1, currentValue is displayed as a placeholder string
    currentValuesame as CollectionCurrently selected item (used as placeholder value if set by code)

    オブジェクトにその他のプロパティが含まれている場合、それらは無視されます。

    To initialize the object associated to the drop-down list, you can:

    • プロパティリストのデータソーステーマにおいて、選択リストの項目で "<Static List>" を選び、デフォルト値のリストを入力します。 The default values are loaded into an object automatically.

    • Execute code that creates the object and its properties. For example, if "myList" is the variable associated to the drop-down list, you can write in the On Load form event:

    // Form.myDrop is the datasource of the form object

Form.myDrop:=New object
Form.myDrop.values:=New collection("apples"; "nuts"; "pears"; "oranges"; "carrots")
Form.myDrop.index:=-1  //currentValue is a placeholder
Form.myDrop.currentValue:="Select a fruit"

    The drop-down list is displayed with the placeholder string:

    After the user selects a value:

    Form.myDrop.values // ["apples","nuts","pears","oranges","carrots"]
Form.myDrop.currentValue //"oranges"
Form.myDrop.index //3

    配列の使用

    配列 とは、メモリー内の値のリストのことで、配列の名前によって参照されます。 A drop-down list can display an array as a list of values when you click on it.

    To initialize the array associated to the drop-down list, you can:

    • プロパティリストのデータソーステーマにおいて、選択リストの項目で "<Static List>" を選び、デフォルト値のリストを入力します。 これらのデフォルト値は、配列へと自動的にロードされます。 オブジェクトに関連付けた変数名を使用して、この配列を参照することができます。

    • オブジェクトが表示される前に、値を配列要素に代入するコードを実行します。 たとえば:

      ARRAY TEXT(aCities;6) 
  aCities{1}:="Philadelphia" 
  aCities{2}:="Pittsburg" 
  aCities{3}:="Grand Blanc" 
  aCities{4}:="Bad Axe" 
  aCities{5}:="Frostbite Falls" 
  aCities{6}:="Green Bay"

    In this case, the name of the variable associated with the object in the form must be aCities. このコードをフォームメソッド内に置き、On Load フォームイベント発生時に実行されるようにします。

    • Before the object is displayed, load the values of a list into the array using the LIST TO ARRAY command. たとえば:
       LIST TO ARRAY("Cities";aCities)

    In this case also, the name of the variable associated with the object in the form must be aCities. このコードは、前述した代入命令文の代わりに実行できます。

    ユーザーがおこなった選択内容をフィールドに保存する必要があれば、レコードの登録後に代入命令を実行します。 たとえば、次のような Case文のコードを作成します:

      Case of
    :(Form event=On Load)
       LIST TO ARRAY("Cities";aCities)
       If(Record number([People])<0) // 新規レコードの場合
          aCities:=3 // デフォルトの値を表示します
       Else // 既存レコードの場合には、保存された値を表示します
          aCities:=Find in array(aCities;City)
       End if
    :(Form event=On Clicked) // ユーザーが選択を変更した場合
       City:=aCities{aCities} // フィールドに新しい値を代入
    :(Form event=On Validate)
       City:=aCities{aCities}
    :(Form event=On Unload)
       CLEAR VARIABLE(aCities)
 End case

    You must select each event that you test for in your Case statement. 配列には常に有限数の項目が納められます。 項目リストは動的であり、メソッドを用いて変更可能です。 配列の項目は変更・並び替え・追加することができます。

    選択リストの使用

    If you want to use a drop-down list to manage the values of an input area (listed field or variable), 4D lets you reference the field or variable directly as the drop-down list's data source. これにより列挙型のフィールド/変数を容易に管理できるようになります。

    For example, in the case of a "Color" field that can only contain the values "White", "Blue", "Green" or "Red", it is possible to create a list containing these values and associate it with a drop-down list that references the 4D "Color" field. こうすることによって、あとは 4D が自動的にカレント値の入力や表示に関して管理してくれます。

    階層リストの場合、第一階層の値のみが表示・選択できます。 If you want to display hierarchical contents, you need to use a hierarchical choice list.

    To associate a drop-down list with a field or variable, enter the name of the field or variable directly as the Variable or Expression field of the drop-down list in the Property List.

    It is not possible to use this feature with an object or an array drop-down list. If you enter a field name in the "Variable or Expression" area, then you must use a choice list.

    When the form is executed, 4D automatically manages the drop-down list during input or display: when a user chooses a value, it is saved in the field; this field value is shown in the drop-down list when the form is displayed:

    Selected item value or Selected item reference

    When you have associated a drop-down list with a choice list and with a field or a variable, you can set the Data Type property to Selected item value or Selected item reference. このオプションにより、保存するデータのサイズを最適化できるようになります。

    Using a hierarchical choice list

    A hierarchical drop-down list has a sublist associated with each item in the list. Here is an example of a hierarchical drop-down list:

    In forms, hierarchical drop-down lists are limited to two levels.

    You can assign the hierarchical choice list to the drop-down list object using the Choice List field of the Property List.

    You manage hierarchical drop-down lists using the Hierarchical Lists commands of the 4D Language. All commands that support the (*; "name") syntax can be used with hierarchical drop-down lists, e.g. List item parent.

    標準アクションの使用

    You can build automatically a drop-down list using a standard action. This feature is supported in the following contexts:

    • Use of the gotoPage standard action. In this case, 4D will automatically display the page of the form that corresponds to the number of the item that is selected. For example, if the user selects the 3rd item, 4D will display the third page of the current form (if it exists). At runtime, by default the drop-down list displays the page numbers (1, 2...).

    • Use of a standard action that displays a sublist of items, for example backgroundColor. This feature requires that:

      • a styled text area (4D Write Pro area or input with multistyle property) is present in the form as the standard action target.
      • the focusable property is not set to the drop-down list. At runtime the drop-down list will display an automatic list of values, e.g. background colors. You can override this automatic list by assigning in addition a choice list in which each item has been assigned a custom standard action.

    This feature cannot be used with a hierarchical drop-down list.

    プロパティ一覧

    Alpha Format - Bold - Bottom - Button Style - Choice List - Class - Data Type (expression type) - Data Type (list) - Date Format - Expression Type - Focusable - Font - Font Color - Font Size - Height - Help Tip - Horizontal Sizing - Italic - Left - Not rendered - Object Name - Right - Standard action - Save value - Time Format - Top - Type - Underline - Variable or Expression - Vertical Sizing - Visibility - Width

    ← コンボボックスグループボックス →