# ユーザー入力

ユーザ入力要素 (Web ページコントロールとも呼ばれる) は、対話型の HMI 要素を Web ページに挿入するために使用します。これらの要素は、スプレッドシートでオペレータ I/F 関数を操作するために使用できます。

注:

すべてのコントロール要素には、以下のイベントハンドラスクリプトポイントがあります (いくつかのコントロール要素には追加のイベントハンドラスクリプトポイントがあり、それぞれの説明に示されています)。

- On Mouse Enter
- On Mouse Leave
- On Mouse Move

イベントハンドラスクリプトポイントの詳細については、「Web ページ要素のイベントハンドラスクリプト」のトピックを参照してください。

要素 | 説明
--- | ---
ボタン | ボタン要素は、他の Web ページへの移動、タスクの実行、スプレッドシートエディタを使用した領域のグラフィックスや Button 関数の操作などに使用します。 ボタンのプロパティには [クリックコマンド] プロパティがあり、ボタンがクリックされたときに実行可能なアクションがあらかじめ定義されており、そのリストを提供します。 注: 詳細については、「ボタンの [クリックコマンド] プロパティ」のトピックを参照してください。 ボタン要素には、追加のイベントハンドラスクリプトポイントが 1 つあります。 On Clicked 注: On Clicked スクリプトポイントは、ユーザがボタンをクリックするたびに実行されます。クリックコマンドと On Clicked スクリプトポイントがどちらも設定されている場合は、クリックコマンドが優先され、On Clicked スクリプトの前に実行されます。
チェックボックス | チェックボックス要素には、対話型のチェックボックスとその横に表示されるラベルが含まれています。ラベルの外観や配置を設定するには、[テキスト] セクションの [プロパティ] を使用します ([テキストのパディング] プロパティで、チェックボックスとテキストの間の間隔を決定します)。 チェックボックス要素には、追加のイベントハンドラスクリプトポイントが 3 つあります。 On Changed On Checked On Unchecked
日時入力 | 日時入力要素は、HMI を使用して日付や時刻を表示または入力する手段を提供します。 日時入力要素には、追加のイベントハンドラスクリプトポイントが 1 つあります。 On Changed
リストボックス | データのテーブルを表示して操作するためのコントロールを挿入します。 リストボックス要素には、追加のイベントハンドラスクリプトポイントが 3 つあります。 On Selection Changed On Mouse Up On Mouse Down
複数行テキストボックス | 複数行のテキストを入力するためのコントロールを挿入します。[テキスト] プロパティはタグに結合することができ、それによってユーザスクリプトなどのジョブの他の部分に基づいて更新することができます。 複数行テキストボックス要素には、追加のイベントハンドラスクリプトポイントが 3 つあります。 On Text Change On Mouse Up On Mouse Down 注: 複数行テキストボックス要素は、オンライン中のパスワードの入力をサポートしていません。この機能には、テキストボックスを使用する必要があります。
数値入力 | 数値を入力するためのコントロールを挿入します。数値は直接入力するか、上下の矢印を使用します。 数値入力要素には、追加のイベントハンドラスクリプトポイントが 1 つあります。 On Value Change
ページコントロール | ジョブの他の Web ページにアクセスして操作できるコントロールを挿入します。[ページ名] プロパティのドロップダウンメニューで、このコントロール要素で表示する Web ページを選択します。 ページコントロール要素に、イベントハンドラスクリプトポイントはありません。
パネル | その上に他の HMI 要素を配置できるパネルを挿入します。これにより、要素を視覚的に整理したり、複数の要素のコンテナとして使用することができます。 注: パネルの [有効] プロパティが無効 (オフ) になっている場合は、パネル上の要素もすべて無効になります。 パネルの [認証] プロパティが有効 (オン) になっている場合は、個々の要素の [認証] プロパティの設定に関係なく、パネル上のすべての要素に認証が必要になります。[認証] プロパティの詳細については、「Web ページ要素の認証」のトピックを参照してください。 公開済みのプロパティタグがある要素をパネルに配置すると、要素のパス名が変更されてパネルの名前が含まれます。例えば、WebPages.WebPageName.PanelName.CheckboxName.Checked となります。
ラジオボタン | オンとオフを切り替えることができる、2 つの状態を持つ対話型のボタンと、その横のラベルを挿入します。ラベルの外観や配置を設定するには、[テキスト] セクションの [プロパティ] を使用します ([テキストのパディング] プロパティで、ボタンとテキストの間の間隔を決定します)。 ラジオボタン要素には、追加のイベントハンドラスクリプトポイントが 3 つあります。 On Changed On Checked On Unchecked
選択ボックス | ドロップダウンリストコントロールを挿入します。 選択ボックス要素には、追加のイベントハンドラスクリプトポイントが 3 つあります。 On Selection Changed On Mouse Up On Mouse Down
スライダ | コントロールを目的の値までスライドさせてグラフィカルに数値を選択できる、対話型の数値セレクタコントロールを挿入します。 スライダ要素には、追加のイベントハンドラスクリプトポイントが 1 つあります。 On Value Change
テキストボックス | テキストを入力するためのコントロールを挿入します。[テキスト] プロパティはタグに結合することができ、それによってユーザスクリプトなどのジョブの他の部分に基づいて更新することができます。 [パスワード] プロパティを有効にするとパスワード入力用のテキストボックスに変換され、文字がアスタリスクに置き換えられます。 テキストボックス要素には、追加のイベントハンドラスクリプトポイントが 3 つあります。 On Text Change On Mouse Up On Mouse Down