クイックリファレンス:ローカルプロパティとグローバルプロパティ
SenseTalkのローカルプロパティとグローバルプロパティは、システム全体の動作を設定または変更します。例えば、時間または日付値の数値形式を設定したり、SenseTalkスクリプトがファイルやファイルシステムオブジェクトとどのように相互作用するかを変更することができます。SenseTalkによってオブジェクトがどのように扱われるかを影響する特別なプロパティもいくつかあります。
以下にローカルプロパティ、グローバルプロパティ、特別なプロパティのリストが表示されます。SenseTalkには、Eggplant Functionalアプリケーションを操作するための特定のグローバルプロパティセットも含まれています。これらは次のページで説明されています:
ローカルプロパティ
SenseTalkのローカルプロパティは、ハンドラ内のローカル動作を管理します。これらがまだ現在のハンドラ内で特定の値に設定されていない場合、各プロパティに指定されているデフォルト値が設定されます。これらのプロパティの値がハンドラ内で設定されると、その値はローカルハンドラ内でのみ有効です。ローカルハンドラを呼び出したハンドラや、ローカルハンドラによって呼び出されるハンドラは影響を受けません。
the caseSensitve | considering case や ignoring case を明示的に指定しないテキスト比較が大文字と小文字を区別するかどうかを決定します。デフォルトは False です。 |
the centuryCutoff | 2桁の年が属すると仮定される世紀を制御します。デフォルトは the defaultCenturyCutoff グローバルプロパティの値です。 |
the itemDelimiter | フォルトは the defaultItemDelimiter グローバルプロパティの値です。 |
the lineDelimiter | ラインチャンク式を評価する際にラインアイテムを分割する文字列を定義します。デフォルトは the defaultLineDelimiter グローバルプロパティの値です。 |
the listInsertionMode | 他のリストに挿入されるリストが、他のリストにネストするか、アイテムごとに挿入されるかを決定します。デフォルトは the defaultListInsertionMode グローバルプロパティの値です。 |
the numberFormat | 数値の表示形式を定義します。デフォルトは the defaultNumberFormat グローバルプロパティの値です。 |
the wordDelimiter | テキスト内の単語を分割する文字を定義します。デフォルトは the defaultWordDelimiter グローバルプロパティの値です。 |
the wordQuotes | 単語チャンクの引用符の扱い方を制御します。デフォルトは the defaultWordQuotes グローバルプロパティの値です。 |
グローバルプロパティ
以下のSenseTalkプロパティはグローバルスコープです。それらはいつでも任意のハンドラによって変更可能で、変更後はすべてのハンドラでその新しい値がその時点以降有効になります。
ほとんどのグローバルプロパティは、スクリプト実行の開始時に標準的な初期設定を持っています。これらの標準値は、ホストアプリケーションのユーザーのデフォルトデータベースの設定で上書き可能です。そのため、プロパティ名に ST
を接頭辞として使用します。例えば、the shellCommand
プロパティは、ユーザーデフォルトで STShellCommand
という名前を使用して設定されます。
the asTextLimit | 値の内部的に生成されるテキスト表現の最大サイズを制御します。 |
the autoSaveDatabaseUpdates | データベースへの更新が自動的に保存されるかどうかを決定します。 |
the backScripts | メッセージパッシングのパスの一部として、ターゲットオブジェクトの後にメッセージを受け取る特別なオブジェクトのリスト。 |
the booleanComparison | Booleanのマッチング方法を制御します。 |
the breakpointsEnabled | breakpoint コマンドが遵守されるか無視されるかを決定します。 |
the characterFiller | コンテナの内容の末尾を超える文字位置に格納することによってコンテナが拡張された場合の挙動を指定します。 |
the clockFormat | 時間のフォーマットを制御するために、12 hour または24 hour に設定します。 |
the colorFormat | 色の表示形式です。 |
the defaultCenturyCutoff | centuryCutoff ローカルプロパティが設定されていない場合に、どの世紀の2桁の年が想定されるかを制御します。 |
the defaultDataFormat | データがテキストに変換される際に値がどのように表されるかを制御します。 |
the defaultItemDelimiter | テキスト項目の区切り文字を定義します。 |
the defaultLineDelimiter | 行チャンク式の評価時に、行項目を分割するために使用される文字列を定義します。 |
the defaultListInsertionMode | 項目を別のリストに追加する際に、項目の動作方法を制御します。 |
the defaultNumberFormat | 数値を表示するためのデフォルトの書式を指定します。 |
the defaultQuoteFormat | the listFormat と the propertyListFormat グローバルプロパティの値がテキストに変換されるときにどのように引用されるかを指定します。 |
the defaultStringEncoding | ファイル内のテキスト文字列を読み書きする際に使用されるエンコーディングを制御します。 |
the defaultWordDelimiter | 単語のデフォルトの区切り文字を指定します。 |
the defaultWordQuotes | 単語チャンクのデフォルトの引用符文字を定義します。 |
the duplicatePropertyKeyMode | プロパティリスト内の重複するキーの扱い方を制御します。 |
the endValue | イテレータが返す値がない場合に、end 定数の値を指定します。 |
the evaluationContext | do 、send 、value() 、または merge() 式で変数が評価される方法を制御します(ローカル変数、グローバル変数、またはユニバーサル変数として);デフォルトは Local です。 |
the exception | 最新の try ブロックのコンテキストでスローされた例外に関する情報が含まれており、それ以外の場合は空です |
the folder , the directory | ファイルシステムの現在の作業フォルダを返します。 |
the folderNamesEndWithSlash | フォルダ名が末尾にスラッシュで返されるかどうかを決定します。 |
the frontScripts | メッセージパッシングパスの一部として、ターゲットオブジェクトの前にメッセージを受け取る特別なオブジェクトのリスト。 |
the lineFiller | コンテナが内容の終端を超える行番号の位置に格納されることで拡張される場合に使用する行区切り記号を提供します。 |
the listFormat | 表示されるリストの書式設定を制御します。 |
the matchesCanOverlap | パターン検索が重複したり、入れ子になったりするかどうかを決定します。 |
the namedColors | 名前でアクセス可能な定義済みの色。 |
the objectContainsItemDefinition | オペレータや関数がプロパティリスト内のキーと値にアクセスする方法を制御します。 |
the patternCharacterMode | パターン検索の行モードとテキストモード(デフォルト)を切り 替えます。 |
the patternTimeout | 単一のパターン検索にかかる最大時間を制御します。 |
the predefinedVariables | すべての事前定義された変数の定義を含むプロパティリストです。 |
the propertyListFormat | 表示されるプロパティリストの書式設定を制御します。 |
the readTimeout | read または open socket コマンドがタイムアウトする前にかかる最大時間(秒)を指定します。 |
the resultHistory | 最近の結果値のリストを格納しています。 |
the resultHistoryLimit | the resultHistory 内のアイテムの最大数を制御します。 |
the shellCommand | shell() 関数で使用されるコマンドラインシェルを設定します。 |
the strictFiles | 存在しないファイルの内容にアクセスする際に例外をスローするか、空の値を返すかを決定します。 |
the strictProperties | True に設定すると、オブジェクトの未定義のプロパティにアクセスすると例外をスローし、空の値を返すのではなくます。 |
the strictVariables | True に設定すると、宣言または保存されていないローカル変数の値にアクセスすると、変数の名前を返すのではなく例外をスローします。 |
the suiteVariables | ユーザー定義のスイート全体変数のプロパティリストを含んでいます。 |
the throwExceptionResults | the result を設定する操作がエラーを返す場合に例外がスローさ れるかどうかを決定します。 |
the timeFormat | 利用可能なすべての日付/時間形式を定義するプロパティリスト。 |
the timeInputFormat | 日付と時間の値を認識する際に使用される形式のリスト。 |
the treeFormat | XMLツリーがどのようにフォーマットされるかを定義します。 |
the treeInputFormat | ツリーに変更が加えられた場合にテキストノードが結合されるかどうかを指定します。 |
the umask | 新しく作成されたファイルのアクセス許可を制御します。 |
the URLCacheEnabled | アクセスされたURLを後で再利用するためにキャッシュできるかどうかを決定します。デフォルトでは、Trueはキャッシュを許可します。 |
the URLErrorLevel | エラーとして扱われる最も低いURLステータス値を指定します。 |
the URLTimeout | タイムアウトするまでのURLリクエストの最大時間(秒単位)を指定します。 |
the watchForScriptChanges | スクリプトハンドラーが呼び出される際に、SenseTalkがキャッシュされたコピーを使用するか、最初にソースを更新するかを決定します。 |
the wordFiller | コンテナが、コンテナの内容の終わりを超えるワード位置に格納されることによって拡張される場合の動作を指定します。 |
特別なプロパティ
SenseTalkにとって特別な意味を 持ついくつかのオブジェクトプロパティがあります。これらのプロパティの一部は、キーまたは値の関数によってリスト化されず、オブジェクトのデフォルトのテキスト表現には表示されませんが、オブジェクトのプロパティとして直接アクセスできます。
これらの特別なプロパティは、SenseTalkによってオブジェクトがどのように扱われるかに影響します。これらのプロパティはあなたのオブジェクトの普通のプロパティとして表示されますが、特別な意味を持ちます。
asText | オブジェクトにasText プロパティが設定されている場合、それは"asText"関数メッセージを処理しない場合のオブジェクトのテキスト表現として使用されます。 |
asTextFormat | オブジェクトが"asText"関数ハンドラもasTextプロパティも持たない場合、SenseTalkはasTextFormat プロパティをチェックします。このプロパティがオブジェクトに設定されている場合、その値はmerge 関数を使用してオブジェクトのテキスト表現を生成するフォーマット文字列として使用されます。 |
objectType | オブジェクトのobjectType プロパティを設定すると、それはis a 演算子の特定のタイプのオブジェクトとして認識されます。 |
script properties | 完全な説明については、スクリプトプロパティを参照してください。 |