editres - クラウドでオンライン

プログラム：

NAME

editres - X Toolkit アプリケーション用の動的リソース エディタ

構文

編集者 [ -ツールキットオプション ...]

OPTIONS

エディトレス 標準の X Toolkit コマンド ライン オプションをすべて受け入れます (「 X(7)）。 オーダー
コマンド ライン オプションの指定は重要ではありません。

DESCRIPTION

Editres は、ユーザーとアプリケーション開発者が完全なウィジェットを表示できるようにするツールです
Editres プロトコルを使用する X Toolkit アプリケーションの階層。 加えて、
editres は、ユーザーがリソース仕様を作成するのに役立ち、ユーザーがリソース仕様を適用できるようにします。
リソースをアプリケーションに追加し、結果を動的に表示します。 ユーザーが満足したら
リソース仕様 editres は、リソース文字列をユーザーの X リソースに追加します
ファイルにソフトウェアを指定する必要があります。

使用する エディトレス

エディトレス には、次の XNUMX つの領域で構成されるウィンドウが表示されます。

メニュー バー editres へのフル アクセスを可能にする一連のポップアップ メニュー
機能。

パナー パナーを使用すると、より直感的な方法でアプリケーションをスクロールできます
ツリー表示。

メッセージ エリア editres のアクションに関する情報をユーザーに表示します。
彼女に期待します。

アプリケーション ウィジェット ツリー この領域は、選択したアプリケーションのウィジェットを表示するために使用されます。
ウィジェットツリー。

editres セッションを開始するには、 入手 ウィジェット 木 コマンドメニューのメニュー項目。
これにより、ポインタ カーソルが十字線に変わります。 次に、アプリケーションを選択する必要があります
そのウィンドウのいずれかをクリックして見たいと思います。 このアプリケーションが
editres プロトコルの場合、editres はアプリケーションのウィジェット ツリーをそのツリーに表示します。
窓。 アプリケーションが editres プロトコルを理解していない場合、editres は通知します。
数秒遅れてメッセージ領域にこの事実が表示されます。

ウィジェット ツリーを作成したら、他のメニュー オプションを選択できます。 の効果
これらのそれぞれについて以下に説明します。

コマンド

ウィジェットツリーを取得
ユーザーは、editres プロトコルを使用する任意のアプリケーションをクリックできます。
そのウィジェット ツリーを受け取ります。

現在のウィジェット ツリーを更新
Editres は、現時点で存在するウィジェットについてのみ知っています。 たくさんの
アプリケーションは、その場でウィジェットを作成および破棄します。 このメニュー項目を選択すると、
editres がアプリケーションにそのウィジェット ツリーを再送信するように要求し、そのウィジェット ツリーを更新します。
アプリケーションの新しい状態への情報。

たとえば、xman はそのためのウィジェットのみを作成します。 トップボックス 起動時。 なし
マニュアルページウィンドウのウィジェットの作成は、ユーザーが実際に
をクリックします マニュアル ページへ移動します。 ボタン。 xman のウィジェット ツリーを取得する前に、
マニュアル ページがアクティブな場合は、後でウィジェット ツリーを更新することをお勧めします。
マニュアルページが表示されました。 これにより、マニュアルの編集も可能になります
ページのリソース。

ウィジェット ツリーをファイルにダンプする
アプリケーションを文書化する場合、全体をダンプできると便利なことがよくあります。
アプリケーション ウィジェット ツリーを ASCII ファイルに変換します。 このファイルは、
マニュアルページ。 このメニュー項目を選択すると、ポップアップ ダイアログがアクティブになります。 タイプ
このダイアログでファイルの名前を選択し、 オーケー、またはキャリッジを入力します-
戻る。 Editres は、ウィジェット ツリーをこのファイルにダンプします。 ファイルをキャンセルするには
ダイアログで、 キャンセル

リソースボックスを表示
このコマンドは、現在のアプリケーションのリソース ボックスをポップアップ表示します。 このリソース
ボックス (詳細は後述) を使用すると、ユーザーはどのリソースを正確に確認できますか?
ウィジェットツリー表示で現在選択されているウィジェットに設定できます。
現在選択できるウィジェットは XNUMX つだけです。 より多くまたはより少なく選択された場合
editres はリソース ボックスのポップアップを拒否し、エラー メッセージを
メッセージ エリア.

リソースの設定
このコマンドは、任意のリソースを設定するための簡単なダイアログ ボックスをポップアップします。
選択したすべてのウィジェット。 リソース名と値を入力する必要があります。
Tab キーを使用して、リソース名フィールドとリソースを切り替えることができます
値フィールド。

終了 editres を終了します。

TREE コマンド

　 木 メニューには、操作を実行できるいくつかのコマンドが含まれています
ウィジェットツリー。

クライアントでウィジェットを選択
このメニュー項目を使用すると、アプリケーション内の任意のウィジェットを選択できます。 編集者はするだろう
次に、ウィジェット ツリーが表示する対応する要素を強調表示します。 一度このメニュー
項目が選択されると、ポインター カーソルが再び十字線に変わります。
表示したいウィジェットの任意のポインタ ボタンをクリックします。 いくつか以来
ウィジェットは子によって完全に隠されているため、すべてのウィジェットに到達することはできません
このメカニズムはウィジェット間の非常に有用なフィードバックを提供します。
ウィジェット ツリー内の要素と実際のアプリケーション内の要素。

すべてを選択します。

すべての選択を解除

すべて反転
これらの関数を使用すると、ユーザーはウィジェット内のすべてのウィジェットを選択、選択解除、または反転できます。
ウィジェットツリー。

子供を選択

親を選択
これらの関数は、現在のそれぞれの直接の親または子を選択します
選択したウィジェット。

子孫を選択

先祖を選択
これらの関数は、現在選択されているそれぞれのすべての親または子を選択します
ウィジェット。 これは再帰的検索です。

ウィジェット名を表示

クラス名を表示

ウィジェット ID を表示

ウィジェット ウィンドウを表示
ツリー ウィジェットが最初に表示されるとき、ツリー内の各ウィジェットのラベル
ウィジェット名に対応します。 これらの関数は、 を
関連するクラス名、ID、またはウィンドウを表示するように変更されるツリー内のウィジェット
アプリケーションの各ウィジェットで。 ウィジェット ID とウィンドウは XNUMX 進数で表示されます
数字。

さらに、ツリー操作ごとにキーボード アクセラレータがあります。 入力が
フォーカスがツリー内の個々のウィジェットにある場合、その操作はそのウィジェットにのみ影響します
ウィジェット。 入力フォーカスがツリーの背景にある場合、まったく同じ効果があります
対応するメニュー項目として。

表示された翻訳エントリは、アプリケーション内の任意のウィジェットに適用できます。 もしそうなら
ウィジェットがツリー ウィジェットの子である場合、そのウィジェットにのみ影響します。
ツリー メニューのコマンドと同じ効果があります。

Flash アクティブ ウィジェット
このコマンドは、 選択 ウィジェット in クライアント コマンド、それは表示されます
ユーザーは、ウィジェット ツリーで現在選択されている各ウィジェットを点滅させます。
アプリケーション内の対応するウィジェット フラッシュ回数 (デフォルトでは XNUMX 回)
フラッシュカラー.

キー オプション インタビュー 入門
-
space 選択解除 選択(なし)
w 選択 選択（ウィジェット）
s 選択 選択(すべて)
i Invert Select(反転)
c 子を選択 子を選択
d 子孫を選択 Select(子孫)
p 親を選択 Select(親)
a 祖先の選択 Select(ancestors)
N ウィジェット名の表示 Relabel(name)
C クラス名を表示 Relabel(class)
ウィジェット ID を表示 Relabel(id)
W Show Widget Windows Relabel(ウィンドウ)
Toggle Widget/Class Name Relabel(toggle)

ウィジェットのボタン 1 をクリックすると、選択したウィジェットのセットに追加されます。 クリックする
ウィジェットのボタン 2 は、他のすべてのウィジェットの選択を解除してから、そのウィジェットだけを選択します。
ウィジェットのボタン 3 をクリックすると、ウィジェットのインスタンス名の間でラベルが切り替わります
ウィジェットのクラス名。

使用する ザ リソース BOX

リソース ボックスには XNUMX つの異なるエリアがあります。 それぞれの領域は、
画面を上から順に説明します。

リソースライン
リソース ボックスの上部にあるこの領域には、現在のリソース名が次のように正確に表示されます。
ファイルに保存するか適用すると表示されます。

ウィジェットの名前とクラス
この領域では、このリソースを適用するウィジェットを正確に選択できます。
この領域には XNUMX つの行があり、最初の行には選択したウィジェットの名前が含まれています
とそのすべての祖先、およびより制限的なドット (.) セパレーター。 二行目
各ウィジェットの特定性の低いクラス名が含まれています。
制限星 (*) セパレーター。 XNUMX 行目には一連の特別なボタンが含まれています。
呼ばれます 任意 ウィジェット これにより、このレベルが一般化され、任意のウィジェットに一致します。 最後
行には、と呼ばれる一連の特別なボタンが含まれています 任意 ウィジェット 鎖 これは
単一のレベルをゼロ以上のレベルに一致するものに変換します。

この領域の初期状態は、リソース名を使用する最も制限的な状態です。
そしてドット区切り。 この領域の他のボタンを選択すると、簡単に行うことができます
より多くのウィジェットが仕様に一致することを許可する制限。 の
極端な場合は、すべての 任意 ウィジェット 鎖 ボタン、これはすべてに一致します
アプリケーションのウィジェット。 別のボタンを選択すると、ツリー表示が
現在のリソースによってどのウィジェットが影響を受けるかを正確に表示するように更新します
仕様。

通常のリソースとコンストレイント リソース
次の領域では、法線または制約リソースの名前を選択できます
設定したい。 一部のウィジェットには制約リソースがない場合があるため、その領域は
表示されません。

リソースの価値
この次の領域では、リソース値を入力できます。 この値は
リソース ファイルに行を入力するのとまったく同じように入力します。 したがって、
エスケープされていない改行は含まれません。 には、いくつかの特殊文字シーケンスがあります。
このファイル：

\n - これは改行に置き換えられます。

\### - # は任意の XNUMX 進数です。 これは、XNUMX バイトに置き換えられます。
XNUMX 進数として解釈されるこのシーケンスが含まれます。 たとえば、値
\000 を指定することで NULL バイトを含むデータを格納できます。

\ - これは何も圧縮されません。

\\ - これは XNUMX つのバックスラッシュに圧縮されます。

コマンドエリア
この領域には、このセクションで説明するいくつかのコマンド ボタンがあります。

保存ファイルの設定
このボタンを使用すると、ユーザーはリソースが保存されるファイルを変更できます。
このボタンをクリックすると、ファイル名を尋ねるダイアログ ボックスが表示されます。 一度
ファイル名が入力されたら、キャリッジ リターンを押すか、 オーケー
保存ファイルを変更せずにダイアログ ボックスをポップ ダウンするには、 キャンセル

保存 このボタンは、 リソースを追加する。 ライン 上記の現在の最後まで
ファイルを保存。 セーブファイルが設定されていない場合 作成セッションプロセスで Save File ダイアログボックスは
ユーザーにファイル名の入力を求めるポップアップが表示されます。

適用 このボタンは、一致するすべてのウィジェットで XtSetValues 呼び出しを実行しようとします。
リソースを追加する。 ライン 上で説明した。 指定された値はすべてに直接適用されます
一致するウィジェット。 この動作は、動的な感じを与える試みです。
リソース エディター。 この機能により、ユーザーはアプリケーションを状態にすることができるため
処理を望まない可能性があります。特定の処理を許可するフックが提供されています。
これらの SetValues リクエストをブロックするアプリケーション (を参照) ブロッキング エディトレス つながり申請
下）。

残念ながら、X Toolkit によってウィジェットに課せられた設計上の制約により、
本質的に静的なシステムを動的に強制しようとするリソース マネージャー
動作が奇妙な結果を引き起こす可能性があります。 の結果が保証されるものではありません。
apply は、値を保存して再起動したときに起こることと同じです。
応用。 この機能は、大まかな感じを与えるために提供されています。
変更によって何が達成されるか、得られた結果を考慮する必要があります
せいぜい疑わしい。 そうは言っても、これはeditresの最も優れた機能のXNUMXつです。
試してみて、何ができるか見てみることを強くお勧めします。

保存して適用
このボタンは、上記の保存と適用のアクションを XNUMX つのボタンにまとめたものです。

ポップダウン リソース ボックス
このボタンは、表示からリソース ボックスを削除します。

ブロッキング エディトレス リクエスト

editres プロトコルは、Athena ウィジェット セットに組み込まれています。 これにより、すべての
Xaw に対してリンクされているアプリケーションは、リソース エディターと通信できます。
これは優れた柔軟性を提供し、便利なツールですが、非常に簡単に変更できます。
虐待された。 したがって、任意の Xaw アプリケーションで値を指定することが可能です。
編集ブロック editresが情報を漏らさないようにするために、以下に説明するリソース
その内部、または無効にする 設定値 プロトコルの一部。

編集ブロック (CLASS 編集ブロック)
このアプリケーションが editres に適用するブロッキングのタイプを指定します
プロトコル。

受け入れられる値は次のとおりです。

all すべてのリクエストをブロックします。

setValues すべての SetValues リクエストをブロックします。 これは唯一の editres リクエストであるため、
実際にアプリケーションを変更します。これは事実上、
アプリケーションは読み取り専用です。

none すべての editres 要求を許可します。

これらのリソースは、どの Xaw アプリケーションにも設定されることに注意してください。 編集者. 彼らは許可します
editres がこれまでに作成したリクエストのすべてまたは一部を保持する個々のアプリケーション
成功。 もちろん、editres も Xaw アプリケーションなので、それを表示して表示することもできます。
editres によって変更された (かなり再帰的、私は知っています)、これらのコマンドは設定によってブロックできます
　 編集ブロック editres 自体のリソース。

リソース

編集者 利用可能なアプリケーション リソースは次のとおりです。

フラッシュ回数 (CLASS フラッシュの数)
アプリケーションのウィジェットがフラッシュされる回数を指定します。
　 ショー アクティブ ウィジェット コマンドが呼び出されます。

フラッシュタイム (CLASS フラッシュタイム)
上記のフラッシュ間の時間。

フラッシュカラー (CLASS フラッシュカラー)
アプリケーション ウィジェットのフラッシュに使用する色を指定します。 明るい色であるべき
フラッシュされている領域にすぐに注意を引くために使用されます。
赤か黄色。

saveResourceFile (CLASS リソースファイルを保存)
これは、リソース行が追加されるファイルです。 Save (Comma Separated Values) ボタンをクリックして、各々のジョブ実行の詳細（開始/停止時間、変数値など）のCSVファイルをダウンロードします。
リソースボックスで発動。

ウィジェット

リソースを指定するには、ウィジェットの階層を知っておくと便利です。
構成します 編集者。 以下の表記では、インデントは階層構造を示しています。
最初にウィジェット クラス名が指定され、次にウィジェット インスタンス名が続きます。

編集者編集者
ペニングされたペニングされた
ボックスボックス
MenuButton コマンド
シンプルメニューメニュー
SmeBSB sendTree
SmeBSB リフレッシュツリー
SmeBSB dumpTreeToFile
SmeLineライン
SmeBSB getResourceList
SmeLineライン
SmeBSB 終了
メニューボタンツリーコマンド
シンプルメニューメニュー
SmeBSB showClientWidget
SmeBSB selectAll
SmeBSB unselectAll
SmeBSB invertAll
SmeLineライン
SmeBSBセレクトこども
SmeBSB selectParent
SmeBSB selectDescendants
SmeBSB selectAncestors
SmeLineライン
SmeBSB showWidgetNames
SmeBSB showClassNames
SmeBSB showWidgetID
SmeBSB showウィジェットWindows
SmeLineライン
SmeBSB フラッシュアクティブウィジェット
ペイン化された hPane
パンナー パンナー
ラベル userMessage
グリップグリップ
舷窓 舷窓
木の木
トグル
.
.
.
TransientShell リソースボックス
ペイン化されたペイン
ラベル リソース ラベル
フォーム名とクラス
トグルドット
スターを切り替え
切り替え
トグル名
クラスを切り替え
.
.
.
レーベル名Label
リスト名リスト
ラベル制約Label
リスト制約リスト
フォーム値フォーム
ラベル値Label
テキスト値テキスト
ボックスコマンドボックス
コマンド setFile
コマンド保存
コマンド適用
コマンド saveAndApply
コマンドキャンセル
グリップグリップ
グリップグリップ

ENVIRONMENT

DISPLAY デフォルトのホストと表示番号を取得します。

X環境
に格納されているグローバルリソースを上書きするリソースファイルの名前を取得します
RESOURCE_MANAGERプロパティ。

onworks.net サービスを使用してオンラインで editres を使用する