# はじめに

## 対象読者

このマニュアルは、既存のアプリケーションの共通デスクトップ環境(CDE)への統合、またはCDEの機能を使用する新しいアプリケーションの開発に関心があるプログラマを対象としています。 このマニュアルは、 CDE 開発環境を説明するものであり、 Motif®、 X、 UNIX®、またはCプログラミングの知識があることを前提としています。

## このマニュアルを読む前に

共通デスクトップ環境 プログラマーズ・ガイド は、プログラミング情報を集めたものです。CDEへのアプリケーションの統合を開始する前に、 PG.Pref.mkr.1の節にリストされているマニュアルをお読みください。

共通デスクトップ環境 プログラマ概要 は、CDEの説明と、プログラミング環境を紹介しています。

## このマニュアルの構成

共通デスクトップ環境 プログラマーズ・ガイド は、２部構成になっています。各部に、共通デスクトップ環境の各要素の詳しい説明、概念図、各要素の具体的な使い方の説明、コーディング例があります。

第１部 – PG.prtI.mkr.1は、アプリケーション・レベルと印刷レベルの登録方法を説明します。

PG.basc1.mkr.1 は、既存のアプリケーションの CDEへの基本的な統合に必要な手順を説明します。

第２部 – PG.prt2.mkr.1は、既存のアプリケーションを共通デスクトップ環境に統合する方法を説明します。

PG.fonts.mkr.1は、一般的な標準フォントの記述を使用して、CDE準拠システム上でアプリケーションに最も近いフォントを使用する方法を説明します。

PG.msgs.mkr.1は、情報とエラー・メッセージを表示するための一般的なモデルを説明します。

PG.smgr.mkr.1は、 ICCMセッション管理プロトコルを説明し、セッション・マネージャとのアプリケーションの統合の例を示します。

PG.dndPG.mkr.1 ドラッグ＆ドロップのユーザ・モデル、新しいドラッグ＆ドロップのアプリケーション・プログラム・インタフェース(API)、およびドラッグ＆ドロップの使い方を説明します。

第３部 – PG.prt3.mkr.1は、新しいセッション・マネージャおよびドラッグ＆ドロップと統合する方法を説明します。また、ロケールがログイン・マネージャ、ウィンドウ・マネージャ、および端末エミュレータに与える影響についても説明します。

PG.wsmgr.mkr.1は、アプリケーションを特殊な方法でワークスペース・マネージャと統合する方法を説明します。

PG.widgs.mkr.1は、CDEの一部として提供されるカスタム・ウィジェットの使い方を説明します。

PG.aIII.mkr.1は、 アプリケーションの中でアクションを作成する方法を説明します。

PG.datat.mkr.1は、 データ型関数とデータ型データベースの使い方を説明します。

PG.calmg.mkr.1は、 カレンダ APIについて、関数、データ構造、カレンダ属性、およびエントリ属性などを説明します。カレンダ APIの使い方も説明します。

11章は、アプリケーションを `dtinfo`オンライン・マニュアル・ブラウザに統合する方法について説明します。 ;この章はまた、自分のブラウザを書くために使う DtInfoデータベース・エンジンAPIを要約します。

12章は、 CDEプリンティング・ウィジェットとAPIを説明します。

用語集はこのマニュアルで使われている語句とそのリストです。

## 関連文書

CDEへのアプリケーションの統合を開始する前に、マニュアル・セットの他のマニュアルも読んでください。 付属マニュアルのリストについては、 PG.Pref.mkr.2 を参照してください。

実行環境マニュアル・セットは、次のものからなります。:

- 共通デスクトップ環境 ユーザーズ・ガイド

- 共通デスクトップ環境 上級 ユーザおよびシステム管理者ガイド

- オンライン・ヘルプ・ボリューム

上級ユーザおよびシステム管理者ガイド には、アプリケーションをデスクトップに統合する際に役立つ情報が含まれています。

カレンダAPIとスケジュールAPIの詳細については、X.400 API AssociationからXAPIA規格の最新版を入手してください。 住所は下記のとおりです。 The address is X.400 API Association, 800 El Camino Real, Mountain View, California, 94043.

### 開発環境マニュアル

この節では、開発者マニュアル・セットの各マニュアル—（プログラマーズ・ガイド—を除く）概要を示します。 プログラマーズ・ガイドの他に、開発環境用のマニュアル・セットには次のマニュアルが含まれています。 :

- CDE/Motif スタイルガイドおよび認証チェックリスト

- 共通デスクトップ環境 アプリケーション ・ビルダ ユーザーズ・ガイド

- 共通デスクトップ環境 プログラマ概要

- 共通デスクトップ環境 ヘルプ・システム設計者および プログラマのためのガイド

- 共通デスクトップ環境 ToolTalk メッセージの概要

- 共通デスクトップ環境 国際化対応 プログラマーズ・ガイド

- 共通デスクトップ環境 デスクトップKorn Shellユーザーズ・ガイド

- 共通デスクトップ環境 用語集

- オンライン・マニュアル・ページ

#### 共通デスクトップ環境 プログラマ概要

共通デスクトップ環境 プログラマ概要 は２部構成になっています。第１部には、実行時と開発環境の両方に関するハイレベルの情報など、共通デスクトップ環境アーキテクチャの概要が含まれています。 第２部には、アプリケーションを開発する前に知っておくべき情報と、開発環境のコンポーネントの説明があります。

共通デスクトップ環境 プログラマ概要 は、共通デスクトップ環境の開発環境と開発者マニュアル・セットの概要を示すものです。アプリケーションの設計と開発を始める前に、まずこのマニュアルを読んでください。

#### CDE/Motif スタイルガイドおよび認証チェックリスト

CDE/Motif スタイルガイドおよび認証チェックリスト は、アプリケーション設計のスタイルのガイドラインと、共通デスクトップ環境のアプリケーション・レベルの認定の要件を説明します。 これらの要件は、Motifバージョン1.2の要件に共通デスクトップ環境固有の要件を追加したものです。

チェックリストでは、モデル・キーボードの形式を使用して、キーについて説明します。チェックリストは、英語ロケールで左から右へ書かれる言語を対象としたアプリケーションを設計することを前提としています。 キーボード入力を示す箇所では、Motifのモデル・キーボードの文字でキーが示されています。 マウス・ボタンは、マウスのボタンの数に依存しない動作を示すために、仮想ボタン名称を使用して説明されています。

このマニュアルは、アプリケーション設計者が一貫性のあるアプリケーションを開発し、アプリケーション内の動作に一貫性をもたせるために役立つ情報を提供します。

#### 共通デスクトップ環境 アプリケーション・ビルダ ユーザーズ・ガイド

共通デスクトップ環境のアプリケーション・ビルダは、共通デスクトップ環境アプリケーションを開発するための対話型ツールです。 このツールは、アプリケーション・グラフィカル・ユーザ・インタフェース(GUI)の構築と、デスクトップの多くの便利なデスクトップ・サービス(ヘルプ、ToolTalk、およびドラッグ＆ドロップなど)の組み込みとを容易にする機能を提供します。 共通デスクトップ環境 アプリケーション・ビルダ ユーザーズ・ガイド では、パレットから“オブジェクト”をドラッグ＆ドロップしてインタフェースを作成する方法を説明します。 また、インタフェース内のオブジェクト間の接続方法、アプリケーション・フレームワーク・エディタを使用してデスクトップ・サービスとの統合を簡単にする方法、Cコードの生成方法、およびアプリケーション・ビルダ出力にアプリケーション・コードを追加して最終的なアプリケーションを生成する方法についても説明しています。

#### 共通デスクトップ環境 ヘルプ・システム設計者およびプログラマのためのガイド

共通デスクトップ環境 ヘルプ・システム設計者およびプログラマのためのガイド は、アプリケーション・ソフトウェアのためのオンライン・ヘルプの開発方法について説明しています。 ヘルプ・トピックの作成方法と、オンライン・ヘルプをMotifアプリケーションに統合する方法が述べられています。

このマニュアルの対象読者は、次のとおりです。:

- オンライン・ヘルプ情報の設計、作成、および表示する設計者

- 完全に統合されたヘルプ機能を提供するアプリケーション・ソフトウェアを作成する開発者

このマニュアルは、４部構成になっています。第１部では、アプリケーションのヘルプを設計するために設計者と開発者とが協力して行う役割について説明しています。 第２部は、オンライン・ヘルプを構成および記述する設計者に必要な情報を説明しています。 第３部は、ヘルプ・システムのアプリケーション・プログラマのツールキットを説明しています。第４部は、国際化対応環境向けのオンライン・ヘルプの作成について、設計者とプログラマに必要な情報を説明しています。

#### 共通デスクトップ環境 ToolTalkメッセージの概要

共通デスクトップ環境 ToolTalkメッセージの概要 では、メディア交換およびデスクトップ・サービスのメッセージ・セットの規則に準拠したアプリケーションを作成するための便利なルーチンとして提供されるToolTalkコンポーネント、コマンド、およびエラー・メッセージについて説明しています。 このマニュアルは、ToolTalk®サービスを使用して他のアプリケーションと相互運用するアプリケーションを作成または保守する開発者のためのマニュアルです。

ToolTalkメッセージの概要では、一般的なToolTalkの機能については説明していません。 ToolTalkサービスの詳しい説明は、 ToolTalkサービス: An Inter-Operability Solutionを参照してください。ToolTalkをより簡単に使用するには、 ToolTalk and Open Protocols: Inter-Application Communicationを参照してください。

#### 共通デスクトップ環境 国際化対応プログラマーズ・ガイド

共通デスクトップ環境 国際化対応プログラマーズ・ガイド は、アプリケーションを簡単にローカライズして、さまざまな言語と文化的規則を一貫したユーザ・インタフェースでサポートできるようにする、アプリケーションの国際化対応について説明しています。

特に、次の情報を提供しています。:

- 開発者に対し、世界中で使用できるようなアプリケーションを書くためのガイドラインとヒントを提供しています。

- デスクトップのさまざまな階層にまたがる国際化トピックの全体像を提供しています。

- 参考資料および詳しい記述のあるマニュアルを示しています。一般的な文献を参照する場合もあります。

このマニュアルは、既存の参考資料または概念的なドキュメントの説明をそのまま掲載するのでなく、特定の国際化トピックに関するガイドラインと規則を説明するものです。 国際化トピックに焦点を置くものであり、オープン・ソフトウェア環境の中の特定のコンポーネントや階層について説明したものではありません。

#### 共通デスクトップ環境 デスクトップKorn Shellユーザーズ・ガイド

共通デスクトップ環境 デスクトップKorn Shellユーザーズ・ガイド では、デスクトップKorn Shell(`dtksh`)スクリプトで Motif アプリケーションを作成する方法を説明しています。 開発者が作業を始めるにあたって必要な基本的な情報に加え、徐々に複雑になるスクリプトの例を示しています。

このマニュアルは、特定の作業に適したシェル形式のスクリプト環境を探している開発者を対象としています。 KornShellプログラミング、Motif、Xtイントリンシクスの知識と、Xlibについてのある程度の知識があることを前提としています。

#### 共通デスクトップ環境 用語集

共通デスクトップ環境 用語集は、共通デスクトップ環境で使用する用語の包括的なリストです。 この用語集は、デスクトップのすべてのユーザにとって、ソースおよび参照の基本となります。この用語集の読者は、—エンドユーザ、開発者、翻訳者—まで多岐にわたるため、読者や、用語の由来や、グラフィカル・ユーザ・インタフェースでその用語を使用する共通デスクトップ環境コンポーネントについての情報も、用語定義の書式に含まれています。

## 表記上の規則

このマニュアルは、DocBook文書型定義(DTD)を使用したSGML(Structured Generalized Mark-up Language)で記述されています。 次の表に、このマニュアルで使用する表記上の規則を示します。

## 表記上の規則

`文字または記号` | `意味` | `例`
`AaBbCc123` | コマンドの名前 | ファイルをリストするために`ls`コマンドを使います。
`AaBbCc123` | コマンド・オプションの名前 | すべてのファイルをリストするために`ls` `−a` を使います。
AaBbCc123 | コマンド行プレイスホルダ: 実際の名前または値で置き換えます。 | ファイルを削除するには、`rm` filenameを入力します。
`AaBbCc123` | ファイルとディレクトリの名前 | `.login` ファイルを編集します。
AaBbCc123 | ブック・タイトル、新しい語または条件、強調する語を示します。 | ユーザーズ・ガイド の６章を読んでください。 これらは、クラスと呼ばれています。 これをするために、rootでなければ いけません。