GetCurrentSelections()は、アプリ内の現在の選択条件のリストを返します。 代わりに、検索ボックスで検索文字列を使用して選択が行われた場合、GetCurrentSelections()は検索文字列を返します。
オプションを使用している場合、record_sep を指定する必要があります。新しい行を指定するには、record_sep を chr(13)&chr(10) に設定します。
特定の値を除くすべての値を選択する場合、除外する値が 2 つの場合は「NOT x,y」、1 つの場合は「NOT y」形式を使用します。すべての値を選択し、その値のカウントが max_values よりも大きい場合、ALL のテキストが返されます。
構文:
GetCurrentSelections ([record_sep [, tag_sep [, value_sep [, max_values [, state_name]]]]])
戻り値データ型： string
引数：
| 引数 | 説明 |
|---|---|
| record_sep | 項目レコードの間に置かれる区切り記号です。デフォルトでは、新しい行を意味する <CR><LF> が使用されます。 |
| tag_sep | 項目名のタグと項目値の間に置かれる区切り記号です。デフォルトは「: 」です。 |
| value_sep | 項目値の間に配置される区切り記号。デフォルトは「,」です。 |
| max_values | 個々にリストされる項目値の最大数です。この数が大きくなると、「x of ｙ value」(x/y 個) という表記が使用されます。デフォルトは 6 です。 |
| state_name |
特定のビジュアライゼーションのために選択された並列ステートの名前。state_name 引数が使用されると、特定のステート名に関連付けられた選択のみが対象になります。 詳細については、「並列ステートを使用した比較分析」を参照してください。 |
例と結果:
以下の例では、異なるフィルター パネルにロードされた 2 つの項目 (First name と Initials) を使用しています。
| 例 | 結果 |
|---|---|
|
John が First name に選択されている場合 GetCurrentSelections () |
'First name: John' |
|
Johnと Peter が First name に選択されている場合 GetCurrentSelections () |
'First name: John, Peter' |
|
John と Peter が First name に、そして JA がInitials に選択されている場合 GetCurrentSelections () |
'First name: John, Peter Initials: JA' |
|
John が First name に、そして JA がInitials に選択されている場合 GetCurrentSelections ( chr(13)&chr(10) , ' = ' ) |
'First name = John Initials = JA' |
|
Sue 以外のすべての名前が First name に選択されており、Initials が選択されていない場合 GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3) |
'First name=NOT Sue' |
例で使用されているデータ:
Names:
LOAD * inline [
First name|Last name|Initials|Has cellphone
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC|No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');