5.7.5 HelpTagのサンプル・プログラム |
 |
HelpTagのサンプル・ファイルは次のディレクトリに入っています。
CDE$SYSTEM_DEFAULTS:[EXAMPLES.DTHELP]
|
次の例では， HelpTagの -files オプションの使用法を示すサンプル・ファイルを使用しています。
$ @CDE$PATH:DTHELPTAG -files HELPDEMO.HTG
|
上記のコマンドの実行により次のメッセージが出力されます。
Workfile is --> HELPDEMO.HTG
MARKUP PARSER (with non-canonical SGML enhancements)
(c) Copyright 1993, 1994 Hewlett-Packard Company
(c) Copyright 1993, 1994 International Business Machines Corp.
(c) Copyright 1993, 1994 Sun Microsystems, Inc.
(c) Copyright 1993, 1994 Unix System Labs, Inc., a subsidiary of Novell, Inc.
CDE HelpTag Formatting System. - Version B.00.00 (DTD Version A.01.23)
Interface generated from help.if on Thu Dec 28 09:01:10 1995
helpdemo.htg
Warning: could not open locale translation database.
[.graphics]AppWithHelp.xwd
[.graphics]cauticon.pm
[.graphics]clock.xwd
[.graphics]clouds.xpm
[.graphics]bee.xwd
[.graphics]deadjim.xwd
[.graphics]GeneralHelp.xwd
[.graphics]head-down.xwd
[.graphics]helpchar.ent
[.graphics]helpicon.ent
[.graphics]helplang.ent
[.graphics]helpShelf.pm
[.graphics]integral.bm
[.graphics]noteicon.pm
[.graphics]QuickHelp.xwd
[.graphics]rooster.xpm
[.graphics]Snapshot.bm
[.graphics]Snapshot.xwd
[.graphics]speaker.pm
[.graphics]shuttle2.xwd
[.graphics]sunset.xwd
[.graphics]tribe.xwd
[.graphics]warnicon.pm
[.graphics]xload.xwd
Exiting HelpTag Utility...
$
|
New Desktop には，スクリーン・セーバを追加することができます。スクリーン・セーバのサンプル・プログラムが CDE$SYSTEM_DEFAULTS:[EXAMPLES.DTSCREEN]ディレクトリにあります。
スクリーン・セーバの作成は次の手順で行ってください。
- スクリーン・セーバ・アプリケーションを作成します。
- スクリーン・セーバを起動するアクションを作成します。
- 新しいスクリーン・セーバのアクションを，利用可能なスクリーン・セーバのリストに追加します。これには，次の行を SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM ファイルに追加します。
DTSCREENSAVERLIST == "SampleScreenSaver"
|
リストの各スクリーン・セーバ名は，スペースで区切ります。
- セッションを再起動します。
以上の手順を完了すると，新しいスクリーン・セーバがスタイル・マネージャの [スクリーンセーバ] オプションの利用可能なスクリーン・セーバのリストに追加されます。
新しいスクリーン・セーバの作成についての詳細は，上記サンプル・ディレクトリの README. ファイルを参照してください。
表 5-5 は， New Desktop に付属のCDE構成要素用のヘッダ・ファイルをまとめたものです。これらのヘッダ・ファイルを利用することにより，アプリケーション開発者がデスクトップAPI (ドラッグ・ドロップ，保存および復元，ワークスペース・マネージャなど)，ヘルプ・サービスおよびカスタム・ウィジェットを活用することができます。
ヘッダ・ファイルはディレクトリDECW$INCLUDE にあり，サンプル・ディレクトリのソース・ファイル中で次の構文により参照されます。
ここで DT は DECW$INCLUDEとして定義されている論理名です。
 | 注意
include は必ず小文字で指定し，それに続く句は必ず括弧 (<>) で囲ってください。
|
表 5-5 CDE ヘッダ・ファイル
| DT/ACTION.H
|
アクション関連の構造体および関数
|
| DT/DND.H
|
ドラッグ・ドロップ関数
|
| DT/DT.H
|
CDE バージョン情報， DtInitialize およびDtAppInitialize 関数
|
| DT/DTS.H
|
データ型定数および関数
|
| DT/SAVER.H
|
スクリーン・セーバ API 関数
|
| DT/SESSION.H
|
セッション・マネージャ API (保存および復元) 機能
|
| DT/WSM.H
|
ワークスペース・マネージャ API に関連するデータおよび関数
|
| DT/HELP.H
|
dtfile ヘルプの関数を定義。
|
| DT/HELPQUICKD.H
|
クィック・ヘルプ・ダイアログのリソースおよび関数
|
| DT/COMBOBOX.H
|
コンボ・ボックスのウィジェット用
|
| DT/EDITOR.H
|
エディタのウィジェット用
|
| DT/MENUBUTTON.H
|
メニュー・ボタンのウィジェット用
|
| DT/SPINBOX.H
|
スピン・ボックスのウィジェット用
|
New Desktop にはCDEサンプル・プログラムが用意されており， 表 5-6 で説明しています。サンプル・プログラムには， New Desktop で提供される各種CDE APIやその他のプログラミング・リソースの使用法が示されています。各サンプル・ディレクトリには README. ファイルが入っています。これはサンプル・プログラムと，そのディレクトリ用のサンプル・プログラムを構築するために利用できるコマンド・ファイル (nnnn.com) について説明しているファイルです。
最上位のサンプル・ディレクトリへは，次の例のようにCDE$EXAMPLES論理名で参照することができます。
$ DIR CDE$EXAMPLES
Directory CDE$SYSTEM_DEFAULTS:[EXAMPLES]
DTACTION.DIR;1 DTDTS.DIR;1 DTHELP.DIR;1
DTSCREEN.DIR;1 DTSESSION.DIR;1 DTWIDGET.DIR;1
DTWSM.DIR;1
|
以上のサンプル・プログラム用のヘッダ・ファイルは，次の形式で組み込まれています。
ここでDT は， DECW$INCLUDEとして定義された論理名です。
表 5-6 CDEサンプル・プログラム
| DTACTION
|
あるファイルに対してアクションを実行する，アクションAPIの使用法を示すデモ・プログラムです。アプリケーションは，2つのテキスト入力フィールドを表示します。最初のフィールドにアクション名を入力し， 2番目のフィールドにアクションを実行する対象となるファイル名を入力して， [RETURN] キーを押します。
|
| DTDTS
|
Dts データ表示APIの使用法を教えるプログラムで，データ型，アイコン名，およびプログラムに各ファイルが渡した対応アクションを表示します。ファイルの対応アクションの実行には， dtactionクライアントを使用することができます。
|
| DTHELP
|
CDEヘルプ・システムHelptag言語の使用法および CDEヘルプ・ファイルの作成方法を教えるプログラムで，コンパイルしたヘルプ・ファイル(HELPDEMO.SDL )は，ヘルプ・ビューアで表示することができます。
|
| DTSCREEN
|
スクリーン・セーバ API のサンプル・プログラム(SCREENSAVER.EXE) が入っています。これは，DTスクリーン・セーバAPIを使用した単純なスクリーン・セーバの例で，デスクトップの全ユーザまたはご自分のセッションでこのスクリーン・セーバを利用可能にする手法を教えます。 (あるいは， New Desktop に用意されているスクリーン・セーバ集から1つ選んで，デスクトップ・セッションで使用することもできます。これらのスクリーン・セーバは，スタイル・マネージャの [スクリーンセーバ]ダイアログからプレビューしたり，選択することができます。)
|
| DTSESSION
|
セッションのメカニズムと APIを示すプログラムです。 SESSION.EXEプログラムは， DtSession APIを使用してDt Session管理プロトコルをサポートするアプリケーションの一例です。このアプリケーションでは，セッション終了時に現在の状態(切り替えボタンの値)が保存されます。セッションが再開されると切り替えボタンの状態が復元されます。保存および復元についての詳細は，本書の
第 5.3 節 を参照してください。
|
| DTWIDGET
|
ウィジェット・ライブラリのデモが入っています。 CONTROLS.EXE プログラムではDtSpinBox，DtComboBox，DtMenuButton の各制御， EDITOR.EXE プログラムではDtEditor ウィジェットのデモを実行します。
|
| DTWSM
|
ワークスペース・マネージャ APIのデモが入っています。 OCCUPY.EXE プログラムはCDEワークスペース内にアプリケーションが存在するかどうかの問い合わせと設定の方法を紹介します。 WSINFO.EXE プログラムは，アプリケーションの現在のワークスペースの属性情報を問い合わせる方法を紹介します。
|
CDEプログラミング関連ドキュメントには，コンテキスト・ヘルプ付きのCDEヘルプ・システム，オンラインCDEドキュメント，オンライン・リファレンス・ページ(マニュアル・ページとも呼ばれる) などがあります。印刷版CDEドキュメントも用意されています。
