マニュアル > コントロールリファレンス > ルート

ルートオブジェクトが持っているプロパティのことを、ルートプロパティと呼びます。

プロパティ名

説明

スクリプト

アクション

ブラウザ

スクリプト

演算式

構文

Comment

ルートのコメント。

○

Enabled

有効、無効の切り替え。

無効時、キーボードの入力を受けつけなくなります。Enabledルートプロパティはすべてのフォーム、すべてのコントロールに対して影響があります。一部のコントロールは淡色になります。

○

EnabledInput

有効、無効の切り替え。

無効時、キーボードの入力を受けつけなくなります。EnabledInputルートプロパティはすべてのフォーム、すべてのコントロールに対して影響があります。Enabledと異なりコントロールが淡色になりません。

○

EnabledEvent

イベントの有効、無効の切り替え。

無効時、全てのイベント（ルート、フォーム、コントロールを含む）の発生を停止します。オンライン中にスクリプトで使用するプロパティのためプロパティページダイアログには表示されません。

○

Title

ウインドウのタイトル位置に表示されるテキスト。また、ブラウザをタスクバーアイコンとして表示した場合、マウスをアイコン上に持ってきたときに表示されるテキスト。

○

TitleType

タイトルの表示方法。

ROOT	Titleルートプロパティをタイトルとして表示する
FORM	フォームオブジェクトのTitleプロパティをタイトルとして表示する
ROOT_FORM	ルートオブジェクト、フォームオブジェクトの順にTitleプロパティを組み合わせて表示する
FORM_ROOT	フォームオブジェクト、ルートオブジェクトの順にTitleプロパティを組み合わせて表示する

○

TitleParent

WebブラウザやVBなどで作成したユーザーアプリケーションへブラウザを組み込むとき、アプリケーションのタイトルを更新するかどうか。専用ブラウザの時は無視される。

○

DefaultForm

ブラウザが起動したときの初期表示フォーム名。

○

DefaultView

以下のルートメソッドのViewName引数を省略（もしくは空文字を指定）した場合、DefaultView名で指定したビュー名が採用される。

OpenHomeForm / ClearFormHistory / OpenPrevForm / OpenNextForm / IsHaveNextForm / IsHavePrevForm / GetCurrentForm / ResetZoom / SetZoom / GetZoom / SetStretch

※上メソッドのViewName引数を省略（もしくは空文字を指定）し、かつDefaultViewルートプロパティが空文字の場合、"MainView"が採用される。

○

DefaultFrame

フレーム表示時の設定。

DefaultFireAlarm

FireAlarmルートメソッド呼び出し時に使用されるデフォルト値の定義。

下記の順に定義します。

alarmAction;alarmId;conditionId;commentId[;comment]

commentID,commentはカンマ区切りで複数指定可能です。

例）Event;system;1;0

commentIdに対するcommentとして、ルートプロパティ名を指定することにより、FireAlarm呼び出し時に、自動的にその値をコメントに含めることができます。

例）Event;system;1;0,1;,PSLoginUser // FireAlarm("message");と呼び出すことにより[CM0]には"message"、[CM1]にはPSLoginUserの値が設定されます。

○

HiddenForm

バックグラウンドフォームとして開きたいフォームのフォーム名を指定。

バックグラウンドフォームは、ブラウザが起動中に見えない状態で常に開かれています。このフォームには常に動作させたいコントロールやスクリプトを置きます。フォームのHiddenFromプロパティをTRUEにする事でも同様の動作になります。

○

Stretch

ストレッチモード。

以下のモードに従い、フォームの大きさを自動的に調整（拡大、縮小）します。

NONE	実際の大きさで表示（ストレッチしない）
FORM	フォームの設定に合わせる
STRETCH_FULL	サイズに合わせて引き伸ばし表示する
STRETCH_KEEPRATE	サイズに合わせて引き伸ばし表示する（縦横比保持）
RESIZE_FULL	サイズに合わせてフォームサイズを調整する
RESIZE_KEEPRATE	サイズに合わせてフォームサイズを調整する（縦横比保持）

※STRETCH_XXXとRESIZE_XXXの違いについて

STRETCH_XXXの場合、画面を広げたときにフォームのサイズ（Width/Heightプロパティ）はそのままで、拡大縮小比率を自動調整することにより引き伸ばし表示しています。そのため、絵や文字すべてが拡大縮小されます。一方、RESIZE_XXXの場合、拡大縮小比率は100%のまま固定で、フォームの実際のサイズ（Width/Heightプロパティ）を自動調整します。そのため、コントロールや文字のサイズはそのまま維持します。画面を広げたときに画面上のコントロール位置やサイズを自動的に調整したい場合は、各コントロールのAutoResizeX/AutoResizeYプロパティを設定します。例えばAutoResizeXに"RIGHT"を指定すると、画面を広げた際、コントロールの位置が右辺に追従して自動的に移動します。

○

RefreshRate

画面の更新周期（ms）。

0の時はデフォルト周期が適用されます（推奨）。CPUの負荷を下げたいとき等は、更新周期を大きな値に調整します。RefreshRateは動作中も変更することが可能で、例えば各フォームのOnInitializeイベントで以下の要領でRefreshRateを変更することができます。

event OnInitialize()

{

::RefreshRate = 1000; // この画面は更新周期を1秒に変更

}

○

EscToReleaseFullScreen

ESCキーが押されたときに、フルスクリーン表示を解除するか否か。

専用ブラウザのみ有効。

○

Inifile

初期値設定ファイル名。

ルートプロパティまたはフォームプロパティの初期値を外部テキストファイルで定義したい場合、ファイル名を指定します。

○

InifileSection

Inifile使用時のセクション名。

初期値設定ファイルでは必ずInifileSectionで設定したセクション名を指定してください。（他の用途でinifileを使用している場合、他のセクションと区別するため。）

初期値設定ファイル例）

[Property]

Title=中央監視システム

PSNode=192.168.1.1

[xxx(他用途セクション名)]

Xxx = xxx

初期設定ファイル（INIファイル）には、ルートプロパティ以外にも、フォームのプロパティを定義することができます。フォームプロパティを定義する場合、以下の書式で記述してください。

書式：

フォルダ名.フォーム名.プロパティ名=値

例

Folder01.Form01.Comment=ABCDE

○

StartupMonitor

マルチモニターの場合に起動時に表示するモニター番号を指定。

0はプライマリモニタで、1以上の数値がサブモニタ

○

StartupSize

ブラウザが起動したときのブラウザのサイズ。専用ブラウザのみ有効。

STANDARD	標準サイズ。
FULLSCREEN	フルスクリーン表示。フォームがデスクトップ一杯に表示されます。
DEFAULTFORM	DefaultFormで設定したフォームのサイズ。
MAXIMUM	最大表示。
MINIMUM	最小表示。
CUSTOMSIZE	ユーザでサイズを指定する。 StartupSizeWidth/StartupSizeHeightの値がフォームのサイズとなる。
CUSTOMSIZE2	ユーザでサイズを指定する。 StartupSizeWidth/StartupSizeHeightの値がアプリケーションのサイズとなる。
TASKBARICON	タスクバーにアイコン化する。

○

StartupSizeWidth

画面の幅。StartupSizeでCUSTOMSIZE/CUSTOMSIZE2を指定した時のみ有効。

○

StartupSizeHeight

画面の高さ。StartupSizeでCUSTOMSIZE/CUSTOMSIZE2を指定した時のみ有効。

○

WindowMinWidth

ブラウザのサイズを小さくした時の最小の制限サイズ（幅）。

0の場合、制限しない。（標準ブラウザのみの対応。IEには非対応。）

○

WindowMinHeight

ブラウザのサイズを小さくした時の最小の制限サイズ（高さ）。

0の場合、制限しない。（標準ブラウザのみの対応。IEには非対応。）

○

StartupCenter

ブラウザの実行時の表示位置を、デスクトップ中央にする。

○

StartupPosLeft

ブラウザが起動したときの表示位置（左座標）を指定する。

StartupCenterがFALSEのとき有効。-1のときデフォルト位置に表示される。専用ブラウザのみ有効。

○

StartupPosTop

ブラウザが起動したときの表示位置（上座標）を指定する。

StartupCenterがFALSEのとき有効。-1のときデフォルト位置に表示される。専用ブラウザのみ有効。

○

StartupWaitingTime

起動時の待ち時間（ms単位）。

スタートアップフォルダで自動起動するときなどで、サーバとの起動タイミングを調整する時などに使用します。

○

ShowStatusBar

ブラウザ実行中の、ステータスバーの表示・非表示。

○

ShowMenu

ブラウザ実行中の、メニューの表示・非表示。

○

ShowFullScreenMenu

ブラウザ実行中の、フルスクリーン表示時のメニューの表示・非表示。

○

ShowMaxButton

ブラウザ実行中の、タイトルバー右の最大ボタンの表示・非表示。

○

ShowMinButton

ブラウザ実行中の、タイトルバー右の最小ボタンの表示・非表示。

○

ShowTitleBar

ブラウザ実行中の、タイトルバーの表示・非表示。

○

ShowSystemMenu

ブラウザ実行中の、システムメニューの表示・非表示。

○

ShowBrowserBorder

ブラウザの外枠（くぼんだように表示される枠）の表示・非表示。

フレーム表示の場合、FALSEにすると、２重にくぼんだように表示されず、きれいに表示できます。

○

ViewFillColor

ビュー（フォーム範囲外の部分）の背景色。

フォームのViewFillColorプロパティに無色を指定すると、ViewFillColorルートプロパティが使用される。

○

FocusHoverType

マウスがコントロールの上を移動しているときに、フォーカスが可能なことを示す四角い枠のタイプ。

DOUBLE1	二重線（デフォルト）
SINGLE1	一重線（太さ1ピクセル）
SINGLE2	一重線（太さ2ピクセル）
SINGLE3	一重線（太さ3ピクセル）

○

FocusHoverColor1

マウスがコントロールの上を移動しているときに、フォーカスが可能なことを示す四角い枠の色。FocusHoverType がDOUBLE1の場合、内側の色。SINGLE1/2/3の場合、線の色。

○

FocusHoverColor2

マウスがコントロールの上を移動しているときに、フォーカスが可能なことを示す四角い枠の色。FocusHoverType がDOUBLE1の場合、外側の色。

○

MaxFormHistory

フォームを開いた履歴の最大個数。

この履歴はOpenPrevForm/OpenNextFormで使用されます。

○

BindWatchTime

バインドで「WATCH」書式を指定するときの、状態不一致監視時間（秒単位）のデフォルト値。

詳しくは「バインド」の「入出力バインド書式」を参照下さい。

○

AllowShutdown

専用ブラウザを終了させてもよいかどうか。

ルートイベントOnShutdown呼び出し後に、

AllowShutdown が評価され、もしFALSEであった場合、終了要求がキャンセルされます。

○

AllowResize

FALSE時、ブラウザ起動後のウインドウサイズを変更できないようにする。

○

AllowZoom

画面のズーム機能（拡大、縮小）を許可するかどうかのデフォルト値。

フォームプロパティのAllowZoomが"DEFAULT"に設定されている場合、ルートプロパティの値が利用されます。

○

ToolTipFont

ツールチップ表示で使用されるフォント。

ツールチップで表示される文字はフォームのToolTipTextで指定します。

○

ToolTipOffsetX

ツールチップの表示をマウス位置からX方向にずらして表示する。

○

ToolTipOffsetY

ツールチップの表示をマウス位置からY方向にずらして表示する。

○

ToolTipTimer

ツールチップの表示後、非表示にするまでの時間をミリ秒単位で指定することができます。0を指定するとタイマー設定なし。

○

KeepProcess

Browserのプロセスを監視する。

Trueに設定することでBrowserが異常終了した際などに自動的に再起動を行います。このプロパティはBrowserから実行している場合のみ有効となり、EditorからRUNした場合は無効になります。また、有効にするためには、

「ProcessKeeper3.exe」が必要になります。このEXEがインストールフォルダに含まれていることを確認して下さい。

DeveloperMode

TRUEにすると、画面のビューのサイズやビュー名が表示される。

○

ShowCommentProperty

ブラウザメニューの「表示」「コメントを表示する」を選択時に表示するコメントで使用されるプロパティ名。

例えば「Name」と指定するとオブジェクト名をコメントとして表示します。複数のプロパティを同時に表示したい場合はカンマ「,」で区切って指定します。例）Name,Comment

○

ShowCommentChildLevel

ブラウザメニューの「表示」「コメントを表示する」を選択時に表示するコメントの階層。

グループ化された下層のコントロールのコメントを表示したくない場合は1を指定します。-1を指定するとすべての階層のコメントを表示します。

○

プロパティ名

説明

スクリプト

アクション

ブラウザ

スクリプト

演算式

構文

RunBrowserType

Runアイコンを押したときに、起動させるブラウザのタイプ。

PANEL_BROWSER	専用ブラウザ
WEB_BROWSER	WEBブラウザ
USER_APPLICATION	ユーザーアプリケーション

○

RunUserAppPath

ユーザーアプリケーションのパス。RunBrowserTypeがUSER_APPLICATIONの時のみ有効。

○

RunUserAppCommandLine

ユーザーアプリケーションを起動するときに指定するコマンドライン。RunBrowserTypeがUSER_APPLICATIONの時のみ有効。

○

DefaultFormWidth

エディタで新規にフォームを作成した時のフォームサイズ（幅）。

○

DefaultFormHeight

エディタで新規にフォームを作成した時のフォームサイズ（高さ）。

○

SetupFolder

「クライアント配布用セットアップを行う」を実施時にデフォルトで表示される作成先フォルダ名。

○

SetupResourceFolder

「クライアント配布用セットアップを行う」を実施時にデフォルトで表示されるリソースフォルダ名。

○

AttachedFiles

「クライアント配布用セットアップを行う」を実施時に添付に含めるファイル。

プロパティに設定されているファイル名は自動的にセットアップフォルダに添付されますが、スクリプトでファイルを直接使用している場合などには、自動添付されません。もし添付を行いたい場合は、AttachedFilesで添付ファイル名を指定します。複数存在する場合は、改行して指定します。

1)添付ファイルは相対パスで指定可能。

2)出力先はファイルパスの後に「；」+「出力先」で指定可能。指定しない場合は、XMLと同じ場所に出力される。

例）

RES\menu.jpg;RES

「RES\menu.jpg」が指定したファイル出力先のRESフォルダに出力される。

○

プロパティ名

説明

スクリプト

アクション

ブラウザ

スクリプト

演算式

構文

PSLoginMust

PSLoginMustルートプロパティ(TRUE/FALSE)は、ログインがされてない時でも、クライアントのランタイムを開始しても良いかどうかの設定。

ログインを行うためにはサーバがネットワーク上の別PC上又はブラウザと同じPC上で起動している必要があります。サーバが起動していない場合やユーザー名やパスワードに誤りがある場合にはログインが失敗しますが、その時にシステムを開始（フォームを表示）しても良いかどうかを設定します。

TRUE - ログインを必須とする。サーバへのログインが成功するまで、システムを開始しません。ログインの完了以降に何らかの原因でサーバとの通信ができなくなった場合には、サーバが見つかるまで自動的にリトライを行います。サーバが見つかった時点で再認証を行い、もしOKであればログインを行い、もしNGであればログイン画面が表示されます。

FALSE - ログインを必須としない。サーバへのログイン無しでもシステムが開始します。自動ログイン（Loginメソッド）又は手動ログイン（OpenLoginForm）によってログインされるまで、サーバとは未接続の状態です。ログインの完了以降に何らかの原因でサーバとの通信ができなくなった場合、サーバが見つかるまで自動的にリトライを行います。サーバが見つかった時点で再認証を行い、もしOKであればログインを行い、もしNGであればリトライを終了します。

○

PSLoginStartup

システム開始時のログイン方法を指定。

NONE

ログインしない。

1) ただし、PSLoginMustルートプロパティがTRUE時、NONEの設定は無視され、ログイン画面が表示されます。

2) PSLoginMustルートプロパティがFALSE時、自動ログイン（Loginメソッド）もしくは手動ログイン（OpenLoginForm）によりログインされるまで、未接続のままです。

AUTO

自動ログイン。

ログイン画面は表示されず、PSLoginUserルートプロパティ / PSLoginPwdルートプロパティで設定されたユーザー名及びパスワードを利用して、自動的にログインされます。もし、ログインが失敗した場合かつ PSLoginMustルートプロパティがTRUE時、ログイン画面が表示されます。

MANUAL

手動ログイン。

ログイン画面が表示され、オペレータによるユーザー名、パスワードの入力によってログインを行います。もしもログインが失敗した場合、PSLoginMustルートプロパティがTRUEの時はログインが成功するまでシステムは開始されず、ログイン画面が表示され続けます。

サーバへのLoginが成功していない状態の時、ブラウザはタグ、アラーム、ヒストリカル、データベース、ファイルなどの各情報をサーバから受け取れません。また、外部情報の入出力のためのすべての関数（以下参照）やコントロール（DirectQueryDbコントロール、VideoPlayerコントロール、 VideoRecorderコントロールなど）も同時にロックされます。その他、ActiveXのデータの入出力のためのメソッドもロックされます。

ルートメソッド

LoadTextFile / SaveTextFile / LoadCsvFile / SaveCsvFile / SavePrintText

グリッドコントロールメソッド

LoadCsvFile / SaveCsvFile

（つまり、正しいログインが行われない限り、ブラウザプロセスはプロセス外との入出力は一切できない状態になります。この仕組みにより、ログイン認証が完了して安全とみなされたユーザーに対してのみデータの入出力を公開することができます）

○

PSLoginStartupError

ログインが失敗した際のエラーダイアログの設定。

TRUE	システム開始時のログイン方法がAUTOのとき、ログインがもし失敗したらエラーダイアログを表示する。
FALSE	システム開始時のログイン方法がAUTOのとき、ログインがもし失敗してもエラーダイアログを表示しない。

○

PSLoginMenu

ブラウザのメニュー（operation-login/logout）選択時のログイン方法。

NONE	メニューからログインしない。
AUTO	メニューからLoginを選択した時、自動ログインする。
MANUAL	メニューからLoginを選択した時、手動ログインする。

○

PSLoginScreen

手動ログイン時のログイン画面の表示タイプ。

NORMAL	通常のログイン画面
DISABLE_CANCEL	キャンセルボタンを無効にする
DISABLE_USERPWD	ユーザー名、パスワードを無効にする
DISABLE_CANCEL_USERPWD	キャンセルボタン及びユーザー名、パスワードを無効にする

ユーザー名、パスワードを無効にした場合、オペレータはログイン画面でユーザー名とパスワードを変更できなくなります。また、キャンセルボタンを無効にすると、ログインのキャンセルができなくなります。尚、PSLoginMustルートプロパティがTRUEの時は、キャンセルボタンは自動的に無効になります。

○

PSLoginUser

自動ログインもしくはLoginメソッドでログインを行う際のユーザ。

○

PSLoginGroup

ログイン時にユーザーが所属するグループ。

○

PSLoginPwd

自動ログインもしくはLoginメソッドでログインを行う際のパスワード。

○

PSLoginComment

ログインユーザー毎のコメント。

ダイレクトログイン機能で、ログインINIファイルに指定することで、ログインユーザー毎に任意の文字列を設定する事が可能です。

○

プロパティ名	説明	スクリプトアクション	ブラウザスクリプト	演算式構文
PSTimeOut	サーバとの通信のタイムアウト時間（秒単位）。ネットワークの環境により数秒を設定してください（一般的には20秒程度）。ヒストリカルデータサーバで大量のデータを取得する、日報年報月報でExcelファイルを作成して取得するなどの処理に長い時間を要する場合に、このPSTimeOutルートプロパティがそれらの処理時間に対して短いとタイムアウトエラーとなってしまう点に注意してください。そのような場合には設定する時間を調整してください（但し、このタイムアウト時間を長くしすぎると、何らかの問題により通信が途絶えたときに通信エラーを検知するまでの時間が長くなってしまうというデメリットが生じます）。	×	○	×
PSTimeOutConnect	サーバとの接続時のタイムアウト時間（秒単位）。サーバとブラウザを同じPCで起動するときは通常「-1」を設定します。サーバとブラウザを異なるPCで運用し、接続がうまくいかない場合、このタイムアウト時間を調整してみてください（通常は5から10秒程度）。	×	○	×
PSNodeRedundancy	2重化する場合、Trueに設定。	×	○	×
PSNode	サーバのノード名。サーバとブラウザを別々のPCで実行するとき、サーバのIPアドレスもしくはノード名を必ず指定する必要があります。同じPCで実行する時は、空白のままでかまいません。	×	○	×
PSNode2	サブ機のサーバのノード名。 2重化した場合のみ設定が必要になります。なお、PSNodeRedundancyがTrueのときのみ有効になります。	×	○	×
PSPanelPort	サーバのポート番号。サーバ側にはデフォルトで6001が設定されています。	×	○	×
PSPanelPort2	サブ機のサーバのポート番号。 2重化した場合のみ設定が必要になります。のノード名。2重化した場合のみ設定が必要になります。なお、PSNodeRedundancyがTrueのときのみ有効になります。	×	○	×
PSPing	サーバとの接続前にPingコマンドでサーバPCが有効かどうか確認する。 Pingで確認を行うと、PSTimeOutConnectの設定に関わらず、サーバPCが起動していない時など、接続エラーとして認識するまでの時間が安定します。インターネット経由で接続する場合、ブラウザが接続するIPのターゲット機器（ルーターなど）がPingコマンドに対応している必要があります。セキュリティの関係上、Pingコマンドを公開しないときなどはFALSEにしてください。	×	○	×
PSFilePath	エディタのサーバ実行ボタンでサーバを起動した際に、自動的に読み込むサーバの設定ファイル。	×	○	×
PSTagAccessPath	タグのアクセスパス。タグパスの一部を略したいときに使用します。例えば「U01.F01.」と指定すると、U01.F01.T01というタグのバインド設定は「T01」のみに省略できます。	×	○	×
PSTagDirectPathMark	PSTagAccessPathででアクセスパスを設定した場合に、アクセスパスを無視してタグパスを絶対パス指定するための識別文字（デフォルトではアンダーバー「_」）。アクセスパスを指定すると、全てのタグ参照はアクセスパスを省略したタグ名で指定する必要があります。この時、アクセスパスを無視して絶対パスで直接指定したい場合には、タグパスの先頭に本プロパティで指定した文字を１文字付与することにより、絶対パスでの指定ができるようになります。例えば、アクセスパスに「U01.F01.」を指定した場合、「U02」などの他のPLCや、「U01.F02」などの他のフォルダにあるタグは指定する事ができなくなってしまいます。そのような場面では、先頭に「_」（デフォルト設定）を付与して、「_U02.F01.T01」などの指定とする事により、アクセスパスの設定を無視することができます。このプロパティに指定する文字に禁則文字は使用しないでください。詳しくは、ユーザーズマニュアルの「バインドタグの禁則文字について」を参照下さい。	×	○	×
PSTagUpdateRate	サーバとの通信の更新周期（ms単位）。	×	○	×
PSTagDebug	外部タグに対して仮想通信を行うかどうか。 TRUE時、外部タグに対して仮想的に通信をしている状態にします。デバッグ時などで使用してください。この状態では、サーバと接続を行わなくてもブラウザ内部で外部タグの値の読み書きが可能です。	×	○	×
PSUserLevel	ユーザーレベル（整数値）。ログインが成功したユーザーのレベル値がセットされます。詳しくはユーザーズマニュアル「セキュリティタグによるユーザーレベル判定」を参照して下さい。	×	○	×
PSUserAuth	権限文字列。ユーザがグループに所属してる場合、ログイン後、グループの権限文字列がセットされます。未ログインの時は空文字となります。尚、通信が不安定なためにログアウトしてしまった場合などは、その間、本プロパティは空文字になるので注意してください。	×	○	×
PSUserParam	ユーザのパラメータ文字列。	×	○	×