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]]]])

戻り値データ型： 文字列

引数：  

• record_sep: 項目レコードの間に置かれる区切り記号です。デフォルトでは、新しい行を意味する <CR><LF> が使用されます。
• tag_sep: 項目名のタグと項目値の間に置かれる区切り記号です。デフォルトは「: 」です。
• value_sep: 項目値の間に配置される区切り記号。デフォルトは「 , 」です。
• max_values: 個々にリストされる項目値の最大数です。この数が大きくなると、「x of ｙ value」(x/y 個) という表記が使用されます。デフォルトは 6 です。

例

以下の例では、異なるリスト ボックスにロードされた 2 つの項目を使用しています (1 つは First name の名前向け、もう 1 つは Initials 向け)。

例1： First name で John が選択されています

GetCurrentSelections ()

'First name: John' を返します。

例2： First name で John と Peter が選択されています。

GetCurrentSelections ()

'First name: John, Peter' を返します。

例3： First name で John が選択され、Initials で JA が選択されています。

GetCurrentSelections ()

'First name: John; Peter と Initials: JA' を返します。

例4： First name で John が選択され、Initials で JA が選択されています。

GetCurrentSelections ( chr(13)&chr(10) , ' = ' )

'First name = John と Initials = JA' を返します。

例5： First name で Sue 以外のすべての名前が選択され、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 '|');