リスト・ボックス

リスト・ボックス・コントロールを使用すると、1 つまたは複数の項目を選択でき、 選択した項目に固有のコマンド・シンタックスを生成する項目リストを 表示できます。リスト・ボックス・コントロールには、次のプロパティーがあります。

「識別子」コントロールの固有の識別子。 これはシンタックス・テンプレートの コントロールを参照する際に使用する識別子です。

「タイトル」コントロールと共に表示されるオプションのタイトル。複数行のタイトルまたは長いタイトルの場合、省略符号 (...) ボタンをクリックして、「表題プロパティー」ダイアログにタイトルを入力します。

「ツールチップ」ユーザーがコントロールにカーソルを移動した場合に表示されるオプションのツールチップ・テキスト。

「リスト項目」。省略符号 (...) ボタンをクリックして「項目プロパティの一覧表示」ダイアログ・ボックスを開き、コントロールのリスト項目を指定できます。キャンバス上のリスト・ボックス・コントロールをダブルクリックして、「項目プロパティの一覧表示」ダイアログを開くこともできます。

「ニーモニック・キー」。コントロールへのキーボード・ショートカットとして使用する、タイトルのオプションの文字。これらの文字は、タイトル内で下線付きで表示されます。ショートカットは、Alt キーを押しながらニーモニック・キーを押すと アクティブ化されます。「ニーモニック・キー」プロパティーは、Mac ではサポートされていません。

「リスト ボックス タイプ」。リスト・ボックスが単一選択だけをサポートするか、または複数選択をサポートするかを指定します。項目がチェック・ボックスのリストとして表示されるように指定することもできます。

「区切り記号の種類」。 生成されたシンタックス内の選択したリスト項目間の区切り文字を指定します。使用できる区切り文字は、ブランク、コンマ、および正符号 (+) です。また、任意の単一文字を入力して、区切り文字として使用することもできます。

「最小選択数」。該当する場合に、コントロールで選択する必要のある項目の最小数。

「最大選択数」。該当する場合に、コントロールで選択できる項目の最大数。

「シンタックス」。ランタイム時にこのコントロールで生成され、シンタックス・テンプレートに 挿入できるコマンド・シンタックスを指定します。

  • %%ThisValue%% はコントロールのランタイム値を指定し、デフォルトとなります。リスト項目が手動で定義された場合、ランタイム値は、 選択したリスト項目の「シンタックス」プロパティーの値となります。リスト項目がターゲット・リスト・コントロールを基準とする場合、ランタイム値は、選択したリスト項目の値となります。 複数選択リスト・ボックス・コントロールの場合、ランタイム値は指定した区切り記号の種類で区切られた (デフォルトはブランク区切り)、選択した項目のリストになります。 詳しくは、コンボ・ボックスとリスト・ボックスのリスト項目の指定を参照してください。
  • 有効なコマンド・シンタックスを指定できます。複数行のシンタックスまたは長いシンタックスの場合、省略符号 (...) ボタンをクリックして、シンタックスのプロパティー・ダイアログにシンタックスを入力します。
「引用符の処理」。引用符付き文字列の一部としてシンタックス プロパティに %%ThisValue%% が含まれている場合、%%ThisValue%% のランタイム値に引用符の処理を指定します。このコンテキストでは、引用符付き文字列は単一引用符または二重引用符で囲まれた文字列になります。 引用符の処理は、%%ThisValue%% を囲む引用符と同じタイプの引用符のみに適用されます。次のタイプの引用符の処理を使用できます。
シンタックス
前後の引用符と一致する %%ThisValue%% のランタイム値の引用符は二重になります。例えば、シンタックス・プロパティーが '%%ThisValue%%' であり、選択したリスト項目が List item's value である場合、生成されるシンタックスは 'List item''s value' になります。
Python
前後の引用符と一致する %%ThisValue%% のランタイム値の引用符は、円記号 (¥) でエスケープされます。例えば、シンタックス プロパティが '%%ThisValue%%' で、選択したリスト項目の値が List item's value である場合、生成されるシンタックス'List item\'s value' になります。%ThisValue%% が三重引用符で囲まれている場合、引用符の処理は行われないので注意してください。
R
前後の引用符と一致する %%ThisValue%% のランタイム値の引用符は、円記号 (¥) でエスケープされます。例えば、シンタックス プロパティが '%%ThisValue%%' で、選択したリスト項目の値が List item's value である場合、生成されるシンタックス'List item\'s value' になります。
なし
前後の引用符と一致する %%ThisValue%% のランタイム値の引用符は、変更されずに保持されます。

「有効化ルール」。現在のコントロールが有効になる条件を決定するルールを指定します。 省略符号 (...) ボタンをクリックし、「有効化ルール」ダイアログ ボックスを開き、ルールを指定します。「有効化ルール」プロパティは、有効化ルールを指定するために使用できる他のコントロールがキャンバスに存在するときにのみ表示されます。