ドキュメント・ロードマップ

Graphics Builderには、包括的なオンライン・ヘルプ・システムがあります。これを使用して、さまざまな概念、参照および操作に関するトピックについての情報を入手できます。

Graphics Builderを使いこなすには:

1	各コンポーネントの概要を述べたクイック・ツアーを確認します。

•	「ヘルプ」 [image] 「クイック・ツアー」を選択する。

2	最も一般的な作業の実行方法を学習するには、キュー・カードを参照します。

•	「ヘルプ」 [image] 「キュー・カード」を選択する。

3	オンライン・マニュアルとハード・コピーのマニュアルを参照します。

•	「ヘルプ」 [image] 「マニュアル」を選択する。

4	ヘルプ・トピックを参照します。

•	目次と索引を参照するには、「ヘルプ」 [image] 「ヘルプ・トピック」を選択する。

•	状況依存ヘルプを参照するには、[Help]キー（ほとんどのプラットフォームでは通常[F1]キー）を押す。

•	Form Builderのキー・コマンドを見るには、「ヘルプ」 [image] 「キーボード・ヘルプ」を選択するか、[キー一覧]（これは通常、ほとんどのプラットフォームで[Ctrl]+[K]を押す）。


円弧オブジェクトの作成

円弧オブジェクトを作成する方法:

1	ツール・パレットから「円弧」ツールを選びます。

2	レイアウト上で、対角線状に選択してドラッグしながら弧を定義し、マウス・ボタンを離します。

円弧を描くには、[Shift]キーを押しながらドラッグしてください。


楕円オブジェクトの作成

楕円オブジェクトを作成する方法:

1	ツール・パレットから「楕円」ツールを選びます。

2	レイアウト上で、対角線状に選択してドラッグしながら楕円を定義し、マウス・ボタンを離します。

楕円を描くには、[Shift]キーを押しながらドラッグしてください。


手書きオブジェクトの作成

手書きオブジェクトを作成する方法:

1	ツール・パレットから「手書き」ツールを選びます。

2	レイアウト上で、選択してドラッグしながら自由に手書きの形を定義し、マウス・ボタンを離します。

「手書き」ツールには、制約はありません。


線オブジェクトの作成

線オブジェクトを作成する方法:

1	ツール・パレットから「線」ツールを選びます。

2	レイアウト上で開始点を選択し、終点までドラッグしてマウス・ボタンを離します。

水平または垂直、45度の線を描くには、[Shift]キーを押したまま、描きたい方向へドラッグします。


多角形オブジェクトの作成

多角形オブジェクトを作成する方法:

1	ツール・パレットから「多角形」ツールを選びます。

2	レイアウト上で、最初の頂点の位置を選択し、順々に次の頂点を選択していきます。多角形の描画を終了するには、最後の頂点をダブルクリックします。

すると、最初と最後の頂点を結ぶ線が描かれます。

水平、垂直または45度のセグメントを描くには、[Shift]キーを押したまま頂点を定義してください。1つの頂点の位置を指定しても、後続の頂点の位置には反映されません。


折れ線オブジェクトの作成

折れ線オブジェクトを作成する方法:

1	ツール・パレットから「折れ線」ツールを選びます。

2	レイアウト上で、最初の頂点の位置を選択し、順々に次の頂点を選択していきます。折れ線の描画を終了するには、最後の頂点をダブルクリックします。

最初と最後の頂点を手動でつなげない限りは、多角形オブジェクトの場合と違ってその2つの頂点を結ぶ線は描かれません。

水平または垂直、45度のセグメントを描くには、[Shift]キーを押したまま頂点を定義してください。


四角形オブジェクトの作成

四角形オブジェクトを作成する方法:

1	ツール・パレットから「四角形」ツールを選びます。

2	レイアウト上で、対角線状に選択してドラッグしながら四角形を定義し、マウス・ボタンを離します。

正方形を描くには、[Shift]キーを押しながらドラッグしてください。


角の丸い四角形オブジェクトの作成

角の丸い四角形オブジェクトを作成する方法:。

1	ツール・パレットで「丸い四角形」ツールを選びます。

2	レイアウト上で、対角線状に選択してドラッグしながら角の丸い四角形を定義し、マウス・ボタンを離します。

角の丸い正方形を描画するには、[Shift]キーを押しながらドラッグします。


プログラムによる図形の作成

  関連項目

プログラムを利用して図形を作成する方法:

  Graphics BuilderのPL/SQLビルトインを使用します。

次の例では、オブジェクトやチャートのバックグラウンドとして使用する大きいカラーの四角形を作成します。

PROCEDURE create_background IS
  the_back   OG_OBJECT;
  rect_pos   OG_POINT;
  rect_ht    NUMBER;
  rect_wi    NUMBER;
BEGIN
/*Set the start position of the rectangle*/
  rect_pos.x:=.5*OG_INCH;
  rect_pos.y:=.5*OG_INCH;
/*Set the rectangle's height and width*/
  rect_ht:=6*OG_INCH;
  rect_wi:=4*OG_INCH;
/*Make the rounded rectangle object*/
  the_back:=OG_MAKE_RRECT(rect_pos, rect_ht, rect_wi);
/*Set the object's foreground fill color and pattern*/
  OG_SET_FFCOLOR(the_back, 'color 25');
  OG_SET_FILLPAT(the_back, 'gray50');
END;


記号について

レイアウトで、記号を飾り付けのアートワーク要素として使用したり、記号をチャート・フィールド・テンプレートの表示形式として使用するように指定できます。


「記号」パレットからの記号の選択

記号パレットから記号を選ぶ方法:

1	ツール・パレットの「記号」パレットのアイコンを選び、オープンします。

パレットがオープンすると、使用可能な記号が表示されます。

2	使用する記号を選びます。

パレットがクローズし、選択された記号が「記号」パレット・アイコンに表示されます。この記号は、現在選択されているすべての記号オブジェクトと「記号」ツールを使用してレイアウトに配置する新規オブジェクトに適用されます。この記号の選択は、次に変更するまで現行の図表に対して有効です。

使用可能な記号のパレットは変更できません。


レイアウトへの記号の配置

記号をレイアウトに配置する方法:

1	ツール・パレットから「記号」ツールを選択します。

2	レイアウト上の記号を表示させたい位置を選択します。

「記号」パレットで現在選択されている記号が、レイアウトに表示されます。


プログラムによる記号の作成

  関連項目

記号をプログラムで作成する方法:

  Graphics BuildプロパティのビルトインOG_MAKE_SYMBOLを使用します。

次に例を示します。

PROCEDURE make_sym IS
  place  OG_POINT;
BEGIN
  place.x:=1*OG_INCH;
  place.y:=2*OG_INCH;
  OG_MAKE_SYMBOL(place, 5, OG_MEDIUM_SYMSIZE);
END;


テキストおよびテキスト・フィールドについて

  関連項目

Graphics Builderでは、テキストを図表に追加するために、テキスト・オブジェクトとテキスト・フィールド・オブジェクトという2種類のオブジェクトが提供されます。この2つのオブジェクトに対して、次のアクションを実行できます。

•	テキスト・オブジェクトを作成する。

•	テキスト・オブジェクトをプログラムで作成する。

•	テキスト・オブジェクトを編集する。

•	テキスト・フィールド・オブジェクトを作成する。

•	テキスト・オブジェクトまたはテキスト・フィールド全体に対してプロパティを設定する。

•	テキスト・オブジェクトまたはデフォルトのテキスト・フィールドのテキストの一部分に対してプロパティを設定する。

•	テキスト・オブジェクトを使用して、タイトルを付けたり、またはアートワーク要素のラベル付けをしたり、説明を追加する。テキスト・フィールド・オブジェクトを使用して、実行時にテキストを入力するための入力領域を追加する。


手動によるテキスト・オブジェクトの作成

テキスト・オブジェクトの作成方法:

1	ツール・パレットから「テキスト」ツールを選択します。

2	レイアウトに、テキスト・カーソルがあるバウンディング・ボックスを作成するために、次のいずれかを行ってください。

レイアウト上のテキスト・オブジェクトを開始させる位置を選択します。テキストは、リターン・キーを押したときのみ次の行にワードラップします。

テキスト・オブジェクト用の特定の領域をドラッグで拡大します。テキストは、ボックスの水平の境界線内に収まるようにワードラップします。テキストを入力するに従って、ボックスは垂直方向に広がっていきます。

3	テキストを入力します。強制改行するには、リターン・キーを使用します。

4	テキストの入力が終了したら、レイアウトのテキスト・オブジェクト以外の場所を選択して、テキスト・モードを終了します。

テキストを入力しないでテキスト・オブジェクトを作成した場合、そのオブジェクトは自動的に削除されるので注意してください。空のテキスト・オブジェクトを作成するには、最初に任意のテキストを入力してテキスト・オブジェクトを作成し、その後でテキストを編集して削除します。空のテキスト・オブジェクトを作成できるのは、固定バウンディング・ボックスの場合のみです。


プログラムによるテキスト・オブジェクトの作成

  例	  関連項目

テキスト・オブジェクトをプログラムで作成する方法:

1	テキスト・オブジェクトを作成します。

2	複数テキスト要素を作成して、複数テキスト・オブジェクトに挿入します。

•	複数テキスト要素は、テキスト・オブジェクト内の1行を表します。複数テキスト要素には、1つ以上のテキスト文字列（単一テキスト要素）を含めることができます。

•	最初の複数テキスト要素は、指定されない限りはテキスト・オブジェクトの索引点ゼロ（0）に挿入されます。

3	前のステップで作成した複数テキスト・オブジェクトに挿入する単一テキスト要素を作成します。

単一テキスト要素は、複数テキスト要素によって作成された行に挿入する実際のテキスト文字列です。

4	単一テキスト要素を複数テキスト要素に挿入します。単一テキスト要素は、一度に1つずつ、複数テキスト要素内の指定された索引点に挿入します。

5	ステップ3と4を、テキスト・オブジェクトに必要なテキスト数のみ繰り返します。

サイズ、フォントおよび間隔のプロパティは、各単一テキスト要素に対して個別に、またはテキスト・オブジェクト全体に対して一度に設定できます。


例: プログラムによるテキスト・オブジェクトの作成

次の例では、テキスト・オブジェクトをレイアウト上のポイント（1", 1"）に作成し、2つの複数テキスト・オブジェクト（テキスト行）を入れます。最初の複数テキスト・オブジェクトには、1つの単ーテキスト要素（文字列）を入れ、2番目の複数テキスト・オブジェクトは、2つの単ーテキスト要素を入れます。この2つのテキスト行は、次のような12ポイントのTimesフォントで表されます。

This is line 1.

And now line 2.

PROCEDURE make_text IS
   text_obj   OG_OBJECT;
   text_pos   OG_POINT;
   smp_rec    OG_SMPTEXT_ATTR;
 BEGIN
/* Set text object's origin properties */
   text_pos.x:=OG_INCH;
   text_pos.y:=OG_INCH;

/* Make the text object */
   text_obj:=OG_MAKE_TEXT(text_pos);

 /* Insert a new compound text element into the text
      object at index 0 */
    OG_INSERT_CMPTEXT(text_obj, 0);

/* Set simple text record for desired text string*/
    smp_rec.str:='This is line 1.';
    smp_rec.mask:=OG_STR_SMPTEXTA;

/* Insert a new simple text element at index 0
      in text object's compound text element at
      index 0, using defined simple text record */
    OG_INSERT_SMPTEXT(text_obj, smp_rec, 0, 0);

/* Insert a new compound text element into the text
     object at index 1 */
    OG_INSERT_CMPTEXT(text_obj, 1);

/* Change the simple text record's text string */
    smp_rec.str:='And now';

/* Insert a new simple text element at index 0
      in text object's compound text element at
      index 1, using defined simple text record */
    OG_INSERT_SMPTEXT(text_obj, smp_rec, 1, 0);

/* Change the simple text record's text string */
    smp_rec.str:=' line 2.';

/* Insert a new simple text element at index 1
      in text object's compound text element at
      index 1, using defined simple text record */
    OG_INSERT_SMPTEXT(text_obj, smp_rec, 1, 1);

/*Set font size and typeface for text object*/
   OG_SET_FONT_PTSIZE(text_obj, '12');
   OG_SET_FONT_TYPEFACE(text_obj, 'Times');
END;


テキスト・フィールド・オブジェクトの作成

テキスト・フィールド・オブジェクトを作成する方法:

1	ツール・パレットから「テキスト・フィールド」ツールを選択します。

2	レイアウトで選択してドラッグしながら四角形のバウンディング・ボックスを定義し、マウス・ボタンを離します。

   正方形のテキスト・フィールドを作成するには、[Shift]キーを押しながらドラッグしてください。

  テキスト・フィールドにデフォルトのテキストを入力する方法は、次のとおりです。

3	ツール・パレットから「テキスト」ツールを選択します。

4	テキスト・フィールド・オブジェクトを選択します。選択した位置にテキスト・カーソルが表示されます。

5	テキストを入力します。

6	テキストの入力が終了したら、レイアウトのテキスト・フィールド・オブジェクト以外の場所を選択して、テキスト・モードを終了します。

実行時に、デフォルトのテキストがテキスト・フィールドに表示されます。このテキストは変更できます。


描画のインポート

描画をインポートする方法:

1	「ファイル」 [image] 「インポート」 [image] 「イメージ」を選択して「インポート」ダイアログを表示させます。

2	「データベース」または「ファイル・システム」ラジオ・ボタンのいずれかを選んで、ファイルのデータ・ソースを示します。

3	ファイル名またはモジュール名を対応するフィールドに入力するか、または「参照」を選択してオペレーティング・システム・ファイル・ダイアログまたは「データベースからインポート」ダイアログを表示させ、そこでファイルまたはモジュールを選択します。

4	「フォーマット」ドロップダウン・リストから描画フォーマット・タイプを選択します。

5	「OK」を選択して、描画ファイルをインポートします。

インポートされたアートワークが、レイアウトに表示されます。

注意: オブジェクトを1つのファイルにグループ化し、そのファイルをCGMフォーマットに変換した場合、これらのオブジェクトのグループ化は解除されます。

Graphics Builderでは、CGMフォーマットで保存された描画ファイルまたは他のOracleアプリケーションからOracleフォーマットで保存されたアートワーク・ファイルを受け入れます。Graphics Builderでは、指定されない限り、描画はアクティブ・レイヤーにインポートされます。


イメージのインポート

イメージをインポートする方法:

1	「ファイル」 [image] 「インポート」 [image] 「描画」を選択して、「インポート」ダイアログを表示させます。

2	「データベース」または「ファイル・システム」ラジオ・ボタンのいずれかを選んで、ファイルのデータ・ソースを示します。

3	ファイル名またはモジュール名を対応するフィールドに入力するか、または「参照」を選択して、オペレーティング・システム・ファイル・ダイアログまたは「データベースからインポート」ダイアログを表示させ、そこでファイルまたはモジュールを選択します。

4	「フォーマット」ドロップダウン・リストからイメージ・フォーマット・タイプを選択します。

5	「OK」を選択して、イメージ・ファイルをインポートします。

インポートされたアートワークが、レイアウトに表示されます。


PL/SQLによるアートワークのインポート

  関連項目

アートワークをPL/SQLでインポートする方法:

  Graphics BuilderのビルトインOG_IMPORT_IMAGEを使用します。

次の例では、イメージをアクティブ・ウィンドウのアクティブ・レイヤー上にインポートします。

PROCEDURE import_the_image IS
   the_image   OG_OBJECT;
   the_layer   OG_LAYER;
BEGIN
  the_layer:=OG_GET_LAYER('layer1');
  OG_ACTIVATE_LAYER(the_layer);
  the_image:=OG_IMPORT_IMAGE('my_image',OG_FILESYSTEM,
    OG_TIFF_IFORMAT);
END;


サウンドについて

サウンドは、実行時の特定のイベントを知らせるのに有効です。たとえば、チャート内のデータが特定のしきい値に満たなかった場合などに鳴らす警告音を録音できます。実行時のサウンドは、PL/SQLを使用したプログラムにより再生します。


サウンドの録音

サウンドを録音する方法:

1	オブジェクト・ナビゲータでサウンド・サブノードを選び、「作成」ボタンまたは「ナビゲータ」 [image] 「作成」を選びます。現行の図表にサウンドが存在しない場合は、ナビゲータのサウンド・ノードをダブルクリックして、「サウンド」ダイアログ・ボックスに新規のサウンドを表示します。

新規サウンド(初期名はサウンドx)が作成され、「サウンド」ダイアログ・ボックスが表示されます。

2	新規のサウンドを録音するには、「録音」ボタンを選択します。

3	録音が済んだら、「終了」ボタンを選択します。

4	サウンドを受け入れてダイアログをクローズするには、「OK」を選択します。

サウンドが図表に追加されます。サウンドへは、PL/SQLのビルトイン・プロシージャOG_PLAY_SOUNDを使用してアクセスできます。


プログラムによるサウンドの録音

  関連項目

サウンドをプログラムで録音する方法:

  Graphics BuilderのビルトインOG_RECORD_SOUNDを使用します。

次の例では、ランタイムの図表内に「サウンド」ダイアログ・ボックスを表示し、そこで新規サウンドを録音できるようにします。

PROCEDURE record_warning IS
   warn_sound   OG_SOUND;
BEGIN
   warn_sound:=OG_GET_SOUND('warning');
   IF NOT OG_ISNULL(warn_sound) THEN
      OG_RECORD_SOUND(warn_sound);
   END IF;
END;


サウンドのインポート

サウンドをインポートする方法:

1	「ファイル」 [image] 「インポート」 [image] 「サウンド」を選んで、「サウンド・インポート」ダイアログを表示します。

2	ファイルのソースの指定に、「ファイル・システム」または「データベース」ラジオ・ボタンのいずれかを選びます。

3	「ファイル」フィールドにファイル名を入力するか、または「参照」を選択してファイルのリストを表示し、そこからファイルを選びます。

4	「フォーマット」ドロップダウン・リストから適切なサウンド・ファイルのフォーマットを選びます。

5	ダイアログを受け入れてサウンドをインポートするには、「OK」を選択します。

サウンドが図表に追加されます。サウンドへは、PL/SQLのビルトイン・プロシージャOG_PLAY_SOUNDを使用してアクセスできます。

ファイル・システムまたはデータベースから既存のサウンド・ファイルをインポートできます。


図表のインポート

図表をインポートする方法:

1	「ファイル」 [image] 「インポート」 [image] 「図表」を選んで、「図表インポート」ダイアログを表示します。

2	図表の名前と位置、および各図表のアクティブ・レイヤーにマージするかどうか、名前の重複の解決方法を指定します。

3	ダイアログを受け入れて図表をインポートするには、「インポート」を選択します。

ファイル・システムまたはデータベースに格納されている図表を、現行の図表にインポートできます。この方法で、ある図表の内容を別の既存の図表にコピーし、2つの図表を効果的に結合できます。


レイヤーについて

「レイヤー設定」ダイアログを使用して、レイヤーに対するすべてのアクションを実行できます。このダイアログは、メニューから「ツール」 [image] 「レイヤー」を選ぶと、いつでも表示できます。オブジェクト・ナビゲータを使用しても多数のアクションを実行できます。実行できるアクションは、次のとおりです。

•	新規レイヤーを作成します。

•	レイヤーを改名します。

•	レイヤーをアクティブ化します。

•	PL/SQLを使用してレイヤーをアクティブ化します。

•	レイヤーを隠す、または表示します。

•	PL/SQLを使用してレイヤーを隠す、または表示します。

•	レイヤーを並べ替える。

•	レイヤーを削除します。

アクティブ・レイヤーとは作業中のレイヤーのことで、常に表示されています。複数のレイヤーを作成してアクティブ・レイヤーと並んで表示させることができます。また、複数のレイヤーを隠すこともできます。新規の図表を作成すると、その図表には、layer0 というレイヤーが1つ含まれています。このときはこれが唯一のレイヤーなので、デフォルトでこれがアクティブ・レイヤーとなります。

PL/SQLを使用して、すでにあるレイヤーを実行時に操作できます。アクティブ・レイヤーは、エンド・ユーザーが対話できる唯一のレイヤーですが、別のレイヤーでユーザー入力が必要な場合は、PL/SQLを使用してアクティブ・レイヤーを変更できます。この他にも、レイヤーを隠したり表示したり、レイヤーの積上げ順序を変更することで、個々のオブジェクトを全体的にまたは部分的に見えなくすることができます。

たとえば、レイアウトをひとつのレイヤーのみで構成されているように見せることができます。

しかし、実際は複数のレイヤーで構成されているかもしれません。

表示または隠すレイヤーを、いつでも一度に必要な数のみ設定できます。アクティブ・レイヤーは、常に表示されている必要があります。


新規レイヤーの作成

新規のレイヤーを作成する方法:

1	オブジェクト・ナビゲータでレイヤー・オブジェクトを選択します。

2	「作成」ボタンを選択するか、または「ナビゲータ」 [image] 「作成」を選択し、「レイヤー設定」ダイアログを表示します。

別の方法として、メニューから「ツール」 [image] 「レイヤー」を選ぶこともできます。

3	「新規作成」を選択します。「既にあるレイヤー」リストに、layerxという新規のレイヤーが表示されます。この場合xはインスタンス番号で、新規レイヤーが作成されるごとに1つずつ増えます。新規レイヤーがアクティブ・レイヤーになります。

4	変更を確定し、「レイヤー設定」ダイアログをクローズするには、「OK」を選択します。

レイアウトが複数のビューに分割されている場合は、すべてのビューに新規レイヤーが追加されます。ただし、アクティブ・ビュー内のレイヤーのみがアクティブ・レイヤーになります。


図表について

Graphics Builderで作成されたアプリーションは図表と呼ばれます。図表は、データ・ソースから問合せをされるデータ、および、図形要素、ドリルダウン機能または連続更新など数種類のコンポーネントから構成されています。

Graphics Builderの図表には、次のようなコンポーネントがあります。

チャート

図形オブジェクト

アートワークのインポート

サウンド

レイヤー

ページ・ブレーク

著作権情報


チャート

チャートは、データを視覚的に示すために図表中に作成することができるグラフィック・ダイアグラムです。


図形オブジェクト

オブジェクトは、レイアウト上の目で見ることができる要素です。図形オブジェクトは、Graphics Builderの描画ツールで作成したり、または図表にインポートして、目で見ることができる要素です。


アートワークのインポート

Graphics Builder内でアートワークを作成したり、サード・パーティ製アプリーションから描画ファイルおよびイメージ・ファイルをインポートできます。


サウンド

システムがサウンドをサポートしている場合は、図表で使用するためにオーディオ録音をすることができます。


レイヤー

すべての図表レイアウトは、レイヤーと呼ばれる1つ以上の固有の表面から構成されます。レイヤーは、特定の条件においてのみ表示するオブジェクトを配置するのに便利です。たとえば、あるレイヤー上のボタンを選択すると別のレイヤーにオブジェクトを表示させることができます。また、あるレイヤーを隠して、そのレイヤーのオブジェクトを「主レイアウト」ウィンドウ以外のウィンドウに表示させることもできます。


ページ・ブレーク

ページ・ブレークは、レイアウト上に表示される黒色の実線であり、各ページ・ブレークは印刷ページの境界を示します。ページ・サイズは、「ページ設定」ダイアログの設定によって決まります。

ページ・ブレークはBuilder内でのみ表示され、図表が実行または印刷される時には見えなくなります。


著作権情報

作成した図表に作成者名や最終更新日などの著作権情報を追加できます。この情報は、ランタイムを実行している他のユーザーが、その図表の作成者や作成日などの詳しい情報を知りたい場合に利用できます。


図表の作成について

Builderを起動するたびに、Disp1という名前の新規図表が自動的に表示されます。この新規の図表は、あらためて作成する手間を省くためのものです。

Graphics Builderの起動時に初期図表を作成しないように設定するには、「ツール」 [image] 「ツール・オプション」を選択して「ツール・オプション」プロパティ・シートを表示します。「環境設定」タブを選びます。起動ブロックで、「オープン」ドロップダウン・リストから「図表なし」を選択します。この設定を環境設定ファイルに保存するには、「保存」を選択します。


新規図表の作成

新規図表を作成する方法は次のとおりです。

  オブジェクト・ナビゲータでは、「図表」 ノードを選択した後、ツールバーの「作成」ボタンを選択します。

新規図表が、レイアウト・エディタに表示されます。デフォルト名はDispxです。ここで、xは現行のセッション中に新規図表が作成されるたびに1ずつ増加するインスタンス番号です。

現在オープンされている図表がなければ、ナビゲータ内の図表ノードをダブルクリックして、新規図表を作成します。


チャートについて

チャートは単一オブジェクトとしてレイアウト上に表示されますが、実際には3つの主要コンポーネントから構成されます。

•	問合せ

•	チャート領域

•	チャート・テンプレート

使用する問合せおよびチャート・テンプレートを指定し、レイアウト上のチャート領域を定義することにより、レイアウト・エディタ内でチャート・コンポーネントを作成できます。別の方法としては、PL/SQLを使用したプログラムでチャート・コンポーネントを作成できます。

たとえば、プログラムで問合せを定義し、チャート・テンプレートを選択し、フィールドをボタンにする、またはチャートの残りを切り離すように設定してフィールドを"突出させる"ことができます。また、PL/SQLを使用してフィールドのパターンまたはカラー、線の形式を設定することで、そのフィールドの図形プロパティを定義できます。この後、データ項目の特定のしきい値など、プロパティの適用時の条件を設定できます。実行時、Graphics Builderは、指定されたデータ項目または条件に従って、指定されたフィールドにプロパティを適用します。


問合せについて

問合せは、チャート用のデータを取り出すためにGraphics Builderが必要とするSQL SELECT文またはファイルです。1つのチャートは、一度に1つの問合せとのみ関係付けることができます。チャートの描画時、Graphics Builderでは、別の問合せを指定しない限りは現行の問合せのデータが使用されます。


チャート・テンプレートについて

チャート・テンプレートでは、チャートの書式およびそれに含まれるさまざまなプロパティを定義します。1つのチャートは、一度に1つのチャート・テンプレートとのみ関連付けることができます。ただし、個々のチャート・テンプレートに対して以下のアクションを実行し、そのテンプレートを使用してプロパティを複数のチャートに適用できます。

•	軸枠プロパティの指定

•	項目、値および日付軸プロパティの指定

•	凡例の移動

•	参照線の定義

•	数値および日付書式の指定

•	テキストおよび線プロパティの指定

•	カラーとパターンの指定

各チャート・テンプレートは、1つ以上のフィールド・テンプレートと関連付けることができます。フィールド・テンプレートは、棒グラフまたは列、円グラフの円弧、線グラフなど個々のフィールドのプロパティを定義します。


チャート・タイプについて

次のリストに、作成できるチャートの使用可能なタイプと、推奨される使用方法を示します。

縦棒グラフ	このチャート・タイプは、縦棒を使用してデータを比較する際に使用します。たとえば、縦棒グラフ・チャートを使用して、四半期ごとの各営業担当員の販売収益を示すことができます。
円グラフ	このチャート・タイプは、各部分の全体に対する割合または比率を比較する際に使用します。たとえば、円グラフ・チャートを使用して年間収益を部門別または四半期別に比較できます。
横棒グラフ	このチャート・タイプは、横棒を用いてデータを比較する際に使用します。たとえば、横棒グラフ・チャートを使用して月次収益を比較できます。
表	このチャート・タイプは、データを表形式で示す際に使用します。たとえば、表チャートを使用して従業員構成チャートを表すことができます。
折れ線グラフ	このチャート・タイプは、特定のデータ集合の垂直方向の変化を示す際に使用します。たとえば、折れ線グラフを使用して、毎日のまたは1時間ごとの株価の変化を表示できます。
散布図	このチャート・タイプは、データを2つの値軸に沿って示す際に使用します。散布図チャートは、標準偏差を示すのに適しています。たとえば、散布図チャートを使用して従業員の年齢と給与を表します。2つのデータ集合間に相関関係がある場合、点はかなり密接にグループ化されます。グループからかなり離れたところにある点が、給与の格差を示します。
複合グラフ	縦棒グラフおよび折れ線グラフなど複数の表示形式を結合したものです。たとえば、複合グラフを使用して、毎日の販売収益を、データの集計表示を示す折れ線グラフと一緒に表示できます。
株価チャート	このチャート・タイプは、株価の高値、安値および終値に対応する値フィールドを表すのに使用します。問合せの各行に対して、株価チャート範囲がチャート上に表示されます。
ダブル-Y軸グラフ	このチャート・タイプは、データを表す2つの独立したY軸を示します。各Y軸は、異なる値範囲を示すことができます。たとえば、1つの軸は収益を、もう1つの軸は収入を表すのに使用し、この両方を時間の経過に沿って表示できます。
ガント・チャート	このチャート・タイプは、特定の期間にわたってのプロジェクト・データの集合を示します。ガント・チャートは、一般的にはプロジェクトの段階的スケジュールを示すのに使用されます。


軸チャートについて

  例

Graphics Builderで作成できるチャートの大部分は軸チャートです。軸チャートは、軸というチャートの枠に沿ったそのデータの位置に応じて、データが表示されるチャートです。列および棒グラフ、折れ線グラフのチャートは、すべて軸チャートです。軸チャートには2または3本の軸を含めることができます。各軸は次のタイプのどれかです。

•	項目

•	値

•	日付

使用上の注意: 軸チャートを作成する場合、問合せの表に割り当てられた列名からX軸およびY軸ラベルが取得されます。これらの軸ラベルを軸プロパティ・シートでカスタマイズするか、または問合せの中の列の別名を指定できます。チャート・テンプレートを使用する場合、問合せの中のカスタマイズ済み軸ラベルを割り当てるのが良い方法です。


例:問合せでカスタマイズされた軸ラベルの割当て

/*The following example demonstrates how you can
**customize axis labels by specifying a column
**name alias in your query.
*/

select warehouse_id "Warehouse ID",
amount_in_stock "Inventory Levels"
from s_inventory


項目軸について

項目軸は、固定間隔で固有の値を表示するための軸です。これらの値は、数学的に関係付けられていません。項目（独立型）データは、離散した軸に沿って表されるので、離散軸は項目軸とも呼ばれます。

たとえば、従業員名を項目軸に沿って表します。ただし、給与は項目軸に沿って表せません（貨幣の値は、数学的に一方が他方より大きいという関係があるため）。


値軸について

値軸は、数学的に関連する値を表示するための軸です。軸は1つの値から始まり、別の値に達するまで続きます。表示間隔は、データ値が、軸の下限と上限間のどこに位置するかによります。値(依存）データは、連続した軸に沿って表されるので、連続軸は値軸とも呼ばれます。

たとえば、従業員の給与を値軸に沿って表します。ただし、従業員名は値軸に沿って表せません。


日付軸について

日付軸は、DATE値を表示するための軸です。軸は、1つの日付から始まり、別の日付に達するまで続きます。（この点では日付軸は値軸に似ていますが、Graphics Builderでは、両者をまったく異なる軸として扱います）。表示間隔は、データ値が、軸の下限と上限間のどこに位置するかによります。

たとえば、従業員の入社日を日付軸に沿って表します。


レイアウト・エディタで新規問合せからチャートを作成する

チャートを作成する方法は次のとおりです。

1	未接続のデータベースに接続するには、「ファイル」 [image] 「接続」を選択します。

2	「ツール」パレットの「チャート」ツールを選択し、次にレイアウト上で選択するか、またはチャートの領域をドラッグして拡大します。

また、メニューから「チャート」 [image] 「チャート作成」を選択することもできます。

チャート領域をドラッグして拡大しないと、Graphics Builderでは、デフォルトのチャート領域サイズが使用されます。

図表の中に既存の問合せがある場合、「チャート生成」ダイアログが表示されます。既存の問合せがない場合は、「新規問合せ」ダイアログが表示されます。

問合せを作成する方法は次のとおりです。

3	「チャート作成－ 新規問合せ」ダイアログを表示するには、「チャート生成」が表示された後に、「新規問合せ」ラジオ・ボタンを選択し、「OK」を選択します。

4	「SQL文」フィールドにSQL SELECT文を入力するか、または別の問合せタイプを選びます。

5	「実行」を選択して問合せを実行します。

戻されたデータを、データ・プロパティ・ページで見ることができます。

チャート・プロパティを指定する方法は次のとおりです。

6	「チャート作成－新規問合せ」プロパティ・シートをクローズしてチャート・プロパティ・シートを表示するには、「OK」を選択します。

7	(オプション）チャートの名前とタイトルを入力します。

8	チャート・タイプとサブタイプを選びます。

9	チャートを作成するには、「OK」を選択します。

レイアウト・エディタにチャートが描画されます。オブジェクト・ナビゲータにチャート・オブジェクトが表示されます。チャート領域は、チャートによって埋められる場所です。目盛りきざみラベルと凡例は、この領域を超える場合があります。

これで、レイアウト上の他のオブジェクトを操作するようにチャート・オブジェクトを操作（選択、移動、サイズ変更、削除など）するか、またはチャート・オブジェクトのプロパティを変更できます。


既存問合せのチャートの作成

既存の問合せからチャートを作成する方法は次のとおりです。

1	レイアウト・エディタで、「ツール」パレットの「チャート」ツールを選択します。次にレイアウトで選択するか、またはチャート領域をドラッグして拡大します。

また、メニューから「チャート」 [image] 「チャート作成」を選択することもできます。

チャート領域をドラッグして拡大しないと、Graphics Builderでは、デフォルトのチャート領域サイズが使用されます。

「チャート生成」ダイアログが表示されます。

2	「既存問合せ」ドロップダウン・リストから既存の問合せを選択します。

3	ダイアログを確定してチャート・プロパティ・シートを表示するには、「OK」を選択します。

4	(オプション）チャートの名前とタイトルを入力します。

5	チャート・タイプとサブタイプを選びます。

6	チャートを作成するには、「OK」を選択します。

レイアウト・エディタにチャートが描画されます。オブジェクト・ナビゲータにチャート・オブジェクトが表示されます。チャート領域は、チャートによって埋められる場所です。目盛りきざみラベルと凡例は、この領域を超える場合があります。

これで、レイアウト上の他のオブジェクトを操作するようにチャート・オブジェクトを操作（選択、移動、サイズ変更、削除など）するか、またはチャート・オブジェクトのプロパティを変更できます。


プログラムによるチャートの作成

チャートをプログラムで作成する方法は次のとおりです。

1	必要であれば、使用するテンプレートを定義します。

2	使用する問合せを作成します。

3	PL/SQLプログラム単位を作成します。例


例:プログラムによるチャートの作成

/* The following example assumes that the template
**and query have already been defined.It executes
**the specified query and stores the results
**internally.
*/

PROCEDURE create_chart IS
/* Declare the variables */
   the_chart      OG_OBJECT;
   ch_pos         OG_POINT;
   ch_hy          NUMBER;
   ch_wi          NUMBER;
   the_query      OG_QUERY;
   the_template   OG_TEMPLATE;
   indep_field    OG_FIELD;
   dep_field      OG_FIELD;
BEGIN
/* Get the template and query that have already been
      defined in the Builder */                               the_template:=OG_GET_TEMPLATE('template0');
   the_query:=OG_GET_QUERY('query0');
/*Set the position of the chart in X/Y coordinates*/
  ch_pos.x:=0*OG_INCH;
  ch_pos.y:=0*OG_INCH;
/*Set the height and width of the chart */
  ch_ht:=3*OG_INCH;
  ch_wi:=3*OG_INCH;
/* Make the chart */
  the_chart:=OG_MAKE_CHART(chpos, ch_ht, ch_wi,
the_template, the_query);
/* Define a field for ENAME */
  indep_field.field_type:=OG_INDEPENDENT;
  indep_field.colname:='ENAME';
/* Insert it into the chart in the 0th position */
  OG_INSERT_FIELD(the_chart, indep_field, 0);
/* Define a field for SAL */
  dep_field.field_type:=OG_DEPENDENT;
  dep_field.colname:='SAL';
  dep_field.ftname:='column';
/* Insert it into the chart in the second position */
  OG_INSERT_FIELD(the_chart, dep_field, 1);
/* Define as field for COMM */
  dep_field.field_type:=OG_DEPENDENT;
  dep_field.colname:='COMM';
  dep_field.ftname:='column';
/* Insert it into the chart in the last position */
  OG_INSERT_FIELD(the_chart, dep_field, OG_LAST);
/* Execute the query for the first time*/
  OG_EXECUTE_QUERY(the_query);
/* Update the chart so the new field and query
      information takes effect */
  OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END;


チャート作成中の問合せの作成

  関連項目

チャート作成時に問合せを作成する方法は次のとおりです。

1	「チャート」 [image] 「チャート作成」を選択します。

別の方法として、「レイアウト・エディタ」ツール・パレットで「チャート」ツールを選び、次に図表領域を選択するか、またはチャートの領域をドラッグして拡大します。

既存の問合せがない場合は、「新規問合せ」ダイアログが表示されます。既存の問合せがある場合は、「チャート生成」ダイアログが表示されます。

2	「チャート作成－新規問合せ」プロパティ・シートを表示するには、「チャート生成」が表示された後に、「新規問合せ」ラジオ・ボタンを選択し、「OK」を選択します。

3	「SQL文」フィールドにSQL SELECT文を入力するか、または別の問合せタイプを選びます。

4	「実行」を選択して問合せを実行します。

戻されたデータを、データ・プロパティ・ページで見ることができます。

5	「チャート作成－新規問合せ」プロパティ・シートをクローズしてチャート・プロパティ・シートを表示するには、「OK」を選択します。

チャートを作成するには、チャートのオプションを選択して「OK」を選択します。

チャート作成時に問合せを作成すると、2つのアクションを1つのプロセスに結合します。これにより、問合せを別々に定義することなくチャートを素早く作成できます。新規問合せをチャートと一緒に作成した後、両方のオブジェクトがオブジェクト・ナビゲータのリストに表示されます。


チャート・データの指定について

問合せの各列には、項目または値のデータが含まれています。意味のあるデータ表示を作成するには、そのデータをチャートの要素にマップする必要があります。この場合次の事項を考慮してください。

•	データの分類

•	フィールド・マッピング

•	データのフィルタリング


データの分類について

次の2つの方法のどちらかを使用して、問合せ列のデータを分類できます。

•	項目

•	値

データ型によって、そのデータがチャートでどのように表示されるかが決まります。


項目について

項目は、項目に関係付けられた値を持つデータの一部分です。たとえば、多数いる従業員の給与を知りたい場合、従業員名が項目になります。これで、各従業員の給与（各項目の値）のチャートを作成できます。

項目はデータの他の部分に依存しないので、項目を含む問合せ列は、通常、非依存と呼ばれます。前述の例では、従業員名は他のどのデータにも依存しません。

項目は、通常、項目軸または日付軸に沿って表示されます。したがって、日付軸は"項目軸"とも呼ばれます。


値について

値は、項目に関係付けられたデータの一部分です。たとえば、5000という数量は、特定の製品(この製品は項目)に関係付ける必要があります。

値はデータの他の部分に依存しているので、値を含む問合せ列は、通常、依存と呼ばれます。前述の例で、5000という数量は、これが指し示している製品がわからない限りは無意味です。数量の値は、特定の製品に依存しています。

値は、通常、値軸に沿って表示されます。


フィールド・マッピングについて

フィールド・マッピングは、チャートに含める問合せ列、「チャート」フィールドとして列を表す方法、およびフィールドを表示する順序を指定するためのプロセスです。また、フィールド・マッピングは、値（依存型）データ・フィールドとフィールド・テンプレート（列、棒グラフなど）の関連付けにも関係しています。

Graphics Builderでチャートを最初に作成する場合、問合せプロパティのデータ・ページでの列の表示方法と順序、および現行のフィールド・テンプレートに基づいて、フィールド・マッピングが自動的に行われます。デフォルトを変更するには、まずチャートを選び、そのプロパティ・シートをオープンし、値および項目ページの設定を変更します。

チャートを最初に作成した時、Graphics Builderでは、問合せ列はチャートに表示された項目と値にマップされます。一方、次のことを行う場合は、チャートで現在使用されている情報を変更するたびに、項目列と値列を変更する必要があります。

•	データ・フィールドをチャートに追加またはチャートから削除

•	データ・フィールドを表示する順序を変更

•	問合せに別名を追加することにより列名を変更

•	問合せから列を削除

•	チャートにサブ項目を追加

•	フィールド・テンプレートの改名または削除

•	使用するフィールド・テンプレートの追加


項目列および値列の割当て

項目列および値列の割当て方法は次のとおりです。

1	チャートをダブルクリックしてチャート・プロパティ・シートを表示します。

2	項目プロパティ・ページを表示するには、「項目」タブを選択します。また、値プロパティ・ページを表示するには、「値」タブを選択します。

3	次の方法でオプションを変更します。

•	チャートの項目または値のリストに追加するには、「問合せ列」リストから列を選択し、「挿入」を選択します。

•	チャートの項目および値を表示する順序を変更するには、チャート項目列またはチャート値列を選択し、「一番上へ」 (リストの一番上へ移動)、「一番下へ」（リストの一番下へ移動）、「上へ」（1項目上へ移動）または「下へ」（1項目下へ移動）のどれかを選択します。

•	チャート項目列またはチャート値列をそれぞれのリストから削除するには、列を選択し、「削除」を選択します。項目列または値列をリストから削除しても、問合せからは削除されません。

•	チャートの値列をフィールド・テンプレートに関連付けるには、リストから値列を選択し、「フィールド・テンプレート」ドロップダウン・リストからフィールド・テンプレートを選択します。

4	変更を適用してチャート・プロパティ・シートをクローズするには、「OK」を選択します。


ブレーク・チャートの作成

ブレーク・チャートの作成方法は次のとおりです。

1	列チャートまたは棒グラフ・チャートを作成するか、または、チャート・プロパティ・シートをオープンして既存の列チャートまたは棒グラフ・チャートを選びます。

2	「項目」タブを選んで項目プロパティ・ページを表示します。

3	チャート項目リストには、項目が1つのみ表示されていることを確認してください。

4	サブ項目ドロップダウン・リストからサブ項目を選びます。

5	変更を適用してチャート・プロパティ・シートをクローズするには、「OK」を選択します。また、チャート・プロパティ・シートをクローズしないで変更を適用するには、「適用」を選択します。


ドリルダウン・リレーションについて

Graphics Builderを使用して、図表の"マスター"チャートと"ディテール"チャートの間にドリルダウン・リレーションを確立できます。チャート間にドリルダウン・リレーションを確立する方法は、次のとおりです。

実行時にマスター・チャート内の要素を選択して、その要素の詳細情報に"ドリルダウン"できます。たとえば、会社の各部門の経費を示す円グラフで、ある部門の円弧を選択すると、その部門の詳細情報を表示できます。

ドリルダウン・リレーションは、パラメータに基づいています。マスター・チャートでパラメータ値が設定され、細目チャートの問合せで、この値が使用されます。マスター・チャートのチャート要素を選択すると、Graphics Builderでは次のことが行われます。

•	チャート要素で表されるデータ値を判断する

•	値をパラメータに割り当てる

•	パラメータを参照する詳細問合せを実行する

•	詳細チャートを更新する

ドリルダウン・リレーションは変更できます。たとえば、異なる問合せを実行するように指定したり、パラメータ値を異なる列に設定できます。直接プログラムで2つのチャート間のドリルダウン・リレーションを確立することはできません。これと同様に、プログラムでドリルダウン・リレーションを変更することはできません。


2つのチャートの間のドリルダウン・リレーションの作成

2つのチャートの間にドリルダウン・リレーションを確立する方法は次のとおりです。

1	マスター・チャートを選びます。これは、ドリルダウン・アクションを"駆動する"ためのチャートです。

2	パラメータ値を判別するのに使用するチャート要素を選びます。チャート要素には、目盛きざみラベルや、円グラフの円弧などがあります。

チャート要素で示されるパラメータは、ディテール・チャートに対する問合せで使用されるので注意してください。パラメータによって、マスター・チャートとディテール・チャートのリレーションが確立されます。

3	選択したチャート要素のプロパティ・シートをオープンします。（選択したチャート要素をダブルクリックするか、ポップアップ・メニューから「プロパティ」を選択するかまたは「ツール」 [image] 「プロパティ」を選択します）。

4	「ドリルダウン」タブを選んで、ドリルダウン・プロパティ・ページを表示します。

5	新規パラメータを作成するには、「新規作成」を選択します。

「パラメータ」ダイアログが表示されます。

6	デフォルトのパラメータ名PARAMnをアクセプトするか、「名前」フィールドに新規名を入力します。

7	「タイプ」ドロップダウン・リストから、データ型（CHAR、NUMBERまたはDATE）を選びます。

パラメータ用に選ぶデータ型は、そのパラメータが示す列のデータ型に一致させる必要があります。

8	（オプション）「初期値」フィールドにパラメータの初期値を入力します。

9	新規パラメータを確定するには、「OK」を選択します。

「パラメータ」ダイアログがクローズされ、オブジェクト・プロパティ・シートに戻ります。

10	「以下の値に設定」ドロップダウン・リストから、パラメータの値ソースになるように選択したチャート要素を示す列名を選びます。

11	「問合せ実行」ドロップダウン・リストから、ドリルダウンディテール・チャートを更新する問合せを選びます。

12	問合せにパラメータを追加できるように「編集」を選択します。

問合せプロパティ・シートが表示されます。

13	作成したパラメータが組み込まれるように問合せを編集します。例

14	問合せの編集を確定してオブジェクト・プロパティ・シートに戻るには、「OK」を選択します。

15	ドリルダウン・プロシージャを確定するには、「OK」を選択します。

16	ドリルダウン処理をテストするために、図表を上書き保存して、実行します。マスター・チャートのチャート要素を選択して、編集された問合せデータでディテール・チャートが更新されたことで、どのような結果が生じるかを確認します。

前述の処理では、PL/SQLをまったく使用していないことに注意してください。オブジェクト・プロパティ・シートを使用して、図表のあらゆるオブジェクトのドリルダウン・イベントを作成できます。


例: 問合せへのパラメータの追加

/*To edit a query to include a parameter you have created, you might add a
**WHERE clause to the existing query as follows:
** WHERE column1 := :PARAM0
*/

WHERE column1 := :PARAM0


ドリルダウン・リレーションの変更

ドリルダウン・リレーションの変更方法は次のとおりです。

1	ドリルダウン処理を駆動するチャート要素のオブジェクト・プロパティ・シートをオープンします。

2	「ドリルダウン」タブを選んで、ドリルダウン・プロパティ・ページを表示します。

3	新しいオプションを選択します。

4	新規ドリルダウン・リレーションを確定してオブジェクト・プロパティ・シートをクローズするには、「OK」を選択します。

パラメータ自体を変更する場合は、オブジェクト・ナビゲータで、または「編集」を選択し「パラメータ」ダイアログを表示することによりオブジェクト・プロパティ・ページでパラメータにアクセスできます。


インタプリタについて

  関連項目

Graphics Builderでは、Procedure Builderのインタプリタという機能を使用しています。この機能により、図表で使用されているPL/SQLプログラム単位をデバッグできます。

Procedure Builderの操作を実行するには、メニューおよびエディタ、コマンド・ダイアログ・ボックスを使用するか、またはインタプリタのコマンド・ラインでコマンドを入力します。

インタプリタは、Procedure Builderの主要なデバッグ作業領域です。インタプリタは、コマンド・ラインを使用してPL/SQLプログラム単位を定義および表示、デバッグできるペイン・ウィンドウです。

Procedure Builderの起動時のコンテキストによって、インタプリタの表示方法には次の2つがあります。

•	モーダル

•	モードレス

コマンド・ラインへのコマンドの入力時に、ポップアップ・メニューの「新規プロンプト」コマンドを使用すると、そのコマンドを廃棄してインタプリタ・ペインに新規のPL/SQLプロンプトを表示できます。

デバッグ・セッションの記録を保持する場合は、インタプリタのすべての入力と出力をログ・ファイルに記録できます。


インタプリタのコンポーネントについて

インタプリタには、次の5つの主要コンポーネントがあります。

メニュー・バー（モードレスのみ）

コントロール・バー

ソース・ペイン

ナビゲータ・ペイン

インタプリタ・ペイン

両方のタイプ（モーダルとモードレス）のインタプリタに、同じ機能があります。ただし、メニューはモーダル・ウィンドウではアクセスできないので、モーダル・インタプリタには、メニューのかわりにその機能に対応するボタンがあります。

ポップアップ・メニューは、それぞれのペインで使用できる多数の共通のコマンドを含んでいます。

インタプリタの詳細は、Procedure Builderのオンライン・ヘルプを参照してください。


メニュー・バー（モードレスのみ）

ほとんどの作業を実行できるメニュー・コマンドを表示します。


コントロール・バー

ほとんどの共通作業に対してアクセラレータとして使用できるボタンが入っています。


ソース・ペイン

プログラム単位のソースを表示し、デバッグ・アクションを定義できます。


ナビゲータ・ペイン

現行セッションのオブジェクト階層（モーダル・インタプリタ内のデバッグ・ノードのみ）を表示します。

モードレス・インタプリタでは、ナビゲータ・ペインを隠すことができます。


インタプリタ・ペイン

あらゆるPL/SQLの構成体とProcedure Builderのコマンドを入力できるコマンド・ラインを表示します。


モーダル・インタプリタの表示

モーダル・インタプリタの表示方法:

  モーダル・インタプリタは、アプリケーションの実行中に、Graphics Builderによって自動的に表示されます（たとえば、図表のランタイム・シミュレーション時に、Graphics Builderによりプログラム単位内に設定したブレーク・ポイントが見つけられた場合）。モーダル・インタプリタがオープンされている場合、クローズされるまで、アプリケーションとPL/SQLの実行は両方とも停止されます。


モードレス・インタプリタの表示

モードレス・インタプリタの表示方法:

  「ツール」 [image] 「PL/SQLインタプリタ」を選びます。

モードレス・インタプリタが表示されます。デフォルトでは、モードレス・インタプリタにナビゲータ・シートは含まれません。モードレス・インタプリタで実行するすべてのデバッグ・アクションは、Graphics Builderのオブジェクト・ナビゲータ内のオブジェクトを通してアクセスできます。

別の方法として、メニューから「ビュー」 [image] ｢ナビゲータ・ペイン」を選ぶことで、いつでもナビゲータ・シートを挿入できます。

Builderで、またはランタイム・シミュレーション中に、いつでもモードレス・インタプリタを起動できます。


図表のデバッグについて

  関連項目

通常は、エラーとその発生条件に基づいて、エラー・ソースを突き止めることができます。ネストされたプログラム単位の場合は、一番最初のプログラム単位を使用してエラー・ソースを突き止めます。

たとえば、ボタン・プロシージャAがプログラム単位Bをコール、Bがプログラム単位Cをコールするとします。エラーが、これらのプログラム単位のどれか1つを実行中に発生し、PL/SQL例外状況が発生したとします。この場合、エラー・ソースのトレースには、プログラム単位Aを選びます。

エラーの修正方法がすぐにわからないとき、問題の原因を突き止めるのにデバッグ・アクションを設定できます。たとえば、エラーが発生したプログラム単位に、サブプログラムまたはループ、他の制御式へのコールが含まれている場合、問題の正確なソースを突き止めるのは困難です。

デバッグ・アクションによって、PL/SQLプログラム単位の実行を監視または割込み（あるいはその両方）できます。デバッグ・アクションには、次の2つのタイプがあります。

•	ブレークポイント

•	デバッグ・トリガー

さらにDEBUGパッケージを使用して、ブレークポイントの設定、または、プログラム単位の実行を停止し制御をインタプリタに戻す、変数とパラメータの検索と設定、PL/SQLコマンドの解釈などのデバッグ作業を指定できます。

デバッグ・アクションは、Builderまたはデバッガで設定できます。どのような場合にデバッグ・アクションを設定するかは、プログラム単位の複雑さと図表自体によります。


ランタイム・シミュレーションでの図表のテストについて

  関連項目

一番簡単な図表のテスト方法は、Graphics Builderのランタイム・シミュレーション・モード（デバッガとも呼ばれる）を使用することです。Builderで図表を実行し、デバッグ・ウィンドウでその図表をテストできます。この方法で図表をテストおよびデバッグし、Builderに戻って必要な修正を行うという作業が素早くできます。

ランタイム・シミュレーションで図表をテストするとき、Graphics Builderでは、オブジェクト・ナビゲータ以外の現在オープンされているウィンドウはすべて最小化されます。


Graphics Builderでのデバッグ・アクションの設定について

Builderでデバッグ・アクションを設定し、図表を実行した場合、デバッグ・トリガーなどのデバッグ・アクションに達すると、モーダル・インタプリタが自動的に表示されます。モーダル・インタプリタが表示されると、図表およびPL/SQLの実行は、インタプリタをクローズするまで中断されます。

Builderでデバッグ・アクションを設定する場合の考慮事項は、次のとおりです。

•	図表が実行されたらすぐに起動されるオープン・トリガーに、デバッグ・アクションを設定するか。

•	そのデバッグ・アクションを、今後も使用できるように保持するか。

デバッグ・アクションをBuilderで設定し、その後プログラム単位を修正して再コンパイルした場合、ソース位置を変更するためにデバッグ・アクションを修正する必要があります。デバッグ・アクションは、プログラム単位ソースの行番号に関連付けられています。


デバッガでのデバッグ・アクションの設定について

デバッガでデバッグ・アクションを設定することで、モードレス・インタプリタでもその設定を使用してデバッグできます。

デバッガでいったん図表をクローズすると、プログラム単位に設定したすべてのデバッグ・アクションは失われます。デバッグ・アクションがブレークポイントと単純なデバッグ・トリガーのみで構成されている場合は、これを考慮する必要はありません。

デバッガでプログラム単位を直接デバッグする場合、変更はBuilderでは反映されません。


ブレークポイントの使用について

最も一般的なデバッグ・アクションのタイプは、ブレークポイントです。ブレークポイントは、プログラム単位の実行を監視するのに便利です。

Graphics Builderは、ブレークポイントが指定されている行に達する直前にプログラム単位の実行を中断します。この時点で、Procedure Builderの機能を使用してプログラム状態（変数値など）を検査または修正（あるいは両方）できます。適切なプログラム状態になったら、実行またはステップ・コマンドで実行を再開するか、あるいはリセット・コマンドで実行を終了できます。

たとえば、カウント・ループを含むプロシージャがあるとします。このループは、ファンクションをコールし、ローカル変数の値を増やします。各ループ・サイクルにとって正しい値が変数に割り当てられることを確認するために、変数の割当て後、行に直接ブレークポイントを設定できます。ブレークポイントに達してプロシージャに割込みが生じた場合、変数値をチェックするためにナビゲータのコール・スタック・トレースを調べて、その後ステップ・コマンドで次のブレークポイントに回帰できます。


デバッグ・トリガーの使用について

  関連項目

デバッグ・トリガーは、最も一般的なデバッグ・アクションの形式です。デバッグ・トリガーは、プログラム単位内の1ブロックのPL/SQLコードと特定のソース行を関連付けます。

Graphics Builderでは、デバッグ・トリガーが指定された行に達する直前にデバッグ・トリガーが実行されます。デバッグ・トリガーを、次の時点で起動するように指定できます。

•	プログラム単位の、ある単一行に達した時（現行のソース位置、行番号5、行番号23など）

•	インタプリタが制御を取得するたび（インタプリタが、ブレークポイントやプログラムのステップ処理のためプログラムの実行を中断するたびに）。

•	すべての PL/SQLソース行の実行時

デバッグ・トリガーは、特に条件付きブレークポイントの設定に便利です。トリガー本体内から例外DEBUG.BREAKをコールできます。たとえば、次に示すデバッグ・トリガーは、my_procの行番号10に条件付きブレークポイントを確立します。このブレーク・ポイントに到達するのは、ローカルNUMBER変数my_sal が5000を超えた場合のみです。

PL/SQL> .trigger proc my_proc line 10 is
     +> IF DEBUG.GETN('my_sal') > 5000 THEN
     +>   RAISE DEBUG.BREAK;
     +> END IF;


デバッグ・レベルの使用について

  関連項目

デバッグ・アクションがプログラムの実行に割り込むと、インタプリタは制御を取得し、デバッグ・レベルというものを確立します。デバッグ・レベルでは、割り込まれたプログラム単位の状態を検査および修正し、実行を再開するためのコマンドとPL/SQL文を入力できます。

デバッグ・レベルで入力されたすべてのPL/SQLコードは、それ自体が割り込まれる場合があるので（たとえば、別のブレークポイントに達したことによって）、デバッグ・レベルをネストすることも可能です。デバッグ・レベルは、別のデバッグ・レベルと区別できるように番号が付けられます。最も深くネストされたレベルに、一番高い番号が割り当てられます。番号付けは、一番外側のレベルの0（ゼロ）から開始します。

0番、つまり一番外側のレベルは、通常最上位レベルと呼ばれます。最上位レベルには、関連付けられたプログラム状態はありません。これは、最上位レベルが、一番外側のレベルつまりプログラム単位が最初に起動される位置だからです。最上位レベルから起動されたコードが割り込まれると、デバッグ・レベル1が設定されます。同様に、デバッグ・レベル1から起動されたコードが割り込まれると、デバッグ・レベル2が設定されます。このように、デバッグ・レベル3、4...と続きます。

インタプリタのコマンド・プロンプトは、現行のデバッグ・レベルを反映しています。インタプリタが最上位レベルの下にレベルを設定すると、プロンプトに現行のデバッグ・レベル番号を含む接頭辞が組み込まれます。たとえば、インタプリタのデバッグ・レベル1のコマンド・プロンプトは、次のように表示されます。

（デバッグ 1）PL/SQL>

リセット・コマンドを使用して、現行のデバッグ・レベルでの実行を継続せずに制御を外側のデバッグ・レベルに戻せます。


プログラム単位の実行の制御について

いったんデバッグ・アクションに従ってプログラム状態を検査または修正（およびその両方）したら、次のようにプログラム単位の実行を制御できます。

プログラム単位のステップ処理

プログラム単位の実行の再開

プログラム単位の実行の取り消し


インタプリタの入力と出力のロギングについて

Procedure Builderを使用して、プログラム単位のデバッグ中にインタプリタの入力と出力を記録できます。ロギングを使用可能にした後、インタプリタで入力したコマンドとその結果のインタプリタ出力メッセージが、ログ・ファイルに追加または書き込まれます。これは、ロギングを使用不可にするか終了するまで続きます。


ロギングのコマンド・ライン・オプションについて

インタプリタに次のコマンドのいずれかを入力すると、ロギングを制御できます。

•	LOG

•	DISABLE (Logging)

•	ENABLE (Logging)

前述のコマンドとProcedure Builderの他のコマンドの詳細は、ヘルプの目次から「インタプリタ・コマンド・リファレンス」を選んでください。


エラーの修正について

  関連項目

デバッガまたはBuilderのいずれでもエラーを修正できます。デバッガでプログラム単位を修正して再コンパイルすると、変更内容はBuilderで自動的には反映されません。デバッガでプログラム単位に対して複数の変更を行った場合、デバッガ内のプログラム単位と Builder内のプログラム単位を同期化する必要があります。Builderで変更を行った場合は、その変更でエラーが修正されたことを確認するために、必ず図表を保存して再実行してください。


プログラム単位の同期化について

デバッガでPL/SQLエラーを修正した場合は、その修正したプログラム単位の内容とBuilder内のプログラム単位の内容を同期化する必要があります。同期化の操作によって、Builder内のプログラム単位がデバッガのプログラム単位に置き換えられます。


未処理例外の処理について

Graphics Builderでランタイム・シミュレーション時にエラーが発生すると、エラー・メッセージ番号が付いたエラー・メッセージ警告が表示されます。そのエラー・メッセージ番号とエラーの発生条件を必ずメモしておいてください。エラーの発生条件とは、たとえば、図表をオープンしたときに発生したのか、あるいはチャートでドリルダウンを試みたときなのか、あるボタンを選択したときなのかなどです。

Graphics Builderのエラー・メッセージの詳細は、トラブルシューティングの項を参照してください。

エラー・メッセージOG-00637は、未処理のPL/SQL例外が発生したことを示します。このようにエラー・メッセージの中で示された例外番号によって、考えられるエラーの原因について説明している例外エラー・テキストの場所を判別できます。

Graphics Builderでは、Graphics Builderのすべてのビルトイン・プロシージャまたはファンクション、データ型で発生したエラーに対して、多数のビルトインPL/SQL例外が提供されます。Graphics Builderのビルトイン例外は、『Graphics Builderリファレンス・マニュアル』で番号と名前の両方で説明されています。


ランタイム・シミュレーションでの図表のテスト

  関連項目

図表をランタイム・シミュレーションでテストする方法:

1	アクティブな図表を実行するために、オブジェクト・ナビゲータかレイアウト・エディタで「実行」ツールを選択するか、または「ファイル」 [image] 「実行」を選びます。

複数の図表がオープンされている場合は、ナビゲータで実行する図表の図表オブジェクトを選んで、「実行」ツールを選択します。

その図表が、しばらく上書き保存されていない場合、Graphics Builderでは図表の現行状態の一時ファイルが作成され、図表が実行されます。図表を一度も保存していない場合、Graphics Builderで実行する前に図表を保存するように指示が出ます。

Builderで現在図表が1つもオープンされていない場合は、1つ選ぶように指示が出ます。

選択された図表のランタイム・バージョンが、「Graphicsデバッガ」ウィンドウにオープンされます。

2	ドリルダウン・リレーションやボタン・プロシージャをテストして、正確に動作することを確認します。タイマーがある場合は、それが動作して正確な結果が出るかを確認します。

図表がランタイム・シミュレーションで動作したら、図表を生成できます。ただし、図表を生成する前に他の変更を加えた場合は、その変更をテストするために図表を再実行することをお薦めします。


エラーのトレース

  関連項目

エラーのトレース方法:

1	オブジェクト・ナビゲータの「図表名<Debug>」ノードを展開します。

2	プログラム単位をダブルクリックして、プログラム単位エディタにプログラム単位を表示します。

ネストされたプログラム単位からエラーを探す場合は、一番最初にコールされるプログラム単位をオープンします。たとえば、あるボタンを選択した結果エラーが発生したなら、関連付けられたボタン・プロシージャをオープンします。

そのプログラム単位に関連付けられたコンパイル・エラーがプログラム単位ソースの下のペインに表示されます。ネストされたプログラム単位の場合は、エラーが発生する前にコールされるプログラム単位が、エラー・スタックの一番上に表示されます。


ブレークポイントの設定

ブレーク・ポイントの設定方法:

1	「ツール」 [image] 「PL/SQLインタプリタ｣を選択して、PL/SQLインタプリタを表示します。

2	ナビゲータで、デバッグするプログラム単位を選びます。

そのプログラム単位が、インタプリタのソース・ペインに表示されます。各行には番号が付けられています。

3	ブレークポイントを設定する行をダブルクリックします。ブレークポイントが挿入されます。

また、ブレークポイント用に「ブレーク・トリガー」も設定できます。ブレーク・トリガーは、ブレークポイントに達するたびに実行される PL/SQLブロックです。このブロックには、ブレークポイントに達するたびに実行されるProcedure Builderコマンドを含めることもできます。

インタプリタ・ペインでBREAKコマンドを使用して、指定されたソース行にブレークポイントを挿入できます。


デバッグ・トリガーの設定

デバッガ・トリガーの設定方法:

1	「ツール」 [image] 「PL/SQLインタプリタ｣を選択して、PL/SQLインタプリタを表示します。

2	ナビゲータで、デバッグするプログラム単位を選びます。

そのプログラム単位が、インタプリタのソース・ペインに表示されます。各行には番号が付けられています。

3	デバッグ・トリガーを設定する行を選びます。

4	ポップアップ・メニューから「トリガー」を選ぶか、または「デバッグ」 [image] 「トリガー」を選んで、「PL/SQLトリガー」ダイアログを表示します。

5	「トリガー本体」フィールドに、トリガーの本体を入力します。

6	トリガーを受け入れてダイアログをクローズするには、「OK」を選択します。

デバッグ・トリガー作成の詳細は、Procedure Builderのオンライン・ヘルプを参照してください。


プログラム単位のステップ処理

プログラム単位のステップ処理方法:

  STEPコマンドを使用して、割り込まれたプログラム単位をステップ処理します。指定された文が実行された後、制御はインタプリタに戻されます。割り込まれたプログラムの実行を一時的に再開するために、4通りのSTEPコマンドがあります。

STEPコマンドを起動するには、コントロール・バーからボタンを1つ選ぶか、またはインタプリタのコマンド・ラインにSTEPコマンドを入力します。


プログラム単位の実行の再開

プログラム単位の実行を再開する方法:

  GOコマンドを使用して、プログラムの実行を再開します。この実行は、現在実行中の実行スレッドが終了するまで、またはデバッグ・アクションによって再度割り込まれるまで続きます。GOコマンドを起動するには、コントロール・バーから「実行」ボタンを選ぶか、またはGOコマンドをインタプリタのコマンド・ラインに入力します。


プログラム単位の実行の取り消し

プログラム単位の実行の取消し方法:

  RESETコマンドを使用して、現行のデバッグ・レベルでの実行を継続せずに、制御を外側のデバッグ・レベルに戻します。RESETコマンドにより、現行の（および、より高い）デバッグ・レベルでの実行を終了させます。

RESETコマンドを起動するには、コントロール・バーから「リセット」ボタンを選ぶか、またはRESETコマンドをインタプリタのコマンド・ラインに入力します。


ログ・ファイルを使用可能にする

ログ・ファイルを使用可能にする方法:

1	「デバッグ」 [image] 「ログ」を選んで、「ログ・インタプリタ」ダイアログを表示します。

2	「ファイル」フィールドにディレクトリ・パスとログ・ファイル名を入力するか、「参照」を選択してオペレーティング・システム・ファイル・ダイアログをオープンし、そこで既存のログ・ファイルを選びます。

3	現行のログを既存のログ・ファイルに追加する場合は、「追加」チェックボックスを選びます。

4	変更を受け入れて、ダイアログをクローズするには、「OK」を選択します。


ログ・ファイルを使用不可にする

ログ・ファイルを使用不可にする方法:

1	「デバッグ」 [image] 「ログ」を選んで、「ログ・インタプリタ」ダイアログを表示します。

2	「使用不可」チェックボックスを選びます。

3	変更を受け入れて、ダイアログをクローズするには、「OK」を選択します。


ログ・ファイルの表示

既存のログ・ファイルの内容を表示する方法:

  「インタプリタ・ログ」ブラウザを表示するために「デバッグ」 [image] 「インタプリタ・ログ」を選びます。

または

1	「デバッグ」 [image] 「ログ」を選んで、「ログ・インタプリタ」ダイアログを表示します。

2	「ログ表示」チェックボックスを選びます。

3	変更を受け入れて、ダイアログをクローズするには、「OK」を選択します。

「インタプリタ・ログ」ブラウザが表示されます。


プログラム単位の同期化

プログラム単位を同期化する方法:

  メニューから「編集」 [image] 「プログラム単位の同期化」を選びます。


Procedure Builderパッケージ

  関連項目

Graphics BuilderのビルトインPL/SQLのデータ型およびファンクション、プロシージャ以外に、Procedure Builderでは、次のビルトインPL/SQLパッケージが提供されます。このパッケージには、プログラム単位のデバッグ中に参照できる多数のPL/SQL構造体が含まれています。

DDE	ORA_PROF
DEBUG	TEXT_IO
LIST	TOOL_ENV
OLE2	TOOL_ERR
ORA_FFI	TOOL_RES
ORA_NLS


DDE

DDE通信がサポートされます。


DEBUG

PL/SQLプログラム単位のデバッグ用のプロシージャおよびファンクション、例外が提供されます。


LIST

文字列（VARCHAR2）のリストの作成およびメンテナンス用のプロシージャおよびファンクション、例外が提供されます。このパッケージで、PL/SQLバージョン1で配列を作成する方法が提供されます。


OLE2

OLE2 オートメーション・オブジェクト属性の作成および操作、アクセスのためのPL/SQL APIが提供されます。


ORA-FFI

PL/SQLから外部（C言語）ファンクションをコールするためのパブリック・インタフェースが提供されます。


ORA-NLS

現行の言語環境についての高レベルな情報を取り出せます。


ORA-PROF

PL/SQLプログラム単位の調整（特定のコードの実行に要する時間の検査）用のプロシージャおよびファンクション、例外が提供されます。


TEXT-IO

ファイルからの情報の読込みとファイルへの情報の書込みができる構成体が提供されます。


TOOL-ENV

変数環境と対話できるようにします。


TOOL-ERR

DEBUGなどの他のビルトイン・パッケージによって作成されたエラー・スタックにアクセスして操作できるようにします。


TOOL-RES

PL/SQLコードをより移植しやすくするために、リソース・ファイル内のすべてのテキスト・データを切り離してリソースを抽出する方法が提供されます。


レイアウト・エディタのコンポーネントについて

レイアウト・エディタは、Graphics Builderの主な作業領域です。レイアウト・エディタで図形オブジェクト（線、多角形、四角形、テキストなど）を作成、変更することにより図表のレイアウトを設計します。

各図表にはレイアウトが１つのみ含まれ、各レイアウトが所属する図表は、1つのみです。

レイアウト・エディタには、次のコンポーネントがあります。

レイアウト

ツールバー

オブジェクト

定規

格子

ビュー

ツール・パレット

ステータス行


レイアウトについて

レイアウト上でオブジェクトを作成、変更または削除できます。レイアウト上のオブジェクトの外観は、図表を実行したとき、オブジェクトがどのように表示されるかを正確に示しています。レイアウト・エディタでは、オブジェクトのサイズおよび形状、カラー、その他の図形プロパティを変更でき、即座に変更内容が表示されます。


ツールバーについて

ツールバーはレイアウト・エディタ上端に水平に位置しており、「保存」、「実行」、「カット」、「コピー」、「ペースト」などの共通メニュー・コマンドを実行するためのボタンが用意されています。

ツールバーでツールの名前を表示するには、マウスをボタンの上に移動します。ツールの名前はポップアップ・メッセージとして表示され、ステータス行にツールの説明が表示されます。


図形オブジェクトについて

レイアウト上で作成、変更できる図形オブジェクトには、円弧、チャート、イメージ、線、多角形、四角形、丸い四角形、記号およびテキスト・オブジェクトが含まれます。


定規について

定規は、レイアウトの左および上の枠に位置し、オブジェクトのサイズ設定または位置決めをするときに参照点として使用できます。定規を表示または非表示にするには、「表示」 [image] 「定規」を選択します。デフォルトの設定では定規が表示されます。

定規マーカーは、両方の定規の上に表示され、カーソルの水平および垂直位置に従って移動する破線です。定規マーカーを参照して使用することによって、より正確なカーソルの位置決めがしやすくなります。

定規ガイドは、定規に平行なレイアウト上の破線であり、オブジェクトをサイズ設定または位置決めするときに参照点として使用できます。定規ガイドは、Builderのレイアウト上にのみ表示され、図表を実行または印刷するときには表示されません。

定規ガイドを表示または非表示にするには、「表示」 [image] 「定規ガイド」を選択します。デフォルトの設定では定規ガイドが表示されます。


レイアウト格子について

レイアウト格子は、一連の等間隔の水平破線および垂直破線であり、オブジェクトをサイズ設定または位置決めするときに参照点として使用できます。定規の長さの単位に基づいて、格子線の表示間隔を設定できます。格子線はGraphics Builderのレイアウトのみに表示され、図表を実行または印刷するときは表示されません。

格子を表示または非表示にするには、「表示」 [image] 「格子表示」を選択します。デフォルトの設定では格子が表示されます。

格子指定は、オブジェクトのサイズ設定や移動を格子間隔単位で行う機能です。これを使用すると、オブジェクトのサイズ設定または位置決めがより正確にでき、制御がしやすくなります。カーソルが指定する各格子線ペア間の"スナップ・ポイント"の数を設定できます。

格子指定をアクティブ化または非アクティブ化するには、「表示」 [image] 「格子指定」を選択します。格子指定は、デフォルトでは非アクティブです。


ビューについて

ビューは、図表の1つの小さなセクションにフォーカスを合わせたレイアウトの一部分です。最初は1つの大きな表示として表示されますが、最大で4つの表示を作成できます。各表示では、異なるオブジェクト、オブジェクトの一部またはレイヤーを操作できます。さらに、各表示には、専用のレイヤーおよび定規、格子表示、拡大率設定があります。

各表示は独立しているので、定規単位、格子表示、拡大率など、独立して設定できます。さらに、各ビューではレイアウトを独自にスクロールできます。

現在作業中のビューは、"アクティブ"ビューと呼ばれます。アクティブ・ビューであることは、スクロールバーが使用可能になっていることでわかります。非アクティブビューのスクロール・バーは使用不可になっています。

定規および格子表示、その他の設定を変更すると、その変更はアクティブ・ビューのみに適用されます。レイアウト上に表示されているオブジェクトを変更すると、その変更は、そのオブジェクトを表示しているビューすべてに反映されます。


ツール・パレットについて

レイアウト上でオブジェクトを描画および変更するときに使用するツールがツール・パレットに個々のアイコンとして表示されます。ツールを使用するには、次の方法のいずれかを使用して、ツールをアクティブ化する必要があります。

•	単一操作では、アイコンを選択します。操作を実行した後、デフォルトのツールが再びアクティブになります。

•	複数操作では、アイコンをダブルクリックします。アイコン全体が反転表示され、他のツールをアクティブにするまで、そのツールはアクティブです。

一度にアクティブにできるツールは1つのみです。「選択」ツールはデフォルトのツールです。

ツール・パレットにツールの名前を表示するには、マウスをボタンの上に移動します。ツールの名前はポップアップ・メッセージとして表示され、ステータス行にツールの説明が表示されます。


ステータス行について

ステータス行には次の情報が表示されます。

•	マウスの絶対位置（現在選択している定規単位で）

•	マウスのドラッグ距離（現在選択している定規単位で）

•	回転角度

•	ズーム・レベル

ステータス行に表示される情報は、使用しているツールおよび実行しているアクションによって異なります。次の表では、それぞれの環境でステータス行に表示されるステータス情報を示します。

ツール	対策	ステータス情報

各ツール	マウスの移動	カーソルのX、Y座標、ズーム・レベル
円弧、楕円、四角形、丸い四角形	オブジェクトの作成	カーソル開始位置のX、Y座標、オブジェクト幅および高さ、ズーム・レベル
手書き	オブジェクトの作成	カーソルのX、Y座標、ズーム・レベル
行	オブジェクトの作成	カーソルのX、Y座標、線グラフの長さ、回転角度（水平から）、ズーム・レベル
拡大	マウスによる選択	ズーム・レベル
多角形、折れ線	オブジェクトの作成	カーソルのX、Y座標、回転角度（水平から）、ズーム・レベル
回転	オブジェクトの移動	元の位置からの水平および垂直距離、ズーム・レベル
回転	オブジェクトの回転	元の位置からの回転角度、ズーム・レベル
選択	オブジェクトの移動	元の位置からの水平および垂直距離、ズーム・レベル


環境設定の設定

環境設定を設定する方法:

1	ツール・オプションのプロパティ・シートを表示するには、「ツール」 [image] 「ツール・オプション」を選択します。

2	サウンド出力デバイス、イメージ圧縮アルゴリズム、ページ・サイズなど、希望する環境設定を指定します。

3	現行のセッション、または現行およびそれ以降のセッションにオプションを適用できます。

•	現行のセッションのみの環境設定を行うには、「OK」を選択します。設定は、現行のセッションを終了するまで有効です。ただちに有効になる設定もあれば、次に図表を作成またはオープンするときに有効になる設定もあります。

•	現行およびそれ以降のすべてのセッションの環境設定を行うには、「保存」を選択します。Graphics Builder環境設定ファイルに設定が保存され、それ以降のセッションでも有効になります。

オブジェクトを作成および操作しやすくするために、レイアウトをカスタマイズできます。設定する環境設定は、ファイル・システムのローカル環境設定ファイルに保存されます。


レイアウト・サイズの指定

レイアウト・サイズを指定する方法は次のとおりです。

1	「レイアウト設定」ダイアログを表示するには、「表示」 [image] 「表示オプション」 [image] 「レイアウト」を選択します。

2	希望するレイアウト・サイズおよびページ方向設定を指定します。

3	設定を確認して「レイアウト設定」ダイアログをクローズするには、「OK」を選択します。

設定は、現行のBuilderセッションのみで有効です。


レイアウト全体の表示

レイアウト全体を表示する方法は次のとおりです。

  「表示」 [image] 「ウィンドウに合わせる」を選択します。

レイアウト全体が参照できるように、拡大率が下がります。


拡大率の増加

拡大率を上げる方法は次のとおりです。

1	ツール・パレットから「拡大」ツールを選択します。

2	拡大率を上げるレイアウトを選択します。

拡大率は2倍で増加します（オブジェクトも2倍に拡大されて、表示されます）。再び拡大率を2倍にするには、前述のステップを繰り返します。可能な最大拡大率は16倍です。

オブジェクトは大きく表示されますが、実際のサイズは変更されません。


拡大率の減少

拡大率を下げる方法は次のとおりです。

1	ツール・パレットから「拡大」ツールを選択します。

2	[Shift]キーを押しながら、拡大率を下げるレイアウトを選択します。

拡大率は1/2で減少します（オブジェクトも1/2に縮小され、表示されます）。再び拡大率を1/2にするには、前述のステップを繰り返します。レイアウト全体が表示されている状態では、それ以上縮小することはできません。

オブジェクトは小さく表示されますが、実際のサイズは変更されません。


レイアウトの中央にズームイン

レイアウトの中央にズームインする方法は次のとおりです。

  「表示」 [image] 「ズームイン」を選択します。

ビューが2倍に拡大表示されます。


レイアウトの中央からズームアウト

レイアウトの中央からズームアウトする方法は次のとおりです。

  「表示」 [image] 「ズームアウト」を選択します。

ビューが1/2倍に縮小表示されます。


拡大率を標準に戻す

拡大率を標準に戻す方法は次のとおりです。

  「表示」 [image] 「標準サイズ」を選択します。

拡大率が標準に戻され、オブジェクトは実際のサイズとして表示されます。


定規および格子設定の指定方法

定規および格子設定の指定方法は次のとおりです。

1	「定規設定」ダイアログを表示するには、「表示」 [image] 「表示オプション」 [image] 「定規」を選択します。

2	使用する寸法の単位、格子間隔など、希望する定規および格子設定を指定します。

3	設定を確認して「定規設定」ダイアログをクローズするには、「OK」を選択します。

設定は、現行のBuilderセッションのみで有効です。実行時に、定規および格子は表示されません。

定規の長さの単位を変更すると、変更を反映して定規が更新されます。また、拡大したり、別のレイアウト領域に移動すると、それによって定規が更新されます。


定規ガイドの使用方法

定規ガイドを使用する方法は次のとおりです。

  水平または垂直定規を選択し、定規ガイドを希望する位置までドラッグします。希望するところにガイドを配置したら、マウス・ボタンを離します。


定規ガイドの移動

定規ガイドを移動する方法は次のとおりです。

  ガイドを選択し、元の定規までドラッグします。

配置したら、定規ガイドを新規位置までドラッグすることによって、移動できます。レイアウトに必要な数の定規ガイドを配置できます。


格子指定の使用方法

格子指定を使用する方法は次のとおりです。

  「表示」 [image] 「格子指定」を選択します。

前回の設定に従って、格子指定はオンまたはオフに切り替わります。設定は、現行のBuilderセッションのみで有効です。格子指定をオンにすると、作成または移動、サイズ変更する新規オブジェクトが、「定規設定」ダイアログ・ボックスで定義された格子指定ポイントに沿って整列されます。


ビューの作成

ビューを作成する方法は次のとおりです。

  最初に水平スクロール・バーの右側、垂直スクロール・バーの下にある分割バーを使用します。

分割バーを表示するには、ここをクリックしてください。

ビューはBuilderのみのレイアウトに表示され、図表を実行または印刷するときには表示されません。

レイアウトを複数のビューに分割する方法は次のとおりです。

  2、3または4つのビューを作成するには、スクロール・バーの水平または垂直分割バーを使用します。

  2つのビューを作成するには、水平または垂直分割バーを新規位置までドラッグします。1つの軸上に2つのビューが作成され、各ビューには、別の軸上に専用の分割バーが設定されます。

  3つのビューを作成するには、2つのビューを作成してから、別の軸上の分割バーを使用してそのうち1つのビューを分割します。

  4つのビューを作成するには、2つのビューを作成してから、別の軸上の分割バーを使用して両方のビューを分割します。

ビューは現行のBuilderセッションのみに有効であり、実行時は表示されません。


ビューのアクティブ化

ビューをアクティブ化する方法は次のとおりです。

  ビューを選択します。ビューが強調表示されます。

ビュー内での作業をするには、それをアクティブにする必要があります。一度にアクティブにできるビューは1つです。


ビューのサイズ変更

ビュー・サイズを変更する方法は次のとおりです。

  水平または垂直分割バーを新規位置までドラッグします。


ビューの削除

ビューを削除する方法は次のとおりです。

  分割バーをスクロール・バー上の元の位置までドラッグします。


描画オプションの指定

描画オプションを指定する方法は次のとおりです。

1	「書式」 [image] 「描画オプション」を選択してから、「一般」、「円弧」、「テキスト」、「丸い四角形」または「イメージ」のいずれかを選択します。

選択したオプションのダイアログ・ボックスが表示されます。

2	設定するオプションを指定します。

指定した内容は、再びそれを変更するまで、現行の図表で有効です。

レイアウトでそれらを描画したとき自動的に適用されるようにオブジェクトのデフォルト・オプションを指定できます。たとえば、テキストのオプションには、文字揃えおよびスケーラブルな境界線、スケーラブル・フォント、丸めがあります。


オブジェクト・ナビゲータのコンポーネントについて

オブジェクト・ナビゲータには、階層ビューがあり、含まれているすべての図表やオブジェクトをオープンしたり、階層ビューを参照することができます。

オブジェクト・ナビゲータには、次のコンポーネントがあります。

ノード表示領域

ツールバー

位置標識

「検索」フィールド


ノード表示領域について

ノード表示領域は、オブジェクト・ナビゲータの主なコンポーネントです。ここは、現在、使用可能なすべてのオブジェクトが階層で表示されている領域です。


ツールバーについて

ツールバーには、「保存」、「実行」、「作成」、「削除」、「拡張」、「縮小」など、ナビゲータや「ファイル」メニューからも使用可能な共通コマンドが用意されています。


位置標識について

位置標識は、ノード表示領域で現在選択されているオブジェクトの名前を表示します。


「検索」フィールドについて

「検索」フィールドでオブジェクトの一部または完全な名前を入力することにより、ナビゲータのオブジェクトを検索できます。


オブジェクト階層について

ナビゲータ階層内のほとんどのオブジェクトには、オブジェクト・タイプに基づいて、1つ以上のデフォルト・サブオブジェクトが自動的に割り当てられます。これらのデフォルト・サブオブジェクトには、次の2つの基本タイプがあります。

•	割当て

•	参照

たとえば、図形オブジェクトには、ボタン・プロシージャおよび問合せ実行トリガー、パラメータ設定ファンクションが含まれています。プログラム単位には、それをコールしている参照先のオブジェクト、およびプログラム単位自身が参照している参照元のオブジェクトが含まれています。

次の表では、「図表」ノードの最初のレイヤーのオブジェクトに関するデフォルト・サブオブジェクトを示します。

ノード	Object	デフォルト・サブオブジェクト

レイアウト	layerx	ボタン・プロシージャ なし（または、名前） 問合せの実行: なし（または、名前）  パラメータ設定: なし（または、名前）)
テンプレート	templatex	参照先
問合せ	queryx	カスタム実行トリガー: なし（または、名前） 実行後トリガー: なし（または、名前） タイマー: なし（または、名前） 参照先
パラメータ	PARAMx	参照先
タイマー	タイマーx	タイマー・プロシージャ: なし（または、名前） 参照先
プログラム単位	name	指定 参照元 参照先
これらのデフォルト・サブオブジェクトは、図表のオブジェクト間でクロス・リファレンスを追跡しやすいように設計されています。特に、オブジェクトとプログラム単位間、チャートとテンプレート間、パラメータとその値を割り当てるオブジェクト間などです。

たとえば、ドリルダウン・プロシージャを図形オブジェクトに定義してPARAM0値を設定するには、図形オブジェクトの「パラメータ設定」ノードをPARAM0に設定します。同様に、PARAM0の「参照先」ノードをobject_nameに設定します。


ノードの拡張

ノードを拡張して、サブオブジェクトの第1レイヤーを表示する方法は次のとおりです。

1	サブオブジェクトを含むノードを選択します。

2	ノードのサブオブジェクトの第1レイヤーを表示するには、「拡張」を選択するか、「ナビゲータ」 [image] 「拡張」を選択します。

また、ノードの強調表示されたプラス符号を選択して、サブオブジェクトの第1レイヤーを拡張することもできます。

ノードを拡張して、すべてのサブオブジェクトを表示する方法は次のとおりです。

1	縮小したノードを選択します。

2	ノードのすべてのサブオブジェクトを表示するには、「すべて拡張」を選択するか、「ナビゲータ」 [image] 「すべて拡張」を選択します。


ノードの縮小

ノードを縮小する方法は次のとおりです。

1	ノードを選択します。

2	「縮小」を選択するか、「ナビゲータ」 [image] 「縮小」を選択します。ノードのサブオブジェクトは隠されます。

縮小したノードには、頭にプラス符号が付きます。

また、ノードの反転表示されたマイナス符号を選択して、サブオブジェクトの第1レイヤーを縮小することもできます。

ノードを縮小して、すべてのサブオブジェクトを隠す方法は次のとおりです。

1	ノードを選択します。

2	すべてのサブオブジェクトを隠すには、「すべて縮小」を選択するか、「ナビゲータ」 [image] 「すべて縮小」を選択します。


オブジェクトの検索

オブジェクトを検索する方法は次のとおりです。

1	「検索」フィールドで検索するオブジェクトの一部または完全名を入力します。

タイプを開始するとすぐに、Graphics Builderは、オブジェクト・ナビゲータの上から変更分順方向検索を開始します。入力を停止するまで、検索が継続します。

Graphics Builderは、必要に応じてノードを拡張して、検索中に現行の位置を表示します。

2	オブジェクト・ナビゲータで検索条件の次のまたは前のオカレンスを検索するには、「順方向検索」または「逆方向検索」を選択します。

現在、「検索」フィールドで、ワイルド・カードはサポートされません。


埋込み図表の準備について

異なるツールを使用して構築されたアプリケーションにGraphics Builderの図表を埋め込む前に、それらのツールが最適な状態で共に作動できるように環境と図表を準備する必要があります。次に考慮すべき点を示します。

•	モジュールの位置確認

•	外部ソースを使用した問合せ列の挿入

•	図表のサイズ設定

•	図表の実行

•	テキスト・パラメータの受信

•	データの受信

•	レイアウトの構築


外部ソースを使用した問合せ列の挿入について

Graphics BuilderのチャートをForm BuilderやReport Builder（Reports Developerに組み込まれています）などの他のOracle製品に組み込んだ場合、チャートの作成に使用された問合せ列とコールする側の製品の問合せで使用している列とが一致している限り、そのチャートはコール側の製品の問合せからのデータを使用します。

作成しているチャートが他のOracle製品のみからコールされる場合、カスタム問合せを使用して"空白の"チャートを作成できます。このチャートは、他の製品から起動されると、データが挿入されます。カスタム問合せのスキーマ・プロパティ・ページを使用して、コールする側の製品で使用される問合せと同じ名前で列を作成します。次に、カテゴリや値のデータなどを割り当てて、通常のようにチャートのプロパティを定義します。

このチャートは、データが入っていない状態のレイアウトで表示されます。

Graphics Builderの図表が他の製品からコールされた場合、コール側の製品の問合せがカスタム問合せの代用として使用され、列名が同じであるため、チャートがユーザの仕様に合せて描画されます。


モジュールの位置確認について

埋込み図表の実行のためにGraphics Builderがコールされる場合、図表を検索する必要があります。Graphics Builderは、次の順で図表ファイルを検索します。

1	ファイル名の前に付けられているディレクトリ・パス（存在する場合）。

2	オペレーティング・システムで指定される"現在の"ディレクトリまたは「作業」ディレクトリ。

3	GRAPHICS60_PATH環境変数により指定されているパス。

4	ORACLE_PATH環境変数により指定されているパス。

必ず、図表ファイルの位置を明示的に指定するか、パス変数を正しく設定し、パス変数の1つが図表ファイルの位置を示すようにします。


図表のサイズ設定について

アプリケーションに表示される際の図表のサイズは、必ずしもGraphics Builder内の図表のサイズである必要はありません。図表を埋め込む場合、それをクリップするのか、拡大/縮小するのか、あるいは埋め込むアプリケーションのレイアウトに合う大きさの図表を作成するのかを決定する必要があります。

Oracleコンポーネントは同じ図形定義システムを使用するため、Form Builderに対し指定された表示領域に合うように図表を拡大/縮小またはクリップするように指定できます。Report Builder（Reports Developerに組み込まれています）は、表示領域に合うように図表を自動的に拡大/縮小します。

拡大/縮小とクリップは、それぞれ注意すべき点があります。拡大/縮小された図表は、ゆがんで表示される場合があります。クリップされた図表では、そのサイズが表示領域の左上隅（座標0,0）から計算されます。これは、図表オブジェクトがGraphics Builderレイアウト・エディタの上境界線と左境界線から位置付けられる場合、クリップされた図表には「空の」領域が含まれることを意味します。

図表のゆがみや不要な空の領域が出ないようにするには、事前に次の操作を行います。

•	図表の内容をレイアウト・エディタの左上隅に移動させます。

•	「表示」 [image] 「表示オプション」 [image] 「レイアウト」を使用して「レイアウト設定」ダイアログを表示し、図表のサイズを指定します。


図表の実行について

他のOracleコンポーネントは、Graphics Builderのランタイム実行可能プログラムまたはバッチ実行可能プログラムのどちらかを起動できます。


テキスト・パラメータの受信について

  関連項目

Graphics Builder図表を起動するコンポーネントは、図表内で定義されるパラメータに初期値を渡すことができます。これらのパラメータ値は、常にCHAR型として渡されます。

Graphics Builder内でパラメータを作成する場合、「パラメータ」ダイアログでデータ型を指定してください。Graphics Builderは、受信するCHARパラメータ値をそのパラメータに指定されているデータ型に黙示的に変換します。

起動するコンポーネントからGraphics Builderに日付を渡す場合、「図表」プロパティ・シート内で受信する日付の書式を指定する必要があります。たとえば、Graphics Builderに値04-JUL-92を送る場合、「図表」プロパティ・シートの「パラメータ日付書式」フィールドで日付書式DD-MON-YYが指定されている必要があります。


データの受信について

  関連項目

Graphics Builder図表を他のOracleコンポーネントに埋め込む場合、Graphics BuilderはGraphics Builder自身のデータのかわりにそのコンポーネントのデータを使用できます。

Graphics Builder内でそのチャートを作成する場合、「チャート」プロパティ・シートの「データ」プロパティ・ページ内の「問合せ実行時にチャートを更新」をチェックしてください。コール側のコンポーネントで問合せが実行される際に、チャートは新しいデータに更新されます。

Graphics Builderが送ったデータをどのように処理すべきかわかるように、コール側コンポーネントが使用している問合せにチャートの作成に使用している問合せと同じ列名が含まれていることを確認してください。たとえば、図表に項目ENAMEと値SALを表示するチャートが含まれているとします。

Form BuilderがEMPLOYEEとSALARYという列をもつデータに置き換えると、チャートは検索するべき列を見つけることができなくなります。

Graphics Builder問合せに別名を割り当てた場合には、明確にするためそれらを削除することをお薦めします。「軸」プロパティ・シートを使用して、カスタム軸ラベルを割り当ててください。


レイアウトの構築について

Graphics Builderの起動後、Report Builder（Reports Developerに組み込まれています）は常に図表の実行に続くレイアウトの内容を受信します。Graphics Builderの起動後、Form BuilderはOG.OPENプロシージャ内に指定されているレイアウトの内容を受信します。


フォームへの図表の埋込みについて

  関連項目

フォームへ図表を埋め込むには次に示す2つの方法があります。

•	Form Builderチャート・ウィザードを利用

•	PL/SQLビルトインを利用

フォームへ新規チャートを埋め込むには、Form Builderチャート・ウィザードを使用してください。チャート・ウィザードを使用すると、手順を1つずつ追って単純なチャートを作成できます。

既存の図表または複雑な図表を埋め込むには、チャート項目を手動で構築してOG.PLLライブラリをその項目に連結してください。OG.PLLライブラリは、特にフォームと図表間でデータを渡すために設計されたビルトインPL/SQLルーチンのセットです。このライブラリには、データ、マウス・イベント、およびPL/SQLコマンドを渡すプロシージャおよびファンクション、そして実行時に埋込み図表の初期化と切り離しを行うプロシージャおよびファンクションが含まれています。OG.PLLビルトインは、埋込み図表に情報とコマンドを送るフォーム・トリガーがフォーム内で起きるイベントによって起動するとき、それらに取り込むことができます。


フォームでチャートを作成するためにチャート・ウィザードを使用する

  関連項目

フォームでチャートを作成するためのチャート・ウィザードの使用方法:

1	Form Builderのレイアウト・エディタで、「ツール」 [image] 「チャート・ウィザード」を選択するか、またはツールバーの「チャート・ウィザード」ボタンを選択します。

2	レイアウト上で四角形を選択しドラッグします。作成する四角形のサイズにより、作成されるチャート・オブジェクトのサイズが決まります。

3	「新規チャート・オブジェクト」ダイアログで、「チャート・ウィザードを使う」を選択し、「OK」ボタンを選択します。

4	チャート・ウィザードの「ようこそ」ページで「次」を選択し、ウィザードに従いチャートを作成します。


Form Builderでチャート・オブジェクトを手動で作る

  関連項目

フォームにおいてチャートを手動で作る方法:

1	Form Builderのレイアウト・エディタで、ツール・パレット内の「チャート項目」ボタンを選択します。

2	レイアウト上で四角形を選択しドラッグします。作成する四角形のサイズにより、作成されるチャート・オブジェクトのサイズが決まります。

3	「新規チャート・オブジェクト」ダイアログで、「新規チャートを手動で作る」を選択し、「OK」ボタンを選択します。


フォームへの既存図表の埋込み

  関連項目

フォームへ既存図表を埋め込む方法:

1	チャート・オブジェクトを手動で作成します。

2	フォーム・モジュールにOG.PLLライブラリを連結します。

3	既存図表をロードするため、OG.PLLライブラリのOG.OPENプロシージャを使用するフォーム・トリガーを1つ以上作成します。

4	（オプション）必要に応じ、図表を自動化するために、OG.PLLビルトインをを使用します。


フォームへのPL/SQLを使用した図表の統合について

  関連項目

フォームへ図表を統合するには、OG.PLLライブラリに入っているパッケージ・プロシージャOG.OPENを使用してください。

OG.OPENプロシージャをトリガーに組み込むことで、図表をロードすることができます。たとえば、When-New-Form-Instanceトリガーに組み込んで、フォームのロードと同時に図表をロードしたり、When-Button-Pressedトリガーに組み込んで、ユーザーが適切なボタンを選択する際に図表をロードするという設定が可能になります。OG.OPENを含むトリガーが起動する際に、図表がアクティブでないブロックに入っている場合、ブロックはフォーカスを取得しませんが、図表はすぐにロードされて表示されます。

Form Builderが適切なGraphics Builder実行可能プログラムを起動し図表をロードすると、図表は明示的にクローズされるまでメモリーに常駐します。Graphics Builderは、オープンされた図表を再ロードしません。チャート・オブジェクトを変更したため変更をテストする場合は、まずトリガー内でOG.CLOSEビルトインをコールし図表をクローズする必要があります。(OG.CLOSEはOG.PLLライブラリに入っています。)

Graphics Builderを終了するには、Post-BlockトリガーやPost-Formトリガーのような他のトリガー内でOG_QUITビルトイン・プロシージャを使用してください。OG_QUITは、OG.OPENおよびOG.CLOSEとは異なりForm Builderに組み込まれているOG.PLLライブラリの一部ではありません。OG_QUITは、Graphics Builderビルトイン・サブプログラムであり、解析のためにGraphics Builderに渡す必要があります。このため、OG.PLLにはOG.INTERPRETが含まれています。有効なPL/SQL文字列をGraphics Builderに渡して実行するには、OG.INTERPRETを使用してください。


OG.PLLライブラリについて

フォームとチャート間の統合のレベルは、Graphics BuilderとForm Builder間に確立される通信レベルにより異なります。Form BuilderをGraphics Builderと"対話"させるには、OG.PLLライブラリを使用してください。

フォーム・プロシージャに、このライブラリを連結してください。このライブラリは、図表との通信に使用できるいくつかのプロシージャおよびファンクションを含むパッケージから構成されています。

通常、Form BuilderとGraphics Builder間で通信を行うには、1つ以上のフォーム・トリガーに1つ以上のOG.PLLプロシージャおよびOG.PLLファンクションを組み込み、フォーム内で起きるアクションが埋込み図表に対し情報とコマンドを送ることができるようにします。


図表のアクティブ化について

図表はユーザー・アクションを区別するように設定できます。最も簡単な方法は、OG.PLLライブラリが提供しているOG.MOUSEDOWNとOG.MOUSEUPパッケージ・サブプログラムを使用して図表にマウス・イベントを知らせることです。

トリガーが作成されているアクションをユーザーが実行する際、トリガーはGraphics Builderに対し直接情報を渡します。Graphics Builderは、そのマウス・イベントがGraphics Runtimeで発生する場合とまったく同じように応答します。

このトリガーは、マウス・イベントに連結させる必要はありません。ユーザーがボタンを押すことでドリルダウン図表を表示するようにする場合は、Form Builderレイアウトでそのボタンを作成し適切なプロシージャを含むWhen-Button-Pressedトリガーを連結してください。

OG.MOUSEUPおよびOG.MOUSEDOWNは、双方ともフォームから図表に送られる情報を完全に制御します。たとえば、ユーザーがフォーム内でマウスを使用するかわりにボタンを押すようにする場合でも、必要な情報（座標、シングルまたはダブルクリック、ボタン1またはボタン2など）をすべて図表に渡すことができ、Graphics Builderはその情報を実際のマウス・イベントのように扱います。

マウス・アクションを示すすべての引数のデフォルトは、マウスが送る実際の情報です。


図表へのPL/SQLの送信について

Form BuilderアプリケーションにGraphics Builder図表を組み込む場合、OG.INTERPRETプロシージャを使用し図表に特定のPL/SQLコードを実行するように指示できます。このPL/SQLは、Graphics Builderビルトインでも単純な1行のコマンドに対するユーザー定義のファンクションやプロシージャでもかまいませんが、文字列として送る必要があります。この文字列はすべて引用符で囲み、必要に応じその後にセミコロンを付けてください。

OG.INTERPRETを使用し、Graphics Builderプログラム単位をフォームから実行できます。これにより、チャートのベースになっているデータを変更するのみでなく、PL/SQLプログラム単位を図表内で使用してチャートの棒の色の変更やオブジェクトの移動といった動的な操作を行うことができます。


フォームと図表間のデータの交換について

  関連項目

埋込み図表へマウス・アクションやPL/SQLを送る他に、フォームから図表へ、または図表からフォームへ情報を渡すこともできます。OG.PLLライブラリに入ったファンクションOG.GETCHARPARAMを使用してください。OG.PLLは、値が数値であるパラメータに対しOG.GETNUMPARAMも提供しています。

データを渡すには、次の2種類のパラメータを使用できます。

•	テキスト・パラメータ

•	データ・パラメータ

データが渡されると、図表は更新中にその情報を使用できます。


テキスト・パラメータについて

テキスト・パラメータには、変数や定数からの値が入っています。これらは、事前定義されたシステム・パラメータ、ユーザー定義のパラメータ、バインド変数または字句変数を参照します。それぞれのテキスト・パラメータは、キーまたは名前、および値を持ちます。

事前定義されたシステム・パラメータは、一定の名前またはキーをもち、通常ツールをコールするコマンド・ラインで指定されます。たとえば、PRINTはパラメータ・キーであり、'yes'は選択可能な値の1つです。またUSERIDはキーであり、'scott/tiger@t:london-payroll'は有効な値の1つです。

ユーザー定義のパラメータは、通常アプリケーションの設計段階で定義され、モジュールに対する動作をより柔軟に制御することができます。フォームでのパラメータの作成の詳細は、Form Builderのマニュアルを参照してください。

コンポーネント間で渡されるユーザー定義のパラメータは、初めにCHAR型に変換されます。しかし、起動されるコンポーネントは、その値を黙示的に適切なデータ型に変換するか、あるいは（TO_DATE、TO_NUMBERなどのPL/SQL変換関数を使用し）それらを別のデータ型の値として扱うができます。

変換ファンクションによるデータ型の変換の詳細は、『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください。


データ・パラメータについて

データ・パラメータは、Form BuilderからGraphics Builderへ表形式で渡すことができるレコード・グループです。この操作は、次のような場合に行うと便利です。

•	図表がフォーム内でユーザー・アクションに基づいた問合せを動的に構築し実行して、Graphics Builderにそのユーザー・アクションの結果を渡すことができる場合。

•	Form Builderがすでに取り出したデータを図表が使用して、コンポーネントでそのデータを再利用できる場合。

•	フォームがコミットされていないレコード・グループを作成して、それらを表示する場合。

テキスト・パラメータと同様に、それぞれのデータ・パラメータはキーと値を持ちます。データ・パラメータの値は、図表に渡されるForm Builderの問合せの名前を示します。データ・パラメータのキーは、起動されるコンポーネント内で等しいと見なされる問合せ名を示します。

Form BuilderからGraphics Builderにデータを渡す場合、必ず初めにForm Builderでその問合せを実行してください。


パラメータ・リストの作成と挿入について

  関連項目

Form Builderは、パラメータ・リストを使用して情報を図表に渡します。パラメータ・リストは、一連のパラメータ・キーと値のペアです。（単一のパラメータでもパラメータ・リストに割り当てる必要があります。）渡すそれぞれの情報は、パラメータとして定義し、その後パラメータ・リストに追加する必要があります。作成するパラメータのタイプは、渡す情報により異なります。パラメータ・リストは、常に文字列リテラルとして渡されます。

Form Builderには、次に示すようなパラメータ・リストとパラメータ・リストに入るパラメータの作成と操作を行うためのいくつかのビルトイン・ファンクションとプロシージャが含まれています。

•	CREATE_PARAMETER_LIST （ファンクション）

•	GET_PARAMETER_LIST （ファンクション）

•	DESTROY_PARAMETER_LIST （ファンクション）

•	ADD_PARAMETER （プロシージャ）

•	SET_PARAMETER_ATTR （プロシージャ）

•	GET_PARAMETER_ATTR （プロシージャ）

•	DELETE_PARAMETER （プロシージャ）

Graphics Builderでは、これらのファンクションとプロシージャはTOOL_INTパッケージの一部です。これらを使用する場合、TOOL_INT.GET_PARAMETER_LISTのように、名前の前にTOOL_INTを付けてください。


フォームからのGraphics Builderの起動について

パラメータ・リストの作成と挿入を行った後、Graphics Builderを起動し、OG.PLLに含まれる次のプロシージャのどれか1つを使用してそのパラメータ・リストをGraphics Builderに送ってください。

•	OG.OPEN

•	OG.INTERPRET

•	OG.MOUSEDOWN

•	OG.MOUSEUP

•	OG.REFRESH


Graphics Builderによるフォームで使用する図表の作成

  関連項目

フォームで使用するGraphics Builder図表の作成方法:

  通常行うようにGraphics Builder図表を作成します。

フォームで使用するドリルダウンGraphics Builder図表の作成方法:

  通常行うようにドリルダウン図表を作成します。


チャート領域の描画

チャート領域の描画方法:

  Form Builderツール・パレットから「チャート項目」ボタンを選択し、フォーム・レイアウト内で領域を作成します。プロパティ・パレットでチャート領域の名前を変更するか、デフォルト名をそのまま使用します。


図表のオープンとクローズを行うトリガーの作成

  例

図表のオープンとクローズを行うトリガーの作成方法:

1	OG.PLLライブラリをフォームに連結します。このライブラリには、Form BuilderとGraphics Builder間の通信に使用するサブパッケージから構成されるOGパッケージが入っています。

Form Builderでのライブラリの連結の詳細は、Form Builderのマニュアルを参照してください。

2	Graphics Builder図表をロードするため、OG.OPENプロシージャを使用するトリガーを作成します。

3	必要に応じ、図表をクローズするために、OG.CLOSEプロシージャを使用するトリガーを作成します。Graphics Builderに終了コマンドを送る場合は、OG.INTERPRETを使用してください。

Form Builderでのトリガーの作成の詳細は、Form Builderのマニュアルを参照してください。


例: 図表のオープンとクローズ

例: OG.OPEN

次のWhen-New-Form-Instanceトリガーは、図表inv_disp.ogdをチャート領域'CHART_AREA1'にオープンし、Form Builderレイアウトで割り当てられた領域に合うように図表を拡大/縮小し、図表を自動的にリフレッシュします（REFRESH=TRUEがデフォルト）。渡されるパラメータ・リストはありません。

OG.OPEN('inv_disp.ogd', 'CHART_AREA1', clip=FALSE);

例: OG.CLOSE

次のPost-Formトリガーは、チャート領域'CHART_AREA1'の図表inv_disp.ogdをクローズします。このトリガーは、2つのパラメータ、display_nameとchart_item_nameのみを使用しています。

OG.CLOSE('inv_disp.ogd', 'CHART_AREA1');

この例でも、Post-Formトリガーを使用する必要はありません。クローズするときにクローズする位置でその図表のクローズに最適なトリガーを選択します。

例: OG.INTERPRET

次のPost-Formトリガーは、Graphics Builderを終了するためにGraphics BuilderビルトインOG_QUITを使用しています。

OG.INTERPRET('inv_disp.ogd', 'CHART_AREA1', 'og_quit;');

セミコロンが"og_quit"のすぐ後に続いていることに注意してください。PL/SQLをOG.INTERPRETを介して渡す場合、後続するセミコロンを含める必要があります。この例でも、Post-Formトリガーを使用する必要はありません。終了する時点で、Graphics Builderの終了に最適なトリガーを選択します。


マウス・イベントを渡すトリガーの作成

  例

マウス・イベントを渡すトリガーの作成方法:

  Form Builderで、OG.PLLライブラリからOG.MOUSEDOWNまたはOG.MOUSEUPパッケージ・サブプログラムのいずれかを組み込んだトリガーを作成します。


例: マウス・イベントを渡すトリガーの作成

例: OG.MOUSEDOWN

次のWhen-Mouse-Clickトリガーは、図表inv_disp.ogdをアクティブ化します。

OG.MOUSEDOWN('inv_disp.ogd', 'CHART_AREA1');

前述の例のプロシージャは、2つの引数、display_nameとchart_area_name.のみを使用しています。双方のプロシージャとも、マウスによる選択のxおよびy座標、選択されたマウス・ボタン、選択された回数、パラメータ・リストなど、その他のいくつかの引数を使用します。


PL/SQLを渡すトリガーの作成

  例

PL/SQLを渡すトリガーの作成方法:

  Form BuilderからGraphics Builderプログラム単位を起動するためにOG.INTERPRETパッケージ・サブプログラムを使用する場合、プログラム単位と必要な引数を文字列として渡す必要があります。つまり、実行するプログラム単位は引用符で囲む必要があります。


例: PL/SQLを渡すトリガーの作成

例: プロシージャを起動するOG.INTERPRETの使用

When-Button-Pressedトリガーに組み込まれた次の例は、'set_timers'プロシージャを起動します。

OG.INTERPRET('inv_disp.ogd', 'CHART_AREA1',
'set_timers;');

セミコロンが後に続いていることに注意してください。

例2: 文字列を作成するOG.INTERPRETの使用

Graphics Builder内で起動するプログラム単位の引数にフォーム内の項目値を渡す場合、連結演算子を使用して必要な文字列を作成してください。次の単純な例は、フォーム内のテキスト・フィールドの1つから提供される引数によりプログラム単位"set_param"を実行するようにGraphics Builderに指示しています。

OG.INTERPRET ('inv_disp.ogd', 'CHART_AREA1', 'set_param('|| TO_CHAR(:BLOCK1.category_cbox) || ');');

例3: 文字列を作成するOG.INTERPRETの使用 - 詳細なケース

次に、連結演算子を使用し文字列を作成する、やや詳細な例を示します。

OG.INTERPRET('inv_disp.ogd', 'CHART_AREA1',
'set_timer(' ||
 TO_NUM(:BLOCK2.values_plist) ||
 ','  ||
 TO_NUM(:BLOCK3.more_cbox) ||
 ');');

次に、前述のサブプログラムのコールを（それぞれが連結演算子で分離された）個別の部分に分けて示します。

'set_timer('	Contains the procedure name and opening parentheses, enclosed	in single quotes.

TO_NUM(:BLOCK2.	Contains the parameter from Form Builder, converted to the NUMBER

values_plist)	datatype.This is an argument required by the set_timer	procedure.

','	Contains the comma that separates the two supplied arguments.

TO_NUM(:BLOCK3.	Contains the parameter from Form Builder, converted to the NUMBER

more_cbox)	datatype.This is the second argument to the set_timer	procedure.

');'	Contains the procedure's closing parentheses and semicolon,	enclosed in single quotes.

結果として、Graphics Builderは次の文字列を得ます。

set_timer(x,y);

ここで、引数xおよびyは、フォームから送られNUMBER型に変換された数値です。


データを渡すトリガーの作成

  例

データを渡すトリガーの作成方法:

  フォームと図表間でデータを受け渡しする場合、フォームはパラメータ値を図表から抽出することも、テキストとデータ・パラメータを図表に渡すこともできます。しかし、フォームは1つの問合せに対し1つのパラメータ値しか抽出できず、渡すことができるのはパラメータ・リストのみです。


例: データを渡すトリガーの作成

例1: パラメータ値の取得

When-Button-Pressedトリガーで次のファンクションを指定すると、Graphics Builder図表のパラメータparam1の値を取り出し、その値をフォーム内のテキスト・フィールド'TEXT_ITEM1'に割り当てます。

:BLOCK1.TEXT_ITEM1 := OG.GETCHARPARAM

('inv_disp.ogd', 'CHART_AREA1', 'param1');

例2: パラメータの受渡し

次に、sal_chart図表の構築に使用するGraphics Builderに部署番号を渡すために使用する例として、ブロックレベルのPost-Queryトリガーのテキストを示します。

PROCEDURE pass_param IS
pl   ParamList  /*Parameter list datatype*/
BEGIN

/*Create the parameter list, named "my param list".*/
pl := Create_Parameter_List('my_param_list');

/*Add a text parameter to the list to supply a value for

**the 'dept_num' parameter that Graphics Builder is expecting*/
Add_Parameter(pl, 'dept_num', TEXT_PARAMETER,
TO_CHAR(:dept.deptno));

/*Call Graphics Builder to populate the chart item*/
OG.REFRESH('sal_chart', 'dept.chart_item', pl);

/*Destroy the parameter list*/
Destroy_Parameter_List(pl);

END

例3: レコード・グループの受渡し

次に、Graphics Builderにデータを渡すために使用する、ブロックレベルのPost-Queryトリガーのテキストを示します。この例で、Form Builderは問合せを発行し、結果のデータをレコード・グループに格納しています。データを使用してsal_chart図表を構築するGraphics Builderにレコード・グループを渡すために、データ・パラメータが使用されています。

Procedure pass_data is
pl_id  PARAMLIST;
rg_id  RECORDGROUP := Find_Group('chart_data');
qry    VARCHAR(2000);
stat   NUMBER;

BEGIN
/*Prepare a query in a string based on the last
**WHERE clause issued.*/
qry := 'SELECT ename, sal FROM emp '||
   substr(:system.last_query,instr(:system.last_query,
'WHERE'))||' order by empno';

/*Check to see if the record group already exists;
**if not, create it.*/
IF Id_Null(rg_id) THEN
rg_id := CREATE_GROUP_FROM_QUERY('chart_data', qry);
END IF;

/*As the record group may have already existed with old
**data, clear it out and repopulate it based on the new
**query*/
DELETE_GROUP_ROW(rg_id, all_rows);
stat := POPULATE_GROUP_WITH_QUERY(rg_id, qry);

/*Now create a parameter list*/
pl_id := CREATE_PARAMETER_LIST('pl_chart_data');

/*Add a data parameter with the same name asthe query in
**the display*/
Add_Parameter(pl_id,'query0',DATA_PARAMETER,'chart_data');

/*Refresh an already-opened display with the new data*/
OG.REFRESH('sal_chart','dept.chart_item',pl_id);

*/Destroy the parameter list*/
DESTROY_PARAMETER_LIST

END


パラメータ・リストの作成と挿入

  関連項目

パラメータ・リストの作成方法:

1	どのような情報を渡すか決定します。

2	ツールに適したビルトインを使用してパラメータ・リストを作成します。

3	リストに項目を追加します。このプロシージャは、次の引数を必要とします。

   パラメータ・リストの名前

  追加するパラメータの名前

  追加するパラメータのタイプ（テキストまたはデータ）

  追加するパラメータの値

コマンド・ラインまたは実行可能なオプションを渡す場合には、必ずコマンド・ライン・オプション・キーワードをパラメータ名として指定してください。有効な実行可能オプションの一覧は、起動するコンポーネントのマニュアルを参照してください。


フォームの実行

フォームの実行方法:

  作成したすべてのトリガーが正しくコンパイルされることを確認し、「プログラム」 [image] 「フォーム実行」を選択します。


レポートへの図表の埋込みについて

  関連項目

レポートに図表を埋め込む方法は2つあります。次の方法で図表を作成できます。

•	Report Builder（Reports Developerに組み込まれています）のチャート・ウィザードを利用

•	手動

レポートで新規チャートを作成するには、Report Builderのチャート・ウィザード（Reports Developerに組み込まれています）を使用してください。チャート・ウィザードを使用すると、手順を1つずつ追って単純なチャートを作成できます。

レポートに既存の図表または複雑な図表を埋め込むには、レポート・レイアウトでチャート・オブジェクトを作成し、チャート・オブジェクトのプロパティ・パレットを使用して図表のプロパティを設定してください。

データベースからではなく、図表が埋め込まれているレポートから直接データを受信するように図表を設定できます。この機能により、レポートのフィルタリングされたデータまたは集計データを反映した図表を埋め込むことができます。


クイック・ツアーを呼び出すキャプションを入力する

複雑な図表とは、対話形式の図表、複数の問合せを含む図表、あるいはオブジェクトおよびチャートを含む図表を意味します。


チャート・ウィザードを使用して、レポートに新規チャートを作成する

  関連項目

レポート内からチャートを作成するためのチャート・ウィザードの使用方法:

1	Report Builderのライブ・プレビューア表示またはレイアウト・モデル表示（Reports Developerに組み込まれています）で、「ツール」 [image] 「チャート・ウィザード」を選択するか、ツールバーの「チャート・ウィザード」ボタンを選択します。

2	ウィザードに従いチャートを作成します。


レポートへの既存図表の埋込み

  関連項目

レポートへ既存図表を埋め込む方法:

1	Report Builderのレイアウト・モデル表示（Reports Developerに組み込まれています）で、ツール・パレットの「チャート」ボタンを選択します。

2	チャート・オブジェクトを作成するため四角形を選択しドラッグします。作成する四角形のサイズにより、作成されるチャート・オブジェクトのサイズが決まります。

3	プロパティ・パレットを表示するため、新しいチャート・オブジェクトをダブルクリックします。

4	「チャート」ノードで、図表が入ったファイルの名前に対する「チャート・ファイル名」プロパティを設定します。

5	レポートから図表にパラメータを渡す場合は、チャート・オブジェクトのパラメータに対しレポート列またはパラメータをマップします。

6	図表が複数の問合せを使用しているか、データ値をレポートから図表へ直接渡す場合、レポートに対しチャート・オブジェクトの列プロパティをマップします。


レポートから埋込み図表へのパラメータの受渡し

  関連項目

レポートから図表へパラメータを渡す方法:

1	埋め込まれたチャート・オブジェクトをダブルクリックし、「プロパティ・パレット」を表示します。

2	「プロパティ・パレット」で、「パラメータ」プロパティ・ページと「列」プロパティ・ページを表示するため、「チャート」ノードの下で「パラメータおよび列」プロパティに表示されるボタンを選択します。

3	「パラメータ」タブを選択します。

4	「レポート列」リストで、レポート列、または図表内のパラメータに一致するパラメータを選択します。レポート列またはパラメータの選択は、図表内に対応するパラメータが存在し、パラメータがその値を選択されたレポート列の正しいインスタンスから取得することを意味します。

5	「チャート・パラメータ」フィールドで、レポート列またはパラメータがマップを行うチャート・パラメータの名前を入力します。

6	「OK」を選択します。


レポートから埋込み図表へのデータ値の受渡し

  関連項目

レポートから図表へデータ値を渡す方法:

1	埋め込まれたチャート・オブジェクトをダブルクリックし、「プロパティ・パレット」を表示します。

2	「プロパティ・パレット」で、パラメータ・プロパティと列プロパティを表示するため、「チャート」ノードの下で「パラメータおよび列」プロパティに表示されるボタンを選択します。

3	「列」タブを選択します。

4	「チャート問合せ」フィールドで、図表問合せの名前を入力します。図表にフィルタリングしたレポートのデータまたは集計を反映さる場合は、レポートから渡す列またはパラメータに対応するデータ列を返すデータ・ソース（SQLまたはファイル）をもつ問合せを入力してください。

5	「レポート・グループ」フィールドで、ドロップダウン・リストから、「チャート問合せ」フィールドで指定した問合せが使用しているデータとパラメータを含むレポート・グループを選択します。

6	「レポート列」リストで、図表内の列にマップするレポート列を選択して指定します。選択するレポート列は、対応する図表列に対し値を提供します。「チャート列」フィールドで対応する図表列の名前を入力します。

7	「OK」を選択します。


レポートに埋め込まれた図表のハイパーリング先の作成

レポートに埋め込まれた図表に対するハイパーリンク先の追加方法:

1	Report Builderのライブ・プレビューア表示またはレイアウト・モデル表示（Reports Developerに組み込まれています）で、チャート・オブジェクトをダブルクリックし「プロパティ・パレット」を表示します。

2	「Webリンク」ノードの下で、チャート・オブジェクトの識別子に対し「ハイパーリンクの宛先」プロパティを設定します。


OLEコンテナ・アプリケーションで使用するために図表をサイズ設定する

OLEコンテナ・アプリケーションで使用するための図表のサイズ設定方法:

1	図表内のオブジェクトをレイアウト・エディタの左上隅に移動させて十分な空き領域を作り、図表が見やすいようにします。

2	「表示」 [image] 「表示オプション」 [image] 「レイアウト」を選択し、「レイアウト設定」ダイアログを表示します。

3	レイアウトの「水平」および「垂直」サイズを入力します。

4	「OK」を選択してレイアウト・サイズを決定し、ダイアログをクローズします。

レイアウト・サイズは、定義した大きさに制限されます。OLEコンテナ・アプリケーションで指定した領域が図表のサイズに十分なものか確認してください。

OLEコンテナ・アプリケーションにGraphics Builder図表を埋め込む際、図表中の実際のイメージを組み込むことになります。OLEサーバー・アプリケーションはGraphics Builderと同じ図形定義システムを使用しないため、定義された領域に合うようにGraphics Builder図表のイメージを拡大/縮小することはできません。


OLEコンテナへの図表の埋込み

OLEコンテナ・アプリケーションへ図表を埋め込む方法:

1	Graphics Builderで図表を作成します。

2	OLEコンテナ・アプリケーションでチャート領域を描画します。

3	組み込まれる図表に対する適切なプロパティを設定します。

OLEサーバー・オブジェクトの組込み方法の説明は、OLEコンテナ・アプリケーションのマニュアルを参照してください。


イメージとしての図表のエクスポートについて

Graphics Builderオブジェクト（単一またはグループ）は、GIF、JPEG、BMP、TIFF、PICTなど、さまざまなイメージ形式にエクスポートできます。オブジェクトをイメージとしてエクスポートする方法は3つあります。

•	Webページ、Wordドキュメント、プレゼンテーションなどで使用するため図表の静的イメージをエクスポートする場合に、Graphics Builderの「イメージ・エクスポート」メニュー項目を使用します。

•	Webアプリケーションで使用するため対話形式の図表をエクスポートする場合に、OG_EXPORT_IMAGEビルトインを使用します。

•	シェル・スクリプトから図表をバッチ生成している場合に、Graphics Builderのコマンド・ラインを使用します。


「イメージ・エクスポート」メニュー項目を介したイメージのエクスポート

「イメージ・エクスポート」メニュー項目を介したイメージのエクスポート方法:

1	レイアウト・エディタ内で選択するかオブジェクト・ナビゲータから選択して、エクスポートするオブジェクトまたはグループ・オブジェクトを選択します。

2	「ファイル」 [image] 「エクスポート」 [image] 「イメージ」を選択し、「イメージ・エクスポート」ダイアログを表示します。

3	「データベース」または「ファイル」ラジオ・ボタンを選択し、イメージをファイルとデータベースのどちらにエクスポートするかを指定します。ファイルにエクスポートする場合、エクスポート先のファイルのパス名を入力するか、「参照」を選択しファイルを選択します。

4	「フォーマット」ドロップダウン・リストから、エクスポート・ファイルのイメージ形式を選択します。

5	「データ型」ドロップダウン・リストから、イメージのデータ型を選択します。

6	「圧縮」ドロップダウン・リストに、「形式」ドロップダウン・リストで選択されたイメージ形式に対して、Graphics Builderによって圧縮可能な形式が表示されます。Graphics Builderが示すデフォルトの圧縮形式を受け入れるか、ドロップダウン・リストから他の形式を選択します。一部のイメージ形式に対するデフォルトの圧縮形式は「なし」ですが、イメージ以外のオブジェクトまたはオブジェクトのグループをエクスポートする場合はドロップダウン・リストから形式を指定する必要があります。各形式の圧縮の指定の詳細は、『PL/SQLビルトイン・リファレンス』を参照してください。

7	JPEG形式にエクスポートする場合は、「質」ドロップダウン・リストから質の指定を選択します。

8	「OK」を選択します。


PL/SQLを介したイメージのエクスポート

  例

PL/SQLを介したイメージのエクスポート方法:

  OG_EXPORT_IMAGEビルトインを使用します。


例:og_export_image

/* Suppose you want to export a complex display as a GIF
**for publication on a World Wide Web page.The following
**procedure exports the currently open display as the image,
**"test.gif."
*/

PROCEDURE
BEGIN
   og_export_image('c:\test.gif', OG_FILESYSTEM,
OG_GIF_IFORMAT,og_root_object,
OG_LZWHDIFF_ICOMPRESSION);
END


Graphics Builderコマンド・ラインを使用したイメージのエクスポート

  例

Graphics Builderコマンド・ラインを使用したイメージのエクスポート方法:

  GORUN60を使用してイメージとしてエクスポートする図表を実行し、イメージ・エクスポート・パラメータに対する引数にそのイメージ名を指定します。


例: Graphics Builderコマンド・ラインを使用したイメージのエクスポート

/*This example provides a sample export-to-image command
*line argument.It runs the display test.ogd and exports it
*to the image "test.gif."


TOOL_INTパッケージについて

  関連項目

Graphics Builder図表から他のOracleコンポーネントを起動するための準備は、他のコンポーネントから図表を起動する準備によく似ています。しかし、Form BuilderがOG.PLLライブラリで提供しているパッケージ・プロシージャなどを使用するかわりに、ビルトイン・パッケージTOOL_INTを使用します。

このパッケージにより、他のコンポーネントへ情報を渡したり、図表から他のコンポーネントを起動することが可能になります。


同期通信について

Graphics Builderが他のコンポーネントを同期をとって起動する場合、Graphics Builder図表の実行は起動されるコンポーネントが実行を終了するまで中断されます。

他のコンポーネントにデータを渡すには、同期をとってそのコンポーネントを起動する必要があります。

次のような場合に、このような方法で他のコンポーネントを起動すると便利です。

•	継続する前に、ユーザーにForm Builderで値を入力させる必要がある場合。

•	Report Builder（Reports Developerに組み込まれています）に問合せデータを渡し、その問合せデータに基づいてレポートを実行する場合。


非同期通信について

Graphics Builderが他のコンポーネントを同期をとらずに起動する場合、Graphics Builder図表の実行は通常どおりに継続し、他のコンポーネントを起動するPL/SQLプロシージャ・コールに続きます。つまり、Graphics Builderとコールされるコンポーネントの実行は同時に行われます。

他のコンポーネントを同期をとらずに起動する場合、そのコンポーネントにデータを渡すことはできません。

次のような場合に、このような方法で他のコンポーネントを起動すると便利です。

•	プリンタなどの他のデバイスにReport Builderレポートを生成する場合。

•	図表を実行している間、ユーザーがOracle Bookドキュメントを表示できるようにする場合。

Graphics Builderから他のコンポーネントにデータ・パラメータを渡す場合、そのコンポーネントを同期通信モードで起動する必要があります。


実行モードについて

Graphics Builderが他のOracleコンポーネントを起動できる実行モードは次の2つです。

•	ランタイム

•	バッチ

これらの実行モードのそれぞれの動作は、Graphics Builderが起動する各コンポーネントにより異なります。また、一部のOracleコンポーネントは、特定の実行モードをサポートしない場合があります。詳細は、起動するコンポーネントのマニュアルを参照してください。


他のコンポーネントへの情報の受渡し

  例

他のコンポーネントへ情報を渡す方法:

  「フォームと図表間のデータの交換」.で説明されているように、テキストとデータ・パラメータを使用します。


例: Graphics Builderから他のコンポーネントへの情報の受渡し

Graphics Builder図表に次のパラメータによりReport Builder（Reports Developerに組み込まれています）を起動させます。

名前	Value

USERID	scott/tiger
DESTYPE	printer
COPIES	2
my_param	67
さらに、Report BuilderのレポートがGraphics Builderが提供するデータに基づくようにします。レポートで定義された問合せの名前を'Q_1'、Graphics Builder図表で定義された問合せの名前を'query0'と想定します。

次のプロシージャは、'my_plist'というパラメータ・リストを作成し、前述のパラメータをそのリストに追加します。

PROCEDURE create_plist IS
   the_list   tool_int.paramlist;

BEGIN
   the_list:=TOOL_INT.CREATE_PARAMETER_LIST('my_plist');
   TOOL_INT.ADD_PARAMETER(the_list, 'userid',
         TOOL_INT.TEXT_PARAMETER, 'scott/tiger');
   TOOL_INT.ADD_PARAMETER(the_list, 'destype',
         TOOL_INT.TEXT_PARAMETER, 'printer');
   TOOL_INT.ADD_PARAMETER(the_list, 'copies',
         TOOL_INT.TEXT_PARAMETER, '2');
   TOOL_INT.ADD_PARAMETER(the_list, 'my_param',
         TOOL_INT.TEXT_PARAMETER, '67');
   TOOL_INT.ADD_PARAMETER(the_list, 'Q_1',
         TOOL_INT.DATA_PARAMETER, 'query0');
END;


# > $ A K 例: 同じログイン・セッションの使用
同じログイン・セッションの使用

  例

同じログイン・セッションを使用する方法:

  Graphics Builderに指定したログイン情報を他のコンポーネントに対しパラメータ形式で渡します。その後、Graphics Builderから他のコンポーネントを起動する際に、起動するコンポーネントとログイン・セッションを実際に共有できます。これは、「接続」ダイアログ・ボックスを使用せずに起動するためにも便利です。

Form Builder、Report Builder（Reports Developerに組み込まれています）およびOracle Bookは、データベース接続を確立するためUSERID実行可能オプションも使用します。Graphics Builderは、アプリケーションに対しそのログイン情報をプロパティ形式で格納します。プロパティ・ビルトイン・ファンクションOG_GET_ATTRを使用してこの情報を取り出し、続いて情報をパラメータ・リストにテキスト・パラメータとして含めることができます。


例: # > $ A K 例: 同じログイン・セッションの使用
例: 同じログイン・セッションの使用

次のプロシージャの例は、Graphics BuilderからReport Builder（Reports Developerに組み込まれています）にリモート・データベース接続の文字列を渡す方法を示しています。

PROCEDURE run_form IS
  rept_list  tool_int.paramlist;
  uname      VARCHAR2;
  pword      VARCHAR2;
  cnxn       VARCHAR2;
BEGIN
/*create the parameter list*/
  rept_list:=TOOL_INT.CREATE_PARAMETER_LIST('list1');

/*find OG login information*/
  uname:=OG_GET_AP_USERNAME;
  pword:=OG_GET_AP_PASSWORD;
  cnxn:=OG_GET_AP_CONNECTION;

/*add OG login info to parameter list*/
  TOOL_INT.ADD_PARAMETER (form_list, 'userid',
TOOL_INT.TEXT_PARAMETER, uname || '/' ||
pword || '@' || cnxn);
/*pass Report Builder the parameter list with login info*/
  TOOL_INT.RUN_PRODUCT(TOOL_INT.REPORTS, 'inventory.rpt',
TOOL_INT.ASYNCHRONOUS, TOOL_INT.RUNTIME, rept_list)
END;


Graphics Builderから他のコンポーネントを起動する

コンポーネントを起動する方法:

  TOOL_INT.RUN_PRODUCTプロシージャを使用します。このプロシージャは、次の引数を必要とします。

•	起動するコンポーネントの名前

•	コンポーネントのフォーム、レポートまたはドキュメント

•	コンポーネントを起動する通信モード

•	使用するコンポーネントの実行モード

•	コンポーネントに渡すパラメータ・リストの名前


Graphics BuilderからForm Builderを起動する

  例

Graphics BuilderからForm Builderを起動する方法:

  Graphics BuilderからForm Builderを起動して、図表の問合せデータを含むフォームを表示することができます。1つのコンポーネントから他のコンポーネントにデータを渡す場合、そのコンポーネントを同期モードで起動する必要があることに注意してください。


例: Graphics BuilderからForm Builderを起動する

次のプロシージャは、Form Runtimeアプリケーションを起動し、このアプリケーションに図表の問合せデータを提供します。

PROCEDURE open_form (the_form IN VARCHAR2) IS
  form_list  tool_int.paramlist;
  uname      VARCHAR2;
  pword      VARCHAR2;
  cnxn       VARCHAR2;
BEGIN
/*create the parameter list*/
  form_list:=TOOL_INT.CREATE_PARAMETER_LIST('list2');
  uname:=OG_GET_AP_USERNAME;
  pword:=OG_GET_AP_PASSWORD;
  cnxn:=OG_GET_AP_CONNECTION;

/*Add a parameter to the parameter list*/
  TOOL_INT.ADD_PARAMETER (form_list, 'userid',
TOOL_INT.TEXT_PARAMETER, uname || '/' ||
pword || '@' || cnxn);

/*pass Form Builder the parameter list*/
  TOOL_INT.RUN_PRODUCT(TOOL_INT.FORMS, 'the_form',
TOOL_INT.ASYNCHRONOUS, TOOL_INT.RUNTIME, form_list);
END;


Graphics BuilderからReport Builderを起動する

  例

Graphics BuilderからReport Builder（Reports Developerに組み込まれています）を起動する方法

  Report Builderを起動するトリガーをバッチ・モードで定義し、事前定義されたレポートを表示します。Report Builderランタイムを起動してレポートを表示することもできます。


例: Graphics BuilderからReport Builderを起動する

次の例は、Report Builder（Reports Developerに組み込まれています）へ渡すパラメータ・リストを作成し、続いてinventory.repレポートを実行するReport Builderをコールするプロシージャを示しています。このプロシージャは、Report Builderの「接続」ダイアログ・ボックスを使用せずに起動するための、USERID実行可能引数のテキスト・パラメータも含んでいます。

PROCEDURE print_inv_rep IS
  rep_list  tool_int.paramlist;
BEGIN
/*create a parameter list*/
  rep_list:=TOOL_INT.CREATE_PARAMETER_LIST('list2');

/*add the USERID executable option to the list*/
  TOOL_INT.ADD_PARAMETER (rep_list, 'userid',
TOOL_INT.TEXT_PARAMETER, 'scott/tiger');

/*add the query data parameter to the list*/
  TOOL_INT.ADD_PARAMETER (rep_list, 'Q_inv',
TOOL_INT.DATA_PARAMETER, 'query_inv');

/*call Report Builder batch mode to print the report*/
  TOOL_INT.RUN_PRODUCT(TOOL_INT.REPORTS, 'inventory.rep',
TOOL_INT.SYNCHRONOUS, TOOL_INT.BATCH,
TOOL_INT.FILESYSTEM, rep_list);
END;

Graphics Builder図表の実行は、Report Builderがレポートの表示を終了するまで中断されます。

Report Builder実行可能オプションの詳細は、Report Builderのマニュアルを参照してください。


Graphics BuilderからOracle Bookを起動する

  例

Graphics BuilderからOracle Bookを起動する方法:

  Oracle Bookランタイムのインスタンスを起動するプロシージャを図表上のボタンと関連付けることができます。Oracle Bookドキュメントにハイパーテキスト・ターゲットが含まれる場合、TARGET実行可能引数を使用し特定のターゲット位置でドキュメントをオープンするように指定できます。


例: Graphics BuilderからOracle Bookを起動する

次のボタン・プロシージャは、help.obdというOracle Bookドキュメントをターゲット名"start"でオープンします。

PROCEDURE OGBUTTONPROC0(buttonobj IN og_object, hitobj
 IN og_object, win IN og_window, eventinfo IN og_event)IS
  book_list  tool_int.paramlist;
BEGIN
/*create a parameter list*/
  book_list:=TOOL_INT.CREATE_PARAMETER_LIST('list1');

/*add the target executable option to the list*/
  TOOL_INT.ADD_PARAMETER (book_list, 'target',
TOOL_INT.TEXT_PARAMETER, 'start');

/*open Oracle Book at the target name specified above*/
  TOOL_INT.RUN_PRODUCT(TOOL_INT.BOOK, 'help.obd',
TOOL_INT.ASYNCHRONOUS, TOOL_INT.RUNTIME,
TOOL_INT.FILESYSTEM, book_list);
END;

Oracle Bookランタイムを起動する際にOracle Bookランタイムに渡すことができる他の実行可能引数については、Oracle Bookのドキュメントを参照してください。


ファイル・システムへの図表の保存

ファイル・システムに図表を保存する方法は次のとおりです。

1	「ファイル」 [image] 「別名保存」 [image] 「ファイル・システム」を選択して、使用中のシステムの「ファイル」ダイアログを表示します。

2	図表に一意のファイル名を指定します。

Graphics Builderによるデフォルト・ファイル名をそのまま使用しても、一意の名前に置換してもかまいません。

3	ダイアログ・ボックスを確定して図表を保存します。

レイアウト・エディタの内容とその図表の他のウィンドウの内容がそのままの状態で保存されます。


データベースへの図表の保存

データベースに図表を保存する方法:

1	「ファイル」 [image] 「別名保存」 [image] 「データベース」を選択して、「データベースへの保存」ダイアログ・ボックスを表示します。

2	図表に一意の名前を「名前」フィールドに入力します。

3	「保存」ボタンを選択して図表を保存します。

レイアウト・エディタの内容とその図表の他のウィンドウの内容がそのままの状態で保存されます。

必ずデータベースに接続し、そのデータベースへのアクセス権限を確保して、図表を保存できるようにしてください。また、データベースには、必ずGraphics Builder表がセットアップされている必要があります。詳細は、データベース管理者に問い合せてください。


図表への変更の破棄

図表への変更を破棄する方法:

  「ファイル」 [image] 「変更の破棄」を選択して、最後に行った変更を破棄します。

図表は、その前に保存した形に復元されます。


ファイル・システム内の図表の改名

ファイル・システム内の図表を改名する方法:

  ファイルとして格納されている図表を改名する場合は、使用中のオペレーティング・システムを実行します。ファイルを改名するには、適切なファイル権限を持っている必要があります。

ファイルの正しい改名方法については、使用しているオペレーティング・システムのマニュアルを参照してください。


データベース内の図表の改名

データベースに格納されている図表を改名する方法:

1	「ファイル」 [image] 「管理」 [image] 「改名」 [image] 「図表」を選択して、「改名」ダイアログ・ボックスを表示します。

2	その図表の古い名前と新しい名前を指定します。

3	「改名」ボタンを選択して新しい名前を適用します。

データベースに格納されている図表を改名できるのは、その図表を作成したユーザーまたはその図表へのアクセス権限が付与されたユーザーのみです。


エクスポート済みのチャート・テンプレートの改名、削除およびアクセス権限の付与について

エクスポート済みのチャート・テンプレートの改名、削除およびアクセス権限を付与する方法:

  エクスポート済みのテンプレートの改名、削除およびアクセス権限を付与する手順は、図表の場合と同じです。


ファイル・システム内の図表へのアクセス権限の付与と取消し

ファイル・システム内の図表へのアクセス権限を付与する方法と取り消す方法:

  オペレーティング・システムによっては、個々のファイルに対する読込み、書込みおよび実行権限のユーザーによる付与が許可されている場合があります。使用しているオペレーティング・システムでファイル権限を設定する方法の詳細は、そのオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に問い合せてください。


データベース内の図表へのアクセス権限の付与と取消し

データベースに格納されている図表へのアクセス権限を付与する方法と取り消す方法:

1	「ファイル」 [image] 「管理」 [image] 「アクセス」 [image] 「図表」を選択して、「データベース上モジュールへのアクセス」ダイアログ・ボックスを表示します。

このダイアログには、アクセス可能なデータベースに格納されている図表がすべてリストされています。

2	リストから図表を1つ選択します。

3	「OK」ボタンを選択して、「モジュール・アクセス」ダイアログを表示します。

このダイアログには、その図表へのアクセス権限のあるユーザーがすべてリストされています。

4	アクセス権限を付与するユーザーのデータベース・ユーザーIDを「ユーザー」フィールドに入力します。

5	「追加」ボタンを選択して、その名前を「アクセス」リストに追加します。

6	アクセス権限を取り消すユーザーの名前を「アクセス」リストから選択します。

7	「削除(R)」を選択してアクセス・リストからユーザー名を削除します。

8	「OK」を選択して変更内容を確定し、「モジュール・アクセス」ダイアログをクローズします。

選択した図表へのアクセス権限が更新されます。

図表を作成してデータベースに格納したら、その図表へのアクセス権限を他のユーザーに付与できます。ただし、対象ユーザーもGraphics Builderデータベースの表に対するアクセス権を持っている必要があります。詳細は、データベース管理者に問い合せてください。


外部サウンドの管理

外部サウンドを管理する方法:

  ファイル・システムまたはデータベース内のサウンドへのアクセス権限を付与する手順および取り消す手順と、ファイル・システムまたはデータベース内のサウンドを改名する手順および削除する手順は、図表の場合と同じです。

Builder内に作成されたサウンドや図表にインポートされたサウンドは、図表に対して内部的であると考えられます。また、ファイル・システムやデータベースに格納されたサウンドは、図表に対して外部的であると考えられます。サウンドの位置によって、サウンドへのアクセス権限の付与と取消し、サウンドの改名、サウンドの削除に使用する手段が決まります。


アートワークの管理

アートワークを管理する方法:

  アートワークへのアクセス権限を付与する手順および取り消す手順と、アートワークを改名する手順および削除する手順は、図表の場合と同じです。


アートワークのエクスポート

アートワークをエクスポートする方法:

1	イメージをエクスポートする場合は、イメージを選択します。図表全体を1つの描画としてエクスポートすると、Graphics Builderにより、その図表内の参照できるレイヤー上にあるアートワークがすべて自動的に選択されます。

2	「ファイル」 [image] 「エクスポート」を選択してから、エクスポートするアートワークのタイプを選択します。

たとえば、Graphics Builderに描画されたオブジェクトをエクスポートする場合は、「描画」を選択します。「エクスポート」ダイアログが表示されます。

3	希望するオプションを指定します（ファイル名と位置、アートワークをエクスポートするときのファイル形式など）。

4	「OK」ボタンを選択して、情報を確認し「サウンド・エクスポート」ダイアログをクローズします。

アートワークが、指定した位置にエクスポートされます。

図表からイメージをエクスポートしたり、図表内の参照できるレイヤーをすべて1つの描画としてエクスポートできます。アートワークは、ファイル・システムにもデータベースにもエクスポートできます。図表内でグループ化されている各オブジェクトを、1度CGMファイルにエクスポートすると、そのグループ化されたプロパティを維持できなくなります。


PL/SQLによるアートワークのエクスポート

  関連項目

PL/SQLを使用してアートワークをエクスポートする方法:

  OG_EXPORT_DRAWINGビルトイン・プロシージャを使用します。

次の例を使用すると、1つのレイヤーの内容がCGMファイルにエクスポートされます。

PROCEDURE export_the_drawing IS
   the_layer   OG_OBJECT;
BEGIN
   the_layer:=OG_GET_LAYER('layer0');
   OG_EXPORT_DRAWING('my_draw', OG_FILESYSTEM,
     OG_CGM16_DFORMAT, the_layer);
END;


カラー・パレットの管理

カラー・パレットを管理する方法:

  カラー・パレットを改名および削除する手順と、カラー・パレットへのアクセス権限を付与する手順は、図表の場合と同じです。同様に、カラー・パレットをインポートおよびエクスポートする手順は、アートワークの場合と同じです。


オブジェクト・ナビゲータでの図表の削除

オブジェクト・ナビゲータで図表を削除する方法:

1	オブジェクト・ナビゲータで図表オブジェクトを選択します。

2	「削除」ボタンを選択するか、または「ナビゲータ」 [image] 「削除」を選択します。

警告が表示されて、削除を確認するように指示されます。

3	「Yes」を選択して確認します。

選択した図表が削除されます。

オブジェクト・ナビゲータにオープンされている図表であれば、どこに格納されていても削除できます。図表を削除する場合には、必ずその図表への適切なアクセス権限が必要になります。ファイルへの書込み権限またはデータベースへのアクセス権限がないと、図表の削除はできません。


ファイル・システムからの図表の削除

ファイル・システムから図表を削除する方法:

  ファイルとして格納されている図表を削除する場合は、使用しているオペレーティング・システムで実行します。図表を削除する場合には、必ず適切なアクセス権限が必要です。

ファイルを削除する正しい方法については、使用しているオペレーティング・システムのマニュアルを参照してください。


データベースからの図表の削除

データベースに格納されている図表を削除する方法:

1	「ファイル」 [image] 「管理」 [image] 「削除」 [image] 「図表」を選択して、「データベースから削除」ダイアログを表示します。

2	図表の名前を指定します。

3	「OK」ボタンを選択して、データベースから図表を削除します。

データベースに格納されている図表を削除できるのは、その図表を作成したユーザーまたはその図表へのアクセス権限が付与されたユーザーのみです。


チャート・プロパティについて

チャート・プロパティでは、チャートに対応するテンプレートや問合せなどのチャート全体のプロパティを定義します。チャート・プロパティは、「チャート」プロパティ・シートを使用して実行でき、次のような編成になっています。

チャート

データ

項目

値

PL/SQL

通常、チャート・プロパティを定義する場合は、チャートを選択し、そのチャートのプロパティ・シートをオープンし、定義するプロパティを選択します。また、PL/SQLを使用すると、このようなプロパティの多くをプログラム上で定義できます。


チャート名、タイトル、チャート・タイプおよびテンプレートが含まれます。


問合せフィルタ・ファンクションなどの問合せに関連したプロパティやデータの表示範囲が含まれます。


チャート内に表示するチャート項目とサブ項目が含まれます。項目（独立）データは、一定の間隔で表示されます。項目データは、数学的な関連がなく、通常「項目」軸と呼ばれる軸に沿って表示されます。


チャートの値とそれに対応するフィールド・テンプレートが含まれます。値（従属）データは、通常ある値を起点として別の値に達するまで連続します。値データは、数学的な関連があり、通常「値」軸と呼ばれる軸に沿って表示されます。


チャート用のマウス・イベントとそれに対応するプロシージャが含まれます。


レイアウト・エディタによるチャート・プロパティへのアクセスとチャート・プロパティの変更

レイアウト・エディタを使用してチャート・プロパティにアクセスする方法:

  レイアウト・エディタ内のチャートをダブルクリックするか、または

  レイアウト・エディタ内でチャートを選択しておいて、ポップアップ・メニューから「プロパティ」コマンドを選択します。

チャートに対応付ける各種の問合せやテンプレートが指定でき、またチャート全体の他のプロパティも指定できます。たとえば、チャートに名前を付けてプログラムでその名前を参照する場合があります。また、チャートをボタン・プロシージャに対応付ける場合もあります。

レイアウト・エディタを使用してチャート・プロパティを変更する方法:

1	チャートをダブルクリックして「チャート」プロパティ・シートを表示します。

2	設定するオプションを指定します。

3	「OK」ボタンを選択して、変更内容を適用し「チャート」プロパティ・シートをクローズするか、または「適用」ボタンを選択して、「チャート」プロパティ・シートをクローズしないまま変更内容をチャートに適用します。


オブジェクト・ナビゲータによるチャート・プロパティへのアクセスとチャート・プロパティの変更

オブジェクト・ナビゲータを使用してチャート・プロパティにアクセスする方法:

  オブジェクト・ナビゲータ内のチャート・オブジェクトをダブルクリックするか、または

  オブジェクト・ナビゲータにチャート・オブジェクトを選択しておいて、ポップアップ・メニューから「プロパティ」コマンドを選択するか、

  オブジェクト・ナビゲータにチャート・オブジェクトを選択しておいて、「ツール」 [image] 「プロパティ」を選択します。

チャートに対応付ける各種の問合せやテンプレートが指定でき、またチャート全体の他のプロパティも指定できます。たとえば、チャートに名前を付けてプログラムでその名前を参照する場合があります。また、チャートをボタン・プロシージャに対応付ける場合もあります。

オブジェクト・ナビゲータを使用してチャート・プロパティを変更する方法:

1	チャートをダブルクリックして「チャート」プロパティ・シートを表示します。

2	設定するオプションを指定します。

3	「OK」ボタンを選択して、変更内容を適用し「チャート」プロパティ・シートをクローズするか、または「適用」ボタンを選択して、「チャート」プロパティ・シートをクローズしないまま変更内容をチャートに適用します。


基本線の値の設定

基本線の値を指定する方法:

1	チャートまたは単一チャート・オブジェクト（チャート・タイトルなど）を選択します。

2	ポップアップ・メニューから「枠」コマンドを選択するか、または 「チャート」 [image] 「枠」を選択して、「枠」プロパティ・シートを表示します。

3	「軸枠」タブを選択して「軸枠」プロパティ・ページを表示します。

4	希望する基本線の値を指定します。

5	「OK」ボタンを選択して変更内容をチャートに適用します。


横棒プロパティと縦棒プロパティの指定

横棒プロパティと縦棒プロパティを指定する方法:

1	チャートまたは単一チャート・オブジェクトを選択します。

2	ポップアップ・メニューから「枠」コマンドを選択するか、または「チャート」 [image] 「枠」を選択して、「枠」プロパティ・シートを表示します。

3	必要な場合は、「枠」タブを選択して「枠」プロパティ・ページを表示します。

4	深さサイズ、シャドウ・サイズまたはシャドウ方向に対するオプションをいずれか1つ選択します。

5	「OK」ボタンを選択して、変更内容を適用し「枠」プロパティ・シートをクローズします。

加えた変更がチャートの「枠」に反映されるか「フィールド・テンプレート」に反映されるかは、選択したチャートのタイプによります。


凡例プロパティの指定

凡例プロパティを指定する方法:

1	チャートまたは単一チャート・オブジェクト（チャート・タイトルなど）を選択します。

2	ポップアップ・メニューから「枠」コマンドを選択するか、または「チャート」 [image] 「枠」を選択して、「枠」プロパティ・シートを表示します。

3	希望する設定を指定します。

4	「OK」ボタンを選択して、変更内容を適用し「枠」プロパティ・シートをクローズします。


凡例の移動

凡例を移動する方法:

1	凡例の枠を選択して新しい位置までドラッグします。

2	必要な場合は、ポップアップ・メニューから「更新」ボタンを選択するか、または「チャート」 [image] 「チャート更新」を選択して、チャートの外観を更新します。


参照線の追加、編集および削除について

有効な値を示す参照線をチャート枠に追加できます。参照線をチャートに追加してから、その参照線のプロパティを編集したり、その参照線をチャートから削除できます。また、「参照線」プロパティ・シートの値を変更すれば、参照線の移動も可能です。


参照線の追加

参照線を追加する方法:

1	チャートまたは単一チャート・オブジェクトを選択します。

2	ポップアップ・メニューから「参照線」コマンドを選択するか、または「チャート」 [image] 「参照線」を選択して、「参照線」プロパティ・シートを表示します。

参照線が存在していない場合には、警告が表示されて新しい参照線を作成するかどうかを聞いてきます。「はい」ボタンを選択すると、新しい参照線が「参照線」プロパティ・シートに自動的に作成されます。

3	プロパティ・シート内の「作成」を選択して新しい参照線を作成します。

4	デフォルトの凡例のラベルと値を確定するか、またはその設定を変更します。

5	「OK」ボタンを選択して、新しい参照線をチャート枠上に描画し「参照線」プロパティ・シートをクローズします。


参照線プロパティの編集

参照線プロパティを編集する方法:

1	チャートまたは単一チャート・オブジェクトを選択します。

2	ポップアップ・メニューから「参照線」コマンドを選択するか、または「チャート」 [image] 「参照線」を選択して、「参照線」プロパティ・シートを表示します。

3	編集するプロパティを含む参照線を「参照線」ドロップダウン・リストから選択します。

4	設定するオプションを指定します。

5	「OK」ボタンを選択して、変更内容を参照線に適用し「参照線」プロパティ・シートをクローズします。


参照線の削除

参照線を削除する方法:

1	チャートまたは単一チャート・オブジェクトを選択します。

2	ポップアップ・メニューから「参照線」コマンドを選択するか、または「チャート」 [image] 「参照線」を選択して、「参照線」プロパティ・シートを表示します。

3	削除する参照線を「参照線」ドロップダウン・リストから選択します。

4	「削除」を選択します。

警告が表示されて、削除を確認するように指示されます。

5	「Yes」を選択して確認します。

6	「OK」ボタンを選択して、変更内容を適用し「参照線」プロパティ・シートをクローズします。


軸枠プロパティの指定について

「枠」プロパティ・シートで軸チャートの外観を変更できます。「枠」プロパティとして、基本線の値、項目幅、深さサイズ、シャドウ・サイズおよびシャドウ方向があります。深さサイズ、シャドウ・サイズ、シャドウ方向が指定できます。「枠」プロパティ・シートでは、凡例を隠したり表示することもできます。また、凡例を隠すように指定したり、複数の列に分割するように指定してもかまいません。


軸プロパティの指定について

軸チャートの場合、軸プロパティには、選択する軸のタイプ（項目軸、値軸または日付軸）に固有のオプションがいくつかあります。

また、軸の項目ラベルの指定、チャートに使用する目盛きざみと目盛きざみラベルのプロパティの設定、格子表示の指定ができます。


項目軸および値軸、日付軸のプロパティの指定

項目軸および値軸、日付軸のプロパティを指定する方法:

1	チャートまたは単一チャート・オブジェクト（項目軸、値軸、日付軸のうちどれか）を選択します。

2	ポップアップ・メニューから「軸」コマンドを選択するか、または「チャート」 [image] 「軸」を選択して、「軸」プロパティ・シートを表示します。

3	変更したいプロパティを含む軸（X、Y1など）を「軸」ドロップダウン・リストから選択します。

4	データ型、軸の方向、目盛きざみと目盛きざみラベルの設定などから希望するオプションを指定します。

プロパティ・シートの一番上にあるタブを選択して、プロパティ・ページ間を切り換えます。

5	「OK」ボタンを選択して、変更内容を選択済みの軸に適用します。


チャートの更新について

「問合せ」プロパティ・シート内のデータに変更があった場合や、チャートの要素やファンクションをなんらかの方法で変更した場合には、その変更内容が反映されるようにチャートを更新する必要があります。チャートの更新は、次の3通りの方法により実行できます。

•	自動

•	手動

•	PL/SQLを使用して実行

PL/SQLを使用すると、指定した間隔で実行されるタイマー・トリガーによってチャートを更新できます。


動的チャートおよびアートワークのみのチャートについて

  関連項目

動的チャートとは、データ・ソースにリンクされたチャートです。Graphics Builderでは、チャートの描画に使用するデータが必要となるため、初期設定でのチャートはすべて動的チャートになります。チャートを動的にしておくことにより、そのチャートについて問合せが再実行されたりテンプレートが変更されるたびに、そのチャートの更新が行えるようになります。チャートを更新すると、Graphics Builderでは「データ」プロパティ・ページと「チャート・テンプレート」エディタの内容が参照され、新しい情報に基づいたチャートが再描画されます。

チャートを静的オブジェクトに変更するオプションもあります。


チャートの改名について

  関連項目

Graphics Builderでは、次の2つの場所を使用してチャート名を変更できます。

•	オブジェクト・ナビゲータ

•	「チャート」プロパティ・シート

PL/SQLプログラム単位で参照されているチャートを改名したら、必ず新しいチャート名が反映されるように参照内容を変更してください。


チャートの削除について

  関連項目

作成したチャートをカットしてシステムのクリップボードに保管しておくのではなく、そのチャートを完全に削除したい場合は、次の２通りの方法で実行できます。

•	オブジェクト・ナビゲータ

•	メニュー

PL/SQLプログラム単位で参照されているチャートを削除したら、必ずその削除が反映されるように参照内容を変更してください。

チャートを削除しても、そのチャートの作成に使用された問合せや、そのチャートに使用されていたチャート・テンプレートは削除されません。これらを1つずつ削除しても再使用してもかまいません。


チャートの自動更新

チャートを自動的に更新する方法:

  「チャート」プロパティ・シートの「データ」プロパティ・ページで、チェックボックスを選択して「問合せ実行時にチャートを更新」をアクティブにします。

問合せが実行されるたびにチャートが更新されます。


チャートの手動更新

チャートを手動で更新する方法:

1	更新したいチャートを選択します。

2	ポップアップ・メニューから「更新」ボタンを選択するか、または「チャート」 [image] 「チャート更新」を選択します。

Graphics Builderでは、最新の情報をもとにチャートが再描画されます。


PL/SQLによるチャートの更新

PL/SQLを使用してチャートを更新する方法:

  タイマー・トリガーを使用します。

次のプロシージャに、タイマー・トリガーの使用の仕方が示されています。

/*You could assign the following procedure to a
**timer trigger to be executed at a specified
**interval.This example updates the specified
**chart to reflect new query results or new
**properties that have been applied to chart
**elements.
*/

PROCEDURE my_timer IS
   my_query   og_query;
   my_chart   og_object;
BEGIN
   my_query:=og_get_query('emp_query');
   my_chart:=og_get_object('emp_chart');
   og_execute_query(my_query);
   og_update_chart(my_chart, OG_ALL_CHUPDA);
END;


チャートのアートワークへの変換

動的チャートを静的アートワーク・オブジェクトに変換する方法:

1	アートワークに変換したいチャートを選択します。

2	「チャート」 [image] 「アートワークに変換」を選択します。

Graphics Builderでは、チャートは、1つ1つが操作可能な形状で構成されるグループ・オブジェクトに変換されます。アートワーク・オブジェクトとしてのチャートの更新はできません。


オブジェクト・ナビゲータでのチャートの改名

オブジェクト・ナビゲータでチャートを改名する方法:

1	改名したいチャート・オブジェクトを選択します。

2	そのチャート名の上にマウス・ポインタを移動します。

カーソルがポインタからテキスト・エディタに変わります。

3	名前を1回選択すると、カーソルが位置付けされ、編集モードになります。

名前全体を置き換えるには、名前を選択して反転表示させ、新規名を入力します。


「チャート」プロパティ・シートでのチャートの改名

「チャート」プロパティ・ページ上でチャートを改名する方法:

1	チャートのプロパティ・シートをオープンします。

2	名前フィールドでそのチャートの名前を編集します。

3	「OK」ボタンを選択して、新しい名前を適用し「チャート」プロパティ・シートをクローズします。


オブジェクト・ナビゲータでのチャートの削除

オブジェクト・ナビゲータでチャートを削除する方法:

1	ナビゲータに、チャート・オブジェクトを選択します。

2	「削除」ボタンを選択するか、またはメニューから「ナビゲータ」 [image] 「削除」を選択します。

警告が表示されて、削除を確認するように指示されます。

3	「Yes」を選択して確認します。


メニューによるチャートの削除

メニューを使用してチャートを削除する方法:

1. 	レイアウト・エディタに、削除するチャートを選択します。

2. 	「編集」 [image] 「消去」を選択します。


オブジェクトの変更について

  関連項目

ほとんどのオブジェクトの変更は、プロパティ・シート上で行われます。各オブジェクトのプロパティ・シートやオブジェクト・タイプ・ダイアログにアクセスするには、次の3通りの方法があります。

•	オブジェクト・ナビゲータ内で、編集するオブジェクトのアイコンをダブルクリックします。

•	オブジェクトを選択しておいて、ポップアップ・メニューから「プロパティ」コマンドを選択します。

•	オブジェクトを選択しておいて、「ツール」 [image] 「プロパティ」を選択します。

発生するイベントと処理方法は、編集するオブジェクトのタイプによって異なります。


オブジェクト・ナビゲータでのオブジェクトの選択について

選択したオブジェクトに対してとるアクションによって、単一のオブジェクトや複数のオブジェクトをオブジェクト・ナビゲータ上で選択することがあります。オブジェクト・ナビゲータにオブジェクト名ノードを選択すると、レイアウト・エディタにもそのオブジェクトが選択されます。

各オブジェクトが非常に小さいか、または互いに密接している場合やレイアウト・エディタでの選択が困難な場合、オブジェクト・ナビゲータでのオブジェクトの選択が効果的です。

レイアウト・エディタ上で１グループの1メンバーであるオブジェクトを選択すると、そのグループ・ツリーの一番上にあるグループ・オブジェクトが選択されます。オブジェクトを1つずつシフトクリックすれば、複数のオブジェクトを選択できます。オブジェクトの移動は、「選択」ツールがアクティブのときにそのオブジェクトを選択してドラッグすれば実行できます。また、オブジェクトのサイズ変更は、そのオブジェクトの制御点をドラッグすれば実行できます。


ルールの有効範囲について

Graphics Builderでは、オブジェクトの選択に関して有効範囲が決められているルールが施行されます。このようなルールは、オブジェクトが選択されている限り施行されます。ルールは、次のとおりです。

1	「選択」ツールを使用する場合は、選択されているオブジェクトと同じグループに属するオブジェクトしか選択できません。別のグループに属するオブジェクトや、どのグループにも属さないオブジェクトを選択するには、次のいずれかを実行してください。

レイアウトの空き領域を選択してオブジェクトをすべて選択解除してから、通常の方法で他のオブジェクトを選択します。

「配置」 [image] 「グループ設定」サブメニューにある項目を1つ選択して、オブジェクトを既存のグループに追加します。

2	複数のオブジェクトの選択は、それらのオブジェクトが同じグループに属する場合（それらのオブジェクトが兄弟の場合）にしか実行できません。


単一オブジェクトまたはグループ・オブジェクトの選択

単一オブジェクトまたはグループ・オブジェクトを選択する方法:

1	ツール・パレットにある「選択」ツールを選択します。

2	オブジェクトを選択して選択します。

オブジェクトを取り囲むように領域をドラッグして、そのオブジェクトを選択することもできます。

他のオブジェクトが選択されているときに単一オブジェクトまたはグループ・オブジェクトを選択する方法:

1	ツール・パレットにある「選択」ツールを選択します。

2	オブジェクトをシフトクリックして選択します。

[Shift]キーを押しながらオブジェクトを取り囲むように領域をドラッグして、そのオブジェクトを選択することもできます。

3	選択したい個々のオブジェクトに、この処理を行います。


複数オブジェクトの選択

複数のオブジェクトを選択する方法:

1	ツール・パレットから「選択」ツールを選択します。

2	各オブジェクトを取り囲むように領域をドラッグしてそれらのオブジェクトを選択するか、または最初のオブジェクトを選択してからシフトクリックによってオブジェクトを1つずつ選択します。


グループ・オブジェクト内の単一オブジェクトの選択

グループ・オブジェクト内の1つのオブジェクトのみを選択する方法:

1	ツール・パレットにある「選択」ツールを選択します。

2	グループ・オブジェクトを選択します。

グループ・オブジェクトを取り囲むように領域をドラッグして、そのグループ・オブジェクトを選択することもできます。

3	子オブジェクトを選択します。

「選択」ツールを使用して1つのグループ内の1つのオブジェクトを選択すると、そのオブジェクトが属する最上位レベルのグループが選択されます。

同じグループ内の他のオブジェクトが選択されているときにそのグループ内の単一オブジェクトを選択する方法:

1	ツール・パレットにある「選択」ツールを選択します。

2	グループ・オブジェクトを選択します。

グループ・オブジェクトを取り囲むように領域をドラッグして、そのグループ・オブジェクトを選択することもできます。

3	1つの子オブジェクトを選択します。

4	そのグループ内のもう1つの子オブジェクトをシフトクリックして選択します。

5	他に選択する子オブジェクトがあれば、前述のステップ4を繰り返します。

複数のオブジェクトが同じ親を共有している場合に限り、それらのオブジェクトを同時に選択できます。


すべてのオブジェクトの選択

レイアウト上のオブジェクトをすべて選択する方法:

  「編集」 [image] 「すべて選択」を選択します。

アクティブ・レイヤー上のオブジェクトがすべて選択されます。


オブジェクト・ナビゲータでのオブジェクトの選択

ナビゲータにリストされている各オブジェクトには、次の3つの基本要素が左から右に構成されています。

サブオブジェクト標識

タイプ・アイコン

名前

オブジェクト・ナビゲータでオブジェクトを選択する方法:

  オブジェクト・ナビゲータで、オブジェクトのタイプ・アイコンまたは名前を選択します。

オブジェクト・ナビゲータに既存のオブジェクト（たとえば、SAL_bars）を選択すると、対応するオブジェクトがレイアウト・エディタに選択されることに注意してください。

また、現在どのオブジェクトが選択されているかがわかるように、選択されたオブジェクトの名前が「オブジェクト・ナビゲータ」ウィンドウのタイトル・バーに表示されます。

[Shift]キーを押しながらオブジェクト・タイプ・アイコンを選択すれば、ナビゲータ上で複数のオブジェクトを選択できます。


サブオブジェクト標識

プラス符合が表示されている場合は、オブジェクトを拡張してそのオブジェクトのサブオブジェクトを表示できることを示し、符合が表示されていない場合は、オブジェクトにはサブオブジェクトがなく、さらにそのオブジェクトも拡張できないことを示します。マイナス符合は、オブジェクトがすでに拡張済みであることを示します。


タイプ・アイコン

レイヤー、チャート、チャート要素、形状などのオブジェクト・タイプを示します。


名前

Graphics Builderに割り当てられたデフォルト名か、またはカスタマイズされた名前のどちらかです。


オブジェクトの選択解除

オブジェクトを選択解除する方法:

  選択済みオブジェクトをすべて選択解除する場合は、レイアウトの空き領域を選択します。

  複数の選択済みオブジェクトの中から1つ選択解除する場合は、そのオブジェクトをシフトクリックします。


単一オブジェクトまたはグループ・オブジェクトの移動

単一オブジェクトまたはグループ・オブジェクトを移動する方法:

1	移動するオブジェクトを選択します。

2	そのオブジェクトのバウンディング・ボックスの内側を選択して移動したい位置までドラッグします。

水平軸または垂直軸に対してオブジェクトの位置を維持する場合は、[Shift]キーを押しながらそのオブジェクトを水平または垂直にドラッグします。

矢印キーを使用すると、オブジェクトをどの方向にでも1ピクセルずつ移動できます。


複数のオブジェクトの移動

複数のオブジェクトを移動する方法:

1	移動したいオブジェクトをいくつか選択します。

2	1つの選択済みオブジェクトのバウンディング・ボックスの内側を選択して移動したい位置までドラッグします。他の選択済みオブジェクトがすべてそのオブジェクトとともに移動します。


オブジェクト・ナビゲータでのオブジェクトの再順序指定

オブジェクト・ナビゲータでオブジェクトを再順序指定する方法:

  オブジェクトを選択して、そのオブジェクトの階層構造の新しい位置までドラッグします。

ナビゲータの階層構造でオブジェクトの「順序」を変更できるのは、このアクションだけです。レイアウト内のオブジェクトの物理位置を変更する場合には、そのオブジェクトをレイアウト・エディタ内で移動してください。

オブジェクトは、作成された順序でナビゲータにリストされます。


オブジェクトの整列

オブジェクトを整列させる方法:

1	整列させたいオブジェクトを選択します。

2	「配置」 [image] 「オブジェクト整列」を選択して、「オブジェクト整列」ダイアログを表示します。

3	希望する整列設定を指定します（たとえば、オブジェクトを上揃え、下揃え、左揃え、右揃えまたは中央揃えにする）。オブジェクトが互いに整列し合うように指定したり、格子表示に対して整列するように指定することもできます。

4	「OK」ボタンを選択して、整列設定を確認しオブジェクトを整列させます。

現在の整列設定を使用してオブジェクトを整列させる方法:

1	整列させるオブジェクトを選択します。

2	「配置」 [image] 「整列繰返し」を選択します。

オブジェクトの整列は、「オブジェクト整列」ダイアログ・ボックスの現在の設定に従って行われます。

整列設定は、一度指定されたら、変更が加えられるまでアクティブのままです。一度定義した整列設定を必要に応じて繰り返すこともできます。


スタック順序の変更

スタック順序を変更する方法:

1	移動するオブジェクトを選択します。

2	「配置」メニューを選択してから、次のいずれかを実行してください。

•	オブジェクトをそのすぐ前面にあるオブジェクトの前に移動する場合は、「前面へ」を選択する。

•	オブジェクトをそのすぐ背面にあるオブジェクトの後ろに移動する場合は、「背面へ」を選択する。

•	オブジェクトを他のすべてのオブジェクトの前に移動する場合は、「最前面へ移動」を選択する。

•	オブジェクトを他のすべてのオブジェクトの後ろに移動する場合は、「最背面へ移動」を選択する。


プログラム上でのオブジェクトの移動

  関連項目

プログラム上でオブジェクトを移動する方法:

  ビルトイン・プロシージャOG_MOVEを使用します。

次の例を使用すると、指定されたオブジェクトがレイアウト上の別の位置に移動します。

PROCEDURE move_inventory(invent_obj IN og_object) IS

distance   OG_POINT;
BEGIN
   distance.x:=(3*OG_INCH);
   distance.y:=(3*OG_INCH);
   OG_MOVE(invent_obj, distance);
END;


オブジェクトのコピー

オブジェクトをコピーする方法:

1	コピーするオブジェクトを選択します。

2	「コピー」ボタンを選択するか、または「編集」 [image] 「コピー」を選択するか、ポップアップ・メニューから「コピー」コマンドを選択します。

Graphics Builderにより、オブジェクトがクリップボードに格納されます。


オブジェクトのカット

オブジェクトをカットする方法:

1	削除するオブジェクトを選択します。

2	ポップアップ・メニューから「カット」コマンドを選択するか、または「カット」ボタンを選択するか、「編集」 [image] 「カット」を選択します。

Graphics Builderにより、オブジェクトがレイアウトから削除され、クリップボードに格納されます。


オブジェクトの消去

オブジェクトを消去する方法:

1	削除するオブジェクトを選択します。

2	ポップアップ・メニューから「消去」コマンドを選択するか、または「編集」 [image] 「消去」を選択します。

Graphics Builderにより、クリップボードの内容に影響なくオブジェクトがレイアウトから削除されます。

消去されたオブジェクトの取出しはできません。


プログラム上でのオブジェクトの消去

  関連項目

プログラム上でオブジェクトを消去する方法:

  PL/SQLビルトイン・サブプログラムOG_DESTROYを使用します。

次の例を使用すると、指定されたウィンドウがランタイム表示から削除（「破棄」）されます。

PROCEDURE destroy_USA IS
   the_window   OG_WINDOW;
BEGIN
   the_window:=OG_GET_WINDOW('USA_window');
   OG_DESTROY(the_window);
END;


オブジェクトのペースト

オブジェクトをペーストする方法:

  「ペースト」ボタンを選択するか、または「編集」 [image] 「ペースト」を選択します。

Graphics Builderにより、オブジェクトがクリップボードからレイアウト上の元のオブジェクトと同じ位置にペーストされます。選択したオブジェクトを移動することもできます。

元のオブジェクトの上に重ねてペーストすると、そのコピーを移動するまで元のオブジェクトは参照できません。


オブジェクトの複製

レイアウト上にオブジェクトを複製する方法:

1	複製したいオブジェクトを選択します。

2	「編集」 [image] 「複製」を選択します。

Graphics Builderにより、オブジェクトがレイアウト上の元のオブジェクトの位置からわずかにずれたところに複製されます。

「編集」 [image] 「複製」を繰り返して行えば、最初に選択したオブジェクトをいくつも複製できます。


プログラム上でのオブジェクトの複製

  関連項目

プログラム上でオブジェクトを複製する方法:

  ビルトイン・サブプログラムOG_CLONEを使用します。

次の例を使用すると、指定されたオブジェクトと同一のオブジェクトが新しく作成されます。

PROCEDURE dup_object(my_old_object IN og_object) IS
   my_new_object   OG_OBJECT;
BEGIN
   my_new_object:=OG_CLONE(my_old_object);
END;


オブジェクトの削除

オブジェクトを削除する方法:

  オブジェクトをレイアウトからカットまたは消去します。カットした場合は、オブジェクトが削除され、どこか他の場所にペーストできるようにクリップボードに格納されます。消去した場合は、クリップボードの内容に影響なくオブジェクトが削除されます。

また、オブジェクト・ナビゲータからもオブジェクトを削除できます。


オブジェクト・ナビゲータからのオブジェクトの削除

  関連項目

オブジェクト・ナビゲータからオブジェクトを削除する方法:

1	削除したいオブジェクトを選択します。

2	「削除」ボタンを選択するか、または「ナビゲータ」 [image] 「削除」を選択します。

警告が表示されて、削除を確認するように指示されます。

3	「Yes」を選択して確認します。

プログラム単位で参照されているオブジェクトを削除した場合、必ずその削除が反映されるようにプログラム単位を編集してください。


記号サイズの設定

記号オブジェクトのサイズを設定する方法:

1	記号オブジェクトを選択します。

2	「書式」 [image] 「記号」を選択して各オプションのサブメニューを表示します。

3	「大」、「標準」または「小」のどれかを選択します。

選択したサイズが、現在選択されている記号オブジェクトに適用されます。この設定は、変更が加えられるまで現在の図表に有効です。


オブジェクトのサイズ変更

オブジェクトのサイズを変更する方法:

  オブジェクトの制御点（4つ）のうちの1つを新しい位置までドラッグします。制御点のドラッグ方法によって、オブジェクトのサイズがどう変わるかが決まります。

オブジェクトの縦横比を維持するには、[Shift]キーを押しながら制御点を新しい位置までドラッグします。


単一オブジェクトまたはグループ・オブジェクトのサイズ変更

単一オブジェクトまたはグループ・オブジェクトのサイズを変更する方法:

1	サイズを変更するオブジェクトを選択します。

2	制御点の1つを選択して変更したい位置までドラッグします。


複数のオブジェクトのサイズ変更

複数のオブジェクトのサイズを変更する方法:

1	サイズを変更するオブジェクトをいくつか選択します。

2	1つの選択済みオブジェクトの制御点を選択して変更する位置までドラッグします。

他の選択済みオブジェクトがすべて、そのオブジェクトに対応したサイズに変更されます。


複数のオブジェクトの同一サイズ化

複数のオブジェクトを同じサイズにする方法:

1	サイズを変更するオブジェクトをいくつか選択します。

2	「配置」 [image] 「オブジェクト・サイズ設定」を選択して、「オブジェクト・サイズ設定」ダイアログを表示します。

3	希望するオプションを指定します(たとえば、サイズを大きいオブジェクトに合せるか小さいオブジェクトに合せるか、幅や高さもしくはその両方の平均値を使用するか、どの寸法単位を使用するかなど)。

4	「OK」ボタンを選択して、設定内容に従ってオブジェクトのサイズを変更し「オブジェクト・サイズ設定」ダイアログをクローズします。


プログラム上でのオブジェクトのサイズ変更

  関連項目

プログラム上でオブジェクトのサイズを変更する方法:

  PL/SQLビルトイン・サブプログラムOG_SCALEを使用します。

次のボタン・プロシージャの例を使用すると、指定されたオブジェクトのサイズが2倍になります。

PROCEDURE double(buttonobj IN og_object, hitobj IN
 og_object, win IN og_window, eventinfo IN og_event) IS
   anchor OG_POINT;
   newpt  OG_POINT;
   oldpt  OG_POINT;
BEGIN
   anchor.x:=OG_INCH;
   anchor.y:=OG_INCH;
   oldpt.x:=OG_INCH+1;
   oldpt.y:=OG_INCH+1;
   newpt.x:=OG_INCH+2;
   newpt.y:=OG_INCH+2;
   OG_SCALE(hitobj, anchor, oldpt, newpt);
END;


オブジェクトの変形

オブジェクトを変形するには、そのオブジェクトの頂点を変形したい位置までドラッグします。オブジェクトの変形時に見える制御点は、オブジェクトの選択時に見える制御点とは異なります。「変形」ツールを使用すると、オブジェクトのタイプによってそれぞれ違った結果になります。

Object	変形する方法

円弧	掃引角を90度（デフォルト）以外の値に変更します。
多角形および折れ線	任意の頂点を変形したい位置に移動します。
線	始点または終点を新しい位置に移動します。
楕円、四角形、丸い四角形	任意の頂点を変形したい位置に移動します。
手書きオブジェクト	任意の点を変形したい位置に移動します。
イメージ	イメージのクリップ（または切取り）を行います。
選択制御点と変形制御点が一致することのないようにオブジェクトを回転させている場合には、「選択」ツールを使用して楕円、四角形、丸い四角形の変形を行うことはできません。

オブジェクトを変形させる方法:

1	変形させたいオブジェクトを選択します。

2	ツール・パレットから「変形」ツールを選択します。

オブジェクトのタイプに応じて、制御点がオブジェクトの頂点に移動します。

3	頂点の1つを選択して新しい位置までドラッグします。

「変形」ツールを使用すると、オブジェクトのタイプによってそれぞれ違った結果になります。


オブジェクトの回転について

「回転」ツールを使用すると、単一オブジェクトまたは複数のオブジェクトをどの方向にでも回転できます。オブジェクトは、その中央点を軸に回転します。

システムによっては、テキストの回転をサポートしていないものもあります。詳細は、使用しているオペレーティング・システムのマニュアルを参照してください。


単一オブジェクトまたは複数のオブジェクトの回転

単一オブジェクトまたは複数のオブジェクトを回転する方法:

1	ツール・パレットから「回転」ツールを選択します。

2	オブジェクトの制御点の1つを選択して、そのオブジェクトを回転させる方向にドラッグします。


グループ内のオブジェクトの回転

グループ内でオブジェクトを回転する方法:

1	ツール・パレットから「選択」ツールを選択します。

2	グループ・オブジェクトを選択します。

グループ・オブジェクトを取り囲むように領域をドラッグして、そのグループ・オブジェクトを選択することもできます。

3	子オブジェクトを選択します。

シフトクリックによって、そのグループ内の子オブジェクトをいくつか選択します。

4	ツール・パレットから「回転」ツールを選択します。

5	オブジェクトの制御点の1つを選択して、そのオブジェクトを回転させる方向にドラッグします。


プログラム上でのオブジェクトの回転

  関連項目

プログラム上でオブジェクトを回転する方法:

  PL/SQLビルトイン・サブプログラムOG_ROTATEを使用します。

次の例を使用すると、指定されたオブジェクトが指定された角度だけ逆時計回りに回転します。

PROCEDURE rotate_needle (degrees IN NUMBER,
 center_pt IN og_point) IS
   the_needle     OG_OBJECT;
BEGIN   the_needle:=og_get_object('Needle 1');
   OG_ROTATE(the_needle, center_pt, degrees);
END;


グループ操作について

複数のオブジェクトを組み合せて、1つのオブジェクトとして処理できます。1つのグループに属するオブジェクトが子オブジェクトとなり、そのグループが親オブジェクトとなります。複数のグループ・オブジェクトを組み合せることもできます。その結果生じたグループは、複数のサブグループで構成されます。


オブジェクトのグループ化

オブジェクトをグループ化する方法:

1	組み合せて1つのグループにしたいオブジェクトをいくつか選択します。

2	「配置」 [image] 「グループ化」を選択します。

オブジェクトは、組み合されて1つのグループになります。


親グループの選択

親グループを選択する方法:

  「配置」 [image] 「グループ設定」 [image] 「親選択」を選択します。

親グループが選択されます。


子オブジェクトの選択

子オブジェクトを選択する方法:

  「配置」 [image] 「グループ設定」 [image] 「子選択」を選択します。

そのグループ・オブジェクトの子オブジェクトが選択されます。


子オブジェクトの追加と削除

子オブジェクトを追加する方法と削除する方法:

1	グループ・オブジェクトと追加するオブジェクトを両方選択するか、または削除する子オブジェクトを選択します。

2	「配置」 [image] 「グループ設定」を選択してから、次のいずれかを実行します。

•	オブジェクトをグループ・オブジェクトに追加する場合は、「グループに追加」を選択します。

•	子オブジェクトをグループ・オブジェクトから削除する場合は、「グループから削除」を選択します。


プログラム上での子オブジェクトの追加と削除

  関連項目

プログラム上で子オブジェクトを追加する方法と削除する方法:

  PL/SQLビルトイン・サブプログラムOG_DELETE_CHILDおよびOG_INSERT_CHILDを使用します。

次の例を使用すると、1つの子オブジェクトが1つのグループ・オブジェクトから削除され、別のグループ・オブジェクトに挿入されます。

PROCEDURE move_prod(warehouse1 IN og_object, warehouse2 IN
 og_object, prod_index IN NUMBER) IS
   oldpt.x:=OG_INCH+1;
   oldpt.y:=OG_INCH+1;
   newpt.x:=OG_INCH+2;
   newpt.y:=OG_INCH+2;
   OG_SCALE(hitobj, anchor, oldpt, newpt);
   the_prod  og_object;
BEGIN
   the_prod:=OG_GET_CHILD(warehouse1, prod_index);
   OG_DELETE_CHILD(warehouse1, prod_index, 1);
   OG_INSERT_CHILD(warehouse2, the_prod, OG_LAST);
END;


オブジェクトのグループ解除

オブジェクトをグループ解除する方法:

1	グループ・オブジェクトを選択します。

2	「配置」 [image] 「グループ解除」を選択します。

グループ化されたオブジェクトが、それぞれ切り離されます。


オブジェクトの改名

  関連項目

オブジェクトを改名する方法:

1	オブジェクトまたはオブジェクト・グループをダブルクリックして「オブジェクト」プロパティ・シートを表示します。オブジェクトまたはオブジェクト・グループをダブルクリックして「オブジェクト」プロパティ・シートを表示します。

別の方法としては、オブジェクトまたはオブジェクト・グループを選択しておいてポップアップ・メニューから「プロパティ」コマンドを選択するか、またはオブジェクトを選択してから「ツール」 [image] 「プロパティ」を選択します。

2	「名前」フィールドに名前を入力します。

3	「OK」ボタンを選択して、新しい名前を確定し「オブジェクト」プロパティ・シートをクローズします。

オブジェクトを作成したら、「オブジェクト」プロパティ・シートを使用してそのオブジェクトの名前を指定できます。または、オブジェクト・ナビゲータで直接オブジェクトの名前を指定できます。

オブジェクトをPL/SQLプログラム単位で使用するのであれば、各オブジェクトに一意の名前を割り当ててください。

PL/SQLプログラム単位で参照されているオブジェクトの名前を変更したら、必ずその新しい名前が反映されるように参照内容を変更してください。


オブジェクト・ナビゲータでのオブジェクトの改名

  関連項目

オブジェクト・ナビゲータでオブジェクトを改名する方法:

1	改名したいオブジェクトを選択します。

2	そのオブジェクトの名前の上にマウス・ポインタを移動します。

カーソルがポインタからテキスト・エディタに変わります。

3	名前を1回選択すると、カーソルが位置付けされ、編集モードになります。

表示レイアウト内に作成したオブジェクトはどれでも改名できます。このようなオブジェクトには、レイヤー、問合せ、図形オブジェクト、パラメータ、タイマー、サウンド、チャート、チャート・テンプレートがあります。名前全体を置き換えるには、名前を選択してハイライト表示にし、新規名を入力します。プログラム単位で参照されているオブジェクトを改名したら、必ずその新しい名前が反映されるように参照内容も変更してください。

PL/SQLプログラム単位を改名する場合には、必ず「プログラム単位」エディタを使用して実行してください。


図表間でのオブジェクトの共有

図表間でオブジェクトを共有する方法:

1	オブジェクト・ナビゲータで、移動する問合せ、パラメータ、タイマー、サウンド、プログラム単位のいずれかを選択します。

2	そのオブジェクトを移動する位置まで垂直にドラッグします。ナビゲータでのオブジェクトの現在のノード位置が水平破線で示されます。

3	マウス・ボタンを離して、オブジェクトを「ドロップ」します。オブジェクトは、必ずオブジェクト階層構造の適切なノードに「ドロップ」してください（たとえば、問合せであれば、「問合せ」ノードの下にドロップします）。

図表内でオブジェクトを再順序指定できるだけでなく、問合せ、プログラム単位、パラメータ、タイマー、サウンドをある図表から別の図表へ移動できます。プログラム単位を連結ライブラリやオープン・ライブラリに移動したり、それらのライブラリから移動することもできます。

プログラム単位を図表から図表へ移動すると、そのプログラム単位のコンパイル済みの状態が失われるので、再コンパイルする必要があります。


プログラム単位でのオブジェクト参照の変更

プログラム単位でオブジェクト参照を変更する方法:

1	オブジェクトを参照するプログラム単位をダブルクリックして、そのプログラム単位を「プログラム単位」エディタに表示します。

2	「編集」 [image] 「検索/置換」を選択して「検索/置換」ダイアログを表示します。

3	「検索文字列」フィールドに旧オブジェクト名を入力します。

大/小文字区別による検索や、正規表現による項目別の検索ができます。

4	「置換文字列」フィールドに新しいオブジェクト名を入力します。

5	「すべて置換」を選択して、旧オブジェクト名の候補をすべて現行のプログラム単位で新しいオブジェクト名に置換します。

現行のスコープ（たとえばプログラム単位ノードやオープン・ライブラリ・ノード）のプログラム単位すべてで名前を検索したり、置換したりするには、「編集」 [image] 「プログラム単位すべて検索/置換」を選択します。


カラーおよびパターンの適用について

  関連項目

カラーやパターンをチャート枠のコンポーネントに適用する手順は、オブジェクトの場合と同じです。


「Line/Fill/Text」表示には、枠パターン、塗りパターンおよびテキスト・パターンと現在選択されているカラーが表示されます。別の指定をしない限り、作成されるオブジェクトには、その設定が使用されます。


オブジェクトのカラーの設定

オブジェクトのカラーを設定する方法:

1	カラーを適用する既存のオブジェクトまたはチャート要素を選択します。

2	「塗りカラー」パレットを選択してからオブジェクトのバックグラウンド・カラーを選択するか、または「線カラー」パレットを選択してからオブジェクトの境界線のフォアグラウンド・カラーを選択します。

該当するカラー・パレットが表示されます。

カラー・パレットを「切り離して」レイアウト・エディタ内の別の位置に移動するには、「パレットの切取り」オプションを選択してからそのパレットのタイトル・バーをドラッグします。

3	パレットからカラーを選択します。

パレットがクローズし、オブジェクトが指定されている場合にはカラーがそのオブジェクトに適用されます。そのカラーは、「Line/Fill/Text」表示ボックス内の該当部分にも表示され、変更が加えられるまで現行の図表に有効です。

使用しているシステムにカラー・サポートがあれば、オブジェクトの内側（塗り）と境界線（線）のどちらにもカラーを適用できます。


塗りパターンの設定

塗りパターンを設定する方法:

1	パターンを適用する既存のオブジェクトを選択します。

2	「塗りカラー」パレットを選択します。

3	「塗りカラー」パレット・メニューから「パターン」コマンドを選択して「パターン」パレットを表示します。

4	オブジェクトに適用するパターンを選択します。

そのパターンが、そのオブジェクトに適用されます。そのパターンは、「Line/Fill/Text」表示ボックス内の塗り部分にも表示され、変更が加えられるまで現行の図表に有効です。

5	「パターン」パレットをクローズします。

オブジェクトの塗りには様々なパターンを適用できます。テキスト・オブジェクトの場合は、パターンをバウンディング・ボックスの塗りに適用できますが、キャラクタ自体には適用できません。チャートの場合は、パターンをチャート・テンプレートに適用できます。


パターン・カラーの設定

パターン・カラーを設定する方法:

1	フォアグラウンド・パターン・カラーおよびバックグラウンド・パターン・カラーを適用する既存のオブジェクトまたはチャート要素を選択します。

オブジェクトを選択しないと、その設定は既存のオブジェクトに適用されず、変更が加えられるまで、のちに作成される新しいオブジェクトに適用されます。

2	「塗りカラー」パレットを選択します。

3	「塗りカラー」パレット・メニューから「パターン」コマンドを選択します。

フォアグラウンド・カラーとバックグラウンド・カラーの現行の設定を示す「パターン」パレットが表示されます。いつでも見えるように、このパレットをレイアウトの周辺に移動することもできます。

4	フォアグラウンド・カラー（左側）またはバックグラウンド・カラー（右側）のどちらか一方のドロップダウン・カラー・パレットを選択します。

該当するパレットがオープンし、使用しているシステムで利用可能なカラーが表示されます。

5	パターンのフォアグラウンドまたはバックグラウンドに適用したいカラーを選択します。

パターン・フォアグラウンド・カラー・パレットまたはパターン・バックグラウンド・カラー・パレットがクローズし、その変更内容が「パターン」パレットに反映されます。そのカラーは、選択済みオブジェクトと「Line/Fill/Text」表示ボックス内の塗り部分にも適用されます。

6	「パターン」パレットをクローズするか、または別のカラーを選択します。

この記号の選択は、次に変更するまで現行の図表に対して有効です。

パターンの濃い部分がフォアグラウンド要素で、薄い部分がバックグラウンド要素になります。使用しているシステムにカラー・サポートがあれば、現行の塗りパターンのフォアグラウンド要素とバックグラウンド要素に様々なカラーを適用できます。


テキスト・カラーの設定

  関連項目

テキスト・カラーを設定する方法:

1	カラーを適用するテキスト・オブジェクトまたはチャート要素を選択します。

2	レイアウト・エディタで「テキスト・カラー」パレット・アイコンを選択して「テキスト・カラー」パレットを表示します。

カラー・パレットを「切り離して」レイアウト・エディタ内の別の位置に移動するには、「パレットの切取り」オプションを選択してからそのパレットのタイトル・バーをドラッグします。

3	テキストのカラーを選択します。

パレットがクローズし、指定されている場合にはカラーが選択済みテキスト・オブジェクトとレイアウト上に作成される新しいテキスト・オブジェクトに適用されます。そのカラーは、「Line/Fill/Text」表示ボックス内の該当部分にも表示され、変更が加えられるまで現行の図表に有効です。

テキスト・オブジェクトのバウンディング・ボックスのカラーとパターンを設定できるだけでなく、テキスト自体のカラーも選択できます。チャート内のテキストの場合は、レイアウト・エディタに直接チャート要素を選択すれば、チャート・テンプレートにカラーを適用できます。

チャート要素のカラーをデータ・ソースにリンクするには、フォーマット・トリガーを使用して各チャート要素にカラーを適用します。


オブジェクトからの塗りパターンと塗りカラーの削除

オブジェクトから塗りパターンと塗りカラーを削除する方法:

1	カラーやパターンを再設定または削除する既存のオブジェクトまたはチャート要素を選択します。

2	「塗りカラー」パレットを選択します。

カラー・パレットを「切り離して」レイアウト・エディタ内の別の位置に移動するには、「パレットの切取り」オプションを選択してからそのパレットのタイトル・バーをドラッグします。

3	「塗りなし」オプションを選択して、現在選択されているカラーやパターンを削除します。

パレットがクローズし、選択済みオブジェクトとレイアウト上に描画される新しいオブジェクトの塗りカラーが再設定されます。そのカラーは、「Line/Fill/Text」表示ボックス内の該当部分にも表示され、変更が加えられるまで現行の図表に有効です。

オブジェクトに選択されたパターンとカラーは、再設定されるまでアクティブのままです。


プログラム上でのオブジェクトのカラーの変更

  関連項目

プログラム上でオブジェクトのカラーを変更する方法:

  カラーの変更を行うPL/SQLビルトイン・サブプログラム（OG_SET_FFCOLORなど）を使用します。

次の例を使用すると、OG_SET_FFCOLOR図形プロパティ・ビルトイン処理によって、指定されたオブジェクトのフォアグラウンド塗りプロパティが設定されます。

PROCEDURE color_country(country_name) IS
   my_object    OG_OBJECT;
BEGIN
   my_object:=OG_GET_OBJECT(country_name);
   OG_SET_FFCOLOR(country_name, 'color 72');
END;


カラー・パレットの編集

カラー・パレットを編集する方法:

1	「書式」 [image] 「カラー・パレット」を選択して、「カラー・パレット」ダイアログを表示します。

このメニュー項目が使用できない場合は、カラー・モードが「ツール・オプション-デフォルト」プロパティ・シートで「Editable」(編集可能)に設定されているか確認してください。設定されていない場合には、必ず図表を一度クローズしてから再度オープンして、新しいカラー・モード設定が有効になるようにしてください。

2	編集するカラーを選択します。

3	「編集」ボタンを選択します。

ご使用のシステムのカラー編集ダイアログ・ボックスが表示されます。

4	ご使用のシステムでの手順に従ってカラーを編集します。

5	そのダイアログ・ボックスを確定して、「カラー・パレット」ダイアログ・ボックスに戻ります。

6	カラーの改名を行う場合は、「現在のカラー」フィールドに別の名前を入力してから「改名」ボタンを選択します。

7	「OK」ボタンを選択して、「カラー・パレット」ダイアログをクローズします。

使用しているシステムにカラー・サポートがあれば、図表に現在使用されているカラー・パレットを編集できます。カラー・パレットのインポートとエクスポートも可能です。


オブジェクトの境界線の非表示化

オブジェクトの境界線を隠す方法:

1	境界線を削除する既存のオブジェクトまたはチャート要素を選択します。

2	「線カラー」パレットを選択します。

カラー・パレットを「切り離して」レイアウト・エディタ内の別の位置に移動するには、「パレットの切取り」オプションを選択してからそのパレットのタイトル・バーをドラッグします。

3	「枠なし」オプションを選択して、その境界線を隠します。

パレットがクローズし、選択済みオブジェクトとレイアウト上に描画される新しいオブジェクトの線カラーが再設定されます。そのカラーや、そのカラーが存在しないことが、「Line/Fill/Text」表示ボックス内の該当する部分に表示され、そのカラーは変更が加えられるまで現行の図表に有効です。


線プロパティの設定

線プロパティを設定する方法:

1	線を選択します。

2	「書式」メニューから次のコマンドのいずれかを選択します。

•	行	線幅サイズのサブメニューを表示します。

•	線種	線種形式のサブメニューを表示します。

•	矢印	矢印スタイルのサブメニューを表示します。

3	設定するオプションを指定します。

選択されるプロパティが線オブジェクトに適用されます。設定は、変更が加えられるまで現行の図表に有効です。


枠プロパティの設定

  関連項目

枠プロパティを設定する方法:

1	オブジェクトを選択します。

2	「書式」 [image] 「線幅」を選択して枠幅を設定するか、または「書式」 [image] 「凹凸」を選択して凹凸オプションのリストを表示します。

オブジェクトの枠に凹凸オプションを設定する場合には、線幅は2ポイント以上に設定してください。

3	設定するオプションを指定します。

選択されるプロパティが選択済みオブジェクトの枠に適用されます。設定は、変更が加えられるまで現行の図表に有効です。


数値書式と日付書式の指定について

必要に応じて、次のいずれかで数値書式と日付書式を設定できます。

•	レイアウト・エディタ

•	チャート・テンプレート

•	環境設定ファイル

数値書式と日付書式を特定のチャートに直接設定する場合は、レイアウト・エディタで設定します。

数値書式と日付書式を特定のチャート・テンプレート用に設定する場合は、チャート・テンプレートで設定します。

数値書式と日付書式をすべてのチャートとすべてのBuilder設定に適用する場合や、PRNファイルなどの外部ファイルからの日付データを使用する場合は、環境設定ファイルで設定します。これにより、外部ファイルで参照されている日付が、チャートの日付に正確にマップされるようになります。対応する日付書式が環境設定ファイルに指定されていないと、Graphics Builderは外部の日付をキャラクタ・データとみなします。


テキスト・オブジェクトまたはテキスト・フィールド全体のプロパティの設定

  関連項目

テキスト・オブジェクトまたはテキスト・フィールド全体のプロパティを設定する方法:

1	テキスト・オブジェクトまたはテキスト・フィールドを選択します。

2	「書式」 [image] 「フォント」、「間隔」および「文字揃え」を選択して、オプションのサブメニューまたはダイアログ（フォント）を表示します。

3	設定するオプションを指定します。

選択されるプロパティがテキスト・オブジェクトまたはテキスト・フィールドに適用されます。

4	終了したら、テキスト・オブジェクトの外側のレイアウトを選択して、テキスト・オブジェクトまたはテキスト・フィールドを選択解除します。


部分テキスト・オブジェクトまたはデフォルト・テキスト・フィールドのテキストのプロパティの設定

部分テキスト・オブジェクトまたはデフォルト・テキスト・フィールドのテキストのプロパティを設定する方法:

1	ツール・パレットから「テキスト」ツールを選択します。

2	プロパティを変更するテキスト・オブジェクトまたはテキスト・フィールドを選択します。

選択した場所にテキスト・カーソルが表示されます。

3	変更したいテキスト上にドラッグします。

4	「書式」 [image] 「フォント」または「間隔」、「文字揃え」を選択して、オプションのサブメニューを表示します。

5	設定するオプションを指定します。

選択されるプロパティがテキストに適用されます。

6	終了したら、テキスト・オブジェクトまたはテキスト・フィールドの外側のレイアウトを選択して、テキスト・モードを編集しテキストを選択解除します。


環境設定ファイルでの数値書式と日付書式の設定

環境設定ファイルで数値書式と日付書式を設定する方法:

1	「ツール」 [image] 「ツール・オプション」 を選択して、「ツール・オプション」プロパティ・シートを表示します。

2	「数値」ボタンまたは「日付」ボタンを選択して、「数値書式」ダイアログまたは「日付書式」ダイアログを表示します。

3	「書式」フィールドに希望する数値書式または日付書式を入力します。

有効な書式に関する詳細は、『Oracle7 Server SQL言語リファレンス』を参照してください。

4	「追加」ボタンを選択して、その書式をリストに追加します。

5	「OK」ボタンを選択して、書式リストに加えた変更を確定しダイアログをクローズします。

6	「上書き保存」ボタンを選択して環境設定ファイルに設定を保存するか、または「OK」ボタンを選択して現行のセッション専用に設定を上書き保存します。

作成されるチャートには、書式リストに最後に追加した書式が使用されます。


レイアウト・エディタでの数値書式と日付書式の設定

数値書式と日付書式をレイアウト・エディタのチャートに直接設定する方法:

1	編集したい数値書式または日付書式を含むチャート要素を選択します。

設定されている要素がすべて選択されます。

2	ポップアップ・メニューから「数値書式」または「日付書式」を選択するか、あるいは「書式」 [image] 「数値」または「書式」 [image] 「日付」を選択して「数値書式」ダイアログまたは「日付書式」ダイアログを表示します。

3	「数値」または「日付」を選択して、「数値書式」ダイアログ・ボックスまたは「日付書式」ダイアログ・ボックスを表示します。

現行の数値書式または日付書式が「書式」フィールドに表示されます。

4	現行の書式を編集したり、リストから別の書式を選択したり、新しい書式を入力してリストに追加できます。書式をリストに追加し常駐させる場合は、環境設定ファイルで数値書式と日付書式を設定してください。

5	「OK」ボタンを選択して、書式リストに加えた変更を確定しダイアログをクローズします。

編集したテンプレートを使用するチャートすべてに変更が反映されます。

有効な書式に関する詳細は、『Oracle7 Server SQL言語リファレンス』を参照してください。


チャート・テンプレートでの数値書式と日付書式の設定

チャート・テンプレートで数値書式と日付書式を設定する方法:

1	チャート・テンプレートを表示させるには、「ツール」 [image] 「テンプレート」を選択します。

2	数値書式または日付書式を設定したいテンプレートを「テンプレート」ドロップダウン・リストから選択します。

選択したテンプレートがエディタのレイアウトに表示されます。

3	設定したい数値書式または日付書式を示すチャート・テンプレート要素を選択します。

4	選択した要素に応じて「書式」 [image] 「数値」または「書式」 [image] 「日付」を選択して、「数値書式」ダイアログまたは「日付書式」ダイアログを表示します。

現行の数値書式または日付書式が「書式」フィールドに表示されます。

5	現行の書式を編集したり、リストから別の書式を選択したり、新しい書式を入力してリストに追加できます。

書式をリストに追加し常駐させる場合は、環境設定ファイルで数値書式と日付書式を設定してください。

6	「OK」ボタンを選択して、書式リストに加えた変更を確定しダイアログをクローズします。

7	「チャート・テンプレート」エディタをクローズします。

編集したテンプレートを使用するチャートすべてに変更が反映されます。

有効な書式に関する詳細は、『Oracle7 Server SQL言語リファレンス』を参照してください。


テキスト・オブジェクトの編集

テキスト・オブジェクトを編集する方法:

1	ツール・パレットから「テキスト」ツールを選択します。

2	入力または編集を開始するテキスト・オブジェクトを選択します。

選択した場所にテキスト・カーソルが表示されます。

3	テキストを入力または編集します。

テキスト上をドラッグすれば、テキストをブロック単位で選択できます。

4	終了したら、テキスト・オブジェクトの外側のレイアウトを選択して、テキスト・モードから出ます。


サウンドの再生と編集

サウンドを再生する方法と編集する方法:

1	既存のサウンドをダブルクリックして、「サウンド」ダイアログ・ボックスを表示します。

2	「再生」ボタンまたは「録音」ボタンを選択して、既存のサウンドを再生または録音します。

「早送り」ボタンと「巻戻し」ボタンまたはスライド・バーを使用すると、サウンド・ファイル内の位置の検索もできます。

3	「OK」ボタンを選択して、「サウンド」ダイアログ・ボックスをクローズします。


プログラム上でのサウンドの再生

  関連項目

プログラム上でサウンドを再生する方法:

  PL/SQLビルトイン・プロシージャOG_PLAY SOUNDおよびファンクションOG_GET_SOUNDを使用します。

次の例を使用すると、指定されたサウンドが、環境設定ファイルに指定されたサウンド出力デバイスから再生されます。

PROCEDURE warning IS
   the_sound   OG_SOUND;
BEGIN
   the_sound:=OG_GET_SOUND('warning_snd');
   OG_PLAY_SOUND(the_sound);
END;


サウンドのエクスポート

サウンドをエクスポートする方法:

1	ナビゲータにサウンド・オブジェクトを選択します。

2	「ファイル」 [image] 「エクスポート」 [image] 「サウンド」を選択して、「サウンド・エクスポート」ダイアログを表示します。

3	希望するオプションを指定します（ファイル名と位置、サウンドをエクスポートするときのファイル形式と圧縮方式など）。

4	「OK」ボタンを選択して、情報を確認し「サウンド・エクスポート」ダイアログをクローズします。

サウンドが、指定された位置にエクスポートされます。


内部サウンドの改名

  関連項目

内部サウンドを改名する方法:

1	改名したいサウンド・オブジェクトを選択します。

2	そのサウンドの名前の上にマウス・ポインタを移動します。

カーソルがポインタからテキスト・エディタに変わります。

3	名前を1回選択すると、カーソルが位置付けされ、編集モードになります。

名前全体を置換する場合は、その名前を選択して反転表示させてから、新しい名前を入力します。

Builder内に作成されたサウンドや図表にインポートされたサウンドは、図表に対して内部的であると考えられます。また、ファイル・システムやデータベースに格納されたサウンドは、図表に対して外部的であると考えられます。サウンドの位置によって、サウンドへのアクセス権限の付与と取消し、サウンドの改名、サウンドの削除に使用する手段が決まります。

PL/SQLプログラム単位で参照されているサウンドを改名したら、必ずその新しい名前が反映されるように参照内容も変更してください。


内部サウンドの削除

内部サウンドを削除する方法:

1	削除したいサウンド・オブジェクトを選択します。

2	「削除」ボタンを選択するか、または「ナビゲータ」 [image] 「削除」を選択します。

3	削除の確認が表示されたら、「はい」を選択してそれを確定します。

サウンドが図表から削除されます。

Builder内に作成されたサウンドや図表にインポートされたサウンドは、図表に対して内部的であると考えられます。また、ファイル・システムやデータベースに格納されたサウンドは、図表に対して外部的であると考えられます。サウンドの位置によって、サウンドへのアクセス権限の付与と取消し、サウンドの改名、サウンドの削除に使用する手段が決まります。


パラメータについて

パラメータは、ドリルダウン・リレーションで最も頻繁に使用され、図表のチャート要素値や図形オブジェクト名を表します。パラメータは、問合せの中やPL/SQLプログラム単位の中で、指定のアクションを起動するために使用します。

パラメータは、複数のPL/SQLプログラム単位の中で、グローバル変数としても使用できます。

パラメータの使用方法としては次のようなものがあります。

•	ドリルダウン・リレーションでチャート要素値を表します。

•	ドリルダウン・リレーションまたはボタン・プロシージャで図形オブジェクト名を表します。

•	PL/SQLプログラム単位の値を格納します。

•	問合せで使用するWHERE句などの文字列を格納します。


パラメータ・コンポーネントについて

作成する各パラメータは、次のコンポーネントを持っています。

名前

タイプ

初期値


名前

SQLまたはPL/SQL文のパラメータを参照するために使用する名前。


タイプ

パラメータが表す値のデータ型。ポップリストの有効なエントリは、NUMBER、CHARおよびDATEです。


初期値

（オプション）図表を最初に実行するときにパラメータに割り当てられる値。ここに入力された値は、手動またはプログラム操作で割り当てた値で置換できます。


パラメータの作成について

「パラメータ」ダイアログ・ボックスを使用してパラメータを作成します。パラメータは、使用する前に作成しておくことも、ドリルダウン・リレーションの設定などのような他のタスクの実行中に作成することもできます。

NUMBERまたはCHAR、DATE以外のデータ型（たとえば、Graphics Builder PL/SQLビルトイン・データ型の1つ）のグローバル変数を作成する場合、それらの変数を定義するパッケージを作成できます。PL/SQLパッケージの詳細は『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください。

パラメータの作成が終わると、プログラム単位、SQL問合せまたはドリルダウン・プロシージャの内部でそのパラメータを参照できます。


オブジェクト・ナビゲータを使用したスタンドアロン・パラメータの作成

オブジェクト・ナビゲータを使用してパラメータを作成する方法

1	オブジェクト・ナビゲータ内で、「パラメータ」ノードを選択します。

2	「パラメータ」ダイアログ・ボックスを表示するには、「作成」ボタンを選択するか、メニューから「ナビゲータ」 [image] 「作成」を選択します。

パラメータが現在存在していない場合は、「パラメータ」ノードをダブルクリックして、「パラメータ」ダイアログ・ボックスを表示します。

新規パラメータは最初、paramxという名前が付けられ、CHAR型です。

3	新規パラメータの名前、タイプおよび初期値を定義します。

4	新規パラメータの設定をアクセプトしてダイアログ・ボックスをクローズするには、「OK」を選択します。


メニューを使用したスタンドアロン・パラメータの作成

メニューを使用してパラメータを作成する方法

1	「パラメータ」ダイアログ・ボックスを表示するには、「ツール」 [image] 「パラメータ」を選択します。

2	新規パラメータを作成するには、「作成」ボタンを選択します。

新規パラメータは最初、paramxという名前が付けられ、CHAR型です。

3	パラメータの名前、タイプおよび初期値を定義します。

4	新規パラメータの設定をアクセプトしてダイアログ・ボックスをクローズするには、「OK」を選択します。


ドリル・ダウン・ページでの新規パラメータの作成

  関連項目

ドリルダウン・ページで新規パラメータを作成する方法

1	オブジェクト・プロパティ・シートを表示するには、パラメータ値を割り当てるオブジェクト（チャート要素など）をダブルクリックします。

オブジェクト・プロパティ・シートを表示するのに、オブジェクトを選択してポップアップ・メニューから「プロパティ」コマンドを選択するか、または「ツール」 [image] 「プロパティ」を選択する方法もあります。

2	「ドリルダウン」タブを選択して、ドリルダウン・プロパティ・ページを表示します。

3	「パラメータ」ダイアログ・ボックスを表示するには、「パラメータ設定」フィールドの右側の「編集」を選択します。

4	パラメータのタイプおよび初期値を定義します。

5	新規パラメータの設定をアクセプトしてダイアログ・ボックスをクローズするには、「OK」を選択します。

6	「ドリルダウン」プロパティ・ページの「以下の値に設定」フィールドおよび「問合せ実行」フィールドを設定します。

7	ドリルダウン・リレーションをアクセプトするには、「OK」を選択します。


参照による新規パラメータの作成

参照で新規パラメータを作成する方法

1	SQL問合せまたはPL/SQLプログラムの内部で、一意のパラメータ名に対する参照を入力します。次に例を示します。

:object := OG_GET_OBJECT (circle1);

2	問合せを実行するには、「OK」を選択します。また、プログラム単位をコンパイルするには、「コンパイル」を選択します。

3	参照されるパラメータが存在しない場合、そのパラメータを作成するかどうかを尋ねるプロンプトが表示されます。

4	「パラメータ」ダイアログを確認および表示するには、「Yes」を選択します。

5	パラメータのタイプおよび初期値を定義します。

6	新規パラメータの設定をアクセプトしてダイアログ・ボックスをクローズするには、「OK」を選択します。

7	問合せを再実行するには、「OK」を選択します。また、プログラム単位をコンパイルし直すには、「コンパイル」を選択します。

SQL SELECT文の作成中にパラメータを使用する必要がある場合は、新規で一意のパラメータ名を参照してください。問合せの実行を指定すると、Graphics Builderから新規パラメータの作成を求めるプロンプトが表示され、続いて「パラメータ」ダイアログが表示されます。


オブジェクト・ナビゲータでのパラメータの改名

オブジェクト・ナビゲータ内でパラメータを改名する方法

1	改名するパラメータ・オブジェクトを選択します。

2	名前を1回選択すると、カーソルが位置付けされ、編集モードになります。

名前全体を置き換えるには、名前を選択してハイライト表示にし、新規名を入力します。

3	SQL SELECT文、PL/SQLプログラム単位またはドリルダウン・リレーションの中でこのパラメータを参照している場合は、該当する参照を変更して、新規パラメータ名を反映させてください。


「パラメータ」ダイアログでのパラメータの改名

「パラメータ」ダイアログのパラメータを改名する方法

1	「パラメータ」ダイアログ・ボックスをオープンします。

2	改名するパラメータを「名前」ドロップダウン・リストから選択します。

3	名前を編集します。

4	新規名をアクセプトして「パラメータ」ダイアログ・ボックスをクローズするには、「OK」を選択します。

5	SQL SELECT文、PL/SQLプログラム単位またはドリルダウン・リレーションの中でこのパラメータを参照している場合は、該当する参照を変更して、新規パラメータ名を反映させてください。


オブジェクト・ナビゲータによるパラメータの編集

オブジェクト・ナビゲータを使用してパラメータを編集する方法

1	パラメータ・オブジェクトをダブルクリックして、「パラメータ」ダイアログを表示します。

また、パラメータ・オブジェクトを選択してポップアップ・メニューから「プロパティ」コマンドを選択するか、「ツール」 [image] 「プロパティ」を選択する方法もあります。

2	設定を変更します。

3	変更をアクセプトしてダイアログ・ボックスをクローズするには、「OK」を選択します。


メニューを使用したパラメータの編集

メニューを使用してパラメータを編集する方法

1	「パラメータ」ダイアログ・ボックスを表示するには、「ツール」 [image] 「パラメータ」を選択します。

2	変更するパラメータの名前を、「パラメータ」ドロップダウン・リストから選択します。

3	設定を変更します。

4	変更をアクセプトしてダイアログ・ボックスをクローズするには、「OK」を選択します。


パラメータの参照について

Graphics Builderでは、次の2種類のパラメータ参照があります。

•	バインド

•	字句

「パラメータ」ダイアログ・ボックスではパラメータ名はすべて大文字でリストされていますが、SQL文またはPL/SQL文で使用するときは大/小文字を区別する必要はありません。

存在していないパラメータを参照すると、その時点でそのパラメータを作成するかどうかを尋ねる警告が表示されます。「Yes」と答えると、「パラメータ」ダイアログが表示されます。


パラメータへの値の割当てについて

次の4種類の方法でパラメータに値を割り当てることができます。

•	最初に、「パラメータ」ダイアログ・ボックス内で。

•	PL/SQLプログラム単位内で。

•	ユーザー・アクションに基づいて。

•	ランタイムまたはバッチ実行可能プログラムの引数として。

実行時には、パラメータの値は、SQL SELECT文またはPL/SQLプログラム単位の中で参照されます。


ユーザー・アクションに基づくパラメータ値の割当てについて

  関連項目

パラメータ値を図表のオブジェクト（たとえば、チャート要素）に結び付けることができます。ユーザーがランタイム図表の図表オブジェクトを選択することにより、パラメータ値を設定できます。次の2つのアプリケーションを使用できます。

•	ドリルダウン・リレーションの作成。

•	オブジェクト・ボタン・プロシージャの使用。


バインド参照の作成

バインド参照を作成する方法

  パラメータ名の直前にコロン(:)を入力します。パラメータはオンザフライに作成できるので、参照前にパラメータを定義しておく必要はありません。

たとえば、次のSQL SELECT文では、my_paramがEMP表内のENAME列の1つの値を表します。

select ename, sal
from emp
where ename = :my_param

バインド参照を使用して、SQL SELECT文またはPL/SQLプログラム単位の文字列、数値、日付などの1つの値を置き換えます。


字句参照の作成

字句参照を作成する方法

  パラメータ名または列名の直前にアンパサンド(&)を入力することにより、パラメータまたは列の字句参照を作成します。デフォルトの定義は提供されていないので、各字句参照の初期値も入力してください。

たとえば、パラメータを使用してSELECT文中のWHERE句を表すには、まずそのパラメータを定義し、その初期値フィールドにWHERE句を入力します。

そして、SELECT文を作成します。

select ename, sal
from emp
&my_param

また、プログラムを使用して値を割り当てた後、新規の値に基づいて問合せを実行し、関連したチャートを更新することもできます。

PROCEDURE set_param (name IN VARCHAR2, qry IN OG_QUERY) IS
  the_chart  OG_OBJECT;
BEGIN
  :my_param:='WHERE ENAME = '||name;
  OG_EXECUTE_QUERY(qry);
  the_chart:=OG_GET_CHART('chart0');
  OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END;

字句を使用してSELECT文の列名を置き換える場合は、置き換える各列に対して字句を作成します。Graphics Builderでフィールドを正しくマップできるように、各列に別名を設定してください。また、実行時には、このSELECT文に指定した数と同じ数の項目を指定してください。

次に例を示します。

select &param1 ONE, &param2 TWO
from &tablename
&where_clause

字句参照をSQL SELECT文の複数テキスト文字列のプレースホルダとして使用します。字句参照を使用して、SELECT、FROM、WHERE、GROUP BY、ORDER BY、HAVING、CONNECT BYおよびSTART WITHの後に続く句を置換します。

CHAR型のパラメータのみを字句パラメータとして使用できます。また、PL/SQL文中の字句参照は作成できません。


パラメータへの初期値の割当て

  関連項目

パラメータに初期値を割り当てる方法は、次のとおりです。

  「初期値」フィールドに値を入力します。


PL/SQLを使用したパラメータへの値の割当て

  関連項目

PL/SQLを使用してパラメータに値を割り当てる方法

  パラメータを参照し、他の変数と同様に、そのパラメータに値を割り当てます。

たとえば、パラメータDNOに値10を割り当てるには、次の文をプロシージャに組み込みます。

:DNO := 10;

パラメータに数値またはテキスト文字列などの絶対値を割り当てることができます。また、他の変数、パラメータおよび演算子を使用して、パラメータに相対値を割り当てることもできます。

たとえば、NUMBER型のmy_numという名前のパラメータを定義したと仮定します。PL/SQL文では次のように設定できます。

PROCEDURE double IS
BEGIN
  :my_num := :my_num*2;
END;

これは、my_numに、元の値に2をかけた値を設定します。


コマンド・ラインでのパラメータ値の割当て

  関連項目

コマンド・ラインでパラメータ値を割り当てる方法

  パラメータ割当てをコマンド文字列の最後の引数としてインクルードします。パラメータ用に指定された値は、「パラメータ」ダイアログ・ボックス内に設定されたパラメータの初期値を置換します。

次の例では、パラメータhisparam（NUMBER型）およびherparam（DATE型）への値の割当て方法を示します。

g30des openfile=chart1 hisparam=29 herparam='94-10-02'

パラメータはグローバルですが、変数は変数が定義されているプログラム単位内に限り使用できます。プログラム単位の外で変数を使用する場合は、かわりにパラメータを使用してください。


オブジェクト・ボタン・プロシージャを使用したパラメータ値の設定

オブジェクト・ボタン・プロシージャの使用方法

1	パラメータ値を設定する図形オブジェクトをダブルクリックします。

また、オブジェクトを選択してポップアップ・メニューから「プロパティ」を選択するか、または「ツール」 [image] 「プロパティ」を選択する方法もあります。

2	「ドリルダウン」タブを選択して、ドリルダウン・ページを表示します。

3	新規パラメータを作成するには、「パラメータ設定」ポップリストからパラメータを選択するか、「編集」を選択します。

4	「名前」フィールドにパラメータ名を入力します。

ドリルダウン・チャートと同様に、ボタン・プロシージャはユーザーがそのオブジェクトを「ランタイム」図表でアクティブにします。ただし、アクションを起動するためにユーザーが選択するのは、チャート要素でなく図形オブジェクトです。

「オブジェクト名」値はデータ型CHARとして定義されます。パラメータをCHAR以外のデータ型として定義していた場合、問合せまたはPL/SQLプログラム単位内でそのパラメータを参照するときは、TO_CHAR変換を使用する必要があります。TO_CHARの詳細は『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください。

これで、図表内のどのプログラム単位でもこのパラメータを使用できます。


オブジェクト・ナビゲータでのパラメータの削除

オブジェクト・ナビゲータのパラメータを削除する方法

1	ナビゲータ内でパラメータ・オブジェクトを選択します。

2	「削除」ボタンを選択するか、メニューから「ナビゲータ」 [image] 「削除」コマンドを選択します。

3	警告メッセージでは、確認の「はい」を選択します。

4	SQL SELECT文、PL/SQLプログラム単位またはドリルダウン・リレーションの中でそのパラメータを参照している場合は、それらの参照を変更して削除を反映させてください。


「パラメータ」ダイアログからのパラメータの削除

「パラメータ」ダイアログからパラメータを削除する方法

1	「パラメータ」ダイアログ・ボックスを表示するには、「ツール」 [image] 「パラメータ」を選択します。

2	削除するパラメータの名前を、「パラメータ」ドロップダウン・リストから選択します。

3	「削除」を選択します。

4	警告メッセージでは、確認の「はい」を選択します。

5	「パラメータ」ダイアログをクローズするには、「OK」を選択します。

6	SQL SELECT文、PL/SQLプログラム単位またはドリルダウン・リレーションの中でそのパラメータを参照している場合は、それらの参照を変更して削除を反映させてください。


図表のオープン
�図表のオープン

図表をオープンする方法は次のとおりです。

1	「ファイル（Ｆ）」 [image] 「オープン」を選択して「フィルタ」ダイアログを表示します。

2	次の適切なラジオ・ボタンを選択します。

•	図表がファイルに保存されている場合は「ファイル・システム」

•	図表がデータベースに保存されている場合は「データベース」

3	「図表」または「すべてのファイル」チェックボックスを選択して、「OK」を選択します。

4	オープンする図表を選択して「OK」を選択します。


ランタイム用の図表の準備

  関連項目

図表をランタイム用に準備する方法は次のとおりです。

レイアウトのサイズの決定:

1	メニューから「表示」 [image] 「表示オプション」 [image] 「レイアウト」を選択します。

2	「レイアウト・サイズ」フィールドで、デフォルトの「水平」および「垂直」のサイズを変更します。

3	「インチ」または「センチメートル」のどちらかのラジオ・ボタンを選択します。

4	「OK」をクリックしてレイアウト・サイズの設定を確定し、ダイアログをクローズします。

これで、図表レイアウトが指定のサイズに変更されます。これらのサイズ設定を使用して、図表を表示するウィンドウのサイズを決定できます。

デフォルト・ウィンドウの「ウィンドウ」プロパティの設定は次のとおりです。

デフォルト設定では、Graphics Builderは「主レイアウト」というウィンドウに各図表をオープンします。次のデフォルト・ウィンドウのプロパティを変更できます。

•	ランタイムのレイアウトの位置

•	ウィンドウの縦と横のサイズ

•	ウィンドウ名

デフォルト・ウィンドウのプロパティを設定する場合には、次のような「オープン・トリガー」で設定してください。

PROCEDURE OGTRIGGERPROC0 IS
  the_win    OG_WINDOW;
  win_pos    OG_POINT;
  win_wid    NUMBER;
  win_ht     NUMBER;
BEGIN
  the_win:=OG_GET_WINDOW('Main Layout');

/*Define the position for the window*/
  win_pos.x:=1*OG_INCH;
  win_pos.y:=.5*OG_INCH;

/*Set the position property for the window*/
  OG_SET_POSITION(the_win, win_pos);

/*Define the size of the window */
  win_wid:=4*OG_APP.HSCREEN_RES;
  win_ht:=5*OG_APP.VSCREEN_RES;

/*Set the size property of the window*/
  OG_SET_WINDOW_SIZE(the_win, win_wid, win_ht);

/*Assign a name to the window */
  OG_SET_WINDOW_NAME(the_win, 'Start Here');
END;

図表はGraphics Builderランタイムでオープンされるとき、座標位置(1, .5)に'Start Here'というタイトルが付けられ、4x5のウィンドウでオープンされます。

次のようにレイアウト単位を指定します。

OG_APP定数HSCREEN_RESおよびVSCREEN_RESを使用して、図表ウィンドウの縦と横のサイズを定義します。これらの定数はOG_INCHに似ていますが、ウィンドウ専用の寸法です。

水平および垂直のレイアウト解像度は常に等価です。OG_APP.HSCREEN_RES定数およびOG_APP.VSCREEN_RES定数は、それぞれ、1水平インチおよび1垂直インチのレイアウト単位（ピクセル）の数を表します。この寸法単位により、図表ウィンドウは、それを使用する画面の解像度に関係なく同じように表示されます。

レイアウト上で(x.y)座標を表すには、OG_POINT PL/SQLビルトイン・データ型を使用します。値(0,0)は、画面の左上の角を表します。これらの座標は、レイアウト単位で表されます。


図表の生成について

図表のランタイム・バージョンを生成すると、Graphics Builderランタイムまたはバッチ実行可能プログラムで実行するのに必要な要素のみ含まれます。たとえば、生成された図表には、PL/SQLソース・コードは含まれていません。


図表の生成

図表を生成する方法は次のとおりです。

1	「ファイル(F)」 [image] 「管理」 [image] 「生成」 [image] 「ファイル・システム」または「データベース」を選択します（図表の保存先によって異なる）。

2	ランタイム図表ファイルの名前を入力するか、またはデフォルト名を使用します。

Graphics Builderランタイム図表はデフォルトのファイル拡張子として.ogrを使用します。

3	「OK」を選択して図表のランタイム・バージョンを生成します。


図表のテストについて

  関連項目

Builderでは、Graphics Builderデバッガにアクセスすることによって、図表の実行をテストすることができます。デバッガで実行する図表を選択すると、その図表の現在保存されている状態のものがGraphics Builderで実行されます。したがって、図表をBuilderの中でオープンしている場合、図表を実行する前に必ず最近行った変更を保存してください。


オープンされている図表の実行

オープンされている図表を実行する方法は次のとおりです。

1	ナビゲータ内で図表オブジェクトを選択します。

2	ツールバーの「実行」ボタンを選択して、「Graphics Builderデバッガ・主レイアウト」ウィンドウに図表をオープンします。このウィンドウでは、図表のランタイム実行がシミュレートされます。

3	作業が終了したら「ファイル」 [image] 「クローズ」を選択して、デバッガをクローズします。

デバッガでオープンしている間にBuilderの図表を変更した場合、その変更は、図表を保存して再実行するまではデバッガに表示されません。デバッガでPL/SQLプログラム単位を編集する場合、「編集」 [image] 「プログラム単位の同期化」を選択することによって、変更をBuilderに戻して組み込むことができます。


オープンされていない図表の実行

閉じた図表を実行する方法は次のとおりです。

1	「ファイル(F)」 [image] 「実行」を選択して、「ファイル」ダイアログを表示します。

2	「フィルタ」ダイアログの適切な設定を選択して、「OK」を選択し、「データベースからオープン」ダイアログまたは使用中のオペレーティング・システム・ファイル・ダイアログのいずれかをオープンします。

3	図表をリストから選択します。

4	ダイアログを確定してそれをクローズし、選択した図表を実行します。

5	図表は「Graphics Builder デバッガ・主レイアウト」ウィンドウにオープンされます。

6	作業が終了したら「ファイル」 [image] 「クローズ」を選択して、デバッガをクローズします。


図表の印刷

図表を印刷する方法は次のとおりです。

1	「ファイル」 [image] 「Print」を選択して、使用しているシステムの印刷ダイアログ・ボックスを表示します。

2	システムに適切な印刷オプションを指定します。

3	ダイアログ・ボックスを確定して、印刷を行います。

図表に複数のレイヤーが含まれている場合は、表示されているレイヤーのみが印刷されます。


印刷用ページ設定

印刷用ページの設定方法は次のとおりです。

1	「ファイル」 [image] 「Print Setup」を選択してシステムのページ設定ダイアログを表示します。

2	システム用に印刷設定を指定します。

3	ダイアログ・ボックスを確定します。

設定は、現在のBuilder Runtimeセッションの間、有効です。


図表の連鎖について

PL/SQLビルトイン・プロシージャOG_OPEN_DISPLAYを使用して、1つの図表を別の図表からオープンすることができます。2番目の図表をオープンしたとき、元の図表を、オープンしたままにしておくことも、クローズしてしまうこともできます。

新しい図表をオープンし、元の図表をクローズする場合は、OG_CLOSE_DISPLAYサブプログラムがスタックの最後にあることを確認してください。これは、図表をクローズする前に他のすべてのサブプログラムの実行が完了するようにするためです。OG_CLOSE_DISPLAYサブプログラムの後にリストされているサブプログラムは、どれもコールされません。ただし、クローズ・トリガーがあれば、そのトリガーが実行されます。

次に例を示します。

PROCEDURE next_display IS
  next_disp  OG_DISPLAY;
  old_disp   OG_DISPLAY;
BEGIN
  next_display:=OG_OPEN_DISPLAY('more.ogd', OG_FILESYSTEM);
  old_disp:=OG_GET_DISPLAY('plan.ogd');
  OG_CLOSE_DISPLAY(old_disp);
END;


パッケージの作成について

  関連項目

パッケージとは、関連するPL/SQLプロシージャ、関数、データタイプ、変数、またはその他のデータベース・オブジェクトとして格納されている構造体の集合をいいます。図表は、関連するすべての図表が同じデータベース接続を維持している限り、パッケージに格納されているグローバル変数を共有できます。データベースとの接続を切断すると、パッケージの状態はリセットされます。

図表が同じデータベース接続を維持できるようにするには、OPEN_DISPLAY PL/SQLビルトイン・プロシージャを使用して1つの図表を別の図表からオープンします。

作成するパッケージには、変数定義と、その変数を操作するサブプログラム（つまり変数値を設定するプロシージャおよび変数値をフェッチするファンクション)の両方が含まれている必要があります。変数とそれに対応付けられたサブプログラムは、同じデータベース接続を共有する図表ならどこででも参照できます。

次の例は、グローバル変数barと2つのサブプログラムを含む、パッケージの仕様と本体を示しています。

PACKAGE foo IS
  bar  VARCHAR2;
  PROCEDURE set_bar (txt VARCHAR2);
  FUNCTION get_bar return VARCHAR2;
 END;

PACKAGE BODY foo IS
  PROCEDURE set_bar (txt VARCHAR2) IS
    BEGIN
      foo.bar:=txt;
    END;

  FUNCTION get_bar RETURN VARCHAR2 IS
    BEGIN
      return foo.bar;
    END;
END;

1度パッケージを作成しておくと、グローバル変数を参照し、ストアド・サブプログラムを使用して図表間でその変数の値を操作することができます。次に例を示します。

PROCEDURE set_param IS
BEGIN
/*assign the local parameter 'param' to the value of the
global variable bar*/

  :param:=foo.get_bar;

/*change the value of bar for the next time it is
referenced*/

  foo.set_bar('object1');
END;

PL/SQLパッケージに関する詳細は、『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください。


ウィンドウについて

Graphics Builderでは、ウィンドウは作業領域と表示領域としての2つの機能を持っています。

Graphics Builderでは、ウィンドウは、エディタ、表、ブラウザなどのGraphics Builderインタフェース要素が含まれている作業域です。複数のウィンドウをオープンできますが、アクティブにできるウィンドウは一度に1つのみです。

デフォルトのウィンドウ構成には、図表をオープンしたときに表示されるウィンドウの位置および数が定義されています。デフォルトでは、オープンされるのは「レイアウト・エディタ」ウィンドウのみです。しかし、異なるウィンドウを設定したり、「環境設定」ダイアログ・ボックスを使用して、そのウィンドウを新規デフォルトとして保存することができます。

また、実行時にレイアウトの別の領域にオブジェクトを表示するウィンドウをプログラムによって作成することもできます。デフォルト設定では、図表のオブジェクトは「主レイアウト」ウィンドウに表示されます。PL/SQLを使用して、オブジェクトを表示する追加ウィンドウを作成できます。また、ウィンドウのサイズと位置について、いつオープン/クローズするのかについても定義できます。


ウィンドウの可視制御について

以下に示すように、ランタイム・アプリケーションで使用されているウィンドウをさらに細かく管理することができます。

隠す	このオプションを使用して、ウィンドウを一時的に隠します。再度表示することができます。
表示	このオプションを使用して、以前に隠したウィンドウをまた表示します。
破棄	このオプションを使用して、不要になったウィンドウをクローズします。破棄するウィンドウとしては、既存の図表からオープンされたウィンドウが考えられます。
注意: デフォルトの「主レイアウト」ウィンドウは破棄できません。デフォルトの「主レイアウト」を破棄する場合は、OG_CLOSE_DISPLAYを使用するか、またはOG_HIDE_WINDOWを使用します。


ウィンドウとレイヤーの使用について

図表に複数のレイヤーが含まれている場合、個別のウィンドウ間で既存のレイヤーをアクティブにしたり、表示したり、隠したりすることができます。これには、別の図表をオープンするのと同じ効果があります。各レイヤーを別のウィンドウに提示できるので、ユーザーは1つの図表の複数レイヤーを見ることができます。

複数のウィンドウ間でレイヤーを操作するには、PL/SQLビルトイン・プロシージャOG_ACTIVATE_LAYER、OG_HIDE_LAYERおよびOG_SHOW_LAYERを使用します。これらのプロシージャのそれぞれに、オプションのウィンドウ・ハンドル引数があります。プロシージャに特定のウィンドウ・ハンドルを指定しない場合、Graphics Builderは、レイヤーが含まれている各ウィンドウ上で指定のアクションを実行します。

ユーザーは、アクティブ・レイヤー・ウィンドウとのみ対話できます。アクティブ・レイヤーは隠せないことを忘れないでください。まず先に新しいレイヤーをアクティブにしてから、前のレイヤーを隠します。

次の例には、図表の2番目のレイヤーをアクティブにして新規ウィンドウに表示するプログラム単位を示します。

PROCEDURE activate_layer IS
  new_layer   OG_LAYER;
  old_layer   OG_LAYER;
  new_window  OG_WINDOW;
BEGIN
  new_layer:=OG_GET_LAYER('layer1');
  old_layer:=OG_GET_LAYER('layer0');
  new_window:=OG_GET_WINDOW('Details');
  OG_ACTIVATE_LAYER(new_layer, new_window);
END;


データベース・パイプの使用

データベース・パイプを使用する方法

1	PACK_MESSAGEプロシージャを使用して、ローカル・メッセージ・バッファに情報を追加します。

2	SEND_MESSAGEプロシージャを使用して、メッセージ・バッファ内の情報を送るために使用するパイプを指定します。

3	RECIEVE_MESSAGEプロシージャを使用して、名前付きパイプのメッセージを受け取ります。

4	UNPACK _MESSAGEプロシージャを使用して、バッファ内の情報にアクセスします。

次のプロシージャでは変数値をメッセージ・バッファに代入して、'the_pipe'というパイプでこのバッファをサーバーに送信しています。

PROCEDURE pass_var (my_var NUMBER) IS
 stat  NUMBER;
BEGIN
  DBMS_PIPE.PACK_MESSAGE(my_var);
  stat:=DBMS_PIPE.SEND_MESSAGE('the_pipe', 30, 8192);
END;

注意:注意: Graphics Builderは、現在ストアド・サブプログラムの仕様の引数に対するデフォルト値を認識していません。したがって、DBMS_PIPE.SEND_MESSAGEにはTIMEOUT引数およびMAXPIPESIZE引数用のデフォルト値がありますが、ここでは値を明示的に指定する必要があります。したがって、DBMS_PIPE.SEND_MESSAGEにはTIMEOUT引数およびMAXPIPESIZE引数用のデフォルト値がありますが、ここでは値を明示的に指定する必要があります。

次のプロシージャは、同じデータベース接続を共有している2番目の図表から実行されます。

PROCEDURE get_var IS
  my_var  NUMBER;
  stat    NUMBER;
BEGIN
/*Receive the pipe from the server */
  stat:=DBMS_PIPE.RECEIVE_MESSAGE('the_pipe', 30);
/*Unpack the information in the pipe and store in my_var*/
  DBMS_PIPE.UNPACK_MESSAGE(my_var);
/*Use the variable value to perform some action*/
  use_variable(my_var);
END;

DBMS_PIPEパッケージに関する詳細は、『Oracle7 Serverアプリケーション開発者ガイド』を参照してください。


新規ウィンドウの作成

新規ウィンドウを作成する方法は次のとおりです。

  新規ウィンドウを作成するには、PL/SQLビルトイン・ファンクションOG_MAKE_WINDOWを使用します。このファンクションを使用すると、1つのランタイム図表用に複数のウィンドウを作成できます。これによって、同じ図表の異なるレイヤーを異なるウィンドウに表示したり、複数の図表を次々にオープンすることによってそれらの図表を連鎖させることができます。

次に例を示します。

PROCEDURE make_win IS
  nu_win   OG_WINDOW;
  win_pos  OG_INCH;
  win_wid  NUMBER;
  win_ht   NUMBER;
BEGIN
  win_pos.x:=0*OG_INCH;
  win_pos.y:=0*OG_INCH;
  win_wid:=7*OG_APP.VSCREEN_RES;
  win_ht:=6*OG_APP.HSCREEN_RES;

  nu_win:=OG_MAKE_WINDOW(win_pos, win_wid, win_ht);
  OG_SET_NAME(nu_win, 'Detail Chart');
END;


ウィンドウのスクロールバーを隠す

ウィンドウのスクロールバーを隠す方法は次のとおりです。

  PL/SQLビルトイン属性レコードOG_SCROLLBARS_WINDOWAを使用します。

次に例を示します。

PROCEDURE make_window IS
  the_window  OG_WINDOW;
  windo_attr  OG_WINDOW_ATTR;
BEGIN
  windo_attr.name:='Inventory';
  windo_attr.scrollbars:=FALSE;
  windo_attr.width:=4*OG_APP.HSCREEN_RES;
  windo_attr.height:=5*OG_APP.VSCREEN.RES;
  windo_attr.mask:=OG_NAME_WINDOWA+
OG_SCROLLBARS_WINDOWA+
OG_SIZE_WINDOWA;
  the_window:=OG_MAKE(windo_attr);
END;

既存のウィンドウの属性レコードは変更できません。既存のウィンドウのスクロールバーを隠すには、そのウィンドウを隠すかまたはそのウィンドウを破棄して、新規ウィンドウを作成する必要があります。「主レイアウト」という元のデフォルト・ウィンドウは破棄できないことに注意してください。

ランタイム図表の初期ウィンドウのスクロールバーを隠す場合は、まずスクロールバーを持たない新規ウィンドウを作成するOpen Displayトリガーを作成して、「主レイアウト」ウィンドウを隠す必要があります。


ウィンドウを隠す

ウィンドウを隠す方法は次のとおりです。

  PL/SQLビルトインOG_HIDE_WINDOWを使用します。これを使用すると、ウィンドウをユーザーに対して一時的に隠し、後で再度表示することができます。

次の例には、ユーザーがチャート要素を選択したときにアクティブになるボタン・プロシージャを示します。

PROCEDURE OGBUTTONPROC0 (buttonobj IN og_object, hitobj IN og_object, win IN og_window, eveninfo IN og_event) IS
  curr_window  OG_WINDOW;
BEGIN
  curr_window:=OG_GET_WINDOW('Main Layout');
  OG_HIDE_WINDOW('Main Layout');
END;


ウィンドウの表示

ウィンドウを表示する方法は次のとおりです。

  PL/SQLビルトイン・プロシージャOG_SHOW_WINDOWを使用します。

次に例を示します。

PROCEDURE show_window IS
  back_window  OG_WINDOW;
BEGIN
  back_window:=OG_GET_WINDOW('Details');
  OG_SHOW_WINDOW(back_window);
END;


ウィンドウの破棄

ウィンドウを破棄する方法は次のとおりです。

  OG_DESTROY PL/SQLビルトインを使用します。OG_DESTROYを使用すると、OG_MAKE_WINDOWまたはOG_MAKE(Window)で作成した任意のウィンドウを、その内容を変更せずにクローズできます。

1つの図に関連付けられているすべてのウィンドウをクローズするには、OG_CLOSE_DISPLAY PL/SQLビルトイン・プロシージャを使用します。

注意: デフォルトの「主レイアウト」ウィンドウは破棄できません。

次のプロシージャで、ウィンドウが破棄されます。

PROCEDURE close_window (the_window IN og_window) IS
BEGIN
  OG_DESTROY(the_window);
END;


?


チャート・テンプレートについて

チャート・テンプレートでは、チャートの書式およびそれに含まれるさまざまなプロパティを定義します。1つのチャートは、1度に1つのチャート・テンプレートとのみ関連付けることができます。ただし、個々のチャート・テンプレートに対して次のアクションを実行し、そのテンプレートを使用してプロパティを複数のチャートに適用できます。

•	軸枠プロパティの指定

•	項目、値および日付軸プロパティの指定

•	凡例の移動

•	参照線の定義

•	数値および日付書式の指定

•	テキストおよび線プロパティの指定

•	カラーとパターンの指定

各チャート・テンプレートは、1つ以上のフィールド・テンプレートと関連付けることができます。フィールド・テンプレートは、棒グラフ、列、円グラフの円弧、線グラフなど個々のフィールドのプロパティを定義します。

Graphics Builderには、横棒グラフ、線グラフ、円グラフなどを含む10項目に分類された56のデフォルトのチャート・テンプレートから構成されるセットが備わっています。特定の型およびサブタイプのチャートを作成する場合、Graphics Builderでは、該当の型に対応付けられたデフォルトのチャート・テンプレートのコピーが作成されます。このコピーは変更できますが、デフォルト・チャート・テンプレート自体に修正を加えることはできません。

Graphics Builderでテンプレートをコピーする場合、割り当てられる名前はtemplatexです。この場合のxは、現行の図面で新規チャート・テンプレートを作成するたびに増えていく数です。チャート・テンプレートのカスタマイズが済んだら、チャートの作成時に「チャート」プロパティ・シートの「テンプレート」ドロップダウン・リストから選択することによって、そのチャート・テンプレートを複数のチャートに割り当てることができます。

チャート・テンプレートをカスタマイズするには、チャート・テンプレート・エディタを使用します。


チャート・テンプレート・コンポーネントについて

チャート・テンプレート・コンポーネントは、次の2つの主なカテゴリに分けられます。

•	チャート枠

•	フィールド・テンプレート


チャート枠について

チャート枠には、軸ラベル、書式設定および用例位置など、チャートの基本構造体を構成するコンポーネントがインクルードされています。1つのチャート・テンプレートには、チャート枠は1つのみ存在します。

最初にチャート・テンプレートを作成したときに、チャート・テンプレート・エディタに表示されるものが枠画チャート枠です。


フィールド・テンプレートについて

フィールド・テンプレートにインクルードされたコンポーネントにより、値（依存）データが棒グラフ、線グラフなどをチャート・フィールドにどのように表すか判断されます。1つのチャート・テンプレートには、少なくとも1つのデフォルト・フィールド・テンプレートがありますが、フィールド・テンプレートを追加してそれに異なるチャート値（問合せ列）を対応付けることができます。

フィールド・テンプレートを見るには、チャート・テンプレート・エディタにチャート枠が表示されているときに、エディタの上部にある「フィールド・テンプレート」ラジオ・ボタンを選択します。


チャート・テンプレート・プロパティについて

チャート・テンプレート・プロパティにより、チャート枠の外観と動作、およびフィールド・テンプレート・コンポーネントが定義されます。適用されるプロパティおよびそれをどのように定義するかは、チャート・テンプレートの型に応じて異なります。通常、チャート・テンプレート・エディタのチャート・テンプレート・プロパティを定義するには、コンポーネントを選択し、プロパティ・シートまたは「書式」メニューをオープンし、オプションを選択します。


チャート・テンプレート・エディタについて

各図表には、チャート・テンプレート・エディタが1つのみ含まれます。1つの図表について複数のチャート・テンプレートを定義できますが、チャート・テンプレート・エディタで表示または変更できるのは1度に1つのみです。

チャート・テンプレート・エディタでも、レイアウト・エディタと同じく、右下角の分割バーをドラッグすることによって、複数のビューを設定できます。したがって、1つのビューにチャート・テンプレートを表示し、別のビューにそのフィールド・テンプレートを表示できます。

チャート・テンプレート・エディタには次のコンポーネントがあります。

枠エディタ

フィールド・テンプレート・エディタ

ツール・パレット


枠エディタについて

枠エディタは、チャート枠の要素を選択および変更する場合に使用します。枠では、プロットされるデータに関係なく、チャートの基本構造体が判断されます。エディタ内の枠の外観は、チャートが作成されたときにどのような外観になるかを表します。枠要素のフォント、カラーおよびその他の図形プロパティを変更し、その結果をすぐに画面で見ることができます。また、用例（存在している場合）を動かすには、用例ボックス（テキストではなく）を新しい位置にドラッグします。


フィールド・テンプレート・エディタについて

フィールド・テンプレート・エディタは、チャートのフィールド・テンプレートの要素を選択および変更する場合に使用します。フィールド・テンプレートでは、一連のデータをチャートにどのように表示するかを決定します。チャートを作成するときは、問合せで取り出した列を特定のフィールド・テンプレートと対応付ける必要があります。フィールド・テンプレートの図形プロパティにより、データがチャートにどのように表示されるかが決まります。


チャート・テンプレート・ツール・パレットについて

チャート・テンプレート・エディタのツール・パレットには、選択ツールばかりでなく、線/塗り/テキスト表示インジケータ、線カラー・パレット、塗りカラー・パレット（およびパターン・パレット）、テキスト・カラー・パレット、さらに記号パレットがあります。


チャート・テンプレートの選択について

ユーザーが最初にチャートを選択せずに、メニューから「ツール」 [image] 「テンプレート」コマンドを選択する場合、チャート・テンプレート・エディタが現行のチャート・テンプレートとともに表示されます。現行のチャート・テンプレートとは、チャート・テンプレート・エディタで最後に選択したチャート・テンプレートのことです。"現行の"チャート・テンプレートとして、デフォルトの異なるチャート・テンプレートか、カスタマイズされたチャート・テンプレートを選択できます。


チャート・テンプレートのカスタマイズについて

  関連項目

現行のチャート・テンプレートのチャート枠を編集する前に、次の変更をユーザーが検証できるように、チャート枠がチャート・テンプレート・エディタに表示されていることを確認します。

  チャート・テンプレート・エディタで、チャート枠を表示するために、「枠」ラジオ・ボタンを選択します。

チャート・テンプレートの枠および軸プロパティをカスタマイズする方法は、チャートの「枠」および「軸」プロパティをカスタマイズする方法と同じです。

参照メニュー・オプションおよびツール以下のセクションでは、チャート・テンプレート・エディタ内のメニュー・オプションおよびツールを使用します。

テンプレートの枠および軸プロパティのカスタマイズに加えて、さらにチャート・テンプレートで使用するフィールド・テンプレートを複数カスタマイズできます。


エクスポートしたチャート・テンプレートの管理について

チャート・テンプレートを作成しカスタマイズしたら、他の図表に利用するために、オブジェクト・ナビゲータおよびチャート・テンプレート・エディタで、ファイル・システムまたはデータベースへエクスポートできます。

また、前にエクスポートしたチャート・テンプレートを、オブジェクト・ナビゲータまたはチャート・テンプレート・エディタからインポートできます。


チャート・テンプレートの作成について

チャート・テンプレートを作成する方法

1	オブジェクト・ナビゲータでは、「テンプレート」ノードを選択した後、ツールバーの「作成」ボタンを選択します。

2	デフォルトのチャート型（列）を受け入れるか、「タイプ」メニューから代替チャートおよびサブタイプを選択します。

3	デフォルトのチャート・テンプレート名（templatex）を受け入れるか、または「テンプレート」 [image] 「改名」コマンドを選択して「改名テンプレート」ダイアログを表示し、名前を編集します。

4	チャートの枠および軸プロパティを希望どおりにカスタマイズします。

5	カスタマイズが終了したら、「ファイル」 [image] 「クローズ」コマンドを選択して、チャート・テンプレート・エディタをクローズします。

チャートを作成する前に、カスタマイズ済みのチャート・テンプレートを作成できます。チャート・テンプレートを作成し（カスタマイズし）た後、それを「チャート」プロパティ・シートの図表に割り当てるには、「テンプレート」ドロップダウン・リストから「テンプレート名」を選択します。

また、チャート・テンプレートを、他の図表で使用するために、ファイル・システムまたはデータベースにエクスポートできます。


デフォルト・チャート・テンプレートの選択

デフォルト・チャート・テンプレートを選択する方法

1	「ツール」 [image] 「テンプレート」コマンドを選択して、チャート・テンプレート・エディタを表示します。

2	使用するチャートの型（円グラフなど）を「タイプ」メニューから選択します。

3	該当のチャートの型のサブメニューに表示されているチャート・テンプレートを1つ選択します。

選択したデフォルト・チャート・テンプレートのチャート枠がチャート・テンプレート・エディタに表示されます。これは、別のチャート・テンプレートを作成または編集するまで、現行のチャート・テンプレートとなります。

4	「ファイル」 [image] 「クローズ」コマンドを選択して、チャート・テンプレート・エディタをクローズします。

このチャート型が、現行のチャート・テンプレートになります。メニューから「ツール」 [image] 「テンプレート」を選択すると、このチャート・テンプレートがチャート・テンプレート・エディタに表示されます。


カスタマイズしたチャート・テンプレートの選択

カスタマイズ済みのチャート・テンプレートを選択する方法

1	「ツール」 [image] 「テンプレート」コマンドを選択して、チャート・テンプレート・エディタを表示します。

2	チャート・テンプレート・エディタで、「テンプレート」ポップリストを選択して、カスタマイズ済みテンプレートのリストを表示します。

3	リストされているチャート・テンプレートの1つを選択して、それをチャート・テンプレート・エディタに表示します。

これは、別のチャート・テンプレートを作成または編集するまで、現行のチャート・テンプレートとなります。

4	「ファイル」 [image] 「クローズ」コマンドを選択して、チャート・テンプレート・エディタをクローズします。

このチャート型が、現行のチャート・テンプレートになります。メニューから「ツール」 [image] 「テンプレート」を選択すると、このチャート・テンプレートがチャート・テンプレート・エディタに表示されます。


チャート・テンプレートのインポート

チャート・テンプレートをインポートする方法

1	オブジェクト・ナビゲータの「テンプレート」ノードを選択するか、「ツール」 [image] 「テンプレート」コマンドを選択して、チャート・テンプレート・エディタを表示します。

2	「編集」 [image] 「インポート」 [image] 「テンプレート」コマンドを選択して、「インポート」ダイアログを表示します。

3	ファイル/モジュール名および位置を選択します。

4	現行の図表に特定のチャート・テンプレートをインポートするには、「OK」を選択します。


チャート・テンプレートのエクスポート

チャート・テンプレートをエクスポートする方法

1	ナビゲータのテンプレート・オブジェクトを選択するか、またはエクスポートするチャート・テンプレートをチャート・テンプレート・エディタの「テンプレート」ドロップダウン・リストから選択します。

2	「編集」 [image] 「エクスポート」 [image] 「テンプレート」コマンドを選択して、「エクスポート」ダイアログを表示します。

3	位置、ファイル/モジュール名などのエクスポート・オプションを選択します。

4	テンプレートをエクスポートし、「エクスポート」ダイアログをクローズするには、「OK」を選択します。


チャート・テンプレートの改名

オブジェクト・ナビゲータ内でチャート・テンプレートを改名する方法

1	改名するチャート・テンプレート・オブジェクトを選択します。

2	マウス・ポインタをチャート・テンプレート名の上に移動します。

カーソルがポインタからテキスト・エディタに変わります。

3	名前を1回選択すると、カーソルが位置付けされ、編集モードになります。

名前全体を置き換えるには、名前を選択してハイライト表示にし、新規名を入力します。

チャート・テンプレート・エディタでチャート・テンプレートを改名する方法

1	「テンプレート」ドロップダウン・リストから、改名するチャート・テンプレートを選択します。

選択したチャート・テンプレートがエディタ・レイアウトで表示されます。

2	「テンプレート」 [image] 「改名」コマンドを選択して、「改名テンプレート」ダイアログを表示します。

3	「テンプレート名」フィールドに新規テンプレート名を入力します。

4	新規名を適用しダイアログをクローズするには、「OK」を選択します。

注意: PL/SQLプログラム単位のいずれかで参照したチャート・テンプレートを改名する場合、これらの参照を変更して新規名を反映させる必要があります。


チャート・テンプレートの削除

オブジェクト・ナビゲータからチャート・テンプレートを削除する方法

1	ナビゲータのチャート・テンプレート・オブジェクトを選択します。

2	「削除」ボタンを選択するか、メニューから「ナビゲータ」 [image] 「削除」コマンドを選択します。

3	警告メッセージでは、確認の「はい」を選択します。

チャート・テンプレート・エディタからチャート・テンプレートを削除する方法は次のとおりです。

1	「テンプレート」ドロップダウン・リストから、削除するチャート・テンプレートを選択します。

2	「テンプレート」 [image] 「削除」コマンドを選択します。

警告が表示されて、削除を確認するように指示されます。

3	「Yes」を選択して確認します。

注意: PL/SQLプログラム単位のいずれかで参照したチャート・テンプレートを削除した場合、これらの参照を変更して削除を反映させる必要があります。


フィールド・テンプレートの作成、変更および割当てについて

値列フィールドに異なるプロパティを割り当てる場合、チャート・テンプレートに複数のフィールド・テンプレートを作成できます。各フィールド・テンプレートは、異なる値列フィールドに割り当てることも、複数の値列フィールドに割り当てることも、必要になるまで未使用のままにしておくこともできます。「フィールド」プロパティには、チャート・タイプにより表示形式、線の形式、ラベル回転などのオプションがインクルードされています。

フィールド・テンプレートを作成しカスタマイズしたら、それをチャートの値列に割り当てることができます。


フィールド・テンプレートへのカラーとパターンの適用について

カラーとパターンをフィールド・テンプレートに適用するための手順は、オブジェクトに適用するときと同じです。 しかし、レイアウト・エディタのカラー・パレットのかわりに、チャート・テンプレート・エディタのカラー・パレットを使用します。カラー・パレットは同じように動作します。


フィールド・テンプレートの追加

フィールド・テンプレートを追加する方法

1	ポップアップ・メニューから「フィールド・テンプレート」を選択するか、「テンプレート」 [image] 「フィールド ・テンプレート」コマンドを選択して、フィールド・テンプレート・プロパティ・シートを表示します。

2	「新規作成」を選択すると、新規フィールド・テンプレートが作成されます。このテンプレートには最初は"ftempx"という名前が付いています。

新規フィールド・テンプレートの名前を変えることも、デフォルトのままにしておくこともできます。

3	「軸フィールド」タブを選択して、軸チャート・フィールド・テンプレートのプロパティを設定します。

4	新規フィールド・テンプレートを適用し、「フィールド・テンプレート」ダイアログをクローズするには、「OK」を選択します。

フィールド・テンプレートをチャートに表示するには、そのフィールド・テンプレートを列値に対応付ける必要があります。


フィールド・テンプレートの編集

フィールド・テンプレートを編集する方法

1	現行のチャート・テンプレートのフィールド・テンプレートを編集する前に、次の変更をユーザーが検証できるように、フィールド・テンプレートがチャート・テンプレート・エディタに表示されていることを確認します。

2	チャート・テンプレート・エディタから「フィールド」テンプレート・ラジオ・ボタンを選択して、現行のフィールド・テンプレートを表示します。

3	ドロップダウン・リストから、編集するフィールド・テンプレートを選択します。


フィールド・テンプレートのプロパティの指定

フィールド・テンプレートのプロパティを指定する方法

1	チャートまたは単一チャート・オブジェクトを選択します。

2	ポップアップ・メニューから「フィールド・テンプレート」を選択するか、「チャート」 [image] 「フィールド ・テンプレート」コマンドを選択して、フィールド・テンプレート・プロパティ・シートを表示します。

3	「軸フィールド」タブを選択して、「軸フィールド」プロパティ・ページを表示します。

4	設定するオプションを指定します。

5	フィールド・テンプレートへの変更を適用し、「フィールド・テンプレート」のプロパティ・シートをクローズするには、「OK」を選択します。


フィールド・テンプレートの割当て

フィールド・テンプレートを割り当てる方法

1	レイアウト・エディタまたはオブジェクト・ナビゲータ内で、チャートを選択します。

2	ポップアップ・メニューから「プロパティ」を選択するか、「ツール」 [image] 「プロパティ」コマンドを選択して、チャートのプロパティ・シートを表示します。

3	チャートの値プロパティ・ページを表示するには、「値」タブを選択します。

4	「チャート値」リストから、フィールド・テンプレートを割り当てたい値列を選択します。

5	「フィールド・テンプレート」ドロップダウン・リストからフィールド・テンプレートを選択します。

6	変更を適用し、チャート・プロパティ・シートをクローズするには、「OK」を選択します。


フィールド・テンプレートの削除

フィールド・テンプレートを削除する方法

1	チャートまたは単一チャート・オブジェクトを選択します。

2	ポップアップ・メニューから「フィールド・テンプレート」を選択するか、「チャート」 [image] 「フィールド ・テンプレート」コマンドを選択して、フィールド・テンプレート・プロパティ・シートを表示します。

3	削除するフィールド・テンプレートを、「フィールド・テンプレート」ドロップダウン・リストから選択します。

4	「削除」を選択します。

警告が表示されて、削除を確認するように指示されます。

5	「Yes」を選択して確認します。

6	変更をアクセプトし、フィールド・テンプレート・プロパティ・シートをクローズするには、「OK」を選択します。

作成したチャートの値列が削除するフィールド・テンプレートと関連付けられている場合、削除する前に別のフィールド・テンプレートと関連付ける必要があります。


PL/SQLについて

PL/SQLはSQLを強化拡張したもので、ループ、条件、プロシージャなどの手続き型のプログラミング構造体を提供します。Graphics BuilderでPL/SQLを使用すると、図表の制御機能が向上し、現在のデータおよびエンド・ユーザー・アクション、実行時に存在するその他の条件に対する図表の応答機能も向上します。図表の中でPL/SQLを使用して、次の操作を行うことができます。

•	オブジェクトの作成と操作。たとえば、オブジェクトをアニメーション化して、レイアウト上で動いているように見せることができます。

•	操作の流れる順序の制御。たとえば、ユーザーがオブジェクトを選択すると指定したレイヤーが表示されるようにできます。

•	操作のタイミングの制御。たとえば、指定の時間間隔でアクションを起こすことができます。

•	操作を条件的に発生させる。たとえば、現在のデータ値を計算させ、結果に応じて異なるオブジェクトを表示させることができます。

•	エンド・ユーザーのアクションの定義および解釈。たとえば、ユーザーが無効な文を入力するとエラー・メッセージが表示されるようにすることができます。


名前重複の解決について

名前が重複しているPL/SQL構造体を参照した場合、Graphics Builderは以下の順序で検索を行います。

1	次の中では、事前に定義された順序はありません。

•	図表とともに保存されているローカル・プログラム単位

•	PL/SQL STANDARDビルトイン

•	Graphics Builderビルトイン

2	連結ライブラリ

3	ストアド・プログラム単位


座標およびサイズ情報の指定について

提供されているビルトイン構造体には、オブジェクトのレイアウト上の位置や寸法を指定した数値を参照したり、またはユーザーにそのような数値を提供させるものが多くあります。こうした値に対して使用する必要がある測定単位はレイアウト単位と呼ばれています。

レイアウト単位を使用するのは、それぞれ異なる表示解像度を備えた複数のディスプレイ・デバイスで実行されるGraphics Builderアプリケーションに首尾一貫した寸法体系を提供するためです。たとえば、72行/インチの画面解像度のデバイスでの1インチは、90行/インチの画面解像度のデバイスの場合とは異なります。対照的に、Graphics Builderのレイアウト解像度はすべてのシステムで同じです。すべての寸法をレイアウト単位で指定し、すべてのデバイスに一貫性が保たれます。

OG_INCHビルトイン・グローバル変数

Graphics Builderは、1インチのレイアウト単位数に等しい、OG_INCHというグローバル変数を提供しています。

たとえば、高さ3インチ、幅2インチの矩形の領域を定義するには、次のローカル変数を宣言します。

my_rect   OG_RECTANGLE;

次に、以下の文に示すようにグローバル変数OG_INCHを使用できます。

my_rect.height := 3 * OG_INCH;
   my_rect.width := 2 * OG_INCH;

リテラル値を設定せずに、アプリケーションのグローバル変数を使用することをお薦めします。Graphics Builderの現在のバージョンでも将来のバージョンでも図表を適正に表示させるには、サポートされているビルトイン・グローバル変数を使用するのが最良の方法です。


オブジェクト・ハンドルを使用したGraphics Builderオブジェクトの参照について

多くのビルトイン・サブプログラムでは、Graphics Builderオブジェクトに対して操作を実行することができます。たとえば、OG_EXECUTE_QUERYプロシージャを使用すると、問合せを実行することができます。これらのサブプログラムでは、操作の対象となるオブジェクトを指定する必要があります。

オブジェクトを名前で参照するかわりに、多くのビルトイン・プロシージャ、ファンクションおよびデータ型では、オブジェクトへのハンドル（ポインタ）を使用することが必要です。たとえば、問合せを実行するには、問合せのハンドルをOG_EXECUTE_QUERYに渡す必要があります。

PROCEDURE getdata IS
  query_handle  OG_QUERY;
BEGIN
  query_handle := OG_GET_QUERY('query0');
  OG_EXECUTE_QUERY(query_handle);
END;

オブジェクト・ハンドルの取得

Graphics Builderは、オブジェクトのハンドルを取得するためのビルトイン・ファンクションのセットを提供しています。各ファンクションからは、検索対象のハンドルのオブジェクト型に応じて、特定のデータ型の値が戻されます。

次の表に、取得できるハンドルのGraphics Builderオブジェクト、ハンドルを取得するために使用するファンクションおよび戻り値のデータ型を示します。

オブジェクト型	ファンクション	戻り値のデータ型

軸	OG_Get_Axis	OG_Axis
ボタン・プロシージャ	OG_GET_BUTTONPROC	OG_Buttonproc
チャート・テンプレート	OG_Get_Template	OG_Template
図表	OG_Get_Display	OG_Display
フィールド・テンプレート	OG_Get_Ftemp	OG_Ftemp
図形オブジェクト	OG_Get_Object	OG_Object
レイヤー	OG_Get_Layer	OG_Layer
問合せ	OG_GET_QUERY	OG_Query
参照線	OG_Get_Refline	OG_Refline
Sound	OG_Get_Sound	OG_Sound
タイマー	OG_Get_Timer	OG_Timer
ウィンドウ	OG_Get_Window	OG_Window
ハンドルを使用する理由

ハンドルは、効率を高めるために名前のかわりに使用するものです。名前で項目を参照すると、Graphics Builderでは、参照のたびに該当のタイプの既存項目をすべて検索して、指定の名前に一致する項目を見つけます。これでは時間がかかるので、上記にリストしたファンクションを使用して名前付き項目を検索します。該当項目が検索されると、その項目を直接指し示すハンドルが作成されます。ハンドルを使用することによって、Graphics Builderは項目を参照するたびに項目名を検索する手間を省いています。

ハンドルを"格納する"最良の方法は、変数を使用して行うことです。プログラム単位の始めに、変数の名前およびデータ型を付け与えることによって、任意の変数を宣言できます。

その後で、ファンクションから戻される値にその変数を割り当てます。前述の例では、変数"query_handle"がOG_QUERY組込みデータ型を持つものとして宣言されています。これは、ファンクションOG_GET_QUERYから戻されるデータ型です。

プロシージャの第1行で、query_handle変数がOG_GET_QUERYファンクションから戻される値に割り当てられます。これで、変数query_handleは、この変数に現在格納されている問合せ用のオブジェクト・ハンドルを必要とする場合に、このプログラム単位内のどこからでも参照できます。


プログラム単位について

プログラム単位はPL/SQLを使用して作成できるコード構造体です。Graphics Builderを使用してPL/SQLプログラム単位を記述するか、または独自のエディタを使用して作成したプログラム単位をインポートまたはエクスポートできます。

次の2種類のPL/SQLプログラム単位がGraphics Builderで使用できます。

•	サブプログラム

•	パッケージ

プログラム単位は、オブジェクト・ナビゲータから「PL/SQLプログラム単位」エディタを開いて編集できます。このエディタは、コードを記述したりデバッグする場合に使用します。


サブプログラムについて

サブプログラムはGraphics Builderで作成できるPL/SQLプロシージャおよびファンクションです。

プロシージャは指定されたアクションを順番に実行します。たとえば、あるプロシージャを実行すると、新規データに基づいてチャートが更新されます。Graphics Builderで作成できる2つの特殊タイプのプロシージャは、次のとおりです。

ボタン・プロシージャ	実行時に特定のマウス・イベント（マウス・ボタンを押す、放す、ボタンを押したままで、または押さずにマウスを移動させるなど）が発生したときに実行される、オブジェクトまたはレイヤーに対応付けられたプロシージャ。
トリガー・プロシージャ	トリガーが起動されたときに実行されるプロシージャ。トリガーとしては、図表のオープン、図表のクローズ、指定の時間間隔の経過、問合せの実行などがあります。
ファンクションは指定されたアクションを順番に実行して値を戻します。たとえば、あるファンクションを実行すると、ある品目に課せられる消費税が計算されて戻されます。Graphics Builderで作成できる特殊タイプのファンクションの1つに、問合せから戻された値をフィルタに通して指定の条件を満たす値のみを図表に表示する問合せフィルタ・ファンクションがあります。


パッケージについて

パッケージは、論理的に関連のあるPL/SQLプロシージャ、ファンクション、データ型、変数、定数、例外、カーソルおよびその他の構造体をグループ化します。パッケージに定義されている構造体は、パッケージ・ファンクションやパッケージ・プロシージャのように、一般的に"パッケージ～"と呼ばれます。パッケージPL/SQL構造体を参照する場合、各構造体の名前の前にパッケージ名とピリオド（.）を付ける必要があります。


図表へのプログラム単位のロードについて

プログラム単位が格納されているPL/SQLライブラリを連結するのではなく、個々のプログラム単位を図表にロードする場合があります。ライブラリを連結する場合に比べて、個々のプログラム単位をロードすることで特にパフォーマンス上の利点があるわけではありません。

次の基準を使用して、ライブラリを連結するかわりに個々のプログラム単位をロードするかどうかを判断してください。

•	ライブラリが非常に大きい場合、サイズ制限の問題が起こる可能性があります。

•	図表を移動すると、ライブラリを指しているすべてのパス名を変更する必要があります。

•	図表に必要なプログラム単位がわずかな場合、連結ライブラリを使用しないほうがメンテナンスが容易にできます。


PL/SQLビルトインについて

  関連項目

Graphics BuilderはPL/SQL言語に、Graphics Builderアプリケーションの動作のカスタマイズ専用に使用される拡張機能を提供しています。これらの構造体はビルトインと呼ばれ、標準PL/SQLパッケージの拡張機能としてインプリメントされています。

Graphics Builderには、次のタイプのビルトインがあります。

•	データ型

•	グローバル変数

•	サブプログラム

•	例外

Graphics Builderビルトインは、ユーザーが特定の機能をプログラムで制御できるように設計されているため、Graphics Builderの図表を定義するときのみ使用できます。

すべてのPL/SQLビルトインはプログラム単位の中で使用できますが、ビルトイン自体の編集はできません。


例外について

PL/SQLプログラム単位の成功や失敗を補足または分離するには、例外を使用します。たとえば、ユーザーが実行時に無効なアクションを実行するとエラーが表示されるようにできます。例外には、次の2通りあります。

ユーザー定義の例外	Graphics Builderでは、ユーザー独自の例外を宣言、呼出しおよび処理できます。例外に関する詳細は、『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください。
事前定義済みの例外	Graphics Builderの中で使用できるように、多数の例外が事前定義されています。事前定義済みの例外を実行するには、その例外ハンドラを書き込む必要があります。例外ハンドラは、PL/SQLプログラム単位の中で特定の条件または例外が発生したときに実行される文を定義したものです。例外状況が発生すると、通常の実行が停止され、制御が該当の例外ハンドラに渡されます。


プログラム単位の作成について

プログラム単位を作成する方法は次のとおりです。

1	アクションを実行するために必要なGraphics Builderビルトイン・プロシージャが何かを決めします。

2	そのプロシージャ名を調べて、必要な引数を判断します。

プロシージャ定義に応じて、ハンドル、または変数、絶対値の形で、プロシージャに引数を提供します。

3	必要な引数を取り出すために必要なGraphics Builderビルトイン・ファンクションがある場合は、それがどれかを判断します。

4	ファンクションから戻される値を格納するために定義する必要がある変数が何かを判断します。


プログラム単位の作成

  例

プログラム単位を作成する方法は次のとおりです。

1	オブジェクト・ナビゲータの「プログラム単位」を選択します。

2	「作成」ボタンをクリックするか、または「ナビゲータ」 [image] 「作成」を選択して、「新規プロプラム単位」ダイアログを表示します。

現在プログラム単位がまったく存在していない場合は、「プログラム単位」ノードをダブルクリックして、新規プログラム単位を作成します。

3	作成するプログラム単位のタイプを選択し、そのプログラム単位の名前を入力して、「OK」を選択します。

「PL/SQLプログラム単位」エディタが表示されます。「名前」フィールドには指定したプログラム単位名が表示されます。

4	プログラム単位を定義します。

5	「コンパイル」を選択してプログラム単位をコンパイルします。

6	エラーが検出された場合は、それらのエラーをすべて解決します。

プログラム単位を正常にコンパイルし図表で使用できるようにするには、プログラム単位にエラーがない状態にする必要があります。

7	作業が終了したら、「クローズ」を選択してプログラム単位エディタをクローズします。


例:プログラム単位の作成

図表内のレイヤーをアクティブ化するプログラム単位を作成する場合、Graphics Builder PL/SQLビルトイン・プロシージャOG_ACTIVATE_LAYERを使用します。このプロシージャには、Graphics Builderのビルトイン・データ型OG_LAYERの引数が必要です。このデータ型の値を得るには、ファンクションOG_GET_LAYERを使用し、このファンクションが戻す値を格納するためのOG_LAYER型の変数を宣言します。

前述の手順を逆にたどっていくと、次のようなプロシージャが作成されます。

PROCEDURE act_layer IS
/*Declare the variable to store the function return */
  the_layer  OG_LAYER;
BEGIN
/*Use the function to assign the variable's value */
  the_layer:=OG_GET_LAYER('layer1');
/*Use the variable value as an argument to the procedure */
  OG_ACTIVATE_LAYER(the_layer);
END;


プログラム単位の編集

PL/SQLプログラム単位を編集する方法は次のとおりです。

  編集対象のプログラム単位オブジェクトをダブルクリックするか、またはそのプログラム単位を選択してポップアップ・メニューの「プロパティ」をクリックします。プログラム単位のソースを含んだプログラム単位エディタが表示されます。

必要に応じてそのプログラム単位を編集します。コンパイル済みのプログラム単位を編集する場合は、変更した後で再コンパイルする必要があります。


個々のプログラム単位のコンパイル

個々のプログラム単位をコンパイルする方法は次のとおりです。

1	オブジェクト・ナビゲータ上でプログラム単位をダブルクリックして、プログラム単位エディタをオープンします。

別の方法として、「ツール」 [image] 「プログラム単位」を選択してプログラム単位エディタを表示し、「名前」ドロップダウン・リストからプログラム単位を選択します。

「プログラム単位」ステータス・バーに、プログラム単位が正常にコンパイルされたかどうかが表示されます。

2	「コンパイル」を選択してプログラム単位をコンパイルします。

エラーが検出された場合は、その報告が「プログラム単位」エディタのプログラム単位本体のすぐ下に表示されます。エラーをダブルクリックすると、プログラム単位本体内のそのエラーのソースへナビゲートできます。


プログラム単位のバッチ・コンパイル

プログラム単位をバッチ・コンパイルする方法は次のとおりです。

1	「ファイル(F)」 [image] 「コンパイル」を選択して図表内のコンパイルされていないプログラム単位をバッチ・コンパイルするか、または「ファイル(F)」 [image] 「すべてコンパイル」を選択して、図表内の全プログラム単位を（再）コンパイルします。「すべてコンパイル」を使用すると、すでにコンパイル済みのプログラム単位も強制的に再コンパイルされます。

「コンパイル」ダイアログが表示され、そこに進行状況インディケータと、検出されたコンパイル・エラーが記録されているスクロール可能なフィールドが表示されます。

2	コンパイル画面では、次のボタンを選択して対話できます。

•	割込み	コンパイルを一時的に停止できます。

•	再開	「割込み」操作の後にバッチ・コンパイルを再開できます。

•	OK	「コンパイル」ダイアログを確定しクローズできます。

•	取消し	バッチ・コンパイルを取り消します。

•	エラーへジャンプ	コンパイル・エラーを検索して、関連するプログラム単位をオープンします。

3	作業が終了したら、「OK」を選択して「コンパイル」ダイアログをクローズします。


プログラム単位の再コンパイル

コンパイル済みのPL/SQLコードは異なるシステム間で移植可能ではありません。したがって、異なるシステムで使用する図表を準備する場合は、そのシステムでソース・コードを再コンパイルする必要があります。

  「ファイル」- [image] 「すべてコンパイル」を選択して、図表内の全プログラム単位を（再）コンパイルします。


プログラム単位の改名

  関連項目

プログラム単位を改名する方法は次のとおりです。

1	プログラム単位オブジェクトをダブルクリックして、プログラム単位エディタを表示します。

2	プログラム単位を編集して、名前を変更します。

3	プログラム単位を再コンパイルします。

他のプログラム単位の中で参照されているプログラム単位の名前を変更した場合は、該当の参照箇所を編集して新しい名前を反映させる必要があります。改名したプログラム単位を再コンパイルすると、それを参照する他のプログラム単位はコンパイル済みの状態ではなくなり、オブジェクト・ナビゲータにアスタリスク（*）付きで表示されます。


図表へのプログラム単位のロード

プログラム単位を図表へロードする方法は次のとおりです。

  ライブラリのプログラム単位を選択して、図表の「プログラム単位」ノードの下にドラッグします。

マウス・ボタンを放すと、プログラム単位がその図表に自動的にコピーされます。名前も型も同じプログラム単位が図表内にすでに存在している場合は、既存のプログラム単位を上書きするかどうか確認する警告が表示されます。


PL/SQLプログラム単位の削除

  関連項目

オブジェクト・ナビゲータからプログラム単位を削除する方法は次のとおりです。

  プログラム単位オブジェクトを選択して「削除」ボタンを選択するか、または「ナビゲータ」 [image] 「削除」を選択します。「Yes」を選択して確認します。

プログラム単位エディタからプログラム単位を削除する方法は次のとおりです。

1	プログラム単位オブジェクトをダブルクリックするか、ポップアップ・メニューから「プログラム単位」を選択するか、または「ツール」 [image] 「プログラム単位」を選択してプログラム単位エディタを表示します。

2	必要な場合には、削除するプログラム単位を「名前」ドロップダウン・リストから選択します。

3	「削除」ボタンを選択してプログラム単位を削除します。

警告が表示されて、削除を確認するように指示されます。

4	「Yes」を選択して確認します。

5	「クローズ」を選択して、プログラム単位エディタをクローズします。

別のプログラム単位で参照されているプログラム単位を削除する場合は、参照を取り外して該当のプログラム単位を再コンパイルし、変更を反映させる必要があります。


一貫性のチェック

一貫性をチェックする方法は次のとおりです。

1	「ファイル」 [image] 「一貫性チェック」を選択して、「一貫性チェック」ダイアログを表示します。

矛盾のあるものはGraphics Builderで検索され、それがメッセージ表示フィールドに報告されます。

2	作業が終了したら、「OK」を選択して「一貫性チェック」ダイアログをクローズします。

図表の中でPL/SQLを使用した場合、プログラム単位とそのプログラム単位の参照との間に矛盾がないことを検証する必要のある場合があります。矛盾の一例としては、トリガー・プロシージャを参照しているのにそれを作成していない場合などがあります。


ライブラリについて

PL/SQLライブラリは、よく使用されるPL/SQLプログラム単位を後で使用できるように格納しておくための便利な方法です。

これらのライブラリは、Graphics Builderで作成できるPL/SQLプログラム単位の集まりで構成されています。図表とともに格納できる個々のプログラム単位と異なり、PL/SQLライブラリはデータベースまたはファイル・システムに格納され、複数のユーザーが複数の図表に使用できます。Graphics BuilderでPL/SQLライブラリを参照するには、オブジェクト・ナビゲータを使用してライブラリを図表に連結する必要があります。さらに、作成したライブラリへのアクセス権を他のユーザーに付与して、他のユーザーがそれらのライブラリを使用することもできます。

PL/SQLライブラリは、1つの図表の中で複数回参照することも、同じアプリケーション中の他のモジュールと共有することもできます。


ライブラリへのアクセス権の付与および取消しについて

自分で作成したPL/SQLライブラリか、またはそのライブラリへのアクセス権を付与されていれば、そのライブラリへのアクセス権を付与したり取り消したりすることができます。他のユーザーにアクセス権を付与することは、そのユーザーが別のユーザーにPL/SQLライブラリへのアクセス権を付与したり、そのPL/SQLライブラリを改名したり変更することを許すことになります。


ライブラリの作成

PL/SQLライブラリを作成する方法は次のとおりです。

1	オブジェクト・ナビゲータ内の「PL/SQLライブラリ」ノードを選択します。

2	「作成」ボタンをクリックするか、「ナビゲータ」 [image] 「作成」を選択します。

初期名がLIB_xxxの新規オープン・ライブラリが作成されます。

3	現在オープンされているライブラリがない場合は、ナビゲータ内の「PL/SQLライブラリ」ノードをダブルクリックして、新規ライブラリを作成します。

これでライブラリが作成されたので、既存の、または新規のプログラム単位を追加してこのライブラリ内に格納できます。


ライブラリのオープン

ライブラリをオープンする方法は次のとおりです。

1	「ファイル(F)」 [image] 「オープン」を選択して「フィルタ」ダイアログを表示します。

2	「図表」チェックボックスから「ライブラリ」または「すべてのファイル」をチェックします。

3	「オブジェクト・アクセス」ラジオ・グループで、ライブラリが格納されている場所に応じて、「データベース」ラジオ・ボタンまたは「ファイル・システム」ラジオ・ボタンを選択します。

4	「OK」を選択して選択内容を確認します。

ライブラリがファイル・システムに格納されている場合は、システムのファイル・ダイアログが表示されます。ライブラリがデータベースに格納されている場合は、「データベースからオープン」ダイアログが表示されます。

5	オープンするライブラリの名前を指定して、そのライブラリをオープンするためのダイアログを確定します。

ライブラリは.pllファイル拡張子によって、他のファイルから区別します。


オープン・ライブラリへの既存のプログラム単位の追加

オープン・ライブラリへ既存のプログラム単位を追加する方法は次のとおりです。

1	オブジェクト・ナビゲータ内で、変更するオープン・ライブラリのサブノードを拡張します。

2	追加するプログラム単位を「図表」ノードから選択します。

3	プログラム単位のアイコンを選択し、オープン・ライブラリの「プログラム単位」サブノードの下にドラッグします。

マウス・ボタンを放すと、プログラム単位がオープン・ライブラリに自動的にコピーされます。名前も型も同じプログラム単位がライブラリにすでに存在している場合は、元のプログラム単位への上書きの確認を求める警告が表示されます。


オープン・ライブラリへの新規プログラム単位の作成

ライブラリ内に新規プログラム単位を作成する方法は次のとおりです。

1	オブジェクト・ナビゲータ内で、オープン・ライブラリ・ノードの下の「プログラム単位」サブノードを選択します。

2	「作成」ボタンをクリックするか、「ナビゲータ」{ [image] 「作成」を選択して「新規プログラム単位」ダイアログを表示します。

現在ライブラリ内にプログラム単位が存在していない場合は、ナビゲータ内の「プログラム単位」サブノードをダブルクリックして、「新規プログラム単位」ダイアログを表示します。

3	新規プログラム単位に付ける名前を入力します。

4	新規プログラム単位のタイプを選択します。

5	「OK」を選択して、「新規プログラム単位」ダイアログをアクセプトし、プログラム単位エディタを表示します。

6	新規プログラム単位を定義します。

7	「コンパイル」を選択して新規プログラム単位をコンパイルします。

8	「クローズ」を選択して、プログラム単位エディタをクローズします。

作成した新規プログラム単位が、ライブラリの「プログラム単位」サブノードの下に表示されます。


オープン・ライブラリからのプログラム単位の削除

プログラム単位をライブラリから削除する方法は次のとおりです。

1	変更するライブラリのサブノードを拡張します。

2	ライブラリから削除するプログラム単位を選択します。

3	「削除」ボタンをクリックするか、または「ナビゲータ」 [image] 「削除」を選択します。

警告が表示されて、削除を確認するように指示されます。

4	「Yes」を選択して確認します。


ライブラリの保存

ライブラリを保存するには、

1	保存するライブラリを選択します。

2	「保存」をクリックするか、「ファイル(F)」 [image] 「保存」または「ファイル(F)」 [image] 「別名保存(A)」を選択して「ライブラリ保存」ダイアログを表示します。

「別名保存(A)」は初めて保存する場合にのみ使用するようにしてください。

3	ライブラリの名前、およびそのライブラリの保存先（ファイル・システムかデータベース）を指定します。

4	「OK」を選択してライブラリを保存します。

ファイル・システムに保存されたライブラリには、自動的にファイル拡張子.pllが付けられます。


図表へのライブラリの連結

ライブラリを図表に連結する方法は次のとおりです。

1	オブジェクト・ナビゲータ内の、「連結ライブラリ」ノード（図表ノード内部の）を選択します。

2	「作成」ボタンをクリックするか、「ナビゲータ」 [image] 「作成」を選択して「連結ライブラリ」ダイアログを表示します。

現在連結されているライブラリがない場合は、ナビゲータ内で「連結ライブラリ」ノードをダブルクリックして、「連結ライブラリ」ダイアログを表示します。

3	連結するライブラリの名前を入力します。

4	「連結(A)」を選択してライブラリを連結します。

ライブラリとともにパス名を指定すると（つまり、ライブラリが現在のディレクトリまたは作業ディレクトリに格納されていない場合）、パス名の削除を求められます。パス名を削除しない場合、Graphics Builderは指定されたパス名のみでライブラリを検索します。図表を分配する場合は、Graphics Builderではライブラリを検出できないことがあります。

パス名の削除を決定した場合は、Graphics Builderで、次の検索パスに従ってライブラリが検索されます。

•	ユーザーの現在のディレクトリまたは作業ディレクトリ

•	Graphics Builderパス環境変数によって指定されたディレクトリ

•	Oracleパス環境変数によって指定されたディレクトリ

特定のライブラリを図表に連結して、そのライブラリの内容を図表の中で使用できます。ライブラリを図表に連結して、ライブラリとその内容が（ランタイム）図表に伴うようにできます。連結ライブラリは静的ではなく、連結した時点ではライブラリの"スナップショット"ではありません。連結ライブラリは該当ライブラリへのリンクであり、ライブラリに対して行ったすべての更新を受け取ります。

オープンしているライブラリは連結できません。連結するライブラリが現在オープンされている場合は、クローズした後で連結してください。複数のライブラリを1つの図表に連結できます。


図表からのライブラリの連結解除

図表からライブラリの連結を解除する方法は次のとおりです。

1	オブジェクト・ナビゲータの「連結ライブラリ」ノードの下で、連結解除するライブラリを選択します。

2	「削除」ボタンをクリックするか、または「ナビゲータ」 [image] 「削除」を選択します。

連結解除の確認を求める警告が表示されます。

3	「OK」を選択してライブラリの連結を解除します。


ファイル・システム内のライブラリへのアクセス権の付与および取消し

ファイル・システム内のライブラリに対するアクセス権の付与および取消しをする方法は次のとおりです。

  オペレーティング・システムによっては、個々のファイルに対する読込み、書込みおよび実行権限のユーザーによる付与が許可されている場合があります。使用しているオペレーティング・システムでファイル権限を設定する方法の詳細は、そのオペレーティング・システムのマニュアルを参照するか、またはシステム管理者にお問合せください。


データベース内のライブラリへのアクセス権の付与および取消し

データベース内のライブラリに対するアクセス権の付与および取消しをする方法は次のとおりです。

1	「ファイル(F)」 [image] 「管理(I)」 [image] 「アクセス(A)」 [image] 「ライブラリ(L)」を選択して、「データベース上モジュールへのアクセス」ダイアログボックスを表示します。

このダイアログには、アクセスできるデータベースに格納されているすべてのライブラリのリストが含まれています。

2	リストからライブラリを選択します。

3	「OK」を選択して「モジュール・アクセス」ダイアログを表示します。

このダイアログには、ライブラリへのアクセス権を持っているユーザーのリストが含まれています。

4	アクセス権を付与するには、アクセス権を付与するユーザーのデータベース・ユーザー名を「ユーザー名」フィールドに入力します。

5	「追加(A)」を選択してアクセス・リストにユーザー名を追加します。

6	「アクセス・リスト」に含まれているユーザーからアクセス権を取り消すには、リストでユーザー名を選択します。

7	「削除(R)」を選択してアクセス・リストからユーザー名を削除します。

8	「OK」を選択して変更内容を確定し、「モジュール・アクセス」ダイアログをクローズします。

これで、ライブラリについてのアクセス権限が更新されます。自分で作成してデータベースに格納したライブラリに対する、別のユーザー・アクセス権（読込み/書込み/実行権限）も付与することができます。ただし、対象ユーザーもGraphics Builderデータベースの表に対するアクセス権を持っている必要があります。詳細は、データベース管理者にお問合せください。


ファイル・システムに格納されているライブラリの改名

ファイル・システム内のライブラリを改名する方法は次のとおりです。

  オペレーティング・システムを使用して、ファイル・システムに格納されているライブラリを改名することができます。ファイルを改名するには、適切なファイル許可を持っている必要があります。

ファイルの正しい改名方法については、使用しているオペレーティング・システムのマニュアルを参照してください。


データベース内に格納されているライブラリの改名

データベースに格納されているライブラリを改名する方法は次のとおりです。

1	「ツール」 [image] 「PL/SQLインタプリタ」を選択して、PL/SQLインタプリタを表示します。

2	次のように、インタプリタのコマンド・ラインでRENAMEコマンドを入力します。

PL/SQL> .RENAME LIB library_name1 TO library_name2

ライブラリが自分で作成したものではなく、データベースに格納されている場合、そのライブラリを改名するにはGRANT権限を持っている必要があります。ライブラリがファイル・システムに格納されている場合、そのライブラリを改名するには、適正なファイル許可を持っている必要があります。


ファイル・システムからのライブラリの削除

ファイル・システムからライブラリを削除する方法は次のとおりです。

  オペレーティング・システムを使用して、ファイルとして格納されているライブラリを削除することができます。ファイルを削除するには、適正なファイル許可を持っている必要があります。

ファイルを削除する正しい方法については、使用しているオペレーティング・システムのマニュアルを参照してください。


データベースからのライブラリの削除

データベースからライブラリを削除する方法は次のとおりです。

1	「ツール」 [image] 「PL/SQLインタプリタ」を選択して、PL/SQLインタプリタを表示します。

2	インタプリタのコマンド・ラインに、次のコマンドを入力します。

PL/SQL> .DELETE LIBRARY library_name;

library_nameは削除するライブラリの名前です。

3	PL/SQLインタプリタをクローズします。


トリガーの実行順序について

トリガーは実行時の特定の時点で起動されるPL/SQLプロシージャです。トリガーを使用して、ボタン、動的な"オンザフライ（作業中の）"チャートの書式設定、自動更新およびコミットなどの機能で図表の機能を強化することができます。Graphics Builderでは、図表に対応付けられたトリガー・プロシージャがすべて、特定の順序で実行されます。実行の順序を理解しておくと、図表を開発するときに役立ちます。

次の順序でイベントが発生します。

•	オープン・トリガーの起動

•	問合せの実行

•	チャートの更新

•	タイマーの実行

•	ボタンの実行

•	クローズ・トリガーの起動


オープン・トリガーの起動について

オープン・トリガーは名前によって示されている時点、すなわち図表が実行された（ランタイムにオープンされた）直後に起動します。オープン・トリガーは、最初に起動されるトリガーです。


問合せの実行について

  関連項目

問合せの実行中に、次の順序で以下のことが発生します。

1	問合せに対して 「オープンされている図表」オプションが設定されている場合、図表のオープン時に問合せが自動的に実行されます。デフォルトでは、このオプションがアクティブになっています。つまり、オープン・トリガーが起動された直後に、問合せが実行されるということです。

「オープンされている図表」オプションがアクティブになっていない場合、OG_EXECUTE_QUERYビルトイン・プロシージャがコールされるまで問合せは実行されません。

2	実行後トリガーがある場合は、問合せの実行直後にそのトリガーが起動されます。

3	問合せフィルタ・ファンクションがある場合は、実行後トリガーの起動直後にそのファンクションが実行されます。問合せフィルタは、取り出されたデータが問合せプロパティ・シートに表示されるのを妨げるためのものでなく、そのデータのどのサブセットをチャートに組み込むかを判別するためのものです。


チャートの更新について

  関連項目

チャートの更新には、次の順序で発生する以下のような関連イベントが含まれます。

1	チャートに対して「問合せ実行時にチャートを更新(U)」オプションが設定されている場合、問合せの実行に続いて自動的にチャートの更新が行われます。デフォルトでは、このオプションはアクティブになっています。つまり、問合せ実行プロシージャの実行の直後にチャートが更新されるということです。

「問合せ実行時にﾁｬｰﾄを更新(U)」がアクティブになっていない場合、OG_UPDATE_CHARTビルトイン・プロシージャがコールされるまでチャートは更新されません。

2	フォーマット・トリガーがある場合は、チャート更新の最終段階、つまりチャートの描画の直前に、そのトリガーが起動されます。

フォーマット・トリガーは、チャート要素のカラーなど、条件付きの書式設定プロパティを設定するために使用できます。


タイマー実行について

  関連項目

タイマーの実行には、次の順序で発生する以下のような関連イベントが含まれます。

1	問合せがタイマーに関連付けられている場合（問合せプロパティ・シートの「オプション」ページの「タイマー」オプションによって）、問合せはタイマーが時間切れになると自動的に実行されます。デフォルトでは、このオプションはアクティブになっていません。

しかし、「タイマー」がアクティブになっていると、 問合せの実行から派生してチャートの更新が行われることがあります。

2	タイマー・プロシージャは、タイマーの起動時に、問合せ実行と同時に実行されます。タイマー実行時に実行される問合せがない場合は、タイマー・プロシージャが発生するただ1つのイベントになります。

タイマーは、図表の実行時に自動的にアクティブにすることも、あるいは、Graphics Builder PL/SQLビルトイン・プロシージャOG_ACTIVATE_TIMERを使用してPL/SQLプログラム単位からプログラムによってアクティブにすることもできます。


ボタン実行について

  関連項目

ボタンの実行には、次の順序で発生する関連項目が含まれています。

1	ドリルダウン・リレーションシップでボタンとしての機能を持つチャート要素（円グラフの断片など）においてマウス・イベントが検出されると、Graphics Builderはそのチャート要素のプロパティ・シートのドリルダウン・ページに指定されている列およびパラメータを使用して、パラメータに列の値を割り当てます。

2	ドリルダウン・リレーションシップでボタンとしての機能を持つチャート要素（円グラフの断片など）においてマウス・イベントが検出されると、Graphics Builderはそのチャート要素のプロパティ・シートのドリルダウン・ページに指定されている詳細チャート問合せを実行します。

3	任意のボタン・オブジェクト上でマウス・イベントが検出されると、そのオブジェクトのボタン・プロシージャが（存在していれば）実行されます。

問合せ実行から派生して、チャート更新が実行されることがあります。


クローズ・トリガーの起動について

クローズ・トリガーは図表がクローズされる直前に起動されます。クローズ・トリガーは最後に起動されるトリガーです。


トリガーの参照について

各タイプのトリガーについて、オブジェクト・ナビゲータでは対応する割当て/参照ノードが表示されます。これらのノードは、プロシージャがある場合に、特定のトリガーにどのプロシージャが割り当てられているかを示します。

ナビゲータ内のプログラム単位オブジェクトを選択し、それをどれか1つのトリガー・ノードの下にドラッグすることによって、既存のプログラム単位をトリガーに割り当てることができます。マウスを放すと、プログラム単位名がトリガー・ノードとともに表示されます。

次の表に、どのトリガー・プロシージャ・ノードがナビゲータ内のどのオブジェクトに対応するかを示します。

トリガーのタイプ	ナビゲータ内のオブジェクト・ノード

オープン	図表
実行後	問合せ
フォーマット	チャート要素
タイマー	問合せ、タイマー
ボタン	オブジェクト、チャート要素、レイヤー等
クローズ	図表
トリガー・ノードの1つをダブルクリックしてプログラム単位エディタを使用することにより、いつでも、新規トリガー・プロシージャを作成したり、現在割り当てられているトリガー・プロシージャを編集したりできます。


オープン・トリガーの使用について

  関連項目

オープン・トリガーは図表が最初に実行されたときにPL/SQLプロシージャを実行します。たとえば、問合せを実行し、チャートを更新し、タイマーをアクティブにするなどによって図表の初期状態を設定するように、オープン・トリガーを定義できます。


オープン・トリガーの作成

  例	   関連項目

オープン・トリガーを作成する方法は次のとおりです。

1	ナビゲータ内のオープン・トリガー・オブジェクトをダブルクリックして、プログラム単位エディタを表示します。

プログラム単位エディタには、デフォルトのトリガー・プロシージャ・テンプレート（初期名はOGTRIGGERPROCx）が含まれています。

2	トリガー・プロシージャを改名するか、またはデフォルトのままにして、プロシージャの本体を入力します。

3	「コンパイル」を選択してプログラム単位をコンパイルします。

エラーが検出された場合は、そのエラーを訂正して再コンパイルします。

4	「クローズ」を選択して、プログラム単位エディタをクローズします。


例:オープン・トリガー

PROCEDURE open_disp IS
  old_layr  OG_LAYER;
  nu_layr   OG_LAYER;
  the_qry   OG_QUERY;
BEGIN
  old_layer:=OG_GET_LAYER('layer_home');
  nu_layer:=OG_GET_LAYER('layer_buttn');
  the_qry:=OG_GET_QUERY('query0');
  OG_ACTIVATE_LAYER(nu_layr);
  OG_HIDE_LAYER(old_layr);
  OG_EXECUTE_QUERY(the_qry);
END:


オープン・トリガー・プロシージャの参照の変更

オープン・トリガー・プロシージャ参照を変更する方法は次のとおりです。

1	「ツール」 [image] 「図表」を選択して、図表プロパティ・シートをオープンします。

2	「オープン・トリガー」ドロップダウン・リストから使用可能なトリガー・プロシージャを選択するか、または図表のオープン時に希望する動作がない場合は「なし」を選択します。

3	「OK」を選択して変更内容を適用し、図表プロパティ・シートをクローズします。

Graphics Builderでは、複数のトリガー・プロシージャを作成でき、図表の開発時にその中のどれでもオープン・トリガーに割り当てることができます。


実行後トリガーの使用について

  関連項目

実行後トリガーは問合せに関連付けられているPL/SQLプロシージャです。このトリガーは、関連の問合せが実行された直後に起動されます。


実行後トリガーの作成

  例

実行後トリガーを作成する方法は次のとおりです。

1	ナビゲータ内の問合せオブジェクトの下の「実行後トリガー」オブジェクトをダブルクリックします。

デフォルトのトリガー・プロシージャ・テンプレート（初期名はOGQUERYPROCx）を含んだ、プログラム単位エディタが表示されます。

2	トリガー・プロシージャを改名するか、またはデフォルトのままにして、プロシージャの本体を入力します。

3	「コンパイル」を選択してプログラム単位をコンパイルします。

エラーが検出された場合は、そのエラーを訂正して再コンパイルします。

4	「クローズ」を選択して、プログラム単位エディタをクローズします。


例:実行後トリガー

PROCEDURE post_exec IS
  the_timer  OG_TIMER;
BEGIN
  the_timer:=OG_GET_TIMER('check_stock');
  OG_ACTIVATE_TIMER(the_timer);
END:


実行後トリガーの参照の変更

実行後トリガーの参照を変更する方法は次のとおりです。

1	ナビゲータで問合せオブジェクトをダブルクリックするか、または問合せを選択して、ポップアップ・メニューから「プロパティ」コマンドを選択して、問合せプロパティ・シートを表示します。

別の方法として、「ツール」 [image] 「問合せ」を選択して現在の問合せに対する問合せプロパティ・シートを表示します。

2	「オプション」タブを選択して、オプション・プロパティ・ページを表示します。

3	「実行後トリガー」ドロップダウン・リストから使用可能な実行後トリガー・プロシージャを選択するか、または実行後動作を希望しない場合は「なし」を選択します。

4	「OK」を選択して変更内容を適用し、オブジェクト・プロパティ・シートをクローズします。

Graphics Builderでは、複数の実行後トリガー・プロシージャを作成でき、図表中のどの問合せにでもそれを簡単に割り当てることができます。


フォーマット・トリガーの使用について

  関連項目

フォーマット・トリガーはチャート要素に関連付けられているPL/SQLプロシージャです。フォーマット・トリガーは、要素の書式設定属性を動的に変更するために使用できるのでチャート要素の描画の直前に実行されます。たとえば、チャートのバーの値が一定値を超えていればチャートのバーを緑色にするようなフォーマット・トリガーを定義できます。


フォーマット・トリガーの作成

  例	  関連項目

フォーマット・トリガーを作成する方法は次のとおりです。

1	書式設定するチャート要素をダブルクリックするか、またはチャート要素を選択しポップアップ・メニューから「プロパティ」コマンドを選択して、チャート要素のオブジェクト・プロパティ・シートを表示します。

2	「フォーマット・トリガー」ドロップダウン・リストの右にある「作成」を選択します。

デフォルトのフォーマット・トリガー・プロシージャ・テンプレート（初期名はOGFORMATTRIGx）を含んだ、プログラム単位エディタが表示されます。

3	フォーマット・トリガー・プロシージャを改名するか、またはデフォルトのままにして、プロシージャの本体を入力します。

4	「コンパイル」を選択してプログラム単位をコンパイルします。

エラーが検出された場合は、そのエラーを訂正して再コンパイルします。

5	「クローズ」を選択して、プログラム単位エディタをクローズします。


例:フォーマット・トリガー

PROCEDURE format_point (elem IN og_object, query IN
og_query) IS
  st_price  NUMBER;
BEGIN
  st_price:=OG_GET_NUMCELL(query, OG_NEWDATA, 'sell_pr');
 IF st_price > 200 THEN
   OG_SET_BFCOLOR (elem, 'red');
 END IF;
END:


フォーマット・トリガーの参照の変更

フォーマット・トリガーの参照を変更する方法は次のとおりです。

1	チャート要素をダブルクリックするか、またはチャート要素を選択し、ポップアップ・メニューから「プロパティ」コマンドを選択して、チャート要素のオブジェクト・プロパティ・シートを表示します。

2	「フォーマット・トリガー」ドロップダウン・リストから使用可能なフォーマット・トリガー・プロシージャを選択するか、または特別な書式設定を希望しない場合は「なし」を選択します。

3	「OK」を選択して変更内容を適用し、オブジェクト・プロパティ・シートをクローズします。

Graphics Builderでは、複数のフォーマット・トリガー・プロシージャを作成して、どの有効なチャート要素のプロパティ・シートからでもそれらのプロシージャに簡単にアクセスすることができます。


タイマー・トリガーについて

  関連項目

タイマーは指定された時間間隔ごとにPL/SQLトリガー・プロシージャを実行します。たとえば、タイマーを毎分起動させ、チャート更新用のPL/SQLプロシージャを実行するように定義できます。


タイマー・トリガーの作成

  例	  関連項目

タイマー・トリガーを作成する方法は次のとおりです。

1	オブジェクト・ナビゲータ内の「タイマー」ノードを選択します。

2	「作成」ボタンをクリックするか、または「ナビゲータ」 [image] 「作成」を選択して、「タイマー・トリガー」ダイアログ・ボックスを表示します。

現在タイマーが存在していない場合は、ナビゲータ内の「タイマー」ノードをダブルクリックして、「タイマー・トリガー」ダイアログ・ボックスに新規のデフォルト・タイマーを表示します。このダイアログには、新規タイマー（初期名はタイマーx）のデフォルト設定が示されます。

別の方法として、「ツール」 [image] 「タイマー」を選択し、「作成(N)」を選択して新規タイマーを作成します。

3	新規プロシージャを作成する場合は、「プロシージャ」ドロップダウン・リストの右にある「編集(I)」を選択します。

デフォルトのトリガー・プロシージャ・テンプレート（初期名はOGTRIGGERPROCx）を含んだ、プログラム単位エディタが表示されます。

4	トリガー・プロシージャを改名するか、またはデフォルトのままにして、プロシージャの本体を入力します。

5	「コンパイル」を選択して新規プロシージャをコンパイルします。

6	「クローズ」を選択して、プログラム単位エディタをクローズし、「タイマー・トリガー」ダイアログに戻ります。

7	割り当てる既存のプログラム単位がある場合は、それを「プロシージャ」ドロップダウン・リストから選択します。

8	必要に応じてタイマーの名前と間隔を変更します。

「アクティブ」チェックボックスを使用して、タイマーが図表の実行時に自動的にアクティブになるのか（チェックする）、別のPL/SQLプログラム単位からアクティブにされるのか（チェックなし）を決定します。

また、Graphics Builder PL/SQLビルトイン・プロシージャOG_ACTIVATE_TIMERを使用して、別のプログラム単位からタイマーをアクティブにすることもできます。たとえば、ユーザーがランタイム図表でボタンを押したときにタイマーがアクティブになるようにもできます。


例:タイマー・トリガー

PROCEDURE check_stock IS
  the_query  OG_QUERY;
  the_chart  OG_OBJECT;
BEGIN
  the_query:=OG_GET_QUERY('stock_val');
  the_chart:=OG_GET_CHART('stock');
  OG_EXECUTE_QUERY(the_query);
  OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END:


タイマー・トリガー・プロシージャの参照の変更

タイマー・トリガーの参照を変更する方法は次のとおりです。

1	変更するタイマーをダブルクリックするか、または「ツール」 [image] 「タイマー」を選択して、「タイマー・トリガー」ダイアログ・ボックスを表示します。

2	「プロシージャ」ドロップダウン・リストから使用可能なプロシージャを選択するか、またはタイマーが時間切れになったときに何も動作を希望しない場合は「なし」を選択します。

3	「OK」を選択して変更内容を適用し、「タイマー・トリガー」ダイアログ・ボックスをクローズします。

この方法で、図表に格納されている任意のプロシージャを既存のタイマーに簡単に割り当てることができます。


ボタン・プロシージャについて

レイヤー、グラフィック・オブジェクト、チャート要素、記号、テキスト・オブジェクトなどの、Graphics Builder内で作成したオブジェクト、またはGraphics Builderにインポートしたオブジェクトは、すべてボタン・プロシージャに割り当てることができます。ボタン・プロシージャは、関連付けられたオブジェクトを持つ指定の"マウス・イベント"（たとえば、マウス・ボタンを押す）が検出されたときに実行されます。

ボタンおよびボタン・プロシージャについては、次の事項を特に考慮する必要があります。

•	マウス・イベント

•	イベント・アクティブ・オブジェクト

•	ボタン・プロシージャの指定

•	ボタン・プロシージャの作成

•	ボタン・プロシージャの参照の変更

ボタンは自動的に起動され、値は戻らないため、ボタン・ファンクションはサポートされていません。（簡潔さを保つため、ボタンについて説明している間は"オブジェクト"といえば、すべて"オブジェクトまたはレイヤー"を意味するものとします。


マウス・イベントについて

Graphics Builderは、以下のマウス・イベントを認識します。

イベント	説明

マウス・ボタンを押す	マウス・ボタンを押すと検出されます。
マウス・ボタンを放す	マウス・ボタンを放すと検出されます。
ボタンを押したまま、マウスを移動	ボタンを押したままでマウスを移動すると検出されます。
ボタンを放したまま、マウスを移動	ボタンを押さずにマウスを移動した場合に検出されます（レイヤーのみで検出可能）。


イベント・アクティブ・オブジェクトについて

「マウス・ボタンを押す」イベントはどのオブジェクトが"イベント・アクティブ"になるかを決定するため、最も重要なイベントです。イベント・アクティブ・オブジェクトは、次の「マウス・ボタンを押す」イベント（新しいイベント・アクティブ・オブジェクトを決定する）まで、「マウス・ボタンを押す」イベントとその後に続くすべてのイベントを"受け取り"ます。

関連するプロシージャを持ち、さらに少なくとも1つのマウス・イベントを受け取るように設定されているオブジェクトのみが、イベント・アクティブ・オブジェクトになる資格があります。（オブジェクトのプロシージャと希望のイベントは、「プロパティ」ダイアログまたはPL/SQLのいずれかを使用して設定することができます。）オブジェクトは、イベント・アクティブになるために「マウス・ボタンを押す」イベントを受け取るように設定する必要はないことに注意してください。

Graphics Builderで「マウス・ボタンを押す」イベントが検出されると、次の検索方針に従って前述の基準を満たす最初のオブジェクトが検索されます。

•	マウスが指している最上位のオブジェクト（アクティブ・レイヤーにおいて）

•	最上位のオブジェクトの親のグループ（子のいずれかが選択されたときに起動されるプロシージャをグループに割り当てることができますが、それは子に自分自身のプロシージャが割り当てられていないときに限られます。子に割り当てられているプロシージャの方が優先されます。

•	親の親、またその親というように、最上位のオブジェクトのグループ・ツリーをさかのぼる。

•	アクティブ・レイヤー

指定の基準を満たすオブジェクトのうち最初にGraphics Builderで検出されたオブジェクトが、イベント・アクティブ・オブジェクトになります。条件を満たすオブジェクトが検出されない場合は、「マウス・ボタンを押す」イベントは無視されます。レイアウト上で、オブジェクトが存在しない場所を選択することにより、アクティブ・レイヤーをイベント・アクティブにできることに注意してください。

イベント・アクティブ・オブジェクトを選択すると、そのオブジェクトが「マウス・ボタンを押す」イベントを受け取るように設定されているかどうかが、Graphics Builderによりチェックされます。そのように設定されていれば、そのオブジェクトは「マウス・ボタンを押す」イベントを受信してイベント・アクティブになり、プロシージャが実行されます。検出されたすべての後続イベントについて同じチェックがGraphics Builderで行われ、オブジェクトが受信可能な設定になっているイベントについてのみ、プロシージャが起動されます。

Graphics Builderが「マウス・ボタンを放す」イベントを検出すると、イベント・アクティブ・オブジェクトは"非アクティブにされます"。「マウス・ボタンを押す」イベントによって再びイベント・アクティブにならない限り、いかなるマウス・イベントも受け取らなくなります。

レイヤーについての特別の注意

レイヤーで受信されてもオブジェクトでは受信されないイベントが2つあります。「ボタンを押したまま、マウスを移動」と「ボタンを放したまま、マウスを移動」です。アクティブ・レイヤーに対応付けられたプロシージャがあり、どちらかのイベントを受信するように設定されていれば、イベント・アクティブになっているオブジェクトが他に何もないときには、アクティブ・レイヤーがイベントを受信します。


ボタン・プロシージャ仕様について

  例	  関連項目

ボタン・プロシージャには、正確に4つの特定な引数が指定されている必要があります。Graphics Builderでは、新規ボタン・プロシージャを作成するとき、次のデフォルト・プロシージャ仕様が提供されます。

PROCEDURE proc_name
  (buttonobj  IN  og_object,
   hitobj     IN  og_object,
   win        IN  og_window,
   eventinfo  IN  og_event) IS

パラメータの内容は次のとおりです。

proc_name	プロシージャ名。Graphics Builderから、プロシージャ用に一意のデフォルト名が提供されますが、変更してもかまいません。
buttonobj	イベント・アクティブ・オブジェクト（たとえば、このボタン・プロシージャが関連付けられているオブジェクト）へのハンドル。
hitobj	イベントが検出されたときマウスが指している、アクティブ・レイヤーの最上位のオブジェクトへのハンドル。選択されたオブジェクトがボタン・プロシージャを持つグループの子である場合、これはbuttonobjとは異なっている場合があります。その場合は、buttonobjがグループ・オブジェクトであり、hitobjが子になります。
win	イベント・アクティブ・オブジェクトがイベント・アクティブになっているウィンドウへのハンドル。
eventinfo	このプロシージャを起動したマウス・イベントに関する情報を含むレコード。このフィールドは、Graphics Builderビルトイン・データ型OG_EVENTのフィールドです。
ボタン・プロシージャのeventinfo引数を使用して、プロシージャが異なるイベントに対して異なるアクションを実行するように設定することができます。ボタン・プロシージャは、それが受け取るように設定されている任意のイベントにより起動されることに注意してください。プロシージャのアクションに何も条件が設定されていない場合、特定の条件に限定されていないすべての文が実行されます。


例:ボタン・プロシージャ -- オブジェクトの移動

以下のボタン・プロシージャは、「マウス・ボタンを押す」イベントを受け取るとボタン・オブジェクトを右下に2インチ移動し、次に「マウス・ボタンを放す」イベントを受け取ると（マウスの位置を中心に）そのオブジェクトを45度回転します。ボタン・オブジェクトも「マウス・ボタンを押す」イベントを受け取るように設定されている可能性があり、したがってそれらのイベントによってプロシージャが起動されるとしても、このプロシージャは単にそれらを無視することに注意してください。

PROCEDURE move_and_rotate(buttonobj IN og_object, hitobj IN og_object, win IN og_window, eventinfo IN og_event) IS
  move_offset  OG_POINT;
BEGIN
  IF eventinfo.event_type=OG_MOUSE_DOWN THEN
    move_offset.x := 2 * OG_INCH;
    move_offset.y := 2 * OG_INCH;
    OG_MOVE(buttonobj, move_offset);
  ELSIF eventinfo.event_type=OG_MOUSE_UP THEN
    OG_ROTATE(buttonobj, eventinfo.mouse_position, 45);
  END IF;
END;


ボタン・プロシージャの作成

  例

ボタン・プロシージャを作成する方法は次のとおりです。

1	オブジェクトをダブルクリックするか、またはオブジェクトを選択し、「ツール」 [image] 「プロパティ」を選択してオブジェクト・プロパティ・シートを表示します。

2	オブジェクトに名前が付いていない場合は、「名前」フィールドに名前を入力します。

3	「プロシージャ」ドロップダウン・リストの右にある「作成(N)」を選択します。

デフォルトのボタン・プロシージャ・テンプレート（初期名はOGBUTTONPROCx）を含んだ、プログラム単位エディタが表示されます。

4	ボタン・プロシージャを改名するか、またはデフォルトを受け入れて、プロシージャの本体を入力します。

5	「コンパイル」を選択してプログラム単位をコンパイルします。

エラーが検出された場合は、そのエラーを訂正して再コンパイルします。

6	「クローズ」を選択して、プログラム単位エディタをクローズします。


例:ボタン・プロシージャ -- タイマーの停止

PROCEDURE stop_plot (buttonobj IN og_object, hitobj IN
og_object, win IN og_object) IS
  the_timer  OG_TIMER;
BEGIN
  the_timer:=og_get_timer('stockchk');
  OG_DEACTIVATE_TIMER(the_timer);
END;


ボタン・プロシージャの参照の変更

ボタン・プロシージャの参照を変更する方法は次のとおりです。

1	オブジェクトをダブルクリックするか、またはオブジェクトを選択し、「ツール」 [image] 「プロパティ」を選択してオブジェクト・プロパティ・シートを表示します。

2	「プロシージャ」ドロップダウン・リストから使用可能なボタン・プロシージャを選択するか、またはボタン動作が必要でない場合は「なし」を選択します。

3	「OK」を選択して変更内容を適用し、オブジェクト・プロパティ・シートをクローズします。

Graphics Builderを使用すると、複数のボタン・プロシージャを作成し、図表の開発中にどのオブジェクトのプロパティ・シートからでも簡単にそれらのボタン・プロシージャにアクセスすることができます。


クローズ・トリガーの使用について

  関連項目

クローズ・トリガーは実行時に図表がクローズされるとPL/SQLプロシージャを実行します。たとえば、図表を印刷するクローズ・トリガー、またはデータベースへの変更をコミットするクローズ・トリガーを定義できます。

ただし、図表はクローズ・トリガー・プロシージャの実行が完了するまでは実際にクローズされません。


クローズ・トリガーの作成

  例	  関連項目

クローズ・トリガーを作成する方法は次のとおりです。

1	オブジェクト・ナビゲータで、「クローズ・トリガー」アイコンをダブルクリックするか、または「ツール」 [image] 「図表」を選択して、図表プロパティ・シートを表示します。

2	「クローズ・トリガー」ドロップダウン・リストの右にある「編集(I)」を選択します

デフォルトのトリガー・プロシージャ・テンプレート（初期名はOGTRIGGERPROCx）を含んだ、プログラム単位エディタが表示されます。

3	プロシージャを改名するか、またはデフォルトのままにして、プロシージャの本体を入力します。

4	「コンパイル」を選択してプログラム単位をコンパイルします。

エラーが検出された場合は、そのエラーを訂正して再コンパイルします。

5	「クローズ」を選択して、プログラム単位エディタをクローズします。


例:クローズ・トリガー

PROCEDURE close_disp IS
  the_sound  OG_SOUND;
BEGIN
  the_sound:=OG_GET_SOUND('playme');
  OG_PLAY_SOUND(the_sound);
END;


クローズ・トリガー・プロシージャの参照の変更

クローズ・トリガーの参照を変更する方法は次のとおりです。

1	「ツール」 [image] 「図表」を選択して、図表プロパティ・シートを表示します。

2	「クローズ・トリガー」ドロップダウン・リストから使用可能なトリガー・プロシージャを選択するか、または図表のクローズ時に何も動作を希望しない場合は「なし」を選択します。

3	「OK」を選択して変更内容を適用し、図表プロパティ・シートをクローズします。

Graphics Builderでは、複数のトリガー・プロシージャを作成でき、そのうちの1つを図表の開発時にクローズ・トリガーとして割り当てることが簡単にできます。


問合せについて

問合せは表示用のデータを取り出すためのSQL SELECT文またはファイルです。ほとんどの場合、問合せはチャートのデータを取り出すのに使用しますが、プログラム内で問合せを実行して、そのデータを使用してオブジェクトを作成したり、修正することもできます。

チャートの作成時に問合せも作成するか、改めて作成するかにかかわらず、各問合せには一意で内容が分かりやすい名前を付けることをお薦めします。作成した問合せには、Graphics Builderによってquerynというデフォルト名が与えられます。内容のわかる名前を割り当てると、オブジェクト・ナビゲータ内で問合せを検索したり、チャートの作成時にドロップダウン・リストから問合せを取り出すときに、見つけやすくなります。


データソースへの接続

データ・ソースに接続する方法は次のとおりです。

1	「ファイル」 [image] 「接続」を選択して「接続」ダイアログ・ボックスを表示します。

問合せを実行するには、その前にそのデータ・ソースに接続する必要があります。その後で、SQL SELECT文を作成して、データを取り出します。

2	ユーザー名とパスワードを入力します。（パスワードは、入力しても表示されません。）使用するユーザー名とパスワードがわからない場合は、データ・ソース管理者にお問い合せください。

リモート・データ・ソースに接続するとき以外は、「データ・ソース」フィールドを空白のままにしておきます。リモート・データ・ソースに接続する場合は、SQL*Net通信プロトコル、データ・ソース・ノード、データベース名をコロンで区切って入力する必要があります。次に例を示します。

t:boston:payroll

または、ODBCデータ・ソースの場合には、次のように入力します。

ODBC:boston:payroll

すべての接続に対し、デフォルトのデータ・ソース接続文字列を指定できます。

1	「接続」を選択してログオンします。

データベース・ソースへのログオンに成功すると、「接続」ダイアログ・ボックスがクローズされます。エラー・メッセージが表示された場合、データ・ソース管理者に問い合せて、ログオンIDとデータ・ソースが正しく指定されていることを確認してください。


問合せの作成について

Graphics Builderでは、次のオプションを使用して問合せを作成することができます。

SQL SELECT文を作成する

ファイルを問合せとして指定する

チャート作成時に問合せを作成する

PL/SQLを使用して問合せを作成する

どの方法を使用するかは、データをどのような形式で持っているかによって異なります。データ・ソースがデータベースの場合は、SQL SELECT文を使用します。データ・ソースがスプレッドシートなどのファイルの場合は、そのファイル全体を問合せとして指定します。さらに、SQL文およびPL/SQLコードの組合せを使用してカスタム問合せを作成できます。

問合せを実行すると、指定したデータ列とその行とのセットがGraphics Builderで取り出され、問合せプロパティ・シートの「データ」プロパティ・ページに配置されます。「データ」プロパティ・ページには、常に現在の問合せから取り出されたデータが含まれています。チャートを作成するときは、特に指定しない限り、Graphics Builderでは現在の問合せからのデータが使用されます。


外部SQL問合せの使用について

ファイルに既存のSQL問合せが格納されている場合、次のいずれかのオプションが使用できます。

•	外部SQL問合せの参照

•	外部SQL問合せのインポート

SQL SELECT文についての詳細、およびそれらをテキスト・ファイルに格納する方法の詳細は、『Oracle7 Server SQL言語リファレンス』を参照してください。


SQL SELECT文の作成

SQL SELECT文による問合せの作成方法は次のとおりです。

1	オブジェクト・ナビゲータで「問合せ」ノードを選択し、「作成」を選択するか、「ナビゲータ」 [image] 「作成」を選択して、問合せプロパティ・シートを表示します。

問合せが現在存在していない場合は、ナビゲータ内で「問合せ」ノードをダブルクリックして、問合せプロパティ・シートを表示します。

別の方法として、「ツール」 [image] 「問合せ」を選択してプロパティ・シートを表示し、「問合せが存在しません。作成しますか?」という問いに「Yes」ボタンを選択して新しく問合せを作成します。

デフォルト名はqueryxで、xはインスタンス番号を表し、現在のセッション中に新しい問合せが作成されるたびに1つずつ数が大きくなっていきます。

2	デフォルト名を使用するか、または「名前」フィールドに新しく名前を入力します。

3	「SQL文」フィールドにSQL SELECT文を入力します。

SQL SELECT文の詳細は、『Oracle7 Server SQL言語リファレンス』を参照してください。

4	「実行」を選択して問合せを実行します。

「データ」プロパティ・ページにデータが表示されます。

5	「OK」または「クローズ」を選択して、問合せプロパティ・シートをクローズします。

新規データが「データ」プロパティ・ページに表示されます。

問合せを事前に作成し、チャートを後になって作成する場合は、この方法を使用してください。問合せプロパティ・シートを使用すると、同時に複数の問合せを作成できます。


問合せとしてのファイルの指定

ファイルを問合せとして指定する方法は次のとおりです。

1	オブジェクト・ナビゲータで「問合せ」ノードを選択し、「作成」を選択するか、「ナビゲータ」 [image] 「作成」を選択して、問合せプロパティ・シートを表示します。

問合せが現在存在していない場合は、ナビゲータ内で「問合せ」ノードをダブルクリックして、問合せプロパティ・シートを表示します。

別の方法として、「ツール」 [image] 「問合せ」を選択してプロパティ・シートを表示し、「問合せが存在しません。作成しますか?」という問いに「Yes」ボタンを選択して新しく問合せを作成します。

デフォルト名はqueryxで、xはインスタンス番号を表し、現在のセッション中に新しい問合せが作成されるたびに1つずつ数が大きくなっていきます。

2	デフォルト名を使用するか、または「名前」フィールドに新しく名前を入力します。

3	「タイプ」ドロップダウン・リストからファイル・タイプを選択します。

4	「参照」を選択して、システムのファイル・ダイアログを表示します。

5	有効なファイルを選択し、ダイアログ・ボックスをアクセプトします。

ディレクトリ・パスおよびファイル名が、Graphics Builderにより「ファイル」フィールドに表示されます。

ファイルに日付が含まれている場合、ファイル問合せの日付書式の設定を参照してください。

6	「実行」を選択して問合せを実行します。

「データ」プロパティ・ページにデータが表示されます。

7	「OK」または「クローズ」を選択して、問合せプロパティ・シートをクローズします。

新規データが「データ」プロパティ・ページに表示されます。

問合せとして使用できるファイル形式は、SYLK、WKSまたはPRNです。


PL/SQLを使用した問合せの作成

  関連項目

PL/SQLを使用して問合せを作成する方法は次のとおりです。

  パラメータとGraphics Builder PL/SQLビルトインを使用して、プログラム内で問合せを作成して実行します。たとえば、パラメータを使用してプログラム内でWHERE句を問合せ用に設定する場合があります。この場合はCHAR型のパラメータ（the_param）に対する字句参照を組み込んだ問合せ（query0）を作成します。

次のプロシージャでは、提供された引数に基づいてパラメータの値が設定された後で問合せが実行され、関連のチャートが更新されます。

PROCEDURE add_param (the_name IN VARCHAR2) IS
  query  OG_QUERY;
  the_chart  OG_OBJECT;
BEGIN
  :the_param:='WHERE ename = '|| the_name;
  query:=OG_GET_QUERY('query0');
  OG_EXECUTE_QUERY(query);
  the_chart:=OG_GET_CHART('name_chart');
  OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END;

別の方法として、OG_MAKE_QUERYファンクションを使用してプログラム内で問合せ全体を作成できます。次に例を示します。

FUNCTION make_ch RETURN og_query IS
BEGIN
  query:=OG_MAKE_QUERY(OG_SQL_QTYPE, 'select ename,
sal from emp');
END;

この例のファンクションで一度問合せを作成しておくと、結果として得られた問合せを実行してチャートを作成することができます。


外部SQL問合せの参照

  関連項目

外部SQL問合せの参照方法は次のとおりです。

1	オブジェクト・ナビゲータで「問合せ」ノードを選択し、「作成」を選択するか、「ナビゲータ」 [image] 「作成」を選択して、問合せプロパティ・シートを表示します。

問合せが現在存在していない場合は、ナビゲータ内で「問合せ」ノードをダブルクリックして、問合せプロパティ・シートを表示します。

別の方法として、「ツール」 [image] 「問合せ」を選択してプロパティ・シートを表示し、「問合せが存在しません。作成しますか?」という問いに「Yes」ボタンを選択して新しく問合せを作成します。

2	「タイプ」ドロップダウン・リストから「外部SQLファイル」を選択します。

「ファイル」フィールドおよび「参照」ボタンがアクティブになります。

3	「ファイル」フィールドにSQLファイルの名前と場所を入力するか、「参照」ボタンを選択してオペレーティング・システムのファイル・ダイアログを表示します。

4	参照するSQLファイルを選択し、ファイル・ダイアログをアクセプトしてクローズします。

Graphics Builderにより、パス位置がそのファイルに格納されます。

5	「実行」を選択して、外部ファイルの問合せを実行します。

6	「実行」を選択して問合せを再実行します。

Graphics Builderで外部問合せファイルを参照したときは、問合せが図表に組み込まれるのでなく、そのファイルへのリンクが提供されます。問合せを編集しない場合、またはそれを図表に組み込まない場合は、この方法を使用します。

図表を実行時に配布する場合は、Graphics Builderで検索して実行できるように、外部問合せファイルも配布する必要があります。


外部SQL問合せのインポート

外部SQL問合せをインポートする方法は次のとおりです。

1	オブジェクト・ナビゲータで「問合せ」ノードを選択し、「作成」を選択するか、「ナビゲータ」 [image] 「作成」を選択して、問合せプロパティ・シートを表示します。

問合せが現在存在していない場合は、ナビゲータ内で「問合せ」ノードをダブルクリックして、問合せプロパティ・シートを表示します。

別の方法として、「ツール」 [image] 「問合せ」を選択してプロパティ・シートを表示し、「問合せが存在しません。作成しますか?」という問いに「Yes」ボタンを選択して新しく問合せを作成します。

2	「SQL文」フィールドのカーソルを選択します。

3	「SQLインポート」を選択して、システムのファイル・ダイアログを表示します。

4	SQL SELECT文を含むテキスト・ファイルを選択して、ダイアログ・ボックスをアクセプトします。

Graphics Builderによって、ファイルに格納されているSQL文が「SQL文」フィールドにインポートされます。

5	「実行」を選択してインポートされた問合せを実行します。

6	「OK」を選択してダイアログをクローズします。

問合せをインポートすると、その問合せを必要なときに編集できます。


テキスト・ファイルへの問合せのエクスポート

問合せをテキスト・ファイルにエクスポートする方法は、次のとおりです。

1	変更する問合せオブジェクトをダブルクリックするか、またはオブジェクト・ナビゲータで問合せオブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択します。

別の方法として、「ツール」 [image] 「問合せ」を選択して現在の問合せに対する問合せプロパティ・シートを表示します。

2	必要に応じて、「問合せ」ドロップダウン・リストから代替の問合せを選択します。

3	「SQL文」フィールドのカーソルを選択します。

4	「SQLエクスポート」を選択してシステムのファイル・ダイアログを表示します

5	SQL文を入れたいテキスト・ファイルを選択して、ダイアログ・ボックスをアクセプトします。

6	「実行」を選択して問合せを再実行します。

Graphics Builderにより、SQL文が指定したファイルにエクスポートされます。

Graphics BuilderでSQL問合せを作成した後は、その問合せをテキスト・ファイルにエクスポートして他のOracle製品で使用できます。オブジェクト・ナビゲータ内で問合せを1つの図表から別の図表にドラッグすることによって、問合せをGraphics Builder内部で再使用することができます。


カスタム問合せの作成について

カスタム問合せを使用して列を作成し、PL/SQLのみ、またはSQLとPL/SQLの組合せを使用して、作成した列にデータを挿入することができます。

問合せの列への挿入には、カスタム実行プロシージャまたは外部ソースを使用します。カスタム問合せを作成しておくと、チャートの作成時に参照することができます。


外部ソースを使用した問合せ列の挿入について

Graphics BuilderのチャートをForm BuilderやReport Builder（Reports Developerに組み込まれています）などの他のOracle製品に組み込んだ場合、チャートの作成に使用された問合せ列とコール側の製品の問合せで使用している列とが一致している限り、そのチャートはコール側の製品の問合せからのデータを使用します。

作成しているチャートが他のOracle製品からのみコールされる場合、カスタム問合せを使用して"空白の"チャートを作成できます。このチャートは、他の製品から起動されると、データが挿入されます。カスタム問合せのスキーマ・プロパティ・ページを使用して、コール側の製品で使用される問合せと同じ名前で列を作成します。次に、カテゴリや値のデータなどを割り当てて、通常のようにチャートのプロパティを定義します。

このチャートは、データが入っていない状態のレイアウトで表示されます。

Graphics Builderの図表が他の製品からコールされた場合、コール側の製品の問合せがカスタム問合せの代用として使用され、列名が同じであるため、チャートがユーザーの仕様に合せて描画されます。

この場合、データを列に挿入するためのカスタム実行プロシージャを作成する必要はありません。


カスタム問合せ列の作成

カスタム問合せ列の作成方法は次のとおりです。

1	オブジェクト・ナビゲータで「問合せ」ノードを選択し、「作成」を選択するか、「ナビゲータ」 [image] 「作成」を選択して、問合せプロパティ・シートを表示します。

問合せが現在存在していない場合は、ナビゲータ内で「問合せ」ノードをダブルクリックして、問合せプロパティ・シートを表示します。

別の方法として、「ツール」 [image] 「問合せ」を選択してプロパティ・シートを表示し、「問合せが存在しません。作成しますか?」という問いに「Yes」ボタンを選択して新しく問合せを作成します。

デフォルト名はqueryxで、xはインスタンス番号を表し、現在のセッション中に新しい問合せが作成されるたびに1つずつ数が大きくなっていきます。

2	デフォルト名を使用するか、または「名前」フィールドに新しく名前を入力します。

3	「タイプ」ドロップダウン・リストから「カスタム」を選択します。

4	「スキーマ」タブを選択し、スキーマ・プロパティ・ページを表示します。

5	「新規列」を選択して列を作成します。

6	名前、タイプおよびその他の設定を適宜変更します。

グラフ化する列のすべてについて、作成を続けます。

7	カスタム実行プロシージャを作成し、列にデータを挿入するか、または「クローズ」を選択して問合せプロパティ・シートをクローズします。


カスタム実行プロシージャを使用した問合せ列の挿入

  例

カスタム実行プロシージャの作成方法は次のとおりです。

1	変更する（カスタム）問合せオブジェクトをダブルクリックするか、またはオブジェクト・ナビゲータで問合せオブジェクトを選択して、ポップアップ・メニューから「プロパティ」コマンドを選択します。

別の方法として、「ツール」 [image] 「問合せ」を選択して現在の問合せに対する問合せプロパティ・シートを表示します。

2	必要に応じて、「問合せ」ドロップダウン・リストから代替の問合せを選択します。

3	「オプション」タブを選択して、オプション・プロパティ・ページを表示します。

4	ドロップダウン・リストから既存のカスタム実行トリガーを選択するか、または「新規作成」ボタンを選択して新しいカスタム実行プロシージャを作成します。

「プログラム単位」エディタが、テンプレートOGQUERYPROC0プロシージャとともに表示されます。

5	テンプレート・プロシージャを編集して、カスタム列にデータを挿入します。

OG_SET_xxxCELLおよびOG_APPEND_ROW PL/SQLビルトイン・プロシージャを使用します。

6	「OK」を選択して変更内容を適用し、問合せプロパティ・シートをクローズします。

図表を保存して実行するか、「チャート」 [image] 「チャート作成」を選択して、カスタム実行プロシージャをテストすることができます。


例: カスタム問合せプロシージャの使用

カスタム実行プロシージャの例を次に示します。このプロシージャでは、「スキーマ」プロパティ・ページで3つの列が作成されています。Name列はCHAR型、Salary列はNUMBER型、Hired列はDATE型です。

Graphics Builderはバッファ行またはテーブルの仮想行を維持します。OG_SET_xxxCELLを使用してこの仮想行にデータを挿入し、OG_APPEND_ROWを使用して仮想行を表に付加します。仮想行は1行しかないので、表に対し1度しか挿入できないことにご注意ください。

PROCEDURE fill_columns (query IN og_query)IS

/* Set the data for the first row */
  OG_SET_CHARCELL(query, 'Name', 'Smith');
  OG_SET_NUMCELL(query, 'Salary', '50000');
  OG_SET_DATECELL(query, 'Hired', '12-NOV-88');

/* Append the row of data to the table*/
  OG_APPEND_ROW(query);

/* Set the data for the next row*/
  OG_SET_CHARCELL(query, 'Name', 'Jones');
  OG_SET_NUMCELL(query, 'Salary', '55000');
  OG_SET_DATECELL(query, 'Hired', '19-APR-92');

/* Append the row of data to the table*/
  OG_APPEND_ROW(query);

END;


オブジェクト・ナビゲータを使用した問合せのアクセス

オブジェクト・ナビゲータで問合せにアクセスする方法は、次のとおりです。

1	ナビゲータで問合せオブジェクトをダブルクリックし、その問合せに対する問合せプロパティ・シートを表示するか、または問合せオブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択します。

2	問合せプロパティ・シートをオープンしておくと、「問合せ」ドロップダウン・リストから他の変更対象の問合せを選択することができます。


メニューを使用した問合せへのアクセス

メニューで問合せにアクセスする方法は次のとおりです。

1	「ツール」 [image] 「問合せ」を選択して、問合せプロパティ・シートを表示します。

2	「問合せ」ドロップダウン・リストから問合せを選択します。

希望のアクションを実行します。

この方法で、現在の問合せ用の「問合せ」プロパティ・シートがオープンされます。オープンしたら、「問合せ」ドロップダウン・リストから別の問合せを選択できます。現在の問合せとは、問合せプロパティ・シートで最も新しく作成または変更した問合せです。


問合せの変更

問合せを変更する方法は次のとおりです。

1	変更しようとする問合せオブジェクトをダブルクリックするか、またはナビゲータで問合せオブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択します。

別の方法として、「ツール」 [image] 「問合せ」を選択して現在の問合せに対する問合せプロパティ・シートを表示します。

2	必要に応じて、「問合せ」ドロップダウン・リストから代替の問合せを選択します。

3	以下のように問合せを編集します。

   問合せがSQL SELECT文の場合、「SQL文」フィールドでSQL SELECT文を編集します。

  問合せがファイルに基づいている場合、システムのファイル・ダイアログ・ボックスが表示されます。ファイルを選択して、ダイアログ・ボックスを確定してください。そして、必要に応じてファイルを編集します。

4	「実行」を選択して問合せを再実行します。

そして、必要に応じてファイルを編集します。

5	「実行」を選択して問合せを再実行します。

新規データが「データ」プロパティ・ページに表示されます。


オブジェクト・ナビゲータを使用した問合せの変更

オブジェクト・ナビゲータで問合せを変更するには次のようにします。

  問合せオブジェクトを選択し、オブジェクト・ナビゲータで「作成」や「削除」などのボタンの1つを選択するか、「ナビゲータ」メニューからオプションを選択します。


オブジェクト・ナビゲータでの問合せの改名

オブジェクト・ナビゲータで問合せを改名する方法は次のとおりです。

1	改名する問合せオブジェクトを選択します。

2	名前を1回選択すると、カーソルが位置付けされ、編集モードになります。

名前全体を置き換えるには、名前を選択して反転表示にし、新規名を入力します。

オブジェクト・ナビゲータ内で1つ以上の問合せを直接迅速に改名するには、この方法を使用します。改名する前に問合せの内容を表示するには、後で説明するメニューによる方法を使用してください。

3	問合せがPL/SQLプログラム単位またはドリルダウン関係で参照されている場合は、新しい問合せ名を反映するようにすべての参照を変更します。


問合せプロパティ・シートでの問合せの改名

問合せプロパティ・シートで問合せを改名する方法は次のとおりです。

1	変更する問合せオブジェクトをダブルクリックするか、またはオブジェクト・ナビゲータで問合せオブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択します。

別の方法として、「ツール」 [image] 「問合せ」を選択して現在の問合せに対する問合せプロパティ・シートを表示します。

2	必要に応じて、「問合せ」ドロップダウン・リストから代替の問合せを選択します。

3	「名前」フィールドに問合せの新しい名前を入力します。

4	「OK」を選択して新しい名前を適用し、問合せプロパティ・シートをクローズします。

改名の前に問合せの内容を表示するには、この方法を使用します。

5	問合せがPL/SQLプログラム単位またはドリルダウン関係で参照されている場合は、新しい問合せ名を反映するようにすべての参照を変更します。


ファイル問合せの日付書式の設定

ファイル問合せの日付書式を設定する方法は次のとおりです。

1	変更する問合せオブジェクトをダブルクリックするか、またはオブジェクト・ナビゲータで問合せオブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択します。

別の方法として、「ツール」 [image] 「問合せ」を選択して現在の問合せに対する問合せプロパティ・シートを表示します。

2	必要に応じて、「問合せ」ドロップダウン・リストから代替の問合せを選択します。

3	「オプション」タブを選択して、オプション・プロパティ・ページを表示します。

4	「日付書式」フィールドに日付書式を入力するか、「リスト」を選択して、「日付書式」ダイアログ・ボックスから既存の書式を選択します。

有効な書式に関する詳細は、『Oracle7 Server SQL言語リファレンス』を参照してください。

5	「OK」を選択してダイアログ・ボックスを確定し、問合せプロパティ・シートに戻ります。

6	「実行」を選択して問合せを再実行し、データを新しい書式で表示します。

日付が含まれているファイル（SYLK、WKSまたはPRN）の問合せで、Graphics Builderが日付データを文字としてでなく日付として認識されるようにするには、問合せプロパティ・シートで日付書式を指定する必要があります。

日付書式は、問合せプロパティ・シートの「データ」プロパティ・ページの日付データにのみ適用されます。チャートに適用する場合は、「レイアウト」エディタまたは「チャート・テンプレート」エディタで日付書式を設定します。


問合せの実行について

問合せは次の方法で実行できます。

•	図表のオープン時に自動的に実行

•	特定の時間間隔を空けて実行

•	PL/SQLを使用して実行


チャート・データのフィルタリングについて

チャートに表示するデータを制限する場合、通常は問合せにWHERE句を指定して（たとえば、"WHERE DEPTNO = :DNO")、データにフィルタを設定します。ただし、この方法では、各チャートに、専用の他と重複しない問合せを割り当ててあることが必要です。さらに、チャートが更新されるたびに問合せを再実行すると、チャートのパフォーマンスにも悪影響が出てしまいます。

この問題を避けるには、チャートに問合せフィルタを作成します。問合せフィルタは、チャートに表示するデータの量を制限するPL/SQLファンクションです。各チャートに専用の問合せフィルタを割り当てることができるため、（1回しか実行されない）単一の問合せによって、複数のチャートで使用するデータを提供することができます。

問合せフィルタ・ファンクションでは、問合せの各行が読み取られ、ユーザーが設定した条件に従って、そのデータ行が評価されます。その際、条件を満たす各行が表示されます。条件を満たさない各行は表示されませんが、「問合せ」プロパティ・シートの「データ」プロパティ・ページの中には残っています。


問合せフィルタの作成

  関連項目	  例

問合せフィルタを作成する方法は次のとおりです。

1	問合せデータに対してどのような条件を設定するかを決めます。

列の最大限度を設定する、複数列の値を比較する、許認データの特定範囲を選択する、などの条件を決めます。

2	チャートをダブルクリックしてチャート・プロパティ・シートを表示します。

3	「データ」タブを選択して、データ・プロパティ・ページを表示します。

4	「フィルタ機能」ドロップダウン・リストの右側に表示される「編集」ボタンを選択します。

デフォルトのフィルタ機能テンプレート（初期名はOGQUERYFILTER0）を含む、PL/SQLプログラム単位エディタが表示されます。

問合せで使用される1つ以上の列に対し条件を設定する必要があります。

5	フィルタ条件を定義します。

6	プログラム単位エディタで「コンパイル」を選択して問合せフィルタをコンパイルします。

エラーを見つけたら、それを訂正し、再コンパイルしてください。問合せフィルタは、正常にコンパイルにしてからでなければ使用できません。

7	「クローズ」を選択して、プログラム単位エディタをクローズします。

8	「OK」を選択して「チャート」プロパティ・シートをクローズします。

「チャート」 [image] 「チャート更新」を選択すると、チャートに対する問合せフィルタ機能の結果を確認できます。

問合せでは、表の中のすべての行を検索しますが、問合せフィルタで、特定の行だけがチャートに組み込まれるようにできます。

PL/SQLを使用した条件の設定に関する詳細は、『PL/SQLユーザーズ・ガイドおよびリファレンス』の「構造体の制御」を参照してください。


問合せフィルタ機能の使用

  関連項目

問合せフィルタ機能を使用する方法は次のとおりです。

1	問合せフィルタを付け加えたいチャートをダブルクリックするか、または（レイアウト・エディタかオブジェクト・ナビゲータで）選択して、ポップアップ・メニューから「プロパティ」コマンドを選択します。

別の方法として、「ツール」 [image] 「プロパティ」を選択して、チャート・プロパティ・シートを表示します。

2	「データ」タブを選択して、データ・プロパティ・ページを表示します。

3	「フィルタ機能」ドロップダウン・リストから既存の問合せフィルタ機能を選択するか、または「編集」を選択して新しい問合せフィルタを作成します。

4	変更を適用し、チャート・プロパティ・シートをクローズするには、「OK」を選択します。

「チャート」 [image] 「チャート更新」を選択すると、問合せフィルタ機能をテストすることができます。

Graphics Builderを使用すると、1つで複数のチャートに割り当てることができる問合せを作成できます。チャートの問合せフィルタ・ファンクションを作成することにより、チャートに表示するデータを制限でき（たとえば5000を超えるすべての給与など）、問合せを再実行する必要がありません。

また、同じデータベースを使用する複数のチャートを作成する場合、汎用問合せを1つ作成し、問合せフィルタを使用して表示するデータを判別することもできます。この場合、問合せフィルタはWHERE句と同じ機能を実行しますが、フィルタでデータがクライアント側に配分されるため、サーバーに対して1つの問合せを実行するのみという、パフォーマンス上の利点が加わります。


図表オープン時の問合せの実行

図表のオープン時に問合せを実行する方法は次のとおりです。

1	変更する問合せオブジェクトをダブルクリックするか、またはオブジェクト・ナビゲータで問合せオブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択します。

別の方法として、「ツール」 [image] 「問合せ」を選択して現在の問合せに対する問合せプロパティ・シートを表示します。

2	必要に応じて、「問合せ」ドロップダウン・リストから代替の問合せを選択します。

3	「オプション」タブを選択して、オプション・プロパティ・ページを表示します。

4	「オープンされている図表の実行」チェックボックスを選択して、図表オープン時の実行機能をアクティブにします。


特定の時間間隔での問合せの実行

特定の時間間隔で問合せを実行するには、次のようにします。

1	変更する問合せオブジェクトをダブルクリックするか、またはオブジェクト・ナビゲータで問合せオブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択します。

別の方法として、「ツール」 [image] 「問合せ」を選択して現在の問合せに対する問合せプロパティ・シートを表示します。

2	必要に応じて、「問合せ」ドロップダウン・リストから代替の問合せを選択します。

3	「オプション」タブを選択して、オプション・プロパティ・ページを表示します。

4	「タイマー」チェックボックスを選択してタイマーに基づいて実行機能をアクティブにします。

5	ドロップダウン・リストから既存のタイマーを選択するか、または「編集」を選択して新規にタイマーを作成します。


PL/SQLを使用した問合せの実行

  関連項目

PL/SQLを使用して問合せを実行する方法は次のとおりです。

  PL/SQLビルトイン・サブプログラムOG_EXECUTE_QUERYおよびOG_UPDATE_CHARTを使用します。

以下の例では、指定された問合せを実行し、関連するチャートを更新しています。

PROCEDURE every_30_secs IS
   query   OG_QUERY;
   the_chart   OG_OBJECT;
BEGIN
   query:=OG_GET_QUERY('emp_query');
   the_chart:=OG_GET_OBJECT('emp_chart');
   OG_EXECUTE_QUERY(query);
   OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END;


オブジェクト・ナビゲータでの問合せの削除

オブジェクト・ナビゲータで問合せを削除する方法は次のとおりです。

1	削除する問合せオブジェクトを選択します。

2	オブジェクト・ナビゲータで「削除」を選択するか、または「ナビゲータ」 [image] 「削除」を選択します。

警告が表示されて、削除を確認するように指示されます。

3	「Yes」を選択して確認します。

オブジェクト・ナビゲータにリストされている1つ以上の問合せをすばやく削除するには、この方法を使用します。削除する前に問合せを表示するには、後述の問合せプロパティ・シートによる方法を使用してください。


問合せプロパティ・シートでの問合せの削除

問合せプロパティ・シートで問合せを削除する方法は次のとおりです。

1	変更する問合せオブジェクトをダブルクリックするか、またはオブジェクト・ナビゲータで問合せオブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択します。

別の方法として、「ツール」 [image] 「問合せ」を選択して現在の問合せに対する問合せプロパティ・シートを表示します。

2	必要に応じて、「問合せ」ドロップダウン・リストから代替の問合せを選択します。

3	「削除」を選択します。

警告が表示されて、削除を確認するように指示されます。

4	「Yes」を選択して確認します。

削除する前に問合せの内容を表示するには、この方法を使用します。


レイヤーの改名について

  関連項目

レイヤーは次の2箇所で改名できます。

•	「レイヤー設定」ダイアログボックス

•	オブジェクト・ナビゲータ

PL/SQLプログラム単位で参照しているレイヤーを改名する場合は、すべての参照を変更して新規名を反映させる必要があります。


レイヤーのアクティブ化

レイヤーをアクティブにする方法は次のとおりです。

1	ナビゲータでレイヤー・オブジェクトをダブルクリックし、「レイヤー設定」ダイアログを表示します。

別の方法として、ナビゲータでレイヤー・オブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択するか、またはメニューから「ツール」 [image] 「プロパティ」を選択します。

2	「すでにあるレイヤー」リストからレイヤーを選択します。

3	「アクティブ化(A)」を選択します。

選択したレイヤーが「アクティブ・レイヤー」フィールドにリストされます。前の設定でレイヤーが隠されていた場合は、表示状態になります。

4	変更を確定し、「レイヤー設定」ダイアログをクローズするには、「OK」を選択します。

レイヤーを操作するには、まずアクティブ・レイヤーにする必要があります。一度に1つのレイヤーしかアクティブにすることができません。


PL/SQLを使用したレイヤーのアクティブ化

  関連項目

PL/SQLを使用してレイヤーをアクティブにする方法は次のとおりです。

  PL/SQLビルトイン・サブプログラムOG_ACTIVATE_LAYERを使用します。

次の例では、指定したウィンドウの指定レイヤーをアクティブにします。

PROCEDURE activate_a_layer(layer_num IN NUMBER, the_window
 IN og_window) IS
   layer_name   VARCHAR2(6);
   the_layer    OG_LAYER;
BEGIN
   layer_name:='layer'||TO_CHAR(layer_num);
   the_layer:=OG_GET_LAYER(layer_name);
   OG_ACTIVATE_LAYER(the_layer, the_window);
END;


「レイヤー設定」ダイアログでのレイヤーの改名

「レイヤー設定」ダイアログでレイヤーを改名する方法は次のとおりです。

1	ナビゲータでレイヤー・オブジェクトをダブルクリックし、「レイヤー設定」ダイアログを表示します。

別の方法として、ナビゲータでレイヤー・オブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択するか、またはメニューから「ツール」 [image] 「プロパティ」を選択します。

2	「すでにあるレイヤー」リストからレイヤーを選択します。

選択したレイヤーが「新規名」フィールドに表示されます。

3	「改名」フィールドにレイヤーの新規名を入力します。

4	「改名」を選択します。

「すでにあるレイヤー」リストで、新規名が表示されます。

5	変更を確定し、「レイヤー設定」ダイアログをクローズするには、「OK」を選択します。


オブジェクト・ナビゲータでのレイヤーの改名

オブジェクト・ナビゲータでレイヤーを改名する方法は次のとおりです。

1	改名するレイヤー・オブジェクトを選択します。

2	マウス・ポインタをレイヤー名に置きます。カーソルがポインタからテキスト・エディタに変わります。

3	名前を1回選択すると、カーソルが位置付けされ、編集モードになります。名前全体を置き換えるには、名前を選択して反転表示にし、新規名を入力します。


レイヤーを隠す/表示する

レイヤーを表示または隠す方法は次のとおりです。

1	ナビゲータでレイヤー・オブジェクトをダブルクリックし、「レイヤー設定」ダイアログを表示します。

別の方法として、ナビゲータでレイヤー・オブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択するか、またはメニューから「ツール」 [image] 「プロパティ」を選択します。

2	「すでにあるレイヤー」リストからレイヤーを選択します。

3	「隠す/表示」を選択します。

   レイヤーが隠されていた場合は、レイヤーの前にプラス(+)記号が表示され、今度は表示されていることを示します。

  レイヤーが表示されていた場合は、レイヤーの前にマイナス(-)記号が表示され、今度は隠されていることを示します。

  アクティブなレイヤー以外は表示されているどのレイヤーも隠すことができます。現在アクティブになっているレイヤーを隠すには、その前に、別のレイヤーをアクティブにする必要があります。

4	変更を確定し、「レイヤー設定」ダイアログをクローズするには、「OK」を選択します。

レイヤーはいくつでも、隠したり表示したりできます。アクティブ・レイヤーを非表示にすることはできません。現在アクティブになっているレイヤーを隠すには、その前に別のレイヤーをアクティブにする必要があります。


PL/SQLを使用してレイヤーを隠す/表示する

  関連項目

PL/SQLを使用して、レイヤーを表示したり隠したりする方法は次のとおりです。

  PL/SQLビルトイン・サブプログラムOG_HIDE_LAYERおよびOG_SHOW_LAYERを使用します。

最初の例では指定したレイヤーを隠し、2番目の例では指定したレイヤーを表示します。

PROCEDURE make_layer1_invis(the_window) IS
   my_layer   OG_LAYER;
BEGIN
   my_layer:=OG_GET_LAYER('layer1');
   OG_HIDE_LAYER(my_layer, the_window);
END;

PROCEDURE make_layer_visible(the_window) IS
   my_layer   OG_LAYER;
BEGIN
   my_layer:=OG_GET_LAYER('layer1');
   OG_SHOW_LAYER(my_layer, the_window);
END;


レイヤーの並べ替え

レイヤーの順序を変更する方法は次のとおりです。

1	ナビゲータでレイヤー・オブジェクトをダブルクリックし、「レイヤー設定」ダイアログを表示します。

別の方法として、ナビゲータでレイヤー・オブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択するか、またはメニューから「ツール」 [image] 「プロパティ」を選択します。

2	「すでにあるレイヤー」リストから順序を変更するレイヤーを選択します。

3	「上へ」（レイヤーの位置を上へ移動する）、「下へ」（レイヤーの位置を下へ移動する）「一番上へ」（スタックの一番上へ移動する）または「一番下へ」（スタックの一番下へ移動する）の各ボタンのいずれかを選択します。

これでレイヤーがスタック内の新しい位置に移動します。

4	変更を確定し、「レイヤー設定」ダイアログをクローズするには、「OK」を選択します。


レイヤーの削除

レイヤーを削除する方法は次のとおりです。

1	ナビゲータでレイヤー・オブジェクトをダブルクリックし、「レイヤー設定」ダイアログを表示します。

別の方法として、ナビゲータでレイヤー・オブジェクトを選択し、ポップアップ・メニューから「プロパティ」コマンドを選択するか、またはメニューから「ツール」 [image] 「プロパティ」を選択します。

2	「すでにあるレイヤー」リストから削除するレイヤーを選択します。

3	「削除」を選択します。

4	警告が表示されたら「Yes」を選択して確認します。

該当のレイヤーが「すでにあるレイヤー」リストから削除されます。

5	「OK」を選択して変更内容を確認し、「レイヤー設定」ダイアログをクローズします。

該当のレイヤーとそのオブジェクトが図表から削除されます。隠されているか表示されているかにかかわらず、アクティブでないレイヤーならどれでも削除できます。レイヤーを削除すると、そのレイヤー上のすべてのオブジェクトも削除されます。アクティブ・レイヤーは削除できません。アクティブ・レイヤーを削除するには、その前に別のレイヤーをアクティブにする必要があります。


ユーザー・イグジットについて

ユーザー・イグジットは、ユーザーが書いてGraphics Builder実行可能ファイルにリンクするプログラムです。ユーザー・イグジットを使用すると、Graphics Builderから3GLプログラムをコールすることができます。Graphics Builderから、ユーザー作成プログラムに制御を渡し、なんらかの機能を実行した後でGraphics Builderに制御を戻すようにする場合に、ユーザー・イグジットを作成してください。

ユーザー・イグジットでは、次のタスクを実行できます。

•	オペレーティング・システムのテキスト・ファイルからGraphics Builderへのデータの引き渡し

•	LONG RAWデータの操作

•	PL/SQLブロックのサポート

•	プリンタなどのリアル・タイム・デバイスの制御

ユーザー・イグジットは、数学的処理などのような他のタスクにも使用できます。ただし、そのような処理はPL/SQLを使用してGraphics Builder内で実行することをお薦めします。なぜなら、PL/SQLには移植性があるのに対して、ユーザー・イグジットにはそれがないからです。

注意:すべてのタイプのユーザー・イグジットで、前述のタスクのすべてが実行できるわけではありません。これらのタスクのほとんどは、Oracleプリコンパイラ・ユーザー・イグジットで実現できます。


Oracleプリコンパイラ・ユーザー・イグジットについて

Oracleプリコンパイラ・ユーザー・イグジットはOracleプリコンパイラ・インタフェースを組み込んでいます。このインタフェースを使用して、ホスト言語(Ada、C、COBOL、FORTRAN、Pascal、PL/l)でサブルーチンを書き、SQLコマンドを組み込むことができます。このユーザー・イグジットから、Oracle(ビルトインSQLコマンドを使用して)およびGraphics Builderのパラメータにアクセスできます。

これらの機能があるので、ほとんどのユーザー・イグジットはOracleプリコンパイラ・ユーザー・イグジットとして作成できます。ORACLEプリコンパイラ・インタフェースに関する詳細は、『Oracleプリコンパイラ・プログラマーズ・ガイド』を参照してください。

Oracleプリコンパイラ・インタフェースとOCIを組み合せたユーザー・イグジットも作成できます。

注意:すべてのオペレーティング・システムで、前述の言語のすべてがサポートされるわけではありません。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。


OCI（Oracleコール・インタフェース）ユーザー・イグジットについて

OCIユーザー・イグジットはOracleコール・インタフェースを組み込んでいます。このインタフェースを使用して、Oracleのコールを含むサブルーチンを書き込むことができます。

OCIのみを組み込んだ(Oracleプリコンパイラ・インタフェースを組み込んでいない)ユーザー・イグジットでは、Graphics Builderのパラメータにはアクセスできません。OCIに関する詳細は、『Oracleコール・インタフェース・プログラマーズ・ガイド』を参照してください。

Oracleプリコンパイラ・インタフェースとOCIを組み合せたユーザー・イグジットも作成できます。


非Oracleユーザー・イグジットについて

Oracle以外のユーザー・イグジットには、Oracleプリコンパイラ・インタフェースもOCIも組み込まれていません。たとえば、Oracle以外のユーザー・イグジットは完全にCのみで書くことができますが、Oracle以外のユーザー・イグジットは、OracleまたはGraphics Builderのパラメータにアクセスできません。


ユーザー・イグジットの書込みについて

  関連項目

Oracleプリコンパイラ・ユーザー・イグジットの書込み方法の基本ステップについて説明します。（最も頻繁に使用するタイプのユーザー・イグジットはOracleプリコンパイラ・ユーザー・イグジットなので、この項は特にOracleプリコンパイラ・ユーザー・イグジットを対象とします。Oracleプリコンパイラ・ユーザー・イグジットは、Graphics Builderの変数、パラメータおよびOracleデータベースのデータにアクセスできます。ほとんどのタスクについてこのユーザーイグジットを使用することをお薦めします。

ユーザー・イグジットを書き込むには、次の情報が必要です。

•	サポートされているファンクション(Graphics Builderによる引数の取得および引き渡しの方法と、ユーザー・イグジットからエラーを発生させる方法を含む)

•	引き渡されたユーザー・イグジット・コールの構文（すなわち、ユーザー・イグジット・プログラムがコールを受け取ったときどのように表示されるか）

注意: ここでは、ユーザー・イグジットの書込みやインプリメントに関する説明のすべてを記載しているわけではありません。詳細は、オペレーティング・システム、およびユーザー・イグジットの作成に使用する言語によって異なります。


ユーザー・イグジットのインプリメントについて

一般的に、ユーザー・イグジットのインプリメントは次のように行います。

•	IAPXTB表を作成し、各ユーザー・イグジット名(1つのユーザー・イグジットにつき1行)を挿入します。

•	IAPXTB表からソース・ファイルを生成します。

•	IAPXTBソース・ファイルをコンパイルし、作成したプログラムもコンパイルして、その結果生成されたオブジェクト・モジュールをG30DES、G30RUN、G30BATの1つ以上とリンクします。


ユーザー・イグジットの作成

ユーザー・イグジットを作成する方法は次のとおりです。

1	ユーザー・イグジットを使用せずに図表を作成します。

2	どのようなユーザー・イグジットが必要かを決めます。

3	ホスト・プログラミング言語の1つを使用してユーザー・イグジットを書きます。

4	次の手順で、ユーザー・イグジットをインプリメントします。

   IAPXTB表を作成し、各ユーザー・イグジット名（1つのユーザー・イグジットにつき1行）を挿入します。

  IAPXTB表からソース・ファイルを生成します。

  IAPXTBソース・ファイルおよびユーザーが作成したプログラムをコンパイルし、G30DES、G30RUN、G30BATの1つ以上とリンクします。

5	Graphics Builderにユーザー・イグジットをコールする記述をします（必要であれば引数を付けます）。

注意: ユーザー・イグジットのインプリメントに関する詳細には、オペレーティング・システムによって異なる部分があります。正確なステップの詳細は、ご使用のオペレーティング・システムのGraphics Builderマニュアルを参照してください。


IAPXTB表の作成

IAPXTB表を作成する方法は次のとおりです。

  ユーザー・イグジットを（任意のオペレーティング・システムに）インプリメントするには、GENXTBプログラムおよびGENXTBフォームが使用可能であることが必要です。これらの機能を使用可能にする方法の詳細は、使用しているオペレーティング・システム用のGraphics Builderマニュアルを参照してください。

IAPXTB表はGENXTBフォームで使用される基本表ですが、この表を作成するには、GENXTBプログラムを使用します。GENXTBプログラムの使用方法の詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。Form Builderがない場合は、SQL*Plusを使用してIAPXTB表を作成してください。表の作成に関する詳細は、『SQL*Plusユーザーズ・ガイドおよびリファレンス』を参照してください。

IAPXTB表には、Graphics Builderにリンクするユーザー・イグジットをすべてリストします。IAPXTB表の個々の列についての説明を次に示します。

列名	説明	使用方法

XTB$XNM	名前	この列は、ユーザー・イグジットの名前を指定します（これは必ずしもユーザー・イグジットを含んだファイル名である必要はありません）。ホスト言語の中には大文字と小文字を区別するものがあることに注意してください。
XTB$XTY	タイプ	この列はユーザー・イグジットを書く言語を指定します。
XTB$REM	注釈	この列は、ユーザー・イグジットの目的を記述するテキスト文字列を指定します。 文字列の最大長は80文字です。
XTB$CRE	作成	この列はIAPXTB表のレコードを作成した日付を指定します。 レコードをコミットすると、GENXTBフォームは自動的にこの列に値を入力します。
XTB$MOD	変更	この列は、IAPXTB表のレコードを最後に変更した日付を指定します。レコードをコミットすると、GENXTBフォームは自動的にこの列に値を入力します。

この表には使用するすべてのユーザー・イグジット名が含まれている必要があります。たとえば、Form Builderで使用するユーザー・イグジットはすでに表に追加してある場合でも、Graphics Builderで使用するユーザー・イグジット（現時点ではまだありません）およびユーザー作成の新規ユーザー・イグジットをすべてその表に追加する必要があります。

ユーザー・イグジットの記述をIAPXTB表に挿入するには、GENXTBフォーム(Form Builderフォームの1つ)を使用します。Form Builderを使用していない場合、SQL*Plusを使用して行を挿入します。表への行の挿入に関する詳細は『SQL*Plusユーザーズ・ガイドおよびリファレンス』を参照してください。

個々のユーザー・イグジット名ごとに、1行をIAPXTB表に入力してください。（ユーザー・イグジットが単独でプリコンパイルおよびコンパイルされるファイルに入っているか、または複数のユーザー・イグジットとともにプリコンパイルおよびコンパイルされるファイルに入っているかにかかわらず、行ってください）。また、1つのIAPXTB表に同じシステムのすべての製品で使用するユーザー・イグジットを保存しておいてください。

ユーザー・イグジットをインプリメントするためのプロセスは、個々のオペレーティング・システムに固有のものです。正確なステップの詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

注意:     IAPXTB表を誤って削除してしまった場合に備えて、ユーザー・イグジットの情報をテキスト・データとして別に保存しておいてください。


IAPXTBソース・ファイルの生成

IAPXTBソース・ファイルを生成する方法は次のとおりです。

  GENXTBプログラムを使用して、IAPXTB表の情報を読み取り、ソース・ファイルを生成します。このソース・ファイルは、ユーザー・イグジットをリンクするために必要なエントリ・ポイント・ファイルです。

注意: ユーザー・イグジットをインプリメントするためのプロセスは、個々のオペレーティング・システムに固有のものです。正確なステップの詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。


ソース・ファイルおよびプログラムのコンパイル

ソース・ファイルおよびプログラムをコンパイルする方法は次のとおりです。

  IAPXTBソース・ファイルおよびユーザー・イグジット・プログラムをコンパイルします。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。次に、コンパイルの結果であるIAPXTBオブジェクト・ファイルを、G30DES、G30RUN、G30BATの1つ以上の実行可能ファイルとリンクします。

注意: ユーザー・イグジットをインプリメントするためのプロセスは、個々のオペレーティング・システムに固有のものです。正確なステップの詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。


ユーザー・イグジット・コールの書込み

ユーザー・イグジット・コールを書き込む方法は次のとおりです。

ユーザー・イグジットはGraphics Builderの中のPL/SQLを入力できるところであればどこからでもコールすることができます。次の構文を使用します。

構文:	og_user_exit('user_exit_name [argument_list]');

パラメータの内容は次のとおりです。

user_exit_name	制御を渡そうとするユーザー・イグジットの名前。ユーザー・イグジット名の長さは自由です。（オペレーティング・システムによっては、名前の最大長が6文字の場合があります。システム管理者に確認してください。

argument_list	ユーザー・イグジットに引き渡す任意のパラメータ名を含みます。引数リストの長さは自由です。

注意: 前述の構文はPL/SQLボタンまたはトリガー・プロシージャに埋め込むことが必要です。

例:

曲線上の2点に基づいて曲線の下の面積を計算するユーザー・イグジット(名前はINTEGRAL)を書いたとします。そして、4つのGraphics Builderパラメータ(名前はPOINT1X、POINT1Y、POINT2X、POINT2Y)があり、その値には2つの点(x座標およびy座標)が含まれているとします。このユーザー・イグジット・コールは次のようになります。

og_user_exit('integral point1x point1y point2x point2y');

ユーザー・イグジット・プログラムに、計算した領域をGraphics BuilderのAREAというパラメータに戻したい(EXEC TOOLS SET)場合があります。そのためには、AREAパラメータ用の値を設定(SET)するユーザー・イグジットを書き込みます。

ルール:

1	ユーザー・イグジット名は使用しているオペレーティング・システムおよびホスト言語のルールに従う必要があります。そのようなルールの中には、大文字小文字の区別に関するルールが含まれている場合もあるので、注意してください。

2	user_exit_nameの最大長は10文字（一部のオペレーティング・システムでは6文字）です。argument_listの最大長は230文字です。スペースもこの数に含めます。

注意: これらの制限はオペレーティング・システムによって異なる場合があります。正確な制限については、システム管理者に確認してください。

3	引数はスペースでのみ区切られます。argument_listの引数の間に複数のスペースがあると、文字列がユーザー・イグジットに渡される前にGraphics Builderにより余分なスペースが削除されます。

たとえば、コール

'quota 10 20 Q4'

がユーザー・イグジットに渡される場合は、次のようになります。

'quota 10 20 Q4'

4	引数の中で二重引用符を文字として参照するには、"\"を使用します。\は、引数の受渡しの前に削除されます。


PL/SQL内のユーザー・イグジット・エラーのチェック

PL/SQL内のユーザー・イグジット・エラーをチェックする方法は次のとおりです。

  次の例外を使用します。

OG_Userexit_Failure_Error

OG_Userexit_Fatal_Error

OG_USEREXIT_FAILURE_ERROR例外は、ユーザー・イグジットからFAILUREが戻されたときに発生します。OG_USEREXIT_FATAL_ERROR例外は、ユーザー・イグジットからFATALが戻されたときに発生します。

例:

MYEXITという名前のユーザー・イグジットがあり、それが失敗したかどうかをチェックするとします。この場合、ユーザー・イグジット・コールは次のようになります。

BEGIN
  og_user_exit('myexit');
EXCEPTION
  WHEN og_userexit_failure_error THEN
    og_quit;
  WHEN og_userexit_fatal_error THEN
    og_quit;
END;


?


Graphics Builderのファイル格納について

ファイルを格納するとき、システムによっては、ファイル名の末尾に拡張子を付けることができます(拡張子を付けるように要求される場合もあります)。このようなシステム上のGraphics Builderでは、次のように拡張子を付けます。

拡張子	ファイルのタイプ	作成者

.afc	AIFF-cサウンド	サウンドのエクスポート
.bmp	BMPイメージ	イメージのエクスポート
.cgm	CGM描画	描画のエクスポート
.cht	チャート・テンプレート	チャート・テンプレートのエクスポート
.jpg	JFIFイメージ	イメージのエクスポート
.odf	Oracle描画フォーマット	描画のエクスポート
.ogd	Graphics Builderのファイル	図表の上書き保存
.ogr	Graphics Builderのランタイム・ファイル	図表の生成
.oif	Oracleイメージ・フォーマット	イメージのエクスポート
.osf	Oracleサウンド・フォーマット	サウンドのエクスポート
.pal	カラー・パレット	カラー・パレットのエクスポート
.pcx	PCXイメージ	イメージのエクスポート
.pic	PICTイメージ	イメージのエクスポート
.pll	PL/SQLライブラリ	PL/SQLライブラリの上書き保存
.pls	PL/SQLプログラム単位	PL/SQLソース・テキストのエクスポート
.tif	TIFFイメージ	イメージのエクスポート


ファイル検索について

  関連項目

PL/SQLビルトイン・サブプログラムを使用してファイルを参照する場合、Graphics Builderは、次の順序でそのファイルを検索します。

1	ファイル名の直前にパスが指定されている場合は、そのパス(例、C:\images\product.tif)。

2	オペレーティング・システムが「現行」（または「作業」）パスと考えるパス。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

3	GRAPHICS60環境変数により指定されているパス。

4	ORACLE_HOME環境変数により指定されているパス。


ファイル拡張子と検索順序について

  関連項目

Graphics Builder PL/SQLビルトイン・サブプログラムで指定したファイル名には、ファイル拡張子が付けられます。指定したファイル名に拡張子が含まれていると、Graphics Builderはそのファイル名と完全に一致するファイルを探します。

指定されたファイル名に拡張子が含まれていないと、Graphics Builderは、まず最初に指定されたとおりのファイルを探します。そのファイルが見つからないと、Graphics Builderはそのファイル・タイプに適切な拡張子をファイルに追加して、再びそのファイルを検索します。

たとえば、TIFFイメージをインポートするときにファイル名をbudgieと指定すると、Graphics Builderはまず最初にこの名前のファイルを検索します。検索に失敗すると、Graphics Builderは次にbudgie.tifというファイルを検索します。


ファイルとデータベース間のドキュメントの移動について

ファイルとデータベース間では、次のタイプの文書を移動させることができます。

図表

その他のモジュール


ファイル・システムとデータベース間の図表の移動

ファイルに格納された図表をデータベースに移動させるには、次の手順で行います。

1	Graphics Builderで、「ファイル」 [image] 「オープン」を選択し、データベースに格納された図表をオープンします。

2	「ファイル」 [image] 「別名保存」 [image] 「データベース」を選択します。

必要に応じて、この後オぺレーティング・システム・コマンドを使用してファイル・システム内のファイルを削除します。

データベースに格納された図表をファイルに移動させるには、次の手順で行います。

1	Graphics Builderで、「ファイル」 [image] 「オープン」を選択し、データベースに格納された図表をオープンします。

2	「ファイル」 [image] 「別名保存」 [image] 「ファイル・システム」を選択します。

続いて必要に応じ、「ファイル」 [image] 「管理」 [image] 「削除」を選択し、モジュールのデータベース・バージョンを削除します。


ファイル・システムとデータベース間での他のドキュメントの移動

ファイル・システムとデータベース間で別のドキュメントを移動するには:

 図表にそのドキュメントをインポートし、次にエクスポートします。この方法で、次のようなドキュメントを移動することができます。

•	チャート・テンプレート

•	カラー・パレット

•	描画

•	イメージ

•	PL/SQLライブラリ

•	サウンド


ドキュメントの削除

ファイルに格納されているドキュメントを削除するには:

 適切なオぺレーティング・システム・コマンドを使用してください。

モジュールをデータベースから削除するには:

  「ファイル」 [image] 「管理」 [image] 「削除」 [image] モジュールタイプを選択します。


実行可能ファイルについて

実行可能ファイルは、Graphics Builder、ランタイムおよびバッチ・モードのコンポーネントを起動するのに使用するバイナリ・ファイルです。実行可能ファイルは、コマンド・プロンプトでファイル名(キーワードとともに)を入力するか、またはビットマップのデスクトップから起動されます。実行可能ファイルは、最初はbinサブディレクトリ（binフォルダ）の中に入れられます。

Graphics Builderの実行可能ファイルは次のとおりです。

GOBAT60	Builderまたはランタイム・ファイルを非ビットマップ環境で実行し、図表の出力をプリンタ、ファイルまたはデータベースに向けます。

GORUN60	Builderまたはランタイム形式のファイルに保管された図表を実行します。

GOBLD60	GraphicsBuilderを起動します。Graphics Builderでは図表の作成、修正およびテストを行うことができます。


コマンド・ライン構文の規則

  関連項目

コマンド・ラインから実行可能ファイルを起動する場合、通常は次の書式で入力します。

executable_name keyword1=value1 keyword2=value2 ...

それぞれのkeyword=valueは引数と呼ばれます。これを設定しておくことによって、キーワードを毎回入力する必要がなくなります。

次の構文規則は、すべてのGraphics Builder実行可能ファイルに適用されます。

1	引数の等号記号(=)の前後には空白を入れないでください。

2	引数と引数の間は、1つ以上の空白で区切ってください。この際、空白のかわりにカンマを使用しないでください。

3	引数の値は引用符か二重引用符で囲んでください。どちらを使用するかは、システムによって異なります。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

4	すべての引数でkeyword=の部分は、大文字と小文字の区別がありません。オぺレーティング・システムによっては、USERID、PRINT、COPIES、CLOSEおよびQUITを除くすべての引数において値の部分は大文字と小文字の区別をする必要があります。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

5	キーワードは省略される場合もあります。

6	すべてのファイル参照で、フルパス名を指定できます。

7	コマンド・ラインで指定された値は、Graphics Builderまたはランタイムのデフォルト値を上書きします。たとえば、デフォルト・プリンタ名が'printer1'の場合にコマンド・ラインからPRINTER='printer2'と指定してBuilderを起動すると、図表はprinter2に印刷されます。

同様に、実行可能ファイルで明示的に設定された値は、コマンド・ラインから入力した値を上書きします。たとえば、コマンド・ラインでGraphics Builderを起動してプリンタ名を設定した場合、そのプリンタ値を上書きするには、Graphics Builderで明示的に変更します。


キーワードの使用方法

構文で指定された順序で引数を入力する場合、それぞれの引数のkeyword=の部分は、オプションになります。引数のうち1つでも指定しないと、その指定されなかった引数の後の引数にキーワードを指定する必要があります。

たとえば、実行可能ファイルに引数が4つあり、そのうちの1番目、2番目および4番目の引数のみを指定する場合、最初の2つはキーワードなしで指定できます。ただし、4番目の引数にはキーワードが必要です。理由は、構文で指定されたとおりの順序で引数を入力しなかった(3番目の引数を指定しなかった)ためです。

例(有効):

次に示すのは、有効なコマンド・ラインの順序の例です。

gobld60 openfile=my_display print=yes userid=scott/tiger

gobld60 my_display scott/tiger print=yes

2番目の例では、USERIDとPRINT間の構文に使用されないキーワードがあるので、PRINTキーワードを使用する必要があります。

例(無効):

次に示すのは、無効なコマンド・ラインの順序の例です。

gobld60 scott/tiger openfile=my_display

この例は、"scott/tiger"が順不同でUSERIDキーワードが指定されずに入力されているため無効です。


値リスト

ほとんどのキーワードでは、複数の値を指定できます。たとえば、OPENFILEとOPENDBキーワードには、値のリストを指定できます。これは、実行可能ファイルによって複数の図表がオープンされるということです。

gobld60 openfile=(d1,d2,d3)

これにより、1つのコマンド・ライン文で複数の図表を処理できます。たとえば、複数の図表をオープンし、それらをCGMファイルにエクスポートして、1つのコマンド・ライン文ですべての図表を印刷できます。

値リストはカッコで囲み、それぞれの値をカンマで区切る必要があります。システムによっては、コマンド・ラインでのカッコとカンマの使用方法に特別な制限があるので、注意してください。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

値の一致

1つの図表をオープンしてコマンド・ラインで他のキーワードを指定した場合、Graphics Builderが実行するアクションは、オープンされた図表上のその指定されたキーワードが指示するアクションです。たとえば、OPENFILEとPRINTキーワードの両方をコマンド・ライン文で使用すると、Graphics Builderは、指定されたファイルをオープンしてそれを印刷します。

gobld60 openfile=d1 print=yes

コマンド・ラインから値リストを使用して複数の図表をオープンし、なおかつ他のキーワードの値リストを入力した場合、Graphics Builderは、そのキーワード値とオープンされた図表の値リスト内での位置を一致させます。次に例を示します。

gobld60 openfile=(d1,d2,d3) print=(yes,no,yes)

この例では、Graphics Builderは3つの図表をすべてオープンしますが、印刷するのはd1とd3のみです。

OPENFILEとOPENDBの両方を使用して図表をオープンする場合、他のキーワード値との一致時にはOPENFILEによってオープンされた図表上位になります。次に例を示します。

gobld60 opendb=(d1,d2) openfile=d3 print=(yes,no,yes)

この例では、d3とd2が印刷されますが、d1は印刷されません。

キーワードのいずれにも"NULL"値を指定することはできません。たとえば、3つの図表をオープンして1番目と3番目の図表のみを生成するということはできません。

gobld60 openfile=(d1,d2,d3) generatefile=(g1,,g3)  --invalid

GENERATEFILE値リストの2番目の値がないので、結果はエラーになります。

埋込み値

キーワードの値リストの値がオープンされている図表の数よりも少ない場合は、Graphics Builderは欠けている値に、キーワードに最後に指定された値またはデフォルト値を埋め込みます。各キーワードの埋込み動作については、次に説明します。

キーワードの値リストの値がオープンされている図表の数よりも多い場合は、余分な値は無視されます。

例:

次にコマンド・ライン文の例を挙げます。

1	gobld60 openfile=d1 print=yes copies=2 exportcgm=cgm_file quit=yes

Graphics Builderは、図表d1を実行し、デフォルトのプリンタにその図表のコピーを2部出力します。

2	gobld60 openfile=(d1,d2) userid=(scott/tiger,steve/lion)

Graphics Builderは、データベースのユーザーID scott/tigerを使用して図表d1を実行し、次にデータベース・ユーザーID steve/lionを使用してd2を実行します。

3	gobld60 openfile=(d1,d2) print=yes

Graphics Builderは、d1とd2の両方をオープンして、1部ずつデフォルトのプリンタに出力します。PRINTキーワードは、最後に指定された値(yes)で、欠けている値を埋めることに注意してください。

4	gobld60 openfile=(d1,d2) opendb=d3 generatefile=(g1,g2) print=(no,no,yes)	close=(yes,yes)

Graphics Builderは、各図表について次のことを実行します。(1)d1についてはオープン、生成およびクローズ。(2)d2についてはオープン、生成およびクローズ(3)d3についてはオープン、印刷およびクローズ。GENERATEFILEキーワードは欠けている値を埋めないこと、およびCLOSEキーワードはそれの最後に指定された値(yes)で欠けている値を埋めることに注意してください。


明示的なログイン

データベースに明示的にログインするには、次のいずれかの方法を使用してください。(1)実行可能ファイル用のUSERIDキーワードを使用します。(2) Graphics Builderまたはランタイムの実行可能ファイルで「ファイル」 [image] 「接続」を選択します。(3) Graphics Builderの「SQL文エディタ」ダイアログ・ボックスで「接続」を選択します。

USERID

オプションのNet8プロトコル用のORACLEユーザー名とパスワードです。

オプション:	このキーワードの値は、次のいずれかの書式で入力してください。

username/password

username/password@node

Oracle以外のデータソースへの接続を希望する場合は、次のようになります。

username/password@ODBC:datasource[:dbname]

ODBCデータベースへの接続を行うためdbnameを指定せずにオプションusername/password@ODBC:datasource[:dbname]を使用すると、ODBC接続の現行のデータベースが使用されます。


自動ログイン

ORACLE自動ログイン機能を使用すると、ユーザー名とパスワードを明示的に指定せずにGraphics Builderに接続できます。この自動ログイン機能は、すべてのGraphics Builder実行可能ファイルで使用できます。この機能の使用の詳細は、『Oracle8 Server管理者ガイド』を参照してください。

この方法でログインする場合、ORACLEはデフォルト・ログイン(OPS$など)を使用してORACLEユーザー名をオぺレーティング・システムのユーザー名に関連付けます。自動ログイン・プロシージャの起動は、次のいずれかの方法で行ってください。

•	USERIDキーワードでコマンド・ラインから実行可能ファイルを起動します。ユーザー名とパスワードの明示的な指定を省略すると、Graphics Builderは自動ログインを試みます。

•	「接続」ダイアログ・ボックスのユーザー名とパスワードのフィールドになにも入力しないでください。

この方法でログインする場合、USERIDキーワードの後に@nodeを入力して、あるいは「接続」ダイアログの「データベース」フィールドにnodeと入力して、リモート・データベースにアクセスできます。


リモート・ログイン

Net8で、リモート・データベース(ローカル・コンピュータ上にないデータベースなど)を指定できます。リモート・ログイン機能を使用する場合、リモート・データベースを意識する必要はありません。遠隔地のノードへのアクセスやローカル・コンピュータ上のデータベースへのアクセスにかかわらず、Graphics Builderの動作は同じです。

構文:	driver_name:node_name:db_name

パラメータの内容は次のとおりです。

driver_name	リモートのアクセスに使用するドライバ（ t:、d:、あるいはOracle以外のデータソースに対してはODBC:）です。デフォルトの設定は、システムによって異なります。

node_name	これは、ターゲット・データベースがあるリモート・ネットワーク・ノード名(例、london)。

db_name	データベースの名前(例、:rds)。

Net8の詳細は、『Oracle Net8管理者ガイド』を参照してください。

例

図表を'london'ノード上のINVデータベースで実行するには、次のように入力できます。

gorun60 openfile=invent.ogd userid=scott/tiger@D:london:INV


ログ・ファイル

システムによっては、起動時のエラー・メッセージをコマンド・ラインに表示できます。これをサポートしないシステムでは、Graphics Builderは起動メッセージが記述されている一時ディレクトリにログ・ファイルを作成します。各実行可能ファイルには、次のような独自のログイン・ファイルがあります。

実行プログラム	ログ・ファイル名

GOBLD60	godes.log
GORUN60	gorun.log
GOBAT60	gobat.log
これらのファイルが置かれる一時ディレクトリは、システムによって異なります。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。


GOBLD60

Graphics Builderを起動するには、GOBLD60実行可能ファイルを使用します。

構文:     gobld60 [[keyword=]value ]...

有効なkeyword=value引数は、次のとおりです。

OPENFILE={filename|(filename1,filename2,...)}

USERID={login_string|(login_string1,login_string2,...)}

OPENDB={display_name|(display_name1,display_name2,...)}

PRINT={{YES|NO}|({YES|NO},{YES|NO},...)}

COPIES={n|(n1,n2,...)}

PRINTER={printer_name|(printer_name1,printer_name2,...)}

PRINTFILE={filename|(filename1,filename2,...)}

EXPORTFILE={filename|(filename1,filename2,...)}

EXPORTCGM={filename|(filename1,filename2,...)}

EXPORTBIT={{16|32}|({16|32},{16|32},...)}

EXPORTDB={drawing_name|(drawing_name1,drawing_name2,...)}

EXPORTIMAGE={filename}

GENERATEFILE={filename|(filename1,filename2,...)}

GENERATEDB={display_name|(display_name1,display_name2,...)}

SAVEFILE={filename|(filename1,filename2,...)}

SAVEDB={display_name|(display_name1,display_name2,...)}

CLOSE={{YES|NO}|({YES|NO},{YES|NO},...)}

QUIT={YES|NO}

CMDFILE=filename

LOGFILE=filename

MODULE={filename|(filename1,filename2,...)}

param={value|(value1,value2,...)}


OPENFILE

オープンされる図表が入っているファイル名です。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


USERID

これは、データベースへのログイン文字列です。

オプション:	有効なデータベース・ログイン文字列を入力します。

デフォルト:	なし。ただし、自動ログインが使用可能な場合は除きます。

埋込み値:	最後に指定されたログイン文字列。

「起動時にログオン」という環境設定にチェックが付いている場合に、ここにログイン文字列を指定すると、「接続」ダイアログ・ボックスは表示されません。


OPENDB

データベースに保管され、これからオープンされる図表名です。USERID引数を使用してデータベースにログインする必要があります。

オプション:	有効な図表名を入力します。

デフォルト:	なし。

埋込み値:	無効。


PRINT

OPENFILEまたはOPENDBでオープンされた図表を、オープン直後にPRINTER引数で指定されたプリンタに出力するかどうかを指定します。

オプション:	yesを指定すると、図表は出力(印刷)されます。

デフォルト:	noを指定すると、図表は出力(印刷)されません。

埋込み値:	最後に指定された値。


COPIES

印刷する図表のコピー部数です。

オプション:	有効な整数を入力します。

デフォルト:	1

埋込み値:	1


PRINTER

図表が出力されるプリンタ名です。

オプション:	有効なプリンタ名を入力します。詳細は、使用しているマニュアルを参照してください。

デフォルト:	デフォルト・プリンタ名。

埋込み値:	最後に指定された値。この値がない場合は、プリンタのデフォルト・プリンタ名。


PRINTFILE

図表がPostScript形式で印刷されるファイル名です。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


EXPORTFILE

図表がOracle描画フォーマットとしてエクスポートされるファイル名です。すべてのレイヤーが、表示または非表示に関係なくエクスポートされます。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


EXPORTCGM

図表がCGM形式の描画としてエクスポートされるファイル名です。すべてのレイヤーが、表示または非表示に関係なくエクスポートされます。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


EXPORTBIT

CGMファイルにエクスポートされた図表の形式を指定します。

オプション:	16ビットを選ぶと、2バイトの座標空間が使用されます。

32ビットを選ぶと、4バイトの座標空間が使用されます。

デフォルト:	16

埋込み値:	16


EXPORTDB

図表がOracle形式の描画としてデータベースへエクスポートされるときの名前。USERID引数を使用してデータベースにログインする必要があります。すべてのレイヤーが、表示または非表示に関係なくエクスポートされます。

オプション:	有効な名前を入力します。

デフォルト:	なし。

埋込み値:	なし。


EXPORTIMAGE

図表が、ファイル拡張子で指定された形式のイメージにエクスポートされる時の名前です。すべてのレイヤーが、表示または非表示に関係なくエクスポートされます。

オプション:	次の拡張子のうちの1つを付けた有効なファイル名を指定します。
.gif	図表をGIFファイルにエクスポートする場合
.jpg	図表をJPEGファイルにエクスポートする場合
.bmp	図表をビットマップにエクスポートする場合
.tif	図表をTIFFファイルにエクスポートする場合
.pict	図表をPICTファイルにエクスポートする場合

ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


GENERATEFILE

図表が生成されるファイル名です。このキーワードを使用すると、Graphics Builderは図表の中のPL/SQLプログラムをすべてコンパイルします。コンパイル・エラーが発生すると、エラー・メッセージはLOGFILEで指定されたファイルに書き込まれ、不完全な図表が生成されます。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


GENERATEDB

図表が生成されデータベースに保管されるときの名前です。USERID引数を使用してデータベースにログインする必要があります。このキーワードを使用すると、Graphics Builderは図表の中のPL/SQLプログラムをすべてコンパイルします。コンパイル・エラーが発生すると、エラー・メッセージはLOGFILEで指定されたファイルに書き込まれ、不完全な図表が生成されます。

オプション:	有効な図表名を入力します。

デフォルト:	なし。

埋込み値:	なし。


SAVEFILE

図表が保存されるファイル名です。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


SAVEDB

図表がデータベースに保存されるときの名前です。USERID引数を使用してデータベースにログインする必要があります。

オプション:	有効な図表名を入力します。

デフォルト:	なし。

埋込み値:	なし。


CLOSE

Graphics Builderが図表の処理を終えた後、その図表をクローズするかどうかを指定します。

オプション:	yesを指定すると、図表はクローズされます。

noを指定すると、図表はクローズされません。

デフォルト:	no

埋込み値:	no


QUIT

オープンされている図表の処理がすべて終了したらGraphics Builderを終了させるかどうかを指定します。

オプション:	yesを指定すると、ランタイムを終了させます。

noを指定すると、ランタイムを終了させません。

デフォルト:	no

埋込み値:	無効。


CMDFILE

有効なGOBLD60コマンド・ライン引数が入っているテキスト・ファイル名です。このファイルには、多数の引数または標準的な引数のセットを指定できます。このため、Graphics Builderを実行するたびにそれらの引数を入力しなくて済みます。

このファイルには、単一のコマンド・ライン構成の値となる引数のみを入力できます。引数は、空白か改行で区切ってください。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


LOGFILE

エラー・メッセージを警告として表示できない場合に、Graphics Builderはそのエラー・メッセージをこのテキスト・ファイルに書き込みます。このファイルに書き込まれるのは、Graphics Builder以外のエラーの他にGraphics Builderがコマンド・ライン引数を処理しようとしている最中に発生したエラーなどのメッセージです。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


MODULE

キーワードOPENFILEの同義語。


param

図表に定義されているパラメータの名前です。ここに指定されるパラメータの値は、図表の「パラメータ」に設定されているパラメータの初期値に優先します。

オプション:	図表の「パラメータ」に定義されている任意のパラメータと、そのパラメータのデータ型に有効な値を入力します。

デフォルト:	図表の「パラメータ」に定義されているパラメータおよび値。

埋込み値:	最後に指定された値。

パラメータ値は、システムの条件に基づき引用符または二重引用符内に入れることができます。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

例:

1	gobld60 openfile=d1 hisparam=26 herparam='Birthday' ourparam='14-JULY-94'

2	gobld60 openfile=(d1,d2,d3) myparam=(5,6)

この例で、myparam はd1では5、d2 とd3では6です。


GORUN60

GORUN60実行可能ファイルを使用して、コマンド・ラインから図表を実行します。

構文: gorun60 [[keyword=]value ]...

有効なkeyword=value引数は、次のとおりです。

OPENFILE={filename|(filename1,filename2,...)}

USERID={login_string|(login_string1,login_string2,...)}

OPENDB={display_name|(display_name1,display_name2,...)}

PRINT={{YES|NO}|({YES|NO},{YES|NO},...)}

COPIES={n|(n1,n2,...)}

PRINTER={printer_name|(printer_name1,printer_name2,...)}

PRINTFILE={filename|(filename1,filename2,...)}

EXPORTFILE={filename|(filename1,filename2,...)}

EXPORTCGM={filename|(filename1,filename2,...)}

EXPORTBIT={{16|32}|({16|32},{16|32},...)}

EXPORTDB={drawing_name|(drawing_name1,drawing_name2,...)}

EXPORTIMAGE={filename}

CLOSE={{YES|NO}|({YES|NO},{YES|NO},...)}

QUIT={YES|NO}

CMDFILE=filename

LOGFILE=filename

MODULE={filename|(filename1,filename2,...)}

EXECPLSFILE={filename}

ORACLE_STARTUP={YES|NO}

param={value|(value1,value2,...)}


OPENFILE

オープンされる図表が入っているファイル名です。コンパイルされていないPL/SQLプログラムはコンパイルされ、その後で図表が実行されます。コンパイル・エラーが発生すると、エラー・メッセージはLOGFILEで指定されたファイルに書き込まれ、図表は異常終了します。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


USERID

これは、データベースへのログイン文字列です。

オプション:	有効なデータベース・ログイン文字列を入力します。

デフォルト:	なし。ただし、自動ログインが使用可能な場合は除きます。

埋込み値:	最後に指定されたログイン文字列。

「起動時にログオン」という環境設定にチェックが付いている場合に、ここにログイン文字列を指定すると、「接続」ダイアログ・ボックスは表示されません。


OPENDB

データベースに保管され、これからオープンされる図表名です。USERID引数を使用してデータベースにログインする必要があります。コンパイルされていないPL/SQLプログラムはコンパイルされ、その後で図表が実行されます。コンパイル・エラーが発生すると、エラー・メッセージはLOGFILEで指定されたファイルに書き込まれ、図表は異常終了します。

オプション:	有効な図表名を入力します。

デフォルト:	なし。

埋込み値:	無効。


PRINT

OPENFILEまたはOPENDBでオープンされた図表を、PRINTER引数で指定されたプリンタに出力するかどうかを指定します。図表のオープン・トリガーが実行を完了した後に、その図表は出力(印刷)されます。

オプション:	yesを指定すると、図表は出力(印刷)されます。

noを指定すると、図表は出力(印刷)されません。

デフォルト:	no

埋込み値:	最後に指定された値。


COPIES

印刷する図表のコピー部数です。

オプション:	有効な整数を入力します。

デフォルト:	1

埋込み値:	1


PRINTER

図表のオープン・トリガーが実行を完了した後、その図表が出力されるプリンタ名です。

オプション:	有効なプリンタ名を入力します。詳細は、使用しているマニュアルを参照してください。

デフォルト:	デフォルト・プリンタ名。

埋込み値:	最後に指定された値。この値がない場合は、プリンタのデフォルト・プリンタ名。


PRINTFILE

図表のオープン・トリガーが実行を完了した後、PostScript形式で図表が印刷されるファイル名。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


EXPORTFILE

図表がOracle描画フォーマットとしてエクスポートされるファイル名です。表示されているか隠れているかにかかわらず、図表のOpen Displayトリガーが実行を終了するとすべてのレイヤーがエクスポートされます。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


EXPORTCGM

図表がCGM形式の描画としてエクスポートされるファイル名です。表示されているか隠れているかにかかわらず、図表のOpen Displayトリガーが実行を終了するとすべてのレイヤーがエクスポートされます。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


EXPORTBIT

CGMファイルにエクスポートされた図表の形式を指定します。

オプション:	16ビットを選ぶと、2バイトの座標空間が使用されます。

32ビットを選ぶと、4バイトの座標空間が使用されます。

デフォルト:	16

埋込み値:	16


EXPORTDB

図表がOracle形式の描画としてデータベースへエクスポートされるときの名前。USERID引数を使用してデータベースにログインする必要があります。表示されているか隠れているかにかかわらず、図表のOpen Displayトリガーが実行を終了するとすべてのレイヤーがエクスポートされます。

オプション:	有効な名前を入力します。

デフォルト:	なし。

埋込み値:	なし。


EXPORTIMAGE

図表が、ファイル拡張子で指定された形式のイメージにエクスポートされるときの名前です。すべてのレイヤーが、表示または非表示に関係なくエクスポートされます。

オプション:	次の拡張子のうちの1つを付けた有効なファイル名を指定します。
.gif	図表をGIFファイルにエクスポートする場合
.jpg	図表をJPEGファイルにエクスポートする場合
.bmp	図表をビットマップにエクスポートする場合
.tif	図表をTIFFファイルにエクスポートする場合
.pict	図表をPICTファイルにエクスポートする場合

ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


CLOSE

Graphics Builderが図表の処理を終えた後、その図表をクローズするかどうかを指定します。

オプション:	yesを指定すると、図表はクローズされます。

noを指定すると、図表はクローズされません。

デフォルト:	no

埋込み値:	no


QUIT

オープンされている図表の処理がすべて終了したらGraphics Builderを終了させるかどうかを指定します。

オプション:	yesを指定すると、ランタイムを終了させます。

noを指定すると、ランタイムを終了させません。

デフォルト:	no

埋込み値:	無効。


CMDFILE

有効なGORUN60コマンド・ライン引数が入っているテキスト・ファイル名です。このファイルには、多数の引数または標準的な引数のセットを指定できます。このため、Graphics Builderを実行するたびにそれらの引数を入力しなくて済みます。

このファイルには、単一のコマンド・ライン構成の値となる引数のみを入力できます。引数は、空白か改行で区切ってください。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


LOGFILE

エラー・メッセージを警告として表示できない場合に、Graphics Builderはそのエラー・メッセージをこのテキスト・ファイルに書き込みます。このファイルに書き込まれるのは、Graphics Builder以外のエラーの他にGraphics Builderがコマンド・ライン引数を処理しようとしている最中に発生したエラーなどのメッセージです。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


MODULE

キーワードOPENFILEの同義語。


EXECPLSFILE

起動時に実行されるPL/SQL無名ブロックまたは名前付きプロシージャが入っているテキスト・ファイル名です。

オプション:	有効なファイル名。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


ORACLE_STARTUP

起動時にGraphics BuilderにOPEN_DISPLAYトリガーを実行させるかどうかを指定します。ORACLE_STARTUPをEXECPLSFILEコマンド・ライン・オプションとともに使用すると、オープン・トリガーで実行されるアクションのかわりに別のアクションを実行できます。

オプション:	yesを指定すると、Graphics Builderはオープン・トリガーを実行します。

noを指定すると、オープン・トリガーを実行しません。

デフォルト:	yes

埋込み値:	無効。


param

図表に定義されているパラメータの名前です。ここに指定されるパラメータの値は、図表の「パラメータ」に設定されているパラメータの初期値に優先します。

オプション:	図表の「パラメータ」に定義されている任意のパラメータと、そのパラメータのデータ型に有効な値を入力します。

デフォルト:	図表の「パラメータ」に定義されているパラメータおよび値。

埋込み値:	最後に指定された値。

パラメータ値は、システムの条件に基づき引用符または二重引用符内に入れることができます。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

例:

1	gorun60 openfile=d1 hisparam=26 herparam='Birthday' ourparam='14-JULY-94'

2	gorun60 openfile=(d1,d2,d3) myparam=(5,6)

この例で、myparam はd1では5、d2 とd3では6です。


GOBAT60

GOBAT60実行可能ファイルを使用すると、ビットマップまたは非ビットマップ端末のどちらからでもバッチ・モードで図表を実行できます。この実行可能ファイルは、処理が完了した後も自動的に終了しません。図表がスタンドアロンの場合は、OG_QUITをクローズ・トリガーに組み込んでください。図表がフォームに埋め込まれている場合は、Graphics Builderをバッチ・モードにして終了します。これを行うには、FormsトリガーからのOG_INTERPRETのコールを組み込み、PL/SQL文字列og_quit;を渡してください。

構文: gobat60 [[keyword=]value ]...

有効なkeyword=value引数は、次のとおりです。

OPENFILE={filename|(filename1,filename2,...)}

USERID={login_string|(login_string1,login_string2,...)}

OPENDB={display_name|(display_name1,display_name2,...)}

PRINT={{YES|NO}|({YES|NO},{YES|NO},...)}

COPIES={n|(n1,n2,...)}

PRINTER={printer_name|(printer_name1,printer_name2,...)}

PRINTFILE={filename|(filename1,filename2,...)}

EXPORTFILE={filename|(filename1,filename2,...)}

EXPORTCGM={filename|(filename1,filename2,...)}

EXPORTBIT={{16|32}|({16|32},{16|32},...)}

EXPORTDB={drawing_name|(drawing_name1,drawing_name2,...)}

EXPORTIMAGE=[filename]

CMDFILE=filename

LOGFILE=filename

MODULE={filename|(filename1,filename2,...)}

EXECPLSFILE={filename}

ORACLE_STARTUP={YES|NO}

SHOWTOOLBAR={YES|NO}

SESSIONID={nnnnnn.nnnnnn}

param={value|(value1,value2,...)}


OPENFILE

オープンされる図表が入っているファイル名です。コンパイルされていないPL/SQLプログラムはコンパイルされ、その後で図表が実行されます。コンパイル・エラーが発生すると、エラー・メッセージはLOGFILEで指定されたファイルに書き込まれ、図表は異常終了します。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


USERID

これは、データベースへのログイン文字列です。

オプション:	有効なデータベース・ログイン文字列を入力します。

デフォルト:	なし。ただし、自動ログインが使用可能な場合は除きます。

埋込み値:	最後に指定されたログイン文字列。

「起動時にログオン」という環境設定にチェックが付いている場合に、ここにログイン文字列を指定すると、「接続」ダイアログ・ボックスは表示されません。


OPENDB

データベースに保管され、これからオープンされる図表名です。USERID引数を使用してデータベースにログインする必要があります。コンパイルされていないPL/SQLプログラムはコンパイルされ、その後で図表が実行されます。コンパイル・エラーが発生すると、エラー・メッセージはLOGFILEで指定されたファイルに書き込まれ、図表は異常終了します。

オプション:	有効な図表名を入力します。

デフォルト:	なし。

埋込み値:	無効。


PRINT

OPENFILEまたはOPENDBでオープンされた図表を、PRINTER引数で指定されたプリンタに出力するかどうかを指定します。図表のオープン・トリガーが実行を完了した後に、その図表は出力(印刷)されます。

オプション:	yesを指定すると、図表は出力(印刷)されます。

noを指定すると、図表は出力(印刷)されません。

デフォルト:	no

埋込み値:	最後に指定された値。


COPIES

印刷する図表のコピー部数です。

オプション:	有効な整数を入力します。

デフォルト:	1

埋込み値:	1


PRINTER

図表のオープン・トリガーが実行を完了した後、その図表が出力されるプリンタ名です。

オプション:	有効なプリンタ名を入力します。詳細は、使用しているマニュアルを参照してください。

デフォルト:	デフォルト・プリンタ名。

埋込み値:	最後に指定された値。この値がない場合は、プリンタのデフォルト・プリンタ名。


PRINTFILE

図表のオープン・トリガーが実行を完了した後、PostScript形式で図表が印刷されるファイル名。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


EXPORTFILE

図表がOracle描画フォーマットとしてエクスポートされるファイル名です。表示されているか隠れているかにかかわらず、図表のOpen Displayトリガーが実行を終了するとすべてのレイヤーがエクスポートされます。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


EXPORTCGM

図表がCGM形式の描画としてエクスポートされるファイル名です。表示されているか隠れているかにかかわらず、図表のOpen Displayトリガーが実行を終了するとすべてのレイヤーがエクスポートされます。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


EXPORTBIT

CGMファイルにエクスポートされた図表の形式を指定します。

オプション:	16ビットを選ぶと、2バイトの座標空間が使用されます。

32ビットを選ぶと、4バイトの座標空間が使用されます。

デフォルト:	16

埋込み値:	16


EXPORTDB

図表がOracle形式の描画としてデータベースへエクスポートされるときの名前。USERID引数を使用してデータベースにログインする必要があります。表示されているか隠れているかにかかわらず、図表のOpen Displayトリガーが実行を終了するとすべてのレイヤーがエクスポートされます。

オプション:	有効な名前を入力します。

デフォルト:	なし。

埋込み値:	なし。


EXPORTIMAGE

図表が、ファイル拡張子で指定された形式のイメージにエクスポートされる時の名前です。すべてのレイヤーが、表示または非表示に関係なくエクスポートされます。

オプション:	次の拡張子のうちの1つを付けた有効なファイル名を指定します。
.gif	図表をGIFファイルにエクスポートする場合
.jpg	図表をJPEGファイルにエクスポートする場合
.bmp	図表をビットマップにエクスポートする場合
.tif	図表をTIFFファイルにエクスポートする場合
.pict	図表をPICTファイルにエクスポートする場合

ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	なし。


CMDFILE

有効なgobat60コマンド・ライン引数が入っているテキスト・ファイル名。このファイルには、多数の引数または標準的な引数のセットを指定できます。このため、Graphics Builderを実行するたびにそれらの引数を入力しなくて済みます。

このファイルには、単一のコマンド・ライン構成の値となる引数のみを入力できます。引数は、空白か改行で区切ってください。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


LOGFILE

エラー・メッセージを警告として表示できない場合に、Graphics Builderはそのエラー・メッセージをこのテキスト・ファイルに書き込みます。このファイルに書き込まれるのは、Graphics Builder以外のエラーの他にGraphics Builderがコマンド・ライン引数を処理しようとしている最中に発生したエラーなどのメッセージです。

オプション:	有効なファイル名を入力します。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


MODULE

キーワードOPENFILEの同義語。


EXECPLSFILE

起動時に実行されるPL/SQL無名ブロックまたは名前付きプロシージャが入っているテキスト・ファイル名です。

オプション:	有効なファイル名。ファイル名の絶対または相対パス名を指定してください。

デフォルト:	なし。

埋込み値:	無効。


ORACLE_STARTUP

起動時にGraphics BuilderにOPEN_DISPLAYトリガーを実行させるかどうかを指定します。ORACLE_STARTUPをEXECPLSFILEコマンド・ライン・オプションとともに使用すると、オープン・トリガーで実行されるアクションのかわりに別のアクションを実行できます。

オプション:	yesを指定すると、Graphics Builderはオープン・トリガーを実行します。

noを指定すると、オープン・トリガーを実行しません。

デフォルト:	ｙｅｓ

埋込み値:	無効。


SHOWTOOLBAR

「Graphics Web」ツールバーをオンまたはオフにします。

オプション:	yesは、「Graphics Web」ツールバーを表示します。

noは、「Graphics Web」ツールバーを表示しません。

デフォルト:	URLに他のパラメータが含まれていない場合はyes、URLに他のパラメータが含まれている場合はnoです。

埋込み値:	無効。

注意: このキーワードは、Graphics Webカートリッジにより提供されるURLを介してWeb上に図表をオープンする場合にのみ有効です。


SESSIONID

Graphics Webカートリッジを介して表示されるGraphics displayのインスタンスの、一意識別子です。

オプション:	Graphics Webカートリッジにより生成される、任意の英数値によるセッションID番号。次に例を示します。

sessionid=000001.091032

デフォルト:	無効。

埋込み値:	利用不可。

注意: このキーワードは、Graphics Webカートリッジにより提供されるURLを使用してWeb上に図表をオープンする場合にのみ有効です。


param

図表に定義されているパラメータの名前です。ここに指定されるパラメータの値は、図表の「パラメータ」に設定されているパラメータの初期値に優先します。

オプション:	図表の「パラメータ」に定義されている任意のパラメータと、そのパラメータのデータ型に有効な値を入力します。

デフォルト:	図表の「パラメータ」に定義されているパラメータおよび値。

埋込み値:	最後に指定された値。

パラメータ値は、システムの条件に基づき引用符または二重引用符内に入れることができます。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

例:

1	gobat60 openfile=d1 hisparam=26 herparam='Birthday' ourparam='14-JULY-94'

2	gobat60 openfile=(d1,d2,d3) myparam=(5,6)

この例で、myparam はd1では5、d2 とd3では6です。


SQLスクリプトについて

Graphics Builderには、数種類のSQLスクリプトが組み込まれています。これを使用すると、非常に時間のかかるデータベース管理を迅速に行うことができます。このSQLスクリプトで実行できる内容は次のとおりです。

•	モジュールをデータベースに格納するときに使用するデータベース表の作成

•	データベース表に対するユーザー・アクセスの権限付与

•	これらの表に対するユーザーのアクセス権限の取り消し

SQLスクリプトを実行するには、まずSQL*Plusを実行し、データベースに接続した後、次のように入力します。

START script_name

パラメータの内容は次のとおりです。

script_name	実行するスクリプト名です。

これらのスクリプトのリストと使用方法については、使用しているオぺレーティング・システムのGraphics Builderマニュアルを参照してください。

SQL*Plusの使用の詳細は、『SQL*Plusユーザーズ・ガイドおよびリファレンス』を参照してください。


インストール・ファイルについて

インストール・ファイルとは、Graphics Builderのインストールに使用するSQLスクリプトです。Graphics Builderのインストールに使用するインストール・ファイルのリストは、使用しているオぺレーティング・システムのGraphics Builderマニュアルを参照してください。


デモ・ファイルについて

Graphics Builderには、数種類のデモ・ファイルが組み込まれています。これらのデモ・ファイルは、Graphics BuilderのファイルかSQLスクリプトのいずれかです。Builderのファイルは、移植可能なバイナリ・ファイルで、図表の定義が入っています。SQLスクリプトは、サンプル・データベース表を作成します。


管理ファイルについて

  関連項目

管理ファイルは、SQLスクリプトです。これを使用すると素早く簡単に管理作業を行うことができます。


環境設定ファイルについて

環境設定値は、ファイル・システムにテキスト・ファイルとして格納されます。Graphics Builderでは、次の環境設定ファイルをサポートします。

•	ユーザー環境設定ファイル	シングル・ユーザーの環境設定情報が入っています。

•	グローバル環境設定ファイル	ユーザー環境設定ファイルが見つからない場合に使用される環境設定情報が入っています。

オぺレーティング・システムによっては、この両方のファイルともサポートされない場合があります。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

ファイル書式

環境設定ファイルの中の項目は、通常は次のような書式で入力します。

preference = 値

パラメータの内容は次のとおりです。

preference	環境設定項目の名前。

値	環境設定の値です。この値は、文字列か数値です。空白が含まれる文字列は、二重引用符で囲んでください。

その他の設定

環境設定を「環境設定」ダイアログで設定する以外に、他の値を環境設定ファイルに直接入力して設定することもできます。次の値を設定できます。

環境変数

Keep_Passwordの環境設定


環境変数について

オペレーティング・システムがサポートするかどうかにかかわらず、環境設定ファイルに名前と値を入れることにより特定の環境変数を設定できます。

注意: 設定できるのは、ユーザー定義の変数と、Graphics Builderのインストールおよび実行が不要な変数のみです。

例

イメージ・ファイルを含むディレクトリを指す環境変数GRAPHICS30を設定します。次のような行を環境設定ファイルに追加します。

GRAPHICS60 = C:\mystuff\images


Keep_Passwordについて

Keep_Password環境設定は、図表の実行中にGraphics Builderが現行のデータベース・ユーザーのパスワードをメモリーに保持するかどうかを指定します。

この環境設定の有効な値は、次のとおりです。

•	yes	Graphics Builderがパスワードをメモリーに保持することを指定します。

•	No	Graphics Builderがパスワードをメモリーに保持しないことを指定します。

たとえば、パスワードをメモリーに保持しておき、他の製品を起動して、現在使用されているのと同じユーザー名とパスワードをその製品に渡すことができます。

セキュリティの問題上危険だと判断したら、「no」と指定することもできます。

この環境設定は、環境設定ファイルに直接入力してください。「環境設定」ダイアログでは設定できません。

例

Graphics Builderがユーザーのパスワードをメモリーに保持するようにこの環境設定を設定します。次のような行を環境設定ファイルに追加します。

OracleGraphics.Keep_Password = Yes


?


 「配置」メニュー

この項では、次のGraphics Builderの「配置」メニュー項目について説明します。

「最前面へ移動」

「最背面へ移動」

「前面へ」

「背面へ」

「オブジェクト整列」

「整列繰返し」

「オブジェクト・サイズ設定」

「サイズ設定繰返し」

「グループ化」

「グループ解除」

「グループ操作」


最前面へ移動

グループ（またはレイヤー）内でオブジェクトを他のオブジェクトの最前面に移動させます。最前面のオブジェクトは、常に一番最後に、レイアウト上の同じスペースを共用する他のオブジェクトの上に重ねて描画されます。


最背面へ移動

グループ（またはレイヤー）内でオブジェクトを他のオブジェクトの最背面に移動させます。最背面のオブジェクトは、常に一番最初に描画されるので、そのオブジェクトより前面にあり、なおかつレイアウト上で同じスペースを共用するオブジェクトに、部分的に隠れてしまう場合があります。


前面へ

グループ（またはレイヤー）内で、あるオブジェクトの直後にあるオブジェクトをそのオブジェクトの前面に移動します。オブジェクトは、別のオブジェクトの上に描画されるので、その2つのオブジェクトがレイアウト上の同じスペースを共用している場合は、背面のオブジェクトは部分的に隠れてしまうことがあります。

グループ（またはレイヤー）内で、ある隠れているオブジェクトを隠しているオブジェクトが、隠れているオブジェクトの直前にない場合、その隠れているオブジェクトは数回にわたって前面へ移動する必要があります。


背面へ

グループ（またはレイヤー）内で、あるオブジェクトの直前にあるオブジェクトをそのオブジェクトの背面に移動します。オブジェクトは別のオブジェクトの下に描画されるので、その2つのオブジェクトがレイアウト上の同じスペースを共用している場合は、背面のオブジェクトが部分的に隠れてしまうことがあります。

グループ（またはレイヤー）内で、隠れているオブジェクトが、隠しているオブジェクトの直後にない場合、その隠しているオブジェクトを数回にわたって背面に移動する必要があります。


オブジェクト整列

選択されたオブジェクトを、オブジェクト同士または格子を基準にしてレイアウト上に配置します。指定される整列設定が、「整列繰返し」メニュー・コマンドでのオブジェクトの整列のデフォルトになります。

ダイアログ・ボックス・オプション

相互整列基準

選択されたオブジェクト同士を基準にして整列するように指定します。

格子表示整列基準

選択されたオブジェクトが格子スナップ・ポイントを基準にして整列するように指定します。格子指定をオンにする必要はありません。

水平

選択されたオブジェクトを水平に整列させる方法を指定します。次のオプションの中から選択できます。

なし	オブジェクトの水平位置を変更しないことを指定します。

左	選択されたオブジェクトを、その中で最も左寄りのオブジェクトに合せて左揃えするように指定します。

右	選択されたオブジェクトを、その中で最も右寄りのオブジェクトに合せて右揃えするように指定します。

中央	選択されたオブジェクトの水平中心点を、すべてのオブジェクトにとって平均的な水平位置に揃えます。

分配	選択されたオブジェクトの水平方向の間隔が均一になるように移動し、最も左寄りと最も右寄りのオブジェクトは元の水平位置を維持するように指定します。

寄せ	選択された各オブジェクトの左側をすぐ左のオブジェクトの右側に合せ、最左のオブジェクトは元の位置を維持するように指定します。

垂直

選択されたオブジェクトを垂直に整列させる方法を指定します。次のオプションの中から選択できます。

なし	オブジェクトの垂直位置を変更しないように指定します。

上	選択されたオブジェクトを、最も上の位置にあるオブジェクトの上側が揃うように移動することを指定します。

下	選択されたオブジェクトを、最も下の位置にあるオブジェクトの下側が揃うように移動することを指定します。

中央	選択されたオブジェクトを、その垂直中心点がすべてのオブジェクトの中心点の平均的な垂直位置に揃えます。

分配	選択されたオブジェクトの垂直方向の間隔が均一になるように移動し 、最も上と最も下のオブジェクトの元の垂直位置を維持するように指定します。

寄せ	選択された各オブジェクトの上側をすぐ上のオブジェクトの下側に合せ、最も上のオブジェクトの元の位置は維持するように指定します。


整列繰返し

「オブジェクト整列」ダイアログ・ボックスで指定された現行の整列設定を使用し、現在選択されているオブジェクトを整列させます。


オブジェクト・サイズ設定

選択されたオブジェクトを、オブジェクト同士を基準にしてサイズ変更します。指定されるサイズ設定が、「サイズ設定繰返し」メニュー・コマンドでのオブジェクトのサイズ設定のデフォルトになります。

ダイアログ・ボックス・オプション

幅

選択されたオブジェクトの幅をどのように変更するかを指定できます。次のオプションの中から選択できます。

なし	オブジェクトの幅を変更しないことを指定します。

最小サイズ	その中で一番狭いオブジェクトの幅と同じになるように、各オブジェクトのサイズ変更を指定します。

最大サイズ	その中で一番広いオブジェクトの幅と同じになるように、各オブジェクトのサイズ変更を指定します。

平均	選択されたすべてのオブジェクトの平均の幅になるように、各オブジェクトのサイズ変更を指定します。

カスタム	ここに入力したカスタム幅と同じになるように、各オブジェクトのサイズ変更を指定します。この値の寸法の単位は、「単位」ラジオ・ボタンで指定します。

高さ

選択されたオブジェクトの高さをどのように変更するかを指定できます。次のオプションの中から選択できます。

なし	オブジェクトの高さを変更しないように指定します。

最小サイズ	その中で一番低いオブジェクトの高さと同じになるように、各オブジェクトのサイズ変更を指定します。

最大サイズ	その中で一番高いオブジェクトの高さと同じになるように、各オブジェクトのサイズ変更を指定します。

平均	選択されたすべてのオブジェクトの平均の高さになるように、各オブジェクトのサイズ変更を指定します。

カスタム	ここに入力したカスタム高さと同じになるように、各オブジェクトのサイズ変更を指定します。この値の寸法の単位は、「単位」ラジオ・ボタンで指定します。

単位

「カスタム」を選択した時の高さと幅の値の単位を指定します。


サイズ設定繰返し

「オブジェクト・サイズ設定」ダイアログ・ボックスで指定されている現行のサイズ設定を使用し、現在選択されているオブジェクトのサイズを変更します。


グループ

選択されたすべてのオブジェクトを1つのグループ・オブジェクトに整理統合します。グループ・オブジェクトの8つの制御ポイントが現れ、それが1つのオブジェクトであることが示されます。


グループ解除

選択されたグループ・オブジェクトのグループを解除します。

この場合、グループ・オブジェクトは破棄されます。グループ・オブジェクトを構成するすべての子は、グループ・ツリーの1つ上のレベルに移動しますが、他に変更はありません。この後、それぞれの子は、以前の親と同じレベルに置かれ、以前の親の親の新しい子となります。


グループ操作

グループ・オブジェクトのグループ化、選択および変更を制御します。このコマンドでサブメニューが表示され、そこで実行するグループ操作を指定できます。

「親選択」

「子選択」

「グループに追加」

「グループから削除」


親選択

現在選択されているオブジェクトの親グループを選択します。選択されたオブジェクトがグループのメンバーでないと、親がいないのでエラーが発生します。


子選択

現在選択されているグループ・オブジェクトのすべての子を選択します。この後、その中から1つ子を選択するには、その子を選択します。選択する子が別のグループ・オブジェクトの場合、そのグループ・オブジェクトの子の中から1つ選んで選択します。最初に選ばれたオブジェクトがグループでないと、子がいないのでエラーが発生します。


グループに追加

現在選択されている単一オブジェクトを、現在選択されているグループ・オブジェクトの子にします。少なくとも2つのオブジェクトを選択する必要があります。そのうちの片方のみがグループ・オブジェクトであることが必要です。そうでないと、エラーが発生します。


グループから削除

現在選択されている単一またはグループ・オブジェクトをその親グループから削除し、そのオブジェクトをグループ・ツリーの1つ上のレベルに移動させます。その後、この2つのオブジェクトは、以前の親と同位および以前の親の親の子となります。選択されたオブジェクトがグループのメンバーでないと、親がいないのでエラーが発生します。


 「チャート」メニュー

この項では、次のGraphics Builderの「チャート」メニュー項目について説明します。

「チャート作成」

「枠」

「軸」

「フィールド・テンプレート」

「参照線」

「チャート更新」

「アートワークに変換」


チャート作成

チャートを作成します。

問合せが存在しないと、「新規問合せ」ダイアログ・ボックスで1つ作成するように指示されます。

問合せが存在すると、「チャート生成」ダイアログ・ボックスで1つ選択するか新しい問合せを1つ作成するように指示されます。

問合せを指定すると、「チャート」プロパティ・シートが表示されます。


枠

選択されたチャートの枠のプロパティを変更します。

設定するオプションのプロパティ・ページを次の中から選択してください。

「枠」プロパティ・ページ

深さ、シャドウおよび凡例設定を設定します。

「軸枠」プロパティ・ページ（軸チャートのみ）

基本線、項目幅および第2-Y軸のプロパティを設定します。

「円グラフ」プロパティ・ページ（円グラフのみ）

表示、ラベル、「その他」欄の定義およびその他のプロパティを設定します。

「表枠」プロパティ・ページ（表チャートのみ）

ラベル、グリッド、行または列の数、およびその他のプロパティを設定します。


軸

選択されたチャートの軸のプロパティを変更します。

設定するオプションのプロパティ・ページを次の中から選択してください。

「軸」プロパティ・ページ

ラベル、位置、方向、目盛り、グリッドおよびその他のプロパティを設定します。

「値軸」プロパティ・ページ

軸の最大値、最小値およびスケールを設定します。

「日付軸」プロパティ・ページ

最大値、最小値、ステップ、ラベルおよびその他のプロパティを設定します。

「項目軸」プロパティ・ページ

項目の最小数および最大数を設定します。


フィールド・テンプレート

選択されたチャートのフィールド・テンプレートを変更します。

設定するオプションのプロパティ・ページを次の中から選択してください。

「フィールド」プロパティ・ページ

フィールド・テンプレート名およびカラー/パターン回転の種類を設定します。

「軸フィールド」プロパティ・ページ

表示形式、線の形式、ラベル回転、カーブ調整およびその他のプロパティを設定します。


参照線

選択されたチャートの参照線のプロパティを変更します。

「プロパティ・シート」オプション

参照線

変更する参照線を選択します。このリストには、選択されたチャートのテンプレートに存在するすべての参照線が表示されます。

凡例

凡例に表示する参照線を識別するテキスト・ラベル。

Value

参照値であり、この値で参照線が表示されます。

軸のマッピング

参照値がその位置を判断するために比較される軸を指定します。

作成

選択されたチャートのテンプレートに対し、新しい参照線を作成します。

削除

選択されたチャートのテンプレートから参照線を削除します。


チャート更新

選択されたチャートを、関連付けられた問合せとチャート・テンプレートに基づいて再作成します。関連付けられた問合せとチャート・テンプレートは、チャートが最後に描画されてから変更された可能性があります。

チャートは、それが動的チャートの場合にのみ更新できます。チャートを「アートワークに変換」メニュー・コマンドによりアートワークに変換した場合は、更新できません。


アートワークに変換

更新可能な動的チャートを更新不可な静的チャートに変更します。

静的チャートは、他のグループ・オブジェクトとまったく同様に扱う必要があります。その子の選択や単一のオブジェクトの編集が可能です。しかし、チャートはその問合せまたはテンプレートに基づいて更新することは不可能であるという点に注意してください。Graphics Builderでは、基本的に静的チャートはチャートとはみなされません。

静的チャートを動的チャートに変換することはできません。しかし、チャートの問合せおよびテンプレートがまだ利用できる場合は、チャートを再度作成できます。


 「編集」メニュー

この項では、次のGraphics Builderの「編集」メニュー項目について説明します。

元に戻す

カット

コピー

ペースト

消去

複製

すべて選択

オブジェクト選択

解像度の減少

プログラム単位の同期化

検索/置換


元に戻す

一番最後に実行した操作を取り消します。たとえば、誤ってオブジェクトを削除した場合、「元に戻す」を実行すると、削除されたオブジェクトが回復されます。

操作によっては(図表の上書き保存など)、取り消せないので注意してください。このような場合は、「元に戻す」メニュー項目が非アクティブになっています。

ダイアログ・ボックス内で「元に戻す」は選択できません。ダイアログ内での変更を取り消すには、変更を確定せずにそのダイアログの「元に戻す」または「クローズ」ボタンを選択します。


カット

現在選択されているオブジェクトまたはテキストを削除し、それをクリップボードに記憶させます。この後、「ペースト」メニュー項目を使用してクリップボードの内容を図表に取り込むことができます。

「カット」操作を実行するたびに、クリップボードの内容は上書きされます。「カット」操作を取り消すと、クリップボードの以前の内容は復元されません。


コピー

現在選択されているオブジェクトまたはテキストをクリップボードに記憶させます。このときに、「カット」のようにコピー元が削除されることはありません。この後、「ペースト」メニュー項目を使用してクリップボードの内容を図表に取り込むことによってできます。

「コピー」操作を実行するたびに、クリップボードの内容は上書きされます。「コピー」操作は取り消すことはできません。


ペースト

クリップボードの内容(つまり一番最後にカットまたはコピーされたオブジェクトかテキスト)を現行ウィンドウのレイアウトに取り込みます。

クリップボードが空の場合またはペースト操作ができない場合(四角形はテキスト・フィールドにペーストできません)は、「ペースト」メニュー項目が非アクティブになっています。

ペースト操作では、クリップボードの内容は変更されません。必要に応じて、クリップボードの内容を何回もペーストできます。


消去

現在選択されているオブジェクトまたはテキストを、クリップボードに記憶させずに削除します(「カット」ではクリップボードに記憶させます)。

「消去」操作では、クリップボードの内容は変更されません。


複製

選択されたオブジェクト(複数可)の完全なコピーを作成します。

選択されたオブジェクトのコピーはレイアウト上に置かれますが、元の位置からは少しずれます。元のオブジェクトは選択解除され、そのコピーが選択された状態になります。

「複製」操作では、クリップボードの内容は変更されません。


すべて選択

レイアウト上のオブジェクトをすべて選択します。

「すべて選択」を選択したときに、オブジェクトが現行で選択されていないと、レイアウトのアクティブなレイヤー上のオブジェクトがすべて選択されます。

「すべて選択」を選択したときにオブジェクトが1つ選択されていると、グループ・ツリー内のそのオブジェクトの同位オブジェクトがすべて選択されます。


オブジェクト選択

名前付きのグラフィカル・オブジェクトが選択または選択解除されます。

ダイアログ・ボックス・オプション

名前

選択または選択解除するオブジェクトの名前。

選択

指定されたオブジェクトを選択します。

選択解除

指定されたオブジェクトを選択解除するか、または現在の選択(ある場合)から削除します。


解像度の減少

選択されたイメージの解像度を、現在のサイズで正確に表示するのに必要な最低の解像度に減らします。Graphics Builderは、余分な解像度情報を破棄します。

イメージを小さくサイズ変更しても、デフォルトの動作はそのイメージの元の解像度を維持しますが、小さくなったイメージは、品質を落とさずに元の解像度より低い解像度で表示することができます。サイズ変更されたイメージの解像度を減少させると、イメージの操作に必要なメモリー量と同様に図表の保存に必要な記憶領域も減らします。

イメージの解像度を増加させることはできません。このため、一旦イメージを小さくして解像度を減少させると、その後でイメージを元のサイズに戻したときにイメージの品質は落ちてしまいます。


プログラム単位の同期化

デザイナ図表のプログラム単位の状態を、ランタイム・デバッガのプログラム単位の現在の状態に置き換えます。これにより、プログラム単位をランタイムでテストし、希望する動作が可能になるように変更し、その後でその変更をデザイナの図表に取り込むことができます。

このメニュー項目は、ランタイム・シミュレーションの場合のみ使用可能です。

警告: デザイナ図表のすべてのプログラム単位は、それらのランタイムのプログラム単位によって上書きされます。ランタイム・シミュレーション時に削除されたデザイナのプログラム単位は、デザイナの図表からも削除されます。


検索/置換

PL/SQLプログラム単位内のテキストを検索し置き換えます。このコマンドは、プログラム単位エディタ内でのみ有効です。

ダイアログ・ボックス・オプション

次を検索

プログラム単位内で検索するテキスト。正規表現を検索するには、ここに入力し「正規表現」チェックボックスを選択します。

置換

検索されたテキストを、ここに入力されたテキストに置き換えます。

正規表現

検索文字列テキストが正規表現かどうかを指定します。

大/小文字区別

検索文字列テキストと大文字と小文字の使い分けが完全に一致するテキストのみを検索します。

次を検索

検索文字列テキストの次の候補を検索し、ハイライト表示します。

置換

現在の選択内容を置換テキストに置き換え、検索テキストの次の候補を探します。

すべて置換

検索文字列テキストのすべての候補を置換テキストに置き換えます。この場合、候補ごとに止まって反転表示しません。カーソル位置以降のテキストのみを一括して変更します。


 「ファイル」メニュー

このセクションでは、次のGraphics Builderの「ファイル」メニュー項目について説明します。

新規作成

OPEN文

CLOSE文

上書き保存

別名保存

変更の破棄

インポート

エクスポート

実行

コンパイル

すべてコンパイル

一貫性チェック

接続

切断

管理

印刷

ページ設定

最近アクセスされたファイルのリスト

EXIT文


作成

新規図表またはPL/SQLライブラリを作成します。

このメニュー項目を選ぶと、次のサブメニューが表示されます。

図表	新規の図表を作成します。新規の図表のノードがオブジェクト・ナビゲータに表示され、次に図表のレイアウト・エディタが現れます。

ライブラリ	新規のPL/SQLライブラリを作成します。オブジェクト・ナビゲータのオープン・ライブラリ・ノードの下に、新規ライブラリのノードが表示されます。


オープン

ファイルまたはデータベースに格納された既存の図表を取り出します。

複数の図表を同時にオープンするときには、1つの図表を同じGraphics Builderセッションでオープンすることはできません。

ダイアログ・ボックス・オプション

オブジェクト・アクセス

オープンする図表の位置を指定します。「データベース」を選択すると、「データベースからオープン」ダイアログ・ボックスが表示されます。「ファイル・システム」を選択すると、システムの「ファイルを開く」ダイアログが表示されます。

図表

ファイルまたはモジュールをオープンするように選択するときに、表示するタイプを指定します。


クローズ

現行の図表を取り消します。

変更しても図表が保存されていない場合は、ダイアログ・ボックスが表示されるので、変更の保存、変更の廃棄またはクローズ操作の取消しのいずれかを選択できます。


保存

次の条件で、現行の図表をファイルまたはデータベースに格納します。

•	図表が、現行セッションで以前に保存されたことがある場合、そのときと同じ名前で同じ場所に上書き保存されます。

•	図表がオープンされた後、上書き保存されていない場合、オープンされたときの名前と場所に保存されます。

•	図表が、新規作成のためまだ保存されていない場合は、「保存」ダイアログ・ボックスが表示されます。そこで図表の格納場所を指定できます。


別名保存

現行の図表を、新しく指定した名前で新しい場所に格納します。

このメニュー項目を選ぶと、次のサブメニューが表示されます。

データベース

「データベースへ保存」ダイアログ・ボックスが表示されます。

ファイル・システム

使用しているシステムの「ファイル名を付けて保存」ダイアログを表示します。

その図表を以前に保存したことがない場合、「別名保存」を選択するとデフォルトで「Dispx」(xには数字が入る)という名前で保存されます。それ以外の場合は、デフォルトで図表は最後にオープンまたは保存された名前で上書き保存されます。


変更の破棄

図表に対する変更をすべて破棄し、最後に保存またはオープンされたときの状態に戻します。

変更の破棄は、次の条件で行われます。

•	図表が、現行セッションで以前に保存されたことがある場合、そのときの状態に戻ります。

•	図表がオープンされた後、ー度も上書き保存されていない場合、オープンされたときの状態に戻ります。

•	図表が、新規作成のためまだー度も保存されたことがない場合、変更はすべて破棄され初期の状態に戻ります。


インポート

ファイルまたはデータベースに格納されているモジュールを現行の図表に組み込みます。

インポートするオブジェクトのサブメニュー項目を選択してください。

図表

データベースまたはファイルに保存された図表を現在の図表にマージします。このコマンドを選択すると、「図表インポート」ダイアログ・ボックスが表示されます。

描画

線による描画を現行のレイアウトに配置します。このコマンドを選択すると、「インポート」ダイアログ・ボックスが表示されます。

イメージ

ビットマップ・イメージを現在のレイアウトに挿入します。このコマンドを選択すると、「イメージ・インポート」ダイアログ・ボックスが表示されます。

サウンド

データベースまたはファイル・システムに格納されているサウンドから新しいサウンドを作成します。このコマンドを選択すると、「サウンド・インポート」ダイアログ・ボックスが表示されます。

テキスト

テキストをPL/SQLプログラム単位エディタからファイルへ移します。このコマンドを選択すると、システムの「ファイルを開く」ダイアログが表示されます。

テンプレート

ファイルまたはデータベースに格納されているチャート・テンプレートを現行の図表に取り込みます。このコマンドを選択すると、「インポート」ダイアログ・ボックスが表示されます。

カラー・パレット

図表の現在のカラー・パレットを新しいものに置き換えます。このメニュー項目が使用可能になるのは、図表のカラー・パレット・モードが、「ツール・オプション」ダイアログ・ボックスで「Editable」（編集可能）に設定されている場合に限ります。このコマンドを選択すると、「インポート」ダイアログ・ボックスが表示されます。


エクスポート

モジュールを現在の表示からファイルまたはデータベースへ格納します。

次に、「エクスポート」サブメニュー項目について説明します。

描画

表示されているレイヤーの内容をファイルまたはデータベースへ格納します。このコマンドを選択すると、「エクスポート」ダイアログ・ボックスが表示されます。

イメージ

選択したイメージをファイルまたはデータベースに格納します。このコマンドを選択すると、「イメージ・エクスポート」ダイアログ・ボックスが表示されます。

サウンド

現在の表示にサウンドをロードします。このコマンドを選択すると、「サウンド・エクスポート」ダイアログ・ボックスが表示されます。

テキスト

テキストをPL/SQLプログラム単位エディタからファイルへ移します。このコマンドを選択すると、システムの「ファイル名を付けて保存」ダイアログが表示されます。

テンプレート

チャート・テンプレートを現行の図表からファイルまたはデータベースへ格納します。このコマンドを選択すると、「エクスポート」ダイアログ・ボックスが表示されます。

カラー・パレット

現行図表のカラー・パレットをファイルまたはデータベースに格納します。このコマンドを選択すると、「エクスポート」ダイアログ・ボックスが表示されます。


実行

図表をランタイム・シミュレーション・モードで実行します。図表のランタイム実行をシミュレートし、PL/SQLコードのロジック内のエラーの位置を見つけます。

図表を実行すると、Graphics Builderは、組み込まれているすべてのPL/SQLコードのバッチ・コンパイルを行います。コンパイル・エラーがなければ、図表の「主レイアウト」ウィンドウが表示されます。


コンパイル

図表の中のプログラム単位のうち、現在まだコンパイルされていないものがすべてコンパイルされ、「コンパイル」ダイアログ・ボックスが表示されます。すでにコンパイル済みのプログラム単位は、これによる影響を受けません。


すべてコンパイル

図表の中のすべてのプログラム単位は、コンパイル済みかどうかに関係なく再コンパイルされ、「コンパイル」ダイアログ・ボックスが表示されます。現在コンパイル済みのプログラム単位は、最初に無効にされ、その後再コンパイルされます。


一貫性チェック

図表の様々な部分で矛盾がないことを検証します。たとえば、パラメータ・リストが誤って削除されたボタン・プロシージャは正常にコンパイルできますが、図表の実行時には正確に機能しません。一貫性チェックによって、この問題は通知されます。

一貫性チェックの後、次のメッセージのうち1つまたは複数のメッセージが表示されます。

一貫性エラーはありませんでした。

原因:	図表に一貫性エラーはありません。

処置:	なし。

<trigger_type>:プロシージャ'<proc_name>'が見つかりません。

原因:	PL/SQLプログラム単位をトリガーとして名前を付けましたが、Graphics Builderはその名前のプロシージャを見つけられませんでした。

処置:	次のことを確認してください。

•	「トリガー」ダイアログで名前を付けたプロシージャを定義およびコンパイルした。

•	「トリガー」ダイアログとプロシージャのヘッダーの両方で正確な名前を使用した。

•	トリガーに関連付けたプログラム単位は、プロシージャである(ファンクションまたはパッケージではない)。

<trigger_type>:プロシージャ '<proc_name>' にパラメータがありません。

原因:	トリガーに関連付けたPL/SQLプロシージャには、起動時に引数が渡される必要があります。Graphics Builderが引数なしでトリガー・プロシージャを起動したので、これは無効です。

処置:	トリガーに、引数を必要としないプロシージャを割り当ててください。

プロシージャ: '<proc_name>' (オブジェクト: '<obj_name>' に関係)が存在しません。

原因:	PL/SQLボタン・プロシージャをオブジェクトと関連付けましたが、Graphics Builderはその名前のプロシージャを見つけられませんでした。

処置:	オブジェクトの「オブジェクト・プロパティ」ダイアログの「プロシージャ」フィールドの名前が、定義されたプロシージャの名前に一致するか確認してください。

プログラム単位: '<pu_name>'(オブジェクト: '<obj_name>'に関係)が、プロシージャではありません。

原因:	オブジェクトに関連付けたプログラム単位が、プロシージャではありません。ファンクションまたはパッケージをオブジェクトに関連付けることはできません。

処置:	オブジェクトの「オブジェクト・プロパティ」ダイアログの「プロシージャ」フィールドの名前が、有効なプロシージャの名前であることを確認してください。

プロシージャ '<proc_name>'(オブジェクト: '<obj_name>'に関係)には引数が4つ必要です。

原因:	オブジェクトに関係付けたPL/SQLプロシージャのヘッダーに、ボタン・プロシージャに必要な4つの引数が含まれていません。

処置:	プロシージャのヘッダーに必要な4つの引数が含まれていることを確認してください。

プロシージャ: '<proc_name>'(オブジェクト: '<obj_name>'に関係)の引数型が正しくありません。

原因:	オブジェクトに関連付けたPL/SQLプロシージャのヘッダーに含まれる1つ以上の引数が、ボタン・プロシージャに必要なタイプの引数ではありません。

処置:	プロシージャ・ヘッダーに含まれる引数が正しいタイプで、なおかつ正しい順序で列記されていることを確認してください。


接続

データベースにログオンします。

各テキスト・ボックスに別々に入力するか、または「ユーザー名」テキスト・ボックス内の1行に次のすべてを入力できます。

username/password@database

また、次のように「ユーザー名」テキスト・ボックスにユーザー名とデータベースのみを入力して、「パスワード」テキスト・ボックスにパスワードを入力すると、パスワードを表示させないようにできます。

username@database

ダイアログ・ボックス・オプション

ユーザー名

接続するデータベース・アカウントのユーザー名です。

パスワード

データベース・アカウントのパスワードです。

データベース

データベースを指定する接続文字列です。リモート・データベースに接続するには、適切なSQL*Netデータベース接続文字列も入力する必要があります。


切断

現行のデータベース接続をクローズします。


管理

データベースに格納されているモジュールの管理およびランタイム用図表ファイル(.ogr)の生成、ファイルのソース制御の管理を行うことができます。

このメニュー項目を選択すると、次のサブメニュー項目が表示されます。

アクセス

データベースに格納されているモジュールへのアクセス権の付与または取消しを行います。このサブメニューでモジュール・タイプを選択すると、「データベース上モジュールへのアクセス」ダイアログ・ボックスが表示されます。

削除

データベースに格納されているモジュールを削除します。このサブメニューからモジュール・タイプを選択すると、「データベースから削除」ダイアログ・ボックスが表示されます。

改名

データベースに格納されているモジュールの名前を変更します。モジュール・タイプを選択すると、「改名」ダイアログ・ボックスが表示されます。

生成

現行の図表のランタイム・バージョンが作成されます。データベースへの保存を選択すると、「データベースへ保存」ダイアログ・ボックスが表示されます。ファイル・システムへの保存を選ぶと、システムの「ファイル名を付けて保存」ダイアログ・ボックスが表示されます。

図表を生成すると、コンパイルされていないPL/SQLプログラム単位は自動的にコンパイルされます。コンパイル・エラーまたはその他のエラーが発生すると、エラー・メッセージが表示され生成作業は異常終了します。

チェックイン

「ソース制御: チェックイン」ダイアログが起動します。ここで、図表ファイルにチェックインしてアーカイブすることができます。このコマンドは、Polytron Version Control System (PVCS)がインストールされている場合に限り使用可能です。

図表ファイルをチェックインすると、PVCSは、バイナリからテキストへの変換を自動的に行い、そのファイルをテキスト・ファイルとして指定の場所にアーカイブします。

「ソース制御: チェックイン」ダイアログ・ボックスも参照。

チェックアウト

「ソース制御: チェックアウト」ダイアログが起動します。ここで、ソース制御アーカイブから以前チェックインした図表ファイルを取り出すことができます。このコマンドは、Polytron Version Control System (PVCS)がインストールされている場合に限り使用可能です。

アーカイブされたファイルは、テキスト・ファイルとして格納されます。ファイルをチェックアウトすると、Graphics Builderは、そのテキスト・ファイルを、デザイナで編集できるように自動的にバイナリ・ファイル(.OGD)に変換します。

「ソース制御: チェックアウト」ダイアログ・ボックスも参照。

ソース制御オプション

「ソース制御オプション」ダイアログが起動します。ここで、ソース制御システム・オプションを設定できます。このコマンドは、Polytron Version Control System (PVCS)がインストールされている場合に限り使用可能です。

「ソース制御: オプション」ダイアログ・ボックスも参照。


Print(印刷)

デフォルト・プリンタへレイアウトを出力します。

表示されているレイヤーのみが印刷されます。

「印刷」メニュー項目を選択すると、システムによっては「印刷」ダイアログが表示されることがあります。詳細は、使用しているマニュアルを参照してください。


ページ設定

ページ・サイズ、方向およびその他の出力関連の設定値を設定します。

このダイアログはシステムによって異なります。詳細は、使用しているマニュアルを参照してください。


最近アクセスされたファイルのリスト

最近アクセスされた4つのファイルを降順にリストします。ファイルタイプは.ogdと.pllのいずれかです。.ogdファイルのファイル名をダブルクリックすると、そのファイルがデザイナでオープンされ、.pllファイルのファイル名をダブルクリックすると、ライブラリがロードされます。


終了

Graphics Builderセッションを終了します。

オープンされている図表がすべてクローズされ、セッションが終了します。図表が最後に保存またはオープンされてから修正された場合は、変更の保存、変更の廃棄または終了操作の異常終了のいずれかを求めるプロンプトが表示されます。


 「書式」メニュー

この項では、Graphics Builderの次のような「書式」メニュー項目について説明します。

フォント

間隔

文字揃え

方向

線グラフ

線種

凹凸

矢印

記号

描画オプション

カラー・パレット

数値

日付


フォント

選択されたテキストのフォント書体を設定します。システムによって、「フォント」を選ぶとサブメニューが表示されその中にフォント・リストがある場合と、「フォント」を選択するとダイアログ・ボックスが表示される場合とがあります。

使用可能なフォントはシステムによって異なりますが、Times、Helvetica、Courierなどのオプションがあります。詳細は、使用しているマニュアルを参照してください。

テキスト・オブジェクトが選択されていると、指定されたフォントがそのオブジェクト内のすべてのテキストに適用されます。テキスト・オブジェクト内のテキストのみが選択されていると、指定したフォントがそのテキストに適用されます。

フォントを指定した時にテキストが選択されていなくても、その指定されたフォントが、以後作成されるすべてのテキストのデフォルトになります。


間隔

テキスト・オブジェクトの行間隔を設定します。

このメニュー項目を選ぶと、次のサブメニュー・オプションが表示されます。

シングル

行間隔が、各行で最大のテキストのポイント・サイズに等しくなります。

1 1/2

行間隔が、各行で最大のテキストの1.5倍のポイント・サイズに等しくなります。

ダブル

行間隔が、各行で最大のテキストの2倍のポイント・サイズに等しくなります。

カスタム

行間隔を必要に合せて入力できます。このサブメニューを選ぶと、次に説明する「カスタム間隔」ダイアログ・ボックスが表示されます。

ダイアログ・ボックス・オプション

間隔サイズを選択するか、または「カスタム」を選んでテキスト・ボックスに間隔サイズを入力します。


文字揃え

テキスト・オブジェクト内で、バウンディング・ボックスを基準にしたテキストの文字揃えを設定します。

このメニュー項目を選ぶと、次のサブメニュー・オプションが表示されます。

[←]

テキストの各行の左側を、テキスト・ボックスのバウンディング・ボックスの左枠に揃えます。

中央揃え

テキストの各行の中央を、テキスト・オブジェクトのバウンディング・ボックスの水平中央に揃えます。

[→]

テキストの各行の右側を、テキスト・オブジェクトのバウンディング・ボックスの右枠に揃えます。

開始

テキストを、システムの言語設定で指示されている開始点に合せます。たとえば、英語のシステムではテキストを左揃えしますが、アラブ語のシステムでは右揃えします。

[End]

テキストを、システムの言語設定で指示されている終点に合せます。たとえば、英語のシステムではテキストを右揃えしますが、アラブ語のシステムでは左揃えします。


方向

新規のテキストがテキスト・オブジェクトに挿入されるときの方向を設定します。

このメニュー項目を選ぶと、次のサブメニュー・オプションが表示されます。

デフォルト

新規テキストをシステムの言語設定で指示されている方向に挿入します。たとえば、英語のシステムではテキストを左から右へ挿入しますが、アラブ語のシステムでは右から左へ挿入します。

左から右

新規テキストを左から右へ挿入します。

右から左

新規テキストを右から左へ挿入します。


線

線またはオブジェクト枠の線幅を設定します。

サブメニューから線幅を選択してください。「カスタム」を選択すると、次の「カスタム線幅」ダイアログ・ボックスが表示されます。

ダイアログ・ボックス・オプション

幅

線幅。

単位

線幅を指定するときの寸法の単位。


線種

線またはオブジェクト枠の線種を設定します。

サブメニューから線種を選択してください。


凹凸

線またはオブジェクト枠の凹凸のスタイルを設定します。

サブメニューから凹凸スタイルを選択してください。


矢印

線の矢印スタイルを設定します。

サブメニューから矢印スタイルを選択してください。


記号

記号のサイズを設定します。

サブメニューから記号サイズを選択してください。


描画オプション

描画スタイルと描画オプションを設定します。

設定するオプション用のサブメニュー項目を選択してください。

一般

端形式、結合形式、角/中心からの描画および転送モードを設定します。

円弧

円弧の形および閉じを設定します。

テキスト

テキストの原点、枠ボックス、ワードラップおよびその他のオプションを設定します。

丸い四角形

丸い四角形の角の丸め半径を設定します。

イメージ

イメージの品質および粗さオプション（ディザー）を設定します。


カラー・パレット

カラー・パレットに定義されているカラーを変更します。

このメニュー項目が使用可能になるのは、「ツール・オプション」ダイアログ・ボックスのカラー・パレット・モードが「Editable」(編集可能)の場合に限ります。

カラー・パレットは図表とともに保存されるので、カラー・パレットに対する変更も保存されます。

ダイアログ・ボックス・オプション

編集するカラーの選択

現行のカラー・パレットの内容を表示します。変更するカラーのカラー・セルを選択してください。

現在のカラー

カラー・パレットで現在選択されているカラー名。カラー名を変更するには、新しい名前をこのテキスト・ボックスに入力し、「改名」を選択してください。

編集

システムのダイアログが表示されるので、そこで選択されたカラーの定義を変更できます。詳細は、使用しているマニュアルを参照してください。

改名

選択されたカラー名を「現在のカラー」テキスト・ボックスに表示されている名前に変更します。


数値

使用可能な数値書式マスクを追加、削除または適用します。チャート要素以外のテキスト・オブジェクトには、書式マスクを適用できません。

このメニュー項目を選択すると、「数値書式」ダイアログ・ボックスが表示されます。


日付

使用可能な日付書式マスクを追加、削除または適用します。チャート要素以外のテキスト・オブジェクトには、書式マスクを適用できません。

このメニュー項目を選択すると、「日付書式」ダイアログ・ボックスが表示されます。


 「ヘルプ」メニュー

「ヘルプ」メニューはシステムによって異なります。詳細は、使用しているマニュアルを参照してください。ただし、次にリストしたメニュー項目は必ず表示されます。

Graphics Builderヘルプ・トピック

キュー・カード

クイック・ツアー

モジュール情報

Graphics Builderについて


内容

Graphics Builderのヘルプ・システムを起動します。可能な場合、ヘルプ・システムでは、使用しているオペレーティング・システムの標準ヘルプ・インタフェースを使用します。使用できない場合は、Oracleヘルプ・システムが表示されます。


キュー・カード

キュー・カードを起動します。キュー・カードは、Graphic Builderの多くの基本的なタスクを実行するときに便利なカードです。


クイック・ツアー

クイック・ツアーを起動します。

クイック・ツアーには、Graphic Builderで利用できるツールの概要と、図表作成の処理に関する基本的な手順が含まれます。


モジュール情報

現行図表の作成情報と改訂情報を表示します。

ダイアログ・ボックス・オプション

作成

図表がデータベースに保存されている場合は、図表作成についての情報が表示されます。

ユーザー名	図表を最初にデータベースに保存したユーザーの名前です。

Date	最初に図表がデータベースに保存された日付です。

バージョン	図表を作成するときに使用したGraphics Builderのバージョンです。

最終変更

図表がデータベースに保存されている場合は、図表変更についての情報が表示されます。

ユーザー名	図表を最後にデータベースに保存したユーザーの名前です。

Date	図表が最後にデータベースに保存された日付です。

バージョン	図表を最後に更新したときに使用したGraphicsBuilderのバージョンです。

Copyright

図表についての著作権情報を表示します。著作権は、図表を他のユーザーに分配する場合に有用です。また、著作権は、Graphics Builder Runtime実行プログラム内の「モジュール情報」ダイアログ・ボックスにも表示されます。分配する図表のランタイム・バージョンの中に表示するテキストをここに入力してください。このフィールドのデフォルト値は、「ツール・オプション」ダイアログ・ボックス内の「メッセージ」フィールドの内容です。


Graphics Builderについて

バージョン番号、著作権情報などを含めたGraphics Builder実行プログラムについての情報を表示します。


 「ナビゲータ」メニュー

この項では、次のGraphics Builder Navigatorのメニュー項目について説明します。

「作成」

DELETE文

拡張

縮小

すべて拡張

すべて縮小

マーク設定

マークへジャンプ

ナビゲータ・オプション


作成

現在選択されているオブジェクトまたは上位ノードと同じタイプの新規オブジェクトを作成します。


削除

現在選択されているオブジェクトを削除します。


拡張

現在選択されているノードの直接の子を表示します。


縮小

現在選択されているノードの直接の子を隠します。


すべて拡張

現在選択されているノードの子ノードを再帰的に拡張します。


すべて縮小

現在選択されているノードの子ノードを再帰的に縮小します。


マーク設定

現在選択されているノードに参照マークを設定します。これにより、オブジェクト・ナビゲータで他のオブジェクトの作業をした後、「マークへジャンプ」メニュー項目を選んで、マーク設定されたノードに戻れます。


マークへジャンプ

「マーク設定」メニュー項目で以前マーク設定されたノードを選択します。


ナビゲータ・オプション

オブジェクト・ナビゲータのオブジェクトの外観を判別するためのオプションを設定します。

ダイアログ・ボックス・オプション

参照ノード表示

あるオブジェクト下にあり、そのオブジェクトが参照する他のオブジェクトを表すノードを表示します。たとえば、チャート・オブジェクトは問合せノードを含み、その問合せノードは、チャートが参照する問合せを表示します。

参照元ノード表示

あるオブジェクト下にあり、他のオブジェクトによるそのオブジェクトの参照を表すノードを表示します。たとえば、問合せオブジェクトは、その問合せがチャートによって参照されることを表示します。


 「テンプレート」メニュー

この項では、次のGraphics Builder「テンプレート」メニュー項目について説明します。

「作成」

「改名」

DELETE文

「枠」

「軸」

「フィールド・テンプレート」

「参照線」


作成

新しいチャート・テンプレートを作成します。

新しい図表を作成する場合、チャート・テンプレート・エディタにはまだチャート・テンプレートは入っていません。既存のテンプレートがない状態から初めてテンプレートを作成する場合は、次の手順を実行してください。

•	「テンプレート」 [image] 「作成」を選択します。

•	「タイプ」メニューからチャート・タイプを選択します。"template0"という名前の新しいチャート・テンプレートが自動的に作成されます。

このダイアログをアクセプトすると、新しいチャート・テンプレートがチャート・テンプレート・エディタに表示されます。

ダイアログ・ボックス・オプション

タイプ

作成するチャートのタイプです。選択したいチャート・タイプのアイコンを選択します。

名前

テンプレート名。


改名

チャート・テンプレート・エディタに表示されているテンプレートの名前を変更します。

ダイアログ・ボックス・オプション

名前

テンプレートの新しい名前です。


削除

チャート・テンプレート・エディタに表示されているテンプレートを削除します。


枠

チャート・テンプレート・エディタに表示されているテンプレートの枠プロパティを変更します。

設定するオプションのプロパティ・ページを次の中から選択してください。

「枠」プロパティ・ページ

深さ、シャドウおよび凡例のプロパティを設定します。

「軸枠」プロパティ・ページ（軸チャートのみ）

基本線、項目幅および第2-Y軸のプロパティを設定します。

「円グラフ」プロパティ・ページ（円グラフのみ）

表示、ラベル、「その他」欄の定義およびその他のプロパティを設定します。

「表枠」プロパティ・ページ（表チャートのみ）

ラベル、グリッド、行または列の数、およびその他のプロパティを設定します。


軸

チャート・テンプレート・エディタに表示されているテンプレートの軸プロパティを変更します。

設定するオプションのプロパティ・ページを次の中から選択してください。

「軸」プロパティ・ページ

ラベル、位置、方向、目盛り、グリッドおよびその他のプロパティを設定します。

「値軸」プロパティ・ページ

軸の最大値、最小値およびスケールを設定します。

「日付軸」プロパティ・ページ

最大値、最小値、ステップ、ラベルおよびその他のプロパティを設定します。

「項目軸」プロパティ・ページ

項目の最小数および最大数を設定します。


フィールド・テンプレート

チャート・テンプレート・エディタに表示されているチャート・テンプレートのフィールド・テンプレート・プロパティを変更します。

設定するオプションのプロパティ・ページを次の中から選択してください。

「フィールド」プロパティ・ページ

フィールド・テンプレート名およびカラー/パターン回転の種類を設定します。

「軸フィールド」プロパティ・ページ

表示形式、線の形式、ラベル回転、カーブ調整およびその他のプロパティを設定します。


参照線

チャート・テンプレート・エディタに表示されているテンプレートの参照線プロパティを変更します。

「プロパティ・シート」オプション

参照線

変更する参照線を選択します。現在のテンプレートにある参照線がすべて、このリストに表示されます。

凡例

凡例に表示する参照線を識別するテキスト・ラベル。

値

参照値であり、この値で参照線が表示されます。

軸のマッピング

参照値がその位置を判断するために比較される軸を指定します。

作成

現在のテンプレートの新しい参照線を作成します。

削除

現在のテンプレートから参照線を削除します。


 「ツール」メニュー

この項では、次のGraphics Builder「ツール」メニュー項目について説明します。

「プロパティ」

「PL/SQLインタプリタ」

「プログラム単位」

「ストアド・プログラム単位」

「データベース・トリガー」

「図表」

「レイヤー」

「パラメータ」

「問合せ」

「テンプレート」

「タイマー」

「ツール・オプション」


プロパティ

選択したオブジェクトのプロパティを設定します。オブジェクトの選択は、レイアウト上か、またはオブジェクト・ナビゲータ内で実行することができます。

修正するオブジェクト・タイプを選択します。

「チャート」

チャートタイプ、問合せ、項目、値およびその他のプロパティを設定します。

「図表」

オープン・トリガーおよびクローズ・トリガーを設定し、パラメータの日付書式を変更します。

「グラフィック・オブジェクト」

名前、ボタン・プロシージャおよびドリル・ダウンのプロパティを設定します。

「レイヤー」

レイヤーの作成、削除、非表示化、表示、アクティブ化および改名を実行します。

「パラメータ」

パラメータを作成および削除し、名前、データ型または初期値を設定します。

「問合せ」

問合せを作成および削除し、データ・ソースまたはその他のプロパティを設定します。

「テンプレート」

チャート・テンプレート・エディタを表示します。チャート・テンプレートを作成および削除し、枠、フィールド・テンプレート、軸およびその他のプロパティを設定します。

「タイマー」

タイマーを作成および削除し、タイマー名、トリガー・プロシージャおよび時間間隔を設定します。

「ツール・オプション」


PL/SQLインタプリタ

PL/SQLインタプリタを表示します。これを使用して、PL/SQLプログラム単位を実行およびデバッグできます。


プログラム単位

プログラム単位エディタを表示します。これを使用して、PL/SQLプログラム単位を作成および編集できます。


ストアド・プログラム単位

ストアド・プログラム単位エディタを表示します。これを使用して、ストアドPL/SQLプログラム単位を作成および編集できます。


データベース・トリガー

データベース・トリガー・エディタを表示します。これを使用して、データベース・トリガーを作成および編集できます。


図表

オープン・トリガーおよびクローズ・トリガーを設定し、パラメータの日付書式を変更します。

「プロパティ・シート」オプション

オープン・トリガー

実行時に図表を最初にオープンするときに実行されるPL/SQLプロシージャの名前です。このリストに表示されるのは、有効なオープン・トリガーのみです。

作成

新しいオープン図表トリガーを作成します。

クローズ・トリガー

実行時に図表をクローズするときに実行されるPL/SQLプロシージャの名前です。このリストに表示されるのは、有効なクローズ・トリガーのみです。

作成

新しいクローズ図表トリガーを作成します。

パラメータ日付書式

日付型のパラメータ値に使用される日付書式マスクを指定します。

List

図表において現在使用可能な日付書式マスクを表示し、マスクの追加または削除を許可します。このボタンを選択すると、「日付書式」ダイアログ・ボックスが表示されます。

方向

NLSサポートのための、テキストや矢印などのデフォルトの方向を決定します。「左から右へ」、「右から左へ」または「デフォルト」（現行の言語により決定される）を選択します。


レイヤー

レイヤーの作成、削除、非表示化、表示、アクティブ化および改名を実行します。

ダイアログ・ボックス・オプション

すでにあるレイヤー

図表においてすでに存在するレイヤーを表示します。リスト内のレイヤーの順序によって、レイアウト上へのオブジェクトの表示のしかたが決まります。各レイヤーのオブジェクトは、リスト内のその下で表示されているすべてのレイヤーのオブジェクトに重なります。

作成

"layerx"という名の、新規の空のレイヤーを作成します（xは数値）。

削除

リスト内に選択したレイヤーを削除します。また、そのレイヤーにおけるオブジェクトもすべて削除されます。

隠す/表示

選択したレイヤーが表示されている場合にはそれを非表示にし、非表示になっている場合には表示します。リスト内のレイヤー名の横の'+'は表示中であることを、'-'は隠されていることを表します。アクティブ・レイヤーを非表示にすることはできません。

アクティブ化

選択したレイヤーをアクティブにします。非表示になっているレイヤーは、表示されるように自動的に設定されます。あるレイヤーを非アクティブにする場合は、別のレイヤーをアクティブにしてください。

前へ/後へ/一番前へ/一番後へ

選択したレイヤーをリスト内の1つ前の位置またはリスト内の1つ後の位置、リストの一番前、リストの一番後へ移動します。リスト内のレイヤーの順序によって、レイアウト上へのオブジェクトの表示のしかたが決まります。各レイヤーのオブジェクトは、リスト内のその下で表示されているすべてのレイヤーのオブジェクトに重なります。

アクティブ・レイヤー

現在アクティブになっているレイヤーの名前を表示します。一度に1つのレイヤーしかアクティブにすることができません。

新規名

選択したレイヤーの新しい名前です。「改名」を選択して、レイヤーの改名を行ってください。

改名

選択したレイヤーを、「新規名」テキスト・ボックスで指定されている名前に変更します。


パラメータ

パラメータを作成および削除し、名前、データ型または初期値を設定します。

「プロパティ・シート」オプション

パラメータ

変更するパラメータを選択します。図表においてすでにあるパラメータがすべて、このリストに表示されます。

名前

パラメータの名前です。

Type

パラメータのデータ型です。

初期値

図表を初めて実行する際のパラメータの初期値です。ここに入力された値は、コマンド・ラインに指定された値に取り替えることができ、また、実行時に変更できます。

パラメータ値の長さは、2000バイトを超えてはいけません。


問合せ

問合せを作成および削除し、データ・ソースまたはその他のプロパティを設定します。

設定するオプションのプロパティ・ページを次の中から選択してください。

「問合せ」プロパティ・ページ

問合せの名前、データ・ソースおよび(必要があれば)SQL文を設定します。

「データ」プロパティ・ページ

問合せにより戻されるデータを表示します。

「オプション」プロパティ・ページ

実行、データ・キャッシング・プロパティ、トリガーおよびその他のプロパティを設定します。

「スキーマ」プロパティ・ページ（カスタム問合せのみ）

カスタム列を作成および削除し、名前およびデータ型を設定します。


「問合せ」プロパティ・ページ

問合せの名前、データ・ソースおよび(必要があれば)SQL文を設定します。

「プロパティ・ページ」オプション

問合せ

変更する問合せを選択します。図表においてすでにある問合せがすべて、このリストに表示されます。

名前

問合せの名前です。

Type

問合せのタイプです。次のオプションから1つ選択してください。

SQL文 	問合せにより、指定したSQL SELECT文を基準にして、データがデータベースから取り出されます。「SQL文」テキスト・ボックスにSQL文を入力してください。

SYLKファイル	問合せは、SYLK書式のファイルからデータを検索します。SYLKは、Microsoft Excelなどのアプリケーションで使用されている書式です。問合せを実行すると、データはこのファイルから読み込まれます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

WKSファイル	問合せにより、データがWKS書式のファイルから取り出されます。WKSは、Lotus 1-2-3などの人気のアプリケーションに使用される書式です。問合せを実行すると、そのファイルからデータを読み込みます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

PRNファイル	問合せにより、データがPRN書式のファイルから取り出されます。PRNは、テキスト・ファイル書式です。問合せを実行すると、データはこのファイルから読み込まれます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

カスタム	ユーザーは問合せの列およびデータをカスタマイズできます。列を設定するには、「スキーマ」プロパティ・ページに表示される制御を使用します。データを設定するには、ビルトイン・プロシージャOG_APPEND_ROWを使用します。

外部SQLファイル　問合せにより、データがSQL SELECT文を含むテキスト・ファイルから取り出されます。問合せを実行すると、SQL文がこのファイルから読み込まれ実行されます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

ファイル

SYLK、WKS、PRNまたは外部SQL問合せに使用するファイルの位置と名前を表示します。ファイル・システムの中にあるファイルの位置を確認する場合は、「ブラウズ」ボタンを選択してください。

参照

ファイル名を探して選択し、「ファイル」テキスト・ボックスに表示させることができます。

SQL文

SQL文の問合せにおいて実行されるSQL SELECT文です。

接続

「接続」ダイアログ・ボックスが表示され、データベースへの接続が可能になります。

SQLインポート

テキスト・ファイルの内容を「SQL文」テキスト・ボックスに設定できます。テキストはコピーされますが、ファイルにはリンクされません。あるファイルのSQLテキストへのリンクを作成する場合は、外部SQLファイルの問合せタイプを使用してください。

SQLエクスポート

「SQL文」テキスト・ボックスの内容をファイルに設定できます。

作成

新しい問合せを作成します。

削除

現在の問合せを削除します。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。

データ消去

取り出されたすべてのデータのデータ・キャッシュを消去します。これを使用しても、その問合せ自体が削除されたり、変更されることはありません。


「データ」プロパティ・ページ

問合せにより戻されるデータを表示します。セルを選択すると、データ表示部の上のテキスト・ボックスにそのセルの内容を表示します。データ表示部の最上行に、列名とデータ型が表示されます。

「プロパティ・ページ」オプション

問合せ

変更する問合せを選択します。図表においてすでにある問合せがすべて、このリストに表示されます。

作成

新しい問合せを作成します。

削除

現在の問合せを削除します。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。

データ消去

取り出されたすべてのデータのデータ・キャッシュを消去します。これを使用しても、その問合せ自体が削除されたり、変更されることはありません。


「オプション」プロパティ・ページ

実行、データ・キャッシング・プロパティ、トリガーおよびその他のプロパティを設定します。

「プロパティ・ページ」オプション

問合せ

変更する問合せを選択します。図表においてすでにある問合せがすべて、このリストに表示されます。

実行

どのようなときに問合せを自動的に実行するかを指定します。次のオプションから選択してください。

「オープンされている図表」	ランタイムで図表を最初にオープンするときに問合せを実行します。

タイマー	タイマーに指定した頻度で問合せを実行します。ドロップダウン・リストからタイマーを選択するか、または「編集」を選択して新しいタイマーを作成します。

Data

問合せデータに関連したいくつかのオプションを設定します。

新規データ	問合せの実行により新しく取り出されたデータを処理する方法を決定します。

「旧データを置換」を選択すると、前に実行されたデータがすべて廃棄され、新しく取り出されたデータに置換されます。

「旧データに追加」を選択すると、既存のデータ行がすべて維持され、既存のデータ・セットの一番下に新しいデータ行が追加されます。

旧データの保存	前に取り出されたデータを新しいデータに置換するときにその旧データを特別なバッファに格納するかどうかを指定します。続いて、OG_GET_NUMCELLなどのビルトイン・ルーチンによりこの「古いデータ」バッファをアクセスできます。このプロパティは、「新規データ」の設定が「旧データを置換」になっている場合に限り有効です。

最大行数	問合せデータ・セットに保持されるデータの最大行数を指定します。データを追加した結果、行数が最大値を超えてしまった場合は、すでにあるデータ行が超過した分のみ、データ・セットの一番上から廃棄されます。このプロパティは、「新規データ」の設定が「旧データに追加」になっている場合に限り有効です。また、問合せのmaxflag属性はTRUE（デフォルト）に設定する必要があります。maxflagの設定の詳細は、「最大行フラグ・プロパティ」を参照してください。

日付書式	ファイルの日付データを認識し、「日付」プロパティ・ページに日付がどのように表示されるかを決定するのに使用される書式を指定します。ファイル内の日付がここで指定した書式でない場合は、Graphics Builderはそれを日付として認識しません。

PL/SQL

問合せにより、PL/SQLの使用に関連したいくつかのオプションを設定します。

カスタム実行プロシージャ	（カスタム問合せのみ。）カスタムの問合せが実行されるときに起動するPL/SQLプロシージャです。このプロシージャは通常、問合せをデータに移入するPL/SQL文で構成されています。このリストに表示されるのは、カスタム問合せトリガー・プロシージャ・ヘッダーが有効なプロシージャのみです。

「新規作成」を選択して、新しいカスタム問合せプロシージャを作成してください。

実行後トリガー	問合せが実行された後で起動するPL/SQLプロシージャです。このリストに表示されるのは、問合せ後トリガー・プロシージャ・ヘッダーが有効なプロシージャのみです。

「新規作成」を選択して、新しい実行後プロシージャを作成してください。

作成

新しい問合せを作成します。

削除

現在の問合せを削除します。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。

データ消去

取り出されたすべてのデータのデータ・キャッシュを消去します。これを使用しても、その問合せ自体が削除されたり、変更されることはありません。


「スキーマ」プロパティ・ページ

（カスタム問合せのみ。）カスタム問合せにおける列の名前やデータ型を作成、削除および設定します。

「プロパティ・ページ」オプション

問合せ

変更する問合せを選択します。図表においてすでにある問合せがすべて、このリストに表示されます。

Column

変更する列を選択します。この問合せに対して定義されたすべての列がこのリストに表示されます。

名前

列の名前です。列の名前を変更する場合は、ここに新しい名前を入力して「適用」を選択してください。

Type

列のデータ型。

最大長

列に入るデータの最大の長さ。これは、データ型がCHARの列のみに適用されます。

新規列

新しい列を問合せに追加します。

列削除

現在の列を問合せから削除します。

作成

新しい問合せを作成します。

削除

現在の問合せを削除します。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。

データ消去

取り出されたすべてのデータのデータ・キャッシュを消去します。これを使用しても、その問合せ自体が削除されたり、変更されることはありません。


テンプレート

チャート・テンプレート・エディタを表示します。チャート・テンプレートを作成および削除し、枠、フィールド・テンプレート、軸およびその他のプロパティを設定します。


タイマー

タイマーを作成・削除し、タイマー名、トリガー・プロシージャおよび時間間隔を設定します。

「プロパティ・シート」オプション

タイマー

変更するタイマーを選択します。図表においてすでにあるタイマーがすべて、このリストに表示されます。

名前

タイマーの名前。

プロシージャ

タイマーが起動したときに実行されるPL/SQLプロシージャ（存在する場合）です。このリストに表示されるのは、タイマー・トリガー・プロシージャ・ヘッダーが有効なプロシージャのみです。

新しいタイマー・プロシージャを作成するには、「作成」を選択してください。

間隔

それぞれタイマーが起動してから次に起動するまでの時間です。

アクティブ

タイマーを起動するかどうかを指定します。

作成

新しいタイマーを作成します。

削除

現在のタイマーを削除します。


ツール・オプション

各種のGraphics Builderオプションを変更します。

設定するオプションのダイアログ・タブを選択してください。

「デフォルト」タブ

Copyrightメッセージ、カラー・パレット、数値/日付書式リストおよびページ・サイズを設定します。

「環境設定」タブ

起動オプションおよびその他の一般設定を設定します。


「デフォルト」タブ

Copyrightメッセージ、カラー・パレット、数値/日付書式リストおよびページ・サイズを設定します。

ダイアログ・ボックス・オプション

Copyrightメッセージ

新しく作成した図表の「情報」ダイアログに表示される「Copyright」フィールドのデフォルト・テキストです。この設定は、次に作成またはオープンする図表に対して有効になります。

カラー・パレット

使用中のカラー・パレットに関連するオプションを設定します。

ファイル　新規作成する図表に使用するカラー・パレットが含まれているファイルの名前です。このフィールドを空白にすると、Graphics Builderではデフォルトのカラー・パレットが使用されます。このフィールドには、カラー・パレットのフルパス名または相対パス名を必ず指定してください。この設定は、次に作成またはオープンする図表に対して有効になります。

モード	図表のカラー・パレットをシステムでどのように実行するかを決めます。別の図表をアクティブにするたびに、Graphics Builderではシステムのカラー・パレットをその図表のカラー・パレットに一致するように（またはできる限り近づけるように）修正します。システムで一度に対処できるカラー数に制限があるので、別々のカラー・パレットを使用している複数の図表を同時に正確に表示できないことがあります。この設定は、次に作成またはオープンする図表に対して有効になります。リストには、次のオプションが含まれています。

「Editable」は、Graphics Builderがシステムのカラー・パレットをアクティブ図表のパレットに一時的に置き換えます。新しい図表がアクティブになるたびに、そのカラー・パレットでシステム・パレットが置き換えられます。これにより、アクティブでない図表の外観に悪影響が及ぶことがありますが、アクティブ図表は正確に表示されます。カラー・パレットを修正またはインポートするためには、パレットが「Editable」であることが必要です。

「Read Only-Shared」は、Graphics Builderがパレットにそれ以上カラーを追加できなくなるまで、各アクティブ図表のカラー・パレットをシステムの元のパレットに追加し続けます。そのパレットは、すべてのオープンされている図表が共有する単一パレットとなります。完全に別のカラーを使用する図表をアクティブにすると、その図表は正確に表示されないことがあります。

「Read Only_Private」は、Graphics Builderが、パレットにカラーを追加できなくなるまで、図表をアクティブにするたびにそのカラー・パレットをシステムの元のパレットに追加します。そのパレットは、その図表をアクティブにすると必ず使用されるパレットとなります。これにより、アクティブでない図表の外観に悪影響が及ぶことがありますが、アクティブ図表は正確に表示されます。

「書式リスト」

数値書式と日付書式のダイアログ・ボックスのデフォルトで使用できる日付と数値の書式を設定します。この設定は即時に有効になります。次のボタンを選択できます。

日付	日付書式マスクを設定し、「日付書式」ダイアログ・ボックスを表示します。

数値	数値書式マスクを設定し、「数値書式」ダイアログ・ボックスを表示します。

ページ・サイズ

レイアウト上のページ割り線の位置を決める実際のページの幅、高さおよび単位を設定します。レイアウトがページ・サイズより大きいことがあるので注意してください。

保存

オプションをアクセプトし、それらをオプション・ファイルに保存します。


「環境設定」タブ

起動オプションおよびその他の一般設定を設定します。

ダイアログ・ボックス・オプション

起動

Graphics Builderを最初に実行したときにその動作を制御する複数のオプションを設定します。

オープン	Graphics Builderがデフォルトで図表をオープンするか作成するかを決めます。

「図表なし」は、Graphics Builderを最初に実行したときに図表が初めから作成されたりオープンされることはありません。

「新規図表」は、Graphics Builderで新規図表が自動的に作成され、そのレイアウト・エディタが表示されます。

「ファイル・オープン」は、Graphics Builderで「フィルタ」ダイアログ・ボックスが自動的に表示され、初めにファイルから図表をオープンすることができます。

起動時にログオン	Graphics Builderを最初に実行したときに、「接続」ダイアログ・ボックスが表示されます。USERIDパラメータを使用してデータベースに接続しているときは、「接続」ダイアログは表示されません。この設定は、次にGraphics Builderを実行したときに有効になります。

一般

一般オプションを設定します。

サウンド出力

サウンドを再生するときに使用される出力デバイスです。このリストに表示される項目は、システムによって異なります。詳細は、使用しているマニュアルを参照してください。この設定は即時に有効になります。

イメージ圧縮

図表の保存または生成、あるいはイメージをクリップボードにコピーするときに、図表内のすべてのイメージの圧縮に使用する圧縮方法を指定します。

図表内のイメージに適用できない圧縮方法を選択すると、そのイメージは圧縮されません。たとえば、PackBitsを選択して、カラー・イメージを含む図表を保存すると、そのイメージは圧縮されません。この設定は、次に作成またはオープンする図表に対して有効になります。

自動キャラクタ・セット変換

図表をオープンしたときに、Graphics Builderで図表のテキストをNLS_LANG環境変数で指定されたキャラクタ・セットに自動的に変換するかどうかを指定します。この設定は、次に作成またはオープンする図表に対して有効になります。

実行時にスムース再描画

Graphics Builderで描画操作の影響を受けるレイアウトの一部をどのように更新するかを決めます。この設定はランタイムに有効になります。

この設定をオフにすると、ダメージ領域内の修正された各オブジェクトが個別に描画されます。

この設定をオンにすると、内部バッファ内の修正された各オブジェクトがまずレンダリングされます。レンダリングが完了すると、レイアウトは単一の再描画で更新されます。

「スムース再描画」を選択すると、レイアウトが更新されるときのちらつきが減少します。ただし、ダメージ領域が大きい場合は、「スムース再描画」で生成される内部バッファに大量のメモリーが必要となります。メモリーの問題が発生しない限り、「スムース再描画」をオンにしておくことをお薦めします。

バックアップ・ファイル保存

図表を保存するたびにGraphics Builderでそのバックアップ・コピーを保存しておくかどうかを決めます。バックアップ・ファイルには元のファイルと同じ基本名が付けられ、ファイル名拡張子は.bakに変更されます。たとえば、図表trends.ogdを保存すると、バックアップ・ファイルはtrends.bakという名前になります。

ナビゲートでプロパティを適用

別のオブジェクトのプロパティをプロパティ・シートに表示するときに（たとえば、プロパティ・シートのドロップダウン・リストから別のオブジェクトを選択することによって）、そのプロパティ・シート内の変更を自動的に適用するかどうかを指定します。このチェックボックスがオンでない場合、保留中の変更を保存するかどうかを尋ねるプロンプトが必要なときに表示されます。

実行で問合せプロパティを適用

問合せを実行するときに問合せプロパティ・シート内の変更を自動的に適用するかどうかを指定します。このチェックボックスがオンでない場合、保留中の変更を保存するかどうかを尋ねるプロンプトが必要なときに表示されます。

保存

オプションをアクセプトし、それらをオプション・ファイルに保存します。


 「タイプ」メニュー

「タイプ」メニューには、Graphics Builderでサポートされている各チャート・タイプ用に事前定義されたテンプレートが含まれています。このようなテンプレートは、独自のテンプレートをカスタマイズする際に使用する開始点です。この項は、次のGraphics Builder「タイプ」メニュー項目について説明しています。

縦棒グラフ

横棒グラフ

線グラフ

複合グラフ

円グラフ

ダブル-Y軸グラフ

株価チャート

ガント・チャート

散布図

表


縦棒グラフ

事前定義された縦棒グラフのチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


横棒グラフ

事前定義された横棒グラフのチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


線グラフ

事前定義された線グラフのチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


複合グラフ

事前定義された複合グラフのチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


円グラフ

事前定義された円グラフのチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


ダブルY軸グラフ

事前定義されたダブルY軸グラフのチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


株価チャート

事前定義された株価チャートのチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


ガント・チャート

事前定義されたガント・チャートのチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


散布図

事前定義された散布図のチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


表

事前定義された表のチャート・テンプレートを含むサブメニューを表示します。あるテンプレートがチャート・テンプレート・エディタに表示されている場合に、このメニューから事前定義されたテンプレートを選択すると、すでにあるテンプレートのプロパティが、選択したテンプレートのプロパティに置換されます。現在テンプレートが存在していない場合は、このメニューから1つのテンプレートを選択すると、選択済みのデフォルト・プロパティをもつ新しいテンプレートが作成されます。


 「表示」メニュー

この項は、次のGraphics Builder「ビュー」メニュー項目について説明しています。

標準サイズ

ウィンドウに合せる

ズームイン

ズームアウト

定規

定規ガイド

格子表示

格子指定

ページ・ブレーク

ツール・パレット

ステータス・バー

表示オプション


標準サイズ

拡大したレイアウトを標準の大きさに戻します。


ウィンドウに合せる

レイアウトを縮小して、レイアウト全体を一度に参照できるようにします。


ズームイン

レイアウトを倍に拡大します。


ズームアウト

レイアウトを2分の1に縮小します。


定規

レイアウト上に定規を表示したり、それを非表示にします。


定規ガイド

レイアウト上に定規ガイドを表示したり、それを非表示にします。


格子表示

レイアウト上に格子を表示したり、それを非表示にします。


格子指定

レイアウト用の格子指定をアクティブにしたり、それを非アクティブにします。


ページ・ブレーク

レイアウト上にページ・ブレークを表示したり、それを非表示にします。


ツール・パレット

レイアウト上にツール・パレットを表示したり、それを非表示にします。


ステータス・バー

レイアウト上にステータス・バーを表示したり、それを非表示にします。


表示オプション

レイアウトの表示に関連付けられたオプションを変更します。

設定するオプション用のサブメニュー項目を選択してください。

定規

定規単位、格子間隔および格子指定の解像度のオプションを設定します。

レイアウト

レイアウト・サイズおよびページ方向オプションを設定します。


「ウィンドウ」メニュー

このメニューには、現在オープンされているGraphics Builderウィンドウがすべてリストされ、ここから1つのウィンドウを選択してアクティブにできます。

選択されたウィンドウは、アクティブ・ウィンドウとなり、ウィンドウの一番前に移動します。たとえば、レイアウト・エディタとチャート・テンプレート・エディタをオープンし、レイアウト・エディタをアクティブにしている場合（レイアウト・エディタが一番前に表示）、「ウィンドウ」メニューからチャート・テンプレート・エディタをアクティブにするよう選択できます。「ウィンドウ」メニューの詳細は、システムのマニュアルを参照してください。


OLEについて

オブジェクトのリンクおよび埋込み(OLE)を使用すると、1つの文書に複数のアプリケーション機能を組み合せることができます。

コンテナ・アプリケーションは、別のアプリケーションのオブジェクトを表示できます。たとえば、「フォーム」に、Microsoft Excelのスプレッドシートを入れることが可能です。

サーバー・アプリケーションでは、そこに入っているオブジェクトをコンテナを使用して表示できます。たとえば、Graphics Builderの図表をVisual Basicのフォームに埋め込むことが可能です。

Graphics BuilderはOLEサーバーです。Graphics Builderの図表をOLEコンテナ・クライアント・アプリケーションに埋め込んでもかまいません。詳細は、OLEコンテナ・クライアント・アプリケーションのマニュアルを参照してください。


OLE動詞について

動詞には、Graphics Builderの図表がOLEコンテナ内でアクティブになったときに実行する操作が指定されます。Graphics Builderがサポートする動詞は、次のとおりです。

HIDE

OPEN

SHOW

PRIMARY(デフォルト)動詞は、OPENです。


HIDEについて

OLE動詞HIDEは、Graphics Builderの埋込みオブジェクトを非アクティブにし、図表を非表示にします。


OPENについて

OLE動詞OPENは、Graphics Builderの実行可能プログラムを実行し、埋込み図表をOLEコンテナ・クライアント・アプリケーションにロードします。


SHOWについて

OLE動詞SHOWは、Graphics Builderの埋込みオブジェクトをアクティブにし、そのオブジェクトがOLEコンテナ・クライアント・アプリケーションと対話するための準備をします。


OLEオートメーションについて

OLEオートメーションを使用すると、OLEコンテナ・クライアント・アプリケーション内からプログラム構成体を使用してGraphics Builderの埋込み図表を処理することができます。Graphics Builderでは、Graphics Builder機能にアクセスするメソッドがいくつかサポートされています。このようなアクセス方法の起動のしかたについては、OLEコンテナ・クライアント・アプリケーションのマニュアルを参照してください。


ClearQuery

Graphics Builderの問合せからデータをすべて消去します。

Visual Basic構文

ole.Object.ClearQuery query_name

パラメータの内容は次のとおりです。

ole	OLEオブジェクト。

query_name	消去するGraphics Builderの問合せの名前。


接続

Graphics Builderの埋込み図表用のデータベース接続を設定します。

Visual Basic構文

ole.Object.Connect connect_string

パラメータの内容は次のとおりです。

ole	OLEオブジェクト。

connect_string	username/password@remote_server形式の有効なOracleデータベース接続文字列。


GetCharParam

Graphics Builderパラメータの文字列を戻します。タイプCHARでないパラメータは、戻される前にCHARに変換されます。

Visual Basic構文

x = ole.Object.GetCharParam param_name

パラメータの内容は次のとおりです。

ole	OLEオブジェクト。

param_name	Graphics Builder図表におけるパラメータの名前。


インタプリタ

Graphics BuilderにPL/SQL文をすべて実行するように指示します。

Visual Basic構文

ole.Object.Interpret pls_string

パラメータの内容は次のとおりです。

ole	OLEオブジェクト。

pls_string	Graphics Builderが確実に実行できるすべてのPL/SQL文字列。


MouseDown

Graphics Builder図表に対してマウスダウン・イベントを通知します。

Visual Basic構文

ole.Object.MouseDown pos_x pos_y

パラメータの内容は次のとおりです。

ole	OLEオブジェクト。

pos_x	マウス・イベント位置のx座標。たとえば、この情報は、Visual BasicのMouseDownイベントで提供されます。

pos_y	マウス・イベント位置のy座標。たとえば、この情報は、Visual BasicのMouseDownイベントで提供されます。


MouseMove

Graphics Builder図表に対してマウス移動のイベントを通知します。

Visual Basic構文

ole.Object.MouseMove pos_x pos_y

パラメータの内容は次のとおりです。

ole	OLEオブジェクト。

pos_x	マウス・イベント位置のx座標。たとえば、この情報は、Visual BasicのMouseMoveイベントで提供されます。

pos_y	マウス・イベント位置のy座標。たとえば、この情報は、Visual BasicのMouseMoveイベントで提供されます。


MouseUp

Graphics Builder図表に対してマウス･アップのイベントを通知します。

Visual Basic構文

ole.Object.MouseUp pos_x, pos_y

パラメータの内容は次のとおりです。

ole	OLEオブジェクト。

pos_x	マウス・イベント位置のx座標。たとえば、この情報は、Visual BasicのMouseUpイベントで提供されます。

pos_y	マウス・イベント位置のy座標。たとえば、この情報は、Visual BasicのMouseUpイベントで提供されます。


SetRow

Graphics Builderの埋込み図表におけるカスタムの問合せにデータ行を1行追加します。

Visual Basic構文

ole.Object.SetRow query_name, value[, value...]

パラメータの内容は次のとおりです。

ole	OLEオブジェクト。

query_name	カスタムの問合せの名前。

value　	文字または数値によるデータ値。これらの値は、1行のデータ行にまとめてから、問合せに追加します。たとえば、列ENAMEとSALを含むカスタムの問合せ「query0」を定義した場合は、次のVisual Basicコマンドを使用して値「SMITH」と2000を含む行を1行追加します。

ole.Object.SetRow "query0", "SMITH", 2000


同期

埋込みオブジェクトの表示を更新して、図表の現在の状態に反映させます。

Visual Basic構文

ole.Object.Sync

パラメータの内容は次のとおりです。

ole	OLEオブジェクト。


?


パターン・パレット

パレット内の各サンプル・パターンとその名前を参照する場合は、次のリンクをいずれか1つ選択してください。

パターン、パート1

パターン、パート2


デフォルト・カラー・パレット

Graphics Builderは、明示的に別のものが指定またはインポートされない限り、デフォルト・カラー・パレットを使用します。

デフォルトのパレットには、図表にインポートできるファイルとしての機能もあります。このファイルの位置の詳細は、オペレーティング・システムのインストール情報を参照してください。

デフォルト・カラー・パレットは、次の規則に従って定義されます。

1	パレットの左上の領域は、よく使用される16種類の色で構成されます。 それらの色の名前は、次のとおりです。

black (黒)	white (白)	green (緑)	darkgreen (濃い緑)
	gray (グレー)	darkgray (濃いグレー)	cyan (水色)	darkcyan (濃い水色)
	red (赤)	darkred (濃い赤)	blue (青)	darkblue (濃い青)
	yellow (黄)	darkyellow (濃い黄)	magenta (赤紫)	darkmagenta (濃い赤紫)
1	パレットの左下の領域は、カスタム定義の色を設定できる8つの空のセルで構成されます。

2	その隣の5つの列は、多様な階調で構成されます。それぞれの色は、灰色の割合に従って'灰色<value>'と命名されます。この値の範囲は4～96です（4ずつ増加）。たとえば、有効は色名は'灰色96'、'灰色92'、'灰色4'のようになります。

3	パレットの残りの部分は、赤、緑、青(RGB)の成分の割合を変化させて指定した色で構成されます。

赤と緑の成分の割合値はそれぞれ、0、25、50、75、88、100です。

青の成分の割合値はそれぞれ、0、50、75、88、100です。

それぞれの色は、そのRGB値に従い'r<value>g<value>b<value>'と命名されます（たとえば、100%の赤、0%の緑、88%の青で構成される色はr100g0b88と命名される）。

上記のカラー・セルを除けば、パレットは5つの主要領域で構成され、それぞれの領域には6x6の配列で36種類の色が入っています。これらの色は、次の規則に従って定義されます。

赤の値は、色がそれぞれの主要領域内で左から右にいくにしたがって大きくなっていきます。

緑の値は、色がそれぞれの主要領域内で上から下にいくにしたがって大きくなっていきます。

青の値は、主要領域が左から右にいくにしたがって大きくなっていき、1つの領域にあるすべての色は同じ青の値を使用します。


グレースケール

グレースケールのカラー・パレットは、全体的に多様な階調で構成されます。このカラー・パレットは、次の規則により定義されています。

1	最初の2つの色は、'黒'および'白'と命名されます。

2	パレットの残りの部分は、グレーの割合を変化させて指定した色で構成されます。それぞれの色は、その灰色の値に従って'灰色<value>'と命名されます。これらの色は、次の規則に従って定義されます。

（'白'の右の）最初の灰色の灰色値は100%で、'灰色100'と命名されます。

色がパレットを左から右にいくに従って(1つの行の一番右のセルまで来たらそこで折り返して次の行の一番左のセルにいきます)、それぞれの色のグレーの値は、その前にある値より.5ずつ小さくなっていきます。

'灰色12.5'の後、それぞれの色の灰色の値はその前の値より.25ずつ小さくなります。

灰色の値は、パレット内の'灰色0'という最後の色に到達するまで続いて減少します。


Oracle CDE1

Oracle CDE1カラー・パレットは、Graphics Builder 2.0ではデフォルト・カラー・パレットでした。このカラー・パレットは、次の規則により定義されています。

1	このパレットの最初の2列は、次で構成されます。

一般に使用される、'青'、'マゼンタ'、'赤'、'シアン'、'緑'および'黄'と命名されている色

'黒'、'灰色60'、'灰色45'、'灰色30'、'灰色15'および'白'と命名されている灰色の度合い

2	パレットの残りの部分は、赤、緑、青(RGB)の成分の割合を変化させて指定した色で構成されます。各コンポーネントの割合値はそれぞれ、0、40、55、70、85、100です。

それぞれの色は、そのRGB値に従い'r<value>g<value>b<value>'と命名されます（たとえば、100%の赤、40%の青および0%の緑で構成される色は、'r100b40g0'と命名される）。

最初の2列を除けば、パレットは6つの主要領域で構成され、それぞれの領域には6x6の配列で36種類の色が入っています。これらの色は、次の規則に従って定義されます。

   赤の値は、色がそれぞれの主要領域内で左から右にいくにしたがって大きくなっていきます。

  緑の値は、色がそれぞれの主要領域内で上から下にいくにしたがって大きくなっていきます。

  青の値は、主要領域が左から右にいくにしたがって大きくなっていき、1つの領域にあるすべての色は同じ青の値を使用します。


パターン、パート1


パターン、パート2


オブジェクトのアルファベット順リスト
�オブジェクトのアルファベット順リスト

軸プロパティ

チャート・プロパティ

図表プロパティ

フィールド・テンプレート・プロパティ

枠プロパティ

レイヤー・プロパティ

オブジェクト・プロパティ

パラメータ・プロパティ

問合せプロパティ

参照線プロパティ

タイマー・プロパティ


軸プロパティ

軸プロパティ

ラベル、位置、方向、目盛きざみ、グリッドおよびその他の設定。

値軸プロパティ

軸の最大値、最小値、ステップおよびスケール。

日付軸プロパティ

最大値、最小値、ステップ、ラベルおよびその他の設定。

項目軸プロパティ

最小項目数および最大項目数。


軸プロパティ

項目ラベル

軸に沿って表示するラベルのテキストを指定します。

データ型

軸に沿って表示するデータの特性を指定します。

軸の位置

どのチャート枠に沿って軸を表示するかを指定します。

軸の方向

増分値や連続した項目を軸に沿ってどの方向に設定するかを指定します。

目盛きざみ位置

主目盛きざみと補助目盛きざみをどう表示するかを指定します。

目盛きざみラベル回転

目盛きざみラベルの回転角度を指定します。注意: システムによっては、テキストの回転をサポートしていないものもあります。

補助きざみ数

それぞれの主目盛きざみと主目盛きざみの間に定義される補助目盛きざみ数です。

主目盛きざみ

主目盛きざみを主目盛間隔で表示するかどうかを指定します。

補助目盛きざみ

「補助きざみ数」で設定された値の指定どおりに補助目盛きざみを表示するかどうかを指定します。

主目盛グリッド

それぞれの主目盛きざみにグリッドを表示するかどうかを指定します。

補助目盛グリッド

それぞれの補助目盛きざみにグリッドを表示するかどうかを指定します。

軸ラベル

軸に沿って値を識別する項目ラベルを表示するかどうかを指定します。

目盛りきざみラベル

軸に沿って値を識別する項目ラベルを表示するかどうかを指定します。


値軸プロパティ

最大値

軸上に表示される最大の値です。

主目盛間隔

主目盛きざみと目盛きざみラベルが表示される軸に沿った主目盛間隔です。

最小値

軸上に表示される最小の値です。

スケール

軸のスケーリングに使用されるアルゴリズムを指定します。

線形	最小軸値と最大軸値の間の固定した間隔を使用して軸のスケーリングを行います。

対数	対数アルゴリズム（10の累乗にもとづく）を使用して軸のスケーリングを行って、最小軸値と最大軸値の間の間隔を決定します。

パーセント基準	データ値を次のいずれか1つと対応させて表示するように軸のスケーリングを行います。

合計	それぞれのデータ値が、すべてのデータ値の合計値を基準にしたパーセントで表示されます。

最小値	それぞれのデータ値が、最小データ値を基準にしたパーセントで表示されます。

最大値	それぞれのデータ値が、最大データ値を基準にしたパーセントで表示されます。

注意: スケーリングのパーセント基準は、独立した値軸（たとえば、散布図チャート上にある軸）には適用できません。

パーセント基準を選択した場合には、必ず比較値の計算方法を指定する必要があります。

フィールド	それぞれのデータ値のパーセントを、他の項目にある同じフィールドのデータ値と対応させて計算します。たとえば、SMITHの給与は他の従業員全員の給与と比較して表示されます。

カテゴリ	それぞれのデータ値のパーセントを、他のフィールドの同じ項目にあるデータ値と対応させて計算します（このオプションは、1つの項目に対して複数のフィールドが表示されている場合に限り有効です）。たとえば、SMITHの給与および歩合は互いに比較して表示されますが、他の従業員の額とは比較されません。


日付軸プロパティ

最大値

軸上に表示される最大の値です。

主目盛間隔

どの細分性によって独立した日付軸を項目分けするかを指定します。主目盛間隔は、「ラベル」の設定で指定された主目盛単位に従って空けられます。これによって、項目数が目盛きざみと目盛きざみの間に表示されます。

最小値

軸上に表示される最小の値です。

年の最初の月

新しい年度が始まる最初の月です。

週末をスキップ

軸の値を計算するときに週末を無視するかどうかを指定します。

ラベル

主目盛きざみと目盛きざみラベルが表示される軸に沿った主目盛間隔のみでなく、目盛きざみラベルの表示も指定します。「主目盛間隔」で指定された単位より小さい単位のラベル設定は無視されます。

カスタム	対応するテキスト・フィールドには必ずカスタム日付書式を入力してください。この日付書式で使用される最小単位がチェック済みのすべての単位よりも小さい場合は、Graphics Builderはその単位をチェックしたものとみなして動作します。有効な日付書式については、『Oracle7 Server SQL言語リファレンス』を参照してください。


項目軸プロパティ

最小項目数

チャートに表示される最小項目数です。実際の項目数がここで指定された数よりも少ない場合、チャート上には指定された最小項目数を収容する分のスペースが残ります。

最大項目数

チャートに表示される最大項目数です。最大項目数が表示されると、残ったデータはすべて無視されます。


チャート・プロパティ

チャート・プロパティ

名前、タイトル、チャート・タイプおよびテンプレートのプロパティ。

データ・プロパティ（チャート）

問合せ、フィルタ、データ範囲およびその他のプロパティ。

項目プロパティ

チャート上に項目として表示される問合せ列。

値プロパティ

チャート上に値として表示される問合せ列。

PL/SQLプロパティ

PL/SQLボタン・プロシージャの設定。


チャート・プロパティ

名前

チャートの名前です。PL/SQLプログラム単位で参照する場合は、チャートの名前を指定する必要があります。プログラム目的でチャートを参照しようと考えていない場合は、名前を指定する必要はありません。

Title

チャートのタイトルです。デフォルトでは、タイトルはチャートの上に表示されます。必要な場合には、タイトルを新しい位置にドラッグしてもかまいません。

Type

基本チャートのタイプです。

サブタイプ

チャート・タイプのバリエーションです。各バリエーションは、指定されたチャート・タイプに基づいており、異なる表現を得るために多様なプロパティが設定されています。

テンプレート

チャートの基準となるチャート・テンプレートです。新しいチャートを作成すると、新しいテンプレートが自動的に作成されます。すでにあるテンプレートをチャートの基準にする場合は、このリストから該当するテンプレートを選択してください。


データ・プロパティ（チャート）

問合せ

チャート用のデータを提供する問合せです。

Graphics Builderは、チャートを作成する場合には、最後に取り出されたデータを、選択された問合せに対して使用します。最新のデータを使用する場合は、問合せを再実行してください。

問合せ実行時にチャートを更新

問合せの実行時にチャートを自動的に更新するように指定します。ビルトイン・プロシージャOG_UPDATE_CHARTを使用しても、チャートをプログラム目的で更新することができます。

フィルタ機能

問合せによって提供されたデータの量を制限する目的で使用されるPL/SQL機能です。この機能によって値TRUEが戻されるデータ行のみがチャート上に表示されます。このリストに表示されるのは、フィルタ・トリガー機能が有効な場合のみです。

マッピング型

「値」プロパティ・ページのレイアウトを決定します。使用可能な選択項目は、チャート・タイプによって異なります。

一般	値リストを1つのみ指定できます。

ガント・チャート	「開始」値および「終了」値として表示される列を指定できます。

株価チャート	「高」値、「終」値および「低」値として表示される列を指定できます。

データ範囲

チャートの問合せの中から、どの行のデータをチャートに表示するかを指定します。

すべての行表示	チャート上に問合せのすべての行を表示します。

行表示	指定された範囲内にあるデータ行のみを表示します。


項目プロパティ

問合せ列

チャートの問合せから、チャート項目として使用できる列を表示します。

チャート項目

チャート項目として表示される列を表示します。

サブ項目

ブレーク・チャートでサブ項目として使用する問合せ列を指定します。

挿入

選択した列を項目リストに追加します。

削除

選択した列を項目リストから削除します。

一番上へ

選択した列を項目リストの一番上へ移動し、最初に表示されるようにします。

一番下へ

選択した列を項目リストの一番下へ移動し、最後に表示されるようにします。

上へ

選択した列を項目リスト内で1スロット上へ移動し、先に表示されるようにします。

下へ

選択した列を項目リスト内で1スロット下へ移動し、後に表示されるようにします。


値プロパティ

問合せ列

チャートの問合せから、チャート値として使用できる列を表示します。

チャート値

（一般マッピング・タイプ）チャート値として表示される列を表示します。

フィールド・テンプレート

（一般マッピング・タイプ）選択した列の表示を決定するのに使用されるフィールド・テンプレートを表示します。

開始

（ガント・チャート・マッピング・タイプ）開始値として表示されるデータを含む列を指定します。

[End]

（ガント・チャート・マッピング・タイプ）終了値として表示されるデータを含む列を指定します。

高

（株価チャート・マッピング・タイプ）上限として表示されるデータを含む列を指定します。

終り

（株価チャート・マッピング・タイプ）終り値として表示されるデータを含む列を指定します。

低

（株価チャート・マッピング・タイプ）下限として表示されるデータを含む列を指定します。


PL/SQLプロパティ

プロシージャ

チャートに関連付けられたPL/SQLボタン・プロシージャの名前です。このプロシージャは、チャートに関連する指定された「マウス・イベント」が検出される際に実行されます。このリストに表示されるのは、ボタン・トリガー・プロシージャが有効な場合のみです。

イベント・タイプ

どの「マウス・イベント」が指定されたボタン・プロシージャを起動するかを指定します。

マウス・ボタンを押す	マウス・ボタンで選択すると、プロシージャが起動します。

マウス・ボタンを放す	マウス・ボタンを放すと、プロシージャが起動します。

マウス・ボタンを押したまま、マウスを移動する	マウス・ボタンを押したままマウスを移動させると、プロシージャが起動します。


図表プロパティ

オープン・トリガーとクローズ・トリガーを設定し、パラメータの日付書式を変更します。

オープン・トリガー

実行時に図表を最初にオープンするときに実行されるPL/SQLプロシージャの名前です。このリストに表示されるのは、有効なオープン・トリガーのみです。

作成

新しいオープン図表トリガーを作成します。

クローズ・トリガー

実行時に図表をクローズするときに実行されるPL/SQLプロシージャの名前です。このリストに表示されるのは、有効なクローズ・トリガーのみです。

作成

新しいクローズ図表トリガーを作成します。

パラメータ日付書式

日付型のパラメータ値に使用される日付書式マスクを指定します。

List

図表において現在使用可能な日付書式マスクを表示し、マスクの追加または削除を許可します。このボタンを選択すると、「日付書式」ダイアログ・ボックスが表示されます。

方向

NLSサポートのための、テキストや矢印などのデフォルトの方向を決定します。「左から右へ」、「右から左へ」または「デフォルト」（現行の言語により決定される）を選択します。


フィールド・テンプレート・プロパティ

フィールド・プロパティ

フィールド・テンプレート名およびカラー・パターン回転方式

軸フィールド・プロパティ

表示形式、線の形式、ラベル回転、カーブ調整およびその他の設定。


フィールド・プロパティ

名前

フィールド・テンプレートの名前です。

カラー回転

Graphics Builderがカラー・パレットやパターン・パレットを自動的に回転させて、このフィールド・テンプレートを使用する各フィールドに固有のパレット設定を選択するかどうかを指定します。指定しないと、このフィールド・テンプレートを使用するすべてのフィールドは同じパレットで表示されます。


軸フィールド・プロパティ

表示形式

このフィールドをチャート上に表示するために使用する要素を指定します。

横棒グラフ	フィールドの各データ値が、値軸に沿って基本線から該当する値まで伸長している横棒として表示されます。

行	フィールドのデータ値が、各項目の値を結ぶ線として表示されます。

塗り	フィールドのデータ値が、範囲境界が基本線、チャートの枠および各項目の値を結ぶ線からなる塗り領域として表示されます。

記号	フィールドの各データ値が、各データ・ポイントに表示する記号として表示されます。カスタム記号を選択するには、テンプレートの記号の1つを選択し、記号パレットから新しい記号を1つ選択します。

スパイク	フィールドの各データ値が、基本線とデータ・ポイントを結ぶ直線として表示されます。

ラベル	フィールドの各データ値が、該当する値を含むテキスト・ラベルとして表示されます。

線の形式

線表示形式を含む各フィールドのデータ・ポイント間を結ぶために使用する線の形式を指定します。

ラベル回転

ラベル表示形式を含む各フィールドのラベルの回転角度を指定します。

軸のマッピング

フィールドの表示方法を決定するのに必要なデータ値が比較される軸を指定します。

カーブ調整タイプ

カーブ調整をチャートに適用するかどうか、また適用する場合にはどのアルゴリズムを使用するかを指定します。

Graphics Builderは、データの最小2乗近似を使用してカーブの計算を実行します。つまり、Graphics Builderは、カーブの値と実際のデータ値との差を2乗した合計をできるだけ小さくするような、下記の式にある値a とb を求めようとします。各調整タイプのカーブは、下記のように定義されます。

線形	カーブは、次の式で定義されます。

y = ax + b

対数	カーブは、次の式で定義されます。

y = a(log x) + b

指数	カーブは、次の式で定義されます。

(log y) = ax +b

累乗	カーブは、次の式で定義されます。

(log y) = a(logx) + b

表示位置

各項目において2つ以上のフィールドのデータ値間の関係を指定します。

標準	複数のフィールドからのデータ値が標準表示され、項目の表示データに対して使用可能なスペースが均等に分割されます。

前フィールドから	複数のフィールドからのデータ値がそれぞれ1つずつ上にスタックされ、各チャート要素（横棒、線など）が前の値のエンド・ポイントから最新のデータ・ポイントまで描画されます。

スタック	複数のフィールドからのデータ値がそれぞれ1つずつ上にスタックされ、項目の表示データに対して使用可能な同じスペースが共有されます。各データ・ポイントの位置を求める場合は、前の値にそれぞれの値を加えます。

オーバーラップ

複数のフィールドからのデータ値を横棒チャートや縦棒チャートで表示する棒どうしがそれぞれオーバーラップする割合を指定します。


枠プロパティ

枠プロパティ

深さ、シャドウおよび凡例の設定。

軸枠プロパティ

基本線、項目幅および第2-Y軸の設定。

円グラフ・プロパティ

表示、ラベル、「その他」の少量の定義およびその他の設定。

表枠プロパティ

ラベル、グリッド、行数または列数およびその他の設定。


枠プロパティ

深さサイズ

チャート枠と要素を3次元表示にするために、それらが描画される深さのサイズを指定します。

シャドウ・サイズ

チャート枠と要素が描画されるシャドウのサイズを指定します。

シャドウ方向

チャート枠と要素が描画されるシャドウの方向を指定します。

枠の表示

チャートの周囲に四角形を表示するかどうかを指定します。（円グラフ・チャートには適用されません。）

凡例

チャートの凡例を表示するかどうかを指定します。（表チャートには適用されません。）

凡例中の列数

凡例内にラベルを表示するために使用する列数です。この数がすでにあるラベルの数と同数以上である場合には、各ラベルは別々の列に表示されます。


軸枠プロパティ

基本線の値

値軸に沿ってフィールドを表示する際に開始点として使用される値です。基本線の値を上回る値はすべて、基本線の上に表示されます。また、基本線の値を下回る値はすべて、基本線の下に表示されます。

最小値	基本線が最小軸値となります。

最大値	基本線が最大軸値となります。

0（ゼロ）	値0が基本線として使用されます。

カスタム	関連付けられたテキスト・フィールドに入力された値が基本線として使用されます。

基本線のマッピング

位置を求めるために基本線の値が比較される軸を指定します。

項目幅

これは、「ストライプ幅」の割合で示した、横棒グラフや縦棒グラフ内の棒の幅です。ストライプ幅は、棒が互いに重なることなくとれる棒の最大の幅で、項目軸の長さを、表示される棒の数で割って決定されます。

項目幅を設定すると、棒と棒の間にスペースを入れることができるようになります。これを実行する場合は、項目幅を100%未満に設定してください。

第2-Y軸

第2-Y軸をチャート内に表示するかどうかを指定します。


円グラフ枠プロパティ

円グラフ表示

円グラフの各円弧と完成したチャートとの関係を指定します。

合計	値円グラフの各円弧が表示され、そのデータ値はここで指定された合計値の割合を表します。

パーセント	既存のデータ値の合計がチャートの合計値のここで指定された割合を表し、個々の円弧がそれぞれ表示されます。

表示順序

データ値が表示される方向を指定します。円グラフの最初の円弧が通常チャートの一番上に表示され、それ以降の円弧はここで指定された方向に表示されます。

項目表示ラベル

円グラフの各円弧を、示されている項目の名前でラベル表示するかどうかを指定します。

データ値

円グラフの各円弧を、そのデータ値でラベル表示するかどうかを指定します。

パーセント値

円グラフの各円弧を、示されている完成したチャートの割合でラベル表示するかどうかを指定します。

目盛きざみ

円グラフの各円弧とそのラベルを結ぶ目盛きざみを表示するかどうかを指定します。

より小さい円弧を入れる x %未満の円弧を「その他」とする

ここに入力される値より小さい割合の円弧をラベル「その他」で1つの円弧に結合することを指定します。

ラベル・オーバーラップを防ぐ

円グラフの各円弧のラベルが互いにオーバーラップしないように指定します。この場合、長いラベルには、チャートから離れたところへの配置が必要となることもあります。これに対しては、設定をオフにすることもできます。


表枠プロパティ

表方向

データ行を水平にリストするか、または垂直にリストするかを指定します。

最小行数

表チャートに表示される最小行数です。実際の行数がここで指定された数よりも少ない場合、チャート上には指定された最小行数を収容する分のスペースが残ります。

最大行数

表チャートに表示される最大行数です。最大行数が表示されると、残った行はすべて無視されます。

列名

列の名前をチャート内の最初の行として表示するかどうかを指定します。

垂直グリッドの表示

列と列の間に垂直グリッドを表示するかどうかを指定します。

水平グリッドの表示

行と行の間に水平グリッドを表示するかどうかを指定します。

水平線当りの行数

それぞれの水平グリッドが描画される前に表示されるデータ行の数です。


レイヤー・プロパティ

レイヤーの作成、削除、非表示化、表示、アクティブ化および改名を実行します。

ダイアログ・ボックス・オプション

すでにあるレイヤー

図表においてすでに存在するレイヤーを表示します。リスト内のレイヤーの順序によって、レイアウト上へのオブジェクトの表示のしかたが決まります。各レイヤーのオブジェクトは、リスト内のその下で表示されているすべてのレイヤーのオブジェクトに重なります。

作成

"layerx"という名の、新規の空のレイヤーを作成します（xは数値）。

削除

リスト内に選択したレイヤーを削除します。また、そのレイヤーにおけるオブジェクトもすべて削除されます。

隠す/表示

選択したレイヤーが表示されている場合にはそれを非表示にし、非表示になっている場合には表示します。リスト内のレイヤー名の横の'+'は表示中であることを、'-'は隠されていることを表します。アクティブ・レイヤーを非表示にすることはできません。

アクティブ化

選択したレイヤーをアクティブにします。非表示になっているレイヤーは、表示されるように自動的に設定されます。あるレイヤーを非アクティブにする場合は、別のレイヤーをアクティブにしてください。

前へ/後へ/一番前へ/一番後へ

選択したレイヤーをリスト内の1つ前の位置またはリスト内の1つ後の位置、リストの一番前、リストの一番後へ移動します。リスト内のレイヤーの順序によって、レイアウト上へのオブジェクトの表示のしかたが決まります。各レイヤーのオブジェクトは、リスト内のその下で表示されているすべてのレイヤーのオブジェクトに重なります。

アクティブ・レイヤー

現在アクティブになっているレイヤーの名前を表示します。一度に1つのレイヤーしかアクティブにすることができません。

新規名

選択したレイヤーの新しい名前です。「改名」を選択して、レイヤーの改名を行ってください。

改名

選択したレイヤーを、「新規名」テキスト・ボックスで指定されている名前に変更します。


オブジェクト・プロパティ

オブジェクト・プロパティ

名前、ボタン・プロシージャ、マウス・イベントおよびフォーマット・トリガー。

ドリルダウン・プロパティ

ドリルダウン・プロパティ


オブジェクト・プロパティ

名前

オブジェクトの名前です。PL/SQLプログラム単位で参照する場合は、オブジェクトの名前を指定する必要があります。プログラム目的でオブジェクトを参照しない場合は、名前を指定する必要はありません。

プロシージャ

オブジェクトに関連付けられたPL/SQLボタン・プロシージャの名前です。このプロシージャは、オブジェクトに関連する指定された「マウス・イベント」が検出される際に実行されます。このリストに表示されるのは、ボタン・トリガー・プロシージャが有効な場合のみです。

イベント・タイプ

どの「マウス・イベント」が指定されたボタン・プロシージャを起動するかを指定します。

マウス・ボタンを押す	マウス・ボタンで選択すると、プロシージャが起動します。

マウス・ボタンを放す	マウス・ボタンを放すと、プロシージャが起動します。

マウス・ボタンを押したまま、マウスを移動する	マウス・ボタンを押したままマウスを移動させると、プロシージャが起動します。

マウスボタンを放したまま、マウスを移動する	マウス・ボタンを放したままマウスを移動（レイヤーのみ）させると、プロシージャが起動します。

フォーマット・トリガー

オブジェクトに関連付けられたチャート・フォーマット・トリガーの名前です。このリストに表示されるのは、フォーマット・トリガー・プロシージャが有効な場合のみです。注意: このプロパティが適用されるのは、オブジェクトがチャート要素である場合に限ります。


ドリルダウン・プロパティ

パラメータ設定

オブジェクトを選択すると値が設定されるパラメータです。

作成

新しいパラメータを作成し、「パラメータ」プロパティ・ページを表示します。

以下の値に設定

オブジェクトを選択するとパラメータが設定される値を指定します。

オブジェクトがチャート要素の場合、チャートの問合せ内に現れる列を選択できます。続いてパラメータは、現行の問合せ行に対する指定された列内に現れるデータ値に設定されます。

オブジェクトがチャート要素でない場合は、パラメータはオブジェクトの名前にしか設定できません。

Execute Query(問合せ実行)

オブジェクトを選択したときに実行される問合せを指定します。パラメータを設定するように指定した場合は、その問合せが実行される前にパラメータが設定されます。

作成

新規の問合せを作成し、「問合せ」プロパティ・ページを表示します。


パラメータ・プロパティ

パラメータ

変更するパラメータを選択します。図表においてすでにあるパラメータがすべて、このリストに表示されます。

名前

パラメータの名前です。

Type

パラメータのデータ型です。

初期値

図表を初めて実行する際のパラメータの初期値です。ここに入力された値は、コマンド・ラインに指定された値に取り替えることができ、また、実行時に変更できます。

パラメータ値の長さは、2000バイトを超えてはいけません。


問合せプロパティ

問合せプロパティ

問合せ用の名前、データ・ソースおよびSQL文（必要な場合）。

データ・プロパティ（問合せ）

問合せによって戻されるデータ。

オプション・プロパティ

実行とデータ・キャッシング・プロパティおよびトリガー、その他のプロパティ。

スキーマ・プロパティ（カスタム問合せのみ）

カスタム列の名前およびデータ型を作成、削除および設定します。


問合せプロパティ

問合せ

変更する問合せを選択します。図表においてすでにある問合せがすべて、このリストに表示されます。

名前

問合せの名前です。

Type

問合せのタイプです。次のオプションから1つ選択してください。

SQL文 	問合せにより、指定したSQL SELECT文を基準にして、データがデータベースから取り出されます。「SQL文」テキスト・ボックスにSQL文を入力してください。

SYLKファイル	問合せは、SYLK書式のファイルからデータを検索します。SYLKは、Microsoft Excelなどのアプリケーションで使用されている書式です。問合せを実行すると、データはこのファイルから読み込まれます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

WKSファイル	問合せにより、データがWKS書式のファイルから取り出されます。WKSは、Lotus 1-2-3などの人気のアプリケーションに使用される書式です。問合せを実行すると、そのファイルからデータを読み込みます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

PRNファイル	問合せにより、データがPRN書式のファイルから取り出されます。PRNは、テキスト・ファイル書式です。問合せを実行すると、データはこのファイルから読み込まれます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

カスタム	ユーザーは問合せの列およびデータをカスタマイズできます。列を設定するには、「スキーマ」プロパティ・ページに表示される制御を使用します。データを設定するには、ビルトイン・プロシージャOG_APPEND_ROWを使用します。

外部SQLファイル	問合せにより、データがSQL SELECT文を含むテキスト・ファイルから取り出されます。問合せを実行すると、SQL文がこのファイルから読み込まれ実行されます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

ファイル

SYLK、WKS、PRNまたは外部SQL問合せに使用するファイルの位置と名前を表示します。ファイル・システムの中にあるファイルの位置を確認する場合は、「参照」ボタンを選択してください。

参照

ファイル名を探して選択し、「ファイル」テキスト・ボックスに表示させることができます。

SQL文

SQL文の問合せにおいて実行されるSQL SELECT文です。

接続

「接続」ダイアログ・ボックスが表示され、データベースへの接続が可能になります。

SQLインポート

テキスト・ファイルの内容を「SQL文」テキスト・ボックスに設定できます。テキストはコピーされますが、ファイルにはリンクされません。あるファイルのSQLテキストへのリンクを作成する場合は、外部SQLファイルの問合せタイプを使用してください。

SQLエクスポート

「SQL文」テキスト・ボックスの内容をファイルに設定できます。

作成

新しい問合せを作成します。

削除

現在の問合せを削除します。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。

データ消去

取り出されたすべてのデータのデータ・キャッシュを消去します。これを使用しても、その問合せ自体が削除されたり、変更されることはありません。


データ・プロパティ（問合せ）

問合せ

変更する問合せを選択します。図表においてすでにある問合せがすべて、このリストに表示されます。

作成

新しい問合せを作成します。

削除

現在の問合せを削除します。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。

データ消去

取り出されたすべてのデータのデータ・キャッシュを消去します。これを使用しても、その問合せ自体が削除されたり、変更されることはありません。


オプション・プロパティ

問合せ

変更する問合せを選択します。図表においてすでにある問合せがすべて、このリストに表示されます。

実行

どのようなときに問合せを自動的に実行するかを指定します。次のオプションから選択してください。

「オープンされている図表」	ランタイムで図表を最初にオープンするときに問合せを実行します。

タイマー	タイマーに指定した頻度で問合せを実行します。ドロップダウン・リストからタイマーを選択するか、または「編集」を選択して新しいタイマーを作成します。

Data

問合せデータに関連したいくつかのオプションを設定します。

新規データ	問合せの実行により新しく取り出されたデータを処理する方法を決定します。

「旧データを置換」を選択すると、前に実行されたデータがすべて廃棄され、新しく取り出されたデータに置換されます。

「旧データに追加」を選択すると、既存のデータ行がすべて維持され、既存のデータ・セットの一番下に新しいデータ行が追加されます。

旧データの保存	前に取り出されたデータを新しいデータに置換するときにその旧データを特別なバッファに格納するかどうかを指定します。続いて、OG_GET_NUMCELLなどのビルトイン・ルーチンによりこの「古いデータ」バッファをアクセスできます。このプロパティは、「新規データ」の設定が「旧データを置換」になっている場合に限り有効です。

最大行数	問合せデータ・セットに保持されるデータの最大行数を指定します。データを追加した結果、行数が最大値を超えてしまった場合は、すでにあるデータ行が超過した分だけ、データ・セットの一番上から廃棄されます。このプロパティは、「新規データ」の設定が「旧データに追加」になっている場合に限り有効です。また、問合せのmaxflag属性はTRUE（デフォルト）に設定する必要があります。maxflagの設定の詳細は、「最大行フラグ・プロパティ」を参照してください。

日付書式	ファイルの日付データを認識し、「日付」プロパティ・ページに日付がどのように表示されるかを決定するのに使用される書式を指定します。ファイル内の日付がここで指定した書式でない場合は、Graphics Builderはそれを日付として認識しません。

PL/SQL

問合せにより、PL/SQLの使用に関連したいくつかのオプションを設定します。

カスタム実行プロシージャ	（カスタム問合せのみ。）カスタムの問合せが実行されるときに起動するPL/SQLプロシージャです。このプロシージャは通常、問合せをデータに移入するPL/SQL文で構成されています。このリストに表示されるのは、カスタム問合せトリガー・プロシージャ・ヘッダーが有効なプロシージャのみです。

「新規作成」を選択して、新しいカスタム問合せプロシージャを作成してください。

実行後トリガー	問合せが実行された後で起動するPL/SQLプロシージャです。このリストに表示されるのは、問合せ後トリガー・プロシージャ・ヘッダーが有効なプロシージャのみです。

「新規作成」を選択して、新しい実行後プロシージャを作成してください。

作成

新しい問合せを作成します。

削除

現在の問合せを削除します。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。

データ消去

取り出されたすべてのデータのデータ・キャッシュを消去します。これを使用しても、その問合せ自体が削除されたり、変更されることはありません。


スキーマ・プロパティ

このプロパティは、カスタムの問合せ専用です。

問合せ

変更する問合せを選択します。図表においてすでにある問合せがすべて、このリストに表示されます。

Column

変更する列を選択します。この問合せに対して定義されたすべての列がこのリストに表示されます。

名前

列の名前です。列の名前を変更する場合は、ここに新しい名前を入力して「適用」を選択してください。

Type

列のデータ型。

最大長

列に入るデータの最大の長さ。これは、データ型がCHARの列のみに適用されます。

新規列

新しい列を問合せに追加します。

列削除

現在の列を問合せから削除します。

作成

新しい問合せを作成します。

削除

現在の問合せを削除します。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。

データ消去

取り出されたすべてのデータのデータ・キャッシュを消去します。これを使用しても、その問合せ自体が削除されたり、変更されることはありません。


参照線プロパティ

チャート・テンプレート・エディタに表示されているテンプレートの参照線プロパティを変更します。

参照線

変更する参照線を選択します。現在のテンプレートにある参照線がすべて、このリストに表示されます。

凡例

凡例に表示する参照線を識別するテキスト・ラベル。

値

参照値であり、この値で参照線が表示されます。

軸のマッピング

参照値がその位置を判断するために比較される軸を指定します。

作成

現在のテンプレートの新しい参照線を作成します。

削除

現在のテンプレートから参照線を削除します。


タイマー・プロパティ

タイマーを作成・削除し、タイマー名、トリガー・プロシージャおよび時間間隔を設定します。

「プロパティ・シート」オプション

タイマー

変更するタイマーを選択します。図表においてすでにあるタイマーがすべて、このリストに表示されます。

作成

新しいタイマーを作成します。

削除

現在のタイマーを削除します。

名前

タイマーの名前。

プロシージャ

タイマーが起動したときに実行されるPL/SQLプロシージャ（存在する場合）です。このリストに表示されるのは、タイマー・トリガー・プロシージャ・ヘッダーが有効なプロシージャのみです。

新しいタイマー・プロシージャを作成する場合は、「作成」を選択してください。

間隔

それぞれタイマーが起動してから次に起動するまでの時間です。

アクティブ

タイマーを起動するかどうかを指定します。

作成

新しいタイマーを作成します。

削除

現在のタイマーを削除します。


ファイルのセキュリティと制限について
�ファイルのセキュリティと制限について

Graphics Builderは、使用中のオペレーティング・システム環境を活用して、ファイルに格納されたモジュールのセキュリティを維持します。ファイルに格納されているモジュールへのアクセス権限を獲得する方法は、オペレーティング・システムによって異なります。詳細は、使用しているマニュアルを参照してください。


データベースのセキュリティと制限について

Graphics Builderユーザーに対して、次の2種類の制限を設定することができます。

Graphics Builderに対するアクセス権限の制御

モジュールに対する他者のアクセス権限の制御

Graphics Builderのセキュリティ機構は、OracleのGRANTおよびREVOKEコマンドを利用し、特別の制御方法も提供しています。GRANTおよびREVOKEコマンドを使用して設定されたすべての制限も適用されています。


Graphics Builderへのアクセス制御

Graphics Builderへのアクセスを制御する場合、

 ユーザーは、適切なインストール・スクリプトを実行することによってGraphics Builder表へのアクセス権限を獲得するまで、Graphics Builderにアクセスすることはできません。また、ユーザーのアクセス権限は手動で取り消す必要があります。


モジュールへの他のユーザーのアクセス制御

他からのモジュールへのアクセスを制御する場合、

1	レイアウト・エディタの「ファイル」 [image] 「管理」 [image] 「アクセス」メニューからモジュール・タイプを選択し、「データベース上モジュールへのアクセス」ダイアログ・ボックスを表示します。

2	モジュール名を選択します。

3	OKを選択して「モジュール・アクセス」ダイアログ・ボックスを表示します。

4	「ユーザー名」フィールドにユーザー名（またはPUBLIC）を入力します。PUBLICを入力すると、システム所有の表へのアクセス権限が付与されているユーザーはすべて、このモジュールにアクセスできるようになります。


データベース表の格納について

Graphics Builderでは、3種類の表の集合が使用できます。

•	デモ表	デモに使用されるサンプル・データを格納します。

•	データ表	各ユーザーがデータを格納します。

•	Graphics Builder表	Graphics Builderモジュールを格納します。

Graphics Builder表

Graphics Builderモジュール（図表、描画、チャート・テンプレート、カラー・パレット、サウンド、イメージ）は、データベースへの格納時には、Graphics Builder表に格納されます。この表は、次の表で構成されています。

Graphics Builder固有の表: Graphics Builder固有の表は、モジュール定義と他の図表の定義を格納します。この表は、Graphics Builderのみが使用でき、その他のOracle製品と共用することはできません。ビューやパブリック・シノニムを使用すると、ユーザーは、自分が所有しているモジュールや自分にアクセス権限のあるモジュールについての情報を参照できます。

Oracle製品共通の表: Oracle製品共通の表は、モジュール定義を格納し、他のOracle製品と共用できます。データベース・ビューやパブリック・シノニムを使用すると、ユーザーは、自分が所有しているモジュールや自分にアクセス権限のあるモジュールについての情報を参照できます。

注意: オラクル社は、Graphics Builder表の変更を特に目的としていないSQL*Plusや別のデータベース・ツールによって表定義を変更したモジュールの機能や整合性については一切保証しません。また、オラクル社は、常に予告なしに表の名前や構造を変更することがあります。


データベースの記憶域要件

Oracle製品共通の表には（空の場合）、およそ255データベース・ブロック（あるいは460KB）の記憶領域が必要です。さらに、Graphics Builder固有の表には（空の場合）、130データベース・ブロック（あるいは260KB）の記憶領域が必要です。複数のユーザーで1つのOracle製品表を共用する場合は、最初のインストール時には、385ブロックのみが必要となります。それ以外に、各ユーザーがそれぞれ独自のOracle製品表を所有する場合は、1人のユーザーにつき385ブロックが与えられます。

Oracle製品表が使用する記憶領域は、モジュールが定義されるたびに大きくなっていきます。実際の記憶領域は、モジュールによって大きく異なることがあります。また、図表の場合は、オブジェクト数、問合せ数、PL/SQLプログラム単位のサイズなどによって異なります。


Graphics Builder固有の表について

Graphics Builder固有の表は、モジュール定義と他の図表の定義を格納します。この表を使用できるのは、Graphics Builderのみで、その他のOracle製品と共用することはできません。ビューやパブリック・シノニムを使用すると、ユーザーは、自分が所有しているモジュールや自分にアクセス権限のあるモジュールについての情報を参照できます。


Graphics Builder固有の表

GC_CHARTING

GC_FIELD

GC_REFERENCE

GO_DOCUMENT

GO_PARAMETER

GO_QUERY

GO_SOUND

GO_TIMER

VG_COLOR

VG_FONT

VG_IMAGE


GC_CHARTING

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEMID	INTEGER	インスタンスID
CHARTNAME	RAW(255)	チャート名
CHARTNAME_LEN	INTEGER	チャート名の長さ
CHARTNAME_CS	INTEGER	チャート名のキャラクタ・セット
CHART_TYPE	INTEGER	チャート・タイプ
CHART_VIS	INTEGER	チャートの可視性フラグ
DEPTH_SIZE	INTEGER	深さサイズ（0 => 20）
SHADOW_SIZE	INTEGER	シャドウ・サイズ（0 => シャドウなし）
SHADOW_DIR	INTEGER	シャドウ方向
BASELN_FLG	INTEGER	基本線定義フラグ
BASELN_DAT	DATE	基本線の日付値
BASELN_VAL	FLOAT	基本線の値
CATEGORY_WD	FLOAT	項目合計幅（ストライプ幅の割合）
BASELN_AXIS	INTEGER	基本線軸マッピング（y1またはy2）
X1_AXIS_TYPE	INTEGER	軸のデータ型: 値日付または項目
X1_AXIS_DEP	INTEGER	軸の依存性の状態: 依存しいる場合は真
X1_SCALE_FNC	INTEGER	スケール機能: 線形または対数、割合
X1_AXIS_POS	INTEGER	軸の位置: 一番上/一番下/左/右
X1_GRID_VIS	INTEGER	主目盛きざみ/補助目盛きざみまたは主目盛グリッド/補助目盛グリッドの可視性マスク
X1_AXIS_STEP	INTEGER	ユーザー固定の最小/最大/ステップ・ビット・フラグ
X1_NUM_STRIP	INTEGER	項目軸のストライプ数
X1_CONT_AX_MN	FLOAT	値軸の最小値
X1_CONT_AX_MX	FLOAT	値軸の最大値
X1_CONT_AX_ST	FLOAT	値軸のステップ
X1_DATE_AX_MN	DATE	日付軸の最小値
X1_DATE_AX_MX	DATE	日付軸の最大値
X1_DATE_AX_ST	INTEGER	日付軸のステップ
X1_AX_LBL_HS	INTEGER	軸ラベルの非表示/表示化フラグ
X1_TIC_TYPE	INTEGER	目盛きざみタイプ（中心に設定/中心から外して設定）
X1_MINOR_TIC	INTEGER	補助目盛きざみ/グリッドの件数0..9
X1_NUM_FORMAT	RAW(255)	目盛きざみラベル用の数値書式文字列
X1_NUM_FORMAT_CS	INTEGER	目盛きざみラベル用の数値書式キャラクタ・セット
X1_NUM_FORMAT_LEN	INTEGER	目盛きざみラベル用の数値書式文字列の長さ
X1_DAT_FORMAT	RAW(255)	目盛きざみラベル用の日付書式文字列
X1_DAT_FORMAT_CS	INTEGER	目盛きざみラベル用の日付書式キャラクタ・セット
X1_DAT_FORMAT_LEN	INTEGER	目盛きざみラベル用の日付書式文字列の長さ
X1_TIC_ROT	INTEGER	目盛きざみラベルの方向（回転）
X1_TIC_FIX	INTEGER	目盛きざみラベル固定方向フラグ
X1_TIC_DT_VIS	INTEGER	日付が表示された軸の目盛きざみラベルの可視性
X1_DATE_ABBR	INTEGER	日付が略記されたフラグ
X1_WKEND_FLG	INTEGER	週末なしフラグ
X1_START_MNTH	INTEGER	会計年度の始まる月(1..2)
X1_PCT_TYP	INTEGER	パーセント・タイプ（合計または最小値、最大値）
X1_PCT_GRP	INTEGER	パーセントのグループ化（列または項目）
X2_AXIS_TYPE	INTEGER	軸のデータ型: 値日付または項目
X2_AXIS_DEP	INTEGER	軸の依存性状態: 依存性状態であれば真
X2_SCALE_FNC	INTEGER	スケール機能: 線形または対数、割合
X2_AXIS_POS	INTEGER	軸の位置: 一番上/一番下/左/右
X2_GRID_VIS	INTEGER	主目盛きざみ/補助目盛きざみまたは主目盛グリッド/補助目盛グリッドの可視性マスク
X2_AXIS_STEP	INTEGER	ユーザー固定の最小/最大/ステップ・ビット・フラグ
X2_NUM_STRIP	INTEGER	項目軸のストライプ数
X2_CONT_AX_MN	FLOAT	値軸の最小値
X2_CONT_AX_MX	FLOAT	値軸の最大値
X2_CONT_AX_ST	FLOAT	値軸のステップ
X2_DATE_AX_MN	DATE	日付軸の最小値
X2_DATE_AX_MX	DATE	日付軸の最大値
X2_DATE_AX_ST	INTEGER	日付軸のステップ
X2_AX_LBL_HS	INTEGER	軸ラベルの非表示/表示化フラグ
X2_TIC_TYPE	INTEGER	目盛きざみタイプ（中心に設定/中心から外して設定）
X2_MINOR_TIC	INTEGER	補助目盛きざみ/グリッドの件数0..9
X2_NUM_FORMAT	RAW(255)	目盛きざみラベル用の数値書式文字列
X2_NUM_FORMAT_CS	INTEGER	目盛きざみラベル用の数値書式キャラクタ・セット
X2_NUM_FORMAT_LEN	INTEGER	目盛きざみラベル用の数値書式文字列の長さ
X2_DAT_FORMAT	RAW(255)	目盛きざみラベル用の日付書式文字列
X2_DAT_FORMAT_CS	INTEGER	目盛きざみラベル用の日付書式キャラクタ・セット
X2_DAT_FORMAT_LEN	INTEGER	目盛きざみラベル用の日付書式文字列の長さ
X2_TIC_ROT	INTEGER	目盛きざみラベルの方向（回転）
X2_TIC_FIX	INTEGER	目盛きざみラベル固定方向フラグ
X2_TIC_DT_VIS	INTEGER	日付が表示された軸の目盛きざみラベルの可視性
X2_DATE_ABBR	INTEGER	日付が略記されたフラグ
X2_WKEND_FLG	INTEGER	週末なしフラグ
X2_START_MNTH	INTEGER	会計年度の始まる月(1..2)
X2_PCT_TYP	INTEGER	パーセント・タイプ（合計または最小値、最大値）
X2_PCT_GRP	INTEGER	パーセントのグループ化（列または項目）
X3_AXIS_TYPE	INTEGER	軸のデータ型: 値日付または項目
X3_AXIS_DEP	INTEGER	軸の依存性状態: 依存性状態であれば真
X3_SCALE_FNC	INTEGER	スケール機能: 線形または対数、割合
X3_AXIS_POS	INTEGER	軸の位置: 一番上/一番下/左/右
X3_GRID_VIS	INTEGER	主目盛きざみ/補助目盛きざみまたは主目盛グリッド/補助目盛グリッドの可視性マスク
X3_AXIS_STEP	INTEGER	ユーザー固定の最小/最大/ステップ・ビット・フラグ
X3_NUM_STRIP	INTEGER	項目軸のストライプ数
X3_CONT_AX_MN	FLOAT	値軸の最小値
X3_CONT_AX_MX	FLOAT	値軸の最大値
X3_CONT_AX_ST	FLOAT	値軸のステップ
X3_DATE_AX_MN	DATE	日付軸の最小値
X3_DATE_AX_MX	DATE	日付軸の最大値
X3_DATE_AX_ST	INTEGER	日付軸のステップ
X3_AX_LBL_HS	INTEGER	軸ラベルの非表示/表示化フラグ
X3_TIC_TYPE	INTEGER	目盛きざみタイプ（中心に設定/中心から外して設定）
X3_MINOR_TIC	INTEGER	補助目盛きざみ/グリッドの件数0..9
X3_NUM_FORMAT	RAW(255)	目盛きざみラベル用の数値書式文字列
X3_NUM_FORMAT_CS	INTEGER	目盛きざみラベル用の数値書式キャラクタ・セット
X3_NUM_FORMAT_LEN	INTEGER	目盛きざみラベル用の数値書式文字列の長さ
X3_DAT_FORMAT	RAW(255)	目盛きざみラベル用の日付書式文字列
X3_DAT_FORMAT_CS	INTEGER	目盛きざみラベル用の日付書式キャラクタ・セット
X3_DAT_FORMAT_LEN	INTEGER	目盛きざみラベル用の日付書式文字列の長さ
X3_TIC_ROT	INTEGER	目盛きざみラベルの方向（回転）
X3_TIC_FIX	INTEGER	目盛きざみラベル固定方向フラグ
X3_TIC_DT_VIS	INTEGER	日付が表示された軸の目盛きざみラベルの可視性
X3_DATE_ABBR	INTEGER	日付が略記されたフラグ
X3_WKEND_FLG	INTEGER	週末なしフラグ
X3_START_MNTH	INTEGER	会計年度の始まる月(1..2)
X3_PCT_TYP	INTEGER	パーセント・タイプ（合計または最小値、最大値）
X3_PCT_GRP	INTEGER	パーセントのグループ化（列または項目）
P_CLOCK_FLG	INTEGER	時計回りフラグ
P_SUM_FLG	INTEGER	合計フラグ
P_TIC_VIS	INTEGER	目盛きざみ/ラベル可視性ビット・マスク
P_FIXED_SUM	FLOAT	ユーザー定義の合計
P_FIXED_PCT	FLOAT	ユーザー定義の割合
P_CAT_LBL_FMT	RAW(255)	項目ラベル書式文字列
P_CAT_LBL_FMT_CS	INTEGER	項目ラベル書式キャラクタ・セット
P_CAT_LBL_FMT_LEN	INTEGER	項目ラベル書式文字列の長さ
P_DAT_LBL_FMT	RAW(255)	日付ラベル書式文字列
P_DAT_LBL_FMT_CS	INTEGER	日付ラベル書式キャラクタ・セット
P_DAT_LBL_FMT_LEN	INTEGER	日付ラベル書式文字列の長さ
P_ABS_LBL_FMT	RAW(255)	絶対ラベル書式文字列
P_ABS_LBL_FMT_CS	INTEGER	絶対ラベル書式キャラクタ・セット
P_ABS_LBL_FMT_LEN	INTEGER	絶対ラベル書式文字列の長さ
P_PCT_LBL_FMT	RAW(255)	パーセント・ラベル書式文字列
P_PCT_LBL_FMT_CS	INTEGER	パーセント・ラベル書式キャラクタ・セット
P_PCT_LBL_FMT_LEN	INTEGER	パーセント・ラベル書式文字列の長さ
T_MAX_ROW	INTEGER	最大行数
T_MAX_ROW_FIX	INTEGER	最大行数固定フラグ
T_GRID_VIS	INTEGER	グリッド可視性フラグ
T_TABLE_DIR	INTEGER	表方向
T_ROW_PERGRID	INTEGER	水平グリッド当たりの行数
L_NUM_COL	INTEGER	凡例: 列数
L_SHADOW_SIZE	INTEGER	凡例: シャドウ・サイズ（0 => シャドウなし）


GC_FIELD

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEMID	INTEGER	インスタンスID
TEMPLATE_SEQ	INTEGER	フィールド・テンプレート順序（シーケンス）番号
FIELDNAME	RAW(255)	フィールド・テンプレート名
FIELDNAME_LEN	INTEGER	フィールド・テンプレート名の長さ
FIELDNAME_CS	INTEGER	フィールド・テンプレート名のキャラクタ・セット
PLOT_DEF	INTEGER	表示定義ビット・マスク
CONNECT_TYPE	INTEGER	コネクタ・タイプ
PLOT_EXT	INTEGER	表示エクステント
REGRESS_TST	INTEGER	復帰タイプ
ROT_COL_FLAG	INTEGER	カラー/パターン回転フラグ
LABEL_ROT_ANG	INTEGER	ラベル回転角度
BAR_OVERLAP	FLOAT	棒のオーバーラップ（棒幅における小数部）
NUM_FORMAT	RAW(255)	テキスト/注釈用の数値書式文字列
NUM_FORMAT_CS	INTEGER	テキスト/注釈用の数値書式キャラクタ・セット
NUM_FORMAT_LEN	INTEGER	テキスト/注釈用の数値書式文字列の長さ
DAT_FORMAT	RAW(255)	テキスト/注釈用の日付書式文字列
DAT_FORMAT_CS	INTEGER	テキスト/注釈用の日付書式キャラクタ・セット
DAT_FORMAT_LEN	INTEGER	テキスト/注釈用の日付書式文字列の長さ
AXIS_MAPPING	INTEGER	軸のマッピング


GC_REFERENCE

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEMID	INTEGER	インスタンスID
REFLINE_ID	INTEGER	参照線ID
REFLINE_MAP	INTEGER	参照線のマッピング
CONT_AXIS_VAL	FLOAT	この行をマッピングしている値軸の値
DATE_AXIS_VAL	DATE	参照線の日付軸値のマッピング
LEG_LBL	RAW(255)	凡例ラベル文字列
LEG_LBL_LEN	INTEGER	凡例ラベル文字列の長さ
LEG_LBL_CS	INTEGER	凡例文字列のキャラクタ・セット


GO_DOCUMENT

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
FOREGROUND_EDGE_COLOR	INTEGER	デフォルト・フォアグラウンド線カラー
BACKGROUND_EDGE_COLOR	INTEGER	デフォルト・バックグラウンド線カラー
EDGE_PATTERN	INTEGER	デフォルト枠パターン
FOREGROUND_FILL_COLOR	INTEGER	デフォルト塗りフォアグラウンド・カラー
BACKGROUND_FILL_COLOR	INTEGER	デフォルト塗りバックグラウンド・カラー
FILL_PATTERN	INTEGER	デフォルト塗りパターン
DASH_STYLE	INTEGER	デフォルト線種スタイル
ARROW_STYLE	INTEGER	デフォルト矢印スタイル
SYMBOL_SIZE	INTEGER	デフォルト記号サイズ
SYMBOL_INDEX	INTEGER	デフォルト記号索引
BRUSH_WIDTH	INTEGER	デフォルト線幅
TRANS_MODE	INTEGER	デフォルト転送モード
CAP_STYLE	INTEGER	デフォルト端形式
JOIN_STYLE	INTEGER	デフォルト結合形式
ARC_FILL_STYLE	INTEGER	デフォルトの円弧の形
ARC_CLOSURE	INTEGER	デフォルトの円弧の閉じ
RRECT_CORNER_WIDTH	INTEGER	デフォルトの丸い四角形の角の幅
RRECT_CORNER_HEIGHT	INTEGER	デフォルトの丸い四角形の角の幅
FACE_NAME	RAW(255)	デフォルト・フォント・タイプフェース
FACE_NAME_CHAR	INTEGER	タイプフェース名のキャラクタ・セット
FACE_NAME_LEN	INTEGER	タイプフェース名の長さ
FONT_SIZE	INTEGER	デフォルト・フォント・ポイント・サイズ
FONT_STYLE	INTEGER	デフォルト・フォント・スタイル
FONT_WEIGHT	INTEGER	デフォルトのフォントの太さ
FONT_WIDTH	INTEGER	デフォルトのフォントの幅
IMAGE_TEXT	INTEGER	デフォルト・イメージ・テキスト
KERNING	INTEGER	デフォルトのカーニング設定
CHAR_SET	INTEGER	デフォルトキャラクタ・セット
TEXT_COLOR	INTEGER	デフォルト・テキスト・カラー
TEXT_HOR_ALIGN	INTEGER	デフォルトの水平テキスト整列
TEXT_VER_ALIGN	INTEGER	デフォルトの垂直テキスト整列
TEXT_HOR_JUSTI	INTEGER	デフォルトの水平テキスト文字揃え
TEXT_VER_JUSTI	INTEGER	デフォルトの垂直テキスト文字揃え
TEXT_SPACING	INTEGER	デフォルトのテキストの間隔
TEXT_FIXED_FLAG	INTEGER	デフォルトの固定テキスト・フラグ
TEXT_FONTSC_FLAG	INTEGER	デフォルト・スケーラブル・フォント・フラグ
TEXT_WRAP_FLAG	INTEGER	デフォルト・テキスト・ラップ・フラグ
TEXT_BBOX_SCALABILITY	INTEGER	デフォルト・スケーラブル・テキスト・ボックス・フラグ
TEXT_INVISIBILITY	INTEGER	デフォルトの見えないテキスト・フラグ
TEXT_CUSTOM_SPACING	INTEGER	デフォルトのカスタム間隔フラグ
HOR_ALIGN_MODE	INTEGER	デフォルト水平整列設定
VER_ALIGN_MODE	INTEGER	デフォルト垂直整列設定
CTR_TRACK_FLAG	INTEGER	デフォルトの中心/角からの描画フラグ
DRAW_SIZE_WIDTH_DEN	INTEGER	レイアウト幅の分母
DRAW_SIZE_WIDTH_NUM	INTEGER	レイアウト幅の分子
DRAW_SIZE_HEIGHT_DEN	INTEGER	レイアウト高さの分母
DRAW_SIZE_HEIGHT_NUM	INTEGER	レイアウト高さの分子
PAGE_COUNT	INTEGER	デフォルト・ページ・カウント
ACTIVE_LAYER	INTEGER	アクティブ・レイヤーID
MAIN_EDITOR_X	INTEGER	レイアウト・エディタのX座標
MAIN_EDITOR_Y	INTEGER	レイアウト・エディタのY座標
MAIN_EDITOR_WIDTH	INTEGER	レイアウト・エディタの幅
MAIN_EDITOR_HEIGHT	INTEGER	レイアウト・エディタの高さ
CHART_TEMP_HS	INTEGER	チャート・テンプレート・エディタの非表示/表示化
CHART_TEMP_X	INTEGER	チャート・テンプレート・エディタのX座標
CHART_TEMP_Y	INTEGER	チャート・テンプレート・エディタのY座標
CHART_TEMP_WIDTH	INTEGER	チャート・テンプレート・エディタの幅
CHART_TEMP_HEIGHT	INTEGER	チャート・テンプレート・エディタの高さ
DATATABLE_HS	INTEGER	データ表の非表示/表示化
DATATABLE_X	INTEGER	データ表のX座標
DATATABLE_Y	INTEGER	データ表のY座標
DATATABLE_WIDTH	INTEGER	データ表の幅
DATATABLE_HEIGHT	INTEGER	データ表の高さ
CONST_WIND_HS	INTEGER	一貫性チェッカの非表示/表示化
CONST_WIND_X	INTEGER	一貫性チェッカのX座標
CONST_WIND_Y	INTEGER	一貫性チェッカのY座標
CONST_WIND_WIDTH	INTEGER	一貫性チェッカの幅
CONST_WIND_HEIGHT	INTEGER	一貫性チェッカの高さ
PLSQL_WIND_HS	INTEGER	バッチ・コンパイラの非表示/表示化
PLSQL_WIND_X	INTEGER	バッチ・コンパイラのX座標
PLSQL_WIND_Y	INTEGER	バッチ・コンパイラのY座標
PLSQL_WIND_WIDTH	INTEGER	バッチ・コンパイラの幅
PLSQL_WIND_HEIGHT	INTEGER	バッチ・コンパイラの高さ
PLSQL_PROG_HS	INTEGER	PL/SQLブラウザの非表示/表示化
PLSQL_PROG_X	INTEGER	PL/SQLブラウザのX座標
PLSQL_PROG_Y	INTEGER	PL/SQLブラウザのY座標
PLSQL_PROG_WIDTH	INTEGER	PL/SQLブラウザの幅
PLSQL_PROG_HEIGHT	INTEGER	PL/SQLブラウザの高さ
PLSQL_BROWSER_HS	INTEGER	ライブラリ・ブラウザの非表示/表示化
PLSQL_BROWSER_X	INTEGER	ライブラリ・ブラウザのX座標
PLSQL_BROWSER_Y	INTEGER	ライブラリ・ブラウザのY座標
PLSQL_BROWSER_WIDTH	INTEGER	ライブラリ・ブラウザの幅
PLSQL_BROWSER_HEIGHT	INTEGER	ライブラリ・ブラウザの高さ
BIND_VAR_HS	INTEGER	パラメータ表の非表示/表示化
BIND_VAR_X	INTEGER	パラメータ表のX座標
BIND_VAR_Y	INTEGER	パラメータ表のY座標
BIND_VAR_WIDTH	INTEGER	パラメータ表の幅
BIND_VAR_HEIGHT	INTEGER	パラメータ表の高さ
OPEN_DRAWING_TRIGNAME	RAW(255)	オープン・トリガー名
OPEN_DRAWING_CHARSET	INTEGER	Open Displayトリガー名のキャラクタ・セット
OPEN_DRAWING_CHARLEN	INTEGER	オープン・トリガー名の長さ
CLOSE_DRAWING_TRIGNAME	RAW(255)	クローズ・トリガー名
CLOSE_DRAWING_CHARSET	INTEGER	クローズ・トリガー名のキャラクタ・セット
CLOSE_DRAWING_CHARLEN	INTEGER	クローズ・トリガー名の長さ
BIND_VAR_NAME	RAW(255)	パラメータ表の日付書式
BIND_VAR_CHAR	INTEGER	パラメータ表の日付書式のキャラクタ・セット
BIND_VAR_LEN	INTEGER	パラメータ表の日付書式の長さ
TEMPLATE_NAME	RAW(255)	現在のテンプレート名
TEMPLATE_NAME_CHAR	INTEGER	現在のテンプレート名のキャラクタ・セット
TEMPLATE_NAME_LEN	INTEGER	現在のテンプレート名の長さ
ACTIVE_QUERY	INTEGER	現在の問合せID
DISPLAY_ROW	INTEGER	パラメータ表内の行数
OCL_VERSION	INTEGER	Oracle Charting Libraryのバージョン番号


GO_PARAMETER

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEM	INTEGER	パラメータID
PARAM_NAME	RAW(255)	パラメータ名
PARAM_NAME_CHAR	INTEGER	パラメータ名のキャラクタ・セット
PARAM_NAME_LEN	INTEGER	パラメータ名の長さ
PARAM_TYPE	INTEGER	パラメータ・タイプ
PARAM_STR_NAME	RAW(255)	パラメータ値
PARAM_STR_NAME_CHAR	INTEGER	パラメータ値のキャラクタ・セット
PARAM_STR_NAME_LEN	INTEGER	パラメータ値の長さ
ROW_NUMBER	INTEGER	パラメータ表の行


GO_QUERY

名前	Type	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEMID	INTEGER	問合せID
QUERY_NAME	RAW(255)	問合せ名
QUERY_NAME_CHAR	INTEGER	問合せ名のキャラクタ・セット
QUERY_NAME_LEN	INTEGER	問合せ名の長さ
QUERY_SRC	LONG RAW	問合せソース
QUERY_SRC_CHAR	INTEGER	問合せソースのキャラクタ・セット
QUERY_SRC_LEN	INTEGER	問合せソースの長さ
QUERY_TYPE	INTEGER	問合せタイプ
DATE_FORMAT	RAW(255)	日付書式
DATE_FORMAT_CHAR	INTEGER	日付書式のキャラクタ・セット
DATE_FORMAT_LEN	INTEGER	日付書式の長さ


GO_SOUND

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEMID	INTEGER	サウンドID
名前	RAW(255)	サウンド名
NAME_SET	INTEGER	サウンド名のキャラクタ・セット
NAME_LEN	INTEGER	サウンド名の長さ
LONGID	INTEGER	LONGフィールドID
RECVOLUME	INTEGER	録音ボリューム
PLAYVOLUME	INTEGER	再生ボリューム


GO_TIMER

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEM	INTEGER	タイマーID
TIMER_NAME	RAW(255)	タイマー名
TIMER_NAME_CHARSET	INTEGER	タイマー名のキャラクタ・セット
TIMER_NAME_LENGTH	INTEGER	タイマー名の長さ
proc_name	RAW(255)	タイマー・プロシージャ名
PROC_NAME_CHARSET	INTEGER	プロシージャ名のキャラクタ・セット
PROC_NAME_LENGTH	INTEGER	プロシージャ名の長さ
TIMER_INTERVAL	INTEGER	タイマー間隔


GO_VISLAYER

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
LAYERID	INTEGER	レイヤーID


VG_COLOR

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEMID	INTEGER	インスタンスID
CELLID	INTEGER	カラー・セルID
COLOR_NAME	RAW(255)	カラー名
NAME_SET	INTEGER	カラー名のキャラクタ・セット
NAME_LENGTH	INTEGER	カラー名の長さ
RED	INTEGER	赤の成分
GREEN	INTEGER	緑の成分
BLUE	INTEGER	青の成分


VG_DRAWING

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEMID	INTEGER	インスタンスID
LONGID	INTEGER	LONGフィールドID


VG_FONT

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEMID	INTEGER	インスタンスID
FONTID	INTEGER	フォントID
COUNT	INTEGER	フォントを参照するオブジェクトの数
名前	RAW(255)	フォント名
NAME_SET	INTEGER	フォント名のキャラクタ・セット
NAME_LEN	INTEGER	フォント名の長さ
FONT_SIZE	INTEGER	フォント・サイズ
STYLE	INTEGER	フォント・スタイル
WEIGHT	INTEGER	フォントの太さ
WIDTH	INTEGER	フォントの幅
IMAGETEXT	INTEGER	フォント・イメージ・テキスト
KERNING	INTEGER	フォント・カーニング
CHAR_SET	INTEGER	フォント・キャラクタ・セット


VG_IMAGE

名前	データ型	説明

OWNER	VARCHAR(30)	所有者ID
MODID	INTEGER	モジュールID
ITEMID	INTEGER	インスタンスID
IMAGEID	INTEGER	イメージID
COUNT	INTEGER	イメージを参照するオブジェクトの数
LONGID	INTEGER	LONGフィールドID


Oracle製品共通の表について

Oracle製品共通の表は、モジュール定義を格納し、他のOracle製品と共用できます。データベース・ビューやパブリック・シノニムを使用すると、ユーザーは、自分が所有しているモジュールや自分にアクセス権限のあるモジュールについての情報を参照できます。


Oracle製品共通の表

DE_ATTACHED_LIBS

ROSLFDESC

ROSSTRINGS

TOOL_ACCESS

TOOL_LRAW

TOOL_MODULE

TOOL_PLSQL


DE_ATTACHED_LIBS

名前	データ型	説明

OWNER	VARCHAR(30)	所有者
MODID	NUMBER(10)	モジュールID
ITEMID	NUMBER(10)	ライブラリ番号（リスト順）
LIBNAME	VARCHAR(30)	ライブラリ名
LIBMODE	NUMBER(10)	ライブラリ・モード（ビット・マスク）


ROSLFDESC

名前	データ型	説明

OWNER	VARCHAR(30)	ユーザー
MODID	NUMBER(10)	モジュールID
ID	NUMBER(10)	LONGフィールドID
LPAGEID	NUMBER(10)	論理ページ順序番号
LFLEN	NUMBER(10)	LONGフィールドの長さ
N	NUMBER(10)	ページ数
DATALEN	NUMBER(10)	該当ページのデータの長さ
DATA	LONG RAW	データ（文字列）


ROSSEQUENCES

名前	データ型	説明

OWNER	VARCHAR2(30)	所有者
MODID	NUMBER(10)	モジュールID
SEQNAME	VARCHAR2(30)	順序名
MIN_VAL	NUMBER(10)	最小値
MAX_VAL	NUMBER(10)	最大値
INC_BY	NUMBER(10)	増分ステップ
CURRVAL	NUMBER(10)	現在の設定値
NEXTVAL	NUMBER(10)	次の値
CASHSIZE	NUMBER(10)	キャッシュ・サイズ


ROSSTRINGS

名前	データ型	説明

OWNER	VARCHAR(30)	ユーザー
MODID	NUMBER(10)	モジュールID
GROUPID	NUMBER(10)	グループID
STRINGID	NUMBER(10)	モジュール内の文字列のインスタンスを識別する
LFID	NUMBER(10)	ROS使用
LEN length	NUMBER(10)	データ（文字列）
CS	NUMBER(10)	キャラクタ・セット
STR	LONG RAW	データ（文字列）


TOOL_ACCESS

名前	データ型	説明

PRODUCT	VARCHAR(30)	製品名
OWNER	VARCHAR(30)	モジュールの所有者
MODID	INTEGER	モジュールID
GRANTEE	VARCHAR(30)	アクセス権限が付与されたユーザー


TOOL_LRAW

名前	データ型	説明

OWNER	VARCHAR(30)	モジュールの所有者
MODID	NUMBER(10)	モジュールID
ID	NUMBER(10)	LONG RAWフィールドID
LPAGEID	NUMBER(10)	LONG RAWページID
LFLEN	NUMBER(10)	LONG RAWフィールドの長さ
N	NUMBER(10)	LONG RAWフィールドの順序番号
ATALEN	NUMBER(10)	LONG RAWフィールドの長さ
DATA	LONG RAW	LONG RAWデータ長


TOOL_MODULE

名前	データ型	説明

PRODUCT	VARCHAR(30)	製品名
MODTYPE	VARCHAR(30)	モジュール・タイプ
MODID	NUMBER(10)	モジュールID
NEXT_ITEMID	NUMBER(10)	次に使用可能な内部ID
OWNER	VARCHAR(30)	モジュールの所有者
MODNAME	VARCHAR(30)	モジュール名
CREATOR	VARCHAR(30)	モジュールを作成したユーザー
CREATE_DATE	DATE	作成日
CREATE_VER	NUMBER(10)	作成された製品のバージョン
MODIFIER	VARCHAR(30)	最後にモジュールを変更したユーザー
MOD_DATE	DATE	変更日
MOD_VER	NUMBER(10)	変更された製品のバージョン
COPYRIGHT	VARCHAR(250)	モジュールの著作権情報
REQ_ROLE	VARCHAR(30)	該当モジュールの実行に必要なロール
TCS_VER	NUMBER(8)	TCSのバージョン
VGS_VER	NUMBER(8)	VGSのバージョン
DE_VER	NUMBER(8)	DEのバージョン
ROS_VER	NUMBER(8)	ROSのバージョン


TOOL_PLSQL

名前	データ型	説明

OWNER	VARCHAR(30)	モジュールの所有者
MODID	NUMBER(10)	モジュールID
ITEMID	NUMBER(10)	項目（プログラム単位）ID
OBJECT_ID	NUMBER(10)	関連付けられたオブジェクトID(オプション）
タイプ	NUMBER(4)	プログラム単位のタイプ（オプション、製品定義）
名前	VARCHAR(30)	プログラム単位の名前
PLSLFID_ST	NUMBER(10)	PL/SQLソース・テキストのLONGフィールドID
PLSLFID_EP	NUMBER(10)	PL/SQLコード・プログラム単位のLONGフィールドID


?


フォント・マッピング

1つのキャラクタ・セット(たとえば、WE8ISO8859P1)を使用して図表を作成しているときに別のキャラクタ・セット(EEC8EUROPA3)で実行する場合は、フォント別名ファイル(uifont.ali)に適切なエントリを作成してそれらのキャラクタ・セットの間にフォントをマッピングするようにしてください。

Graphics Builderが使用するフォントの別名を定義する場合には、uifont.aliファイルを編集します。別名を定義する各フォントごとに、ファイル内に次のエントリを作成してください。

source_font = destination_font

各フォントには、次の属性を指定できます。

<face>.<size>.<style>.<weight>.<width>.<character_set>

<face>には、必ずフォントの名前(文字列/識別子)を指定してください。<style>、<weight>、<width>および<character_set>には、数値もしくは事前定義された識別子または文字列を指定できます。たとえば、US7ASCIIも1も値として有効であり、同じキャラクタ・セットを参照します。<size>には、必ず明確なサイズをポイント単位で指定してください。

次は、認識されている名前とそれに対応する数値のリストです。

スタイル	数値
----------------------------------------
plain	0
italic	1
oblique	2
underline	4
outline	8
shadow	16
inverted	32
overstrike	64
blink	128

太さ	数値
---------------------------------------
ultralight	1
extralight	2
light	3
demilight	4
medium	5
demibold	6
bold	7
extrabold	8
ultrabold	9
ultradense	1
extradense	2
dense	3
semidense	4
normal	5
semiexpand	6
expand	7
extraexpand	8
ultraexpand	9

プラス記号（+）を使用することによって、複数のスタイルを組み合せることができます。次に例を示します。

Arial..Italic+Overstrike = Helvetica.12.Italic.Bold

文字列のマッピングはすべて、大/小文字の区別なく行われます。フォントは、プラットフォームや表示面によっては、検索時に大/小文字が区別されることがあるため、右側に名前が指定されている場合にはよく注意してください。ただし、マッピング時には、大/小文字は区別されません。

円記号(\)は、継続文字として使用されます。コメントは、次のように挿入できます。

/* comment */
# comment
; comment

フォント・マッピングの確認

uifont.aliファイルが適切であるかどうかについては、fontchkを使用して確認できます。これは、ファイルにエラーがないかをチェックするプログラムです。次を入力して、フォント・マッピング・ファイルを解析してください。

fontchk filename

フォント・マッピングの例

以下は、Graphics Builderで使用可能なフォント・マッピング・ファイルの例です。

[ Global ]  # Put mappings for all surfaces here.

# Mapping from MS Windows

Arial             = helvetica
"Courier New"     = courier
"Times New Roman" = times
Modern            = helvetica
"MS Sans Serif"   = helvetica
"MS Serif"        = times
"Small Fonts"     = helvetica

# Mapping from Macintosh

"New Century Schlbk" = "new century schoolbook"
"New York"           = "times"
[ Printer ]  # Put mappings for all printers here.
[ Printer:PostScript1 ]  /* Put mappings for PostScript
                            level 1 printers here. */

# Mapping from MS Windows

Roman             = palatino
Script            = "itc zapf chancery"
FixedSys          = courier
System            = helvetica
# Mapping from Macintosh
"Avant Garde"     = "itc avant garde gothic"

# Mapping from Motif display

fixed             = courier
clean             = times
lucidatypewriter  = courier
lucidabright      = times

# Sample Kanji font mappings

courier...Medium..JEUC   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..JEUC     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
courier...Medium..SJIS   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..SJIS     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..JEUC     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..JEUC       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..SJIS     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..SJIS       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..JEUC = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..JEUC   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..SJIS = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..SJIS   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC

[ Printer:PostScript2 ]  /* Put mappings for PostScript
                            level 2 printers here. */

# Mapping from MS Windows

Roman             = palatino
Script            = "itc zapf chancery"
FixedSys          = courier
System            = helvetica

# Mapping from Macintosh

"Avant Garde"     = "itc avant garde gothic"

# Mapping from Motif display

fixed             = courier
clean             = times
lucidatypewriter  = courier
lucidabright      = times

# Sample Kanji font mappings

courier...Medium..JEUC   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..JEUC     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
Courier...Medium..SJIS   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..SJIS     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..JEUC     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..JEUC       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..SJIS     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..SJIS       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..JEUC = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..JEUC   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..SJIS = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..SJIS   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC

[ Display ]  # Put mappings for all display surfaces here.

[ Display:Motif ]  # Put mappings for Motif displays here

# Mapping from MS Windows

Courier           = courier
Roman             = lucida
Script            = lucidabright
FixedSys          = fixed
System            = lucida

# Mapping from Macintosh

"Avant Garde"     = helvetica
"Bookman"         = times
[ Display:CM ]     # Put mappings for all CM displays here.

# These are DEC-specific, and may need localization

*..Blink          = Blinking
*..Inverted+Underline.Bold = ReverseBoldUnderline
*..Inverted+Underline.= UnderlineReverse
*..Underline.Bold = UnderlineBold
*..Inverted.Bold  = ReverseBold
*...Bold          = Bold
*..Underline      = Underline
*..Inverted       = Reverse
*                 = Plain    # The font of last resort


フォント・マッピング・ファイル

Graphics Builderは、フォントの別名をサポートしています。Graphics Builderで使用されるフォント・マッピングは、uifont.aliファイルに定義されています。このファイルを編集すると、マッピングを変更できます。このファイルの位置は、オペレーティング・システムによって異なります。

注意: Graphics Builderは、環境変数TK2_FONTALIASで指定された位置にあるフォント・マッピング・ファイルを検索します。TK2_FONTALIASが指定されていないと、Graphics Builderは、使用しているオペレーティング・システムのデフォルトの位置にあるファイルを検索します。


ユーザー・イグジット用にサポートされるファンクション

Oracleプリコンパイラ・ホスト言語のうちの1つを使用して作成されたユーザー・イグジットでは、次を実行できます。

•	プロシージャ操作（ホスト言語の文を使用して）

•	追加ファンクション（次の文を使用して)

使用可能な文	使用方法

EXEC SQL	SQLコマンドを実行します。
EXEC TOOLS GET	Graphics Builderからユーザー・イグジットに値を渡します。
EXEC TOOLS SET	ユーザー・イグジットからGraphics Builderに値を渡します。
EXEC TOOLS MESSAGE	ユーザー・イグジットからGraphics Builderに1つのメッセージとオプション・メッセージ・コードを渡します。
EXEC TOOLS GET CONTEXT	Graphics Builderからユーザー・イグジットにコンテキスト・ポインタを渡します。
EXEC TOOLS SET CONTEXT	ユーザー・イグジットからGraphics Builderにコンテキスト・ポインタを渡します。
EXEC ORACLE	Oracleプリコンパイラ・オプションを実行します。


EXEC SQL

この文は、SQLコマンドであり、接頭辞として"EXEC SQL"が付けられます。EXEC SQL文を使用すると、Oracleプリコンパイラ・ユーザー・エグジットであらゆるSQLコマンドを実行できます。これは、データベースに入っているデータをユーザー・イグジットから選択または処理するための手段です。

構文:	EXEC SQL sql_statement;

パラメータの内容は次のとおりです。

sql_statement	有効なOarcle SQL文。

Graphics Builderにより接続が自動的に確立されるので、ORACLEプリコンパイラ・ユーザー・イグジットにCONNECTを明示的に指定して実行する必要はありません。ただし、実際には、ORACLEでは、同時接続をサポートしています。詳細は、『Oracleプリコンパイラ・プログラマーズ・ガイド』を参照してください。

注意: Graphics Builderは、(G30DES、G30RUN、G30BATのどれか1つまたはそれらを組み合せて使用することにより)図表を実行した後では、データベースに変更があってもCOMMITを実行しません。COMMITの必要があれば、ユーザー・イグジットを使用して実行できます。


EXEC TOOLS GET

この文を使用すると、Graphics BuilderからOarcleプリコンパイラ・ユーザー・イグジットに値が渡されます。この文は、主として、Graphics Builderパラメータの値をホスト言語変数に設定します。値がGraphics Builderからユーザー・イグジットに渡されると、ユーザー・イグジットでは、その値を使用して計算、処理または更新を行うことが可能になります。

構文: 	EXEC TOOLS GET display_variable_1[,
display_variable_2, ...]INTO :host_variable_1[,
:host_variable_2, ...];

パラメータの内容は次のとおりです。

display_variable_n	値の読込み元のGraphics Builderパラメータの名前。

host_variable_n	値の読込み先のホスト言語変数の名前。

注意:

1	display_variable_nを使用すると、次がどちらも参照されます。

   Graphics Builderパラメータ。

  値としてパラメータ名が指定されるホスト言語変数（接頭辞はコロン）。

2	図表引数は、Graphics Builderからユーザー・イグジットに標準SQL書式で渡されます。

   文字列は、一重引用符で囲んで渡されます（次のルールの1を参照）。

  定数は、そのまま渡されます（引用符なし）。

  日付は、該当するパラメータの書式マスクで指定された書式で、また一重引用符で囲んで渡されます（次のルールの1を参照）。

  ホスト変数の前には、コロン（:）が付きます。

次の表に、Graphics Builderからユーザー・イグジットへの引数の渡し方についての例をいくつか示します。

値	結果

'Summit'	文字列の定数値Summitの渡し方です。
413.60	数値の定数値413.60の渡し方です。
'19910414083000'	日付値1991年4月14日午前8時30分の、YYYYMMDDHH24MISSの書式マスクによる渡し方です。
:holder1	ホスト変数値holder1の渡し方です。
（ホスト言語変数の制限の詳細は、『Oracleプリコンパイラ・プログラマーズ・ガイド』を参照してください。

ルール:

1	一部のホスト言語では、一重引用符のかわりに二重引用符が使用されています。

2	Graphics Builderオブジェクトのデータが32Kバイト文字を超えていると、EXEC TOOLS GETから戻される値は、32Kバイト文字になるように左端から切り捨てられます。


EXEC TOOLS SET

  関連項目

この文を使用すると、Oracleプリコンパイラ・ユーザー・イグジットからGraphics Builderに値が渡されます。この文は、主として、定数やホスト言語変数の値をGraphics Builderパラメータに設定します。

構文:	EXEC TOOLS SET display_variable[, ...]VALUES
({:host_variable | constant}[, ...]);

パラメータの内容は次のとおりです。

display_variable	値の読込み先のGraphics Builderパラメータの名前。

host_variable	値の読込み元のホスト言語変数の名前。

Constant	読み込まれる定数。

注意: 引数はユーザー・イグジットへも、ユーザー・イグジットからも、同じように渡されます。

ルール:

1	Graphics Builderパラメータに対して、32Kバイト文字を超えるデータのEXEC TOOLS SETを実行することはできません。


EXEC TOOLS GET CONTEXT

この文を使用すると、あるOracleプリコンパイラ・ユーザー・イグジットから別のOracleプリコンパイラ・ユーザー・イグジットにコンテキストが渡されます。この文により、グローバル変数を指定しなくても、あるユーザー・イグジットから別のユーザー・イグジットへの情報のGET(取得)が可能になります。

構文:	EXEC TOOLS GET CONTEXT application_context_name INTO
:host_variable_pointer;

パラメータの内容は次のとおりです。

application_context_name	アクセスするコンテキストの名前。

host_variable_pointer	コンテキストを挿入するホスト言語ポインタ変数の名前。

ルール:

1	コンテキストのGET(取得)を実行する場合、ユーザー・イグジットは、必ずそのユーザー・イグジットがリンクされているGraphics Builder実行可能プログラムと同じプロセス内にある必要があります（つまり、ユーザー・イグジットから、サブプロセスを起動したり、サブプロセスをコンテキストにアクセスできるようにしないでください）。


EXEC TOOLS SET CONTEXT

この文を使用すると、名前付きのコンテキストが作成されます。この文により、グローバル変数を指定しなくても、各ユーザー・イグジット間で情報を共用することが可能になります。Aと名付けられたユーザー・イグジットでコンテキストを作成した場合、Aとリンクしている他のユーザー・イグジットでも、Aで作成されたコンテキストに入っている情報のGET(取得)を実行できます。

構文:	EXEC TOOLS SET CONTEXT :host_variable_pointer BY
application_context_name;

パラメータの内容は次のとおりです。

host_variable_pointer	作成するコンテキストを指すポインタ。

application_context_name	コンテキストの名前。

ルール:

1	コンテキストを共用する場合、ユーザー・イグジットは、必ずそのユーザー・イグジットがリンクされているGraphics Builder実行可能プログラムと同じプロセス内にある必要があります（つまり、ユーザー・イグジットから、サブプロセスを起動したり、サブプロセスをコンテキストにアクセスできるようにしないでください）。


 EXEC ORACLE

この文は、標準SQL以外の文であり、ORACLEプリコンパイラのオプションの実行時に使用されます。詳細は、『Oracleプリコンパイラ・プログラマーズ・ガイド』を参照してください。

ルール:

1	Graphics Builderは、(G30DES、G30RUN、G30BATのどれか1つまたはそれらを組み合せて使用することにより)図表を実行した後では、データベースに変更があってもCOMMITを実行しません。COMMITの必要があれば、ユーザー・イグジットを使用して実行できます。


EXEC TOOLS MESSAGE

  関連項目

この文を使用すると、ORACLEプリコンパイラ・ユーザー・イグジットからGraphics Builderにメッセージが渡されます。Graphics Builderは、渡されたメッセージを他のGraphics Builderメッセージ（警告メッセージや標準システムの出力デバイスに向けられたメッセージなど）と同じように表示します。

構文:	EXEC TOOLS MESSAGE msg_text [msg_number];

パラメータの内容は次のとおりです。

msg_text	メッセージとして呼び出される最大190字-msg_text英数字。

msg_number	メッセージ番号として呼び出される0から9999までの番号。

注意: PL/SQLを使用して、エラー・メッセージを定義したり呼び出すこともできます。


一般規則

Oracleプリコンパイラ・ユーザー・イグジットからは、ホスト言語画面入出力を実行することはできません。このような制限が存在するのは、ホスト言語が画面入出力の実行時に使用するランタイム・ルーチンと、Graphics Builderが入出力の実行時に使用するルーチンが重複しているからです。

ユーザー・イグジットからホスト言語ファイル入出力を実行することは可能です。


渡されたユーザー・イグジット・コールの構文

ユーザー・イグジットのコールは、最初にuser_exit_nameが指定され、その後にオプション指定されているargument_listが1本の文字列として、ユーザー・イグジット・プログラムに渡されます。argument_listの引数と引数の間には、スペースが1つ置かれます。

例:

1	コール

OG_USER_EXIT('quota 10 20 Q4');

がユーザー・イグジットに渡される場合は、次のようになります。

'quota 10 20 Q4'

2	コール

OG_USER_EXIT('quota');

がユーザー・イグジットに渡される場合は、次のようになります。

'quota'

ルール:

1	ユーザー・イグジット・コール文字列の解析を行うのは、ユーザー・イグジットであり、Graphics Builderではありません。

2	ユーザー・イグジットの名前とともに渡される引数と引数の間にスペースが2つ以上置かれていると、Graphics Builderは、その文字列がユーザー・イグジットに渡される前に余分なスペースを削除します。

たとえば、コール

'quota 10 20 Q4'

がユーザー・イグジットに渡される場合は、次のようになります。

'quota 10 20 Q4'


属性レコードの使用方法

•	概要

•	ショートカット・ビルトイン

•	アプリケーション属性レコード


概要

多くのビルトイン・サブプログラムは"属性レコード"と呼ばれる引数を受け取ります。"属性"とは、単にGraphics Builderオブジェクトのプロパティや特性のことをいいます。たとえば、四角形には、フォアグラウンド・カラーという属性があり、円弧には、開始角度と終了角度という属性があります。Graphics Builderでは、属性を確認した上で、オブジェクトの構造と外観を描写します。

Graphics Builderには、このような属性を制御するように、新しいビルトイン変数データ型がいくつか提供されています。これらのデータ型のほとんどは、レコード・データ型として定義されています。（レコード・データ型についての詳細は、『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください）。1つのレコード内の各フィールドは、特定の属性を表します。したがって、"属性レコード"とは、レコード・データ型として宣言した変数のことを指します。

たとえば、線の属性レコード、OG_LINE_ATTRの型定義は、次のようになります。

TYPE og_line_attr IS RECORD
(mask        NUMBER(1,1),
 startpt     og_point,
 endpt       og_point,
 arrowstyle  NUMBER(1,0)
);

このレコードには、線の始点および終点、矢印スタイルの属性が指定されています（マスク属性については、後で説明します）。

オブジェクトにおける属性は、いくつかある属性レコードのどれかで表すことができます。1つの属性をプログラムによって変更する場合は（たとえば、塗りパターンを変更する）、対応する属性レコード内の対応するフィールドの値を変更してから、その属性レコードをプロシージャまたはファンクションに渡す必要があります（プロシージャおよびファンクションによって、求めるアクションが実行されますが、その場合、必ず属性レコードを使用して、実行するアクションを正確にプロシージャまたはファンクションに反映させてください）。


属性クラス

属性レコードには、多くのオブジェクト・タイプに共通する属性を含むものと、1つのオブジェクト・タイプに固有の属性を含むものがあります。たとえば、名前はすべてのオブジェクトにありますが、フォント・サイズはテキスト・オブジェクトにしかありません。

すべての属性は、次のクラスに編成されます。

•	一般

•	図形

•	オブジェクト固有

一般属性

一般属性は、ほとんどのオブジェクト・クラスに適用されます。たとえば、名前または対応付けられたボタン・プロシージャ、親オブジェクトは、ほとんどのオブジェクトにあります。

図形属性

図形属性は、多くのオブジェクト・クラスに適用されますが、すべてのオブジェクト・クラスに適用されるわけではありません。図形属性が適用されるのは、図形オブジェクト（レイアウト・エディタ内のいずれかのグラフィカル・ツールを使用して作成できるオブジェクト）のみです。たとえば、図形属性の1つである"塗りカラー"を使用すると、四角形、円弧、記号などを描写できます。しかし、この属性を使用してイメージを描写しようしても、イメージに塗りカラーは不要なため、意味がありません。同じ理由で、グループ・オブジェクトも図形属性を使用しての描写はできません。（グループとしては図形オブジェクトでなくても、そのグループの個々のコンポーネントは図形オブジェクトであることがあります。この場合には、図形属性をそのコンポーネントに適用できます）。

オブジェクト固有の属性

オブジェクト固有の属性は、特定のオブジェクト・クラスにのみ適用されます。たとえば、"開始角度"は円弧を描写するための属性であり、この属性を使用しても、四角形または線、イメージ、その他のオブジェクトを描写できません。同じように、グループ・オブジェクトの場合にそれを構成している"子の数"を知ることはできますが、この属性を他のオブジェクト・クラスに使用しても意味がありません。Graphics Builderでは、次に挙げるオブジェクトに固有の属性を与えます。アプリケーション、円弧、チャート、グループ、イメージ、線、多角形、四角形、丸い四角形、記号、テキスト、ウィンドウ。

一般属性および図形属性には、それぞれ特有のビルトイン属性レコードが定義されています。また、オブジェクト固有の属性にも、個別の属性レコードが定義されています。

次のリストは、Graphics Builderオブジェクトと、それに対して有効な属性レコードです。

オブジェクト・クラス	属性レコード
アプリケーション	アプリケーション
円弧	一般 図形 円弧
チャート	一般 グループ チャート
チャート要素	図形 チャート要素
図表	図表
図形	一般 図形
グループ	一般 グループ
イメージ	一般イメージ
線	一般 図形 線
多角形	一般 図形 多角形
プリンタ	プリンタ
問合せ	問合せ
四角形	一般 図形 四角形
丸い四角形	一般 図形 丸い四角形
サウンド	サウンド
記号l	一般 図形 記号
テキスト	一般 図形 テキスト
タイマー	タイマー
ウィンドウ	ウィンドウ


結合属性レコード

先に述べた属性レコードに加えて、Graphics Builderでは、"結合属性レコード"も定義されています。結合属性レコードでは、オブジェクトを描写するのに必要なすべての属性レコードが1つの変数に結合されます。その名前が示すとおり、これは別のレコードですが、その中の各フィールドは一般属性レコードまたは図形属性レコード、オブジェクト固有の属性レコードのいずれかです。したがって、個別の属性レコードをいくつも使用してオブジェクトのそれぞれの属性クラスを示さなくても、1つの結合属性レコードを使用すると、あるオブジェクトの属性をすべて制御できます。

たとえば、四角形の結合属性レコードには、一般属性レコード、図形属性レコード、四角形属性レコードを表す3つのフィールドがあり、イメージの結合属性レコードには、一般属性レコードとイメージ属性レコードを表す2つのフィールドがあります。

次は、線オブジェクトの結合属性レコードOG_LINE_CAのタイプ定義です。

TYPE og_line_ca IS RECORD
(line_caob  og_generic_attr,  /*generic attribute record*/
 line_caoh  og_graphic_attr,  /* graphicattribute record */
 line_caol  og_line_attr      /* line attributerecord */
);

この結合属性レコードには、一般属性レコード、図形属性レコード、線属性レコードを表す3つのフィールドがあります。


マスク属性

各属性レコード（結合属性レコードは除く）には、"マスク"と呼ばれる数値フィールドがあります。このフィールドの値は、属性レコード内の変更（設定）または検査（取得）する属性を示します。属性レコードをプロシージャまたはファンクションの引数として使用すると、そのプロシージャやファンクションではマスクを使用して考慮すべき属性が判別されます。

たとえば、図形属性レコードにffcolor属性を設定することによって、あるオブジェクトの塗りフォアグラウンド・カラーを変更してから、その属性レコードとオブジェクトのハンドルを引数としてOG_SET_ATTRプロシージャに渡すと想定してください。この場合、プロシージャでは、設定する属性がどれなのかが判別できません。つまり、オブジェクトの図形属性すべてを変更する必要があるのか、オブジェクトの図形属性の一部のみを変更する必要があるのかを認識できません。これを認識するため、プロシージャによって、属性レコードのマスク属性が調べられます。

マスク属性の値は、プロシージャやファンクションで使用する必要がある属性レコード内の属性を示します。この値を、"マスク値"と呼びます。


マスク定数

属性レコードに対応するマスク値を判別しやすくするため、Graphics Builderでは、各属性に"マスク定数"と呼ばれる個別のビルトイン数値定数が対応付けられています。

次は、線の属性レコードのリストですが、この場合はマスク定数を付記しています。

TYPE og_line_attr IS RECORD           Mask Constants:
(mask       NUMBER(1,0),
 startpt    og_point,          OG_STARTPT_LINEA
 endpt      og_point,          OG_ENDPT_LINEA
 arrowstyle NUMBER(1,0)        OG_ARROWSTYLE_LINEA
);
                               OG_ALL_LINEA
                               OG_NONE_LINEA

属性レコード内の属性から使用する属性を決定したら、それらの属性に対応付けられているマスク定数の合計を計算してください。その結果が、それらの属性を表すマスク値になります。属性レコード内のマスク属性をこのマスク値に設定すると、その属性レコードを渡したプロシージャまたはファンクションでは、それらの属性のみが考慮されます。

たとえば、前述の線の属性レコードのstartpt属性を変更する場合は、最初に、このタイプの変数を宣言します。

my_variable   og_line_attr;

続いて、startpt属性の新しい値を設定します。

my_variable.startpt :=minew_point;

最後に、マスクを設定して、新しい始点の設定を指示します。

my_variable.mask := OG_STARTPT_LINEA;

（この一連の処理は、プロシージャやファンクションに使用される属性レコードを用意しているにすぎません。この処理が実際にオブジェクトを変更する場合にどう関係しているのかを把握するには、特定のプロシージャやファンクションについての説明を参照してください）。

線の始点と終点に新しい値を設定する場合には、マスクを設定してそのことを指示する必要があります。この場合、これら2つの属性のマスク定数の合計が、この場合の適切なマスク値となります。

my_variable.mask := OG_STARTPT_LINEA +  OG_ENDPT_LINEA;

各属性のためのマスク定数に加えて、すべての属性レコードには、プロシージャやファンクションがすべての属性を使用することを指示する属性と、どの属性も使用しないことを指示する属性が追加されています。線属性レコードでは、これらのマスク定数は、OG_ALL_LINEAおよびOG_NONE_LINEAです。

これらのマスク定数は数値であり、数値として処理できることを知っておいてください。これらを加算して複数の属性を示すのみでなく、減算することもできます。たとえば、終点を除くすべての属性がプロシージャやファンクションに影響されることを示す場合は、マスク値を次のように設定できます。

my_variable.mask := OG_ALL_LINEA - OG_ENDPT_LINEA;

場合によっては、1つの属性レコード内で複数の属性を表すのに、同じマスク定数を使用することがあります。マスク値を計算する場合にマスク定数を使用すると、その定数で表されている属性はすべて、属性レコードが渡されるプロシージャまたはファンクションによって使用されます。

結合属性レコード内のマスク

前述したとおり、すべての属性レコードには、マスク属性がありますが、結合属性レコードにはありません。結合属性レコードを引数としてプロシージャに渡すと、プロシージャが使用するマスクは、その結合属性レコードに入っている各属性レコードのマスクになります。

たとえば、ある変数を線の結合属性レコードとして宣言する場合（線の結合属性レコードは、一般属性レコードおよび図形属性レコード、線固有の属性レコードで構成されることを思い出してください）、まず次のように指定します。

comb_variable   og_line_ca;

次に、このレコードの属性をいくつか変更します。一般属性レコードでは、どの値も変更せず、図形属性レコードでは、線種属性と端形式属性の値を変更し、線属性レコードでは、矢印スタイル属性の値のみを変更するとします。この場合、次のような文を使用できます。

comb_variable.line_caoh.dashstyle := minew_dashstyle;
comb_variable.line_caoh.capstyle := minew_capstyle;
comb_variable.line_caol.arrowstyle := minew_arrowstyle;

変更を実行するプロシージャにこの結合属性レコードを渡すには、それぞれの属性レコードにマスクを設定して、そのレコード内でプロシージャが使用する必要のある属性を指示する必要があります。

comb_variable.line_caob.mask := OG_NONE_GENERICA;
comb_variable.line_caoh.mask := OG_DASHSTYLE_GRAPHICA +
                                OG_CAPSTYLE_GRAPHICA;
comb_variable.line_caol.mask := OG_ARROWSTYLE_LINEA;

属性レコード内のどの属性も使用する必要がない場合でも、必ず結合属性レコード内のすべての属性レコードにマスクを設定する必要があります。この場合、マスクは、どの属性も使用しないことを指示したマスク定数に設定します。

個々の属性レコードに対してマスクを設定したら、結合属性レコードをプロシージャやファンクションに渡すことが可能になります。属性レコードのマスク値を使用した場合に限り、使用する属性をプロシージャやファンクションに知らせることができます。


作成可能、設定可能、取得可能な属性

以下のリストにある各属性のとなりには、3文字までのアルファベット文字が指定されています。

アルファベット文字	意味
C	作成可能な属性を示す。つまり、Graphics Builderでは、該当する属性を含むオブジェクトを最初に作成したとき、その属性に割り当てた値が認識されます。属性が作成可能でないと、Graphics Builderにより、オブジェクトの作成時にデフォルト値が提供されます。
S	設定可能な属性を示す。つまり、適切なGraphics Builderビルトイン・サブプログラムを起動して該当する属性の値を設定できます。
G	取得可能な属性を示す。つまり、適切なGraphics Builderビルトイン・サブプログラムを起動して該当する属性の値を取得できます。


ショートカット・ビルトイン

先に説明した属性レコードによる処理方法以外にも、Graphics Builderでは、オブジェクトの作成処理とその属性の取得または設定処理を簡単にする一連のビルトイン・サブプログラムを使用することもできます。こういったショートカット・サブプログラムを使用すると、オブジェクトの1つの属性を設定または取得できます。詳細は、Graphics Builder「ビルトインの概要」を参照してください。

たとえば、属性レコードによる処理方法を使用してオブジェクトの塗りパターンと枠パターンを設定する場合には、新しい塗りパターンの設定および適切なマスクの設定、OG_SET_ATTRのコールを次のように実行する必要があります。

PROCEDURE attr_rec_approach (my_obj OG_OBJECT) IS
   my_recog_graphic_ca;
BEGIN
   my_rec.graphic_caoh.fillpatt:='gray50';
   my_rec.graphic_caoh.edgepatt:='kangaroo';
   my_rec.graphic_caob.mask:=OG_NONE_GENERICA;
my_rec.graphic_caoh.mask:=OG_FILLPATT_GRAPHICA+
OG_EDGEPATT_GRAPHICA;
   og_set_attr(my_obj, my_rec);
END;

ショートカットを使用すると、前述と同じプロセスをたった2つのプロシージャのコールで実行できます。

PROCEDURE shortcut_approach (my_obj OG_OBJECT) IS
BEGIN
   og_set_fillpatt(my_obj, 'gray50');
   og_set_edgepatt(my_obj, 'kangaroo');
END;

メリット

属性レコードのかわりにショートカットを使用する場合には、次の利点があります。

•	必要なPL/SQLコードが少なくて済むため、開発時間を削減できる。

•	プログラム単位の読取りと認識が簡単になる。

デメリット

属性レコードのかわりにショートカットを使用する場合には、次の欠点があります。

•	効率が悪くなる。Graphics Builderでは、属性レコードが内部で使用されるため、ショートカットをコールするたびに新しい内部属性レコードを定義し挿入する必要があります。また、複数の"set"ルーチンを実行する時間は、1つのルーチンを実行する時間に比べて長くなります。前述の例では、最初のプロシージャ（"set"が1つ）に要する時間は、2番目のプロシージャ（"set"が2つ）の約半分です。

•	複数のショートカットをコールして必要な属性をすべて設定すると、アプリケーションのパフォーマンスに悪影響を及ぼすおそれがあるので、アプリケーションはデフォルト設定に依存することになります。


アプリケーション属性レコード

アプリケーション属性レコードは、現行のアプリケーションで使用可能な属性で構成されます。

TYPE og_app_attr IS RECORD            Mask Constants:
(mask
(mask         NUMBER(3,0),
 cursor       VARCHAR2(255),          OG_CURSOR_APPA
 hscreen_res  NUMBER(5,0),            OG_SCREEN_RES_APPA
 vscreen_res  NUMBER(5,0),            OG_SCREEN_RES_APPA
 hlayout_res  NUMBER(10,0),           OG_LAYOUT_RES_APPA
 vlayout_res  NUMBER(10,0),           OG_LAYOUT_RES_APPA
 platform     NUMBER(1,0),            OG_PLATFORM_APPA
 username     VARCHAR2(255),          OG_USERNAME_APPA
 password     VARCHAR2(255),          OG_PASSWORD_APPA
 connection   VARCHAR2(255)           OG_CONNECTION_APPA
);
                                      OG_ALL_APPA
                                      OG_NONE_APPA

	属性	説明
SG	cursor	使用するマウス・カーソルの名前。この属性の値として、次の文字列のいずれかを指定できます。 default insertion crosshair help busy 詳細は、使用しているマニュアルを参照してください。この属性に無効な値を設定すると、その値は"default"とみなされます。
G	hscreen_res	画面の水平解像度。この値は、画面の水平方向1インチ内の画面解像度（ピクセル）単位の数です。
G	vscreen_res	画面の垂直解像度。この値は、画面の垂直方向1インチ内の画面解像度単位（ピクセル）の数です。
G	hlayout_res	レイアウトの水平解像度。この値は、レイアウトの水平方向の1インチ内のレイアウト単位の数です。
G	vlayout_res	レイアウトの垂直解像度。この値は、レイアウトの垂直方向の1インチ内のレイアウト単位の数です。
G	platform	Graphics Builderが実行されるプラットフォーム。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_MACINTOSH_PLATFORM   プラットフォームがApple Macintoshになる。
		OG_MOTIF_PLATFORM   プラットフォームがOSF/MOTIFになる。
		OG_MSWINDOWS_PLATFORM   プラットフォームがMicrosoft Windowsになる。
		OG_PM_PLATFORM   プラットフォームがPresentation Managerになる。
		OG_X_PLATFORM   プラットフォームがX Window Systemになる。
G	username	現行のデータベース接続用のユーザー名。接続していないと、この属性はNULLになります。
G	password	現行のデータベース接続用のパスワード。接続していない場合や、Keep_Password作業環境を「いいえ」に設定している場合、この属性はNULLになります。
G	connection	現行のデータベース接続用のデータベー接続文字列。接続していないと、この属性はNULLになります。


円弧結合属性レコード

円弧結合属性レコードは、一般属性レコードおよび図形属性レコード、円弧属性レコードで構成されます。

TYPE og_arc_ca IS RECORD
(arc_caob  og_generic_attr, /* generic */
 arc_caoh  og_graphic_attr, /* graphic */
 arc_caoa  og_arc_attr /* arc */
);


円弧属性レコード

記号属性レコードは、記号オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_arc_attr IS RECORD                Mask Constants:
(mask     NUMBER(1,0),
 basearc  og_arc, OG_BASEARC_ARCA
 arcfill  NUMBER(1,0),
OG_ARCFILL_ARCA
 closed   BOOLEAN OG_CLOSED_ARCA
);

	属性	説明
CSG	basearc	左上角のx座標とy座標、および楕円から円弧をカットする際に基準として使用する四角形の高さと幅。
CSG	arcfill	円弧の形状。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_CHORD_ARCFILL   円弧の形状が弦型になる
		OG_PIE_ARCFILL   円弧の形状が完全な扇型になる。
CSG	closed	円弧の閉じ形状。この属性の値として、次のいずれかを指定できます。
		TRUE   円弧が閉じた形状になる。
		FALSE   円弧が開いた形状になる。


値軸結合属性レコード

TYPE og_contaxis_ca IS RECORD
(ca_axis  og_axis_attr, /* generic axis */
 ca_cont  og_contaxis_attr /* continuous axis */
);


値軸属性レコード

TYPE og_contaxis_attr IS RECORD     Mask Constants:
(mask      NUMBER(4,0),
 automin BOOLEAN,                 OG_MINIMUM_CONTAXISA
 minimum
NUMBER(6),

	属性	説明
SG	automin	軸最小値を「自動」に設定するかどうかを指定します。
SG	minimum	最小軸値を指定します（ただし、autominがFALSEの場合のみ）。
SG	autostep	主目盛間隔を「自動」に設定するかどうかを指定します。
SG	step	主目盛間隔を指定します（ただし、autostepがFALSEの場合のみ）。
SG	automax	軸最大値を「自動」に設定するかどうかを指定します。
SG	maximum	最大軸値を指定します（ただし、automaxがFALSEの場合のみ）。
SG	scale	軸のスケーリングに使用されるアルゴリズムを指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_LINEAR_SCALE   最小軸値から最大軸値まで固定した間隔で軸をスケーリングします。
		OG_LOG_SCALE   最小軸値から最大軸値までの間隔を決めるために、対数アルゴリズム（10の累乗に基づく）を使用して軸をスケーリングします。
		OG_PCT_SCALE   データ値をpct_ofで指定した数と対応させて表示するように軸をスケーリングします。
SG	pct_of	相対スケール変更係数を指定する（scaleがOG_PCT_SCALEに設定されている場合）。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_MAXIMUM_PCTOF   各データ値を最大データ値のパーセントで表示する。
		OG_MINIMUM_PCTOF   各データ値を最小データ値のパーセントで表示する。
		OG_SUM_PCTOF   各データ値をすべてのデータ値の合計のパーセントで表示する。
SG	pct_by	pct_ofスケール値をどう計算するかを指定する。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_CATEGORY_PCTBY   各データ値のパーセントを他の項目内の同じフィールドのデータ値と対応させて計算する。
		OG_FIELD_PCTBY   各データ値のパーセントを他のフィールドの同じ項目内のデータ値と対応させて計算する。
SG	numfmt	軸目盛きざみラベルの数値書式を指定します。これは有効なSQLフォーマット文字列である必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


日付軸結合属性レコード

TYa_axis  og_axis_attr, /* generic axis */
 ca_date  og_dateaxis_attr /*PE og_dateaxis_ca IS RECORD
(c date axis */
);


日付軸属性レコード

TYPE og_dateaxis_attr IS RECORD   マスク定数:
(mask       NUMBER(5,0),
 automin    BOOLEAN,              OG_MINIMUM_DATEAXISA
 minimum    DATE,                 OG_MINIMUM_DATEAXISA
 autostep   BOOLEAN,              OG_STEP_DATEAXISA
 step       NUMBER(2,0),          OG_STEP_DATEAXISA
 automax    BOOLEAN,              OG_MAXIMUM_DATEAXISA
 maximum    DATE,                 OG_MAXIMUM_DATEAXISA
 firstmon   NUMBER(2,0),          OG_FIRSTMON_DATEAXISA
 skipwknds  BOOLEAN,              OG_SKIPWKNDS_DATEAXISA
 labels     NUMBER(4,0),          OG_LABELS_DATEAXISA
 dayfmt     NUMBER(1,0),          OG_DAYFMT_DATEAXISA
 monthfmt   NUMBER(1,0),          OG_MONTHFMT_DATEAXISA
 qtrfmt     NUMBER(1,0),          OG_QTRFMT_DATEAXISA
 yearfmt    NUMBER(1,0),          OG_YEARFMT_DATEAXISA
 custfmt    VARCHAR2(255)         OG_CUSTMT_DATEAXISA
);
                                  OG_ALL_DATEAXISA
                                  OG_NONE_DATEAXISA

	属性	説明
SG	automin	軸最小値を「自動」に設定するかどうかを指定します。
SG	minimum	最小軸値を指定します（ただし、autominがFALSEの場合のみ）。
SG	autostep	主目盛間隔を「自動」に設定するかどうかを指定します。
SG	step	主目盛間隔を指定します（ただし、autostepがFALSEの場合のみ）。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_SECOND_STEP
		OG_MINUTE_STEP
		OG_HOUR_STEP
		OG_DAY_STEP
		OG_WEEK_STEP
		OG_MONTH_STEP
		OG_QUARTER_STEP
		OG_YEAR_STEP
SG	automax	軸最大値を「自動」に設定するかどうかを指定します。
SG	maximum	最大軸値を指定します（ただし、automaxがFALSEの場合のみ）。
SG	firstmonth	新しい年度が始まる最初の月です。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_JAN_MONTH
		OG_FEB_MONTH
		OG_MAR_MONTH
		OG_APR_MONTH
		OG_MAY_MONTH
		OG_JUN_MONTH
		OG_JUL_MONTH
		OG_AUG_MONTH
		OG_SEP_MONTH
		OG_OCT_MONTH
		OG_NOV_MONTH
		OG_DEC_MONTH
SG	skipweekends	軸の値を計算するときに週末を無視するかどうかを指定します。
SG	labels	主目盛きざみと目盛きざみラベルが表示される軸に沿った主目盛間隔のみでなく、目盛きざみラベルの表示も指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_NO_LABELS
		OG_SECOND_LABELS
		OG_MINUTE_LABELS
		OG_HOUR_LABELS
		OG_AMPM_LABELS
		OG_DAY_LABELS
		OG_DAYOFWEEK_LABELS
		OG_WEEK_LABELS
		OG_MONTH_LABELS
		OG_QUARTER_LABELS
		OG_YEAR_LABELS
		OG_CUSTOM_LABELS（この値をlabelsに設定した場合は、必ず customfmt属性にカスタム日付書式を指定してください）。
SG	dayfmt	曜日ラベルの表示形式を決めます。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_FIRSTLETTER_FMT
		OG_THREELETTER_FMT
SG	monthfmt	月ラベルの表示形式を決めます。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_FIRSTLETTER_FMT
		OG_THREELETTER_FMT
SG	quarterfmt	四半期ラベルの表示形式を決めます。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_ARABIC_FMT
		OG_ROMAN_FMT
SG	yearfmt	年ラベルの表示形式を決めます。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_FOURDIGIT_FMT
		OG_TWODIGIT_FMT
SG	custfmt	軸目盛きざみラベルのカスタム日付書式です。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


項目軸結合属性レコード

TYPE og_discaxis_ca IS RECORD
(ca_axis  og_axis_attr, /* generic axis */
 ca_disc  og_discaxis_attr /* discrete axis */
);


項目軸属性レコード

TYPE og_discaxis_attr IS RECORD       Mask Constants:
(mask     NUMBER(3,0),
 automin  BOOLEAN,                    OG_MINCAT_DISCAXISA
 mincat   NUMBER(10,0),               OG_MINCAT_DISCAXISA
 automax  BOOLEAN,                    OG_MAXCAT_DISCAXISA
 maxcat   NUMBER(10,0),               OG_MAXCAT_DISCAXISA
 numfmt   VARCHAR2(255),              OG_NUMFMT_DISCAXISA
 datefmt  VARCHAR2(255)               OG_DATEFMT_DISCAXISA
);
                                      OG_ALL_DISCAXISA
                                      OG_NONE_DISCAXISA

	属性	説明
SG	automin	軸に表示する最小項目数を「自動」に設定するかどうかを指定します。
SG	mincat	軸上に表示される最小項目数を指定します（autominがFALSEの場合）。
SG	automax	軸に表示する最大項目数を「自動」に設定するかどうかを指定します。
SG	maxcat	軸に表示する最大項目数を指定します （ただし、automaxがFALSEの場合のみ）。
SG	numfmt	軸目盛きざみラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。
SG	datefmt	軸目盛きざみラベルの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


軸属性レコード

TYPE og_axis_attr IS RECORD           Mask Constants:
(mask          NUMBER(5,0),
 axistype      NUMBER(1,0),          OG_AXISTYPE_AXISA
 custlabel     VARCHAR2(255),        OG_CUSTLABEL_AXISA
 position      NUMBER(1,0),          OG_POSITION_AXISA
 direction     NUMBER(1,0),          OG_DIRECTION_AXISA
 tickpos       NUMBER(1,0),          OG_TICKPOS_AXISA
 ticklabelrot  NUMBER(1,0),          OG_TICKLABELROT_AXISA
 minorct       NUMBER(1,0),          OG_MINORCT_AXISA
 majorticks    BOOLEAN,              OG_MAJORTICKS_AXISA
 minorticks    BOOLEAN,              OG_MINORTICKS_AXISA
 majorgrid     BOOLEAN,              OG_MAJORGRID_AXISA
 minorgrid     BOOLEAN,              OG_MINORGRID_AXISA
 axislabel     BOOLEAN,              OG_AXISLABEL_AXISA
 ticklabels    BOOLEAN               OG_TICKLABELS_AXISA
);
                                     OG_ALL_AXISA
                                     OG_NONE_AXISA

	属性	説明
SG	axistype	この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_CONTINUOUS_AXISTYPE
		OG_DATE_AXISTYPE
		OG_DISCRETE_AXISTYPE
SG	custlabel	軸に沿って表示するラベルのテキストを指定します。
SG	position	どのチャート枠に沿って軸を表示するかを指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_BOTTOM_POSITION
		OG_LEFT_POSITION
		OG_RIGHT_POSITION
		OG_TOP_POSITION
SG	direction	増分値や連続した項目を軸に沿ってどの方向に設定するかを指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_DOWN_DIRECTION
		OG_LEFT_DIRECTION
		OG_RIGHT_DIRECTION
		OG_UP_DIRECTION
SG	tickpos	主目盛きざみと補助目盛きざみをどう表示するかを指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_CROSS_TICKPOS
		OG_INSIDE_TICKPOS
		OG_OUTSIDE_TICKPOS
SG	ticklabelrot	この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_CCW_ROTATION
		OG_CW_ROTATION
		OG_NO_ROTATION
SG	minorct	それぞれの主目盛きざみと主目盛きざみの間に定義される補助目盛きざみ数です。
SG	majorticks	主目盛きざみを主目盛間隔で表示するかどうかを指定します。
SG	minorticks	「補助きざみ数」で設定された値の指定通りに補助目盛きざみを表示するかどうかを指定します。
SG	majorgrid	それぞれの主目盛きざみにグリッドを表示するかどうかを指定します。
SG	minorgrid	それぞれの補助目盛きざみにグリッドを表示するかどうかを指定します。
SG	axislabel	軸に沿って値を識別する項目ラベルを表示するかどうかを指定します。
SG	ticklabels	軸に沿って値を識別する項目ラベルを表示するかどうかを指定します。


チャート結合属性レコード

チャートは、グループ・オブジェクトと同様に扱われ、線、四角形、テキストなどで構成されます。したがって、チャート結合属性レコードを使用すると、チャートに固有の属性にアクセスできるのみでなく、グループ属性にもアクセスできます。また、チャートそのものは図形オブジェクトではないので（チャートを構成するオブジェクトは図形オブジェクトであっても）、このレコードを使用しても図形属性にはアクセスできません。チャートの個々の要素の図形属性を設定する場合には、チャート要素属性レコードを使用してください（後の説明を参照）。

チャートが動的チャートとして指定されている場合に限り、このレコードを使用して、チャートの属性にアクセスできます。チャートがアートワークの場合は、そのチャートはグループ・オブジェクトとみなされ、チャート・オブジェクトとして扱われません。プログラムによって作成されたチャートは、動的チャートとなります。

チャート結合属性レコードは、一般属性レコード、グループ属性レコードおよびチャート属性レコードで構成されます。

TYPE og_chart_ca IS RECORD
(chart_caob  og_generic_attr,   /* generic */
 chart_caog  og_group_attr,     /* graphic */
 chart_caoc  og_chart_attr      /* chart */
);


チャート属性レコード

チャート属性レコードは、チャート・オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_chart_attr IS RECORD           Mask Constants:
(mask        NUMBER(4,0),
 frame       og_rectangle,          OG_FRAME_CHARTA
 template    og_template,           OG_TEMPLATE_CHARTA
 query       og_query,              OG_QUERY_CHARTA
 title       VARCHAR2(255),         OG_TITLE_CHARTA
 autoupdate  BOOLEAN,               OG_AUTOUPDATE_CHARTA
 rangeflag   BOOLEAN,               OG_ROWS_CHARTA
 startrow    NUMBER(10,0),          OG_ROWS_CHARTA
 endrow      NUMBER(10,0),          OG_ROWS_CHARTA
 filter      VARCHAR2(255)          OG_FILTER_CHARTA
);
                                    OG_ALL_CHARTA
                                    OG_NONE_CHARTA

	属性	説明
CSG	frame	チャートの枠のx座標とy座標、および高さ、幅です（レイアウト単位）。
CSG	template	チャートに使用するテンプレートのハンドルです。
CSG	query	チャートに使用する問合せのハンドルです。
CSG	title	チャートのタイトルです。
CSG	autoupdate	問合せの実行時にチャートを自動的に更新するように指定します。
CSG	rangeflag	チャートに表示する問合せ行の数を、startrowとendrowで指定した範囲に制限するかどうかを指定します。
CSG	startrow	チャートに表示するデータの最初の行です。最初のデータ行は0、2番目の行は1となり、以下同様です。
CSG	endrow	チャートに表示するデータの最後の行です。
CSG	filter	問合せのフィルタ・トリガー・プロシージャの名前です。


チャート要素結合属性レコード

チャート要素は、フィールドの単一の値を表す図形オブジェクトです。たとえば、棒グラフの棒や円グラフの円弧がチャート要素です。この結合属性レコードをOG_SET_ATTRプロシージャとともに使用すると、チャート要素の属性を変更できます。

チャート要素結合属性レコードは、図形属性レコードおよびチャート要素属性レコードで構成されます。

TYPE og_chelement_ca IS RECORD
(chelement_cagr  og_graphic_attr,    /* graphic */
 chelement_cace  og_chelement_attr   /* chart element */
);


チャート要素属性レコード

チャート要素属性レコードは、チャート要素にのみ使用可能な属性で構成されます。

TYPE og_chelement_attr IS RECORD   Mask Constants:
(mask       NUMBER(1,0),
 button     og_buttonproc,         OG_BUTTON_CHELEMENTA
 events     NUMBER(2,0),           OG_BUTTON_CHELEMENTA
 explosion  NUMBER(10,0),          OG_EXPLOSION_CHELEMENTA
 name       VARCHAR2(255)          OG_NAME_CHELEMENTA
);
                                   OG_ALL_CHELEMENTA
                                   OG_NONE_CHELEMENTA

	属性	説明
S	button	このチャート要素と対応付けるボタン・プロシージャのハンドルです。要求したマウス・イベントをこのプロシージャで確実に受信できるようにするには、必ずイベント属性を正しく設定してください。
S	events	ボタン・プロシージャが受け取るマウス・イベントのタイプです。この属性の値として、次のビルトイン定数のいずれかを指定できます。プロシージャで複数のイベント・タイプを確実に受信できるようにするには、この属性を、要求したイベントの定数の合計となるように設定します。
		OG_NO_EVENTS   どのマウス・イベントも受信しない。
		OG_MOUSE_DOWN   マウス・ボタンを押すイベントのみ受信する。
		OG_MOUSE_MOVE_DOWN   マウス・ボタンを押したままマウスを移動させるイベントのみ受信する。
		OG_MOUSE_UP   マウス・ボタンを放すイベントのみ受信する。
		OG_MOUSE_MOVE_UP   マウス・ボタンを放したまま、マウスを移動させるイベントのみ受信する。
S	explosion	チャート要素（円グラフの円弧）を突出させる距離。チャートのx半径およびy半径の割合で表されます。この属性は、円グラフのチャートにしか使用できません。また、チャート要素として項目を指定するとすべての円グラフが同じ割合で展開されます。したがって、突出値を指定する属性レコードは、個々のフィールドと対応付ける必要があります。
S	name	チャート要素の名前です。チャート要素の名前を取得する場合は、一般属性レコードを使用してください。


図表属性レコード

図表属性レコードは、現行の図表にのみ使用可能な属性で構成されます。

TYPE og_display_attr IS RECORD	   Mask Constants:
(mask          NUMBER(2,0),
 opentrigger   VARCHAR2(255),        OG_OPENTRIGGER_DISPLAYA
 closetrigger  VARCHAR2(255),        OG_CLOSETRIGGER_DISPLAYA
 width         NUMBER(10,0),         OG_SIZE_DISPLAYA
 height        NUMBER(10,0),         OG_SIZE_DISPLAYA
 dateformat    VARCHAR2(255)         OG_DATEFORMAT_DISPLAYA
);
                                     OG_ALL_DISPLAYA
                                     OG_NONE_DISPLAYA

	属性	説明
SG	opentrigger	図表のオープン・トリガーの名前。
SG	closetrigger	図表のクローズ・トリガーの名前。
SG	width	レイアウトの幅です（レイアウト単位）。
SG	height	レイアウトの高さです（レイアウト単位）。
SG	dateformat	パラメータの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


軸フィールド・テンプレート結合属性レコード

TYPE og_axisftemp_ca IS RECORD
(ca_ftemp   og_ftemp_attr,     /* generic field template */
 ca_aftemp  og_axisftemp_attr  /* axis field template */
);


軸フィールド・テンプレート属性レコード

TYPE og_axisftemp_attr IS RECORD   Mask Constants:
(mask       NUMBER(3,0),
 plottype   NUMBER(3,0),           OG_PLOTTYPE_AXISFTEMPA
 linestyle  NUMBER(1,0),           OG_LINESTY_AXISFTEMPA
 labelrot   NUMBER(1,0),           OG_LABELROT_AXISFTEMPA
 plotpos    NUMBER(1,0),           OG_PLOTPOS_AXISFTEMPA
 overlap    NUMBER(3),             OG_OVERLAP_AXISFTEMPA
 axis       NUMBER(1,0),           OG_AXIS_AXISFTEMPA
 curvefit   NUMBER(1,0)            OG_CURVEFIT_AXISFTEMPA
);
                                   OG_ALL_AXISFTEMPA
                                   OG_NONE_AXISFTEMPA

	属性	説明
SG	plottype	このフィールドをチャート上に表示するために使用する要素を指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_NONE_PLOTTYPE
		OG_BAR_PLOTTYPE
		OG_LINE_PLOTTYPE
		OG_SYMBOL_PLOTTYPE
		OG_FILL_PLOTTYPE
		OG_SPIKE_PLOTTYPE
		OG_LABEL_PLOTTYPE
SG	linestyle	線表示形式を含む各フィールドのデータ・ポイント間を結ぶために使用する線の形式を指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_SPLINE_LINESTYLE
		OG_STEP_LINESTYLE
		OG_STRAIGHT_LINESTYLE
SG	labelrot	ラベル表示形式を含む各フィールドのラベルの回転角度を指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
SG	plotpos	各項目において2つ以上のフィールドのデータ値間の関係を指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_NORMAL_PLOTPOS
		OG_FROMPREV_PLOTPOS
		OG_STACKED_PLOTPOS
SG	overlap	複数のフィールドからのデータ値を横棒チャートや縦棒チャートで表示する棒どうしがそれぞれオーバーラップする割合を指定します。
SG	axis	フィールドの表示方法を決定するのに必要なデータ値が比較される軸を指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_X_AXIS
		OG_Y1_AXIS
		OG_Y2_AXIS
SG	curvefit	カーブ調整をチャートに適用するかどうか、また適用する場合にはどのアルゴリズムを使用するかを指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_NO_CURVEFIT
		OG_LINEAR_CURVEFIT
		OG_LOG_CURVEFIT
		OG_EXP_CURVEFIT
		OG_POWER_CURVEFIT


フィールド・テンプレート属性レコード

TYPE og_ftemp_attr IS RECORD           Mask Constants:
(mask      NUMBER(3,0),
 name      VARCHAR2(255),              OG_NAME_FTEMPA
 root      OG_OBJECT,                  OG_ROOT_FTEMPA
 colorrot  NUMBER(1,0),                OG_COLORROT_FTEMPA
 numfmt    VARCHAR2(255),              OG_NUMFMT_FTEMPA
 datefmt   VARCHAR2(255)               OG_DATEFMT_FTEMPA
);
                                       OG_ALL_FTEMPA
                                       OG_NONE_FTEMPA

	属性	説明
SG	name	フィールド・テンプレートの名前です。
G	root	フィールド・テンプレートが含まれるチャート・テンプレートのハンドル。
SG	colorrot	Graphics Builderがカラー・パレットやパターン・パレットを自動的に回転させて、このフィールド・テンプレートを使用する各フィールドに固有のパレット設定を選択するかどうかを指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_NO_COLORROT
		OG_AUTO_COLORROT
		OG_COLOR_COLORROT
		OG_PATTERN_COLORROT
		OG_BOTH_COLORROT
SG	numfmt	フィールド・ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列でする必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。
SG	datefmt	フィールド・ラベルの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


軸枠結合属性レコード

TYPE og_axisframe_ca IS RECORD
(ca_frame


軸枠属性レコード

TYPE og_axisframe_attr IS RECORD   Mask Constants:
(mask       NUMBER(3,0),
 reflinect  NUMBER(3,0),           OG_REFLINECT_AXISFRAMEA
 basevalue  NUMBER(1,0),           OG_BASEVALUE_AXISFRAMEA
 cust_num   NUMBER(6),             OG_BASEVALUE_AXISFRAMEA
 cust_date  DATE,                  OG_BASEVALUE_AXISFRAMEA
 base_axis  NUMBER(1,0),           OG_BASEAXIS_AXISFRAMEA
 catwidth   NUMBER(3,0),           OG_CATWIDTH_AXISFRAMEA
 second_y   BOOLEAN                OG_SECONDY_AXISFRAMEA
);
                                   OG_ALL_AXISFRAMEA
                                   OG_NONE_AXISFRAMEA

	属性	説明
G	reflinect	チャート・テンプレートに含まれる参照線の数。
SG	baseline_value	値軸に沿ってフィールドを表示する際に開始点として使用される値です。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_MIN_BASELINE
		OG_MAX_BASELINE
		OG_ZERO_BASELINE
		OG_CUSTOM_BASELINE
SG	custom_num	数値軸タイプの基本線の値を指定します。この値は、自動的にOG_CUSTOM_BASELINEに設定されます。
SG	custom_date	日付軸タイプの日付の値を指定します。この値は、自動的にOG_CUSTOM_BASELINEに設定されます。
SG	baseline_axis	位置を求めるために基本線の値が比較される軸を指定します。
SG	catwidth	これは、「ストライプ幅」の割合で示した、横棒グラフや縦棒グラフ内の棒の幅です。ストライプ幅は、棒が互いに重なることなくとれる棒の最大の幅で、項目軸の長さを、表示される棒の数で割って決定されます。
SG	second_y	第2-Y軸をチャート内に表示するかどうかを指定します。


枠属性レコード

TYPE og_frame_attr IS RECORD       Mask Constants:
(mask         NUMBER(4,0),
 name         VARCHAR2(255),       OG_NAME_FRAMEA
 frametype    NUMBER(1,0),         OG_FRAMETYPE_FRAMEA
 ftempct      NUMBER(5,0),         OG_FTEMPCT_FRAMEA
 root         OG_OBJECT,           OG_ROOT_FRAMEA
 depthsize    NUMBER(1,0),         OG_DEPTHSIZE_FRAMEA
 shadowsize   NUMBER(1,0),         OG_SHADOWSIZE_FRAMEA
 shadowdir    NUMBER(1,0),         OG_SHADOWDIR_FRAMEA
 plotframe    BOOLEAN,             OG_PLOTFRAME_FRAMEA
 legend       BOOLEAN,             OG_LEGEND_FRAMEA
 legendcolct  NUMBER(3,0)          OG_LEGENDCOLCT_FRAMEA
);
                                   OG_ALL_FRAMEA
                                   OG_NONE_FRAMEA

	属性	説明
SG	name	チャート・テンプレートの名前です。
G	frametype	このテンプレートで表されるチャートのタイプ。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_AXIS_FRAMETYPE
		OG_PIE_FRAMETYPE
		OG_TABLE_FRAMETYPE
G	ftempct	チャート・テンプレートに含まれるフィールド・テンプレートの数。
G	root	チャート・テンプレートのハンドル。
SG	depthsize	チャート枠と要素を3次元表示にするために、それらが描画される深さのサイズを指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_NONE_DEPTHSIZE
		OG_SMALL_DEPTHSIZE
		OG_MEDIUM_DEPTHSIZE
		OG_LARGE_NONE_DEPTHSIZE
		OG_XLARGE_DEPTHSIZE
SG	shadowsize	チャート枠と要素が描画されるシャドウのサイズを指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_NONE_SHADOWSIZE
		OG_SMALL_SHADOWSIZE
		OG_MEDIUM_SHADOWSIZE
		OG_LARGE_SHADOWSIZE
		OG_XLARGE_SHADOWSIZE
SG	shadowdir	チャート枠と要素が描画されるシャドウの方向を指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_UPPERRIGHT_SHADOWDIR
		OG_UPPERLEFT_SHADOWDIR
		OG_LOWERRIGHT_SHADOWDIR
		OG_LOWERLEFT_SHADOWDIR
SG	plotframe	チャートの周囲に四角形を表示するかどうかを指定します。（円グラフ・チャートには適用されません。）
SG	legend	チャートの凡例を表示するかどうかを指定します。（表チャートには適用されません。）
SG	legendcolct	凡例内にラベルを表示するために使用する列数です。


円グラフ枠結合属性レコード

TYPE og_pieframe_ca IS RECORD
(ca_frame  og_frame_attr,


円グラフ枠属性レコード

TYPE og_pieframe_attr IS RECORD   Mask Constants:
(mask        NUMBER(3,0),
 usage       NUMBER(1,0),         OG_USAGE_PIEFRAMEA
 usagevalue  NUMBER(6),           OG_USAGE_PIEFRAMEA
 plotorder   NUMBER(1,0),         OG_PLOTORDER_PIEFRAMEA
 categs      BOOLEAN,             OG_CATEGS_PIEFRAMEA
 datavals    BOOLEAN,             OG_DATAVALS_PIEFRAMEA
 pctvalues   BOOLEAN,             OG_PCTVALUES_PIEFRAMEA
 ticks       BOOLEAN,             OG_TICKS_PIEFRAMEA
 other       NUMBER(3),           OG_OTHER_PIEFRAMEA
 nooverlap   BOOLEAN,             OG_NOOVERLAP_PIEFRAMEA
 catnumfmt   VARCHAR2(255),       OG_CATNUMFMT_PIEFRAMEA
 catdatefmt  VARCHAR2(255),       OG_CATDATEFMT_AXSFRAMEA
 valuefmt    VARCHAR2(255),       OG_VALUEFMT_PIEFRAMEA
 pctfmt      VARCHAR2(255)        OG_PCTFMT_PIEFRAMEA
);
                                  OG_ALL_PIEFRAMEA
                                  OG_NONE_PIEFRAMEA

	属性	説明
SG	usage	円グラフの各円弧と完成したチャートとの関係を指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_TOTALVALUE_USAGE
		OG_PCT_USAGE
SG	usagevalue	円グラフの各円弧は、そのデータ値におけるここで指定した値に対するパーセンテージとして表示されます。（usageがOG_TOTALVALUE_USAGEに設定されている場合に限り有効です。）
SG	plotorder	データ値が表示される方向を指定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_CCW_PLOTORDER
		OG_CW_PLOTORDER
SG	categs	円グラフの各円弧を、示されている項目の名前でラベル表示するかどうかを指定します。
SG	datavals	円グラフの各円弧を、そのデータ値でラベル表示するかどうかを指定します。
SG	pctvalues	円グラフの各円弧を、示されている完成したチャートの割合でラベル表示するかどうかを指定します。
SG	ticks	円グラフの各円弧とそのラベルを結ぶ目盛きざみを表示するかどうかを指定します。
SG	other	ここに入力される値より小さい割合の円弧をラベル「その他」で1つの円弧に結合することを指定します。
SG	nooverlap	円グラフの各円弧のラベルが互いにオーバーラップしないように指定します。
SG	catnumfmt	項目ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。
SG	catdatefmt	項目ラベルの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。
SG	valuefmt	データ値ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。
SG	pctfmt	パーセント値ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


表枠結合属性レコード

TYPE og_tableframe_ca IS RECORD
(ca_frame  og_frame_attr,       /* generic frame */
 ca_table  og_tableframe_attr   /* table frame */
);


表枠属性レコード

TYPE og_tableframe_attr IS RECORD   Mask Constants::
(mask     NUMBER(3,0),
 automin  BOOLEAN,                  OG_MIN_TABLEFRAMEA
 minrows  NUMBER(10,0),             OG_MIN_TABLEFRAMEA
 automax  BOOLEAN,                  OG_MAX_TABLEFRAMEA
 maxrows  NUMBER(10,0),             OG_MAX_TABLEFRAMEA
 cname    BOOLEAN,                  OG_CNAME_TABLEFRAMEA
 vgrid    BOOLEAN,                  OG_VGRID_TABLEFRAMEA
 hgrid    BOOLEAN,                  OG_HGRID_TABLEFRAMEA
 gridct   NUMBER(10,0)              OG_GRIDCT_TABLEFRAMEA
);
                                    OG_ALL_TABLEFRAMEA
                                    OG_NONE_TABLEFRAMEA

	属性	説明
SG	automin	チャートに表示される最小行数を「自動」に設定するかどうかを指定します。
SG	minrows	チャート上に表示する最小行数を指定します（autominがFALSEの場合）。
SG	automax	チャートに表示される最大行数を「自動」に設定するかどうかを指定します。
SG	maxrows	チャートに表示される最大行数を指定します（ただし、automaxがFALSEの場合のみ）。
SG	colnames	列の名前をチャート内の最初の行として表示するかどうかを指定します。
SG	vgrid	列と列の間に垂直グリッドを表示するかどうかを指定します。
SG	hgrid	行と行の間に水平グリッドを表示するかどうかを指定します。
SG	gridct	各水平グリッド間に表示されるデータの行数（hgridがTRUEに設定されている場合）。


一般属性レコード

一般属性レコードは、あらゆる問合せに使用可能な属性で構成されます。

TYPE og_generic_attr IS RECORD    Mask Constants:
(mask       NUMBER(6,0),
 name       VARCHAR2(255),          OG_NAME_GENERICA
 parent     og_object,              OG_PARENT_GENERICA
 ibbox      og_rectangle,           OG_IBBOX_GENERICA
 obbox      og_rectangle,           OG_OBBOX_GENERICA
 objtype    NUMBER(2,0),            OG_OBJTYPE_GENERICA
 button     og_buttonproc,          OG_BUTTON_GENERICA
 events     NUMBER(2,0),            OG_EVENTS_GENERICA
 keycol     VARCHAR2(255,           OG_KEYCOL_GENERICA
 execquery  og_query,               OG_EXECQUERY_GENERICA
 setparam   VARCHAR2(255),          OG_SETPARAM_GENERICA
 fmttrig    VARCHAR2(255),          OG_FMTTRIG_GENERICA
 hide       BOOLEAN                 OG_HIDE_GENERICA
);
                                    OG_ALL_GENERICA
                                    OG_NONE_GENERICA

	属性	説明
CSG	name	オブジェクト名。
CG	parent	オブジェクトの親オブジェクトのハンドル。
G	ibbox	オブジェクトの内側のバウンディング・ボックス。これは、枠の太さやその他の属性の設定に関係なく、オブジェクトの理想の形状を構成している（オブジェクトの4つの制御点を結んでいる）四角形です。
G	obbox	オブジェクトの外側のバウンディング・ボックス。これは、オブジェクトを完全に囲める最小サイズの四角形です。外側のバウンディング・ボックスは、オブジェクトの枠が太い場合には内側のバウンディング・ボックスと異なる場合があります。内側のバウンディング・ボックスではオブジェクトの本来あるべき形をたどっているのに対し、外側のバウンディング・ボックスではオブジェクト全体を囲みます。
G	objtype	オブジェクトのタイプ。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_ARC_OBJTYPE   オブジェクトが円弧である。
		OG_CHART_OBJTYPE   オブジェクトがチャートである。
		OG_GROUP_OBJTYPE   オブジェクトがグループである。
		OG_IMAGE_OBJTYPE   オブジェクトがイメージである。
		OG_LINE_OBJTYPE   オブジェクトが線である。
		OG_POLY_OBJTYPE   オブジェクトが多角形または折れ線である。
		OG_RECT_OBJTYPE   オブジェクトが四角形である。
		OG_RRECT_OBJTYPE   オブジェクトが角の丸い四角形である。
		OG_SYMBOL_OBJTYPE   オブジェクトが記号である。
		OG_TEXT_OBJTYPE   オブジェクトがテキスト・オブジェクトである。
CSG	button	オブジェクトと対応付けるボタン・プロシージャのハンドル。要求したマウス・イベントをこのプロシージャで確実に受信できるようにするには、必ずイベント属性を正しく設定してください。
CSG	events	ボタン属性で指定されたプロシージャで受信するマウス・イベントのタイプ。この属性の値として、次のビルトイン定数のいずれかを指定できます。プロシージャで複数のイベント・タイプを確実に受信できるようにするには、この属性を、要求したイベントの定数の合計となるように設定します。
		OG_NO_EVENTS   どのマウス・イベントも受信しない。
		OG_MOUSE_DOWN   マウス・ボタンを押すイベントのみ受信する。
		OG_MOUSE_UP   マウス・ボタンを放すイベントのみ受信する。
		OG_MOUSE_MOVE_UP   マウス・ボタンを放したまま、マウスを移動させるイベントのみ受信する。
CSG	keycol	ドリルダウン・チャートに設定する列。この属性は、チャート要素にしか適用されません。
CSG	execquery	オブジェクトを選択したときに実行される問合せを指定します。
CSG	setparam	オブジェクトを選択すると値が設定されるパラメータです。
CSG	fmttrig	フォーマット・トリガー。この属性は、チャート要素にしか適用されません。
SG	hide	指定されたGraphics Builderオブジェクトを隠します。


図形結合属性レコード

図形結合属性レコードは、一般属性レコードと図形属性レコードで構成されます。

TYPE og_graphic_ca IS RECORD
(graphic_caob  og_generic_attr,


図形属性レコード

図形属性レコードは、図形オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_graphic_attr IS RECORD     Mask Constants:
(mask        NUMBER(4,0),
 ewidth      NUMBER(10,0),         OG_EWIDTH_GRAPHICA
 rotang      NUMBER(5,2),          OG_ROTANG_GRAPHICA
 fecolor     VARCHAR2(255),        OG_FECOLOR_GRAPHICA
 becolor     VARCHAR2(255),        OG_BECOLOR_GRAPHICA
 edgepatt    VARCHAR2(255),        OG_EDGEPATT_GRAPHICA
 ffcolor     VARCHAR2(255),        OG_FFCOLOR_GRAPHICA
 bfcolor     VARCHAR2(255),        OG_BFCOLOR_GRAPHICA
 fillpatt    VARCHAR2(255),        OG_FILLPATT_GRAPHICA
 dashstyle   NUMBER(1,0),          OG_DASHSTYLE_GRAPHICA
 capstyle    NUMBER(2,0),          OG_CAPSTYLE_GRAPHICA
 joinstyle   NUMBER(2,0),          OG_JOINSTYLE_GRAPHICA
 transfer    NUMBER(1,0)           OG_TRANSFER_GRAPHICA
 bevelstyle  NUMBER(2,0)           OG_BEVELSTYLE_GRAPHICA
);
                                   OG_ALL_GRAPHICA
                                   OG_NONE_GRAPHICA

	属性	説明
CSG	ewidth	オブジェクトの枠の幅（レイアウト単位）。
CSG	rotang	オブジェクトの回転角度。オブジェクトが最初に作成されるときの角度は0とみなされ、この属性は、オブジェクトが現在、開始角度から時計回りに回転している度数です。この属性を設定すると、オブジェクトを絶対角度に対して回転させることができ、またOG_ROTATEプロシージャを使用すると、オブジェクトを相対角度の度数だけ回転させることができます。（OG_ROTATEを使用してオブジェクトを回転させると、新しい絶対角度を反映するようにrotang属性が自動的に更新されます。）
CSG	fecolor	オブジェクトのフォアグラウンド線カラー。有効なカラー・パレットについて詳細は、「デフォルト・カラー・パレット」を参照してください。
CSG	becolor	オブジェクトのバックグラウンド線カラー。有効なカラー名について詳細は、「デフォルト・カラー・パレット」を参照してください。
CSG	edgepatt	オブジェクトの枠パターン。有効なパターン名について詳細は、「パターン・パレット」を参照してください。
CSG	ffcolor	オブジェクトのフォアグラウンド塗りカラー。有効なカラー名について詳細は、「デフォルト・カラー・パレット」を参照してください。
CSG	bfcolor	オブジェクトのバックグラウンド塗りカラー。有効なカラー名について詳細は、「デフォルト・カラー・パレット」を参照してください。
CSG	fillpatt	オブジェクトの塗りパターン。有効なパターン名について詳細は、「パターン・パレット」を参照してください。
CSG	dashstyle	オブジェクトの枠の線種スタイル。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_SOLID_DSTYLE   実線を表示する。
		OG_DOT_DSTYLE   点線を表示する。
		OG_LONG_DSTYLE   ダッシュ記号を連ねて、長い破線として表示する。
		OG_DASHDOT_DSTYLE   ダッシュ記号とダッシュ記号の間に点を含む破線を表示する。
		OG_DOTDOT_DSTYLE   2つの連続した点からなる点線を表示する。
		OG_SHORT_DSTYLE   短いのダッシュ記号を連ねて、破線として表示する。
		OG_DASHDOTDOT_DSTYLE   ダッシュ記号とダッシュ記号の間に2つの連続した点を含む破線を表示する。
CSG	capstyle	オブジェクトの枠の端形式。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_BUTT_CSTYLE   切り端形式で表示する。
		OG_PROJECTING_CSTYLE   伸ばし端形式で表示する。
		OG_ROUND_CSTYLE   丸め端形式で表示する。
CSG	joinstyle	オブジェクトの枠の結合形式。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_MITRE_JSTYLE   角結合形式で表示する。
		OG_BEVEL_JSTYLE   斜め結合形式で表示する。
		OG_ROUND_JSTYLE   丸め結合形式で表示する。
CSG	transfer	オブジェクトの転送モード。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_COPY_TRANSFER   転送モードをコピーにする。
		OG_REVCOPY_TRANSFER   転送モードを逆転コピーにする。
		OG_OR_TRANSFER   転送モードをバック抜きにする。
		OG_REVOR_TRANSFER   転送モードを逆転バック抜きにする。
		OG_CLEAR_TRANSFER   転送モードをフォア抜きにする。
		OG_REVCLEAR_TRANSFER   転送モードを逆転フォア抜きにする。
		OG_INVERT_TRANSFER   転送モードをモノコピー（透明）にする。
		OG_BACKINVERT_TRANSFER   転送モードを逆転モノコピー（透明）にする。
CSG	bevelstyle	オブジェクトの凹凸スタイル。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_INSET_BSTYLE   凸枠で表示する。
		OG_LOWERED_BSTYLE   凹で表示する。
		OG_OUTSET_BSTYLE   凹枠で表示する。
		OG_PLAIN_BSTYLE   オブジェクトに凹凸スタイルを設定しない。
		OG_RAISED_BSTYLE   凸で表示する。


グループ結合属性レコード

グループ結合属性レコードは、一般属性レコードとグループ属性レコードで構成されます。

TYPE og_group_ca IS RECORD
(group_caob  og_generic_attr,   /* generic */
 group_caog  og_group_attr      /* group */
);


グループ属性レコード

グループ属性レコードは、グループ・オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_group_attr IS RECORD        Mask Constants:
(mask        NUMBER(1,0),
 childcount  NUMBER(10,0),          OG_CHILDCOUNT_GROUPA
 clipflag    BOOLEAN                OG_CLIPFLAG_GROUPA
);
                                    OG_ALL_GROUPA
                                    OG_NONE_GROUPA

	属性	説明
G	childcount	グループ・オブジェクトに含まれる子の数。別のグループ・オブジェクトが、対象としているグループの子である場合、そのオブジェクトは単に1つのオブジェクトとしてカウントされます。
CSG	clipflag	グループ内の最初のオブジェクトの表示領域を、グループを表示する枠にするかどうかを指定します。TRUEに設定すると、レイアウトに表示されるオブジェクトは、枠内に含まれるグループ・オブジェクト、またはグループ・オブジェクトの一部となります。枠になっているオブジェクト自体も表示されます。この属性の値として、次のいずれかを指定できます。
		TRUE   グループ内の最初のオブジェクトがクリップする枠と見なされる。
		FALSE   グループ内の最初のオブジェクトはクリップする枠と見なされない。


イメージ結合属性レコード

イメージ結合属性レコードは、一般属性レコードとイメージ属性レコードで構成されます。

TYPE og_image_ca IS RECORD
(image_caob  og_generic_attr,   /* generic */
 image_caoi  og_image_attr


イメージ属性レコード

イメージ属性レコードは、イメージ・オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_image_attr IS RECORD          Mask Constants:
(mask        NUMBER(3,0),
 cliprect    og_rectangle,            OG_CLIPRECT_IMAGEA
 upperleft   og_point,                OG_UPPERLEFT_IMAGEA
 width       NUMBER(10,0),            OG_SIZE_IMAGEA
 height      NUMBER(10,0),            OG_SIZE_IMAGEA
 query       og_query,                OG_DATA_IMAGEA
 which_data  NUMBER(1,0),             OG_DATA_IMAGEA
 colname     VARCHAR2(255),           OG_DATA_IMAGEA
 quality     NUMBER(5,0),             OG_QUALITY_IMAGEA
 dither      BOOLEAN                  OG_DITHER_IMAGEA
);
                                      OG_ALL_IMAGEA
                                      OG_NONE_IMAGEA

	属性	説明
SG	cliprect	イメージを表示する枠のx座標とy座標、および高さ、幅（レイアウト単位）。この枠の中に含まれるイメージのみが表示されます。この属性を指定しないと、クリップする枠がイメージの全寸法と同じ大きさになります。
SG	upperleft	イメージの左上角のx座標とy座標（レイアウト単位）。
SG	width	イメージの幅（レイアウト単位）。この属性にイメージのデフォルトの幅以外の値を設定すると、イメージは新しい幅に合うように調整サイズされます。
SG	height	イメージの高さ（レイアウト単位）。この属性にイメージのデフォルトの高さ以外の値を設定すると、イメージは新しい高さに合うようにサイズ調整されます。
C	query	データベース内の表からイメージを取り出す問合せのハンドル。この表は、必ずユーザー表であり、Graphics Builderが、図表または描画、チャート・テンプレート、カラー・パレット、イメージ、サウンドをデータベースに保存またはエクスポートするときに使用されるプライベート表であってはいけません。データベースに格納できるのは、Oracleイメージ・フォーマットのみです。
C	which_data	作成するイメージを問合せの新しいデータ・セットに入れるか古いデータ・セットに入れるかを指定します。Graphics Builderには、この属性の値として使用可能なビルトイン数値定数が2つあります。
		OG_NEWDATA   イメージを問合せの新しいデータ・セットに入れる。
		OG_OLDDATA   イメージを問合せの古いデータ・セットに入れる。
C	colname	イメージ・データを入れる問合せ列の名前。作成されたイメージは、この属性で指定した列と問合せのカーソルが指し示す行が交わる問合せセルに入れられます。
CSG	quality	イメージを描画するときの品質を指定します。イメージの品質を高くすると、見栄えはよくなりますが、操作（たとえば、描画、移動、スケーリングなど）の処理時間が長くなります。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_HIGH_IQUALITY   品質が高くなる。
		OG_MED_IQUALITY   品質が標準になる。
		OG_LOW_IQUALITY   品質が低くなる。
CSG	dither	Graphics Builderでイメージを表示するときに、そのイメージをディザリングするかどうかを指定します。この属性の値として、次のいずれかを指定できます。
		TRUE   イメージをディザリングする。
		FALSE   イメージをディザリングしない。


線結合属性レコード

線結合属性レコードは、一般属性レコードおよび図形属性レコード、線属性レコードで構成されます。

TYPE og_line_ca IS RECORD
(line_caob  og_generic_attr, /* generic */
 line_caoh  og_graphic_attr, /* graphic */
 line_caol  og_line_attr /* line */
);


線属性レコード

線属性レコードは、線オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_line_attr IS RECORD           Mask Constants:
(mask        NUMBER(1,0),
 startpt     og_point,                OG_STARTPT_LINEA
 endpt       og_point,                OG_ENDPT_LINEA
 arrowstyle  NUMBER(1,0)              OG_ARROWSTYLE_LINEA
);
                                      OG_ALL_LINEA
                                      OG_NONE_LINEA

	属性	説明
CSG	startpt	線の始点のx座標とy座標（レイアウト単位）。
CSG	endpt	線の終点のx座標とy座標（レイアウト単位）。
CSG	arrowstyle	線の矢印のスタイル。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_NOARROW_ASTYLE   線に矢印を付けない。
		OG_START_ASTYLE   線の始点に矢印を付ける。
		OG_END_ASTYLE   線の終点に矢印を付ける。
		OG_BOTH_ASTYLE   線の両側の終点に矢印を付ける。
		OG_MIDTOSTART_ASTYLE   線の中央に始点方向を指す矢印を付ける。
		OG_MIDTOEND_ASTYLE   線の中央に終点方向を指す矢印を付ける。


多角形結合属性レコード

多角形結合属性レコードは、一般属性レコードおよび図形属性レコード、多角形属性レコードで構成されます。

TYPE og_poly_ca IS RECORD
(poly_caob  og_generic_attr,


多角形属性レコード

多角形属性レコードは、多角形オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_poly_attr IS RECORD               Mask Constants:
(mask     NUMBER(1,0),
 pointct  NUMBER(10,0),                   OG_POINTCT_POLYA
 closed   BOOLEAN                         OG_CLOSED_POLYA
);
                                          OG_ALL_POLYA
                                          OG_NONE_POLYA

	属性	説明
G	pointct	多角形オブジェクトを構成する点の数。
CSG	closed	多角形の閉じ形状。この属性の値として、次のいずれかを指定できます。
		TRUE   多角形を閉じる。
		FALSE   多角形を開く。


プリンタ属性レコード

TYPE og_printer_attr IS RECORD      Mask Constants:
(mask       NUMBER(3,0),
 name       VARCHAR2(255),          OG_NAME_PRINTERA
 landscape  BOOLEAN,                OG_LANDSCAPE_PRINTERA
 startpage  NUMBER(5,0),            OG_STARTPAGE_PRINTERA
 endpage    NUMBER(5,0),            OG_ENDPAGE_PRINTERA
 width      NUMBER(10,0),           OG_WIDTH_PRINTERA
 height     NUMBER(10,0),           OG_HEIGHT_PRINTERA
 copies     NUMBER(5,0),            OG_COPIES_PRINTERA
 printfile  VARCHAR2(255)           OG_PRINTFILE_PRINTERA
);
                                    OG_ALL_PRINTERA
                                    OG_NONE_PRINTERA

	属性	説明
SG	name	現行のプリンタの名前。
SG	landscape	図表をLandscapeモードとPortraitモードのどちらで印刷するかを指定します
SG	startpage	印刷する第1ページ。
SG	endpage	印刷する最終ページ。
S	width	ページの幅。
S	height	ページの高さ。
SG	copies	印刷部数。
SG	printfile	出力先のPostScriptファイルの名前。このプロパティをNULLにすると、出力がプリンタへ送られます。


問合せ属性レコード

問合せ属性レコードは、問合せにのみ使用可能な属性で構成されます。

TYPE og_query_attr IS RECORD       Mask Constants:
(mask         NUMBER(4,0),
 name         VARCHAR2(255),       OG_NAME_QUERYA
 dateformat   VARCHAR2(255),       OG_DATEFORMAT_QUERYA
 querysource  VARCHAR2(2000),      OG_QUERYSOURCE_QUERYA
 querytype    NUMBER(1,0),         OG_QUERYTYPE_QUERYA
 cachetype    NUMBER(1,0),         OG_CACHETYPE_QUERYA
 maxflag      BOOLEAN,             OG_MAXFLAG_QUERYA
 maxrows      NUMBER(10,0),        OG_MAXROWS_QUERYA
 execopen     BOOLEAN,             OG_EXECOPEN_QUERYA
 exectimer    VARCHAR2(255),       OG_EXECTIMER_QUERYA
 execalert    VARCHAR2(255),       OG_EXECALERT_QUERYA
 customproc   VARCHAR2(255),       OG_CUSTOMPROC_QUERYA
 postproc     VARCHAR2(255)        OG_POSTPROC_QUERYA
);
                                   OG_ALL_QUERYA
                                   OG_NONE_QUERYA

	属性	説明
CSG	name	問合せの名前です。
CSG	dateformat	問合せの日付書式マスク。
CSG	querysource	問合せデータのソース。データのソースがデータベースであれば、この属性に問合せのSQL SELECT文のテキストを入れる必要があります。データがファイル・システムに格納されている場合は、この属性にデータ・ファイルのパスと名前を入れる必要があります。
CSG	querytype	問合せのタイプです。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_CUSTOM_QTYPE   通常の問合せを使用する。
		OG_EXSQL_QTYPE   SQL SELECT文で構成されるテキスト・ファイルからデータをフェッチする。
		OG_PRN_QTYPE   PRNファイルを使用する。
		OG_SQL_QTYPE   SQL SELECT文を使用する。
		OG_SYLK_QTYPE   SYLKファイルを使用する。
		OG_WKS_QTYPE   WKSファイルを使用する。
CSG	cachetype	問合せの実行により新しく取り出されたデータを処理する方法を決定します。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_APPEND_CACHETYPE   既存のデータ行がすべて保持され、新しいデータ行が既存のデータ・セットの一番下に追加される。
		OG_COPY_CACHETYPE   前に実行されたデータがすべてバッファにコピーされ、新しく取り出されたデータに置換される。
		OG_NONE_CACHETYPE   前に実行されたデータがすべて廃棄され、新しく取り出されたデータに置換される。
CSG	maxflag	データ・セット内の行数に制限を設定するかどうかを指定します。
CSG	maxrows	問合せデータ・セットに保持されるデータの最大行数を指定します。
CSG	execopen	図表を実行中にオープンした時に問合せを自動的に実行するかどうかを指定します。
CSG	exectimer	問合せを実行するときに使用するタイマーの名前。
CSG	execalert	未使用。
CSG	customproc	カスタムの問合せが実行されるときに起動するPL/SQLプロシージャです。
CSG	postproc	問合せが実行された後で起動するPL/SQLプロシージャです。


四角形結合属性レコード

四角形結合属性レコードは、一般属性レコード、図形属性レコードおよび四角形属性レコードで構成されます。

TYPE og_rect_ca IS RECORD
(rect_caob  og_generic_attr,   /* generic */
 rect_caoh  og_graphic_attr,   /* graphic */
 rect_caor  og_rect_attr       /* rectangle */
);


四角形属性レコード

四角形属性レコードは、四角形オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_rect_attr IS RECORD              Mask Constants:
(mask      NUMBER(1,0),
 baserect  og_rectangle                  OG_BASERECT_RECTA
);
                                         OG_ALL_RECTA
                                         OG_NONE_RECTA

	属性	説明
CSG	baserect	四角形オブジェクトの基礎として使用する四角形の左上角のx座標とy座標。


参照線属性レコード

TYPE og_refline_attr IS RECORD           Mask Constants:
(mask       NUMBER(2,0),
 numvalue   NUMBER(6),                   OG_VALUE_REFLINEA
 datevalue  DATE,                        OG_VALUE_REFLINEA
 label      VARCHAR2(255),               OG_LABEL_REFLINEA
 axis       NUMBER(1,0)                  OG_AXIS_REFLINEA
);
                                         OG_ALL_REFLINEA
                                         OG_NONE_REFLINEA

	属性	説明
SG	numvalue	参照線の数値。
SG	datevalue	参照線の日付値。
SG	label	凡例に表示する参照線を識別するテキスト・ラベル。
SG	axis	参照値の基準となる軸を指定します。


角の丸い四角形結合属性レコード

角の丸い四角形結合属性レコードは、一般属性レコード、図形属性レコードおよび丸い四角形属性レコードで構成されます。

TYPE og_rrect_ca IS RECORD
(rrect_caob  og_generic_attr,   /* generic */
 rrect_caoh  og_graphic_attr,   /* graphic */
 rrect_caor  og_rrect_attr      /* rounded rectangle */
);


角の丸い四角形属性レコード

角の丸い四角形属性レコードは、角の丸い四角形オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_rrect_attr IS RECORD            Mask Constants:
(mask      NUMBER(1,0),
 baserect  og_rectangle,                OG_BASERECT_RRECTA
 corner    og_point                     OG_CORNER_RRECTA
);
                                        OG_ALL_RRECTA
                                        OG_NONE_RRECTA

	属性	説明
CSG	baserect	四角形オブジェクトの基礎として使用する四角形の左上角のx座標とy座標。
CSG	corner	丸める角を形成する弧を360度になるまで延長してできる楕円のx半径とy半径（レイアウト単位）。


サウンド属性レコード

サウンド属性レコードは、サウンドにのみ使用可能な属性で構成されます。

TYPE og_sound_attr IS RECORD              Mask Constants:
(mask        NUMBER(1,0),
 query       og_query,                    OG_DATA_SOUNDA
 which_data  NUMBER(1,0),                 OG_DATA_SOUNDA
 colname     VARCHAR2(255),               OG_DATA_SOUNDA
 name        VARCHAR2(255),               OG_NAME_SOUNDA
);
                                          OG_ALL_SOUNDA
                                          OG_NONE_SOUNDA

	属性	説明
C	query	データベースの表からサウンドを検索する問合せのハンドル。この表は、必ずユーザー表であり、Graphics Builderが、図表または描画、チャート・テンプレート、カラー・パレット、イメージ、サウンドをデータベースに保存またはエクスポートするときに使用されるプライベート表であってはいけません。
C	which_data	作成されるサウンドが、問合せの新規データ・セット内に含まれているか、旧データ・セットに含まれているかを指定します。Graphics Builderには、この属性の値として使用可能なビルトイン数値定数が2つあります。
		OG_NEWDATA   サウンドを問合せの新しいデータ・セットに入れる。
		OG_OLDDATA   サウンドを問合せの古いデータ・セットに入れる。
C	colname	サウンド・データが入る問合せ列の名前。作成されるサウンドは、この属性により指定される列と問合せのカーソルが指している行の交差位置の問合せセルに含まれているものです。
CSG	name	サウンドの名前。


記号結合属性レコード

記号結合属性レコードは、一般属性レコードおよび図形属性レコード、記号属性レコードで構成されます。

TYPE og_symbol_ca IS RECORD
(symbol_caob  og_generic_attr,   /* generic */
 symbol_caoh  og_graphic_attr,   /* graphic */
 symbol_caos  og_symbol_attr     /* symbol */
);


記号属性レコード

記号属性レコードは、記号オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_symbol_attr IS RECORD          Mask Constants:
(mask     NUMBER(1,0),
 center   og_point,                    OG_CENTER_SYMBOLA
 indx     NUMBER(3,0),                 OG_INDX_SYMBOLA
 symsize  NUMBER(1,0)                  OG_SYMSIZE_SYMBOLA
);
                                       OG_ALL_SYMBOLA
                                       OG_NONE_SYMBOLA

	属性	説明
CSG	center	記号の中央のx座標とy座標（レイアウト単位）。
CSG	indx	デザイナ内の記号パレットに表示される記号の索引(または番号)。
CSG	symsize	記号のサイズ。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_LARGE_SYMSIZE   サイズが大きくなる。
		OG_MEDIUM_SYMSIZE   サイズが標準になる。
		OG_SMALL_SYMSIZE   サイズが小さくなる。


テキスト属性の概要

テキスト属性レコードには、テキスト・オブジェクト内に表示されるテキストは含まれません。そのかわりに、まずテキスト・オブジェクトを作成してから、OG_INSERT_CMPTEXTプロシージャを使用してそのテキスト・オブジェクトに複数テキスト要素を挿入する必要があります。1つのテキスト・オブジェクトに複数の複数テキスト要素を挿入することができ、各要素はそのオブジェクト内の1行のテキストを表します。また、それぞれの複数テキスト要素に、1つ以上の単一テキスト要素を挿入することもできます。単一テキスト要素は、実際のテキスト文字列で構成され、複数テキスト要素に挿入する場合にはOG_INSERT_SMPTEXTプロシージャを使用して実行する必要があります。

複数テキストおよび単一テキストの属性レコードについては、後のリストを参照してください。


テキスト結合属性レコード

テキスト結合属性レコードは、一般属性レコード、図形属性レコードおよびテキスト属性レコードで構成されます。

TYPE og_text_ca IS RECORD
(text_caob  og_generic_attr,   /* generic */
 text_caoh  og_graphic_attr,   /* graphic */
 text_caot  og_text_attr       /* text */
);


テキスト属性レコード

テキスト属性レコードは、テキスト・オブジェクトにのみ使用可能な属性で構成されます。

TYPE og_text_attr IS RECORD            Mask Constants:
(mask       NUMBER(6,0),
 origin     og_point,                  OG_ORIGIN_TEXTA
 ctcount    NUMBER(10,0),              OG_CTCOUNT_TEXTA
 gfont      og_font_attr,              OG_GFONT_TEXTA
 gcolor     VARCHAR2(255),             OG_GCOLOR_TEXTA
 spacing    NUMBER(1,0),               OG_SPACING_TEXTA
 custom     NUMBER(10,0),              OG_SPACING_TEXTA
 horigin    NUMBER(1,0),               OG_HORIGIN_TEXTA
 vorigin    NUMBER(1,0),               OG_VORIGIN_TEXTA
 halign     NUMBER(2,0),               OG_HALIGN_TEXTA
 valign     NUMBER(3,0),               OG_VALIGN_TEXTA
 fixed      BOOLEAN,                   OG_FIXED_TEXTA
 wrap       BOOLEAN,                   OG_WRAP_TEXTA
 bbscale    BOOLEAN,                   OG_BBSCALE_TEXTA
 fontscale  BOOLEAN,                   OG_FONTSCALE_TEXTA
 invisible  BOOLEAN,                   OG_INVISIBLE_TEXTA
 width      NUMBER(10,0),              OG_FIXEDWH_TEXTA
 height     NUMBER(10,0)               OG_FIXEDWH_TEXTA
);
                                       OG_ALL_TEXTA
                                       OG_NONE_TEXTA

	属性	説明
CSG	origin	テキスト・オブジェクトの左上角のx座標とy座標です（レイアウト単位）。
G	Ctcount	テキスト・オブジェクトを構成する複数テキスト要素の数。
S	Gfont	テキスト・オブジェクトのグローバル・フォント。この属性を設定すると、テキスト・オブジェクトのすべての単一テキスト要素のフォント属性がこのフォントに設定されます。この属性の設定によって影響されるのは、既存の単一テキスト要素のみです。新しく追加された単一テキスト要素は、その単一テキスト属性レコードに指定されたフォントで表示されます。
S	gcolor	テキスト・オブジェクトのグローバル・カラー。この属性を設定すると、テキスト・オブジェクトのすべての単一テキスト要素のカラー属性がこのカラーに設定されます。この属性の設定によって影響されるのは、既存の単一テキスト要素のみです。新しく追加された単一テキスト要素は、その単一テキスト属性レコードに指定されたカラーで表示されます。
CSG	spacing	テキスト・オブジェクトの行間隔。この属性の値として、次のビルトイン定数のいずれかを指定できます。カスタム間隔を設定する場合、custom属性の値には、正確な間隔の値を指定してください。
		OG_SINGLE_SPACE   テキストの行間隔をシングル・スペースに設定する。
		OG_ONEHALF_SPACE   テキストの行間隔を1-1/2スペースに設定する。
		OG_DOUBLE_SPACE   テキストの行間隔をダブル・スペースに設定する。
		OG_CUSTOM_SPACE   テキストの行間隔をカスタム・サイズに設定する。使用する実際の間隔は、custom属性に定義します。
CSG	custom	テキスト・オブジェクトのカスタム間隔（レイアウト単位）。この属性を使用して間隔を指定できるのは、spacing属性がカスタム間隔に設定されている場合のみです。
CSG	horigin	原点に対するテキスト・オブジェクトの水平位置。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_LEFT_HORIGIN   原点が左枠に沿って配置される。
		OG_CENTER_HORIGIN   原点が左枠と右枠のちょうど中間に配置される。
		OG_RIGHT_HORIGIN   原点が右枠に沿って配置される。
CSG	vorigin	原点に対するテキスト・オブジェクト の垂直位置。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_TOP_VORIGIN   原点が上枠に沿って配置される。
		OG_MIDDLE_VORIGIN   原点が上枠と下枠のちょうど中間に配置される。
		OG_BOTTOM_VORIGIN   原点が下枠に沿って配置される。
CSG	halign	テキスト・オブジェクトの水平文字揃え。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_LEFT_HALIGN   テキストを左揃えで表示する。
		OG_CENTER_HALIGN   テキストを中央揃えで表示する。
		OG_RIGHT_HALIGN   テキストを右揃えで表示する。
CSG	valign	テキスト・オブジェクトの垂直文字揃え。この属性の値として、次のビルトイン定数のいずれかを指定できます。
		OG_TOP_VALIGN   テキストを上揃えで表示する。
		OG_MIDDLE_VALIGN   テキストを中央揃えで表示する。
		OG_BOTTOM_VALIGN   テキストを下揃えで表示する。
CSG	wrap	テキストを、テキスト・オブジェクトのバウンディング・ボックスに収まるように「ラップ（改行）」するかどうかを指定します。複数テキスト要素はテキストの行を表し、単一テキスト要素から構成されます。この属性の値として、次のいずれかを指定できます。
		TRUE   テキストをラップする。
		FALSE   テキストをラップしない。
CSG	bbscale	テキスト・オブジェクトをスケーリングするときにテキスト・オブジェクトの境界線もスケーリングするかどうかを指定します。この属性の値として、次のいずれかを指定できます。
		TRUE   バウンディング・ボックスをサイズ調整する。
		FALSE   バウンディング・ボックスをサイズ調整しない。
CSG	fontscale	テキスト・オブジェクトをスケーリングするときにフォントのサイズもスケーリングするかどうかを指定します。この属性の値として、次のいずれかを指定できます。
		TRUE   ポイント・サイズをサイズ調整する。
		FALSE   ポイント・サイズをサイズ調整しない。
CSG	fixed	テキスト・オブジェクトのバウンディング・ボックスを固定サイズのままにするかどうかを指定します。この属性をTRUEにする場合は、width属性およびheight属性の値に、バウンディング・ボックスのサイズを指定する必要があります。この属性の値として、次のいずれかを指定できます。
		TRUE   バウンディング・ボックスのサイズを固定する。バウンディング・ボックスのサイズは、width 属性および height 属性に定義します。
		FALSE   バウンディング・ボックスのサイズを固定しない。
CSG	width	バウンディング・ボックスの幅（レイアウト単位）。バウンディング・ボックスが変化するたびに、この属性は新しい幅になるように自動的に更新されます。この属性を使用して幅を設定できるのは、fixed属性がTRUEの場合のみです。
CSG	height	バウンディング・ボックスの高さ（レイアウト単位）。バウンディング・ボックスが変化するたびに、この属性は新しい高さになるように自動的に更新されます。この属性を使用して高さを設定できるのは、fixed属性がTRUEの場合のみです。
CSG	invisible	テキスト・オブジェクト内のテキストを表示しないようにするかどうかを指定します。これは、パスワードを見せたくない場合に、パスワードを入力するテキスト・フィールドに指定すると便利です。この属性の値として、次のいずれかを指定できます。
		TRUE   テキストが非表示になる。
		FALSE   テキストが表示される。


フォント属性レコード

フォント属性レコードを使用すると、フォント・スタイル、ポイント・サイズなどのフォントのプロパティを指定できます。

TYPE og_font_attr IS RECORD           Mask Constants:
(mask         NUMBER(3,0),
 typeface     VARCHAR2(255),          OG_TYPEFACE_FONTA
 ptsize       NUMBER(10,2),           OG_PTSIZE_FONTA
 style        NUMBER(5,0),            OG_STYLE_FONTA
 weight       NUMBER(5,0),            OG_WEIGHT_FONTA
 width        NUMBER(5,0),            OG_WIDTH_FONTA
 kerning      BOOLEAN,                OG_KERNING_FONTA
 nearest      BOOLEAN,                OG_NEAREST_FONTA
 synthesize   BOOLEAN,                OG_SYNTHESIZE_FONTA
 charset      NUMBER(5,0)             OG_CHARSET_FONTA
);
                                      OG_ALL_FONTA
                                      OG_NONE_FONTA

	属性	説明
CG	typeface	フォントのスタイル。この値はシステムによって異なります。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。
CG	ptsize	フォントのサイズ。このフィールドの値はシステムによって異なります。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。
CG	style	フォントのスタイル。すべてのスタイルをすべてのシステムで使用できるわけではありません。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。このフィールドには、次のビルトイン定数を指定できます。
		OG_BLINK_FONTSTYLE   隠し文字にする。
		OG_INVERTED_FONTSTYLE   反転表示をする。
		OG_ITALIC_FONTSTYLE   イタリック表示をする。
		OG_OBLIQUE_FONTSTYLE   斜体表示をする。
		OG_OUTLINE_FONTSTYLE   アウトライン表示をする。
		OG_OVERSTRIKE_FONTSTYLE   取消し線を表示する
		OG_PLAIN_FONTSTYLE   プレーン表示をする。
		OG_SHADOW_FONTSTYLE   影付き表示をする。
		OG_UNDERLINE_FONTSTYLE   下線表示をする。
		OG_UNKNOWN_FONTSTYLE   不明。スタイルをこの値に設定できません。ただし、フォントを取得したときに、Graphics Builderによってそのフォント・スタイルが判別されない場合は、この値が戻されます。
CG	weight	フォントの太さ。すべての太さをすべてのシステムで使用できるわけではありません。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。このフィールドには、次のビルトイン定数を指定できます。
		OG_BOLD_FONTWEIGHT   太字にする。
		OG_DEMIBOLD_FONTWEIGHT   やや細い太字にする。
		OG_DEMILIGHT_FONTWEIGHT   やや太い細字にする。
		OG_EXTRABOLD_FONTWEIGHT   さらに太い太字する。
		OG_EXTRALIGHT_FONTWEIGHT   さらに細い細字にする。
		OG_LIGHT_FONTWEIGHT   細字にする。
		OG_MEDIUM_FONTWEIGHT   標準にする。
		OG_ULTRABOLD_FONTWEIGHT   最も太い太字にする。
		OG_ULTRALIGHT_FONTWEIGHT   最も細い細字にする。
		OG_UNKNOWN_FONTWEIGHT   不明。フォントの太さをこの値に設定できません。ただし、フォントを取得したときに、Graphics Builderによってその太さが判別されない場合は、この値が戻されます。
CG	width	フォントの幅。すべての幅をすべてのシステムで使用できるわけではありません。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。このフィールドには、次のビルトイン定数を指定できます。
		OG_DENSE_FONTWIDTH   狭くする。
		OG_EXPAND_FONTWIDTH   広くする。
		OG_EXTRADENSE_FONTWIDTH   さらに狭くする。
		OG_EXTRAEXPAND_FONTWIDTH   さらに広くする。
		OG_NORMAL_FONTWIDTH   標準にする。
		OG_SEMIDENSE_FONTWIDTH   やや広い狭さにする。
		OG_SEMIEXPAND_FONTWIDTH   やや狭い広さにする。
		OG_ULTRADENSE_FONTWIDTH   最も狭くする。
		OG_ULTRAEXPAND_FONTWIDTH   最も広くする。
		OG_UNKNOWN_FONTWIDTH   不明。フォントの幅をこの値に設定できません。ただし、フォントを取得したときに、Graphics Builderによってその幅が判別されない場合は、この値が戻されます。
CG	kerning	フォントをカーニングするかどうかを指定する。カーニングとは、テキストを読みやすくするために、隣接する文字間の空白を調整することです。このフィールドの値として、次のいずれかを指定できます。
		TRUE   フォントをカーニングする。
		FALSE   フォントをカーニングしない。
C	nearest	指定したフォントが見つからない場合に、Graphics Builderによってそれにもっとも近いフォントが代用されるようにするかどうかを指定する。近似フォントを見つけるときの優先順位は、書体、サイズ、スタイル、フォントの太さ、幅の順です（つまり、Graphics Builderによって、まず指定された書体が検索され、次にサイズが検索され、という順番で検索されていきます）。この属性の値として、次のいずれかを指定できます。
		TRUE   最も近いフォントをかわりに使用する。
		FALSE   最も近いフォントをかわりに使用しない。
C	synthesize	指定したフォントが見つからない場合、Graphics Builderによって近似フォントを変形させて指定フォントを合成するかどうかを指定します。このフィールドの値として、次のいずれかを指定できます。
		TRUE   フォントを合成する。
		FALSE   フォントを合成しない。
CG	charset	フォントのキャラクタ・セット。このフィールドの値には、U.S. ASCIIおよび漢字、アラビア文字などのキャラクタ・セットを指定します。このフィールドの有効な値のリストについては、使用しているオペレーティング・システムのBuilderのマニュアルを参照してください。
		OG_US7ASCII_CHARSET
		OG_WE8DEC_CHARSET
		OG_WE8HP_CHARSET
		OG_US8PC437_CHARSET
		OG_WE8EBCDIC37_CHARSET
		OG_WE8EBCDIC500_CHARSET
		OG_WE8PC850_CHARSET
		OG_D7DEC_CHARSET
		OG_F7DEC_CHARSET
		OG_S7DEC_CHARSET
		OG_E7DEC_CHARSET
		OG_SF7ASCII_CHARSET
		OG_NDK7DEC_CHARSET
		OG_I7DEC_CHARSET
		OG_NL7DEC_CHARSET
		OG_CH7DEC_CHARSET
		OG_SF7DEC_CHARSET
		OG_WE8ISO8859P1_CHARSET
		OG_EE8ISO8859P2_CHARSET
		OG_SE8ISO8859P3_CHARSET
		OG_NEE8ISO8859P4_CHARSET
		OG_CL8ISO8859P5_CHARSET
		OG_AR8ISO8859P6_CHARSET
		OG_EL8ISO8859P7_CHARSET
		OG_IW8ISO8859P8_CHARSET
		OG_WE8ISO8859P9_CHARSET
		OG_AR8ASMO708PLUS_CHARSET
		OG_AR7ASMO449PLUS_CHARSET
		OG_WE8MACROMAN8_CHARSET
		OG_JVMS_CHARSET
		OG_JEUC_CHARSET
		OG_JDEC_CHARSET
		OG_SJIS_CHARSET
		OG_JDBCS_CHARSET
		OG_JHP_CHARSET
		OG_KSC5601_CHARSET
		OG_KIBM5540_CHARSET
		OG_KDBCS_CHARSET
		OG_CGB231380_CHARSET
		OG_CDBCS_CHARSET
		OG_BIG5_CHARSET
		OG_CNS1164386_CHARSET


複数テキスト要素属性レコード

複数テキスト要素属性レコードは、複数テキスト要素にのみ使用可能な属性で構成されます。

TYPE og_cmptext_attr IS RECORD	   Mask Constants:
(mask     NUMBER(1,0),
 stcount  NUMBER(10,0)               OG_STCOUNT_CMPTEXTA
);
                                     OG_ALL_CMPTEXTA
                                     OG_NONE_CMPTEXTA

	属性	説明
G	stcount	複数テキスト要素を構成する単一テキスト要素の数。


単一テキスト要素属性レコード

単一テキスト要素属性レコードは、単一テキスト要素にのみ使用可能な属性で構成されます。

TYPE og_smptext_attr IS RECORD    Mask Constants:
(mask   NUMBER(1,0),
 str    VARCHAR2(2000)            OG_STR_SMPTEXTA
 font   og_font_attr,             OG_FONT_SMPTEXTA
 color  VARCHAR2(255)             OG_COLOR_SMPTEXTA
);
                                  OG_ALL_SMPTEXTA
                                  OG_NONE_SMPTEXTA

	属性	説明
CSG	str	単一テキスト要素の実際のテキストが含まれている文字列。
CSG	font	文字列のテキストを表示するフォント。使用されるフォント属性を、フォント属性レコードのマスク属性（複数の場合もあり）の値で指定します。マスクを設定していない属性レコードのフィールドには、影響はありません。
CSG	color	文字列のテキストを表示するカラー。これはテキスト自体のカラーであることに注意してください。テキスト・オブジェクトの線カラーや塗りカラーを設定する場合は、そのテキスト・オブジェクトの図形属性を変更してください。
例

このプロシージャでは、座標(1",1")に"Message"という名前のテキスト・オブジェクトが作成され、次の2行のテキストが12ポイントのTimesフォントで入っています。

This is line 1.

And now line 2.

各複数テキスト要素は、テキスト・オブジェクトのちょうど1行のテキストを表すことを覚えておいてください。

PROCEDURE make_text IS
   text_obj   og_object;
   text_rec   og_text_ca;
   smp_rec    og_smptext_attr;
   font_rec   og_font_attr;
BEGIN
/* Set text object's name and origin attributes */
   text_rec.text_caob.name:='Message';
   text_rec.text_caot.origin.x:=OG_INCH;
   text_rec.text_caot.origin.y:=OG_INCH;
   text_rec.text_caob.mask:=OG_NAME_GENERICA;
   text_rec.text_caoh.mask:=OG_NONE_GRAPHICA;
   text_rec.text_caot.mask:=OG_ORIGIN_TEXTA;
/* Make the text object */
   text_obj:=og_make(text_rec);
/* Insert new compound text element into the text object at
      index 0 */
   og_insert_cmptext(text_obj, 0);
/* Set font record's typeface and point size attributes */
   font_rec.typeface:='times';
   font_rec.ptsize:=12;
   font_rec.mask:=OG_TYPEFACE_FONTA+
                  OG_PTSIZE_FONTA;
/* Set simple text record for text string and font */
   smp_rec.str:='This is line 1.';
   smp_rec.font:=font_rec;
   smp_rec.mask:=OG_STR_SMPTEXTA+
                 OG_FONT_SMPTEXTA;
/* Insert a new simple text element at index 0 in text
      object's compound text element at index 0, using
      defined simple text record */
   og_insert_smptext(text_obj, smp_rec, 0, 0);
/* Insert new compound text element into the text object at
      index 1 */
   og_insert_cmptext(text_obj, 1);
/* Change the simple text record's text string */
   smp_rec.str:='And now';
/* Insert a new simple text element at index 0 in text
      object's compound text element at index 1, using
      defined simple text record */
   og_insert_smptext(text_obj, smp_rec, 1, 0);
/* Change the simple text record's text string */
   smp_rec.str:=' line 2.';
/* Insert a new simple text element at index 1 in text
      object's compound text element at index 1, using
      defined simple text record */
   og_insert_smptext(text_obj, smp_rec, 1, 1);
END;

例

このファンクションでは、テキスト・フィールド・オブジェクトのハンドルを引数として使用し、このフィールドに入っているテキストを戻します。複数テキスト要素にしかアクセスしていないので、フェッチされるのはテキスト・フィールドの1行目のテキストのみです。

FUNCTION get_text(text_obj IN og_object) RETURN VARCHAR2 IS
   smp_rec   og_smptext_attr;
BEGIN
   /* Set the simple text record's mask, indicating that the text string is the only attribute to get */
   smp_rec.mask:=OG_STR_SMPTEXTA;
   /* Get the 0th simple text element in the text object's
      0th compound text element, and store the results in
      the simple text record */
   og_get_smptext(text_obj, 0, 0, smp_rec);
   /* Return the text string attribute of the simple text
      record */
   RETURN(smp_rec.str);
END;


タイマー属性レコード

タイマー属性レコードは、タイマーにのみ使用可能な属性で構成されます。

TYPE og_timer_attr IS RECORD          Mask Constants:
(mask       NUMBER(2,0),
 name       VARCHAR2(255),            OG_NAME_TIMERA
 interval   NUMBER(10,3),             OG_INTERVAL_TIMERA
 timerproc  VARCHAR2(255),            OG_TIMERPROC_TIMERA
 active     BOOLEAN                   OG_ACTIVE_TIMERA
);
                                      OG_ALL_TIMERA
                                      OG_NONE_TIMERA

	属性	説明
CSG	name	タイマーの名前。
CSG	interval	タイマー・プロシージャの実行間隔の秒数。
CSG	timerproc	タイマーの起動時に実行するプロシージャの名前。


ウィンドウ属性レコード

ウィンドウの位置とサイズは、「画面解像度単位」、つまり一般的にピクセルと呼ばれる単位で表します。画面解像度の水平値と垂直値は、OG_APPと呼ばれるビルトイン・グローバル・レコードに提供されています。このレコードは、OG_APP_ATTRタイプであり、これについては、本章の「アプリケーション属性レコード」の項で詳しく説明しています。

実際の数値のかわりにこのグローバル変数を使用して、アプリケーションが、画面解像度の異なるシステム上で一貫した表示を維持できるようにしてください。

ウィンドウ属性レコードは、ウィンドウにのみ使用可能な属性で構成されます。

TYPE og_window_attr is RECORD      Mask Constants:
(mask        NUMBER(2,0),
 position    og_point,             OG_POSITION_WINDOWA
 width       NUMBER(5,0),          OG_SIZE_WINDOWA
 height      NUMBER(5,0),          OG_SIZE_WINDOWA
 name        VARCHAR2(255),        OG_NAME_WINDOWA
 scrollbars  BOOLEAN,              OG_SCROLLBARS_WINDOWA
 helptarget  VARCHAR2(255)         OG_HELPTARGET_WINDOWA
);
                                   OG_ALL_WINDOWA
                                   OG_NONE_WINDOWA

	属性	説明
CSG	position	ウィンドウの左上角のx座標とy座標 （画面解像度単位）。
CSG	width	ウィンドウの幅（画面解像度単位）。
CSG	height	ウィンドウの高さ(画面解像度単位)。
CSG	name	ウィンドウの名前。実行時には、レイアウト・ウィンドウのデフォルト名が「Main Layout」となります。
C	Scrollbars	ウィンドウにスクロール・バーを表示するかどうかを指定します。この属性の値として、次のいずれかを指定できます。
		TRUE   ウィンドウにスクロール・バーを表示する。
		FALSE   ウィンドウにスクロール・バーを表示しない。
CSG	helptarget	ウィンドウがアクティブの間に「ヘルプ・システム」を起動した時に表示される、ランタイム・ヘルプ内のハイパーテキスト・ターゲット。


PL/SQLビルトインについて

このセクションでは、すべてのGraphics Builderビルトイン・サブプログラムについて説明します。これらのサブプログラムは、PL/SQL言語の拡張機能で、独自のサブプログラムにGraphics Builder機能と機能性を持たせることを可能にします。

これらのサブプログラムの使用法の詳細は、『Graphics Builder開発者ガイド』を参照してください。

ダメージ・フラグの使用法

バウディング・ボックス更新フラグの使用法

オブジェクトのリストでの作業

ビルトイン・サブプログラムの説明


ダメージ・フラグの使用法

次のプロシージャとファンクションのうち多くは、「ダメージ・フラグ」と呼ばれるブール引数を受け入れます。ダメージ引数は常にオプションで、その値は指定されない限り「TRUE」にデフォルト設定されています。

ダメージ・フラグが「TRUE」に設定されると、プロシージャまたはファンクションの影響を受けるレイアウトの一部に、「damaged」というマークが付けられます。これらの領域は「ダメージ領域」と呼ばれます。たとえば、オブジェクトのカラーまたはサイズを変更すると、オブジェクトが表示されている図表の領域がダメージを受けます。

ダメージ領域は常に四角形です。影響を受けるオブジェクトが四角形でない場合は、ダメージ領域が、オブジェクトを完全に包含する最小の大きさの四角形領域になります。

ダメージを受けた領域のプロシージャまたはファンクションを終了するか、またはビルトイン・プロシージャOG_SYNCHRONIZEをコールすると、ダメージ領域が自動的に再描画されます。スクリーンの領域が再描画されると、その領域は（別のプロシージャ・コールによってその領域が再びダメージを受けるまで）ダメージを受けていない状態になります。

ダメージ・フラグを「FALSE」に設定している場合は、サブプログラム・コールの影響を受けるレイアウトはダメージを受けていないので、前述のいずれの状態でも再描画されません。

ただし、オブジェクトを修正するときにダメージ・フラグを「FALSE」に設定していても、加えた変更はそのオブジェクトの内部記述に適用されます。後からそのようなオブジェクトの属性をプログラムで検査しようとすると（たとえば、ビルトイン・プロシージャOG_GET_ATTRを使用して）、それがレイアウトに表示されている内容と一致しないことがわかります。

たとえば、ダメージ・フラグを「FALSE」に設定してオブジェクトのサイズを変更すると、オブジェクトのサイズに変更がないことがレイアウトの表示でわかります。ただし、オブジェクトの内部表示は変更されます。つまりオブジェクトのサイズを判別するために後からOG_GET_ATTRを使用すると、Graphics Builderでサイズが変更されたサイズとして認識されていて、レイアウトに表示されているサイズとは異なって認識されていることがわかります。

「FALSE」ダメージ・フラグを指定するときは十分注意してください。このフラグによって、図表の外観と図表のオブジェクトの内部記述は「非同期」になります。

レイアウトの領域に明示的にダメージを与えるには、ビルトイン・プロシージャOG_DAMAGEを使用します。


バウンディング・ボックス更新フラグの使用法

次のプロシージャとファンクションのうち多くは、"バウンディング・ボックス更新フラグ"と呼ばれるブール引数を受け入れます。バウンディング・ボックス更新引数は常にオプションで、その値は指定されない限りTRUEにデフォルト設定されます。

オブジェクトのインナーとアウターのバウンディング・ボックスに関するオブジェクトに対しては、多くの修正を加えることができます。たとえば、オブジェクトの枠幅を変更すると、そのインナー・バウンディング・ボックスは変わりませんが、アウター・バウンディング・ボックスはオブジェクトの新しいサイズに調整されます。オブジェクトを移動すると、そのバウンディング・ボックスの両方が変更されます。

このような操作をするたびに、Graphics Builderではオブジェクトのバウンディング・ボックスが内部で更新されます（バウンディング・ボックスは、一般属性レコードのobbox属性とibbox属性で表されています）。

バウンディング・ボックス更新フラグを「TRUE」に設定すると、Graphics Builderでは、オブジェクトのバウンディング・ボックスに影響を及ぼす各操作の実行後、通常どおり更新されます。さらに、Graphics Builderはそのオブジェクトと関連のあるオブジェクトのバウンディング・ボックスを、オブジェクトが常駐するレイヤーまで（レイヤーを含む）更新します。

バウンディング・ボックス・フラグがFALSEの場合、バウンディング・ボックスは更新されません。

多数のオブジェクトを修正したり（いくつかのオブジェクトを何度も修正）すると、Graphics Builderがすべてのバウンディング・ボックスを更新するのに費やす時間によって、アプリケーションのパフォーマンスに悪影響が出る可能性があります。したがって、効率よくするために、バウンディング・ボックスの更新をすべての修正が加えられるまで待つことをお薦めします。たとえば、オブジェクトに対していくつか修正を加える場合、デフォルトの動作では、各修正の実行後にバウンディング・ボックスが更新されます。しかし、これらの複数の自動バウンディング・ボックス更新を抑制して、ビルトイン・プロシージャOG_UPDATE_BBOXを使用してバウンディング・ボックスを明示的に更新するように選択できます。

一方、オブジェクトに加える修正がそのバウンディング・ボックスに影響を及ぼさない場合は（たとえば、そのカラーの変更など）、それらが適切に更新されたかどうかについて注意する必要はありません。その場合は、自動バウンディング・ボックス更新を抑制したとしても、後で更新されるようなことはありません。

オブジェクトのバウンディング・ボックスを明示的に更新するには、ビルトイン・プロシージャOG_UPDATE_BBOXを使用します。

オブジェクトを修正し、バウンディング・ボックス更新フラグをFALSEに設定するときには、ダメージ・フラグもFALSEに設定することをお薦めします。Graphics Builderでは、オブジェクトのバウンディング・ボックスを使用して再描画するダメージ領域を判別します。バウンディング・ボックスが正確でないと、レイアウトが誤ってダメージを受ける可能性があります。


オブジェクトのリスト操作

このセクションで説明するプロシージャとファンクションは、"リスト"の項目を作成または修正するために使用されます。たとえば、次の各オブジェクトは以下のような項目リストから構成されています。

•	グループ・オブジェクトには子オブジェクトのリストが含まれています。

•	多角形オブジェクトにはポイントのリストが含まれています。

•	テキスト・オブジェクトには複数テキスト要素のリストが含まれています。

•	複数テキスト要素には単一テキスト要素のリストが含まれています。

•	チャート・オブジェクトにはフィールドのリストが含まれています。

リスト内の各項目には、リスト内での位置を表す"索引"、または番号が割り当てられます。リストは0が基数で、リストの最初の項目に索引0、2番目の項目に索引1という順で索引が割り当てられます。

下の例はグループ・オブジェクト（テニス・ラケット）の図形表示と、それを構成する子オブジェクト（ヘッド、ハンドル、グリップ）のリストです。

リストの操作

これらのリストに対して実行できる操作は次の3つです。

•	項目の挿入

•	項目の削除

•	項目の取得（その値を検査するため）

Graphics Builderでは、リストを使用する各オブジェクトごとに、ビルトイン・サブプログラムが提供されています。たとえば、グループ・オブジェクトとその子に関連するサブプログラムは、OG_INSERT_CHILD、OG_DELETE_CHILDおよびOG_GET_CHILDです。

これらのサブプログラムでは、操作する項目の索引を指定する必要があります。

たとえば、1つの複数テキスト要素と3つの単一テキスト要素からなる次のテキスト・オブジェクトを作成したとします。

最初の複数テキスト要素から2番目の単一テキスト要素を削除するには、次のように、プロシージャにテキスト・オブジェクトを渡します。

PROCEDURE delete_second_word(textobj og_object) IS
BEGIN
   og_delete_smptext(textobj, 0, 1, 1);
END;

別の例として、グループの子オブジェクトのリストの最後にオブジェクトを挿入することによって、そのオブジェクトをグループに追加するとします。リストの最後の項目に対応する索引を指定するには、リストに含まれている項目の数を知る必要があります。Graphics Builderには、リストの最後の項目を指定するための索引としてビルトイン数値定数OG_LASTが提供されています（また、リストの最初の項目を指定するための定数OG_FIRSTも提供されています）。

次のプロシージャで、グループ・オブジェクトと追加するオブジェクトを引数として受け入れ、そのオブジェクトをグループの最後に追加します。

PROCEDURE stick_at_end(groupobj og_object, childobj og_object) IS
BEGIN
   og_insert_child(groupobj, childobj, OG_LAST);
END;

OG_LAST索引はリストの最後に項目を挿入するためのみに使用してください。リストの最後から項目を削除したり取得するには、その項目の実際の索引値を指定する必要があります。項目を空のリストに挿入するには、OG_FIRSTまたはOG_LASTの索引を使用します。

別の項目ですでに占有されている索引を使用して項目を挿入すると、新しい項目が古い項目の前に挿入されます（つまり、新しい項目が指定された索引の位置を占有します）。

詳細は、使用するリスト関連のサブプログラムの説明を参照してください。


ビルトイン・サブプログラムの説明

説明:

サブプログラムの用途と使用方法を指定します。

構文:

サブプログラムをコールするための構文です。サブプログラムをコールする方法が複数ある場合は、すべて表示されます。

パラメータ

サブプログラムのパラメータについて説明します。

戻り値:

サブプログラムの戻り値（ファンクションのみ）について説明します。

コメント:

使用方法のルールと警告について説明します。

例:

サブプログラム使用法の作業例です。


例外名

  関連項目

構文

例外名 EXCEPTION;


OG_Active_Layer_Del

  関連項目

説明	この例外は、現行のアクティブ・レイヤーがOG_Destroyの引数として使用される場合に発生します。

構文

OG_Active_Layer_Del EXCEPTION;

エラー・コード	 102034


 OG_Append_Failure

  関連項目

説明	この例外は、データをカスタム問合せに追加しようとしている最中にエラーが生じた場合に発生します。

構文

OG_Append_Failure EXCEPTION;

エラー・コード	 102166


   OG_Column_Not_Settable

  関連項目

説明	この例外は、問合せ列のスキーマを修正しようとしたとき、その問合せがカスタム問合せではなかった場合に発生します。

構文

OG_Column_Not_Settable EXCEPTION;

エラー・コード	 102167


OG_Colors_Not_Writable

  関連項目

説明	この例外は、OG_Import_Imageをコールする際に、use_colors引数をTRUEに設定しても、図表のカラー・パレットが編集可能にならない場合に発生します。

構文

OG_Colors_Not_Writable EXCEPTION;

エラー・コード	 102097


OG_Column_Type_Mismatch

  関連項目

説明	この例外は、OG_Get_Charcell、OG_Get_DatecellまたはOG_Get_Numcellによって戻されたデータが、予期されないデータ型の場合発生します。

構文

OG_Column_Type_Mismatch EXCEPTION;

エラー・コード	 102043


OG_Date_Overflow

  関連項目

説明	この例外は、OG_Update_Chartにおいて日付軸を含むチャートをコールしたとき、データ範囲が大きすぎる場合に発生します。たとえば、データが数年にわたっていて、軸の主目盛間隔が秒の場合、この例外が発生します。

構文

OG_Date_Overflow EXCEPTION;

エラー・コード	 102074


OG_Delete_Column_Failure

  関連項目

説明	この例外は、問合せから列を削除しようとした場合に発生します。列を削除できるのは、カスタム問合せの場合のみです。

構文

OG_Delete_Column_Failure EXCEPTION;

エラー・コード	 102169


OG_Delete_Object_Prop_Failure

  関連項目

説明	この例外は、オブジェクトからプロパティを削除しようとした場合に発生します。

構文

OG_Delete_Object_Prop_Failure EXCEPTION;

エラー・コード	 102164


OG_Delete_Param_Error

  関連項目

説明	この例外は、パラメータを削除しようとした場合に発生します。

構文

OG_Delete_Param_Error EXCEPTION;

エラー・コード	 102176


OG_Delete_Property_Error

  関連項目

説明	この例外は、オブジェクトからプロパティを削除しようとした場合に発生します。

構文

OG_Delete_Property_Error EXCEPTION;

エラー・コード	 102181


OG_Display_Closed

  関連項目

説明	この例外は、OG_Close_Displayをコールして図表をクローズした後、その図表に対して操作を実行しようとした場合に発生します。

構文

OG_Display_Closed EXCEPTION;

エラー・コード	 102115


OG_Drawing_Export_Failure

  関連項目

説明	この例外は、OG_Export_Drawingが描画をエクスポートしようとしてエラーが生じた場合に発生します。

構文

OG_Drawing_Export_Failure EXCEPTION;

エラー・コード	 102091


OG_Drawing_Import_Failure

  関連項目

説明	この例外は、OG_Import_Drawingが描画をインポートしようとして、エラーが生じた場合に発生します。

構文

OG_Drawing_Import_Failure EXCEPTION;

エラー・コード	 102095


OG_Duplicate_Column_Name

  関連項目

説明	この例外は、カスタム問合せで列を定義したとき、その列名で別の列にすでに使用されていた場合に発生します。

構文

OG_Duplicate_Column_Name EXCEPTION;

エラー・コード	 102172


OG_Duplicate_Display_Name

  関連項目

説明	この例外は、OG_Save_Displayをコールして、name 引数をオープンされている別の図表のname引数と同じ値に設定した場合に発生します。

構文

OG_Duplicate_Display_Name EXCEPTION;

エラー・コード	 102106


OG_Duplicate_Ftemp_Name

  関連項目

説明	この例外は、フィールド・テンプレートを作成したとき、同じ名前のフィールド・テンプレートがすでに存在していた場合に発生します。

構文

OG_Duplicate_Ftemp_Name EXCEPTION;

エラー・コード	 102156


OG_Duplicate_Query_Name

  関連項目

説明	この例外は、問合せを作成したとき、同じ名前の問合せがすでに存在していた場合に発生します。

構文

OG_Duplicate_Query_Name EXCEPTION;

エラー・コード	 102171


OG_Duplicate_Template_Name

  関連項目

説明	この例外は、チャート・テンプレートを作成したとき、同じ名前のチャート・テンプレートがすでに存在していた場合に発生します。

構文

OG_Duplicate_Template_Name EXCEPTION;

エラー・コード	 102157


OG_Env_Var_Error

  関連項目

説明	この例外は、OG_Translate_Envvarが環境変数を評価しようとして、エラーが生じた場合に発生します。

構文

OG_Env_Var_Error EXCEPTION;

エラー・コード	 102102


OG_Env_Var_Notfound

  関連項目

説明	この例外は、OG_Translate_Envvarで環境変数を変換しようとしたとき、その変数がシステムに対して定義されていなかった場合に発生します。

構文

OG_Env_Var_Notfound EXCEPTION;

エラー・コード	 102103


OG_Font_Not_Found

  関連項目

説明	この例外は、システムで見つからないフォント名を使用してフォントを設定しようとした場合に発生します。

構文

OG_Font_Not_Found EXCEPTION;

エラー・コード	 102098


OG_Generate_Display_Failure

  関連項目

説明	この例外は、図表の生成中にOG_Generate_Displayで、エラーが生じた場合に発生します。

構文

OG_Generate_Display_Failure EXCEPTION;

エラー・コード	 102105


OG_Get_Object_Prop_Failure

  関連項目

説明	この例外は、オブジェクト・プロパティ値の取得中に、エラーが生じた場合に発生します。

構文

OG_Get_Object_Prop_Failure EXCEPTION;

エラー・コード	 102163


OG_Get_Param_Error

  関連項目

説明	この例外は、パラメータ値の取得中に、エラーが生じた場合に発生します。

構文

OG_Get_Param_Error EXCEPTION;

エラー・コード	 102175


OG_Get_Printer_Failure

  関連項目

説明	この例外は、印刷しようとしたとき、Graphics Builderでプリンタが検出されなかった場合に発生します。

構文

OG_Get_Printer_Failure EXCEPTION;

エラー・コード	 102160


OG_Get_Property_Error

  関連項目

説明	この例外は、オブジェクト・プロパティ値の取得中に、エラーが生じた場合に発生します。

構文

OG_Get_Property_Error EXCEPTION;

エラー・コード	 102179


OG_Hide_Active_Layer

  関連項目

説明	この例外は、現行のアクティブ・レイヤーが、OG_Hide_Layer の引数として使用された場合に発生します。レイヤーを非アクティブにするには、OG_Activate_Layer を使用して別のレイヤーをアクティブにしてください。

構文

OG_Hide_Active_Layer EXCEPTION;

エラー・コード	 102013


OG_Host_Failure_Error

  関連項目

説明	この例外は、OG_Hostがホスト・システムでコマンドを実行しようとしたとき、OG_Hostエラーが生じた場合に発生します。

構文

OG_Host_Failure_Error EXCEPTION;

エラー・コード	 102059


OG_Image_Creation_Failure

  関連項目

説明	この例外は、イメージの作成中に、エラーが生じた場合に発生します。

構文

OG_Image_Creation_Failure EXCEPTION;

エラー・コード	 102083


OG_Image_Export_Failure

  関連項目

説明	この例外は、イメージのエクスポート中に、OG_Export_Imageでエラーが生じた場合に発生します。

構文

OG_Image_Export_Failure EXCEPTION;

エラー・コード	 102087


OG_Image_Import_Failure

  関連項目

説明	この例外は、イメージのインポート中に、OG_Import_Imageでエラーが生じた場合に発生します。

構文

OG_Image_Import_Failure EXCEPTION;

エラー・コード	 102093


OG_Incompatible_Pos_Dir

  関連項目

説明	この例外は、無効な軸の方向または位置を指定した場合に発生します。

構文

OG_Incompatible_Pos_Dir EXCEPTION;

エラー・コード	 102141


OG_Insert_Column_Failure

  関連項目

説明	この例外は、列を問合せに挿入しようとした場合に発生します。列は、カスタム問合せにのみ挿入できます。

構文

OG_Insert_Column_Failure EXCEPTION;

エラー・コード	 102168


OG_Internal_OG_Error

  関連項目

説明	この例外は、重大な内部エラーが生じた場合に発生します。サポート担当に連絡してください。

構文

OG_Internal_OG_Error EXCEPTION;

エラー・コード	 102000


OG_Internal_Tk_Error

  関連項目

説明	この例外は、重大な内部エラーが生じた場合に発生します。サポート担当に連絡してください。

構文

OG_Internal_Tk_Error EXCEPTION;

エラー・コード	 102001


OG_Invalid_Arc_Fill

  関連項目

説明	この例外は、円弧の設定時に、無効な値を使用した場合に発生します。

構文

OG_Invalid_Arc_Fill EXCEPTION;

エラー・コード	 102066


OG_Invalid_Arrowstyle

  関連項目

説明	この例外は、線の矢印の設定時に、無効な値を使用した場合に発生します。

構文

OG_Invalid_Arrowstyle EXCEPTION;

エラー・コード	 102022


OG_Invalid_Axis

  関連項目

説明	この例外は、無効な軸の値を指定した場合に発生します。有効な値は、OG_X_Axis、OG_Y1_AxisおよびOG_Y2_Axisのみです。

構文

OG_Invalid_Axis EXCEPTION;

エラー・コード	 102140


OG_Invalid_Axis_Handle

  関連項目

説明	この例外は、無効な軸ハンドルを参照しようとした場合に発生します。

構文

OG_Invalid_Axis_Handle EXCEPTION;

エラー・コード	 102122


OG_Invalid_Axis_Mapping

  関連項目

説明	この例外は、無効な軸のマッピングでチャートを更新しようとした場合に発生します。

構文

OG_Invalid_Axis_Mapping EXCEPTION;

エラー・コード	 102134


OG_Invalid_Baselinetype

  関連項目

説明	この例外は、無効な基本線タイプを指定した場合に発生します。

構文

OG_Invalid_Baselinetype EXCEPTION;

エラー・コード	 102132


OG_Invalid_Baseline_Value

  関連項目

説明	この例外は、無効な基本線の値を指定した場合に発生します。

構文

OG_Invalid_Baseline_Value EXCEPTION;

エラー・コード	 102153


OG_Invalid_Bbox

  関連項目

説明	この例外は、ビルトイン・プロシージャOG_Update_Bboxの引数which_bbox に対して無効な値を使用した場合に発生します。

構文

OG_Invalid_Bbox EXCEPTION;

エラー・コード	 102060


OG_Invalid_Buttonproc_Handle

  関連項目

説明	この例外は、プロシージャの引数として使用されたボタン・プロシージャ属性に、無効な値が含まれている場合に発生します。

構文

OG_Invalid_Buttonproc_Handle EXCEPTION;

エラー・コード	 102006


OG_Invalid_Cachetype

  関連項目

説明	この例外は、無効なキャッシュ・タイプを指定した場合に発生します。有効な値は、OG_Append_Cachetype、OG_Copy_CachetypeおよびOG_None_Cachetypeのみです。

構文

OG_Invalid_Cachetype EXCEPTION;

エラー・コード	 102170


OG_Invalid_Cap_Style

  関連項目

説明	この例外は、端形式に無効な値を指定した場合に発生します。

構文

OG_Invalid_Cap_Style EXCEPTION;

エラー・コード	 102018


OG_Invalid_Catwidth

  関連項目

説明	この例外は、無効な項目幅を指定した場合に発生します。

構文

OG_Invalid_Catwidth EXCEPTION;

エラー・コード	 102135


OG_Invalid_Chart_Creation_Attr

  関連項目

説明	この例外は、OG_Makeの引数として使用されたチャート結合属性レコードに、無効な属性が含まれている場合に発生します。チャートを最初に作成するとき、そのチャートに付加するテンプレートと問合せの両方を必ず指定してください。

構文

OG_Invalid_Chart_Creation_Attr EXCEPTION;

エラー・コード	 102054


OG_Invalid_Chart_Update_Mask

  関連項目

説明	この例外は、OG_Update_Chartの引数として使用されたマスク値が無効の場合に発生します。

構文

OG_Invalid_Chart_Update_Mask EXCEPTION;

エラー・コード	 102052


OG_Invalid_Child_Del_Total

  関連項目

説明	この例外は、削除する子の合計数を指定するOG_Delete_Childの引数として使用される値が、グループに実際に存在する子の数より大きい場合に発生します。

構文

OG_Invalid_Child_Del_Total EXCEPTION;

エラー・コード	 102032


OG_Invalid_Child_Index

  関連項目

説明	この例外は、OG_Delete_Child、OG_Get_ChildまたはOG_Insert_Childの引数として使用されている索引値が、グループ内の子数から1を引いた数より大きい場合に発生します。

構文

OG_Invalid_Child_Index EXCEPTION;

エラー・コード	 102031


OG_Invalid_Child_Object

  関連項目

説明	この例外は、OG_Insert_Childをコールして、なおかつchild_hdl引数を、グループに挿入できないオブジェクトになるように設定した場合に発生します。

構文

OG_Invalid_Child_Object EXCEPTION;

エラー・コード	 102116


OG_Invalid_Cmptext_Del_Total

  関連項目

説明	この例外は、削除する複数テキスト要素の合計数を指定するOG_Delete_Cmptext引数が、テキスト・オブジェクトに実際に存在する複数テキスト要素の数より大きい場合に発生します。

構文

OG_Invalid_Cmptext_Del_Total EXCEPTION;

エラー・コード	 102037


OG_Invalid_Cmptext_Index

  関連項目

説明	この例外は、指定した複数テキスト要素の索引値がテキスト・オブジェクト内の複数テキスト要素数から1を引いた数より大きい場合に発生します。

構文

OG_Invalid_Cmptext_Index EXCEPTION;

エラー・コード	 102036


OG_Invalid_Color_Name

  関連項目

説明	この例外は、カラー・プロパティのどれか1つに無効な値を指定した場合に発生します。

構文

OG_Invalid_Color_Name EXCEPTION;

エラー・コード	 102015


OG_Invalid_Column_Index

  関連項目

説明	この例外は、ビルトイン・ファンクションOG_Get_Schemaのcol_num引数に無効な値を指定した場合に発生します。

構文

OG_Invalid_Column_Index EXCEPTION;

エラー・コード	 102099


OG_Invalid_Column_Name

  関連項目

説明	この例外は、次の場合に発生します。

•	無効な列名を含むフィールド・レコードが、OG_Insert_Fieldによってチャートに挿入されており、さらにそのチャートが OG_Update_Chartのコールで更新された場合。

•	チャートのいずれか1つの要素の属性を設定するときに、無効な列名がOG_Set_Attrの引数として使用されており、さらにそのチャートが OG_Update_Chartのコールで更新された場合。

•	無効な列名が、OG_Get_Charcell、OG_Get_DatecellまたはOG_Get_Numcellの引数として使用されている場合。

構文

OG_Invalid_Column_Name EXCEPTION;

エラー・コード	 102044


OG_Invalid_Compression_Type

  関連項目

説明	この例外は、無効なイメージ圧縮定数を指定した場合に発生します。

構文

OG_Invalid_Compression_Type EXCEPTION;

エラー・コード	 102121


OG_Invalid_Cursor_Offset

  関連項目

説明	この例外は、OG_Start_Fromの引数として使用される値が指定された問合せの行数から1を引いた数より大きい場合に発生します。

構文

OG_Invalid_Cursor_Offset EXCEPTION;

エラー・コード	 102047


OG_Invalid_Curvefit

  関連項目

説明	この例外は、無効なカーブ調整タイプを指定した場合に発生します。

構文

OG_Invalid_Curvefit EXCEPTION;

エラー・コード	 102158


OG_Invalid_Dash_Style

  関連項目

説明	この例外は、OG_MakeまたはOG_Set_Attの引数として使用される属性レコードに、線種属性にとって無効な値が含まれている場合に発生します。

構文

OG_Invalid_Dash_Style EXCEPTION;

エラー・コード	 102019


OG_Invalid_Data_File

  関連項目

説明	この例外は、PRN、SYLKまたはWKSファイルをオープンまたは読込み中に、Graphics Builderでエラーが生じた場合に発生します。

構文

OG_Invalid_Data_File EXCEPTION;

エラー・コード	 102077


OG_Invalid_Data_Flag

  関連項目

説明	この例外は、無効なデータ・フラグを指定した場合に発生します。有効な値は、ビルトイン定数のOG_NewdataおよびOG_Olddataのみです。

構文

OG_Invalid_Data_Flag EXCEPTION;

エラー・コード	 102042


OG_Invalid_Data_Value

  関連項目

説明	この例外は、OG_Update_Chartをコールしたとき、チャート作成に使用された問合せに、無効のデータが含まれている場合に発生します(たとえば、チャート・タイプが円グラフで、問合せに負のデータが含まれる場合など)。

構文

OG_Invalid_Data_Value EXCEPTION;

エラー・コード	 102070


OG_Invalid_Date_Format

  関連項目

説明	この例外は、無効な日付書式を指定した場合に発生します。

構文

OG_Invalid_Date_Format EXCEPTION;

エラー・コード	 102108


OG_Invalid_Datevalue

  関連項目

説明	この例外は、無効なデータ値を指定した場合に発生します。

構文

OG_Invalid_Datevalue EXCEPTION;

エラー・コード	 102133


OG_Invalid_Depthsize

  関連項目

説明	この例外は、無効な深さサイズを指定した場合に発生します。

構文

OG_Invalid_Depthsize EXCEPTION;

エラー・コード	 102129


OG_Invalid_Direction

  関連項目

説明	この例外は、無効な軸方向を指定した場合に発生します。

構文

OG_Invalid_Direction EXCEPTION;

エラー・コード	 102143


OG_Invalid_Display_Handle

  関連項目

説明	この例外は、OG_Close_Displayの引数として無効な図表ハンドルが使用されている場合に発生します。

構文

OG_Invalid_Display_Handle EXCEPTION;

エラー・コード	 102011


OG_Invalid_Drawing_Format

  関連項目

説明	この例外は、ビルトイン・プロシージャOG_Export_DrawingまたはOG_Import_Drawingのformat 引数に無効な値を使用した場合に発生します。

構文

OG_Invalid_Drawing_Format EXCEPTION;

エラー・コード	 102089


OG_Invalid_External_Location

  関連項目

説明	この例外は、無効な位置を指定した場合に発生します。有効な値は、OG_DbおよびOG_Filesystemのみです。

構文

OG_Invalid_External_Location EXCEPTION;

エラー・コード	 102056


OG_Invalid_Event_Mask

  関連項目

説明	この例外は、イベント・プロパティに無効な値を指定した場合に発生します。

構文

OG_Invalid_Event_Mask EXCEPTION;

エラー・コード	 102058


OG_Invalid_Field_Datatype

  関連項目

説明	この例外は、OG_Update_Chartをコールしたとき、チャート作成に使用された問合せに、そのチャートにとって無効なデータ型が含まれている場合に発生します。たとえば、円グラフ・チャートの依存フィールドにCHAR型のデータは指定できません。CHAR型のデータがあると、この例外が発生します。

構文

OG_Invalid_Field_Datatype EXCEPTION;

エラー・コード	 102069


OG_Invalid_Field_Del_Total

  関連項目

説明	この例外は、チャートから削除するフィールドの合計数を指定するOG_Delete_Fieldの引数値が、チャートに実際に存在するフィールド数より大きい場合に発生します。

構文

OG_Invalid_Field_Del_Total EXCEPTION;

エラー・コード	 102041


OG_Invalid_Field_Index

  関連項目

説明	この例外は、OG_Delete_Field、OG_Get_FieldまたはOG_Insert_Fieldの引数として使用されている索引値が、チャートのフィールド数から1を引いた数より大きい場合に発生します。

構文

OG_Invalid_Field_Index EXCEPTION;

エラー・コード	 102040


OG_Invalid_Field_Template

  関連項目

説明	この例外は、無効なフィールド・テンプレート名を指定した場合に発生します。

構文

OG_Invalid_Field_Template EXCEPTION;

エラー・コード	 102067


OG_Invalid_Field_Type

  関連項目

説明	この例外は、無効なフィールド・タイプ値を含むフィールド・レコードが、OG_Insert_Fieldを使用してチャートに挿入され、さらにそのチャートがOG_Update_Chartのコールで更新された場合に発生します。有効なフィールド・タイプ値には、OG_DependentおよびOG_Independentも含まれます。

構文

OG_Invalid_Field_Type EXCEPTION;

エラー・コード	 102045


OG_Invalid_Ftemp_Del_Total

  関連項目

説明	この例外は、削除しようとしているフィールド・テンプレート数が、チャート・テンプレートに存在する数より多い場合に発生します。

構文

OG_Invalid_Ftemp_Del_Total EXCEPTION;

エラー・コード	 102125


OG_Invalid_Ftemp_Index

  関連項目

説明	この例外は、無効なフィールド・テンプレートをチャート・テンプレートから削除するように指定した場合に発生します。

構文

OG_Invalid_Ftemp_Index EXCEPTION;

エラー・コード	 102124


OG_Invalid_Gridct

  関連項目

説明	この例外は、無効な格子表示カウントを指定した場合に発生します。

構文

OG_Invalid_Gridct EXCEPTION;

エラー・コード	 102155


OG_Invalid_Image_Format

  関連項目

説明	この例外は、ビルトイン・プロシージャOG_Export_ImageまたはOG_Import_Imageのformat 引数に無効な値を使用した場合に発生します。

構文

OG_Invalid_Image_Format EXCEPTION;

エラー・コード	 102082


OG_Invalid_Join_Style

  関連項目

説明	この例外は、無効な結合形式を指定した場合に発生します。

構文

OG_Invalid_Join_Style EXCEPTION;

エラー・コード	 102017


OG_Invalid_Labelrot

  関連項目

説明	この例外は、無効なラベル回転を指定した場合に発生します。

構文

OG_Invalid_Labelrot EXCEPTION;

エラー・コード	 102150


OG_Invalid_Layer_Handle

  関連項目

説明	この例外は、OG_Activate_Layer、OG_Hide_LayerまたはOG_Show_Layerの引数として無効なレイヤー・ハンドルが使用された場合に発生します。

構文

OG_Invalid_Layer_Handle EXCEPTION;

エラー・コード	 102009


OG_Invalid_Linestyle

  関連項目

説明	この例外は、無効な線の形式を指定した場合に発生します。

構文

OG_Invalid_Linestyle EXCEPTION;

エラー・コード	 102159


OG_Invalid_Min_Max

  関連項目

説明	この例外は、無効な軸の最小値または最大値を指定した場合に発生します。

構文

OG_Invalid_Min_Max EXCEPTION;

エラー・コード	 102139


OG_Invalid_Minimum

  関連項目

説明	この例外は、無効な軸の最小値を指定した場合に発生します。

構文

OG_Invalid_Minimum EXCEPTION;

エラー・コード	 102154


OG_Invalid_Month

  関連項目

説明	この例外は、無効な月を指定した場合に発生します。

構文

OG_Invalid_Month EXCEPTION;

エラー・コード	 102149


OG_Invalid_Number_Format

  関連項目

説明	この例外は、無効な数値書式を指定した場合に発生します。

構文

OG_Invalid_Number_Format EXCEPTION;

エラー・コード	 102138


OG_Invalid_Object_Handle

  関連項目

説明	この例外は、サブプログラムの引数として無効なオブジェクト・ハンドルを指定した場合に発生します。

構文

OG_Invalid_Object_Handle EXCEPTION;

エラー・コード	 102003


OG_Invalid_Object_Type

  関連項目

説明	この例外は、OG_MakeまたはOG_Set_Attrの引数として使用された属性レコードに、そのオブジェクト・タイプ属性にとって無効な値が含まれている場合に発生します。

構文

OG_Invalid_Object_Type EXCEPTION;

エラー・コード	 102020


OG_Invalid_Overlap

  関連項目

説明	この例外は、無効なオーバーラップ値を指定した場合に発生します。

構文

OG_Invalid_Overlap EXCEPTION;

エラー・コード	 102152


OG_Invalid_Pattern_Name

  関連項目

説明	この例外は、無効なパターン名を指定した場合に発生します。

構文

OG_Invalid_Pattern_Name EXCEPTION;

エラー・コード	 102016


OG_Invalid_Pct_By

  関連項目

説明	この例外は、無効なパーセント元値を指定した場合に発生します。

構文

OG_Invalid_Pct_By EXCEPTION;

エラー・コード	 102148


OG_Invalid_Pct_Of

  関連項目

説明	この例外は、無効な表示値を指定した場合に発生します。

構文

OG_Invalid_Pct_Of EXCEPTION;

エラー・コード	 102147


OG_Invalid_Pie_Usage

  関連項目

説明	この例外は、無効な表示値を指定した場合に発生します。

構文

OG_Invalid_Pie_Usage EXCEPTION;

エラー・コード	 102136


OG_Invalid_Pie_Usagevalue

  関連項目

説明	この例外は、無効な使用値を指定した場合に発生します。

構文

OG_Invalid_Pie_Usagevalue EXCEPTION;

エラー・コード	 102137


OG_Invalid_Plotpos

  関連項目

説明	この例外は、無効な使用部分位置を指定した場合に発生します。

構文

OG_Invalid_Plotpos EXCEPTION;

エラー・コード	 102151


OG_Invalid_Point_Del_Total

  関連項目

説明	この例外は、削除するポイントの合計数を指定するOG_Delete_Pointの引数値が、削除するように最初に指定されたポイントを含めて、オブジェクトに実際に存在するポイント数より大きい場合に発生します。

構文

OG_Invalid_Point_Del_Total EXCEPTION;

エラー・コード	 102035


OG_Invalid_Point_Index

  関連項目

説明	この例外は、OG_Delete_Point、OG_Get_PointまたはOG_Insert_Pointの引数として使用された索引値が、オブジェクト内のポイント数から1を引いた数より大きい場合に発生します。

構文

OG_Invalid_Point_Index EXCEPTION;

エラー・コード	 102033


OG_Invalid_Position

  関連項目

説明	この例外は、無効な軸の位置を指定した場合に発生します。

構文

OG_Invalid_Position EXCEPTION;

エラー・コード	 102142


OG_Invalid_Prn_Format

  関連項目

説明	この例外は、PRNファイルを参照する問合せを実行したとき、そのファイルが有効なPRN形式ではなかった場合に発生します。

構文

OG_Invalid_Prn_Format EXCEPTION;

エラー・コード	 102079


OG_Invalid_Query_Handle

  関連項目

説明	この例外は、無効な問合せハンドルを指定した場合に発生します。

構文

OG_Invalid_Query_Handle EXCEPTION;

エラー・コード	 102004


OG_Invalid_Query_Source

  関連項目

説明	この例外は、問合せに対して無効なSQL文またはファイル名を指定した場合に発生します。

構文

OG_Invalid_Query_Source EXCEPTION;

エラー・コード	 102107


OG_Invalid_Query_Type

  関連項目

説明	この例外は、無効な問合せタイプを指定した場合に発生します。

構文

OG_Invalid_Query_Type EXCEPTION;

エラー・コード	 102109


OG_Invalid_Refline_Del_Total

  関連項目

説明	この例外は、削除しようとしている参照線の数が、チャート・テンプレートに存在する参照線の数より多い場合に発生します。

構文

OG_Invalid_Refline_Del_Total EXCEPTION;

エラー・コード	 102128


OG_Invalid_Refline_Index

  関連項目

説明	この例外は、無効な参照線を削除するように指定した場合に発生します。

構文

OG_Invalid_Refline_Index EXCEPTION;

エラー・コード	 102127


OG_Invalid_Refline_Handle

  関連項目

説明	この例外は、無効な参照線ハンドルを参照した場合に発生します。

構文

OG_Invalid_Refline_Handle EXCEPTION;

エラー・コード	 102123


OG_Invalid_Row_Number

  関連項目

説明	この例外は、チャートのいずれか1つの要素の属性を設定するときに、無効な列数がOG_Set_Attrの引数として使用され、さらにOG_Update_Chartのコールでチャートが更新された場合に発生します。

構文

OG_Invalid_Row_Number EXCEPTION;

エラー・コード	 102053


OG_Invalid_Scale

  関連項目

説明	この例外は、無効な目盛り値を指定した場合に発生します。

構文

OG_Invalid_Scale EXCEPTION;

エラー・コード	 102146


OG_Invalid_Shadowdir

  関連項目

説明	この例外は、無効なシャドウ方向を指定した場合に発生します。

構文

OG_Invalid_Shadowdir EXCEPTION;

エラー・コード	 102131


OG_Invalid_Shadowsize

  関連項目

説明	この例外は、無効なシャドウ・サイズを指定した場合に発生します。

構文

OG_Invalid_Shadowsize EXCEPTION;

エラー・コード	 102130


OG_Invalid_Smptext_Del_Total

  関連項目

説明	この例外は、削除する単一テキスト要素の合計数を指定するOG_Delete_Smptextの引数値が、複数テキスト要素に実際に存在する単一テキスト要素の数より大きい場合に発生します。

構文

OG_Invalid_Smptext_Del_Total EXCEPTION;

エラー・コード	 102039


OG_Invalid_Smptext_Index

  関連項目

説明	この例外は、OG_Delete_Smptext、OG_Get_SmptextまたはOG_Insert_Smptextの引数として使用されている索引値が、複数テキスト要素内の単一テキスト要素数から1を引いた数より大きい場合に発生します。

構文

OG_Invalid_Smptext_Index EXCEPTION;

エラー・コード	 102038


OG_Invalid_Sound_Format

  関連項目

説明	この例外は、無効なサウンド形式を指定した場合に発生します。

構文

OG_Invalid_Sound_Format EXCEPTION;

エラー・コード	 102084


OG_Invalid_Sound_Handle

  関連項目

説明	この例外は、OG_Play_Soundの引数として無効なサウンド・ハンドルが使用されている場合に発生します。

構文

OG_Invalid_Sound_Handle EXCEPTION;

エラー・コード	 102007


OG_Invalid_Step

  関連項目

説明	この例外は、無効なステップ値を指定した場合に発生します。

構文

OG_Invalid_Step EXCEPTION;

エラー・コード	 102145


OG_Invalid_Sylk_Format

  関連項目

説明	この例外は、SYLKファイルを参照する問合せを実行したとき、そのファイルが有効なSYLK形式でなかった場合に発生します。

構文

OG_Invalid_Sylk_Format EXCEPTION;

エラー・コード	 102078


OG_Invalid_Symbol_Index

  関連項目

説明	この例外は、無効な記号索引を指定した場合に発生します。

構文

OG_Invalid_Symbol_Index EXCEPTION;

エラー・コード	 102023


OG_Invalid_Symbol_Size

  関連項目

説明	この例外は、無効な記号サイズを指定した場合に発生します。

構文

OG_Invalid_Symbol_Size EXCEPTION;

エラー・コード	 102024


OG_Invalid_Template_Handle

  関連項目

説明	この例外は、無効なテンプレート・ハンドルを参照しようとした場合に発生します。

構文

OG_Invalid_Template_Handle EXCEPTION;

エラー・コード	 102005


OG_Invalid_Template_Type

  関連項目

説明	この例外は、無効なテンプレート・タイプを指定した場合に発生します。

構文

OG_Invalid_Template_Type EXCEPTION;

エラー・コード	 102126


OG_Invalid_Text_Horalign

  関連項目

説明	この例外は、無効な整列値を指定した場合に発生します。

構文

OG_Invalid_Text_Horalign EXCEPTION;

エラー・コード	 102026


OG_Invalid_Text_Horjust

  関連項目

説明	この例外は、無効な文字位置の値を指定した場合に発生します。

構文

OG_Invalid_Text_Horjust EXCEPTION;

エラー・コード	 102027


OG_Invalid_Text_Spacing

  関連項目

説明	この例外は、無効な間隔値を指定した場合に発生します。

構文

OG_Invalid_Text_Spacing EXCEPTION;

エラー・コード	 102025


OG_Invalid_Text_Vertalign

  関連項目

説明	この例外は、無効な整列値を指定した場合に発生します。

構文

OG_Invalid_Text_Vertalign EXCEPTION;

エラー・コード	 102028


OG_Invalid_Text_Vertjust

  関連項目

説明	この例外は、無効な文字位置の値を指定した場合に発生します。

構文

OG_Invalid_Text_Vertjust EXCEPTION;

エラー・コード	 102029


OG_Invalid_Tickpos

  関連項目

説明	この例外は、無効な目盛きざみ位置を指定した場合に発生します。

構文

OG_Invalid_Tickpos EXCEPTION;

エラー・コード	 102144


OG_Invalid_Timer_Handle

  関連項目

説明	この例外は、無効なタイマー・ハンドルを指定した場合に発生します。

構文

OG_Invalid_Timer_Handle EXCEPTION;

エラー・コード	 102010


OG_Invalid_Timer_Procedure

  関連項目

説明	この例外は、無効なトリガー・プロシージャを指定した場合に発生します。

構文

OG_Invalid_Timer_Procedure EXCEPTION;

エラー・コード	 102112


OG_Invalid_Timer_Interval

  関連項目

説明	この例外は、無効な時間間隔を指定した場合に発生します。

構文

OG_Invalid_Timer_Interval EXCEPTION;

エラー・コード	 102113


OG_Invalid_Transfer_Mode

  関連項目

説明	この例外は、無効な転送モードを指定した場合に発生します。

構文

OG_Invalid_Transfer_Mode EXCEPTION;

エラー・コード	 102057


OG_Invalid_Userexit_Invocation

  関連項目

説明	この例外は、Graphics Builderで指定されたユーザー・イグジットが起動されない場合に発生します。

構文

OG_Invalid_Userexit_Invocation EXCEPTION;

エラー・コード	 102048


OG_Invalid_Window_Dimensions

  関連項目

説明	この例外は、無効なウィンドウ・ディメンションを指定した場合に発生します。

構文

OG_Invalid_Window_Dimensions EXCEPTION;

エラー・コード	 102002


OG_Invalid_Window_Handle

  関連項目

説明	この例外は、サブプログラムの引数として無効なウィンドウ・ハンドルが使用された場合に発生します。

構文

OG_Invalid_Window_Handle EXCEPTION;

エラー・コード	 102008


OG_Invalid_Wks_Format

  関連項目

説明	この例外は、WKSファイルを参照する問合せを実行したとき、そのファイルが有効なWKS形式ではなかった場合に発生します。

構文

OG_Invalid_Wks_Format EXCEPTION;

エラー・コード	 102080


OG_Layer_Not_Child_Of_Root

  関連項目

説明	この例外は、OG_Makeの引数として使用された属性レコードに、親属性にとって無効な値が含まれている場合に発生します。

構文

OG_Layer_Not_Child_Of_Root EXCEPTION;

エラー・コード	 102012


OG_Login_Failure

  関連項目

説明	この例外は、OG_ConnectまたはOG_Logonを使用してデータベースに接続しようとして失敗した場合に発生します。

構文

OG_Login_Failure EXCEPTION;

エラー・コード	 102085


OG_Logoff_Disallowed

  関連項目

説明	この例外は、OG_Logoffをコールしたとき、図表にオープンSQLのカーソルが含まれているため、Graphics Builderでデータベースがクローズできない場合に発生します。

構文

OG_Logoff_Disallowed EXCEPTION;

エラー・コード	 102101


OG_Logon_Disallowed

  関連項目

説明	この例外は、OG_Logonをコールしたとき、図表にオープンSQLのカーソルが含まれているためGraphics Builderで前のデータベース接続がクローズできない場合に発生します。

構文

OG_Logon_Disallowed EXCEPTION;

エラー・コード	 102100


OG_Logoff_Failure

  関連項目

説明	この例外は、データベース接続のクローズ中に、OG_Logoffでエラーが生じた場合に発生します。

構文

OG_Logoff_Failure EXCEPTION;

エラー・コード	 102086


OG_Main_Window_Destruction

  関連項目

説明	この例外は、メイン図表ウィンドウがOG_Destroyの引数として使用された場合に発生します。メイン・ウィンドウを破棄せずにクローズするには、OG_Hide_Windowを使用します。

構文

OG_Main_Window_Destruction EXCEPTION;

エラー・コード	 102046


OG_Missing_Chart_Field

  関連項目

説明	この例外は、OG_Update_Chartをコールしたとき、チャート作成に使用された問合せに、そのチャートが必要とする1つまたは複数のフィールドが含まれていなかった場合に発生します。たとえば、ENAME、SALおよびCOMMの値を取り込むためのチャートを作成したとき、問合せがENAMEとSALの値のみを戻した場合などです。

構文

OG_Missing_Chart_Field EXCEPTION;

エラー・コード	 102068


OG_No_Chart_Data

  関連項目

説明	この例外は、OG_Update_Chartをコールしたとき、そのチャートに関連付けられた問合せがまだ実行されていなかった場合に発生します。

構文

OG_No_Chart_Data EXCEPTION;

エラー・コード	 102114


OG_No_Database_Connection

  関連項目

説明	この例外は、アクセスしようとしたデータベースが、まだ正常に接続されていなかった場合に発生します。OG_Execute_QueryまたはOG_Open_Displayで実行されている可能性があります。

構文

OG_No_Database_Connection EXCEPTION;

エラー・コード	 102055


OG_No_Dependent_Fields

  関連項目

説明	この例外は、依存フィールドを1つも含まないチャートを更新しようとした場合に発生します。

構文

OG_No_Dependent_Fields EXCEPTION;

エラー・コード	 102072


OG_No_Independent_Fields

  関連項目

説明	この例外は、独立フィールドを1つも含まないチャートを更新しようとした場合に発生します。

構文

OG_No_Independent_Fields EXCEPTION;

エラー・コード	 102186


OG_No_Query_Name

  関連項目

説明	この例外は、無効な問合せ名を指定した場合に発生します。

構文

OG_No_Query_Name EXCEPTION;

エラー・コード	 102173


OG_No_Schema

  関連項目

説明	この例外は、スキーマがないカスタム問合せを実行しようとした場合に発生します。

構文

OG_No_Schema EXCEPTION;

エラー・コード	 102165


OG_Not_Chart_Element

  関連項目

説明	この例外は、オブジェクトをチャート要素として扱おうとしたとき、そのオブジェクトが実際はチャート要素ではない場合に発生します。

構文

OG_Not_Chart_Element EXCEPTION;

エラー・コード	 102184


OG_Not_Supported_In_Designer

  関連項目

説明	この例外は、Graphics Builderに適用できないPL/SQL文を実行しようとした場合に発生します。PL/SQL文は、ランタイムのみで実行してください。

構文

OG_Not_Supported_In_Designer EXCEPTION;

エラー・コード	 102183


OG_Sound_Conversion_Failure

  関連項目

説明	この例外は、サウンドをインポートしようとしたとき、Graphics Builderがサウンドの元のサンプリング・レートまたはコード化方式から変換できなかった場合に発生します。通常、これはサウンドが大きすぎることを意味します。

構文

OG_Sound_Conversion_Failure EXCEPTION;

エラー・コード	 102120


OG_No_Sound_Input_Device

  関連項目

説明	この例外は、サウンドを再生しようとしてOG_Play_Soundを使用したとき、再生用のサウンド出力デバイスがない場合に発生します。

構文

OG_No_Sound_Input_Device EXCEPTION;

エラー・コード	 102118


OG_No_Sound_Output_Device

  関連項目

説明	この例外は、サウンドを記録しようとしてOG_Record_Soundを使用したとき、記録用のサウンド入力デバイスがない場合に発生します。

構文

OG_No_Sound_Output_Device EXCEPTION;

エラー・コード	 102117


OG_Not_Chart_Object

  関連項目

説明	この例外は、チャート内で操作するビルトイン・サブプログラムをコールしたとき、そのサブプログラムに渡した引数がチャート・オブジェクトにとって無効なハンドルだった場合に発生します。

構文

OG_Not_Chart_Object EXCEPTION;

エラー・コード	 102061


OG_Not_Group_Object

  関連項目

説明	この例外は、グループ内で操作するビルトイン・サブプログラムをコールしたとき、そのサブプログラムに渡した引数がグループ・オブジェクトにとって無効なハンドルだった場合に発生します。

構文

OG_Not_Group_Object EXCEPTION;

エラー・コード	 102062


OG_Not_Image_Object

  関連項目

説明	この例外は、イメージ内で操作するビルトイン・サブプログラムをコールしたとき、そのサブプログラムに渡した引数がイメージ・オブジェクトにとって無効なハンドルだった場合に発生します。

構文

OG_Not_Image_Object EXCEPTION;

エラー・コード	 102064


OG_Not_Polygon_Object

  関連項目

説明	この例外は、折れ線または多角形内で操作するビルトイン・サブプログラムをコールしたとき、そのサブプログラムに渡した引数が折れ線または多角形オブジェクトにとって無効なハンドルだった場合に発生します。

構文

OG_Not_Polygon_Object EXCEPTION;

エラー・コード	 102063


OG_Not_Text_Object

  関連項目

説明	この例外は、テキスト・オブジェクト内で操作するビルトイン・サブプログラムをコールしたとき、そのサブプログラムに渡した引数がテキスト・オブジェクトにとって無効なハンドルだった場合に発生します。

構文

OG_Not_Text_Object EXCEPTION;

エラー・コード	 102065


OG_Null_Chart_Element

  関連項目

説明	この例外は、OG_Get_Chart_Elementをコールしたとき、そのチャート要素がNULLだった場合に発生します。

構文

OG_Null_Chart_Element EXCEPTION;

エラー・コード	 102187


OG_Null_Module_Name

  関連項目

説明	この例外は、ファイル・システムまたはデータベースからモジュールをエクスポート、インポートまたはオープンするビルトイン・サブプログラムの引数としてNULLモジュール名を指定した場合に発生します。

構文

OG_Null_Module_Name EXCEPTION;

エラー・コード	 102110


OG_Open_Display_Failure

  関連項目

説明	この例外は、図表をオープンしようとしたとき、OG_Open_Displayでエラーが生じた場合に発生します。

構文

OG_Open_Display_Failure EXCEPTION;

エラー・コード	 102030


OG_Parent_Not_Group

  関連項目

説明	この例外は、OG_Makeの引数として使用されている属性レコード内の親属性に、有効なグループ・オブジェクトのハンドルがない場合に発生します。

構文

OG_Parent_Not_Group EXCEPTION;

エラー・コード	 102014


OG_Pctchart_Zero

  関連項目

説明	この例外は、チャートに対して無効なパーセント基準値を指定した場合に発生します。

構文

OG_Pctchart_Zero EXCEPTION;

エラー・コード	 102071


OG_Piechart_Sum_Overflow

  関連項目

説明	この例外は、問合せで戻された実際のデータ合計数より小さい「合計値」を(「円グラフ枠」プロパティ・シートにおいて)指定して円グラフ・チャートを更新した場合に発生します。

構文

OG_Piechart_Sum_Overflow EXCEPTION;

エラー・コード	 102073


OG_Print_Failure

  関連項目

説明	この例外は、図表の印刷中に、Graphics Builderでエラーが生じた場合に発生します。

構文

OG_Print_Failure EXCEPTION;

エラー・コード	 102111


OG_Query_Execution_Error

  関連項目

説明	この例外は、問合せの実行中に、Graphics Builderでエラーが生じた場合に発生します。

構文

OG_Query_Execution_Error EXCEPTION;

エラー・コード	 102075


OG_Recursive_Chart_Update

  関連項目

説明	この例外は、チャートを更新するプロセスにおいて、同じチャートを明示的に更新するトリガーが起動された場合に発生します。

構文

OG_Recursive_Chart_Update EXCEPTION;

エラー・コード	 102185


OG_Root_Object_Destruction

  関連項目

説明	この例外は、OG_Destroyの引数として使用されたオブジェクトが、レイアウト・グループ・ツリーのルート・オブジェクトの場合に発生します。

構文

OG_Root_Object_Destruction EXCEPTION;

エラー・コード	 102021


OG_Row_Retrieval_Failure

  関連項目

説明	この例外は、OG_Get_Charcell、OG_Get_DatecellまたはOG_Get_Numcellが、データの現在行の検索に失敗した場合に発生します。

構文

OG_Row_Retrieval_Failure EXCEPTION;

エラー・コード	 102081


OG_Save_Display_Failure

  関連項目

説明	この例外は、図表の保存中に、OG_Save_Displayでエラーが生じた場合に発生します。

構文

OG_Save_Display_Failure EXCEPTION;

エラー・コード	 102104


OG_Set_Object_Prop_Failure

  関連項目

説明	この例外は、オブジェクト・プロパティの設定中にエラーが生じた場合に発生します。

構文

OG_Set_Object_Prop_Failure EXCEPTION;

エラー・コード	 102162


OG_Set_Param_Error

  関連項目

説明	この例外は、パラメータの設定中にエラーが生じた場合に発生します。

構文

OG_Set_Param_Error EXCEPTION;

エラー・コード	 102174


OG_Set_Printer_Failure

  関連項目

説明	この例外は、プリンタ名の設定中にエラーが生じた場合に発生します。

構文

OG_Set_Printer_Failure EXCEPTION;

エラー・コード	 102161


OG_Set_Property_Error

  関連項目

説明	この例外は、オブジェクト・プロパティの設定中にエラーが生じた場合に発生します。

構文

OG_Set_Property_Error EXCEPTION;

エラー・コード	 102180


OG_Sound_Export_Failure

  関連項目

説明	この例外は、サウンドのエクスポート中に、OG_Export_Soundでエラーが生じた場合に発生します。

構文

OG_Sound_Export_Failure EXCEPTION;

エラー・コード	 102088


OG_Sound_Import_Failure

  関連項目

説明	この例外は、サウンドのインポート中に、OG_Import_Soundでエラーが生じた場合に発生します。

構文

OG_Sound_Import_Failure EXCEPTION;

エラー・コード	 102094


OG_Sql_Execution_Error

  関連項目

説明	この例外は、SQL文で作成された問合せの実行中に、Graphics Builderでエラーが生じた場合に発生します。

構文

OG_Sql_Execution_Error EXCEPTION;

エラー・コード	 102076


OG_Template_Export_Failure

  関連項目

説明	この例外は、テンプレートのエクスポート中に、OG_Export_Templateでエラーが生じた場合に発生します。

構文

OG_Template_Export_Failure EXCEPTION;

エラー・コード	 102092


OG_Template_Import_Failure

  関連項目

説明	この例外は、テンプレートのインポート中に、OG_Import_Templateでエラーが生じた場合に発生します。

構文

OG_Template_Import_Failure EXCEPTION;

エラー・コード	 102096


OG_Too_Many_Data_Rows

  関連項目

説明	この例外は、実行した問合せに対して戻される行数が、Graphics Builderの処理限度を超えている場合に発生します。

構文

OG_Too_Many_Data_Rows EXCEPTION;

エラー・コード	 102119


OG_Undefined_Param

  関連項目

説明	この例外は、未定義のパラメータを参照しようとした場合に発生します。

構文

OG_Undefined_Param EXCEPTION;

エラー・コード	 102178


OG_Undefined_Property

  関連項目

説明	この例外は、未定義のオブジェクト・プロパティを参照しようとした場合に発生します。

構文

OG_Undefined_Property EXCEPTION;

エラー・コード	 102182


OG_Userexit_Failure_Error

  関連項目

説明	この例外は、ユーザー・イグジットが、対応するエラー・コードをGraphics Builderに戻した場合に発生します。

構文

OG_Userexit_Failure_Error EXCEPTION;

エラー・コード	 102049


OG_Userexit_Fatal_Error

  関連項目

説明	この例外は、ユーザー・イグジットが、対応するエラー・コードをGraphics Builderに戻した場合に発生します。

構文

OG_Userexit_Fatal_Error EXCEPTION;

エラー・コード	 102050


OG_Userexit_Unknown_Error

  関連項目

説明	この例外は、ユーザー・イグジットが、不明のエラー・コードをGraphics Builderに戻した場合に発生します。

構文

OG_Userexit_Unknown_Error EXCEPTION;

エラー・コード	 102051


Tool_Int.Duplicate_Parameter_Key

  関連項目

説明	この例外は、パラメータをパラメータ・リストに追加しようとしたとき、同じ名前のパラメータがすでに定義されている場合に発生します。

構文

Tool_Int.Duplicate_Parameter_Key EXCEPTION;

エラー・コード	 104508


Tool_Int.Duplicate_Parameter_List_Name

  関連項目

説明	この例外は、作成しようとしたパラメータ・リスト名が、すでに別のパラメータ・リストに使用されている場合に発生します。

構文

Tool_Int.Duplicate_Parameter_List_Name EXCEPTION;

エラー・コード	 104504


Tool_Int.Internal_Tools_Error

  関連項目

説明	この例外は、重大な内部エラーが生じた場合に発生します。サポート担当に連絡してください。

構文

Tool_Int.Internal_Tools_Error EXCEPTION;

エラー・コード	 104500


Tool_Int.Invalid_Communication_Mode

  関連項目

説明	この例外は、無効な通信モードを使用してTool_Int.Run_Productをコールしようとした場合に発生します。有効な値は、パッケージ定数のTool_Int.SynchronousおよびTool_Int.Asynchronousのみです。

構文

Tool_Int.Invalid_Communication_Mode EXCEPTION;

エラー・コード	 104511


Tool_Int.Invalid_Execution_Mode

  関連項目

説明	この例外は、無効な実行モードを使用してTool_Int.Run_Productをコールしようとした場合に発生します。有効な値は、パッケージ定数のTool_Int.BatchおよびTool_Int.Runtimeのみです。

構文

Tool_Int.Invalid_Execution_Mode EXCEPTION;

エラー・コード	 1045010


Tool_Int.Invalid_Location

  関連項目

説明	この例外は、指定されたモジュールに対して無効な位置でTool_Int.Run_Productをコールしようとした場合に発生します。有効な値は、パッケージ定数のTool_Int.DbおよびTool_Int.Filesystemのみです。

構文

Tool_Int.Invalid_Location EXCEPTION;

エラー・コード	 104503


Tool_Int.Invalid_Parameter_List_Handle

  関連項目

説明	この例外は、無効なパラメータ・リスト・ハンドルを参照しようとした場合に発生します。

構文

Tool_Int.Invalid_Parameter_List_Handle EXCEPTION;

エラー・コード	 104506


Tool_Int.Invalid_Parameter_Key

  関連項目

説明	この例外は、無効な名前を使用して、パラメータを参照しようとした場合に発生します。

構文

Tool_Int.Invalid_Parameter_Key EXCEPTION;

エラー・コード	 104507


Tool_Int.Invalid_Parameter_List_Name

  関連項目

説明	この例外は、無効な名前を使用して、パラメータを参照しようとした場合に発生します。

構文

Tool_Int.Invalid_Parameter_List_Name EXCEPTION;

エラー・コード	 104505


Tool_Int.Invalid_Parameter_Type

  関連項目

説明	この例外は、パラメータ・タイプを、CHAR、DATEまたはNUMBER以外の型に設定しようとした場合に発生します。

構文

Tool_Int.Invalid_Parameter_Type EXCEPTION;

エラー・コード	 104501


Tool_Int.Invalid_Product

  関連項目

説明	この例外は、無効な製品を指定して、Tool_Int.Run_Productをコールしようとした場合に発生します。有効な値は、パッケージ定数のTool_Int.FormsおよびTool_Int.Reportsのみです。

構文

Tool_Int.Invalid_Product EXCEPTION;

エラー・コード	 104502


Tool_Int.run_product_failure

  関連項目

説明	この例外は、Graphics Builderで、Tool_Int.Run_Productのコールで指定された製品が実行されない場合に発生します。Graphics Builderとともに使用する別の製品の設定については、使用しているオペレーティング・システムのGraphics Builderマニュアルまたは該当する製品のマニュアルを参照してください。

構文

Tool_Int..Run_Product_Failure EXCEPTION;

エラー・コード	 104509


PL/SQLビルトイン例外について

ここでは、Graphics Builderのビルトイン例外について説明します。最初にそれらのエラー・コードの一覧が示され、続いて各例外の詳細が説明されています。それぞれの例外について、構文、説明およびエラー・メッセージが挙げられています。

例外を処理しなければ、例外が発生するたびに画面の実行が一時的に停止し、エラー・メッセージが表示されます。表示されたメッセージで「OK」を選択すると、再び画面の実行が開始されます。

例外の有効範囲規則と通知の詳細は、『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください。


例外（エラー・コード順）

説明

エラー・コード	例外名
102000	OG_Internal_OG_Error
102001	OG_Internal_Tk_Error
102002	OG_Invalid_Window_Dimensions
102003	OG_Invalid_Object_Handle
102004	OG_Invalid_Query_Handle
102005	OG_Invalid_Template_Handle
102006	OG_Invalid_Buttonproc_Handle
102007	OG_Invalid_Sound_Handle
102008	OG_Invalid_Window_Handle
102009	OG_Invalid_Layer_Handle
102010	OG_Invalid_Timer_Handle
102011	OG_Invalid_Display_Handle
102012	OG_Layer_Not_Child_Of_Root
102013	OG_Hide_Active_Layer
102014	OG_Parent_Not_Group
102015	OG_Invalid_Color_Name
102016	OG_Invalid_Pattern_Name
102017	OG_Invalid_Join_Style
102018	OG_Invalid_Cap_Style
102019	OG_Invalid_Dash_Style
102020	OG_Invalid_Object_Type
102021	OG_Root_Object_Destruction
102022	OG_Invalid_Arrowstyle
102023	OG_Invalid_Symbol_Index
102024	OG_Invalid_Symbol_Size
102025	OG_Invalid_Text_Spacing
102026	OG_Invalid_Text_Horalign
102027	OG_Invalid_Text_Horjust
102028	OG_Invalid_Text_Vertalign
102029	OG_Invalid_Text_Vertjust
102030	OG_Open_Display_Failure
102031	OG_Invalid_Child_Index
102032	OG_Invalid_Child_Del_Total
102033	OG_Invalid_Point_Index
102034	OG_Active_Layer_Del
102035	OG_Invalid_Point_Del_Total
102036	OG_Invalid_Cmptext_Index
102037	OG_Invalid_Cmptext_Del_Total
102038	OG_Invalid_Smptext_Index
102039	OG_Invalid_Smptext_Del_Total
102040	OG_Invalid_Field_Index
102041	OG_Invalid_Field_Del_Total
102042	OG_Invalid_Data_Flag
102043	OG_Column_Type_Mismatch
102044	OG_Invalid_Column_Name
102045	OG_Invalid_Field_Type
102046	OG_Main_Window_Destruction
102047	OG_Invalid_Cursor_Offset
102048	OG_Invalid_Userexit_Invocation
102049	OG_Userexit_Failure_Error
102050	OG_Userexit_Fatal_Error
102051	OG_Userexit_Unknown_Error
102052	OG_Invalid_Chart_Update_Mask
102053	OG_Invalid_Row_Number
102054	OG_Invalid_Chart_Creation_Attr
102055	OG_No_Database_Connection
102056	OG_Invalid_External_Location
102057	OG_Invalid_Transfer_Mode
102058	OG_Invalid_Event_Mask
102059	OG_Host_Failure_Error
102060	OG_Invalid_Bbox
102061	OG_Not_Chart_Object
102062	OG_Not_Group_Object
102063	OG_Not_Polygon_Object
102064	OG_Not_Image_Object
102065	OG_Not_Text_Object
102066	OG_Invalid_Arc_Fill
102067	OG_Invalid_Field_Template
102068	OG_Missing_Chart_Field
102069	OG_Invalid_Field_Datatype
102070	OG_Invalid_Data_Value
102071	OG_Pctchart_Zero
102072	OG_No_Dependent_Fields
102073	OG_Piechart_Sum_Overflow
102074	OG_Date_Overflow
102075	OG_Query_Execution_Error
102076	OG_Sql_Execution_Error
102077	OG_Invalid_Data_File
102078	OG_Invalid_Sylk_Format
102079	OG_Invalid_Prn_Format
102080	OG_Invalid_Wks_Format
102081	OG_Row_Retrieval_Failure
102082	OG_Invalid_Image_Format
102083	OG_Image_Creation_Failure
102084	OG_Invalid_Sound_Format
102085	OG_Login_Failure
102086	OG_Logoff_Failure
102087	OG_Image_Export_Failure
102088	OG_Sound_Export_Failure
102089	OG_Invalid_Drawing_Format
102091	OG_Drawing_Export_Failure
102092	OG_Template_Export_Failure
102093	OG_Image_Import_Failure
102094	OG_Sound_Import_Failure
102095	OG_Drawing_Import_Failure
102096	OG_Template_Import_Failure
102097	OG_Colors_Not_Writable
102098	OG_Font_Not_Found
102099	OG_Invalid_Column_Index
102100	OG_Logon_Disallowed
102101	OG_Logoff_Disallowed
102102	OG_Env_Var_Error
102103	OG_Env_Var_Notfound
102104	OG_Save_Display_Failure
102105	OG_Generate_Display_Failure
102106	OG_Duplicate_Display_Name
102107	OG_Invalid_Query_Source
102108	OG_Invalid_Date_Format
102109	OG_Invalid_Query_Type
102110	OG_Null_Module_Name
102111	OG_Print_Failure
102112	OG_Invalid_Timer_Procedure
102113	OG_Invalid_Timer_Interval
102114	OG_No_Chart_Data
102115	OG_Display_Closed
102116	OG_Invalid_Child_Object
102117	OG_No_Sound_Output_Device
102118	OG_No_Sound_Input_Device
102119	OG_Too_Many_Data_Rows
102120	OG_Sound_Conversion_Failure
102121	OG_Invalid_Compression_Type
102122	OG_Invalid_Axis_Handle
102123	OG_Invalid_Refline_Handle
102124	OG_Invalid_Ftemp_Index
102125	OG_Invalid_Ftemp_Del_Total
102126	OG_Invalid_Template_Type
102127	OG_Invalid_Refline_Index
102128	OG_Invalid_Refline_Del_Total
102129	OG_Invalid_Invalid_Depthsize
102130	OG_Invalid_Shadowsize
102131	OG_Invalid_Shadowdir
102132	OG_Invalid_Baselinetype
102133	OG_Invalid_Datevalue
102134	OG_Invalid_Axis_Mapping
102135	OG_Invalid_Catwidth
102136	OG_Invalid_Pie_Usage
102137	OG_Invalid_Pie_Usagevalue
102138	OG_Invalid_Number_Format
102139	OG_Invalid_Min_Max
102140	OG_Invalid_Axistype
102141	OG_Incompatible_Pos_Dir
102142	OG_Invalid_Position
102143	OG_Invalid_Direction
102144	OG_Invalid_Tickpos
102145	OG_Invalid_Step
102146	OG_Invalid_Scale
102147	OG_Invalid_Pct_Of
102148	OG_Invalid_Pct_By
102149	OG_Invalid_Month
102150	OG_Invalid_Labelrot
102151	OG_Invalid_Plotpos
102152	OG_Invalid_Overlap
102153	OG_Invalid_Baseline_Value
102154	OG_Invalid_Minimum
102155	OG_Invalid_Gridct
102156	OG_Duplicate_Ftemp_Name
102157	OG_Duplicate_Template_Name
102158	OG_Invalid_Curvefit
102159	OG_Invalid_Linestyle
102160	OG_Get_Printer_Failure
102161	OG_Set_Printer_Failure
102162	OG_Set_Object_Prop_Failure
102163	OG_Get_Object_Prop_Failure
102164	OG_Delete_Object_Prop_Failure
102165	OG_No_Schema
102166	OG_Get_Append_Failure
102167	OG_Column_Not_Settable
102168	OG_Insert_Column_Failure
102169	OG_Delete_Column_Failure
102170	OG_Invalid_Cachetype
102171	OG_Duplicate_Query_Name
102172	OG_Duplicate_Column_Name
102173	OG_No_Query_Name
102174	OG_Set_Param_Error
102175	OG_Get_Param_Error
102176	OG_Delete_Param_Error
102178	OG_Undefined_Param
102179	OG_Get_Property_Error
102180	OG_Set_Property_Error
102181	OG_Delete_Property_Error
102182	OG_Undefined_Property
102183	OG_Not_Supported_In_Designer
102184	OG_Not_Chart_Element
102185	OG_Recursive_Chart_Update
102186	OG_No_Independent_Fields
102187	OG_Null_Chart_Element
104500	Tool_Int.Internal_Tools_Error
104501	Tool_Int.Invalid_Parameter_Type
104502	Tool_Int.Invalid_Product
104503	Tool_Int.Invalid_Location
104504	Tool_Int.Duplicate_Parameter_List_Name
104505	Tool_Int.Invalid_Parameter_List_Name
104506	Tool_Int.Invalid_Parameter_List_Handle
104507	Tool_Int.Invalid_Parameter_Key
104508	Tool_Int.Duplicate_Parameter_Key
104509	Tool_Int.Run_Product_Failure
104510	Tool_Int.Invalid_Execution_Mode
104511	Tool_Int.Invalid_Communication_Mode


ビルトイン・データ型

OG_Arc

OG_Axis

OG_Buttonproc

OG_Colschema

OG_Display

OG_Event

OG_Field

OG_Ftemp

OG_Layer

OG_Object

OG_Point

OG_Query

OG_Rectangle

OG_Refline

OG_Sound

OG_Template

OG_Timer

OG_Window

TOOLINTPARAMATTR

TOOLINTPARAMLIST


 OG_Arc

説明	円弧のパスを定義します。このデータ型は次のように定義されたレコードです。

構文

TYPE OG_Arc IS RECORD
(x       NUMBER(10,0),
 y       NUMBER(10,0),
 height  NUMBER(10,0),
 width   NUMBER(10,0),
 sangle  NUMBER(5,0),
 eangle  NUMBER(5,0)
);

パラメータの内容は次のとおりです。 x	円弧の基になる四角形（つまり、円弧の4つの制御ポイントに接する四角形）の左上角のx座標（レイアウト単位）。
y	円弧の基になる四角形の左上のy座標（レイアウト単位）。
height	円弧の基になる四角形の高さ（レイアウト単位）。
width	円弧の基になる四角形の幅（レイアウト単位）。
sangle	円弧の開始角度。
eangle	円弧の終了角度。


 OG_Axis

説明	チャート軸のハンドル。


 OG_Buttonproc

説明	ボタン・プロシージャのハンドル。


OG_Colschema

説明	問合せの列のスキーマを記述します。このデータ型は次のように定義されたレコードです。

構文

TYPE OG_Colschema IS RECORD
(colname     VARCHAR2(255),
 coltype     NUMBER(3,0),
 not_null    BOOLEAN,
 precision   NUMBER(3,0),
 scale       NUMBER(3,0),
 maxlen      NUMBER(10,0),
 dateformat  VARCHAR2(255)
);

パラメータの内容は次のとおりです。 colname	列名。
coltype	列タイプ。このレコード・フィールドに指定できるビルトイン定数は次のとおりです。 OG_Char_Coltype　列タイプが CHAR、VARCHAR2またはROWID であることを表します。 OG_Number_Coltype　列タイプが NUMBERであることを表します。 OG_Long_Coltype　列タイプが LONGであることを表します。 OG_Date_Coltype　列タイプが DATEであることを表します。 OG_Raw_Coltype　列タイプがRAWであることを表します。 OG_Longraw_Coltype　列タイプが LONGRAWであることを表します。 OG_Mlslabel_Coltype　列タイプが MLSLABELであることを表します。
not_null	列にNOT NULL制約を設定するかどうかを指定します。このレコード・フィールドに指定できる値は次のいずれかです。 TRUE　列にNOT NULL制約が設定されます。 FALSE　列にNOT NULL制約は設定されません。
precision	NUMBERタイプの列用の精度値セットの詳細は、『Oracle7 Server SQL 言語リファレンス』を参照してください。このレコード・フィールドは、データ ベースからのSQL問合せ専用です。
scale	NUMBERタイプの列用のスケール値セット。詳細は、『Oracle7 Server SQL言語リファレンス』を参照してください。このレコード・フィールドは、データ ベースからのSQL問合せ専用です。
maxlen	列に入力できるデータの最大長（単位： バイト）。詳細は、『Oracle7 Server SQL 言語リファレンス』を参照してください。
dateformat	列の値が日付のときに使用される日付書式マスク。


 OG_Display

説明	画面のハンドル


OG_Event

説明	ボタン・プロシージャを起動したマウス・イベントに関する情報を記述します。このデータ型は次のように定義されたレコードです。

構文

TYPE OG_Event IS RECORD
(event_type      NUMBER(1,0),
 mouse_position  OG_Point,
 click_count     NUMBER(5,0),
 constrained     BOOLEAN,
 mouse_button    NUMBER(1,0)
);

パラメータの内容は次のとおりです。 event_type	ボタン・プロシージャで受信されたマウス・イベントのタイプ。このレコード・フィールドに指定できるビルトイン定数は次のとおりです。 OG_Mouse_Down　マウスを押すイベントをプロシージャが受信したことを表します。 OG_Mouse_Move_Down　マウスを押したままマウスを移動するイベントをプロシージャが受信したことを表します。 OG_Mouse_Up　マウスを放すイベントをプロシージャが受信したことを表します。 OG_Mouse_Move_Up　マウスを押さずにマウスを移動するイベントをプロシージャが受信したことを表します。
mouse_position	イベントが受信されたときの、レイアウト上のマウス位置のx座標とy座標。
click_count	マウスを押すイベントの場合に、マウスでの選択が検出された回数。注意: ダブルクリックが検出されると、このプロシージャは、ダブルクリックを構成するすべてのイベント、つまり、最初に1回目のクリックとなるマウスを押すイベント、次にマウスを放すイベント、さらに2回目のクリックとなるマウスを押すイベント、最後にもう1回マウスをはなすイベントを受けとります。プロシージャのロジックを定義するときは、この点に留意してください。
constrained	シフト・キーを押しているかどうかを指定します。このレコード・フィールドに指定できる値は次のいずれかです。 TRUE　シフト・キーが押されていることを表します。 FALSE　シフト・キーが押されていないことを表します。
mouse_button	どのボタンが押されているか示します。このレコード・フィールドに指定できる値は次のいずれかです。 OG_Left_Mouse_Button OG_Center_Mouse_Button OG_Right_Mouse_Button


OG_Field

説明	チャート内のフィールド・プロパティを指定します。このデータ型は次のように定義されたレコードです。

構文

TYPE OG_Field IS RECORD
(field_type  NUMBER(1,0),
 colname     VARCHAR2(255),
 ftname      VARCHAR2(255)
);

パラメータの内容は次のとおりです。 field_type	フィールド・タイプ。このレコード・フィールドに指定できるビルトイン定数は次のとおりです。 OG_Category　フィールドがチャートに項目として表示されていることを表します。 OG_Dependent　OG_Valueと同義です。 OG_Subcategory　フィールドがブレーク・チャートでサブ項目として使用されていることを表します。 OG_Independent　OG_Categoryと同義です。 OG_Value　フィールドがチャートに値として表示されていることを表します。
colname	このフィールドがチャート上に表示するチャート問合せの列名。
ftname	フィールドに関連付けられたフィールド・テンプレート名。ただし、フィールド・テンプレートを項目に関連付けても意味がありません。このようなフィールドを定義するときは、項目にテンプレートを割り当てないでください。


OG_Ftemp

説明	フィールド・テンプレートのハンドル


OG_Layer

説明	レイヤーのハンドル


OG_Object

説明	グラフィック・オブジェクトのハンドル


OG_Point

説明	座標やサイズに必要な、xとyの値を指定します。このデータ型は次のように定義されたレコードです。

構文

TYPE OG_Point IS RECORD
(x  NUMBER(10,0),
 y  NUMBER(10,0)
);

パラメータの内容は次のとおりです。 x	x成分の値。通常、この値はレイアウト上の単位で表します。
y	y成分の値。通常、この値はレイアウト上の単位で表します。


OG_Query

説明	問合せのハンドル


 OG_Rectangle

説明	四角形の領域を定義します。このデータ型は次のように定義されたレコードです。

構文

TYPE OG_Rectangle IS RECORD
(x       NUMBER(10,0),
 y       NUMBER(10,0),
 height  NUMBER(10,0),
 width   NUMBER(10,0)
);

パラメータの内容は次のとおりです。 x	四角形の左上角のx座標（レイアウト単位）。
y	四角形の左上角のy座標（レイアウト単位）。
height	四角形の高さ（レイアウト単位）。
width	四角形の幅（レイアウト単位）。


 OG_Refline

説明	参照線のハンドル


OG_Sound

説明	サウンドのハンドル


OG_Template

説明	チャート・テンプレートのハンドル


 OG_Timer

説明	タイマーのハンドル


OG_Window

説明	ウィンドウのハンドル


 TOOL_INT.PARAMLIST

説明	パラメータ・リストのハンドル


TOOL_INT.PARAM_ATTR

説明	パラメータを定義します。このデータ型は次のように定義されたレコードです。

構文

TYPE TOOL_INT.param_attr IS RECORD
(mask       NUMBER(1,0),
 paramtype  NUMBER(1,0),
 value      VARCHAR2(255))
);

パラメータの内容は次のとおりです。 mask	属性レコード用のマスク。
paramtype	パラメータ・タイプ。このレコード・フィールドに指定できるビルトイン定数は次のとおりです。 TOOL_INT.DATA_PARAMETER TOOL_INT.TEXT_PARAMETER
value	パラメータの値。


ビルトイン・グローバル変数

OG_App

OG_Inch

OG_Null_Axis

OG_Null_Buttonproc

OG_Null_Display

OG_Null_Ftemp

OG_Null_Layer

OG_Null_Object

OG_Null_Query

OG_Null_Refline

OG_Null_Sound

OG_Null_Template

OG_Null_Timer

OG_Null_Window


OG_App

説明	最初にGraphics BuilderのビルトインPL/SQL構成体が実行されたときの、アプリケーションの属性値のスナップショットが入ります。

構文

OG_App  OG_App_Attr;

注意: このグローバル変数は、ある時点における値のスナップショットであるため、アプリケーションの属性を変更しても、この変数に影響はありません。たとえば、データベース接続を変更しても、username、passwordおよびconnectionの属性は自動的に更新されません。


OG_Inch

説明	1インチに相当するレイアウト単位数。

構文

OG_Inch  NUMBER;


OG_Null_Axis,;
 OG_Null_Axis

説明	チャート軸のNULLハンドル。

構文

OG_Null_Axis  OG_Axis;


OG_Null_Buttonproc,;
OG_Null_Buttonproc

説明	ボタン・プロシージャのNULLハンドル。

構文

OG_Null_Buttonproc  OG_Buttonproc;


OG_Null_Display,;
OG_Null_Display

説明	画面のNULLハンドル。

構文

OG_Null_Display  OG_Display;


OG_Null_Ftemp,;
OG_Null_Ftemp

説明	フィールド・テンプレートのNULLハンドル。

構文

OG_Null_Ftemp  OG_Ftemp;


OG_Null_Layer,;
OG_Null_Layer

説明	レイヤーのNULLハンドル。

構文

OG_Null_Layer  OG_Layer;


OG_Null_Object,;
OG_Null_Object

説明	グラフィック・オブジェクトのNULLハンドル。

構文

OG_Null_Object  OG_Object;


OG_Null_Query,;
OG_Null_Query

説明	問合せのNULLハンドル。

構文

OG_Null_Query  OG_Query;


OG_Null_Refline,;
OG_Null_Refline

説明	参照線のNULLハンドル。

構文

OG_Null_Refline  OG_Refline;


OG_Null_Sound,;
OG_Null_Sound

説明	サウンドのNULLハンドル。

構文

OG_Null_Sound  OG_Sound;


OG_Null_Template;
OG_Null_Template

説明	チャート・テンプレートのNULLハンドル。

構文

OG_Null_Template  OG_Template;


OG_Null_Timer,;
OG_Null_Timer

説明	タイマーのNULLハンドル。

構文

OG_Null_Timer  OG_Timer;


OG_Null_Window,;
OG_Null_Window

説明	ウィンドウのNULLハンドル。

構文

OG_Null_Window  OG_Window;


ビルトイン・サブプログラムのアルファベット順リスト

OG_Activate_Layer

OG_Activate_Timer

OG_Append_Directory

OG_Append_File

OG_Append_Row

OG_Center

OG_Clear_Query

OG_Clone（オブジェクト）

OG_Clone (テンプレート)

OG_Close_Display

OG_Connect

OG_Damage（オブジェクト）

OG_Damage (領域)

OG_Data_Changed

OG_Data_Queried

OG_Deactivate_Timer

OG_Delete_Child

OG_Delete_Cmptext

OG_Delete_Column

OG_Delete_Field

OG_Delete_Ftemp

OG_Delete_Param

OG_Delete_Point

OG_Delete_Property

OG_Delete_Refline

OG_Delete_Smptext

OG_Destroy（オブジェクト）

OG_Destroy (問合せ)

OG_Destroy（サウンド）

OG_Destroy (テンプレート)

OG_Destroy (タイマー)

OG_Destroy (ウィンドウ)

DOSQL

OG_Draw

OG_Execute_Query

OG_Export_Drawing（図表）

OG_Export_Drawing（オブジェクト/レイヤー）

OG_Export_Drawing （ウィンドウ）

OG_Export_Image

OG_Export_Sound

OG_Export_Template

OG_Generate_Display

OG_Get_Attr (アプリケーション)

OG_Get_Attr (軸)

OG_Get_Attr (図表)

OG_Get_Attr (フィールド・テンプレート)

OG_Get_Attr (枠テンプレート)

OG_Get_Attr (オブジェクト)

OG_Get_Attr (プリンタ)

OG_Get_Attr (問合せ)

OG_Get_Attr (参照線)

OG_Get_Attr (サウンド)

OG_Get_Attr (タイマー)

OG_Get_Attr (ウィンドウ)

OG_Get_Axis

OG_Get_Buttonproc

OG_Get_Char_Param

OG_Get_Char_Property

OG_Get_Charcell

OG_Get_Chart_Element

OG_Get_Child

OG_Get_Cmptext

OG_Get_Column

OG_Get_Date_Param

OG_Get_Date_Property

OG_Get_Datecell

OG_Get_Display

OG_Get_Field

OG_Get_Ftemp

OG_Get_Layer

OG_Get_Newrows

OG_Get_Num_Param

OG_Get_Num_Property

OG_Get_Numcell

OG_Get_Object

OG_Get_Param_Type

OG_Get_Point

OG_Get_Query

OG_Get_Refline

OG_Get_Row

OG_Get_Schema

OG_Get_Smptext

OG_Get_Sound

OG_Get_Template

OG_Get_Timer

OG_Get_Window

OG_Help

OG_Hide_Layer

OG_Hide_Window

OG_Host

OG_Import_Drawing

OG_Import_Image

OG_Import_Sound

OG_Import_Template

OG_Insert_Child

OG_Insert_Cmptext

OG_Insert_Column

OG_Insert_Field

OG_Insert_Ftemp

OG_Insert_Point

OG_Insert_Refline

OG_Insert_Smptext

OG_Isnull

OG_Logged_On

OG_Logoff

OG_Logon

OG_Make_Chart

OG_Make_Ellipse

OG_Make_Group

OG_Make_Image

OG_Make_Line

OG_Make_Poly

OG_Make_Query

OG_Make_Rect

OG_Make_Rrect

OG_Make_Sound

OG_Make_Symbol

OG_Make_Template

OG_Make_Text

OG_Make_Timer

OG_Make_Window

OG_Move

OG_Next_Row

OG_Numcols

OG_Numrows

OG_Open_Display

OG_Param_Exists

OG_Pause

OG_Play_Sound

OG_Point_In

OG_Point_Near

OG_Print

OG_Property_Exists

OG_Quit

OG_Record_Sound

OG_Root_Object

OG_Rotate

OG_Same

OG_Save_Display

OG_Scale

OG_Set_Edgecolor

OG_Set_Fillcolor

OG_Set_Attr (アプリケーション)

OG_Set_Attr (軸)

OG_Set_Attr (チャート要素)

OG_Set_Attr (図表)

OG_Set_Attr (フィールド・テンプレート)

OG_Set_Attr (枠テンプレート)

OG_Set_Attr (オブジェクト)

OG_Set_Attr (プリンタ)

OG_Set_Attr (問合せ)

OG_Set_Attr (参照線)

OG_Set_Attr (サウンド)

OG_Set_Attr (タイマー)

OG_Set_Attr (ウィンドウ)

OG_Set_Charcell

OG_Set_Datecell

OG_Set_Numcell

OG_Set_Schema

OG_Set_Param

OG_Set_Property

OG_Show_Layer

OG_Show_Window

OG_Start_From

OG_Stop_Sound

OG_Synchronize

TOOLINTADDPARAMETER

TOOLINTCREATEPARAMETERLIST

TOOLINTDELETEPARAMETER

TOOLINTDESTROYPARAMETERLIST

TOOLINTGETPARAMETERATTR

TOOLINTGETPARAMETERLIST

TOOLINTISNULL

TOOLINTRUNPRODUCT

TOOL_INT.SET_PARAMETER_ATTR

OG_Translate_Envvar

OG_Update_Chart

OG_Update_Bbox

OG_User_Exit


この文字で始まるビルトイン・サブプログラムはありません。


チャート・ビルトイン

OG_Delete_Column

OG_Delete_Field

OG_Get_Chart_Element

OG_Get_Column

OG_Get_Field

OG_Get_Row

OG_Insert_Field

OG_Make_Chart

OG_Update_Chart


OG_Delete_Column

  例	  関連項目

説明 このプロシージャでは、カスタムの問合せから列を削除します。

構文

PROCEDURE OG_Delete_Column
  (query_hdl  OG_Query,
   indx       NUMBER,
   total      NUMBER);

パラメータ

query_hdl	列が削除される問合せのハンドル。
indx	問合せから削除する最初の列の索引。
total	削除する列の合計数。


OG_Delete_Columnの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure deletes a column
 ** from the query 'query0':
 */

PROCEDURE example(col_num number) IS
   query   OG_Query;
BEGIN
   query:=OG_Get_Query('query0');
   OG_Delete_Column(query, col_num, 1);
END;


 OG_Delete_Field

  例	  関連項目

説明 このプロシージャでは、指定したチャート・オブジェクトから1つ以上のフィールドを削除します。

構文

PROCEDURE OG_Delete_Field
  (chart_hdl  OG_Object,
   indx       NUMBER,
   total      NUMBER);

パラメータ

chart_hdl	チャート・オブジェクトのハンドル。
indx	フィールド・リストから削除する最初のフィールドの索引。
total	削除するフィールドの合計数。
使用上の注意 フィールドの削除では、指定したチャートから該当するフィールドが削除されるのみです。フィールドが参照しているフィールド・テンプレートは削除されません（変更されることはあります）。また、チャートのフィールドを変更しても、そのチャートをOG_Update_Chartのコールによって更新するまで変更は適用されません。


OG_Delete_Fieldの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose one chart currently displays plots for both salary
 ** and commission data, and you want to remove the
 ** commission plot from that chart and plot it on another one.
 */

PROCEDURE transfer_comm(chart1 IN OG_Object, chart2 IN
OG_Object, field_index in number) IS
   the_field   OG_Field;
BEGIN
   the_field:=OG_Get_Field(Chart1, field_index);
   OG_Delete_Field(Chart1, field_index, 1);
   OG_Insert_Field(Chart2, the_field, OG_Last);
   OG_Update_Chart(Chart1, OG_All_Chupda);
   OG_Update_Chart(Chart2, OG_All_Chupda);
END;


 OG_Get_Chart_Element

  例	  関連項目

説明 チャート要素（棒グラフの棒、円グラフの円弧など）のハンドルと行番号を割り当てると、このファンクションにより、行番号に対応した個々の要素が戻されます。

構文

FUNCTION OG_Get_Chart_Element
  (group_hdl  OG_Object,
   row_num    NUMBER)
RETURN OG_Object;

パラメータ

group_hdl	チャート要素で構成されるグループのハンドル。
row_num	取得するチャート要素に対応した行番号。
戻り値 指定した行番号に対応した個々のチャート要素。

使用上の注意 グループ・ハンドルは、OG_Get_Objectに該当する名前を指定して、チャート・オブジェクトから取り出せます。


OG_Get_Chart_Elementの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure changes the color of the first:
 ** bar in a column chart, regardless of its value:
 */

PROCEDURE example(chart OG_Object) IS
  bars_group  OG_Object;
  elem        OG_Object;
BEGIN
  bars_group := OG_Get_Object('Sal_Bars', chart);
  elem := OG_Get_Chart_Element(Bars_Group, 0);
  OG_Set_Fillcolor(Elem, 'red');
END;


OG_Get_Column

  例	  関連項目

説明 このファンクションを使用して、特定のチャート要素に対応付けられた問合せの列の名前を戻します。

構文

FUNCTION OG_Get_Column
  (chelement_hdl  OG_Object)
RETURN VARCHAR2;

パラメータ

chelement_hdl	チャート要素のハンドル。
戻り値 チャート要素に対応付けられた列の名前。


OG_Get_Columnの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the query column represented by
 ** the first bar in a column chart:
*/

FUNCTION example(chart OG_Object) RETURN CHAR IS
  bars  OG_Object;
  elem  OG_Object;
  col   VARCHAR2(15);
BEGIN
  bars := OG_Get_Object('Sal_Bars', chart);
  elem := OG_Get_Chart_Element(Bars, 0);
  col := OG_Get_Column(Elem);
  RETURN(col);
END;


 OG_Get_Field

  例	  関連項目

説明 このファンクションを使用して、フィールドの属性値で構成されたレコードを、指定したチャートに戻します。

構文

FUNCTION OG_Get_Field
  (chart_hdl  OG_Object,
   indx       NUMBER)
RETURN OG_Field;

パラメータ

chart_hdl	チャート・オブジェクトのハンドル。
indx	チャートのフィールド内の、戻されるフィールドの索引。
戻り値 指定されたフィールドの属性。


OG_Get_Fieldの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose one chart currently displays plots for both salary
 ** and commission data, and you want to remove the
 ** commission plot from that chart and plot it on another one:
 */

PROCEDURE transfer_comm(chart1 IN OG_Object, chart2 IN
  OG_Object, field_index IN NUMBER) IS
   the_field   OG_Field
BEGIN
   the_field:=OG_Get_Field(The_Chart, field_index);
   OG_Delete_Field(Chart1, field_index, 1);
   OG_Insert_Field(Chart2, the_field, OG_Last);
END;


 OG_Get_Row

  例	  関連項目

説明 このファンクションを使用して、特定のチャート要素で対応付けられた問合せの行番号を戻します。

構文

FUNCTION OG_Get_Row
  (chelement_hdl  OG_Object)
RETURN NUMBER;

パラメータ

chelement_hdl	チャート要素のハンドル。
戻り値 チャート要素に対応付けられた行番号。


OG_Get_Rowの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following format trigger explodes the pie slice
 ** representing SAL for employee 'SMITH':
 */

PROCEDURE OGFORMATTRIG0(elem IN OG_Object,
                        query IN OG_Query) IS
  ename    VARCHAR2(10);
  chart    OG_Object;
  row_num  NUMBER;
BEGIN
  ename := OG_Get_Charcell(Query, 'ENAME');
  IF ename = 'SMITH' THEN
    chart := OG_Get_Object('Chart0');
    row_num := OG_Get_Row(Elem);
    OG_Set_Explosion(Chart, row_num, 'SAL', 25);
  END IF;
END;


 OG_Insert_Field

  例	  関連項目

説明 このプロシージャでは、指定したチャートに新しいフィールドを挿入します。

構文

PROCEDURE OG_Insert_Field
  (chart_hdl  OG_Object,
   field_rec  OG_Field,
   indx       NUMBER);

パラメータ

chart_hdl	チャート・オブジェクトのハンドル。
field_rec	フィールドの属性で構成されるレコード。
indx	チャートのフィールドに新しいフィー ルドを挿入するための索引。この引数は、必ず0から n まで(0とnを含む)の整数であることが必要です。この場合、n は、挿入を行う前にチャートの中にあったフィールドの数になります。次のビルトイン定数のいずれかを指定することもできます。 OG_First   チャートのフィールド・ リストの最初に新しいフィールドを挿入する(索引は0になります)。 OG_Last   チャートのフィールド・ リストの最後に新しいフィールドを挿入する(索引は挿入を行う前にチャートの中にあったフィールドの数になります)。
使用上の注意 チャートのフィールドを変更しても、そのチャートをOG_Update_Chartのコールによって更新するまで変更は適用されません。


OG_Insert_Fieldの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose one chart currently displays plots for both
 ** salary and commission data, and you want to remove
 ** the commission plot from that chart and plot it on another one:
 */

PROCEDURE transfer_comm (chart1 IN OG_Object, chart2 IN
OG_Object, field_index IN NUMBER) IS
   the_field   OG_Field;
BEGIN
   the_field:=OG_Get_Field(The_Chart, field_index);
   OG_Delete_Field(Chart1, field_index, 1);
   OG_Insert_Field(Chart2, the_field, OG_Last);
END;


 OG_Make_Chart

  例	  関連項目

説明 このファンクションを使用して、チャートを作成します。

構文

FUNCTION OG_Make_Chart
  (position  OG_Point,
   height    NUMBER,
   width     NUMBER,
   template  OG_Template,
   query     OG_Query)
RETURN OG_Object;

パラメータ

position	チャート枠のx座標とy座標。
height	チャートの高さ。
width	チャートの幅。
template	チャートに使用するテンプレート。
query	チャートに使用する問合せ。
戻り値 新しく作成したチャートのハンドル。

使用上の注意 チャートを完成するには、OG_Insert_Fieldによってチャートにフィールドを追加し、OG_Update_Chartによってチャートを更新する必要があります。


OG_Make_Chartの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function creates a chart using
 ** the specified template and query:
 */

FUNCTION example(template OG_Template, query OG_Query) RETURN OG_Object IS
  chart   OG_Object;
  pos     OG_Point;
  height  NUMBER;
  width   NUMBER;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  height := 4* OG_Inch;
  width := 4* OG_Inch;

  chart := OG_Make_Chart(Pos, height, width, template, query);
  RETURN(chart);
END;


OG_Update_Chart

  例	  関連項目

説明 このプロシージャでは、指定したチャートの指定した部分を更新して、新しい問合せ結果や、チャート要素にすでに適用されている新しい属性を反映させます。問合せに基づくチャートを更新するには、その問合せを少なくとも一度は実行した後にしてください。

構文

PROCEDURE OG_Update_Chart
  (chart_hdl    OG_Object,
   chart_mask   NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

chart_hdl	更新するチャートのハンドル。
chart_mask	更新する必要のあるチャート部分を指定する。この引数の値には、次のビルトイン定数のいずれかを指定してください。 OG_All_Chupda   チャート全体を更新する。 OG_Dep1axis_Chupda   最初の従属軸に対応付けられたチャート部分のみを更新する。 OG_Dep2axis_Chupda   2番目の従属軸に対応付けられたチャート部分のみを更新する。 OG_Frame_Chupda   枠に対応付けられたチャート部分のみを更新する。 OG_Indaxis_Chupda   独立軸に対応付けられたチャート部分のみを更新する。 OG_Inframe_Chupda   枠内に表示されたチャート部分のみを更新する。 OG_Legend_Chupda   凡例に対応付けられたチャート部分のみを更新する。 OG_None_Chupda   どのチャート部分も更新しない。 OG_Title_Chupda   チャートのタイトルのみを更新する。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意 このプロシージャを起動すると、Graphics Builderにより現行のチャートが破棄され、更新した問合せの結果や属性の設定に従ってもう一度チャートが作成されます。このため、OG_Update_Chartを最後に起動してからチャート要素の属性の設定に対して加えた変更はすべて消失します。たとえば、OG_Set_Attrを使用してチャート内の特定の棒の属性を設定し、その棒を更新すると、希望どおりの結果が得られます。ただし、OG_Update_Chartをもう一度コールすると、その変更はすべて消失し、棒の表示がデフォルト設定に戻ります。

チャートを更新するときには必ず、それぞれのチャート要素から変更してください。チャート要素を変更する基準はデータの変更に応じて変わることがあるので、この手順が必要となります。


OG_Update_Chartの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to update a chart periodically.
 **You could write the following timer trigger:
*/

PROCEDURE my_timer IS+
   my_query   OG_Query;
   my_chart   OG_Object;
BEGIN
   my_query:=OG_Get_Query('Emp_Query');
   my_chart:=OG_Get_Object('Emp_Chart');
   OG_Execute_Query(My_Query);
   OG_Update_Chart(My_Chart, OG_All_Chupda);
END;


データベース・ビルトイン

OG_Connect

OG_Logged_On

OG_Logoff

OG_Logon


 OG_Connect

  例	  関連項目

説明 このファンクションを使用して、「接続」ダイアログ・ボックスを表示します。

構文

FUNCTION OG_Connect
RETURN BOOLEAN;

パラメータ

なし。


OG_Connectの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose your application requires the
** user to be connected to a database.The
** following procedure checks if a connection
** exists and, if not, prompts the user to
** connect by showing the Connect dialog box:
*/

PROCEDURE ensure_connection IS
status  BOOLEAN;
BEGIN
   IF NOT OG_Logged_On THEN
   status:=OG_Connect;
   END IF;
END;


OG_Logged_On

  例	  関連項目

説明 このファンクションを使用して、ユーザーが現在データベースに接続している場合にはTRUEを、接続していない場合にはFALSEを戻します。

構文

FUNCTION OG_Logged_On
RETURN BOOLEAN;

パラメータ

なし。

戻り値

TRUE	ユーザーがデータベースに接続している場合。
FALSE	ユーザーがデータベースに接続していない場合。


OG_Logged_Onの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose your application requires the user to be
** connected to a database.The following procedure
** checks if a connection exists and, if not, prompts the
** user to connect by showing the Connect dialog box:
*/

PROCEDURE ensure_connection IS
status  BOOLEAN;
BEGIN
   IF NOT OG_Logged_On THEN
      status := OG_Connect;
   END IF;
END;


OG_Logoff

  例	  関連項目

説明 このプロシージャで、既存のデータベース接続をクローズします。

構文

PROCEDURE OG_Logoff;

パラメータ

なし。


OG_Logoffの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to disconnect from a database when the display is closed.
** You could write the following Close Display trigger:
*/

PROCEDURE close_trig IS
BEGIN
   IF OG_Logged_On THEN
      OG_Logoff;
   END IF;
END;


OG_Logon

  例	  関連項目

説明 このプロシージャで、指定したデータベースへの接続を確立します。

構文

PROCEDURE OG_Logon
  (username        VARCHAR2  :=  NULL,
   password        VARCHAR2  :=  NULL,
   connect_string  VARCHAR2  :=  NULL);

パラメータ

username	使用するユーザー名。
password	使用するパスワード。
connect_string	使用するデータベース接続文字列。リモート・データベースに接続する場合は、適切なSQL*Netデータベース接続文字列を指定する必要があります。詳細は、『Oracle Network Manager管理者ガイド』を参照してください。
使用上の注意 1つの接続がすでに確立されているときに、このプロシージャで次の接続を試行すると、その接続が成功しても失敗しても、最初にあった接続が切断されます。


OG_Logonの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose your application requires the user to be connected to a database.
** The following procedure checks if a connection exists and, if not,
**automatically establishes a connection:
*/

PROCEDURE ensure_connection IS
BEGIN
   IF NOT OG_Logged_On THEN
      OG_Logon('Scott', 'tiger', 't:london:MY_DB');
   END IF;
END;


図表ビルトイン

OG_Close_Display

OG_Generate_Display

OG_Get_Display

OG_Isnull

OG_Open_Display

OG_Save_Display


OG_Close_Display

  例	  関連項目

説明  このプロシージャで、指定された図表をクローズし、その図表で使用されているすべてのウィンドウを破棄します。また、指定された図表のクローズ・トリガーを実行します。

構文

PROCEDURE OG_Close_Display
  (display_hdl  OG_Display);

パラメータ

display_hdl	クローズする図表のハンドル。
使用上の注意  現行の図表をクローズするプロシージャをコールする場合、OG_Close_Displayはそのプロシージャの最後の行に記述してください。一度図表をクローズした後で、PL/SQLを実行することはできません。


OG_Close_Displayの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose the user is through with one display,
** and you want to close it and open another one.
*/

PROCEDURE continue(old_disp_name, new_disp_name) IS
   old_disp   OG_Display;
   new_disp   OG_Display;
BEGIN
   old_dispb:=OG_Get_Display(Old_Disp_Name, OG_Filesystem);
   OG_Close_Display(Old_Disp);
   new_dispb:=OG_Open_Display(New_Disp_Name, OG_Filesystem);
END;


OG_Generate_Display

  例	  関連項目

説明  このファンクションで、現行の図表を生成します。生成された図表は、Graphics Builderランタイムやバッチ・プログラムで実行されます。

構文

PROCEDURE OG_Generate_Display;

PROCEDURE OG_Generate_Display
  (name        VARCHAR2,
   repository  OG_Number);

パラメータ

name	生成される図表に割り当てる名前。図表をデータベースに格納する場合は、この引数に図表の名前のみを指定します。図表をファイル・システムに格納する場合は、この引数に図表ファイルの絶対パス名または相対パス名を指定します。
repository	図表をファイル・システムまたはデータベースのどちらに格納するかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db   図表をデータベースに格納します。 OG_Filesystem   図表をファイル・システムに格納します。
使用上の注意  nameとrepositoryを省略すると、図表が最後にオープンされたときの名前とリポジトリを使用して図表が生成されます。


OG_Generate_Displayの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose your display allows the user to interactively specify
**which queries to view, and what chart types to use.
**When the user selects a 'generate' button, you may want to
**generate a runtime version of the display
** that the user can use in the future.
*/

PROCEDURE gen(buttonobj IN OG_Object, hitobj IN OG_Object,
  win IN OG_Window, eventinfo IN OG_Event) IS
BEGIN
  og_generate_display('my_disp', OG_FILESYSTEM);
END;


OG_Get_Display

  例	  関連項目

説明 現行のGraphics Builderセッションでオープンしている図表のハンドルを戻します。現在実行中の図表以外の図表をオープンするには、OG_Open_Displayを使用します。

構文

FUNCTION OG_Get_Display
RETURN OG_Display;

FUNCTION OG_Get_Display
  (display_name  VARCHAR2,
   repository    NUMBER)
RETURN OG_Display;

パラメータ

display_name	図表の名前。図表がデータベースに格納されている場合は、この引数に図表の名前のみを指定します。図表がファイル・システムに格納されている場合は、この引数に図表ファイルの絶対パス名または相対パス名を指定します。
repository	図表がファイル・システムまたはデータベースのどちらに格納されているかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db   図表をデータベースに格納します。 OG_Filesystem   図表をファイル・システムに格納します。
戻り値  指定された図表のハンドル。図表が存在しないか、またはオープンされていない場合は、NULLハンドルが戻されます。

使用上の注意  display_nameとrepositoryを省略すると、このファンクションによって現行の図表のハンドルが戻ります。


OG_Get_Displayの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose the user is through with one display,
** and you would like to close it and open another one.
*/

PROCEDURE continue(old_disp_name, new_disp_name) IS
   old_disp   OG_Display;
   new_disp   OG_Display;
BEGIN
   old_disp:=OG_Get_Display(Old_Disp_Name, OG_Filesystem);
   OG_Close_Display(Old_Disp);
   new_disp:=OG_Open_Display(New_Disp_Name, OG_Filesystem);
END;


OG_Isnull

  例	  関連項目

説明  このファンクションで、指定されたハンドルがNULLハンドルであるかどうかを判別します。

構文

FUNCTION OG_Isnull                           問合せ
  (handle OG_Query)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           オブジェクト
  (handle OG_Object)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           チャート・テンプレート
(handle  OG_Template)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           ボタン・プロシージャ
(handle  OG_Buttonproc)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           サウンド
  (handle OG_Sound)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           ウィンドウ
  (handle OG_Window)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           レイヤー
  (handle OG_Layer)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           タイマー
  (handle OG_Timer)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           図表
  (handle OG_Display)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           軸
  (handle OG_Axis)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           フィールド・テンプレート
(handle  OG_Ftemp)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           参照線
(handle  OG_Refline)
RETURN BOOLEAN;

パラメータ

ハンドル	評価対象のハンドル。
戻り値

TRUE	ハンドルがNULLハンドルである場合。
FALSE	ハンドルがNULLハンドルでない場合。


OG_Isnullの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose your display occasionally creates a text object that contains a warning message.At times you
** may want to remove the warning message before continuing with the execution of the display.Rather
** than keeping track of whether a warning has been generated, you can check for the existence of the
** text object before deleting it.
*/

PROCEDURE remove_warning IS
   warning_obj   OG_Object;
BEGIN
   warning_obj:=OG_Get_Object('warning');
   IF NOT (OG_Isnull(warning_obj)) THEN;
      OG_Destroy(warning_obj);
   END IF;
END;


OG_Open_Display

  例	  関連項目

説明  このファンクションで、指定された図表をオープンし、そのオープン・トリガーを実行します。また、後でOG_Close_Displayの引数として使用できる図表のハンドルを戻します。図表が存在しない場合は、このファンクションはNULLハンドルを戻します。

構文

FUNCTION OG_Open_Display
  (display_name  VARCHAR2,
   repository    NUMBER)
RETURN OG_Display;

パラメータ

display_name	図表の名前。図表がデータベースに格納されている場合は、この引数に図表の名前のみを指定します。図表がファイル・システムに格納されている場合は、この引数に図表ファイルの絶対パス名または相対パス名を指定します。
repository	図表がファイル・システムまたはデータベースのどちらに格納されているかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db   図表はデータベースに格納されています。 OG_Filesystem   図表はファイル・システムに格納されています。
戻り値  新たにオープンされた図表のハンドル。

使用上の注意  このファンクションでは、引数として図表のハンドルを受け入れません。これは、図表をオープンする前に、まずファイル・システムまたはデータベース内で図表の存在を検証する必要があるからです。OG_Get_Displayを使用して図表のハンドルを取得した後で、ファイル・システムまたはデータベースからその図表を削除したとします。図表のハンドルをOG_Open_Displayへ渡そうとしても、ハンドルで参照される図表の検出はできません。したがって、図表の名前をもう一度指定する必要があります。


OG_Open_Displayの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose the user is through with one display,
** and you would like to close it and open another one.
*/

PROCEDURE continue(old_display_name IN CHAR,
new_display_name IN CHAR) IS
   old_display   OG_Display;
   new_display   OG_Display;
BEGIN
   old_display:=OG_Get_Display(old_display_name, OG_Filesystem);
   new_display:=OG_Open_Display(new_display_name, OG_Filesystem);
   OG_Close_Display(old_display);
END;


OG_Save_Display

  例	  関連項目

説明  このファンクションで、図表の現行の状態を保存します。保存された図表は、Graphics Builderでオープンしたり編集したりできます。

構文

PROCEDURE OG_Save_Display;

PROCEDURE OG_Save_Display
  (name        VARCHAR2,
   repository  OG_Number);

パラメータ

name	保存する図表に割り当てる名前。図表をデータベースに格納する場合は、この引数に図表の名前のみを指定します。図表をファイル・システムに格納する場合は、この引数に図表ファイルの絶対パス名または相対パス名を指定します。
repository	図表をファイル・システムまたはデータベースのどちらに格納するかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db   図表をデータベースに格納します。 OG_Filesystem   図表をファイル・システムに格納します。
使用上の注意  nameとrepositoryを省略すると、図表が最後にオープンされたときの名前とリポジトリを使用して図表が保存されます。


OG_Save_Displayの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to import 100 TIFF images.Doing this
**manually is tedious and would take a long time.
**The solution is to write the following procedure,
**which imports images from the files named 'image00'
**through 'image99'.When finished, it saves the display
**so that you can open it again in the Builder.
*/

PROCEDURE import_100 IS
   the_image   OG_Image;
   file_name   VARCHAR2(7);
BEGIN
   FOR i IN 0..99 LOOP
      file_name:='image'||SUBSTR(TO_CHAR(i, '09'), 2);
      the_image:=OG_Import_Image(File_Name, OG_Filesystem, OG_Tiff_Iformat);
   END LOOP;
   OG_Save_Display;
END;


レイヤー・ビルトイン

OG_Activate_Layer

OG_Get_Layer

OG_Hide_Layer

OG_Show_Layer


OG_Activate_Layer

  例	  関連項目

説明  このプロシージャで、指定したウィンドウ内の指定したレイヤーをアクティブにします。

構文

PROCEDURE OG_Activate_Layer
  (layer_hdl   OG_Layer,
   window_hdl  OG_Window
   damage      BOOLEAN   :=  TRUE);

PROCEDURE OG_Activate_Layer
  (layer_hdl   OG_Layer,
   damage      BOOLEAN   :=  TRUE);

パラメータ

layer_hdl	アクティブにするレイヤーのハンドル。
window_hdl	アクティブにするレイヤーが含まれているウィンドウのハンドル。指定しなければ、すべてのウィンドウでそのレイヤーがアクティブにされます。
damage	ダメージ・フラグ。
使用上の注意　隠れたレイヤーをアクティブにすると、そのレイヤーが画面に表示されます。アクティブにできるレイヤーは一度に1つのみです。

また、グループ・オブジェクトを画面のルート・オブジェクトの子として挿入した場合は、OG_Get_Layerを使用してそのグループのレイヤー・ハンドルを取得できます。このようなグループ・オブジェクトをアクティブにすると、Graphics Builderではこのオブジェクトが1つのレイヤーとして認識されます。


OG_Activate_Layerの使用例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose your layout contains several layers,
**each of which contains a set of buttons.
**If you want certain buttons to be active at
**a specific time, you can activate the layer
**that contains those buttons.If the user
**selects on a button object that is not in the active
**layer, nothing will happen.
*/

PROCEDURE activate_a_layer(layer_num NUMBER, the_window OG_Window) IS
   layer_name   VARCHAR2(6);
   the_layer    OG_Layer;
BEGIN
   layer_name:='layer'||TO_CHAR(layer_num);
   the_layer:=OG_Get_Layer(Layer_Name);
   OG_Activate_Layer(The_Layer, the_window);
END;


OG_Get_Layer

  例	  関連項目

説明  OG_Get_Objectファンクションにパラメータとしてグループ・オブジェクト名を渡すと、レイヤーを1つのグループ・オブジェクトとして扱えます。

構文

FUNCTION OG_Get_Layer
  (layer_name  VARCHAR2)
RETURN OG_Layer;

パラメータ

layer_name	レイヤーの名前。このレイヤーのハンドルが戻ります。
戻り値  指定されたレイヤーのハンドル。指定されたレイヤーが存在しない場合、このファンクションを使用するとNULLハンドルが戻ります。

使用上の注意  OG_Get_Layerを使用して、グループ・オブジェクトのレイヤー・ハンドルを取得し、さらにそのグループを表示またはアクティブにすると、そのグループをレイヤーとして扱えます。


OG_Get_Layerの使用例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to hide "layer1".
*/

PROCEDURE make_layer1_invis (the_window   OG_Window) IS
   my_layer   OG_Layer;
BEGIN
   my_layer:=OG_Get_Layer('Layer1');
   OG_Hide_Layer(My_Layer, the_window);
END;


OG_Hide_Layer

  例	  関連項目

説明  このプロシージャで指定したレイヤーを隠します。

構文

PROCEDURE OG_Hide_Layer
  (layer_hdl   OG_Layer);

PROCEDURE OG_Hide_Layer
  (layer_hdl   OG_Layer,
   window_hdl  OG_Window);

パラメータ

layer_hdl	隠すレイヤーのハンドル。
window_hdl	隠すレイヤーが含まれているウィンドウのハンドル。指定しなければ、すべてのウィンドウでそのレイヤーが隠されます。
使用上の注意  指定したレイヤーが複数のウィンドウに表示されている場合は、指定したウィンドウ内のレイヤーのみが隠されます。また、アクティブなレイヤーは隠せないので、まず、別のレイヤーをアクティブにしてから実行してください。


OG_Hide_Layerの使用例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose "layer1" contains information that is no longer useful to view.
**The following procedure will hide it:
*/

PROCEDURE make_layer1_invis(the_window   OG_Window) IS
   my_layer   OG_Layer;
BEGIN
   my_layer:=OG_Get_Layer('Layer1');
   OG_Hide_Layer(My_Layer, the_window);
END;


OG_Show_Layer

  例	  関連項目

説明  このプロシージャで、指定したレイヤーを表示します。

構文

PROCEDURE OG_Show_Layer
  (layer_hdl   OG_Layer,
   window_hdl  OG_Window);

パラメータ

layer_hdl	表示するレイヤーのハンドル。
window_hdl	表示するレイヤーが含まれているウィンドウのハンドル。指定しなければ、すべてのウィンドウでそのレイヤーが表示されます。
使用上の注意  指定したレイヤーが複数のウィンドウで隠されていた場合は、指定したウィンドウ内のレイヤーのみが表示されます。

また、グループ・オブジェクトを画面のルート・オブジェクトの子として挿入した場合は、OG_Get_Layerを使用してそのグループのレイヤー・ハンドルを取得できます。このようなグループ・オブジェクトを表示すると、Graphics Builderではこのオブジェクトが1つのレイヤーとして認識されます。


OG_Show_Layerの使用例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to show "layer1".
*/

PROCEDURE make_layer_visible (the_window   OG_Window) IS
   my_layer   OG_Layer;
BEGIN
   my_layer:=OG_Get_Layer('Layer1');
   OG_Show_Layer(My_Layer, the_window);
END;


その他のビルトイン

DOSQL

OG_Append_Directory

OG_Append_File

OG_Center

OG_Damage (領域)

OG_Get_Attr (アプリケーション)

OG_Get_Attr (軸)

OG_Get_Attr (図表)

OG_Get_Attr (フィールド・テンプレート)

OG_Get_Attr (枠テンプレート)

OG_Get_Attr (オブジェクト)

OG_Get_Attr (プリンタ)

OG_Get_Attr (問合せ)

OG_Get_Attr (参照線)

OG_Get_Attr (サウンド)

OG_Get_Attr (タイマー)

OG_Get_Attr (ウィンドウ)

OG_Get_Buttonproc

OG_Help

OG_Host

OG_Pause

OG_Print

OG_Quit

OG_Root_Object

OG_Set_Attr (アプリケーション)

OG_Set_Attr (軸)

OG_Set_Attr (チャート要素)

OG_Set_Attr (図表)

OG_Set_Attr (フィールド・テンプレート)

OG_Set_Attr (枠テンプレート)

OG_Set_Attr (オブジェクト)

OG_Set_Attr (プリンタ)

OG_Set_Attr (問合せ)

OG_Set_Attr (参照線)

OG_Set_Attr (サウンド)

OG_Set_Attr (タイマー)

OG_Set_Attr (ウィンドウ)

OG_Translate_Envvar

OG_User_Exit


DO_SQL

  例	  関連項目

説明  このプロシージャは、指定されたSQL文を実行します。

構文

PROCEDURE do_sql
  (sql_stmt  VARCHAR2);

パラメータ

sql_stmt	有効なSQL文。これにはDML（データ操作言語）文またはDDL（データ定義言語）文が含まれます。
使用上の注意  標準PL/SQLではPL/SQLプログラム単位にDML文を含めることができますが、DDL文を実行できないので、かわりにこのプロシージャを使用してDDL文を実行します。ただし、PL/SQLプログラム単位にＤML文を組み込むことができます。一般に、DML文はDO_SQLプロシージャを使用するよりプログラム単位内で効率的に実行されます。


Do_Sql Examples

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure creates a table from within Graphics Builder:
*/

PROCEDURE create_table(table_name VARCHAR2) IS
BEGIN
  do_sql('create table' || table_name ||
         '  (empno  number(4),' ||
         '   ename  varchar2(10));');
END;


OG_Append_Directory

  例	  関連項目

説明  このファンクションは、ファイル・システムでパス名を指定する文字列を作成します。

構文

FUNCTION OG_Append_Directory
  (dir     VARCHAR2,
   subdir  VARCHAR2)
RETURN VARCHAR2;

パラメータ

dir	subdirが追加されるディレクトリを指定する文字列。この引数には有効ディレクトリの完全名が含まれている必要があります。
subdir	dirに追加されるサブディレクトリを指定する文字列。
戻り値  完全なディレクトリ・パスを含む文字列。

使用上の注意  ディレクトリおよびサブディレクトリの名前を指定した場合、このファンクションは、使用しているシステムに合ったディレクトリ・セパレータを使用してこれらを連結します。


OG_Append_Directoryの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you create a display that is run on several different systems,
**and one function of that display is to import an image from the file
**'my_image'.Assume the identical directory structure exists on all systems
**on which the display is run; however, each system requires a different
**directory separator.The following procedure creates a valid directory
**string for each system:
*/

PROCEDURE import_my_image(file_path VARCHAR2) IS
   the_image   OG_Object;
BEGIN
   file_path:=OG_Append_Directory(File_Path, 'home');
   file_path:=OG_Append_Directory(File_Path, 'smith');
   file_path:=OG_Append_Directory(File_Path, 'images');
   file_path:=OG_Append_File(File_Path, 'my_image');
   the_image:=OG_Import_Image(File_Path, OG_Filesystem,
OG_Tiff_Iformat);
END;

/*Assume the intial value of file_path is 'C:\'.On MS-DOS systems,
**the value of **file_path that is passed to OG_Import_Image is:
**C:\home\smith\images\my_image.
*/

/*Assume the initial value of file_path is 'disk$ic1[]'.On VMS systems,
**the value of file_path that is passed to OG_Import_Image is:
**disk$ic1:[home.smith.images]my_image.
*/


OG_Append_File

  例	  関連項目

説明  このファンクションは、使用しているファイル・システムのファイルのパス名を指定する文字列を作成します。

構文

FUNCTION OG_Append_File
  (dir       VARCHAR2,
   filename  VARCHAR2)
RETURN VARCHAR2;

パラメータ

dir	filenameが追加されるディレクトリを指定する文字列。この引数には有効ディレクトリの完全名が含まれている必要があります。
filename	dirに追加されるファイル名を指定する文字列。
戻り値  完全なファイル・パスを含む文字列。

使用上の注意  ディレクトリおよびファイルの名前を指定した場合、このファンクションは、使用しているシステムに合ったディレクトリ・セパレータを使用してこれらを連結します。


OG_Append_Fileの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you create a display that is run on several different systems,
**and one function of that display is to import an image from the file 'my_image'.
**Assume the identical directory structure exists on all systems on which the display
**is run; however, each system requires a different directory separator.
**The following procedure creates a valid directory string for each system:
*/

PROCEDURE import_my_image(file_path VARCHAR2) IS
   the_image   OG_Object;
BEGIN
   file_path:=OG_Append_Directory(File_Path, 'home');
   file_path:=OG_Append_Directory(File_Path, 'smith');
   file_path:=OG_Append_Directory(File_Path, 'images');
   file_path:=OG_Append_File(File_Path, 'my_image');
   the_image:=OG_Import_Image(File_Path, OG_Filesystem,
     OG_Tiff_Iformat);
END;

/*Assume the intial value of file_path is 'C:\'.On MS-DOS systems, the value of
**file_path that is passed to OG_Import_Image is:C:\home\smith\images\my_image.
*/

/*Assume the initial value of file_path is 'disk$ic1[]'.On VMS systems, the value of
**file_path that is passed to OG_Import_Image is:disk$ic1:[home.smith.images]my_image.
*/


OG_Center

  例	  関連項目

説明  このプロシージャは、center_ptで表された図表のポイントがウィンドウ中央に表示されるように、指定されたウィンドウ内の図表を再描画します。

構文

PROCEDURE OG_Center
  (window_hdl  OG_Window,
   center_pt   OG_Point);

パラメータ

window_hdl	ウィンドウに対するハンドル。
center_pt	ウィンドウ中央に表示させるための図表のポイント。


OG_Centerの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you have a chart that you want to appear in the center of a window.
**To do this, you need to get the location and dimensions of the chart's outer
**bounding box, calculate its center point, then use center_pt to place this
**point in the center of the window.
*/

PROCEDURE center_chart (my_window IN og_window, my_chart IN
og_object) IS
   center_point   og_point;
   chart_record   og_chart_ca;
BEGIN
   chart_record.chart_caob.mask:=OG_OBBOX_GENERICA;
   chart_record.chart_caog_mask:=OG_NONE_GROUPA;
   chart_record.chart_caoc_mask:=OG_NONE_CHARTA;
   og_get_attr (my_chart, chart_record);
   center_pt.x:=chart_record.chart_caob.obbox.x +
(chart_record.chart_caob.obbox.width / 2);
   center_pt.y:=chart_record.chart_caob.obbox.y +
(chart_record.chart_caob.obbox.height / 2);
   og_center (my_window, center_point);
END;


OG_Damage (Region)

  例	  関連項目

説明  このプロシージャは、レイアウトの四角形領域を破損します。

構文

PROCEDURE OG_Damage
  (region  OG_Rectangle);

PROCEDURE OG_Damage
  (region     OG_Rectangle,
   layer_hdl  OG_Layer);

パラメータ

region	破損した四角形領域。
layer_hdl	四角形領域が破損したレイヤー。layer_hdlを指定していない場合、すべてのレイヤーの領域が破損されます。
使用上の注意  詳細は「ダメージ制御フラグ」を参照してください。


OG_Damage (領域)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure damages a 3"x2"
** area in the upper-left corner of the layout:
*/

PROCEDURE example IS
  damage_region  OG_Rectangle;
BEGIN
  damage_region.x := 0;
  damage_region.y := 0;
  damage_region.width := 3 * OG_Inch;
  damage_region.height := 2 * OG_Inch;

  OG_Damage(Damage_Region);
END;


OG_Get_Attr (アプリケーション)

  例	  関連項目

説明

構文

PROCEDURE OG_Get_Attr
  (attr  IN OUT  OG_App_Attr);

パラメータ

attr	アプリケーションの属性で満たされた属性レコード。
使用上の注意  このプロシージャは、現在実行中のGraphics Builder実行可能プログラムの属性値を取得します。属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (アプリケーション)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the number of screen resolution units
**(i.e., pixels) for the current display device:
*/

FUNCTION example RETURN NUMBER IS
  rec  OG_App_Attr;
BEGIN
  rec.mask := OG_Screen_Res_Appa;
  OG_Get_Attr(Rec);
  RETURN(rec.hscreen_res);
END;


OG_Get_Attr (軸)

  例	  関連項目

説明  このプロシージャは、指定された軸の属性値を取得します。

構文

PROCEDURE OG_Get_Attr                        generic
  (axis_hdl  IN      OG_Axis,
   attr      IN OUT  OG_Axis_Attr);

PROCEDURE OG_Get_Attr                        continuous
  (axis_hdl  IN      OG_Axis,
   attr      IN OUT  OG_Contaxis_Ca);

PROCEDURE OG_Get_Attr                        date
  (axis_hdl  IN      OG_Axis,
   attr      IN OUT  OG_Dateaxis_Ca);

PROCEDURE OG_Get_Attr                        discrete
  (axis_hdl  IN      OG_Axis,
   attr      IN OUT  OG_Discaxis_Ca);

パラメータ

axis_hdl	取得する属性を持つ軸に対するハンドル。
attr	軸の属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (軸)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the custom label for the specified axis:
*/

FUNCTION example(axis OG_Axis) RETURN CHAR IS
  rec  OG_Contaxis_Ca;
BEGIN
  rec.ca_axis.mask := OG_Custlabel_Axisa;
  rec.ca_cont.mask := OG_None_Contaxisa;
  OG_Get_Attr(Axis, rec);
  RETURN(rec.ca_axis.custlabel);
END;


OG_Get_Attr (図表)

  例	  関連項目

説明  このプロシージャは、現在の図表の属性値を取得します。

構文

PROCEDURE OG_Get_Attr
  (attr  IN OUT  OG_Display_Attr);

パラメータ

attr	図表の属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (図表)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the display width:
*/

FUNCTION example RETURN NUMBER IS
  rec  OG_Display_Attr;
BEGIN
  rec.mask := OG_Size_Displaya;
  OG_Get_Attr(Rec);
  RETURN(rec.width);
END;


OG_Get_Attr (フィールド・テンプレート)

  例	  関連項目

説明  このプロシージャは、指定されたフィールド・テンプレートの属性値を取得します。

構文

PROCEDURE OG_Get_Attr                        generic
  (ftemp_hdl  IN      OG_Ftemp,
   attr       IN OUT  OG_Ftemp_Attr);

PROCEDURE OG_Get_Attr                        axis
  (ftemp_hdl  IN      OG_Ftemp,
   attr       IN OUT  OG_Axisftemp_Ca);

パラメータ

ftemp_hdl	取得する属性を持つフィールド・テンプレートに対するハンドル。
attr	フィールド・テンプレートの属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (フィールド・テンプレート)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the number format mask for the specified field template:
*/

FUNCTION example(ftemp OG_Ftemp) RETURN CHAR IS
  rec  OG_Axisftemp_Ca;
BEGIN
  rec.ca_ftemp.mask := OG_Numfmt_Ftempa;
  rec.ca_aftemp.mask := OG_None_Axisftempa;
  OG_Get_Attr(Ftemp, rec);
  RETURN(rec.ca_ftemp.numfmt);
END;


OG_Get_Attr (枠テンプレート)

  例	  関連項目

説明  このプロシージャは、指定された枠テンプレートの属性値を取得します。

構文

PROCEDURE OG_Get_Attr                        generic frame
  (template_hdl  IN      OG_Template,
   attr          IN OUT  OG_Frame_Attr);

PROCEDURE OG_Get_Attr                        axis frame
  (template_hdl  IN      OG_Template,
   attr          IN OUT  OG_Axisframe_Ca);

PROCEDURE OG_Get_Attr                        pie frame
  (template_hdl  IN      OG_Template,
   attr          IN OUT  OG_Pieframe_Ca);

PROCEDURE OG_Get_Attr                        table frame
  (template_hdl  IN      OG_Template,
   attr          IN OUT  OG_Tableframe_Ca);

パラメータ

template_hdl	取得する枠属性を持つチャート・テンプレートに対するハンドル。
attr	枠テンプレートの属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (枠テンプレート)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the depth size for the specified template frame:
*/

FUNCTION example(temp OG_Template) RETURN NUMBER IS
  rec  OG_Axisframe_Ca;
BEGIN
  rec.ca_frame.mask := OG_Depthsize_Framea;
  rec.ca_axis.mask := OG_None_Framea;
  OG_Get_Attr(Temp, rec);
  RETURN(rec.ca_frame.depthsize);
END;


OG_Get_Attr (オブジェクト)

  例	  関連項目

説明  このプロシージャは、指定されたオブジェクトの属性値を取得します。

構文

PROCEDURE OG_Get_Attr                        arc
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Arc_Ca);

PROCEDURE OG_Get_Attr                        chart
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Chart_Ca);

PROCEDURE OG_Get_Attr                        generic
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Generic_Attr);

PROCEDURE OG_Get_Attr                        graphic
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Graphic_Ca);

PROCEDURE OG_Get_Attr                        group
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Group_Ca);

PROCEDURE OG_Get_Attr                        image
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Image_Ca);

PROCEDURE OG_Get_Attr                        line
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Line_Ca);

PROCEDURE OG_Get_Attr                        polygon/polyline
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Poly_Ca);

PROCEDURE OG_Get_Attr                        rectangle
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Rect_Ca);

PROCEDURE OG_Get_Attr                        rounded rectangle
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Rrect_Ca);

PROCEDURE OG_Get_Attr                        symbol
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Symbol_Ca);

PROCEDURE OG_Get_Attr                        text/text field
  (object_hdl  IN      OG_Object,
   attr        IN OUT  OG_Text_Ca);

パラメータ

object_hdl	取得する属性を持つオブジェクトに対するハンドル。
attr	オブジェクトの属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (オブジェクト)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose the user selects an object whose color determines what information
**the user is interested in viewing.The following function will take an object
**as its **argument and return the name of its foreground fill color.The color
**can then be determined, and the appropriate information displayed.
*/

FUNCTION get_color(the_object IN OG_Object) RETURN VARCHAR2
IS
   obj_record   OG_Graphic_Ca;
BEGIN
   obj_record.graphic_caoh.mask:=OG_Ffcolor_Graphica;
   obj_record.generic_caob.mask:=OG_None_Generica;
   OG_Get_Attr(The_Object, obj_record);
   RETURN(obj_record.graphic_caoh.ffcolor);
END;


OG_Get_Attr (プリンタ)

  例	  関連項目

説明  このプロシージャは、現在のプリンタの属性値を取得します。

構文

PROCEDURE OG_Get_Attr
  (attr  IN OUT  OG_Printer_Attr);

パラメータ

attr	プリンタの属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (プリンタ)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the name of the current printer:
*/

FUNCTION example RETURN CHAR IS
  rec  OG_Printer_Attr;
BEGIN
  rec.mask := OG_Name_Printera;
  OG_Get_Attr(Rec);
  RETURN(rec.name);
END;


OG_Get_Attr (問合せ)

  例	  関連項目

説明  このプロシージャは、指定された問合せの属性値を取得します。

構文

PROCEDURE OG_Get_Attr
  (query_hdl  IN      OG_Query,
   attr       IN OUT  OG_Query_Attr);

パラメータ

query_hdl	取得する属性を持つ問合せに対するハンドル。
attr	問合せの属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (問合せ)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the SQL statement that defines the specified query:
*/

FUNCTION example(query OG_Query) RETURN CHAR IS
  rec  OG_Query_Attr;
BEGIN
  rec.mask := OG_Querysource_Querya;
  OG_Get_Attr(Query, rec);
  RETURN(rec.querysource);
END;


OG_Get_Attr (参照線)

  例	  関連項目

説明  このプロシージャは、指定された参照線の属性値を取得します。

構文

PROCEDURE OG_Get_Attr
  (refline_hdl  IN      OG_Refline,
   attr         IN OUT  OG_Refline_Attr);

パラメータ

refline_hdl	取得する属性を持つ参照線に対するハンドル。
attr	参照線の属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (参照線)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the label for the specified reference line.
*/

FUNCTION example(refline OG_Refline) RETURN CHAR IS
  rec  OG_Refline_Attr;
BEGIN
  rec.mask := OG_Label_Reflinea;
  OG_Get_Attr(Refline, rec);
  RETURN(rec.label);
END;


OG_Get_Attr (サウンド)

  例	  関連項目

説明  このプロシージャは、指定されたサウンドの属性値を取得します。

構文

PROCEDURE OG_Get_Attr
  (sound_hdl  IN      OG_Sound,
   attr       IN OUT  OG_Sound_Attr);

パラメータ

sound_hdl	取得する属性を持つサウンドに対するハンドル。
attr	サウンドの属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (サウンド)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the name of the specified sound:
*/

FUNCTION example(sound OG_Sound) RETURN CHAR IS
  rec  OG_Sound_Attr;
BEGIN
  rec.mask := OG_Name_Sounda;
  OG_Get_Attr(Sound, rec);
  RETURN(rec.name);
END;


OG_Get_Attr (タイマー)

  例	  関連項目

説明  このプロシージャは、指定されたタイマーの属性値を取得します。

構文

PROCEDURE OG_Get_Attr
  (timer_hdl  IN      OG_Timer,
   attr       IN OUT  OG_Timer_Attr);

パラメータ

timer_hdl	取得する属性を持つタイマーに対するハンドル。
attr	タイマーの属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (タイマー)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the procedure name assigned to the specified timer:
*/

FUNCTION example(timer OG_Timer) RETURN CHAR IS
  rec  OG_Timer_Attr;
BEGIN
  rec.mask := OG_Timerproc_Timera;
  OG_Get_Attr(Timer, rec);
  RETURN(rec.timerproc);
END;


OG_Get_Attr (ウィンドウ)

  例	  関連項目

説明  このプロシージャは、指定されたウィンドウの属性値を取得します。

構文

PROCEDURE OG_Get_Attr
  (window_hdl  IN      OG_Window,
   attr        IN OUT  OG_Window_Attr);

パラメータ

window_hdl	取得する属性を持つウィンドウに対するハンドル。
attr	ウィンドウの属性で満たされた属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが取り出されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Get_Attr (ウィンドウ)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the specified window's position:
*/

FUNCTION example(window OG_Window) RETURN OG_Point IS
  rec  OG_Window_Attr;
BEGIN
  rec.mask := OG_Position_Windowa;
  OG_Get_Attr(Window, rec);
  RETURN(rec.position);
END;


OG_Get_Buttonproc

  例	  関連項目

説明  このボタン・プロシージャは、定義済みである必要があり、PL/SQLパッケージ内に存在してはいけません。

構文

FUNCTION OG_Get_Buttonproc
  (proc_name  VARCHAR2)
RETURN OG_Buttonproc;

パラメータ

proc_name	ハンドルが返されるPL/SQLボタン・プロシージャの名前。
戻り値  指定されたボタン・プロシージャに対するハンドル。指定されたボタン・プロシージャが存在しない場合はNULLが返されます。


OG_Get_Buttonprocの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you have written a button procedure named 'show_sales_data'
**and you want to assign that procedure to an object; then, when the user
**selects the object, the procedure will be executed.
*/

PROCEDURE make_object_button(my_obj IN OG_Object) IS
   obj_rec         OG_Generic_Attr;
   my_buttonproc   OG_Buttonproc;
BEGIN
   my_buttonproc:=OG_Get_Buttonproc('Show_Sales_Data');
   obj_rec.mask:=OG_Button_Generica;
   obj_rec.button:=my_buttonproc;
   obj_rec.events:=OG_Mouse_Down;
   OG_Set_Attr(My_Obj, obj_rec);
END;


OG_Help

  例	  関連項目

説明  このプロシージャは「ヘルプ・システム」を起動し、指定したハイパーテキスト・ターゲットで、ランタイム・ヘルプを表示します。

構文

 PROCEDURE OG_Help
  (target  VARCHAR2);

パラメータ

target	表示されるランタイム・ヘルプ内のハイパーテキスト・ターゲット。


OG_Helpの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want the user to be able to select a button and invoke
**the Help system.You could write the following button procedure:
*/

PROCEDURE get_help (buttonobj IN OG_Object, hitobj IN
OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
BEGIN
   IF eventinfo.event_type=OG_Mouse_Up THEN
      OG_Help('Topic_1');
   END IF;
END;


OG_Host

  例	  関連項目

説明  このプロシージャは、指定されたコマンドをオペレーティング・システムに渡します。

構文

PROCEDURE OG_Host
  (command  VARCHAR2);

パラメータ

command	実行するコマンドを含むテキスト文字列。


OG_Hostの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to be notified via electronic mail when a user closes a display.
**You could create a script named 'mail_me' in your file system that sends you mail,
**and then invoke it with the following Close Display trigger:
*/

PROCEDURE send_me_mail IS
BEGIN
   OG_Host('Mail_Me');
END;


OG_Pause

  例	  関連項目

説明  このプロシージャは、指定された秒数、図表の実行を中断します。

構文

PROCEDURE OG_Pause
  (secs  NUMBER);

パラメータ

secs	中断する秒数。


OG_Pauseの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure suspends display execution for seven seconds:
*/

PROCEDURE example IS
BEGIN
  OG_Pause(7);
END;


OG_Print

  例	  関連項目

説明  このプロシージャは、現在選択されている出力デバイスにレイアウト内容を出力します。

構文

PROCEDURE OG_Print;

PROCEDURE OG_Print
  (window_hdl  OG_Window);

パラメータ

window_hdl	出力されるウィンドウに対するハンドル。
使用上の注意  ウィンドウのハンドルを指定すると、そのウィンドウに表示されているレイヤーのみが出力されるか、またはレイヤーが含まれているウィンドウの種類やレイヤーの表示/非表示にかかわらず、図表のすべてのレイヤーが出力されます。


OG_Printの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to print the contents of the main layout window.
*/

PROCEDURE print_main_window IS
   the_window   OG_Window;
BEGIN
   the_window:=OG_Get_Window('Main Layout');
   OG_Print(The_Window);
END;


OG_Quit

  例	  関連項目

説明  このプロシージャは、現行のGraphics Builderセッションを終了します。

構文

PROCEDURE OG_Quit;

パラメータ

なし。


OG_Quitの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to provide the user with a button that-when selected
**commits database changes and quits Graphics Builder.You could write the
**following button procedure:
*/

PROCEDURE commit_and_quit (hitobj IN OG_Object, buttonobj
  IN OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
BEGIN
   COMMIT;
   OG_Quit;
END;


OG_Root_Object

  例	  関連項目

説明  このファンクションは、図表のルート・オブジェクトに対するハンドルを返します。

構文

FUNCTION OG_Root_Object
RETURN OG_Object;

パラメータ

なし。

戻り値  図表のルート・オブジェクトに対するハンドル。

使用上の注意  ルート・オブジェクトは、図表の最上位のオブジェクトです。そのすぐ下の子が図表のレイヤーです。


OG_Root_Objectの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure moves the topmost layer in the display to the bottom of the layer list:
*/

PROCEDURE example IS
  root   OG_Object;
  layer  OG_Object;
BEGIN
  root := OG_Root_Object;
  layer := OG_Get_Child(Root, 0);
  OG_Insert_Child(Root, layer, OG_Last);
END;


OG_Set_Attr (アプリケーション)

  例	  関連項目

説明  このプロシージャは、現在実行中のGraphics Builder実行可能プログラムの属性を設定します。

構文

PROCEDURE OG_Set_Attr
  (attr  OG_App_Attr);

パラメータ

attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (アプリケーション)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the cursor to 'busy':
*/

PROCEDURE example IS
  attr  OG_App_Attr;
BEGIN
  attr.cursor := 'busy';
  attr.mask := OG_Cursor_Appa;
  OG_Set_Attr(Attr);
END;


OG_Set_Attr (軸)

  例	  関連項目

説明  このプロシージャは、指定された軸の属性値を設定します。

構文

PROCEDURE OG_Set_Attr                        generic
  (axis_hdl  OG_Axis,
   attr      OG_Axis_Attr);

PROCEDURE OG_Set_Attr                        continuous
  (axis_hdl  OG_Axis,
   attr      OG_Contaxis_Ca);

PROCEDURE OG_Set_Attr                        date
  (axis_hdl  OG_Axis,
   attr      OG_Dateaxis_Ca);

PROCEDURE OG_Set_Attr                        discrete
  (axis_hdl  OG_Axis,
   attr      OG_Discaxis_Ca);

パラメータ

axis_hdl	設定する属性を持つ軸に対するハンドル。
attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (軸)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the custom label for the specified axis:
*/

PROCEDURE example(axis OG_Axis, label VARCHAR2) IS
  rec  OG_Contaxis_Ca;
BEGIN
  rec.ca_axis.custlabel := 'New Label';
  rec.ca_axis.mask := OG_Custlabel_Axisa;
  rec.ca_cont.mask := OG_None_Contaxisa;
  OG_Set_Attr(Axis, rec);
END;


OG_Set_Attr (チャート要素)

  例	  関連項目

説明  このプロシージャは、横棒や円弧などチャート要素の属性を設定します。

構文

PROCEDURE OG_Set_Attr
  (chart_hdl  OG_Object,
   row_num    NUMBER,
   col_name   VARCHAR2,
   attr       OG_Chelement_Ca);

パラメータ

chart_hdl	設定する属性を持つデータ値を含むチャートに対するハンドル。
row_num	設定する属性を持つデータ値の行数。
col_name	設定する属性を持つデータ値の列の名前。
attr	新規属性値を含む属性レコード。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意  対応するデータ値のチャート、行および列とチャート設定属性レコードを指定する必要があります。属性レコードには、指定されたデータ値を表すチャート要素に適用される図形および他の属性が含まれます。たとえば、横棒に対応するデータ値の属性レコードを指定することにより、棒グラフの横棒のカラーを設定できます。

チャート要素の変更は、OG_Update_Chartのコールによりチャートが更新されるまで適用されないことに注意してください。

属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (チャート要素)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure loops through all rows in a chart's query,
**and then sets the color of each bar in the chart based on its value:
*/

PROCEDURE OGTRIGGERPROC0 IS
chart og_object;
query og_query;
rec og_chelement_ca;
total number;
bar_val number;

BEGIN
  chart := og_get_object ('Employees');
  query:= og_get_query ('query0');
  og_execute_query (query);
  og_start_from(query, OG_NEWDATA);
  total := og_numrows (query, OG_NEWDATA);
for i in 0..total-1 loop
  bar_val:=og_get_numcell (query, OG_NEWDATA,'SAL');
   IF bar_val>2000 THEN^M
   rec.chelement_cagr.mask :=OG_BFCOLOR_GRAPHICA;
   rec.chelement_cace.mask :=OG_NONE_CHELEMENTA;
   rec.chelement_cagr.bfcolor := 'cyan';
og_set_attr (chart, i, 'SAL', rec);
   END; IF;
  og_next_row(query, OG_NEWDATA);
 END LOOP;
 og_update_chart (chart, OG_ALL_CHUPDA);
END;


OG_Set_Attr (図表)

  例	  関連項目

説明  このプロシージャは、現在の図表の属性を設定します。

構文

PROCEDURE OG_Set_Attr
  (attr  OG_Display_Attr);

パラメータ

attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (図表)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the display width:
*/

PROCEDURE example IS
  rec  OG_Display_Attr;
BEGIN
  rec.width := 4 * OG_Inch;
  rec.height := 5 * OG_Inch;
  rec.mask := OG_Size_Displaya;
  OG_Set_Attr(Rec);
END;


OG_Set_Attr (フィールド・テンプレート)

  例	  関連項目

説明  このプロシージャは、指定されたフィールド・テンプレートの属性値を設定します。

構文

PROCEDURE OG_Set_Attr                        generic
  (ftemp_hdl  OG_Ftemp,
   attr       OG_Ftemp_Attr);

PROCEDURE OG_Set_Attr                        axis
  (ftemp_hdl  OG_Ftemp,
   attr       OG_Axisftemp_Ca);

パラメータ

ftemp_hdl	設定する属性を持つフィールド・テンプレートに対するハンドル。
attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (フィールド・テンプレート)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the number format mask for the specified field template:
*/

PROCEDURE example(ftemp OG_Ftemp) IS
  rec  OG_Axisftemp_Ca;
BEGIN
  rec.ca_ftemp.numfmt := '9,990';
  rec.ca_ftemp.mask := OG_Numfmt_Ftempa;
  rec.ca_aftemp.mask := OG_None_Axisftempa;
  OG_Set_Attr(Ftemp, rec);
END;


OG_Set_Attr (枠テンプレート)

  例	  関連項目

説明  このプロシージャは、指定された枠テンプレートの属性値を設定します。

構文

PROCEDURE OG_Set_Attr                        generic frame
  (template_hdl  OG_Template,
   attr          OG_Frame_Attr);

PROCEDURE OG_Set_Attr                        axis frame
  (template_hdl  OG_Template,
   attr          OG_Axisframe_Ca);

PROCEDURE OG_Set_Attr                        pie frame
  (template_hdl  OG_Template,
   attr          OG_Pieframe_Ca);

PROCEDURE OG_Set_Attr                        table frame
  (template_hdl  OG_Template,
   attr          OG_Tableframe_Ca);

パラメータ

template_hdl	設定する枠属性を持つチャート・テンプレートに対するハンドル。
attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (枠テンプレート)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the depth size for the specified template frame:
*/

PROCEDURE example(temp OG_Template) IS
  rec  OG_Axisframe_Ca;
BEGIN
  rec.ca_frame.depthsize := OG_Large_Depthsize;
  rec.ca_frame.mask := OG_Depthsize_Framea;
  rec.ca_axis.mask := OG_None_Framea;
  OG_Set_Attr(Temp, rec);
END;


OG_Set_Attr (オブジェクト)

  例	  関連項目

説明  このプロシージャは、指定されたオブジェクトの属性を設定します。

構文

PROCEDURE OG_Set_Attr                        arc
  (object_hdl   OG_Object,
   attr         OG_Arc_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        chart
  (object_hdl   OG_Object,
   attr         OG_Chart_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        generic
  (object_hdl   OG_Object,
   attr         OG_Generic_Attr,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        graphic
  (object_hdl   OG_Object,
   attr         OG_Graphic_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        group
  (object_hdl   OG_Object,
   attr         OG_Group_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        image
  (object_hdl   OG_Object,
   attr         OG_Image_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        line
  (object_hdl   OG_Object,
   attr         OG_Line_Ca,
   damage       BOOLEAN          := TRUE,
   update_bbox  BOOLEAN          := TRUE);

PROCEDURE OG_Set_Attr                        polygon/polyline
  (object_hdl   OG_Object,
   attr         OG_Poly_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        rectangle
  (object_hdl   OG_Object,
   attr         OG_Rect_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        rounded rectangle
  (object_hdl   OG_Object,
   attr         OG_Rrect_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        symbol
  (object_hdl   OG_Object,
   attr         OG_Symbol_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        text/text field
  (object_hdl   OG_Object,
   attr         OG_Text_Ca,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE); パラメータ

パラメータ

object_hdl	設定する属性を持つオブジェクトに対するハンドル。
attr	新規属性値を含む属性レコード。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (オブジェクト)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you have a map of the world and you want to change the
**color of one of the countries.First, you would get the handle to the
**country object, then you would change its color.
*/

PROCEDURE color_country (country_name) IS
   my_object    OG_Object;
   obj_record   OG_Graphic_Ca;
BEGIN
   my_object:=OG_Get_Object(Country_Name);
   obj_record.graphic_caob.mask:=OG_None_Generica;
   obj_record.graphic_caoh.mask:=OG_Ffcolor_Graphica;
   obj_record.graphic_caoh.ffcolor:='red';
   OG_Set_Attr(My_Object, obj_record);
END;


OG_Set_Attr (プリンタ)

  例	  関連項目

説明  このプロシージャは、現在のプリンタの属性値を設定します。

構文

PROCEDURE OG_Set_Attr
  (attr  OG_Printer_Attr);

パラメータ

attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (プリンタ)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure tells sets the number of copies to print:
*/

PROCEDURE example IS
  rec  OG_Printer_Attr;
BEGIN
  rec.copies := 2;
  rec.mask := OG_Copies_Printera;
  OG_Set_Attr(Rec);
END;


OG_Set_Attr (問合せ)

  例	  関連項目

説明  このプロシージャは、指定された問合せの属性を設定します。

構文

PROCEDURE OG_Set_Attr
  (query_hdl  OG_Query,
   attr       OG_Query_Attr);

パラメータ

query_hdl	設定する属性を持つ問合せに対するハンドル。
attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (問合せ)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the SQL statement that defines the specified query:
*/

PROCEDURE example(query OG_Query) IS
  rec  OG_Query_Attr;
BEGIN
  rec.querysource := 'select ename, sal from emp';
  rec.mask := OG_Querysource_Querya;
  OG_Set_Attr(Query, rec);
END;


OG_Set_Attr (参照線)

  例	  関連項目

説明  このプロシージャは、指定された参照線の属性を設定します。

構文

PROCEDURE OG_Set_Attr
  (refline_hdl  OG_Refline,
   attr         OG_Refline_Attr);

パラメータ

refline_hdl	設定する属性を持つ参照線に対するハンドル。
attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (参照線)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the label for the specified reference line.
*/

PROCEDURE example(refline OG_Refline) IS
  rec  OG_Refline_Attr;
BEGIN
  rec.label := 'Average';
  rec.mask := OG_Label_Reflinea;
  OG_Set_Attr(Refline, rec);
END;


OG_Set_Attr (サウンド)

  例	  関連項目

説明  このプロシージャは、指定されたサウンドの属性を設定します。

構文

PROCEDURE OG_Set_Attr
  (sound_hdl  OG_Sound,
   attr       OG_Sound_Attr);

パラメータ

sound_hdl	設定する属性を持つサウンドに対するハンドル。
attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (サウンド)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the name of the specified sound:
*/

PROCEDURE example(sound OG_Sound) IS
  rec  OG_Sound_Attr;
BEGIN
  rec.name := 'Alert';
  rec.mask := OG_Name_Sounda;
  OG_Set_Attr(Sound, rec);
END;


OG_Set_Attr (タイマー)

  例	  関連項目

説明  このプロシージャは、指定されたタイマーの属性を設定します。

構文

PROCEDURE OG_Set_Attr
  (timer_hdl  OG_Timer,
   attr       OG_Timer_Attr);

パラメータ

timer_hdl	設定する属性を持つタイマーに対するハンドル。
attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (タイマー)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the procedure name assigned to the specified timer:
*/

PROCEDURE example(timer OG_Timer) IS
  rec  OG_Timer_Attr;
BEGIN
  rec.timerproc := 'update_proc';
  rec.mask := OG_Timerproc_Timera;
  OG_Set_Attr(Timer, rec);
END;


OG_Set_Attr (ウィンドウ)

  例	  関連項目

説明  このプロシージャは、指定されたウィンドウの属性を設定します。

構文

PROCEDURE OG_Set_Attr
  (window_hdl  OG_Window,
   attr        OG_Window_Attr);

パラメータ

window_hdl	設定する属性を持つウィンドウに対するハンドル。
attr	新規属性値を含む属性レコード。
使用上の注意  属性レコード内のマスク属性値によって指定される属性値のみが設定されます。マスクが設定されていない属性レコード内のフィールドは、このプロシージャのコールによって影響を受けません。


OG_Set_Attr (ウィンドウ)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure sets the specified window's size:
*/

PROCEDURE example(window OG_Window) IS
  rec  OG_Window_Attr;
BEGIN
  rec.width := 4 * OG_Get_Ap_Hscreen_Res;
  rec.height := 5 * OG_Get_Ap_Vscreen_Res;
  rec.mask := OG_Size_Windowa;
  OG_Set_Attr(Window, rec);
END;


OG_Translate_Envvar

  例	  関連項目

説明  このファンクションは、指定された環境変数値を返します。

構文

FUNCTION OG_Translate_Envvar
  (envvar  VARCHAR2)
RETURN VARCHAR2;

パラメータ

envvar	変換する環境変数。
戻り値  環境変数値を含む文字列。

使用上の注意  環境変数の取り扱いやその存在は、システムによって異なります。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

環境変数を検索する場合、Graphics Builderは最初にオぺレーティング・システムをチェックし、環境変数が定義されているかどうかを確認します。定義されていない場合は、環境設定ファイル内を検索します。


OG_Translate_Envvarの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose your system has an environment variable named IMAGE_DIR
**that specifies the directory path of the image file 'my_image'.The following
**procedure imports that image:
*/

PROCEDURE import_my_image IS
   the_image   OG_Object;
   file_path   VARCHAR2(50);
BEGIN
   file_path:=OG_Translate_Envvar('Image_Dir');
   file_path:=OG_Append_File(File_Path, 'my_image');
   the_image:=OG_Import_Image(File_Path, OG_Filesystem,
     OG_Tiff_Iformat);
END;


OG_User_Exit

  例	  関連項目

説明  このプロシージャは、ユーザー定義実行可能プログラムを実行します。

構文

PROCEDURE OG_User_Exit
  (command  VARCHAR2);

パラメータ

command	ユーザー・イグジットおよびそれに渡す引数の名前。


OG_User_Exitの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose your display controls the operation of hardware
**components connected to your system.When the user selects
**a button, you may want to invoke the hardware controller
**routine, which you have linked in as a user exit.In addition,
**you may want to pass an argument to this user exit.The following
**procedure invokes the user exit 'hw_ctrl' with the parameter 'signal':
*/

PROCEDURE control_hw(buttonobj IN OG_Object, hitobj IN OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
BEGIN
   OG_User_Exit('Hw_Ctrl' || :signal);
END;


クイック・ツアーを呼び出すキャプションをタイプする
この文字で始まるビルトイン・サブプログラムはありません。


パラメータ・ビルトイン

OG_Delete_Param

OG_Get_Char_Param

OG_Get_Date_Param

OG_Get_Num_Param

OG_Get_Param_Type

OG_Param_Exists

OG_Set_Param


OG_Delete_Param

  例	  関連項目

説明　このプロシージャで、指定したパラメータを削除します。

構文

PROCEDURE OG_Delete_Param
  (param_name  VARCHAR2);

パラメータ

param_name	削除するパラメータの名前。


OG_Delete_Paramの例

  アルファベット順リスト         [image]  すべての例     [image]  関連項目

/* The following procedure deletes the parameter 'param0':
*/

PROCEDURE example IS
BEGIN
  OG_Delete_Parameter('Param0');
END;


OG_Get_Char_Param

  例	  関連項目

説明　このファンクションは、指定したデータ型がCHAR型のパラメータの値を取得するために使用します。このファンクションは、パラメータに対するバインド参照と等価です。

構文

FUNCTION OG_Get_Char_Param
  (param_name  VARCHAR2)
RETURN VARCHAR2;

パラメータ

param_name	取得する値のパラメータ名。
戻り値　指定したパラメータの値。

使用上の注意　このファンクションは、ライブラリに保存されているプログラム単位内でパラメータを参照する場合に便利です。バインド参照の場合、ライブラリのコンテキスト内ではコンパイルは失敗しますが、このファンクションの場合はコンパイルは成功します。


OG_Get_Char_Paramの例

  アルファベット順リスト       [image]  すべての例     [image]  関連項目

/* The following procedure gets the value of the parameter 'status',
**and changes the color of the specified object based on its value:
*/

PROCEDURE example(object OG_Object) IS
  stat  VARCHAR2(10);
BEGIN
  stat := OG_Get_Char_Param('Status');
  IF stat = 'obsolete' THEN
    OG_Set_Fillcolor(Object, 'red');
  END IF;
END;


OG_Get_Date_Param

  例	  関連項目

説明　このファンクションは、指定したデータ型がDATE型のパラメータの値を取得するために使用します。このファンクションは、パラメータに対するバインド参照と等価です。

構文

FUNCTION OG_Get_Date_Param
  (param_name  VARCHAR2,
   fmt         VARCHAR2)
RETURN DATE;

パラメータ

param_name	取得したい値のパラメータ名。
戻り値　指定したパラメータの値。

使用上の注意　このファンクションは、ライブラリに保存されているプログラム単位内でパラメータを参照する場合に便利です。バインド参照の場合、ライブラリのコンテキスト内ではコンパイルは失敗しますが、このファンクションの場合はコンパイルは成功します。


OG_Get_Date_Paramの例

  アルファベット順リスト         [image]  すべての例     [image]  関連項目

/* The following procedure gets the value of the parameter 'due_date',
**and changes the color of the specified object based on its value:
*/

*/

PROCEDURE example(object OG_Object) IS
  due  DATE;
BEGIN
  due := OG_Get_Date_Param('Due_Date');
  IF due < sysdate THEN
    OG_Set_Fillcolor(Object, 'red');
  END IF;
END;


OG_Get_Num_Param

  例	  関連項目

説明　このファンクションは、指定したデータ型がNUMBER型のパラメータの値を取得するために使用します。このファンクションは、パラメータに対するバインド参照と等価です。

構文

FUNCTION OG_Get_Num_Param
  (param_name  VARCHAR2)
RETURN NUMBER;

パラメータ

param_name	取得する値のパラメータ名。
戻り値　指定したパラメータの値。

使用上の注意　このファンクションは、ライブラリに保存されているプログラム単位内でパラメータを参照する場合に便利です。バインド参照の場合、ライブラリのコンテキスト内ではコンパイルは失敗しますが、このファンクションの場合はコンパイルは成功します。


OG_Get_Num_Paramの例

  アルファベット順リスト         [image]  すべての例     [image]  関連項目

/* The following procedure gets the value of the parameter 'priority', and increases it by 1:
*/

*/

PROCEDURE example IS
  val  NUMBER;
BEGIN
  val := OG_Get_Num_Param('Priority');
  OG_Set_Param('Priority', val + 1);
END;


OG_Get_Param_Type

  例	  関連項目

説明　このファンクションを使用すると、パラメータのデータ型が戻ります。

構文

FUNCTION OG_Get_Param_Type
  (param_name  VARCHAR2)
RETURN NUMBER;

パラメータ

param_name	パラメータの名前です。
戻り値　次のビルトイン定数のいずれか。

•	OG_Char_Paramtype

•	OG_Date_Paramtype

•	OG_Num_Paramtype


OG_Get_Param_Typeの例

  アルファベット順リスト         [image]  すべての例     [image]  関連項目

/* The following procedure retrieves the datatype of the parameter 'param0',
**then increases it by one if the type is NUMBER:
*/

*/

PROCEDURE example IS
  dtype  NUMBER;
BEGIN
  dtype := OG_Get_Param_Type('Param0');
  IF dtype = OG_Num_Paramtype THEN
    :param0 := :param0 + 1;
  END IF;
END;


OG_Param_Exists

  例	  関連項目

説明　このファンクションを使用して、特定のパラメータが作成されているかどうかを判別します。

構文

FUNCTION OG_Param_Exists
  (param_name  VARCHAR2)
RETURN BOOLEAN;

パラメータ

param_name	パラメータの名前です。
戻り値 TRUE	そのパラメータが存在する場合
FALSE	そのパラメータが存在しない場合


OG_Param_Existsの例

  アルファベット順リスト         [image]  すべての例     [image]  関連項目

/* The following procedure assigns drill-down behavior to a chart, but first verifies
**that the parameter it sets exists (and creates it if it doesn't exist):
*/

*/

PROCEDURE example(chart OG_Object, param_name VARCHAR2) IS
  chelement_group  OG_Object;
BEGIN
  IF NOT OG_Param_Exists(Param_Name) THEN
    OG_Set_Param(Param_Name, 10);
  END IF;

  chelement_group := OG_Get_Object('Sal_Bars', chart);
  OG_Set_Setparam(Chelement_Group, param_name);
  OG_Set_Keycol(Chelement_Group, 'DEPTNO');
END;


OG_Set_Param

  例	  関連項目

説明　このプロシージャで、指定したパラメータの値を設定します。指定したパラメータが存在しない場合、そのパラメータが作成されます。

構文

PROCEDURE OG_Set_Param                       date
  (param_name    VARCHAR2,
   param_value   DATE,
   param_format  VARCHAR2  :=  'DD-MON-YY');

PROCEDURE OG_Set_Param                       number
  (param_name   VARCHAR2,
   param_value  NUMBER);

PROCEDURE OG_Set_Param                       char
  (param_name   VARCHAR2,
   param_value  VARCHAR2);

パラメータ

param_name	設定する値のパラメータ名。
param_value	パラメータに設定する値。
param_format	param_valueを日付パラメータに変換するための書式マスク。
使用上の注意　このプロシージャは、ライブラリに保存されているプログラム単位内でパラメータを参照する場合に便利です。バインド参照の場合、ライブラリのコンテキスト内ではコンパイルは失敗しますが、このプロシージャではコンパイルは成功します。


OG_Set_Paramの例

  アルファベット順リスト         [image]  すべての例     [image]  関連項目

  関連項目 /* The following procedure gets the value of the parameter
**'priority', and increases it by 1:
*/

*/

PROCEDURE example IS
  val  NUMBER;
BEGIN
  val := OG_Get_Num_Param('Priority');
  OG_Set_Param('Priority', val + 1);
END;


ビルトイン問合せ

OG_Append_Row

OG_Clear_Query

OG_Data_Changed

OG_Data_Queried

OG_Destroy (問合せ)

OG_Execute_Query

OG_Get_Charcell

OG_Get_Datecell

OG_Get_Newrows

OG_Get_Numcell

OG_Get_Query

OG_Get_Schema

OG_Insert_Column

OG_Make_Query

OG_Next_Row

OG_Numcols

OG_Numrows

OG_Set_Charcell

OG_Set_Datecell

OG_Set_Numcell

OG_Set_Schema

OG_Start_From


OG_Append_Row

  例	  関連項目

説明  このプロシージャは、現在の行バッファをカスタム問合せの1番下に追加します。

構文

PROCEDURE OG_Append_Row
  (query_hdl  OG_Query);

パラメータ

query_hdl	行バッファが追加される問合せに対するハンドルです。
使用上の注意  OG_Set_Charcell、OG_Set_DatecellおよびOG_Set_Numcellを使用して、行バッファの内容を指定してください。


OG_Append_Rowの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to create a custom query using the ENAME, SAL, and
**HIREDATE columns in the existing query 'query0' as a basis.However, **in the new query, you want to double every SAL value.The following **procedure is a custom query procedure you could use:
*/

*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Query0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);

  FOR i IN 0..row_count loop
    other_ename := OG_Get_Charcell(Other_Query, 'ENAME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'HIREDATE');
    OG_Set_Charcell(Query, 'ENAME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'HIREDATE', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Clear_Query

  例	  関連項目

説明  このプロシージャは、指定された問合せからすべての行を削除します。

構文

PROCEDURE OG_Clear_Query
  (query_hdl  OG_Query);

パラメータ

query_hdl	消去する問合せに対するハンドル。


OG_Clear_Queryの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to create a custom query using the ENAME, SAL, and
**HIREDATE columns in the existing query 'query0' as a basis.However, **in the new query, you want to double every SAL value.The following **procedure is a custom query procedure you could use:
*/

*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Query0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);

  FOR i IN 0..row_count loop
    other_ename := OG_Get_Charcell(Other_Query, 'ENAME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'HIREDATE');
    OG_Set_Charcell(Query, 'ENAME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'HIREDATE', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Data_Changed

  例	  関連項目

説明  このファンクションは、指定された問合せのOG_Execute_Queryの最新のコールから生じた新規データと旧データを比較します。データ・セットが異なる場合はTRUEを、データ・セットが同じ場合はFALSEを返します。

構文

 FUNCTION OG_Data_Changed
  (query_hdl  OG_Query)
RETURN BOOLEAN;

パラメータ

query_hdl	問合せに対するハンドル。
戻り値 TRUE	データが変更された場合。
FALSE	データが変更されていない場合。
使用上の注意  このファンクションは、新規データと旧データの次の項目を比較し、不一致を検出した時点で停止します。

1	返された行数

2	問合せスキーマ

3	データのセルごとの比較（データ・セットが大きい場合は、この比較は時間がかかることに注意してください）


OG_Data_Changedの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to update a chart periodically, but only if the
**data has changed.You could write the following timer trigger:
*/

*/

PROCEDURE my_timer IS
   my_query   OG_Query;
   my_chart   OG_Object;
BEGIN
   my_query:=OG_Get_Query('Emp_Query');
   OG_Execute_Query(My_Query);
   IF OG_Data_Changed(My_Query) THEN
      my_chart:=OG_Get_Object('Emp_Chart');
      OG_Update_Chart(My_Chart, OG_All_Chupda);
   END IF;
END;


OG_Data_Queried

  例	  関連項目

説明  このファンクションは、指定された問合せのOG_Execute_Queryの最新のコールによって、指定されたデータ項目が問合せをされたかどうかを判別します。

構文

FUNCTION OG_Data_Queried
  (query_hdl   OG_Query,
   which_data  NUMBER)
RETURN BOOLEAN;

パラメータ

query_hdl	問合せに対するハンドル。
which_data	新規データまたは旧データのステータスをチェックするかどうかを指定します。Graphics Builderには、この引数の値として使用可能なビルトイン数値定数が2つあります。OG_NewdataとOG_Olddataです。
戻り値 TRUE	データが問合せをされた場合。
FALSE	データが問合せをされなかった場合。
使用上の注意  OG_Execute_Queryにより問合せが実行されなかった場合、データ項目の問合せも実行されずに、このファンクションはFALSEを返します。問合せが1回のみ実行された場合、このファンクションは新規データにTRUEを、旧データにFALSEを返します。問合せが2回以上実行された場合、このファンクションは常にTRUEを返します。


OG_Data_Queriedの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to use OG_Data_Changed to check if a query's
**data has changed, and then update a chart that uses that query.
**Before you do so, you may want to make sure that both the old and
**new data for the query have been queried.
*/

PROCEDURE check_and_update IS
   my_query   OG_Query;
   my_chart   OG_Object;
BEGIN
   my_query:=OG_Get_Query('Sales Query');
   IF OG_Data_Queried(My_Query, OG_Olddata) AND
OG_Data_Queried(My_Query, OG_Newdata) THEN
      IF data_changed(my_query) THEN
         my_chart:=OG_Get_Object('Sales Chart');
         OG_Update_Chart(My_Chart, OG_All_Chupda);
      END IF;
   END IF;
END;


OG_Destroy (問合せ)

  例	  関連項目

説明   このプロシージャは、指定された問合せを破棄します。

構文

PROCEDURE OG_Destroy
  (query_hdl  OG_Query);

パラメータ

query_hdl	破棄する問合せに対するハンドル。


OG_Destroy (Query)の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure destroys the specified query:
*/

*/

PROCEDURE destroy_query(query_name VARCHAR2) IS
  query  OG_Query;
BEGIN
  query := OG_Get_Query(Query_Name);
  OG_Destroy(Query);
END;


OG_Execute_Query

  例	  関連項目

説明  このプロシージャは、指定された問合せを実行し、その結果を内部に格納します。

構文

PROCEDURE OG_Execute_Query
  (query_hdl  OG_Query);

パラメータ

query_hdl	実行する問合せに対するハンドル。
使用上の注意  Builderで問合せを定義する必要があります。問合せがデータベースへのアクセスを必要としているときにデータベースが接続されていない場合、OG_No_Database_Connection例外状況が発生します。このプロシージャはデータを取り出すのみです。データをチャートに適用したり、他の方法でデータを操作しないでください。

各問合せでは、現在の問合せの結果（"新規"データ）および前回の問合せの結果（"旧"データ）の2つのデータ・セットが格納されます。したがって、前回問合せが実行された後でデータが変更されたときにのみチャートを更新するなど、データの変更に基づく操作を実行できます。データの操作およびチェックが可能な他のビルトイン・プロシージャおよびファンクションにより、使用するデータ・セットを指定できます。

このプロシージャのコールによって問合せが実行されなかった場合は、問合せ用の新規データおよび旧データは存在しません。問合せが最初に実行されたとき、その結果は新規データとして格納されますが、旧データは存在しません。その後、問合せが実行されるたびに旧データが破棄され、既存の新規データが旧データになり、問合せの最新結果が新規データとして格納されます。

問合せが実行されるたびに、新規データの暗黙的カーソルが作成されます。（他のプロシージャやファンクションのなかには、このカーソルを操作してデータをチェックできるものもあります）。新規データが旧データとして再分類されるときに、カーソル（およびデータ・リスト内のカーソルの現在位置）は維持されます。一方、新規カーソルはデータの有効行を自動的に指し示さないことに注意してください。使用するカーソルを準備するには、OG_Start_Fromを使用します。


OG_Execute_Queryの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to update a chart periodically.
**You could write the following timer trigger:
*/

*/

PROCEDURE every_30_secs IS
   the_query   OG_Query;
   the_chart   OG_Object;
BEGIN
   the_query:=OG_Get_Query('Emp_Query');
   the_chart:=OG_Get_Object('Emp_Chart');
   OG_Execute_Query(The_Query);
   OG_Update_Chart(The_Chart, OG_All_Chupda);
END;


OG_Get_Charcell

  例	  関連項目

説明  このファンクションは、指定された列の現在のデータ行で、指定された問合せの文字データ値を返します。

構文

FUNCTION OG_Get_Charcell
  (query_hdl   OG_Query,
   col_name    VARCHAR2)
RETURN VARCHAR2;

FUNCTION OG_Get_Charcell
  (query_hdl   OG_Query,
   which_data  NUMBER,
   col_name    VARCHAR2)
RETURN VARCHAR2;

パラメータ

query_hdl	返すデータを含む問合せに対するハンドル。
col_name	返すデータを含む列の名前。
which_data	セル値を旧データまたは新規データのどちらから取り出すかを指定します。指定しなかった場合、この引数値にはデフォルトのOG_Newdataが設定されます。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Newdata   セル値を新規データから取り出します。 OG_Olddata   セル値を旧データから取り出します。
戻り値  指定されたデータ・セルの内容。

使用上の注意  現在の行は、問合せを実行するためにOG_Execute_Queryを使用するときに、最初に作成される問合せの暗黙的カーソルにより決定されます。

データ表に表示された問合せ結果を表示する場合、このファンクションは現在の行と指定された列の交差するセルに含まれるデータを返します。

このファンクションを使用して、CHAR、VARCHAR2またはRAW型の列からデータ値を返すことができます。


OG_Get_Charcellの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*Suppose that you have a chart that
**displays employee salaries.The following
**procedure uses a format trigger to paint
**a specific employee's salary column
**yellow (in this case, "Scott's").
*/

PROCEDURE CharCell (elem IN og_object,

query IN og_query) IS

ename varchar2(10);

BEGIN

ename := og_get_charcell(query, OG_NEWDATA, 'ename');

if ename = 'SCOTT' then

og_set_bfcolor(elem, 'yellow');

end if;

END;


OG_Get_Datecell

  例	  関連項目

説明  このファンクションは、指定された列の現在のデータ行で、指定された問合せの日付データ値を返します。

構文

FUNCTION OG_Get_Datecell
  (query_hdl   OG_Query,
   which_data  NUMBER,
   col_name    VARCHAR2)
RETURN DATE;

パラメータ

query_hdl	返すデータを含む問合せに対するハンドル。
col_name	返すデータを含む列の名前。
which_data	セル値を旧データまたは新規データのどちらから取り出すかを指定します。指定しなかった場合、この引数値にはデフォルトのOG_Newdataが設定されます。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Newdata   セル値を新規データから取り出します。 OG_Olddata   セル値を旧データから取り出します。
戻り値  指定されたデータ・セルの内容。

使用上の注意  現在の行は、問合せを実行するためにOG_Execute_Queryを使用するときに、最初に作成される問合せの暗黙的カーソルにより決定されます。

データ表に表示された問合せ結果を表示する場合、このファンクションは現在の行と指定された列の交差するセルに含まれるデータを返します。


OG_Get_Datecellの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you have a bar chart that
**shows the hire dates of several employees.
**The following format trigger changes the
**column color for employees with
**a HireDate prior to '28-SEP-81'
**to green.
*/

 PROCEDURE DateCell (elem IN og_object,
                        query IN og_query) IS
  HireDate date;
BEGIN
  HireDate := og_get_datecell(query, OG_NEWDATA, 'HIREDATE');
  if HireDate < '28-SEP-81' then
     og_set_bfcolor(elem, 'green');
  end if;
END;


OG_Get_Newrows

  例	  関連項目

説明  このファンクションは、問合せに追加されるデータの新規行の数を決定します。

構文

FUNCTION OG_Get_Newrows
  (query  OG_Query)
RETURN NUMBER;

パラメータ

query	問合せに対するハンドル。
戻り値  前回実行された問合せに追加された行数。

使用上の注意  このファンクションは、問合せプロパティで新規データを旧データに追加するように指定している場合に便利です。新規データが旧データを置換する場合、このファンクションはOG_Numrowsと同じ結果を返します。


OG_Get_Newrowsの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you have a query that appends new data old data, but you want
**to know a cell value for the first new row returned.The following
**function sets the query's cursor to start at the first new row returned:
*/

*/

FUNCTION example(query OG_Query) RETURN CHAR IS
  total_rows  NUMBER;
  new_rows    NUMBER;
  new_name    VARCHAR2(10);
BEGIN
  OG_Execute_Query(Query);
  total_rows := OG_Numrows(Query, OG_Newdata);
  new_rows := OG_Get_Newrows(Query);
  OG_Start_From(Query, OG_Newdata, total_rows - new_rows);

  new_name := OG_Get_Charcell(Query, 'ENAME');
  RETURN(new_name);
END;


OG_Get_Numcell

  例	  関連項目

説明  このファンクションは、指定された列の現在のデータ行の、指定された問合せの数値データ値を返します。

構文

FUNCTION OG_Get_Numcell
  (query_hdl   OG_Query,
   col_name    VARCHAR2)
RETURN NUMBER;

FUNCTION OG_Get_Numcell
  (query_hdl   OG_Query,
   which_data  NUMBER,
   col_name    VARCHAR2)
RETURN NUMBER;

パラメータ

query_hdl	返すデータを含む問合せに対するハンドル。
col_name	返すデータを含む列の名前。
which_data	セル値を旧データまたは新規データのどちらから取り出すかを指定します。指定しなかった場合、この引数値にはデフォルトのOG_Newdataが設定されます。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Newdata   セル値を新規データから取り出します。 OG_Olddata   セル値を旧データから取り出します。
戻り値  指定されたデータ・セルの内容。

使用上の注意  現在の行は、問合せを実行するためにOG_Execute_Queryを使用するときに、最初に作成される問合せの暗黙的カーソルにより決定されます。

データ表に表示された問合せ結果を表示する場合、このファンクションは現在の行と指定された列の交差するセルに含まれるデータを返します。


OG_Get_Numcellの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following is an example of a
**format trigger that changes the color
**of the chosen chart element (e.g. pie
**slice or bar) to red if its value is
**greater than 200.

 PROCEDURE format_point (elem IN og_object, query IN
    og_query) IS
  st_price NUMBER;
BEGIN
  st_price:=OG_GET_NUMCELL (query, OG_NEWDATA, 'sell_pr');
IF st_price > 200 THEN
  OG_SET_BFCOLOR (elem,'red');
END IF;
END;


OG_Get_Query

  例	  関連項目

説明  このファンクションは、指定された問合せに対するハンドルを返します。

構文

FUNCTION OG_Get_Query
  (query_name  VARCHAR2)
RETURN OG_Query;

パラメータ

query_name	返されるハンドルを持つ問合せの名前。注意: QUERY_NAMEは大文字と小文字を区別します。
戻り値  指定された問合せに対するハンドル。

使用上の注意  問合せが存在しない場合、このファンクションはNULLハンドルを返します。


OG_Get_Queryの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to update a chart periodically.
**You could write the following timer trigger:
*/

*/

PROCEDURE every_30_secs IS
   the_query   OG_Query;
   the_chart   OG_Object;
BEGIN
   the_query:=OG_Get_Query('Emp_Query');
   the_chart:=OG_Get_Object('Emp_Chart');
   OG_Execute_Query(The_Query);
   OG_Update_Chart(The_Chart, OG_All_Chupda);


OG_Get_Schema

  例	  関連項目

説明  このファンクションは、問合せの特定の列のスキーマに関する情報を返します。

構文

 FUNCTION OG_Get_Schema
  (query_hdl   OG_Query,
   which_data  NUMBER,
   col_num     NUMBER)
RETURN OG_Colschema;

パラメータ

query_hdl	列を含む問合せに対するハンドル。
which_data	スキーマが取り出される列が問合せの旧データまたは新規データのどちらに存在するかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。OG_Newdata   列が問合せの新規データに存在します。 OG_Olddata   列が問合せの旧データに存在します。
col_num	取り出す列のスキーマを指定します。最初の列の番号は0で、2番目の列の番号は1です。
戻り値  指定された問合せ列のスキーマ。


OG_Get_Schemaの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to query a database table, and then use the name
**of the first column elsewhere in your application.Assume you have
**defined a parameter named 'my_query' that is of type CHAR,
**and that you have defined the following SQL query named 'query0':
*/

*/

&my_query

/* The following function takes a table name as an argument and
**returns the name of the table's first column:
*/

FUNCTION get_col_name (table_name IN VARCHAR2) RETURN VARCHAR2 IS
   my_schema    OG_Colschema;
   star_query   OG_Query;
BEGIN
   :my_query:='select * from ' || table_name;
   star_query:=OG_Get_Query('Query0');
   OG_Execute_Query(Star_Query);
   my_schema:=OG_Get_Schema(Star_Query, OG_Newdata, 0);
   RETURN(my_schema.colname);
END;


OG_Insert_Column

  例	  関連項目

説明  このプロシージャは、列をカスタム問合せに挿入します。

構文

PROCEDURE OG_Insert_Column
  (query_hdl  OG_Query,
   indx       NUMBER,
   schema     OG_Colschema);

パラメータ

query_hdl	列を挿入する問合せに対するハンドル。
indx	新規列を問合せ列リストに挿入する索引です。この引数は、0～n（両端の値を含む）の整数値である必要があります。ここで、nは挿入より前の問合せ列数です。次のビルトイン定数のいずれかを指定することもできます。  OG_First   問合せ列リストの最初に新規列を挿入します（索引 = 0）。 OG_Last   問合せ列リストの最後に新規列を挿入します（索引 = 挿入より前の問合せ列数）。
schema	挿入する列のスキーマ。


OG_Insert_Columnの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure creates 'query0', containing the columns ENAME
**and SAL:
*/

*/

PROCEDURE example IS
  query  OG_Query;
  col    OG_Colschema;
BEGIN
  query := OG_Make_Query('Query0', NULL);
  OG_Set_Querytype(Query, OG_Custom_Qtype);

  col.colname := 'ENAME';
  col.coltype := OG_Char_Coltype;
  col.maxlen := 10;

  OG_Insert_Column(Query, OG_Last, col);

  col.colname := 'SAL';
  col.coltype := OG_Number_Coltype;
  col.precision := 7;
  col.scale := 2;

  OG_Insert_Column(Query, OG_Last, col);

END;


OG_Make_Query

  例	  関連項目

説明  このファンクションは、問合せを作成します。

構文

FUNCTION OG_Make_Query
  (querytype    NUMBER,
   querysource  VARCHAR2
RETURN OG_Query;

パラメータ

querytype	問合せタイプ。値は、次のビルトイン定数のうちのいずれかを指定してください。OG_Custom_Qtype  問合せはカスタム問合せです。 OG_Exsql_Qtype  問合せによりSQL SELECT文を含むテキスト・ファイルからデータが取り出されます。 OG_Prn_Qtype  PRNファイルに基づいて問合せが行われます。 OG_Sql_Qtype  問合せはSQL SELECT文です。 OG_Sylk_Qtype  SYLKファイルに基づいて問合せが行われます。 OG_Wks_Qtype  WKSファイルに基づいて問合せが行われます。
querysource	問合せデータのソース。データベースからのデータの場合は、このプロパティに問合せのSQL SELECT文のテキストが含まれている必要があります。データがファイル・システムに格納されている場合は、このプロパティにデータ・ファイルのパスと名前を指定する必要があります。
戻り値  新規に作成された問合せに対するハンドル。


OG_Make_Queryの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function creates a SQL query:
*/

*/

FUNCTION example(query_name VARCHAR2) RETURN OG_Query IS
  query   OG_Query;
  qtype   NUMBER;
  qsource VARCHAR2(2000);
BEGIN
  qtype := OG_Sql_Qtype;
  qsource := 'select ename, sal from emp';

  query := OG_Make_Query(Qtype, qsource);

  OG_Set_Name(Query, query_name);
  OG_Execute_Query(Query);
  RETURN(query);
END;


OG_Next_Row

  例	  関連項目

説明

構文 このプロシージャは、指定された問合せに関連付けられた暗黙的カーソルをデータの次の行に進めます。

PROCEDURE OG_Next_Row
  (query_hdl   OG_Query,
   which_data  NUMBER);

パラメータ

query_hdl	問合せに対するハンドル。
which_data	旧データまたは新規データのどちらを処理するかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Newdata   問合せの新規データのカーソルを進めます。 OG_Olddata   問合せの旧データのカーソルを進めます。
使用上の注意  カーソルが問合せのデータの最後の行を指し示している場合は、OG_Next_Rowの次のコールによってカーソルの位置は変わりません。データが存在しない行にはカーソルは進まないので、エラーや例外は発生しません。カーソルがデータの最後の行を指し示していることを確認するには、OG_Numrowsを使用して正確な行数を決定してから、カーソルを進めるためにOG_Next_Rowを使用した回数を算出します。


OG_Next_Rowの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to name each bar in a bar chart so that when
**the user selects one of the bars you can determine which one it is
**by checking its name.For this example, assume the query for the chart
** is:
*/

*/

SELECT ENAME, SAL FROM EMP

/*The following procedure gives each bar the name of its category,
**which in this case is its associated ENAME:
*/
*/

PROCEDURE name_the_bars (my_chart IN OG_Object, my_query IN
  OG_Query) IS
   bar_rec    OG_Chelement_Ca;
   curr_row   NUMBER;
   total      NUMBER;
   bar_name   VARCHAR2(15);
BEGIN
   OG_Execute_Query(My_Query);
   OG_Start_From(My_Query, OG_Newdata, 0);
   total:=OG_Numrows(My_Query, OG_Newdata);
   FOR curr_row IN 0..total-1 LOOP
      bar_name:=OG_Get_Charcell(My_Query, OG_Newdata,
        'ENAME');
      bar_rec.chelement_cagr.mask:=OG_None_Graphica;
      bar_rec.chelement_cace.mask:=OG_Name_Chelementa;
      bar_rec.chelement_cace.name:=bar_name;
      OG_Set_Attr(My_Chart, curr_row, 'ENAME', bar_rec);
      OG_Next_Row(My_Query, OG_Newdata);
   END LOOP;
   OG_Update_Chart(My_Chart, OG_All_Chupda);
END;


OG_Numcols

  例	  関連項目

説明  このファンクションは、問合せに存在する列数を返します。

構文

FUNCTION OG_Numcols
  (query_hdl   OG_Query,
   which_data  NUMBER)
RETURN NUMBER;

パラメータ

query_hdl	問合せに対するハンドル。
which_data	新規データまたは旧データのどちらをチェックするかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Newdata   問合せの新規データの列数を返します。 OG_Olddata   問合せの旧データの列数を返します。
戻り値  指定された問合せ列数。


OG_Numcolsの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose Reports will pass data to your display, and you want to chart
** it.
**Since you may not be sure what columns your display will receive,
**you can make your charting procedure generic.You can write one
**procedure that creates an chart, then pass the query and chart to
**another procedure that inserts the query's columns as fields.The
**following procedure inserts the columns (it assumes the first column
**is the independent field, and the rest are dependent fields):
*/

*/

PROCEDURE add_columns(the_query OG_Query, the_chart OG_Object) IS
   num_of_cols   NUMBER(1);
   the_field     OG_Field;
   the_column    OG_Colschema;
BEGIN
   OG_Execute_Query(The_Query);
   num_of_cols:=OG_Numcols(The_Query, OG_Newdata);
   FOR i IN 0..num_of_cols-1 LOOP
      the_column:=OG_Get_Schema(The_Query, OG_Newdata, i);
      the_field.colname:=the_column.colname;
      IF i=0 THEN
         the_field.field_type:=OG_Independent;
      ELSE
         the_field.field_type:=OG_Dependent;
         the_field.ftname:='line';
      END IF;
      OG_Insert_Field(The_Chart, the_field, i);
   END LOOP;
   OG_Update_Chart(The_Chart, OG_All_Chupda);
END;


OG_Numrows

  例	  関連項目

説明  このファンクションは、問合せに存在する行数を返します。

構文

FUNCTION OG_Numrows
  (query_hdl   OG_Query,
   which_data  NUMBER)
RETURN NUMBER;

パラメータ

query_hdl	問合せに対するハンドル。
which_data	新規データまたは旧データのどちらをチェックするかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Newdata   問合せの新規データの行数を返します。 OG_Olddata   問合せの旧データの行数を返します。
戻り値  指定された問合せのデータの行数。


OG_Numrowsの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to name each bar in a bar chart so that when
**the user selects one of the bars you can determine which one it is
**by checking its name.For this example, assume the query for the chart
** is:
*/

*/

SELECT ENAME, SAL FROM EMP

/*The following procedure gives each bar the name of its category,
**which in this case is its associated ENAME:
*/
*/

PROCEDURE name_the_bars(my_chart IN OG_Object, my_query IN
  OG_Query) IS
   bar_rec    OG_Chelement_Ca;
   curr_row   NUMBER;
   total      NUMBER;
   bar_name   VARCHAR2(15);
BEGIN
   OG_Execute_Query(My_Query);
   OG_Start_From(My_Query, OG_Newdata, 0);
   total:=OG_Numrows(My_Query, OG_Newdata);
   FOR curr_row IN 0..total-1 LOOP
      bar_name:=OG_Get_Charcell(My_Query, OG_Newdata,
        'ENAME');
      bar_rec.chelement_cagr.mask:=OG_None_Graphica;
      bar_rec.chelement_cace.mask:=OG_Name_Chelementa;
      bar_rec.chelement_cace.name:=bar_name;
      OG_Set_Attr(My_Chart, curr_row, 'ENAME', bar_rec);
      OG_Next_Row(My_Query, OG_Newdata);
   END LOOP;
   OG_Update_Chart(My_Chart, OG_All_Chupda);
END;


OG_Set_Charcell

  例	  関連項目

説明  このプロシージャは、行バッファの文字列型セル値を設定します。

構文

PROCEDURE OG_Set_Charcell
  (query_hdl   OG_Query,
   col_name    VARCHAR2
   cell_value  VARCHAR2);

パラメータ

query_hdl	セル値を設定する問合せに対するハンドル。
col_name	設定するセルを含む列の名前。
cell_value	セルが含む値。
使用上の注意  バッファのすべてのセルに値を設定した後、OG_Append_Rowを使用して、カスタム問合せの最後に新規の行としてバッファを追加します。


OG_Set_Charcellの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to create a custom query using the ENAME, SAL,
**and HIREDATE columns in the existing query 'query0' as a basis.
**However, in the new query, you want to double every SAL value.
**The following procedure is a custom query procedure you could use:
*/

*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Query0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);
  FOR i IN 0..row_count-1 loop
    other_ename := OG_Get_Charcell(Other_Query, 'ENAME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'HIREDATE');
    OG_Set_Charcell(Query, 'ENAME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'HIREDATE', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Set_Datecell

  例	  関連項目

説明  このプロシージャは、行バッファの日付型セル値を設定します。

構文

PROCEDURE OG_Set_Datecell
  (query_hdl   OG_Query,
   col_name    VARCHAR2
   cell_value  DATE);

パラメータ

query_hdl	セル値を設定する問合せに対するハンドル。
col_name	設定するセルを含む列の名前。
cell_value	セルが含む値。
使用上の注意  バッファのすべてのセルに値を設定した後、OG_Append_Rowを使用して、カスタム問合せの最後に新規の行としてバッファを追加します。


OG_Set_Datecellの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to create a custom query using the ENAME, SAL,
**and HIREDATE columns in the existing query 'query0' as a basis.
**However, in the new query, you want to double every SAL value.
**The following procedure is a custom query procedure you could use:
*/

*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Query0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);
  FOR i IN 0..row_count-1 loop
    other_ename := OG_Get_Charcell(Other_Query, 'ENAME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'HIREDATE');
    OG_Set_Charcell(Query, 'ENAME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'HIREDATE', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Set_Numcell

  例	  関連項目

説明  このプロシージャは、行バッファの数値型セル値を設定します。

構文

PROCEDURE OG_Set_Numcell
  (query_hdl   OG_Query,
   col_name    VARCHAR2,
   cell_value  NUMBER);

パラメータ

query_hdl	セル値を設定する問合せに対するハンドル。
col_name	設定するセルを含む列の名前。
cell_value	セルが含む値。
使用上の注意  バッファのすべてのセルに値を設定した後、OG_Append_Rowを使用して、カスタム問合せの最後に新規の行としてバッファを追加します。


OG_Set_Numcellの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to create a custom query using the ENAME, SAL,
**and HIREDATE columns in the existing query 'query0' as a basis.
**However, in the new query, you want to double every SAL value.
**The following procedure is a custom query procedure you could use:
*/

*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Query0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);
  FOR i IN 0..row_count-1 loop
    other_ename := OG_Get_Charcell(Other_Query, 'ENAME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'HIREDATE');
    OG_Set_Charcell(Query, 'ENAME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'HIREDATE', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Set_Schema

  例	  関連項目

説明  このプロシージャは、カスタム問合せ列のスキーマを設定します。

構文

PROCEDURE OG_Set_Schema
  (query_hdl  OG_Query,
   col_num    NUMBER,
   schema     OG_Colschema);

パラメータ

query_hdl	設定するスキーマを持つ問合せに対するハンドル。
col_num	設定する列の索引。
schema	列を設定する新規スキーマ。


OG_Set_Schemaの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure changes the name of the fist column
**in a custom query from ENAME to EMPLOYEE:
*/

*/

PROCEDURE example(query OG_Query) IS
  schema  OG_Colschema;
BEGIN
  schema.colname := 'EMPLOYEE';
  schema.coltype := OG_Char_Coltype;
  schema.maxlen := 10;

  OG_Set_Schema(Query, 0, schema);

END;


OG_Start_From

  例	  関連項目

説明  このプロシージャは、指定された問合せに関連付けられた暗黙的カーソルが指定されたデータ行を指し示すように設定します。

構文

PROCEDURE OG_Start_From
  (query_hdl   OG_Query,
   which_data  NUMBER,
   start_row   NUMBER);

パラメータ

query_hdl	問合せに対するハンドル。
which_data	旧データまたは新規データのどちらを処理するかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Newdata   問合せの新規データのカーソルを設定します。 OG_Olddata   問合せの旧データのカーソルを設定します。
start_row	カーソルが位置する行番号。
使用上の注意  データの一番最初の行を指し示すには、オフセット値0を使用します。データの最後の行は、OG_Numrowsが返した値から1を引いたオフセット値になります。OG_Execute_Queryを使用して問合せを実行するたびにカーソル位置は廃棄されるので、設定し直す必要があることに注意してください。問合せを実行するたびに、問合せにより取り出される行数は変わる可能性があることに注意してください。


OG_Start_Fromの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to name each bar in a bar chart so that
**when the user selects one of the bars you can determine
**which one it is by checking its name.For this example,
**assume the query for the chart is:
*/

*/

SELECT ENAME, SAL FROM EMP

/*The following procedure gives each bar the name of its
**category, which in this case is its associated ENAME:
*/
*/

PROCEDURE name_the_bars (my_chart IN OG_Object, my_query IN
  OG_Query) IS
   bar_rec    OG_Chelement_Ca;
   curr_row   NUMBER;
   total      NUMBER;
   bar_name   VARCHAR2(15);
BEGIN
   OG_Execute_Query(My_Query);
   OG_Start_From(My_Query, OG_Newdata, 0);
   total:=OG_Numrows(My_Query, OG_Newdata);
   FOR curr_row IN 0..total-1 LOOP
      bar_name:=OG_Get_Charcell(My_Query, OG_Newdata,
        'ENAME');
      bar_rec.chelement_cagr.mask:=OG_None_Graphica;
      bar_rec.chelement_cace.mask:=OG_Name_Chelementa;
      bar_rec.chelement_cace.name:=bar_name;
      OG_Set_Attr(My_Chart, curr_row, 'ENAME', bar_rec);
      OG_Next_Row(My_Query, OG_Newdata);
   END LOOP;
   OG_Update_Chart(My_Chart, OG_All_Chupda);
END;


この文字で始まるビルトイン・サブプログラムはありません。


サウンド・ビルトイン

OG_Destroy（サウンド）

OG_Export_Sound

OG_Get_Sound

OG_Import_Sound

OG_Make_Sound

OG_Play_Sound

OG_Record_Sound

OG_Stop_Sound


OG_Destroy（サウンド）

  例	  関連項目

説明  このプロシージャで、指定されているサウンドを破棄します。

構文

PROCEDURE OG_Destroy
  (sound_hdl  OG_Sound);

パラメータ

sound_hdl	破棄するサウンドのハンドルです。


OG_Destroy（サウンド）の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure destroys the specified sound:
*/

*/

PROCEDURE destroy_sound(sound_name VARCHAR2) IS
  sound  OG_Sound;
BEGIN
  sound := OG_Get_Sound(Sound_Name);
  OG_Destroy(Sound);
END;


OG_Export_Sound

  例	  関連項目

説明  このプロシージャで、サウンドをエクスポートします。

構文

PROCEDURE OG_Export_Sound
  (name        VARCHAR2,
   repository  NUMBER,
   format      NUMBER,
   sound_hdl   OG_Sound);

パラメータ

name	サウンドのエクスポート先の名前。サウンドがデータベースに格納される場合、この引数には、サウンド・モジュール名のみを指定してください。サウンドがファイル・システムに格納される場合は、この引数には、サウンド・ファイルの絶対パス名か相対パス名を指定してください。
repository	サウンドを、ファイル・システムとデータベースのどちらに格納するかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db  サウンドはデータベースに格納されます。 OG_Filesystem  サウンドはファイル・システムに格納されます。
format	サウンドのエクスポート形式を指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。OG_Aiff_Sformat  サウンドがAIFF形式で保存されていることを示します。 OG_Aiffc_Sformat  サウンドがオーディオ交換ファイル形式-cで保存されていることを示します。 OG_Au_Sformat  サウンドが、SUN au形式で保存されていることを示します。 OG_Wave_Sformat  サウンドが、PCM WAVE形式で保存されていることを示します。
sound_hdl	エクスポートされるサウンドのハンドルです。


OG_Export_Soundの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to export the sound named 'sound0' to the AIFF-c file
**'my_sound' so that you can later import it into some other application.
** The following procedure does this:
*/

*/

PROCEDURE export_the_sound IS
   the_sound   OG_Sound;
BEGIN
   the_sound:=OG_Get_Sound('Sound0');
   OG_Export_Sound('My_Sound', OG_Filesystem,
OG_Aiffc_Sformat, the_sound);
END;


OG_Get_Sound

  例	  関連項目

説明  この関数は、指定されたサウンドのハンドルを戻します。

構文

FUNCTION OG_Get_Sound
   (sound_name  VARCHAR2)
RETURN OG_Sound;

パラメータ

sound_name	戻るサウンドのハンドル名。
戻り値  指定されたサウンドのハンドル。指定のサウンドが存在しない場合は、NULLハンドルが戻ります。


OG_Get_Soundの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to play a warning sound, to indicate
**low inventory or an illegal action by the user.
*/

PROCEDURE warning IS
   the_sound   OG_Sound;
BEGIN
   the_sound:=OG_Get_Sound('Warning_Snd');
   OG_Play_Sound(The_Sound);
END;


OG_Import_Sound

  例	  関連項目

説明  この関数は、データベースまたはファイルからサウンドをインポートします。

構文

FUNCTION OG_Import_Sound
  (name        VARCHAR2,
   repository  NUMBER,
   format      NUMBER,
   sound_name  VARCHAR2)
RETURN OG_Sound;

パラメータ

name	格納されているサウンドの名前。サウンドがデータベースに格納されている場合、この引数にはサウンド名のみを指定してください。サウンドがファイル・システムに格納されている場合、この引数には、サウンド・ファイルの絶対パス名か相対パス名を指定してください。
repository	サウンドが、ファイル・システムとデータベースのどちらに格納されているかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db   サウンドがデータベースに格納されていることを示します。 OG_Filesystem  サウンドがファイル・システムに格納されていることを示します。
format	サウンドの保存形式を指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。OG_Aiff_Sformat  サウンドがAIFF形式で保存されていることを示します。 OG_Aiffc_Sformat  サウンドがAIFF-c形式で保存されていることを示します。 OG_Any_Sformat  Graphics Builderが自動的にサウンドの形式を決定することを示します。注意: 現在は使用されていないOracleフォーマットでサウンドがエクスポートされた場合は、この形式を指定してください。 OG_Au_Sformat  サウンドが、SUN au形式で保存されていることを示します。 OG_Oracle_Sformat  サウンドが、他のOracle製品で使用されているOracleフォーマットで保存されていることを示します。 OG_Wave_Sformat  サウンドがWAV形式で保存されていることを示します。
sound_name	Graphics Builderでサウンドに割り当てられる名前。この名前をもつ別のサウンドがすでに存在している場合、Graphics Builderでは、そのサウンドはインポート・サウンドに置換されます。
戻り値 インポートされたサウンドのハンドル。


OG_Import_Soundの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to import the contents of the AIFF-c file
**'my_sound' into your display as the sound named 'sound0'.
** The following procedure does this:
*/

*/

PROCEDURE import_the_sound IS
   the_sound   OG_Sound;
BEGIN
   the_sound:=OG_Import_Sound('My_Sound', OG_Filesystem,
OG_Aiffc_Sformat, 'sound0');
END;


OG_Make_Sound

  例	  関連項目

説明  この関数は、データベース表に格納されているデータからサウンドを作成します。

構文

FUNCTION OG_Make_Sound
  (query       OG_Query,
   which_data  NUMBER,
   colname     VARCHAR2)
RETURN OG_Sound;

パラメータ

query	データベースの表からサウンドを検索する問合せのハンドル。なお、この表はユーザーの表であることが必要です。データベースにモジュールを保存またはエクスポートするときにGraphics Builderによって使用されるプライベート表は指定できません。
which_data	作成されるサウンドが、問合せの新規データ・セット内に含まれているか、旧データ・セットに含まれているかを指定します。Graphics Builderには、この属性の値として使用可能なビルトイン数値定数が2つあります。 OG_Newdata  サウンドが問合せの新規データ・セットに含まれていることを示します。 OG_Olddata  サウンドが問合せの旧データ・セットに含まれていることを示します。
colname	サウンド・データが入る問合せ列の名前。作成されるサウンドは、この属性により指定される列と問合せのカーソルが指している行の交差位置の問合せセルに含まれているものです。
戻り値 新規に作成されたサウンドのハンドル。


OG_Make_Soundの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function creates a sound from data in the sixth
**row of the query 'sound_query' in the column SOUND_COLUMN:
*/

*/

FUNCTION example(sound_name VARCHAR2) RETURN OG_Sound IS
  query  OG_Query;
  sound  OG_Sound;
BEGIN
  query := OG_Get_Query('Sound_Query');
  OG_Execute_Query(Query);
  OG_Start_From(Query, OG_Newdata, 5);
  sound := OG_Make_Sound(Query, OG_Newdata, 'SOUND_COLUMN');

  OG_Set_Name(Sound, sound_name);
  RETURN(sound);
END;


OG_Play_Sound

  例	  関連項目

説明 このプロシージャで、ユーザーが指定したサウンド出力デバイスを使用して、指定のサウンドを再生します。

構文

PROCEDURE OG_Play_Sound
 (sound_hdl OG_Sound);

パラメータ

sound_hdl	再生されるサウンドのハンドル。


OG_Play_Soundの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to play a warning sound, to indicate
**low inventory or an illegal action by the user.
*/

PROCEDURE warning IS
   the_sound   OG_Sound;
BEGIN
   the_sound:=OG_Get_Sound('Warning_Snd');
   OG_Play_Sound(The_Sound);
END;


OG_Record_Sound

  例	  関連項目

説明  このプロシージャで、サウンド・ダイアログ・ボックスの表示と新規サウンドの録音ができます。

構文

PROCEDURE OG_Record_Sound  (sound_hdl  OG_Sound);

パラメータ

sound_hdl	サウンドのハンドル。
使用上の注意  新規サウンドは、sound_hdlで指したサウンドに上書きされます。また、sound_hdlが指すサウンドは、Builderまたはビルトイン・ファンクションOG_Import_SoundおよびOG_Makeで以前作成されたものです。


OG_Record_Soundの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want the user to record a sound to be played as a warning
**when data changes.You could write the following procedure:
*/

*/

PROCEDURE record_warning IS
   warn_sound   OG_Sound;
BEGIN
   warn_sound:=OG_Get_Sound('Warning');
   IF not OG_Isnull(Warn_Sound) THEN
      OG_Record_Sound(Warn_Sound);
   END IF;
END;


OG_Stop_Sound

  例	  関連項目

説明  このプロシージャで、再生処理中のサウンドの再生を取り消します。

構文

PROCEDURE OG_Stop_Sound
  (sound_hdl   OG_Sound);

パラメータ

sound_hdl	再生を停止するサウンドのハンドル。


OG_Stop_Soundの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to create a button that the user
**can select to cancel a sound that is currently playing.
**The following button procedure does this:
*/

*/

PROCEDURE OGBUTTONPROC0 (buttonobj IN OG_Object, hitobj IN OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
  sound  OG_Sound;
BEGIN
  sound := OG_Get_Sound('Alarm');
  OG_Stop_Sound(Sound);
END;


テンプレート・ビルトイン

OG_Clone（テンプレート）

OG_Delete_Ftemp

OG_Delete_Refline

OG_Destroy (テンプレート)

OG_Export_Template

OG_Get_Axis

OG_Get_Ftemp

OG_Get_Refline

OG_Get_Template

OG_Import_Template

OG_Insert_Ftemp

OG_Insert_Refline

OG_Make_Template


OG_Clone（テンプレート）

  例	  関連項目

説明  このファンクションは指定したテンプレートと一致する、新規チャート・テンプレートを作成します。

構文

FUNCTION OG_Clone
  (template_hdl  OG_Template,
   name          VARCHAR2)
RETURN OG_Template;

パラメータ

template_hdl	ひな型となるチャート・テンプレートのハンドル。
name	新規テンプレートに付ける名前。
戻り値  新規に作成されたテンプレートのハンドル。


OG_Clone（テンプレート）の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you have created  atemplate, and you want to create another
**identical template without having to again specify the same properties.
*/

PROCEDURE dup_template(old_template IN OG_Template) IS
   new_template   OG_Template;
BEGIN
   new_template:=OG_Clone(Old_Template);
END;


OG_Delete_Ftemp

  例	  関連項目

説明  このプロシージャで、指定されたチャート・テンプレートから1つ以上のフィールド・テンプレートを削除します。

構文

PROCEDURE OG_Delete_Ftemp
  (template_hdl  OG_Template,
   indx          NUMBER,
   total         NUMBER);

パラメータ

template_hdl	チャート・テンプレートのハンドル。
indx	削除する最初のフィールド・テンプレートの索引。
total	削除するフィールド・テンプレートの合計数。


OG_Delete_Ftempの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure deletes a column from the template 'template0':
*/

*/

PROCEDURE example(ft_num  NUMBER) IS
  template  OG_Template;
BEGIN
  template := OG_Get_Template('Template0');
  OG_Delete_Ftemp(Template, ft_num, 1);
END;


OG_Delete_Refline

  例	  関連項目

説明  このプロシージャで、指定されたチャート・テンプレートから1つ以上の参照線を削除します。

構文

PROCEDURE OG_Delete_Refline
  (template_hdl  OG_Template,
   indx          NUMBER,
   total         NUMBER);

パラメータ

template_hdl	チャート・テンプレートのハンドル。
indx	削除する最初の参照線の索引。
total	削除する参照線の合計数。


OG_Delete_Reflineの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure deletes a reference line template 'template0':
*/

*/

PROCEDURE example(rl_num  NUMBER) IS
  template  OG_Template;
BEGIN
  template := OG_Get_Template('Template0');
  OG_Delete_Refline(Template, rl_num, 1);
END;


OG_Destroy（テンプレート）

  例	  関連項目

説明  このプロシージャで、指定されたチャート・テンプレートを破棄します。

構文

PROCEDURE OG_Destroy
  (template_hdl  OG_Template);

パラメータ

template_hdl	破棄するチャート・テンプレートのハンドル。


OG_Destroy（テンプレート）の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure destroys the specified template:
*/

*/

PROCEDURE destroy_template(template_name VARCHAR2) IS
  template  OG_Template;
BEGIN
  template := OG_Get_Template(Template_Name);
  OG_Destroy(Template);
END;


OG_Export_Template

  例	  関連項目

説明  このプロシージャで、チャート・テンプレートをエクスポートします。

構文

PROCEDURE OG_Export_Template
  (name          VARCHAR2,
   repository    NUMBER,
   template_hdl  OG_Template);

パラメータ

name	テンプレートのエクスポート先の名前。テンプレートがデータベースに格納される場合、この引数には、テンプレート名のみを指定してください。テンプレートがファイル・システムに格納される場合は、テンプレート・ファイルの絶対パス名または相対パス名を指定してください。
repository	テンプレートをファイル・システムとデータベースのどちらに格納するかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db   テンプレートはデータベースに格納されます。 OG_Filesystem   テンプレートはファイル・システムに格納されます。
tamplate_hdl	エクスポートされるテンプレートのハンドル。


OG_Export_Templateの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to export the chart template named 'template0'
**to the file 'my_temp' so that you can later import it into some other
**Graphics Builder display.The following procedure does this:
*/

*/

PROCEDURE export_the_template IS
   the_temp   OG_Template;
BEGIN
   the_temp:=OG_Get_Template('Template0');
   OG_Export_Template('My_Temp', OG_Filesystem, the_temp);
END;


OG_Get_Axis

  例	  関連項目

説明  このファンクションは、チャート・テンプレートにある軸のハンドルを戻します。

構文

FUNCTION OG_Get_Axis
  (template_hdl  OG_Template,
   which_axis    NUMBER)
RETURN OG_Axis;

パラメータ

template_hdl	ハンドルが戻される軸を含んでいるチャート・テンプレートのハンドル。
which_axis	どの軸が戻されるかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_X_Axis    OG_Y1_Axis    OG_Y2_Axis
戻り値  指定された軸のハンドル。指定されたボタン・プロシージャが存在しない場合はNULLが返されます。


OG_Get_Axisの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns a handle to the specified template's X axis:
*/

*/

FUNCTION example(template_name VARCHAR2) RETURN OG_Axis IS
  template  OG_Template;
  axis      OG_Axis;
BEGIN
  template := OG_Get_Template(Template_Name);
  axis := OG_Get_Axis(Template, OG_X_Axis);
  RETURN(axis);
END;


OG_Get_Ftemp

  例	  関連項目

説明  このファンクションは、チャート・テンプレート内のフィールド・テンプレートのハンドルを戻します。

構文

FUNCTION OG_Get_Ftemp
  (template_hdl  OG_Template,
   indx          NUMBER)
RETURN OG_Ftemp;

パラメータ

template_hdl	ハンドルが戻されるフィールド・テンプレートを含んでいるチャート・テンプレートのハンドル。
indx	チャートのフィールド・テンプレート・リストの中で戻されるフィールド・テンプレートの索引。
戻り値  指定されたフィールド・テンプレートのハンドル。


OG_Get_Ftempの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the handle to the
**first field template in the specified chart template:
*/

*/

FUNCTION example(temp_name VARCHAR2) RETURN OG_Ftemp IS
  template  OG_Template;
  ftemp   OG_Ftemp;
BEGIN
  template := OG_Get_Template(Temp_Name);
  ftemp := OG_Get_Ftemp(Template, 0);
  RETURN(ftemp);
END;


OG_Get_Refline

  例	  関連項目

説明  このファンクションは、チャート・テンプレート内の参照線のハンドルを戻します。

構文

FUNCTION OG_Get_Refline
  (template_hdl  OG_Template,
   indx          NUMBER)
RETURN OG_Refline;

パラメータ

template_hdl	戻される参照線が含まれているチャート・テンプレートのハンドル。
indx	戻されるチャートの参照線リストの中で戻される参照線の索引。
戻り値  指定された参照線のハンドル。


OG_Get_Reflineの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function returns the handle to the
**first reference line in the specified chart template:
*/

*/

FUNCTION example(temp_name VARCHAR2) RETURN OG_Refline IS
  template  OG_Template;
  refline   OG_Refline;
BEGIN
  template := OG_Get_Template(Temp_Name);
  refline := OG_Get_Refline(Template, 0);
  RETURN(refline);
END;


OG_Get_Template

  例	  関連項目

説明  このファンクションは、指定されたテンプレートのハンドルを戻します。

構文

FUNCTION OG_Get_Template
  (template_name  VARCHAR2)
RETURN OG_Template;

パラメータ

template_name	ハンドルが戻されるチャート・テンプレートの名前。
戻り値  指定されたチャート・テンプレートのハンドル。そのテンプレートが存在しない場合は、NULLハンドルが戻ります。


OG_Get_Templateの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to create a chart programmatically.You would need to assign attribute values (including a template) to a chart combined attribute record, then pass that record to OG_Make.
*/

PROCEDURE create_emp_chart IS
   chart_rec      OG_Chart_Ca;
   the_template   OG_Template;
   the_query      OG_Query;
   the_chart      OG_Object;
BEGIN
   the_template:=OG_Get_Template('Emp_Template');
   the_query:=OG_Get_Query('Emp_Query');
   chart_rec.chart_caoc.template:=the_template;
   chart_rec.chart_caoc.query:=the_query;
   chart_rec.chart_caob.mask:=OG_None_Generica;
   chart_rec.chart_caog.mask:=OG_None_Groupa;
   chart_rec.chart_caoc.mask:=OG_Template_Charta+
                              OG_Query_Charta;
   the_chart:=OG_Make(Chart_Rec);
END;


OG_Import_Template

  例	  関連項目

説明  このファンクションは、チャート・テンプレートをインポートします。

構文

FUNCTION OG_Import_Template
  (name           VARCHAR2,
   repository     NUMBER,
   template_name  VARCHAR2)
RETURN OG_Template;

パラメータ

name	テンプレートの格納時の名前。テンプレートがデータベースに格納されている場合、この引数には、テンプレート名のみを指定してください。テンプレートがファイル・システムに格納されている場合は、テンプレート・ファイルの絶対パス名または相対パス名を指定してください。
repository	テンプレートがファイル・システムとデータベースのどちらに格納されているかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db   テンプレートがデータベースに格納されていることを示します。 OG_Filesystem   テンプレートがファイル・システムに格納されていることを示します。
template_name	Graphics Builderでテンプレートに割り当てられる名前。この名前のテンプレートがすでに存在している場合、Graphics Builderでは、そのテンプレートはインポートされたテンプレートに置換されます。
戻り値  インポートされたテンプレートのハンドル。


OG_Import_Templateの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you want to import the chart template file 'my_temp'
**into your display as the template named 'template0'.
** The following procedure does this:
*/

*/

PROCEDURE import_the_template IS
   the_temp   OG_Template;
BEGIN
   the_temp:=OG_Import_Template('My_Temp', OG_Filesystem,
'template0');
END;


OG_Insert_Ftemp

  例	  関連項目

説明  このプロシージャで、新規フィールド・テンプレートを指定されたチャート・テンプレートに挿入します。

構文

PROCEDURE OG_Insert_Ftemp                    pie/table chart
  (template_hdl  OG_Template,
   attr          OG_Ftemp_Attr,
   indx          NUMBER);

PROCEDURE OG_Insert_Ftemp                    axis chart
  (template_hdl  OG_Template,
   attr          OG_Axisftemp_Ca,
   indx          NUMBER);

パラメータ

template_hdl	チャート・テンプレートのハンドル。
attr	フィールド・テンプレートの属性を含むレコード。
indx	新規フィールド・テンプレートをチャート・テンプレートに挿入するときの索引。この引数は、0～ nの整数(0、n を含む)を指定してください。nは、チャート・テンプレート内の挿入前のフィールド・テンプレート数です。次のビルトイン定数のいずれかを指定することもできます。  OG_First   新規フィールド・テンプレートを、チャート・テンプレートの先頭に挿入することを示します (index = 0)。 OG_Last   新規フィールド・テンプレートをチャート・テンプレートの最後に挿入することを示します(index = チャート・テンプレート内の挿入前のフィールド・テンプレート数)。


OG_Insert_Ftempの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure inserts a new field
**template into the specified chart template.
*/

PROCEDURE example(template OG_Template) IS
  attr  OG_Axisftemp_Ca;
BEGIN
  attr.ca_aftemp.plottype := OG_Bar_Plottype;
  attr.ca_ftemp.name := 'column';
  attr.ca_aftemp.mask:= OG_Plottype_Axisftempa;
  attr.ca_ftemp.mask := OG_Name_Ftempa;

  OG_Insert_Ftemp(Template, attr, 0);
END;


OG_Insert_Refline

  例	  関連項目

説明  このプロシージャで、新規の参照線を指定されたチャート・テンプレートに挿入します。

構文

PROCEDURE OG_Insert_Refline
  (template_hdl  OG_Template,
   attr          OG_Refline_Attr,
   indx          NUMBER);

パラメータ

template_hdl	チャート・テンプレートのハンドル。
attr	参照線の属性を含んでいるレコード。
indx	新規の参照線をチャート・テンプレートに挿入するときの索引。この引数は、0～ nの整数(0、nを含む)を指定してください。n は、チャート・テンプレート内の挿入前の参照線の数です。次のビルトイン定数のいずれかを指定することもできます。  OG_First   新規の参照線を、チャート・テンプレートの先頭(index = 0)に挿入することを示します。 OG_Last   新規の参照線をチャート・テンプレートの最後に挿入することを示します(index = チャート・テンプレート内の挿入前の参照線の数)。


OG_Insert_Reflineの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure inserts a new refernce
**line into the specified chart template.
*/

PROCEDURE example(template OG_Template) IS
  attr  OG_Refline_Attr;
BEGIN
  attr.numvalue := 1000;
  attr.label := 'Average';
  attr.mask:= OG_Value_Reflinea+
              OG_Label_Reflinea;

  OG_Insert_Refline(Template, attr, 0);
END;


OG_Make_Template

  例	  関連項目

説明  このファンクションはチャート・テンプレートを作成します。

構文

FUNCTION OG_Make_Template
  (name        VARCHAR2,
   chart_type  NUMBER
RETURN OG_Template;

パラメータ

name	テンプレート名。
chart_type	テンプレートのチャート型。値は、次のビルトイン定数のうちのいずれかを指定してください。  OG_Column OG_Column_Stacked OG_Column_Overlap OG_Column_Pct OG_Column_Zero OG_Column_Shadow OG_Column_3d OG_Column_Line OG_Bar OG_Bar_Stacked OG_Bar_Overlap OG_Bar_Pct OG_Bar_Zero OG_Bar_Shadow OG_Bar_3d OG_Bar_Line OG_Line OG_Line_Symbol OG_Line_Stacked OG_Line_Fill OG_Step OG_Step_Symbol OG_Step_Stacked OG_Step_Fill OG_Spline OG_Spline_Symbol OG_Spline_Stacked OG_Spline_Fill OG_Mixed_Line OG_Mixed_Fill OG_Mixed_Spline OG_Mixed_Spfill OG_Doubley_Column OG_Doubley_Overlap OG_Doubley_Line OG_Doubley_Symbol OG_Highlow_Symbol OG_Highlow_Spike OG_Highlow_Both OG_Highlow_Line OG_Highlow_Fill OG_Scatter_Symbol OG_Scatter_Curvefit OG_Scatter_Linear OG_Scatter_Log OG_Scatter_Loglog OG_Scatter_Connect OG_Gantt OG_Gantt_Shadow OG_Gantt_Depth OG_Pie OG_Pie_Shadow OG_Pie_Depth OG_Pie_Depth OG_Table OG_Table_Shadow OG_Table_Depth
戻り値  新規に作成されたテンプレートのハンドル。


OG_Make_Templateの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function creates a column
**chart template with shadows on the bars:
*/

*/

FUNCTION example RETURN OG_Template IS
  template  OG_Template;
BEGIN
  template := OG_Make_Template('Template0', OG_Column_Shadow);
  RETURN(template);
END;


タイマー・ビルトイン

OG_Activate_Timer

OG_Deactivate_Timer

OG_Destroy（タイマー）

OG_Get_Timer

OG_Make_Timer


OG_Activate_Timer

  例	  関連項目

説明 このプロシージャで、指定されたタイマーをアクティブにします。

構文

PROCEDURE OG_Activate_Timer
  (timer_hdl  OG_Timer);

パラメータ

timer_hdl	アクティブにするタイマーのハンドル。
使用上の注意  図表がオープンされると、デフォルトですべてのタイマーがアクティブになります。OG_Deactivate_Timerプロシージャを使用して明示的にタイマーを非アクティブにしない限りは、タイマーをアクティブにする必要はありません。


OG_Activate_Timerの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you have created timers to update all of your charts
**every 30 seconds, and that you have deactivated the timers
**for charts that are not displayed.When you display a chart,
**however, you want to re-activate its timer.
*/

PROCEDURE activate_emp_timer IS
   my_timer   OG_Timer;
BEGIN
   my_timer:=OG_Get_Timer('Emp_Timer');
   OG_Activate_Timer(My_Timer);
END;


OG_Deactivate_Timer

  例	  関連項目

説明  このプロシージャで、指定されたタイマーを非アクティブにします。

構文

PROCEDURE OG_Deactivate_Timer
  (timer_hdl  OG_Timer);

パラメータ

timer_hdl	タイマーのハンドル。
使用上の注意  図表をオープンすると、すべてのタイマーは自動的にアクティブになります。タイマーを非アクティブにするには、このプロシージャを実行して明示的に非アクティブにする必要があります。図表の表示されている部分でタイマーが必要なければ、非アクティブにしたほうが効率的です。システムで不要なタイマーの処理に時間を費やす必要がなくなります。


OG_Deactivate_Timerの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you have created timers to update all of your
**charts every 30 seconds, and that you have deactivated
**the timers for charts that are not displayed.
*/

PROCEDURE deactivate_emp_timer IS
   my_timer   OG_Timer;
BEGIN
   my_timer:=OG_Get_Timer('Emp_Timer');
   OG_Deactivate_Timer(My_Timer);
END;


OG_Destroy（タイマー）

  例	  関連項目

説明  このプロシージャで、指定されたタイマーを破棄します。

構文

PROCEDURE OG_Destroy
  (timer_hdl  OG_Timer);

パラメータ

timer_hdl	破棄するタイマーのハンドル。


OG_Destroy（タイマー）の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure destroys the specified timer:
*/

*/

PROCEDURE destroy_timer(timer_name VARCHAR2) IS
  timer  OG_Timer;
BEGIN
  timer := OG_Get_Timer(Timer_Name);
  OG_Destroy(Timer);
END;


OG_Get_Timer

  例	  関連項目

説明  このファンクションは、指定されたタイマーのハンドルを戻します。

構文

FUNCTION OG_Get_Timer
  (timer_name  VARCHAR2)
RETURN OG_Timer;

パラメータ

timer_name	ハンドルが戻されるタイマーの名前。
戻り値  指定されたタイマーのハンドル。指定されたタイマーが存在しない場合、このファンクションはNULLハンドルを戻します。


OG_Get_Timerの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose you have created timers to update all of your
**charts every 30 seconds, and that you have deactivated
**the timers for charts that are not displayed.When you
**display a chart, however, you want to re-activate its timer.
*/

PROCEDURE activate_emp_timer IS
   my_timer   OG_Timer;
BEGIN
   my_timer:=OG_Get_Timer('Emp_Timer');
   OG_Activate_Timer(My_Timer);
END;


OG_Make_Timer

  例	  関連項目

説明  このファンクションはタイマーを作成します。

構文

FUNCTION OG_Make_Timer
  (interval   OG_Point,
   timerproc  VARCHAR2
RETURN OG_Timer;

パラメータ

interval	タイマーが起動する間隔 (秒単位)。
timerproc	設定された時間間隔で実行するプロシージャの名前。
戻り値  新規に作成されたタイマーのハンドル。


OG_Make_Timerの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure creates a timer that executes
**the procedure 'update_proc' every 30 seconds.
*/

PROCEDURE example(timer_name VARCHAR2) IS
  timer  OG_Timer;
BEGIN
  timer := OG_Make_Timer(30, 'update_proc');
  OG_Set_Name(Timer, timer_name);
END;


TOOLS_INTビルトイン

TOOLINTADDPARAMETER

TOOLINTCREATEPARAMETERLIST

TOOLINTDELETEPARAMETER

TOOLINTDESTROYPARAMETERLIST

TOOLINTGETPARAMETERATTR

TOOLINTGETPARAMETERLIST

TOOLINTISNULL

TOOLINTRUNPRODUCT

TOOLINTSETPARAMETERATTR


TOOL_INT.ADD_PARAMETER

  例	  関連項目

説明  このプロシージャで、指定されたパラメータ・リストにパラメータを追加します。

構文

PROCEDURE TOOL_INT.add_parameter
  (list_hdl    TOOL_INT.PARAMLIST,
   param_name  CHAR,
   attr        TOOL_INT.PARAM_ATTR);

PROCEDURE TOOL_INT.add_parameter
  (list_hdl    TOOL_INT.PARAMLIST,
   param_name  CHAR,
   attr        TOOL_INT.PARAM_ATTR);

PROCEDURE TOOL_INT.add_parameter
  (list_hdl    TOOL_INT.PARAMLIST,
   param_name  CHAR,
   param_type  NUMBER,
   value       CHAR);

パラメータ

list_hdl	パラメータ・リストのハンドル。
param_name	追加するパラメータの名前。
attr	追加するパラメータのタイプと値を含むパラメータ属性レコード。
param_type	追加するパラメータのタイプ。この引数の値には、次のビルトイン定数のいずれかを指定してください。TOOL_INT.DATA_PARAMETER   パラメータが、ある製品から他の製品への問合せのマッピングを表すことを示します。 TOOL_INT.TEXT_PARAMETER   パラメータが単一値であることを示します。
value	追加するパラメータの値。
使用上の注意  パラメータのタイプおよび値を含んでいるパラメータ属性レコードを指定するか、パラメータのタイプおよび値を直接指定できます。


Tool_Int.Add_Parameterの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure creates a parameter list and
**adds several parameters to it:
*/

*/

PROCEDURE create_plist IS
  the_list  tool_int.paramlist;
BEGIN
  the_list:=tool_int.create_parameter_list('my_plist');
  tool_int.add_parameter(the_list, 'userid',
    TOOL_INT.TEXT_PARAMETER, 'scott/tiger');
  tool_int.add_parameter(the_list, 'destype',
    TOOL_INT.TEXT_PARAMETER, 'printer');
  tool_int.add_parameter(the_list, 'copies',
    TOOL_INT.TEXT_PARAMETER, '2');
  tool_int.add_parameter(the_list, 'my_param',
    TOOL_INT.TEXT_PARAMETER, '67');
  tool_int.add_parameter(the_list, 'Q_1',
    TOOL_INT.DATA_PARAMETER, 'query0');
END;


TOOL_INT.CREATE_PARAMETER_LIST

  例	  関連項目

説明  このファンクションは、指定された名前で新規のパラメータ・リストを作成します。

構文

FUNCTION TOOL_INT.create_parameter_list
  (name  CHAR)
RETURN TOOL_INT.PARAMLIST;

パラメータ

name	作成するパラメータ・リストの名前。
戻り値  新規に作成されたパラメータ・リストのハンドル。


TOOL_INT.Create_Parameter_Listの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure creates a parameter list and
**adds several parameters to it:
*/

*/

PROCEDURE create_plist IS
  the_list  tool_int.paramlist;
BEGIN
  the_list:=tool_int.create_parameter_list('my_plist');
  tool_int.add_parameter(the_list, 'userid',
    TOOL_INT.TEXT_PARAMETER, 'scott/tiger');
  tool_int.add_parameter(the_list, 'destype',
    TOOL_INT.TEXT_PARAMETER, 'printer');
  tool_int.add_parameter(the_list, 'copies',
    TOOL_INT.TEXT_PARAMETER, '2');
  tool_int.add_parameter(the_list, 'my_param',
    TOOL_INT.TEXT_PARAMETER, '67');
  tool_int.add_parameter(the_list, 'Q_1',
    TOOL_INT.DATA_PARAMETER, 'query0');
END;


TOOL_INT.DELETE_PARAMETER

  例	  関連項目

説明  このプロシージャで、指定されたパラメータ・リストから指定されたパラメータを削除します。

構文

PROCEDURE TOOL_INT.delete_parameter
  (list_hdl    TOOL_INT.PARAMLIST,
   param_name  CHAR);

パラメータ

list_hdl	パラメータを削除するパラメータ・リストのハンドル。
param_name	削除するパラメータの名前。


Tool_Int.Delete_Parameterの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure deletes the parameter 'username' from a parameter list:
*/

*/

PROCEDURE example IS
  list  tool_int.paramlist;
BEGIN
  list := tool_int.get_parameter_list('list0');
  tool_int.delete_parameter(list, 'username');
END;


TOOL_INT.DESTROY_PARAMETER_LIST

  例	  関連項目

説明  このプロシージャで、指定されたパラメータ・リストを破棄します。

構文

PROCEDURE TOOL_INT.destroy_parameter_list
  (list_hdl  TOOL_INT.PARAMLIST);

パラメータ

list_hdl	削除するパラメータ・リストのハンドル。


Tool_Int.Destroy_Parameter_Listの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure creates a parameter list,
**first destroying an existing list (if any):
*/

*/

PROCEDURE example IS
  list  tool_int.paramlist;
BEGIN
  list := tool_int.get_parameter_list('list0');

  IF NOT tool_int.isnull(list) THEN
    tool_int.destroy_parameter_list(list);
  END IF;

  list := tool_int.create_parameter_list('list0');
END;


TOOL_INT.GET_PARAMETER_ATTR

  例	  関連項目

説明  このプロシージャで、指定されたパラメータ・リスト内の指定パラメータの属性を取得します。

構文

PROCEDURE TOOL_INT.get_parameter_attr
  (list_hdl    TOOL_INT.PARAMLIST,
   param_name  CHAR,
   attr        TOOL_INT.PARAM_ATTR);

PROCEDURE TOOL_INT.get_parameter_attr
  (list_hdl    TOOL_INT.PARAMLIST,
   param_name  CHAR,
   param_type  NUMBER,
   value       CHAR);

パラメータ

list_hdl	パラメータを取得するパラメータ・リストのハンドル。
param_name	取得するパラメータの名前。
attr	パラメータ属性に設定される属性レコード。
param_type	このプロシージャをコールしたときに、パラメータのタイプ設定される変数。この引数の値には、次のビルトイン定数のいずれかを指定してください。TOOL_INT.DATA_PARAMETER   パラメータが、ある製品から他の製品への問合せのマッピングを表すことを示します。 TOOL_INT.TEXT_PARAMETER   パラメータが単一値であることを示します。
value	このプロシージャをコールしたときに、パラメータの値が設定される変数。
使用上の注意  このプロシージャでパラメータの属性が設定されるようにパラメータ属性レコードを指定するか、別の変数を指定できます。


Tool_Int.Get_Parameter_Attrの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure gets the value of the 'priority' parameter,
**and increases its value by one:
*/

*/

PROCEDURE example IS
  list    tool_int.paramlist;
  ptype   NUMBER;
  pvalue  VARCHAR2;
BEGIN
  list := tool_int.get_parameter_list('list0');
  tool_int.get_parameter_attr(list, 'priority', ptype,
    pvalue);

  pvalue := to_char(to_number(pvalue) + 1);

  tool_int.set_parameter_attr(list, 'priority',
    tool_int.TEXT_PARAMETER, pvalue);

END;


TOOL_INT.GET_PARAMETER_LIST

  例	  関連項目

説明  このファンクションは、指定された名前のパラメータ・リストのハンドルを戻します。

構文

FUNCTION TOOL_INT.get_parameter_list
  (list_name  CHAR)
RETURN TOOL_INT.paramlist;

パラメータ

list_name	取得するパラメータ・リストの名前。
戻り値  名前付きパラメータ・リストのハンドル。


Tool_Int.Get_Parameter_Listの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure creates a parameter list,
**first destroying an existing list (if any):
*/

*/

PROCEDURE example IS
  list  tool_int.paramlist;
BEGIN
  list := tool_int.get_parameter_list('list0');

  IF NOT tool_int.isnull(list) THEN
    tool_int.destroy_parameter_list(list);
  END IF;

  list := tool_int.create_parameter_list('list0');
END;


TOOL_INT.ISNULL

  例	  関連項目

説明  このファンクションは、指定されたパラメータ・リストのハンドルがNULLハンドルかどうかを判断します。

構文

FUNCTION TOOL_INT.isnull
  (list_hdl  TOOL_INT.PARAMLIST)
RETURN BOOLEAN;

パラメータ

list_hdl	評価対象のハンドル。
戻り値 TRUE	ハンドルがNULLの場合。
FALSE	ハンドルがNULLでない場合。
使用上の注意  TOOL_INT.GET_PARAMETER_LISTがNULLハンドルを戻すのは、取得しようとするパラメータ・リストが存在しない場合です。


Tool_Int.Isnullの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure creates a parameter list,
**first destroying an existing list (if any):
*/

*/

PROCEDURE example IS
  list  tool_int.paramlist;
BEGIN
  list := tool_int.get_parameter_list('list0');

  IF NOT tool_int.isnull(list) THEN
    tool_int.destroy_parameter_list(list);
  END IF;

  list := tool_int.create_parameter_list('list0');
END;


TOOL_INT.RUN_PRODUCT

  例	  関連項目

説明  このプロシージャで、サポートされている別のOracle製品を起動します。

構文

PROCEDURE TOOL_INT.run_product
  (product     NUMBER,
   module      CHAR,
   comm_mode   NUMBER,
   exec_mode   NUMBER,
   repository  NUMBER,
   list_hdl    TOOL_INT.PARAMLIST);

PROCEDURE TOOL_INT.run_product
  (product     NUMBER,
   module      CHAR,
   comm_mode   NUMBER,
   exec_mode   NUMBER,
   repository  NUMBER,
   list_name   CHAR);

パラメータ

product	起動されるOracle製品。この引数の値には、次のビルトイン定数のいずれかを指定してください。TOOL_INT.BOOK   Oracle Bookを起動します。 TOOL_INT.FORMS   Formsを起動します。 TOOL_INT.REPORTS   Reportsを起動します。
module	起動された製品で実行されるモジュール名。モジュールがデータベースに格納されている場合、この引数にはモジュール名のみを指定してください。モジュールがファイル・システムに格納されている場合は、モジュール・ファイルの絶対パス名か相対パス名を指定してください。
comm_mode	製品を起動するときの通信モード。この引数の値には、次のビルトイン定数のいずれかを指定してください。  TOOL_INT.SYNCHRONOUS   製品が同期的に起動されます。 TOOL_INT.ASYNCHRONOUS    製品が非同期的に起動されます。
exec_mode	起動された製品の実行モードです。この引数の値には、次のビルトイン定数のいずれかを指定してください。TOOL_INT.BATCH   製品がバッチ・モードで起動されます。 TOOL_INT.RUNTIME   製品がランタイム・モードで起動されます。
repository	モジュールがファイル・システムとデータベーズのどちらに格納されているかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  TOOL_INT.DB   モジュールはデータベースに格納されていることを示します。 TOOL_INT.FILESYSTEM   モジュールはファイル・システムに格納されていることを示します。
list_hdl	起動された製品に渡されるパラメータ ・リストのハンドル。
list_name	起動された製品に渡されるパラメータ・リストの名前。
使用上の注意  詳細は、Oracle製品のマニュアルを参照してください。


Tool_Int.Run_Productの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure opens the Oracle Book document named
**'catalog' and jumps to the hypertext target sailboard:
*/

*/

PROCEDURE call_book is
  list  tool_int.paramlist;
BEGIN
  list:=tool_int.create_parameter_list('plist');

  tool_int.add_parameter(list, 'target',
    tool_int.TEXT_PARAMETER, 'sailboard');

  tool_int.RUN_PRODUCT(tool_int.FORMS, 'catalog',
    tool_int.ASYNCHRONOUS, tool_int.RUNTIME,
    tool_int.FILESYSTEM, list);

END;


TOOL_INT.SET_PARAMETER_ATTR

  例	  関連項目

説明  このプロシージャで、指定されたパラメータ・リスト内の指定パラメータの属性を設定します。

構文

PROCEDURE TOOL_INT.set_parameter_attr
  (list_hdl    TOOL_INT.PARAMLIST,
   param_name  CHAR,
   attr        TOOL_INT.PARAM_ATTR);

PROCEDURE TOOL_INT.set_parameter_attr
  (list_hdl    TOOL_INT.PARAMLIST,
   param_name  CHAR,
   param_type  NUMBER,
   value       CHAR);

パラメータ

list_hdl	指定されたパラメータを含むパラメータ・リストのハンドル。
param_name	設定するパラメータの名前。
attr	設定するパラメータの属性が入っている属性レコード。
param_type	設定するパラメータのタイプ。この引数の値には、次のビルトイン定数のいずれかを指定してください。TOOL_INT.DATA_PARAMETER   パラメータが、ある製品から他の製品への問合せのマッピングを表すことを示します。 TOOL_INT.TEXT_PARAMETER   パラメータが単一値であることを示します。
value	設定するパラメータの値。
使用上の注意  このプロシージャでパラメータ属性の設定に使用するパラメータ属性レコードを指定するか、属性を含む別の変数を指定できます。


Tool_Int.Set_Parameter_Attrの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure gets the value of the 'priority'
**parameter, and increases its value by one:
*/

*/

PROCEDURE example IS
  list    tool_int.paramlist;
  ptype   NUMBER;
  pvalue  VARCHAR2;
BEGIN
  list := tool_int.get_parameter_list('list0');
  tool_int.get_parameter_attr(list, 'priority', ptype,
    pvalue);

  pvalue := to_char(to_number(pvalue) + 1);

  tool_int.set_parameter_attr(list, 'priority',
    tool_int.TEXT_PARAMETER, pvalue);

END;


ウィンドウ・ビルトイン

OG_Destroy（ウィンドウ）

OG_Get_Window

OG_Hide_Window

OG_Make_Window

OG_Show_Window


OG_Destroy（ウィンドウ）

  例	  関連項目

説明  このプロシージャで、指定されたウィンドウを破棄します。これにより、そのウィンドウはクローズされますが、内容には影響しません。

構文

PROCEDURE OG_Destroy
  (window_hdl  OG_Window);

パラメータ

window_hdl	破棄するウィンドウのハンドル。


OG_Destroy（ウィンドウ）の例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose a user selects a country in a map of the world,
**and the application creates a new window to display
**information about sales in that country.When the user selects
**another country, you may want to destroy the old window
**and create another one containing information about the new country.
*/

PROCEDURE destroy_USA IS
   the_window   OG_Window;
BEGIN
   the_window:=OG_Get_Window('Usa_Window');
   OG_Destroy(The_Window);
END;


OG_Get_Window

  例	  関連項目

説明  このファンクションは、指定されたウィンドウのハンドルを戻します。

構文

FUNCTION OG_Get_Window
  (window_name  VARCHAR2)
RETURN OG_Window;

パラメータ

window_name	ハンドルが戻されるウィンドウの名前。
戻り値  指定されたウィンドウのハンドル。指定のウィンドウが存在しない場合は、NULLハンドルが戻ります。

使用上の注意  ウィンドウが図表のメイン・ウィンドウ(「主レイアウト」ウィンドウ)や、プログラムによって作成されたウィンドウの場合もあります。


OG_Get_Windowの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose the main window-which was previously hidden-contains information
**that is now useful to view.The following procedure will show it:
*/

*/

PROCEDURE show_main_window IS
   the_main_window   OG_Window;
BEGIN
   the_main_window:=OG_Get_Window('Main Layout');
   OG_Show_Window(The_Main_Window);
END;


OG_Hide_Window

  例	  関連項目

説明  このプロシージャで、指定されたウィンドウを隠します。

構文

PROCEDURE OG_Hide_Window
  (window_hdl  OG_Window);

パラメータ

window_hdl	隠されるウィンドウのハンドル。
使用上の注意 ウィンドウは破棄されません。そのため、そのウィンドウをすぐに必要としないときは隠し、必要になったときに再び表示できます。


OG_Hide_Windowの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose the main layout window contains a chart that the user
**no longer needs to see.The following procedure will hide it temporarily.
**Remember that this does not destroy the window; it will still exist
**and be available to be shown again when needed.
*/

PROCEDURE hide_main_window IS
   the_main_window   OG_Window;
BEGIN
   the_main_window:=OG_Get_Window('Main Layout');
   OG_Hide_Window(The_Main_Window);
END;


OG_Make_Window

  例	  関連項目

説明  このファンクションはウィンドウを作成します。

構文

FUNCTION OG_Make_Window
  (position  OG_Point,
   height    NUMBER,
   width     NUMBER)
RETURN OG_Window;

パラメータ

position	ウィンドウの左上角のx座標とy座標 （画面解像度単位）。
height	ウィンドウの高さ(画面解像度単位)。
width	ウィンドウの幅（画面解像度単位）。
戻り値  新規に作成されたウィンドウのハンドル。


OG_Make_Windowの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following function creates a 5"x4" window
**in the upper left corner of the screen:
*/

*/

FUNCTION example(window_name VARCHAR2) RETURN OG_Window IS
  window  OG_Window;
  pos     OG_Point;
  height  NUMBER;
  width   NUMBER;
BEGIN
  pos.x := 0;
  pos.y := 0;
  width := 5 * OG_Get_Ap_Hscreen_Res;
  height := 4 * OG_Get_Ap_Vscreen_Res;

  window := OG_Make_Window(Pos, height, width);
  OG_Set_Name(Window, window_name);
  RETURN(window);
END;


OG_Show_Window

  例	  関連項目

説明  このプロシージャで、指定されたウィンドウを表示します。

構文

PROCEDURE OG_Show_Window
  (window_hdl  OG_Window);

パラメータ

window_hdl	表示するウィンドウのハンドル。


OG_Show_Windowの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* Suppose the main window-which was previously hidden
**contains information that is now useful to view.
**The following procedure will show it.
*/

PROCEDURE show_main_window IS
   the_main_window   OG_Window;
BEGIN
   the_main_window:=OG_Get_Window('Main Layout');
   OG_Show_Window(The_Main_Window);
END;


グラフィック・オブジェクト・ビルトイン

OG_Clone（オブジェクト）

OG_Damage（オブジェクト）

OG_Delete_Child

OG_Delete_Cmptext

OG_Delete_Point

OG_Delete_Property

OG_Delete_Smptext

OG_Destroy（オブジェクト）

OG_Draw

OG_Export_Drawing（図表）

OG_Export_Drawing（オブジェクト/レイヤー）

OG_Export_Drawing（ウィンドウ）

OG_Export_Image

OG_Get_Char_Property

OG_Get_Child

OG_Get_Cmptext

OG_Get_Date_Property

OG_Get_Num_Property

OG_Get_Object

OG_Get_Point

OG_Get_Smptext

OG_Import_Drawing

OG_Import_Image

OG_Insert_Child

OG_Insert_Cmptext

OG_Insert_Point

OG_Insert_Smptext

OG_Make_Ellipse

OG_Make_Group

OG_Make_Image

OG_Make_Line

OG_Make_Poly

OG_Make_Rect

OG_Make_Rrect

OG_Make_Symbol

OG_Make_Text

OG_Move

OG_Point_In

OG_Point_Near

OG_Property_Exists

OG_Rotate

OG_Same

OG_Scale

OG_Set_Edgecolor

OG_Set_Fillcolor

OG_Set_Property

OG_Synchronize

OG_Update_Bbox


OG_Clone（オブジェクト）

  例	  関連項目

説明　このファンクションを使用して、指定したオブジェクトと同じオブジェクトを新たに作成します。

構文

FUNCTION OG_Clone
  (object_hdl   OG_Object,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE)
RETURN OG_Object;

パラメータ

object_hdl	複製するオブジェクトのハンドル。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
戻り値　新たに作成されたオブジェクトのハンドル。


OG_Clone（オブジェクト）の例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you have created an object, and you want to
** create another identical object without having to
**again specify the same properties.
*/

PROCEDURE dup_object(old_object IN OG_Object) IS
   new_object   OG_Object;
BEGIN
   new_object:=OG_Clone(Old_Object);
END;


OG_Damage（オブジェクト）

  例	  関連項目

説明　このプロシージャで、レイアウトされたオブジェクトを再描画します。

構文

PROCEDURE OG_Damage
  (object_hdl  OG_Object);

パラメータ

object_hdl	再描画するオブジェクトのハンドル。


OG_Damage（オブジェクト）の例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*Suppose you want to move an object. The default behavior of the built-in
**procedure OG_Move is to update the bounding boxes of all of the modified
**object's antecedants, including the layer on which the object resides.
**To update a layer's bounding boxes, Graphics Builder must examine every object
**on that layer.If the layer contains a large number of objects,
**this operation can be very time-consuming.
*/

/*To make your application more efficient, you can move the object
**while inhibiting this automatic bounding box update, then explicitly
**update only that object's bounding boxes.(Note that since the
**automatic bounding box update does not occur, the bounding boxes
**of the object's antecedants may be inaccurate.)
*/

/*When you modify an object with a FALSE bounding box update flag,
**you may also want to use a FALSE damage flag.In this case,
**when you are through modifying the object, you would invoke
**OG_Damage to explicitly damage the object.
*/

PROCEDURE move_efficiently (the_object OG_Object) IS
   offset   OG_Point;
BEGIN
   offset.x:=OG_Inch;
   offset.y:=OG_Inch;
   OG_Move(The_Object, offset, FALSE, FALSE)
   OG_Update_Bbox(The_Object, OG_Bothbbox);
   OG_Damage(The_Object);
END;


OG_Delete_Child

  例	  関連項目

説明　このプロシージャで、指定したグループ・オブジェクトから1つ以上の子オブジェクトを削除します。

構文

PROCEDURE OG_Delete_Child
  (group_hdl    OG_Object,
   indx         NUMBER,
   total        NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

group_hdl	グループ・オブジェクトのハンドル。
indx	グループの子リストから削除する最初のオブジェクトの索引。
total	削除する子オブジェクトの総数。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　子を削除するというのは、オブジェクトとその親グループとの関連付けをなくすという意味です。子オブジェクトを破棄するという意味ではありません。つまり、削除された子の一般属性レコード内の親の属性がNULLハンドルに設定され、そのグループのオブジェクト・リストからその子が削除されます。なお、親の属性がNULLハンドルのオブジェクトはレイアウト上に表示されません。

レイヤーを削除するには、画面のルート・オブジェクトを1つのグループとして扱い、そのグループとレイヤー索引をこのプロシージャに渡します。


OG_Delete_Childの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*Suppose you have a several objects representing products
**in a warehouse, and you want to move one of the products
**from one warehouse to another.Your display may use a group
**comprised of the products to represent the inventory for each
**warehouse.To move a product from one warehouse to another,
**you would want to get the handle to the product object,
**delete it from one warehouse group, and add it to another
**warehouse group.
*/

/*Note that this procedure changes only the internal composition
**of the group objects.To move or change the appearance of the
**product object, you must use other Graphics Builder built-in procedures.
*/

PROCEDURE move_prod(warehouse1 IN OG_Object, warehouse2 IN
OG_Object, prod_index IN number) IS
   the_prod   OG_Object;
BEGIN
   the_prod:=OG_Get_Child(Warehouse1, prod_index);
   OG_Delete_Child(Warehouse1, prod_index, 1);
   OG_Insert_Child(Warehouse2, the_prod, OG_Last);
END;


OG_Delete_Cmptext

  例	  関連項目

説明　このプロシージャで、指定したテキスト・オブジェクトから1つ以上の複数テキスト要素を削除します。「テキスト属性」に説明されているように、テキスト・オブジェクトのテキスト1行を複数テキスト要素といいます。

構文

PROCEDURE OG_Delete_Cmptext
  (text_hdl     OG_Object,
   indx         NUMBER,
   total        NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text_hdl	テキスト・オブジェクトのハンドル。
indx	複数テキスト要素リストから削除する最初の複数テキスト要素のテキスト・オブジェクト内の索引。
total	削除する複数テキスト要素の総数。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　複数テキスト要素を削除すると、その要素を構成する単一テキスト要素がすべて削除されます。


OG_Delete_Cmptextの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*Suppose you use a text object to display messages to the user.
**A previous part of your application produced two-line messages,
**but the part of the display that is currently being used produces
**only one-line messages.You may want to delete the extraneous
**compound text element.
*/

PROCEDURE delete_msg_line(msg_object IN OG_Object,
line_index IN number) IS
BEGIN
   OG_Delete_Cmptext(Msg_Object, line_index, 1);
END;


OG_Delete_Point

  例	  関連項目

説明　このプロシージャで、指定した多角形オブジェクトまたは折れ線オブジェクトから1つまたは複数の点を削除します。

構文

PROCEDURE OG_Delete_Point
  (poly_hdl     OG_Object,
   indx         NUMBER,
   total        NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

poly_hdl	多角形オブジェクトまたは折れ線オブジェクトのハンドル。
indx	点リストから削除する最初の点の索引。
total	削除する点の総数。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　Graphics Builderでオブジェクトを作成すると、そのオブジェクトを描画するときにマウスで選択した順序で点に初期索引値が付けられます（最初の点の初期索引値は0になります）。また、プログラムを使用して点を挿入すると、挿入時に指定した索引に従って索引値が付けられます。


OG_Delete_Pointの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*Suppose you have several polygons on a map, each of which
**connects the cities along a specific distribution route.
**If a city is transferred from one distribution route to another,
**you would want to get the point representing that city,
**delete it from one polygon, and add it to another polygon.
*/

PROCEDURE move_city(route1 IN OG_Object, route2 IN
OG_Object, city_index IN number) IS
   the_city   OG_Point;
BEGIN
   the_city:=OG_Get_Point(Route1, city_index);
   OG_Delete_Point(Route1, city_index, 1);
   OG_Insert_Point(Route2, OG_Last, the_city);
END;


OG_Delete_Property

  例	  関連項目

説明　このプロシージャで、オブジェクトのユーザー定義プロパティを削除します。

構文

PROCEDURE OG_Delete_Property
  (object_hdl  OG_Object,
   prop_name   VARCHAR2);

パラメータ

object_hdl	オブジェクトのハンドル。
prop_name	削除するプロパティ名。


OG_Delete_Propertyの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure deletes the property 'priority'
** from every child object in a named group:
*/

PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    OG_Delete_Property(Child_Obj, 'priority');
  END LOOP;
END;


OG_Delete_Smptext

  例	  関連項目

説明　このプロシージャで、指定したテキスト・オブジェクト内の指定した複数テキスト要素から1つ以上の単一テキスト要素を削除します。「テキスト属性」に説明されているように、複数テキスト要素の各テキスト文字列を単一テキスト要素といいます。

構文

PROCEDURE OG_Delete_Smptext
  (text_hdl     OG_Object,
   cmpindex     NUMBER,
   smpindex     NUMBER,
   total        NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text_hdl	テキスト・オブジェクトのハンドル。
Cmpindex	削除する単一テキスト要素を含む複数テキスト要素の索引。
smpindex	削除する最初の単一テキスト要素の索引。
total	削除する単一テキスト要素の総数。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　単一テキストを削除しても、そのテキストを含む複数テキスト要素の索引には影響しません。また、複数テキストが削除されることもありません。したがって、複数テキスト要素内の単一テキスト要素をすべて削除し、その複数テキスト要素を空のまま残せます。


OG_Delete_Smptextの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you have created a message text object.To change
**the message it contains, you would delete the simple text element
**containing the current message and insert a new simple text element
**containing the new message.To maintain the font and other attributes,
**however, you first would want to get the simple text element into an
**attribute record.That way, you could modify only the text string,
**and leave the other attribute settings (such as font) unchanged.
*/

PROCEDURE put_msg(mess IN VARCHAR2) IS
  msgobj    OG_Object;
  msgrec    OG_Smptext_Attr;
BEGIN
  msgobj := OG_Get_Object('msg');
  OG_Get_Smptext(msgobj, 0, 0, msgrec);
  OG_Delete_Smptext(msgobj, 0, 0, 1);
  msgrec.mask:= OG_STR_SMPTEXTA;
  msgrec.str:= mess;
  OG_Insert_Smptext(msgobj, msgrec, 0, OG_LAST);
END;


OG_Destroy（オブジェクト）

  例	  関連項目

説明　このプロシージャで、指定したオブジェクトを破棄します。グループ・オブジェクトを破棄すると、そのグループの子もすべて破棄されます。

構文

PROCEDURE OG_Destroy
  (object_hdl   OG_Object,
   recurse      BOOLEAN    :=  FALSE,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

object_hdl	破棄するオブジェクトのハンドル。
Recurse	再帰破棄フラグ。この引数はオプションです。指定しなければ、デフォルトでFALSEに設定されます。また、破棄するオブジェクトがグループの唯一の子でない場合は、この引数は無視されます。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　破棄するオブジェクトがグループの唯一の子の場合は、recurseの値をTRUEに設定すると、親グループも破棄されます。親グループの破棄は、そのオブジェクトのグループ・ツリーをさかのぼって実行されます（たとえば、そのオブジェクトの親がその親グループの唯一の子であれば、その親グループも破棄されます）。レイヤー上の最後のオブジェクトが破棄されると、そのレイヤーがアクティブになっているウィンドウがなければ、最終的には、そのレイヤーも破棄されます。

recurseがFALSEの場合は、object_hdlで指定したオブジェクトのみが破棄されます。


OG_Destroy（オブジェクト）の例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure destroys the specified object:
*/

PROCEDURE destroy_obj(obj_name VARCHAR2) IS
  object  OG_Object;
BEGIN
  object := OG_Get_Object(Obj_Name);
  OG_Destroy(Object);
END;


OG_Draw

  例	  関連項目

説明　このプロシージャで、指定したオブジェクトをレイアウト上に描画します。

構文

PROCEDURE OG_Draw
  (object_hdl  OG_Object);

パラメータ

object_hdl	描画するオブジェクトへのハンドル。
使用上の注意　このプロシージャでは、オブジェクトを変更する他のプロシージャと異なり、レイアウト上の長方形の領域を描画しません。このプロシージャでは、指定したオブジェクトを描画するのみで、レイアウトには一切影響ありません。

このプロシージャを使用すると、Graphics Builderが確保した長方形の領域を再描画（必要以上に大きな領域になる場合があります）させずに、レイアウト上にオブジェクトを表示できます。


OG_Drawの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*Suppose you want to clone an object and have it appear on the
**layout smoothly, without causing a damage region to be redrawn.
**First, you would create the object by calling OG_Clone with a FALSE
**damage flag .Then, you can make the object appear on the layout
**by calling OG_Draw.
*/

PROCEDURE clone_object IS
   the_object   OG_Object;
   new_object   OG_Object;
BEGIN
   the_object:=OG_Get_Object('My_Object');
   new_object:=OG_Clone(The_Object, FALSE);
   OG_Draw(new_object);
END;


OG_Export_Drawing（図表）

  例	  関連項目

説明　このプロシージャで、（隠れたレイヤーも含めて）レイアウト全体を1つの描画オブジェクトとしてエクスポートします。

構文

PROCEDURE OG_Export_Drawing
  (name         VARCHAR2,
   repository   NUMBER,
   format       NUMBER,
   compression  NUMBER    :=  OG_No_Icompression);

パラメータ

name	描画オブジェクトのエクスポート先の名前。描画オブジェクトをデータベースに保存する場合は、この引数に描画オブジェクト名のみを指定します。描画オブジェクトをファイル・システムに保存する場合は、この引数に描画ファイルの絶対パス名または相対パス名を指定します。
repository	描画オブジェクトをファイル・システムとデータベースのどちらに保存するのかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。 OG_Db　描画オブジェクトをデータベースに保存します。 OG_Filesystem　描画オブジェクトをファイル・システムに保存します。
format	描画オブジェクトをエクスポートするときの形式を指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。 OG_Cgm16_Dformat　描画オブジェクトをCGM 2バイト形式で保存します。 OG_Cgm32_Dformat　描画オブジェクトをCGM 4バイト形式で保存します。 OG_Oracle_Dformat　描画オブジェクトが他のOracle製品で使用されるOracleフォーマットで保存されていることを表します。
compression	描画オブジェクトのイメージを圧縮するための圧縮タイプ。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_No_Icompression　イメージを圧縮しません。 OG_H3g_Icompression　CCITT Group 3を使用してイメージを圧縮します。 OG_G3fax_Icompression　Group 3 FAX圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロ・イメージの場合のみです。 OG_G4fax_Icompression　Group 4 FAX圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロ・イメージの場合のみです。 OG_Pack_Icompression　PackBits圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロのTIFFイメージの場合のみです。 OG_Lzwhdiff_Icompression　水平方向の差分を考慮したLZW圧縮を使用してイメージを圧縮します。 OG_Lzwnohdiff_Icompression　水平方向の差分を考慮しないLZW圧縮を使用してイメージを圧縮します。 OG_Jpeg_Lowest_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が最も小さく品質が最も高くなります。 OG_Jpeg_Low_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が小さく品質が高くなります。 OG_Jpeg_Medium_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプでは、中程度の圧縮率と品質になります。 OG_Jpeg_High_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が大きく品質が低くなります。 OG_Jpeg_Highest_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が最も大きく品質が最も低くなります。


OG_Export_Drawing（図表）の例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*Suppose you want to export the display contents to the CGM file
**'my_draw' so that you can later import it into some other application.
** The following procedure does this:
*/
PROCEDURE export_the_drawing IS
BEGIN
   OG_Export_Drawing('My_Draw', OG_Filesystem, OG_Cgm16_Dformat);
END;


OG_Export_Drawing（オブジェクト/レイヤー）

  例	  関連項目

説明　このプロシージャで、指定したオブジェクトまたはレイヤーを1つの描画オブジェクトとしてエクスポートします。

構文

PROCEDURE OG_Export_Drawing
  (name         VARCHAR2,
   repository   NUMBER,
   format       NUMBER,
   object_hdl   OG_Object,
   compression  NUMBER     :=  OG_No_Icompression);

パラメータ

name	描画オブジェクトのエクスポート先の名前。描画オブジェクトをデータベースに保存する場合は、この引数に描画オブジェクト名のみを指定します。描画オブジェクトをファイル・システムに保存する場合は、この引数に描画ファイルの絶対パス名または相対パス名を指定します。
Repository	描画オブジェクトをファイル・システムとデータベースのどちらに保存するのかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db　描画オブジェクトをデータベースに保存します。 OG_Filesystem　描画オブジェクトをファイル・システムに保存します。
format	描画オブジェクトをエクスポートするときの形式を指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。OG_Cgm16_Dformat　描画オブジェクトをCGM 2バイト形式で保存します。 OG_Cgm32_Dformat　描画オブジェクトをCGM 4バイト形式で保存します。 OG_Oracle_Dformat　描画オブジェクトが他のOracle製品で使用されるOracleフォーマットで保存されていることを表します。
object_hdl	エクスポートするオブジェクトのハンドル。エクスポートするオブジェクトは、グループでもレイヤーのオブジェクト・ハンドルでも構いません。オブジェクトとそのオブジェクトの子孫がすべてエクスポートされます。エクスポートするレイヤーを指定するには、OG_Get_Objectを使用してそのレイヤーのオブジェクト・ハンドルを指定します。
Compression	描画オブジェクトのイメージを圧縮するための圧縮タイプ。この引数の値には、次のビルトイン定数のいずれかを指定してください。OG_No_Icompression　イメージを圧縮しません。 OG_H3g_Icompression　CCITT Group 3を使用してイメージを圧縮します。 OG_G3fax_Icompression　Group 3 FAX圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロ・イメージの場合のみです。 OG_G4fax_Icompression　Group 4 FAX圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロ・イメージの場合のみです。 OG_Pack_Icompression　PackBits圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロのTIFFイメージの場合のみです。 OG_Lzwhdiff_Icompression　水平方向の差分を考慮したLZW圧縮を使用してイメージを圧縮します。 OG_Lzwnohdiff_Icompression　水平方向の差分を考慮しないLZW圧縮を使用してイメージを圧縮します。 OG_Jpeg_Lowest_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が最も小さく品質が最も高くなります。 OG_Jpeg_Low_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が小さく品質が高くなります。 OG_Jpeg_Medium_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプでは、中程度の圧縮率と品質になります。 OG_Jpeg_High_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が大きく品質が低くなります。 OG_Jpeg_Highest_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が最も大きく品質が最も低くなります。


OG_Export_Drawing（オブジェクト/レイヤー）の使用例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to export the contents of 'layer0' to the CGM file
** 'my_draw' so that you can later import it into some other application.
** The following procedure does this:
*/

*/

PROCEDURE export_the_drawing IS
   the_layer   OG_Object;
BEGIN
   the_layer:=OG_Get_Object('Layer0');
   OG_Export_Drawing('My_Draw', OG_Filesystem,
OG_Cgm16_Dformat, the_layer);
END;


OG_Export_Drawing（ウィンドウ）

  例	  関連項目

説明　このプロシージャで、指定したウィンドウに表示されている内容を1つの描画オブジェクトとしてエクスポートします。

構文

PROCEDURE OG_Export_Drawing
  (name         VARCHAR2,
   repository   NUMBER,
   format       NUMBER,
   window_hdl   OG_Window,
   compression  NUMBER     :=  OG_No_Icompression);

パラメータ

name	描画オブジェクトのエクスポート先の名前。描画オブジェクトをデータベースに保存する場合は、この引数に描画オブジェクト名のみを指定します。描画オブジェクトをファイル・システムに保存する場合は、この引数に描画ファイルの絶対パス名または相対パス名を指定します。
Repository	描画オブジェクトをファイル・システムとデータベースのどちらに保存するのかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。 OG_Db　描画オブジェクトをデータベースに保存します。 OG_Filesystem　描画オブジェクトをファイル・システムに保存します。
format	描画オブジェクトをエクスポートするときの形式を指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。OG_Cgm16_Dformat　描画オブジェクトをCGM 2バイト形式で保存します。 OG_Cgm32_Dformat　描画オブジェクトをCGM 4バイト形式で保存します。 OG_Oracle_Dformat　描画オブジェクトが他のOracle製品で使用されるOracleフォーマットで保存されていることを表します。
window_hdl	エクスポートする描画オブジェクトを含むウィンドウのハンドル。そのウィンドウに表示されているレイヤーがすべてエクスポートされます。
Compression	描画オブジェクトのイメージを圧縮するための圧縮タイプ。この引数の値には、次のビルトイン定数のいずれかを指定してください。OG_G3fax_Icompression　Group 3 FAX圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロ・イメージの場合のみです。 OG_G4fax_Icompression　Group 4 FAX圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロ・イメージの場合のみです。 OG_H3g_Icompression　CCITT Group 3を使用してイメージを圧縮します。 OG_Jpeg_High_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が大きく品質が低くなります。 OG_Jpeg_Highest_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が最も大きく品質が最も低くなります。 OG_Jpeg_Low_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が小さく品質が高くなります。 OG_Jpeg_Lowest_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が最も小さく品質が最も高くなります。 OG_Jpeg_Medium_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプでは、中程度の圧縮率と品質になります。 OG_Lzwhdiff_Icompression　水平方向の差分を考慮したLZW圧縮を使用してイメージを圧縮します。 OG_Lzwnohdiff_Icompression　水平方向の差分を考慮しないLZW圧縮を使用してイメージを圧縮します。 OG_No_Icompression　イメージを圧縮しません。 OG_Pack_Icompression　PackBits圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロのTIFFイメージの場合のみです。


OG_Export_Drawing（ウィンドウ）の例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to export the contents of the 'Main Layout'
** window to the CGM file 'my_draw' so that you can later import it
** into some other application.The following procedure does this:
*/
PROCEDURE export_the_drawing IS
   the_window   OG_Window;
BEGIN
   the_window:=OG_Get_Window('Main Layout');
   OG_Export_Drawing('My_Draw', OG_Filesystem,
OG_Cgm16_Dformat, the_window);
END;


OG_Export_Image

  例	  関連項目

説明　このプロシージャで、Graphics Builderオブジェクトを1つのイメージとしてエクスポートします。

構文

PROCEDURE OG_Export_Image
  (name         VARCHAR2,
   repository   NUMBER,
   format       NUMBER,
   image_hdl    OG_Object,
   compression  NUMBER     :=  OG_No_Icompression);

パラメータ

name	イメージのエクスポート先の名前。イメージをデータベースに保存する場合は、この引数にイメージの名前のみを指定します。イメージをファイル・システムに保存する場合は、この引数にイメージ・ファイルの絶対パス名または相対パス名を指定します。
Repository	イメージをファイル・システムとデータベースのどちらに保存するかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db　イメージをデータベースに保存します。 OG_Filesystem　イメージをファイル・システムに保存します。
format	イメージをエクスポートするときの形式を指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Bmp_Iformat　イメージをWindows/OS2のビットマップ形式で保存します。 OG_Cals_Iformat　イメージをCALS Type 1のラスター形式で保存します。 OG_Gif_Iformat　イメージをCompuServeのGIF形式で保存します。GIFファイルはOG_Lzwhdiff_Icompressionを使用して圧縮する必要があります。 OG_Jfif_Iformat　イメージをJPEGファイル・イメージ・フォーマットで保存します。 OG_Pict_Iformat　イメージをMacintoshのPICT形式で保存します。 OG_Ras_Iformat　イメージをSUNのラスター形式で保存します。 OG_Tiff_Iformat　イメージをTagのイメージ・ファイル・フォーマットで保存します。
image_hdl	エクスポートするイメージ・オブジェクトのハンドル。すべてのGraphics Builderオブジェクトがエクスポートできます。
Compression	使用する圧縮タイプ。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_G3fax_Icompression　Group 3 FAX圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロ・イメージの場合のみです。 OG_G4fax_Icompression　Group 4 FAX圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロ・イメージの場合のみです。 OG_H3g_Icompression　CCITT Group 3を使用してイメージを圧縮します。 OG_Jpeg_High_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が大きく品質が低くなります。 OG_Jpeg_Highest_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が最も大きく品質が最も低くなります。 OG_Jpeg_Low_Icompression　JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が小さく品質が高くなります。 OG_Jpeg_Lowest_Icompression JPEG圧縮を使用してイメージを圧縮します。このタイプは、圧縮率が最も小さく品質が最も高くなります。 OG_Jpeg_Medium_Icompression JPEG圧縮を使用してイメージを圧縮します。このタイプでは、中程度の圧縮率と品質になります。 OG_Lzwhdiff_Icompression　水平方向の差分を考慮したLZW圧縮を使用してイメージを圧縮します。この圧縮タイプはGIFファイルに使用します。 OG_Lzwnohdiff_Icompression　水平方向の差分を考慮しないLZW圧縮を使用してイメージを圧縮します。 OG_No_Icompression　イメージを圧縮しません。 OG_Pack_Icompression　PackBits 圧縮を使用してイメージを圧縮します。この圧縮タイプを指定できるのは、モノクロのTIFFイメージの場合のみです。


OG_Export_Imageの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to export the image named 'image0' to the TIFF file
**'my_image' so that you can later import it into some other application
**The following procedure does this:
*/
PROCEDURE export_the_image IS
   the_image   OG_Object;
BEGIN
   the_image:=OG_Get_Object('image0');
   OG_Export_Image('my_image', OG_Filesystem,
      OG_Tiff_Iformat, the_image);
END;


OG_Get_Char_Property

  例	  関連項目

説明　このファンクションを使用して、オブジェクトのユーザー定義CHARプロパティの値を取得します。

構文

FUNCTION OG_Get_Char_Property
  (object_hdl  OG_Object,
   prop_name   VARCHAR2)
RETURN VARCHAR2;

パラメータ

object_hdl	取得したいプロパティを含むオブジェクトのハンドル。
prop_name	値を取得するプロパティの名前。
戻り値　指定したプロパティの値。


OG_Get_Char_Propertyの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure gets the 'status' property
**in each child object in a group, and then changes
**the object's color if the status is 'obsolete':
*/
PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
  stat         VARCHAR2(10);
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    stat := OG_Get_Char_Property(Child_Obj, 'status');
    IF stat = 'obsolete' THEN
      OG_Set_Fillcolor(Child_Obj, 'red');
    END IF;
  END LOOP;

END;


OG_Get_Child

  例	  関連項目

説明　このファンクションを使用すると、グループ・オブジェクト内の子オブジェクトのハンドルが戻ります。

構文

FUNCTION OG_Get_Child
  (group_hdl  OG_Object,
   indx       NUMBER)
RETURN OG_Object;

パラメータ

group_hdl	その子を含むグループ・オブジェクトのハンドル。
indx	グループの子リスト内のオブジェクトの索引。このオブジェクトのハンドルが戻ります。
戻り値　グループ内の指定した子オブジェクトのハンドル。


OG_Get_Childの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*Suppose you have a several objects representing products
**in a warehouse, and you want to move one of the products
**from one warehouse to another.Your display may use a group
**comprised of the products to represent the inventory for each
**warehouse.To move a product from one warehouse to another,
**you would want to get the handle to the product object, delete it
**from one warehouse group, and add it to another warehouse group.
*/

PROCEDURE move_prod(warehouse1 IN OG_Object, warehouse2 IN
OG_Object, prod_index in number) IS
   the_prod   OG_Object;
BEGIN
   the_prod:=OG_Get_Child(Warehouse1, prod_index);
   OG_Delete_Child(Warehouse1, prod_index, 1);
   OG_Insert_Child(Warehouse2, the_prod, OG_Last);
END;

/*Note that this procedure changes only the internal composition
**of the group objects.To move or change the appearance of the
**product object, you must use other Graphics Builder built-in procedures.
*/


OG_Get_Cmptext

  例	  関連項目

説明　このプロシージャで、指定した複数テキスト要素の属性値を取得して、指定した複数テキスト属性レコードの対応するフィールドに割り当てます。「テキスト属性」に説明されているように、テキスト・オブジェクトのテキスト1行を複数テキスト要素といいます。

構文

PROCEDURE OG_Get_Cmptext
  (text_hdl          OG_Object,
   indx              NUMBER,
   attr      IN OUT  OG_Cmptext_Attr);

パラメータ

text_hdl	テキスト・オブジェクトのハンドル。
indx	取り出する属性のある複数テキスト要素の、複数テキスト要素内の索引。
attr	複数テキスト要素の属性を受け取る複数テキスト属性レコード。
使用上の注意　属性レコードのマスク属性の値で指定された属性値のみが取り出されます。したがって、OG_Get_Cmptextをコールしても、マスクが設定されていない属性レコードのフィールドには影響しません。


OG_Get_Cmptextの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to determine how many simple text elements
**compose the first compound text element within a text object.
**Knowing this, you can loop through and examine each simple text element.
*/

FUNCTION how_many(my_text IN OG_Object) RETURN NUMBER IS
   ctext_rec   OG_Cmptext_Attr;
BEGIN
   ctext_rec.mask:=OG_Stcount_Cmptexta;
   OG_Get_Cmptxt(My_Text, 0, ctext_rec);
   RETURN(ctext_rec.stcount);
END;


OG_Get_Date_Property

  例	  関連項目

説明　このファンクションを使用して、オブジェクトのユーザー定義DATEプロパティの値を取得します。

構文

FUNCTION OG_Get_Date_Property
  (object_hdl  OG_Object,
   prop_name   VARCHAR2,
   date_fmt    VARCHAR2   := 'DD-MON-YY')
RETURN DATE;

パラメータ

object_hdl	取得するプロパティを含むオブジェクトのハンドル。
prop_name	値を取得するプロパティの名前。
date_fmt	OG_Set_Propertyで日付プロパティを設定するのに使用した日付書式マスク。
戻り値　指定したプロパティの値。


OG_Get_Date_Propertyの例
OG_Get_Date__Propertyの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure gets the 'due_date' property in each child object
**in a group, and then changes the object's color if the due date has past:
*/

PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
  due          DATE;
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count-1 LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    due := OG_Get_Date_Property(Child_Obj, 'due_date');
    IF due < sysdate THEN
      OG_Set_Fillcolor(Child_Obj, 'red');
    END IF;
  END LOOP;

END;


OG_Get_Num_Property

  例	  関連項目

説明　このファンクションを使用して、オブジェクトのユーザー定義数値プロパティの値を取得します。

構文

FUNCTION OG_Get_Num_Property
  (object_hdl  OG_Object,
   prop_name   VARCHAR2)
RETURN NUMBER;

パラメータ

object_hdl	取得するプロパティを含むオブジェクトのハンドル。
prop_name	値を取得するプロパティの名前。
戻り値　指定したプロパティの値。


OG_Get_Num_Propertyの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure gets the 'priority' property in each child object
**in a group, and then sets the priority to one greater than its current value:
*/
PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
  current_p    NUMBER;
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count-1 LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    current_p := OG_Get_Num_Property(Child_Obj, 'priority');
    OG_Set_Property(Child_Obj, 'priority', current_p + 1);
  END LOOP;

END;


OG_Get_Object

  例	  関連項目

説明　このファンクションを使用して、円弧、チャート、グループ、イメージ、線、多角形、四角形、丸い四角形、記号、テキストなどのオブジェクトを取り出します。オブジェクトを取り出す前に、Builder内またはプログラムを使用して、そのオブジェクトを作成し、名前を付けておく必要があります。指定したオブジェクトが存在しなければ、このファンクションを使用するとNULLハンドルが戻ります。

構文

FUNCTION OG_Get_Object
  (object_name  VARCHAR2)
RETURN OG_Object;

FUNCTION OG_Get_Object
  (object_name  VARCHAR2,
   root_hdl     OG_Object)
RETURN OG_Object;

パラメータ

object_name	オブジェクトの名前。このオブジェクトのハンドルが戻ります。注意: OBJECT_NAME引数では大文字と小文字が区別されます。
root_hdl	グループ・ツリーを検索したいオブジェクトのハンドル。
戻り値　指定したオブジェクトのハンドル。

使用上の注意　root_hdlを指定しなければ、Graphics Builderによって画面上の実際のルート・オブジェクトから検索が開始されます。つまり、画面上から名前を持つすべてのオブジェクトが検索されます。一方、root_hdlを指定すると、Graphics Builderによってグループ・ツリーのそのオブジェクトの下から検索されます。なお、検索パスに同じ名前のオブジェクトが複数存在すると、正しい結果は戻りません。

object_nameにレイヤー名を指定すると、このファンクションはレイヤーをグループ・オブジェクトとして処理し、そのグループのハンドルが戻ります。このハンドルを使用すれば、グループ関連のサブプログラム（OG_Insert_ChildやOG_Delete_Childなど）を使用してレイヤー上のオブジェクトが操作できます。


OG_Get_Objectの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you have a map of the world and you want to change
**the color of one of the countries.First, you would get the handle
**to the country object, then you would change its color.
*/

PROCEDURE color_country(country_name) IS
   my_object    OG_Object;
   obj_record   OG_Graphic_Ca;
BEGIN
   my_object:=OG_Get_Object(Country_Name);
   obj_record.graphic_caob.mask:=OG_None_Generica;
   obj_record.graphic_caoh.mask:=OG_Ffcolor_Graphica;
   obj_record.graphic_caoh.ffcolor:='red';
   OG_Set_Attr(My_Object, obj_record);
END;


OG_Get_Point

  例	  関連項目

説明　このファンクションを使用すると、指定したオブジェクト上の点のx座標とy座標を含むレコードが戻ります。

構文

FUNCTION OG_Get_Point
  (object_hdl  OG_Object,
   indx        NUMBER
   rotated     BOOLEAN    :=  FALSE)
RETURN OG_Point;

パラメータ

object_hdl	オブジェクトのハンドル。
indx	戻される点の索引。
rotated	オブジェクトに適用されている回転角を、戻された点に反映させるかどうかを指定します。
戻り値　指定した点の位置。

使用上の注意

多角形: オブジェクトのindx番目の点が戻ります。

円弧、チャート、四角形、丸い四角形: 索引0では左上角、索引1では右上角、索引2では右下角、索引3では左下角の点が戻ります。

テキスト: 索引0では左上角、索引1では右上角、索引2では右下角、索引3では左下角の点が戻ります。

行: 索引0では始点、索引1では終点が戻ります。

イメージ、グループ、記号: 適用されません。

Graphics Builderでオブジェクトを作成すると、そのオブジェクトを描画するときにマウスで選択した順序で点に初期索引値が付けられます（最初の点の初期索引値は0になります）。また、プログラムを使用して点を挿入すると、挿入時に指定した索引に従って索引値が付けられます。


OG_Get_Pointの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you have several polygons on a map, each of which connects
**the cities within a specific distribution area.If a city is transferred from one
**distribution area to another, you would want to get a handle to the point
**representing that city, delete it from one polygon, and add it to another polygon.
*/

PROCEDURE move_city(area1 IN OG_Object, area2 IN OG_Object,
  city_index NUMBER) IS
   the_city   OG_Point;
BEGIN
   the_city:=OG_Get_Point(Area1, city_index);
   OG_Delete_Point(Area1, city_index, 1);
   OG_Insert_Point(Area2, OG_Last, the_city);
END;


OG_Get_Smptext

  例	  関連項目

説明　このプロシージャで、指定した複数テキスト要素内および指定したテキスト・オブジェクト内の指定した単一テキスト要素の属性値を取得します。取得した属性は、さらに、指定した単一テキスト属性レコードの対応するフィールドに割り当てられます。「テキスト属性」に説明されているように、複数テキスト要素の各テキスト文字列を単一テキスト要素といいます。

構文

PROCEDURE OG_Get_Smptext
  (text_hdl          OG_Object,
   cmpindex          NUMBER,
   smpindex          NUMBER,
   attr      IN OUT  OG_Smptext_Attr);

パラメータ

text_hdl	テキスト・オブジェクトのハンドル。
Cmpindx	属性を取り出す単一テキスト要素を含む複数テキスト要素のテキスト・オブジェクト内の索引。
Smpindex	属性を取り出す単一テキスト要素の複数テキスト要素内の索引。
attr	単一テキスト要素の属性を受け取る単一テキスト属性レコード。
使用上の注意　属性レコードのマスク属性の値で指定された属性値のみが取り出されます。したがって、OG_Get_Smptextをコールしても、マスクが設定されていない属性レコードのフィールドには影響しません。


OG_Get_Smptextの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you have created a message text object.To change the
**message it contains, you would delete the simple text element containing
**the current message and insert a new simple text element containing the
**new message.To maintain the font and other attributes, however,
**you first would want to get the simple text element into an attribute record.
**That way you could modify only the text string, and leave the other attribute
**settings (such as font) unchanged.
*/

PROCEDURE put_msg (mess IN VARCHAR2) IS
   msgobj   OG_Object;
   msgrec   OG_Smptext_Attr;
BEGIN
   msgobj:=OG_Get_Object('Msg');
   msgrec.mask:=OG_Font_Smptexta+
                OG_Color_Smptexta;
   msgrec.font.mask:=OG_All_Fonta;
   OG_Get_Smptext(Msgobj, 0, 0, msgrec);
   OG_Delete_Smptext(Msgobj, 0, 0, 1, FALSE);
   msgrec.mask:=msgrec.mask + OG_Str_Smptexta;
   msgrec.str:=mess;
   OG_Insert_Smptext(Msgobj, msgrec, 0, OG_Last);
END;


OG_Import_Drawing

  例	  関連項目

説明　このプロシージャを使用して、描画オブジェクトをインポートします。描画オブジェクトのハンドルが戻ります。

構文

FUNCTION OG_Import_Drawing
  (name         VARCHAR2,
   repository   NUMBER,
   format       NUMBER,
   use_colors   BOOLEAN,
   damage       BOOLEAN   :=  TRUE,
   update_bbox  BOOLEAN   :=  TRUE)
RETURN OG_Object;

FUNCTION OG_Import_Drawing
  (name         VARCHAR2,
   repository   NUMBER,
   format       NUMBER,
   use_colors   BOOLEAN,
   parent_hdl   OG_Object,
   damage       BOOLEAN   :=  TRUE,
   update_bbox  BOOLEAN   :=  TRUE)
RETURN OG_Object;

パラメータ

name	描画オブジェクトの名前。描画オブジェクトがデータベースに保存されている場合は、この引数に描画オブジェクト名のみを指定します。描画オブジェクトがファイル・システムに保存されている場合は、この引数に描画ファイルの絶対パス名または相対パス名を指定します。
Repository	描画オブジェクトがファイル・システムとデータベースのどちらに保存されているかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db　描画オブジェクトがデータベースに保存されていることを表します。 OG_Filesystem　描画オブジェクトがファイル・システムに保存されていることを表します。
format	描画オブジェクトが保存されている形式を指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。OG_Cgm_Dformat　描画オブジェクトがCGM形式(2バイトまたは4バイト)で保存されていることを表します。 OG_Oracle_Dformat　描画オブジェクトが他のOracle製品で使用されるOracleフォーマットで保存されていることを表します。
use_colors	描画オブジェクトのカラー・パレットを使用するかどうかを指定します。この引数をTRUEにすると、描画オブジェクトのパレットが使用されます。FALSEにすると、Graphics Builderのデフォルトのカラー・パレットが使用されます。
parent_hdl	インポートした描画オブジェクトを子として挿入するグループ・オブジェクトのハンドル。この引数を指定しなければ、描画オブジェクトはルート・オブジェクトの子として挿入されます（ただし、描画オブジェクトをレイヤーとして認識させるには、そのオブジェクトをアクティブにまたは表示する必要があります）。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
戻り値　インポートされた描画オブジェクトのハンドル。


OG_Import_Drawingの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to import the contents of the CGM file 'my_draw'
**onto the layer 'layer0'.You can get the object handle to the layer,
**then use that for parent_hdl.The following procedure does this:
*/
PROCEDURE import_the_drawing IS
   the_layer   OG_Object;
   dummy   OG_Object;
BEGIN
   the_layer:=OG_Get_Object('Layer0');
   dummy:=OG_Import_Drawing('My_Draw', OG_Filesystem,
OG_Cgm16_Dformat, FALSE, the_layer);
END;


OG_Import_Image

  例	  関連項目

説明　このプロシージャを使用して、アクティブ・ウィンドウのアクティブ・レイヤー上にイメージをインポートします。

構文

FUNCTION OG_Import_Image
  (name         VARCHAR2,
   repository   NUMBER,
   format       NUMBER,
   damage       BOOLEAN   :=  TRUE,
   update_bbox  BOOLEAN   :=  TRUE)
RETURN OG_Object;

パラメータ

name	イメージの名前。イメージがデータベースに保存されている場合は、この引数にイメージ名のみを指定します。イメージがファイル・システムに保存されている場合は、この引数にイメージ・ファイルの絶対パス名または相対パス名を指定します。
Repository	イメージがファイル・システムとデータベースのどちらに保存されているかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Db　イメージがデータベースに保存されていることを表します。 OG_Filesystem　イメージがファイルシステムに保存されていることを表します。
format	イメージが保存されている形式を指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。OG_Any_Iformat　Graphics Builderでイメージ形式が自動的に判別されます。注意: イメージが現在使用されていないOracleフォーマットでエクスポートされている場合に、この形式を指定します。 OG_Bmp_Iformat　イメージがBMP形式で保存されていることを表します。 OG_Cals_Iformat　イメージがCALS形式で保存されていることを表します。 OG_Gif_Iformat　イメージがGIF形式で保存されていることを表します。 OG_Jfif_Iformat　イメージがJFIF形式で保存されていることを表します。 OG_Oracle_Sformat　イメージが他のOracle製品で使用されるOracleフォーマットで保存されていることを表します。 OG_Pcd_Iformat　イメージがPCD形式で保存されていることを表します。 OG_Pcx_Iformat　イメージがPCX形式で保存されていることを表します。 OG_Pict_Iformat　イメージがPICT形式で保存されていることを表します。 OG_Ras_Iformat　イメージがSUNのラスター形式で保存されていることを表します。 OG_Tiff_Iformat　イメージがTIFF形式で保存されていることを表します。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
戻り値　インポートされたイメージのハンドル。


OG_Import_Imageの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to import the contents of the TIFF file 'my_image'
**onto the layer 'layer0'.The following procedure does this:
*/
PROCEDURE import_the_image IS
   the_image   OG_Object;
BEGIN
   OG_Activate_Layer(OG_Get_Layer('Layer0'));
   the_image:=OG_Import_Image('My_Image', OG_Filesystem,
     OG_Tiff_Iformat);
END;


OG_Insert_Child

  例	  関連項目

説明　このプロシージャで、指定したグループ・オブジェクトに子オブジェクトを挿入します。挿入されるオブジェクトがすでに別のグループ・オブジェクトの子になっている場合は、Graphics Builderによってその子が現在の親から自動的に削除されます。

構文

PROCEDURE OG_Insert_Child
  (group_hdl    OG_Object,
   child_hdl    OG_Object,
   indx         NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

group_hdl	子を挿入するグループ・オブジェクトのハンドル。
child_hdl	子として挿入するオブジェクトのハンドル。
indx	新しい子を挿入するグループの子リスト内の位置の索引。この引数は、0からnまでの整数であることが必要です。ここで、nは新しい子を挿入する前のグループの子の数です。次のビルトイン定数のいずれかを指定することもできます。  OG_First　グループの最初の子（索引 = 0）としてオブジェクトを挿入します。 OG_Last　グループの最後の子（索引 = 挿入前のグループの子の数）としてオブジェクトを挿入します。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　レイヤーを1つのグループ・オブジェクトとして扱い、このプロシージャにそのオブジェクトのハンドルを渡せば、レイヤーにオブジェクトを挿入できます。また、画面のルート・オブジェクトにグループ・オブジェクトを挿入すれば、新しいレイヤーを作成できます。ただし、Graphics Builderにそのグループをレイヤーとして認識させるには、OG_Activate_LayerまたはOG_Show_Layerをコールして明示的に表示する必要があります。

なお、Graphics Builderではグループ・オブジェクトで発生するループはチェックしません。このようなグループは、グループをそのグループの子孫の子として挿入したときに発生します。このような場合、挿入の影響を受けるオブジェクトのバウンディング・ボックスを更新しようとしたときに、Graphics Builderが無限ループに入ります。

また、このプロシージャで変更されるのは、グループ・オブジェクトの内部構成のみです。したがって、製品オブジェクトの外観を移動または変更するには、Graphics Builderの他のビルトイン・プロシージャを使用する必要があります。


OG_Insert_Childの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you have a several objects representing products in a warehouse,
**and you want to move one of the products from one warehouse to another.
**Your display may use a group comprised of the products to represent the
**inventory for each warehouse.To move a product from one warehouse to
**another, you would want to get the handle to the product object, delete it
**from one warehouse group, and add it to another warehouse group.
*/

PROCEDURE move_prod (warehouse1 IN OG_Object, warehouse2 IN
  OG_Object, prod_index IN number) IS
   the_prod   OG_Object;
BEGIN
   the_prod:=OG_Get_Child(Warehouse1, prod_index);
   OG_Delete_Child(Warehouse1, prod_index, 1);
   OG_Insert_Child(Warehouse2, the_prod, OG_Last);
END;


OG_Insert_Cmptext

  例	  関連項目

説明　このプロシージャで、指定したテキスト・オブジェクトに新しい複数テキスト要素を挿入します。「テキスト属性」に説明されているように、テキスト・オブジェクトのテキスト1行を複数テキスト要素といいます。

構文

PROCEDURE OG_Insert_Cmptext
  (text_hdl     OG_Object,
   indx         NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text_hdl	テキスト・オブジェクトのハンドル。
indx	新しい複数テキスト要素を挿入するテキスト・オブジェクト内の複数テキスト要素リスト内の位置の索引。この引数は、0からnまでの整数であることが必要です。ここで、nは挿入前のテキスト・オブジェクト内の複数テキスト要素の数です。次のビルトイン定数のいずれかを指定することもできます。  OG_First　テキスト・オブジェクトの最初（索引 = 0）に新しい複数テキスト要素を挿入します。 OG_Last　テキスト・オブジェクトの最後（索引 = 挿入前のテキスト・オブジェクト内の複数テキスト要素の数）に新しい複数テキスト要素を挿入します。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意 複数テキスト要素の属性は、Graphics Builderによって自動的に設定されます。したがって、新しい複数テキストを作成する際は、複数テキスト属性レコードを指定する必要はありません。（逆に、要素の属性を取得する場合は、属性を受け取るための複数テキスト属性レコードをOG_Get_Cmptextに指定する必要があります。）


OG_Insert_Cmptextの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to create a text object that contains a message for
**the user.The following function will create the object, insert a compound text
**element, then insert a simple text element that contains the text of the message.
*/

PROCEDURE make_text (the_message IN VARCHAR2) IS
   text_rec   OG_Text_Ca;
   text_obj   OG_Object;
   smp_rec    OG_Smptext_Attr;
BEGIN
   text_rec.text_caob.mask:=OG_None_Generica;
   text_rec.text_caoh.mask:=OG_None_Graphica;
   text_rec.text_caot.mask:=OG_None_Texta;
   text_obj:=OG_Make(Text_Rec);
   OG_Insert_Cmptext(Text_Obj, OG_Last);
   smp_rec.mask:=OG_Str_Smptexta;
   smp_rec.str:=the_message;
   OG_Insert_Smptext(Text_Obj, smp_rec, 0, OG_Last);
END;


OG_Insert_Point

  例	  関連項目

説明　このプロシージャで、指定した多角形オブジェクトに新しい点を挿入します。

構文

PROCEDURE OG_Insert_Point
  (poly_hdl     OG_Object,
   indx         NUMBER,
   pt           OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

poly_hdl	多角形オブジェクトまたは折れ線オブジェクトのハンドル。
indx	新しい点を挿入する点リスト内の位置の索引。この引数は、0からnまでの整数であることが必要です。ここで、nは新しい点を挿入する前のオブジェクト内の点の数です。次のビルトイン定数のいずれかを指定することもできます。  OG_First　オブジェクトの最初（索引 = 0）に新しい点を挿入します。 OG_Last　オブジェクトの最後（索引 = 挿入前のテキスト・オブジェクト内の点の数）に新しい点を挿入します。
pt	挿入する点のx座標とy座標が入ったレコード。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　Graphics Builderでオブジェクトを作成すると、そのオブジェクトを描画するときにマウスで選択した順序で点に初期索引値が付けられます（最初の点の初期索引値は0になります）。また、プログラムを使用して点を挿入すると、挿入時に指定した索引に従って索引値が付けられます。


OG_Insert_Pointの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you have several polygons on a map, each of which connects
**the cities within a specific distribution area.If a city is transferred from one
**distribution area to another, you would want to get a handle to the point
**representing that city, delete it from one polygon, and add it to another polygon.
*/

PROCEDURE move_city(area1 IN OG_Object, area2 IN OG_Object,
city_index IN NUMBER) IS
   the_city   OG_Point;
BEGIN
   the_city:=OG_Get_Point(Area1, city_index);
   OG_Delete_Point(Area1, city_index, 1);
   OG_Insert_Point(Area2, OG_Last, the_city);
END;


OG_Insert_Smptext

  例	  関連項目

説明　このプロシージャで、指定したテキスト・オブジェクト内の指定した複数テキスト要素に新しい単一テキスト要素を挿入します。「テキスト属性」に説明されているように、複数テキスト要素の各テキスト文字列を単一テキスト要素といいます。

構文

PROCEDURE OG_Insert_Smptext
  (textobj      OG_Object,
   smp_attr     OG_Smptext_Attr,
   cmpindex     NUMBER,
   smpindex     NUMBER,
   damage       BOOLEAN          :=  TRUE,
   update_bbox  BOOLEAN          :=  TRUE);

パラメータ

text_hdl	テキスト・オブジェクトのハンドル。
smp_attr	挿入する単一テキスト要素の属性レコード。
Cmpindex	単一テキストを挿入するテキスト・オブジェクト内の複数テキスト要素の索引。
Smpindex	新しい単一テキスト要素を挿入する複数テキスト要素内の位置の索引。この引数は、0からnまでの整数であることが必要です。ここで、nは挿入前の複数テキスト要素内の単一テキスト要素の数です。次のビルトイン定数のいずれかを指定することもできます。OG_First　複数テキスト要素の最初（索引 = 0）に新しい単一テキスト要素を挿入します。 OG_Last　複数テキスト要素の最後（索引 = 挿入前の複数テキスト要素内の単一テキスト要素の数）に新しい単一テキスト要素を挿入します。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　指定した単一テキスト要素の属性レコード（smp_attr）には、テキスト文字列をはじめ、単一テキスト要素の属性が入っています。設定される属性値は、その属性レコードのマスク属性の値で指定された属性値のみです。


OG_Insert_Smptextの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to create a text object that contains a message
**for the user.The following procedure will create the object, insert a
**compound text element, then insert a simple text element that contains
**the text of the message.
*/

PROCEDURE make_text (the_message IN VARCHAR2) IS
   text_rec   OG_Text_Ca;
   text_obj   OG_Object;
   smp_rec    OG_Smptext_Attr;
BEGIN
   text_rec.text_caob.mask:=OG_None_Generica;
   text_rec.text_caoh.mask:=OG_None_Graphica;
   text_rec.text_caot.mask:=OG_None_Texta;
   text_obj:=OG_Make(Text_Rec);
   OG_Insert_Cmptext(Text_Obj, OG_Last);
   smp_rec.mask:=OG_Str_Smptxta;
   smp_rec.str:=the_message;
   OG_Insert_Smptext(Text_Obj, smp_rec, 0, OG_Last);
END;


OG_Make_Ellipse

  例	  関連項目

説明　このファンクションは楕円を作成するために使用します。

構文

FUNCTION OG_Make_Ellipse
  (position  OG_Point,
   height    NUMBER,
   width     NUMBER)
RETURN OG_Object;

パラメータ

position	楕円のx座標とy座標。
height	楕円の高さ。
width	楕円の幅。
戻り値　新たに作成された楕円のハンドル。


OG_Make_Ellipseの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following function creates an ellipse:
*/

FUNCTION example RETURN OG_Object IS
  object  OG_Object;
  pos     OG_Point;
  height  NUMBER;
  width   NUMBER;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  height := 4* OG_Inch;
  width := 4* OG_Inch;

  object := OG_Make_Ellipse(Pos, height, width);
  RETURN(object);
END;


OG_Make_Group

  例	  関連項目

説明　このファンクションは、グループ・オブジェクトを作成するために使用します（なお、OG_Insert_Childを使用して子を追加するまで、作成されたグループは空のままです）。

構文

FUNCTION OG_Make_Group
RETURN OG_Object;

パラメータ

なし。

戻り値　新たに作成されたグループのハンドル。


OG_Make_Groupの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following function creates a group with the specified name:
*/

FUNCTION example(group_name VARCHAR2) RETURN OG_Object IS
  object  OG_Object;
BEGIN
  object := OG_Make_Group;
  OG_Set_Name(Object, group_name);
  RETURN(object);
END;


OG_Make_Image

  例	  関連項目

説明　このファンクションを使用して、データベースの表に格納されたデータからイメージを作成します。

構文

FUNCTION OG_Make_Image
  (query       OG_Query,
   which_data  NUMBER,
   colname     VARCHAR2)
RETURN OG_Object;

パラメータ

query	データベース内の表からイメージを取り出す問合せのハンドル。なお、この表はユーザーの表であることが必要です。データベースにモジュールを保存またはエクスポートするときにGraphics Builderによって使用されるプライベート表は指定できません。
which_data	作成するイメージを問合せの新しいデータ・セットに入れるか古いデータ・セットに入れるかを指定します。値は、次のビルトイン定数のうちのいずれかを指定してください。  OG_Newdata　問合せの新しいデータ・セットにイメージを入れます。 OG_Olddata　問合せの古いデータ・セットにイメージを入れます。
Colname	イメージ・データを入れる問合せ列の名前。作成されたイメージは、この属性で指定した列と問合せのカーソルが指し示す行が交わる問合せセルに入れられます。
戻り値　新たに作成されたイメージのハンドル。


OG_Make_Imageの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following function creates an image from data in the sixth
**row of the query 'image_query' in the column IMAGE_COLUMN:
*/

FUNCTION example(image_name VARCHAR2) RETURN OG_Object IS
  query   OG_Query;
  object  OG_Object;
BEGIN
  query := OG_Get_Query('Image_Query');
  OG_Execute_Query(Query);
  OG_Start_From(Query, OG_Newdata, 5);
  object := OG_Make_Image(Query, OG_Newdata, 'IMAGE_COLUMN');

  OG_Set_Name(Object, image_name);
  RETURN(object);
END;


OG_Make_Line

  例	  関連項目

説明　このファンクションは線を作成するために使用します。

構文

FUNCTION OG_Make_Line
  (startpt  OG_Point,
   endpt    OG_Point)
RETURN OG_Object;

パラメータ

startpt	線の始点（レイアウト単位で指定します）。
endpt	線の終点（レイアウト単位で指定します）。
戻り値　新たに作成された線のハンドル。


OG_Make_Lineの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following function creates a 2" horizontal line:
*/

FUNCTION example RETURN OG_Object IS
  object   OG_Object;
  startpt  OG_Point;
  endpt    OG_Point;
BEGIN
  startpt.x := OG_Inch;
  startpt.y := OG_Inch;
  endpt.x := 2 * OG_Inch;
  endpt.y := OG_Inch;

  object := OG_Make_Line(Startpt, endpt);
  RETURN(object);
END;


OG_Make_Poly

  例	  関連項目

説明　このファンクションを使用して、多角形オブジェクトまたは折れ線オブジェクトを作成します（なお、OG_Insert_Pointを使用して点を追加するまで、作成されたオブジェクトには点がありません）。

構文

FUNCTION OG_Make_Poly
RETURN OG_Object;

パラメータ

なし。

戻り値　新たに作成された多角形オブジェクトまたは折れ線オブジェクトのハンドル。


OG_Make_Polyの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following function creates a polygon with the specified name:
*/

FUNCTION example(poly_name VARCHAR2) RETURN OG_Object IS
  object  OG_Object;
BEGIN
  object := OG_Make_Poly;
  OG_Set_Name(Object, poly_name);
  RETURN(object);
END;


OG_Make_Rect

  例	  関連項目

説明　このファンクションは、四角形を作成するために使用します。

構文

FUNCTION OG_Make_Rect
  (position  OG_Point,
   height    NUMBER,
   width     NUMBER)
RETURN OG_Object;

パラメータ

position	四角形のx座標とy座標。
height	四角形の高さ。
width	四角形の幅。
戻り値　新たに作成された四角形のハンドル。


OG_Make_Rectの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following function creates a rectangle:
*/

FUNCTION example RETURN OG_Object IS
  object  OG_Object;
  pos     OG_Point;
  height  NUMBER;
  width   NUMBER;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  height := 4* OG_Inch;
  width := 4* OG_Inch;

  object := OG_Make_Rect(Pos, height, width);
  RETURN(object);
END;


OG_Make_Rrect

  例	  関連項目

説明　このファンクションは、丸い四角形を作成するために使用します。

構文

FUNCTION OG_Make_Rrect
  (position  OG_Point,
   height    NUMBER,
   width     NUMBER)
RETURN OG_Object;

パラメータ

position	丸い四角形のx座標とy座標。
height	丸い四角形の高さ。
width	丸い四角形の幅。
戻り値　新たに作成された丸い四角形のハンドル。


OG_Make_Rrectの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following function creates a rounded rectangle:
*/

FUNCTION example RETURN OG_Object IS
  object  OG_Object;
  pos     OG_Point;
  height  NUMBER;
  width   NUMBER;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  height := 4* OG_Inch;
  width := 4* OG_Inch;

  object := OG_Make_Rrect(Pos, height, width);
  RETURN(object);
END;


OG_Make_Symbol

  例	  関連項目

説明　このファンクションは、記号を作成するために使用します。

構文

FUNCTION OG_Make_Symbol
  (position  OG_Point,
   indx      NUMBER,
   symsize   NUMBER)
RETURN OG_Object;

パラメータ

position	記号の中央の位置。
indx	記号パレットに表示するときの記号の位置の索引（または数値）。
Symsize	記号のサイズ。このプロパティには、次のビルトイン定数を指定できます。  OG_Large_Symsize    OG_Medium_Symsize    OG_Small_Symsize
戻り値　新たに作成された記号のハンドル。


OG_Make_Symbolの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following function creates a symbol:
*/

FUNCTION example RETURN OG_Object IS
  symbol  OG_Object;
  pos     OG_Point;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;

  symbol := OG_Make_Symbol(Pos, 5, OG_Large_Symsize);
  RETURN(symbol);

END;


OG_Make_Text

  例	  関連項目

説明　このファンクションは、テキスト・オブジェクトを作成するために使用します。

構文

FUNCTION OG_Make_Text
  (position  OG_Point,
RETURN OG_Object;

OG_Make_Text
  (position  OG_Point,
   string    VARCHAR2)
RETURN OG_Object;

OG_Make_Text
  (position  OG_Point,
   string    VARCHAR2,
   ptsize    NUMBER)
RETURN OG_Object;

パラメータ

position	テキスト・オブジェクトのx座標とy座標。
string	テキスト文字列。
ptsize	文字サイズ。
戻り値　新たに作成されたテキスト・オブジェクトへのハンドル。


OG_Make_Textの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following function creates a text object:
*/

FUNCTION example RETURN OG_Object IS
  object  OG_Object;
  pos     OG_Point;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  object := OG_Make_Text(Pos, 'Sales Rankings');
  RETURN(object);
END;


OG_Move

  例	  関連項目

説明  このプロシージャで、指定したオブジェクトをレイアウトの別の位置に移動します。

構文

PROCEDURE OG_Move
  (object_hdl   OG_Object,
   offset       OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

object_hdl	移動するオブジェクトのハンドル。
オフセット	オブジェクトを現在の位置から移動する相対的な距離。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　移動後のオブジェクトのxy座標が負になるようにオフセットを指定すれば、オブジェクトをレイアウトの外に移動できます。

また、オフセットのxy成分に正の値を指定すると、オブジェクトが右下に移動します。負の値を指定すると、オブジェクトが左上に移動します。

オブジェクトをレイアウト上の任意の絶対座標に移動するには、適切な属性レコードに新しい位置を設定します。


OG_Moveの例

  アルファベット順リスト           [image]  すべての例     [image]  関連項目

/* Suppose you have an object that represents inventory in a warehouse.
**If the inventory is moved from one warehouse to another, you would
**want to move the object that represents it.
*/

PROCEDURE move_inventory(invent_obj IN OG_Object) IS
   distance   OG_Point;
BEGIN
   distance.x:=(3*OG_Inch);
   distance.y:=(3*OG_Inch);
   OG_Move(Invent_Obj, distance);
END;


OG_Point_In

  例	  関連項目

説明　このファンクションを使用して、指定した参照点がオブジェクトの領域内にあるかどうかを判別します。

構文

FUNCTION OG_Point_In
  (object_hdl  OG_Object,
   ref_pt      OG_Point,
   aperture    OG_Point)
RETURN OG_Object;

FUNCTION OG_Point_In
  (window_hdl  OG_Window,
   ref_pt      OG_Point,
   aperture    OG_Point)
RETURN OG_Object;

パラメータ

object_hdl	チェックするオブジェクトのハンドル。
window_hdl	チェックするウィンドウのハンドル。
ref_pt	参照点。
Aperture	参照点からの最大許容距離（object_hdlに塗りなしがある場合にのみ指定します）。
戻り値　指定した参照点がオブジェクトの領域内にあれば、このファンクションによりそのオブジェクトのハンドルが戻ります。参照点がオブジェクトの領域内になければ、NULLハンドルが戻ります。

使用上の注意　このファンクションは、ユーザーのマウスのアクティビティを監視する場合に特に便利です。たとえば、グループ・オブジェクト用のボタン・プロシージャを作成し、そのプロシージャの最初の部分でイベント・レコードを使用して、マウスが選択または移動されたときのマウスの位置を特定できます。その後、OG_Point_InやOG_Point_Nearをコールすれば、グループ・オブジェクトとマウスの座標を引数として渡せます。このとき、このファンクションにより、ユーザーが選択したグループ内のオブジェクトが戻ります。

なお、このファンクションで判別できるのは、オブジェクトの領域内にある点のみです。参照点がオブジェクトの枠上にあれば、NULLハンドルが戻ります。（このファンクションでは、オブジェクトの枠の太さが可能な範囲で最も細いことが前提です。つまり太い枠線に変換された領域は無視されます）。オブジェクトが塗りなしパターンの場合（つまり、塗り領域がまったくない場合）、このファンクションによりデフォルトでOG_Point_Nearの動作が実行されます。なお、引数apertureはOG_Point_Inでは使用されませんが、オブジェクトが塗りなしパターンの場合にOG_Point_Nearに渡されます。

引数にオブジェクトを1つのみ指定すると、このファンクションによりそのオブジェクト内に参照点が存在するかどうかがチェックされます。一方、グループ・オブジェクトを指定すると、そのグループ（とサブグループ）のメンバーがすべてチェックされ、参照点が存在する一番上の単一オブジェクトが戻ります（グループのどのオブジェクトにも参照点が存在しなければ、NULLハンドルが返されます）。なお、レイヤーはグループ・オブジェクトとして渡すことができます。同様に、オブジェクトのかわりにウィンドウを指定すると、このファンクションにより、そのウィンドウ内のオブジェクトがすべてチェックされます。

参照点が複数のオブジェクトの枠上に存在する場合は、グループ・ツリーの一番上のオブジェクトが戻ります。


OG_Point_Inの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose your application allows the user to select an object and drag it on
**top of other objects that are within a group.When the user releases the mouse
**button, you want to determine which object the mouse is pointing to, and destroy it.
**The following procedure could be used as a button procedure for the object that was dragged.
*/

PROCEDURE destroy_target (hitobj IN OG_Object, buttonobj IN
OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
   the_group    OG_Object;
   aper         OG_Point;
   target_obj   OG_Object;
BEGIN
   IF eventinfo.event_type=OG_Mouse_Up THEN
      the_group:=OG_Get_Object('Big_Group');
      aper.x:=3*OG_App.HSCREEN_RES;   /* three pixels */
      aper.y:=3*OG_App.VSCREEN_RES;   /* three pixels */
      target_obj:=OG_Point_In(The_Group,
        eventinfo.mouse_position, aper);
      IF not(OG_Isnull(Target_Obj)) THEN
         OG_Destroy(Target_Obj);
      END IF;
   END IF;
END;


OG_Point_Near

  例	  関連項目

説明　このファンクションを使用して、オブジェクトの枠上に、指定した参照点があるかどうかを判別します。

構文

FUNCTION OG_Point_Near
  (object_hdl  OG_Object,
   ref_pt      OG_Point,
   aperture    OG_Point)
RETURN OG_Object;

FUNCTION OG_Point_Near
  (window_hdl  OG_Window,
   ref_pt      OG_Point,
   aperture    OG_Point)
RETURN OG_Object;

パラメータ

object_hdl	チェックするオブジェクトのハンドル。
window_hdl	チェックするウィンドウのハンドル。
ref_pt	参照点。
Aperture	参照点からの最大許容距離。
戻り値　指定した参照点がオブジェクトの枠上にあれば、このファンクションによりそのオブジェクトのハンドルが戻ります。参照点がオブジェクトの枠上になければ、NULLハンドルが戻ります。

使用上の注意　このファンクションは、ユーザーのマウスのアクティビティを監視する場合に特に便利です。たとえば、グループ・オブジェクト用のボタン・プロシージャを作成し、そのプロシージャの最初の部分でイベント・レコードを使用して、マウスが選択または移動されたときのマウスの位置を特定できます。その後、OG_Point_InやOG_Point_Nearをコールすれば、グループ・オブジェクトとマウスの座標を引数として渡せます。このとき、このファンクションにより、ユーザーが選択した単一オブジェクトが戻ります。

なお、オブジェクトが透明な枠パターンの場合、このファンクションではNULLハンドルが戻ります。

引数に単一オブジェクトを指定すると、このファンクションにより、そのオブジェクトの枠上に参照点が存在するかどうかがチェックされます。一方、グループ・オブジェクトを指定すると、そのグループ（とサブグループ）のメンバーがすべてチェックされ、枠上に参照点が存在する単一オブジェクトが戻ります（グループのどのオブジェクトの枠上にも参照点が存在しなければ、NULLハンドルが戻ります）。なお、レイヤーはグループ・オブジェクトとして渡すことができます。同様に、オブジェクトのかわりにウィンドウを指定すると、このファンクションにより、そのウィンドウ内のオブジェクトがすべてチェックされます。

引数apertureは、参照点とオブジェクトの枠の最大許容距離を表します。すなわち、枠からの距離がこの引数の値以下であれば、そのオブジェクトのハンドルが戻ります。また、apertureで指定した領域がオブジェクトの枠にかかっている場合も、OG_Point_Nearはそのオブジェクトのハンドルを戻します。なお、apertureにはxとy両方の成分があります。

参照点が複数のオブジェクトの枠上に存在する場合は、グループ・ツリーの一番上のオブジェクトが戻ります。

通常、apertureは、ユーザーがマウスで位置を指定するときの、許容できるずれの範囲を決める目的で使用します。このような場合、apertureのx成分とy成分には同じ値、一般に3ピクセルに設定します。


OG_Point_Nearの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose your application allows the user to select an object and drag it
**to the edge of other objects that are within a group.When the user releases
**the mouse button, you want to determine which object's edge the mouse
**is pointing to, and destroy it.The following procedure could be used as a
**button procedure for the object that was dragged.
*/

PROCEDURE destroy_target (hitobj IN OG_Object, buttonobj IN
  OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
   the_group    OG_Object;
   aper         OG_Point;
   target_obj   OG_Object;
BEGIN
   IF eventinfo.event_type=OG_Mouse_Up THEN
      the_group:=OG_Get_Object('Big_Group');
      aper.x:=3*OG_App.HSCREEN_RES;   /* three pixels */
      aper.y:=3*OG_App.VSCREEN_RES;   /* three pixels */
      target_obj:=OG_Point_Near(The_Group,
        eventinfo.mouse_position, aper);
      IF not(OG_Isnull(Target_Obj)) THEN
         OG_Destroy(Target_Obj);
      END IF;
   END IF;
END;


OG_Property_Exists

  例	  関連項目

説明　このファンクションを使用して、ユーザー定義プロパティがオブジェクトに設定されているかどうかをチェックします。

構文

FUNCTION OG_Property_Exists
  (object_hdl  OG_Object,
   prop_name   VARCHAR2)
RETURN BOOLEAN;

パラメータ

object_hdl	チェックするオブジェクトのハンドル。
prop_name	存在するかどうかをチェックしたいプロパティの名前。
戻り値 TRUE	指定したプロパティが存在する場合。
FALSE	指定したプロパティが存在しない場合。


OG_Property_Existsの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure adds the property 'priority' to an object, if it doesn't already exist:
*/

PROCEDURE example(object OG_Object) IS
BEGIN
  IF NOT OG_Property_Exists(Object, 'priority') THEN
    OG_Set_Property(Object, 'priority', 10);
  END IF;
END;


OG_Rotate

  例	  関連項目

説明　このプロシージャで、指定したオブジェクトを指定した角度だけ反時計回りに回転させます。

構文

PROCEDURE OG_Rotate
  (object_hdl   OG_Object,
   center_pt    OG_Point,
   degrees      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

object_hdl	回転させるオブジェクトのハンドル。
center_pt	回転軸となるレイアウト上の点。
Degrees	オブジェクトを反時計回りに回転させる角度。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


OG_Rotateの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you have a display that contains a dial.The needle of the dial
**points at specific values along the face of the dial.When the data changes,
**you may want to rotate the needle to point to a new value.
*/

PROCEDURE rotate_needle (degrees IN NUMBER,
  center_pt IN OG_Point) IS
   the_needle   OG_Object;
BEGIN
   the_needle:=OG_Get_Object('Needle 1');
   OG_Rotate(The_Needle, center_pt, degrees);
END;


OG_Same

  例	  関連項目

説明　このファンクションを使用して、2つのハンドルを比較して同じものかどうかチェックします。たとえば、このファンクションに2つのオブジェクトのハンドルを渡すと、2つのハンドルが同じオブジェクトを指しているかどうかがチェックされます。

構文

FUNCTION OG_Same                             object
  (handle1  OG_Object,
   handle2  OG_Object)
RETURN BOOLEAN;

FUNCTION OG_Same                             query
  (handle1  OG_Query,
   handle2  OG_Query)
RETURN BOOLEAN;

FUNCTION OG_Same                             chart template
  (handle1  OG_Template,
   handle2  OG_Template)
   RETURN BOOLEAN;

FUNCTION OG_Same                             button procedure
  (handle1  OG_Buttonproc,
   handle2  OG_Buttonproc)
RETURN BOOLEAN;

FUNCTION OG_Same                             sound
  (handle1  OG_Sound,
   handle2  OG_Sound)
RETURN BOOLEAN;

FUNCTION OG_Same                             window
  (handle1  OG_Window,
   handle2  OG_Window)
RETURN BOOLEAN;

FUNCTION OG_Same                             layer
  (handle1  OG_Layer,
   handle2  OG_Layer)
RETURN BOOLEAN;

FUNCTION OG_Same                             timer
  (handle1  OG_Timer,
   handle2  OG_Timer)
RETURN BOOLEAN;

FUNCTION OG_Same                             display
  (handle1  OG_Display,
   handle2  OG_Display)
RETURN BOOLEAN;

FUNCTION OG_Same                             axis
  (handle1  OG_Axis,
   handle2  OG_Axis)
RETURN BOOLEAN;

FUNCTION OG_Same                             field template
  (handle1  OG_Ftemp,
   handle2  OG_Ftemp)
RETURN BOOLEAN;

FUNCTION OG_Same                             reference line
  (handle1  OG_Refline,
   handle2  OG_Refline)
RETURN BOOLEAN;

パラメータ

handle1	比較する2つのハンドルのうち最初のハンドル。
handle2	比較する2つのハンドルのうち2番目のハンドル。
戻り値 TRUE	2つのハンドルが同じ場合。
FALSE	2つのハンドルが異なる場合。
使用上の注意

"="は使用できないため、ハンドルの値を比較するにはこのファンクションが必要です。たとえば、次のプロシージャは正しくありません。

PROCEDURE invalid (obj1 OG_Object, obj2 OG_Object) IS
BEGIN
   IF obj1 = obj2 THEN     --illegal comparison
      NULL;
   END IF;
END;


OG_Sameの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to compare two objects to see if they are the same.
**The following function returns TRUE if they are the same and FALSE if they are not:
*/

FUNCTION compare (obj1 OG_Object, obj2 OG_Object) RETURN BOOLEAN IS
BEGIN
   IF OG_Same(Obj1, obj2) THEN
      RETURN(TRUE);
   ELSE
      RETURN(FALSE);
   END IF;
END;


OG_Scale

  例	  関連項目

説明　このプロシージャで、指定したオブジェクトのサイズを変更します。

構文

PROCEDURE OG_Scale
  (object_hdl.OG_Object,
   anchor       OG_Point,
   oldpt        OG_Point,
   newpt        OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

object_hdl	サイズを変更するオブジェクトのハンドル。
anchor	オブジェクトのアンカー・ポイント。
oldpt	始点。
newpt	終点。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
使用上の注意　新しい点とアンカー・ポイントとの距離、および古い点とアンカー・ポイントとの距離から、スケール･ファクタ値が計算されます。つまり、この2つの距離の比がスケール変更係数になります。スケール変更係数はx座標とy座標で別々に計算されます。

次に、オブジェクトの各制御ポイントのアンカー・ポイントに対する相対位置がこの係数を使用してスケーリングされます。なお、x座標とy座標のスケール変更係数が等しい場合は、同じ比率を保ったまま（つまり、正方形は正方形のまま）オブジェクトのサイズが変更されます。

たとえば、左上の制御ポイントが(OG_Inch, OG_Inch)のオブジェクトのサイズを2倍にする場合、各パラメータの値を次のように指定します。anchor =(OG_Inch, OG_Inch), oldpt= (OG_Inch+1, OG_Inch+1),newpt= (OG_Inch+2, OG_Inch+2)。したがって、x座標のスケール変更係数は次のようになります。(newpt.x-anchor.x) /(oldpt.x-anchor.x) = (OG_Inch+2-OG_Inch) / (OG_Inch+1-OG_Inch) = 2 / 1 =2(newpt.y-anchor.y) / (oldpt.y-anchor.y) =(OG_Inch+2-OG_Inch) / (OG_Inch+1-OG_Inch) = 2 / 1 = 2

アンカー・ポイントとオブジェクトの各制御ポイント間の距離は、この係数を使用してスケーリングされます。上の例では、スケール変更係数が2で、オブジェクトの右上の制御ポイントがアンカー・ポイントの1.5インチ右にある場合、この制御ポイントはアンカー・ポイントの3インチ右の位置まで移動します。オブジェクトの他の制御ポイントも、同じように移動します。

なお、制御ポイントをアンカー・ポイントとして使用すると、制御ポイントとアンカー・ポイントの距離が0になるため、制御ポイントの位置は変わりません。

また、このプロシージャを使用すると、「選択」ツールを使用して制御ポイントを選択し、レイアウト上の新しい位置までドラッグしたときと同じように、指定したオブジェクトのサイズを変更できます。アンカー・ポイントは、操作中に移動しない制御ポイントです。oldptは移動前の制御ポイント、newptは移動先の新しい位置です。


OG_Scaleの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to double the size of the object that the user selects.
**Assume the object's center is at (OG_Inch, OG_Inch), and use this point as
**the anchor.The following button procedure will double the size of the object:
*/

PROCEDURE double (buttonobj IN OG_Object, hitobj IN
  OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
   anchor OG_Point;
   newpt OG_Point;
   oldpt OG_Point;
BEGIN
   anchor.x:=OG_Inch;
   anchor.y:=OG_Inch;
   oldpt.x:=OG_Inch+1;
   oldpt.y:=OG_Inch+1;
   newpt.x:=OG_Inch+2;
   newpt.y:=OG_Inch+2;
   OG_Scale(Hitobj, anchor, oldpt, newpt);
END;


OG_Set_Edgecolor

  例	  関連項目

説明　このプロシージャで、指定したオブジェクトの枠のカラーを設定します。つまり、枠のパターンを「透明」に、枠のバックグラウンド・カラーを指定したカラーに設定します。

構文

PROCEDURE OG_Set_Edgecolor
  (object       OG_Object,
   color        VARCHAR2
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

object	変更するオブジェクトのハンドル。
color	カラーの名前。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


OG_Set_Edgecolorの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure sets the edge color of the specified object:
*/

PROCEDURE example(object OG_Object) IS
BEGIN
  OG_Set_Edgecolor(Object, 'red');
END;


OG_Set_Fillcolor

  例	  関連項目

説明　このプロシージャで、指定したオブジェクトの塗りカラーを設定します。つまり、塗りパターンを「透明」に、塗りバックグラウンド・カラーを指定したカラーに設定します。

構文

PROCEDURE OG_Set_Fillcolor
  (object       OG_Object,
   color        VARCHAR2
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

object	変更するオブジェクトのハンドル。
color	カラーの名前。
Damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


OG_Set_Fillcolorの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure sets the fill color of the specified object:
*/

PROCEDURE example(object OG_Object) IS
BEGIN
  OG_Set_Fillcolor(Object, 'red');
END;


OG_Set_Property

  例	  関連項目

説明　このプロシージャで、オブジェクトのユーザー定義プロパティの値を設定します。

構文

PROCEDURE OG_Set_Property                    date
  (object_hdl  OG_Object,
   prop_name   VARCHAR2,
   prop_value  VARCHAR2,
   date_fmt    VARCHAR2   := 'DD-MON-YY');

PROCEDURE OG_Set_Property                    number
  (object_hdl  OG_Object,
   prop_name   VARCHAR2,
   prop_value  NUMBER);

PROCEDURE OG_Set_Property                    char
  (object_hdl  OG_Object,:
   prop_name   VARCHAR2,
   prop_value  VARCHAR2,);

パラメータ

object_hdl	プロパティを設定するオブジェクトのハンドル。
prop_name	設定するプロパティ名。
prop_value	プロパティに設定する値。
date_fmt	prop_value文字列を日付に変換するための日付書式マスク。
使用上の注意　指定したプロパティが存在すれば、このプロシージャによりその値が変更されます。プロパティが存在しなければ、エラーを出力せずに、プロパティが作成され値が設定されます。


OG_Set_Propertyの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure gets the 'priority' property in each child object in a
**group, and then sets the priority to one greater than its current value:
*/

PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
  current_p    NUMBER;
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count-1 LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    current_p := OG_Get_Num_Property(Child_Obj, 'priority');
    OG_Set_Property(Child_Obj, 'priority', current_p + 1);
  END LOOP;

END;


OG_Synchronize

  例	  関連項目

説明　このプロシージャで、すべてのウィンドウの領域を再描画します。つまり、画面に表示されている画像を全オブジェクトの内部表現と同期化します。

構文

PROCEDURE OG_Synchronize;

パラメータ

なし。

使用上の注意　ユーザーが作成したPL/SQLプロシージャでは、その処理が終わった後にOG_Synchronizeが暗黙的に実行されます。


OG_Synchronizeの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Suppose you want to move an object across the display in ten 1/4" increments.
**Instead of moving it multiple times and having it update visually only at the end
**of the procedure, you may want to "synchronize" the layout with the internal
**representation of the object after each move.
*/

PROCEDURE slide_across(the_object IN OG_Object) IS
   offset   OG_Point;
BEGIN
   offset.x:=(1/4)*OG_Inch;
   offset.y:=0;
   FOR i IN 1..10 LOOP
      move(the_object, offset);
      OG_Synchronize;
   END LOOP;
END;


OG_Update_Bbox

  例	  関連項目

説明　このファンクションで、オブジェクトのバウンディング・ボックスを更新します。オブジェクトがグループの場合は、そのオブジェクトの子孫のバウンディング・ボックスもすべて更新します。

構文

PROCEDURE OG_Update_Bbox
  (object_hdl  OG_Object,
   which_bbox  NUMBER);

パラメータ

object_hdl	更新するオブジェクトのハンドル
which_bbox	内側または外側のバウンディング・ボックスを更新するかどうかを指定します。この引数の値には、次のビルトイン定数のいずれかを指定してください。  OG_Bothbbox　内側と外側のバウンディング・ボックスを更新します。 OG_Innerbbox　内側のバウンディング・ボックスのみを更新します。 OG_Outerbbox　外側のバウンディング・ボックスのみを更新します。


OG_Update_Bboxの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*Suppose you want to move an object.The default behavior
**of the built-in procedure OG_Move is to update the bounding
**boxes of all of the modified object's antecedants, including
**the layer on which the object resides.To update a layer's
**bounding boxes, Graphics Builder must examine every object on that layer.
**If the layer contains a large number of objects, this operation
**can be very time-consuming.*/

/*To make your application more efficient, you can move the
**object while inhibiting this automatic bounding box update,
**then explicitly update only that object's bounding boxes.
**(Note that since the automatic bounding box update does not
**occur, the bounding boxes of the object's antecedants
**may be inaccurate.)
*/

/*When you modify an object with a FALSE bounding box update
**flag, you may also want to use a FALSE damage flag.In this case,
**when you are through modifying the object, you would invoke
**OG_Damage to explicitly damage the object.
*/

PROCEDURE move_efficiently (the_object OG_Object) IS
   offset   OG_Point;
BEGIN
   offset.x:=OG_Inch;
   offset.y:=OG_Inch;
   OG_Move(The_Object, offset, FALSE, FALSE)
   OG_Update_Bbox(The_Object, OG_Bothbbox);
   OG_Damage(The_Object);

END;


新しいトピックの見出しをここに入力する
この文字で始まるビルトイン・サブプログラムはありません。


プロパティ・ビルトイン・サブプログラムのアルファベット順リスト

アクティブ・プロパティ(タイマー)

矢印スタイル・プロパティ(線)

自動最大値プロパティ(軸,値)

自動最大値プロパティ(軸,日付)

自動最大値プロパティ(軸,項目)

自動最大値プロパティ(枠,表チャート)

自動最小値プロパティ(軸,値)

自動最小値プロパティ(軸,日付)

自動最小値プロパティ(軸,項目)

自動最小値プロパティ(枠,表チャート)

自動主目盛間隔プロパティ(軸,値)

自動主目盛間隔プロパティ(軸,日付)

自動更新プロパティ(チャート)

軸ラベル・プロパティ(軸,一般)

軸プロパティ(フィールド・テンプレート, 軸チャート)

軸プロパティ(参照線)

軸タイプ・プロパティ(軸,一般)

バックグラウンド線カラー・プロパティ(図形)

バックグラウンド塗りカラー・プロパティ(図形)

基本円弧プロパティ(円弧)

基本四角形プロパティ(四角形)

基本四角形プロパティ(丸い四角形)

基本線軸プロパティ(枠,軸チャート)

基本線の値プロパティ(枠,軸チャート)

凹凸スタイル・プロパティ(図形)

バウンディング・ボックスの幅プロパティ(テキスト)

バウンディング・ボックスの高さプロパティ(テキスト)

ボタン・プロシージャ・プロパティ(チャート要素)

ボタン・プロシージャ・プロパティ(一般)

キャッシュ・タイプ・プロパティ(問合せ)

端形式プロパティ(図形)

項目ラベル・プロパティ(枠,円グラフ・チャート)

項目日付書式プロパティ(枠, 円グラフ・チャート)

項目数値書式プロパティ(枠, 円グラフ・チャート)

項目幅プロパティ(枠,軸チャート)

中央プロパティ(記号)

キャラクタ・セット・プロパティ(テキスト)

子の数プロパティ(グループ)

クリップ・フラグ・プロパティ(グループ)

クリップする四角形プロパティ(イメージ)

クローズ・トリガー・プロパティ(図表)

閉じ形状プロパティ(円弧)

閉じ形状プロパティ(多角形)

カラー・プロパティ(単一テキスト)

カラー・プロパティ(テキスト)

列名プロパティ(枠,表チャート)

列プロパティ(一般)

複合テキスト数プロパティ(テキスト)

接続文字列プロパティ(アプリケーション)

接続文字列プロパティ(アプリケーション)

部数プロパティ(プリンタ)

丸め半径プロパティ erty(丸い四角形)

カーソル・プロパティ(アプリケーション)

カーブ調整プロパティ(フィールド・テンプレート, 軸チャート)

カスタム日付書式プロパティ(枠,軸チャート)

カスタム書式プロパティ(軸,日付)

項目ラベル・プロパティ(軸,一般)

カスタム数値書式プロパティ(枠,軸チャート)

カスタム問合せプロシージャ・プロパティ(問合せ)

カスタム間隔プロパティ(テキスト)

線種スタイル・プロパティ(図形)

データ値プロパティ(枠,円グラフ・チャート)

日付書式プロパティ(軸,項目)

日付書式プロパティ(図表)

日付書式プロパティ(問合せ)

日付値プロパティ(参照線)

曜日書式プロパティ(軸,日付)

深さサイズ・プロパティ(枠,一般)

軸の方向プロパティ(軸,一般)

粗さプロパティ(イメージ)

枠パターン・プロパティ(図形)

枠幅プロパティの例(図形)

終了ページ・プロパティ(プリンタ)

終点プロパティ(線)

終了行プロパティ(チャート)

イベント・プロパティ(チャート要素)

イベント・プロパティ(一般)

オープン時実行プロパティ(問合せ)

タイマーで実行プロパティ(問合せ)

問合せ実行プロパティ(一般)

展開プロパティ(チャート要素)

フィールド・テンプレート・カウント・プロパティ(枠,一般)

塗りパターン・プロパティ(図形)

塗り形状プロパティ(円弧)

フィルタ・プロパティ(チャート)

年の最初の月プロパティ(軸,日付)

固定バウンディング・ボックス・プロパティ(テキスト)

フォアグラウンド線カラー・プロパティ(図形)

フォアグラウンド塗りカラー・プロパティ(図形)

フォント・プロパティ(単一テキスト)

フォーマット・トリガー・プロパティ(一般)

枠タイプ・プロパティ(枠,一般)

格子カウント・プロパティ(枠,表チャート)

高さプロパティ(図表)

高さプロパティ(イメージ)

高さプロパティ(ウィンドウ)

ヘルプ・ターゲット・プロパティ(ウィンドウ)

水平文字揃えプロパティ(テキスト)

水平格子プロパティ(枠,表チャート)

水平レイアウト解像度プロパティ(アプリケーション)

水平原点プロパティ(テキスト)

水平画面解像度プロパティ(アプリケーション)

索引プロパティ(記号)

内側枠ボックス・プロパティ(一般)

間隔プロパティ(タイマー)

非表示プロパティ(テキスト)

結合形式プロパティ(図形)

カーニング・プロパティ(テキスト)

ラベル・プロパティ(参照線)

ラベル回転プロパティ(フィールド・テンプレート, 軸チャート)

ラベル回転プロパティ(軸,日付)

 Landscapeプロパティ(プリンタ)

凡例中の列数プロパティ(枠,一般)

凡例プロパティ(枠,一般)

線の形式プロパティ(フィールド・テンプレート, 軸チャート)

主目盛格子プロパティ(軸,一般)

主目盛格子プロパティ(軸,一般)

主目盛格子プロパティ(軸,項目)

最大行数プロパティ(枠,表チャート)

最大値プロパティ(軸,値)

最大値プロパティ(軸,日付)

最大行プロパティ(問合せ)

最小値プロパティ(軸,項目)

最小値プロパティ(枠,表チャート)

最小値プロパティ(軸,値)

最小値プロパティ(軸,日付)

補助目盛格子プロパティ(軸,一般)

補助きざみ数プロパティ(軸,一般)

補助目盛きざみプロパティ(軸,一般)

月書式プロパティ軸,日付)

名前プロパティ(チャート要素)

名前プロパティ(枠,一般)

名前プロパティ(フィールド・テンプレート,一般)

名前プロパティ(フィールド・テンプレート,一般)

名前プロパティ(一般)

名前プロパティ(プリンタ)

名前プロパティ(問合せ)

名前プロパティ(サウンド)

名前プロパティ(タイマー)

名前プロパティ(ウィンドウ)

近似プロパティ(テキスト)

オーバーラップなしプロパティ(枠,円グラフ・チャート)

数値書式プロパティ(軸,項目)

数値書式プロパティ(軸,値)

数値プロパティ(参照線)

オブジェクト・タイプ・プロパティ(一般)

オープン・トリガー・プロパティ(図表)

原点プロパティ(テキスト)

その他プロパティ(枠,円グラフ・チャート)

外側枠ボックス・プロパティ(一般)

オーバーラップ・プロパティ(フィールド・テンプレート,軸チャート)

ページ・サイズ・プロパティ(プリンタ)

親プロパティ(一般)

パスワード・プロパティ(アプリケーション)

パーセント元プロパティ(軸,値)

パーセント基準プロパティ(軸,値)

パーセント値プロパティ(枠,円グラフ・チャート)

プラットフォーム・プロパティ(アプリケーション)

表示枠プロパティ(枠,一般)

表示順序プロパティ(枠,円グラフ・チャート)

使用部分位置プロパティ(フィールド・テンプレート, 軸チャート)

表示形式プロパティ(フィールド・テンプレート, 軸チャート)

ポイント数プロパティ(多角形)

ポイント・サイズ・プロパティ(テキスト)

位置プロパティ(軸,一般)

位置プロパティ(イメージ)

位置プロパティ(ウィンドウ)

問合せ後トリガー・プロシージャ・プロパティ(問合せ)

出力ファイル・プロパティ(プリンタ)

プロシージャ・プロパティ(タイマー)

品質プロパティ(イメージ)

四半期書式プロパティ(軸,日付)

問合せプロパティ(チャート)

問合せソース・プロパティ(問合せ)

「問合せタイプ」プロパティ(問合せ)

データ範囲プロパティ(チャート)

参照線カウント・プロパティ(枠,軸チャート)

ルート・プロパティ(枠,一般)

ルート・プロパティ(フィールド・テンプレート,一般)

回転角度プロパティ(図形)

スケーラブルな境界線プロパティ(テキスト)

スケーラブル・フォント・プロパティ(テキスト)

スケール・プロパティ(軸,値)

ダブル-Y軸プロパティ(枠,軸チャート)

パラメータ設定プロパティ(一般)

シャドウ方向プロパティ(枠,一般)

シャドウ・サイズ・プロパティ(枠,一般)

単一テキスト数プロパティ(複数テキスト)

サイズと位置プロパティ(チャート)

週末をスキップ・プロパティ(軸,日付)

間隔プロパティ(テキスト)

開始ページ・プロパティ(プリンタ)

始点プロパティ(線)

開始行プロパティ(チャート)

ステップ・プロパティ(軸,値)

ステップ・プロパティ(軸,日付)

スタイル・プロパティ(テキスト)

記号サイズ・プロパティ(記号)

合成プロパティ(テキスト)

テンプレート・プロパティ(チャート)

テキスト文字列プロパティ(単一テキスト)

目盛きざみラベル回転プロパティ(軸,一般)

目盛きざみラベル・プロパティ(軸,一般)

目盛きざみ位置プロパティ(軸,一般)

目盛きざみプロパティ(枠,円グラフ・チャート)

タイトル・プロパティ(チャート)

転送モード・プロパティ(図形)

書体プロパティ(テキスト)

表示プロパティ(枠,円グラフ・チャート)

合計値プロパティ(枠,円グラフ・チャート)

ユーザー名プロパティ(アプリケーション)

値書式プロパティ(枠,円グラフ・チャート)

垂直文字揃えプロパティ(テキスト)

垂直格子プロパティ(枠,表チャート)

垂直レイアウト解像度プロパティ(アプリケーション)

垂直原点プロパティ(テキスト)

垂直画面解像度プロパティ(アプリケーション)

フォントの太さプロパティ(テキスト)

幅プロパティ(図表)

幅プロパティ(イメージ)

幅プロパティ(テキスト)

幅プロパティ(ウィンドウ)

丸めプロパティ(テキスト)


この文字で始まるビルトイン・サブプログラムはありません。


軸（日付）プロパティ

自動最大値プロパティ

自動最小値プロパティ

自動主目盛間隔プロパティ

カスタム書式プロパティ

曜日書式プロパティ

年の最初の月プロパティ

ラベル・プロパティ

最大値プロパティ

最小値プロパティ

月書式プロパティ

四半期書式プロパティ

週末をスキップ・プロパティ

ステップ・プロパティ

年書式プロパティ


自動最大値プロパティ

  例	  関連項目

説明  軸最大値を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Date_Automax
  (axis OG_Axis,
   automax BOOLEAN,
   maximun  DATE);

FUNCTION OG_Get_Date_Automax
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
automax	軸最大値を「自動」に設定するかどうかを指定します。
maximun	最大軸値を指定します（ただし、automaxがFALSEの場合のみ）。


自動最大値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if axis
**Y1's datemaximum is set to auto.If
**the return value is TRUE, it resetsthe
**value to FALSE with default_max;
**if the return value isFALSE, it resets
**the value to TRUE after reading the
**specified maximum axis value.
/*

PROCEDURE datemax IS
  template	og_template;
  axis	og_axis;
  val1	date;
  val2	boolean;
  default_max date := '06-dec-99';
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val2 := og_get_date_automax(axis);
  if val2 = true then
    og_set_date_automax(axis, false, default_max);
    val1 := og_get_date_maximum(axis);
  elsif val2 = false then
   og_set_date_automax(axis, true, default_max);
  end if;
END;


自動最小値プロパティ

  例	  関連項目

説明  軸最小値を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Date_Automin
  (axis OG_Axis,
   automin BOOLEAN,
   minimun DATE);

FUNCTION OG_Get_Date_Automin
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
automin	軸最小値を「自動」に設定するかどうかを指定します。
minimun	最小軸値を指定します（ただし、autominがFALSEの場合のみ）。


自動最小値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if axis
**Y1's dateminimum is set to auto.If the
**return value is TRUE, it resets thevalue
**to FALSE with default_min; if the return
**value isFALSE, it resets the value to
**TRUE after reading the specifiedminimum
**axis value.
*/

PROCEDURE datemin IS
  template	og_template;
  axis	og_axis;
  val1	date;
  val2	boolean;
 default_min	date := '01-dec-79';
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val2 := og_get_date_automin(axis);
  if val2 = true then
    og_set_date_automin(axis, false, default_min);
    val1 := og_get_date_minimum(axis);
  elsif val2 = false then
    og_set_date_automin(axis, true, default_min);
  end if;
END;


自動主目盛間隔プロパティ

  例	  関連項目

説明  主目盛間隔を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Date_Autostep
  (axis      OG_Axis,
   autostep  BOOLEAN,
   step      NUMBER);

FUNCTION OG_Get_Date_Autostep
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
autostep	主目盛間隔を「自動」に設定するかどうかを指定します。
step	主目盛間隔を指定します（ただし、autostepがFALSEの場合のみ）。


自動主目盛間隔プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if axis
**Y1's date stepis set to auto.If the
**return value is TRUE, it resets the value
**to FALSE with default_step; if the return
**value is FALSE,it resets the value
**to TRUE after reading the specified step
**value.
*/

PROCEDURE datestep IS
  template	og_template;
  axis	og_axis;
  val	boolean;
  num	number;
  default_step number := og_second_step;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val:= og_get_date_autostep(axis);
  if val = true then
    og_set_date_autostep(axis, false, default_step);
    num := og_get_date_step(axis);
  elsif val = false then
    og_set_date_autostep(axis, true, default_step);
  end if;
END;


カスタム書式プロパティ

  例	  関連項目

説明  軸目盛きざみラベルのカスタム日付書式です。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Custfmt
  (axis     OG_Axis,
   custfmt  VARCHAR2);

FUNCTION OG_Get_Custfmt
  (axis  OG_Axis)
RETURN VARCHAR2;

パラメータ

axis	軸オブジェクトのハンドルです。
custfmt	軸目盛きざみラベルのカスタム日付書式です。


カスタム書式プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**Custom format value andcompares it
**with the variable 'default_format';
**ifthe two value are not equal,
**it resets the current format to the
**value of the 'default_format'.
*/

PROCEDURE customfmt IS
  template	og_template;
  axis	og_axis;
  val	varchar2(10);
  default_format varchar2(10) := 'DD_YY_MM';
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_custfmt(axis);
  if val != default_format then
    og_set_custfmt(axis, default_format);
  end if;
END;


この文字で始まるビルトイン・サブプログラムはありません。


曜日書式プロパティ

  例	  関連項目

説明  曜日ラベルの表示形式を決めます。このプロパティには、次のビルトイン定数を指定できます。

OG_Firstletter_Fmt

OG_Threeletter_Fmt

構文

PROCEDURE OG_Set_Dayfmt
  (axis    OG_Axis,
   dayfmt  NUMBER);

FUNCTION OG_Get_Dayfmt
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
dayfmt	曜日ラベルの表示形式を決めます。


曜日書式プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks the
**day-of-week format.If the current format
**is First-Letter format, it
**resets the value to Three-Letter
**format, and vice versa.
*/

PROCEDURE dayfmt IS
  template	og_template;
  axis	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_monthfmt(axis);
  if num = og_firstletter_fmt then
    og_set_monthfmt(axis, og_threeletter_fmt);
  elsif num = og_threeletter_fmt then
    og_set_monthfmt(axis, og_firstletter_fmt);
  end if;
END;


年の最初の月プロパティ

  例	  関連項目

説明  新しい年度が始まる最初の月です。このプロパティには、次のビルトイン定数を指定できます。

OG_Jan_Month

OG_Feb_Month

OG_Mar_Month

OG_Apr_Month

OG_May_Month

OG_Jun_Month

OG_Jul_Month

OG_Aug_Month

OG_Sep_Month

OG_Oct_Month

OG_Nov_Month

OG_Dec_Month

構文

PROCEDURE OG_Set_Firstmon
  (axis      OG_Axis,
   firstmon  NUMBER);

FUNCTION OG_Get_Firstmon
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
firstmon	新しい年度が始まる最初の月です。


年の最初の月プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following reads the first month
**value and resetsthe value to the next
**acceptable value.
*/

PROCEDURE firstmonth IS
  template	og_template;
  axis	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_firstmon(axis);
  if num = og_jan_month then
    og_set_firstmon(axis, og_feb_month);
  elsif num = og_feb_month then
    og_set_firstmon(axis, og_mar_month);
  elsif num = og_mar_month then
    og_set_firstmon(axis, og_apr_month);
  elsif num = og_apr_month then
    og_set_firstmon(axis, og_may_month);
  elsif num = og_may_month then
    og_set_firstmon(axis, og_jun_month);
  elsif num = og_jun_month then
    og_set_firstmon(axis, og_jul_month);
  elsif num = og_jul_month then
    og_set_firstmon(axis, og_aug_month);
  elsif num = og_aug_month then
    og_set_firstmon(axis, og_sep_month);
  elsif num = og_sep_month then
    og_set_firstmon(axis, og_oct_month);
  elsif num = og_oct_month then
    og_set_firstmon(axis, og_nov_month);
  elsif num = og_nov_month then
    og_set_firstmon(axis, og_dec_month);
  else og_set_firstmon(axis, og_jan_month);
  end if;
END;


ラベル・プロパティ

  例	  関連項目

説明  主目盛間隔を指定すると同時に、目盛きざみラベルの表示形式を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_No_Labels

OG_Second_Labels

OG_Minute_Labels

OG_Hour_Labels

OG_Ampm_Labels

OG_Day_Labels

OG_Dayofweek_Labels

OG_Week_Labels

OG_Month_Labels

OG_Quarter_Labels

OG_Year_Labels

OG_Custom_Labels   （labelsをこの値に設定する場合は、カスタム書式プロパティでカスタム日付書式を指定する必要があります。）

構文

PROCEDURE OG_Set_Labels
  (axis    OG_Axis,
   labels  NUMBER);

FUNCTION OG_Get_Labels
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
labels	主目盛きざみと目盛きざみラベルが表示される軸に沿った主目盛間隔のみでなく、目盛きざみラベルの表示も指定します。


ラベル・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure determines
**if any label boxesare checked.
**If checked label boxes are found,
**it unchecksall labels; if no checked
**labels are found, it checks the 'Year'
**check box.
*/

PROCEDURE labels IS
  template	og_template;
  axis	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);

  num:= og_get_labels(axis);
  if num != og_no_labels then
    og_set_labels(axis, og_no_labels);
  else og_set_labels(axis, og_year_labels);
  end if;
END;


最大値プロパティ

  例	  関連項目

説明  最大軸値を指定します（ただし、「自動最大値」がFALSEの場合のみ）。

構文

（前述のOG_Set_Date_Automaxを参照してください。）

FUNCTION OG_Get_Date_Maximum
  (axis  OG_Axis)
RETURN DATE;

パラメータ

axis	軸オブジェクトのハンドルです。


最大値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if
**axis Y1's datemaximum is set to auto.
**If the return value is TRUE,
**itresets the value to FALSE with
**default_max; if the return valueis
**FALSE, it resets the value to
**TRUE after reading thespecified
**maximum axis value.
/*

PROCEDURE datemax IS
  template	og_template;
  axis	og_axis;
  val1	date;
  val2	boolean;
  default_max date := '06-dec-99';
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val2 := og_get_date_automax(axis);
  if val2 = true then
    og_set_date_automax(axis, false, default_max);
    val1 := og_get_date_maximum(axis);
  elsif val2 = false then
   og_set_date_automax(axis, true, default_max);
  end if;
END;


最小値プロパティ

  例	  関連項目

説明  最小軸値を指定します（ただし、「自動最小値」がFALSEの場合のみ）。

構文

（OG_Set_Date_Autominを参照してください。）

FUNCTION OG_Get_Date_Minimum
  (axis  OG_Axis)
RETURN DATE;

パラメータ

axis	軸オブジェクトのハンドルです。


最小値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if
**axis Y1's dateminimum is set to auto.
**If the return value is TRUE, it resets
**the value to FALSE with default_min;
**if the return value isFALSE, it resets
**the value to TRUE after reading the
**specified minimum axis value.
*/

PROCEDURE datemin IS
  template	og_template;
  axis	og_axis;
  val1	date;
  val2	boolean;
 default_min	date := '01-dec-79';
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val2 := og_get_date_automin(axis);
  if val2 = true then
    og_set_date_automin(axis, false, default_min);
    val1 := og_get_date_minimum(axis);
  elsif val2 = false then
    og_set_date_automin(axis, true, default_min);
  end if;
END;


月書式プロパティ

  例	  関連項目

説明  月ラベルの表示形式を決めます。このプロパティには、次のビルトイン定数を指定できます。

OG_Firstletter_Fmt

OG_Threeletter_Fmt

構文

PROCEDURE OG_Set_Monthfmt
  (axis OG_Axis,
   monthfmt

NUMBER); FUNCTION OG_Get_Monthfmt
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
monthfmt	月ラベルの表示形式を決めます。


月書式プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks the
**Month format.If the current format
**is First-Letter format, it
**resets the value to Three-Letter
**format, and vice versa.
*/

PROCEDURE monthfmt IS
  template	og_template;
  axis	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_monthfmt(axis);
  if num = og_firstletter_fmt then
    og_set_monthfmt(axis, og_threeletter_fmt);
  elsif num = og_threeletter_fmt then
    og_set_monthfmt(axis, og_firstletter_fmt);
  end if;
END;


四半期書式プロパティ

  例	  関連項目

説明  四半期ラベルの表示形式を決めます。このプロパティには、次のビルトイン定数を指定できます。

OG_Arabic_Fmt

OG_Roman_Fmt

構文

PROCEDURE OG_Set_Qtrfmt
  (axis    OG_Axis,
   qtrfmt  NUMBER);

FUNCTION OG_Get_Qtrfmt
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
qtrfmt	四半期ラベルの表示形式を決めます。


四半期書式プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks the
**Quarter format.If the current
**format is Arabic format, it resets
**the value to Roman format, and vice versa.
*/

PROCEDURE qtrfmt IS
  template	og_template;
  axis	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_qtrfmt(axis);
  if num = og_arabic_fmt then
    og_set_qtrfmt(axis, og_roman_fmt);
  elsif num = og_roman_fmt then
    og_set_qtrfmt(axis, og_arabic_fmt);
  end if;
END;


週末をスキップ・プロパティ

  例	  関連項目

説明  軸値を計算するときに週末を無視するかどうかを指定します。

構文

PROCEDURE OG_Set_Skipwknds
  (axis OG_Axis,
   skipwknds BOOLEAN);

FUNCTION OG_Get_Skipwknds
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
skipwknds	軸の値を計算するときに週末を無視するかどうかを指定します。


週末をスキップ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks whether
**weekends areignored when calculating
**axis values.If the value of weekend
**is set to TRUE (ignored), the procedure
**resets the value toFALSE (include
**in the calculation) and vice versa.
*/

PROCEDURE skipwknds IS
  template	og_template;
  axis	og_axis;
  val	boolean;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val:= og_get_skipwknds(axis);
  if val = true then
    og_set_skipwknds(axis, false);
  elsif val = false then
    og_set_skipwknds(axis, true);
  end if;
END;


ステップ・プロパティ

  例	  関連項目

説明  主目盛間隔を指定します（ただし、「自動ステップ」がFALSEの場合のみ）。このプロパティには、次のビルトイン定数を指定できます。

OG_Second_Step

OG_Minute_Step

OG_Hour_Step

OG_Day_Step

OG_Week_Step

OG_Month_Step

OG_Quarter_Step

OG_Year_Step

構文

（OG_Set_Date_Autostepを参照してください。）

FUNCTION OG_Get_Date_Step
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。


ステップ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if
**axis Y1's date step is set to auto.
**If the return value is TRUE, it resets
**the value to FALSE with default_step;
**if the return value is FALSE,
**it resets the value to TRUE
**after reading the specified step
**value.
*/

PROCEDURE datestep IS
  template	og_template;
  axis	og_axis;
  val	boolean;
  num	number;
  default_step number := og_second_step;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val:= og_get_date_autostep(axis);
  if val = true then
    og_set_date_autostep(axis, false, default_step);
    num := og_get_date_step(axis);
  elsif val = false then
    og_set_date_autostep(axis, true, default_step);
  end if;
END


年書式プロパティ

  例	  関連項目

説明  年ラベルの表示形式を決めます。このプロパティには、次のビルトイン定数を指定できます。

OG_Fourdigit_Fmt

OG_Twodigit_Fmt

構文

PROCEDURE OG_Set_Yearfmt
  (axis OG_Axis,
   yearfmt  NUMBER);

FUNCTION OG_Get_Yearfmt
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
yearfmt	年ラベルの表示形式を決めます。


年書式プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks the Year
**format.If the current format is Two-Digit
**format, it resets the value to
**Four-Digit format, and vice versa.
*/

PROCEDURE yearfmt IS
  template	og_template;
  axis	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_yearfmt(axis);
  if num = og_fourdigit_fmt then
    og_set_yearfmt(axis, og_twodigit_fmt);
  elsif num = og_twodigit_fmt then
    og_set_yearfmt(axis, og_fourdigit_fmt);
  end if;
END;


アプリケーション・プロパティ

接続文字列プロパティ

カーソル・プロパティ

水平レイアウト解像度プロパティ

水平画面解像度プロパティ

パスワード・プロパティ

プラットフォーム・プロパティ

ユーザー名プロパティ

垂直レイアウト解像度プロパティ

垂直画面解像度プロパティ


接続文字列プロパティ

  例	  関連項目

説明 現行のデータベース接続用のデータベース接続文字列。接続していないと、このプロパティはNULLになります。

構文

FUNCTION OG_Get_Ap_Connection
RETURN VARCHAR2;

パラメータ

なし。


接続文字列プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

 /*The following open trigger procedure
**displays the connection string for
**the current database connection
**to a text object.
*/

PROCEDURE connection IS connstr	varchar2(10);
BEGIN
  connstr := og_get_ap_connection;
  if connstr = NULL then
    og_set_str(og_get_object('text object'), 'NULL', true, true);
  else
    og_set_str(og_get_object('text object'), connstr, true, true);
  end if;
END;


カーソル・プロパティ

  例	  関連項目

説明 使用するマウス・カーソルの名前。このプロパティの値として、次の文字列のいずれかを指定できます。

default
insertion
crosshair
help
busy

各カーソルの外観は、システムによって異なります。詳細は、使用しているマニュアルを参照してください。このプロパティに無効な値を設定すると、その値は'default'とみなされます。

構文

PROCEDURE OG_Set_Ap_Cursor
  (cursor  VARCHAR2);

FUNCTION OG_Get_Ap_Cursor
RETURN VARCHAR2;

パラメータ

cursor	使用するマウス・カーソル。


カーソル・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure changes
**the shape of the cursor depending on
**which layer the user selects.
*/

 PROCEDURE ChangeCursor (buttonobj IN og_object,
  hitobj IN og_object, win IN og_window,
  eventinfo IN og_event) IS
  cur	varchar2(10);
BEGIN
  mycur := og_get_ap_cursor;
  if cur = 'default' then
     og_set_ap_cursor('insertion');
  elsif cur = 'insertion' then
     og_set_ap_cursor('crosshair');
  elsif cur = 'crosshair' then
     og_set_ap_cursor('help');
  elsif cur = 'help' then
     og_set_ap_cursor('busy');
  elsif cur = 'busy' then
     og_set_ap_cursor('default');
  end if;
END;;


水平レイアウト解像度プロパティ

  例	  関連項目

説明 レイアウトの水平解像度。この値は、レイアウトの水平方向の1インチ内のレイアウト単位の数です。

構文

FUNCTION OG_Get_Ap_Hlayout_Res
RETURN NUMBER;

パラメータ

なし。


水平レイアウト解像度プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

 /*The following procedure displays
**current horizontal layout resolution
**to a text object.
*/

PROCEDURE h_layout IS
  h_layout	number;
BEGIN
  h_layout := og_get_ap_hlayout_res;
  og_set_str(og_get_object('text object'), h_layout, true, true);
END;


水平画面解像度プロパティ

  例	  関連項目

説明 画面の水平解像度。この値は、画面の水平方向1インチ内の画面解像度（ピクセル）単位の数です。

構文

FUNCTION OG_Get_Ap_Hscreen_Res
RETURN NUMBER;

パラメータ

なし。


水平画面解像度プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure displays
**current horizontal screen
**to a text object..
*/

 PROCEDURE HRES IS
  h_res	 number;
BEGIN
  h_res := og_get_ap_vscreen_res;
  og_set_str(og_get_object('text object'), h_res, true, true);
END;


パスワード・プロパティ

  例	  関連項目

説明 現行のデータベース接続用のパスワード。接続していない場合や、Keep_Password作業環境を「いいえ」に設定している場合、このプロパティはNULLになります。

構文

FUNCTION OG_Get_Ap_Password
RETURN VARCHAR2;

パラメータ

なし。


パスワード・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following open trigger procedure
** displays the password for the current
**database connection to a text object.
*/

 PROCEDURE password IS
  pw	 varchar2(10);
BEGIN
  pw := og_get_ap_password;
  if pw = NULL then
    og_set_str(og_get_object('text object'), 'NULL', true, true);
  else
    og_set_str(og_get_object('text object'), pw, true, true);
  end if;
END;


プラットフォーム・プロパティ

  例	  関連項目

説明 Graphics Builderが実行されるプラットフォーム。このプロパティには、次のビルトイン定数を指定できます。

OG_Macintosh_Platform   プラットフォームがApple Macintoshである。

OG_Motif_Platform   プラットフォームがOSF/MOTIFである。

OG_Mswindows_Platform   プラットフォームがMicrosoft Windowsである。

OG_Pm_Platform   プラットフォームがPresentation Managerである。

OG_X_Platform   プラットフォームがX Window Systemである。

構文

FUNCTION OG_Get_Ap_Platform
RETURN NUMBER;

パラメータ

なし。


プラットフォーム・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure displays
**the platform type on which Oracle
**Graphics is currently running to
**a text object.
*/

 PROCEDURE platform IS
  ptform	 number;
BEGIN
  ptform := og_get_ap_platform;
  if ptform = og_macintosh_platform then
    og_set_str(og_get_object('text object'), 'og_macintosh_platform', true, true);
  elsif ptform = og_motif_platform then
    og_set_str(og_get_object('text object'), 'og_motif_platform', true, true);
  elsif ptform = og_mswindows_platform then
    og_set_str(og_get_object('text object'), 'og_mswindows_platform', true, true);
  elsif ptform = og_pm_platform  then
    og_set_str(og_get_object('text object'), 'og_pm_platform', true, true);
  elsif ptform = og_x_platform then
    og_set_str(og_get_object('text object'), 'og_x_platform', true, true);
  end if;
END;


ユーザー名プロパティ

  例	  関連項目

説明 現行のデータベース接続用のユーザー名。接続していないと、このプロパティはNULLになります。

構文

FUNCTION OG_Get_Ap_Username
RETURN VARCHAR2;

パラメータ

なし。


ユーザー名プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following open trigger procedure
**displays the username for the current
**database connection to a text object.
*/

 PROCEDURE username IS
  usr	 varchar2(10);
BEGIN
  usr := og_get_ap_username;
  if usr = NULL then
    og_set_str(og_get_object('text object'), 'NULL', true, true);
  else
    og_set_str(og_get_object('text object'), usr, true, true);
  end if;
END;


垂直レイアウト解像度プロパティ

  例	  関連項目

説明 レイアウトの垂直解像度。この値は、レイアウトの垂直方向の1インチ内のレイアウト単位の数です。

構文

FUNCTION OG_Get_Ap_Vlayout_Res
RETURN NUMBER;

パラメータ

なし。


垂直レイアウト解像度プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure displays current
**vertical layout resolution to a text object..
*/

 PROCEDURE v_layout IS
  v_layout	number;
BEGIN
  v_layout := og_get_ap_vlayout_res;
  og_set_str(og_get_object('text object'), v_layout, true, true);
END;


垂直画面解像度プロパティ

  例	  関連項目

説明 画面の垂直解像度。この値は、画面の垂直方向1インチ内の画面解像度単位（ピクセル）の数です。

構文

FUNCTION OG_Get_Ap_Vscreen_Res
RETURN NUMBER;

パラメータ

なし。


垂直画面解像度プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure displays current
**vertical screen resolution to a text object:
/*

 PROCEDURE VRES IS
  v_res	 number;
BEGIN
  v_res := og_get_ap_vscreen_res;
  og_set_str(og_get_object('text object'), v_res, true, true);
END;


円弧プロパティ

基本円弧プロパティ

閉じ形状プロパティ

塗り形状プロパティ


基本円弧プロパティ

  例	  関連項目

説明 左上角のx座標とy座標、および円弧がカットされる楕円の元として使用する四角形の高さと幅。

構文

PROCEDURE OG_Set_Basearc
  (arc OG_Object,
   basearc OG_Arc,
   damage BOOLEAN    :=  TRUE,
   update_bbox BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Basearc
  (arc  OG_Object)
RETURN OG_Arc;

パラメータ

arc	描写される円弧オブジェクト。
basearc	左上角のx座標とy座標、および楕円から円弧をカットする際に基準として使用する四角形の高さと幅。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


基本円弧プロパティの例

  アルファベット順リスト

/*The following procedure reads
**information from an existing arc,
**reduces all data by half, and
**updates the arc object.
*/

 PROCEDURE base_arc IS
  arc	og_arc;
BEGIN
  arc := og_get_basearc(og_get_object('arc'));
  arc.x := arc.x/2;
  arc.y := arc.y/2;
  arc.height :=arc.height/2;
  arc.width := arc.width/20;
  arc.sangle := arc.sangle/2;
  arc.eangle := arc.eangle/2;
  og_set_basearc(og_get_object('arc'), arc);
END;


閉じ形状プロパティ

  例	  関連項目

説明 円弧の閉じ形状。このプロパティには、次のいずれかを指定できます。

TRUE   円弧が閉じた形状になる。

FALSE   円弧が開いた形状になる。

構文

PROCEDURE OG_Set_Arc_Closed
  (arc OG_Object,
   closed BOOLEAN,
   damage BOOLEAN    :=  TRUE,
   update_bbox BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Arc_Closed
  (arc  OG_Object)
RETURN BOOLEAN;

パラメータ

arc	描写される円弧オブジェクト。
closed	円弧の閉じ形状。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


閉じ形状プロパティの例

  アルファベット順リスト

/*The following procedure reads the
**closure of an existing arc.If closure
**equals TRUE, it fills the arc with red
**and sets the closure value to FALSE;
**if closure equals FALSE, it fills the
**arc with blue and sets the value to TRUE.
*/

 PROCEDURE closure IS
  cls	BOOLEAN; arc	 BOOLEAN;
  arc  	og_object;
BEGIN
  arc := og_get_object('arc');
  cls := og_get_arc_closed(arc);
  if cls = TRUE  then
     og_set_bfcolor(arc, 'red');
     og_set_arc_closed(arc, FALSE);
  else
     og_set_bfcolor(arc, 'blue');
     og_set_arc_closed(arc, TRUE);
  end if;
END;


塗り形状プロパティ

  例	  関連項目

説明 円弧の塗り形状。このプロパティには、次のビルトイン定数を指定できます。

OG_Chord_Arcfill   円弧の塗り形状が弦型になる。

OG_Pie_Arcfill   円弧の塗り形状が完全な扇型になる。

構文

PROCEDURE OG_Set_Arcfill
  (arc OG_Object,
   arcfill NUMBER,
   damage BOOLEAN    :=  TRUE,
   update_bbox BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Arcfill
  (arc  OG_Object)
RETURN NUMBER;

パラメータ

arc	描写される円弧オブジェクト。
arcfill	円弧の形状。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


塗り形状プロパティの例

  アルファベット順リスト

*The following procedure reads the
**arcfill from an arc, prints the value to a
**text object, assigns a different value
** to the arcfill value..
*/

PROCEDURE fill IS

text	og_object;
  arc	og_object;
  num	NUMBER;
BEGIN
  text := og_get_object('text object');
  arc := og_get_object('arc');
  num := og_get_arcfill(arc);
  og_set_str(text, num);
  og_set_arcfill(arc, og_chord_arcfill);
END;


軸（一般）プロパティ

軸ラベル・プロパティ

軸タイプ・プロパティ

項目ラベル・プロパティ

軸の方向プロパティ

主目盛格子プロパティ

主目盛きざみプロパティ

補助目盛格子プロパティ

補助目盛りきざみプロパティ

補助目盛りきざみ数プロパティ

位置プロパティ

目盛きざみラベル回転プロパティ

目盛きざみラベル・プロパティ

目盛きざみ位置プロパティ


軸ラベル・プロパティ

  例	  関連項目

説明  軸に沿って値を識別するラベルを表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Axislabel
  (axis       OG_Axis,
   axislabel  BOOLEAN);

FUNCTION OG_Get_Axislabel
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
axislabel	軸に沿って値を識別する項目ラベルを表示するかどうかを指定します。


軸ラベル・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure determines if
**the Axis Label checkbox is checked.
**If the box is checked, it unchecks
**it, and vice versa.
*/

PROCEDURE GenAxisLbl IS
  template	og_template;
  x_axis	og_axis;
  val  	boolean;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_axislabel(x_axis);
  if val = true then
     og_set_axislabel(x_axis, false);
  else
     og_set_axislabel(x_axis, true);
  end if;
END;


軸タイプ・プロパティ

  例	  関連項目

説明  使用する軸のタイプを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Continuous_Axistype

OG_Date_Axistype

OG_Discrete_Axistype

構文

PROCEDURE OG_Set_Axistype
  (axis

OG_Axis,
   axistype

パラメータ

axis	軸オブジェクトのハンドルです。
axistype	使用する軸のタイプを指定します。


軸タイプ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**current axis type.If the current type
**is CONTINUOUS, it resets the type
**to DISCRETE, or vice versa.If the
**current type is DATE, it changes the
**year format.
*/

PROCEDURE GenAxisType IS
  template	og_template;
  axis	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_x_axis);
  num := og_get_axistype(axis);
  if num = og_discrete_axistype then
     og_set_axistype(axis,og_continuous_axistype);
  elsif num = og_continuous_axistype then
     og_set_axistype(axis, og_discrete_axistype);
  elsif num = og_date_axistype then
     og_set_yearfmt(axis, og_twodigit_fmt);
  end if;
END;


項目ラベル・プロパティ

  例	  関連項目

説明  軸に沿って表示するラベルのテキストを指定します。

構文

PROCEDURE OG_Set_Custlabel
  (axis       OG_Axis,
   custlabel  VARCHAR2);

FUNCTION OG_Get_Custlabel
  (axis  OG_Axis)
RETURN VARCHAR2;

パラメータ

axis	軸オブジェクトのハンドルです。
custlabel	軸に沿って表示するラベルのテキストを指定します。


項目ラベル・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the current
**label of the specific axis, and changes
**the name of that label.
*/

PROCEDURE CustLabel IS
  template	og_template;
  axis	og_axis;
  label	varchar2(20);
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_x_axis);
  label := og_get_custlabel(axis);
  og_set_custlabel(axis, 'Employee Number');
END;


軸の方向プロパティ

  例	  関連項目

説明  増分値または項目を軸に沿ってどの方向に設定するかを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Down_Direction

OG_Left_Direction

OG_Right_Direction

OG_Up_Direction

構文

PROCEDURE OG_Set_Direction
  (axis OG_Axis,
   direction  NUMBER);

FUNCTION OG_Get_Direction
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
direction	増分値や連続した項目を軸に沿ってどの方向に設定するかを指定します。


軸の方向プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

 /*The following procedure reads the
**directions of the x and y axis and sets
**them to the opposite directions.
*/

PROCEDURE GenDirection IS
  template	/*The following procedure reads the tick
**position of the x-axis, and sets it to
**a different value.	og_axis;
  y_axis	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);
  y_axis := og_get_axis(template, og_y1_axis);
  num := og_get_direction(x_axis);
  if num = og_left_direction then
     og_set_direction(x_axis, og_right_direction);
  elsif num = og_right_direction then
     og_set_direction(x_axis, og_left_direction);
  end if;
  num := og_get_direction(y_axis);
  if num = og_up_direction then
     og_set_direction(y_axis, og_down_direction);
  elsif num = og_down_direction then
     og_set_direction(y_axis, og_up_direction);
  end if;
END;


主目盛格子プロパティ

  例	  関連項目

説明  主目盛きざみに格子を表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Majorgrid
  (axis       OG_Axis,
   majorgrid  BOOLEAN);

FUNCTION OG_Get_Majorgrid
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
majorgrid	それぞれの主目盛きざみにグリッドを表示するかどうかを指定します。


主目盛格子プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

 /*The following procedure checks if the
**Major Grid checkbox is checked.  If the
**box is checked, it unchecks it, and vice
**versa.
*/

PROCEDURE GenMajorGrids IS
  template	/*The following procedure reads the tick
**position of the x-axis, and sets it to
**a different value.	og_axis;
  val	boolean;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_majorgrid(x_axis);
  if val = true then
     og_set_majorgrid(x_axis, false);
  else
     og_set_majorgrid(x_axis, true);
  end if;
END;


主目盛きざみプロパティ

  例	  関連項目

説明  主目盛きざみを主目盛間隔で表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Majorticks
  (axis        OG_Axis,
   majorticks  BOOLEAN);

FUNCTION OG_Get_Majorticks
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
majorticks	主目盛きざみを主目盛間隔で表示するかどうかを指定します。


主目盛きざみプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

 /*The following procedure checks if the
**Major Ticks checkbox is checked.  If
**the box is checked, it unchecks it,
**and vice versa.
*/

PROCEDURE GenMajorTicks IS
  template 	og_template;
  x_axis 	og_axis;
  val  	boolean;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_majorticks(x_axis);
  if val = true then
    og_set_majorticks(x_axis, false);
  else
     og_set_majorticks(x_axis, true);
  end if;
END;


補助目盛格子プロパティ

  例	  関連項目

説明  それぞれの補助目盛りきざみに格子を表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Minorgrid
  (axis       OG_Axis,
   minorgrid  BOOLEAN);

FUNCTION OG_Get_Minorgrid
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
minorgrid	それぞれの補助目盛きざみに格子を表示するかどうかを指定します。


補助目盛格子プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if
**the Minor Grid checkbox is checked.
**If the box is checked, it unchecks it,
**and vice versa.
*/

PROCEDURE GenMinorGrids IS
  template	og_template;
  x_axis 	og_axis;
  val	boolean;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_minorgrid(x_axis);
  if val = true then
     og_set_minorgrid(x_axis, false);
  else
     og_set_minorgrid(x_axis, true);
  end if;
END;


補助目盛きざみプロパティ

  例	  関連項目

説明  補助目盛きざみを表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Minorticks
  (axis        OG_Axis,
   minorticks  BOOLEAN);

FUNCTION OG_Get_Minorticks
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
minorticks	補助目盛きざみを表示するかどうかを指定します。


補助目盛きざみプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if the
**Minor Ticks checkbox is checked.  If
**the box is checked, it unchecks it, and
**vice versa.
*/

PROCEDURE GenMinorTicks IS
  template	og_template;
  x_axis 	og_axis;
  val	boolean;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_minorticks(x_axis);
  if val = true then
     og_set_minorticks(x_axis, false);
  else
     og_set_minorticks(x_axis, true);
  end if;
END;


補助目盛りきざみ数プロパティ

  例	  関連項目

説明  主目盛きざみの間に定義される補助目盛きざみ数です。

構文

PROCEDURE OG_Set_Minorct
  (axis     OG_Axis,
   minorct  NUMBER);

FUNCTION OG_Get_Minorct
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
minorct	それぞれの主目盛きざみと主目盛きざみの間に定義される補助目盛きざみ数です。


補助目盛りきざみ数プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the number
**of minor ticks per interval and resets
**the value to triple the original value.
*/

PROCEDURE GenMinorCt IS
  template	og_template;
  x_axis 	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);
  num := og_get_ticklabelrot(x_axis);
  og_set_minorct(x_axis, 3*num);
END;


位置プロパティ

  例	  関連項目

説明  どのチャート枠に沿って軸を表示するかを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Bottom_Position

OG_Left_Position

OG_Right_Position

OG_Top_Position

構文

PROCEDURE OG_Set_Position
  (axis OG_Axis,
   position  NUMBER);

FUNCTION OG_Get_Position
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
position	どのチャート枠に沿って軸を表示するかを指定します。


位置プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure determines
**which edge of the chart the axis
**appears on, and resets the axis to
**the opposite edge.
*/

PROCEDURE GenPosition IS
  template	og_template;
  axis	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_x_axis);
  num := og_get_position(axis);
  if num = og_bottom_position then
     og_set_position(axis, og_top_position);
  elsif num = og_left_position then
     og_set_position(axis, og_right_position);
  elsif num = og_right_position then
     og_set_position(axis, og_left_position);
  elsif num = og_top_position then
     og_set_position(axis, og_bottom_position);
  end if;
END;
*/


目盛きざみラベル回転プロパティ

  例	  関連項目

説明  目盛きざみラベルが回転する方向を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Ccw_Rotation   逆時計回りに回転します。

OG_Cw_Rotation   時計回りに回転します。

OG_No_Rotation   回転しません。

構文

PROCEDURE OG_Set_Ticklabelrot
  (axis          OG_Axis,
   ticklabelrot  NUMBER);

FUNCTION OG_Get_Ticklabelrot
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
ticklabelrot	目盛きざみラベルが回転する方向を指定します。


目盛きざみラベル回転プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**tick label rotation and changes it
**to a different value.
*/

PROCEDURE GenTickLbl IS
  template	og_template;
  x_axis 	og_axis;
  num	PROCEDURE GenTickLbl IS
  template og_template;
  x_axis og_axis;
  num number;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);

  num := og_get_ticklabelrot(x_axis);
  if num = og_ccw_rotation then
     og_set_ticklabelrot(x_axis, og_cw_rotation);
  elsif num = og_cw_rotation then
     og_set_ticklabelrot(x_axis, og_no_rotation);
  elsif num = og_no_rotation then
     og_set_ticklabelrot(x_axis, og_ccw_rotation);
  end if;
END;


目盛きざみラベル・プロパティ

  例	  関連項目

説明  軸に沿って値を識別するラベルを表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Ticklabels
  (axis OG_Axis,
   ticklabels  BOOLEAN);

FUNCTION OG_Get_Ticklabels
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
ticklabels	軸に沿って値を識別する項目ラベルを表示するかどうかを指定します。


目盛きざみラベル・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if
**Tick Label checkbox is checked.
**If the box is checked, it unchecks it,
**and vice versa.
*/

PROCEDURE GenTickLbl IS
  template	og_template;
  x_axis 	og_axis;
  val	boolean;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);
  val := og_get_ticklabels(x_axis);
  if val = true then
     og_set_ticklabels(x_axis, false);
  else
     og_set_ticklabels(x_axis, true);
  end if;
END;


目盛きざみ位置プロパティ

  例	  関連項目

説明  主目盛きざみと補助目盛きざみをどのように表示するかを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Cross_Tickpos

OG_Inside_Tickpos

OG_Outside_Tickpos

構文

PROCEDURE OG_Set_Tickpos
  (axis OG_Axis,
   tickpos  NUMBER);

 FUNCTION OG_Get_Tickpos
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
tickpos	主目盛きざみと補助目盛きざみをどう表示するかを指定します。


目盛きざみ位置プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

 /*The following procedure reads the tick
**position of the x-axis, and sets it to
**a different value.
*/

PROCEDURE GenTickPos IS
  template 	og_template;
  x_axis 	og_axis;
  num	number;
BEGIN
  template := og_get_template('template0');
  x_axis := og_get_axis(template, og_x_axis);
  num := og_get_tickpos(x_axis);
  if num = og_cross_tickpos then
     og_set_tickpos(x_axis, og_inside_tickpos);
  elsif num = og_inside_tickpos then
     og_set_tickpos(x_axis, og_outside_tickpos);
  elsif num = og_outside_tickpos then
     og_set_tickpos(x_axis, og_cross_tickpos);
  end if;
END;


軸（項目）プロパティ

自動最大値プロパティ

自動最小値プロパティ

日付書式プロパティ

最大項目数プロパティ

最小項目数プロパティ

数値書式プロパティ


自動最大値プロパティ

  例	  関連項目

説明  軸に表示する最大項目数を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Disc_Automax
  (axis

OG_Axis,
   automax

パラメータ

axis	軸オブジェクトのハンドルです。
automax	軸に表示する最大項目数を「自動」に設定するかどうかを指定します。
maxcat	軸に表示する最大項目数を指定します（ただし、automaxがFALSEの場合のみ）。


自動最大値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if the
**X-axis's maximum is set to auto.If
**true, it resets the value to false with
**default_maxcat; if false, it reads the
**current value and resets it to true.
*/

PROCEDURE datemax IS
  template	og_template;
  axis	og_axis;
  val	If
**true, it resets the value to false with
**default_maxcat; if false, it reads the
**current value and resets
**it to true.	number;
  default_maxcat	number := 3;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_automax(axis);
  if val = true then
     og_set_disc_automax(axis, false, default_maxcat);
  elsif val = false then
    maxcat := og_get_disc_maxcat(axis);
    og_set_disc_automax(axis,true,default_maxcat);
  end if;
END;


自動最小値プロパティ

  例	  関連項目

説明  軸に表示する最小項目数を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Disc_Automin
  (axis     OG_Axis,
   automin  BOOLEAN,
   mincat   NUMBER);

FUNCTION OG_Get_Disc_Automin
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
automin	軸に表示する最小項目数を「自動」に設定するかどうかを指定します。
mincat	軸に表示する最小項目数を指定します（ただし、autominがFALSEの場合のみ）。


自動最小値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if the
**X-axis's minimum is set to auto.If
**true, it resets the value to false with
*default_mincat;  if false, it reads the
**current value and resets the value to
**true.
*/

PROCEDURE datemin IS
  template	og_template;
  axis	og_axis;
  val	number;
  default_mincat	number;
  default_mincat	number := 50;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_automin(axis);
  if val = true then
    og_set_disc_automin(axis,false,default_mincat);
  elsif val = false then
    mincat := og_get_disc_mincat(axis);
    og_set_disc_automin(axis,true,default_mincat);
  end if;
END;


日付書式プロパティ

  例	  関連項目

説明  軸目盛きざみラベルの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Disc_Datefmt
  (axis      OG_Axis,
   date_fmt  VARCHAR2);

FUNCTION OG_Get_Disc_Datefmt
  (axis  OG_Axis)
RETURN VARCHAR2;

パラメータ

axis	軸オブジェクトのハンドルです。
date_fmt	軸目盛きざみラベルの日付書式を指定します。


日付書式プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the current
**date format of the axis.If the current
**format is not equal to variable
**'default_date', it resets the value to
**'default_date.'
*/

PROCEDURE datefmt IS
  template	og_template;
  axis	og_axis;
  val	varchar2(10);
  default_date	 varchar2(10) := 'DD_YY_MM';
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_datefmt(axis);
  if val != default_date then
     og_set_disc_datefmt(axis, default_date);
  end if;
END;


最大項目数プロパティ

  例	  関連項目

説明  軸に表示する最大項目数を指定します（ただし、automaxがFALSEの場合のみ）。

構文

（前述のOG_Set_Disc_Automaxを参照してください。）

FUNCTION OG_Get_Disc_Maxcat
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。


最大項目数プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*
** The following procedure checks if the
**X-axis's maximum is set to auto.If
**true, it resets the value to false with
**default_maxcat; if false, it reads the
**current value and resets
**it to true.
*/

PROCEDURE datemax IS
  template	og_template;
  axis	og_axis;
  val	boolean;
  maxcat 	number;
  default_maxcat	 number := 3;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_automax(axis);
  if val = true then
     og_set_disc_automax(axis, false, default_maxcat);
  elsif val = false then
    maxcat := og_get_disc_maxcat(axis);
    og_set_disc_automax(axis,true,default_maxcat);
  end if;
END;


最小項目数プロパティ

  例	  関連項目

説明  軸に表示する最小項目数を指定します（ただし、autominがFALSEの場合のみ）。

構文

（前述のOG_Set_Disc_Autominを参照してください。）

FUNCTION OG_Get_Disc_Mincat
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。


最小項目数プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if the
**X-axis's minimum is set to auto.If
**true, it resets the value to false with
**default_mincat;  if false, it reads the
**current value and resets the value to
**true.
*/

PROCEDURE datemin IS
  template	og_template;
  axis	og_axis;
  val	boolean;
  mincat 	number;
  default_mincat	 number := 50;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_automin(axis);
  if val = true then
    og_set_disc_automin(axis,false,default_mincat);
  elsif val = false then
    mincat := og_get_disc_mincat(axis);
    og_set_disc_automin(axis,true,default_mincat);
  end if;
END;


数値書式プロパティ

  例	  関連項目

説明  軸目盛きざみラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Disc_Numfmt
  (axis     OG_Axis,
   num_fmt  VARCHAR2);

FUNCTION OG_Get_Disc_Numfmt
  (axis  OG_Axis)
RETURN VARCHAR2;

パラメータ

axis	軸オブジェクトのハンドルです。
num_fmt	軸目盛きざみラベルの数値書式を指定します。


数値書式プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the current
**number format of the axis.If the current
**format is not equal to variable
**'default_format', it resets the value to
**'default_format'
*/

PROCEDURE discnumfmt IS
  template	og_template;
  axis	og_axis;
  val	varchar2(10);
  default_format	varchar2(10);
  default_format  varchar2(10) := '9,9,9,9';
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_numfmt(axis);
  if val != default_format then
     og_set_disc_numfmt(axis, default_format);
  end if;
END;


軸（値）プロパティ

自動最大値プロパティ

自動最小値プロパティ

自動主目盛間隔プロパティ

最大値プロパティ

最小値プロパティ

数値書式プロパティ

パーセント元プロパティ

パーセント基準プロパティ

スケール・プロパティ

ステップ・プロパティ


自動最大値プロパティ

  例	  関連項目

説明  軸最大値を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Cont_Automax
  (axis     OG_Axis,
   automax  BOOLEAN,
   maximun  NUMBER);

FUNCTION OG_Get_Cont_Automax
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
automax	軸最大値を「自動」に設定するかどうかを指定します。
maximun	最大軸値を指定します（ただし、automaxがFALSEの場合のみ）。


自動最大値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if axis
**Y1's maximum is set to auto.If return
**value is TRUE, resets the value to FALSE
**with default_max; if return value is
**FALSE, it resets the value to TRUE
**after reading the specified maximum
**axis value.
*/

PROCEDURE automin IS
  axis	og_axis;
  template 	og_template;
  val  	boolean;
  num	number;
  default_max	number := 3000;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_autostep(axis);
  if val = TRUE then
    og_set_cont_autostep(axis, FALSE, default_max);
  else
    num := og_get_cont_step(axis);
    og_set_cont_autostep(axis, TRUE, default_max);
  end if;
END;


自動最小値プロパティ

  例	  関連項目

説明  軸最小値を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Cont_Automin
  (axis     OG_Axis,
   automin  BOOLEAN,
   minimun  NUMBER);

FUNCTION OG_Get_Cont_Automin
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
automin	軸最小値を「自動」に設定するかどうかを指定します。
minimun	最小軸値を指定します（ただし、autominがFALSEの場合のみ）。


自動最小値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if axis
**Y1's minimum is set to auto.If the
**value is TRUE, it resets the value to
**FALSE with default_min; if the return
**value is FALSE, it resets the value to
**TRUE after reading the specified minimum
**axis value.
*/

PROCEDURE automin IS
  axis	og_axis;
  template	og_template;
  val 	boolean;
  num	number;
  default_min	number := 500;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_automin(axis);
  if val = TRUE then
    og_set_cont_automin(axis, FALSE, default_min);
  elsif val = FALSE then
    num := og_get_cont_minimum(axis);
    og_set_cont_automin(axis, TRUE, default_min);
  end if;
END;


自動主目盛間隔プロパティ

  例	  関連項目

説明  主目盛間隔を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Cont_Autostep
  (axis      OG_Axis,
   autostep  BOOLEAN,
   step      NUMBER);

FUNCTION OG_Get_Cont_Autostep
  (axis  OG_Axis)
RETURN BOOLEAN;

パラメータ

axis	軸オブジェクトのハンドルです。
autostep	主目盛間隔を「自動」に設定するかどうかを指定します。
step	主目盛間隔を指定します（ただし、autostepがFALSEの場合のみ）。


自動主目盛間隔プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if axis
**Y1's step isset to auto.If the return
**value is TRUE, it resets the value to
**FALSE with default step value; if
**return value is FALSE,it resets
**the value to TRUE after reading
**the specified step value.
*/

PROCEDURE autostep IS
  axis	og_axis;
  template 	og_template;
  val  	boolean;
  num	number;
  step	number := 500;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_autostep(axis);
  if val = TRUE then
    og_set_cont_autostep(axis, FALSE, step);
  else
    num := og_get_cont_step(axis);
    og_set_cont_autostep(axis, TRUE, step);
  end if;
END;


最大値プロパティ

  例	  関連項目

説明  最大軸値を指定します（ただし、「自動最大値」がFALSEの場合のみ）。

構文

（前述のOG_Set_Cont_Automaxを参照してください。）

FUNCTION OG_Get_Cont_Maximum
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。


最大値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if axis
**Y1's maximum is set to auto.If return
**value is TRUE,it reseta the value to
**FALSE with default_max; if return value
**is FALSE, it resets the value to
**TRUE after reading the specified
**maximum axis value.
*/

PROCEDURE automin IS
  axis	og_axis;
  template 	og_template;
  val  	boolean;
  num	number;
  default_max	number := 3000;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_autostep(axis);
  if val = TRUE then
    og_set_cont_autostep(axis, FALSE, default_max);
  else
    num := og_get_cont_step(axis);
    og_set_cont_autostep(axis, TRUE, default_max);
  end if;
END;


最小値プロパティ

  例	  関連項目

説明  最小軸値を指定します（ただし、「自動最小値」がFALSEの場合のみ）。

構文

（前述のOG_Set_Cont_Autominを参照してください。）

FUNCTION OG_Get_Cont_Minimum
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。


最小値プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if axis
**Y1's minimum is set to auto.If the
**return value is TRUE, it resets the
**value to FALSE with default_min;
**if the return value is FALSE,it resets
**the value to TRUE after reading the
**specified minimum axis value.
*/

PROCEDURE automin IS
  axis	og_axis;
  template	og_template;
  val  	boolean;
  num	number;
  default_min	number := 500;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_automin(axis);
  if val = TRUE then
    og_set_cont_automin(axis, FALSE, default_min);
  elsif val = FALSE then
    num := og_get_cont_minimum(axis);
    og_set_cont_automin(axis, TRUE, default_min);
  end if;
END;


数値書式プロパティ

  例	  関連項目

説明  軸目盛きざみラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Cont_Numfmt
  (axis     OG_Axis,
   num_fmt  VARCHAR2);

FUNCTION OG_Get_Cont_Numfmt
  (axis  OG_Axis)
RETURN VARCHAR2;

パラメータ

axis	軸オブジェクトのハンドルです。
num_fmt	軸目盛きざみラベルの数値書式を指定します。


数値書式プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the current
**number format of the axis and resets it to
**a different value.
*/

PROCEDURE numFormat IS
  axis	og_axis;
  template 	og_template;
  val  	varchar2(10);
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_numfmt(axis);
  og_set_cont_numfmt(axis,'9,9,9,9,9');
END;


パーセント元プロパティ

  例	  関連項目

説明  「パーセント基準」値をどのように計算するかを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Category_Pctby   各データ値のパーセンテージを、他の項目の同じフィールドのデータ値と相対的に計算します。

OG_Field_Pctby   各データ値のパーセンテージを、他のフィールドの同じ項目のデータ値と相対的に計算します。

構文

PROCEDURE OG_Set_Pct_By
  (axis    OG_Axis,
   pct_of  NUMBER);

FUNCTION OG_Get_Pct_By
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
pct_of	「パーセント基準」値をどのように計算するかを指定します。


パーセント元プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

*/The following procedure reads the
**calculating method for the
**Percent Of scaling values
**(with Scale is set to OG_PCT_SCALE)
**from the axis and resets the value to
**the next available value.
/*

PROCEDURE pctby IS
  axis	og_axis;
  template 	og_template;
  val  	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_pct_by(axis);
  if val = OG_category_pctby then
    og_set_pct_by(axis, og_field_pctby);
  elsif val = og_field_pctby then
    og_set_pct_by(axis, og_category_pctby);
  end if;
END;


パーセント基準プロパティ

  例	  関連項目

説明  相対スケール変更係数を指定します（ただし、「スケール」がOG_Pct_Scaleに設定されている場合のみ）。このプロパティには、次のビルトイン定数を指定できます。

OG_Maximum_Pctof   各データ値を最大データ値に対するパーセンテージで表示します。

OG_Minimum_Pctof   各データ値を最小データ値に対するパーセンテージで表示します。

OG_Sum_Pctof   各データ値を全データ値の合計に対するパーセンテージで表示します。

構文

PROCEDURE OG_Set_Pct_Of
  (axis    OG_Axis,
   pct_of  NUMBER);

FUNCTION OG_Get_Pct_Of
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
pct_of	相対スケール変数係数を指定します（ただし、「スケール」がOG_Pct_Scaleに設定されている場合のみ）。


パーセント基準プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**relative scaling factor (with Scale
**set to OG_PCT_SCALE)from the axis
**and resets the value to the next
**available value.
*/

PROCEDURE pctof  IS
  axis	og_axis;
  template 	og_template;
  val  	number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_pct_of(axis);
  if val = OG_maximum_pctof then
     og_set_pct_of(axis, og_minimum_pctof);
  elsif val = og_minimum_pctof then
    og_set_pct_of(axis, og_sum_pctof);
  elsif val = og_sum_pctof then
    og_set_pct_of(axis, og_maximum_pctof);
  end if;
END;


スケール・プロパティ

  例	  関連項目

説明  軸のスケール設定に使用するアルゴリズムを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Linear_Scale   最小軸値と最大軸値の間の固定間隔を使用して軸をスケール設定します。

OG_LOG_Scale   最小軸値と最大軸値の間の間隔を判別するために対数アルゴリズム（基数は10のべき）を使用してスケール設定します。

OG_Pct_Scale  「パーセント基準」で指定した割合に対して相対的にデータ値を表示するように軸をスケール設定します。

構文

PROCEDURE OG_Set_Scale
  (axis   OG_Axis,
   scale  NUMBER);

FUNCTION OG_Get_Scale
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。
scale	軸のスケール設定に使用されるアルゴリズムを指定します。


スケール・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads
**the method used for scaling from
**the axis and resets the value
**to the next available value. PROCEDURE  scale IS
*/

PROCEDURE  scale IS
  axis 	og_axis;
  template 	og_template;
  val  	template := og_get_template('template0'); axis := og_get_axis(template, og_y1_axis);

number;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_scale(axis);
  if val = OG_linear_scale then
    og_set_scale(axis, og_log_scale);
  elsif val = og_log_scale then
    og_set_scale(axis, og_pct_scale);
  elsif val = og_pct_scale then
    og_set_scale(axis, og_linear_scale);
  end if;
END;


ステップ・プロパティ

  例	  関連項目

説明  主目盛間隔を指定します（ただし、「自動ステップ」がFALSEの場合のみ）。

構文

（前述のOG_Set_Cont_Autostepを参照してください。）

FUNCTION OG_Get_Cont_Step
  (axis  OG_Axis)
RETURN NUMBER;

パラメータ

axis	軸オブジェクトのハンドルです。


ステップ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if axis
**Y1's step is set to auto. If the return
**value is TRUE, it resets the value to
**FALSE with default step value; if return
**value is FALSE, it resets the value to
**TRUE after reading the specified step value.
*/

PROCEDURE autostep IS
  axis	og_axis;
  template 	og_template;
  val 	boolean;
  num	number;
  step	number := 500;
BEGIN
  template := og_get_template('template0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_autostep(axis);
  if val = TRUE then
    og_set_cont_autostep(axis, FALSE, step);
  else
    num := og_get_cont_step(axis);
    og_set_cont_autostep(axis, TRUE, step);
  end if;
END;


チャート要素プロパティ

「ボタン・プロシージャ」プロパティ

「イベント」プロパティ

展開プロパティ

名前プロパティ


ボタン・プロシージャ・プロパティ

  例	  関連項目

説明  このチャート要素と対応付けるボタン・プロシージャのハンドルです。このプロシージャが必要なマウス・イベントを受け取るには、イベント・プロパティが正しく設定されている必要があることに注意してください。イベント・プロパティには、次のビルトイン定数を指定できます。

OG_No_Events

OG_Mouse_Up

OG_Mouse_Down

OG_Mouse_Move_Down

プロシージャが複数のイベント・タイプを受け取ることができるようにするには、イベントを該当のイベントの定数の合計に設定します。

構文

PROCEDURE OG_Set_Button
  (chart        OG_Object,
   row_num      NUMBER,
   col_name     VARCHAR2,
   button_proc  OG_Buttonproc,
   events       NUMBER);

パラメータ

chart	チャート・オブジェクトのハンドルです。
row_num	チャート要素で表す問合せ行番号です。
col_name	チャート要素で表す問合せ列です。
button_proc	このチャート要素と対応付けるボタン・プロシージャのハンドルです。
events	ボタン・プロシージャが受け取るマウス・イベントのタイプです。


ボタン・プロシージャ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure assigns
**a button procedure tochart
**element MGR_bars.
*/

PROCEDURE  AssignButtonProc IS
  chart og_object;
  mgrbar og_object;
  button og_buttonproc;
BEGIN
  chart := og_get_object('chart');
  mgrbar := og_get_object('MGR_bars');
  button := og_get_buttonproc('button');
  og_set_button(chart, og_get_row(mgrbar), 'MGR', button, og_mouse_down);
END;


イベント・プロパティ

  例	  関連項目

説明  ボタン・プロシージャが受け取るマウス・イベントのタイプです。このプロパティには、次のビルトイン定数を指定できます。

OG_No_Events

OG_Mouse_Up

OG_Mouse_Down

OG_Mouse_Move_Down

プロシージャが複数のイベント・タイプを受け取ることができるようにするには、イベントを該当のイベントの定数の合計に設定します。

構文

（OG_Set_Buttonを参照してください。）

パラメータ

なし


イベント・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure assigns
**a button procedure tochart
**element MGR_bars.
*/

PROCEDURE  AssignButtonProc IS
  chart og_object;
  mgrbar og_object;
  button og_buttonproc;
BEGIN
  chart := og_get_object('chart');
  mgrbar := og_get_object('MGR_bars');
  button := og_get_buttonproc('button');
  og_set_button(chart, og_get_row(mgrbar), 'MGR', button, og_mouse_down);
END;


展開プロパティ

  例	  関連項目

説明  チャート要素（つまり、円グラフ）を展開する距離、つまりチャートのx半径とy半径のパーセンテージ（たとえば、25など）です。このプロパティは、円グラフで使用したときのみ適用されます。また、チャート要素として項目を指定するとすべての円グラフが同じ割合で展開されます。したがって、指定する列名は、項目列ではなく、値列で指定する必要があります。

構文

PROCEDURE OG_Set_Explosion
  (chart        OG_Object,
   row_num      NUMBER,
   col_name     VARCHAR2,
   explode_pct  NUMBER);

パラメータ

chart	チャート・オブジェクトのハンドルです。
row_num	チャート要素で表す問合せ行番号です。
col_name	チャート要素で表す問合せ列です。これは値列の名前で指定する必要があります。
explode_pct	チャート要素（つまり、円グラフ）を展開する距離、つまりチャートのx半径とy半径のパーセンテージ（たとえば、25など）です。


展開プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure assigns the
**distance the chartelement should be
** exploded to to 50.
*/

PROCEDURE Explosion IS
  pie og_object;
  mgr_slice og_object;
BEGIN
  pie := og_get_object('pie');
  mgr_slice := og_get_object('MGR_slices');
  og_set_explosion(pie, og_get_row(mgr_slice), 'MGR', 50);
END;


名前プロパティ

  例	  関連項目

説明  チャート要素の名前です。

構文

PROCEDURE OG_Set_Name
  (chart     OG_Object,
   row_num   NUMBER,
   col_name  VARCHAR2,
   name      VARCHAR2);

パラメータ

chart	チャート・オブジェクトのハンドルです。
row_num	チャート要素で表す問合せ行番号です。
col_name	チャート要素で表す問合せ列です。
name	チャート要素の名前です。


名前プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure sets
**the name of the chart element.
*/

PROCEDURE Name IS
  chart og_object;
  mgr_bar og_object;
BEGIN
  chart := og_get_object('chart');
  mgr_bar := og_get_object('Mgr_bars');
  og_set_name(chart, og_get_row(mgr_bar), 'MGR', 'NewName');
END;


チャート・プロパティ

自動更新プロパティ

終了行プロパティ

フィルタ・プロパティ

問合せプロパティ

データ範囲プロパティ

サイズと位置プロパティ

開始行プロパティ

テンプレート・プロパティ

タイトル・プロパティ


自動更新プロパティ

  例	  関連項目

説明  問合せの実行時にチャートを自動的に更新するように指定します。

構文

PROCEDURE OG_Set_Autoupdate
  (chart OG_Object,
   autoupdate  BOOLEAN);

FUNCTION OG_Get_Autoupdate
  (chart  OG_Object)
RETURN BOOLEAN;

パラメータ

chart	チャート・オブジェクトのハンドルです。
autoupdate	問合せの実行時にチャートを自動的に更新するように指定します。


自動更新プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following reads the value of
**autoupdate in Chartproperties, and
**resets the value to its opposite value
*/

PROCEDURE ChartAutoUpdate IS
  chart og_object;
  autoupdate boolean;
BEGIN
  chart := og_get_object('chart');
  autoupdate := og_get_autoupdate(chart);
  if autoupdate = true then
     og_set_autoupdate(chart, false);
  else
    og_set_autoupdate(chart, true);
   end if;
END;


終了行プロパティ

  例	  関連項目

説明  チャートに表示するデータの最後の行です。

構文

（OG_Set_Rowを参照してください。）

FUNCTION OG_Get_Endrow
  (chart  OG_Object)
RETURN NUMBER;

パラメータ

chart	チャート・オブジェクトのハンドルです。


終了行プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**startrow and endrowvalue from chart
**(provided the Plot rows box is checked),
**and resets the range to startrow -1 and
**endrow -1.)
*/

PROCEDURE ChartStartEnd IS
  chart og_object;
  startrow number;
  endrow number;
BEGIN
  chart := og_get_object('chart');
  startrow := og_get_startrow(chart);
  endrow := og_get_endrow(chart);
  og_set_rows(chart,true, startrow-1, endrow-1);
END;


フィルタ・プロパティ

  例	  関連項目

説明  問合せのフィルタ・トリガー・プロシージャの名前です。

構文

PROCEDURE OG_Set_Filter
  (chart   OG_Object,
   filter  VARCHAR2);

FUNCTION OG_Get_Filter
  (chart  OG_Object)
RETURN VARCHAR2;

パラメータ

chart	チャート・オブジェクトのハンドルです。
filter	問合せのフィルタ・トリガー・プロシージャの名前です。


フィルタ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads
**the name of the current filter trigger
**of the chart, and assigns a different
**filter trigger to the chart
*/

PROCEDURE ChartFilter IS
  chart og_object;
  current_filter varchar2(30);
  new_filter varchar2(30):='MyFilter';
BEGIN
  chart := og_get_object('chart');
  current_filter := og_get_filter(chart);
  og_set_filter(chart, new_filter);
END;


問合せプロパティ

  例	  関連項目

説明  チャートに使用する問合せのハンドルです。

構文

PROCEDURE OG_Set_Query
  (chart        OG_Object,
   query        OG_Query,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Query
  (chart  OG_Object)
RETURN OG_Query;

パラメータ

chart	チャート・オブジェクトのハンドルです。
query	チャートに使用する問合せのハンドルです。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


問合せプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**query handle from the current chart
**(qry0)and resets the handle value to
**qry1.
*/

PROCEDURE ChartQuery IS
  chart og_object;
  qry0 og_query;
  qry1 og_query;
BEGIN
  chart := og_get_object('chart');
  qry0 := og_get_query(chart);
  qry1 := og_get_query('query1');
  og_set_query(chart, qry1);
END;


データ範囲プロパティ

  例	  関連項目

説明  チャートに表示する問合せ行の数を、startrowとendrowで指定した範囲に制限するかどうかを指定します。

構文

PROCEDURE OG_Set_Rows
  (chart      OG_Object,
   rangeflag  BOOLEAN,
   startrow   NUMBER,
   endrow     NUMBER);

FUNCTION OG_Get_Rangeflag
  (chart  OG_Object)
RETURN BOOLEAN;

パラメータ

chart	チャート・オブジェクトのハンドルです。
rangeflag	チャートに表示する問合せ行の数を、 startrowとendrowで指定した範囲に制限するかどうかを指定します。
startrow	チャートに表示するデータの最初の行です。最初のデータ行は0、2番目の行は1となり、以下同様です。
endrow	チャートに表示するデータの最後の行です。


データ範囲プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if
**the number of queryrows that appear
**on the chart is range restricted.
**If true,it resets the value to false
**(i.e. plots all rows); if false, it
**resets the value to true with a
**restricted range specified by
**startrow and endrow.
*/

PROCEDURE ChartRange IS
  chart og_object;
  rangeflag boolean;
  startrow number := 3;
  endrow number := 9;
BEGIN
  chart := og_get_object('chart');
  rangeflag := og_get_rangeflag(chart);
  if rangeflag = true then
     og_set_rows(chart,false, startrow, endrow);
  else
    og_set_rows(chart, true, startrow, endrow);
  end if;
END;


サイズと位置プロパティ

  例	  関連項目

説明  チャートの枠のx座標とy座標、および高さ、幅です（レイアウト単位）。

構文

PROCEDURE OG_Set_Frame
  (chart        OG_Object,
   frame        OG_Rectangle,
   damage       BOOLEAN       :=  TRUE,
   update_bbox  BOOLEAN       :=  TRUE);

FUNCTION OG_Get_Frame
  (chart  OG_Object)
RETURN OG_Rectangle;

パラメータ

chart	チャート・オブジェクトのハンドルです。
frame	チャートの枠のx座標とy座標、および高さ、幅です（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


サイズと位置プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the frame
**size of the chart, and reduces it by half.
*/

PROCEDURE SizeAndPos IS
  chart og_object;
  rect og_rectangle;
BEGIN
  chart := og_get_object('chart');
    rect := og_get_frame(chart);
  rect.x := rect.x/2;
  rect.y := rect.y/2;
  rect.height := rect.height/2;
  rect.width := rect.width/2;
  og_set_frame(chart, rect);
END;


開始行プロパティ

  例	  関連項目

説明  チャートに表示するデータの最初の行です。最初のデータ行は0、2番目の行は1という順で番号付けされています。

構文

（前述のOG_Set_Rowsを参照してください。）

FUNCTION OG_Get_Startrow
  (chart  OG_Object)
RETURN NUMBER;

パラメータ

chart	チャート・オブジェクトのハンドルです。


開始行プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**startrow and endrowvalue from chart
**(provided the Plot rows box is checked),
**and resets the range to startrow -1 and
**endrow -1.)
*/

PROCEDURE ChartStartEnd IS
  chart og_object;
  startrow number;
  endrow number;
BEGIN
  chart := og_get_object('chart');
  startrow := og_get_startrow(chart);
  endrow := og_get_endrow(chart);
  og_set_rows(chart,true, startrow-1, endrow-1);
END;


テンプレート・プロパティ

  例	  関連項目

説明  チャートに使用するテンプレートのハンドルです。

構文

PROCEDURE OG_Set_Template
  (chart        OG_Object,
   template     OG_Template,
   damage       BOOLEAN      :=  TRUE,
   update_bbox  BOOLEAN      :=  TRUE);

FUNCTION OG_Get_Template
  (chart  OG_Object)
RETURN OG_Template;

パラメータ

chart	チャート・オブジェクトのハンドルです。
template	チャートに使用するテンプレートのハンドルです。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


テンプレート・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**template handles template1 and template2
**from chart1 and chart2 respectively, and
**assigns template1 to chart2, template2
**to chart1.
*/

PROCEDURE ChartTemplate IS
  chart1 og_object;
  chart2 og_object;
  template1 og_template;
  template2 og_template;
BEGIN
  chart1 := og_get_object('chart1');
  chart2 := og_get_object('chart2');
  template1 := og_get_template(chart1);
  template2 := og_get_template(chart2);
  og_set_template(chart1, template2);
  og_set_template(chart2, template1);
END;


タイトル・プロパティ

  例	  関連項目

説明  チャートのタイトルです。

構文

PROCEDURE OG_Set_Title
  (chart  OG_Object,
   title  VARCHAR2);

FUNCTION OG_Get_Title
  (chart  OG_Object)
RETURN VARCHAR2;

パラメータ

chart	チャート・オブジェクトのハンドルです。
title	チャートのタイトルです。


タイトル・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads
**the title of a chart;compare
**the value with new_title.If
**they are not equal,change the
**title to new_title.
*/

PROCEDURE ChartTitle IS
  chart og_object;
  title varchar2(30);
  new_title varchar2(30) := 'New title';
BEGIN
  chart := og_get_object('chart');
  title := og_get_title(chart);
  if title != new_title then
    og_set_title(chart, new_title);
  end if;
END;


図表プロパティ

クローズ・トリガー・プロパティ

日付書式プロパティ

高さプロパティ

オープン・トリガー・プロパティ

幅プロパティ


クローズ・トリガー・プロパティ

  例	  関連項目

説明  図表のクローズ・トリガーの名前です。

構文

PROCEDURE OG_Set_Closetrigger
  (trigger  VARCHAR2);

FUNCTION OG_Get_Closetrigger
RETURN VARCHAR2;

パラメータ

trigger	図表のクローズ・トリガーの名前です。


クローズ・トリガー・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the name
**of the closetrigger of the current
**display.If the current trigger is not
**new_trigger, it sets new_trigger to be the
**current close trigger procedure.
*/

PROCEDURE CloseTrigger IS
  val varchar2(20);
  new_trigger varchar2(20) := 'CURSORDEFAULT';
BEGIN
   val := og_get_closetrigger;
   if val != new_trigger then
     og_set_closetrigger('CursorDefault');
   end if;
END;


日付書式プロパティ

  例	  関連項目

説明  パラメータの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

OG_Set_Dateformat
  (dateformat  VARCHAR2);

OG_Get_Dateformat
RETURN VARCHAR2;

パラメータ

dateformat	パラメータの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。


日付書式プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the date
**format of display.If the format is not
**the same as new_datefmt, it sets the current
**format to new_format.
*/

PROCEDURE datefmt IS
  datefmt varchar2(20);
  new_datefmt varchar2(20) := 'DD/MM/YYYY';
BEGIN
  datefmt := og_get_dateformat;
  if datefmt != new_datefmt then
    og_set_dateformat('DD/MM/YYYY');
  end if;
END;


高さプロパティ

  例	  関連項目

説明  レイアウトの高さです（レイアウト単位）。

構文

（OG_Set_Display_Sizeを参照してください）。

FUNCTION OG_Get_Display_Height
RETURN NUMBER;

パラメータ

なし


高さプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the width
**and height of thecurrent display and
**reduces the display size by half.
*/

PROCEDURE dimension0 IS
  width number;
  height number;
BEGIN
  width := og_get_display_width;
  height := og_get_display_height;
  og_set_display_size(width/2, height/2);
END;


オープン・トリガー・プロパティ

  例	  関連項目

説明  図表のオープン・トリガーの名前です。

構文

PROCEDURE OG_Set_Opentrigger
  (trigger  VARCHAR2);

FUNCTION OG_Get_Opentrigger
RETURN VARCHAR2;

パラメータ

trigger	図表のオープン・トリガーの名前です。


オープン・トリガー・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the name of
**the opentrigger of the current display.
**If the current trigger is not new_trigger,
**it sets new_trigger to be the current open
**trigger procedure.
*/

PROCEDURE OpenTrigger IS
  val varchar2(20);
  new_trigger varchar2(20) := 'TOBLUE';
BEGIN
  val := og_get_opentrigger;
  if val != 'TOBLUE' then
    og_set_opentrigger('toblue');
  end if;
END;


幅プロパティ

  例	  関連項目

説明  レイアウトの幅です（レイアウト単位）。

構文

PROCEDURE OG_Set_Display_Size
  (width   NUMBER,
   height  NUMBER);

FUNCTION OG_Get_Display_Width
RETURN NUMBER;

パラメータ

width	レイアウトの幅です（レイアウト単位）。
height	レイアウトの高さです（レイアウト単位）。


幅プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the width
**and height of thecurrent display and
**reduces the display size by half.
*/

PROCEDURE dimension0 IS
  width number;
  height number;
BEGIN
  width := og_get_display_width;
  height := og_get_display_height;
  og_set_display_size(width/2, height/2);
END;


枠（軸チャート）プロパティ

基本線の軸プロパティ

基本線の値プロパティ

項目幅プロパティ

カスタム日付書式プロパティ

カスタム数値書式プロパティ

参照線カウント・プロパティ

第2-Y軸プロパティ


基本線軸プロパティ

  例	  関連項目

説明  基本線の値が対象とする軸を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Template

OG_Y1_Axis

OG_Y2_Axis

構文

PROCEDURE OG_Set_Baseaxis
  (template  OG_Template,
   baseaxis  NUMBER);

FUNCTION OG_Get_Baseaxis
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
baseaxis	位置を求めるために基本線の値が比較される軸を指定します。


基本線軸プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

*/The following procedure specifies the
**date format for the baseline label.
*/

PROCEDURE CusDateFmt IS
  chart og_object;
  template og_template;
  custDate date;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  custDate := og_get_cust_date(template);
  if custDate != '06-DEC-88' then
    og_set_cust_date(template, '06-DEC-96');
  end if;
END;


基本線の値プロパティ

  例	  関連項目

説明  フィールドを表示する際に開始点として使用する値です。このプロパティには、次のビルトイン定数を指定できます。

OG_Custom_Baseline

OG_Min_Baseline

OG_Zero_Baseline

構文

PROCEDURE OG_Set_Basevalue
  (template   OG_Template,
   basevalue  NUMBER);

FUNCTION OG_Get_Basevalue
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
basevalue	値軸に沿ってフィールドを表示する際に開始点として使用される値です。


基本線の値プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads
**the baseline value of the field
**template of a chart.If the current
** baseline value is ZERO,
**the procedure resets the value to
**MAX; If the current baseline value
**is any value other than ZERO, the
**procedure resets the value to ZERO.
*/

PROCEDURE BaseLine IS
  chart og_object;
  template og_template;
  value number;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  value := og_get_basevalue(template);
  if value = og_zero_baseline then
    og_set_basevalue(template, og_max_baseline);
  else
    og_set_basevalue(template, og_zero_baseline);
  end if;
  og_update_chart(chart);
END;


項目幅プロパティ

  例	  関連項目

説明  これは、「ストライプ幅」の割合で示した、横棒グラフや縦棒グラフ内の棒の幅です。ストライプ幅は、棒が互いに重なることなくとれる棒の最大の幅で、項目軸の長さを、表示される棒の数で割って決定されます。

構文

PROCEDURE OG_Set_Catwidth
  (template  OG_Template,
   catwidth  NUMBER);

FUNCTION OG_Get_Catwidth
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
catwidth	これは、「ストライプ幅」の割合で示した、横棒グラフや縦棒グラフ内の棒の幅です。ストライプ幅は、棒が互いに重なることなくとれる棒の最大の幅で、項目軸の長さを、表示される棒の数で割って決定されます。


項目幅プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure reduces the
** category width of the bars by half of
**its original width.
*/

PROCEDURE CatWidth IS
  chart og_object;
  template og_template;
  width number;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  width := og_get_catwidth(template);
  og_set_catwidth(template, width/2);
END;


カスタム日付書式プロパティ

  例	  関連項目

説明  日付軸タイプの基本線の値を指定します。この値は、データを表示する際の起点として使用されます。このオプションは、OG_CUSTOM_BASELINEプロパティが選択されている場合のみ有効です。

構文

PROCEDURE OG_Set_Cust_Date
  (template   OG_Template,
   cust_date  DATE);

FUNCTION OG_Get_Cust_Date
  (template  OG_Template)
RETURN DATE;

パラメータ

template	チャート・テンプレートです。
cust_date	日付軸タイプの基本線の値を指定します。この値は、値の軸に沿ってデータ・ポイントを描画するための参照として使用されます。


カスタム日付書式プロパティの例

  アルファベット順リスト         [image]  すべての例     [image]  関連項目

/*The following procedure specifies
**the date format for the baseline label.
*/

PROCEDURE CusDateFmt IS
  chart og_object;
  template og_template;
  custDate date;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  custDate := og_get_cust_date(template);
  if custDate != '06-DEC-88' then
    og_set_cust_date(template, '06-DEC-96');
  end if;
END;


カスタム数値書式プロパティ

  例	  関連項目

説明  数値軸タイプの基本線の値を指定します。この値は、自動的にOG_CUSTOM_BASELINEに設定されます。

構文

PROCEDURE OG_Set_Cust_Num
  (template  OG_Template,
   cust_num  NUMBER);

 FUNCTION OG_Get_Cust_Num
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
cust_num	数値軸タイプの基本線の値を指定します。この値は、値の軸に沿ってデータ・ポイントを描画するための参照として使用されます。


カスタム数値書式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure specifies
**the number format for the baseline label.
*/

PROCEDURE CusNumFmt IS
  chart og_object;
  template og_template;
  num number;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  num := og_get_cust_num(template);
  og_set_cust_num(template, num/2);
END;


参照線カウント・プロパティ

  例	  関連項目

説明  チャート・テンプレートに属する参照線の数です。

構文

FUNCTION OG_Get_Reflinect
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。


参照線カウント・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the
**reference line countand prints the
**number to a text object.
*/

PROCEDURE RefLineCnt IS
  text og_object;
  chart og_object;
  template og_template;
  cnt number;
BEGIN
  text := og_get_object('text object');
  chart := og_get_object('chart');
  template := og_get_template(chart);
  cnt := og_get_reflinect(template);
  og_set_str(text, cnt);
END;


第2-Y軸プロパティ

  例	  関連項目

説明  第2-Y軸をチャート内に表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Second_Y
  (template  OG_Template,
   second_y  BOOLEAN);

FUNCTION OG_Get_Second_Y
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
second_y	第2-Y軸をチャート内に表示するかどうかを指定します。


第2-Y軸プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure determines if
**a second Y axisappears on the chart.
**If not, it adds a second one.
*/

PROCEDURE SecondY IS
  chart og_object;
  template og_template;
  axis boolean;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  axis := og_get_second_y(template);
    if axis = false then
      og_set_second_y(template, true);
   end if;
  og_update_chart(chart);
END;


枠（一般）プロパティ

深さサイズ・プロパティ

フィールド・テンプレート・カウント・プロパティ

枠タイプ・プロパティ

凡例プロパティ

凡例中の列数プロパティ

名前プロパティ

表示枠プロパティ

ルート・プロパティ

シャドウ方向プロパティ

シャドウ・サイズ・プロパティ


深さサイズ・プロパティ

  例	  関連項目

説明  チャート枠と要素を3次元で描画するときの深さのサイズを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_None_Depthsize

OG_Small_Depthsize

OG_Medium_Depthsize

OG_Large_None_Depthsize

OG_Xlarge_Depthsize

構文

PROCEDURE OG_Set_Depthsize
  (template   OG_Template,
   depthsize  NUMBER);

FUNCTION OG_Get_Depthsize
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
depthsize	チャート枠と要素を3次元表示にするために、それらが描画される深さのサイズを指定します。


深さサイズ・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

  関連項目 /*The following reads the depth size
**of the chart, and changes the depth
**to a different value.
*/

PROCEDURE FrameDepth IS
  chart og_object;
  template og_template;
  depth number;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  depth := og_get_depthsize(template);
  if depth = og_none_depthsize then
     og_set_depthsize(template, og_small_depthsize);
  elsif depth = og_small_depthsize then
     og_set_depthsize(template, og_medium_depthsize);
  elsif depth = og_medium_depthsize then
     og_set_depthsize(template, og_large_depthsize);
  elsif depth = og_large_depthsize then
     og_set_depthsize(template, og_xlarge_depthsize);
  elsif depth = og_xlarge_depthsize then
     og_set_depthsize(template, og_none_depthsize);
  end if;
END;


フィールド・テンプレート・カウント・プロパティ

  例	  関連項目

説明  チャート・テンプレートに属するフィールド・テンプレートの数です。

構文

FUNCTION OG_Get_Ftempct
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。


フィールド・テンプレート・カウント・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the number of
**the field template that belongs to the current
**template,and prints the value to a text object.
*/

PROCEDURE FTempCnt IS
  text og_object;
  chart og_object;
  template og_template;
  num number;
BEGIN
  text := og_get_object('text object');
  chart := og_get_object('chart');
  template := og_get_template(chart);
  num := og_get_ftempct(template);
  og_set_str(text, num);
 END;


枠タイプ・プロパティ

  例	  関連項目

説明  このテンプレートで表すチャートのタイプです。 このプロパティには、次のビルトイン定数を指定できます。

OG_Axis_Frametype

OG_Pie_Frametype

OG_Table_Frametype

構文

FUNCTION OG_Get_Frametype
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。


枠タイプ・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following reads the frame type
**and prints the valueto a text object.
*/

PROCEDURE FrameType IS
  text og_object;
  chart og_object;
  template og_template;
  num number;
BEGIN
  text := og_get_object('text object');
  chart := og_get_object('chart');
  template := og_get_template(chart);
  num := og_get_frametype(template);
  if num = og_axis_frametype then
    og_set_str(text, 'axis');
  elsif num = og_pie_frametype then
    og_set_str(text ,'pie');
  elsif num = og_table_frametype then
    og_set_str(text, 'table');
  end if;
END;


凡例プロパティ

  例	  関連項目

説明  チャートの凡例を表示するかどうかを指定します。（表チャートには適用されません。）

構文

PROCEDURE OG_Set_Legend
  (template

OG_Template,
   show

パラメータ

template	チャート・テンプレートです。
表示	チャートの凡例を表示するかどうかを指定します。（表チャートには適用されません。）


凡例プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure determines
**if a legend is shown.If a legend
**is shown, it hides it; if a legend
**is hidden, itshows it.
*/

PROCEDURE FrameLegend IS
  chart og_object;
  template og_template;
  val boolean;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  val := og_get_legend(template);
  if val = true then
     og_set_legend(template, false);
  else
     og_set_legend(template, true);
  end if;
END;


凡例中の列数プロパティ

  例	  関連項目

説明  凡例内にラベルを表示するために使用する列数です。

構文

PROCEDURE OG_Set_Legendcolct
  (template

OG_Template,
   colct

パラメータ

template	チャート・テンプレートです。
colct	凡例内にラベルを表示するために使用する列数です。


凡例中の列数プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the number of
**columns in the legend box.If there is more
**than one column in the box, it changes the
**number of the columns to one; if there is
**one column, it changes the number of columns
**to two.
*/

PROCEDURE FrameLegendCol IS
  chart og_object;
  template og_template;
  num number;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  num := og_get_legendcolct(template);
  if num > 1 then
     og_set_legendcolct(template, 1);
  else
     og_set_legendcolct(template, 2);
  end if;
END;


名前プロパティ

  例	  関連項目

説明  チャート・テンプレートの名前です。

構文

PROCEDURE OG_Set_Frame_Name
  (template

OG_Template,
   name

パラメータ

template	チャート・テンプレートです。
name	チャート・テンプレートの名前です。


名前プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following reads the frame name.
**If the name is not'template1', it sets
**it to 'template1'.
*/

PROCEDURE FrameName IS
  chart og_object;
  template og_template;
  name varchar2(30);
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  name := og_get_frame_name(template);
  if name != 'template1' then
    og_set_frame_name(template, 'template1');
  end if;
END;


表示枠プロパティ

  例	  関連項目

説明  チャートの周囲に四角形を表示するかどうかを指定します。（円グラフ・チャートには適用されません。）

構文

PROCEDURE OG_Set_Plotframe
  (template  OG_Template,
   show      BOOLEAN);

FUNCTION OG_Get_Plotframe
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
表示	チャートの周囲に四角形を表示するかどうかを指定します。


表示枠プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure determines
**whether a plot frame is drawn.If
**true, it removes the plot frame;
**if false, it adds a plot frame to
**the current chart.
*/

PROCEDURE FramePlot IS
  chart og_object;
  template og_template;
  val boolean;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  val := og_get_plotframe(template);
  if val = true then
     og_set_plotframe(template, false);
  else
     og_set_plotframe(template, true);
  end if;
END;


ルート・プロパティ

  例	  関連項目

説明　チャート・テンプレートのハンドル（OG_Template型）です。

構文

FUNCTION OG_Get_Root
  (template  OG_Template)
RETURN OG_Object;

パラメータ

template	チャート・テンプレートです。


ルート・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The procedure gets the handle
**(root)of the chart object.
*/

PROCEDURE FrameRoot IS
  chart og_object;
  template og_template;
  root og_object;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  root := og_get_root(template);
END;


シャドウ方向プロパティ

  例	  関連項目

説明  チャート枠と要素を描画するときのシャドウの方向を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Upperright_Shadowdir

OG_Upperleft_Shadowdir

OG_Lowerright_Shadowdir

OG_Lowerleft_Shadowdir

構文

PROCEDURE OG_Set_Shadowdir
  (template   OG_Template,
   shadowdir  NUMBER);

FUNCTION OG_Get_Shadowdir
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
shadowdir	チャート枠と要素が描画されるシャドウの方向を指定します。


シャドウ方向プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

  関連項目 */The following reads the shadow direction of
**the chart,and changes it to a different
**value.
*/

PROCEDURE FrameShadowDir IS
  chart og_object;
  template og_template;
  shadow number;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  shadow := og_get_shadowdir(template);
  if shadow = og_upperright_shadowdir then
     og_set_shadowdir(template, og_lowerleft_shadowdir);
  elsif shadow = og_lowerleft_shadowdir then
     og_set_shadowdir(template, og_upperleft_shadowdir);
  elsif shadow = og_upperleft_shadowdir then
     og_set_shadowdir(template, og_lowerright_shadowdir);
  elsif shadow = og_lowerright_shadowdir then
     og_set_shadowdir(template, og_upperright_shadowdir);
  end if;
END;


シャドウ・サイズ・プロパティ

  例	  関連項目

説明  チャート枠と要素を描画するときのシャドウのサイズを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_None_Shadowsize

OG_Small_Shadowsize

OG_Medium_Shadowsize

OG_Large_Shadowsize

OG_Xlarge_Shadowsize

構文

PROCEDURE OG_Set_Shadowsize
  (template    OG_Template,
   shadowsize  NUMBER);

FUNCTION OG_Get_Shadowsize
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
shadowsize	チャート枠と要素が描画されるシャドウのサイズを指定します。


シャドウ・サイズ・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the shadow size
**of the chart, and changes the size to a
**different value.
*/

PROCEDURE FrameShadow IS
  chart og_object;
  template og_template;
  shadow number;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  shadow := og_get_shadowsize(template);
  if shadow = og_none_shadowsize then
     og_set_shadowsize(template, og_small_shadowsize);
  elsif shadow = og_small_shadowsize then
     og_set_shadowsize(template, og_medium_shadowsize);
  elsif shadow = og_medium_shadowsize then
     og_set_shadowsize(template, og_large_shadowsize);
  elsif shadow = og_large_shadowsize then
     og_set_shadowsize(template, og_xlarge_shadowsize);
  elsif shadow = og_xlarge_shadowsize then
     og_set_shadowsize(template, og_none_shadowsize);
  end if;
END;


枠（円グラフ）プロパティ

項目ラベル・プロパティ

項目日付書式プロパティ

項目数値書式プロパティ

データ値プロパティ

オーバーラップなしプロパティ

その他プロパティ

パーセント書式プロパティ

パーセント値プロパティ

表示順序プロパティ

目盛きざみプロパティ

表示プロパティ

合計値プロパティ

値書式プロパティ


項目ラベル・プロパティ

  例	  関連項目

説明  円グラフの各円弧に、項目の名前のラベルを付けるかどうかを指定します。

構文

PROCEDURE OG_Set_Categs
  (template  OG_Template,
   categs BOOLEAN);

FUNCTION OG_Get_Categs
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
categs	円グラフの各円弧を、示されている項目の名前でラベル表示するかどうかを指定します。


項目ラベル・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure gets
**information about the relationship
**between individual pie slices and
**the complete chart.If the current
**relationship is TOTALVALUE, the
**procedure resets the relationship
** to PERCENTAGE with a value of  50;
**If the current relationship is
**PERCENTAGE, the procedure resets
**the relationship to TOTALVALUE with
**a value of 400000.
*/

PROCEDURE PieUsage IS
  pie og_object;
  template og_template;
  usage number;
  usagevalue number;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  usage := og_get_usage(template);
  if usage = og_totalvalue_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_pct_usage, 50);
   elsif usage = og_pct_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_totalvalue_usage, 400000);
  end if;
  og_update_chart(pie);
END;


項目日付書式プロパティ

  例	  関連項目

説明  項目ラベルの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Catdatefmt
  (template    OG_Template,
   catdatefmt  VARCHAR2);

FUNCTION OG_Get_Catdatefmt
  (template  OG_Template)
RETURN VARCHAR2;

パラメータ

template	チャート・テンプレートです。
catdatefmt	項目ラベルの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。


項目日付書式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure changes the
**pie slice label's date format if the
**format is not currently
**'DD-MM-YY'.
*/

PROCEDURE CatDateFmt IS
  pie og_object;
  template og_template;
  format varchar2(20);
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  format := og_get_catdatefmt(template);
  if format != 'MM-DD-YY' then
   og_set_catdatefmt(template, 'MM-DD-YY');
  end if;
  og_update_chart(pie);
END;


項目数値書式プロパティ

  例	  関連項目

説明  項目ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Catnumfmt
  (template   OG_Template,
   catnumfmt  VARCHAR2);

FUNCTION OG_Get_Catnumfmt
  (template  OG_Template)
RETURN VARCHAR2;

パラメータ

template	チャート・テンプレートです。
catnumfmt	項目ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。


項目数値書式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure changes the
**pie slice label's number format if
**the format is not currently
**'9,9,9,9'.
*/

PROCEDURE CatNumFmt IS
  pie og_object;
  template og_template;
  format varchar2(20);
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  format := og_get_catnumfmt(template);
  if format != '9,9,9,9' then
    og_set_catnumfmt(template, '9,9,9,9');
  end if;
  og_update_chart(pie);
END;


データ値プロパティ

  例	  関連項目

説明  円グラフの各円弧にそのデータ値のラベルを付けるかどうかを指定します。

構文

PROCEDURE OG_Set_Datavals
  (template  OG_Template,
   datavals  BOOLEAN);

FUNCTION OG_Get_Datavals
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
datavals	円グラフの各円弧を、そのデータ値でラベル表示するかどうかを指定します。


データ値プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure hides/shows
** the data value for each pie slice.
*/

PROCEDURE DataVals IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  val := og_get_datavals(template);
  if val = true then
   og_set_datavals(template, false);
  elsif val = false then
   og_set_datavals(template, true);
  end if;
  og_update_chart(pie);
END;


オーバーラップなしプロパティ

  例	  関連項目

説明  円グラフの各円弧のラベルが互いにオーバーラップしないように指定します。

構文

PROCEDURE OG_Set_Nooverlap
  (template   OG_Template,
   nooverlap  BOOLEAN);

FUNCTION OG_Get_Nooverlap
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
nooverlap	円グラフの各円弧のラベルが互いにオーバーラップしないように指定します。


オーバーラップなしプロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure determines if
**pie slice labels are allowed to overlap.
**If overlapping is allowed, the procedure
**disallows it.
*/

PROCEDURE NoOverlap IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  val := og_get_nooverlap(template);
  if val = false then
     og_set_nooverlap(template, true);
  end if;
  og_update_chart(pie);
END;


その他プロパティ

  例	  関連項目

説明  データ値が円グラフの中で個々の円弧として表示されるように、データ値が表すチャートの最小パーセンテージを指定します。この数値より少ないパーセンテージを表すデータ値は、円グラフの中で ｢その他｣として1つの円弧にまとめられます。

構文

PROCEDURE OG_Set_Other
  (template OG_Template,
   other NUMBER);

FUNCTION OG_Get_Other
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
other	データ値が円グラフの中で個々の円弧として表示されるように、データ値が表すチャートの最小パーセンテージを指定します。この数値より少ないパーセンテージを表すデータ値は、円グラフの中で ｢その他｣として1つの円弧にまとめられます。


その他プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure doubles
**the percentage value for which
**any chart slice with a value
**less than or equal to the
**percentage value will be labeled
**"other."
*/

PROCEDURE Other IS
  pie og_object;
  template og_template;
  num number;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  num := og_get_other(template);
  og_set_other(template, num*2);
  og_update_chart(pie);
END;


パーセント書式プロパティ

  例	  関連項目

説明  パーセント値ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Pctfmt
  (template  OG_Template,
   pctfmt    VARCHAR2);

FUNCTION OG_Get_Pctfmt
  (template  OG_Template)
RETURN VARCHAR2;

パラメータ

template	チャート・テンプレートです。
pctfmt	パーセント値ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。


パーセント書式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure hides/shows the
**percent value for each pie slice.
*/

PROCEDURE PctVals IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  val := og_get_pctvalues(template);
  if val = true then
   og_set_pctvalues(template, false);
  elsif val = false then
   og_set_pctvalues(template, true);
  end if;
  og_update_chart(pie);
END;


パーセント値プロパティ

  例	  関連項目

説明  円グラフの各円弧に、チャート全体のパーセンテージのラベルを付けるかどうかを指定します。

構文

PROCEDURE OG_Set_Pctvalues
  (template   OG_Template,
   pctvalues  BOOLEAN);

FUNCTION OG_Get_Pctvalues
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
pctvalues	円グラフの各円弧を、示されている完成したチャートの割合でラベル表示するかどうかを指定します。


パーセント値プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure hides/shows
**the percent value for each pie slice.
*/

PROCEDURE PctVals IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  val := og_get_pctvalues(template);
  if val = true then
   og_set_pctvalues(template, false);
  elsif val = false then
   og_set_pctvalues(template, true);
  end if;
  og_update_chart(pie);
END;


表示順序プロパティ

  例	  関連項目

説明  データ値が表示される方向を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Ccw_Plotorder   値が逆時計回りの方向で表示されます。

OG_Cw_Plotorder   値が時計回りの方向で表示されます。

構文

PROCEDURE OG_Set_Plotorder
  (template   OG_Template,
   plotorder  NUMBER);

FUNCTION OG_Get_Plotorder
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
plotorder	データ値が表示される方向を指定します。


表示順序プロパティの例

  アルファベット順リスト           [image]  すべての例     [image]  関連項目

/*The following procedure reads the
**direction in which the data values
**are plotted, and reverses the
**plotting direction.
*/

PROCEDURE plotOrder IS
  pie og_object;
  template og_template;
  porder number;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  porder := og_get_plotorder(template);
  if porder = og_cw_plotorder then
     og_set_plotorder(template, og_ccw_plotorder);
  else
     og_set_plotorder(template, og_cw_plotorder);
  end if;
  og_update_chart(pie);
END;


目盛きざみプロパティ

  例	  関連項目

説明  円グラフの各円弧とそのラベルを結ぶ目盛きざみを表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Ticks
  (template  OG_Template,
   ticks     BOOLEAN);

FUNCTION OG_Get_Ticks
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
ticks	円グラフの各円弧とそのラベルを結ぶ目盛きざみを表示するかどうかを指定します。


目盛きざみプロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure hides/
**shows the ticks for each pie
**slice.
*/

PROCEDURE ticks IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  val := og_get_ticks(template);
  if val = true then
   og_set_ticks(template, false);
  else
   og_set_ticks(template, true);
  end if;
  og_update_chart(pie);
END;


表示プロパティ

  例	  関連項目

説明  円グラフの各円弧とチャート全体との関係を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Totalvalue_Usage

OG_Pct_Usage

構文

PROCEDURE OG_Set_Usage
  (template  OG_Template,
   usage       NUMBER,
   usagevalue  NUMBER);

FUNCTION OG_Get_Usage
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
usage	円グラフの各円弧と完成したチャートとの関係を指定します。
usagevalue	円グラフの各円弧は、そのデータ値におけるここで指定した値に対するパーセンテージとして表示されます。（usageがOG_TOTALVALUE_USAGEに設定されている場合に限り有効です。）


表示プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure gets
**information about the relationship
**between individual pie slices and
**the complete chart.If the current
**relationship is TOTALVALUE, the procedure
**resets the relationship to PERCENTAGE
**with a value of  50.If the current
**relationship is PERCENTAGE, the procedure
**resets the relationship to TOTALVALUE
**with a value of 400000.
*/

PROCEDURE PieUsage IS
  pie og_object;
  template og_template;
  usage number;
  usagevalue number;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  usage := og_get_usage(template);
  if usage = og_totalvalue_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_pct_usage, 50);
   elsif usage = og_pct_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_totalvalue_usage, 400000);
  end if;
  og_update_chart(pie);
END;


合計値プロパティ

  例	  関連項目

説明  円グラフの各円弧は、そのデータ値におけるここで指定した値に対するパーセンテージとして表示されます。

構文

（前述のOG_Set_Usageを参照してください。）

FUNCTION OG_Get_Usagevalue
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。


合計値プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure gets
**information about the relationship
**between individual pie slices and
**the complete chart.If the current
**relationship is TOTALVALUE, the procedure
**resets the relationship to PERCENTAGE
**with a value of  50.If the current
**relationship is PERCENTAGE, the procedure
**resets the relationship to TOTALVALUE
**with a value of 400000.
*/

PROCEDURE PieUsage IS
  pie og_object;
  template og_template;
  usage number;
  usagevalue number;
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  usage := og_get_usage(template);
  if usage = og_totalvalue_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_pct_usage, 50);
   elsif usage = og_pct_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_totalvalue_usage, 400000);
  end if;
  og_update_chart(pie);
END;


値書式プロパティ

  例	  関連項目

説明  データ値ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Valuefmt
  (template     OG_Template,
   valuenumfmt  VARCHAR2);

FUNCTION OG_Get_Valuefmt
  (template  OG_Template)
RETURN VARCHAR2;e

パラメータ

template	チャート・テンプレートです。
valuenumfmt	データ値ラベルの数値書式を指定します。


値書式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure changes the pie
**slice label's value format if the format
**is not currently '0999'.
*/

PROCEDURE ValFmt IS
  pie og_object;
  template og_template;
  format varchar2(20);
BEGIN
  pie := og_get_object('pie');
  template := og_get_template(pie);
  format := og_get_valuefmt(template);
  if format != '0999' then
    og_set_valuefmt(template, '0999');
  end if;
  og_update_chart(pie);
END;


枠（表チャート）プロパティ

自動最大値プロパティ

自動最小値プロパティ

列名プロパティ

格子カウント・プロパティ

水平格子プロパティ

最大行数プロパティ

最小行数プロパティ

垂直格子プロパティ


自動最大値プロパティ

  例	  関連項目

説明  チャートに表示される最大行数を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Automax
  (template  OG_Template,
   automax   BOOLEAN,
   maxrows   NUMBER);

FUNCTION OG_Get_Automax
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
automax	チャートに表示される最大行数を「自動」に設定するかどうかを指定します。
maxrows	チャートに表示される最大行数を指定します（ただし、automaxがFALSEの場合のみ）。


自動最大値プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure determines if
**there is a maximum number of rows to
**be displayed in the table or if the
**number of rows is automatically
**determined.If the number of
**rows is not automatically determined,
**the procedure reads the number of rows
**the table displays currently and resets
**it to be automatically determined.
*/

PROCEDURE AutoMax IS
  table1 og_object;
  template og_template;
  val boolean;
  maxrows number := 2;
BEGIN
  table1 := og_get_object('table');
  template := og_get_template(table1);
  val := og_get_automax(template);
  if val = false then
     minrows := og_get_maxrows(template);
     og_set_automax(template, false, maxrows/2);
  end if;
  og_update_chart(table1);
END;


自動最小値プロパティ

  例	  関連項目

説明  チャートに表示される最小行数を「自動」に設定するかどうかを指定します。

構文

PROCEDURE OG_Set_Automin
  (template  OG_Template,
   automin   BOOLEAN,
   minrows   NUMBER);

FUNCTION OG_Get_Automin
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
automin	チャートに表示される最小行数を「自動」に設定するかどうかを指定します。
minrows	チャートに表示される最小行数を指定します（ただし、autominがFALSEの場合のみ）。


自動最小値プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*"The following procedure
**determines if there is a
**minimum number of rows that
**must be displayed in the
**table or whether the number of
**rows is automatically determined.
**If the number of rows is not
**automatically determined, the procedure
**reads the number of rows the table
**currently displays and resets it to
**be automatically determined.
 */

PROCEDURE AutoMax IS
  table1 og_object;
  template og_template;
  val boolean;
  minrows number := 2;
BEGIN
  table1 := og_get_object('table');
  template := og_get_template(table1);
  val := og_get_automin(template);
  if val = false then
     minrows := og_get_minrows(template);
     og_set_automin(template, false, minrows/2);
  end if;
  og_update_chart(table1);
END;


列名プロパティ

  例	  関連項目

説明  列の名前をチャート内の最初の行として表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Cname
  (template  OG_Template,
   cname     BOOLEAN);

FUNCTION OG_Get_Cname
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
cname	列の名前をチャート内の最初の行として表示するかどうかを指定します。


列名プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure hides/shows the
**table's column names.
*/

PROCEDURE ColNames IS
  table1 og_object;
  template og_template;
  val boolean;
BEGIN
  table1 := og_get_object('table');
  template := og_get_template(table1);
  val := og_get_cname(template);
  if val = true then
    og_set_cname(template, false);
  elsif val = false then
    og_set_cname(template, true);
  end if;
  og_update_chart(table1);
END;


格子カウント・プロパティ

  例	  関連項目

説明  各水平格子間で表示されるデータの行数です（ただし、「水平格子」をTRUEに設定した場合のみ）。

構文

PROCEDURE OG_Set_Gridct
  (template  OG_Template,
   gridct    NUMBER);

FUNCTION OG_Get_Gridct
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。
gridct	各水平格子間で表示されるデータの行数です（ただし、「水平格子」をTRUEに設定した場合のみ）。


格子カウント・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure doubles
**the grid count of thetable.
*/

PROCEDURE gridcnt IS
  table1 og_object;
  template og_template;
  cnt number;
BEGIN
  table1 := og_get_object('table');
  template := og_get_template(table1);
  cnt := og_get_gridct(template);
  og_set_gridct(template, cnt*2);
  og_update_chart(table1);
END;


水平格子プロパティ

  例	  関連項目

説明  行と行の間に水平格子を表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Hgrid
  (template  OG_Template,
   hgrid     BOOLEAN);

FUNCTION OG_Get_Hgrid
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
hgrid	行と行の間に水平グリッドを表示するかどうかを指定します。


水平格子プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure hides/shows
**horizontal gridlines.
*/

PROCEDURE HoriGrid IS
  table1 og_object;
  template og_template;
  val boolean;
BEGIN
  table1 := og_get_object('table');
  template := og_get_template(table1);
  val := og_get_hgrid(template);
  if val = true then
     og_set_hgrid(template, false);
  elsif val = false then
     og_set_hgrid(template, true);
  end if;
  og_update_chart(table1);
END;


最大行数プロパティ

  例	  関連項目

説明  チャートに表示する最大行数を指定します（「自動最大値」がFALSEの場合のみ）。

構文

（前述のOG_Set_Automaxを参照してください。）

FUNCTION OG_Get_Maxrows
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。


最大行数プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure determines
**if there is a maximum number of rows to
**be displayed in the table or if the
**number of rows is automatically
**determined.If the number ofrows is
**automatically determined, the procedure
**reads the number of rows the table
**displays currently and resets it to be
**automatically determined.
*/

PROCEDURE AutoMax IS
  table1 og_object;
  template og_template;
  val boolean;
  maxrows number := 2;
BEGIN
  table1 := og_get_object('table');
  template := og_get_template(table1);
  val := og_get_automax(template);
  if val = false then
     maxrows := og_get_maxrows(template);
     og_set_automax(template, false, maxrows/2);
  end if;
  og_update_chart(table1);
END;


最小行数プロパティ

  例	  関連項目

説明  チャートに表示する最小行数を指定します（「自動最小値」がFALSEの場合のみ）。

構文

（前述のOG_Set_Autominを参照してください。

FUNCTION OG_Get_Minrows
  (template  OG_Template)
RETURN NUMBER;

パラメータ

template	チャート・テンプレートです。


最小行数プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*"The following procedure
**determines if there is a
**minimum number of rows that
**must be displayed in the
**table or whether the number of
**rows is automatically determined.
**If the number of rows is not
**automatically determined, the procedure
**reads the number of rows the table
**currently displays and resets it to
**be automatically determined.
 */

PROCEDURE AutoMax IS
  table1 og_object;
  template og_template;
  val boolean;
  minrows number := 2;
BEGIN
  table1 := og_get_object('table');
  template := og_get_template(table1);
  val := og_get_automin(template);
  if val = false then
     minrows := og_get_minrows(template);
     og_set_automin(template, false, minrows/2);
  end if;
  og_update_chart(table1);
END;


垂直格子プロパティ

  例	  関連項目

説明  列と列の間に垂直格子を表示するかどうかを指定します。

構文

PROCEDURE OG_Set_Vgrid
  (template  OG_Template,
   vgrid     BOOLEAN);

FUNCTION OG_Get_Vgrid
  (template  OG_Template)
RETURN BOOLEAN;

パラメータ

template	チャート・テンプレートです。
vgrid	列と列の間に垂直グリッドを表示するかどうかを指定します。


垂直格子プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure hides/shows
**vertical gridlines.
*/

PROCEDURE VertGrid IS

table1 og_object;

template og_template;

val boolean;

BEGIN

table1 := og_get_object('table');

template := og_get_template(table1);

val := og_get_vgrid(template);

if val = true then

og_set_vgrid(template, false);

elsif val = false then

og_set_vgrid(template, true);

end if;

og_update_chart(table1);

END.


フィールド・テンプレート（一般）プロパティ

カラー回転プロパティ

日付書式プロパティ

名前プロパティ

数値書式プロパティ

ルート・プロパティ


カラー回転プロパティ

  例	  関連項目

説明  Graphics Builderによって、カラー・パレットやパターン・パレットを自動的に選択させ、このフィールド・テンプレートを使用する各フィールドに他と重複しないようにパレットを割り当てるかどうかを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_None_Colorrot

OG_Auto_Colorrot

OG_Color_Colorrot

OG_Pattern_Colorrot

OG_Both_Colorrot

構文

PROCEDURE OG_Set_Colorrot
  (ftemp     OG_Ftemp,
   colorrot  NUMBER);

FUNCTION OG_Get_Colorrot
  (ftemp  OG_Ftemp)
RETURN NUMBER;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
colorrot	Graphics Builderがカラー・パレットやパターン・パレットを自動的に回転させて、このフィールド・テンプレートを使用する各フィールドに固有のパレット設定を選択するかどうかを指定します。


カラー回転プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads if any
**color rotation is applied to the chart.
**If none has been applied, it applies
**AUTO color rotation.If another method
**of color rotation is currently applied,
**it changes the rotation to NONE.
*/

PROCEDURE fieldColRot IS
  ftemp og_ftemp;
  color number;
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('chart')),0);
  color := og_get_colorrot(ftemp);
  if color = og_none_colorrot then
     og_set_colorrot(ftemp, og_auto_colorrot);
  else
     og_set_colorrot(ftemp, og_none_colorrot);
 end if;
     og_update_chart(og_get_object('chart'));
END;


日付書式プロパティ

  例	  関連項目

説明  フィールド・ラベルの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Datefmt
  (ftemp     OG_Ftemp,
   date_fmt  VARCHAR2);

FUNCTION OG_Get_Datefmt
  (ftemp  OG_Ftemp)
RETURN VARCHAR2;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
date_fmt	フィールド・ラベルの日付書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。


日付書式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

 */The following procedure
**determines if label number
**formats are all'9,9,9,9'.
**If not, it changes them all
**to '9,9,9,9'.
*/

PROCEDURE fieldDateFmt IS
  ftemp og_ftemp;
  datefmt varchar2(20);
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('chart')),0);
  datefmt := og_get_datefmt(ftemp);
  if datefmt != 'DD-MM-YYYY' then
    og_set_datefmt(ftemp, 'DD-MM-YYYY');
  end if;
END;


名前プロパティ

  例	  関連項目

説明  フィールド・テンプレートの名前です。

構文

PROCEDURE OG_Set_Ftemp_Name
  (ftemp  OG_Ftemp,
   name   VARCHAR2);

FUNCTION OG_Get_Ftemp_Name
  (ftemp  OG_Ftemp)
RETURN VARCHAR2;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
name	フィールド・テンプレートの名前です。


名前プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure
**appends a '1' tothe current
**field template's name.
*/

PROCEDURE fieldname IS
  ftemp og_ftemp;
  chart og_object;
  name varchar2(20);
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('chart')),0);
  name := og_get_ftemp_name(ftemp);
  og_set_ftemp_name(ftemp, name||'1');
END;


数値書式プロパティ

  例	  関連項目

説明  フィールド・ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

PROCEDURE OG_Set_Numfmt
  (ftemp    OG_Ftemp,
   num_fmt  VARCHAR2);

FUNCTION OG_Get_Numfmt
  (ftemp  OG_Ftemp)
RETURN VARCHAR2;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
num_fmt	フィールド・ラベルの数値書式を指定します。これは有効なSQLフォーマット文字列で指定する必要があります。


数値書式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

*/The following procedure
**determines if the labels'number
**format is '9,9,9,9'.If
**not, it changes the format
**to '9,9,9,9'.
*/

PROCEDURE fieldNumFmt IS
  ftemp og_ftemp;
  numfmt varchar2(20);
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('chart')),0);
  numfmt := og_get_numfmt(ftemp);
  if numfmt != '9,9,9,9' then
    og_set_numfmt(ftemp, '9,9,9,9');
  end if;
END;


ルート・プロパティ

  例	  関連項目

説明  フィールド・テンプレートが属するチャート・テンプレートのハンドルです。

構文

FUNCTION OG_Get_Root
  (ftemp  OG_Ftemp)
RETURN OG_Object;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。


ルート・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure gets
**a chart's field template handles.
*/

PROCEDURE fieldname IS
  ftemp og_ftemp;
  root og_object;
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('chart')),0);
  root := og_get_root(ftemp);
END;


フィールド・テンプレート（軸チャート）プロパティ

軸プロパティ

カーブ調整プロパティ

ラベル回転プロパティ

線の形式プロパティ

オーバーラップ・プロパティ

表示位置プロパティ

表示形式プロパティ


軸プロパティ

  例	  関連項目

説明  フィールドの値が対象とする軸を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Y1_Axis

OG_Y2_Axis

構文

PROCEDURE OG_Set_Axis
  (ftemp  OG_Ftemp,
   axis   NUMBER);

FUNCTION OG_Get_Axis
  (ftemp  OG_Ftemp)
RETURN NUMBER;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
axis	フィールドの表示方法を決定するのに必要なデータ値が比較される軸を指定します。


軸プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure
**rotates the main Y axis the
**chart currently refers to
**(if there is more than one
**Y axis)and switches the main
**Y axis to a different Y axis.
*/

PROCEDURE axis IS
  axis number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('chart');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  axis := og_get_axis(ftemp);
  if axis = og_y1_axis then
     og_set_axis(ftemp, og_y2_axis);
  elsif axis = og_y2_axis then
     og_set_axis(ftemp, og_y1_axis);
  end if;
  og_update_chart(chart);
END;


カーブ調整プロパティ

  例	  関連項目

説明  カーブ調整をチャートに適用するかどうか、また適用する場合にはどのアルゴリズムを使用するかを指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_No_Curvefit

OG_Linear_Curvefit

OG_LOG_Curvefit

OG_Exp_Curvefit

OG_Power_Curvefit

構文

PROCEDURE OG_Set_Curvefit
  (ftemp     OG_Ftemp,
   curvefit  NUMBER);

FUNCTION OG_Get_Curvefit
  (ftemp  OG_Ftemp)
RETURN NUMBER;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
curvefit	カーブ調整をチャートに適用するかどうか、また適用する場合にはどのアルゴリズムを使用するかを指定します。


カーブ調整プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure determines
**if a curve fit isapplied to the chart.
**If not, it applies a Linear CurveFit
**to the chart.If a curve fit is currently
**applied to thechart, it removes it.
*/

PROCEDURE CurveFit IS
  curve number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('chart');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  curve := og_get_curvefit(ftemp);
  if curve = og_no_curvefit then
    og_set_curvefit(ftemp,og_linear_curvefit);
  else
    og_set_curvefit(ftemp,og_no_curvefit);
  end if;
  og_update_chart(chart);
END;


ラベル回転プロパティ

  例	  関連項目

説明  ラベル表示形式を含む各フィールドのラベルの回転角度を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Ccw_Rotation   逆時計回りに回転します。

OG_Cw_Rotation   時計回りに回転します。

OG_No_Rotation

構文

PROCEDURE OG_Set_Labelrot
  (ftemp    OG_Ftemp,
   linesty  NUMBER);

FUNCTION OG_Get_Labelrot
  (ftemp  OG_Ftemp)
RETURN NUMBER;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
linesty	ラベル表示形式を含む各フィールドのラベルの回転角度を指定します。


ラベル回転プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure rotates a
**chart's rotation labels.
*/

PROCEDURE lblrot IS
  rot number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('chart');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  rot := og_get_labelrot(ftemp);
  if rot = og_no_rotation then
    og_set_labelrot(ftemp,og_cw_rotation);
  elsif rot = og_cw_rotation then
    og_set_labelrot(ftemp, og_ccw_rotation);
  elsif rot = og_ccw_rotation then
    og_set_labelrot(ftemp, og_no_rotation);
  end if;
  og_update_chart(chart);
END;


線の形式プロパティ

  例	  関連項目

説明  線表示形式を含むフィールドのデータ・ポイント間を結ぶために使用する線の形式を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Spline_Linestyle

OG_Step_Linestyle

OG_Straight_Linestyle

構文

PROCEDURE OG_Set_Linesty
  (ftemp    OG_Ftemp,
   linesty  NUMBER);

FUNCTION OG_Get_Linesty
  (ftemp  OG_Ftemp)
RETURN NUMBER;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
linesty	線表示形式を含む各フィールドのデータ・ポイント間を結ぶために使用する線の形式を指定します。


線の形式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure rotates
**the line style of a chart.
*/

PROCEDURE linesty IS
  style number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('chart');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  style := og_get_linesty(ftemp);
  if style = og_spline_linestyle then
     og_set_linesty(ftemp, og_step_linestyle);
  elsif style = og_step_linestyle then
     og_set_linesty(ftemp, og_straight_linestyle);
  elsif style = og_straight_linestyle then
     og_set_linesty(ftemp, og_spline_linestyle);
  end if;
  og_update_chart(chart);
END;


オーバーラップ・プロパティ

  例	  関連項目

説明  複数のフィールドからのデータ値を横棒グラフや縦棒グラフで表示する棒どうしがそれぞれオーバーラップする割合をパーセンテージを指定します。

構文

PROCEDURE OG_Set_Overlap
  (ftemp    OG_Ftemp,
   overlap  NUMBER);

FUNCTION OG_Get_Overlap
  (ftemp  OG_Ftemp)
RETURN NUMBER;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
overlap	複数のフィールドからのデータ値を横棒チャートや縦棒チャートで表示する棒どうしがそれぞれオーバーラップする割合をパーセントで指定します。


オーバーラップ・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads
**the overlap percentage that has
**been specified.If the specified
**percentage is between 0 to 50,
**it redraws the column using
**90% overlap,if the percentage is
**over 90%,it redraws the columns
**with 0% overlap.
*/

PROCEDURE overlap IS
  percent number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('chart');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  percent := og_get_overlap(ftemp);
  if percent between 0 and 50 then
     og_set_overlap(ftemp, 90);
  else
     og_set_overlap(ftemp, 0);
  end if;
END;


表示位置プロパティ

  例	  関連項目

説明  各項目において2つ以上のフィールドのデータ値間の関係を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Normal_Plotpos

OG_Fromprev_Plotpos

OG_Stacked_Plotpos

構文

PROCEDURE OG_Set_Plotpos
  (ftemp    OG_Ftemp,
   plotpos  NUMBER);

FUNCTION OG_Get_Plotpos
  (ftemp  OG_Ftemp)
RETURN NUMBER;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
plotpos	各項目において2つ以上のフィールドのデータ値間の関係を指定します。


使用部分位置プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure rotates
**the plot position of columns in a chart.
*/

PROCEDURE plotpos IS
  pos number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('chart');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  pos := og_get_plotpos(ftemp);
   if pos = og_normal_plotpos then
     og_set_plotpos(ftemp,og_fromprev_plotpos);
   elsif pos = og_fromprev_plotpos then
     og_set_plotpos(ftemp, og_stacked_plotpos);
   elsif pos = og_stacked_plotpos then
     og_set_plotpos(ftemp, og_normal_plotpos);
   end if;
  og_update_chart(chart);
END;


表示形式プロパティ

  例	  関連項目

説明  このフィールドをチャートに表示するために使用する要素を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_None_Plottype

OG_Bar_Plottype

OG_Line_Plottype

OG_Symbol_Plottype

OG_Fill_Plottype

OG_Spike_Plottype

OG_Label_Plottype

構文

PROCEDURE OG_Set_Plottype
  (ftemp     OG_Ftemp,
   plottype  NUMBER);

FUNCTION OG_Get_Plottype
  (ftemp  OG_Ftemp)
RETURN NUMBER;

パラメータ

ftemp	フィールド・テンプレートのハンドルです。
plottype	このフィールドをチャート上に表示するために使用する要素を指定します。


表示形式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*On a mouse click, the following
**procedure rotates the plot type
**of a chart.
*/

PROCEDURE Plottype (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
chart og_object;
template og_template;
ftemp og_ftemp;
num number;
BEGIN
chart := og_get_object('chart');
template := og_get_template(chart);
ftemp := og_get_ftemp(template, 0);
num := og_get_plottype(ftemp);
if num = og_none_plottype then
   og_set_plottype(ftemp, og_bar_plottype);
elsif num = og_bar_plottype then
   og_set_plottype(ftemp, og_line_plottype);
elsif num = og_line_plottype then
   og_set_plottype(ftemp, og_symbol_plottype);
elsif num = og_symbol_plottype then
   og_set_plottype(ftemp, og_fill_plottype);
elsif num = og_fill_plottype then
   og_set_plottype(ftemp, og_spike_plottype);
elsif num = og_spike_plottype then
   og_set_plottype(ftemp, og_label_plottype);
elsif num = og_label_plottype then
   og_set_plottype(ftemp, og_none_plottype);
end if;
og_update_chart(chart);
END;


一般プロパティ

ボタン・プロシージャ・プロパティ

列・プロパティ

イベント・プロパティ

問合せ実行プロパティ

フォーマット・トリガー・プロパティ

オブジェクトを隠すプロパティ

内側枠ボックス・プロパティ

名前プロパティ

オブジェクト・タイプ・プロパティ

外側枠ボックス・プロパティ

親プロパティ

パラメータ設定プロパティ


ボタン・プロシージャ・プロパティ

  例	  関連項目

説明  ボタン・プロシージャをオブジェクトと対応付けるハンドルです。このプロシージャが必要なマウス・イベントを確実に受け取るために、イベント・プロパティも適切に設定する必要があることに注意してください。

構文

PROCEDURE OG_Set_Button
  (object          OG_Object,
   buttonproc      OG_Buttonproc,
   damage          BOOLEAN        :=  TRUE,
   update_bbox     BOOLEAN        :=  TRUE);

FUNCTION OG_Get_Button
  (object  OG_Object)
RETURN OG_Buttonproc;

パラメータ

object	定義中のオブジェクト。
buttonproc	オブジェクトと対応付けるボタン・プロシージャのハンドル。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


ボタン・プロシージャ・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the button
**procedure from a rectangle object, and adds
**the same procedure to a circle object.
*/

PROCEDURE transfer (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  rect og_object;
  circle og_object;
  proc og_buttonproc;
BEGIN
  rect := og_get_object('rect');
  circle := og_get_object('circle');
  proc := og_get_button(rect);
  og_set_button(circle, proc);
END;


列プロパティ

  例	  関連項目

説明  オブジェクトを選択したときに、パラメータに設定される列値です。このプロパティは、チャート要素のみに適用されます。

構文

PROCEDURE OG_Set_Keycol
  (object  OG_Object,
   keycol  VARCHAR2);

FUNCTION OG_Get_Keycol
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
keycol	オブジェクトを選択した時にパラメータに設定される列値。


列プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads
**the column value of a parameter
**and assigns a different value to it
*/

PROCEDURE GenColumn IS
  rect og_object;
  param varchar2(20);
BEGIN
  rect := og_get_object('rect');
  param := og_get_keycol(rect);
  og_set_keycol(rect, 'init');
END;


イベント・プロパティ

  例	  関連項目

説明  ボタン・プロパティが指定したプロシージャが受け取るマウス・イベントのタイプです。このプロパティには、下記のビルトイン定数を指定できます。プロシージャで複数のイベント・タイプを受け取ることができるようにするには、このプロパティを該当のイベントの定数の合計に設定します。OG_Mouse_Move_UpとOG_Mouse_Move_Downは、図表レイヤーに対してのみ使用されることに注意してください。

OG_No_Events

OG_Mouse_Down

OG_Mouse_Up

OG_Mouse_Move_Down

構文

PROCEDURE OG_Set_Events
  (object       OG_Object,
   events       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Events
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。
events	ボタン・プロパティで指定したプロシージャによって受け取られるマウス・イベントのタイプ。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


イベント・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads
**the current mouse event in an object,
**and assigns a different event to it.
*/

PROCEDURE Events IS
  rect og_object;
  events number;
BEGIN
  rect := og_get_object('rect');
  events := og_get_events(rect);
  if events = og_no_events then
     og_set_events(rect, og_mouse_down);
  elsif events = og_mouse_down then
     og_set_events(rect, og_mouse_up);
  elsif events = og_mouse_up then
     og_set_events(rect, og_mouse_move_down);
  elsif events = og_mouse_move_down then
     og_set_events(rect, og_no_events);
  end if;
END;


問合せ実行プロパティ

  例	  関連項目

説明  オブジェクトを選択したときに、実行する問合せを指定します。

構文

PROCEDURE OG_Set_Execquery
  (object     OG_Object,
   execquery  OG_Query);

FUNCTION OG_Get_Execquery
  (object  OG_Object)
RETURN OG_Query;

パラメータ

object	定義中のオブジェクト。
execquery	オブジェクトを選択したときに実行される問合せを指定します。


問合せ実行プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the specified
**query of the object, and assigns a different
**query to it.
*/

PROCEDURE GenQuery IS
  rect og_object;
  query og_query;
  query1 og_query;
BEGIN
  rect := og_get_object('rect');
  query := og_get_execquery(rect);
  query1 := og_get_query('query1');
  og_set_execquery(rect, query1);
END;


フォーマット・トリガー・プロパティ

  例	  関連項目

説明  オブジェクトのフォーマット・トリガーです。このプロパティは、チャート要素だけに適用されます。

構文

PROCEDURE OG_Set_Fmttrig
  (object   OG_Object,
   fmttrig  VARCHAR2);

FUNCTION OG_Get_Fmttrig
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
fmttrig	オブジェクトのフォーマット・トリガーです。このプロパティは、チャート要素だけに適用されます。


フォーマット・トリガー・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the specified
**format trigger from an object, and assigns a
**different format trigger to it.
*/

*/PROCEDURE GenFmtTrigger IS
  rect og_object;
  fmttrig varchar2(20);
BEGIN
  rect := og_get_object('rect');
  fmttrig := og_get_fmttrig(rect);
  og_set_fmttrig(rect, 'fmttrig1');
END;


オブジェクトを隠すプロパティ

  例	  関連項目

説明  オブジェクトを隠します。

構文

PROCEDURE OG_Set_Hide
  (object  OG_Object)
   hide BOOLEAN);

FUNCTION OG_Get_Hide
  (object  OG_Object)
RETURN BOOLEAN;

パラメータ

object	定義中のオブジェクト。
hide	オブジェクトを隠す。


オブジェクトを隠すプロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button
**procedure hides or
**shows an object as it
**is selected.
*/

PROCEDURE OGBUTTONPROC0 (buttonobj IN og_object,

hitobj IN og_object,

win IN og_window,

eventinfo IN og_event) IS

val boolean;

BEGIN

val := og_get_hide(hitobj);

if val then

og_set_hide(hitobj, false);

og_set_bfcolor(hitobj, 'red');

else

og_set_hide(hitobj, true);

og_set_bfcolor(hitobj, 'red');

end if;

END;


内側枠ボックス・プロパティ

  例	  関連項目

説明  オブジェクトの内側枠ボックスです。これは、枠の太さや他のプロパティ設定とは無関係に、オブジェクトの形を構成する（つまり、オブジェクトの4つの制御ポイントを接続する）四角形です。

構文

FUNCTION OG_Get_Ibbox
  (object  OG_Object)
RETURN OG_Rectangle;

パラメータ

object	定義中のオブジェクト。


内側枠ボックス・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following reads the dimensions
**of the inner bounding and outer
**bounding boxes and calculates
**the size of the actual bounding box.
*/

PROCEDURE GenIOBox IS
  obj og_object;
  ibox og_rectangle;
  obox og_rectangle;
  num number;
BEGIN
  obj := og_get_object('rect');
  ibox := og_get_ibbox(obj);
  obox := og_get_obbox(obj);
  num := (obox.height * obox.width)-(ibox.height*ibox.width);
END;


名前プロパティ

  例	  関連項目

説明  オブジェクト名です。

構文

PROCEDURE OG_Set_Name
  (object       OG_Object,
   name         VARCHAR2
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Name
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
name	オブジェクト名。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


名前プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads
**the name of the object and assigns
**another name to it.
*/

PROCEDURE GenName IS
  obj og_object;
  name varchar2(20);
BEGIN
  obj := og_get_object('circle');
  name := og_get_name(obj);
  og_set_name(obj, 'teresa');
END;


オブジェクト・タイプ・プロパティ

  例	  関連項目

説明  オブジェクト・タイプです。このプロパティには、次のビルトイン定数を指定できます。

OG_Arc_Objtype

OG_Chart_Objtype

OG_Group_Objtype

OG_Image_Objtype

OG_Line_Objtype

OG_Poly_Objtype

OG_Rect_Objtype

OG_Rrect_Objtype

OG_Symbol_Objtype

OG_Text_Objtype

構文

FUNCTION OG_Get_Objtype
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。


オブジェクト・タイプ・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure checks
**the type of object being selected on by
**the mouse, and prints the type name to
**a text object.
*/

PROCEDURE GenObjType2 (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  text og_object;
  objtype number;

BEGIN
  text := og_get_object('text object');
  objtype := og_get_objtype(hitobj);
  if objtype = og_arc_objtype then
     og_set_str(text, 'arc');
  elsif objtype = og_chart_objtype then
     og_set_str(text, 'chart');
  elsif objtype = og_group_objtype then
     og_set_str(text, 'group');
  elsif objtype = og_image_objtype then
     og_set_str(text, 'image');
  elsif objtype = og_line_objtype then
     og_set_str(text, 'line');
  elsif objtype = og_poly_objtype then
     og_set_str(text, 'poly');
  elsif objtype = og_rect_objtype then
     og_set_str(text, 'rect');
  elsif objtype = og_rrect_objtype then
     og_set_str(text, 'rrect');
  elsif objtype = og_symbol_objtype then
     og_set_str(text, 'symbol');
  elsif objtype = og_text_objtype then
     og_set_str(text, 'text');
  end if;

END;


外側枠ボックス・プロパティ

  例	  関連項目

説明  オブジェクトの外側枠ボックスです。これは、オブジェクトを完全に囲める最小サイズの四角形です。外側枠ボックスは、オブジェクトの枠が太い場合には内側枠ボックスと異なる場合があります。内側枠ボックスではオブジェクトの本来あるべき形を辿っているのに対し、外側枠ボックスではオブジェクト全体を囲みます。

構文

FUNCTION OG_Get_Obbox
  (object  OG_Object)
RETURN OG_Rectangle;

パラメータ

object	定義中のオブジェクト。


外側枠ボックス・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following reads the dimensions of the
**inner bounding and outer bounding boxes and
**calculates the size of the actual bounding box.
*/

PROCEDURE GenIOBox IS
  obj og_object;
  ibox og_rectangle;
  obox og_rectangle;
  num number;
BEGIN
  obj := og_get_object('rect');
  ibox := og_get_ibbox(obj);
  obox := og_get_obbox(obj);
  num := (obox.height * obox.width)-(ibox.height*ibox.width);
END;


親プロパティ

  例	  関連項目

説明  オブジェクトの親オブジェクトに対するハンドルです。

構文

FUNCTION OG_Get_Parent
  (object  OG_Object)
RETURN OG_Object;

パラメータ

object	定義中のオブジェクト。


親プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure gets the
**parent of the current object, and
**prints the name of the parent object
**to a text object.
*/

PROCEDURE GenParent IS
  text og_object;
  obj og_object;
  parent og_object;
  name varchar2(20);
BEGIN
text := og_get_object('text object');
  obj := og_get_object('circle');
  parent := og_get_parent(obj);
  name := og_get_name(parent);
  og_set_str(text, name);
END;


パラメータ設定プロパティ

  例	  関連項目

説明  オブジェクトを選択したときに、値が設定されるパラメータです。

構文

PROCEDURE OG_Set_Setparam
  (object   OG_Object,
  setparam  VARCHAR2);

FUNCTION OG_Get_Setparam
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
setparam	オブジェクトを選択すると値が設定されるパラメータです。


パラメータ設定プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the
**parameter of a rectangle object, and
**assigns a new parameter to it.
*/

PROCEDURE SetParam IS
  rect og_object;
  param varchar2(20);
BEGIN
  rect := og_get_object('rect');
  param := og_get_setparam(rect);
  og_set_setparam(rect, 'PARAM1');
END;


図形プロパティ

バックグラウンド線カラー・プロパティ

バックグラウンド塗りカラー・プロパティ

凹凸スタイル・プロパティ

端形式プロパティ

線種スタイル・プロパティ

枠パターン・プロパティ

枠幅プロパティ

塗りパターン・プロパティ

フォアグラウンド線カラー・プロパティ

フォアグラウンド塗りカラー・プロパティ

結合形式プロパティ

回転角度プロパティ

転送モード・プロパティ


バックグラウンド線カラー・プロパティ

  例	  関連項目

説明  オブジェクトのバックグラウンド線カラーです。

構文

PROCEDURE OG_Set_Becolor
  (object       OG_Object,
   becolor      VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Becolor
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
becolor	オブジェクトのバックグラウンド線カラー。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


バックグラウンド線カラー・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* /*The following procedure swaps the foreground
**and background edge colors.
*/

PROCEDURE FBEdgeColor IS
  obj og_object;
  fcolor varchar2(20);
  bcolor varchar2(20);
BEGIN
  obj := og_get_object('rect');
  fcolor := og_get_fecolor(obj);
  bcolor := og_get_becolor(obj);
  og_set_fecolor(obj, bcolor);
  og_set_becolor(obj, fcolor);
END;


バックグラウンド塗りカラー・プロパティ

  例	  関連項目

説明  オブジェクトのバックグラウンド塗りカラーです。

構文

PROCEDURE OG_Set_Bfcolor
  (object       OG_Object,
   bfcolor      VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Bfcolor
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
bfcolor	オブジェクトのバックグラウンド塗りカラー。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


バックグラウンド塗りカラー・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure swaps the foreground
**and background fill colors.
*/

PROCEDURE FBFillColor IS
  obj og_object;
  fcolor varchar2(20);
  bcolor varchar2(20);
BEGIN
  obj := og_get_object('rect');
  fcolor := og_get_ffcolor(obj);
  bcolor := og_get_bfcolor(obj);
  og_set_ffcolor(obj, bcolor);
  og_set_bfcolor(obj, fcolor);
END;


凹凸スタイル・プロパティ

  例	  関連項目

説明  オブジェクトの凹凸スタイルです。このプロパティには、次のビルトイン定数を指定できます。

OG_Inset_Bstyle

OG_Lowered_Bstyle

OG_Outset_Bstyle

OG_Plain_Bstyle

OG_Raised_Bstyle

構文

PROCEDURE OG_Set_Bevelstyle
  (object       OG_Object,
   bevelstyle   NUMBER,
   damage       BOOLEAN    := TRUE,
   update_bbox  BOOLEAN    := TRUE);

FUNCTION OG_Get_Bevelstyle
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。
bevelstyle	オブジェクトの凹凸スタイル。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


凹凸スタイル・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure rotates
**the bevel style of a selected object.
*/

PROCEDURE bevel (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  obj og_object;
  num number;
BEGIN
  obj := og_get_object('rect');
  num := og_get_bevelstyle(obj);
  if num = og_inset_bstyle then
     og_set_bevelstyle(obj, og_lowered_bstyle);
  elsif num = og_lowered_bstyle then
     og_set_bevelstyle(obj, og_outset_bstyle);
  elsif num = og_outset_bstyle then
     og_set_bevelstyle(obj, og_plain_bstyle);
  elsif num = og_plain_bstyle then
     og_set_bevelstyle(obj, og_raised_bstyle);
  elsif num = og_raised_bstyle then
     og_set_bevelstyle(obj, og_inset_bstyle);
  end if;
END;


端形式プロパティ

  例	  関連項目

説明  オブジェクトの枠の端形式です。このプロパティには、次のビルトイン定数を指定できます。

OG_Butt_Cstyle

OG_Projecting_Cstyle

OG_Round_Cstyle

構文

PROCEDURE OG_Set_Capstyle
  (object        OG_Object,
   capstyle      NUMBER,
   damage        BOOLEAN    :=  TRUE,
   update_bbox   BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Capstyle
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。
capstyle	オブジェクトの枠の端形式。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


端形式プロパティの例

  アルファベット順リスト         [image]  すべての例     [image]  関連項目

/*The following button procedure rotates
**the cap style of an object's edge.
*/

PROCEDURE CapStyle (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
BEGIN
  num := og_get_capstyle(hitobj);
  if num = og_butt_cstyle then
     og_set_capstyle(hitobj, og_projecting_cstyle);
  elsif num = og_projecting_cstyle then
     og_set_capstyle(hitobj,og_round_cstyle);
  elsif num = og_round_cstyle then
     og_set_capstyle(hitobj,og_butt_cstyle);
  end if;
END;


線種スタイル・プロパティ

  例	  関連項目

説明  オブジェクトの枠の線種スタイルです。このプロパティには、次のビルトイン定数を指定できます。

OG_Solid_Dstyle

OG_Dot_Dstyle

OG_Long_Dstyle

OG_Dashdot_Dstyle

OG_Dotdot_Dstyle

OG_Short_Dstyle

OG_Dashdotdot_Dstyle

構文

PROCEDURE OG_Set_Dashstyle
  (object         OG_Object,
   dashstyle      NUMBER,
   damage         BOOLEAN    :=  TRUE,
   update_bbox    BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Dashstyle
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。
dashstyle	オブジェクトの枠の線種スタイル。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


線種スタイル・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

*/The following button procedure rotates
**the dash style on hit object.
*/

PROCEDURE DashStyle (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
    num number;
BEGIN
  num := og_get_dashstyle(hitobj);
  if num = og_solid_dstyle then
     og_set_dashstyle(hitobj, og_dot_dstyle);
  elsif num = og_dot_dstyle then
     og_set_dashstyle(hitobj,og_long_dstyle);
  elsif num = og_long_dstyle then
     og_set_dashstyle(hitobj,og_dashdot_dstyle);
  elsif num = og_dashdot_dstyle then
     og_set_dashstyle(hitobj,og_dotdot_dstyle);
  elsif num = og_dotdot_dstyle then
     og_set_dashstyle(hitobj,og_short_dstyle);
  elsif num = og_short_dstyle then
     og_set_dashstyle(hitobj,og_dashdotdot_dstyle);
  elsif num = og_dashdotdot_dstyle then
     og_set_dashstyle(hitobj,og_solid_dstyle);
  end if;
END;


枠パターン・プロパティ

  例	  関連項目

説明  オブジェクトの枠パターンです。

構文

PROCEDURE OG_Set_Edgepatt
  (object        OG_Object,
   edgepatt      VARCHAR2,
   damage        BOOLEAN    :=  TRUE,
   update_bbox   BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Edgepatt
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
edgepatt	オブジェクトの枠パターン。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


枠パターン・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure swaps the edge
**and fill patterns of an object.
*/

PROCEDURE EdgePattern IS
  obj og_object;
  edgepatt varchar2(20);
  fillpatt varchar2(20);
BEGIN
  obj := og_get_object('rect');
  edgepatt := og_get_edgepatt(obj);
  fillpatt := og_get_fillpatt(obj);
  og_set_edgepatt(obj, fillpatt);
  og_set_fillpatt(obj, edgepatt);
END;


枠幅プロパティの例

  例	  関連項目

説明  オブジェクトの枠の幅です（レイアウト単位）。

構文

PROCEDURE OG_Set_Ewidth
  (object       OG_Object,
   ewidth       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Ewidth
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。
ewidth	オブジェクトの枠の幅（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


枠幅プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the edge
**width of a selected object.If the width
**is 0, it resets the width to value800.

PROCEDURE EdgeWidth IS
  obj og_object;
  width number;
BEGIN
  obj := og_get_object('rect');
  width := og_get_ewidth(obj);
  if width = 0 then
    og_set_ewidth(obj, 800);
  end if;
END;


塗りパターン・プロパティ

  例	  関連項目

説明  オブジェクトの塗りパターンです。

構文

PROCEDURE OG_Set_Fillpatt
  (object        OG_Object,
   fillpatt      VARCHAR2,
   damage        BOOLEAN    :=  TRUE,
   update_bbox   BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Fillpatt
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
fillpatt	オブジェクトの塗りパターン。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


塗りパターン・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* Examples

/*The following procedure swaps the edge
**and fill patterns of an object.
*/

PROCEDURE EdgePattern IS
  obj og_object;
  edgepatt varchar2(20);
  fillpatt varchar2(20);
BEGIN
  obj := og_get_object('rect');
  edgepatt := og_get_edgepatt(obj);
  fillpatt := og_get_fillpatt(obj);
  og_set_edgepatt(obj, fillpatt);
  og_set_fillpatt(obj, edgepatt);
END;


フォアグラウンド線カラー・プロパティ

  例	  関連項目

説明  オブジェクトのフォアグラウンド線カラーです。

構文

PROCEDURE OG_Set_Fecolor
  (object       OG_Object,
   fecolor      VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Fecolor
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
fecolor	オブジェクトのフォアグラウンド線カラー。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


フォアグラウンド線カラー・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure swaps the foreground
**and background edge colors.
*/

PROCEDURE FBEdgeColor IS
  obj og_object;
  fcolor varchar2(20);
  bcolor varchar2(20);
BEGIN
  obj := og_get_object('rect');
  fcolor := og_get_fecolor(obj);
  bcolor := og_get_becolor(obj);
  og_set_fecolor(obj, bcolor);
  og_set_becolor(obj, fcolor);
END;


フォアグラウンド塗りカラー・プロパティ

  例	  関連項目

説明  オブジェクトのフォアグラウンド塗りカラーです。

構文

PROCEDURE OG_Set_Ffcolor
  (object       OG_Object,
   ffcolor      VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Ffcolor
  (object  OG_Object)
RETURN VARCHAR2;

パラメータ

object	定義中のオブジェクト。
ffcolor	オブジェクトのフォアグラウンド塗りカラー。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


フォアグラウンド塗りカラー・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure swaps the foreground
**and background fill colors.
*/

PROCEDURE FBFillColor IS
  obj og_object;
  fcolor varchar2(20);
  bcolor varchar2(20);
BEGIN
  obj := og_get_object('rect');
  fcolor := og_get_ffcolor(obj);
  bcolor := og_get_bfcolor(obj);
  og_set_ffcolor(obj, bcolor);
  og_set_bfcolor(obj, fcolor);
END;


結合形式プロパティ

  例	  関連項目

説明  オブジェクトの枠の結合形式です。このプロパティには、次のビルトイン定数を指定できます。

OG_Mitre_Jstyle

OG_Bevel_Jstyle

OG_Round_Jstyle

構文

PROCEDURE OG_Set_Joinstyle
  (object         OG_Object,
   joinstyle      NUMBER,
   damage         BOOLEAN    :=  TRUE,
   update_bbox    BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Joinstyle
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。
joinstyle	オブジェクトの枠の結合形式。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


結合形式プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure rotates
**the join style of an object's edge.
*/

PROCEDURE JoinStyle (mitreonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
BEGIN
  num := og_get_joinstyle(hitobj);
  if num = og_mitre_jstyle then
     og_set_joinstyle(hitobj, og_bevel_jstyle);
  elsif num = og_bevel_jstyle then
     og_set_joinstyle(hitobj,og_round_jstyle);
  elsif num = og_round_jstyle then
     og_set_joinstyle(hitobj,og_mitre_jstyle);
  end if;
END;


回転角度プロパティ

  例	  関連項目

説明  オブジェクトの回転角度です。オブジェクトが最初に作成された時の角度が0と見なされ、現在の角度と最初の角度との時計回りで測った差がこのプロパティです。このプロパティを設定すると、オブジェクトを絶対角度で回転させることができ、またOG_Rotateプロシージャを使用すると、オブジェクトを相対角度で回転させることができます。（OG_Rotateを使用してオブジェクトを回転させると、回転角度プロパティが自動的に更新され、新しい絶対角度が反映されます。）

構文

PROCEDURE OG_Set_Rotang
  (object       OG_Object,
   rotang       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Rotang
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。
rotang	オブジェクトの回転角度。オブジェクトが最初に作成された時の角度が0と見なされ、現在の角度と最初の角度との時計回りで測った差がこのプロパティです。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


回転角度プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the rotation
**angle from a selected object, and rotates
**the object another 45 degrees to the right.
*/

PROCEDURE RotAngle IS
  obj og_object;
  rotang number;
BEGIN
  obj := og_get_object('rect');
  rotang := og_get_rotang(obj);
  og_set_rotang(obj, rotang+45);
END;


転送モード・プロパティ

  例	  関連項目

説明  オブジェクトの転送モードです。このプロパティには、次のビルトイン定数を指定できます。

OG_Copy_Transfer

OG_Revcopy_Transfer

OG_Or_Transfer

OG_Revor_Transfer

OG_Clear_Transfer

OG_Revclear_Transfer

OG_Invert_Transfer

OG_Backinvert_Transfer

構文

PROCEDURE OG_Set_Transfer
  (object        OG_Object,
   transfer      NUMBER,
   damage        BOOLEAN    := TRUE,
   update_bbox   BOOLEAN    := TRUE);

FUNCTION OG_Get_Transfer
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。
transfer	オブジェクトの転送モード。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


転送モード・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure rotates the
**transfer mode of a selected object.
*/

PROCEDURE transher (copyonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
BEGIN
  num := og_get_transfer(hitobj);
  if num = og_copy_transfer then
     og_set_transfer(hitobj, og_revcopy_transfer);
  elsif num = og_revcopy_transfer then
     og_set_transfer(hitobj,og_or_transfer);
  elsif num = og_or_transfer then
     og_set_transfer(hitobj,og_revor_transfer);
  elsif num = og_revor_transfer then
     og_set_transfer(hitobj,og_clear_transfer);
  elsif num = og_clear_transfer then
     og_set_transfer(hitobj,og_revclear_transfer);
  elsif num = og_revclear_transfer then
     og_set_transfer(hitobj,og_invert_transfer);
  elsif num = og_invert_transfer then
     og_set_transfer(hitobj,og_backinvert_transfer);
  elsif ]um =og_backinvert_transfer then
  og_set_transfer(hitobj,og_copy_transfer);
  end if;
END;


グループ・プロパティ

子の数プロパティ

クリップ・フラグ・プロパティ


子の数プロパティ

  例	  関連項目

説明  グループ・オブジェクトに属する子の数です。別のグループ・オブジェクトが、対象としているグループの子である場合、そのオブジェクトは単に1つのオブジェクトとしてカウントされます。

構文

FUNCTION OG_Get_Childcount
  (object  OG_Object)
RETURN NUMBER;

パラメータ

object	定義中のオブジェクト。


子の数プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure gets the number
**of children in agroup object.
*/

PROCEDURE GrpChildCnt IS
  grp og_object;
  cnt number;
BEGIN
  grp := og_get_object('group');
  cnt := og_get_childcount(grp);
END;


クリップ・フラグ・プロパティ

  例	  関連項目

説明  グループ内の最初のオブジェクトの表示領域を、グループを表示する枠にするかどうかを指定します。TRUEに設定すると、レイアウトに表示されるオブジェクトは、枠内に含まれるグループ・オブジェクト、またはグループ・オブジェクトの一部となります。枠になっているオブジェクト自体も表示されます。

構文

PROCEDURE OG_Set_Clipflag
  (object        OG_Object,
   clipflag      BOOLEAN,
   damage        BOOLEAN    :=  TRUE,
   update_bbox   BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Clipflag
  (object  OG_Object)
RETURN BOOLEAN;

パラメータ

object	定義中のオブジェクト。
clipflag	グループ内の最初のオブジェクトの表示領域を、グループを表示する枠にするかどうかを指定する。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


クリップ・フラグ・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure checks if
**clipflag is true.Ifnot, it sets the
**flag to true.
*/

PROCEDURE GrpClipFlg IS
  grp og_object;
  flag boolean;
BEGIN
  grp := og_get_object('group');
  flag := og_get_clipflag(grp);
  if flag = false then
     og_set_clipflag(grp, true);
  end if;
END;


イメージ・プロパティ

クリップする四角形プロパティ

粗さプロパティ

高さプロパティ

位置プロパティ

品質プロパティ

幅プロパティ


クリップする四角形プロパティ

  例	  関連項目

説明  イメージを表示する枠のx座標とy座標、および高さ、幅です（レイアウト単位）。この枠の中に含まれるイメージのみが表示されます。このプロパティを指定しないと、表示する枠がイメージと同じ大きさになります。

構文

PROCEDURE OG_Set_Cliprect
  (image         OG_Object,
   cliprect      OG_Rectangle,
   damage        BOOLEAN       :=  TRUE,
   update_bbox   BOOLEAN       :=  TRUE);

FUNCTION OG_Get_Cliprect
  (image  OG_Object)
RETURN OG_Rectangle;

パラメータ

image	定義中のイメージ・オブジェクト。
cliprect	イメージを表示する枠のx座標とy座標、および高さ、幅（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


クリップする四角形プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reduces the
**size of the clipping rectangle by half.
*/

PROCEDURE ClipRect IS
  image og_object;
  rect og_rectangle;
BEGIN
  image := og_get_object('image');
  rect := og_get_cliprect(image);
  rect.height := rect.height/2;
  rect.width := rect.width/2;
  og_set_cliprect(image, rect);
  og_set_clipflag(image, true);
END;


粗さプロパティ

  例	  関連項目

説明  Graphics Builderでイメージを表示するときに、そのイメージをディザリングするかどうかを指定します。このプロパティには、次のいずれかを指定できます。

構文

PROCEDURE OG_Set_Image_Dither
  (image   OG_Object,
   dither  BOOLEAN);

FUNCTION OG_Get_Image_Dither
  (image  OG_Object)
RETURN BOOLEAN;

パラメータ

image	定義中のイメージ・オブジェクト。
dither	Graphics Builderでイメージを表示するときに、そのイメージをディザリングするかどうかを指定する。


粗さプロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure
**dithers an image or removes
**dithering.
*/

PROCEDURE SetDither (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
val boolean;
image og_object;
BEGIN
  image := og_get_object('image');
  val := og_get_image_dither(image);
  if val then
    og_set_image_dither(og_get_object('image'), false);
  else
    og_set_image_dither(og_get_object('image'), true);
  end if;
END;


高さプロパティ

  例	  関連項目

説明  イメージの高さです（レイアウト単位）。このプロパティをイメージのデフォルトの高さ以外の値に設定すると、イメージは新しい高さに収まるようにスケーリングされます。

構文

（前述のOG_Set_Image_Sizeを参照してください。）

FUNCTION OG_Get_Image_Height
  (image  OG_Object)
RETURN NUMBER;

パラメータ

image	定義中のイメージ・オブジェクト。


高さプロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure reduces
**an image's size by half.
*/

PROCEDURE SizeWidthHeight IS
  image og_object;
  height number;
  width number;
BEGIN
  image := og_get_object('image');
  width := og_get_image_width(image);
  height := og_get_image_height(image);
  og_set_image_size(image, width/2, height/2);
END;


位置プロパティ

  例	  関連項目

説明  イメージの左上角のx座標とy座標です（レイアウト単位）。

構文

PROCEDURE OG_Set_Upperleft
  (image          OG_Object,
   upperleft      OG_Point,
   damage         BOOLEAN    :=  TRUE,
   update_bbox    BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Upperleft
  (image  OG_Object)
RETURN OG_Point;

パラメータ

image	定義中のイメージ・オブジェクト。
upperleft	イメージの左上角のx座標とy座標（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


位置プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the
**(x,y) coordinates of the image's
**upper-left corner.If the coordinate
**is not(0,0), the procedure
**moves the image's upper-left
**corner to the (0,0) coordinate.
*/

PROCEDURE Position IS
  image og_object;
  pos og_point;
BEGIN
  image := og_get_object('image');
  pos := og_get_upperleft(image);
  if pos.x != 0 and pos.y != 0 then
    pos.x := 0;
    pos.y := 0;
    og_set_upperleft(image, pos);
  end if;
END;


品質プロパティ

  例	  関連項目

説明  イメージを描画するときの品質を指定します。イメージの品質を高くすると、見栄えはよくなりますが、操作（たとえば、描画、移動、スケーリングなど）の処理時間が長くなります。このプロパティには、次のビルトイン定数を指定できます。

OG_High_Iquality

OG_Medium_Iquality

OG_Low_Iquality

構文

PROCEDURE OG_Set_Image_Quality
  (image    OG_Object,
   quality  NUMBER);

FUNCTION OG_Get_Image_Quality
  (image  OG_Object)
RETURN NUMBER;

パラメータ

image	定義中のイメージ・オブジェクト。
quality	イメージを描画するときの品質を指定する。


品質プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure checks image
**quality.If the image is currently drawn
**with high quality, the procedure redraws
**it with low quality.
*/

PROCEDURE GetQuality (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  image og_object;
  qty number;
BEGIN
  image := og_get_object('image');
  qty := og_get_image_quality(image);
  if qty = og_high_iquality then
    og_set_image_quality(image, og_low_iquality);
  end if;
END;


幅プロパティ

  例	  関連項目

説明  イメージの幅です（レイアウト単位）。このプロパティをイメージのデフォルトの幅以外の値に設定すると、イメージは新しい幅に収まるようにスケーリングされます。

構文

PROCEDURE OG_Set_Image_Size
  (image        OG_Object,
   width        NUMBER,
   height       NUMBER,
   damage       BOOLEAN    := TRUE,
   update_bbox  BOOLEAN    :=   TRUE);

FUNCTION OG_Get_Image_Width
  (image  OG_Object)
RETURN NUMBER;

パラメータ

image	定義中のイメージ・オブジェクト。
width	イメージの幅（レイアウト単位）。
height	イメージの高さ（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


幅プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* The following procedure reduces
**an image's size by half.
*/

PROCEDURE SizeWidthHeight IS
  image og_object;
  height number;
  width number;
BEGIN
  image := og_get_object('image');
  width := og_get_image_width(image);
  height := og_get_image_height(image);
  og_set_image_size(image, width/2, height/2);
END;


線プロパティ

矢印スタイル・プロパティ

終点プロパティ

始点プロパティ


矢印スタイル・プロパティ

  例	  関連項目

説明  線の矢印のスタイルです。このプロパティには、次のビルトイン定数を指定できます。

OG_Noarrow_Astyle   線に矢印を付けません。

OG_Start_Astyle   線の始点に矢印を付けます。

OG_End_Astyle   線の終点に矢印を付けます。

OG_Both_Astyle   線の両端に矢印を付けます。

OG_Midtostart_Astyle   線の中央に、始点の方を指す矢印を付けます。

OG_Midtoend_Astyle   線の中央に、終点の方を指す矢印を付けます。

構文

PROCEDURE OG_Set_Arrowstyle
  (line         OG_Object,
   arrowstyle   NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Arrowstyle
  (line  OG_Object)
RETURN NUMBER; パラメータ

パラメータ

line	定義中の線オブジェクト。
arrowstyle	線の矢印のスタイル。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


矢印スタイル・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure determines a
*line's current arrow style.If the line
**does not include arrows, the procedure adds
**arrows to both ends of the line.If the
**line does include arrows, the
**procedure removes them.
*/

PROCEDURE Arrow (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  arrow og_object;
  num number;
BEGIN
  arrow := og_get_object('arrow');
  num := og_get_arrowstyle(arrow);
  if num = og_noarrow_astyle then
    og_set_arrowstyle(arrow, og_both_astyle);
  else
    og_set_arrowstyle(arrow, og_noarrow_astyle);
  end if;
END;


終点プロパティ

  例	  関連項目

説明  線の終点のx座標とy座標です（レイアウト単位）。

構文

PROCEDURE OG_Set_Endpt
  (line         OG_Object,
   endpt        OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Endpt
  (line  OG_Object)
RETURN OG_Point;

パラメータ

line	定義中の線オブジェクト。
endpt	線の終点のx座標とy座標（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


終点プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the
**coordinates of the line's ending point.
**If the line does not end at the upper-left
**corner of the display, the procedure resets
**the end point to (0,0).
*/

PROCEDURE OGBUTTONPROC0 (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  arrow og_object;
  pos og_point;
BEGIN
  arrow := og_get_object('a');
  pos := og_get_endpt(arrow);
  if pos.x != 0 and pos.y != 0 then
    pos.x := 0;
    pos.y := 0;
    og_set_endpt(arrow, pos);
  end if;
END;


始点プロパティ

  例	  関連項目

説明  線の始点のx座標とy座標です（レイアウト単位）。

構文

PROCEDURE OG_Set_Startpt
  (line         OG_Object,
   startpt      OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Startpt(line OG_Object)
RETURN OG_Point;

パラメータ

line	定義中の線オブジェクト。
startpt	線の始点のx座標とy座標（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


始点プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/* /*The following procedure reads
**the coordinates of a line's
**starting point.If the line does
**not start from the upper-left corner
**of the display, the procedure resets
**the start point to (0,0).
*/

PROCEDURE  StartPt (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  arrow og_object;
  pos og_point;
BEGIN
  arrow := og_get_object('a');
  pos := og_get_startpt(arrow);
  if pos.x != 0 and pos.y != 0 then
    pos.x := 0;
    pos.y := 0;
    og_set_startpt(arrow, pos);
  end if;
END;


多角形プロパティ

閉じ形状プロパティ

ポイント数プロパティ


閉じ形状プロパティ

  例	  関連項目

説明  多角形の閉じ形状です。このプロパティには、次のいずれかを指定できます。

TRUE   多角形を閉じる。

FALSE   多角形を開く。

構文

PROCEDURE OG_Set_Poly_Closed
  (poly         OG_Object,
   closed       BOOLEAN,
   damage       BOOLEAN    := TRUE,
   update_bbox  BOOLEAN    := TRUE);

FUNCTION OG_Get_Poly_Closed
  (poly  OG_Object)
RETURN BOOLEAN;

パラメータ

poly	定義中の多角形。
closed	多角形の閉じ形状。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


閉じ形状プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure determines
**whether a polygon is closed.
**If the polygon is open, the procedure
**closes it.
*/

PROCEDURE closure IS
  polygon og_object;
  val boolean;
BEGIN
  polygon := og_get_object('polygon');
  val := og_get_poly_closed(polygon);
  if val = false  then
     og_set_poly_closed(polygon, true);
  end if;
END;


ポイント数プロパティ

  例	  関連項目

説明  多角形オブジェクトを構成するポイントの数です。

構文

FUNCTION OG_Get_Pointct
  (poly  OG_Object)
RETURN NUMBER;

パラメータ

poly	定義中の多角形。


ポイント数プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the
**number of points that compose the
**polygon object and prints the number
**to a text object.
*/

PROCEDURE PntCnt IS
  text og_object;
  polygon og_object;
  cnt number;
BEGIN
text := og_get_object('text object');
  polygon := og_get_object('polygon');
  cnt := og_get_pointct(polygon);
  og_set_str(text, cnt);
END;


印刷プロパティ

部数プロパティ

終了ページ・プロパティ

Landscapeプロパティ

名前プロパティ

ページ・サイズ・プロパティ

出力ファイル・プロパティ

開始ページ・プロパティ


部数プロパティ

  例	  関連項目

説明  印刷部数です。

構文

PROCEDURE OG_Set_Copies
  (copies  NUMBER);

FUNCTION OG_Get_Copies
RETURN NUMBER;

パラメータ

copies	印刷部数。


部数プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads
**the number of copies and adds two more
**copies to print.
*/

PROCEDURE PrinterCopies IS
  copies number;
BEGIN
  copies := og_get_copies;
  og_set_copies(copis+2);
END;


終了ページ・プロパティ

  例	  関連項目

説明  印刷する最終ページです。

構文

PROCEDURE OG_Set_Endpage
  (endpage  NUMBER);

FUNCTION OG_Get_Endpage
RETURN NUMBER;

パラメータ

endpage	印刷する最終ページ。


終了ページ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**end page number and resets it to the
**original number plus two.
*/

PROCEDURE PrinterEndPage IS
  ep number;
BEGIN
  ep := og_get_endpage;
  og_set_endpage(ep+2);
END;


Landscapeプロパティ

  例	  関連項目

説明  図表をLandscapeモードとPortraitモードのどちらで印刷するかを指定します。

構文

PROCEDURE OG_Set_Landscape
  (landscape  BOOLEAN);

FUNCTION OG_Get_Landscape
RETURN BOOLEAN;

パラメータ

landscape	図表をLandscapeモードとPortraitモードのどちらで印刷するかを指定します。


Landscapeプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure determines
**if the display is printed in landscape
**or portrait mode, and prints the mode
**type to a text object.
*/

PROCEDURE PrinterLandscape IS

landscape boolean;

BEGIN

landscape := og_get_landscape;
  if landscape then
     og_set_str(og_get_object('text object'), 'landscape');
  else
     og_set_str(og_get_object('text object'), 'portrait');
  end if;
END;


名前プロパティ

  例	  関連項目

説明  現行のプリンタの名前です。

構文

PROCEDURE OG_Set_Printer_Name
  (name  VARCHAR2);

FUNCTION OG_Get_Printer_Name
RETURN VARCHAR2;

パラメータ

name	現行のプリンタの名前。


名前プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure sets the
**printer name and prints the name to
**a text object.
*/

PROCEDURE PrinterName IS
  name varchar2(30);
BEGIN
  name := og_get_printer_name;
  og_set_str(og_get_object('text object'), name);
END;


ページ・サイズ・プロパティ

  例	  関連項目

説明  ページ・サイズです（インチ単位）。

構文

PROCEDURE OG_Set_Pagesize
  (width   NUMBER,
  (height  NUMBER);

パラメータ

width	ページの幅（インチ単位）。
height	ページの高さ（インチ単位）。


ページ・サイズ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure sets the
**page size.
*/

PROCEDURE PrinterPageSize IS
  height number := 10*og_inch;
  width number := 10*og_inch;
  printfile varchar2(20);
BEGIN
  og_set_pagesize(height, width);
END;


出力ファイル・プロパティ

  例	  関連項目

説明  出力先のPostScriptファイルの名前です。このプロパティをNULLにすると、出力がプリンタへ送られます。

構文

PROCEDURE OG_Set_Printfile
  (filename  VARCHAR2);

FUNCTION OG_Get_Printfile
RETURN VARCHAR2;

パラメータ

filename	出力先のPostScriptファイルの名前。このプロパティをNULLにすると、出力がプリンタへ送られます。


出力ファイル・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*.The following procedure sets the
**PostScript file name and prints it
**to a text object.
*/

 PROCEDURE PrinterPrintFile IS
  printfile varchar2(20);
BEGIN
  og_set_printfile('myfile');
  printfile := og_get_printfile;
  og_set_str(og_get_object('text object'), printfile);
END;


開始ページ・プロパティ

  例	  関連項目

説明  印刷する第1ページです。

構文

PROCEDURE OG_Set_Startpage
  (startpage  NUMBER);

FUNCTION OG_Get_Startpage
RETURN NUMBER;

パラメータ

startpage	印刷する第1ページ。


開始ページ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

  関連項目 /*The following procedure reads the start
**page number and resets the page number
**to the original number plus two.
*/

PROCEDURE PrinterStartPage IS
  sp number;
BEGIN
  sp := og_get_startpage;
  og_set_startpage(sp+2);
END;


問合せプロパティ

「キャッシュ・タイプ」プロパティ

「カスタム問合せプロシージャ」プロパティ

「日付書式」プロパティ

「オープン時実行」プロパティ

「タイマーで実行」プロパティ

「最大行」プロパティ

名前プロパティ

「問合せ後トリガー・プロシージャ」プロパティ

「問合せソース」プロパティ

「問合せタイプ」プロパティ


「キャッシュ・タイプ」プロパティ

  例	  関連項目

説明  問合せの実行により新しく取り出されたデータを処理する方法を決定します。このプロパティには、次のビルトイン定数を指定できます。

OG_Append_Cachetype  データのすべての既存行が保持され、データの新規行が既存データ・セットの一番下に追加されます。

OG_Copy_Cachetype  前回の実行によるすべてのデータが特別バッファにコピーされ、新しく取り出されたデータに置換されます。

OG_None_Cachetype  前回の実行によるすべてのデータが破棄され、新しく取り出されたデータに置換されます。

構文

PROCEDURE OG_Set_Cachetype
  (query      OG_Query,
   cachetype  NUMBER);

FUNCTION OG_Get_Cachetype
  (query  OG_Query)
RETURN NUMBER;

パラメータ

query	定義中の問合せ。
cachetype	問合せの実行により新しく取り出されたデータを処理する方法を決定します。


「キャッシュ・タイプ」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure rotates the query
**cache type of a query.
*/

PROCEDURE QryCacheType (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  qry og_query;
  num number;
BEGIN
  qry := og_get_query('query0');
  num := og_get_cachetype(qry);
  if num = og_append_cachetype then
     og_set_cachetype(qry, og_copy_cachetype);
  elsif num = og_copy_cachetype then
     og_set_cachetype(qry, og_none_cachetype);
  elsif num = og_none_cachetype then
     og_set_cachetype(qry, og_append_cachetype);
  end if;
END;


「カスタム問合せプロシージャ」プロパティ

  例	  関連項目

説明  カスタム問合せが実行されるときに起動するPL/SQLプロシージャです。

構文

PROCEDURE OG_Set_Customproc
  (query       OG_Query,
   customproc  VARCHAR2);

FUNCTION OG_Get_Customproc
  (query  OG_Query)
RETURN VARCHAR2;

パラメータ

query	定義中の問合せ。
customproc	カスタムの問合せが実行されるときに起動するPL/SQLプロシージャです。


「カスタム問合せプロシージャ」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure swaps the two PL/SQL
**procedures which are invoked when a custom query is

**executed.
*/

PROCEDURE CustQry (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  proc varchar2(20);
  qry og_query;
BEGIN
  qry := og_get_query('query0');
  proc := og_get_customproc(qry);
  if proc = 'CUSTQRY1' then
    og_set_customproc(qry, 'CUSTQRY2');
  elsif proc = 'CUSTQRY2' then
     og_set_customproc(qry, 'CUSTQRY1');
  end if;
  og_execute_query(qry);
END;


「日付書式」プロパティ

  例	  関連項目

説明  問合せの日付書式マスクです。

構文

PROCEDURE OG_Set_Dateformat
  (query       OG_Query,
   dateformat  VARCHAR2);

FUNCTION OG_Get_Dateformat
  (query  OG_Query)
RETURN VARCHAR2;

パラメータ

query	定義中の問合せ。
dateformat	問合せの日付書式マスク。


「日付書式」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads and sets
**the Date Format mask for the query.
*/

PROCEDURE QueryDateFmt IS
  qry og_query;
  DateFmt varchar2(20);
BEGIN
  qry := og_get_query('query0');
  DateFmt := og_get_dateformat(qry);
  og_set_dateformat(qry, 'DD-MM-YYYY');
  DateFmt := og_get_dateformat(qry);
END;


「オープン時実行」プロパティ

  例	  関連項目

説明  図表を実行時にオープンしたときに、問合せを自動的に実行するかどうかを指定します。

構文

PROCEDURE OG_Set_Execopen
  (query     OG_Query,
   execopen  BOOLEAN);

FUNCTION OG_Get_Execopen
  (query  OG_Query)
RETURN BOOLEAN;

パラメータ

query	定義中の問合せ。
execopen	図表を実行中にオープンしたときに問合せを自動的に実行するかどうかを指定します。


「オープン時実行」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure checks if the Execute
**on Open checkbox is checked.If it is checked,
**it unchecks it, or vice versa.
*/

PROCEDURE ExecOpen IS
  execOpen boolean;
  qry og_query;
BEGIN
  qry := og_get_query('query0');
  execOpen := og_get_execopen(qry);
  if execOpen then
     og_set_execopen(qry, false);
  else
     og_set_execopen(qry, true);
  end if;
END;


「タイマーで実行」プロパティ

  例	  関連項目

説明  問合せを実行するときに使用するタイマーの名前です。NULLの場合は、タイマーを使用して問合せを実行しません。

構文

PROCEDURE OG_Set_Exectimer
  (query      OG_Query,
   exectimer  VARCHAR2);

FUNCTION OG_Get_Exectimer
  (query  OG_Query)
RETURN VARCHAR2;

パラメータ

query	定義中の問合せ。
exectimer	問合せを実行するときに使用するタイマーの名前。NULLの場合は、タイマーを使用して問合せを実行しません。


「タイマーで実行」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the name of
**the timer on which the query executes and
**assigns a new timer to the query.
*/

PROCEDURE ExecTimer IS
  exectimer varchar2(20);
  qry og_query;
BEGIN
  qry := og_get_query('query0');
  exectimer := og_get_exectimer(qry);
  og_set_exectimer(qry, 'timer1');
END;


「最大行」プロパティ

  例	  関連項目

説明  問合せデータ・セットに保持されるデータの最大行数を指定します。NULLの場合は、すべての行が保持されます。

構文

PROCEDURE OG_Set_Maxrows
  (query    OG_Query,
   maxrows  NUMBER);

FUNCTION OG_Get_Maxrows
  (query  OG_Query)
RETURN NUMBER;

パラメータ

query	定義中の問合せ。
maxrows	問合せデータ・セットに保持されるデータの最大行数を指定します。NULLの場合は、すべての行が保持されます。


「最大行」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the maximum
**number of rows of data that are retained
**in the query's data set, and adds two rows to
**the original number.
*/

PROCEDURE QueryMaxRow IS
  qry og_query;
  num number;
BEGIN
  qry := og_get_query('query0');
  num := og_get_maxrows(qry);
  og_set_maxrows(qry, num+2);
END;


「最大行フラグ」プロパティ

  例	  関連項目

説明  データ・セットに含まれる行数に制限を設定するかどうかを指定します。このプロパティは、キャッシュ・タイプがOG_APPEND_CACHETYPEタイプのときに限り使用されます。

構文

PROCEDURE OG_Set_Maxflag
  (query    OG_Query,
   maxflag  BOOLEAN);

FUNCTION OG_Get_Maxflag
  (query  OG_Query)
RETURN BOOLEAN;

パラメータ

query	定義中の問合せ。
maxflag	問合せデータ・セットに含むことができるデータの最大行数を指定します。


「最大行フラグ」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure reads the maximum
**number of rows of data that are retained
**in the query's data set, and adds two rows to
**the original number.If the incremented number
**is greater than 1024, then it disables the
**maximum rows flag, thus allowing the query to get
**all the rows of data.
*/

PROCEDURE MaxFlagToggle IS
  qry og_query;
  num number;
BEGIN
  qry := og_get_query('query0');
  num := og_get_maxrows(qry);

num := num+2;
  og_set_maxrows(qry, num);

IF ((num > 1024) AND (og_get_maxflag(qry)=TRUE)) THEN

og_set_maxflag(qry,FALSE);

END IF;
END;


名前プロパティ

  例	  関連項目

説明  問合せの名前です。

構文

PROCEDURE OG_Set_Name
  (query  OG_Query,
   name   VARCHAR2);

FUNCTION OG_Get_Name
  (query  OG_Query)
RETURN VARCHAR2;

パラメータ

query	定義中の問合せ。
name	問合せの名前です。


名前プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure swaps
** the name of two queries.
*/

PROCEDURE QueryName IS
  qry0 og_query;
  qry1 og_query;
  name0 varchar2(30);
  name1 varchar2(30);
BEGIN
  qry0 := og_get_query('query0');
  qry1 := og_get_query('query1');
  name0 := og_get_name(qry0);
  name1 := og_get_name(qry1);
  og_set_name(qry1, 'tmp');
  og_set_name(qry0, name1);
  og_set_name(qry1, name0);
END;


「問合せ後トリガー・プロシージャ」プロパティ

  例	  関連項目

説明  問合せが実行された後で起動するPL/SQLプロシージャです。

構文

PROCEDURE OG_Set_Postproc
  (query     OG_Query,
   postproc  VARCHAR2);

FUNCTION OG_Get_Postproc
  (query  OG_Query)
RETURN VARCHAR2;

パラメータ

query	定義中の問合せ。
postproc	問合せが実行された後で起動するPL/SQLプロシージャです。


「問合せ後トリガー・プロシージャ」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure swaps the two PL/SQL
**procedures which are invoked after the query is
**executed.
*/

PROCEDURE PostTrigger (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  proc varchar2(20);
  qry og_query;
BEGIN
  qry := og_get_query('query0');
  proc := og_get_postproc(qry);
  if  proc = 'POST1' then
      og_set_postproc(qry, 'POST2');
  elsif proc = 'POST2' then
      og_set_postproc(qry, 'POST1');
  end if;
  og_execute_query(qry);
END;


「問合せソース」プロパティ

  例	  関連項目

説明  問合せデータのソースです。データベースからのデータの場合は、このプロパティに問合せのSQL SELECT文のテキストが含まれている必要があります。データがファイル・システムに格納されている場合は、このプロパティにデータ・ファイルのパスと名前を指定する必要があります。

構文

PROCEDURE OG_Set_Querysource
  (query        OG_Query,
   querysource  VARCHAR2);

FUNCTION OG_Get_Querysource
  (query  OG_Query)
RETURN VARCHAR2;

パラメータ

query	定義中の問合せ。
querysource	問合せデータのソース。


「問合せソース」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure swaps the source
**of two queries.
*/

PROCEDURE QuerySource IS
  qry0 og_query;
  qry1 og_query;
  source0 varchar2(50);
  source1 varchar2(50);
BEGIN
  qry0 := og_get_query('query0');
  qry1 := og_get_query('query1');
  source0:= og_get_querysource(qry0);
  source1:= og_get_querysource(qry1);
  og_set_querysource(qry0, source1);
  og_set_querysource(qry1, source0);
END;


「問合せタイプ」プロパティ

  例	  関連項目

説明  問合せのタイプです。このプロパティには、次のビルトイン定数を指定できます。

OG_Custom_Qtype  問合せはカスタム問合せです。

OG_Exsql_Qtype  問合せによりSQL SELECT文を含むテキスト・ファイルからデータが取り出されます。

OG_Prn_Qtype  PRNファイルに基づいて問合せが行われます。

OG_Sql_Qtype  問合せはSQL SELECT文です。

OG_Sylk_Qtype  SYLKファイルに基づいて問合せが行われます。

OG_Wks_Qtype  WKSファイルに基づいて問合せが行われます。

構文

PROCEDURE OG_Set_Querytype
  (query      OG_Query,
   querytype  NUMBER);

FUNCTION OG_Get_Querytype
  (query  OG_Query)
RETURN NUMBER;

パラメータ

query	定義中の問合せ。
querytype	問合せのタイプです。


「問合せタイプ」プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure rotates the
**query type of a query.
*/

PROCEDURE QryType (buttonobj IN og_object,

hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  qry og_query;
  num number;
BEGIN
  qry := og_get_query('query0');
  num := og_get_querytype(qry);

  if num = og_custom_qtype then
     og_set_querytype(qry, og_exsql_qtype);
  elsif num = og_exsql_qtype then
     og_set_querytype(qry, og_prn_qtype);
  elsif num = og_prn_qtype then
     og_set_querytype(qry, og_sql_qtype);
  elsif num = og_sql_qtype then
     og_set_querytype(qry, og_sylk_qtype);
   elsif num = og_sylk_qtype then
     og_set_querytype(qry, og_wks_qtype);
 elsif num = og_wks_qtype then
     og_set_querytype(qry, og_custom_qtype);
  end if;
END;


四角形プロパティ

基本四角形プロパティ


基本四角形プロパティ

  例	  関連項目

説明  四角形オブジェクトの基礎として使用する四角形の左上角のx座標とy座標、および高さと幅です（レイアウト単位）。

構文

PROCEDURE OG_Set_Rect_Baserect
  (rect         OG_Object,
   baserect     OG_Rectangle,
   damage       BOOLEAN       :=  TRUE,
   update_bbox  BOOLEAN       :=  TRUE);

FUNCTION OG_Get_Rect_Baserect
  (rect  OG_Object)
RETURN OG_Rectangle;

パラメータ

rect	定義中の四角形オブジェクト。
baserect	四角形オブジェクトの基礎として使用する四角形の左上角のx座標とy座標、
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


基本四角形プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure determines the size
**of therectangle base and doubles it.
*/

PROCEDURE baseRect IS
  rect og_rectangle;
  obj og_object;
BEGIN
  obj := og_get_object('rect');
  rect := og_get_rect_baserect(obj);
  rect.x := rect.x * 2;
  rect.y := rect.y * 2;
  rect.height := rect.height * 2;
  rect.width := rect.width * 2;
  og_set_rect_baserect(obj, rect);
END;


参照線プロパティ

軸プロパティ

日付値プロパティ

ラベル・プロパティ

数値プロパティ


軸プロパティ

  例	  関連項目

説明  参照値の基準となる軸を指定します。このプロパティには、次のビルトイン定数を指定できます。

OG_X_Axis

OG_Y1_Axis

OG_Y2_Axis

構文

PROCEDURE OG_Set_Axis
  (refline  OG_Refline,
   axis     NUMBER);

FUNCTION OG_Get_Axis
  (refline  OG_Refline)
RETURN NUMBER;

パラメータ

refline	定義中の参照線。
axis	参照値の基準となる軸を指定します。


軸プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure maps
**the reference line against the
**Y1-axis if the line is currently
**mapped againstY2-axis.
*/

PROCEDURE Axis IS
  chart og_object;
  axis number;
  refline og_refline;
  template og_template;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  refline := og_get_refline(template, 0);
  axis := og_get_axis(refline);
  if axis = og_y2_axis then
    og_set_axis(refline, og_y1_axis);
  end if;
  og_update_chart(chart);
END;


日付値プロパティ

  例	  関連項目

説明  参照線の日付値です。

構文

PROCEDURE OG_Set_Datevalue
  (refline    OG_Refline,
   datevalue  DATE);

FUNCTION OG_Get_Datevalue
  (refline  OG_Refline)
RETURN DATE;

パラメータ

refline	定義中の参照線。
datevalue	参照線の日付値。


日付値プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure increases
**reference line value by30 days.
*/

PROCEDURE DateVal IS
  chart og_object;
  dateval date;
  refline og_refline;
  template og_template;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  refline := og_get_refline(template, 0);
  dateval := og_get_datevalue(refline);
  og_set_datevalue(refline, dateval+30);
  og_update_chart(chart);
END;


ラベル・プロパティ

  例	  関連項目

説明  凡例に表示する参照線を識別するテキスト・ラベルです。

構文

PROCEDURE OG_Set_Label
  (refline  OG_Refline,
   label    VARCHAR2);

FUNCTION OG_Get_Label
  (refline  OG_Refline)
RETURN VARCHAR2;

パラメータ

refline	定義中の参照線。
label	凡例に表示する参照線を識別するテキスト・ラベル。


ラベル・プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure changes
**the reference line name to 'New Label'
**if this is not the current name of the
**label.
*/

PROCEDURE label IS
  chart og_object;
  label varchar2(20);
  refline og_refline;
  template og_template;
BEGIN
chart := og_get_object('chart');
  template := og_get_template(chart);
  refline := og_get_refline(template, 0);
  label := og_get_label(refline);
  if label != 'New Label' then
    og_set_label(refline, 'New label');
  end if;
  og_update_chart(chart);
END;


数値プロパティ

  例	  関連項目

説明  参照線の数値です。

構文

PROCEDURE OG_Set_Numvalue
  (refline   OG_Refline,
   numvalue  NUMBER);

FUNCTION OG_Get_Numvalue
  (refline  OG_Refline)
RETURN NUMBER;

パラメータ

refline	定義中の参照線。
numvalue	参照線の数値。


数値プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following procedure increases reference
**line value by500.

*/

PROCEDURE NumVal IS
  chart og_object;
  num number;
  refline og_refline;
  template og_template;
BEGIN
  chart := og_get_object('chart');
  template := og_get_template(chart);
  refline := og_get_refline(template, 0);
  num := og_get_numvalue(refline);
  og_set_numvalue(refline, num+500);
  og_update_chart(chart);
END;


丸い四角形プロパティ

基本四角形プロパティ

丸め半径プロパティ


基本四角形プロパティ

  例	  関連項目

説明  四角形オブジェクトの基礎として使用する四角形の左上角のx座標とy座標、および高さと幅です（レイアウト単位）。

構文

PROCEDURE OG_Set_Rrect_Baserect
  (rrect        OG_Object,
   baserect     OG_Rectangle,
   damage       BOOLEAN       :=  TRUE,
   update_bbox  BOOLEAN       :=  TRUE);

FUNCTION OG_Get_Rrect_Baserect
  (rrect  OG_Object)
RETURN OG_Rectangle;

パラメータ

rrect	定義中の丸い四角形。
baserect	四角形オブジェクトの基礎として使用する四角形の左上角のx座標とy座標、
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


基本四角形プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure reduces
**the size of thebase rectangle or the
**rounded rectangle.
*/

PROCEDURE baserect (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  brect og_rectangle;
  rrect og_object;
BEGIN
  rrect := og_get_object('rrect');
  brect := og_get_rrect_baserect(rrect);
  brect.x := brect.x/2;
  brect.y := brect.y/2;
  brect.height := brect.height/2;
  brect.width := brect.width/2;
  og_set_rrect_baserect(rrect, brect);
END;


丸め半径プロパティ

  例	  関連項目

説明  角を形成する弧を360度になるまで延長してできる楕円のx半径とy半径（レイアウト単位）です。

構文

PROCEDURE OG_Set_Corner
  (rrect        OG_Object,
   corner       OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Corner
  (rrect  OG_Object)
RETURN OG_Point;

パラメータ

rrect	定義中の丸い四角形。
corner	丸める角を形成する弧を360度になるまで延長してできる楕円のx半径とy半径（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


丸め半径プロパティの例

  アルファベット順リスト          [image]  すべての例     [image]  関連項目

/*The following button procedure doubles
**the x and y radiiof the ellipse used to
**create the corners of a rounded rectangle
*/

PROCEDURE corner (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  pt og_point;
  rrect og_object;
BEGIN
  rrect := og_get_object('rrect');
  pt := og_get_corner(rrect);
  pt.x := pt.x*2;
  pt.y := pt.y*2;
  og_set_corner(rrect, pt);
END;


サウンド・プロパティ

名前プロパティ


名前プロパティ

  例	  関連項目

説明  サウンドの名前です。

構文

PROCEDURE OG_Set_Name
  (sound  OG_Sound,
   name   VARCHAR2);

FUNCTION OG_Get_Name
  (sound  OG_Sound)
RETURN VARCHAR2;

パラメータ

sound	定義中のサウンド・オブジェクト。
name	サウンドの名前。


名前プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure gets the
**name of sound from the sound handler
**and assigns a new name to it.
*/

PROCEDURE SoundName (sound in og_sound) IS

name varchar2(10);

BEGIN

name := og_get_name(sound);

og_set_name(sound, name||'2');

END;


単一テキスト・プロパティ

カラー・プロパティ

フォント・プロパティ

テキスト文字列プロパティ


カラー・プロパティ

  例	  関連項目

説明  文字列のテキストの表示カラー。これはテキスト自体のカラーであることに注意してください。テキスト・オブジェクトの枠を設定したり、カラーを塗る場合には、テキスト・オブジェクトのグラフィック・プロパティを変更します。

構文

FUNCTION OG_Get_Color
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN VARCHAR2;

パラメータ

text	定義中のテキスト・オブジェクト。
cmptext_index	定義中の複数テキスト要素の索引番号。
Smptext_index	定義中の単一テキスト要素の索引番号。


カラー・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure reads the color
**of the current text object.If the
**current color is not red, it changes
**it to red.
*/

PROCEDURE color (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
color varchar2(20);
BEGIN
   color := og_get_color(hitobj, 0, 0);
   if color != 'red' then
     og_set_gcolor(hitobj, 'red');
   end if;
END;


フォント・プロパティ

  例 	  関連項目

説明  文字列のテキストの表示フォント。

構文

FUNCTION OG_Get_Font_Typeface
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN VARCHAR2;

FUNCTION OG_Get_Font_Ptsize
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

FUNCTION OG_Get_Font_Style
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

FUNCTION OG_Get_Font_Weight
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

FUNCTION OG_Get_Font_Width
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

FUNCTION OG_Get_Font_Kerning
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN BOOLEAN;

FUNCTION OG_Get_Font_Charset
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。
cmptext_index	定義中の複数テキスト要素の索引番号。
smptext_index	定義中の単一テキスト要素の索引番号。


フォント・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**current typeface from selected text
**object.If the current style is not
**the same as the typeface from argument,
**it assigns a new typeface to the
**text object.
*/

PROCEDURE fonttypeface (text og_object, typeface varchar2)IS

style varchar2(10);

BEGIN

style := og_get_font_typeface(text, 0,0);

if style != typeface then

og_set_font_typeface(text, typeface);

end if;

END;


テキスト文字列プロパティ

  例	  関連項目

説明  単一テキスト要素の実際のテキストを含む文字列。

構文

PROCEDURE OG_Set_Str
  (text         OG_Object,
   str          VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Str
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN VARCHAR2;

パラメータ

text	定義中のテキスト・オブジェクト。
str	単一テキスト要素の実際のテキストが含まれている文字列。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。
cmptext_index	定義中の複数テキスト要素の索引番号。
smptext_index	定義中の単一テキスト要素の索引番号。


テキスト文字列プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads a text string from
**a display and appends numbers to it.
*/

PROCEDURE TextString IS

text og_object;

BEGIN

text := og_get_object('text object');

og_set_str(text,og_get_str(text,0,0)||'123');

END;


記号プロパティ

中央プロパティ

索引プロパティ

記号サイズ・プロパティ


中央プロパティ

  例 [image]  関連項目

説明  記号の中央のx座標とy座標です（レイアウト単位）。

構文

PROCEDURE OG_Set_Center
  (symbol       OG_Object,
   center       OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Center
  (symbol  OG_Object)
RETURN OG_Point;

パラメータ

symbol	定義中の記号オブジェクト。
center	記号の中央のx座標とy座標（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


中央プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure moves
**the symbol from its original
**coordinate (x,y) to (x/2, y/2).
*/

PROCEDURE Center IS
  center og_point;
  symbol og_object;
BEGIN
  symbol := og_get_object('symbol');
  center := og_get_center(symbol);
  center.x := center.x/2;
  center.y := center.y/2;
  og_set_center(symbol, center);

END;


索引プロパティ

  例	  関連項目

説明  記号パレットに表示するときの記号の位置の索引（または数値）です。

構文

PROCEDURE OG_Set_Indx
  (symbol       OG_Object,
   indx         NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Indx
  (symbol  OG_Object)
RETURN NUMBER;

パラメータ

symbol	定義中の記号オブジェクト。
indx	記号パレットに表示するときの記号の位置の索引（または数値）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


索引プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure gets the
**index of an object's symbol position
**in the symbol palette, and replaces
**the current symbol with the symbol
**which has an index value equal to the
**current index value + 1.

PROCEDURE get_index IS
  sym_index number;
  symbol og_object;
BEGIN
  symbol := og_get_object('symbol');
  sym_index := og_get_indx(symbol);
  og_set_indx(symbol, sym_index+1);
END;


記号サイズ・プロパティ

  例	  関連項目

説明  記号のサイズです。このプロパティには、次のビルトイン定数を指定できます。

OG_Large_Symsize

OG_Medium_Symsize

OG_Small_Symsize

構文

PROCEDURE OG_Set_Symsize
  (symbol       OG_Object,
   symsize      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Symsize
  (symbol  OG_Object)
RETURN NUMBER;

パラメータ

symbol	定義中の記号オブジェクト。
symsize	記号のサイズ。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


記号サイズ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads a symbol's
**size.If the symbol's size is not LARGE,
**the procedure changes it to LARGE;
**if a symbol's size is LARGE, the procedure
**changes it to small.
*/

PROCEDURE get_size IS
  sym_size number;
  symbol og_object;
BEGIN
  symbol := og_get_object('symbol');
  sym_size := og_get_symsize(symbol);
  if sym_size != og_large_symsize then
     og_set_symsize(symbol, og_large_symsize);
  else
     og_set_symsize(symbol, og_small_symsize);
  end if;
END;


タイマー・プロパティ

アクティブ・プロパティ

間隔プロパティ

名前プロパティ

プロシージャ・プロパティ


アクティブ・プロパティ

  例 [image]  関連項目

説明  タイマーをアクティブにするかどうかを指定します。

構文

PROCEDURE OG_Set_Active
  (timer   OG_Timer,
   active  BOOLEAN);

FUNCTION OG_Get_Active
  (timer  OG_Timer)
RETURN BOOLEAN;

パラメータ

timer	定義中のタイマー・オブジェクト。
active	タイマーをアクティブにするかどうかを指定します。


アクティブ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following sets the timer to inactive if it
**is currently in active mode.
*/

PROCEDURE TimerActive IS

val boolean;

timer og_timer;

BEGIN

timer := og_get_timer('timer2');

val := og_get_active(timer);

if val then

og_set_active(timer, false);

end if;

END;


間隔プロパティ

  例 [image]  関連項目

説明  タイマー・プロシージャの実行間隔の秒数です。

構文

PROCEDURE OG_Set_Interval
  (timer     OG_Timer,
   interval  NUMBER);

FUNCTION OG_Get_Interval
  (timer  OG_Timer)
RETURN NUMBER;

パラメータ

timer	定義中のタイマー・オブジェクト。
interval	タイマー・プロシージャの実行間隔の秒数。


間隔プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure adds two
**seconds to the original timer
**interval.
*/

PROCEDURE TimerInterval IS

interval number;

timer og_timer;

BEGIN

timer := og_get_timer('timer2');

interval := og_get_interval(timer);

og_set_interval(timer, interval+2);

END;


名前プロパティ

  例	  関連項目

説明  タイマーの名前です。

構文

PROCEDURE OG_Set_Name
  (timer  OG_Timer,
   name   VARCHAR2);

FUNCTION OG_Get_Name
  (timer  OG_Timer)
RETURN VARCHAR2;

パラメータ

timer	定義中のタイマー・オブジェクト。
name	タイマーの名前。


名前プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure appends
**a '1' to the name of a timer.
*/

PROCEDURE TimerName IS

name varchar2(10);

timer og_timer;

BEGIN

timer := og_get_timer('timer1');

name := og_get_name(timer);

og_set_name(timer, name||'1');

END;


プロシージャ・プロパティ

  例 [image]  関連項目

説明  タイマーの起動時に実行するプロシージャの名前です。

構文

PROCEDURE OG_Set_Timerproc
  (timer      OG_Timer,
   timerproc  VARCHAR2);

FUNCTION OG_Get_Timerproc
  (timer  OG_Timer)
RETURN VARCHAR2;

パラメータ

timer	定義中のタイマー・オブジェクト。
timerproc	タイマーの起動時に実行するプロシージャの名前。


プロシージャ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure changes the
**timer procedure to "NewProc" if it is
** current timer procedure.
*/

PROCEDURE TimerProc IS

name varchar2(20);

timer og_timer;

BEGIN

timer := og_get_timer('timer2');

name := og_get_timerproc(timer);

if name != 'NewProc' then

og_set_timerproc(timer, 'NewProc');

end if;

END;


テキスト・プロパティ

バウンディング・ボックスの高さプロパティ

バウンディング・ボックスの幅プロパティ

キャラクタ・セット・プロパティ

カラー・プロパティ

複数テキスト数プロパティ

カスタム間隔プロパティ

固定バウンディング・ボックス・プロパティ

水平線文字揃えプロパティ

水平原点プロパティ

非表示プロパティ

カーニング・プロパティ

近似プロパティ

原点プロパティ

ポイント・サイズ・プロパティ

スケーラブルな境界線プロパティ

スケーラブル・フォント・プロパティ

間隔プロパティ

スタイル・プロパティ

合成プロパティ

書体プロパティ

垂直文字揃えプロパティ

垂直原点プロパティ

フォントの太さプロパティ

フォントの幅プロパティ

丸めプロパティ


バウンディング・ボックスの高さプロパティ

  例 [image]  関連項目

説明  バウンディング・ボックスの高さです（レイアウト単位）。バウンディング・ボックスを変更すると常に、このプロパティが新しい高さを反映して自動的に更新されます。このプロパティは、「固定バウンディング・ボックス」プロパティがTRUEの場合にのみ、高さを設定するために使用します。

構文

（OG_Set_Text_Sizeを参照してください。）

FUNCTION OG_Get_Text_Height
  (text  OG_Object)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。


バウンディング・ボックスの高さプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure doubles the size of the
**text object's bounding box.
*/

PROCEDURE BBoxSize IS

width number;
  height number;
  text og_object;
BEGIN
   text := og_get_object('text object');
   width := og_get_text_width(text);
   height := og_get_text_height(text);
   og_set_text_size(text, width*2, height*2);
END;


バウンディング・ボックスの幅プロパティ

  例 [image]  関連項目

説明  バウンディング・ボックスの幅です（レイアウト単位）。バウンディング・ボックスを変更すると常に、このプロパティが新しい幅を反映して自動的に更新されます。このプロパティは、「固定バウンディング・ボックス」プロパティがTRUEの場合にのみ、幅を設定するために使用します。

構文

PROCEDURE OG_Set_Text_Size
  (text         OG_Object,
   width        NUMBER,
   height       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Text_Width
  (text  OG_Object)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。
width	バウンディング・ボックスの幅（レイアウト単位）。
height	バウンディング・ボックスの高さ（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


バウンディング・ボックスの幅プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure doubles the size of the
**text object's bounding box.
*/

PROCEDURE BBoxSize IS

width number;
  height number;
  text og_object;
BEGIN
   text := og_get_object('text object');
   width := og_get_text_width(text);
   height := og_get_text_height(text);
   og_set_text_size(text, width*2, height*2);
END;


キャラクタ・セット・プロパティ

  例 [image]  関連項目

説明  フォントのキャラクタ・セットです。このフィールドの値には、U.S. ASCII、漢字、アラビア文字などのキャラクタ・セットを指定します。すべてのキャラクタ・セットをすべてのシステムで使用できるわけではありません。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。このフィールドには、次のビルトイン定数を指定できます。

OG_Us7ascii_Charset

OG_We8dec_Charset

OG_We8hp_Charset

OG_Us8pc437_Charset

OG_We8ebcdic37_Charset

OG_We8ebcdic500_Charset

OG_We8pc850_Charset

OG_D7dec_Charset

OG_F7dec_Charset

OG_S7dec_Charset

OG_E7dec_Charset

OG_Sf7ascii_Charset

OG_Ndk7dec_Charset

OG_I7dec_Charset

OG_Nl7dec_Charset

OG_Ch7dec_Charset

OG_Sf7dec_Charset

OG_We8iso8859p1_Charset

OG_Ee8iso8859p2_Charset

OG_Se8iso8859p3_Charset

OG_Nee8iso8859p4_Charset

OG_Cl8iso8859p5_Charset

OG_Ar8iso8859p6_Charset

OG_El8iso8859p7_Charset

OG_Iw8iso8859p8_Charset

OG_We8iso8859p9_Charset

OG_Ar8asmo708plus_Charset

OG_Ar7asmo449plus_Charset

OG_We8macroman8_Charset

OG_Jvms_Charset

OG_Jeuc_Charset

OG_Jdec_Charset

OG_Sjis_Charset

OG_Jdbcs_Charset

OG_Jhp_Charset

OG_Ksc5601_Charset

OG_Kibm5540_Charset

OG_Kdbcs_Charset

OG_Cgb231380_Charset

OG_Cdbcs_Charset

OG_Big5_Charset

OG_Cns1164386_Charset

構文

PROCEDURE OG_Set_Font_Charset
  (text         OG_Object,
   charset      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
charset	フォントのキャラクタ・セット。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


キャラクタ・セット・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following button procedure checks
**if the selected text object's font set
**is in US ASCII Character Set.If not,
**it assigns ASCII Character Set to the object.
*/

PROCEDURE CharSet (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
setNo number;
BEGIN

     SetNo := OG_get_Font_charset(hitobj,0,0);
     if SetNo != og_US7ASCII_Charset then
        og_set_font_charset(hitobj, og_US7ASCII_charset);
     end if;
END;


カラー・プロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクトのカラーです。

構文

PROCEDURE OG_Set_Gcolor
  (text         OG_Object,
   gcolor       VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
gcolor	テキスト・オブジェクトのカラー。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


カラー・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads
** the color of the current text object.
**If the current color is not red,
**it changes it to red.
*/

PROCEDURE color (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
color varchar2(20);
BEGIN
   color := og_get_color(hitobj, 0, 0);
   if color != 'red' then
     og_set_gcolor(hitobj, 'red');
   end if;
END;


複数テキスト数プロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクトを構成するテキスト要素の数です。

構文

FUNCTION OG_Get_Ctcount
  (text  OG_Object)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。


複数テキスト数プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure counts the number of
**compound text elements in a text object.
/*

PROCEDURE CompoundTextCnt IS
  num number;
  text og_object;

BEGIN
  text := og_get_object;
  num := og_get_ctcount(text);
END;


カスタム間隔プロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクトのカスタム間隔です（レイアウト単位）。このプロパティは、「間隔」プロパティがカスタム間隔に設定されている場合にのみ、間隔を指定するために使用します。

構文

PROCEDURE OG_Set_Custom
  (text         OG_Object,
   custom       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Custom
  (text  OG_Object)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。
custom	テキスト・オブジェクトのカスタム間隔（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


カスタム間隔プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure resets the
**custom spacing to twice its original setting.
*/

PROCEDURE CustomSpacing (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
num number;
BEGIN
   num := og_get_custom(hitobj);
   og_set_str(hitobj, 'abc'||num);
   og_set_custom(hitobj, num*2);
END;


固定バウンディング・ボックス・プロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクトのバウンディング・ボックスを固定サイズのままにするかどうかを指定します。このプロパティをTRUEに設定した場合は、「幅」プロパティと「高さ」プロパティの値によってバウンディング・ボックスのサイズが変更されます。

構文

PROCEDURE OG_Set_Fixed
  (text         OG_Object,
   fixed        BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Fixed
  (text  OG_Object)
RETURN BOOLEAN;

パラメータ

text	定義中のテキスト・オブジェクト。
fixed	テキスト・オブジェクトのバウンディング・ボックスを固定サイズのままにするかどうかを指定します。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


固定バウンディング・ボックス・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if the text object's bounding box
**remains a fixed size.
*/

PROCEDURE FixBBox IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('text object');
   val := og_get_fixed(text);
   if val  then
      og_set_fixed(text, false);
   else
      og_set_fixed(text, true);
   end if;
END;


水平文字揃えプロパティ

  例	  関連項目

説明  テキスト・オブジェクトの水平文字揃えです。このプロパティには、次のビルトイン定数を指定できます。

OG_Left_Halign

OG_Center_Halign

OG_Right_Halign

構文

PROCEDURE OG_Set_Halign
  (text         OG_Object,
   halign       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Halign
  (text  OG_Object)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。
halign	テキスト・オブジェクトの水平文字揃え。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


水平文字揃えプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

水平文字揃え

/*The following procedure reads the horizontal
**alignment and readjusts it.
*/

PROCEDURE Halign IS
  num number:=og_right_halign;
  text og_object;
BEGIN
   text := og_get_object('text object');
   num := og_get_halign(text);
   if num = og_left_halign then
     og_set_halign(text, og_center_halign);
   elsif num = og_center_halign then
     og_set_halign(text, og_right_halign);
   elsif num = og_right_halign then
     og_set_halign(text, og_left_halign);
   end if;
END;


水平原点プロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクトの原点に対する水平位置です。このプロパティには、次のビルトイン定数を指定できます。

OG_Left_Horigin   バウンディング・ボックスの左枠を原点とします。

OG_Center_Horigin   バウンディング・ボックスの左枠と右枠の中央を原点とします。

OG_Right_Horigin   バウンディング・ボックスの右枠を原点とします。

構文

PROCEDURE OG_Set_Horigin
  (text         OG_Object,
   horigin      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Horigin
  (text  OG_Object)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。
horigin	原点に対するテキスト・オブジェクトの水平位置。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


水平原点プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the horizontal
**origin and readjusts it.
*/

PROCEDURE Horigin IS

num number;

text og_object;

BEGIN

text := og_get_object('text object');
   num := og_get_horigin(text);
   if num = og_left_horigin then
     og_set_horigin(text, og_center_horigin);
   elsif num = og_center_horigin then
     og_set_horigin(text, og_rightr_horigin);
   elsif num = og_right_horigin then
     og_set_horigin(text, og_left_horigin);
   end if;
END;


非表示プロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクト内のテキストを表示しないようにするかどうかを指定します。これは、パスワードを見せたくない場合に、パスワードを入力するテキスト・フィールドに指定すると便利です。

構文

PROCEDURE OG_Set_Invisible
  (text       OG_Object,
   invisible  BOOLEAN,
   damage         BOOLEAN    :=  TRUE,
   update_bbox    BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Invisible
  (text  OG_Object)
RETURN BOOLEAN;

パラメータ

text	定義中のテキスト・オブジェクト。
invisible	テキスト・オブジェクト内のテキストを表示しないようにするかどうかを指定します。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


非表示プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure determines if
** text in a text object is invisible.If it
** is invisible it makes it visible; if it is
** visible it makes it invisible.
*/

PROCEDURE Invisible IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('text object');
   val := og_get_invisible(text);
   if val  then
      og_set_invisible(text, false);
   else
      og_set_invisible(text, true);
   end if;
END;


カーニング・プロパティ

  例 [image]  関連項目

説明  フォントをカーニングするかどうかを指定します。カーニングとは、テキストを読みやすくするために、隣接する文字間の空白を調整することです。

構文

PROCEDURE OG_Set_Font_Kerning
  (text         OG_Object,
   kerning      BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
kerning	フォントをカーニングするかどうかを指定します。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


カーニング・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following button procedure turns font
**kerning on and off for a selected text object.

PROCEDURE kerning (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  val boolean;
BEGIN
  val := og_get_font_kerning(hitobj,0,0);
  if val then
     og_set_font_kerning(hitobj, false);
  else
     og_set_font_kerning(hitobj, true);
  end if;
END;


近似プロパティ

  例 [image]  関連項目

説明  指定したフォントが見つからない場合に、Graphics Builderによってそれに最も近いフォントが代用されるようにするかどうかを指定します。近似フォントを見つけるときの優先順位は、書体、サイズ、スタイル、フォントの太さ、幅の順です（つまり、Graphics Builderによって、まず指定された書体が検索され、次にサイズが検索され、という順番で検索されていきます）。

構文

PROCEDURE OG_Set_Font_Nearest
  (text         OG_Object,
   nearest      BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
nearest	指定したフォントが見つからない場合に、Graphics Builderによってそれに最も近いフォントが代用されるようにするかどうかを指定します。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


近似プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following button procedure sets nearest
**properties to true.
*/

/*The following button procedure sets nearest
**properties to true. PROCEDURE nearest (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS

BEGIN
     OG_Set_Font_Nearest(hitobj, true);
END;


原点プロパティ

  関連項目

説明  テキスト・オブジェクトの左上角のx座標とy座標です（レイアウト単位）。

構文

PROCEDURE OG_Set_Origin
  (text         OG_Object,
   origin       OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Origin
  (text  OG_Object)
RETURN OG_Point;

パラメータ

text	定義中のテキスト・オブジェクト。
origin	テキスト・オブジェクトの左上角のx座標とy座標です（レイアウト単位）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


ポイント・サイズ・プロパティ

  例 [image]  関連項目

説明  フォントのサイズです。このフィールドの値はシステムによって異なります。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。

構文

PROCEDURE OG_Set_Font_Ptsize
  (text         OG_Object,
   ptsize       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
ptsize	フォントのサイズ。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


ポイント・サイズ・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the point size of the
**current object and enlarges the text object to double
** its original size.
*/

PROCEDURE ptsize (text og_object)IS
num number;
BEGIN
  num := og_get_font_ptsize(text,0,0);
  og_set_font_ptsize(text, num*2);
END;


スケーラブルな境界線プロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクトをスケーリングするときにテキスト・オブジェクトの境界線もスケーリングするかどうかを指定します。

構文

PROCEDURE OG_Set_Bbscale
  (text         OG_Object,
   bbscale      BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Bbscale
  (text  OG_Object)
RETURN BOOLEAN;

パラメータ

text	定義中のテキスト・オブジェクト。
bbscale	テキスト・オブジェクトをスケーリングするときにテキスト・オブジェクトの境界線もスケーリングするかどうかを指定します。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


スケーラブルな境界線プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if the text
**object's bounding box is scaled when the
**text object is scaled.
*/

PROCEDURE Scalebox IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('text object');
   val := og_get_bbscale(text);
   if val  then
      og_set_bbscale(text, false);
   else
      og_set_bbscale(text, true);
   end if;
END;


スケーラブル・フォント・プロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクトをスケーリングするときにフォントのサイズもスケーリングするかどうかを指定します。このプロパティには、次のいずれかを指定できます。

構文

PROCEDURE OG_Set_Fontscale
  (text         OG_Object,
   fontscale    BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Fontscale
  (text  OG_Object)
RETURN BOOLEAN;

パラメータ

text	定義中のテキスト・オブジェクト。
fontscale	テキスト・オブジェクトをスケーリングするときにフォントのサイズもスケーリングするかどうかを指定します。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


スケーラブル・フォント・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure checks if the point size is
**scaled when the text object is scaled.
*/

PROCEDURE Scalable IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('text object');
   val := og_get_fontscale(text);
   if val  then
      og_set_fontscale(text, false);
   else
      og_set_fontscale(text, true);
   end if;
END;


間隔プロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクトの行間隔です。このプロパティには、下記のビルトイン定数を指定できます。カスタム間隔を設定する場合は、「カスタム間隔」プロパティの値で間隔を指定する必要があります。

OG_Single_Space

OG_Onehalf_Space

OG_Double_Space

OG_Custom_Space   テキストにカスタム行間隔が使用されます。実際に使用する間隔は、「カスタム間隔」プロパティで定義します。

構文

PROCEDURE OG_Set_Spacing
  (text         OG_Object,
   spacing      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Spacing
  (text  OG_Object)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。
spacing	テキスト・オブジェクトの行間隔。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


間隔プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following button procedure
**rotates the spacing setting of a
**text object.
*/

/* The following button procedure
**rotates the spacing setting of a
**text object. PROCEDURE Spacing (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
num number;
BEGIN
   num := og_get_spacing(hitobj);
   if num = og_single_space then
      og_set_spacing(hitobj, og_onehalf_space);
   elsif num = og_onehalf_space then
   og_set_spacing(hitobj, og_double_space);
   elsif num = og_double_space then
   og_set_spacing(hitobj, og_custom_space);
   elsif num = og_custom_space then
   og_set_spacing(hitobj, og_single_space);
   end if;
END;


スタイル・プロパティ

  例 [image]  関連項目

説明  フォントのスタイルです。すべてのスタイルをすべてのシステムで使用できるわけではありません。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。このフィールドには、次のビルトイン定数を指定できます。

OG_Blink_Fontstyle

OG_Inverted_Fontstyle

OG_Italic_Fontstyle

OG_Oblique_Fontstyle

OG_Outline_Fontstyle

OG_Overstrike_Fontstyle

OG_Plain_Fontstyle

OG_Shadow_Fontstyle

OG_Underline_Fontstyle

OG_Unknown_Fontstyle   スタイルが不明であることを意味します。スタイルをこの値に設定できません。ただし、フォントを取得したときに、Graphics Builderによってそのフォント・スタイルが判別されない場合は、この値が戻されます。

構文

PROCEDURE OG_Set_Font_Style
  (text         OG_Object,
   style        NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
style	フォントのスタイル。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


スタイル・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following button procedure
**rotates the text style
*/

/*The following button procedure
**rotates the text style
*/ PROCEDURE style (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
text og_object;
num number;
BEGIN
  text := og_get_object('text object');
  num := og_get_font_style(text,0,0);
  if num = og_blink_fontstyle then
    og_set_font_style(text, og_inverted_fontstyle);
  elsif num = og_inverted_fontstyle then
    og_set_font_style(text, og_italic_fontstyle);
  elsif num = og_italic_fontstyle then
    og_set_font_style(text, og_oblique_fontstyle);
  elsif num = og_oblique_fontstyle then
    og_set_font_style(text, og_outline_fontstyle);
  elsif num = og_outline_fontstyle then
    og_set_font_style(text, og_overstrike_fontstyle);
  elsif num = og_overstrike_fontstyle then
    og_set_font_style(text, og_plain_fontstyle);
  elsif num = og_plain_fontstyle then
    og_set_font_style(text, og_shadow_fontstyle);
  elsif num = og_shadow_fontstyle then
    og_set_font_style(text, og_underline_fontstyle);
  elsif num = og_underline_fontstyle then
    og_set_font_style(text, og_unknown_fontstyle);
  elsif num = og_unknown_fontstyle then
    og_set_font_style(text, og_blink_fontstyle);
  end if;
END;


合成プロパティ

  例 [image]  関連項目

説明  指定したフォントが見つからない場合、Graphics Builderによって近似フォントを変形させて指定フォントを合成するかどうかを指定します。

構文

PROCEDURE OG_Set_Font_Synthesize
  (text         OG_Object,
   synthesize   BOOLEAN,
   damage       BOOLEAN  :=  TRUE,
   update_bbox  BOOLEAN  :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
synthesize	指定したフォントが見つからない場合、 Graphics Builderによって近似フォントを変形させて指定フォントを合成するかどうかを指定します。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


合成プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following button procedure sets synthesize
** properties to true.
*/

/*The following button procedure sets synthesize
**properties to true. PROCEDURE synthesize (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS

BEGIN
     OG_Set_Font_Synthesize(hitobj, true);
END;


書体プロパティ

  例 [image]  関連項目

説明  フォントの書体（フォント名）です。このフィールドの値はシステムによって異なり、times、courierおよびhelveticaなどの書体が含まれていることがあります。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。

構文

PROCEDURE OG_Set_Font_Typeface
  (text         OG_Object,
   typeface     VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
typeface	フォントの書体（フォント名）。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


書体プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**current typeface from selected text
**object.If the current style is not
**the same as the typeface from argument,
**it assigns a new typeface to the text
**object.

PROCEDURE fonttypeface (text og_object, typeface varchar2)IS
style varchar2(10);
BEGIN
  style := og_get_font_typeface(text, 0,0);
  if style != typeface then
    og_set_font_typeface(text, typeface);
  end if;
END;


垂直文字揃えプロパティ

  例 [image]  関連項目

説明  テキスト・オブジェクトの垂直文字揃えです。このプロパティには、次のビルトイン定数を指定できます。

OG_Top_Valign

OG_Middle_Valign

OG_Bottom_Valign

構文

PROCEDURE OG_Set_Valign
  (text         OG_Object,
   valign       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Valign
  (text  OG_Object)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。
valign	テキスト・オブジェクトの垂直文字揃え。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


垂直文字揃えプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* The following procedure reads the vertical
** alignment and readjusts it.
*/

PROCEDURE VAligin IS
  num number;
  text og_object;
BEGIN
   text := og_get_object('text object');
   num := og_get_valign(text);
   if num = og_top_valign then
     og_set_valign(text, og_middle_valign);
   elsif num = og_middle_valign then
     og_set_valign(text, og_bottom_valign);
   elsif num = og_bottom_valign then
     og_set_valign(text, og_top_valign);
   end if;
END;


垂直原点プロパティ

  例 [image]  関連項目

説明  原点に対するテキスト・オブジェクトの垂直位置です。このプロパティには、次のビルトイン定数を指定できます。

OG_Top_Vorigin   バウンディング・ボックスの上枠を原点とします。

OG_Middle_Vorigin   バウンディング・ボックスの上下枠の中央を原点とします。

OG_Bottom_Vorigin   バウンディング・ボックスの下枠を原点とします。

構文

PROCEDURE OG_Set_Vorigin
  (text         OG_Object,
   vorigin      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Vorigin
  (text  OG_Object)
RETURN NUMBER;

パラメータ

text	定義中のテキスト・オブジェクト。
vorigin	原点に対するテキスト・オブジェクト の垂直位置。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


垂直原点プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure reads the
**vertical origin and readjusts it.
*/

PROCEDURE Vorigin IS
  num number;
  text og_object;
BEGIN
   text := og_get_object('text object');
   num := og_get_vorigin(text);
   if num = og_top_vorigin then
     og_set_vorigin(text, og_middle_vorigin);
   elsif num = og_middle_vorigin then
     og_set_vorigin(text, og_bottom_vorigin);
   elsif num = og_bottom_vorigin then
     og_set_vorigin(text, og_top_vorigin);
   end if;
END;


フォントの太さプロパティ

  例 [image]  関連項目

説明  フォントの太さです。すべての太さをすべてのシステムで使用できるわけではありません。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。このフィールドには、次のビルトイン定数を指定できます。

OG_Bold_Fontweight

OG_Demibold_Fontweight

OG_Demilight_Fontweight

OG_Extrabold_Fontweight

OG_Extralight_Fontweight

OG_Light_Fontweight

OG_Medium_Fontweight

OG_Ultrabold_Fontweight

OG_Ultralight_Fontweight

OG_Unknown_Fontweight   フォントの太さが不明であることを意味します。フォントの太さをこの値に設定できません。ただし、フォントを取得したときに、Graphics Builderによってその太さが判別されない場合は、この値が戻されます。

構文

PROCEDURE OG_Set_Font_Weight
  (text         OG_Object,
   weight       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
weight	フォントの太さ。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


フォントの太さプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following button procedure
**rotates the font weight for a
**selected text object.
*/

/*The following button procedure
**rotates the font weight for a
**selected text object. PROCEDURE weight (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
  text og_object;
BEGIN
  text := og_get_object('text object');
  num := og_get_font_weight(text,0,0);
  if num = og_bold_fontweight then
    og_set_font_weight(text, og_demibold_fontweight);
  elsif num = og_demibold_fontweight then
    og_set_font_weight(text, og_demilight_fontweight);
  elsif num = og_demilight_fontweight then
    og_set_font_weight(text, og_extrabold_fontweight);
  elsif num = og_extrabold_fontweight then
    og_set_font_weight(text, og_extralight_fontweight);
  elsif num = og_extralight_fontweight then
    og_set_font_weight(text, og_light_fontweight);
  elsif num = og_light_fontweight then
    og_set_font_weight(text, og_medium_fontweight);
  elsif num = og_medium_fontweight then
    og_set_font_weight(text, og_ultrabold_fontweight);
  elsif num = og_ultrabold_fontweight then
    og_set_font_weight(text, og_ultralight_fontweight);
  elsif num = og_ultralight_fontweight then
    og_set_font_weight(text, og_unknown_fontweight);
  elsif num = og_unknown_fontweight then
    og_set_font_weight(text, og_bold_fontweight);
  end if;
END;


フォントの幅プロパティ

  例 [image]  関連項目

説明  フォントの幅です。すべての幅をすべてのシステムで使用できるわけではありません。詳細は、システム管理者に問い合せるか、またはシステムのマニュアルを参照してください。このフィールドには、次のビルトイン定数を指定できます。

OG_Dense_Fontwidth

OG_Expand_Fontwidth

OG_Extradense_Fontwidth

OG_Extraexpand_Fontwidth

OG_Normal_Fontwidth

OG_Semidense_Fontwidth

OG_Semiexpand_Fontwidth

OG_Ultradense_Fontwidth

OG_Ultraexpand_Fontwidth

OG_Unknown_Fontwidth   幅が不明であることを意味します。フォントの幅をこの値に設定できません。 ただし、フォントを取得したときに、Graphics Builderによってその幅が判別されない場合は、この値が戻されます。

構文

PROCEDURE OG_Set_Font_Width
  (text         OG_Object,
   width        NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

パラメータ

text	定義中のテキスト・オブジェクト。
width	フォントの幅。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


フォントの幅プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following button procedure
**rotates the font width for a
**selected test object.
*/

/*The following button procedure
**rotates the font width for a
**selected test object. PROCEDURE width (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
  text og_object;
BEGIN
  text := og_get_object('text object');
  num := og_get_font_width(text,0,0);
  if num = og_dense_fontwidth then
    og_set_font_width(text, og_expand_fontwidth);
  elsif num = og_expand_fontwidth then
    og_set_font_width(text, og_extradense_fontwidth);
  elsif num = og_extradense_fontwidth then
    og_set_font_width(text, og_extraexpand_fontwidth);
  elsif num = og_extraexpand_fontwidth then
    og_set_font_width(text, og_normal_fontwidth);
  elsif num = og_normal_fontwidth then
    og_set_font_width(text, og_semidense_fontwidth);
  elsif num = og_semidense_fontwidth then
    og_set_font_width(text, og_semiexpand_fontwidth);
  elsif num = og_semiexpand_fontwidth then
    og_set_font_width(text, og_ultradense_fontwidth);
  elsif num = og_ultradense_fontwidth then
    og_set_font_width(text, og_ultraexpand_fontwidth);
  elsif num = og_ultraexpand_fontwidth then
    og_set_font_width(text, og_unknown_fontwidth);
  elsif num = og_unknown_fontwidth then
    og_set_font_width(text, og_dense_fontwidth);
  end if;
END;


丸めプロパティ

  例 [image]  関連項目

説明  テキストを、テキスト・オブジェクトのバウンディング・ボックスに収まるように「ラップ（改行）」するかどうかを指定します。複数テキスト要素はテキストの行を表し、単一テキスト要素から構成されます。

構文

PROCEDURE OG_Set_Wrap
  (text         OG_Object,
   wrap         BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Wrap
  (text  OG_Object)
RETURN BOOLEAN;

パラメータ

text	定義中のテキスト・オブジェクト。
wrap	テキストを、テキスト・オブジェクトのバウンディング・ボックスに収まるように「ラップ（改行）」するかどうかを指定します。
damage	ダメージ・フラグ。
update_bbox	バウンディング・ボックス更新フラグ。


丸めプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure checks if the text is 'wrapped'
** into the text's bounding box.
*/

PROCEDURE wrap IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('text object');
   val := og_get_wrap(text);
   if val  then
      og_set_wrap(text, false);
   else
      og_set_wrap(text, true);
   end if;
END;


この文字で始まる項目はありません。


ウィンドウ・プロパティ

説明

ウィンドウの位置とサイズは、「画面解像度単位」、つまり一般的にピクセルと呼ばれる単位で表します。画面解像度の水平値と垂直値を取得するには、ビルトインOG_Get_Ap_Hscreen_ResおよびOG_Get_Ap_Vscreen_Resを使用します。

実際の数値ではなく、これらのビルトインを使用することにより、アプリケーションでは、画面解像度の異なるシステムで一貫性のある表示が維持されます。

高さプロパティ

ヘルプ・ターゲット・プロパティ

名前プロパティ

位置プロパティ

幅プロパティ


高さプロパティ

  例	  関連項目

説明  ウィンドウの高さです（画面解像度単位）。

構文

（OG_Set_Window_Sizeを参照してください。）

FUNCTION OG_Get_Window_Height
  (window  OG_Window)
RETURN NUMBER;

パラメータ

window	定義中のウィンドウ。


高さプロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/* /*The following procedure resizes
**the window to half itsoriginal size.
*/

PROCEDURE WinSize IS
  window og_window;
  width number;
  height number;
BEGIN
  window := og_get_window('Main Layout');
  width := og_get_window_width(window);
  height := og_get_window_height(window);
  og_set_window_size(window, width/2,height/2);
END;


ヘルプ・ターゲット・プロパティ

  例	  関連項目

説明  ウィンドウがアクティブの間に「ヘルプ・システム」を起動したときに表示される、ランタイム・ヘルプ内のハイパーテキスト・ターゲットです。

構文

PROCEDURE OG_Set_Helptarget
  (window      OG_Window,
   helptarget  VARCHAR2);

FUNCTION OG_Get_Helptarget
  (window  OG_Window)
RETURN VARCHAR2;

パラメータ

window	定義中のウィンドウ。
helptarget	ウィンドウがアクティブの間に「ヘルプ・システム」を起動した時に表示される、ランタイム・ヘルプ内のハイパーテキスト・ターゲット。


ヘルプ・ターゲット・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure sets the help
**target to 'NewTarget' if "New Target" is not
** the current helptarget.
*/

PROCEDURE Help IS
  window og_window;
  help varchar2(20);
BEGIN
  window := og_get_window('Main Layout');
  help :=  og_get_helptarget(window);
  if help != 'NewTarget' then
    og_set_helptarget(window, 'NewTarget');
  end if;
END;


名前プロパティ

  例 [image]  関連項目

説明  ウィンドウの名前です。実行時には、レイアウト・ウィンドウのデフォルト名が「Main Layout」となります。

構文

PROCEDURE OG_Set_Name
  (window  OG_Window,
   name    VARCHAR2);

FUNCTION OG_Get_Name
  (window  OG_Window)
RETURN VARCHAR2;

パラメータ

window	定義中のウィンドウ。
name	ウィンドウの名前。


名前プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure resets
**the name of the window ifits name
**is not 'Main Layout'.
*/

PROCEDURE Name IS
  window og_window;
  name varchar2(20);
BEGIN
  window := og_get_window('Main Layout');
  name :=  og_get_name(window);
  if name != 'Main Layout' then
    og_set_name(window, 'Main Layout');
  end if;
END;


位置プロパティ

  例	  関連項目

説明  ウィンドウの左上角のx座標とy座標です（画面解像度単位）。

構文

PROCEDURE OG_Set_Position
  (window    OG_Window,
   position  OG_Point);

FUNCTION OG_Get_Position
  (window  OG_Window)
RETURN OG_Point;

パラメータ

window	定義中のウィンドウ。
position	ウィンドウの左上角のx座標とy座標 （画面解像度単位）。


位置プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure repositions
**the window.
*/

/*The following procedure repositions
**the window. PROCEDURE Position IS
  window og_window;
  pos og_point;
BEGIN
  window := og_get_window('Main Layout');
  pos := og_get_position(window);
  pos.x := pos.x*2;
  pos.y := pos.y*2;
  og_set_position(window, pos);
END;


幅プロパティ

  例 [image]  関連項目

説明  ウィンドウの幅です（画面解像度単位）。

構文

PROCEDURE OG_Set_Window_Size
  (window  OG_Window,
   width   NUMBER,
   height  NUMBER);

FUNCTION OG_Get_Window_Width
  (window  OG_Window)
RETURN NUMBER;

パラメータ

window	定義中のウィンドウ。
width	ウィンドウの幅（画面解像度単位）。
height	ウィンドウの高さ（画面解像度単位）。


幅プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

/*The following procedure resizes the window
** to half itsoriginal size.
*/

PROCEDURE WinSize IS
  window og_window;
  width number;
  height number;
BEGIN
  window := og_get_window('Main Layout');
  width := og_get_window_width(window);
  height := og_get_window_height(window);
  og_set_window_size(window, width/2,height/2);
END;


 トラブルシューティング

ここでは、エラー・メッセージと例外の処理方法を番号順にリストにして説明します。内容は次の項目で構成されています。

異常な状態

Graphics Builderのエラー・メッセージ

Graphics Builderの例外

エラー・メッセージ・コード

サポート担当への連絡


Graphics Builderのエラー・メッセージ

このセクションでは、Graphics Builderのエラー・メッセージについて説明します。エラー・コードの番号順にエラーをリストします。

OG-00001:	バッチ・コンパイル・エラーが発生しました。

原因:	「PL/SQLデバッガ」で図表を実行しようとしましたが、図表のプログラム単位のバッチ・コンパイル中にGraphics Builderでエラーが検出されました。

処置:	コンパイルを実行して、記述されているPL/SQLエラーを解決してください。

OG-00002:	ボタン・プロシージャが見つかりません。

原因:	ボタン・プロシージャをオブジェクトまたはレイヤーと関連付けようとしましたが、Graphics Builderでその名前のプロシージャは検出されませんでした。

処置:	プロシージャが存在しない場合は、作成してください。またプロシージャ名を正しく入力したか確認してください。

OG-00005:	プログラム単位で一貫性エラーが発生しました。

原因:	一貫性エラーのある図表を実行しようとしました。

処置:	一貫性チェックを行ってください。その後、記述されるエラーを解決してください。

OG-00006:	パラメータの切捨てが発生しました。

原因:	2000バイトを超える値をCHAR型のパラメータに割り当てました。

処置:	CHAR型パラメータの最大長は2000バイトです。

OG-00030:	プログラム単位の指定が無効です。

原因:	不正なプログラム単位を適用しようとしました。

処置:	正しいヘッダーを挿入して、もう一度やり直してください。

OG-00032:	PL/SQLプログラム単位名が重複しています。

原因:	すでに存在するプログラム単位と同じ名前のプログラム単位を作成しようとしました。

処置:	プログラム単位の名前を他と重複しないようにしてください。

OG-00057:	トリガー・プロシージャが見つかりません。

原因:	プロシージャをトリガーと関連付けましたが、Graphics Builderでこの名前のプロシージャは検出されませんでした。

処置:	プロシージャが存在しない場合は、作成してください。またプロシージャ名を正しく入力したか確認してください。

OG-00064:	プログラム単位のパラメータ取出しに失敗しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00066:	PL/SQLのデータベース接続に失敗しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00068:	PL/SQL連結ライブラリの保存に失敗しました。

原因:	連結するPL/SQLライブラリのリストを保存しようとしているときに、Graphics Builderでエラーが発生しました。

処置:	データベースに保存する場合、Graphics Builderの表が正しくインストールされていることを確認してください。ファイルに保存する場合は、書込み権限を持っていること、ディスク容量が不足していないこと、ファイルを書き込めない状況が他に存在していないことなどを確認してください。

OG-00069:	PL/SQL連結ライブラリのロードに失敗しました。

原因:	連結するPL/SQLライブラリをロードしようとしているときに、Graphics Builderでエラーが発生しました。

処置:	データベースからロードする場合、Graphics Builderの表が正しくインストールされていることを確認してください。ファイルからロードする場合は、読込み権限および問題のライブラリにアクセスしているか（たとえばライブラリが現行のディレクトリまたはORAPLSQLLOADPATH環境変数で指定したディレクトリにある）、ファイルを読み込めない状況が他に存在していないかなど確認してください。

OG-00070:	PL/SQL連結ライブラリの削除に失敗しました。

原因:	連結するPL/SQLライブラリを削除しようとしているときに、Graphics Builderでエラーが発生しました。

処置:	Graphics Builderの表が正しくインストールされているか確認してください。

OG-00071:	図表は未コンパイル・プログラム単位を含んでいます。

原因:	コンパイルされていないプログラム単位が含まれている図表を実行しようとしました。

処置:	すべてのプログラム単位をコンパイルして、実行する前に図表を保存または生成してください。

OG-00072:	プログラム単位のロードに失敗しました。

原因:	プログラム単位をロードしようとしているときに、Graphics Builderでエラーが発生しました。

処置:	プログラム単位で参照される、すべてのデータベース表または別のプログラム単位がアクセス可能であるか確認してください。 また、Graphics Builderの表が正しくインストールされているか確認してください。

OG-00076:	1つ以上のPL/SQLプログラム単位が大きすぎてコード化できません。

原因:	保存しようとした図表のなかに最大連続メモリー・サイズを超えたプログラム単位が含まれていました。

処置:	超過しているプログラム単位を小さく分割してください。ユーザーのシステム上のメモリー制限の詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

OG-00078:	ブレークポイントを作成できません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00079:	ランタイム・シミュレーションが終了しました。

原因:	ランタイム・シミュレーションが開始される前に、操作を取り消しました。

OG-00077:	1つ以上のPL/SQLプログラム単位が大きすぎてデコードできません。

原因:	オープンしようとした図表のなかに最大連続メモリー・サイズを超えるプログラム単位が含まれています。

処置:	図表を作成したシステム上でオープンして、超過しているプログラム単位を小さく分割してください。ユーザーのシステム上のメモリー制限の詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

OG-00401:	タイマー名が指定されていません。

原因:	「タイマー・トリガー」ダイアログ・ボックスで名前を変更しようとしましたが、「名前」テキスト・フィールドに名前が入力されていません。

処置:	「改名」テキスト・フィールドに名前を入力するか、そのタイマーを削除してください。

OG-00402:	指定したタイマー名が重複しています。

原因:	「タイマー・トリガー」ダイアログ・ボックスで名前を変更しようとしましたが、入力したタイマーの名前が他のタイマーと同じものになっています。

処置:	「名前」テキスト・フィールドには、他と重複しないタイマー名を入力してください。

OG-00403:	指定モジュール名が重複しています。

原因:	Graphics Builderの1つのセッションで次のうちいずれかを試みました。

A.	Builderですでにオープンしている図表をBuilderの中でオープンすること。

B.	ランタイム・シミュレーションですでにオープンしている図表をランタイム・シミュレーションの中でオープンすること。

C.	「ランタイム」実行ファイルですでにオープンしている図表を「ランタイム」実行ファイルの中でオープンすること。

処置:	Graphics Builderの1つのセッションでは、「オープン」操作は特定の図表で1度しか行えません。

OG-00406:	サウンド名が指定されていません。

原因:	「サウンド」ダイアログ・ボックスで名前を変更しようとしましたが、「名前」テキスト・フィールドに名前が入力されていません。

処置:	「名前」テキスト・フィールドに名前を入力するか、そのサウンドを削除してください。

OG-00407:	サウンド名が重複しています。

原因:	「サウンド」ダイアログ・ボックスで名前を変更しようとしましたが、入力したサウンドの名前が他のサウンド名と同じです。

処置:	「名前」テキスト・フィールドには、他と重複しない名前を入力してください。

OG-00408:	タイマー間隔に0が指定されています。

原因:	「タイマー・トリガー」ダイアログ・ボックスで間隔を変更しようとしましたが、選択したタイマーの間隔が0分0秒に設定されています。

処置:	「間隔」テキスト・フィールドに正しい数字を入力するか、そのタイマーを削除してください。

OG-00409:	タイマー用に指定されたプロシージャがありません。

原因:	「タイマー・トリガー」ダイアログ・ボックスでプロシージャを変更しようとしましたが、「プロシージャ」テキスト・フィールドに選択したタイマーのトリガー・プロシージャが空白です。

処置:	「プロシージャ」テキスト・フィールドにPL/SQLトリガー・プロシージャの名前を入力するか、そのタイマーを削除してください。

OG-00410:	タイマーを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00411:	Graphics Builderの図表が見つかりません。

原因:	ランタイム・シミュレーションからBuilderへプログラム単位をマージしようとしましたが、Builderの図表は検索されませんでした。

処置:	Builderの図表がオープンされていること、およびそれを実行してから名前が変更されていないことを確認してください。

OG-00412:	2ノード以上選択されています。

原因:	オブジェクト・ナビゲータ内で複数のノードを選択した後で、1つのノードのみを必要とする操作を行おうとしました。

処置:	ノードを1つのみ選択し、もう一度やり直してください。

OG-00413:	図表が選択されていません。

原因:	図表が必要な操作を行おうとしましたが、図表を選択していません。

処置:	図表を選択し、もう一度やり直してください。

OG-00414:	この図表はすでに実行されています。

原因:	ランタイム・シミュレーションで図表を実行しようとしましたが、その図表はすでに実行されています。

処置:	別の図表を選択するか、または実行中の図表をクローズしてください。

OG-00415:	指定したパラメータ名が重複しています。

原因:	別のパラメータですでに使用されている名前でパラメータを作成しようとしました。

処置:	パラメータには、他と重複しない名前を付けてください。

OG-00416:	パラメータ名が指定されていません。

原因:	パラメータを作成しようとしましたが、その名前を指定しませんでした。

処置:	パラメータの名前を指定してください。

OG-00505:	リスト・カウント・エラーが発生しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00507:	問合せタイプが無効です。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00508:	チャート・テンプレートが見つかりません。

原因:	チャートを更新しようとしましたが、基本にするチャート・テンプレートが検索できません。このエラーの原因として、次のことが考えられます。

A.	チャート・テンプレートを削除しました。

B.	チャート・テンプレートを改名しました。

処置:	チャートの基にするテンプレートは、そのチャートの「チャート・プロパティ」ダイアログ・ボックスで新しいテンプレートを選択することにより変更できます。また、次の処置でエラーを解決できます。

A.の場合	削除したテンプレートと同じ名前で、新しいチャート・テンプレートを作成します。

B.の場合	チャート・テンプレートの名前を、チャートで使用される名前と一致するように改名します。

OG-00511:	チャート・テンプレートが指定されていません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00512:	問合せが指定されていません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00513:	問合せにデータがありません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00514:	文書のポインタが指定されていません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00516:	通信コンテキストがロードできません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00517:	通信インタフェースをロードできません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00518:	製品間のデータ送信が失敗しました。

原因:	別のOracle製品でGraphics Builderを起動し、図表の内容を提供するように要求しましたが、その製品と通信しているときにエラーが発生しました。

処置:	Graphics Builderが同期通信モードで起動されているか確認してください。また、製品間の相互通信を阻害するようなシステム・エラーが起こっていないことも確認してください。

OG-00519:	日付から文字列への変換が失敗しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00520:	統合エラー - <メッセージ>

原因:	別の製品に統合しようとしていたときに、エラーが発生しました。

処置:	戻されたエラー・メッセージを確認して、その製品のマニュアルを参照してください。

OG-00521:	ヘルプを初期化できませんでした。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00522:	プリンタ名が無効です。

原因:	プリンタを見つけようとしたときに、エラーが発生しました。

処置:	そのプリンタが接続されており、稼働していることを確認してください。

OG-00524:	問合せ名が指定されていません。

原因:	問合せを作成しようとしましたが、その名前を指定しませんでした。

処置:	問合せの名前を指定してください。

OG-00525:	指定した問合せ名が重複しています。

原因:	別の問合せですでに使用されている名前で問合せを作成しようとしました。

処置:	問合せには、他と重複しない名前を付けてください。

OG-00528:	列名が重複しています。

原因:	別の列ですでに使用されている名前で列を作成しようとしました。

処置:	列には、他と重複しない名前を付けてください。

OG-00529:	列名が指定されていません。

原因:	列を作成しようとしましたが、その名前を指定しませんでした。

処置:	列の名前を指定してください。

OG-00532:	更新処理中にチャートを更新できません。

原因:	更新中のチャートを更新しようとしました。多くの場合、これは、別のチャート更新を引き起こすチャート関連のトリガー内での操作を行おうとしたためです。

処置:	更新中のチャートを更新する操作を行っていないことを確認してください。

OG-00533:	ドリルダウン・パラメータが存在していません。

原因:	Graphics Builderでドリルダウン・チャートによって使用されるパラメータを設定しようとしましたが、パラメータが存在しません。

処置:	パラメータが存在し、そのチャートに正しく割り当てられているか確認してください。

OG-00602:	プログラム単位を適用できません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00604:	プログラム単位の取消しに失敗しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00608:	PL/SQLプロシージャを実行することができません。

原因:	PL/SQLプロシージャを実行しようとしたときに、Graphics Builderでエラーが発生しました。

処置:	プロシージャがコンパイルされているか確認してください。

OG-00609:	PL/SQLの実行で内部エラーが発生しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00622:	パラメータの位置が無効です。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00630:	内部PL/SQLライブラリの連結に失敗しました。

原因:	内部ライブラリに連結しようとしたときに、Graphics Builderでエラーが発生しました。

処置:	図表がデータベースに保存されている場合は、Graphics Builderの表が正しくインストールされているか確認してください。図表がファイルに保存されている場合は、オープンしようとしているファイルが正しい図表ファイルであることを確認してください。

OG-00632:	PL/SQLライブラリにプログラム単位を挿入できません。

原因:	ライブラリにプログラム単位を挿入しようとしたときに、Graphics Builderでエラーが発生しました。

処置:	図表がデータベースに保存されている場合は、Graphics Builderの表が正しくインストールされているか確認してください。図表がファイルに保存されている場合は、ファイル・システムに十分な空き領域があるか確認してください。

OG-00633:	内部PL/SQLライブラリの削除に失敗しました。

原因:	内部ライブラリを削除しようとしたときに、Graphics Builderでエラーが発生しました。

処置:	Graphics Builderの表が正しくインストールされているか確認してください。

OG-00637:	処理されない例外です <例外番号>

原因:	プログラム単位を実行中に、Graphics BuilderでPL/SQL例外が発生しました。

処置:	エラー・メッセージの最後にリストされた例外番号を書き留めて、その例外の詳細について次の表を参照してください。

例外範囲	例外タイプ	参照マニュアルおよび項目

----------------------------------------------------------------------------------------

0-99999	Oracle/PL/SQL	『Oracle8 エラー・メッセージ』

102000-102499	Graphics Builderビルトイン	PL/SQL例外

104500-104999	TOOL_INTパッケージ	PL/SQL例外

105000-105499	TOOL_RESパッケージ

105500-105999	ORA_NLSパッケージ

300000-300499	DEBUGパッケージ

300500-300999	LISTパッケージ

302000-302499	TOOL_ERRパッケージ

302500-302999	TEXT_IOパッケージ

OG-00801:	データ問合せ実行エラーが発生しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00802:	SQL問合せ実行エラーが発生しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-00901:	入力されたパラメータ名が無効です。

原因:	パラメータの名前として、無効な名前を入力しました。

処置:	正しいパラメータ名を使用してください。

OG-00902:	入力されたパラメータ・タイプが無効です。

原因:	パラメータのタイプとして、無効なタイプが入力されました。

処置:	正しいパラメータ・タイプ（CHAR、DATEまたはNUMBER）のいずれかを入力してください。

OG-00903:	入力されたパラメータ値が無効です。

原因:	パラメータ表の値として、無効な値が入力されました。

処置:	指定したパラメータ・タイプに対して、正しい値を入力してください。

OG-01001:	必要なリソースが見つかりません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01002:	必要なリソースが見つかりません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01103:	高レベル・サウンド・ダイアログが失敗しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01105:	図表をロードすることができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01106:	レコード・キャッシュ読込みの初期化に失敗しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01107:	サウンド変換に失敗しました。

原因:	サウンドをインポートまたは作成しようとしましたが、元のサンプル・レートとコード化体系の変換でエラーが発生しました。サウンドが大きすぎる場合に起こりやすいエラーです。

処置:	小さいサウンドをインポートまたは作成してください。

OG-01108:	サウンド・インポート・ファイルから読み込めません。

原因:	サウンドをインポートしようとしましたが、インポートするファイルに正しいサウンド・データが含まれていません。

処置:	ファイルに正しいサウンド・データが含まれているか確認してください。

OG-01109:	カーソルを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01110:	プリンタが見つかりませんでした。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01301:	データ・ファイルを開くことができません。

原因:	データをファイルから読み込む問合せを実行しようとしましたが、Graphics Builderでファイルをオープンすることができませんでした。このエラーの原因として、次のことが考えられます。

A.	ファイルが存在しません。

B.	ファイルをオープンするのに必要な権限がありません。

C.	システム・エラーにより、Graphics Builderでファイルがオープンできませでした。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	必要なファイルを作成します。

B.の場合	ファイルの書込みができるよう権限を変更するか、またはシステム管理者に変更を依頼します。

C.の場合	システムのマニュアルを調べるか、またはシステム管理者に相談してください。

OG-01304:	データのキャッシュを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01305:	SYLKデータ・のファイルが無効です。

原因:	問合せでSYLKファイルを参照するよう定義しましたが、指定したファイルがSYLK形式ではありませんでした。

処置:	形式とファイルの指定が正しいか確認してください。

OG-01306:	PRNデータのファイル書式が無効です。

原因:	問合せでPRNファイルを参照するよう定義しましたが、指定したファイルがPRN形式ではありませんでした。

処置:	形式とファイルの指定が正しいか確認してください。

OG-01307:	WKSデータ・のファイルが無効です。

原因:	問合せでWKSファイルを参照するよう定義しましたが、指定したファイルがWKS形式ではありませんでした。

処置:	形式とファイルの指定が正しいか確認してください。

OG-01601:	ツール共有領域コンテキストを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01603:	DEコンテキストを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01604:	DE UIコンテキストを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01605:	主レイヤー・ウィンドウを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01606:	Oracle Resource Managerを起動することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01607:	オブザーバ・モデル部を初期化することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01610:	PL/SQLバッチ・コンパイラを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01613:	PL/SQLエディタ・ウィンドウを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01614:	PL/SQLプログラム単位の作成エラーです。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01615:	DE実行コンテキストを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01616:	始動時に仮想メモリー管理コンテキストを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01617:	モーダルでないインタプリタを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01618:	モーダルPL/SQLインタプリタを作成することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01619:	エラー・ハンドラを初期化することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01620:	オブジェクト・ストアを初期化することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01621:	Oracle Imageを初期化することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01622:	Oracle Soundを初期化することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01623:	Oracle Helpを初期化することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01625:	バッチ・ウィンドウ属性を設定することができません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01626:	コマンド・ライン・オプションの引数が多すぎます。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01627:	コマンド・ライン・オプションの指定が重複しています。

原因:	Graphics Builderの実行プログラムをコマンド・ラインから起動するために、コマンド・ラインの引数をプログラムに渡しましたが、同じコマンド・ライン・キーワードを複数回使用しています。

処置:	1つのコマンド・ラインでは、1つのコマンド・ライン・キーワードは一度しか使用できません。キーワードに複数の値を指定する場合は、値リストを使用してください。

OG-01629:	コマンド・ライン・キーワードの後のコマンド・ライン引数にキーワードがありません。

原因:	Graphics Builderの実行プログラムをコマンド・ラインから起動するために、キーワードとその値を指定しましたが、キーワードのない値がキーワードの後に指定されています。

処置:	コマンド・ラインでキーワードを使用する場合は、その後にあるすべてのコマンド・ライン引数でキーワードを使用する必要があります。キーワードを省略できるのは、値が実行プログラムの構文で指定されている順序に記述されている場合と、明示的にキーワードを使用している別のコマンド・ライン引数の後に値が来ない場合のみです。

OG-01630:	コマンド・ライン・オプションの値が無効です。

原因:	Graphics Builderの実行プログラムをコマンド・ラインから起動しようとしましたが、コマンド・ライン・キーワードの値が正しく指定されていませんでした。

処置:	有効なコマンド・ラインの値を指定してください。

OG-01631:	コマンド・ラインのリストが正しく形成されていません。

原因:	Graphics Builderの実行プログラムをコマンド・ラインから起動するため、コマンドに複数の値を指定しましたが、値リストの書式が正しくありません。

処置:	値リストはカッコで囲み、それぞれの値をカンマで区切る必要があります。コマンド・ラインでのカッコとカンマの使用方法に関しては、システムごとに特別な制限がある場合があります。

OG-01632:	コマンド・ラインで入力されたリストが無効です。

原因:	複数の値を使用することができない実行プログラムのキーワードに、値のリストを指定しました。

処置:	1つの値しか受け入れないキーワードに、複数の値を指定しないでください。

OG-01633:	コマンド・ファイルが見つかりません。

原因:	CMDFILE実行キーワードで指定したコマンド・ファイルが検索できませんでした。

処置:	そのファイルが存在し、解読できる形式であることを確認してください。

OG-01635:	PL/SQLプログラム単位ブラウザを作成することができませんでした。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01636:	ライブラリ・ブラウザを作成することができませんでした。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01638:	SQLLIB初期化に失敗しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01639:	ツール統合の初期化に失敗しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01640:	データ表ウィンドウを作成できません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01641:	パラメータ表ウィンドウを作成できません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01643:	チャート・テンプレート・ウィンドウを作成できません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01644:	データ表ウィンドウを作成できません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01642:	チャート・テンプレート・ウィンドウを作成できません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01901:	一般的なオブジェクト・ストアのエラーが発生しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01902:	保存するレイヤーが見つかりません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01903:	レイアウト・ビューに予期せぬ空レイヤーがあります。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01904:	データベース・ストアをオープンできません。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-01905:	ユーザー名をフェッチすることができません。

原因:	未明のユーザー名または指定されていないユーザー名があったため、サーバーからの解明を要求しようとしているときに、Graphics Builderでエラーが発生しました。たとえばユーザー名を「接続」ダイアログ・ボックスに入力しないと、Graphics Builderからサーバーにユーザー名OPS$を解明するよう要求が出ます。

処置:	ユーザー名が登録されており、USER_USERSの表に入っているか確認してください。

OG-02205:	オブジェクトは同じグループに属しません。

原因:	同じグループ・オブジェクトの子オブジェクトではない、2つのオブジェクトを同時に選択しようとしました。

処置:	複数のオブジェクトを選択できるのは、それらが同じグループのメンバーである場合のみです。

OG-02207:	グループを1つのみ選択してください。

原因:	1つ以上の単一オブジェクトまたは複数のグループ・オブジェクトを選択して、グループ解除、または子の選択、グループへのオブジェクトの追加を実行しようとしました。

処置:	これらの操作では、1つのグループ・オブジェクトのみを選択してください。

OG-02212:	選択したオブジェクトはグループではありません。

原因:	単一オブジェクトを選択し、その子を選択しようとしました。

処置:	単一オブジェクトには子オブジェクトはありません。この操作では、グループ・オブジェクトを選択してください。

OG-02213:	オブジェクトに親オブジェクトがありません。

原因:	オブジェクトを選択し、その親を選択しようとしましたが、オブジェクトがグループのメンバーではないため、親オブジェクトがありませんでした。

処置:	親オブジェクトを選択できるのは、グループのメンバーになっているオブジェクトのみです。

OG-02215:	オブジェクトを編集することができません。

原因:	変形ツールを選択し、変形できないオブジェクトの制御点を選択しました。

処置:	記号またはチャート、グループ・オブジェクトは変形できません。

OG-02313:	エクスポートするイメージを1つのみ選択してください。

原因:	イメージをエクスポートしようとしましたが、イメージがないか、または複数のイメージが選択されています。

処置:	エクスポートするイメージを1つのみ選択してください。

OG-02502:	ファイルが見つかりません。またはファイルが読込めません。

原因:	ファイルをオープンしようとしましたが、Graphics Builderでファイルの検索または読込みができませんでした。このエラーの原因として、次のことが考えられます。

A.	ファイルが存在しません。

B.	ファイルをオープンするのに必要な権限がありません。

C.	システム・エラーにより、Graphics Builderでファイルがオープンできませんでした。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	必要なファイルを作成します。

B.の場合	ファイルの書込みができるよう権限を変更するか、またはシステム管理者に変更を依頼します。

C.の場合	システムのマニュアルを調べるか、またはシステム管理者に相談してください。

OG-02503:	ファイルに書き込むことができません。

原因:	ファイルに書き込もうとしましたが、Graphics Builderでエラーが発生しました。このエラーの原因として、次のことが考えられます。

A.	ファイルの書込みに必要な権限がありません。

B.	システム・エラーにより、Graphics Builderでファイルの書込みができませんでした。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	ファイルの書込みができるよう権限を変更するか、またはシステム管理者に変更を依頼してください。

B.の場合	システムのマニュアルを調べるか、またはシステム管理者に相談してください。

OG-02505:	データベース・ストアを開くことができません。データベースが適切に構成されていない可能性があります。

原因:	モジュールをデータベースに格納（たとえば、図表を保存、描画を転送など）しようとしているときに、Graphics Builderでエラーが発生しました。

処置:	Graphics Builderの表にデータを格納するのに必要なアクセス権限があるか確認してください。

OG-02506:	印刷できません。プリンタの設定を確認してください。

原因:	印刷しようとしているときに、Graphics Builderでエラーが発生しました。

処置:	プリンタと印刷環境が正しく環境設定されているか確認してください。詳細は、使用しているマニュアルを参照してください。

OG-02507:	ファイルをオープンできないかファイルが指定したフォーマットではありません。

原因:	ファイルをインポートしようとしましたが、ファイルをオープンしようとしているときにGraphics Builderでエラーが発生しました。そのファイルにアクセスできないか、ファイルが指定された形式ではありません。

処置:	そのファイルにアクセスでき、そのファイルが正しい形式になっていることを確認してください。

OG-02508:	データベースにモジュールが見つかりません。

原因:	データベースに保存されているモジュールをオープンしようとしましたが、Graphics Builderでその名前のモジュールは検索できませんでした。

処置:	指定したモジュールがデータベースに存在し、現在のユーザーに適切な権限があるか確認してください。

OG-02701-2718:	CGMファイルの読込み中にエラーが発生しました。

原因:	CGMファイルをインポートしようとしましたが、読み込もうとしているときに、Graphics Builderでエラーが発生しました。ファイルが損傷しているか、またはCGMファイルが正しくないかのいずれかが考えられます。

処置:	ファイルが有効なCGMファイルであるか確認してください。

OG-02801-2806:	ファイルI/Oエラーが発生しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-03003:	イメージを表示できません。

原因:	Builder内でイメージが含まれている図表をオープンしようとしていますが、イメージを表示するのに十分なメモリーがありません。

処置:	図表を保存し、Graphics Builderを終了してから、可能であればメモリーを解放して再度オープンしてみてください。メモリー要件の詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

OG-03101:	Oracle「Toolkit」のエラーが発生しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-03501:	リソース・ファイルが見つかりません。環境設定を確認してください。

原因:	Graphics Builderで必要なリソース・ファイルを検出することができませんでした。

処置:	環境設定が正しいか確認してください。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

OG-03507:	カラー・パレット・ファイルが見つかりません。環境設定を確認してください。

原因:	Graphics Builderで、vgid.rosという名前のデフォルト・カラー・パレット・ファイルを検出することができませんでした。

処置:	環境設定が正しいか確認してください。詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

OG-03701-3702:	メモリーが十分ありません。

原因:	Graphics Builderがメモリー不足になりました。

処置:	図表を保存し、Graphics Builderを終了してください。メモリー要件の詳細は、使用しているオペレーティング・システムのGraphics Builderマニュアルを参照してください。

OG-03704:	オブジェクト・ストアでエラーが発生しました。

原因:	これは異常な状態です。

処置:	詳細は、「異常な状態」を参照してください。

OG-03800-3812:	CGMファイルの書込みができませんでした。

原因:	描画をCGMとしてエクスポートしようとしましたが、Graphics Builderでエラーが発生しました。このエラーの原因として、次のことが考えられます。

A.	ファイルの書込みに必要な権限がありません。

B.	システム・エラーにより、Graphics Builderでファイルの書込みができませんでした。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	ファイルの書込みができるよう権限を変更するか、またはシステム管理者に変更を依頼してください。

B.の場合	システムのマニュアルを調べるか、またはシステム管理者に相談してください。

OG-04001:	チャート・テンプレート内にフィールド・テンプレートが見つかりません。

原因:	テンプレートが破損しています。

処置:	チャートを更新または再作成してください。

OG-04002:	問合せデータに列が見つかりません。

原因:	あるデータ列が含まれる問合せに基づいてチャートを作成した後で、1つまたは複数の列がなくなるような変更を問合せに対して行いました。チャートを更新しようとしたとき、これらの列を探しましたが、検出できませんでした。

処置:	問合せに存在する列のみを使用して、チャートのフィールド・マッピングを更新してください。

OG-04003:	指定された軸の最小/最大目盛りの組合わせが無効です。

原因:	「最大」の軸値より大きい「最小」の軸値を入力しました。

処置:	「最大」値より小さい「最小」値を入力するか、どちらかの値または両方の値に「自動」を選択してください。

OG-04004:	対応する軸に対し列データ型が無効です。

原因:	チャートで指定されたデータ型と軸プロパティの実際のデータ型が一致しません。

処置:	プロットされているデータと軸プロパティのデータ型を確認してください。

OG-04005:	スタック・データでは負の値を使用できません。

原因:	チャート内のフィールドの「使用部分位置」が「スタック」に設定されていますが、問合せには負のデータが含まれています。

処置:	「スタック」チャートでは正のデータ値しか使用できません。

OG-04006:	ログ・チャートでは負のデータまたは0のデータを使用することはできません。

原因:	対数軸を使用するチャートを作成しましたが、その軸に対してマップするフィールドに、負のデータ値が含まれています。

処置:	対数軸に対しては正のデータ値しか使用できません。

OG-04007:	パーセント・チャートでは負のデータを使用できません。

原因:	パーセント・チャートが基本にしている問合せに、負のデータ値が含まれています。

処置:	パーセント・チャートでは正のデータ値しか使用できません。

OG-04008:	パーセント・チャートで合計/最小/最大のいずれかが0でした。

原因:	すべてのデータ値の合計/最小/最大のパーセントとして、データ値を使用するチャートを作成しましたが、合計/最小/最大のいずれかが0でした。

処置:	合計/最小/最大のいずれかが0の場合、パーセントの計算はできません。

OG-04010:	円グラフでは負のデータを使用できません。

原因:	円グラフが基本にしている問合せに、負のデータ値が含まれています。

処置:	円グラフでは正のデータ値しか使用できません。

OG-04011:	データ値の合計が、指定した合計値よりも大きくなっています。

原因:	問合せの実際のデータ合計よりも小さい「合計値」を円グラフで指定しました。

処置:	円グラフの「合計値」には、問合せで戻される実際のデータ合計より大きい値を設定してください。

OG-04012:	データ・オーバーフロー:別の軸精度で再試行してください。

原因:	日付軸を含むチャートを作成または更新しましたが、そのデータの範囲が大きすぎます。たとえば、データが何年分もあって、軸のステップ・サイズが秒の場合、このエラーが発生します。

処置:	軸のステップ・サイズの単位を大きく設定し、結果として軸の目盛を小さくします。

OG-04013:	凡例列を0にすることはできません。

原因:	凡例にある列数を0に設定しました。

処置:	凡例にある列数を1以上に設定してください。

OG-04014:	チャートにするデータがありません。

原因:	チャートを更新しようとしましたが、それに関連する問合せが実行されていませんでした。これは、その問合せがデータベースを参照してもデータベースが接続されていないとき、あるいはSYLKまたはWKS、PRNの各ファイルが検索できないときに起こります。

処置:	データベースが接続されているか、またはファイルが存在するか確認してください。

OG-04015:	データの行が多すぎます。

原因:	問合せを実行しようとしましたが、システム上でGraphics Builderが処理できる以上のデータ行を問合せが戻しました。

処置:	戻される行が少なくなるように、問合せを制限してください。


 Graphics Builderへの一般的な質問

チャートの作成について

PL/SQLについて

デバッグについて

パフォーマンスについて

統合について

一般設計について


 チャートの作成について

適切にチャートを更新させる方法は?

あるチャートの設定を再使用して、他のチャートを作成できますか?

円グラフのカラーをカスタマイズする方法は?

描画をGraphics Builderにインポートするときに、なぜオブジェクトを選択できないのですか?

凡例を削除する方法は?

レイアウトをイメージとしてエクスポートする方法はありますか?

ラベルを回転できますか?

オブジェクトの枠を三次元で表示する方法は?

ツールを選択されたままにするには、どのようにツールを選択しますか?

テキストのスケーリング方法は?

カラー・パレットの編集方法は?

デフォルト・ラベルの変更方法は?


適切にチャートを更新させる方法は?

チャートを使用して図表を作成し実行するときに、図表にランタイム・データが表示されません。図表には、前回Graphics Builderで保存したときのデータが表示されています。どのようにしたら適切にチャートを更新できますか?

「チャート・プロパティ」ダイアログのデータ・ページの「問合せ実行時にチャートを更新」がチェックされていることを確認します。さらに、「問合せプロパティ」ダイアログの「オプション」タブで、必ず実行の「オープンされている図表」がチェックされるようにします。


あるチャートの設定を再使用して、他のチャートを作成できますか?

他のチャートを再使用して、少しだけ変更したチャートを作成する場合、最もよい方法は?

すべてのチャートはチャート・テンプレートに基づいています。作成しているチャートのタイプおよびサブタイプを選択すると、それは、実際にGraphics Builderによって提供される50以上のデフォルト・チャート・テンプレートから1つを選択したことになり、ユーザーのチャートにそのコピーが作成されます。

提供されるデフォルト・テンプレートは変更できませんが、チャート作成時に作成されるコピーを変更したり、カスタマイズ済みチャート・テンプレートとして保存できます。このとき、チャート・テンプレート・エディタ内でチャート・テンプレートを編集します。


円グラフのカラーをカスタマイズする方法は?

円グラフのカラーを制御するときに、Graphics Builderは、テンプレートのカラーを除いてすべてのカラーを選択しているにように見えます。これをカスタマイズする方法がありますか?

デザイナではこのカラー設定ができません。ただし、プログラムを使用してデータをループし、対応する円弧のカラーや塗りパターンなどを変更できます。これに関連した例は、『Graphics Builder リファレンス』の中で何度か紹介されていますので、リストされているname_the_barsプロシージャを参照してください。

また、PL/SQLライブラリcolorrmp.pllを連結することにより、カラー・ランプと呼ばれるGraphics Builder再使用可能コンポーネントを使用することもできます。詳細は「Graphics Builder再使用可能コンポーネント・ヘルプ」を参照してください。


描画をGraphics Builderにインポートするときに、なぜオブジェクトを選択できないのですか?

描画をGraphics Builderにインポートするときに、レイアウトの描画を選択しましたが、なぜオブジェクトを選択できないのですか?

「ファイル」 [image] 「インポート」 [image] 「描画」を使用するときに、新規描画が現在のレイヤーにインポートされていません。Graphics Builderによって、自動的に新規レイヤーが作成されます。「ツール」 [image] 「レイヤー」ダイアログを使用して、新規にインポートされたレイヤーをアクティブ化します。


凡例を削除する方法は?

凡例なしでチャートを作成するとき、デフォルトで作成された凡例をどのようにして削除できますか?

枠プロパティ・シートの「凡例の表示」チェックボックスを選択解除します。（右マウス・メニューまたは「チャート」メニューを使用してプロパティ・シートを表示できます）。


レイアウトをイメージとしてエクスポートする方法はありますか?

Webページでチャートのイメージをインクルードするとき、どのようにしたら、チャートのレイアウトをイメージにエクスポートできますか?

チャートのレイアウトをイメージにエクスポートする方法は3つあります。コマンド・ラインでエクスポートするには、次のようにコマンド・ライン・オプションexportimageを使用します。

g25run openfile=c:\test.ogd
userid=scott/tiger
exportimage=c:\test.gif quit=yes

これは、図表を実行し、チャート・データを含むレイアウトをGIFファイルtest.gifにエクスポートします。

「ファイル」 [image] 「エクスポート」 [image] 「イメージ」を選択し、「イメージ・エクスポート」ダイアログを使用して、同様にエクスポートすることもできます。

最後に、OG_EXPORT_IMAGEのビルトイン・サブプログラムでも同じことができます。次に例を示します。

og_export_image('C:\test.gif', OG_FILESYSTEM, OG_GIF_IFORMAT, og_root_object, OG_LZWHDIFF_ICOMPRESSION);

この文により圧縮タイプも設定されます。


ラベルを回転できますか?

ラベルの方向を変更する場合に、変更できますか?

できます。 次のトリガーを使用します。

PROCEDURE Rotate_Label(chartname   VarChar2, labelname    VarChar2,  rotationangle    Number) IS
axislabelog_object;
theoffsetOG_Point

BEGIN

axislabel := og_get_object(labelname);
og_set_horigin(axislabel, OG_CENTER_HORIGEN, false, false);
og_rotate(axislabel, og_get_origin(axislabel), rotationangle, false, false);
og_draw(og_get_object(chartname);

END

--Updating chart will invalidate label rotation!!!
--Call this procedure after you have updated the chart.
--Rotation angle is clockwise.

チャートの更新を含む他のすべての操作を行った後で、このトリガーを実行する必要があります。（ただし、Graphics Builder再使用可能コンポーネントを使用したり.ogd ファイルを再使用可能コンポーネントとして登録する場合は、チャート更新後の図表の変更は保存されます）。


オブジェクトの枠を三次元で表示する方法は?

図表のオブジェクトを凸または凹で表示する場合、どうすれば、それができますか?

レイアウトの1つ以上のオブジェクトを選択した後、「書式」 [image] 「凹凸」を選択し、枠の表示方法を凸、凹、凸枠設定または凹枠設定から選択します。凹凸がすぐに現れない場合は、オブジェクトの枠が細すぎて有効に表示されていない可能性があります。「書式」 [image] 「線幅」を選択し、オブジェクトの枠に太い幅を選択します。


ツールを選択されたままにするには、どのようにツールを選択しますか?

レイアウトに同一のオブジェクトをいくつか描画するときに、各オブジェクトを描画した後で、ツールが選択ツールに戻らないようにできますか。

最初に選択しているツールをダブルクリックする場合、ツール・パレットに凹状態のツール・アイコンが表示され、プッシュ・ピンのイメージがアイコンを押した状態になっていることに注目してください。これは、そのツールのモードがアクティブになっていることを意味し、他のツールを選択するまで、そのツールが選択されたままになっています。


テキストのスケーリング方法は?

テキスト・オブジェクトを適切なサイズにドラッグすることは可能ですか?

「書式」 [image] 「描画オプション」に続いて、「テキスト?」 を選択した後、「テキスト描画オプション」ダイアログで「スケーラブル・フォント」を選択します。これによって、テキスト・オブジェクトのテキストをスケーリングできます。


カラー・パレットの編集方法は?

カラー・パレットのカラーが気に入りません。どのようにしてそれらを変更または新規カラーを使用できますか?

カラー・パレットのカラーを変更するには、「ツール」 [image] 「ツール・オプション?」を選択し、デフォルト・ページの「カラー・パレット」で「Editable」を選択します。ユーザーの環境設定を保存します。この新規環境設定を有効にするために、ユーザーの図表をクローズしてから、再オープンする必要があります。次に、「書式」 [image] 「カラー・パレット」を選択して、デフォルトのGraphics Builderカラー・パレットのカスタム・カラーを作成できます。

別のカラー・パレットを使用する場合は、Graphics Builderにはグレースケール・パレットを含むVGAパレットおよび16色VGAパレットが用意されています。カラー・パレットが編集可能であることを確認した後、前述したように、「ファイル」 [image] 「インポート」 [image] 「カラー・パレット」を選択して、「インポート」ダイアログで.palまたはカラー・パレット・ファイルを選択します。使用可能なカラー・パレット・ファイルの位置の詳細は『インストレーションおよびユーザーズ・ガイド』を参照してください。


デフォルト・ラベルの変更方法は?

パーセント記号を円グラフのラベルに追加する場合、どうすればできますか?

パーセント記号を円グラフのラベルに追加するには、フォーマット・トリガーを円グラフのラベル・グループに連結します。次に例を示します。

--Chart Element format trigger.
--Called for each member of a
--specified chart element group.
--Arguments:
--
--	ELEMThe current chart element.
--	QUERYThe query associated with
--this chart.The current row
--of the query is the one
--associated with ELEM.
--	Use OG_GET_xxxCELL to get at
--column values for the current row.

PROCEDURE FTRIG(elem IN og_object, query IN og_query) IS

BEGIN

og_set_str(elem, og_get_str(elem, 0, 0) || '%');

END

この方法を使用して、チャート・ラベルを変更します。


 PL/SQLについて

なぜ定義していないボタンが図表に含まれているのですか?

PL/SQL例外の処理方法は?

レイアウトをイメージとしてエクスポートする方法はありますか?

Graphicsからデータベースの情報を更新できますか?

円グラフの円弧を切り離して突出させることができますか?


なぜ定義していないボタンが図表に含まれているのですか?

図表を生成中に、"オブジェクト'my_button'に関連付けられたプロシージャ'my_buttonproc'には4つのパラメータが必要です"というエラーが発生します。なぜですか？

プロシージャをオブジェクトに関連付ける場合、そのオブジェクトは、選択時にプロシージャを起動するボタンになります。そのプロジェクトがコールされると、Graphics Builderは、アクティブにされたオブジェクトのハンドルを含む4つの引数を自動的に渡します。プロシージャが4つの引数を受け入れるように定義されていないと、生成しているときにこの一貫性エラーが起こります。

これに対する簡単な解決策は、ボタン・プロシージャを定義するときに、最初からプロシージャを起動するのではなく、プログラム単位から「ナビゲータ」 [image] 「作成」を選択して定義を確実に開始することです。このとき、Graphics Builderでは4つのデフォルト引数とデータ型が提供されるので、あとはプロシージャの名前とボディを変更するのみです。


PL/SQL例外の処理方法は?

プロシージャを実行してチャートを更新しているときに、"OG-637: 未処理PL/SQL例外エラー102003"が発生します。それは、何を意味していますか。

OG-637エラーは、多くのPL/SQLまたはOracleのエラーによって生じる一般エラーです。6個の数字から成るエラー番号が何を表しているのかは「Graphics Builderビルトイン例外」を参照してください。 そこでは、エラーの発生原因についてさらに詳しく説明しています。


Graphicsからデータベースの情報を更新できますか?

Graphics Builder内からデータベースへの変更をコミットする方法はありますか?

あります。 図表に関連付けられたPL/SQLプロシージャで行えます。PL/SQLプログラム単位内からDML文を実行したり、DO_SQLビルトイン・プロシージャを使用してDDL文を実行できます。


円グラフの円弧を切り離して突出させることができますか?

特に円グラフ・チャートの1スライスを強調する場合、どのようにしてそれを他の円グラフから切り離しますか?

PL/SQLプロシージャを使用して、円弧を突出させることができます。この作業を行うには、次のステップに従います。

1. 	「チャート・プロパティ」ダイアログで、データ・タブを選択し、"問合せ実行時にチャートを更新"が選択されていないことを確認します。

2. 	「ツール」 [image] 「図表」を選択し、「オープン・トリガー」ドロップダウン・リストの右側の「編集」ボタンを選択します。

3. 	円グラフの円弧を切り離して突出させるプロシージャの本体を入力します。次に例を示します。

PROCEDURE explode IS
pieOG_OBJECT;
pieqOG_QUERY;
mrowsNUMBER;
msalNUMBER;
csalNUMBER;
rowsqNUMBER;

BEGIN
--Assign initial variable values
msal := 0;
mrows :=0;
pie := OG_GET_OBJECT ('sal_chart');
pieq := OG_GET_QUERY ('query0');
--Where 'sal_chart' is the name of the chart and
--and where 'query0' is the name of the query.

--Execute the chart query to get new data.
OG_EXECUTE_QUERY(pieq);

--Count the number of rows returned by the query
rowsq := OG_NUMROWS(pieq, OG_NEWDATA);

--Determine the maximum value by looping through the query rows
OG_START_FROM(pieq, OG_NEWDATA, 0);
FOR I IN 0 .. rowsq -1 LOOP
csal := OG_GET_NUMCELL (peiq, OG_NEWDATA, 'sal');
IF csal > msal THEN
msal := csal;
mrows := i;
END IF;
OG_NEXT_ROW(pieq, OG_NEWDATA);
END LOOP;

--Set the pie explosion
OG_SET_EXPLOSION(pie, OG_ALL_CHUPDA);

--Update the chart

OG_UPDATE_CHART(pie, OG_ALL_CHUPDA);

END;

4. 	トリガーをコンパイルし、プログラム単位エディタをクローズします。

また、PL/SQLライブラリexplode.pllを連結することにより、円グラフの突出と呼ばれるGraphics Builder再使用可能コンポーネントを使用することもできます。詳細は「Graphics Builder再使用可能コンポーネント・ヘルプ」を参照してください。


 デバッグについて

図表内のPL/SQLのコードを保存する方法は?

ランタイム・シミュレーション中に実行したPL/SQLの変更を保存する方法は?


図表内のPL/SQLのコードを保存する方法は?

Graphics Builder図表内のPL/SQLプログラム単位のソース・コードをどのようにして、テキスト・ファイルに保存できますか。

図表をGraphics Builderデザイナ内から実行し、PL/SQLインタプリタを起動することにより取得できます。PL/SQLプロンプトで、次のコマンドをタイプします。

export prog * file <my_text_file>


ランタイム・シミュレーション中に実行したPL/SQLの変更を保存する方法は?

図表をテストして、プロシージャに必要な変更をチェックする場合、どのようにして変更し、その変更が設計時バージョンのプロシージャに影響を与えることを確認できますか?

ランタイム・シミュレーション・プログラム単位と設計時プログラム単位の間にソース・テキストをカット、コピーまたはペーストできます。また、ランタイム・シミュレーションからPL/SQLインタプリタを起動してコマンドを入力できます。

og_save_display;

注意: このコマンドにより、現在のランタイム・シミュレーション状態にあるすべてのものが書き込まれます。したがって、図表の図形オブジェクトに関する現行の変更も同様に保存されます。次回図表を起動すると、オブジェクトは元の初期状態ではないことがあります。変更を破棄するには、現在のデザイナ・セッションから、「ファイル」 [image] 「変更の破棄」を選択する必要があります。


 パフォーマンスについて

組み込まれた図表のパフォーマンスを改善する方法は?

連結ライブラリまたはローカルPL/SQLのどちらを使用するべきですか?

PL/SQLプログラム単位は、どこに格納する必要がありますか?

図表が数多くのデータ表示を表示するとしたら、どうなりますか?

いつDO_SQLを使用する必要がありますか?


Graphicsのパフォーマンスを最大にする場合、最もよい方法は?

Graphicsのパフォーマンスを最大にするのに最もよい方法は、ダメージを監視して、ほとんどのGraphics PL/SQLビルトインでの最後の2つの引数であるフラグを更新することです。デフォルトで、これらのフラグは「TRUE」に設定され、Graphics図表リストが変更されるたびに再描画が起こります。パフォーマンスを改善するには、必ず 1 つのPL/SQLプログラム単位（ボタン・プロシージャ、トリガーなど）内で図表を1回のみ更新するようにします。たとえば、次のコード例を考えます。

開始

for i in 1 ..100 loop

og_set_fillcolor(og_get_object('obj' || to_char(i)),
        'red');

END LOOP;

End;

パフォーマンスを改善するには、コードを次のように変更します。

開始

for i in 1 ..100 loop

og_set_fillcolor(og_get_object('obj' || to_char(i)),
        'red', false, false);

END LOOP;

og_draw(og_root_object);

End;

この例では、プロシージャが終了するまで、画面のどの部分も更新されません。

この手法を使用すると、いくつかのオブジェクトが実行時に作成または消去される図表、または数多くのPL/SQLコードが含まれている図表では、大きなパフォーマンス改善が行われます。（3ライン・ループには多くのコードを含めることができることに注意してください）。


組み込まれた図表のパフォーマンスを改善する方法は?

フォームまたはレポートに組み込まれた図表のパフォーマンスを改善するために、どのようなステップをとることができますか?

一般に、フォームまたはレポートからコールされたときに図表をできるだけ効率よく実行するには、フォームおよび図表の初期設計時にできるだけ多くの共通要素を使用するようにします。たとえば、すでにフォームによってフェッチされたデータをチャート内で使用するとき、図表にデータベースへの再問合せをさせずに、同じデータをレコード・グループを用いて図表に渡します。フォームおよび図表で同じカラー・パレットを使用したり、同じフォントを使用可能にします。

図表のパフォーマンスを改善するもう1つのオプションは、1つのPL/SQLプログラム単位（ボタン・プロシージャ、トリガーなど）が必ずチャートを1回更新するようにすることです。そうするには、「TRUE」に設定されているダメージ・フラグおよびバウンディング・ボックスを「FALSE」にリセットして、最終アクションとして、OG_UPDATE_CHARTおよびOG_DRAWのみを実行するようにします。

Graphics Builderのパフォーマンスを改善することに関する詳細は、次の項を参照してください。

Graphicsのパフォーマンスを最大にする場合、最もよい方法は?

ダメージ・フラグおよびバウンディング・ボックスの詳細は、次の項を参照してください。

ダメージ・フラグの使用

バウンディング・ボックス更新フラグの使用


連結ライブラリまたはローカルPL/SQLのどちらを使用するべきですか?

PL/SQLを外部ライブラリとして連結した方がよいですか?

可能な限り、図表のローカルPL/SQLを使用せずに、図表に連結されたライブラリのPL/SQLをインクルードします。

外部ライブラリに含まれるプログラム単位は、図表、フォームおよびレポートなど多くのモジュールで使用できますが、ローカル・プログラム単位は、それが属しているモジュールでしかアクセスできません。

さらに、ローカル・プログラム単位は、モジュールが実行されるかどうかにかかわらず、モジュールがオープンされたときロードされます。ライブラリは、コールされるときにのみロードされます。


PL/SQLプログラム単位は、どこに格納する必要がありますか?

プログラム単位は、クライアントまたはサーバーのどちらに格納するのが適切ですか?

クライアントに格納することでパフォーマンスを改善できるプロシージャもあれば、サーバーに格納する方が効率よく機能するプロシージャもあります。特定のプロシージャを格納するとき、どこが最適の場所であるかを判断することについては、Procedure Builderのマニュアルを参照してください。


図表が数多くのデータ表示を表示するとしたら、どうなりますか?

数多くのデータ表示を表示する必要があるとき、どのようにして図表のパフォーマンス低下を埋め合わせることができますか。

Graphics Builderには図表に表示できるポイント数のビルトイン制限はありませんが、現実的に考えるといくつかのガイドラインがあります。ユーザーのマシンには、妥当な時間内に大量のデータを十分にプロットできるメモリーがないこともあります。

この問題を回避するための1つの方法として、1回にすべてのデータの1部分のみをプロットするように、図表を設計します。より多くの情報にアクセスするためにユーザーは図表をスクロールしたり、現在プロットされているポイントを選択し、ドリルダウンをしてデータを表示します


いつDO_SQLを使用する必要がありますか?

図表にDDLまたはDMLを追加する場合、DO_SQLを使用する必要がありますか?

必要なときにのみ、パッケージ化されたプロシージャDO_SQLを使用します。DO_SQLは、PL/SQLでは代用できないので、DDL文を実行する場合に必要です。ただし、図表でDMLを使用する場合はプログラム単位内にDO_SQLをインクルードできます。

DO_SQLによって、図表にDDLまたはDML操作（実際、かなり貴重な機能）を追加できますが、使用方法が不適切であると、かなり無駄な処理を行うことになることがあります。問合せと同様に、DO_SQL文はデータベース上で解析され、カーソルをオープンして、実行されます。ただし、問合せとは異なり、DO_SQL文は、データがフェッチされるたびに、実行されます。（たとえば、DO_SQL文が、10レコードのデータをフェッチする場合、その文は10回解析され、10カーソルがオープンし、文が10回実行されます。）


 統合について

レコード・グループを使用して、フォームからGraphics Builderにデータを渡す方法は?

フォームからGraphics Builderバッチをシャットダウンする方法は?

チャートをフォームに組み込むと、なぜ欠けて表示されるのですか?

なぜGraphics Builderが、フォームからオープンする図表を見つけられないのですか?

フォームに組み込んだ図表をなぜ更新できないのですか?

レポートに図表を表示できません。何が間違っているのですか?


レコード・グループを使用して、フォームからGraphics Builderにデータを渡す方法は?

レコード・グループをGraphics Builderに渡して、グループのデータに基づくチャートを取得するのですが。この方法がよくわかりません。

渡されるパラメータの名前が、図表の問合せの名前と同じであるかを確認することが重要です。同期モードのRUN_PRODUCTを介してGraphics Builderを起動して（別の方法ではレコード・グループを渡すことはできません）、そのパラメータ・リストに引数として渡すことを確認してください。問合せを再実行してチャートを更新するには、先述の質問のステップに従ってください。このタイプのフォーム・トリガーの詳細は『フォーム・ユーザーズ・ガイド』を参照してください。


フォームからGraphics Builderバッチをシャットダウンする方法は?

フォームからGraphics Builderを起動すると、Windowsデスクトップに、Graphics Builderバッチモード・アイコンが表示されます。フォームを終了した後でも、そのアイコンが表示されています。自動的にそれを取り除く方法はありますか?

パフォーマンスを最適化するには、Graphics Builderバッチ・プロセスをフォームから起動した後、アクティブのままにしておきます。これはデフォルト動作です。もしそうでないならば、ユーザーは、チャートが更新されるたびに、GraphicsBuilderが起動するまで待機する必要があります。フォームを終了するとき、Graphics Builderをシャットダウンする場合は、Graphics Builderバッチ・モード・プロセスを明示的にシャットダウンするPost-Formトリガーを書くこともできます。

Declare

pl paramlist;

Begin

pl := create_parameter_list('paramlist');

add_parameter(pl, 'oracle_shutdown', text_parameter, 'YES');

run_product(graphics, '<your_display_name>',

synchronous, batch, filesystem,

pl, '<chart_item_name>);

destroy_parameter_list(pl);

End;


チャートをフォームに組み込むと、なぜ欠けて表示されるのですか?

チャートをフォームに組み込んでからフォームを実行すると、図表が正しく表示されないことが多いのですが。どのようにして、それを修正できますか。

デフォルトでは、Graphics Builderを起動して図表をオープンするOG.OPENのコールにより、チャート内で定義した領域に合わせるために図表がクリップされます。2つの方法があります。初期コールで

clip=no

を指定して図表をスケーリングできます。また、図表の実際のサイズにさらに一致させるために、フォームで作成したチャート・オブジェクトのサイズを変更できます。


なぜGraphics Builderが、フォームからオープンする図表を見つけられないのですか?

フォームでチャート・オブジェクトを作成し、OG.OPENの呼出しでオープンする図表を指定するときに、Graphics Builderはまだ図表を見つけていません。なぜですか？

Graphics Builderパス環境変数（FORM_PATH環境変数ではありません）が指定したディレクトリに.ogdファイルがあることを確認してください。この環境変数の名前はプラットフォームによって異なるので、プラットフォーム固有のGraphics Builderのマニュアルをチェックしてください。


フォームに組み込んだ図表をなぜ更新できないのですか?

図表を組み込んだフォームを実行し、フォームをクローズしてから再び実行すると、図表を変更したデータでも更新されません。これはなぜですか?か。

フォームをクローズしてForms Runtimeを終了しても、フォームに組み込んだ図表を実行するためにコールされたGraphics Builder実行可能プログラムであるGraphics Builderバッチ・モードが自動的にはクローズされません。Graphics Builderバッチ・モードがオープンしている間、同じデータを使用して、同じ図表が引き続き実行されます。フォームを終了するとき、必ずGraphics Builderバッチ・モードをクローズするには、フォーム・トリガーに、図表をクローズするOG.CLOSEをコールします。


レポートに図表を表示できません。何が間違っているのですか?

レポート・レイアウトでチャート図表項目を作成して図表に関連付けても、レポートにチャートが表示されずにエラーが発生します。どうなっているのでしょうか？

図表をレポートに関連付けたときに、レポート列とチャート列の間の1対1対応が考慮されていなかった可能性があります。


 一般設計について

コントロール・オブジェクトを使用してアプリケーションを作成できますか?

関連資料


コントロール・オブジェクトを用いてアプリケーションを作成できますか?

Graphics Builderで、プッシュ・ボタン、メニュー、ポップリストなどのコントロール・オブジェクトを用いてアプリケーションを作成できますか?

できません。ただし、Formsを使用してチャートやダイアグラムなどのGraphics Builderオブジェクトを埋め込むことにより、希望のアプリケーションを実現することが可能です。


関連資料

関連書籍

『Oracle PL/SQL Programming』Steven Feuerstein著、O'Reilly and Associates, Inc.

800-998-9938, (707) 829-0515

http://www.ora.com

『Learning Oracle Forms 4.5』Stephen Edelstein著、Relationship Business Systems

(212) 956-3670

74160.645@compuserve.com

『Mastering Oracle in Client Server Computing』Steve Bobrowski著、Sybex

関連雑誌

『Oracle Technical Journal (OTJ)』、Miller Freeman

pchapnickel@nfi.com


ダイアログ・ボックス

次のダイアログ・ボックスおよびそのオプションについて説明します。

「円弧描画オプション」ダイアログ・ボックス

「チャート生成」ダイアログ・ボックス

「コンパイル」ダイアログ・ボックス

「日付書式」ダイアログ・ボックス

「データベースから削除」ダイアログ・ボックス

「エクスポート」ダイアログ・ボックス

「データベースにエクスポート」ダイアログ・ボックス

「イメージ・エクスポート」ダイアログ・ボックス

「サウンド・エクスポート」ダイアログ・ボックス

「一般描画オプション」ダイアログ・ボックス

「イメージ描画オプション」ダイアログ・ボックス

「インポート」ダイアログ・ボックス

「図表インポート」ダイアログ・ボックス

「データベースからインポート」ダイアログ・ボックス

「イメージ・インポート」ダイアログ・ボックス

「サウンド・インポート」ダイアログ・ボックス

「レイアウト設定」ダイアログ・ボックス

「モジュール・アクセス」ダイアログ・ボックス

「データベース上モジュールへのアクセス」ダイアログ・ボックス

「新規問合せ」ダイアログ･ボックス

「数値書式」ダイアログ・ボックス

「データベースからオープン」ダイアログ・ボックス

「改名」ダイアログ・ボックス

「丸い四角形描画オプション」ダイアログ・ボックス

「定規設定」ダイアログ・ボックス

「データベースへ保存」ダイアログ・ボックス

「保存先」ダイアログ・ボックス

ソース制御: 「チェックイン」ダイアログ・ボックス

ソース制御: 「チェックアウト」ダイアログ・ボックス

ソース制御: 「オプション」ダイアログ・ボックス

「テキスト描画オプション」ダイアログ・ボックス

Oracleヘルプの使用


「円弧描画オプション」ダイアログ・ボックス
「円弧描画オプション」ダイアログ･ボックス

円弧の形および閉じを設定します。

ダイアログ・ボックス・オプション

円弧の形  選択した円弧をどのように塗り潰すかを指定します。オプションの中から1つ選択してください。

円弧の閉じ

選択した円弧を閉じた形にするか、または開いた形にするかを指定します。オプションの中から1つ選択してください。


「チャート生成」 ダイアログ・ボックス

作成するチャートにデータを提供するには、既存問合せを選択するか、新規問合せを作成します。

ダイアログ・ボックス・オプション

既存問合せ

現在の図表で定義されているすべての問合せのリストを表示させます。チャートに使用する問合せを、このリストから選択してください。

新規問合せ

チャートに使用する新規の問合せを作成します。このオプションを選択し、「OK」をクリックすると、「新規問合せ」ダイアログ・ボックスが表示されます。


「コンパイル」ダイアログ・ボックス

最新のコンパイル操作の状態および結果として発生するコンパイル・エラーをすべて表示します。エラー・メッセージをクリックし、そのエラーが発生したプログラム単位にアクセスします。

ダイアログ・ボックス・オプション

割込み

コンパイルを途中で中断します。

再開

コンパイルの途中で割込みが発生した場合、そのコンパイルを再開します。

エラーへジャンプ

報告された最初のエラーが含まれるプログラム単位にジャンプします。


「日付書式」ダイアログ・ボックス

使用可能な日付書式マスクを追加、削除または適用します。

ダイアログ・ボックス・オプション

書式

リストへ追加、リストから削除またはオブジェクトへ適用する書式文字列。これは、有効な日付書式マスクであることが必要です。詳細は、『Oracle7 Server SQL言語リファレンス』を参照してください。

追加

「書式」テキスト・ボックスに表示されている書式マスクを、使用可能な書式のリストに追加します。

削除

「書式」テキスト・ボックスに表示されている書式マスクを、使用可能な書式のリストから削除します。

OK

変更を確定し、ダイアログ・ボックスをクローズします。選択された書式マスクが適用可能な場合は、選択されたオブジェクトに適用されます。


「データベースから削除」ダイアログ・ボックス

データベースに現在格納されているモジュールのリストを表示します。

ダイアログ・ボックス・オプション

名前

削除するモジュールの名前。表示されたリストの中からモジュール名を選択するか、またはこのテキスト・ボックスに直接入力できます。

リスト更新

格納されているモジュールのリストを更新します。

OK

「名前」テキスト・ボックスに表示された名前のモジュールを削除します。


「エクスポート」ダイアログ・ボックス

モジュールを現在の表示からファイルまたはデータベースへ格納します。

ダイアログ・ボックス・オプション

データ宛先

エクスポートするモジュールの位置と形式を指定します。

ファイル・システム	使用しているシステムの「ファイル名を付けて保存」ダイアログを表示します。

データベース	「データベースにエクスポート」ダイアログ・ボックスを表示します。

フォーマット	モジュールをエクスポートするときの形式を指定します。エクスポートするモジュールのタイプによって使用可能なオプションが変わります。

オプション

数種類のオプションを指定できます。

圧縮	エクスポート済み描画のコンポーネントであるイメージをエクスポートする時に、使用する圧縮方式(もしあれば)を指定します。

CGMコード化	CGM描画のエクスポート時に使用するコード化方式を指定します。CGMでは、2バイトと4バイトの両方をサポートします。ほとんどの製品では、CGMには2バイトで対応しています。


「データベースにエクスポート」ダイアログ・ボックス

データベースに現在格納されているモジュールのリストを表示します。

ダイアログ・ボックス・オプション

リスト更新

格納されているモジュールのリストを更新します。

名前

エクスポートされたモジュールが格納されるときの名前。表示されたリストの中からモジュール名を選択するか、またはこのフィールドに直接入力できます。

OK

選択されたモジュールをエクスポートします。


 「イメージ・エクスポート」ダイアログ・ボックス

選択したイメージをファイルまたはデータベースに格納します。

ダイアログ・ボックス・オプション

データベース

エクスポートするイメージをデータベースに格納するように指定します。「参照」をクリックすると、「データベースにエクスポート」ダイアログ・ボックスが表示されます。

ファイル

エクスポートするイメージをファイルに格納するように指定します。

フォーマット

イメージをエクスポートするときの形式を指定します。

データ型

イメージをエクスポートするときのデータ型を指定します。

圧縮

イメージをエクスポートするときの圧縮方式を指定します。イメージのエクスポート時の形式によって、オプションは変わります。

質

イメージをエクスポートするときの品質を指定します。これは、複数の品質設定に対応するイメージ形式にのみ適用されます。


「サウンド・エクスポート」ダイアログ・ボックス

選択されたサウンドをファイルまたはデータベースに格納します。

ダイアログ・ボックス・オプション

データベース

エクスポートするサウンドをデータベースに格納することを指定します。「参照」をクリックすると、「データベースにエクスポート」ダイアログ・ボックスが表示されます。

ファイル

エクスポートするサウンドをデータベースに格納することを指定します。

フォーマット

サウンドをエクスポートするときの形式を指定します。

コード化

サウンドをエクスポートするときに使用するコード化方式を指定します。サウンドをエクスポートする時の形式によって、オプションは変わります。

データ型

サウンドをエクスポートするときのデータ型を指定します。

圧縮

サウンドをエクスポートするときの圧縮方式を指定します。サウンドをエクスポートする時の形式によって、オプションは変わります。

レート

サウンドをエクスポートするときのサンプリング・レートを指定します。


「一般描画オプション」ダイアログ・ボックス

端形式、結合形式、角または中心からの描画および転送モードを設定します。

ダイアログ・ボックス・オプション

端形式

選択した線と枠の端形式を指定します。オプションの中から1つ選択してください。

結合形式

選択された線と枠の合流点の結合形式を指定します。オプションの中から1つ選択してください。

オブジェクト作成

オブジェクトをレイアウト上に描画する場合に、そのオブジェクトの描画方法を指定します。次のオプションの中から選択できます。

角から描画する	オブジェクトを描画するときクリックするポイントは、オブジェクトのバウンディング・ボックスの角のポイントです。

中心から描画する	オブジェクトを描画するときクリックするポイントは、オブジェクトのバウンディング・ボックスの中心のポイントです。

転送モード

選択されたオブジェクト（複数可）の転送モードを指定します。次のオプションの中から選択できます。

コピー	フォアグラウンド・カラーがパターンのフォアグラウンド要素に適用され、バックグラウンド･カラーがパターンのバックグラウンド要素に適用されます。

逆転コピー	バックグラウンド・カラーがパターンのフォアグラウンド要素に適用され、フォアグラウンド･カラーがパターンのバックグラウンド要素に適用されます。

バック抜き	フォアグラウンド・カラーがパターンのフォアグラウンド要素に適用され、パターンのバックグラウンド要素は逆転バック抜きになります。

逆転フォア抜き	パターンのフォアグラウンド要素が逆転バック抜きになり、フォアグラウンド・カラーがパターンのバックグラウンド要素に適用されます。

逆転バック抜き	バックグラウンド・カラーがパターンのフォアグラウンド要素に適用され、パターンのバックグラウンド要素は逆転バック抜きになります。

フォア抜き	パターンのフォアグラウンド要素が逆転バック抜きになり、バックグラウンド・カラーがパターンのバックグラウンド要素に適用されます。

モノコピー（透明）	フォアグラウンド・カラーがモノコピー（透明）になり、パターンのフォアグラウンド要素に適用され、パターンのバックグラウンド要素は逆転バック抜きになります。

逆転モノコピー（透明）	パターンのフォアグラウンド要素が逆転バック抜きになると、バックグラウンド・カラーがモノコピー（透明）になり、パターンのバックグラウンド要素に適用されます。

「モノコピー（透明）」転送モードのプロパティの1つとして、ビルトイン・プロシージャOG_DRAWを使って、反転されたオブジェクトを2度描画する場合、その2つの描画は互いに取り消し合うので、そのオブジェクトは（存在していても）レイアウト上に表示されません。


「イメージ描画オプション」ダイアログ・ボックス

イメージの品質および粗さオプション（ディザー）を設定します。

ダイアログ・ボックス・オプション

イメージの品質

Graphics Builderで表示するイメージの品質を指定します。高品質のイメージを選択すると、画面の再描画が遅くなります。

イメージの粗さ

Graphics Builderでイメージをディザリング処理するかを指定します。ディザリングとは、Graphics Builderで、イメージの色の中で現在のカラー・パレットにはない色をシミュレーションする処理です。イメージをディザリング処理しないと、Graphics Builderは、使用可能な色のうち、それらの色に最も近い色をかわりに使用します。ディザリング処理されたイメージは品質がよくなりますが、画面の再描画が遅くなります。


「インポート」ダイアログ・ボックス

ファイルに格納されたモジュールを取り込んで表示します。

ダイアログ・ボックス・オプション

データ・ソース

インポートするモジュールの位置と形式を指定します。

ファイル・システム	モジュールをファイルからロードします。

データベース	モジュールをデータベースからロードします。「参照」をクリックすると、「データベースからインポート」ダイアログ・ボックスが表示されます。

フォーマット	インポートするモジュールの書式を指定します。インポートするモジュールのタイプによって使用可能なオプションが変わります。

オプション

数種類のオプションを指定できます。

アクティブ・レイヤーへインポート	インポートされたオブジェクトをアクティブ・レイヤーに置くかどうかを指定します。アクティブ・レイヤーに置かない場合、そのオブジェクトは新規作成されたレイヤーに置かれます。

インポート・カラー・パレット使用	インポートした描画カラー・パレットを表示されたカラー・パレットと置き換えるかどうかを指定します。このオプションは、表示されたカラー・パレット・モードが「編集可能」である場合のみ使用可能です。


「図表インポート」ダイアログ・ボックス

データベースまたはファイルに保存された図表を現在の図表にマージします。

ダイアログ・ボックス・オプション

データベース

データベースから図表をインポートする場合に指定します。

ファイル

ファイルから図表をインポートする場合に指定します。

図表名

インポートする図表の名前。これは、データベースにある図表名または図表ファイルのパスとファイル名のどちらかです。

アクティブ・レイヤー結合

インポートされた図表のアクティブ・レイヤーから現在オープンされている図表のアクティブ・レイヤーへ、オブジェクトを配置します。

インポート・カラー・パレット使用

現在のカラー・パレットを、インポートされた図表のカラー・パレットに置き換えます。このオプションは、現在表示されたカラー・パレット・モードが「編集可能」である場合のみ有効です。

名前重複の解決

現在の図表のオブジェクトとインポートされた図表のオブジェクトの間で名前の重複が発生した場合の動作を指定します。

既存オブジェクトを置換	現在の図表の重複オブジェクトを、インポートされた図表のオブジェクトに置き換えます。

インポート・オブジェクトを破棄	インポートされた図表の重複オブジェクトはインポートされず、現在の図表の既存オブジェクトをそのまま残します。

各重複箇所で確認	Graphics Builderがオブジェクト間の重複を検出するたびに、それを解決するように指示されます。

インポート

このダイアログで設定されたオプションに従って図表をインポートします。


「データベースからインポート」ダイアログ・ボックス

データベースに現在格納されているモジュールのリストを表示します。

ダイアログ・ボックス・オプション

リスト更新

格納されているモジュールのリストを更新します。

名前

インポートするモジュールの名前。表示されたリストの中からモジュール名を選択するか、またはこのテキスト・ボックスに直接入力できます。

OK

選択されたモジュールをインポートします。


「イメージ・インポート」ダイアログ・ボックス

ビットマップ・イメージを現在のレイアウトに挿入します。

ダイアログ・ボックス・オプション

データベース

データベースからイメージをインポートする場合に指定します。

ファイル

ファイル形式のイメージをインポートする場合に指定します。

フォーマット

インポートするイメージの形式を指定します。

質

イメージのインポート時の品質を指定します。これは、複数の品質設定に対応するイメージ形式にのみ適用されます。


「サウンド・インポート」ダイアログ・ボックス

現在の表示にサウンドをロードします。

ダイアログ・ボックス・オプション

データベース

データベースからサウンドをインポートする場合に指定します。

ファイル

ファイル形式のサウンドをインポートする場合に指定します。

フォーマット

インポートするサウンドの形式を指定します。


「レイアウト設定」ダイアログ・ボックス

レイアウト・サイズおよびページ方向オプションを設定します。

注意: Graphics Builderでは、実際のレイアウト・サイズは、表示されたページ・サイズの完全な倍数になります。このダイアログに入力されたレイアウト・サイズは、最小の大きさを指定します。この後Graphics Builderがページを追加または削除して、ここで指定された大きさに合せます。

ダイアログ・ボックス・オプション

レイアウト・サイズ

レイアウトの水平および垂直の寸法を指定します。

単位

レイアウト・サイズを指定するための寸法の単位を指定します。

ページ方向

印刷時にレイアウトがページ上に割り振られる方向を指定します。次のオプションの中から選択できます。

左から右	レイアウトがページの左から右に割り振られるように指定します。

上から下	レイアウトがページの上から下に割り振られるように指定します。


「モジュール・アクセス」ダイアログ・ボックス

データベース・モジュールにフル・アクセスできるユーザーのリストを表示します。

ダイアログ・ボックス・オプション

ユーザー

アクセス権限を付与または取消しするユーザー名。ユーザー名は、表示されるリストから選択するか、またはこのフィールドに直接入力します。

追加

「ユーザー」フィールドにリストされたユーザーをアクセス・リストに追加し、データベース・モジュールへのフル・アクセス権を付与します。

削除

「ユーザー」フィールドにリストされたユーザーをアクセス・リストから削除し、ユーザーのデータベース・モジュール・アクセス権を取り消します。


「データベース上モジュールへのアクセス」ダイアログ・ボックス

データベースに現在格納されているモジュールのリストを表示します。

ダイアログ・ボックス・オプション

名前

アクセス権限を変更するモジュールの名前。表示されたリストの中からモジュール名を選択するか、またはこのフィールドに直接入力できます。

リスト更新

格納されているモジュールのリストを更新します。

OK

選択されたモジュールのアクセス権限を設定します。このボタンを選択すると、「モジュール・アクセス」ダイアログ・ボックスが表示されます。


「新規問合せ」ダイアログ・ボックス

作成するチャートで使用する「問合せ」を作成します。

設定するオプションのダイアログ・タブを選択してください。

「問合せ」タブ

「データ」タブ

「スキーマ」タブ（カスタム問合せのみ）


「問合せ」タブ

問合せの名前、データ・ソースおよび（必要があれば）SQL文を設定します。

ダイアログ・ボックス・オプション

名前

問合せの名前です。

タイプ

問合せのタイプです。次のオプションから1つ選択してください。

SQL文 	問合せにより、指定したSQL SELECT文を基準にして、データがデータベースから取り出されます。「SQL文」テキスト・ボックスにSQL文を入力してください。

SYLKファイル	問合せは、SYLK書式のファイルからデータを検索します。SYLKは、Microsoft Excelなどのアプリケーションで使用されている書式です。問合せを実行すると、データはこのファイルから読み込まれます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

WKSファイル	問合せにより、データがWKS書式のファイルから取り出されます。WKSは、Lotus 1-2-3などの人気のアプリケーションに使用される書式です。問合せを実行すると、そのファイルからデータを読み込みます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

PRNファイル	問合せにより、データがPRN書式のファイルから取り出されます。PRNは、テキスト・ファイル書式です。問合せを実行すると、データはこのファイルから読み込まれます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

カスタム	ユーザーは問合せの列およびデータをカスタマイズできます。列を設定するには、「スキーマ」タブの制御を使用します。データを設定するには、ビルトイン・プロシージャOG_APPEND_ROWを使用します。

外部SQLファイル	問合せにより、データがSQL SELECT文を含むテキスト・ファイルから取り出されます。問合せを実行すると、SQL文がこのファイルから読み込まれ実行されます。使用するファイルを「ファイル」テキスト・ボックスに指定してください。

ファイル

SYLK、WKS、PRNまたは外部SQL問合せに使用するファイルの位置と名前を表示します。ユーザーのファイル・システムにファイルを位置付けるには、「参照」をクリックします。

参照

ファイル名を探して選択し、「ファイル」テキスト・ボックスに表示させることができます。

SQL文

SQL文の問合せにおいて実行されるSQL SELECT文です。

接続

「接続」ダイアログ・ボックスが表示され、データベースへの接続が可能になります。

SQLインポート

テキスト・ファイルの内容を「SQL文」テキスト・ボックスに設定できます。テキストはコピーされますが、ファイルにはリンクされません。あるファイルのSQLテキストへのリンクを作成する場合は、外部SQLファイルの問合せタイプを使用してください。

SQLエクスポート

「SQL文」テキスト・ボックスの内容をファイルに設定できます。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。


「データ」タブ

問合せにより戻されるデータを表示します。セルをクリックすると、データ表示部の上のテキスト・ボックスにそのセルの内容が表示されます。データ表示部の最上行に、列名とデータ型が表示されます。

ダイアログ・ボックス・オプション

データ消去

取り出されたすべてのデータのデータ・キャッシュを消去します。これを使用しても、その問合せ自体が削除されたり、変更されることはありません。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。


「スキーマ」タブ

（カスタム問合せのみ。）カスタム問合せにおける列の名前やデータ型を作成、削除および設定します。

ダイアログ・ボックス・オプション

列

変更する列を選択します。この問合せに対して定義されたすべての列がこのリストに表示されます。

名前

列の名前です。列名を変更するには、新しい名前を入力して、「適用」をクリックします。

タイプ

列のデータ型。

最大長

列に入るデータの最大の長さ。これは、データ型がCHARの列にのみ適用されます。

新規列

新しい列を問合せに追加します。

列削除

現在の列を問合せから削除します。

実行

現在の問合せを実行します。問合せがSQL SELECT文である場合は、データはデータベースから取り出されます。問合せによりデータがファイルから取り出される場合は、そのファイルが読み込まれます。問合せがカスタムの問合せである場合は、そのカスタムの問合せプロシージャが実行されます。


「数値書式」ダイアログ・ボックス

使用可能な数値書式マスクを追加、削除または適用します。

ダイアログ・ボックス・オプション

フォーマット

リストへ追加、リストから削除またはオブジェクトへ適用する書式文字列。これは、有効な数値書式マスクであることが必要です。詳細は、『Oracle7 Server SQL言語リファレンス』を参照してください。

追加

「書式」テキスト・ボックスに表示されている書式マスクを、使用可能な書式のリストに追加します。

削除

「書式」テキスト・ボックスに表示されている書式マスクを、使用可能な書式のリストから削除します。

OK

変更を確定し、ダイアログ・ボックスをクローズします。選択された書式マスクが、適用可能な場合は選択されたオブジェクトに適用されます。


「データベースからオープン」ダイアログ・ボックス

データベースに現在格納されているモジュールのリストを表示します。

ダイアログ・ボックス・オプション

名前

オープンする図表の名前。図表名は表示されたリストから選択するか、またはこのフィールドに直接入力することができます。

リスト更新

格納されている図表のリストを更新します。

OK

「名前」フィールドに表示される名前の図表をオープンします。


「改名」ダイアログ・ボックス

このダイアログでは、データベースに現在格納されているモジュールのリストが表示されます。

ダイアログ・ボックス・オプション

旧名

改名するモジュールの現在の名前です。

新規名

モジュールの新しい名前です。

リスト更新

格納されているモジュールのリストを更新します。

改名

「旧名」テキスト・ボックスに指定されたモジュール名を、「新規名」テキスト・ボックスに入力された名前に変更します。


「丸い四角形描画オプション」ダイアログ・ボックス

丸い四角形の角の丸め半径を設定します。

ダイアログ・ボックス・オプション

角の丸め半径

丸い角を形成する円弧がそのまま続けて360度のパスをたどった場合、形成されると考えられるだ円の半径を指定します。次の値を設定できます。

水平	架空のだ円の水平(またはx-)半径。

垂直	架空のだ円の垂直(またはy-)半径。

単位   	水平および垂直半径を指定するときの寸法の単位。


「定規設定」ダイアログ・ボックス

単位

定規で使用される寸法の単位を指定します。

文字セル・サイズ

文字セル単位の水平および垂直サイズをポイントで表します。

格子間隔

格子線を引く時の間隔（選択した寸法の単位による）を表示します。選択肢から1つ選択するか、カスタム値を「他」テキスト・ボックスに入力します。

格子当りのスナップポイント数

格子線間のスナップポイント数を指定します。スナップポイントを使うと、オブジェクトをレイアウト中に配置しやすくなります。格子線間にあるスナップポイント数が多いほど、オブジェクトを配置するときの微妙な間隔を制御できます。

選択肢から1つ選択するか、カスタム値を「他」テキスト・ボックスに入力します。


「データベースへ保存」ダイアログ・ボックス

このダイアログでは、データベースに現在格納されているモジュールのリストが表示されます。

ダイアログ・ボックス・オプション

リスト更新

格納されているモジュールのリストを更新します。

名前

保存されたモジュールが格納されるときの名前。表示されたリストの中からモジュール名を選択するか、またはこのフィールドに直接入力できます。

OK

選択されたモジュールを保存します。このときの名前が、データベース内の別の図表ですでに使われている場合、既存の図表を上書きするかどうかを聞いてきます。


「保存先」ダイアログ・ボックス

モジュールを保存するときの場所を指定します。

ダイアログ・ボックス・オプション

ファイル・システム	使用しているシステムの「ファイル名を付けて保存」ダイアログ・ボックスを表示します。

データベース	「データベースへ保存」ダイアログ・ボックスを表示します。


「テキスト描画オプション」ダイアログ・ボックス

テキストの原点、枠ボックス、ワードラップおよびその他のオプションを設定します。

ダイアログ・ボックス・オプション

水平原点

原点に対するテキスト・オブジェクトの水平位置を指定します。次のオプションの中から選択できます。

左	原点は、バウンディング・ボックスの左の枠に沿って置かれます。

中央	原点は、バウンディング・ボックスの水平中央に沿って置かれます。

右	原点は、バウンディング・ボックスの右の枠に沿って置かれます。

垂直原点

原点に対するテキスト・オブジェクトの垂直位置を指定します。次のオプションの中から選択できます。

上	原点は、バウンディング・ボックスの上の枠に沿って置かれます。

中央	原点は、バウンディング・ボックスの垂直中央に沿って置かれます。

下	原点は、バウンディング・ボックスの下の枠に沿って置かれます。

スケーラブル・フォント

テキスト・オブジェクトがサイズ変更された場合、フォントのポイント・サイズもサイズ変更するかどうかを指定します。

非表示テキスト

テキストを見えるようにするか、または見えないようにするかを指定します。

固定バウンディング・ボックス

テキスト・オブジェクトのバウンディング・ボックスをテキストの形に合せて、自動的に拡張するか縮小するかを指定します。

丸め

テキストの行がテキスト・オブジェクトの幅より長い場合、適合しない行はテキストの次の行の始めに移動します。この設定が使用不可になるのは、「固定バウンディング・ボックス」にチェック・マークが付いていない場合です。 この場合、バウンディング・ボックスを自動的にテキストの形に合せるように指定されているからです。

スケーラブルなバウンディング・ボックス

テキスト・オブジェクトがサイズ変更されたとき、バウンディング・ボックスのサイズも変更させるかどうかを指定します。この設定が使用不可になるのは、「固定バウンディング・ボックス」にチェック・マークが付いていない場合です。 この場合、バウンディング・ボックスを自動的にテキストの形に合せるように指定されているからです。


Oracleヘルプの使用

移植性のあるOracleヘルプ・インタフェースは、標準ヘルプ・システム・インタフェースのないシステムで使用されます。

Oracleヘルプ・オプション

内容

ヘルプ文書の目次が表示されます。あるトピックのヘルプ情報を表示させるには、そのトピックを選択して「ジャンプ」を実行します。

索引

ヘルプ文書の索引が表示されます。あるトピックのヘルプ情報を表示させるには、そのトピックを選択して「ジャンプ」を実行します。

履歴

「履歴」ダイアログが表示されます。「履歴」ダイアログには、現在のヘルプ・セッションで今までに参照されたヘルプ・システム・トピックのパスが表示されます。この機能を使用すると、今までにどのトピックについて、どのような順序で参照してきたかを確認できます。 また、「履歴」ダイアログ内のトピックを選択して「ジャンプ」を実行し、再度そのトピックを参照することもできます。トピックは、一番最後に参照されたものから順に表示されます。

戻る

現在参照しているトピックの1つ前に参照したトピックのヘルプ情報を表示します。連続して「戻る」を実行することもできます。 この場合、ヘルプ文書内のパスを再追跡します。実際の「後退」パスは、「履歴」ダイアログのリストで定義されます。

ブックマーク

ブックマークまたはプレースホルダを現在のヘルプ・トピックに割り当てます。後で、このトピックに戻るには、再度「ブックマーク」を選択し、「ブックマークへジャンプ」を選択します。

前（<<<）

前の章を表示します。

次（>>>）

次の章を表示します。

印刷

ヘルプ・トピックを印刷します。

検索

指定された文字列のヘルプ文書を検索します。

クローズ

ヘルプ・システムを終了し、Graphics Builderへ戻ります。


データベース・トリガー・エディタ・インタフェース

  関連項目

データベース・トリガー・エディタを使用すると、表のBEFOREトリガーまたはAFTERトリガー、ビューとオブジェクト・ビュー(Oracle8に接続している場合)のINSTEAD OFトリガーを作成および編集できます。

新規トリガーを定義するには:

1	「表所有者」ドロップダウン・リストからユーザー名（スキーマ）を選択します。

2	「表」ドロップダウン・リストから表名を選択します。

「表」ドロップダウン・リストには、「表所有者」フィールドに表示されているユーザーが所有する表の名前リストが表示されます。「表所有者」フィールドで自分以外のユーザー名を選択すると、「表」ドロップダウン・リストには、アクセス権を付与されている表のみが表示されます。

(ビューの場合のみ。）オブジェクト・ビューについてINSTEAD OFトリガーを定義するには、「表」の横にある矢印をクリックしてドロップダウン・リストを表示し、「ビュー」を選択します。次に、「ビュー」ドロップダウン・リストからビュー名を選択します。

3	「新規作成」をクリックして、新しいデータベース・トリガーを作成します。

「名前」ドロップダウン・リストで、新しいトリガーに一意のトリガー名（同じスキーマ内の他のトリガーに対して）が自動的に割り当てられます。トリガー名は変更できます。

「名前」ドロップダウン・リストには、「表」（または「ビュー」）フィールドに表示されている表（またはビュー）に関連付けられているトリガー名のリストが表示されます。このドロップダウン・リストには、自分がアクセス権を持っている表に関連付けられているデータベース・トリガーの名前のみが表示されます。

4	トリガー・オプションを指定します。

次の項では、データベース・トリガーを定義するために、データベース・トリガー・エディタで使用できるさまざまなオプションに関する情報を記載しています。

5	トリガー・オプションとアクションを指定したら、「保存」をクリックしてトリガーをコンパイルします。

トリガー・オプション

BEFORE/AFTER	(表の場合のみ。）SQLコマンドCREATE TRIGGERのBEFOREオプションまたはAFTERオプションに対応します。 実行中のトリガー文(UPDATE、INSERTまたはDELETEなど)に関連して、トリガー本体をいつ起動するかを指定します。BEFOREトリガーは、トリガー文の実行前に起動します。AFTERトリガーは、トリガー文の実行後に起動します。 BEFOREトリガーとAFTERトリガーは、行トリガーと文トリガーの両方に適用します。
INSTEAD OF	(ビューの場合のみ。）SQLコマンドCREATE TRIGGERのINSTEAD OFオプションに対応します。 Oracleでは、トリガー文を実行するかわりに、トリガーを起動します。トリガーによって、挿入、更新または削除などのアクションがビューの実表に対して直接行われます。

「文」チェックボックス

UPDATE INSERT DELETE	トリガー本体を起動するSQL文（トリガー文）のタイプを指定します。指定できるオプションは、UPDATE、INSERTおよびDELETEです。  1つ以上のチェックボックスをチェックして、トリガー文にオプションを組み込みます。 トリガー文でUPDATEを指定した場合、オプションの列リストをトリガー文に組み込むことができます。詳細は、次の「列オプション」を参照してください。 複数のオプションをチェックした場合、条件述語のUPDATING、INSERTINGおよびDELETINGを使用して、トリガー本体に含まれる特定のコード・ブロックを実行できます。詳細は、後述の「トリガー本体」を参照してください。

列オプション

列	(表の場合のみ。）SQLコマンドCREATE TRIGGERのUPDATEトリガー文に含まれるOF句に対応します。 「表」フィールドで選択された表について、列のリストを表示します。このリストは、トリガー文でUPDATEが指定されたときにのみアクティブになります。 このリスト・ボックスの列を1つ以上クリックすると、選択した列のどれか1つが更新されたときにのみトリガーが起動するように指定されます。表の任意の列が更新されたときにトリガーを起動したい場合は、リスト内の列名をクリックしないでください。 このオプションは、INSTEAD OFトリガーでは使用できません。Oracleでは、UPDATEによってビューの任意の列に含まれる値が変更されるたびに、INSTEAD OFトリガーを起動します。 Oracle8オブジェクト:ネストされた表またはLOB列は指定できません。

各（文）オプション

文	SQLコマンドCREATE TRIGGERの各（文）オプションに対応します。  トリガーを文トリガーとして指定します。Oracleでは、WHEN句で定義されたオプションのトリガー制約が満たされている場合、トリガー文の発行時に1度のみ文トリガーを起動します（トリガー文の対象となる行の数に関係なく）。 このオプションは、INSTEAD OFトリガーでは使用できません。

各(行)オプション

行	SQLコマンドCREATE TRIGGERの各（行）オプションに対応します。  トリガーを行トリガーとして指定します。Oracleでは、トリガー文の対象となる行ごとに1度のみ行トリガーを起動し、WHEN句で定義されたオプションのトリガー制約を満たします。
相関名	相関名を指定します。行トリガーのトリガー本体およびWHEN句で相関名を使用して、現在行の古い値または新しい値のみを参照できます。デフォルトの相関名はOLDとNEWです。行トリガーが、OLDまたはNEWという名前の表に関連付けられている場合、このオプションを使用して別の相関名を指定し、表名と相関名が重複しないようにします。このオプションは、行トリガーでのみ使用できます。
OLDの相関名	OLDという名前の表と名前が重複しないように相関名を指定します。
NEWの相関名	NEWという名前の表と名前が重複しないように相関名を指定します。
WHEN句の論理式	(表の場合のみ。）SQLコマンドCREATE TRIGGERのWHEN句に含まれるブールSQL式に対応します。このオプションは、行トリガーでのみ使用できます。 オプションのトリガー制限を指定します。 WHEN句にブールSQL式が組み込まれると、その式はトリガーの対象となる各行について評価されます。1つの行について式がTRUEに評価されると、トリガー本体が起動します。1つの行について式がFALSEまたはNOT TRUE(つまり、NULLと同様に不明)に評価されると、トリガー本体は起動しません。 Oracle8オブジェクト:オブジェクト列やその属性、VARRAY、ネストされた表またはLOB列を参照できます。トリガー制限内でPL/SQL関数またはメソッドをコールすることはできません。

トリガー・アクションを次の場所で指定します

トリガー本体	トリガーを起動するためにOracleが実行するPL/SQLブロック。 PL/SQLブロックを入力および編集できる、スクロール可能な複数行のテキスト・ボックス。トリガー本体には、SQL文およびPL/SQL文を組み込むことができます。BEGINとENDの各キーワードは必須です。 行トリガーのトリガー本体には、相関名とREFERENCINGオプション、および条件述語のINSERTING、DELETING、UPDATINGを組み込むことができます。 行トリガーについて、INSERTおよびUPDATEなど複数のタイプのトリガー文が指定されている場合、次に示す条件を組み込むことによって、トリガー本体内の特定のコード・ブロックのみを実行できます。 IF INSERTING THEN�END IF; IF UPDATING THEN�END IF;

エディタ内のボタンを次に示します

新規作成	新しいデータベース・トリガーを作成します。 新しいトリガーの定義を始めるには、「新規作成」をクリックします。
保存	トリガー・オプションを保存し、「トリガー本体」フィールドのソースをコンパイルします。コンパイルの結果として生成されるすべてのメッセージが、別のメッセージ・ボックスに表示されます。
変更の破棄	データベース・トリガーを、最後の保存操作または変更の破棄操作を行ったときの状態に戻します。
削除	データベースから現行のデータベース・トリガーを削除します。 削除する場合には、確認が求められます。
クローズ	データベース・トリガー・エディタを終了します。
ヘルプ	このヘルプ・トピックが表示されます。


データベース・トリガーについて

データベース・トリガーはデータベースに格納されるプロシージャで、INSERT、UPDATEまたはDELETEなどのトリガー文が関連のある表に対して発行されると、暗黙的に実行されます。トリガーは表についてのみ定義でき、ビューについては定義できません。ただし、INSERT、UPDATEまたはDELETEの各文がビューに対して発行される場合、ビューの実表に対するトリガーは起動します。

トリガーには、単位ごとに実行するSQL文またはPL/SQL文を組み込むことができ、他のプロシージャを起動できます。トリガーは必要な場合に限り使用します。トリガーを不必要に多く使用すると、トリガーのカスケード化または再帰化が発生します。たとえば、トリガーを起動すると、トリガー本体に含まれるSQL文によって他のトリガーが起動する可能性もあります。

データベース・トリガーを使用することにより、複雑な業務ルールを導入し、すべてのアプリケーションを画一化された方式で動作させることができます。トリガーを設計するときは、次のガイドラインに従います。

•	トリガーを使用するのは、特定の操作が実行されたときに、関連するアクションが確実に実行されるようにする場合です。

•	データベース・トリガーを使用するのは、トリガー文に対して起動する、一元管理された一括操作についてのみです。 この場合、文を発行するユーザーまたはアプリケーションの種類は関係ありません。

•	Oracle内にすでに組み込まれている機能と重複するトリガーは定義しないでください。たとえば、データ整合性ルールを導入するためのトリガーは定義しないでください。 このルールは、宣言整合性制約を使用して簡単に導入できます。

•	トリガーのサイズを制限します（目安は60行以下）。トリガーの論理で60行をはるかに超える数のPL/SQLコードが必要な場合は、大部分のコードをストアド・プロシージャに組み込み、トリガーからプロシージャをコールします。

•	再帰トリガーを作成しないように注意します。たとえば、それ自体がEMPに対してUPDATE文を発行するEMP表に対してAFTER UPDATE文トリガーを作成すると、トリガーは空きメモリーがなくなるまで、再帰的に起動を続けます。

トリガーをアプリケーションで使用する方法の詳細は、『Oracle8 Serverアプリケーション開発者ガイド』を参照してください。トリガーのさまざまなタイプの詳細は、『Oracle8 Server概要』を参照してください。


現行データベースの表所有者のユーザーIDを表示します。ユーザーのドロップダウン・リストを表示するには、このフィールドの右にある矢印をクリックします。


現行データベースの表またはビューの名前を表示します。「表所有者」フィールドに表示されるユーザーが所有する表またはビューのドロップダウン・リストを表示するには、このフィールドの右にある矢印をクリックします。表またはビューを選択するには、リスト内の表またはビューをクリックします。リストには、アクセス権限があるデータベースの表またはビューの名前のみが表示されます（ビューを使用できるのはOracle8のみです）。


現行データベース・トリガーの名前を表示します。「表/ビュー」フィールドに表示される表またはビューのトリガー名のドロップダウン・リストを表示するには、このフィールドの右にある矢印をクリックします。名前リストには、アクセス権限があるデータベース・トリガーの名前のみが表示されます。


トリガーを実行する文（UPDATE、INSERT、DELETEなど）の実行に対して、トリガー本体がいつ起動されるかを示します。このラジオ・ボタンのセットは、SQLコマンドCREATE TRIGGERのBEFORE、AFTERおよびINSTEAD OFオプションに対応しています。


トリガーが、トリガーを実行する文の前に起動されるように指定します。


トリガー本体が、トリガーを実行する文の後に起動されるように指定します。


トリガーを実行する文を実行するかわりに、トリガーがOracleによって起動されるように指定します。ビューの場合に限られます。


トリガー本体を起動するSQL文のタイプを指定します。指定できるオプションは、UPDATE、INSERTおよびDELETEです。オプションをアクティブにするには、1つ以上のチェックボックスをクリックします。表の場合に限られます。


トリガーが、INSERTイベントで起動されるように指定します。


トリガーが、DELETEイベントで起動されるように指定します。


トリガーが、UPDATEイベントで起動されるように指定します。


「表」フィールドで選択された表について、列のリストを表示します。このリストは、「トリガー文」フィールドでUPDATEオプションがアクティブになっている場合にのみ、アクティブになります。表の場合に限られます。


行トリガーを指定します。CREATE TRIGGERコマンドの各（行）オプションに対応しています。


文トリガーを指定します。CREATE TRIGGERコマンドの各（文）オプションに対応しています。


OLDと名付けられる更新前の表またはビューと名前が重複しないように、相関名を指定します。


OLDと名付けられる更新前の表またはビューと名前が重複しないように、相関名を指定します。


WHEN句のブールSQL式を指定します。WHEN句にブールSQL式が組み込まれると、その式はトリガーの対象となる各行について評価されます。1つの行について式がTRUEに評価されると、トリガー本体が起動します。1つの行について式がFALSEまたはNOT TRUE(つまり、NULLと同様に不明)に評価されると、トリガー本体は起動しません。表の場合に限られます。


スクロール可能な複数行のテキスト・ボックスで、PL/SQLデータベース・トリガー本体の入力や編集ができます。トリガー本体は、SQLおよびPL/SQL文を組み込めるPL/SQLブロックです。


名前の付いていない新しいデータベース・トリガーを作成します。


トリガー・オプションを保存し、「トリガー本体」フィールドのソースをコンパイルします。コンパイルの結果として生成されるすべてのメッセージが、メッセージ・ボックスに表示されます。


データベース・トリガーを、最後の保存操作または変更の破棄操作を行ったときの状態に戻します。保存操作または変更の破棄操作が行われなかった場合、データベース・トリガーは元の状態に戻ります。


データベースから現行のデータベース・トリガーを削除します。 削除する場合には、確認が求められます。


PL/SQLインタプリタ・インタフェース

PL/SQLインタプリタはデバッグ用の作業領域です。これを利用して、ソース・コードの表示、デバッグ・アクションの作成、プログラム単位の実行を行ったり、インタプリタ・コマンド、PL/SQL文およびSQL文を実行できます。

デフォルトでは、常にソース・ペインおよびインタプリタ・ペインの2つのペインがPL/SQLインタプリタで開いています。

標準ツールバー・ボタン  インタプリタ内のすべてのペインは、1つのツールバーを共有しています。「クローズ」を除く次のボタンは、プログラム単位の実行停止中のときのみアクティブになり、デバッグに使用されます。

ステップ・イン		停止中のプログラム単位の実行を再開して次の実行可能文に進みます。
ステップ・オーバー		停止中のプログラム単位の実行を再開して次の実行可能文に進み、ネストされたサブプログラムへのコールをスキップします。
ステップ・アウト		ネストされたサブプログラムの実行を再開して、コール側のプログラム単位内の次の実行可能文で実行を中断します。
実行		停止中のプログラム単位の実行を再開し、プログラム単位の終点または次のデバッグ・アクションに進みます。
リセット		現行のデバッグ・レベルを終了します。現行のデバッグ・レベルが1の場合、停止中の実行は放棄されます。
クローズ		PL/SQLインタプリタ・ウィンドウをクローズします。
ヘルプ		このヘルプ・トピックが表示されます。
ソース・ペイン  ソース・ペインでは、現在選択されているプログラム単位のソースが読込み専用で表示されます。キーワード、コメント、文字列および記号には、それぞれ別の色が付けられます。左マージンの第1列は、アイコンおよび記号用に予約されています。左マージンの第2列には、ソースの行番号が表示されます。

次のアイコンが表示される場合もあります。

黄色の矢印		現行の実行位置またはプログラム・カウンタ（program counter）(PC)を示します。
赤色のボール		使用可能なブレークポイントまたはトリガーを示します。
緑色のボール		使用不可のブレークポイントまたはトリガーを示します。

次の記号がソース・ペインに表示される場合もあります。

|	現行のソース位置を示します。  現行のソースの位置は、インタプリタ・コマンド（LISTなど）の結果、またはプログラム単位の実行がデバッグ・アクション（ブレークポイントなど）によって割り込まれたときに変わります。
B(n)	ブレーク・ポイントの位置を示します。 nは対応するデバッグ・アクションIDです。
T(n)	デバッグ・トリガーの位置を示します。 nは対応するデバック・アクションIDです。

ソース・ペインは、ポップアップ・メニュー（ウィンドウで右クリック）から次のコマンドを提供します。

ブレーク	新しいブレーク・ポイントを定義する「PL/SQLブレークポイント」ダイアログ・ボックスを表示します。
トリガー	「PL/SQLトリガー」ダイアログ・ボックスが表示され、新しいデバッグ・トリガーを定義できます。
編集	プログラム単位エディタが表示され、現行のプログラム単位を編集できます。
注意: 一部のシステムでは、ポップアップ・メニューをサポートしていません。前述のコマンドは、「デバッグ」メニューからも使用可能です。

分割バー  分割バーを使用して、インタプリタの各ペインが占める領域の相対量を変更できます。最初にインタプリタが表示されると、分割バーはソース・ペインとインタプリタ・ペインの間に置かれます。モーダル・インタプリタを使用しているか、またはモードレス・インタプリタにナビゲータ・ペインを挿入した場合、2次分割バーが表示されます。

インタプリタ・ペイン  インタプリタ・ペインは、PL/SQL、Procedure BuilderおよびSQLにコマンド・ライン・インタフェースを提供します。PL/SQL>プロンプトの後に、PL/SQL文やPL/SQLブロック、Procedure Builderのインタプリタ・コマンド、またはSQL文を入力できます（SQL*Plus文および構文はサポートされていません）。

マルチライン・コマンド  PL/SQL>プロンプトでのPL/SQL構文の入力時に、いつでも[Enter]キーを押し+>の形式で2つ目のプロンプトを表示できます。終了のセミコロン（;）付きコードを実行するまで、必要なだけ後続のプロンプトを表示することができます。

デバッグ・レベル  デバッグ・アクションによってプログラムの実行が中断された場合、インタプリタはデバッグ・レベルを確立します。デバッグ・レベルではコマンドおよびPL/SQL文を入力でき、それらが逆に割り込まれることによって、デバッグ・レベルがネストされる場合もあります。現行のデバッグ・レベルは、そのレベル番号を含む接頭辞が付いたインタプリタ・ペインの新規プロンプトに示されます。たとえば、デバッグ・レベル1では、インタプリタ・プロンプトが次のように表示されます。

（デバッグ 1）PL/SQL>

ポップアップ・メニュー  インタプリタ・ペインは、ポップアップ・メニュー（ウィンドウで右クリック）から次のコマンドを提供します。

消去	インタプリタ・ペインのすべてのテキストを廃棄し、新規プロンプトを発行します。
新規プロンプト	インタプリタ・ペインで新規プロンプトを発行します。前のプロンプトでの入力は、すべて無視されます。
注意: 一部のシステムでは、ポップアップ・メニューをサポートしていません。

ナビゲータ・ペイン  オブジェクト・ナビゲータ・ペインを使用して、現行のコール・スタックが表示できるほか、デバッグ中に現行の有効範囲の位置で、ローカル変数やパラメータの値を表示したり、任意に変更することもできます。

プログラム単位のデバッグ中に完全にインタプリタ内で作業したい場合は、ソース・ペインとインタプリタ・ペインの間に、オブジェクト・ナビゲータ・ペインを挿入できます。ナビゲータ・ペインを挿入するには、メニューから「表示」 [image] 「ナビゲータ・ペイン」を選択します。ナビゲータ・ペインを隠すには、同じコマンドをもう一度選択します。「表示」メニューから適切なコマンドを選択することにより、他のペインを隠すこともできます。

ナビゲータ・ツールバー　ナビゲータ・ペインが表示されると、以下の項目もボタン・バーに表示されます。

作成		現在選択されているオブジェクトまたはノードの新規インスタンスを作成します。
削除		選択されたオブジェクトを確認の上削除します。
拡張		現在選択されているノードのサブノードの最初のレベルを拡張します。
縮小		現在選択されているノードのサブノードの現行レベルを縮小します。
すべて拡張		現在選択されているノードのサブノードのすべてのレベルを拡張します。ただし、Oracle8のデータ型および属性のノードを再帰的に拡張はしません。
すべて縮小		現在選択されているノードのサブノードのすべてのレベルを縮小します。
検索（テキスト・ボックス）		オブジェクトの一部またはすべての名前を入力することにより、ナビゲータ内でオブジェクトを検索できます。
順方向検索		「検索」テキスト・ボックスに指定した検索条件の次に一致する項目を検索します。
逆方向検索		「検索」テキスト・ボックスに指定した検索条件の1つ前に一致する項目を検索します。


停止中のプログラム単位の実行を再開して次の実行可能文に進みます。


停止中のプログラム単位の実行を再開して次の実行可能文に進み、ネストされたサブプログラムへのコールを飛ばします。


ネストされたサブプログラムの実行を再開して、コール側のプログラム単位内の次の実行可能文で実行を中断します。


停止中のプログラム単位の実行を再開し、プログラム単位の終点または次のデバッグ・アクションに進みます。


現行のデバッグ・レベルを終了します。現行のデバッグ・レベルが1の場合、停止中の実行は放棄されます。


現在選択されているオブジェクトまたはノードの新規インスタンスを作成します。


選択されたオブジェクトを確認の上削除します。


現在選択されているノードのサブノードの最初のレベルを拡張します。


現在選択されているノードのサブノードの現行レベルを縮小します。


現在選択されているノードのサブノードのすべてのレベルを拡張します。Oracle8のデータ型および属性のノードは、再帰的に拡張されません。


現在選択されているノードのサブノードのすべてのレベルを縮小します。


ナビゲータ内で検索するオブジェクトの名前を入力します。


現行のプログラム単位の名前を指定し、それがクライアント上にあるかサーバー上にあるかを示します。


現在選択されているプログラム単位のソースを、ソースの第2列に行番号を付けて読込み専用で表示します。


インタプリタ内の各ペインが占める領域の相対量を変更できます。最初にインタプリタが表示されると、分割バーはソース・ペインとインタプリタ・ペインの間に置かれます。モーダル・インタプリタを使用しているか、またはモードレス・インタプリタにナビゲータ・シートンを挿入した場合、2次分割バーが表示されます。


現行のコール・スタックが表示できるほか、デバッグ中に現行の有効範囲の位置で、ローカル変数やパラメータの値を表示したり、任意に変更することもできます。


PL/SQL、Procedure BuilderおよびSQLにコマンド・ライン・インタフェースを提供します。PL/SQL>プロンプトの後に、PL/SQL文またはPL/SQLブロック、Procedure Builderのインタプリタ・コマンド、またはSQL文を入力できます。


エラー・メッセージについて

各コンポーネントには、次に示す一意のエラー・メッセージ接頭辞があります。

接頭辞	コンポーネント
FRM	Form Builder
OG	Graphics Builder
PDE	Procedure Builder
REP	Reports Builder
BRW	Query Builder
BRS	Schema Builder
NX, XBD	Translation Builder
注意: UNIXでは、Report Builderにより、いくつかのメッセージに表示される$status変数の値は0(正常終了)または1(異常終了)に設定されます。

Forms DeveloperおよびReports Developerのエラー・メッセージに加え、次に示す他のソースからのエラー・メッセージが発生する場合があります。

接頭辞	ソース	ヘルプ
ORA	Oracle Server	『Oracle8 Serverエラー・メッセージ』
PLS	PL/SQL	『Oracle8 Serverエラー･メッセージ』
『Oracle8 Serverエラー・メッセージ』には、SQL*DBA、SQL*Loader、SQL*Module、エクスポート、インポート、Oracleプリコンパイラなど、すべてのデータベース・ユーティリティのエラー・メッセージ・コードと説明が挙げられています。

システム固有のエラー・メッセージについては、オペレーティング・システムのマニュアルに記述されています。


サポート担当への連絡

エラーによっては（内部エラーなど）、エラー報告のためサポート担当に連絡が必要なものがあります。カスタマ・サポートに連絡する場合、次の情報を用意しておいてください。

1	氏名、会社名およびOracleサポートID番号。

2	ハードウェア、オペレーティング・システムおよび使用しているオペレーティング・システムのリリース番号。

3	エラー発生時に使用していたコンポーネントの完全なバージョン番号、および改訂番号とポート・リリース番号（存在する場合）。（コンポーネントのバージョン番号が不明な場合は、「ヘルプ」 [image] 「バージョン情報」を選択してください。）

4	エラー発生時に使用していたその他のすべてのコンポーネント（およびバージョン番号）（たとえば、Oracle 8.0.4）。

5	1つ以上のエラー・メッセージが発生した場合、それらが現れた順に、正確なメッセージ番号と説明。

6	問題の説明（異常な状態など）。

7	次のコードに基づいた、問題の重大度。

•	1:  プログラムが使用できない。操作に重大な影響がある。

•	2:  プログラムは使用できる。操作がかなり制限される。

•	3:  プログラムは使用できるが機能に制限がある。全体の操作に重大な影響はない。

•	4:  使用方法が限定される。操作にはわずかな影響しかない。


異常な状態

時々、異常な状態として知られているエラーが発生する場合があります。これは、次に挙げる原因から起きる可能性があります。

•	アプリケーションが要求されたタスクを完了できない事態が生じました。たとえば、誰かが標準のユーザー・インタフェースを使用せずに、データベースの表の中のデータを変更した場合、無効な値を入力する可能性があります。

•	ソフトウェアのバグが、要求されたタスクの完了を妨げました。

対策  まず、メッセージがForms DeveloperおよびReports Developer以外のものが原因で起きたかどうかを確認するため、システム管理者に連絡してください。メッセージがユーザー・エラーやシステム問題から発生したのではないことが確認された場合、サポート担当に連絡してください。


PL/SQL V1変換ユーティリティについて

  関連項目

PL/SQL V1変換ユーティリティは、PL/SQL V1またはV2で作成されたアプリケーションをアップグレードするプロセスを自動化するときに役立ちます。

フォーム、レポートおよび図表のトリガー、プログラム単位およびPL/SQLブロックが、PL/SQL V1またはV2で書かれている場合、コードはアップグレードする必要があります。アップグレードを行わないと、次の2種類の問題が発生する可能性があります。

•	PL/SQL V1またはV2コードの中には、それより後のバージョンでは構文上有効でないためにコンパイル・エラーを起こすものがあります。

•	PL/SQL V1またはV2コードの中には、それより後のバージョンでは構文上は正しいが、意味が異なるため、予期しない動作や不正な動作を起こすものがあります。

変換ユーティリティは、この両方の問題に対応します。


PL/SQL V1変換ユーティリティの実行方法

  関連項目

変換ユーティリティは、対話形式またはバッチ・モードで使用できます。いずれの場合も、ユーティリティによりコードを実際に更新するかどうかは、ユーザーが制御します。対話形式モードでは、ユーティリティによる変更も、手動での変更も可能なため、柔軟性があります。バッチ・モードでは、ユーティリティは可能な変換をすべて行うか、まったく行わないかのどちらかです。変換は対話形式モードまたはバッチ・モードのいずれかで行われても、変換処理の概略がmodule.plgというログ・ファイルに記録されます。

ユーティリティを対話形式で実行するには、対応するBuilderで、保存されたフォーム、レポート、図表、またはPL/SQL V1またはV2コードを含むライブラリをオープンします。

ユーティリティをバッチ・モードで実行する場合、次の項目を参照してください。

•	バッチ・モードでのフォームの変換

•	バッチ・モードでのレポートの変換

•	バッチ・モードでの図表の変換

ヒント

変換ユーティリティはコードをアップグレードし、V1またはV2の非互換性の一部を解決しますが、変換ユーティリティで対処できない場合もあります。その場合は、コンパイル・エラーとなります。 変換結果は「PL/SQL V1の変換サマリー」ダイアログ・ボックス（対話形式モード）またはログ・ファイルに表示されるので、手動でエラーに対処できます。詳細は、「PL/SQL V1変換ユーティリティでは変換されないもの」を参照してください。

変換ユーティリティによるアプリケーションの変換、保存後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。


使用するモードを決定する前に、各タイプのいくつかのモジュールを対話形式で変換してみます。これで、各タイプのモジュールで発生しているのが、どういう種類の問題なのかわかるので、今後の進め方を決定するのに役立ちます。たとえば、レポートおよびPL/SQLライブラリをバッチ・モードで確実に変換できても、フォームが対話モードで提供されるクローズ監視を必要としていることを発見できる可能性もあります。


対話形式によるPL/SQL V1変換ユーティリティの使用

  関連項目

変換ユーティリティを対話形式で実行するには、対応するBuilderで、保存されたフォーム、レポート、図表、またはPL/SQL V1またはV2コードを含むライブラリをオープンし、アプリケーションを保存します。

重要事項:

•	変換ユーティリティによるアプリケーションの変換、保存後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。

トリガー内の各PL/SQL V1またはV2文、PL/SQLブロックまたはプログラム単位は、「変換」ダイアログ・ボックス内に表示されます。このダイアログ・ボックスには、変換を選択した場合に変換ユーティリティによって実行されるアクションも表示されます。提示された変更の実行、提示された変更の無視、アプリケーション全体の変換またはプロセス全体の停止を行うかについては、自由に選択できます。（「PL/SQL V1の変換オプション」ダイアログ・ボックスを使用して、変換プロセスを制御するパラメータを設定することもできます。）

変換ユーティリティによって、変更（または変更しなかった部分）が追跡され、変換プロセスの最後にmodule.plgという名前のログ・ファイルに要約されます。次にPL/SQLエディタを起動して、アプリケーションを手動で更新できます。


バッチ・モードでのPL/SQL V1変換ユーティリティの使用

  関連項目

ユーティリティをバッチ・モードで実行する場合、次の項目を参照してください。

•	バッチ・モードでのフォームの変換

•	バッチ・モードでのレポートの変換

•	バッチ・モードでの図表の変換


バッチ・モードでのフォームの変換

  関連項目

フォームをバッチ・モードで変換する手順

1	フォームに関連したすべてのPL/SQLライブラリを変換したことを確認します。

2	次のいずれかの操作を行います。

•	Forms compilerのGUIバージョンを実行します。

•	Forms compilerをコマンド・ラインで実行します。

どちらを選択しても、変換処理の概略は自動的にログ・ファイルmodule.plg(moduleは変換されたフォーム・モジュールの名前)に書き込まれます。

使用上の注意

•	変換ユーティリティによるアプリケーションの変換、保存後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。


Form CompilerGUIバージョンを使用したフォームの変換

Forms CompilerのGUIバージョンを使用したフォームの変換手順

1	「Form Compiler」アイコンをダブルクリックします。

2	適切なモジュール・タイプとモジュール・アクセスを選択します。

3	「PL/SQLをV1からV2.3にアップグレードしますか?」と書かれたボックスを選択します。

4	「OK」をクリックします。


コマンド・ラインでのフォームの変換

  関連項目

コマンド・ラインでForm Compilerを使用しフォームを変換する手順

コマンドラインで次のコマンドを発行します。

<Form Compiler> MODULE=form BATCH=yes UPGRADE_PLSQL=yes UPGRADE=yes

パラメータの内容は次のとおりです。

<Form Compiler>	プラットフォーム上のForm Compilerの実行可能プログラムの名前。
form	変換するフォームの名前。
使用上の注意:

•	UPGRADE=YESを同時に指定せずにUPGRADE_PLSQL=YESを指定すると、エラー・メッセージが生成されます。すべてのフォームをForms 6.0に更新しておかないと、PL/SQLをフォーム内で変換できません。 このため、UPGRADE_PLSQL= YESの場合は、UPGRADE=YESを指定する必要があります。

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。


接続されたPL/SQLライブラリのフォームへの変換

PL/SQLライブラリを対話形式で変換する手順

 Form Builder内でライブラリをオープンし、保存します。

Form CompilerのGUIバージョンを使用して、PL/SQLライブラリを変換する手順

1	「Form Compiler」アイコンをダブルクリックします。

2	「ファイル」フィールドで、変換するPL/SQLライブラリを選択します。

3	「出力内容の書き込み先ファイル」フィールドで、ターゲット・ファイルに拡張子.PLLが付いていることを確認します。

4	「OK」をクリックします。

コマンド・ラインでForm Compilerを使用しPL/SQLライブラリを変換する手順

コマンドラインで次のコマンドを発行します。

<Form Compiler> MODULE=library BATCH=yes UPGRADE_PLSQL=yes UPGRADE=yes

パラメータの内容は次のとおりです。

<Form Compiler>	プラットフォーム上のForm Compilerの実行可能プログラムの名前。
library	変換するライブラリの名前。
使用上の注意

•	UPGRADE=YESを同時に指定せずにUPGRADE_PLSQL=YESを指定すると、エラー・メッセージが生成されます。すべてのフォームをForms 6.0に更新しておかないと、PL/SQLをフォーム内で変換できません。 このため、UPGRADE_PLSQL= YESの場合は、UPGRADE=YESを指定する必要があります。

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。


Form Compilerパラメータの指定

次の表は、BATCH、UPGRADEおよびUPGRADE_PLSQLのパラメータの組合せの違いにより、変換処理にどのような影響があるかを示しています。

BATCH	UPGRADE_PLSQL	UPGRADE	動作
NO	YES	YES	フォーム内のPL/SQLは、バッチ・モードで変換されます(BATCH=NOの場合も)。ユーティリティは、Builderの外から対話形式で起動できません。
YES	YES	YES	フォーム内のPL/SQLは、バッチ・モードで変換されます。
NO	NO	YES	フォーム内のPL/SQLは変換されませんが、推奨される変換の一覧がmodule.plgに書き込まれます。フォームは、Forms 6i にアップグレードされます。
YES	NO	YES	フォーム内のPL/SQLは変換されませんが、推奨される変換の一覧がmodule.plgに書き込まれます。フォームは、Forms 6i にアップグレードされます。
NO	NO	NO	FMBを変更することなく新規のFMXをコンパイルする場合に使用します。フォームにV1.3のPL/SQLが含まれる場合、コンパイラ・エラーが発生するか、コードが異なる動作を起こす場合があります。
YES	NO	NO	FMBを変更することなく新規のFMXをコンパイルする場合に使用します。フォームにV1.3のPL/SQLが含まれる場合、コンパイラ・エラーが発生するか、コードが異なる動作を起こす場合があります。
重要事項:

45FMTから60FMBへのアップグレードを、UPGRADE_PLSQLオプションを指定せずに行うと、フォーム内のPL/SQLは変換されません。ただし、変換されるべきフォームがログ・ファイルに記録されます。このログ・ファイルは現行のワーキング・ディレクトリに保存されるため、FMTファイルが保存されているディレクトリとは異なる場合があります。


バッチ・モードでのレポートの変換

レポートをバッチ・モードで変換する手順

1	レポートに接続したPL/SQLライブラリをすべて変換したことを確認します。

2	次のいずれかの操作を行います。

•	Report CompilerのGUIバージョンを実行します。

•	コマンド・ラインからReport Compilerを実行します。

どちらを選択しても、変換処理の概略は自動的にログ・ファイルmodule.plg(moduleは変換されたレポート・モジュールの名前)に書き込まれます。モジュールごとに個別のログが生成されます。

使用上の注意

•	変換ユーティリティによるアプリケーションの変換、保存後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。


Report CompilerのGUIバージョンを使用したレポートの変換

Report CompilerのGUIバージョンを使用し、1つ以上のレポートを変換する手順

1	「Report Compiler」アイコンをダブルクリックします。

2	「文書タイプ」フィールドで、「レポート」を選択します。

3	適切な「ソース・タイプ」および「宛先タイプ」を選択します。

4	「ソース」フィールドの「参照」ボタンを使用し、変換するレポートの位置を確認します。

5	「宛先」フィールドの「参照」ボタンを使用し、変換したレポートの宛先を選択します。

6	「OK」をクリックします。


コマンド・ラインでのレポートの変換

1つ以上のレポートをコマンド・ラインで変換する手順

コマンドラインで次のコマンドを発行します。

<Report Compiler> SOURCE=rep1,rep2, UPGRADE_PLSQL=yes

パラメータの内容は次のとおりです。

<Report Compiler>	プラットフォーム上のReport Compilerの実行可能プログラムの名前。
rep1,rep2,	変換するレポートの名前。


接続されたPL/SQLライブラリのレポートへの変換

PL/SQLライブラリを対話形式で変換する手順

 Report Builder内でライブラリをオープンし、保存します。

Report CompilerのGUIバージョンを使用して、PL/SQLライブラリを変換する手順

1	「Report Compiler」アイコンをダブルクリックします。

2	「文書タイプ」フィールドで、「PL/SQLライブラリ」を指定します。

3	「ソース・タイプ」フィールドで、.PLLを指定します。

4	「宛先タイプ」フィールドで、.PLLまたは.PLXを指定します。.PLDを指定すれば、V1またはV2のPL/SQLは変換されません。

コマンド・ラインでReport Compilerを使用してPL/SQLライブラリを変換する手順

 コマンドラインで次のコマンドを発行します。

<Report Compiler> SOURCE=lib1,lib2, UPGRADE_PLSQL=yes

パラメータの内容は次のとおりです。

<Report Compiler>	プラットフォーム上のReport Compilerの実行可能プログラムの名前。
lib1, lib2	変換するライブラリの名前。
使用上の注意

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。


バッチ・モードでの図表の変換

バッチ・モードで図表を変換する手順

1	図表に関連するすべてのPL/SQLライブラリの変換が終了したことを確認します。

2	次のコマンドを発行します。

<Graphics Builder> openfile=temp.ogd upgrade_plsql=yes savefile=temp1.ogd quit=yes

パラメータの内容は次のとおりです。

<Graphics Builder>	プラットフォーム上のGraphics Builderの実行可能プログラムの名前。
openfile=temp.ogd	Graphics Builderで図表temp.ogdをオープンします。
upgrade_plsql=yes	V1またはV2のPL/SQLを変換します。
savefile=temp1.ogd	変換した図表をtemp1.ogdに保存します。
quit=yes	図表が変換された後、Graphics Builderをクローズします。
使用上の注意:

•	変換処理の概略は、ログファイルmodule.plg（moduleは変換された図表の名前）に自動的に書き込まれます。

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。

•	変換ユーティリティによるアプリケーションの変換後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。


接続されたPL/SQLライブラリの図表への変換

PL/SQLライブラリを対話形式で変換する手順

 Graphics Builderでライブラリをオープンし、保存します。

PL/SQLライブラリをバッチ・モードで変換する手順

 次のコマンドを発行します。

<Graphics Builder> openfile=temp.lib upgrade_plsql=yes savefile=temp1.lib quit=yes

パラメータの内容は次のとおりです。

<Graphics Builder>	プラットフォーム上のGraphics Builderの実行可能プログラムの名前。
openfile=temp.lib	Graphics Builderでライブラリ temp.lib をオープンします。
upgrade_plsql=yes	V1またはV2のPL/SQLを変換します。
savefile=temp1.lib	変換されたライブラリを temp1.lib に保存します。
quit=yes	ライブラリが変換された後、Graphics Builderをクローズします。
使用上の注意:

•	変換処理の概略は、ログファイル module.plg（module は変換されたライブラリの名前）に自動的に書き込まれます。

•	変換ユーティリティによるアプリケーションの変換後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。


PL/SQL V1変換ユーティリティにより変換されるもの

  関連項目

次に、変換ユーティリティがアプリケーション内で解決できる場合を示します。

CHARをVARCHAR2に置換

VARCHAR2に必要な文字列の長さを設定

OUTおよびIN OUTのデフォルト式を削除

式に必須なRETURN文

廃止されたビルトインの置換

ファンクションlengthはゼロ長の文字列に対しNULLを返す

NULLを渡すオーバーロードしたサブプログラムへの対処

ファンクションにRETURN文を指定しないとランタイム・エラーが発生する

長さの制限を削除


CHARをVARCHAR2に置換

PL/SQL V1では、データ型CHARとVARCHAR2は、相互に交換して使用できました。V1より後のバージョンでは、CHARデータ型は右側にスペースが埋められます。

PL/SQL V1では、次の文は、

var1 CHAR(10) := 'hello';

'hello'に同じです。

しかしV1より後のバージョンでは、この文は'hello     '(合計で10文字)として解釈します。

CHAR変数のV1の動作を保つため、変換ユーティリティでは、すべてのCHAR(n)宣言を同義のVARCHAR2(n)文と置換します。上記の例では、var1はVARCHAR2(10)になります。

また、変換ユーティリティでは、VARCHAR文をすべて同義のVARCHAR2式と置換します。


VARCHAR2に必要な文字列の長さを設定

PL/SQL V1より後のバージョンでは、すべてのVARCHAR2変数に対して、長さの指定が必要です。CHARデータ型にすでに長さが指定されている場合、変換ユーティリティは宣言をVARCHAR2に置換する際、その長さを使用します（詳細は、「CHARをVARCHAR2に置換」を参照）。次に例を示します。

var1 CHAR(10);

は、次のように変換されます。

var1 VARCHAR2(10);

変換プログラムは、文字長のないCHARまたはVARCHAR2文を検出すると、1文字の長さを設定します。次に例を示します。

var2 CHAR;

は、次のように変換されます。

var2 VARCHAR2(1);

同様に、

var3 VARCHAR2;

は、次のように変換されます。

var3 VARCHAR2(1);

VARCHAR2宣言に対し長さを指定しないと、コンパイラで次のエラー・メッセージが生成されます。

エラー215: 文字長は1～32767の範囲に制限されています


OUTおよびIN OUTのデフォルト式を削除

  例

PL/SQL V1では、OUTパラメータとIN OUTパラメータの後にデフォルト式を続けることができましたが、この式は常に無視されていました。変換ユーティリティで、OUTパラメータとIN OUTパラメータのデフォルト式を削除します。

既存のコード（デフォルト式の付いたOUTパラメータとIN OUTパラメータを含みます）をコンパイルすると、次のエラー・メッセージが生成されます。

エラー230: OUTおよびIN OUT形式のパラメータに、デフォルト式を付けることはできません


デフォルト式の削除例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

PROCEDURE p (p1 IN OUT NUMBER DEFAULT 25,
             p2 OUT NUMBER DEFAULT 16) IS

BEGIN
. . .
END;

次のように変換します。

PROCEDURE p (p1 IN OUT NUMBER, p2 OUT NUMBER) IS

BEGIN
. . .
END;


式に必須なRETURN文

  例

PL/SQL V1では、式のないRETURN文を使用して、NULL値を返すことができました。ファンクションはすべて値を返す必要があるため、V1より後のバージョンではRETURN文が必須となります。変換ユーティリティは、式が続いていないRETURN文をすべてRETURN NULLと置換します。

式のないRETURN文を含むPL/SQLをコンパイルすると、次のエラー・メッセージが生成されます。

エラー503:このファンクションからの戻り値にはRETURN文が必要です


NULLをRETURN文に追加する例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

FUNCTION f RETURN NUMBER IS
x NUMBER;
BEGIN
x :=13;
IF .. . THEN
RETURN;
END IF;
RETURN x;
END;

次のように変換します。

FUNCTION f RETURN NUMBER IS
x NUMBER;
BEGIN
x :=13;
IF .. . THEN
RETURN NULL; ここでNULLが追加されます
END IF;
RETURN x;
END;


廃止されたビルトインの置換

  例

文字列をPL/SQLの整数に変換するTO_PLS_INTEGERビルトインは、V1より後のバージョンでは廃止されています。変換ユーティリティは、TO_PLS_INTEGERをビルトインTO_NUMBERに置換します。

TO_PLS_INTEGERビルトインを置換しないと、次のコンパイル・エラーが生成されます。

エラー201:識別されたTO_PLS_INTEGERを宣言する必要があります

注意: 廃止されているその他のビルトインは、手動で置換する必要があります。


廃止されたビルトインの置換例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

PROCEDURE foo IS
     v INTEGER;
BEGIN
     v := TO_PLS_INTEGER(24);
END;

次のように変更します。

PROCEDURE foo IS
     v INTEGER;
BEGIN
     v := TO_NUMBER(24);     TO_PLS_INTEGERはTO_NUMBERで置換されます
END;


ファンクションlengthはゼロ長の文字列に対しNULLを返す

  例

PL/SQL V1では、NULL式に適用されたファンクションlengthは、ゼロを返しました。V1より後のバージョンでは、NULL式に適用されたファンクションlengthは、NULLを返します。

V1の動作を保つために、PL/SQL変換ユーティリティはNVL SQL述語を追加して、NULL式に適用されたファンクションlengthがゼロを返すようにします。


ファンクションlengthの例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

c:=null;
l=LENGTH( c );         V1では、これが0に変わります

次のように変換します。

c:=null;
l=NVL(LENGTH( c ),0);  コンバータはNVL( )ビルトインでファンクションlength
                           をラップし、式がゼロを返すようにします


NULLを渡すオーバーロードしたサブプログラムへの対処

  例

PL/SQL V1では、パッケージ内の同じプログラム単位を2つの異なるデータ型、VARCHAR2型とRECORD型として定義できました。これをサブプログラムをオーバーロードするといいます。オーバーロードしたサブプログラムにNULL値を渡した場合、PL/SQLはデータ型をVARCHAR2と仮定しました。ただし、V1より後のバージョンでは、パッケージ内のオーバーロードしたサブプログラムにNULL値を渡す場合、そのデータ型を定義する必要があります。

V1の動作を保つために、PL/SQL変換ユーティリティは、オーバーロードしたサブプログラムに渡されたNULL値を検出すると、必要に応じて次のようなアクションを行います。

•	NULLをTO_CHAR( )でラップします。

•	NULLをTO_NUMBER( )でラップします。

•	NULLをTO_DATE( )でラップします。

•	NULLをNOTでラップします。

希望するデータ型を定義しないで、オーバーロードしたプログラム単位にNULL値を渡す場合、コンパイラで次のエラー・メッセージが生成されます。

エラー307:このコールと一致する'PU名'宣言が多すぎます...


オーバーロードしたサブプログラムにNULL値を渡す例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

PACKAGE ps1 IS
  TYPE foo IS RECORD(id PLS_INTEGER);
                              サブプログラムpがオーバーロードされます
    PROCEDURE p(a VARCHAR2);    aはVARCHAR2型の変数として定義されます
  PROCEDURE p(a FOO);         aは他のデータ型の変数としても定義されます
END;

PROCEDURE foo2 IS
BEGIN
  ps1.p(NULL);                V1では、VARCHAR2データ型が仮定されます
END;

次のように変換します。

PACKAGE ps1 IS
  TYPE foo IS RECORD(id PLS_INTEGER);

  PROCEDURE p(a VARCHAR2);
  PROCEDURE p(a FOO);

END;

PROCEDURE foo2 IS
BEGIN
  ps1.p(TO_CHAR(NULL));      aはVARCHAR2型であるためNULL値は
                                 TO_CHAR( )によってラップされます
END;


ファンクションにRETURN文を指定しないとランタイム・エラーが発生する

  例

PL/SQL V1では、ファンクションでRETURN文を省略しても実行時に問題は発生しません。ただし、V1より後のバージョンでは、ランタイム・エラーが発生します。

V1の動作を保つために、PL/SQL変換ユーティリティは、引数にNULLを持つRETURN文を、RETURN文のないファンクションに追加します。

注意: ファンクションにRETURN文がない場合でもコンパイラ・エラーは発生しませんが、V1より後のバージョンではランタイム・エラーが発生します。


RETURN文が指定されていない例

  関連項目	 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

FUNCTION noreturn (arg IN NUMBER) RETURN char IS
BEGIN
  IF (arg > 100000) THEN
    TEXT_IO.PUT_LINE ('The point of no return.');
  ENDIF;
                         RETURN文が欠落しています。
END;

次のように変換します。

FUNCTION noreturn (arg IN NUMBER) RETURN char IS
BEGIN
  IF (arg > 100000) THEN
    TEXT_IO.PUT_LINE ('The point of no return.');
  ENDIF;
  RETURN NULL;             コンパータによってRETURN NULLが追加されました。
END;


長さの制限を削除

  例

PL/SQL V2では、DATE、BOOLEAN、MLSLABEL、ROWIDの長さの制限は無視されます。ただし、このためにV8でコンパイル・エラーが発生します。

V2の動作を保つため、PL/SQL変換ユーティリティは制限を削除します。


長さの制限の削除例

  関連項目 	   すべての例

変換ユーティリティは、次のコードを、

PROCEDURE badconstraint IS
d DATE(5);
b BOOLEAN(5);
d MLSLABEL(5); --V2 のみ
r ROWID(5); --V2 のみ
BEGIN
  null;
END;

次のように変換します。

PROCEDURE badconstraint IS
d DATE;
b BOOLEAN;
d MLSLABEL; --V2のみ
r ROWID; --V2のみ
BEGIN
  null;
END;


PL/SQL V1変換ユーティリティでは変換されないもの

  関連項目

PL/SQLの多くの非互換項目は変換ユーティリティにより変換できますが、次のものは手動で修正する必要があります。

パッケージ内で必要とされる一意名

標準パッケージ・ファンクションが使用されない場合への対処

PL/SQL V2.3以降における新規予約語

変数の宣言に必要な%ROWTYPEまたは%TYPE

致命的なコンパイラ・エラーが発生し、変換プロセスが継続できない場合は、警告 "Encountered a non-recoverable error; conversion aborted at line <line number> column <column>" が表示されます。


パッケージ内で必要とされる一意名

  例

PL/SQL V1では、同一パッケージ内で変数と同じ名前を持つプロシージャまたはファンクションを作成すると、変数が常に使用され、同一名が付けられたプロシージャやファンクションは無視されました。V1より後のバージョンでは、同一パッケージ内の変数、ファンクションおよびプロシージャは、他と重複しないでください。

エラーを防ぐには、パッケージ内のすべてのプロシージャが一意の名前を持つようにします。 明示的に異なる名前を付けるか、または「Unused」という語をプロシージャ名に付けます。

注意: V1では、Procedure Builderによってビルトイン・パッケージと同じ名前のプログラム単位を作成できます。V1より後のバージョンでは、これは許可されません。Procedure Builderは、ビルトイン・パッケージと同じ名前を持つプログラム単位を検出すると、プログラム単位名の末尾に2個のドル記号$$を追加することで、ロード時にプログラム単位の名前を変更します。したがって、DEBUGはDEBUG$$に変更されます。


パッケージのプロシージャ名を一意名に変更する例

  関連項目 	   すべての例

次の例では、まずコンパイラ・エラーを生成するPL/SQL V1コードを示します。 続いてエラーを防ぐ編集例を示します。

次のコードを、

PACKAGE pk1 IS
  v1 NUMBER;           v1は変数として確立されます
  PROCEDURE v1;        v1はプロシージャとしても確立されます
  PROCEDURE p2 (x OUT NUMBER);
END;

PACKAGE BODY pk1 IS
  PROCEDURE v1 IS
  BEGIN
   .. .
  END;

  PROCEDURE p2 (x OUT NUMBER) IS
  BEGIN
x := pk1.v1;
  END;

END;

次のように変換します。

PACKAGE pk1 IS
  v1 NUMBER;
  PROCEDURE v1Unused;	  プロシージャv1はUnusedと宣言されます
  PROCEDURE p2 (x OUT NUMBER);
END;

PACKAGE BODY pk1 IS
  PROCEDURE v1Unused IS
  BEGIN
   .. .
  END;

  PROCEDURE p2 (x OUT NUMBER) IS
  BEGIN
x := pk1.v1;
  END;

END;


標準パッケージ・ファンクションが使用されない場合への対処

  例

PL/SQL V1では、次に示すようにユーザー自身のパッケージp1からファンクションFLOORをコールできました。

v := p1.FLOOR(x).

パッケージp1にファンクションFLOORがないと、PL/SQLは標準パッケージ内のファンクションFLOORを使用していました。これは、PL/SQL V2.3以降では修正されている、PL/SQLコード・エラーです。したがって、PL/SQL V2.3では、コンパイラはそのファンクション名の標準パッケージをチェックしないで、エラーを報告します。

エラー302:コンポーネント'CCCCC'を宣言する必要があります

ここで'CCCCC'は、標準パッケージ・ファンクションまたは標準パッケージ拡張にあるファンクションまたはプロシージャです。

メッセージ "Incorrect references will resolve to built-in package V1" が、ログに書き込まれます。

コンパイラで標準パッケージのファンクションを指定するには、不正なパッケージ名を削除してください。


パッケージ接頭辞の削除例

  関連項目 	   すべての例

次の例では、まずコンパイラ・エラーを生成するPL/SQL V1コードを示します。続いてエラーを防ぐ編集例を示します。

次のコードを、

PACKAGE pk1 IS a NUMBER;
END;

PROCEDURE p IS v NUMBER;
BEGIN
v := pk1.FLOOR(20.5);
END;

次のように変換します。

PACKAGE pk1 IS a NUMBER;
END;

PROCEDURE p IS v NUMBER;
BEGIN
v := FLOOR(20.5);     接頭辞を削除します
END;


PL/SQL V2.3以降における新規予約語

  例

VARIANCEはPL/SQL V2.3以降の予約語なので、この語を使用するとコンパイラ・エラーが発生します。

エラーを生成せずにVARIANCEを使用する方法の詳細は、例を参照してください。


予約語の例

  関連項目 	   すべての例

次の例では、まずコンパイラ・エラーを生成するPL/SQL V1コードを示し、続いてエラーを防ぐ編集例を示します。

例1:

次のコードを、

FUNCTION variance (y IN NUMBER)
RETURN NUMBER IS

BEGIN
     .. .
     RETURN .. .;
END;

次のように変更します。

FUNCTION varianceUniqueName (y IN NUMBER)
          /* Varianceに一意名が付けられます*/
RETURN NUMBER IS

BEGIN
     .. .
     RETURN .. .;
END;

例2:

サブプログラムをコールするときに、次のコードを、

PROCEDURE foo IS
     x NUMBER;
     y NUMBER;
BEGIN
     .. .
     x := variance(someNumber);
END;

次のように変更します。

PROCEDURE foo IS
     x NUMBER;
     y NUMBER;
BEGIN
     .. .
     x := varianceUniqueName(someNumber);
END;


変数の宣言に必要な%ROWTYPEまたは%TYPE

  例

PL/SQL V8コンパイラは、次のような不正な構文に対してエラーを生成します(PL/SQL V2では、この構文は間違って認められてしまいます)。

return variable-expression

procedure (parameter IN <table_name>)

procedure (parameter IN <table_name>.<column_name>)

正しい構文は次のとおりです。

return variable-type

procedure (parameter IN <table_name>%ROWTYPE)

procedure (parameter IN <table_name>.<column_name>%TYPE)

エラーを防ぐために、式のデータ型を使用するか、表の名前に%ROWTYPEを追加するか、列名に%TYPEを追加します。


変数の宣言例

  関連項目 	   すべての例

次の例では、まずコンパイラ・エラーを生成するPL/SQL V2コードを示し、続いてエラーを防ぐ編集例を示しています。

例1:

次のコードを、

FUNCTION return_column RETURN dept.dname IS
. . .

次のように変更します。

FUNCTION return_column RETURN dept.dname%TYPE IS
. . .

次のコードを、

PROCEDURE foo (name IN dept.dname) IS
. . .

次のように変更します。

PROCEDURE foo (name IN dept.dname%TYPE) IS
. . .

例2:

次のコードを、

FUNCTION return_table RETURN dept IS
. . .

次のように変更します。

FUNCTION return_table RETURN dept.%ROWTYPE IS
. . .

次のコードを、

PROCEDURE foo (name IN dept) IS
. . .

次のように変更します。

PROCEDURE foo (name IN dept%ROWTYPE) IS
. . .

例3:

次の例は、例外的に%TYPEを使用できない場合を示しています。

パラメータを宣言する際に、次のコードを、

FUNCTION return_parm (x IN NUMBER)
  RETURN x IS
. . .

次のように変更します。

FUNCTION return_parm (x IN NUMBER)
  RETURN number IS
. . .


「データベース・ライブラリ」ダイアログ・ボックス

「データベース・ライブラリ」ダイアログ・ボックスは、現在データベースに格納されているライブラリを表示します。

ライブラリ	接続しているデータベースで使用可能なライブラリのリスト。アクセス権限があるライブラリのみがリストに表示されます。選択するライブラリの名前をクリックします。


接続しているデータベースで使用可能なライブラリのリストです。アクセス権限があるライブラリのみがリストに表示されます。選択するライブラリの名前をクリックします。


「新規プログラム単位」ダイアログ・ボックス

「新規プログラム単位」ダイアログ・ボックスは、作成するプログラム単位の名前とタイプを指定します。

名前	プログラム単位の名前を入力します。
タイプ	作成するプログラム単位のタイプを指定します。次のタイプを作成できます。
プロシージャ	指定されたアクション・シーケンスを実行するPL/SQLサブプログラム。
ファンクション	アクションの指定されたシーケンスを実行して値を返すPL/SQLサブプログラム。
パッケージ仕様部	他のプログラム単位によって参照できるデータ型およびサブプログラム。
パッケージ本体	パッケージのインプリメンテーション。固有のサブプログラムまたはデータ型が含まれる場合もあります。パッケージが宣言のみによって構成される場合はオプションで使用します。
型仕様部	オブジェクト型またはコレクション・タイプについて、名前、変数（属性）およびメンバー・サブプログラム（メソッド）を宣言します。
型本体	オブジェクト型の型仕様部で定義されたメンバー・メソッド（ファンクションとプロシージャ）のインプリメンテーション。オブジェクト型で指定された各メソッドについて、対応するメソッド本体が存在する必要があります。
注意: タイプ仕様部およびタイプ本体は、Oracle8に接続しているときにのみ使用できます。


プログラム単位の名前を入力します。


作成するプログラム単位のタイプを指定します。


「オープン・ライブラリ」ダイアログ・ボックス

「オープン・ライブラリ」ダイアログ・ボックスは、ファイル・システムまたはデータベースから既存のライブラリをオープンし、インタプリタのOPENコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

ライブラリ	オープンするライブラリの名前（および位置）を入力します。
参照	「元」フィールドで「ファイル・システム」または「両方」が選択されていると、オペレーティング・システム・ファイルの選択ダイアログ・ボックスが表示されます。「元」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスが表示されます。
元	ライブラリが、ファイル・システムとデータベースのどちらに格納されているかを示します。


オープンするライブラリの名前（および位置）を入力します。


「元」フィールドで「ファイル・システム」または「両方」が選択されていると、オペレーティング・システム・ファイルのダイアログ・ボックスが表示されます。「元」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスが表示されます。


ライブラリが、ファイル・システムとデータベースのどちらに格納されているかを示します。


「連結ライブラリ」ダイアログ・ボックス

「連結ライブラリ」ダイアログ・ボックスは、現行セッションにライブラリを連結します。

ライブラリ	連結するライブラリの名前（および位置）を入力します。
参照	「元」フィールドで「ファイル・システム」または「両方」が選択されていると、オペレーティング・システム・ファイルの選択ダイアログ・ボックスが表示されます。「元」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスが表示されます。
元	ライブラリが、ファイル・システムとデータベースのどちらに格納されているかを示します。
連結	選択を確認してライブラリを連結し、ダイアログ・ボックスをクローズします。


連結するライブラリの名前（および位置）を入力します。


「元」フィールドで「ファイル・システム」または「両方」が選択されていると、オペレーティング・システム・ファイルのダイアログ・ボックスが表示されます。「元」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスが表示されます。


ライブラリが、ファイル・システムとデータベースのどちらに格納されているかを示します。


選択を確認してライブラリを連結し、ダイアログ・ボックスをクローズします。


「ログ・インタプリタ」ダイアログ・ボックス

「ログ・インタプリタ」ダイアログ・ボックスは、ログの実行を管理します。

ファイル	ロギング・セッションを記録するファイルの名前を入力します。
参照	オペレーティング・システムの「ファイル」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、参照を行い、位置または既存ファイルの名前を選択できます。
追加	これを選択すると、APPENDオプションがアクティブになり、現行のログ・セッションが、「ファイル」テキスト・ボックスで指定した既存のログ・ファイルの終わりに追加されます。選択しないと、指定されたファイル内の現行のログ情報はすべて、新しいロギング・セッションにより上書きされます。
使用不可	これを選択すると、DISABLEDオプションがアクティブになり、指定したファイルへのロギングが、再び使用可能にされるまで中断されます。
ログ表示	これを選択すると、「ログ・インタプリタ」ダイアログ・ボックスがアクセプトされる際に「PL/SQLインタプリタ・ログ」ブラウザが表示されます。「インタプリタ・ログ」ブラウザは、「表示」 [image] 「インタプリタ・ログ」を選択しても表示できます。


ロギング・セッションを記録するファイルの名前を入力します。


オペレーティング・システムの「ファイル」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、参照を行い、位置または既存ファイルの名前を選択できます。


これを選択すると、APPENDオプションがアクティブになり、現行のログ・セッションが、「ファイル」テキスト・ボックスで指定した既存のログ・ファイルの終わりに追加されます。選択しないと、指定されたファイル内の現行のログ情報はすべて、新しいロギング・セッションにより上書きされます。


これを選択すると、DISABLEDオプションがアクティブになり、指定したファイルへのロギングが、再び使用可能にされるまで中断されます。


これを選択すると、「ログ・インタプリタ」ダイアログ・ボックスがアクセプトされる際に「PL/SQLインタプリタ・ログ」ブラウザが表示されます。「インタプリタ・ログ」ブラウザは、「表示」-->「インタプリタ・ログ」を選択しても表示できます。


「PL/SQLインタプリタ・ログ」ブラウザ

「PL/SQLインタプリタ・ログ」ブラウザは、ロギング・セッションで記録されたメッセージを表示します。

使用不可/使用可能	現行のロギング・セッションのアクティブ状態を切り替えます。
オフ	現行のロギング・セッションを終了し、ブラウザをクローズします。
「メッセージ」リスト・ボックス	インタプリタ・ペイン内で入出力レコードを表示する読込み専用のスクロール可能な領域。リスト・ボックスに表示されるテキストを選択およびコピー、検索することができます。


現行のロギング・セッションのアクティブ状態を切り替えます。


現行のロギング・セッションを終了し、ブラウザをクローズします。


インタプリタ・ペイン内で入出力レコードを表示する読込み専用のスクロール可能な領域。リスト・ボックスに表示されるテキストを選択およびコピー、検索することができます。


「接続」ダイアログ・ボックス

「接続」ダイアログ・ボックスは、データベース・インスタンスへの接続を確立します。

ユーザー名	データベースのユーザーIDを入力します。このテキスト・ボックスには、接続文字列をすべて入力できますが、ユーザーのパスワードがエコー表示されます。
パスワード	データベースのパスワードを入力します。パスワードのセキュリティ保護のため、このフィールドでは、エコー表示されません。
データベース	接続を希望するデータベースのデータベース接続文字列を入力します。通常は、次の形式で入力します。
	network_protocol:network_node[:database_name]
	各フィールドはコロン(:)で区切ります。データベースの正しい接続文字列の詳細は、使用しているデータベース管理者に問い合せてください。 ODBCデータ・ソースに接続している場合、構文は次のようになることに注意してください。
	username/password@ODBC:datasource[:dbname] dbnameを指定しないと、現行のODBC接続用データベースが使用されます。
接続	入力した情報を確認し、接続を試行します。データベースへの接続が完了すると、ダイアログ・ボックスはクローズします。データベースへの接続に失敗すると、エラーが発行されます。


データベースのユーザーIDを入力します。このテキスト・ボックスには、接続文字列をすべて入力できますが、ユーザーのパスワードがエコー表示されます。


データベースのパスワードを入力します。パスワードのセキュリティ保護のため、このフィールドでは、エコー表示されません。


接続を希望するデータベースのデータベース接続文字列を入力します。


入力した情報を確認し、接続を試行します。データベースへの接続が完了すると、ダイアログ・ボックスはクローズします。データベースへの接続に失敗すると、エラーが発行されます。


「アクセス権限リスト」ダイアログ・ボックス

「アクセス権限リスト」ダイアログ・ボックスは、現在選択されているライブラリまたはデータベース・サーバー上のストアド・プログラム単位へのアクセス権限の表示と変更が行えます。他のユーザーに対するアクセス権限の付与または取消しを行うためには、ライブラリに対するGRANTアクセスを必要とします。

ユーザー・リスト・ボックス	選択したライブラリまたはストアド・プログラム単位に対して、現在アクセス権限を持つユーザーをリストします。「ユーザー」テキスト・ボックスに入れるには、対象となるユーザー名をクリックします。
ユーザー	選択したライブラリまたはストアド・プログラム単位へのアクセス権限を付与または取り消す対象ユーザー名を入力します。このユーザー名は、現行のデータベースで有効なユーザー名を入力する必要があります。ユーザー名がすでに「ユーザー」リスト・ボックスに表示されている場合は、ユーザー名をクリックします。
追加	ライブラリまたはストアド・プログラム単位にGRANTアクセス権限を付与されているユーザーのリストに、ユーザー名を追加します。
削除	ライブラリまたはストアド・プログラム単位にGRANTアクセス権限を付与されているユーザーのリストから、ユーザー名を削除します。


選択したライブラリに対して、現在アクセス権限を持つユーザーをリストします。「ユーザー」テキスト・ボックスに入れるには、対象となるユーザー名をクリックします。


選択したライブラリへのアクセス権限を付与または取り消す対象ユーザー名を入力します。このユーザー名は、現行のデータベースで有効なユーザー名を入力する必要があります。ユーザー名がすでに「ユーザー」リスト・ボックスに表示されている場合は、ユーザー名をクリックします。


ライブラリに対しGRANTアクセス権限を付与されているユーザーのリストに、ユーザー名を追加します。


ライブラリに対しGRANTアクセス権限を付与されているユーザーのリストから、ユーザー名を削除します。


「ライブラリ保存」ダイアログ・ボックス

「ライブラリ保存」ダイアログ・ボックスは、ライブラリをファイル・システムまたはデータベースに保存し、インタプリタのSAVEコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

ライブラリ	保存するライブラリの名前（および位置）を入力します。
参照	「先」フィールドで「ファイル・システム」が選択されていると、オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。「先」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスを表示します。
先	ライブラリを、ファイル・システムとデータベースのどちらに保存するかを示します。


保存するライブラリの名前（および位置）を入力します。


「先」フィールドで「ファイル・システム」が選択されていると、オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。「先」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスを表示します。


ライブラリを、ファイル・システムとデータベースのどちらに保存するかを示します。


「検索と置換」ダイアログ・ボックス

「検索と置換」ダイアログ・ボックスは、プログラム単位エディタまたはストアド・プログラム単位エディタに現在表示されているプログラム単位ソース内の文字列または正規表現の検索と置換に使用します。

検索文字列	検索文字列を入力します。この文字列を正規表現として扱う場合は、「正規表現」チェックボックスをクリックします。
置換文字列	検索結果文字列と置換する文字列を入力します。
正規表現	これがチェックされると、検索文字列を文字列ではなく正規表現として扱うかどうかを指定します。
大/小文字区別	検索文字列の英文字の大文字と小文字を区別して検索するかどうかを示します。このチェックボックスをチェックしない場合、英文字の大小の区別なく、検索文字列に一致するすべての文字列が検索されます。
次を検索	検索文字列の検索を、現在のカーソル位置から開始します。
置換	最新の検索結果文字列を、「置換文字列」テキスト・ボックスで指定した文字列に変更します。その時点で検索結果文字列が選択されていない場合は、検索文字列の次の文字列を検索して置換します。
すべて置換	すべての検索結果文字列を置換文字列に置換します（カーソル位置から検索可能な領域の最後まで）。


検索文字列を入力します。この文字列を正規表現として扱う場合は、「正規表現」チェックボックスをクリックします。


検索結果文字列と置換する文字列を入力します。


検索文字列の英文字の大文字と小文字を区別して検索するかどうかを示します。このチェックボックスをチェックしない場合、英文字の大小の区別なく、検索文字列に一致するすべての文字列が検索されます。


これがチェックされると、検索文字列を文字列ではなく正規表現として扱うかどうかを指定します。


検索文字列の検索を、現在のカーソル位置から開始します。


最新の検索結果文字列を、「置換文字列」テキスト・ボックスで指定した文字列に変更します。その時点で検索結果文字列が選択されていない場合は、検索文字列の次の文字列を検索して置換します。


すべての検索結果文字列を置換文字列に置換します（カーソル位置から検索可能な領域の最後まで）。


「PL/SQLブレークポイント」ダイアログ・ボックス

「PL/SQLブレークポイント」ダイアログ・ボックスは、BREAKコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。これによって、ブレーク・ポイントの作成または変更や、トリガーのブレークができます。

ブレークポイント	ブレーク・ポイントを識別します。 フォームは、「ブレーク・ポイント: 新規作成」または 「ブレーク・ポイント: 番号」です。ラベルの値は、新規のブレーク・ポイントを指定する場合は「新規作成」、既存のブレーク・ポイントを変更する場合は番号です。
使用可能	ブレーク・ポイントが使用可能か使用不可かを示します。
プログラム単位	ブレーク・ポイントが作成されるプログラム単位、既存のブレーク・ポイントの位置または新規ブレーク・ポイントの作成場所を識別します。
行	プログラム単位内のブレーク・ポイントのソース位置を識別します。
トリガー	必要に応じて、ブレーク・ポイントがヒットされたときに起動するPL/SQL文を入力します。BEGINおよびENDの各キーワードはトリガーでは必要ありません。 たとえば、DEBUG.INTERPRETを使用してインタプリタ・コマンドを実行できます。 DEBUG.INTERPRET('.SHOW LOCALS');


ブレーク・ポイントを識別します。フォームは、「ブレーク・ポイント: 新規作成」または 「ブレーク・ポイント: 番号」です。ラベルの値は、新規のブレーク・ポイントを指定する場合は「新規作成」、既存のブレーク・ポイントを変更する場合は番号です。


ブレーク・ポイントが使用可能か使用不可かを示します。


既存のブレーク・ポイントがあるプログラム単位または新規のブレーク・ポイントが作成されるプログラム単位を識別します。


プログラム単位内のブレーク・ポイントのソース位置を識別します。


ブレーク・ポイントがヒットされたときに起動するPL/SQL文を入力します。BEGINおよびENDの各キーワードは必要ありません。


「PL/SQLトリガー」ダイアログ・ボックス

「PL/SQLトリガー」ダイアログ・ボックスは、デバッグ・トリガーを作成し、TRIGGERコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

トリガー	デバッグ・トリガーを識別します。 フォームは、「トリガー: 新規作成」または ｢トリガー: 番号」です。新しいデバッグ・トリガーを指定するときのラベル値は「新規作成」であり、既存のデバッグ・トリガーを変更するときは番号です。
使用可能	デバッグ・トリガーが使用可能か使用不可かを示します。
場所	デバッグ・トリガーのソース位置を指定します。
	「プログラム単位」オプション（デフォルト）は、デバッグ・トリガーがプログラム単位内の特定のソース位置に置かれていることを示します。
	「デバッグ・エントリ」オプションは、トリガーがプログラム単位の実行停止と同時に起動することを示します。
	「ステートメント毎」オプションは、デバッグ・トリガーがプログラム単位内のすべての実行可能文の直前で起動することを示します。
プログラム単位	目的のプログラム単位を識別します。
行	プログラム単位内のデバッグ・トリガーのソース位置を識別します。
トリガー本体	デバッグ・トリガー本体に使用されるPL/SQL文を入力します。BEGINおよびENDの各キーワードは必要ありません。 デバッグ・トリガーは条件付きのブレーク・トリガーのように動作します。デバッグ・アクションが必要な場合について条件を指定する場合、その条件が真のときのみトリガーが起動します。   たとえば、変数が特定の値（100など）に等しい場合、DEBUG.BREAKをコールすることができます。 IF DEBUG.GETC('vnumber') = 100 THEN   RAISE DEBUG.BREAK; END IF;


デバッグ・トリガーを識別します。 フォームは、「トリガー: 新規作成」または｢トリガー: 番号」です。新しいデバッグ・トリガーを指定するときのラベル値は「新規作成」であり、既存のデバッグ・トリガーを変更するときは番号です。


デバッグ・トリガーが使用可能か使用不可かを示します。


デバッグ・トリガーのソース位置を指定します。


目的のプログラム単位を識別します。


プログラム単位内のデバッグ・トリガーのソース位置を識別します。


デバッグ・トリガー本体に使用されるPL/SQL文を入力します。


「PL/SQLステップ」ダイアログ・ボックス

「PL/SQLステップ」ダイアログ・ボックスではインタプリタのSTEPコマンドに対するグラフィカル・ユーザー・インタフェースが提供されており、デバッグ中に一時停止されたプログラム単位のコードを1行ずつ実行するオプションを設定できます。

モード	使用するステップ・オプションを指定します。
	「ステップ・イン（INTO）」は、実行を再開して、次の実行可能文まで続けます。
	「ステップ・オーバー（OVER）」は、実行を再開して、サブプログラムのコールをすべてスキップして、現行のプログラム単位内の次の実行可能文まで続けます。
	「ステップ・アウト（OUT）」は、ネストされたサブプログラムの実行を再開し、コール中のプログラム単位内の次の実行可能文の前で処理を停止します。
	「指定先へ（STEP TO）」は、実行を再開して、指定した位置に到達するまで続けます。
プログラム単位	「指定先へ（STEP TO）」コマンド・オプションのターゲット・プログラム単位本体を識別します。
行	「指定先へ（STEP TO）」コマンド・オプションのターゲット・プログラム単位本体内の位置を識別します。
カウント	STEPコマンドを繰り返す回数を指定します。カウントのデフォルト値は、1です。
適用	指定したオプションを受け入れ、それに従ってプログラム単位の実行を再開します。ステップ操作は通常1つずつ繰り返されるため、「ステップ」ダイアログ・ボックスは、ユーザーが明示的にクローズするまで、またはアクティブなデバッグ・レベルがあるかぎり、表示されたままです。


使用するステップ・オプションを指定します。


「指定先へ」コマンド・オプションのターゲット・プログラム単位本体を識別します。


｢指定先へ｣コマンド・オプションのターゲット・プログラム単位本体内の位置を識別します。


STEPコマンドを繰り返す回数を指定します。カウントのデフォルト値は、1です。


指定したオプションを受け入れ、それに従ってプログラム単位の実行を再開します。ステップ操作は通常1つずつ繰り返されるため、「ステップ」ダイアログ・ボックスは、ユーザーが明示的にクローズするまで、またはアクティブなデバッグ・レベルがあるかぎり、表示されたままです。


「プログラム単位のロード」ダイアログ・ボックス

「プログラム単位のロード」ダイアログ・ボックスは、ファイル・システム上に格納されたプログラム単位のインポートとコンパイルが可能であり、インタプリタのLOADコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

ファイル	プログラム単位ソース・テキストを含むファイルの名前（および位置）を入力します。
参照	オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。
確認の抑止	既存のプログラム単位を上書きする際などに、ロードおよびコンパイル時のすべての確認メッセージを抑止します。デフォルトは使用不可であり、確認メッセージは抑止されません。
ロード	選択を確認してプログラム単位をロードし、ダイアログ・ボックスをクローズします。


プログラム単位ソース・テキストを含むファイルの名前（および位置）を入力します。


オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。


既存のプログラム単位を上書きする際などに、ロードおよびコンパイル時のすべての確認メッセージを抑止します。デフォルトは使用不可であり、確認メッセージは抑止されません。


選択を確認してプログラム単位をロードし、ダイアログ・ボックスをクローズします。


「インタプリタ・デバッグ・スクリプト」ダイアログ・ボックス

「インタプリタ・デバッグ・スクリプト」ダイアログ・ボックスは、インタプリタ・コマンド、PL/SQLソースまたはSQL文の組合せが入ったスクリプトのインポートと実行が可能であり、INTERPRETコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

ファイル	解釈されるデバッグ・スクリプトを含むファイルの名前（および位置）を入力します。
参照	オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。
エコー	エコー・モードを使用可能または使用不可にします。デフォルトは使用不可です。 したがって、スクリプトがロードされたとき、スクリプトの各行はインタプリタ・コマンド・ラインにエコー表示されません。
サイレント	サイレント・モードを使用可能または使用不可にします。デフォルトは使用不可です。 したがって、スクリプトのロード中、状態メッセージは表示されます。
確認の抑止	既存のプログラム単位を上書きする際などに、操作時のすべての確認メッセージを抑止します。デフォルトは使用不可であり、確認メッセージは抑止されません。
インタプリタ	選択を確認してスクリプトを実行し、ダイアログ・ボックスをクローズします。


解釈されるデバッグ・スクリプトを含むファイルの名前（および位置）を入力します。


オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。


エコー・モードを使用可能または使用不可にします。デフォルトは使用不可です。 したがって、スクリプトがロードされたとき、スクリプトの各行はインタプリタ・コマンド・ラインにエコー表示されません。


サイレント・モードを使用可能または使用不可にします。デフォルトは使用不可です。 したがって、スクリプトのロード中、状態メッセージは表示されます。


既存のプログラム単位を上書きする際などに、操作時のすべての確認を抑止します。デフォルトは使用不可であり、確認メッセージは抑止されません。


選択を確認してスクリプトを実行し、ダイアログ・ボックスをクローズします。


「コンパイル」ダイアログ・ボックス

「コンパイル」ダイアログ・ボックスは、バッチ・コンパイル中にコンパイル・エラー・メッセージを表示します。 このダイアログ・ボックスで、コンパイルの中断と再開、およびエラー・ソースへのナビゲートが行えます。

ステータス行	プログラム単位のコンパイルの際、コンパイル中のプログラム単位の名前とタイプおよびコンパイルの終了したプログラム単位の割合などの情報を表示します。
	現在コンパイルされているプログラム単位の名前とタイプ。
	「割込み」をクリックした場合、[INTERRUPTED]を表示。
	コンパイルされたプログラム単位の割合。
コンパイル・エラー・リスト・ボックス	選択されたプログラム単位のコンパイル時のエラーを表示する、スクロール可能でマウス操作可能な領域。 コンパイル・エラー・リスト・ボックス内のエラーをクリックすると、プログラム単位エディタおよびエラーが特定されたプログラム単位が表示されます。 コンパイルの割込み状態のときに（「割込み」をクリックした結果）、コンパイル・エラー・リスト・ボックス内のエラーをクリックした場合、「今エラー処理に移ると、残りのコンパイル操作が停止します」という警告のメッセージが表示されます。
割込み	エラーが生成されすぎる場合などに、コンパイルを一時的に中止します。
再開	割込み後、コンパイルを再開します。
エラーへジャンプ	最初のエラーが位置しているプログラム単位ソースが含まれたプログラム単位エディタを表示します。 コンパイルの割込み状態のときに（「割込み」をクリックした結果）、コンパイル・エラー・リスト・ボックス内のエラーをクリックした場合、エラーのソースに移動するとバッチ・コンパイルが終了するという警告のメッセージが表示されます。 また、「PL/SQLコンパイル・メッセージ」ダイアログ・ボックスも表示されます。これは、選択されたプログラム単位のコンパイル時のエラーをすべて参照できる、スクロール可能でマウス操作可能なリスト・ボックスです。リスト・ボックス内でエラーをクリックすると、プログラム単位エディタおよびエラーが特定されたプログラム単位が表示されます。

エラーが検出されずにコンパイルが終了した場合、ステータス行に「コンパイルは正常終了しました」というメッセージが表示されます。コンパイル時にエラーが検出されて終了した場合は、「コンパイルは終了しましたが、エラーがあります」というメッセージが表示されます。

「PL/SQLコンパイル・メッセージ」ダイアログ・ボックスは、選択されたプログラム単位のコンパイル時のエラーをすべて参照できる、スクロール可能でマウス操作可能なリスト・ボックスです。リスト・ボックス内でエラーをクリックすると、プログラム単位エディタおよびエラーが特定されたプログラム単位が表示されます。


プログラム単位のコンパイルの際、コンパイル中のプログラム単位の名前とタイプおよびコンパイルの終了したプログラム単位の割合などの情報を表示します。


エラーが生成されすぎる場合などに、コンパイルを一時的に中止します。「割込み」をクリックすると、ステータス行に[INTERRUPTED]が表示されます。


割込み後、コンパイルを再開します。


「PL/SQLコンパイル・メッセージ」ブラウザを提示し、最初のエラーの位置でプログラム単位ソースが含まれたプログラム単位エディタを表示します。


正規表現

正規表現は、次の特殊なワイルドカード文字のいずれかを含むことができる文字列です。

.	任意の1文字を検索します。たとえば、.heでは、theとsheの両方が検索されます。
( )	デフォルトの優先順位が望ましくない場合、演算子（たとえば、+）の優先順位を強制するために使用します。たとえば、連結文字（theなど）は、他の+などの演算子より優先されます。したがって、the+Aは(the)+Aと等価です。また、theeeeeeAを検索する際、カッコを使ってth(e+)Aのようにすると、+が連結文字より優先されます。
[ ]	大カッコ内の任意の1文字を検索します。大カッコは論理OR演算子です。たとえば、t[hr]eでは、otherのtheおよびtrendのtreが検索されます。
|	2つの正規表現の間に使用します。どちらかの正規表現に一致するものが検索されます。
\	円マークの後の特殊文字を検索します。たとえば、\*は*が検索されます。円マークは、エスケープ文字です。円マークの次の特殊文字は、特殊文字として扱われません。 次に、エスケープ文字の特殊な使用方法を示します。
	\nは、改行文字を検索します。
	\tは、タブ文字を検索します。
	\bは、ブランク文字を検索します。
	\wは、\n、\t、\bまたは\0を検索します。
*	正規表現の0個以上のインスタンスを検索します。たとえば、(the)*Aでは、 AおよびtheA、thetheAが検索されます。
+	正規表現の1つ以上のインスタンスを検索します。たとえば、(the)+Aでは、theAおよびthetheAの両方が検索されますが、(the)*Aの場合とは異なりAは検索されません。
これらの文字が大カッコに囲まれている場合、特殊な意味を持ちます。

~	最初の文字に使用すると、大カッコ内の文字または範囲にない文字を検索します。たとえば、t[~hr]eでは、toeは検索されますがtheは検索されません。
-	文字の組の間にある場合、その範囲のすべての文字を検索します。たとえば、[A-E]では、文字AおよびB、C、D、Eが検索されます。文字範囲の組は、次のどちらでもかまいません。
	• アルファベット順にみて、最初の文字が2番目の文字より前にある（または同一の文字である）、同じケースのアルファベット。
	• 最初の数字が2番目の数字以下（たとえば、[4-9]または[0-3]）である数字。
	大カッコ内でエスケープ文字を使用することもできます。
ルール: 正規表現の特殊文字の優先順序は、( )、[ ]、連結文字（たとえば、abc）、*、+、~、 、|、.です。

次に、優先順位がわかるようにいくつかの例を示します。

•	Start|Finishは、(Start)|(Finish)と等価です。

•	Start*は、(Start)*と等価です。

•	Start|Finish*は、(Start)|((Finish)*)と等価です。


「PL/SQL表要素選択」ダイアログ・ボックス

「PL/SQL表要素選択」ダイアログ・ボックスには選択された表内の行に対する索引が入っています。 このダイアログ・ボックスを使用し、オブジェクト・ナビゲータで確認したい行を最大に拡大して選択できます。

レコード索引リストボックス	表内のすべての行の索引のリストが入った、スクロール可能なマウス専用の領域。
すべて選択	表内の要素をすべて選択します。
すべて選択解除	表内の要素をすべて選択解除します。
デフォルトでは、すべての索引が選択されます。[Ctrl]キーを押しながらリスト内の選択した項目をクリックして個々の選択を解除します。


「プログラム単位内の検索と置換」ダイアログ・ボックス

「プログラム単位内の検索と置換」ダイアログ・ボックスでは、複数のプログラム単位に渡って、検索と置換を実行できます。

検索文字列	検索文字列を入力します。   文字列を正規表現として扱う場合は、「正規表現を使う」チェックボックスをチェックします。
正規表現	検索条件に使用できる正規表現のリストを表示します。表現をクリックすると、「検索文字列」ボックスに挿入されます。
置換文字列	検索文字列を置換するための文字列を入力します。
正規表現を使う	検索条件に正規表現を使用する場合は、このボックスをチェックします。 検索条件に正規表現を使用しない場合は、このボックスのチェックを外します。
大/小文字を区別	検索文字列の英文字の大文字と小文字を区別して検索する場合は、このボックスをチェックします。 英文字の大小の区別なく、検索文字列に一致するすべての文字列を検索する場合は、このボックスのチェックを外します。
検索する場所	検索または検索/置換を実行する場所を指定します。 スタンドアロンのProcedure Builderでは、「/」はオブジェクト・ナビゲータの1番上のプログラム単位ノードを表します。現行のセッションでオープンしているすべてのPL/SQLライブラリが、「/」の下にリストされます。   すべてのノードがデフォルトで選択されます。特定のノードのみを検索したい場合は、そのノードをクリックします。
すべて検索	指定した検索文字列に一致するすべての文字列を検索します。置換は行われません。
すべて置換	検索文字列に一致するすべての文字列を、指定の置換文字列に置換します。一括置換を行う場合は、操作の確認を求めるメッセージ・ボックスが表示されます。
クローズ	ダイアログ・ボックスをクローズします。
ヘルプ	ヘルプ・トピックを表示します。
「結果」リスト・ボックス	検索結果文字列が表示されます。検索結果文字列の場所は、ノード、プログラム単位の名前、ソースの行数と列数で示されます。 リスト・ボックスの上にあるステータス・バーには、検索または置換された文字列の数が表示されます。 検索結果文字列を編集または置換するために選択するには、その文字列をクリックします。複数の検索結果文字列を選択できます。
置換	「結果」リスト・ボックスで選択した検索結果文字列のみを対象に、検索文字列を置換文字列に置換します。
編集	選択した検索結果文字列のソースをプログラム単位エディタでオープンします。


「PL/SQL V1の変換オプション」ダイアログ・ボックス

サポートされているPL/SQL V1またはV2構文の各タイプのエラーが発生した場合、「PL/SQL V1の変換オプション」ダイアログ・ボックスを使用して、ユーティリティが取るべき処置をコントロールします。作業環境は変換ユーティリティの複数回の起動に渡って、Windows95/NTレジストリまたはUNIXプロファイルのどちらにも保存されます。

問題のタイプ	変換ユーティリティでサポートされるPL/SQL V1またはV2構文タイプの状態リスト。 CHARをVARCHAR2に置換 VARCHAR2に必要な文字列の長さを設定 OUTおよびIN OUTのデフォルト式を削除 式に必須なRETURN文 廃止されたビルトインの置換 ファンクションlengthはゼロ長の文字列に対しNULLを返す NULLを渡すオーバーロードしたサブプログラムへの対処 ファンクションにRETURN文を指定しないとランタイム・エラーが発生する
変換	選択された問題のすべてのインスタンスが、確認の指示なしに自動的に変換されます。
すべて変換	変換するすべての問題のタイプを設定するための迅速なパス。ユーティリティは、確認の指示なしにすべてのPL/SQL V1またはV2を自動的に変換します。
スキップ	問題のタイプが選択されると、問題のすべてのインスタンスが無視されます。コンパイラ・エラーを避けるには、手動でV1またはV2コードを修正する必要があります。
すべて無視	無視するすべての問題のタイプを設定するための迅速なパス。ユーティリティは、すべての問題のタイプを無視し、どんな変換も実行しません。コンパイラ・エラーを避けるには、手動でV1またはV2コードを修正する必要があります。
確認	選択された問題のタイプについて、各インスタンスを別々に「変換」ダイアログ・ボックスに表示します。ダイアログ・ボックスから、「変換」または「無視」のどちらでも選択できます。
すべて確認	すべての問題タイプを「確認」に設定するための迅速なパス。ユーティリティは、PL/SQL V1またはV2文字列を変換する前に、（「変換」ダイアログ･ボックスで）確認を行うように指示します。
OK	選択したものを確認し、ダイアログ・ボックスをクローズします。
取消し	モジュールへのすべての変更を取り消し、ダイアログ・ボックスをクローズします。


「変換」ダイアログ・ボックス

「変換」ダイアログ・ボックスで、PL/SQL V1またはV2の変換プロセスを対話式にコントロールできます。以下に示した変換のためのオプションを設定するには、「オプション」をクリックしてください。

ソース・ペイン	変換条件が検出されるプログラム単位ソースを表示します。変換される構文は強調表示されます。このペイン内でスクロール・アップまたはダウンを行い、それまでに完成された変換をレビューできます。
条件:	変換を必要とするPL/SQL V1またはV2文。
処置:	「変換」をクリックしたときに、変換ユーティリティが行うこと。
説明. . .	問題の詳細と、変換を無視した場合に起こることについて表示します。
変換	推奨されるデフォルト動作を受け入れ、次の文に移動します。
すべて変換	モジュール全体にわたり、すべてのPL/SQL V1またはV2構文の問題を変換します。このモジュールは、複数のユニットを持つ場合があります。すべてのデフォルト動作が受け入れられます。
スキップ	「問題」フィールドに記述されるPL/SQL V1またはV2文を変換せずに、次の文へ移動します。
すべて無視	モジュール全体についての変換を回避します。このモジュールは、複数のプログラム単位を持つ場合があります。
オプション. . .	変換プロセスを制御するオプションを指定できる「PL/SQL V1の変換オプション」ダイアログ・ボックスを表示します。


「PL/SQL V1の変換サマリー」ダイアログ・ボックス

「PL/SQL V1の変換サマリー」ダイアログ・ボックスによって、次の情報を入手できます。

•	正常に変換されたソース行

•	無視されたソース行

•	PL/SQLコンパイラ・エラーを生成したソース行

ツールバー・ボタン:

Xアイコン	ダイアログ・ボックスをクローズします。
?アイコン	ダイアログ・ボックスのヘルプを表示します。
サマリー・ペイン:

検索	拡張および縮小ノードのどちらにも標準検索機能を提供します。
ノード	モジュールの各プログラム単位のためのもの。ノードがプラス記号を含む場合は、それをクリックすると、変換または無視されたもの（およびその方法）についてのサマリーを表示します。ノードが空（プラス記号もマイナス記号もない）の場合は、プログラム単位は変換を必要としません。 コンパイラ・エラーをアドレスする、または変換されたソースや無視したアイテムをレビューするには、拡張されたノードにある行をダブル・クリックします。（または行を選択し、「プログラム」 [image] 「プログラム単位エディタ」を選択します。）エディタは、選択された行のカーソル位置でオープンします。 注意: プログラム単位エディタを使用してソースを変更した後では、次回に行をダブル・クリックするか、または「編集」ボタンを使用すると、カーソルがあるべき位置にないことがあります。
メニュー・アイテム:

プログラム・メニューには次の2つのオプションがあります。

プログラム単位エディタ	プログラム単位エディタでソースをオープンします。カーソルは選択した行に置かれます。
変換オプション	「PL/SQL V1の変換オプション」ダイアログ・ボックスを表示するので、指定したオプションをビューまたは修正できます。
ポップアップ・メニュー:

マウス右ボタンをクリックして、ポップアップ・メニューを表示します。

編集	プログラム単位エディタでソースをオープンします。カーソルは選択した行に置かれます。
説明	選択された行に要求される変換のタイプについてのオンライン・ヘルプを表示します。


プログラム単位エディタのインタフェース

  関連項目

プログラム単位エディタに含まれるボタンおよびドロップダウン・リスト・ボックスは次のとおりです。

コンパイル	現行のプログラム単位をコンパイルします。コンパイルの結果生成されたエラー・メッセージは、スクロール可能なコンパイル・メッセージ・ペインに表示されます。
適用	エディタが最初にオープンされてから、あるいは最後の適用操作または変更の破棄の操作が行われてから、エディタのプログラム単位に加えられた変更を保存します。プログラム単位は再コンパイルされません。エディタはクローズしません。元に戻すスタックまたは再実行スタックは消去されます。
変更の破棄	最後の適用操作または変更の破棄操作を行ったときの状態に、プログラム単位を戻します。適用操作または変更の破棄操作が行われなかった場合、プログラム単位は元の状態に戻ります。
作成	「新規プログラム単位」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、作成するプログラム単位のタイプと名前を指定できます。
削除	現行のプログラム単位を削除します。操作の確認を求めるメッセージ・ボックスが表示されます。
クローズ	プログラム単位エディタをクローズします。
ヘルプ	このヘルプ・トピックが表示されます。
名前	現行のプログラム単位の名前を表示します。現行セッションにあるその他の既存プログラム単位のドロップダウン・リストを表示するには、フィールドの右にある矢印をクリックします。ソース・ペインにプログラム単位を表示するには、このリストで表示するプログラム単位をクリックします。

この他に、エディタは次の要素で構成されています。

ソース・ペイン	PL/SQLプログラム単位ソース・テキストを入力および編集する領域。 分割バーを使用すると、現行のプログラム単位について、異なるビューを4つまで作成できます。各ビューは、個別にスクロールできます。   ソース・ペイン内に水平なビューを作成するには、垂直スクロール・バーの最上部にある分割バーにカーソルを置き、ダブルクリックします。これによってソース・ペインが2つの均等なビューに水平に分割されます。また、分割バーをクリックし、希望のビュー・サイズになるまでドラッグして調整することもできます。  垂直なビューを作成するには、水平スクロール・バーの左端にある分割バーにカーソルを置き、ダブルクリックします。これによってソース・ペインが2つの均等なビューに垂直に分割されます。また、分割バーをクリックし、希望のビュー・サイズになるまでドラッグして調整することもできます。 ビューのサイズを変更するには、ビューを分割している分割バーをクリックし、ドラッグします。 水平または垂直なビューを削除するには、ビューを分割している分割バーをダブルクリックするか、ペインの端までドラッグします。 4つのビューを一度にすべて削除するには、境界バーが交差する部分にカーソルを置いてダブルクリックするか、交差する部分をペインの任意の隅までドラッグします。 コード行を選択するには、左マージンにカーソルを置いて、クリックします。
コンパイル・メッセージ・ペイン	コンパイルの結果生成されたエラー・メッセージがあれば表示します。エラー・メッセージをクリックすると強調表示され、問題のソース文までソース・ペインをスクロールし、エラーの位置にテキスト・カーソルが置かれます。 デフォルトでは、コンパイル時にコンパイル・エラー・メッセージが生成された場合にだけ、コンパイル・メッセージ・ペインが表示されます。 コンパイル・メッセージ・ペインを必要なときに手動で表示するには、カーソルの形状が十字線になるまで、カーソルをエディタ・ウィンドウの右下隅に移動します。次に、マウスを1回クリックし、カーソルを上にドラッグします。これによって分割バーが上に移動し、その下にコンパイル・メッセージ・ペインが表示されます。
分割バー （ペインの分割）	ソース・ペインとコンパイル・メッセージ・ペインを分割します。これによって、ペインの相対サイズを変更できます。ペインのサイズを変更するには、分割バーをクリックして、ドラッグします。 コンパイル・メッセージ・ペインが表示されない場合は、分割バーがエディタ・ウィンドウの底部にあります。
ステータス・バー	エディタの1番下に、プログラム単位の現行の状態に関する情報を表示します。


「ソース」ペインに表示されるプログラム単位をコンパイルします。コンパイルの結果生成されたエラー・メッセージは、スクロール可能なコンパイル・メッセージ・ペインに表示されます。


エディタが最初にオープンされてから、あるいは最後の適用操作または変更の破棄操作が行われてから、エディタでプログラム単位に加えられた変更を保存します。プログラム単位は再コンパイルされません。エディタはクローズしません。


最後の適用操作または変更の破棄操作を行ったときの状態に、プログラム単位を戻します。適用操作または変更の破棄操作が行われなかった場合、プログラム単位は元の状態に戻ります。


「新規プログラム単位」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、作成するプログラム単位のタイプと名前を指定できます。


表示されているプログラム単位を削除します。


エディタをクローズしようとします。変更後、変更内容が適用されていない場合、メッセージ・ボックスが表示され、変更内容を適用または破棄するか、あるいは操作を取り消すように求められます。変更内容がすべて適用または破棄されると、プログラム単位エディタはクローズします。


現在エディタに表示されている、プログラム単位のタイプ（トリガー、プロシージャなど）を指定します。


プログラムがどのオブジェクトに関連付けられているかを指定します。


現行のプログラム単位の名前を表示します。その他の既存プログラム単位のドロップダウン・リストを表示するには、フィールドの右にある矢印をクリックします。エディタにプログラム単位を表示するには、このリストで表示するプログラム単位をクリックします。


PL/SQLプログラム単位のソース・テキストの入力と編集を行います。


コンパイル中に発見された構文エラーを表示します。プログラム単位内のエラー元の位置に進むには、エラーをクリックします。


プログラム単位エディタの2つのペイン（ソース・ペインとコンパイル・メッセージ・ペイン）領域の相対量を変更できます。デフォルトでは、コンパイル・メッセージ・ペインは、コンパイル中にエラー・メッセージが生成された場合にのみ表示されることに注意してください。


ステータス・バーの右側に次のメッセージが表示されます。

変更されていません。	プログラム単位が最初に表示または最後に適用されてから加えられた変更はありません。
変更されました。	プログラム単位が最初に表示または最後に適用されてから1つ以上の変更が加えられています。

ステータス・バーの右側に次のメッセージが表示されます。

コンパイルされていません。	現在表示されているプログラム単位のソース・テキストは、コンパイルされていません。
コンパイルは成功しました。	現在表示されているプログラム単位のソース・テキストは、エラーなくコンパイルされました。
コンパイル･エラーがあります。	現在表示されているプログラム単位のソース・テキストは、コンパイル中にエラーが発生しました。エラーは、コンパイル・メッセージ・ペインに表示されます。


編集機能

  関連項目

次の編集機能は、プログラム単位エディタおよびストアド・プログラム単位エディタでのみサポートされます。

自動インデントおよびインデント解除	エディタでコードを入力すると、PL/SQL構文の規則に従って行が自動的にインデントまたはインデント解除されます。
カラーによる構文のハイライト	キーワード、コメント、文字列および:=や||などの記号は、別のカラーで表示されます。
列と行の選択	テキスト列やソース・コードの行を選択できます。 列を選択するには、[ALT]キーを押してから列ををクリックし、水平にドラッグします。 行を選択するには、ソース・ペインで行の左端マージンをクリックします。
ドラッグ・アンド・ドロップによるテキストの操作	選択されたテキストは、ドラッグ・アンド・ドロップによってコピーまたは移動できます。 テキストをコピーするには、[Ctrl]キーを押しながら、選択したテキストをドラッグします。 テキストを移動するには、選択したテキストをドラッグします。
行のインデントおよびインデント解除	「編集」メニューの「インデント」コマンドおよび「インデント解除」コマンドを使用すると、選択したソース行をインデントまたはインデント解除できます。 [Tab]および[Shift]+[Tab]キーを押しても、選択した行をインデントまたはインデント解除できます。
複数の分割ビュー	現行のプログラム単位の別個のビューを最大4つ作成できます。 水平ビューを作成するには、垂直スクロール・バーの一番上にある分割バーにカーソルを置きます。次に、分割バーをクリックし、下にドラッグします。 垂直ビューを作成するには、水平スクロール・バーの左端にある分割バーにカーソルを置きます。次に、分割バーをクリックし、右方向にドラッグします。 水平ビューまたは垂直ビューを削除するには、ビューを分割する分割バーをダブルクリックします。
印刷	現行のプログラム単位を印刷するには、「ファイル」 [image] 「印刷」を選択します。
無制限の元に戻す/再実行	「編集」メニューの「元に戻す」コマンドおよび「再実行」コマンドを使用すると、最後に保存したときの状態まで、変更を元に戻したり、再実行できます。

注意: これらの機能は、Microsoft Windowsのみで使用できます。UNIXでは、次の操作のみを実行できます。

•	現行のプログラム単位の印刷

•	[TAB]および[Shift]+[TAB]キーを使用した、選択行のインデントとインデント解除

•	ドラッグ・アンド・ドロップによる選択テキストの移動


エディタでのマウスの使用

  関連項目

Microsoft Windowsでプログラム単位エディタ（およびストアド・プログラム単位エディタ）を使用するときは、次のマウス操作がサポートされています。

操作	マウス操作
文字の範囲を選択する	選択する範囲内の最初の文字をクリックし、最後の文字までカーソルをドラッグします。(UNIXでもサポートされています) または 選択する範囲内の最初の文字をクリックし、[Shift]キーを押しながら最後の文字をクリックします。
カーソルの下の単語を選択する	単語をダブルクリックします。(UNIXでもサポートされています) または [Ctrl]キーを押しながら、選択する単語をクリックします。
単語の範囲を選択する	[Ctrl]キーを押しながら、選択する範囲の最初の単語をクリックし、最後の単語までカーソルをドラッグします。
行を選択する	選択する行の左マージンにカーソルを置きます。カーソルが矢印に変わったときにクリックします。
複数の行を選択する	選択する最初の行の左マージンにカーソルを置きます。カーソルが矢印に変わったときにクリックし、選択する最後の行までカーソルをドラッグします。
テキスト列を選択する	[Alt]キーを押し、選択する範囲の最初の列をクリックし、最後の列までカーソルをドラッグします。
選択されたテキストを移動する	まずテキストを選択します。次に、選択したテキストをクリックし、新しい位置にドラッグします。(UNIXでもサポートされています)
選択されたテキストをコピーする	まずテキストを選択します。次に、[Ctrl]キーを押しながら、コピーを配置する位置まで、選択したテキストをドラッグし、マウスを離します。
ウィンドウを2つの水平ビューに分割する	垂直スクロール・バーの一番上にある分割バーをダブルクリックします。 または 垂直スクロール・バーの一番上にある分割バーをクリックし、ドラッグします。
ウィンドウを2つの垂直ビューに分割する	水平スクロール・バーの左端にある分割バーをダブルクリックします。 または 水平スクロール・バーの左端にある分割バーをクリックし、ドラッグします。
分割ビューの相対サイズを調整する	ビューを分割している分割バーをクリックし、ドラッグします。
分割ビューを削除する	ビューを分割している分割バーをダブルクリックします。 または 分割バーをクリックし、ウィンドウの端までドラッグします。 4つのビューを一度に削除するには、分割バーが交わる点をダブルクリックするか、またはその点をウィンドウの任意の角までドラッグします。


エディタでのキーボードの使用

  関連項目

Microsoft WindowsまたはUNIXでプログラム単位エディタ（およびストアド・プログラム単位エディタ）を使用するときは、次のキーボード操作がサポートされています。

操作	キー入力
カーソルを左に1文字移動する	[←]
カーソルを左に移動しながら文字を選択する	[Shift]+[←]
カーソルを右に1文字移動する	[→]
カーソルを右に移動しながら文字を選択する	[Shift]+[→]
選択された文字または単語をコピーする	[Ctrl]+[C]
選択された文字または単語をカットする	[Ctrl]+[X]
クリップボードからペーストする	[Ctrl]+[V]
現行のカーソル位置の右側にある文字を削除する、または選択された文字または単語を削除する	[Del]
現行のカーソル位置の左側にある文字を削除する	[Back Space]
カーソルをプログラム単位の末尾に移動する	[Ctrl]+[End]	(Windowsのみ)
カーソルをプログラム単位の先頭に移動する	[Ctrl]+[Home]	(Windowsのみ)
現行のカーソル位置から、プログラム単位の末尾までのソース行を選択する	[Ctrl]+[Shift]+[End]	(Windowsのみ)
現行のカーソル位置から、プログラム単位の先頭までのソース行を選択する	[Ctrl]+[Shift]+[Home]	(Windowsのみ)
カーソルを現行の行の末尾に移動する	[End]	(Windowsのみ)
カーソルを現行の行の先頭に移動する	[Home]	(Windowsのみ)
現行のカーソル位置から、現行の行の末尾までの文字を選択する	[Shift]+[End]	(Windowsのみ)
現行のカーソル位置から、現行の行の先頭までの文字を選択する	[Shift]+[Home]	(Windowsのみ)
選択された行をインデントするか、または現行のカーソル位置の右側にある文字をインデントする	[Tab]
選択された行をインデント解除する	[Shift]+[Tab]
カーソルを下に1行移動する	[↓]
カーソルを下に移動しながら行を選択する	[Shift]+[↓]
カーソルを上に1行移動する	[↑]
カーソルを上に移動しながら行を選択する	[Shift]+[↑]
ソース・ペインに表示されている行数単位でプログラム単位を下にスクロールする	[Page Down]
ソース・ペインに表示されている行数単位でプログラム単位を下にスクロールしながら行を選択する	[Shift]+[Page Down]
ソース・ペインに表示されている行数単位でプログラム単位を上にスクロールする	[Page Up]
ソース・ペインに表示されている行数単位でプログラム単位を上にスクロールしながら行を選択する	[Shift]+[Page Up]
最後の操作を元に戻す	[Ctrl]+[Z]	(Windowsのみ)
最後に元に戻した操作を再実行する	[Ctrl]+[Y]	(Windowsのみ)


ストアド・プログラム単位エディタのインタフェース

  関連項目

ストアド・プログラム単位エディタに含まれるボタンおよびドロップダウン・リスト・ボックスは次のとおりです。

作成	「新規プログラム単位」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、作成するストアド・プログラム単位のタイプと名前を指定できます。
保存	現行のストアド・プログラム単位をコンパイルします。コンパイルの結果生成されたエラー・メッセージは、スクロール可能なコンパイル・メッセージ・ペインに表示されます。元に戻すスタックまたは再実行スタックは消去されます。
変更の破棄	最後の保存操作または変更の破棄操作を行ったときの状態に、ストアド・プログラム単位を戻します。保存操作または変更の破棄操作が行われなかった場合、プログラム単位は元の状態に戻ります。
削除	データベースから、現行のストアド・プログラム単位を削除します。操作の確認を求めるメッセージ・ボックスが表示されます。
クローズ	ストアド・プログラム単位エディタをクローズします。
ヘルプ	このヘルプ・トピックが表示されます。
所有者	現行のプログラム単位の所有者の、データベース・ユーザーIDを表示します。このボックスの右向きの矢印キーをクリックし、アクセス権限のある、ユーザー名のドロップダウン・リストを表示します。所有者リストには、自分がアクセス権限を持っているストアド・プログラムの所有ユーザーの名前のみが表示されます。
名前	現行のストアド・プログラム単位の名前を表示します。「所有者」フィールドに示されたユーザーIDによって所有されるストアド・プログラム単位のドロップダウン・リストを表示するには、このボックスの右にある矢印をクリックします。「名前」リストには、アクセス権限を付与されたストアド・プログラム単位の名前のみが表示されます。

この他に、エディタは次の要素で構成されています。

ソース・ペイン	PL/SQLプログラム単位ソース・テキストを入力および編集する領域。   分割バーを使用すると、現行のプログラム単位について、異なるビューを4つまで作成できます。各ビューは、個別にスクロールできます。   ソース・ペイン内に水平なビューを作成するには、垂直スクロール・バーの最上部にある分割バーにカーソルを置き、ダブルクリックします。これによってソース・ペインが2つの均等なビューに水平に分割されます。また、分割バーをクリックし、希望のビュー・サイズになるまでドラッグして調整することもできます。  垂直なビューを作成するには、水平スクロール・バーの左端にある分割バーにカーソルを置き、ダブルクリックします。これによってソース・ペインが2つの均等なビューに垂直に分割されます。また、分割バーをクリックし、希望のビュー・サイズになるまでドラッグして調整することもできます。 ビューのサイズを変更するには、ビューを分割している分割バーをクリックし、ドラッグします。 水平または垂直なビューを削除するには、ビューを分割している分割バーをダブルクリックするか、ペインの端までドラッグします。 4つのビューを一度にすべて削除するには、境界バーが交差する部分にカーソルを置いてダブルクリックするか、交差する部分をペインの任意の隅までドラッグします。 コード行を選択するには、左マージンにカーソルを置いて、クリックします。
コンパイル・メッセージ・ペイン	コンパイルの結果生成されたエラー・メッセージがあれば表示します。エラー・メッセージをクリックすると強調表示され、問題のソース文までソース・ペインをスクロールし、エラーの位置にテキスト・カーソルが置かれます。 デフォルトでは、コンパイル時にコンパイル・エラー・メッセージが生成された場合にのみ、コンパイル・メッセージ・ペインが表示されます。 コンパイル・メッセージ・ペインを必要なときに手動で表示するには、カーソルの形状が十字線になるまで、カーソルをエディタ・ウィンドウの右下隅に移動します。次に、マウスを1回クリックし、カーソルを上にドラッグします。これによって分割バーが上に移動し、その下にコンパイル・メッセージ・ペインが表示されます。
分割バー	ソース・ペインとコンパイル・メッセージ・ペインを分割します。これによって、ペインの相対サイズを変更できます。ペインのサイズを変更するには、分割バーをクリックして、ドラッグします。 コンパイル・メッセージ・ペインが表示されない場合は、分割バーがエディタ・ウィンドウの底部にあります。
ステータス・バー	エディタの一番下に、ストアド・プログラム単位の現行の状態に関する情報を表示します。


「新規プログラム単位」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、作成するプログラム単位のタイプと名前を指定できます。


ソース・ペインに表示されるストアド・プログラム単位をコンパイルします。コンパイルの結果生成されたエラー・メッセージは、スクロール可能なコンパイル・メッセージ・ペインに表示されます。


最後の保存操作または変更の破棄操作を行ったときの状態に、ストアド・プログラム単位を戻します。保存操作または変更の破棄操作が行われなかった場合、プログラム単位は元の状態に戻ります。


現行のストアド・プログラム単位を削除します。削除する場合には、確認を行います。


現行のプログラム単位の所有者の、データベース・ユーザーIDを表示します。このフィールドの右向きの矢印キーをクリックし、アクセス権限のある、ユーザー名のドロップダウン・リストを表示します。


現行のストアド・プログラム単位の名前を表示します。「所有者」フィールドに示されたユーザーIDによって所有されるストアド・プログラム単位のドロップダウン・リストを表示するには、このフィールドの右にある矢印をクリックします。「名前」リストには、アクセス権限を付与されたストアド・プログラム単位の名前のみが表示されます。


PL/SQLストアド・プログラム単位のソース・テキストを、入力および編集するために使用されます。


コンパイル中に発見された構文エラーを表示します。プログラム単位内のエラー元の位置へナビゲートするには、エラーをクリックします。


ストアド・プログラム単位エディタの2つのペイン領域の相対量を変更できます。デフォルトでは、コンパイル・メッセージ・ペインは、コンパイル中にエラー・メッセージが生成された場合にのみ表示されることに注意してください。


構文パレットのインタフェース

構文パレットを使用すると、PL/SQL言語要素やビルトイン・パッケージの構成体を表示したりコピーできます。選択した構文は、プログラム単位エディタまたはストアド・プログラム単位エディタにのみコピーできます。

構文パレットには、次のページがあります。

PL/SQLページ	コピーするPL/SQL言語要素を表示および選択できます。PL/SQL言語要素は、制御フロー、カーソル、例外などのカテゴリの一覧にグループ化されています。
ビルトイン・ページ	ビルトイン・パッケージからPL/SQL構成体（ファンクションまたはプロシージャ）を表示および選択できます。ビルトインの一覧は、EXEC_SQL、DEBUG、DDEのようなパッケージ名でグループ化されています。

各ページには次のコンポーネントがあります。

ドロップダウン・リスト	PL/SQLカテゴリ名またはビルトイン・パッケージ名が表示されます。   右側の矢印をクリックすると、PL/SQLカテゴリまたはビルトイン・パッケージを選択できます。
リスト領域	選択されたPL/SQLカテゴリ内の個々の言語要素、または選択されたビルトイン・パッケージ内の構成体が表示されます。デフォルトで、リスト内の最初の項目がハイライト表示（選択）されます。 言語要素または構成体をクリックすると、それらが選択され、表示領域に完全な構文が表示されます。
表示領域	選択されたPL/SQL言語要素または構成体の完全な構文が表示されます。予約語は大文字で表示されます。 エディタに構文を挿入した後、コメント内にない小文字の項目を適切な値に置き換えます。コメント内の小文字の項目は任意です。
挿入	クリックすると、リスト領域で選択された項目が、アクティブ・エディタ・ウィンドウの現行のカーソル位置にコピーされます。
クローズ	クリックすると、構文パレットがクローズします。
ヘルプ	このヘルプ・トピックが表示されます。


構文パレットの表示

構文パレットを表示するには:

  「プログラム」 [image] 「構文パレット」を選択します。


構文パレットのクローズ

構文パレットをクローズするには:

  「クローズ」ボタンをクリックします。


エディタへの構文の挿入

  関連項目

構文をエディタに挿入するには:

1	プログラム単位エディタまたはストアド・プログラム単位エディタが現行の（最後に選択された）ウィンドウであることを確認します。

2	エディタ内で、構文を挿入する位置にカーソルを置きます。

3	構文パレットで、「PL/SQL」タブまたは「ビルトイン」タブをクリックします。

4	ドロップダウン・リストで、PL/SQLカテゴリまたはビルトイン・パッケージを選択します。

カテゴリまたはパッケージをクリックすると、選択できるPL/SQL言語要素またはPL/SQL構成体が下のリスト領域に表示されます。

5	リスト領域でPL/SQL言語要素または構成体を選択します。

PL/SQL言語要素または構成体をクリックすると、リスト領域の下の表示領域に構文が表示されます。

6	「挿入」をクリックして、選択された構文をコピーします。

選択したプレースホルダのあるPL/SQL構文は、アクティブ・エディタの現行のカーソル位置に挿入されます。予約語は大文字で表示されます。

コメント内にない小文字のプレースホルダを、すべて適切な値と置換します。コメント内の項目は任意です。


PL/SQLカテゴリの一覧

ブロック

コメント

制御フロー

カーソル

データ型

例外

ファンクション

ループ

オブジェクト・タイプ

パッケージ

PL/SQL表

プロシージャ

問合せ

レコード

SQLカーソル

表/ビュー

トランザクション

ユーザー・タイプ

変数


ビルトインの一覧

EXEC_SQL

TOOL_SQL

ORA_FFI

ORA_DE

ORA_PROF

ORA_NLS

TOOL_RES

TOOL_ENV

TEXT_IO

TOOL_ERR

STPROC

LIST

OLE2

DDE

DEBUG

PLITBLM

STANDARD


バージョン制御について - PVCS

  関連項目

バージョン制御とは、アーカイブ内の同じファイルの複数のバージョンを管理、メンテナンスするプロセスです。

アーカイブはユーザー定義のディレクトリで、ファイルのテキスト版と、そのファイルに加えられたすべての変更と変更日時の記述を含む、各バージョンの情報が収められています。

アーカイブを使用すると、開発チームのメンバーは、安全かつ首尾一貫した方法でファイルの任意のバージョンを検索し、変更した後、戻すことができます。

Form Builderなどのコンポーネントは、汎用的なインタフェースを経由して、任意のソース制御プロバイダにソース制御の機能を提供します。プラグイン・モジュールは、現在INTERSOLV社のPVCS(Polytron Version Control System)やPure-Atria社のClearcase、その他将来リリースされる製品で利用可能です。

PVCSのインストールと使用方法の詳細は、PVCSのマニュアルを参照してください。

PVCSではファイル・ロックとアーカイブ・レポートもサポートしています。


構成ファイルについて

ソース制御インタフェースの最適なパフォーマンスを得るために設定する必要がある4つの環境変数があります。これらの環境変数は、Windows 3.1では、oracle.iniで設定され、Windows NTまたはWindows 95/98では、レジストリのSOFTWARE/ORACLEキーで設定されます。

DEV2000_SOURCECONTROLは、使用するソース制御システムを指定します。これは、"PVCS"に設定する必要があります。Form Builderなどのコンポーネントは、デフォルトでPVCSを使用するため、この変数を省略すると、このリリースでは大きな効果を得ることはできません。ただし、その他のソース制御システムのサポートを追加している場合は、この変数を設定することにより、そのソース制御システムの機能を期待どおり確実に利用することができます。

DEV2000_PROJECTは、Forms Developerリリース1.0および1.1からTVCCFG変数を置き換え、使用する必要があるPVCSプロジェクト構成(.CFG)ファイルを識別します。環境変数を使用してプロジェクト構成ファイルを指定しない場合は、セッションごとに、「ソース制御オプション」ダイアログ・ボックスからプロジェクト構成ファイルを選択する必要があります。

DEV2000_SCVIEWERは、ソース制御のログやレポート操作の違いの結果を表示するために使用するプログラムを制御します。結果の表示を無効にするには、この変数をnull(値なし)に設定します。

DEV2000_SCCONVERTは、ファイルをPVCSに対してチェックインする前にファイルをASCIIに変換するかどうかと、ファイルをチェックアウトする前にファイルをバイナリに戻すかどうかを制御します。以前のバージョンのForms DeveloperでのPVCSの使用からアップグレードしていて、この動作をそのまま残す場合以外は、このエントリをデフォルトのFALSEに設定しておく必要があります。

oracle.iniの例の一部を次に示します。

...

DEV2000_SOURCECONTROL=PVCS

DEV2000_PROJECT=C:\PROJECTS\MYPROJ\MYPROJ.CFG

DEV2000_SCVIEWER=NOTEPAD.EXE

DEV2000_SCCONVERT=FALSE

...


PVCSのインプリメントについて

一定のオブジェクト（フォーム、メニュー、レポート、図表、PL/SQLライブラリ）をチェックインすると、バイナリ・ファイルは等価のテキスト・ファイルに自動的に変換され、そのテキスト・ファイルがソース制御にチェックインされます。たとえば、MYFORM.FMBをチェックインした場合、MYFORM.FMBは自動的にMYFORM.FMBをMYFORM.FMT（テキスト形式のMYFORMファイル）に変換した後、MYFORM.FMTをソース制御にチェックインします。

同様に、アーカイブ・ファイルをチェックアウトする場合、Oracle Developerではテキスト形式のファイルを、デザイナ・インタフェースで読めるバイナリ形式に変換します。MYFORM.FMTをチェックアウトしたら、編集できるようにMYFORM.FMBに変換します。

アーカイブは、あるファイルの異なるバージョン間でより有意義な差分レポートを生成できるように、テキスト形式のファイルに対して行われます。PVCSではバイナリ・ファイルのアーカイブをサポートしていますが、バイナリ・ファイルのバージョン間の差分レポートの生成はできません。

このファイル変換の結果、PVCSの設定によっては、作業ディレクトリに余分なファイルが残ることがあります。プロジェクトが、ワーク・ファイルをチェックイン後に読取り専用ファイルにするよう構成されている場合、作業ディレクトリにはバイナリ・ファイルと読取り専用のテキスト形式のファイルの両方が残ります。ただし、プロジェクトが、ワーク・ファイルをチェックイン後削除するように構成されている場合は、作業ディレクトリにはバイナリ・ファイルのみが残ります。


ファイルのチェックインについて

  関連項目

ファイルを変更しアーカイブにチェックインするたびに、ファイルは新しいバージョンになります。あるファイル（拡張子がpllのPL/SQLライブラリ・ファイルなど）をチェックインすると、PVCSではバイナリからテキストへの変換を自動的に実行し、そのファイルを適切な拡張子（pldなど）を持つテキスト・ファイルとして、指定したディレクトリにアーカイブします。PVCSでは、このテキスト・ファイルを使用してアーカイブ・レポートを生成します。

バージョン・ラベルにより、バージョンはアプリケーションの完全バージョンを構成する代表的なバージョン群の１つとして識別されます。バージョン・ラベルを使用すると、特定のバージョンに関係付けられたすべてのファイルを、1つの名前を参照することで同時に操作できます。現行モジュールのバージョンをすでにアーカイブしている場合、Oracle Developerではアーカイブ・フィールドに適切な情報を自動的に挿入します。


ファイルのチェックアウトについて

  関連項目

アーカイブからファイルをチェックアウトすると、参照、編集または印刷をするためにファイルにアクセスできます。デフォルトでは、ロックされた特定のバージョンをチェックアウトできるのは一度に1人のユーザーのみです。

ファイルをチェックアウトする場合、ファイルはアーカイブされたテキスト版から適切な形式に自動的に変換します（たとえば、PL/SQLライブラリ・ファイルをpldから.pllへ変換）。アーカイブからチェックアウトしたファイルはワーク・ファイルと呼ばれます。ワーク・ファイルをチェックインするたびに、これが最新バージョンになります。


アーカイブ・レポートの作成について

  関連項目

PVCSによって、次のアーカイブ・アクティビティを要約するレポートを生成できます。

•	アーカイブの作成

•	アーカイブされたファイルの属性

•	継続的な改訂

•	ラベル名

•	最後の改訂で変更された行

•	ワーク・ファイルの説明


プロモーション・モデルについて

プロモーション・モデルとは、開発サイクルにおける重要段階の階層構造です。プロモーションを使用して、設計段階から最終的なリリースまでソース・コードの開発を制御します。各重要段階はプロモーション・グループによって表されます。プロモーション・グループの例として、Development（開発）およびQuality Assurance（品質保証）、Production（生産）があります。プロモーション・モデルは先進機能で、正式にソフトウェアの切替えを図っている現場での使用をお薦めします。

プロモーション・モデルには、1つ以上の最下位グループ、すなわち開発グループを設定することができます。プロモーション・モデルが実行されていると、開発グループに関係付けられたバージョンしか変更することはできません。上位グループに関係付けられたバージョンを編集するには、そのバージョンをチェックアウトし、チェックアウト時に1つの開発グループに再び関係付けてから、チェックインしなおして上位グループに再び昇格させる必要があります。

プロモーション・モデルに開発グループが1つしかない場合、一度にロックできるのは、アーカイブ内の1つのバージョンのみです。開発を並行して進めるためのプロモーション・モデルを設計するには、最低2つの開発グループを設定する必要があります。

開発グループの上には、テストや予備リリースの様々な段階のために、中間のプロモーション・グループをいくつでも定義できます。最上位レベルはProductionグループで、 通常、バージョンに最終的なリリースの準備ができたことを示します。

プロモーション・モデルを使用すると、次のことができます。

•	プロジェクトの状態の迅速な判断。1つのプロジェクト内で、プロジェクトに関するアーカイブ・レポートを実行して、どのモジュールが重要段階に達していないかを即座に判断することができます。

•	非開発レベルでのバージョンへのアクセスの制御。開発後のプロモーション・グループに関係付けられたバージョンを変更することはできないので、必ずすべてのバージョンを徹底的にテストするようにします。

•	独自のモデルのカスタム設計。各プロジェクトに最適のプロモーション構造体を、任意の数の重要段階を設定してカスタム設計することができます。


アーカイブ・ディレクトリの作成

  次のステップ	  関連項目

アーカイブ・ディレクトリを作成するには: 注意:

1	「ファイル」 [image] 「管理」 [image] 「ソース制御オプション」を選択して、「ソース制御: オプション」ダイアログを表示します。

2	「プロジェクト」タブがまだ選択されていない場合は選択します。

3	「アーカイブするディレクトリ」フィールドで、自分のアーカイブ・ディレクトリの名前と位置を指定します。

4	「追加」をクリックし、次に「クローズ」をクリックしてダイアログをクローズします。


レジストリでDEV2000_PROJECTパラメータを定義済みでない限り、アーカイブ・ディレクトリを追加することはできません。Microsoft Windowsでは、DEV2000_PROJECTパラメータを次のように定義します。

DEV2000_PROJECT=C:\PVCS\PROJECT1\PROJECT1.CFG

DEV2000_PROJECTパラメータの編集には、Windows 3.1の場合はOracle.iniファイルを使用し、Windows 95/98およびWindows NTの場合はレジストリを使用します。


ファイルのチェックイン

  次のステップ	  関連項目

ファイルをチェックインするには:

1	「ファイル」 [image] 「管理」 [image] 「チェックイン」を選択して、「ソース制御: チェックイン」ダイアログを表示します。

2	「ワーク・ファイル」テキスト・ボックスにアーカイブするファイルの名前を入力します。

3	「アーカイブするファイル」フィールドで、自分のアーカイブ・ディレクトリを指定します。

4	（オプション）  「バージョン・ラベル」、「プロモーション・グループ」、「記述」を指定します。

5	（オプション）  アーカイブ･ファイルのチェックイン後も、ファイルの書込み可能なコピーをローカルに残したい場合、「チェックイン後もロックを継続」チェックボックスをクリックします。ファイルの書込み可能なコピーがあれば、最初にファイルをチェックアウトしなくても、ファイルに後続の変更を加え、チェックインすることができます。

6	「OK」をクリックして、ファイルをチェックインします。

PVCSによってファイルがアーカイブされます。


ファイルのチェックアウト

  次のステップ	  関連項目

ファイルをチェックアウトするには:

1	「ファイル」 [image] 「管理」 [image] 「チェックアウト」を選択し、「ソース制御: チェックアウト」ダイアログを表示します。

2	「ソース・アーカイブ」フィールドでソース・アーカイブ・ディレクトリを指定します。

3	「ファイル名」テキスト・ボックスに、チェックアウトするファイルの名前を入力します。

4	「改訂バージョン」フィールドで、希望するファイルの改訂バージョンを選択します。

5	（オプション）  「配布先」フィールドにパスを入力して、希望する配布先を指定します。

6	（オプション）  チェックアウトするファイルをロックする場合、チェックアウトするバージョンに割り当てられる開発レベルのプロモーション・グループを選択する必要があります。

7	（オプション）  「チェックアウト時にファイルをロック」チェックボックスをクリックします。注意:

8	（オプション）  「チェックアウト時にファイルをオープン」チェックボックスをクリックします。このボックスをチェックすると、チェックアウトしたファイルは、PVCSからチェックアウトした後、デザイナでオープンされます。

9	「OK」をクリックして、ファイルをチェックアウトします。


アーカイブ・ファイルを変更する場合は、変更をチェックインするために、「チェックアウト時にファイルをロック」チェックボックスを使用可能にする必要があります。使用可能にしないと、ファイルの読込み専用版がチェックアウトされます。


アーカイブ・レポートの作成

  関連項目

アーカイブ・レポートを作成するには:

1	「ファイル」 [image] 「管理」 [image] 「ソース制御オプション」を選択します。

2	「レポート」タブをクリックして、「ソース制御: レポート・オプション」ページを表示します。

3	「アーカイブ」フィールドでアーカイブ・ディレクトリを指定します。

4	「ソース・ファイル」フィールドで、希望するアーカイブ・ファイルの名前を指定します。PVCSでは、このファイルとターゲット・ファイルの比較に基づいてレポートが生成されます。

5	「ターゲット・ファイル」フィールドで、ターゲット・ファイルの名前を指定します。注意

6	「改訂バージョン」フィールドで、希望するファイルの改訂バージョンを選択します。

7	「出力ファイル」フィールドでレポートの名前とディレクトリを指定し、「レポート実行」をクリックします。

PVCSによってレポートが作成されます。DEV2000_SCVIEWER環境変数またはレジストリのパラメータで表示プログラムが指定されている場合、出力を表示するためにこのプログラムがコールされます。指定されていない場合は、エディタを使用して、レポート・ファイルをオープンします。


同じアーカイブ内で2つの改訂バージョンを比較する場合、ステップ4で入力したアーカイブ・ファイルの名前を入力します。 異なるアーカイブ・ファイルを比較する場合、「ターゲット・ファイル」フィールドで異なるアーカイブ・ファイルを1つ指定します。


「ソース制御: チェックイン」ダイアログ

  関連項目

希望するファイルを指定したアーカイブにマージします。

「チェックイン」ダイアログには、次のオプションがあります。

ワーク･ファイル	チェックインするファイルの名前を指定します。「参照」を選択して、ファイルを選択することができるファイル・ダイアログを起動します。
アーカイブするファイル	現行のプロジェクトに使用可能なすべてのアーカイブのドロップダウン・リスト。リストからファイルをチェックインするアーカイブを選択します。
バージョン・ラベル	（オプション）ファイルのバージョン・ラベルを指定します。
プロモーション・グループ	PVCSプロジェクトにプロモーション・モデルが定義されている場合、このリストが使用可能になります。チェックインする改訂バージョンに割り当てられる、開発レベルのプロモーション・グループを選択します。
説明	この改訂バージョンに加えられた変更の記述を指定します。オプションですが、チェックアウト時に改訂バージョンを指定しやすくするため、変更の記述を入力することをお薦めします。
チェックイン後もロックを継続	アーカイブ・ファイルの書込み可能なコピーを、チェックイン後もローカルに残すかどうかを指定します。ファイルの書込み可能なコピーがあれば、最初にファイルをチェックアウトしなくても、ファイルに後続の変更を加え、チェックインすることができます。


「ソース制御: チェックアウト」ダイアログ

  関連項目

指定したファイルを、編集できるようにアーカイブから取り出します。

「チェックアウト」ダイアログには、次のオプションがあります。

ソース・アーカイブ	ファイルをチェックアウトするアーカイブのディレクトリ名を指定します。
ファイル名	ソース制御から取り出すファイルの名前を指定します。「参照」を選択して、ファイルを選択することができるファイル・ダイアログを起動します。
改訂バージョン	「ファイル名」フィールドで選択したファイルの、使用可能な改訂バージョンとバージョン・ラベルを表示します。
説明	「改訂バージョン」リストにある使用可能な改訂バージョンの記述をリストします。
配布先	（オプション） チェックアウトするファイルの配布先ディレクトリを指定します。
プロモーション・グループ	PVCSプロジェクトにプロモーション・モデルが定義されている場合、このリストが使用可能になります。チェックアウトするファイルにロックをかける場合、チェックアウトする改訂バージョンに割り当てられる開発レベルのプロモーション・グループを選択する必要があります。
チェックアウト時にファイルをロック	チェックアウトするファイルにロックのマークを付けるかどうかを指定します。ロックされたファイルは、他のユーザーによる更新から保護されます。
チェックアウト時にファイルをオープン	このボックスをチェックすると、チェックアウトしたファイルは、PVCSからチェックアウトした後、デザイナでオープンされます。


「ソース制御: オプション」ダイアログ

  関連項目

「オプション」ダイアログには、次の3つのタブがあります。

「ソース制御: プロジェクト・オプション」ページ

「ソース制御: ファイル・オプション」ページ

「ソース制御: レポート・オプション」ページ


「ソース制御: プロジェクト・オプション」ページ

  関連項目

プロジェクト構成ファイルで、アーカイブ・ディレクトリの追加および削除ができるようにします。

「プロジェクト・オプション」ページには、次の設定項目があります。

現行プロジェクト	現行のPVCSプロジェクト構成ファイルの名前。初期値はレジストリのDEV2000_PROJECTの値です。直接ファイル名を入力するか、または「参照」を選択して、使用しているオペレーティング・システムのファイル・ダイアログを表示することができます。
アーカイブするディレクトリ	現行のプロジェクトで使用可能なアーカイブ・ディレクトリのリストに追加する、新しいアーカイブ・ディレクトリを指定します。直接ディレクトリ名を入力するか、または「参照」を選択して、使用しているオペレーティング・システムのファイル・ダイアログを表示することができます。
アーカイブ・ディレクトリ・リスト	現行のプロジェクトで使用可能なアーカイブ・ディレクトリを表示します。
追加	「アーカイブするディレクトリ」テキスト・ボックスにアーカイブ・ディレクトリを入力してから、「追加」をクリックし、ディレクトリを現行のプロジェクトに追加します。追加されたディレクトリはリストに表示されます。
削除	リストからアーカイブ・ディレクトリを選択し、次に「削除」をクリックして、プロジェクトからディレクトリを削除します。


「ソース制御: ファイル・オプション」ページ

  関連項目

アーカイブのロックやアンロック、またはそのアーカイブでのアクティビティのログの生成ができるようにします。

「ファイル・オプション」ページには、次の設定項目があります。

アーカイブ	現行のプロジェクト構成ファイル内のすべてのアーカイブ・ディレクトリのドロップダウン・リスト。
ファイル名	アクセスするアーカイブ・ファイルを指定します。直接ファイル名を入力するか、または「参照」を使用してファイルを選択することができます。PVCSプロジェクトがワーク・ファイルのパスを無視するように構成されている場合、ワーク・ファイルまたはアーカイブ・ファイルのいずれかを指定できます。そのように構成されていない場合は、必ずアーカイブ・ファイルのみを指定してください。
改訂バージョン	このドロップダウン・リストでは、選択したファイルの使用可能な改訂バージョンとバージョン・ラベルがすべて表示され、ファイルが選択されていない場合には空項目が表示されます。特定の改訂バージョンを選択した場合、その改訂バージョンはロックまたはアンロックされます。改訂バージョンを選択しない場合、プロモーション・モデルが定義されているかどうかでロックの動作が決まります。プロモーション・モデルが定義されていない場合は、チップ・バージョンがロックされます。定義されている場合は、指定したプロモーション・グループに現在割り当てられている改訂バージョンがロックされます。改訂バージョンを選択せずにアンロックする動作では、必ずそのファイルにかけたすべてのロックが解除されます。
プロモーション・グループ	PVCSプロジェクトにプロモーション・モデルが定義されている場合に使用可能なリストで、プロモーション・モデル内のすべての開発レベルのプロモーション・グループを表示します。改訂バージョンをロックする場合、リストに表示されるプロモーション・グループはその改訂バージョンに割り当てられます。
ログ・ファイル名	ログ・ファイルの名前を指定します。
ログ・タイプ	チェックインまたはチェックアウトが発生した際、指定したログ・ファイルに入力される更新のタイプを指定します。
ロック	ソース制御から取り出さずに、「ファイル名」フィールドで指定したファイルをロックします。ロックされたファイルは、他のユーザーによる更新から保護されます。「改訂バージョン」リストから特定の改訂バージョンを選択すると、その改訂バージョンがロックされます。改訂バージョンを選択しなかった場合、チップ・バージョン（すなわち、指定したプロモーション・グループに現在割り当てられている改訂バージョン）がロックされます。PVCSプロジェクトにプロモーション・モデルが定義されている場合、指定したプロモーション・グループはロックされている改訂バージョンに割り当てられます。
アンロック	「ファイル名」フィールドで指定したファイルをアンロックし、他のユーザーがそのアーカイブ・ファイルに対してチェックアウトや変更を行えるようにします。「改訂バージョン」リストから特定の改訂バージョンを選択した場合、その改訂バージョンはアンロックされます。改訂バージョンを選択しなかった場合、そのファイルの改訂バージョンにかけたロックはすべて解除されます。
ログ生成	名前を指定してログ・ファイルを生成します。ログ・ファイルの項目のタイプは、「ログ・タイプ」オプションの設定によって決まります。DEV2000_SCVIEWER環境変数またはレジストリのパラメータで表示プログラムが指定されている場合、出力を表示するためにこのプログラムがコールされます。


「ソース制御: レポート・オプション」ページ

  関連項目

アーカイブ・レポートの定義と作成ができます。

「レポート・オプション」ページには、次の設定項目があります。

アーカイブ	現行のプロジェクト構成ファイル内のすべてのアーカイブ・ディレクトリのドロップダウン・リスト。
ソース・ファイル	差分レポートで最初に使用するファイルを指定します。直接ファイル名を入力するか、または隣りの「参照」ボタンを使用してファイルを選択することができます。PVCSプロジェクトがワーク・ファイルのパスを無視するように構成されている場合、ワーク・ファイルまたはアーカイブ・ファイルのいずれかを指定できます。そのように構成されていない場合は、必ずアーカイブ・ファイルのみを指定してください。
改訂バージョン	ソース・ファイルのすべての使用可能な改訂バージョンとバージョン・ラベルのドロップダウン・リスト。
ターゲット・ファイル	ターゲット・ファイルの名前を指定します。PVCSでは、ソース・ファイルとターゲット・ファイルの比較に基づいてレポートを生成します。
改訂バージョン	ターゲット・ファイルの使用可能なすべての改訂バージョンとバージョン・ラベルのドロップダウン・リスト。
出力ファイル	ファイルを他のファイルと比較する際、差分レポートが書き込まれる配布先ディレクトリおよびファイル名を指定します。
レポート実行	指定したオプションに従って、レポートを作成します。DEV2000_SCVIEWER環境変数またはレジストリのパラメータで表示プログラムが指定されている場合、出力を表示するためにこのプログラムがコールされます。


エラー・メッセージ

ソース制御インタフェース・ダイアログの使用中に、次のエラー・メッセージが表示されることがあります。

D2SCP-001:	ファイル・システムにファイルのアクセスを拒否されました。

原因:	アーカイブ・ファイルの読込み、またはワーク・ファイルの書込み、ログ出力またはレポート出力の書込みを行うファイル・システム・アクセス権限がありません。

処置:	これらのファイルに対するファイル・システム・アクセス権限が必要であると思われる場合は、システム管理者に連絡してください。

D2SCP-002:	バージョン・マネージャに対するアクセス権限が不十分です。

原因:	指定したアーカイブにアクセスするPVCS権限がありません。マスター･プロジェクトでアーカイブ・ディレクトリの変更ができないのに、「オプション」ダイアログの「プロジェクト・オプション」タブで変更しようとした場合にも、このエラーが表示されます。

処置:	そのアーカイブに対するアクセス権限が必要であると思われる場合は、PVCS管理者に連絡してください。

D2SCP-003:	すでにアーカイブが存在します。

原因:	これは内部エラーの発生を示し、表示されてはならないメッセージです。

処置:	操作を繰り返し試行した後もエラーが発生する場合は、サポート担当に連絡してください。

D2SCP-004:	指定したアーカイブが見つかりません

原因:	アーカイブ・ファイルが必要なときに、アーカイブではないファイル名を入力または選択しました。このエラーは通常、アーカイブ・ファイルではなくワーク・ファイル（たとえば、MYFORM.FMVではなくMYFORM.FMB）を選択したことが原因です。

処置:	「参照」ボタンを使用してアーカイブ・ファイルを選択します。

D2SCP-005:	無効なファイル名：ドライブまたはパスが存在しないか、ファイル名に無効な文字が使われています。

原因:	入力したファイル名が、オペレーティング・システムの有効なファイル名ではありません。

処置:	ファイル名の構文にエラーがないかチェックしてください。

D2SCP-006:	ファイルは別プロセスで使用中です。

原因:	アクセスしようとしたファイルは、他のPVCSユーザーが使用中です。

処置:	通常、少し時間を置いてから再び操作すれば、アクセスできます。

D2SCP-007:	変換に失敗しました。ワーク・ファイルが読込み専用であるか、サポートされていないタイプである可能性があります。

原因:	このエラーの原因として、次のことが考えられます。

A.	ワーク・ファイルが読込み専用である可能性があります。このエラーは、ファイルをロックせずにチェックアウトし、その後「オプション」ダイアログからロックした場合に起こります。

B.	認識されないタイプのファイルをチェックインまたはチェックアウトしようとしました。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	Windowsのファイル・マネージャまたはエクスプローラを使用して、操作を進める前にファイルを書込み可能にしてください。

B.の場合	スタンドアロンのPVCSインタフェースを使用して、ファイルのチェックインまたはチェックアウトを行ってください。

任意のファイルをチェックアウトできますが、チェックインできるのはForms Developerが認識するファイルのみであることに注意してください。これは、Forms Developerでは、ワーク・ファイルからしかサポートするファイル・タイプかどうかを判別できないためです。チェックインする時点でワーク・ファイルがあります。したがって、Forms Developerはチェックインする前にそのファイルをテストします。チェックアウトするときは、そのファイルはワーク・ファイルを取得するためにチェックアウトされます。そうしなければ、Forms Developerではファイルをテストできません。したがって、チェックアウトしているファイルがForms Developerによって認識されないタイプのファイルであるとわかっていれば、チェックアウトのときにこのエラーを無視してもかまいません。

D2SCP-008:	値が無効であるか、不十分です。

原因:	これは内部エラーの発生を示し、表示されてはならないメッセージです。

処置:	操作を繰り返し試行した後もエラーが発生する場合は、サポート担当に連絡してください。

D2SCP-010:	指定したバージョン・ラベルがすでに存在します。

原因:	「チェックイン」ダイアログで、チェックインするファイルに、すでに存在している改訂バージョン・ラベルを指定しました。PVCSでは、指定する改訂バージョン・ラベルは他と重複しないでください。

処置:	ラベルを変更してください。使用中のラベルを参照するには、「オプション」ダイアログの「ファイル・オプション」タブで「ログ」機能を使用します。

D2SCP-011:	指定された改訂バージョンは存在しません。

原因:	これは内部エラーの発生を示し、表示されてはならないメッセージです。

処置:	操作を繰り返し試行した後もエラーが発生する場合は、カスタマ・サポートに連絡してください。

D2SCP-012:	無効な構成ファイルが指定されました。

原因:	このエラーの原因として、次のことが考えられます。

A.	「オプション」ダイアログの「プロジェクト・オプション」タブで選択したファイルが、有効なPVCS構成ファイルではありません。

B.	「チェックイン」ダイアログまたは「チェックアウト」ダイアログにアクセスしようとして、このエラーが発生した場合、DEV2000_PROJECT環境変数で指定された構成ファイルが無効であることを意味します。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	別の有効なファイルを選択します。

B.の場合	変数を変更するか、「オプション」ダイアログの「プロジェクト・オプション」タブを使用して、有効な構成ファイルを設定してください。

D2SCP-013:	最初に、「ソース制御オプション」からプロジェクトを選択する必要があります。

原因:	「チェックイン」ダイアログまたは「チェックアウト」ダイアログにアクセスしようとしましたが、レジストリでDEV2000_PROJECT変数を使用して、または「オプション」ダイアログの「プロジェクト・オプション」タブ上で、プロジェクトを指定していません。

処置:	操作を続行する前に「プロジェクト・オプション」タブを表示し、プロジェクトを選択する必要があります。

D2SCP-014:	プロジェクト構成ファイルを更新できません。

原因:	プロジェクト構成ファイルからアーカイブ・ディレクトリを追加または削除しようとしましたが、ファイルまたはファイルがあるディレクトリに対する書込み許可がありません。

処置:	このアクセス許可が必要であると思われる場合は、PVCS管理者またはシステム管理者に連絡してください。

D2SCP-015:	改訂バージョンがロックされていません。

原因:	ロックしていない改訂バージョンをチェックインしようとしたか、またはロックしていない改訂バージョンを（「ファイル・オプション」タブから）アンロックしようとしました。

処置:	変更を加えた場合、改訂バージョンをチェックインする前に「ファイル・オプション」タブでロックしてください。

D2SCP-016:	指定した改訂バージョンをロックできません。

原因:	「チェックアウト」ダイアログから改訂バージョンをロックしてチェックアウトしようとしたか、または「ファイル・オプション」タブから改訂バージョンをロックしようとしましたが、PVCSではロックの権限を付与できませんでした。このエラーの原因として、次のことが考えられます。

A.	その改訂バージョンがすでに、自分または他のユーザーによってロックされています。

B.	プロジェクトに複数のロックをかけることができず、その改訂バージョンはすでにロックされています。

C.	プロジェクトにプロモーション・モデルがある場合、指定したプロモーション・グループが、ロックした改訂バージョンにすでに割り当てられている可能性があります。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	「ログ」機能を使用して誰がロックしているかを参照します。 自分で改訂バージョンをロックしている場合、ロックを要求せずにファイルをチェックアウトします。他のユーザーがロックしている場合、そのユーザーがロックを解除するのを待ってから、変更のためにファイルをチェックアウトします。

B.の場合	改訂バージョンかファイルが使用可能になるのを待つか、またはそのプロジェクトで1つのファイルに複数のロックがかけられるようにすることを考えてください。

C.の場合	プロモーション・グループが使用可能（ロックされた改訂バージョンに割り当てられていない状態）になるのを待つか、または別の開発レベルのプロモーション・グループを使用してください。

D2SCP-017:	指定したディレクトリが存在しません。

原因:	存在しないディレクトリを指定しました。このエラーは通常、ファイルをチェックインした場所がワークステーション上に存在しないのに、そこからファイルをチェックアウトしようとしたことが原因です。

処置:	この場合は、「宛先」フィールドを編集して、既存のディレクトリを指定してください。

D2SCP-018:	出力をファイルにリダイレクトできません。

原因:	ログ出力または差分レポート出力に指定したファイル名が無効か、またはファイルを書込みのためにオープンできませんでした。

処置:	有効で書込み可能なファイルを指定します。

D2SCP-100:	PVCSエラー 数値 - キーワード

原因:	「ソース制御インタフェースでは処理できませんでした」というエラーが、PVCSから戻されました。

処置:	PVCSのマニュアルでエラーの数値またはエラーのキーワードを使用してエラーを調べ、適切な処置を行ってください。


PVCS構成マネージャ・インタフェースで、新規ファイルまたは改訂バージョンが表示されないのはなぜですか？

ファイルをチェックインし、改訂バージョン・ラベルを割り当てたのに、PVCS構成マネージャ・インタフェースで、新規ファイルまたは改訂バージョンが表示されません。どうすればよいのでしょうか？

プロジェクト・フォルダを、アーカイブ（新規ファイルおよび改訂バージョン）にある新しい情報で更新する必要があります。更新するには、PVCSの最上位の「Project」メニューから「プロジェクト・フォルダ更新...」を選択します。すると、新規ファイルおよび改訂バージョンが、PVCSの「フォルダ」ウィンドウに表示されます。


ソース制御メニュー・オプションが、1つの製品でしか使用できないのはなぜですか？

複数の製品を同時に実行すると、ソース制御メニュー・オプションがそのうちの1つでしか使用できません。なぜですか？

Windows上のPVCSはリエントラントではありません。つまり、PVCSサービスに一度にアクセスできるのは1つのプログラム（Report BuilderのようなPVCSが使用可能なプログラム、またはPVCSインタフェース自体のいずれか）のみです。使用可能なメニューがあるプログラムと、そこからPVCSサービスにアクセスしたいプログラムを両方とも終了する必要があります。次に、PVCSへのアクセスを必要とするプログラムを再起動します。


「PVCSがアーカイブを検索できません」というエラーが出るのはなぜですか？

レポートをチェックアウトしようとして、.RDV（アーカイブ・ファイル）を選択しましたが、PVCSがアーカイブを検索できないというエラーが出ます。どうなっているのでしょうか？

.RDVファイルを選択したとしても、そのファイルはアーカイブ・ファイルではなかった可能性があります。Report Builderでは、チェックイン前に、中間（ASCII）ファイルを拡張子.RDVのファイルとして作成します。（詳細は、PVCSのインプリメントについてを参照してください。）作業ディレクトリではなく、アーカイブ・ディレクトリから.RDVファイルを選択していることを確認してください。この混乱を避けるには、次の3つの方法が役立ちます。

•	チェックイン後にワーク・ファイルを削除するようにPVCSプロジェクト・オプションを設定します。これによって、Reports中間.RDVファイルがディスク上に残らないようにします。

•	.RDVファイルがチェックインされると、VRDなどの異なる接尾語が付けられるように、接尾語のルールを変えます。これで、チェックアウト時に、.RDVではなくVRDのファイルを探すことができます。

•	アーカイブを検索するときに、ワーク・ファイルのパスを無視するようにプロジェクトを構成します。これで、チェックアウト時に、アーカイブ・ファイルではなくワーク・ファイル（この場合はRDFファイル）を指定できるようになります。

これらの方法は、PVCS構成マネージャのユーザー・インタフェース、「プロジェクト構成...」メニュー項目から実行可能です。


どうすれば、ファイルをロックするとき、必ず正しいユーザー名が使用されるようにすることができますか？

ファイルをロック（またはロックしてチェックアウト）すると、必ずユーザーIDが「UNKNOWN」に設定されてしまいます。このように設定されると、他のユーザーがファイルをチェックインまたはアンロックできるようになります。どうすれば必ず正しいユーザー名が使用されるようにすることができますか？

（PVCS改訂バージョン・マネージャ・インタフェースの）PVCSプロジェクト構成オプションの「ネットワーク」セクションに、「ログイン・ソース」というオプションがあります。 これを使用して、この問題を回避することができます。このオプションによって、PVCSが現在のユーザIDを判別する方法を定義することができます。たとえば、NETWAREネットワークを使用する場合、PVCSに現行のNETWAREログインIDを使用するように指示することができます。Windows NTでは、"HOST"ログイン・ソースを使用して、NTログインIDを使用することができます。詳細は、PVCSのマニュアルを参照してください。


チェックアウトのためにワーク・ファイルを選択できるようにする方法はありますか？

チェックアウトのために、アーカイブ・ファイルではなく、ワーク・ファイルを選択できるようにする方法はありますか？

（PVCS改訂バージョン・マネージャ・インタフェースの）PVCSプロジェクト構成オプションの「アーカイブ検索」セクションにある「ワーク・ファイル・パスを無視」というオプションを使用することができます。このオプションを使用すると、「チェックアウト」ダイアログおよび「ソース制御オプション」ダイアログで、ワーク・ファイルまたはアーカイブ・ファイルのいずれかを選択できるようになります。


「VCSDIRがプロジェクト構成ファイルで実現できません」というエラーが出るのはなぜですか？

マスター・プロジェクトをアーカイブ・ディレクトリの変更ができないように構成しました。PVCS改訂バージョン・マネージャ・インタフェースでは、意図したとおり、サブプロジェクトでアーカイブ・ディレクトリを変更することはできません。しかし、Forms Developerでは変更できました。その後、PVCS改訂バージョン・マネージャ・インタフェースから「VCSDIRがプロジェクト構成ファイルで実現できません」というエラーが戻されました。どうなっているのでしょうか？

PVCS改訂バージョン・マネージャ・インタフェースでは、ルート・ディレクトリでデフォルトの MASTER.CFG を検索します。 アーカイブ・ディレクトリを変更した後に、このファイルを元のディレクトリで検索したために、このエラーが通知されたものと思われます。マスター構成ファイルを認識できるようにするには、 VCONFIG  コマンドを使用してPVCSを構成する必要があります。これにより、PVCSライブラリにあるマスター構成ファイルの名前が暗号化され、誰もアーカイブ・ディレクトリのリストを不用意に変更できないようになります。詳細は、INTERSOLV社PVCS付属の『PVCSコマンド行リファレンス・ガイド』の「Master Configuration Files」および「VCONFIG Command」の項を参照してください。


• 9


非Oracleデータソースへのアクセス

  関連項目

Oracle Developerアプリケーションは、Oracle Open Client Adapter(OCA)を使用して任意のODBCデータソースに接続できます。次にリストするデータソースについて、特別な情報を提供します。

アクセスしたいデータソースをクリックします。

Personal Oracle Lite

Microsoft SQL Server(バージョン4.2、6.0および6.5)

Microsoft Access(バージョン2.0以降)

Oracle Rdb(バージョン5.1、6.1および7.0)

Sybase(SQL Serverバージョン4.9、システム10およびシステム11)

Tandem NonStop SQL

Informix(SEおよびオンライン・バージョン5.x、6.xおよび7.x)


Open Client Adapter(OCA)の使用準備

  関連項目

使用するシステムでOCAの使用を設定するには:

1	ネットワーク・ライブラリを含む、必要なサーバーおよびクライアント・ソフトウェアをインストールします。データベースを構築し、データベース・アカウントを作成し、ユーザーに適切なアクセス権限を付与します。Microsoft Accessのようなシングル・ユーザー、シングル・マシンのデータソースには、データベース・サーバーやデータベース・クライアントなどの概念はなく、特別なセットアップは必要ありません（ただし、データベース表を格納するためのデータベース・ファイルを作成する必要はあります）。

2	必要なODBCドライバをクライアント・マシンにインストールし、Microsoft ODBC Administrator(ドライバとともに自動的にインストールされます)を使用してデータソースを構築します。Intersolv社製のODBCドライバ(SQL ServerおよびRdb、Sybase、Informix、Ingres、その他の多数のデータベース用)は、インストレーションCDからインストールされます。MicrosoftやIBM、その他のODBCドライバ・ベンダー製のドライバも使用できます。


Personal Oracle Liteへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Personal Oracle Liteにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。このデータ・ディクショナリ・ビューにより、開発時に必要なデータベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Personal Oracle Liteデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Personal Oracle Liteへのアクセスの詳細は、oca_info.pdfを参照してください。


Init_Formは、form-levelを自動的に変更するOPENDBルーチンで、これによってフォームはODBCデータソースと対話できます。


OCA.PLLは、ディレクトリORACLE_HOME\ocaにあります。Form BuilderがOCA.PLLを見つけることができるように、レジストリ内の環境変数FORMS50_PATHに、ディレクトリORACLE_HOME\oca20を追加する必要があります。


Microsoft SQL Serverへのアクセス

  関連項目	  Open oca_info.pdfをオープンする

Microsoft SQL Serverにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Microsoft SQLサーバー・データソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Microsoft SQL Serverへのアクセスの詳細は、oca_info.pdfを参照してください。


Oracle Rdbへのアクセス

  関連項目 	  Open oca_info.pdf をオープンする

Oracle Rdbにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)OCA.PLLライブラリをアプリケーションに接続します。次に、OPENDB.Init_Formルーチンを含むPre-FormまたはWhen-New-Form-Instanceトリガーを作成します。

7	Oracle Rdbデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Oracle Rdbへのアクセスの詳細は、oca_info.pdfを参照してください。


Microsoft Accessへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Microsoft Accessにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	(オプション)SQLスクリプトを実行し、次に示すようにUBTユーティリティによりデモ表の作成とデータの挿入を行います。

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

6	Microsoft Accessデータソースに接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Microsoft Accessへのアクセスの詳細は、oca_info.pdfを参照してください。


Sybaseへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Sybaseにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Sybaseデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Sybaseへのアクセスの詳細は、oca_info.pdfを参照してください。


Tandem NonStop SQLへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Tandem NonStop SQLにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Tandem NonStop SQLデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Tandem NonStop SQLへのアクセスの詳細は、oca_info.pdfを参照してください。


Informixへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Informixにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Informixデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Informixへのアクセスの詳細は、oca_info.pdfを参照してください。


Open Client Adapter(OCA)について

  oca_info.pdfをオープンする

ODBC用のOracle Open Client Adapter(OCA)により、Microsoft Windows3.1、Windows95、Windows98、およびWindows NT上のアプリケーションで、ODBCドライバを使用してODBC準拠のデータソースにアクセスすることが可能になります。OCAでは、ODBCドライバがODBCのレベル1に準拠する必要があります。ODBCドライバにレベル2のODBC機能がある場合、OCAではその機能も使用してさらに高いパフォーマンスを実現します。

OCAを使用することにより一貫した方法で、アプリケーションで様々なデータソースにアクセスできます。これにより、アプリケーションの開発者は、複数のデータソースに対して修正を行わずに同じアプリケーションを実行することができます。逆に、そのアプリケーションの対象を特定のデータソースに固定し、そのシステム固有の特徴を利用することもできます。

OCAは、Oracle Installerによってインストールされ、すべての必要なファイルがORACLE_HOMEディレクトリにコピーされます。これらのファイルの1つが、oca.pllです。 oca.pllはPL/SQLのファンクション・ライブラリで、アプリケーションからこれを使用して次の操作ができます。

•	アプリケーションのメイン接続の他に、他のデータソースに対する補助接続をオープンします。

•	任意の接続に対し、任意のSQL文およびストアド・プロシージャ・コールを実行します。

•	Oracle以外のストアド・プロシージャから検索結果を取り出します。

•	DBMSおよびODBCドライバの名前とバージョンを取得します。

•	データソースに適合するように、実行時に「フォーム」および「データ・ブロック」プロパティを自動的に調整します。

これらの機能の詳細は、この項目の最上部の [image] ボタンをクリックしてください。

インストールされている他のファイルの詳細は、「リリース・ノート」を参照してください。


デフォルトでは、oca_info.pdfはORACLE_HOME\TOOLS\DOC60\USにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


UBTユーティリティについて

ODBC用のOracle Open Client Adapter(OCA)には、Universal Backend Tester(UBT)というSQL*Plusに似たユーティリティが含まれています。UBTにより、インタプリタ内またはコマンド・ファイルを使用してSQLコマンドを操作できます。

UBT実行プログラム(Windows NT、Windows95、およびWindows98ではUBT32.EXE、Windows3.1ではUBT.EXE)は、ORACLE_HOME\BINにインストールされます。

Oracle Client Adapaterの詳細は、oca_info.pdf(UBTユーティリティの情報を含む)を参照してください。


OCAリリース・ノートは、インストレーションCDのRELNOTES.TXT内に含まれています。


Personal Oracle Liteへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


これはアプリケーション開発用のオプションであり、実行時には必要としません。一部のデータベース(たとえば、Microsoft Access)では、データベース・カタログの情報の公開が不十分で、ビュー作成のサポートが不足しているために、データ・ディクショナリ・ビューを作成できません。この場合は、データベース・オブジェクトの名前を、リストから選択するのではなく、設計時に入力します。


次に示すPersonal Oracle Liteにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\POLITEにインストールされます。

polvudrp.sql	旧バージョンのビューを削除します。

polvubld.sql	必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:polite_ds @polvubld.sql


次に示すPersonal Oracle Liteにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\POLITEにインストールされます。

poldmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:polite_ds @poldmbld.sql


scott/tiger@ODBC:polite_ds


Microsoft SQL Serverへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


次に示すMicrosoft SQL Serverにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\SQLSRVにインストールされます。

sqsvudrp.sql	旧バージョンのビューを削除します。

sqsvubld.sql	SQL Serverバージョン4.2用で、必要なビューを作成します。

sqs60bld.sql	SQL Serverバージョン6.0用で、必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:sqlserver_ds @sqsvubld.sql


次に示すMicrosoft SQL Serverにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\SQLSRVにインストールされます。

sqsdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXEscott/tiger@ODBC:sqlserver_ds @sqsdmbld.sql


scott/tiger@ODBC:sqlserver_ds


Microsoft Accessへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


次に示すMicrosoft Accessにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\ACCESSにインストールされています。

accdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:access_ds @accdmbld.sql


scott/tiger@ODBC:access_ds


Oracle Rdbへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


次に示すOracle Rdbにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\RDBにインストールされます。

rdbvudrp.sql	旧バージョンのビューを削除します。

rdbvubld.sql	必要なビューを作成します。

rdbdual.sql	ビューを複式にします(SYSDATEをサポートするため)。


UBT32.EXE scott/tiger@ODBC:rdb_ds @rdbvubld.sql


次に示すOracle Rdbにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\RDBにインストールされます。

rdbdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:rdb_ds @rdbdmbld.sql


scott/tiger@ODBC:rdb_ds


Sybaseへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


Sybaseにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\SYBASEにインストールされます。

sybvudrp.sql	旧バージョンのビューを削除します。

sybvubld.sql	必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:sybase_ds @sybvubld.sql


Sybaseにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\SYBASEにインストールされます。

sybdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:sybase_ds @sybdmbld.sql


scott/tiger@ODBC:sybase_ds


Tandem NonStop SQLへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


Tandem NonStop SQLにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\NONSTOPにインストールされます。

nssvudrp.sql	旧バージョンのビューを削除します。

nssvubld.sql	必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:nonstop_ds @nssvubld.sql


Tandem NonStop SQLにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\NONSTOPにインストールされます。

nssdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:nonstop_ds @nssdmbld.sql


scott/tiger@ODBC:nonstop_ds


Informixへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


Informixにデータ・ディクショナリ・ビューとデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\INFORMIXにインストールされます。

infvudrp.sql	旧バージョンのビューを削除します。

infvubld.sql	必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:informix_ds @infvubld.sql


Informixにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\INFORMIXにインストールされます。

infdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:informix_ds @infdmbld.sql


scott/tiger@ODBC:informix_ds


トラブルシューティング

以前、Oracleに使用していたアプリケーションが、ODBCデータソースには使用できない場合、おそらく、ODBCかデータソースのいずれかの制限または限界を超えたことが原因と考えられます。

次に、OCAが発行するSQL文とODBCのドライバまたはデータベースが生成するメッセージを表示する手順を示します。

1	次のエントリが、Windows3.1のORACLE.INIファイル、またはWindows NT、Windows95およびWindows98のレジストリに設定されていることを確認します。

•	UB=ORACLE_HOME\OCA20

2	次のエントリを、Windows3.1のORACLE.INIファイル、またはWindows NT、Windows95およびWindows98のSOFTWARE\ORACLEの下にあるレジストリに追加します。

•	OCA_DEBUG_SQL=TRUE

•	OCA_DEBUG_ERROR=TRUE

3	ODBCデータソースに対してアプリケーションを実行し、デバッグ・ウィンドウにSQL文またはエラー・メッセージを表示します。「OK」をクリックして、デバッグ・ウィンドウをクローズし、処理を続けます。

4	エラーを解決できない場合は、サポート担当に問い合せてください。


OCAメッセージ

コード	メッセージの記述。

30000	一般的なOCAエラー。

30001	hostdefがNULLです。

30002	ファンクションがサポートされていません。

30003	接続文字列のユーザー名がNULLです。

30004	接続文字列のホスト名がNULLです。

30005	カーソルがすべて使用中です。

30006	解析ツリーの作成中にエラーが発生しました。

30007	SQL文がNULLです。

30008	メモリーの割当てに失敗しました。

30009	バインド変数の処理中にエラーが発生しました。

30010	OracleからODBCへのデータ型変換エラーです。

30011	ODBCからOracleへのデータ型変換エラーです。

30012	参照値をバインド中にエラーが発生しました。

30013	バインドするパラメータがありません。

30014	ホスト名が長すぎます。

30015	このデータソースではストアド・プロシージャはサポートされていません。

30016	このデータベースでは順序はサポートされていません。

30017	非Oracleデータベースへのログイン中にエラーが発生しました。

30018	ユーザー名またはパスワードが長すぎます。

30019	非Oracleのストアド・プロシージャの処理中にエラーが発生しました。

30020	ストアド・プロシージャの名前が抜けています。

30021	SQL文の準備または実行中にエラーが発生しました。

30022	列の取出し中にエラーが発生しました。

30023	結果セットのフェッチ中にエラーが発生しました。

30024	列記述子の取出し中にエラーが発生しました。

30025	結果セットの列数を取得中にエラーが発生しました。

30026	プロシージャ記述子の取出し中にエラーが発生しました。

30027	ODBC接続/文オプションの設定中にエラーが発生しました。

30028	コミットまたはロールバックでエラーが発生しました。

30029	列のバインド中にエラーが発生しました。

30030	パラメータのバインド中にエラーが発生しました。

30031	ドライバまたはデータベースについての情報の取出し中にエラーが発生しました。

30032	メモリーの解放中にエラーが発生しました。

30033	行ステータス・エラー。

30034	表が見つかりません。

30035	列が見つかりません。

30036	認可仕様が無効です。

30037	データソースを使用できません。

30038	列番号が無効です。

30039	バンドルされた演算子の組合せが不正です。

30040	カーソル・コンテキストが無効です。

30041	バインド変数がありません。

30042	データが見つかりません。

30043	フェッチされた列値がNULLです。

30044	フェッチされた列値が切り捨てられました。

30045	結果データを取出し中にエラーが発生しました。

30046	データソースの名前が指定されていません。

30047	トランザクション分離レベルがサポートされていません。

30048	配列のバインドはサポートされていません。

30049	ログオンされていません。

30050 	SQL文の解放中にエラーが発生しました。

30051	データのフェッチ中にエラーが発生しました。このデータソースをコミットした後に再度実行してください。

30052	実行時にパラメータ値が切捨てられました。

31000	一般的なODBCエラーが使用中のODBCドライバから戻されました。

エラーが発生して、アプリケーションでメッセージ・ファイルからのメッセージが読めない場合、次のエントリがWindows3.1のORACLE.INIファイル、またはWindows NT、Windows95およびWindows98のレジストリに設定されていることを確認してください。

•	UB=ORACLE_HOME\OCA20


PDFドキュメント

PDFドキュメントを表示するには、PDFビューアをインストールされたディレクトリから開始し、oca_info.pdfをオープンしてください。


用語集

英

    ActiveX
    Ada
    ASCII
    Bilder
    CGI
    CGM
    CHARデータ型（CHAR datatype）
    CMDFILE
    DATE
    Designer
    Designer(Oracle)
    DIANA
    EBCDIC
    Familyツール（Family tool）
    GUI
    HTML
    HTTP
    ICD
    IP（インターネット・プロトコル）アドレス（Internet Protocol）
    JAR
    Java
    NA値（NA value）
    NOCACHE
    NULL値（NULL value）
    ODBC
    OLE
    OLEコンテナ（OLE container）
    OLEサーバ（OLE Server）
    Oracle Designer
    ORACLE_HOME
    Oracleデータ型（Oracle datatype）
    Pcode
    PDF
    PL/SQL
    pldファイル（pld file）
    pllファイル（pll file）
    plsファイル（pls file）
    plxファイル（plx file）
    Project Wizard
    prtファイル（prt file）
    RC4
    RDBMS
    rdfファイル（rdf file）
    REF列（REF column）
    Reports Queue Manager（RWRQM60）
    Reports Server（RWMTS60）
    Reports Web Cartridge
    Reports Web CGI（RWCGI60）
    Reportsバックグラウンド・エンジン（Reports Background Engine）（RWRBE60）
    repファイル（rep file）
    rexファイル（rex file）
    RGB
    RTF
    SELECT文（SELECT statement）
    SQL
    SQLスクリプト（SQL script）
    sqlファイル（sql file）
    SQL文（SQL statement）
    SYLK
    TCP
    Top/Bottomツール（Top/Bottom tool）
    URL
    VBX
    VBXコントロール（VBX control）
    Web
    Web cartridge
    Webサーバー（Web server）
    Webブラウザ（Web browser）
    Webリンク（Web link）
    WKS
    WRB
    WWW
    XML
    zoom

数

あ

    アイコン（icon）
    アクション（action）
    アクティブ・ウィンドウ/ビュー（active window/view）
    値構成体（value construct）
    値軸（continuous axis）
    値軸（value axis）
    値のリスト（list of values）
    アプリケーション（application）
    アプレット（applet）
    アンカー（anchor）
    アンカー・ポイント（anchor point）
    暗号化（encyption）
    暗示項目（implied item）
    依存項目（decendant）
    依存性ツリー（dependency tree）
    依存性表示（dependency view）
    依存データ（dependent data）
    イメージ（image）
    インクローズ・オブジェクト（enclosing object）
    インターネット（internet）
    インタプリタ・スクリプト（interpreter script）
    イントラネット（intranet）
    インポート（import）
    ウィンドウ（window）
    内側枠ボックス（inner bounding box）
    エクスポート（export）
    エクスポート・ファイル（export file）
    エディタ（editor）
    オーバーフロー（overflow）
    オブジェクト（object）
    オブジェクト・グループ（object group）
    オブジェクト・タイプ（object type）
    オブジェクト・ナビゲータ（Object Navigator）
    オブジェクト・ハンドル（object handle）
    オブジェクト表（object table）
    オブジェクト列（object column）
    親（parent）

か

    カーソル（cursor）
    カートリッジ（cartridge）
    階層（hierarchy）
    外部PL/SQLライブラリ（external PL/SQL library）
    外部キー（foreign key）
    外部問合せ（external query）
    可視属性（visual attribute）
    カスケード・スタイル・シート（cascading style sheet）
    カスタム基準（custom measure）
    仮想ディレクトリ（virtual directory）
    仮想ファイル・システム（virtual file system）
    カット（cut）
    カテゴリ（category）
    カテゴリ軸（category axis）
    可変配列（varying array）type
    カラー・パレット（color palette）
    環境（environment）
    関係演算子（relational operator）
    キーワード（keyword）
    基準（measure）
    基本形（primitive）
    基本線の値（baseline value）
    キャッシュ（メモリー）（cache （memory））
    キャンバス（canvas）
    キャンバス・ビュー（canvas view）
    行（row）
    行オブジェクト（row object）
    境界線/塗り/テキスト表示（Edge/Fill/Text Display）
    境界線（border）
    切離しメニュー（tear-off menu）
    句（clause）
    クライアント（client）
    クライアント/サーバー・アーキテクチャ（client/server architecture）
    繰返し枠（repeating frame）
    クリップボード（Clipboard）
    グループ（group）
    グループ・ツリー（group tree）
    グループ・フィルタ（group filter）
    グローバル変数（global variable）
    グローバル・レジストリ（Global Registry）
    クロス積（cross product）
    クロス・タブ（crosstab）
    警告（alert）
    計算式列（formula column）
    継承（inherit）
    結合（join）
    限定モード（confie mode）
    原点（origin）
    子（child）
    格子表示（gridlines）
    更新（update）
    構成体（construct）
    構文（syntax）
    項目（item）
    項目軸（discrete axis）
    項目ノード（item node）
    コール・インタフェース（call interface）
    コール・スタック（call stack）
    子問合せ（child query）
    コピー（copy）
    コマンド行（command line）
    コミット（commit）
    コメント（comment）
    コレクション・タイプ（collection type）
    コンテキスト領域（context area）
    コンパイル（compile）
    コンポーネント（component）

さ

    作業環境（preference）
    索引（index）
    座標（x, y）（coordinates）
    座標系（coordinate system）
    座標平面（coordinate plane）
    サブプログラム（subprogram）
    サブプロジェクト（subproject）
    サブプロジェクト・ノード（subproject node）
    サマリー列（summary column）
    参照線（reference line）
    式（expression）
    式（formula）
    字句参照（lexical reference）
    軸チャート（aixs chart）
    システム変数（system variable）
    下に伸びる（downward-growing）
    実行（execute）
    実行（run）
    実行時（Runtime）
    実行ファイル（runfile）
    実行プログラム引数（executable argument）
    修飾ディメンション（qualifying dimension）
    十分に構成されたXML（well-formed XML）
    集約（aggregation）
    終了（quit）
    主キー（primary key）
    仕様（specification）
    上位項目（antecedent）
    使用可能（enabled）
    使用禁止（disabled）
    条件（condition）
    省略記号ボタン（Ellipsis button）
    書式マスク（format mask）
    数値演算子（numeric operators）
    スキーマ（schema）
    スクリプト（script）
    スコープ（scope）
    スタイル・シート（style sheet）
    スタック（stack）
    ストアド・サブプログラム（stored subprogram）
    ストアド・プログラム単位（stored program unit）
    すべてのツール（All tool）
    制御ポイント（control point）
    生成（Generate）
    生成（generate）
    静的な選択済み保存項目（static saved selection）
    制約（constraint）
    セクション（section）
    セッション（session）
    接続（connect）
    接続文字列（connect string）
    セル（cell）
    セレクタ（selector）
    セレクタ・ツール（Selector tool）
    選択項目（selection）
    選択項目のスクリプト（selection script）
    相関副問合せ（correlated subquery）
    挿入モード（insert mode）
    ソース（source）
    ソート・ツール（Sort tool）
    属性（attriute）
    属性値（attribute value）
    属性ツール（Attribute tool）
    属性マスク（attribute mask）
    属性列（attribute columns）
    ソケット（socket）
    祖先（ancestor）
    祖先グループ（ancestor group）
    外側枠ボックス（outer bounding box）

た

    ターゲット（target）
    ターゲット・ノード（target node）
    ダイアログ・ボックス（dialog box）
    タイトルバー（title bar）
    タイトル・ページ（title page）
    タイプ（type）
    チェックサム（checksum）
    チェックボックス（check box）
    置換モード（replace mode）
    チャート項目（chart item）
    チャート・テンプレート（chart template）
    チャート要素（chart element）
    ツール（tool）
    ツールバー（toolbar）
    ツール・パレット（tool palette）
    定義済みアクション（pre-defined action）
    定義済みタイプ（pre-defined type）
    ディテール問合せ（detail query）
    ディメンション（dimension）
    ディメンション階層（dimension hierarchy）
    ディメンション値（dimension value）
    データ型（datatype）
    データ構造ノード（data structure node）
    データソース（datasource）
    データ・ディクショナリ（data dictionary）
    データベース（database）
    データベース・トリガー（database trigger）
    データ・モデル（data model）
    データ・リンク（data link）
    テキスト項目（text item）
    デバッガ（debugger）
    デバッグ（debug）
    デバッグ・アクション（debug action）
    デバッグ・トリガー（debug trigger）
    デフォルト（default）
    問合せ（query）
    問合せフィルタ・ファンクション（query filter function）
    同位項目（sibling）
    動的な保存済み選択項目（dynamic saved selection）
    登録（register）
    独立ﾃﾞｰﾀ（independent data）
    トグル（toggle）
    ドラッグ（drag）
    トランザクション（transaction）
    トリガー（trigger）
    ドリル（drill）
    トレーラ（trailer）

な

    入力項目（input item）
    塗り領域（fill area）
    ネストされたマトリックス（nested matrix）
    ノード（node）

は

    配置（alignment）
    ハイパー・テキスト（hypertext）
    ハイパーリンク（hyperlink）
    配布（deliver）
    バインド参照（bind reference）
    バインド変数（bind variable）
    破損（damage）
    パターン（pattern）
    バックグラウンド処理（background process）
    バックグラウンド要素（background element）
    パッケージ（package）
    パッケージ仕様部（package specification）
    パッケージ・ファンクション（package function）
    パッケージ本体（package body）
    バッチ（Batch）
    バッチ・コンパイル（batch compile）
    バッファ（buffer）
    パネル（panel）
    パラメータ（parameter）
    パラメータ・リスト（parameter list）
    パレット（palette）
    範囲ツール（Range tool）
    ハンドル（handle）
    比較演算子（comparison operators）
    引数（argument）
    非キャッシュ列（non-caching column）
    日付軸（date axis）
    非表示（hidden）
    ビュー（view）
    表（table）
    表形式（tabular）
    表示（display）
    表示形式（plot type）
    表示項目（display item）
    表タイプ（table type）
    ビルトイン（built-ins）
    ビルトイン・データ型（built-in datatype）
    ビルトイン・マクロ（built-in macro）
    ファイアウォール（firewall）
    ファイル・ノード（file node）
    ファミリ（family）
    ファンクション（function）
    フィールド（field）
    フィールド・テンプレート（field template）
    フィルタ（filter）
    フォアグラウンド要素（foregrond element）
    フォーカス（focus）
    フォーマット・トリガー（format trigger）
    フォーム・レイアウト（form layout）
    フォーム・レター・レイアウト（form letter layout）
    複数行フィールド（multi-line field）
    複製（duplicate）
    物理ページ（physical page）
    付与（grant）
    フラット化オブジェクト（flattened object）
    プリンタ制御コード（printer control code）
    ブレーク・グループ（break group）
    ブレーク・チャート（break chart）
    ブレーク・トリガー（break trigger）
    ブレーク・ポイント（breakpoint）
    ブレーク列（break column）
    ブレーク・レポート（break report）
    プレースホルダー・ユーザー名（placeholder username）
    フレックス・モード（flex mode）
    プレビュー（preview）
    プレビューア（Previewer）
    プログラム単位（program unit）
    プロシージャ（procedure）
    プロジェクト（project）
    プロジェクト項目（project item）
    プロジェクト・ナビゲータ（Project Navigator）
    プロジェクト・ノード（project node）
    プロジェクト表示（project view）
    プロジェクト・ファイル（project file）
    プロジェクト・レジストリ（project registry）
    ブロック（block）
    プロトコル（protocol）
    プロパティ（property）
    プロパティ・クラス（property class）
    文（statement）
    分解オブジェクト（deconstructed object）
    分割バー（split bar）
    分類（classification）
    並行性（concurrency）
    ペイン（pane）
    ページ（page）
    ページ・ブレーク（page break）
    ペースト（paste）
    ヘッダー（header）
    ヘッダー・ノード（heading node）
    別名(alias)
    変数（variable）
    編成ノード（organization node）
    ボイラープレート（boilerplate）
    ポート（port）
    保存済み選択項目（saved selection）
    保存済み選択項目ツール（Saved Selection tool）
    ボタン（button）
    ボタン・プロシージャ（button procedure）
    ポップアップ・リスト（pop-up list）
    ボディ（body）

ま

    マージン（margin）
    マクロ（macro）
    マスター/ディテール・レイアウト（master/detail layout）
    マッチング・ツール（Match tool）
    マトリックス・セル（matrix cell）
    マトリックス・レイアウト（matrix layout）
    マトリックス・レポート（matrix report）
    無名ブロック（anoymous block）
    メール・ラベル・レイアウト（mailing label layout）
    メガバイト（MB）（megabyte）
    メソッド（method）
    メッセージ・ボックス（message box）
    モーダル・ウィンドウ（modal window）
    モードなしウィンドウ（modeless window）
    文字位置（justification）
    モジュール（module）

や

    有効なXML（valid XML）
    ユーザー・イグジット（user exit）
    ユーザー定義アクション（user-defined action）
    ユーザー定義型（user-defined type）
    ユーザー定義マクロ（user-defined macro）
    ユーザー・レジストリ（user registry）
    要素（element）
    要素タイプ（element type）
    読込み一貫性（read consistency）

ら

    ライブラリ（library）
    ラジオ・グループ（radio group）
    ラジオ・ボタン（radio button）
    ラベル（label）
    ランタイム・パラメータ･フォーム（Runtime Parameter Form）
    ランチャ（Launcher）
    リスト項目（list item）
    リスト・ツール（list tool）
    リスト・ボックス（list box）
    リフレッシュ（refresh）
    リモート・データベース（remote database）
    リンク（link）
    リンク・ファイル（link file）
    ルート（root）
    ルート・ノード（root node）
    ループ（loop）
    レイアウト（layout）
    レイアウト単位（layout unit）
    例外（exception）
    例外ツール（Exception tool）
    レコード（record）
    レコード・グループ（record group）
    レジストリ（registry）
    列（column）
    列オブジェクト（column object）
    レベル（level）
    レベル・ツール（level tool）
    レポート・レベルのオブジェクト（report-level objects）
    連結したライブラリ（attached library）
    ローカル・データベース（local database）
    ローカル変数（local variable）
    ローカル・レジストリ（local registry）
    論理演算子（logical operators）
    論理ページ（logical page）

わ

    ワイルド・カード（wildcard）
    枠（edge）
    枠（frame）
    枠ボックス（bounding box）


Project Builderにおいて、Project Builderまたはユーザーにより提供され、一定の形式のファイルに用いられるコマンド文字列。アクションは単一のファイル・タイプに制限されていない。たとえば、「ビルド」アクションがFormモジュールおよびCソース・ファイルの双方に定義されている場合、「すべてをビルド」を選択すると適切なツールによりすべての.fmbおよび.cファイルがコンパイルされる。｢定義済みアクション（pre-defined action）｣と｢ユーザー定義アクション（user-defined action）｣も参照。


埋込み型のコンピュータ・システム用に米国国防総省により開発された、高レベルのプログラミング言語。


ユーザー入力を受けることができるウィンドウまたはビュー。


（Oracle Express） 複数のディメンション値のデータを1つの値（全都市の合計販売数など）またはさらに小さな値セット（各地域の都市について算出された平均販売数など）に統合すること。データは詳細の最低レベルで収集されることが多く、分析用にさらに高いレベルでの合計に集約される。


最後のアクションのために発生した状況を通知するモーダル・ウィンドウ。警告には応答する必要がある。


フィールド内でデータが位置付けられる方法。データを定義されたフィールド幅の左、右、中央、左揃え、右揃えまたは中央揃えで配置できる。


表、ビューまたは列を参照するためにSQL文内で使用される2次的な名前。


（Oracle Express） ディメンション内のすべての値または特定階層についてのディメンション内のすべての値を選択できる「セレクタ」ダイアログ・ボックスのツール。


（Oracle Express） 階層内の特定の値を超えるレベルのディメンション値。祖先の値は、その子孫の値の集約合計である。次の例は、GEOGRAPHYディメンション内における、"France"、"Lyon"および"Paris"の祖先としてのディメンション値である"Europe"を示している。


別のグループを直接または間接に所有するグループ。


最初のオブジェクトの位置と2番目のオブジェクトとの関係を保ちながら、1つのオブジェクト上のスポットを別のオブジェクト上のスポットに固定するレイアウト・オブジェクト。


（Oracle Express） ファミリ・リレーションを基準にしてディメンション値を選択するとき、または階層内をナビゲートするときに使用する特定のディメンション値。


名前がなく、実行可能文を囲むBEGINおよびENDキーワードを明示的に指定する必要のないPL/SQLプログラム単位。無名ブロックには名前がないため、他のプログラム単位は参照できない。


別のオブジェクトのグループツリー内で、そのオブジェクトよりも上の位置で現れるオブジェクト。どのオブジェクトも、その依存項目の上位項目になる。


必要に応じWebページやアプリケーションに動的にインポートできる小さなプログラムを表すJava用語。


特定の結果を達成するために使用される、1つ以上のプログラム・モジュール。アプリケーションは、他のアプリケーションにネストできる。たとえば、業務システムを制御するアプリケーションには、データ入力用のさまざまなForm Builderアプリケーションやそのデータを視覚的に表示するさまざまなGraphics Builderアプリケーションを含めることができる。


1. プログラム単位が継続して作動するようにプログラム単位に渡される任意の式。
2. キーワードおよびキーワードの指定値を含む句。


情報交換用の米国標準コード。American National Standard Code for Information Interchangeの略称。


読込み専用のPL/SQLサブプログラムの集合であり、通常アプリケーションと共に提供され、必要なPL/SQLソースを提供する。連結ライブラリ内のプログラム単位は、コンパイル時または実行時に他のプログラム単位によって初めてコールされたときに、暗黙的にロードされる。それらのプログラム単位は、再度必要になったときにすばやく利用できるように、ロードされた状態になっている。このため、実行時のメモリの使用量を節約し、アプリケーションのパフォーマンスを改善することができる。「ライブラリ（library）」も参照。


1. 「プロパティ（prorety）」を参照。
2.  Oracle8オブジェクト・タイプ定義の一部またはコンポーネント。各属性には、名前とOracle8データ型がある。オブジェクト表がオブジェクト・タイプに基づいて作成される場合、表内の列は、オブジェクト・タイプ定義内の属性に対応する。リレーショナル表内の列オブジェクトがオブジェクト・タイプに基づいて作成される場合、その列オブジェクトにはサブ列と同等のものが含まれ、それぞれがオブジェクト・タイプ定義内の属性に対応する。表内の各Oracle8オブジェクト属性が、別の列であるかのように異なるデータ項目として扱われる。このことは、リレーショナル表内のオブジェクト表と列オブジェクトについてもあてはまる。
3. （Oracle Express） ディメンション値によって共有される記述子の特徴。属性は論理グループ分けを表し、これによってユーザーは、同類の特徴を基にデータを選択できる。たとえば、履き物を表すデータベースでは、履き物の色という属性を使用することにより、同じ色を共有するすべてのブーツ、スニーカーおよびスリッパを選択できる。


列オブジェクトを構成する列（Oracle8）。


Graphics Builderでは、属性記述子内の最初の要素。その後のファンクション・コールで設定または取り出される属性のツールキットに知らせる32ビットのマスク。属性マスク内に対応するビットが設定されている要素のみが設定または取り出される。


（Oracle Express） 属性および属性値を基準にしてディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、ソフト・ドリンクを表すデータベースでは、サイズが1リットルの全製品を選択する場合もある。その場合、「サイズ」が属性で、「1リットル」が属性値である。


（Oracle Express） 属性を構成する、データベース内の値。たとえば、アイスクリーム製品を表すデータベースでは、バニラ、チョコレートおよびストロベリーといった属性値は、製品ディメンションの味属性に属する場合がある。ブランド、形態およびサイズなど、製品ディメンションのさまざまなレベルにおけるディメンション値は、味について同じ値を共有する場合がある。


チャートの1種であり、軸と呼ばれるチャートの境界線のどこにデータが位置するかに基づきデータが表示される。軸チャートには軸が2つまたは3つあり、それぞれが項目軸、値軸または日付軸のいずれかになる。


パターンの白い部分。バックグラウンド要素に色を付けるには、「塗りカラー」パレットを使用する。


オペレーティング・システム環境で実行され、サービスやアクションを行う非対話形式のプロセス。一部のOracle製品では、データベースを同時に使用するユーザーのための作業の実行と調整、電子メッセージの処理と配布、印刷サービスの管理など、さまざまな作業にバックグラウンド処理を使用する。


チャートの値軸上の表示フィールドの始点として使用される値。


ウィンドウ・システムを使用せずにバッチ・モードでアプリケーションを実行する実行可能プログラム。


いくつかのPL/SQLプログラム単位をマシンが実行できる形式に一度に変換する。


PL/SQL構成体またはSQL SELECT文内のあらゆる位置に出現する単一のリテラル値（文字列、数値、日付など）の置換に使用されるパラメータへの参照。バインド参照の際には、パラメータ名の前にコロン（:）を付ける必要がある。


PL/SQLパッケージ以外で作成し使用できるグローバル変数。


1. キーワードDECLARE、BEGIN、EXCEPTIONおよびENDで定義される、PL/SQL内の基本的なプログラム単位。
2. Form Builderでは、データベース表またはビューに関連する論理コンテナ。


1. プログラム単位の仕様部と同じ情報が入っており、サブプログラムの実際のインプリメンテーション（そのアクション順序）も含む。ほとんどの場合、1つのサブプログラムには、本体を1つのみ定義する必要がある。
2. Report Builderでは、レポート・レイアウトの大部分（テキスト、図形、データおよび計算）を含む領域。レポートのボディは、レポートのヘッダー・ページとトレーラ・ページの間に表示される。


レポートが実行されるたびにレポート内に表示されるテキストまたは図形（あるいはその両方）。一部の製品では、「一定の」テキストまたは図形と呼ばれる。


レイアウト・オブジェクトの周辺のユーザー定義のアウトラインであり、通常その内容を強調表示するために使用する。境界線は、幅の半分がオブジェクトの枠の外側、もう半分が内側になるように描かれる。


「内側枠ボックス（inner bounding box）」および「外側枠ボックス（outer bounding box）」を参照。


1つの軸に沿って2種類のデータを表示する軸チャート。


ブレーク・グループに割り当てられた問合せ列。


レポート・データのブレークまたは分類に使用されるグループ。ブレーク・グループに割り当てられた問合せ列のデータは、すべて別のグループに属する列のデータの上に表示される。ブレーク・グループにフェッチされた各レコードは一度しか表示されないが、別のグループの複数の関連レコードは表示できる。


レポート・データの集合を分類する項目を含むレポート。


ブレーク・ポイントに達するたびに実行されるPL/SQLブロック。「ブレーク・ポイント（breakpoint）｣も参照。


PL/SQLサブプログラム内のあらゆる実行可能ソース行にセットできるデバッグ・アクション。ブレーク・ポイントはプログラム単位の実行を中断し、制御をPL/SQLインタプリタに渡す。ブレーク・ポイントを使用すると、サブプログラムをステップごとに実行し、ランタイム・エラーを探すことができる。「ブレーク・トリガー（break trigger）」も参照。


特定の形式のドキュメントを作成するために使用されるコンポーネントを指す。たとえば、フォームの作成にはForm Builderが、レポートの作成にはReport Builderが使用される。


Oracle Serverによって定義およびサポートされるデータ型。


PL/SQL言語に対する拡張機能の集合であり、ソフトウェアで使用されるように設計されている。ビルトインには、データ型、プロシージャ、ファンクション、例外および定数が含まれる。


Project Builderでは、マクロはProject Builderに付属している。「マクロ（macro）｣も参照。


コンピュータと周辺機器、またはコンピュータの部分間でデータを転送する間、データを一時的に格納する領域。バッファにより、転送の速度またはタイミングの違いによる情報の損失を防ぎ、一部の機能が高速化される。


1. アクション項目の選択、ダイアログボックスの表示、または現行の条件の確認に使用されるインタフェース要素。
2. 関連するPL/SQLプロシージャをもつ、アプリケーション内のオブジェクト。通常、ユーザ・マウス・イベントに基づいて実行される。


アプリケーション・オブジェクトに関連するPL/SQLプロシージャであり、実行時にその項目で特定のマウス・イベント（ボタンのクリックなど）が発生すると実行される。これは、ブレーク・グループを含む、フェッチされたデータの階層を確立することによって行われる。


現在、ユーザーからアクセスまたは変更されているデータベース上のデータ、またはOracle Serverがユーザーのサポートに必要とするデータのための、一時的な格納領域。これらの用語は同義で使用されることが多い。


Forms DeveloperおよびReports Developerコンポーネントの実行可能プログラムを他のOracle製品や3GLプログラムから起動させるためのインタフェース。


最初のエントリ・ポイントから現在実行しているサブプログラムに対する、一連のサブプログラム・コール。各サブプログラム・コールは、下に伸びるコール・スタック上の枠によって表され、新規に入力されたサブプログラムはスタックの一番下に追加される。


   「エディタ（editor）」を参照。


Form Builderでは、ユーザーがランタイム・アプリケーションで対話を行うインタフェース・オブジェクトを配置するバックグラウンド・オブジェクト。キャンバス・ビューは、通常、ウィンドウに対応付けられる。


オープンAPIを通じてクライアント、アプリケーション・サーバーまたはデータベースにプラグインできる、管理可能なオブジェクト。


「スタイル・シート（style sheet）」を参照。


非階層型の図表やその断片などの情報の種別を、感性レベルではなく、可能とするラベル・コンポーネント。分類された種々の情報へのアクセスを個別に制限する手段として使用される。


「項目軸（discrete axis）」を参照。


スプレッドシート内のデータのインスタンス（Microsoft Excelなど）。


Common Gateway Interfaceの略称。アプリケーションをWebサーバー上で実行するための、業界標準の技法。Webサーバーで検索される標準のHTMLドキュメントは静的であるが（まったく同じテキストが毎回検索される）、CGIにより、プログラムがWebサーバー上で稼働して別のコンピュータと通信を行い、ユーザーが入力する情報に応えて「動的な」HTMLドキュメントを生成することが可能になる。


コンピュータ・グラフィックス・メタファイル。国際的に認められたファイル形式で、オブジェクト指向の図形の保存や、システムまたはプログラム間の転送に使用される。


ANSI/ISO互換のために提供されているOracleデータ型の1種。CHAR列は固定長の列で、A、3、&、ブランクなどの印字可能文字を含むことができ、1～255個の半角文字やNULLを入力できる。


フィールドに対する単一の値を示す、横棒、線、記号、その他の図形オブジェクト。


Graphics Builderチャートをフォームまたはレポートに埋め込むのに使用されるあらゆるサイズの境界のある四角形。


チャートの書式を定義する属性とプロパティの集合。


小さな四角形として表示されるインタフェース要素であり、ユーザーはこれをオンまたはオフに切り替えることができる。


エラーチェックのアルゴリズム。


1. グループの1メンバーであり、グループ・ツリー内でそのグループ・オブジェクトのすぐ下に位置するオブジェクト。グループ・オブジェクトを構成するオブジェクトは、そのグループの子である。どのオブジェクトも、その親オブジェクトの子になる。
2. （Oracle Express） 階層内にある特定値のすぐ下のレベルのディメンション値。子の値は、親の集約合計を生成する計算に組み込まれる。ディメンションに複数の階層が含まれる場合、ディメンション値は複数の親の子である場合がある。次の例は、GEOGRAPHYディメンション内で、"France"の子としてのディメンション値"Lyon"と"Paris"を示している。


「ディテール問合せ（detail query）」を参照。


ラベルの付いた、情報の感度を示す階層レベル。分類は、情報へのアクセスを制限する手段として使用される。


文全体を構成しない、SQL文の一部。たとえば、「WHERE句」。


別のアプリケーションまたはコンピュータ（「サーバー」）のサービス、データ、処理などを要求するユーザー、ソフトウェア・アプリケーションまたはコンピュータ。2タスク環境では、クライアントはユーザー・プロセスである。ネットワーク環境では、クライアントはローカル・ユーザー・プロセスであり、サーバーはローカルまたはリモートの場合がある。


2つのCPU間の処理の分離。1つはトランザクション内でサービスを提供するサーバーとして、もう1つはトランザクション内でサービスを要求して受けるクライアントとして稼働する。共有データ管理の仕事は、すべてデータベース管理システムを実行しているコンピュータによって処理されるので、データベース・アプリケーションを実行しているワークステーションは、データの解釈と表示専用になる。


メモリー・バッファ。オブジェクトは、別のオブジェクトをカットまたはコピーするか、またはアプリケーションを終了するまで、クリップボードに残る。


すべてが同じデータ型で、数に制限のない要素によって構成されるデータ単位を記述する、ユーザー定義データ型。可変配列型および表タイプは、コレクション・タイプである（Oracle8）。


Forms Developerの実行可能プログラムのコマンド・ライン引数のセットが入ったファイルを指定できる引数。


ウィンドウ・システム、描画面、またはウィンドウおよびそのビューに利用できるすべての色を含む。


1. データの特定のドメインを表す、データベース表内の垂直方向の領域。列には列名（ENAMEなど）があり、特定のデータ型（CHARなど）を持っている。たとえば、従業員情報の表で従業員名のすべてが1つの列を構成するなど。レコード・グループ列は、データベースの列を意味する。
2. Report Builderでは、問合せのSELECTリスト内の列のそれぞれの式に対し自動的に作成されるか、集計や式を実行したりプレースホルダーとして稼働するために手動で作成されるデータ・モデル・オブジェクト。


Oracle8のリレーショナル表またはオブジェクト表で、定義がオブジェクト・タイプに基づいている列。列は複合列で、その構成部分は、オブジェクト・タイプの属性に対応する。


オペレーティング・システムのコマンド・ライン。ほとんどのOracle製品は、いくつかの実行プログラム引数を使用して、コマンド・ラインから起動できる。


プログラム内に説明文を含めるための言語要素。これを実行しても影響は出ない。


データベース内のデータの変更を永続的にすること。変更が確定されるまでは、変更情報を格納したり、データを前の状態に復元できるように、新旧のデータが存在する。


（Oracle Express）

>	より大きい

<	より小さい

=	等しい

<=	以下

>=	以上

<>	等しくない

数値の場合、オペランドは最小共通型に拡大される（IntegerはLongに優先し、LongはSingleに優先し、SingleはDoubleに優先する）。文字列の場合、比較は大/小文字が区別され、Windowsのコントロール・パネルで指定する言語によって使用される照合順番に基づいて行われる。結果はFALSEが0でTRUEが-1になる。


ソース・プログラムを、バイナリの実行可能な形式に変換すること。PL/SQLプログラム単位は、実行する前にコンパイルする必要がある。


大規模アプリケーションの一部である特定のターゲット・オブジェクト。｢ターゲット（target）｣も参照。


異なるデータベース・アプリケーションや同じアプリケーションを実行する複数のユーザーによる、同じデータの同時アクセス。データベース・ソフトウェアで並行性を保つには、すべてのユーザーが首尾一貫したデータを参照できることと、すべての変更が適切な順序で行われることを保証するロジックを追加する必要がある。


X> 100のように、値が真か偽である式。たとえば、式で真を評価させた行のみを表示するための問合せを行う場合、問合せに条件を設定します。


子オブジェクトが親オブジェクトの内外で移動またはサイズ変更されることを防ぐレイアウト・エディタ・モード。


データベースへログインすること。問合せを作成または変更したり、データベースに格納されているアプリケーションにアクセスする場合は、接続する必要がある。


SQL*Netがネットワーク上の特定のOracleインスタンスへの接続に使用する、プロトコルを含むパラメータの集合。


オブジェクト・レベルやアプリケーション・レベルではなくデータベース・レベルで実施される、一定のデータに関する規則または制限（列でのNOT NULL制限など）。


PL/SQLコードの構成体。構成体には2つのタイプがある。値無し構成体は値を戻さず、値付き構成体は値を戻す。


Oracle Serverが現行のSQL文を格納する作業領域。文が問合せの場合には、結果の列ヘッダーと結果が入る１行。カーソルとも呼ばれる。


1つの値で始まり、別の値に達するまで継続する値を表示する軸。したがって、これらの値は、数学的に関連付けられている依存データは、通常、値軸とも呼ばれるこの軸に沿って表示される。


オブジェクトの理想的な形を構成する、垂直の四角形の4隅の点。レイアウト上のオブジェクトを選択すると、その制御ポイントが表示される。選択するオブジェクトによっては、制御ポイントをドラッグして、オブジェクトを変更できる場合がある。


描画が行われる2次元の格子。


レイアウト・エディタ・ビューでのオブジェクトの配置とサイズ設定に使用される、x，y単位のタイプ。利用できる座標システムは、1) プラットフォーム固有の文字セル・サイズを使用する文字、2) 単位がピクセル、センチメートル、インチまたはポイントである実際単位。


オブジェクトがレイアウト内で表示されるための位置を示す点。x座標とy座標により、オブジェクトの水平方向（x）と垂直方向（y）の位置が決まる。


必要に応じエディタ内の別の位置にペーストできるように、選択されたオブジェクトの複製をクリップボード上に保管すること。


親問合せと同じ表に基づく副問合せ（たとえば、その親問合せに含まれる表の中にある列の参照など）。


2つ以上の他のグループを所有し、数学的なクロス積を実行する（それらの間の値を相関させる）グループ。


｢マトリックス･セル｣を参照。


1. マウスの位置を示す小さなアイコン。カーソルの形は、選択するツールによって異なる。
2. 問合せにより取り出されるデータに対する内部ポインタ。カーソルは、一度に1行のデータしか指さない。ただし、ビルトイン・サブプログラムを使用すると、カーソルをデータ・セットの任意の行に移動できる。


（Oracle Express） ユーザーが作成する式で、これによってデータ解析を細かくチューニングできる。データベース内のベース基準を使用して、カスタム基準を作成できる。たとえば、データベース内にVolume Shareという既存の基準がある場合、この基準を使用して、Volume Share Year Agoという名前のカスタム基準を作成できる。このカスタム基準では、製品の前年度からの全体シェアを見ることができる。


1つ以上のオブジェクトを削除し、必要に応じエディタ内の別の位置にペーストできるようにそれらをクリップボードに保管すること。


ビューは、その全体または一部が他のビューにより遮られると破損する。


データベースの管理者により所有される一組の表およびビュー。Oracle Serverやその他のリレーショナル・データベースの中核となる情報ソース。


グループと問合せ間でマスター/ディテール（親子）関係を定義するのに使用されるデータ・モデル・オブジェクト。


データベースからどの値をフェッチすべきか、どの値を計算すべきか、データをレポート内でどのように順序付けるべきかを定義するリレーショナル・モデル。データ・モデルを定義するReport Builderオブジェクトは、問合せ、グループ、列、パラメータおよびリンクである。


ビューは、その全体または一部が他のビューにより遮られると破損する。


Project Builderにおいて、オープン・オブジェクトの構造を制御するプロジェクト項目を示す、プロジェクト・ナビゲータ内のノード。たとえば、「グローバル・レジストリ」ノードはグローバル・レジストリを示し、ローカル・レジストリのリストとグローバル・タイプ定義のリストが含まれている。


ユニットとして扱われる、一組のディクショナリ表とユーザー表。


トリガーを実行するINSERT、UPDATEまたはDELETE文がデータベースのリレーショナル表に対して発行されたときに、暗黙的に実行される保存済みのPL/SQLブロック。｢デバッグ・トリガー（debug trigger）｣も参照。


データの標準の書式。共通のOracleデータ型には、CHAR、VARCHAR2、DATE、NUMBER、LONG、RAWおよびLONG RAWなどがある。


Oracle Serverのデータ型の1つ。日付列には、紀元前9999年1月1日から西暦9999年12月31日までの日付と時刻が入る。


1つの日付から始まり、別の日付に達するまで続く日付の値を表示する軸。


プログラム内のランタイム・エラーを検出して診断し、削除すること。


PL/SQLサブプログラム内に配置されるユーザー指定のイベントであり、通常ランタイム・エラーのトラブルシュートを目的とする。


PL/SQLサブプログラムのどの実行可能ソース行にも配置できる、条件付きのデバッグ・アクション。指定条件が満たされると、サブプログラムの実行が再開される前に、指定したアクションが実行される。｢データベース・トリガー（database trigger）｣も参照。


テストとデバッグに使用される、ソフトウェアでのProcedure Builderの機能。


Oracle8では、オブジェクト・タイプとオブジェクトは複合要素であり、構成要素と属性によって構成される。Forms DeveloperおよびReports Developerでは、個々の構成要素または属性を、独立した、個別に選択できるデータ項目として扱う。このような扱い方によって、分解オブジェクトが生成される（フラット化オブジェクトとも呼ばれることもある）。オブジェクトはDeveloper環境内において、同類のエンティティではない。


値が他のデータに依存するデータ。たとえば、ある従業員の就業年数は値10であるが、それはその従業員の名前の値と依存します。値データとも呼ばれる。


ユーザーが必要なコマンド・パラメータや属性を指定しない場合にシステムにより提供される値。


配布と実行のために完成されたアプリケーションを用意し提供すること。


Project Builderにおいて、Project Builderがプロジェクト内で参照されるファイルをどのようにコンパイルするかを決定するために使用する機構。ツリーの左上の項目は、右下の項目に依存している。たとえば、ヘッダー・ファイルが古いか、またはそれを使用して構築する実行可能ファイルより新しいと、Project Builderでは、Buildコマンドを受けて、実行可能ファイルが再構築される。依存性はサブプロジェクトにも当てはまる。たとえば、関数ライブラリを含むサブプロジェクトが再構築されていると、Project Builderは更新されたライブラリ関数を使用するため依存プロジェクトを再構築する必要があることを「理解する」。｢依存性表示（dependency view）｣も参照。


Project Builderでは、プロジェクト・ナビゲータ内のファイルをそれらが互いに依存する順に表示（プロジェクト・ノードを階層の最上位に、その後にターゲット・ノードを、続いてそれらのターゲットの構築可能コンポーネントを配置）する。たとえば、実行可能フォームは.fmbファイルに依存してこれに先行し、.fmbファイルはUSEREXITプロシージャが使用するライブラリに依存してこれに先行するなど。｢プロジェクト表示（project view）｣、｢ターゲット（target）｣も参照。


1. 別のオブジェクトのグループ・ツリー内で、そのオブジェクトより下位に現れるオブジェクト。どのオブジェクトも、その上位項目の依存項目になる。
2.（Oracle Express）階層内の特定の値より小さいレベルのディメンション値。子孫の値は、その祖先の集約合計を生成する計算に組み込まれる。次の例は、GEOGRAPHYディメンション内における、"Europe"の子孫としてのディメンション値である"France"、"Lyon"および"Paris"を示している。


Forms DeveloperおよびReports Developerアプリケーションのさまざまなコンポーネントを設計するためのインタフェース。


「Oracle Designer」を参照。


アプリケーション・モデリング、設計および生成のツールセット。Oracle Designerを使用すると、Oracleリポジトリに記録されているモジュール定義からフォームとメニューを生成できる。


マスター/ディテール・レポートを定義する際、ディテール問合せはマスター（親）問合せにより取り出された各レコードに対するすべての関連レコードを取り出す。


操作を完了するために必要な情報の入力を求める、部分的な画面またはウィンドウ。


コンパイラにより生成される、プログラム単位の中間的な表現。DIANAには、コンパイルされるプログラム単位の構文上と意味上の情報がすべて含まれている。参照をプログラム単位にコンパイルするため、コンパイラは参照先のプログラム単位のDIANAへのアクセスを必要とする。たとえば、プログラム単位Aがプログラム単位Bをコールする場合、BのDIANAが使用可能でなければ、Aをコンパイルできない。


（Oracle Express） データのカテゴリを提供する値のリストである、データベース・オブジェクトのタイプ。ディメンションは、変数の値を識別する索引として機能する。たとえば、月ごとに個別の販売金額が記録された販売データがある場合、そのデータにはMONTHディメンションがある。つまり、データが月別に分類される。ディメンションはリレーショナル・データベースにおけるキーに似ている。

マルチディメンションの変数内にある任意のデータ項目は、変数の各ディメンションから1つのメンバーを指定することにより、一意におよび完全に選択できる。たとえば、販売変数がMONTH、PRODUCTおよびMARKETによってディメンション化されている場合、MONTHディメンションで"January"、PRODUCTディメンションで"Stereos"、MARKETディメンションで"Eastern Resion"を指定すると、変数内の1つのセルが一意に指定される。このように、ディメンションによって、データの取出し、更新および計算について、データを編成および選択するための、正確で、直感的な方法が提供される。

ディメンションは、1つのテキストまたは整数値などの単純な値から、他のディメンションの値を組み合わせた値など、連結した値の場合もある。複合は、ディメンションではないが、散在する値を処理する目的でExpressによってディメンションのように扱われる、連結に似た内部オブジェクトである。


（Oracle Express） ディメンションを構成するリスト内の1つの要素。たとえば、コンピュータ会社のPRODUCTディメンションでは、"LAPPC"および"DESKPC"と呼ばれるディメンション値を持つ場合がある。GEOGRAPHYディメンション内の値には、"Boston"および"Paris"などが含まれる場合がある。また、TIMEディメンション内の値には、"MAY96"および"JAN97"などが含まれる場合がある。


メニュー項目、ボタンなどを表す、インタフェース要素の状態。現行のコンテキストでは使用不可。つまり、キーボードやマウス入力には応答しない。


固有の値を固定した間隔で表示する軸。これらの値は、数学的に関連付けられていない。通常、独立データは、項目軸とも呼ばれるこの軸に沿って表示される。


チャート、イメージ、テキスト・オブジェクトおよび形のあらゆる組合せを含むGraphics Builderドキュメント。


Form Builderでは、PL/SQLでプログラムに基づいてフェッチまたは割り当てる必要のある情報を格納または表示する項目。


これはコール・スタックに属するため、この中では新規に入るサブプログラムはスタックの最下部に追加される。最初のプログラム・エントリ・ポイントに対応する最も古い枠は、スタックの一番上に、最も深くネストされたサブプログラム・コールと関連付けられた最新の枠は、スタックの一番下にある。


マウス・ボタンを押したまま、マウス・ポインタをウィンドウ内の特定の位置にスライドさせること。


（Oracle Express） 階層を持つディメンション内の集約のレベルを上下にナビゲートすること。ディメンション値を選択したり、データを表示したりするとき、ディメンション階層内でドリル・ダウンまたはドリル・アップすることにより、階層を拡張または縮小できる。ドリル・ダウンによってビューが拡張され、ディメンション階層内にある親の値に関連付けられている子の値も表示される。ドリル・アップによって、ディメンション階層内にある親の値に関連付けられている子の値のリストが収縮される。

階層をドリル・ダウン（拡張）するにはプラス・アイコン( [image])をクリックし、ドリル・アップ（縮小）するにはマイナス・アイコン( [image])をクリックする。

セレクタ内では、ドリル・アイコン( [image])をクリックして「ドリル」ダイアログ・ボックスを表示し、ディメンション全体の詳細レベル選択できる。


クリップボードの内容を変更することなくレイアウト上のオブジェクトを直接コピーできるオプション。


（Oracle Express） 評価されるたびに異なるディメンション値を持つことのできる保存済み選択項目。選択されたディメンション値は、使用ごとに異なる場合がある。対照的に、静的な保存済み選択項目は、ディメンション値の変化しないリストである。動的な保存済み選択項目のスクリプトには"Select the last three Months"などのように文が記述されるが、静的な保存済み選択項目のスクリプトには、"Select February 1996, March 1996, and April 1996"といったように文が記述される。


拡張2進化10進符号（Extended Binary-Coded Decimal Interchange Code）の略称。


オブジェクトの境界。


境界線、塗りおよびテキスト・パターンと色の現行の設定を表示する、レイアウト・エディタのツール・パレット上の表示ボックス。


プログラム単位の作成やアプリケーションの設計など、一連の特定のタスクを実行する作業領域。


情報を記録する必要があるかもしれない重要な事柄。要素は、属性および他の要素との関係で記述される。


ディクショナリ内に保持される要素はすべて、特定のタイプに分類される。要素タイプには、エンティティ、属性、プログラム・モジュール、表、ダイアグラム、テキスト、ソフトボックスなどがある。これらのオカレンスまたはインスタンスは、要素と呼ばれる。


（Oracle Express） 実行しようとしているタスクに関連のあるダイアログ・ボックスを表示する。通常はそこで1つ以上の必要な値を選択する。


メニュー項目、ボタンなどが現行のコンテキストで使用できる（つまり、キーボードやカーソルおよびマウスの入力に応答する）ことを表すインタフェース要素の状態。


別のオブジェクトを含むオブジェクト。オブジェクトは、次の条件をすべて満たす場合に限り、別のオブジェクトに囲まれると見なされる。両方のオブジェクトが同じ領域に属している（ボディまたはマージン、ヘッダー、トレーラ）。2つのオブジェクトの外側のものが、枠または繰返し枠である。2つのオブジェクトの外側のものが、もう一方の後ろにある。2つのオブジェクトの内側のものが、完全にもう一方の境界線内にある。両方のオブジェクトが同じ領域に属している（ボディまたはマージン、ヘッダー、トレーラ）。2つのオブジェクトの外側のものが、枠または繰返し枠である。2つのオブジェクトの外側のものが、もう一方の後ろにある。2つのオブジェクトの内側のものが、完全にもう一方の境界線内にある。


意図された受取人のみがデータを暗号解除し、読めるようにデータを暗号化すること。


一般的に使用されるツールおよびそれらの構成情報を含む、ユーザーのコンピュータ･ベースの作業場所。Project Builderにおいて、Forms Developerアプリケーションの開発関連のさまざまな作業を完成するのに使用される、ツールのサブセットを指す。


PL/SQLサブプログラムから生成される警告またはエラーの状況。


（Oracle Express） 指定期間を満たすデータに関連付けられたディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、ボストン市場で1995年の12月23日で終わる週に、ドル売上高が10,000ドルを超えるすべての製品を選択するといった操作もできる。


'OPENFILE=my_disp'や'PRINT=YES'など、製品の実行可能プログラムに渡すことができる引数。これらの引数は、通常実行可能プログラムがコマンド・ラインから起動される際に指定される。


「実行（run）」を参照。


オブジェクト、モジュール、選択されたテキストやイメージのコピーをファイルやデータベースに格納すること。Project Builderにおいて、プロジェクト、タイプ、アクションまたはマクロ（あるいはそれらすべて）の定義が含まれるファイルを、異種プラットフォームで作業する他のクライアントに配布できる移植性のある形式で書くプロセス。「エクスポート・ファイル（export file）」、「インポート（import）」も参照。


Project Builderにおいて、プロジェクトのエクスポートにより作成された共有可能な移植性のあるファイル。


1. 変数、定数、リテラルおよびそれらの値による操作を結合したPL/SQL構成体。
2.（Oracle Express） Express言語プログラム内で指定される1つ以上のデータ値。たとえば、式をプログラムまたは関数の引数として指定できる。式は次のいずれかである。

•	単一のリテラル値（10など）

•	1つ以上の値を含む変数または式

•	1つ以上の値を返す関数

•	変数、式または関数などの値を、算術演算子またはブール演算子と組み合せる計算


「ライブラリ（library）」を参照。


他のOracle製品により参照可能なANSI規格のSQL SELECT文。


（Oracle Express） ディメンション階層のレベルに対応する、関連のあるディメンション値のグループ。ファミリ内のディメンション値は、祖先、親、子および子孫としてお互いに関連付けることができる。次の例では、GEOGRAPHYディメンション内のディメンション値"France"についてのファミリ・リレーションを示す。


（Oracle Express） 特定階層のディメンション値のファミリを選択できる、「セレクタ」ダイアログ・ボックスのツール。ファミリには、1つの親とその子孫にあたるディメンション値すべてが含まれる。たとえば、GeographyディメンションにあるChicago市場レベル以下のファミリ・メンバーをすべて選択できる。


1. その中でデータの入力、編集および削除が可能なインタフェース要素。2. Graphics BuilderおよびReport Builderでは、特定の問合せ列のデータがどのように表示されるかを定義するレイアウト・オブジェクト。


Graphics Builderでは、独立データ（値）が横棒や線のようなチャート・フィールドとしてどのように表示されるかを決定する、属性およびプロパティの集合。


Project Builderにおいて、ファイル・システム内に格納されたファイルを示す、プロジェクト・ナビゲータ内のノード。たとえば、グローバルおよびローカル・レジストリ・ノードは、それぞれグローバルおよびローカル・レジストリ・ファイルに対応する。


塗り（色またはパターン）が適用される、オブジェクト内の領域。


グループによりデータが表示されることを制限する、PL/SQL関数または無名関数。


ローカル・エリア・ネットワーク上のコンピュータに対する外部からのアクセスと、ローカル・エリア・ネットワーク内から外部のコンピュータへのアクセスを規定するコンピュータ。


「分解オブジェクト（deconstructed object）」を参照。


子オブジェクトが移動またはサイズ変更される際に親オブジェクトのサイズ変更または縮小を自動的に行い、オブジェクトの位置変更やサイズ変更により影響される可能性のある他のレイアウト・オブジェクトの位置を調整するレイアウト・エディタ・モード。


ユーザーまたはクライアントからの入力に応答できるエンティティ状態。エンティティは、キーボード・フォーカスを持っていれば、ユーザーがキーを押したときにイベントを受け取れる。描画ビューは、描画フォーカスを持っていれば、描画に影響を与えるクライアント・ルーチンに応答できる。


パターンの黒い部分。フォアグラウンド要素に色を付けるには、「線カラー」パレットを使用する。


別の表の主キーを参照している、1つの表内の値または列。


Report Builderにおいて、ラベルがフィールドの左に、各レコードが別々の論理ページに表示される、デフォルトのレイアウト・スタイル。


Report Builderにおいて、ボイラープレートとフィールドを混在させ「ワード」ブレークで行を折り返すデフォルトのレイアウト・スタイル。


（フィールド・プロパティ） フィールドの値の表示状態を定義する設定。たとえば、書式マスクは、金額や日付の表示を指定するのに使用される。


オブジェクトのフォーマット属性の動的な変更を可能にするPL/SQL関数。


（Oracle Express） 値を生成するストアド計算、ストアド式またはストアド・プロシージャを表すデータベース・オブジェクトのタイプ。データ内の複雑なまたは頻繁に使用されるリレーションを、データ自体を再保存せずに定義および保存する方法は、式によって提供される。式を使用するたびに、値の生成に必要な計算またはプロシージャはExpressによって実行される。


PL/SQLのファンクションまたは式、ユーザー・イグジット、SQL文またはこれらのあらゆる組合せからそのデータを獲得するユーザー作成の列。


1.Graphics Builderにおいて、チャートの基本構造を定義するがデータの表示方法は決定しない、チャート・テンプレートの一部。
2.Report Builderにおいて、他のレイアウト・オブジェクトを囲み複数のオブジェクトのフォーマット、周期および位置を同時に制御するのに使用されるレイアウト・オブジェクト。


アクションの指定されたシーケンスを実行して値を返すPL/SQLサブプログラム。クライアントおよびデータベース・サーバーに存在し、実行することができる。


アプリケーションを、ランタイム実行可能プログラムおよびバッチ実行可能プログラムで実行できるバイナリ形式でファイルまたはデータベースに保存すること。


実行可能なForm Builder。アプリケーションをバイナリ形式でファイルやデータベースに保存するときに使用される。


Forms DeveloperおよびReports Developerインストールの全体に共通した情報を格納するProject Builderレジストリ。この情報は、タイプ定義と、それに関連付けられたアクションおよび、事前定義済みまたはユーザー定義のプロパティに限られる。グローバル・レジストリの使用はオプションである。グローバル・レジストリのファンクションは、個々のユーザー・レジストリにより実行することができる。「レジストリ（registry）」、「ユーザー・レジストリ（user registry）」も参照。


アプリケーション内に存在する論理コンテナ。アプリケーションがグローバル変数を使用する場合、その変数は、アプリケーションを終了するまで、または別のオブジェクトがその変数を明示的に削除するまで、保持される。


ユーザーに、モジュールに対するアクセス権限を与える。アクセス権限を他のユーザーに付与できるのは、モジュールの作成者のみである。


Graphics Builderでは、レイアウト・エディタ内の行と列を分離する線。


1. いくつかの他のオブジェクトから構成されているオブジェクト。
2. Report Builderにおいて、問合せにより選択されているすべての列を含むため自動的に作成されるか、レポート内に現れるデータの階層を変更するためにユーザーにより作成されるデータ・モデル・オブジェクト。主に、レポート内でのブレークの作成と計算のリセットに使用される。
3.Project Builderにおいて、ランチャ外のサブメニューを介して利用できる関連項目の集合。グループによりユーザーは、他の項目またはグループ（あるいはその両方）を表示するためにポップアップする任意の「グループ」をエントリとして、ランチャをWindows95の「スタート」メニューに似せてセットアップできる。たとえば、ユーザーはプロジェクト計画、作業リスト、コンポーネント仕様などを含む「Project Docs」というグループを定義し、.TXTファイルや.DOCファイルなどを含めることができる。


グループによりフェッチされるデータを制限するPL/SQL関数。


「ファミリ・ツリー」に類似した階層モデルで、グループ・オブジェクトとそれらを構成するオブジェクトの関係を表す。


グラフィカル・ユーザー・インタフェース。プログラムの入出力を表す以外に、ピクチャを使用することを意味する。GUIのあるプログラムは、ウィンドウ・システム（X Windows、Microsoft Windows、Apple Macintoshなど）上で稼働する。GUIプログラムは、アイコンやボタンなどを画面上のウィンドウに表示する。ユーザーは、GUIプログラムを主に画面上のポインタ（通常マウスで制御される）を移動して制御する。ビットマップ・インタフェースとも呼ばれる。


アプリケーション・オブジェクトに対する内部ポインタ。PL/SQLプログラム単位内のオブジェクトを参照するには、適切なサブプログラムに、引数としてそのハンドルを渡す必要がある。


テキスト、図形、データ、計算など、レポートの紹介内容を入れることができるオプションのレポート領域。レポートには、ヘッダーが最初に表示され、ボディとトレーラがそれに続く。


レポート内に含めたりレポートに関連付けることができるオブジェクトのタイプを示す、オブジェクト・ナビゲータ内のノード。ヘッダー・ノードを選択しても、レポート内のオブジェクトは選択されない。


（フィールド・プロパティ）  Report Builderが、示されたフィールドをレイアウト内のその位置で禁止するかどうかを指定するプロパティ。「非表示」が指定されると、フィールドの値は（&fieldnameにより）テキスト・オブジェクト内で参照される位置のみ表示される。


（Oracle Express） データを編成および構造化するための方法。ディメンション内の値が複数のレベルに配置され、各レベルがその下位レベルからのデータの集約合計を表している場合、階層が存在する。一部のディメンションは、それらに基づく複数の階層を持つ。

次の例は、GEOGRAPHYディメンションに基づく階層を示す。ここでディメンション値は、5つのレベルで配置されている。CustomersレベルのデータはCitiesレベルに集約され、Citiesレベルのデータは、Countries/Areas、Continents/RegionsおよびGlobalの各レベルに集約される。


Hypertext Markup Languageの略称。インターネット上のWebサーバーの他のドキュメントに対するコンテンツとリンクを指定するのに使用される、タグ・ベースのASCII言語。エンド・ユーザーは、WebブラウザによりHTMLドキュメントを表示させ、リンクに従って他のドキュメントを表示させる。


Hypertext Transfer Protocolの略称。WWWブラウザを有するコンピュータとアクセスされるWWWサーバー間のWWW通信データを搬送するのに使用されるプロトコル。


1つの文書のある位置から、別のドキュメント（のある位置）や同じ文書内の別の場所への参照（リンク）。Webブラウザでは、通常区別ができる方法（異なる色、フォント、スタイルなど）によりハイパーリンクが表示される。ユーザーが（マウスをクリックして）ハイパーリンクを実行すると、ブラウザがリンク対象を表示する。


クロス・リファレンスを含むドキュメントの集まりであり、これを使用するとWebブラウザによりドキュメント間の移動を簡単に行うことができる。


Webブラウザを使用することにより、ドキュメント間を簡単に移動できるクロス・リファレンス。


インタフェースC定義。Cにインプリメントされた機能に対するPL/SQLアプリケーションのプログラミング・インタフェース。


ウィンドウやツールの図形表示。


アプリケーションに保管およびロードできるビットマップ・オブジェクト。クライアントは、インポートされたイメージを変更できない。


Project Builderでは、Project Builderが認識し自動的にプロジェクト・ナビゲータ内にそのエントリを作成するプロジェクト項目であり、通常自動生成の結果である。たとえば、Project BuilderはCソース・ファイルのコンパイルの間に中間ステップとして生成される、 OBJファイルを認識し、それらのエントリをプロジェクト・ナビゲータ内に作成できる。暗示項目のプロパティのリセットは使用が制限されているが（次のコンパイルが変更を破棄する）、編集、ビュー、印刷のようなアクションを介して確認できるため、このような項目は便利である。「項目（item）」、「アクション（action）」も参照。


1. モジュールをファイル・システムまたはデータベースから読み込み、それをアプリケーションに取り込むこと。
2.プロジェクト情報が入ったファイルを読み込むこと。


その値について他のデータに依存しないデータ。たとえば、ある従業員の名前が値Jonesで、これは他の従業員名や関連データの値とは無関係であるなど。項目データとも呼ばれる。


表に関連するオプション構造であり、Oracle Serverにより表の行の位置を素早く確かめ、（オプションとして）それぞれの行が他と重複しないことを保証するために使用される。


Project Builderにおいて、依存性ツリー内の祖先ノードからアクション、タイプ、マクロまたはプロパティ定義の情報を取得すること。上位ノードに関連属性がある場合、それらの属性は継承できる。したがって、フォームや文書のようなファイル・システム項目がサブプロジェクト、プロジェクト、ユーザー・レジストリ、グローバル・レジストリからアクション定義を継承したり、プロジェクトがローカルまたはグローバル・レジストリからタイプ定義を継承する、などの場合がある。


枠の厚みや他の属性設定にかかわらず、オブジェクトの理想的な形を構成し、その4つの制御ポイントを接続する仮想の四角形。


ターゲットの構築に使用されるファイル。たとえば、.FMBは.FMXの入力となる。ソースともいう。


入力する各文字が、カーソル位置以降の文字を右に移動させてその位置に挿入されるモード。置換モードの反対。


世界的な、コンピュータのTCP/IPベースのネットワーク。


PL/SQLソース、Procedure BuilderコマンドおよびSQL文のあらゆる組合せが入ったファイル。


内部的なTCP/IPネットワークであり、これに対するアクセスは（ファイアウォールにより）企業や組織内の人物に制限されている。イントラネットは、インターネットが提供するサービスと類似したものを組織内に提供するが、インターネットに接続される必要は必ずしもない。企業内で情報やアプリケーションの配布のため、内部ネットワーク上に1つ以上のWebサーバーをセットアップするのはイントラネットの一般的な例である。


インターネット上のコンピュータを個別に識別する4つの部分をもつ数値で、それぞれの部分は3桁以下である。


Project Builderでは、フォームやドキュメントなど、そのオブジェクトに関連するファイル・システム内のオブジェクト。プロジェクト・ナビゲータ内のノードにより指定または参照される。


Project Builderでは、「プロジェクト・ナビゲータ」ウィンドウ内のエントリで、アイコンおよび内容を示すタイトルから構成される。ノードは、「Form Builder」ファイルおよび文書などのファイル・システム内の実際の項目を持つ。「ノード（node）」、「項目（item）」も参照。


Java ARchiveの略称。多くのファイル（Javaのクラス・ファイル、イメージなど）を1つのファイルに集めるのに使用されるファイル。


インターネット用のプログラミングをプラットフォーム独自の「アプレット」の形でサポートするコンピュータ言語。


2つ（以上）の表のデータを1つのSELECT文内で結合すること。


「配置（alignment）」を参照。


1. 対応する引数と共に指定する必要があるコマンド・ライン構文の一部。

2. PL/SQL構成体に必要な部分の1つ。


アプリケーションの仮想オブジェクトの値または意味を示すテキスト。


（Oracle Express） ディメンション階層内の位置。ベース・レベルより上の各レベルは、それより下のレベルからのデータの集約合計を表す。たとえば、TIMEディメンションには、MonthやQuarterなどの昇順レベルを持つ場合がある。ディメンション階層内では、1つのレベルのディメンション値は、そのレベルより上または下のレベルのディメンション値とファミリ・リレーションを持つ。


（Oracle Express） 特定階層内のレベルに基づいてディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、GeographyディメンションにあるKey Accountレベルのすべてのディメンション値を選択するといった操作もできる。


オブジェクトの作成、変更、位置付けまたは削除ができるエディタ領域。


異なる表示デバイス間で一貫した測定システムを使用するための寸法の単位。レイアウト上の位置またはオブジェクトの寸法を指定するのに使用される。


SQL SELECT文のテキスト文字列を示すのに使用されるパラメータへの参照。字句参照の際には、パラメータ名の前にアンパサンド（&）を付ける必要がある。


クライアントのファイル・システムまたはデータベースのファイルにともに保管された1つ以上のPL/SQLプログラム単位の集合。ライブラリに保管されたプログラム単位は、複数のアプリケーションから一度に参照できる。ストアド・プログラム単位（データベースに保存され、実行される）とは異なり、ライブラリ内のプログラム単位は、常にクライアント側のPL/SQLエンジン内にロードされ、実行される。ライブラリに保管されたプログラム単位を参照するには、まずライブラリを連結する必要があります。｢連結したライブラリ（attached library）」も参照。


グループと問合せ間でマスター/ディテール（親子）関係を定義するのに使用されるデータ・モデル・オブジェクト。


ボイラープレート・オブジェクトが関連付けられているファイルの名前。実行時に、Report Builderはファイルの内容をレポート・レイアウト内にインポートする。


ダイアログ・ボックス内の項目リスト。通常、リスト・ボックスは選択肢を提供し、スクロールできる。


Form Builderにおいて、選択肢の一覧を表示する項目。


LOVともいう。1列または複数列の選択リストを提供する、スクロール可能なポップアップ・ウィンドウ。


（Oracle Express） ディメンション内で現在選択されている値のリストからディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。


1. アプリケーションを実行するコンピュータ上のデータベース。2. アプリケーションが接続されているデータベース。このデータベースは、アプリケーションによって生成されるすべてのSQL文を解析し、実行する。


「ユーザー・レジストリ（user registry）」を参照。


現行のプログラム単位のスコープ内でのみ宣言されるPL/SQL変数。


（Oracle Express）

Not	Unary Not -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される（1の補数）。

And	And -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。

Or	Inclusive Or -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。

Xor	Exclusive Or -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。

Eqv	Equivalence -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。（A Eqv B）は（Not (A Xor B)）と同じ。

Imp	Implication -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。（A Imp B）は（(Not A）OR B）と同じ。


実際のレポートの1ページ（1つ以上の物理ページに表示される可能性がある）。


PL/SQLサブプログラムでは、 条件が一致しなくなるまで繰り返される条件文。


Project Builderにおいて、アクションのカスタマイズや拡張に使用できる型独自の変数。マクロは、定数または単純な式（これはまた、別の定数または式、あるいはその両方を含む場合がある）の形をとる。マクロを使用すると、コマンド・オプションの発行、およびユーザーがプロパティ定義を1つ変更して行うコマンド・セットの変更の自由度が、大きく高まる。


ページ上の1つ以上の列にレコードを表示する、デフォルトのレイアウト。フィールドは、1つの繰返し枠内で、互いのすぐ下に表示される。


ボディ領域の各論理ページの最上部と最下部にあるオプションのレポート領域。マージンは、任意のレイアウト・オブジェクトを含むことができるが、一般には、ボイラープレートと（ページ番号、総ページ数、総計、現在の日付と時刻のための）フィールドを含む。


ディテール・レコードがマスター・レコードの下に表示される、デフォルト・レイアウト。マスター・レコードは、フォーム・レイアウト・スタイルで表示され、ディテール・レコードは、表形式のレイアウト・スタイルで表示される。


（Oracle Express） ディメンション値の名前に含まれる文字をユーザーが指定する文字に一致させることにより、ディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、BrandレベルのProductディメンションで、"new"という文字を含むすべてのディメンション値を選択できる。


繰返し枠の各レコードをマトリックスのセルとして表示する繰返し方向。


マトリックス・レポートに必要な4つのデータ・セットをフォーマットする、格子に類似したデフォルト・レイアウト。この4つのデータ・セットは、ラベルの行として表示されるセット、ラベルの列としてのセット、格子を作成するセットおよび格子のセルに入るセットがそれぞれ1つずつである。


4つのデータ・セットのクロス・タブ。1つのデータ・セットはページの横方向に表示され、1つはページの縦方向に表示される。1つは、横方向と縦方向のデータが交わることが可能なすべての位置を決定し、それらの位置にセルを配置するクロス積である。もう1つは、セルの「フィルタ」として表示される。1つのデータ・セットはページの横方向に表示され、1つはページの縦方向に表示される。1つは、横方向と縦方向のデータが交わることが可能なすべての位置を決定し、それらの位置にセルを配置するクロス積である。もう1つは、セルの「フィルタ」として表示される。


（Oracle Express） 販売データやコスト・データなど、調査および分析できるデータ。ある基準内のデータを選択および表示できる。基準は、変数やリレーションとして格納したり、式を使用して計算したりできる。


1,048,576（1024x1024）バイトに等しいメモリーの単位。多くの場合、100万バイトに切り捨てられる。


最後のアクションのために発生した状況を通知するモーダル・ウィンドウ。メッセージ・ボックスには応答する必要がある。


オブジェクト・タイプ定義によってOracle8に連結された実行可能コード。


アプリケーションが継続する前にオペレータからの応答を引き出すウィンドウ。


ランタイム・ウィンドウ・マネージャがサポートできる量と同じ量の機能をもてる制限のないウィンドウ。


1. 複数のアプリケーションにより共有できるオブジェクト。外部問合せやPL/SQLライブラリは、モジュールの例。2. Form Builderでは、アプリケーションの主要なコンポーネント（メニュー・モジュール）。


いくつかの行に渡るウィンドウ内のフィールド、またはダイアログ。情報を垂直にスクロールさせることが可能である。


（Oracle Express） データが"使用できない（"not available"）（NA）ことを示す特別なデータ値。NAは、特別なデータ値が割り当てられていないまたはデータを計算できない任意のセルの値である。


横方向または縦方向（あるいはその両方）のディメンションに1つ以上のマスター/ディテール関係が含まれるマトリックス・レポート。ネストできる量に制限はない。


データ上のページが（フェッチしてからフォーマットされるまでキャッシュするのではなく）、フォーマットされてからフェッチされるデータ型。


1.  オブジェクト・ナビゲータのオブジェクト階層内の特定の位置。ノードは、他のオブジェクトへのクロス・リファレンスなどのオブジェクトの情報を表示するために拡張できる。2.  Project Builderにおけるプロジェクト・ナビゲータ内のエントリ。「項目（item）」、「項目ノード（item node）」および「編成ノード（organization node）」も参照。


データ型NOCACHEのデータベース列を参照するレポート列。


値がないこと。


（Oracle Express）

^	指数

-,+	単項のプラスおよびマイナス

*, /	数値乗算または除算。除算の場合、結果はDOUBLE型。

\	整数の除算。オペランドはＩNTEGER型またはLONG型。

Mod	係数または剰余。オペランドはＩNTEGER型またはLONG型。

-, +	数値の加算と減算。+演算子は文字列の連結にも使用できる。


1.  レイアウト上に配置できる項目。オブジェクトの例は次のとおり。四角形および、線、楕円、円弧、多角形、折れ線、丸い四角形、手書き、チャート、テキスト、記号、テキスト・フィールドなどのオブジェクト。

2. Oracle8では、オブジェクト・タイプのインスタンス。オブジェクトは、オブジェクト表内の行であったり、リレーショナル表内の列オブジェクトに含まれる行の一部であったりする。


「列オブジェクト（column object）」を参照。


関連するオブジェクトのコピーや参照を行う機能の提供に使用する、オブジェクト・グループのコンテナ。


「ハンドル（handle）」を参照。


現行セッションのオブジェクトの階層リストが入ったウィンドウ。リストはアウトライン形式で表示され、ユーザーはオブジェクトの作成、編集、改名および削除などの複数の作業を実行できる。


Oracle8において、定義がオブジェクト・タイプに基づいている表のこと。オブジェクト・タイプ内の各属性は、オブジェクト表内の列になる。表内の各行は、個々のOracle8オブジェクトである。


Oracle8において、オブジェクト作成の基盤となる、ユーザーが提供する定義またはテンプレート。オブジェクト・タイプは複合であり、その構成要素が属性である。各属性は名前とデータ型を持ち、オブジェクト・タイプ全体として名前を持つ。オブジェクト・タイプには1つ以上のメソッドが含まれる場合もある。


Open Database Connectivityの略称。異なるデータベース・システムをアクセスするための基準。アプリケーションは、SQLのODBC仕様によりODBCに対し文を送ることができる。ODBCはその文をデータベースが理解できる仕様に変換する。Oracle Open Client Adapter（OCA）により、アプリケーションは異なるデータベース管理システムを一貫した方法でアクセスできる。このためアプリケーション開発者は、特定のDBMSを対象とすることなくアプリケーションの開発、コンパイルおよび実行を行うことができる。


Object Linking and Embeddingの略称。


OLEオブジェクトの保管と表示が可能なアプリケーション。


OLEオブジェクトを作成するアプリケーション。


「ビルトイン・データ型（built-in datatype）」を参照。


Oracle製品のルート・ディレクトリを示す環境変数。


ナビゲータの設定や子項目のファイル・タイプの指示に役立つ、「タイプ」、「プロジェクト」、「フォーム・ファイル」などのプロジェクト・ナビゲータ内のエントリ。これはまた、特定のタイプのファイル・システム・オブジェクト内のデータ構成体に対応する。


x座標とy座標により示される。ビューの原点は、その親のキャンバス上のビューの位置を示す。キャンバスの原点は、描画ビュー上の描画の位置を示す。


オブジェクトを完全に囲む最少の仮想の四角形。


オブジェクトの内容が現行の論理ページに入りきらない状態。オーバーフローが発生すると、内容の一部が次の論理ページに移される。


プログラム単位内のあらゆる位置で参照可能な、ソフトウェアで提供されるPL/SQL関数。


関連するプロシージャ、ファンクション、変数およびその他のパッケージ要素をデータベースまたはクライアント内に1つの単位としてカプセル化し保管する方法。パッケージにより、データベース管理者やアプリケーション開発者の、編集作業が容易になると同時に、機能性とデータベースのパフォーマンスも向上する。ソフトウェアでは、クライアント側のプログラム単位によって参照されるPL/SQL構成体を含むビルトイン・パッケージがいくつか提供されている（TEXT_IOパッケージなど）。いくつかのパッケージには、ストアド・プログラム単位の参照用にOracleデータベース・サーバーも提供されている（DBMS_OUTPUTパッケージなど）。


パッケージの実際のインプリメンテーションを含む。これは、個別のサブプログラムおよびデータ型を含む場合がある。パッケージが宣言のみで構成される場合、本体はオプション。


パッケージに対する公開インタフェース（他のプログラム単位により参照可能なデータ型およびサブプログラム）を宣言する。


（Oracle Express） 1. レポート内に含まれる1つのデータ。追加ページによって追加データが表示される。

次の図は3ページ分のデータを示す。

2. Expressにおいて、ページはExpressデータベース内の格納単位も意味する。


（Oracle Express） 問合せについて選択したデータがスプレッドシート内でどのように表示されるかを表したもの。ページ・レイアウトによって、「横」、「縦」および「ページ」の3つの枠が表示される。問合せによって定義されるマルチディメンションのデータキューブが、2次元のスプレッドシート内でどのように表示されるかが、これらの枠によって示される。ディメンション・タイルには、ディメンションの名前と位置が表示される。「横」枠上のディメンションは、このディメンションが列として表示されることを意味する。「縦」枠上のディメンション・タイルは、このディメンションが行として表示されることを意味する。「ページ」枠上のディメンションは、このディメンションが結果の最上部にあるページ・ボックス内に表示されることを意味する。


現行のオブジェクトとその子を次の論理ページに移動するかどうかを制御する設定。レポート出力に現行オブジェクトが表示される前または後に、ページ・ブレークが発生するように設定できる。


エディタ内で利用できるツール、色またはパターンを表示するインタフェース要素。


作業が行われる、エディタの固有の位置で、通常サイズの変更が可能。


1つの論理ページを印刷するのに必要な物理ページの数。


1. 情報をサブプログラムに渡すのに使用されるPL/SQL構成体。たとえば、サブプログラム・コールMYPROC（x）では、xがパラメータ。2. Forms Developerでは、パラメータは情報をForm BuilderやGraphics Builderなどのコンポーネント間で渡すのに使用される。3. 実行時に変更可能な変数。


Forms Developerコンポーネント間で情報を渡すのに使用される、パラメータ名と関連する値のグループ。


1. そのグループ・ツリー内のあるオブジェクトのすぐ上位のオブジェクト。グループ・オブジェクトは、それを構成する各オブジェクトの親である。どのオブジェクトも、その子の親になる。
2.（Oracle Express）階層内において特定値のすぐ上のレベルにあるディメンション値。親値は、その子の値の集約合計である。次の例は、GEOGRAPHYディメンションにおいて、"Lyon"と"Paris"の親としてのディメンション値"France"を示す。


クリップボードの内容（カットまたはコピーされたオブジェクト）を現行のカーソル位置に入れること。


ほとんどのオブジェクトの枠または塗りに適用できる、図形プロパティ。


コンパイルされたプログラム単位に対するマシン・コードまたは指示リスト。


Portable Document Formatの略称。ドキュメントの作成に使用された元のアプリケーション・ソフトウェア、ハードウェアおよびオペレーティング・システムとは無関係にドキュメントを表現する（Adobe Acrobatに固有の）ファイル形式。PDFファイルは、テキスト、図形およびイメージのあらゆる組合せが入ったドキュメントを、デバイスや解像度から独立した形式で表現できる。


プリンタに出力されるページのサイズ。


横棒、線、記号のような、チャート上のフィールドの表示に使用される要素のタイプ。


SQL言語に対するOracle専用の拡張。SQLに対しアプリケーションの記述に適するようにプロシージャ型構成体やその他の構成体を追加している。


Procedure Builderインタプリタのスクリプト・ファイル。


ソース・コードとコンパイル済みコードを含むPL/SQLライブラリ・ファイル。ファイルはProcedure Builderでオープンして編集できる。


1つのプログラム単位のPL/SQLソースを含むテキスト・ファイル。


実行可能コードのみを含むランタイムPL/SQLライブラリ・ファイル。ファイルをProcedure Builderでオープンして編集することはできない。


ユーザーが特定のアクションを実行する際にポップアップするリスト。


転送されたデータと特定のプログラム間の経路を定めるためにTCPが使用する番号。


Project Builderに付属しておりメニュー項目またはツールバー・ボタン（あるいはその両方）で自動的に利用できるアクション。事前定義済みアクションには、「ビルド」および「配布」、複数のソース制御オプションが含まれる。事前定義済みアクションは、サポートされているファイル・タイプに定義されると、Project Builderからコールすることにより、そのタイプの任意の選択項目に対して起動される。「アクション（action）」、「ユーザー定義アクション（user-defined action）」も参照。


「ビルトイン・データ型（built-in datatype）」を参照。


アプリケーションのインタフェースの動作に影響する設定。


（Oracle Express） 現行の基準を受け入れる場合に生成されるスクリプトを表示する。任意の「セレクタ」ツールのダイアログ・ボックスでは、「プレビュー」ボタンを選択することにより、選択項目のプレビューを表示できる。


レポート出力のアウトラインを表示しスクロールできるインタフェース。


表内の行の識別に使用できる一意の値で内容が構成された、データベース表内の列。


「ビルトイン・データ型（built-in datatype）」を参照。


プリンタ定義ファイルでは、レポート内で参照できるプリンタ・コードを割り当てるエスケープ・シーケンス。


プリンタ定義がテキスト形式（ASCIIやEBCDICなど）で入ったファイル。


指定されたアクション・シーケンスを実行するPL/SQLサブプログラム。クライアントおよびデータベース・サーバーに存在し、実行することができる。


PL/SQLコンパイラが独自に認識して処理できるPL/SQLコード構造。無名ブロック、サブプログラムの仕様部と本体（プロシージャおよびファンクション）、パッケージの仕様部と本体などがある。プログラム単位は、クライアントおよびデータベース・サーバーに存在し、実行できる。｢ストアド・プログラム単位（stored program unit）｣も参照。


Project Builderにより作成される基本的なデータ構造。プロジェクトは、アプリケーションの一部と見なしている、または概念的にグループ分けするすべてのファイルに対するポインタの集合である。エディタ、コンパイラまたは他のツールを定義して、プロジェクト内に含まれる項目を操作できる。すべてのプロジェクト情報はプロジェクト・レジストリ内に格納される。「プロジェクト項目（project item）」、「プロジェクト・ファイル（project file）」および「エクスポート（export）」も参照。


Project Builderにおいて、プロジェクト・ファイルは、アプリケーションに関連付けられたすべてのファイルを指す。プロジェクト・ファイルには、フォーム、レポート、ディスプレイ、3GLモジュール、ドキュメントおよびテスト・スクリプトを含む、あらゆるタイプがある。「プロジェクト（project）」、「プロジェクト項目（project item）」も参照。


Project Builderにおいて、プロパティを定義できるすべての項目を指す。これには、「プロジェクト」ノード下に格納されたすべてのエンティティ、タイプ、アクションおよびマクロも含まれる。「プロジェクト（project）」、「プロジェクト・ファイル（project file）」も参照。


現行セッションのプロジェクト項目の階層リストを含むウィンドウ。リストはアウトライン形式で表示され、ユーザーはオブジェクトの作成、編集、改名および削除などの複数の作業を実行できる。いつでも表示できるのは1つのみだが、オブジェクトの編成に使用される2つの異なるスキーマから選択できる。


プロジェクトのトップ・レベルのノード。プロジェクト・ファイルを表示または指示する。「プロジェクト（project）」、「プロジェクト・ファイル（project file）」も参照。


Project Builderにおいて、プロジェクトに関連付けられたすべての情報を格納するファイル。プロジェクトに属するファイル、タイプ、アクションおよびプロジェクトについて定義されたマクロなどが含まれる。プロジェクトに属するファイル、タイプ、アクションおよびプロジェクトについて定義されたマクロなどが含まれる。


プロジェクト表示は、タイプ、およびプロジェクトとサブプロジェクトの関係により編成されるオブジェクトを表示する。プロジェクトは、プロジェクト・ファイルごとにアルファベット順に編成されてから、カテゴリごとにアルファベット順に編成される。「依存性表示（dependency view）」、「プロジェクト（project）」、「プロジェクト・ファイル（project file）」、「ビュー（view）」も参照。


ユーザーが新規プロジェクトまたはサブ・プロジェクトの作成に必要なステップを完了するのを支援するダイアログ。


オブジェクトの動作または外観を決定する、オブジェクトの特性。


クラスに基づいたオブジェクトの外観と機能性をグローバルに制御するために使用するプロパティとその設定のリストを含む、ユーザー命名オブジェクト。


データベースまたはサーバーに接続する際に入力できる文字列で、リモート・データベースまたはサーバーへの接続を可能にする。


（Oracle Express） 基準内のいずれかのディメンションの値を選択するとき、その基準を構成する他のディメンションは修飾ディメンションと呼ばれる。

「販売」基準が「製品」、「月」および「地域」別にディメンション化されていると仮定する。「販売」に基づく上位10都市を選択する場合、「販売」値を比較するには、比較の対象となる製品と月も指定する必要がある。この場合、「製品」と「月」は、修飾ディメンションである。


データベースの1つ以上の表またはビューから検索するデータを指定する、SQL SELECT文。


実行時に、問合せにより取り出されたデータのフィルタリングを行うPL/SQL関数。ファンクションの条件を満たすデータのみをチャートにする。


現行セッションを終了しユーザーをオペレーティング・システムに戻すオプション。一部のシステムでは、「終了（Quit）」は「終了（Exit）」になる。


2つ以上のセットで表示される（チェックボックスに類似した）制御であり、一定の時間において「オン」または「オフ」となるのはそのうちの1つのみである。


2つ以上のラジオ・ボタンのセットであり、一定の時間において「オン」または「オフ」となるのはそのうちの1つのみである。


（Oracle Express） 連続する時間間隔をディメンション値として選択できる「セレクタ」ダイアログ・ボックスのツール。これらの時間間隔は、次のいずれかを基準にすることができる。

•	最も最近の時間間隔の具体的な数

•	開始時間間隔と最も最近の時間間隔

•	開始および終了の時間間隔

たとえば、1996年11月25日で終わる週から、1996年12月30日で終わる週までの範囲で、ディメンション値を選択するといった操作もできる。


RSA Data Security, Inc.により考案された暗号法であり、任意の長さのキーを認める。これは基本的に、暗号データを作成するためにデータ・ストリームにより排他的論理和が行われているジェネレータの出力を使用する、偽のランダム番号のジェネレータである。このため、2種類のデータ・ストリームを暗号化するのに同じRC4キーを使用しないように十分注意する必要がある。


Relational Databasse Management System（リレーショナル・データ・モデルに基づいたデータベース管理システム）の略称。データ構造、格納と検索操作、および整合性制約の定義が行うことができるデータベース。このようなデータベースでは、データとそれらの間の関係は表で編成される。


単一のバイナリ形式のレポート定義を含むファイル。.RDFファイルは、レポートの実行と編集の双方に使用される。


単一のバイナリ形式のレポート定義を含むファイル。.repファイルは、レポートの実行にのみ使用される。.repファイルを編集できない。


ある時点において、データベース全体でデータを問い合わせる能力。


SQL SELECT文によりフェッチされる1行。


列と行構造による内部的なデータ構造オブジェクトで、それらが定義されるフォーム・モジュールに属する。


他の列オブジェクト内またはオブジェクト表内のデータを参照する列のタイプ（Oracle8）。


チャート上の指定された値の位置に表示される線。


（Oracle Express） 問合せ結果をレポートに表示した後、Expressデータベースから最新のデータをフェッチする。保存されたExpress問合せをオープンすると、結果は自動的にリフレッシュされる。


タイプまたは新規プロジェクトの定義をグローバル・レジストリまたはローカル・レジストリに追加すること。登録されると、新規のタイプにはアクションを定義でき、新規のプロジェクトでは参照ファイルを特定のタイプとして識別させ、そのタイプに対してアクションを起動できる。「レジストリ（registry）」も参照。


プロジェクト定義および環境情報を格納した、グローバルな構造ファイルまたはユーザー固有の構造ファイル（あるいはその両方）。「グローバル・レジストリ（Global Registry）」、「ユーザー・レジストリ（user registry）」も参照。


"WHERE DEPTNO = 10"内の等号など、2つの値間の比較を示す検索条件に使用される記号。比較結果が"TRUE"となる行は結果が返され（フェッチされ）、比較結果が"FALSE"となる行は結果は返されない。


コンピュータ上の、ローカル・データベース以外のデータベース。通常、同じネットワーク上にあるが、ノードが異なるコンピュータ（つまり、データベース・リンクを介して使用するデータベース）。


グループのためにフェッチされるデータ行の表示に使用されるレイアウト・オブジェクト。


入力する各文字がカーソル位置の現行の文字を置換するモード。挿入モードの反対。


レポートのデータ・モデルとレイアウトの定義に使用されるオブジェクト。レポート・レベルのオブジェクトは、1つのレポートに割り当てられ、他のレポートまたは他のOracle製品とは共有できない。オブジェクトには、レポート、問合せ、外部問合せ、外部PL/SQLライブラリ、グループ、列、パラメータ、リンク、枠、繰返し枠、フィールド、ボイラープレートおよびアンカーが含まれる。


Windows NTおよびWindows95でのみ利用可能。コマンド・ラインがレポートを実行するのを待機し、ローカル・サーバー上のバックグラウンドで実行するためそのレポートをそのキューに入れる。通常コマンド・ラインは、RUN_PRODUCTを介してForm BuilderまたはGraphics Builderから、あるいはSRW.RUN_REPORTを介して別のレポートから受け取られる。RWISV60を使用し、レポートをReportsバックグラウンド・エンジンに送ることもできる。


タイムスタンプおよびReports Serverにより管理されるレポートに関するステータス情報をメンテナンスする。


Windows NT、Windows95およびUNIXで利用可能。リモート・サーバー上でのレポートの実行を可能にする。ジョブ要求をキューに登録し、レポートをいつ実行するか計画できる。レポートをReports Serverに送るには、RWCLI60を使用する。


WebサーバーとReports Runtime間のインタフェースを提供し、レポートをWebブラウザから動的に実行することを可能にする。


WebサーバーとReports Serverの間の接続を提供する。


テキスト形式（ASCIIやEBCDICAなど）で格納された、レポート定義を含むファイル。.REXファイルは、レポートを1つのプラットフォームから別のプラットフォームに移植するのに使用する。.REXファイルは、現時点では必要ではないことに注意する。このファイルは、下位互換性のために利用できる。


色のコンポーネント、赤、緑および青の濃度を示す。


アプリケーション内の他のすべてのオブジェクトが属するグループ・オブジェクト。


ユーザー環境を表す、プロジェクトの最上位のノード。デフォルトの設定にどのレジストリが選択されているかによって、ユーザー・レジストリまたはグローバル・レジストリに対応する可能性がある。


1. 表内のフィールド値の1組。たとえば、サンプル表EMPにおける1人の従業員を表すフィールド。

2. アプリケーションのランタイム・バージョンを生成する。


Oracle8オブジェクト表内のオブジェクト。表内の各行がオブジェクトになる。ただし、Forms Developerにおいて、オブジェクト表は個々の列に分解されるため、行オブジェクトは1つのエンティティとして存在しない（個別の属性としてのみ存在する）。


アプリケーションまたはプログラム単位のランタイム・バージョンを実行する。


リッチ・テキスト形式の略称。プラットフォームに特定されないファイル形式で、書式化されていないテキストやイメージをさまざまなアプリケーションおよびオペレーティング・システムで表現するのに使用される制御文字に基づいている。RTFは、ANSI、PC-8、MacintoshまたはIBM PCのキャラクタ・セットを使用して、スクリーン表示や印刷において文書の表現と書式化を行う。


「REPファイル（rep file）」を参照。


ユーザーがその中でランタイム・アプリケーションの表示とランタイム・アプリケーションとの対話を行うインタフェース。


実行時にオプションで表示される画面またはウィンドウであり、この中でユーザーはレポートの実行に先立ち印刷オプションやパラメータの変更を行うことができる。


（Oracle Express） 値のリストまたはスクリプトとして保存された一連のディメンション値。ユーザーは自分で作成した選択項目を保存したり、データベース管理者は保存済みの選択項目を作成して、ユーザーが利用できるように提供できる。

保存済みの選択項目は時間短縮の機能を果たす。つまり、選択項目を再利用する必要があるたびに、保存された選択項目を再作成することなく、取り出すことができる。つまり、選択項目を再利用する必要があるたびに、保存された選択項目を再作成することなく、取り出すことができる。


（Oracle Express） 保存されたディメンション値の選択項目を取り出すことのできるセレクタ・ツール。


通常データベースのユーザーIDによりグループ化されている、関連するデータベース・オブジェクトの集まり。スキーマ・オブジェクトには、表、ビュー、順序、ストアド・プログラム単位、シノニム、索引、クラスタおよびデータベース・リンクが含まれる。


オブジェクトが作動するレベルまたは範囲。Project Builderでは1. コンパイル可能なプロジェクト項目に対して起動された「ビルド」および「すべてをビルド」コマンドによって、影響されるファイルの範囲を記述する。

2. 継承可能な定義によって影響されるファイルの範囲を記述する。


「SQLスクリプト（SQL script）」、「インタプリタ・スクリプト（Interpreter script）」を参照。


Report Builderにおける同一レポート内の複数のレイアウトのいずれかで、それぞれ異なる対象読者、出力形式、ページ・レイアウト、ページ・サイズまたは印刷の向きを持つ。たとえば、1つのレポートで、あるセクションには上級管理職向けの業務要約を記載し、別のセクションには個々の管理者用の詳細な業務分析を記載できる。


1つ以上の表またはビューからどの行と列をフェッチするかを指定するSQL文。


（Oracle Express） ディメンションについて現在選択されている一連のディメンション値またはそれらの値を指定するための条件や基準を含むスクリプト。


（Oracle Express） セレクタ内のさまざまなダイアログ・ボックスで表示される、ディメンション値の選択において、ユーザーが選択した項目の説明。Express言語スクリプトを通常の言語で翻訳したもの。


（Oracle Express） レポート、表、グラフまたはディメンションの各リスト・ボックスに含めるディメンション値を選択するための一連のツール。たとえば、セレクタを使用すると、「販売」に基づく上位10都市を選択したり、「販売」が「割当額」を15パーセント超えた上位10都市を選択できる。セレクタを使用することにより、ディメンション値のソート、および保存済み選択項目の作成と取出しも行うことができる。


（Oracle Express） ディメンション値を選択またはソートするための特定の方法を提供するダイアログ・ボックスまたはそのグループ。各セレクタ・ツールは、セレクタの構成要素である。セレクタ・ツールを使用することにより、階層内のレベル、属性または値名内の文字などを基準にしてディメンション値を選択できる。セレクタ・ツールを使用して、ディメンション値をソートすることもできる。


実行可能プログラムの起動と終了の間の期間。


グループ・ツリー内で同じ親オブジェクトをもつ2つ以上のオブジェクトの1つ。1つのグループ・オブジェクトに属するオブジェクトは、すべて同位項目である。


IPアドレスとポート番号の組合せ。


（Oracle Express） 表示された選択項目内で、ディメンション値の順序を並べ替えることのできる「セレクタ」ダイアログ・ボックスのツール。次の項目を基準にして、選択項目を昇順または降順にソートできる。

•	アルファベット

•	データベース内における順序

•	データ値

•	階層内の順序またはレベル

•	時間間隔

ディメンション値をドラッグ・アンド・ドロップすることにより、選択項目を手動でソートすることもできる。


PL/SQLでは、サブプログラムまたはパッケージ内で提供される文。プログラム単位のソース・コードを持っていなければ、それを実行可能な形にコンパイルすることはできません。Project Builderでは、ターゲットの種類の構築に必要な入力タイプ。サブプログラムの名前、パラメータおよび戻り型（ファンクションへの適用のみ）のみを定義する。


サブプログラムの名前、パラメータおよび戻り値の型（ファンクションへの適用のみ）のみを定義する。


エディタ内の、垂直スクロール・バーの下と、水平スクロール・バーの左にある小さな四角形。マウス・ボタンをドラッグして離すと、新規のペインが作成され、スクロール・バーはそれぞれのペイン用に分割される。


リレーショナル・データベースにおける情報の格納と検索のための標準インタフェース。SQLは、Structured Query Language（構造化問合せ言語）の略称。


テキスト形式（ASCIIやEBCDICなど）に格納された問合せを含む。


データベース管理を素早く簡単に行うSQL文を含むファイル。SQLスクリプトの一部は、Oracle製品に付属している。


Oracleに対するSQLの指示。SELECT文は、SQL文の一種。


「コール･スタック（call stack）」を参照。


条件制御、繰返し制御、逐次制御およびエラー処理に使用されるPL/SQL構成体。各PL/SQL文の最後には、必ずセミコロン（;）を付ける必要がある。


（Oracle Express） 評価されるたびに同じディメンション値を含む保存済みの選択項目。静的な保存済み選択項目では、選択基準ではなく、選択されるディメンション値がリストされる。たとえば、静的な保存済み選択項目のスクリプトには、"Select February 1996, March 1996, and April 1996"などのように文が記述され、動的な保存済み選択項目のスクリプトでは、"Select the last three Months"といったように文が記述される。


Oracleデータベース・サーバーに存在し、Oracleデータベース・サーバーで実行されるプロシージャ、ファンクションまたはパッケージ。


Oracleデータベース・サーバーに存在し、Oracleデータベース・サーバーで実行されるプロシージャまたはファンクション。


HTMLドキュメント内でフォーマットの強力な柔軟性を提供するHTMLの拡張機能。スタイル・シートを利用するHTMLドキュメントを探し、それをスタイル・シートをサポートするブラウザに表示する。


PL/SQLプロシージャまたはPL/SQL関数。


Project Builderにおいて、それ自身のファイル内に格納されているのではなく、他のプロジェクトファイル内に含まれるプロジェクト。「プロジェクト（project）」も参照。


Project Builderにおいて、サブプロジェクトを示すノード。「プロジェクト（project）」、「プロジェクト・ノード（project node）」および「サブプロジェクト・ノード（subproject node）」も参照。


集計タイプの列。Report Builderにより提供されているパッケージ化された集計ファンクションの1つを使用し、レポート内のデータのサブ合計、グランド合計、実行合計およびその他のデータ集計を計算する。


Microsoft Excelプログラムで使用されているファイル形式。


コマンド、修飾子およびパラメータが結びつけられて有効なコマンド文字列を形成する規則的なシステム。


Reports Developerで提供されている変数の1つ（&Logical Page、DESTYPEなど）。


リレーショナル・データベースまたはサーバーで行と列から構成される2次元の格子に格納される、関連する情報の名前付き集合。


コレクション・タイプの一種で、すべてが同じデータ型を持つ、順序付けのされていない一連の要素で構成されるデータ単位を定義する。対応するデータ単位は、1つの列がネストされた表で、その列タイプはビルトイン・タイプまたはオブジェクト・タイプである。（Oracle8）


ページの最上部にラベルを、ラベルの下にデータ行を表示するデフォルト・レイアウト。


Project Builderにおける依存ツリー内のあらゆる項目。たとえば、実行可能プログラムはライブラリの（コンパイル）ターゲット、ライブラリはオブジェクトのグループのターゲット、そしてオブジェクトはソース・ファイルのターゲットである。


ターゲットを示すノード。「ターゲット（target）」も参照。


Transmission Control Protocol（伝送制御プロトコル）の略語。クライアントとWebサーバー間のHTTP要求を交換するための基礎的な通信プロトコル。


マウスやその他のポインティング・デバイスを使用しユーザーがそのソースから削除して表示画面の別の位置へドラッグできるサブメニュー。


Form Builderにおいて、文字列の値を表示する項目。


アプリケーション名やそのウィンドウ内のインタフェース要素を表示する、ウィンドウの最上部の水平領域。


「ヘッダー（header）」を参照。


設定を交互にオンまたはオフに切り替えること。たとえば、オブジェクト・ナビゲータを隠したり表示できる。


アプリケーション内でオブジェクトの作成と操作に使用するアイコン・ボタン。


製品コマンドを実行するアイコン・ボタンの集合。通常、ウィンドウの一番上に沿って水平に並んでいるか、横に垂直に並んでいる。


ツールの集合。


（Oracle Express） 上限xと下限yまたは上限xと下限yのデータ値を基準にしてディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、1995年12月30日で終わる4週間の時間間隔において、「米国内」で生産された製品のうち、販売量が上位10パーセントに入る製品を含むディメンション選択項目を生成できる。


テキスト、図形、データ、計算など、レポートについての最終内容を入れることができるオプションのレポート領域。レポート・トレーラは、ヘッダーとボディに続いて最後に表示される。


1つの単位として扱われる一連のSQL文。


特定のイベントに従って実行または「起動」されるPL/SQLプロシージャ。


タイプ名や説明などの情報が入った、フォームやドキュメントなどのファイル・タイプの説明。各説明は1つのファイル・タイプに当てはまる。また、4つのメタ・タイプもある。"updtext"は、すべてのテキスト・ファイルに適用される。"updproj"は、すべてのプロジェクト・ファイルに適用される。"updlink"は、すべてのプロジェクト・リンクに適用される。"all"は、すべてのファイル・タイプに適用される。"updtext"は、すべてのテキスト・ファイルに適用される。"updproj"は、すべてのプロジェクト・ファイルに適用される。"updlink"は、すべてのプロジェクト・リンクに適用される。"all"は、すべてのファイル・タイプに適用される。タイプは、アクションやマクロを定義する基礎となる。


表データの値を変更すること。特に、SQLコマンドUPDATEによるデータ値の変更、SQLコマンドDELETEによる値の削除、またはコマンドINSERTによる値の挿入。


Uniform Resource Locatorの略称。WWWサーバーおよびホーム・ページの指定に使用される「アドレス」。たとえば、http://www.acme.com/。
この例は、ホストのアドレスがwww.acme.comであることを示す。一般に、URLはファイル名である（長いパスをもち、拡張子.HTMLまたは.HTM（PC-DOSファイル名の場合）が通常付く）。


Forms Developerからの制御（および引数）を別のOracle製品または3GLに渡し、続いて制御（および引数）をForms Developerに戻す方法。


Project Builderユーザーにより定義されるカスタム・アクション。このようなアクションは、任意の1つのファイル・タイプまたはすべてのファイル・タイプに適用できる。「アクション（action）」、「定義済みアクション（pre-defined action）」も参照。


「オブジェクト・タイプ（object type）」を参照。


Project Builderユーザーにより定義されるカスタム・マクロ。このようなマクロは、ビルトイン・アクションとユーザー定義アクションの両方を変更するのに使用することができる。「マクロ（macro）」、「ビルトイン・マクロ（built-in macro）」、「アクション（action）」および「定義済みアクション（pre-defined action）」も参照。


構成情報をユーザーごとに格納するプロジェクト・ファイル。これによってユーザーは、個々の開発環境をカスタマイズできる。ユーザー・レジストリは、グローバル・レジストリからタイプ情報を継承するほか、新規タイプを定義したり、グローバル・レジストリに格納されているタイプ定義の一部を上書きすることもできる。また、ユーザー設定による接続文字列、「ツールバー表示」のようなUI設定、および「作成者」のような一般的なプロジェクト情報など、環境情報および作業環境情報も格納する。「レジストリ（registry）」、「グローバル・レジストリ（Global Registry）」も参照。


「値軸（continuous axis）」を参照。


値を返すPL/SQLコード構造。値構成体には、ファンクションと式が含まれる。


値を割り当てることができ、割り当てられた値が時間がたつにつれ変化する可能性があるユーザー命名オブジェクト。


コレクション･タイプの一種で、すべてが同じデータ型を持つ、順序付けされた一連の要素で構成されるデータ単位を定義する。対応するデータ単位は、可変配列つまりVARRAYである。VARRAY（サイズ）内の要素数は可変である。ただし、可変配列型を宣言するときは、最大サイズを指定する必要がある。


Visual Basic extensionの略称。事前定義済みのVBXコントロールを含むファイル上に分配された特定のダイナミック・リンク・ライブラリのファイル拡張子として使用される。


Microsoft Visual Basic言語で構築されたウィジェット。ユーザー・インタフェースの拡張、ユーザー入力の取得、および出力（スライダ、格子、制御ノブなど）の表示に使用される。


その行がデータベース内に実際に存在しないが、データベースに物理的に格納されている表に基づいている仮想的な表。


仮想ファイル・システムがホスト・マシン上のファイル・システムに格納されたファイルをマッピングするのに使用する、ディレクトリ・ニーモニック（本来、ショートカットまたは略称）。


URL内で使用されているパス名を、ホスト・マシンのオペレーティング・システムによりメンテナンスされているファイル・システムに関連付けるマッピング。


アプリケーション・インタフェース内に現れるオブジェクトに対し設定する、フォント、色およびパターンのプロパティ。


「WWW」を参照。


エンド・ユーザーが（Webサーバーによりサービスされる）コンピュータ上に保管されているHTMLドキュメントおよびプログラムを読むために利用するプログラム。


Web Request Brokerを介してWebサーバー上で実行されるプログラム。


リモートWebブラウザのHTTP要求に応答してWebページを送信する、Webサイトで稼働しているサーバー・プロセス（HTTPデーモン）。


ワードまたはフェーズ内で「任意の1文字」または「隣り合うキャラクタ・セット」を意味するために使用される文字。


1. アプリケーションが入った、デスクトップの四角形の領域。各ウィンドウには、アプリケーションと対話できる領域がある。ウィンドウは、オープン、サイズ変更、移動、アイコンへの縮小、デスクトップ全体への拡張ができる。2. Form Builderにおいて、キャンバス・ビューと関連付けることができるオブジェクト・タイプ。


SQL*CalcやLotus 1-2-3プログラムなどのスプレッドシート・プログラムで使用されているファイル形式。


Oracle Web Request Brokerの略語。Web用のアプリケーションの開発と実行に、強力な分散した実行時環境を提供する。WRBランタイム・プラットフォームにより、アプリケーション開発者は、Webサーバーから独立したアプリケーションや多くのWebサーバーと共に稼働するアプリケーションを記述することができる。


World Wide Webの略語。インターネット上のサーバーのネットワークであり、サーバーのそれぞれが1つ以上のホームページをもつ。ホームページは、そのサーバーまたは他のサーバー（通常こちら）上の他のドキュメントに対し情報やリンクを提供する。


フィールドの内容を編集するため、オブジェクトを拡大し表示領域を広げること。


（デフォルトで）descriptionプロジェクト・ナビゲータの左に表示された2番目のツールバー。簡単な編成およびアプリケーション起動機能がある。


 OLEコントロール（OCX）の最新バージョン。


適切なタギング、ネスティングおよびXML宣言（<?xml version="1.0" encoding="UTF-8"?>など）の組込みなどの一般的なXML原理に従うXML出力。


プレースホルダ・ユーザー名を使用すると、Webブラウザからレポートを実行するときに、Oracelデータベースのユーザー名（$user_name@databaseなど）ではなく、個人ユーザー名を使用してデータベースにログオンできる。


ＸML（Extensible Markup Language）。SGMLを使用して、データを定義および構築するメタ言語。Report Builderは、XML出力をサポートして、Webパブリッシングおよびサードパーティーのアプリケーションとの電子的データ交換を可能にする。また、XMLを使用して、実行時に他のレポート定義とマージすることができるレポート定義を作成することも、文書型定義（DTD）に従う構造および要素の内容を持つXML出力を別々に実行することもできる。


文書型定義（DTD）に準拠する構造および要素内容を持つ、XMLによる出力。有効なXMLは、適切に構成されている。


オンライン・ヘルプの使用

オンライン・ヘルプ・システムを効果的に利用するためのガイドラインを次に示します。

•	「目次」タブを読んで、オンライン・ヘルプで取り上げられているトピックの内容を把握します。

•	トピック・タイトルのすぐ下にある「関連項目」ボタンをクリックして、現行のトピックに関連するトピックのリストを表示します。

•	トピックの一番上にある「オプション」ボタンをクリックして、「手前に表示」を設定します。これにより、アプリケーションの開発を進めながらでも、ヘルプ・トピックは常に画面の手前に表示されます。

•	用語の定義を調べるには、トピックの最上部にある「用語集」ボタンをクリックします。


ドキュメント・ロードマップ

アプリケーションの構築方法を習得するには:

1	各コンポーネントの概要を述べたクイック・ツアーを確認します。

•	「ヘルプ」 [image] 「クイック・ツアー」を選択します。

2	最も一般的な作業の実行方法を学習するには、キュー・カードを参照します。

•	「ヘルプ」 [image] 「キュー・カード」を選択します。

3	オンライン・マニュアルを表示します（ハード・コピーのマニュアルも利用できます）。

•	「ヘルプ」 [image] 「マニュアル」を選択します。

4	オンライン・ヘルプ・システムにアクセスします。

•	「ヘルプ」 [image] 「ヘルプ・トピック」を選択します。

•	状況依存ヘルプを参照するには、[Help]キー（ほとんどのプラットフォームでは通常[F1]キー）を押します。


インフォメーション・デスク


Forms Developerの各国語サポート

  関連項目

世界各国で使用できるアプリケーションを設計する場合、データの表示方法について各国語固有の表記法規約を使用することにより、世界中のユーザーがそれぞれの言語でアプリケーションと対話できるようにしたいものです。Oracleの各国語サポート（NLS）は、次の3つの主要な階層で構成されます。

•	各国語文字コード体系のサポート

•	言語および地域の表記法規約のサポート

•	アプリケーションの翻訳

このように、文字レベル、データ表示レベルおよびインタフェース・レベルでのサポートを組み合せることにより、作成したアプリケーションは、マルチバイト・キャラクタのコード体系および双方向性を含め、ヨーロッパ、中東およびアジアのほとんどの言語で使用できるようになります。


NLSアーキテクチャ

  関連項目

NLSアーキテクチャには、次の2つの主要な部分で構成されます。

•	言語に依存しない機能

•	言語依存のデータ

言語に依存しない機能では、実行時にオペレータが使用する言語および地域に応じて適切な方法でデータを処理し、その国での日付および時刻の表記法規約に従って、データを自動的に書式設定します。

言語依存のデータを特定することにより、作成したアプリケーションに固有な文字列の翻訳のみをアプリケーションで処理できるようになります。


各国語サポートの環境変数

  関連項目

次に示すパラメータを環境変数として使用することにより、Forms Developerの言語設定を指定できます。

パラメータ	指定する言語設定
NLS_CALENDAR	使用するカレンダー・システム
NLS_CREDIT	正の通貨値を示す文字列
NLS_CURRENCY	各国通貨記号
NLS_DATE_FORMAT	日付用のデフォルト書式
NLS_DATE_LANGUAGE	日付用のデフォルト言語
NLS_DEBIT	負の通貨値を示す文字列
NLS_ISO_CURRENCY	ISO通貨記号
NLS_LANG	Forms Developerの言語設定
DEVELOPER_NLS_LANG	Forms Developer Builderの言語
USER_NLS_LANG	Forms Developer Runtimeコンポーネントの言語
NLS_LIST_SEPARATOR	リスト内の項目を区切るための文字
NLS_MONETARY_CHARACTERS	通貨値用の小数点記号と3桁区切り
NLS_NUMERIC_CHARACTERS	数値用の小数点記号と桁グループ・セパレータ
NLS_SORT	文字データ用のソートのタイプ

これらのパラメータの詳細は、『Oracle8 Serverリファレンス・マニュアル』を参照してください。


NLS_LANG環境変数

  例	  関連項目

NLS_LANG環境変数によって、Forms Developerで使用される言語設定が決まります。

NLS_LANGによって指定される設定は次のとおりです。

•	'しばらくお待ちください...'メッセージなど、ユーザーに対して表示されるメッセージの言語

•	日付と数値用のデフォルトの書式マスク

•	ソート基準

•	キャラクタ・セットを構成する文字

NLS_LANGの構文を次に示します。

NLS_LANG=language_territory.charset

パラメータの内容は次のとおりです。

language	メッセージおよび日と月の名前を表示するための言語とその規約を指定します。 言語を指定しないと、その値はデフォルトで米語に設定されます。
territory	地域を指定し、デフォルトの日付書式や、数値、通貨記号および週番号と曜日番号の計算に使用される表記法規則も指定します。 地域を指定しないと、値はデフォルトでアメリカに設定されます。
charset	データを表すキャラクタ・セットを指定します。これは、使用している言語とプラットフォームに一致するキャラクタ・セットである必要があります。この引数は、メッセージの表示に使用するキャラクタ・セットも制御します。

NLS_LANGの詳細は、『Oracle8 Serverリファレンス・マニュアル』を参照してください。


DEVELOPER_NLS_LANG環境変数とUSER_NLS_LANG環境変数

  例	  関連項目

ほとんどの場合、NLS_LANGには1つの値を設定するのみで十分です。ただし、同一コンピュータ上で2か国語のリソース・ファイルとメッセージ・ファイルを同時に使用する必要がある場合、次の2つの環境変数が使用できます。

•	DEVELOPER_NLS_LANGは、製品のBuilder用の言語を指定します。

•	USER_NLS_LANGは、製品のRuntimeコンポーネント用の言語を指定します。

DEVELOPER_NLS_LANGとUSER_NLS_LANGの構文は、NLS_LANGと同じです。

次のような状況の場合は、NLS_LANGを1つ使用するかわりに、上記の2つの変数を使用します。

•	Builderは英語で使用する必要があるが、アプリケーションを他言語用に開発している場合。

•	双方向キャラクタ・セットを使用する言語で実行するアプリケーションを作成している場合。

•	Builderの各国語バージョンが使用できない言語で実行するアプリケーションを作成している場合。

注意  これらの環境変数を個別に指定しないと、それぞれがNLS_LANGのデフォルト値を取ります。

NLS_LANGの詳細は、『Oracle8 Serverリファレンス・マニュアル』を参照してください。


NLS_LANG環境変数の設定

  例	  関連項目

NLS_LANG環境変数を設定するには:

  NLS_LANG環境変数の値を定義する方法は、使用しているオペレーティング・システムについて他の環境変数を定義する場合と同じです。パスの長さなど、プラットフォームに固有の規則に注意してください。

たとえば、Microsoft Windows NTについてNLS_LANGを設定するには、次の手順を実行します。

1	「スタート」メニューの「ファイル名を指定して実行」を選択します。

2	'regedit'と入力し、「OK」をクリックして、レジストリ・エディタをオープンします。

注意  Windowsのレジストリを変更すると、システムの動作に大きく影響します。環境変数の変更は、必要な場合にのみ行います。操作を誤った場合は、「キャンセル」をクリックし、再度実行します。

1	「HKEY_LOCAL_MACHINE」ノードを拡張し、次に「SOFTWARE」ノードを拡張します。

2	「ORACLE」をクリックし、レジストリ・エディタの右側のパネルにOracle環境変数を表示します。

3	NLS_LANG環境変数をダブルクリックします。

4	「値のデータ」テキスト・ボックスにNLS_LANGの新しい値を入力し、「OK」をクリックします。

注意  NLSの機能を使用する場合は、製品がNLSコンポーネントを特定できるように、少なくともNLS_LANGを設定する必要があります。


Windowsプラットフォームでのフォントのエイリアシング

  関連項目

特定のフォントを使用してアプリケーションを作成しても、実行すると別のフォントが使用されている場合があります。この問題は、多くの場合、西ヨーロッパ圏以外の言語環境で英語フォント（MS Sans SerifやArialなど）を使用すると発生します。この問題が起こる理由は、フォントに関連付けられているキャラクタ・セットと、言語環境変数によって指定されたキャラクタ・セットが一致しているかどうかが、Forms Developerによってチェックされるためです。2つのキャラクタ・セットが一致しない場合、Forms Developerでは、言語環境変数によって指定されているキャラクタ・セットと一致するキャラクタ・セットに関連付けしているフォントに自動的に置換します。この自動置換によって、データベースから返されるデータがアプリケーション内で正しく表示されます。

注意  英語フォントを使用して各国語の文字を入力した場合、Windowsでは他のフォントに暗黙的な関連付けを行います。

ただし、このような自動置換を行いたくない場合もあります。自動置換が行われないようにするには、希望するすべてのフォントを、フォント・エイリアス・ファイル内のWE8ISO8859P1キャラクタ・セットにマッピングします。たとえば、アプリケーション内でArialフォントを使用できないときは、フォント・エイリアス・ファイルに次の行を追加します。

Arial.....=Arial...WE8ISO8859P1


サポートされているMicrosoft Windowsのキャラクタ・セット

キャラクタ・セット名	説明
AR8MSWIN1256	MS Windowsコード・ページ1256、8ビット、ラテン語/アラビア語
BG8MSWIN	MS Windows 8ビット、キリル語（ブルガリア）
CL8MSWIN1251	MS Windowsコード・ページ1251、8ビット、ラテン語/キリル語
EE8MSWIN1250	MS Windowsコード・ページ1250、8ビット、東ヨーロッパ言語
EL8MSWIN1253	MS Windowsコード・ページ1253、8ビット、ラテン語/ギリシア語
ET8MSWIN923	MS Windowsコード・ページ923、8ビット、エストニア語
IW8MSWIN1255	MS Windowsコード・ページ1255、8ビット、ラテン語/ヘブライ語
JA16SJIS	Shift-JIS、16ビット、日本語
KO16KSC5601	KSC5601、16ビット、韓国語
LT8MSWIN921	MS Windowsコード・ページ921、8ビット、リトアニア語
TH8TISASCII	タイ工業規格620-2533 - ASCII、8ビット
WE8ISO8859P1	ISO 8859-1、西ヨーロッパ言語
ZHS16CGB231280	CGB2312-80、16ビット、簡体字中国語
ZHT16BIG5	BIG5、16ビット、繁体字中国語


サポートされているアラビア語の表示キャラクタ・セット

Id	キャラクタ・セット名	説明
61	AR8ASMO708PLUS	ASMO 708 Plus Client、8ビット、ラテン語/アラビア語
72	AR8XBASIC	EBCDIC XBASIC Client、8ビット、ラテン語/アラビア語
504	AR8NAFITHA711T	Nafitha Enhanced 711 Client、8ビット、ラテン語/アラビア語
505	AR8SAKHR707T	SAKHR 707 Client、8ビット、ラテン語/アラビア語
506	AR8MUSSAD768T	Mussa'd Alarabi/2 768 Client 8-bit ラテン語/アラビア語
507	AR8ADOS710T	Arabic MS-DOS 710 Client、8ビット、ラテン語/アラビア語
508	AR8ADOS720T	Arabic MS-DOS 720 Client、8ビット、ラテン語/アラビア語
509	AR8APTEC715T	APTEC 715 Client、8ビット、ラテン語/アラビア語
511	AR8NAFITHA721T	Nafitha International 721 Client、8ビット、ラテン語/アラビア語
514	AR8HPARABIC8T	HP ARABIC8 Client、8ビット、ラテン語/アラビア語
567	AR8ARABICMACT	Mac Client、8ビット、ラテン語/アラビア語


言語および地域の表記法規約

  関連項目

文字コード体系によって各言語に必要な個々の文字が使用できる一方で、各国語の表記法規約のサポートにより、ローカライズされたデータ項目が正しく表示されます。

指定の言語によって、次の要素についてデフォルトの表記法規約が決まります。

•	サーバー・メッセージの言語

•	曜日名、月名およびそれらの省略形（SQL関数TO_CHARとTO_DATEによって指定）の言語

•	AM、PM、ADおよびBCを表す記号

•	ORDER BYを指定したときのデフォルトのソート基準（ORDER BYが指定されない限り、GROUP BYではバイナリ・ソートが使用されます）。

•	文字表記の方向

•	肯定応答または否定応答の文字列

たとえば、言語にフランス語を設定すると、次のメッセージ

ORA-00942：表またはビューが存在しません
FRM-10043:ファイルをオープンできません。

は、次のように表示されます。

ORA-00942：table ou vue inexistante
FRM-10043:Ouverture de fichier impossible.

指定された地域によって、次のような日付および数値に関するデフォルトの書式設定が決まります。

•	日付書式

•	小数点記号と桁グループ・セパレータ

•	各国通貨記号

•	ISO通貨記号

•	週の開始日

•	貸し方および借り方の記号

•	ISO週フラグ

•	リスト・セパレータ

たとえば、地域にフランスを設定すると、カンマを小数点記号として使用して数値が書式設定されます。


サポートされている言語

省略形	言語
us	米語
ar	アラビア語
bn	ベンガル語
ptb	ポルトガル語（ブラジル）
bg	ブルガリア語
frc	フランス語（カナダ）
ca	カタロニア語
hr	クロアチア語
cs	チェコ語
dk	デンマーク語
nl	オランダ語
eg	エジプト語
gb	英語
et	エストニア語
sf	フィンランド語
f	フランス語
d	ドイツ語
din	ドイツ工業規格
el	ギリシア語
iw	ヘブライ語
hu	ハンガリー語
is	アイスランド語
in	インドネシア語
i	イタリア語
ja	日本語
ko	韓国語
esa	スペイン語（ラテン・アメリカ）
lv	ラトビア語
lt	リトアニア語
ms	マレー語
esm	スペイン語（メキシコ）
n	ノルウェー語
pl	ポーランド語
pt	ポルトガル語
ro	ルーマニア語
ru	ロシア語
zhs	簡体字中国語
sk	スロバキア語
sl	スロベニア語
e	スペイン語
s	スウェーデン語
th	タイ語
zht	繁体字中国語
tr	トルコ語
uk	ウクライナ語
vn	ベトナム語

注意  特定の言語がサポートされていても、その言語の翻訳が使用できるとは限りません。


サポートされている地域

アルジェリア	ギリシア	ポルトガル
アメリカ	香港	カタール
オーストリア	ハンガリー	ルーマニア
バーレーン	アイスランド	サウジ・アラビア
バングラデシュ	イラク	スロバキア
ブラジル	イスラエル	スロベニア
ブルガリア	イタリア	ソマリア
カナダ	日本	スペイン
カタロニア	ヨルダン	スーダン
中国	韓国	スウェーデン
CIS	クウェート	スイス
クロアチア	ラトビア	シリア
キプロス	レバノン	台湾
チェコ共和国	リビア	タイ
チェコスロバキア	リトアニア	オランダ
デンマーク	マレーシア	チュニジア
ジブティ	モーリタニア	トルコ
エジプト	メキシコ	ウクライナ
エストニア	モロッコ	アラブ首長国連邦
フィンランド	ノルウェー	イギリス
フランス	オマーン	ベトナム
ドイツ	ポーランド	イエメン


Forms Developerの双方向サポート

  関連項目

中東圏の言語および北アフリカ圏の言語についてのNLSサポートには、通常の文字表記方向が右から左である言語の双方向サポートが含まれます。

双方向サポートによって、開発者は次の事項を制御できるようになります。

•	レイアウト方向。右側にラベルがあり、チェックボックスおよびラジオ・ボタンが正しい位置に配置されている項目の表示を含みます。

•	読み方向。右から左または左から右のテキスト方向を含みます。

•	整列。原点の左上から右上への切替えを含みます。

•	初期キーボード状態。エンド・ユーザーがフォームへの入力を開始したときに、各国語文字またはローマ字が自動的に生成されるかどうかを制御します（エンド・ユーザーはこの設定を上書きできます）。

NLS_LANG環境変数に加え、双方向アプリケーションでは次の2つの環境変数を使用する場合があります。

•	DEVELOPER_NLS_LANG

•	USER_NLS_LANG

たとえば、Windows環境でアラビア語のアプリケーションを開発しているときに、米語のインタフェースを使用する場合は、これらの環境変数を次のように設定します。

DEVELOPER_NLS_LANG=AMERICAN_AMERICA.AR8MSWIN1256
USER_NLS_LANG=ARABIC_territory.charset


Form Builderの双方向サポート

  関連項目

双方向アプリケーションでのオブジェクトの外観を指定するには、「方向」、「文字位置」、「読込み順序」、「キーボード状態」および「初期キーボード状態」の5つのプロパティが使用されます。

「方向」は包括的なプロパティで、各オブジェクトについてできる限り多くの機能を提供します。テキスト項目と表示項目を除くすべてのオブジェクトについて、「方向」プロパティが唯一の双方向プロパティで、その設定によって双方向機能の他の局面が制御されます。（ただし、リスト項目には、「初期キーボード状態」と「キーボード状態」の各プロパティが含まれます。）

テキスト項目と表示項目には「方向」プロパティはありませんが、「文字位置」、「読込み順序」、「初期キーボード状態」および「キーボード状態」の各プロパティに限り、これらの項目について設定できます。

キーボード状態は1つの言語に制限できます。たとえば、「キーボード状態」に「ローカル」を設定すると、エンド・ユーザーはキーボードを他の言語に切り替えることができなくなります。

双方向プロパティに「デフォルト」を設定すると、これらのプロパティは、言語環境変数で指定された通常の文字表記方向の値を継承します。ほとんどの場合、これによって希望する機能は提供されます。継承されたデフォルト値を上書きしたいときは、双方向プロパティを指定するのみです。

双方向プロパティの継承は次のとおりです。

	デフォルト設定の値が導出されるオブジェクト
フォーム	言語環境変数
警告、ブロック、値リスト、ウィンドウおよびキャンバスビューなど、すべてのオブジェクト	フォーム
テキスト項目、表示項目、チェックボックス、ボタン、ラジオ・グループおよびリスト項目などのすべての項目	キャンバスビュー

双方向機能に関連する大部分のプロパティは、プログラムによって取り出し、設定できます。詳細は、適切なビルトイン・サブプログラムの説明を参照してください。たとえば、ボタンの「方向」プロパティの値を取得する方法の詳細は、GET_ITEM_PROPERTYの説明を参照してください。


Report Builderの双方向サポート

  関連項目

双方向アプリケーションでのオブジェクトの外観を指定するには、「位置揃え」、「方向」（オブジェクト用）および「方向」（レポート用）の3つのプロパティが使用されます。双方向プロパティは、次に示す階層でオブジェクトに追加されます。

モジュール

ボイラープレート

フィールド

外部ボイラープレート

ボタン

パラメータ・フォーム・ボイラープレート

このリストにないオブジェクトは、双方向サポートを必要としないか（イメージなど）、上記のいずれかのオブジェクト・プロパティからデフォルト値を継承します。


Forms DeveloperのUnicodeサポート

  関連項目

Unicodeは、1つのアプリケーションで多言語テキストを表示できるようにするグローバルなキャラクタ・セットです。これによって多国籍企業では、次に説明するように、1つの多言語アプリケーションを開発し、それを世界各国で実行できます。

グローバルな市場では、次のようなキャラクタ・セットが必要です。

•	すべての言語について製品の1つのインプリメンテーションで済み、さらに世界各国で簡単にインプリメントできること。

•	主要スクリプトをすべて含むこと。

•	多言語ユーザーおよび多言語組織をサポートします。

•	インターネットを使用して世界各国間でのデータ交換が可能であること。

Forms DeveloperではUnicodeをサポートしています。Unicodeを使用すると、西ヨーロッパ、東ヨーロッパおよび中東（双方向）などのシングルバイト言語や、中国語、日本語および韓国語（CJK）などマルチバイトのアジア言語といった複数の言語を、同一アプリケーションで表示できるようになります。

すべての言語を網羅する1つのキャラクタ・セットを使用することにより、さまざまな言語についてさまざまなキャラクタ・セットを用意する必要がなくなります。

たとえば、日本語などのマルチバイト言語を表示するには、NLS_LANG環境変数を次のように設定する必要があります（Windowsプラットフォームの場合）。

Japan_Japanese.JA16SJIS

ドイツ語などのシングルバイト言語を表示するには、NLS_LANGを次のように設定する必要があります（Windowsプラットフォームの場合）。

German_Germany.WE8ISO8859P1

この方式の明らかな短所は、アプリケーションで一度に表示できる文字が1つのキャラクタ・セットに限られることです。複数のキャラクタ・セットを組み合せた言語データは生成できません。

Unicodeキャラクタ・セットでは、NLS_LANGのキャラクタ・セット部分に、特定言語のキャラクタ・セットのかわりにUTF8を設定できます。これによって、異なる言語およびキャラクタ・セットの文字を同時に表示できます。

たとえば、画面上に日本語とドイツ語を同時に表示するには、NLS_LANGの変数を次のように設定する必要があります。

Japanese_Japan.UTF8

または

German_Germany.UTF8

Forms DeveloperのUnicode機能によって、アプリケーション開発者とエンド・ユーザーは、多言語テキストをフォーム内で表示できるようになります。これには、Unicodeを含むデータベースのテキスト、多言語テキスト、GUIオブジェクト内のテキスト（ボタン・ラベルなど）、キーボード入力されたテキストおよびクリップボードのテキストなども含まれます。Forms Developerでは現在、Windows NT 4.0とWindows 95/98（限定サポート）上でUnicodeをサポートしています。

注意  Web用にアプリケーションを開発する場合は、Unicodeを使用できます。これは、JavaによってUnicodeがサポートされているためです。


構成に関する考慮点

  関連項目

UNIXサーバーでは複数のORACLE_HOME(ORACLE_HOMEはOracleソフトウェアについてそれ自体によって作成されるディレクトリ）をサポートできるため、複数のNLS設定をサポートできます。つまり、1台のUNIXサーバーで複数の言語をサポートできます。

ただし、Windows NTでは、サポートできるORACLE_HOMEは1つに限られるため、サポートできるNLS設定も1つのみです。つまり、Windows NTでサポートできる言語は1つのみです。


Unicodeフォントのサポート

  関連項目

Unicodeの多言語テキストを表示するには、絵文字または表示される言語の文字を含むフォントを使用する必要があります。Windows NT、Windows 95およびWindows 98の場合、Microsoft社によって提供されるTrueTypeの'Big Fonts'か、サード・パーティーのUnicodeフォントを使用する必要があります。多言語テキストを入力、表示または印刷して、予期しない文字が表示された場合は、Big Fontを使用していない可能性があります。Microsoft社がNT 4.0で提供しているBig Fontは次のとおりです。

•	Arial

•	Courier New

•	Lucida Console

•	Lucida Sans Unicode

•	Times New Roman

WindowsのBig Fontで表示要件が満たされない場合は、サード・パーティーのフォントを使用します。


Unicodeサポートの有効化

  関連項目

Forms DeveloperでUnicodeサポートを有効にするには、NLS_LANGを次のように設定します。

NLS_LANG=language_territory.UTF8


キャラクタ・セット間の変換

  関連項目

複数の言語で使用するアプリケーションの設計を始めるとき、アプリケーションのエンド・ユーザーによって使用されるキャラクタ・セットと、アプリケーション開発者によって使用されるキャラクタ・セットの両方を考慮する必要があります。実行時におけるキャラクタ・セット・レベルでの変換は自動ですが、この変換によってパフォーマンスは影響を受けます。

たとえば、1つのキャラクタ・セットでアプリケーションを構築し、別のキャラクタ・セットで実行すると、パフォーマンスの低下が見られる場合があります。また、特定の文字と同等の文字がキャラクタ・セットに含まれていない場合、クエスチョン・マーク（?）などの代替文字が表示されます。ただし、目に見える違いがわからない場合でも、パフォーマンスの問題があるため、言語の生成に使用するキャラクタ・セットには開発者として十分な注意を払う必要があります。

注意  Forms Developerでは、AR8MSWINとAR8ISOまたはIW8MSWINとIW8ISOなど、同一言語のキャラクタ・セット間の変換のみを行います。

複数の言語または同一言語でも異なるキャラクタ・セットで実行するアプリケーションを設計する場合、最適なパフォーマンスを実現するため、生成する環境を実行時環境に合せる必要があります。たとえば、次の作業を行います。

•	実行時に最も幅広く使用されるキャラクタ・セットを判断します。

•	言語環境変数をそのキャラクタ・セットに設定して環境を生成します。

注意  Form Builderの場合、生成時に使用されるキャラクタ・セットは、実行時環境でキャラクタ・セットを指定した場合でも、実行時に使用されます。


Forms Developerユーザー・インタフェース

  関連項目

Oracleではソフトウェアの多言語化で1つの実行可能なアプローチを使用します。つまり、シングルバイトのヨーロッパ言語やマルチバイトのアジア言語を処理するために、別の実行可能ファイル（f60des.exeなど）が不要になることを意味します。同一のツール・セットを使用して、英語および英語以外のアプリケーションを作成できます。

注意  Forms Developerでは、異なる言語のフォントおよび入力方式について、Microsoft社のWindowsオペレーティング・システムに依存しています。任意の言語でテキストを入力および表示するには、その言語をサポートするWindowsのバージョンを実行している必要があります（タイ語を表示するには、Thai語のWindowsを実行している必要があります）。

Forms Developerのインストール時に、インストールするメッセージ・ファイルの言語を選択します。Forms Developerのコンポーネント（Form Builderなど）を使用すると、言語環境変数に基づく適切なメッセージ・ファイルを使用してインタフェースが表示されます。たとえば、次のインタフェース要素が含まれます。

•	メッセージ

•	メニューとメニュー項目

•	ダイアログ・ボックス

•	プロンプトとヒント

•	警告

現行の言語設定に対応するメッセージ・ファイルがForms Developerによって検索されない場合、デフォルトで米語のメッセージ・ファイルが設定されます。

注意  メッセージ・ファイルのインストール時に指定できる言語は、米語の他に1つのみです。Forms Developerを別の言語で使用する必要が生じた場合は、適切なメッセージ・ファイルを使用してForms Developerを再インストールする必要があります。

メッセージ・ファイル名によって、Forms Developerコンポーネントと言語が指定されます。その場合、次のようなファイル命名規則が使用されます。

<product_id><language_id>.MSB

たとえば、Form Builderの場合を次に示します。

FMDUS.MSBには、デフォルト（米語）のBuilderメッセージが含まれます。

FMGUS.MSBには、デフォルト（米語）のGenerateメッセージが含まれます。

FMFUS.MSBには、デフォルト（米語）のRunformメッセージが含まれます。

FMFI.MSBには、イタリア語のRunformメッセージが含まれます。

FMFD.MSBには、ドイツ語のRunformメッセージが含まれます。

言語に依存するメッセージ・ファイルのインストールの詳細は、使用しているプラットフォーム用インストレーション・ガイドおよびユーザーズ・ガイドを参照してください。

注意  言語用の補足製品には上位互換性がありません。それらの製品は、共にリリースされたバージョンのForms Developerとのみ動作するように提供されています。以前のリリースの言語用の補足製品がすでにインストールされている場合は、システムから削除する必要があります。


CONVERTを使用したデータ変換

SQL関数CONVERTを使用すると、キャラクタ・セット間でデータを変換できます。この関数は、1つのキャラクタ・セットでの文字列のバイナリ表現を、別のキャラクタ・セットのバイナリ表現に変換します。変換の詳細は、「キャラクタ・セット間の変換」を参照してください。

CONVERTの詳細は、『Oracle8 Serverリファレンス・マニュアル』を参照してください。


デフォルトの書式マスク

  例	  関連項目

言語環境変数によって、Forms Developerインタフェース（BuilderとRuntime）で使用される言語のみでなく、データの表示に使用される一連のデフォルト書式マスクも定義されます。ただし、明示的な書式マスクによってデフォルトが上書きされない場合に限ります。アプリケーション開発者としてデフォルトの表示マスクを上書きする場合は、NLS関連の追加の書式マスクも使用できます。

Forms Developerまたはアプリケーションに入力されるすべてのデータでは、特定の地域に関連付けられたデフォルトの書式マスクが使用されます。そのため、アプリケーションの構築時および実行時に言語を変更でき、日付および数値の書式を変える必要はありません。

Forms Developerでは、次の場合に限りデフォルトの書式マスクを使用します。

•	Builderの使用時: Builderによって、項目、範囲またはパラメータのデフォルト値が表示される場合

•	実行時： ユーザーが、DATEやNUMBERなど、地域固有の型を持つテキスト項目に対してデータを入力する場合

多言語アプリケーションの日付フィールドおよび通貨フィールドについて作業するときは、次の点を考慮する必要があります。

•	表示されるすべての項目（ボイラープレート、テキスト項目、ボタンなどのインタフェース・オブジェクトおよび値リスト）の長さを増やして、テキストの翻訳、および各国語固有の表記法規約に基づく形式で数値を表示できるようにするかどうか。

•	特別な書式マスクを作成するために、NLS関連の書式マスク文字を使用する必要があるかどうか、またはNLS_LANGによって起動されるデフォルトの書式マスクで十分かどうか。


ヒント
暗黙的な型変換の場合、PL/SQLでは常にデフォルトの米語書式（DD-MON-YYなど）が使用されるため、地域固有の型を持つ項目をPL/SQLで使用する場合は、正しい書式マスクを指定する必要があります。PL/SQLで地域固有の項目を翻訳する場合、オラクル社では次に示すとおり、TO_DATEを使用することをお薦めします。

IF :emp.hiredate < TO_DATE('30-12-1996','DD-MM-YYYY') THEN
   ...


書式マスク文字

  例	  関連項目

次の書式マスク文字を使用すると、デフォルトの書式マスクを上書きできます。

日付の書式マスク文字

文字	戻り値
D	日の桁（1～7）
DY	曜日の名前（省略形）
DAY	曜日の名前（空白埋めによって9文字分の長さにされます）
WW	週の桁。アルゴリズムint((day-jan1)/7)によって計算されます。
IW	ISO週の桁
MON	月の名前（省略形）
MONTH	月の名前（空白埋めによって9文字分の長さにされます）
RM	ローマ数字による月の文字
I,IY,IYY,IYYYY	先頭から順に、ISO年の最後の1桁、2桁、3桁およびISO年
BC,AD,B.C.,A.D.	BCまたはADの記号（ピリオド付きとピリオドなし）
AM,PM,A.M.,P.M.	AMまたはPMの記号（ピリオド付きとピリオドなし）
ISOとその日付書式マスクの詳細は、『Oracle Server SQLリファレンス』を参照してください。

数値の書式マスク文字

文字	戻り値
C	国際通貨記号
L	各国通貨記号
D	小数点セパレータ
G	桁グループ（3桁）セパレータ


文字データのソート

  制約	  例	  関連項目

従来から文字データをソートするときは、文字コード体系によって定義される文字の数値に基づいてソート基準が決定されます。このようなソートはバイナリ・ソートと呼ばれ、英語アルファベットについて順序どおりの結果を生みます。これは、ASCII標準およびEBCDIC標準では、AからZまでの文字が昇順の数値で定義されるためです。注意

ただし、他の言語で使用される文字が含まれている場合、バイナリ・ソートでは順序どおりの結果は生まれません。たとえば、昇順のORDER BY問合せによって、文字列ABC、ABZ、BCDおよびﾄBCがこの順序で返されます。文字コード体系では、ﾄはBよりも高い数値を持ちます。

特定の言語について文字のアルファベット順に一致するソート基準を生成するには、文字コード体系の数値を考慮せずに文字をソートする、別のソート手法を使用する必要があります。このような手法は言語ソートと呼ばれます。言語ソートは、バイナリ・ソートで希望の結果が返されるように、文字本来の言語順序を反映する他のバイナリ値と文字を置き換えることによって動作します。

言語上の特殊ケース  言語上の特殊ケースとは、ソート時に1つの文字として扱う必要のある文字順序です。そのような特殊ケースは、言語ソートを使用すると自動的に処理されます。たとえば、スペイン語の言語ソート基準では、2文字のchとllは、cとdの間およびlとmの間にそれぞれ来るとき1つの文字としてソートされることが指定されます。

もう1つの例としてドイツ語のシャープs（ﾟ）があります。ドイツ語の言語ソート基準では、この順序が2文字のSSとしてソートされ、米語の言語ソート基準ではSZとしてソートされます。

このような特殊ケースは、大文字を小文字にまたは小文字を大文字に変換するときにも処理されます。たとえば、ドイツ語でシャープsの大文字は2文字のSSです。このような大/小文字変換の問題は、言語ソート基準によって定義された規則に従って、NLS_UPPER、NLS_LOWERおよびNLS_INITCAPの各関数によって処理されます。（標準関数のUPPER、LOWERおよびINITCAPではこれらの特殊ケースは処理されません。

NLSSORT関数  SQL関数NLSSORTを使用して、文字データをソートできます。この関数は、ソート機構で使用される同等のソート文字列によって文字列を置き換えます。バイナリ・ソートの場合、ソート文字列は入力文字列と同じです。言語ソートが使用されている場合、NLSSORTは元の文字列を置き換えるために使用されたバイナリ値を返します。


注意
ASCII標準では、すべての大文字は小文字の前に表示されます。EBCDIC標準ではそれとは反対に、すべての小文字は大文字の前に表示されます。


言語ソートの制約

  関連項目

言語ソートは、マルチバイト・キャラクタ・セットでサポートされていません。


WHERE句に含まれる文字列の比較

  例	  関連項目

WHERE句に含まれる文字列は、文字のバイナリ値を使用して比較されます。データベース・キャラクタ・セットにおいてより高いバイナリ値を持つ文字は、より低いバイナリ値を持つ文字より'大きい'と言えます。データベース・キャラクタ・セットにおいてより高いバイナリ値を持つ文字は、より低いバイナリ値を持つ文字より'大きい'と言えます。バイナリ値に基づく文字順序は、その言語のアルファベット順と一致しない場合があるため、アルファベット規則に従った比較はあまり行われません。バイナリ・ソートのかわりに言語ソートを実行するには、NLSSORT関数を使用します。


ORDER BY句の制御

  関連項目

言語ソートの順序が使用されている場合、NLSSORTはORDER BY句の各文字項目について暗黙的に使用されます。その結果、ORDER BYについて使用されるソート機構（言語またはバイナリ）は、アプリケーションにとって透明です。

ただし、ORDER BY項目の文字項目についてNLSSORT関数が明示的に指定された場合、暗黙的なNLSSORTは実行されません。つまり、NLSSORTの言語置換は1度のみ適用され、2度目からは適用されません。

デフォルトのソート機構が言語ソートの場合、NLSSORT関数は通常、ORDER BY句では必要ありません。ただし、デフォルトのソート機構がバイナリの場合、次のような問合せでバイナリ・ソートが使用されます。

SELECT ENAME FROM EMP

ORDER BY ENAME

は、バイナリ・ソートを使用します。言語ソートは（次の例に示すドイツ語の場合）、次の構文を使用して取得できます。

SELECT ENAME FROM EMP

ORDER BY NLSSORT(ENAME, 'NLS_SORT = GERMAN')


ALTER SESSIONの使用

  例	  関連項目

NLSデフォルトを上書きするには、ALTER SESSION SQLコマンドを使用できます。たとえば、一部のパラメータ（languageやterritoryなど）を作成し、ユーザーがその値を指定すると仮定します。すると、ユーザーが指定したとおりにセッションを変更できます。

注意  実行時に、サーバーは、NLS_LANGで指定された値に基づいてクライアントのためにALTER SESSIONコマンドを実行します。NLS_LANGが定義されていないと、ALTER SESSION文は実行されません。

Form Builderでは、ALTER SESSIONコマンドについて次のNLSパラメータを指定できます。ただし、Report BuilderとGraphics Builderの場合は、NLS_SORTパラメータしか指定できません。

パラメータ	説明
NLS_LANGUAGE	メッセージおよびエラーを返すためにサーバーによって使用される言語
NLS_TERRITORY	デフォルトの日付マスクおよび通貨マスク用の地域
NLS_DATE_FORMAT	日付用のデフォルト書式
NLS_DATE_LANGUAGE	日付用のデフォルト言語
NLS_NUMERIC_CHARACTERS	小数点記号および桁グループ・セパレータ
NLS_ISO_CURRENCY	ISO国際通貨記号
NLS_CURRENCY	各国通貨記号
NLS_SORT	文字ソート基準
NLS_CALENDAR	現行のカレンダー・システム

これらのパラメータの詳細は、『Oracle8 SQL リファレンス』マニュアルを参照してください。


SQL関数でのNLSパラメータの使用

  関連項目

SQLを使用する場合は常に、次のNLSパラメータを使用してデフォルトのNLS動作を上書きできます。

SQL関数	NLSパラメータ
TO_DATE	NLS_DATE_LANGUAGE NLS_CALENDAR
TO_NUMBER	NLS_NUMERIC_CHARACTERS NLS_CURRENCY NLS_ISO_CURRENCY
TO_CHAR	NLS_DATE_LANGUAGE NLS_NUMERIC_CHARACTERS NLS_CURRENCY NLS_ISO_CURRENCY NLS_CALENDAR
NLS_UPPER	NLS_SORT
NLS_LOWER	NLS_SORT
NLS_INITCAP	NLS_SORT
NLSSORT	NLS_SORT

これらのパラメータの詳細は、『Oracle8 SQLリファレンス』マニュアルを参照してください。


Form BuilderのNLSパラメータ

  関連項目

PL/SQLコードで使用されるNLS環境変数の現行値を取得するには、Form Builderのビルトイン関数を使用できます。

	DEVELOPER_NLS_LANG	USER_NLS_LANG
ビルトイン	GET_FORM_PROPERTY	GET_APPLICATION_PROPERTY
パラメータ	MODULE_NLS_LANG	USER_NLS_LANG

USER_NLS_LANGとDEVELOPER_NLS_LANGはどちらもNLS_LANGの値にデフォルトで設定されるため、どちらかの変数が設定されない場合、Form BuilderのNLSパラメータはNLS_LANGの値を持ちます。

Form BuilderのNLSパラメータはどちらも4つのバリエーションがあり、環境変数のすべてまたは特定部分のみを取り出せます。次の表に、USER_NLS_LANG環境変数を返すGET_APPLICATION_PROPERTYビルトインの4つのパラメータを示します。

パラメータ	戻り値
USER_NLS_LANG	すべてのUSER_NLS_LANG変数
USER_NLS_LANGUAGE	言語部分のみ
USER_NLS_TERRITORY	地域部分のみ
USER_NLS_CHARACTER_SET	キャラクタ・セット部分のみ

DEVELOPER_NLS_LANG環境変数を取り出すには、MODULE_NLS_LANGパラメータを使用してGET_FORM_PROPERTYをコールします。


プリンタ定義ファイルと各国語サポート

  関連項目

レポートを文字モードで使用する場合、レポートの物理ページ幅を、プリンタ定義ファイル（.PRTファイル)で定義されたページ幅より1文字分少なくして定義する必要があります。そのように定義しなかった場合、マルチバイト文字は行の最後の文字スペースから印刷され、すべてを印刷するために次の行に渡る場合があります。たとえば、物理ページ幅が80文字で、プリンタ定義の幅も80文字の場合、マルチバイト文字は80番目の文字から印刷される場合があります。マルチバイト文字は分割できないため、マルチバイト文字をすべて印刷するために81番目の文字を次の行に渡す必要があります。これを回避するため、物理ページ幅はレポートについて79に設定する必要があります。

次に示すアラビア語およびヘブライ語に固有のNLSパラメータは、プリンタ定義ファイルで設定できます。

使用するパラメータ	目的	パラメータの値
nls locale	印刷エンジンの地域を設定する。	hebrewまたはarabic
nls datastorageorder	論理データ格納または可視データ格納を設定する。	logicalまたはvisual
nls contextuallayout	アラビア語プリンタについて、事前の文脈依存レイアウトを実行する。	noまたはyes
nls contextualshaping	アラビア語プリンタについて、事前の文脈依存形状を実行する。	noまたはyes
nls pcharset	プリンタのキャラクタ・セットを指定する。	任意のキャラクタ・セット

プリンタ定義ファイルの詳細は、Report Builderのヘルプ・システムを参照してください。


アプリケーションの翻訳

  関連項目

すべてのエラー・メッセージとボイラープレート・テキストは、同じ言語で表記される必要があります。アプリケーションの実行時、エンド・ユーザーに対して表示されるメッセージまたはボイラープレート・テキストのソースには、次の3つがあります。

•	サーバーからのエラー・メッセージ

•	Forms Developerによって生成される実行時エラー・メッセージ

•	アプリケーションの一部として定義されるメッセージまたはボイラープレート・テキスト

OracleのNLSでは、最初の2つのソースの翻訳を処理します。アプリケーション開発者は、3つ目のソースであるメッセージおよびボイラープレート・テキストを翻訳する必要があります。

通常、翻訳する必要のあるアプリケーション固有のテキストには、次の2つのタイプがあります。

•	メニュー、ボイラープレート・テキスト、項目ラベル、メッセージおよびヒントなど、翻訳可能なテキスト

•	トリガー内で定義された警告およびメッセージを含む、トリガーおよびプロシージャ内の文字列

Translation Builderを使用することによって、ユーザー・インタフェース内の'翻訳可能テキスト'を、複数の言語に翻訳できます。Translation Builderを使用すると、各言語について個別のバイナリ・ファイルを生成することにより、ほとんどすべてのForms Developer多言語アプリケーションを翻訳できるようになります。

Translation Builderではユーザー・インタフェース内の文字列を検索および翻訳できますが、PL/SQLトリガーおよびプロシージャ内の文字列定数を取り出すことはできません。PL/SQLブロック内の定数テキストについては、手動で翻訳する必要があります。これは、テキストが明確に区切られておらず、多くの場合、変数や文字列から構築されているためです。

Translation Builderの詳細は、Translation Builderのヘルプ・システムを参照してください。


設計に関する考慮点

  関連項目

後で翻訳されるアプリケーションを設計する場合、ウィジェットおよびボイラープレート・ラベル用に、追加スペースを残しておくことに注意します。複数のキャラクタ・セットに対応し、翻訳によるスペースの拡張に対処するには、フィールド、境界線およびボイラープレート・テキストの周辺に、30パーセントの空白を残しておくことをお薦めします。

次に例を示します。

フィールド左側のプロンプト	拡張に備えてプロンプトの左側に30パーセントの余白を残す。
フィールドの上のプロンプト	拡張に備えてプロンプトの右側に30パーセントの余白を残す。
ボタン、チェックボックス、ラジオ・グループおよびポップリスト	30パーセントの拡張を考慮する。
タイトル	タイトルを右に30パーセント拡張できるように、バウンディング・ボックスをサイズ設定する。
表示のみのフィールド	基本言語で必要となるサイズより30パーセント広くサイズ設定する。
すべてのウィジェット	すべての翻訳が表示されるように、ウィジェットのサイズを十分に大きくする。たとえば、ボタンは翻訳されたラベルを表示できるだけの大きさが必要です。 使用する必要のある文字で最も高さのある文字が表示できるように、ボタンの長さだけでなく高さもチェックします。たとえば、漢字の表示に必要なピクセル数を計算します。


Translation Builderアプローチの使用

  関連項目

Translation Builderを使用すると、ほとんどすべてのForms Developer多言語アプリケーションを翻訳できます。アプリケーション側でエンド・ユーザーが実行時に言語を切り替える必要がない限り、Translation Builderを使用して、各言語について個別のバイナリ・ファイルを生成できます。

実行時に1つの言語から別の言語に変更する場合、ユーザーはアプリケーションを終了し、言語環境変数を変更します。次に、アプリケーションを再起動します。

Translation Builderアプローチでは、次の段階に従ってアプリケーションを開発します。

•	ソース言語で1つの基本的なアプリケーション定義を作成します（.FMBや.RDFなど）。

•	Translation Builderを使用して、翻訳する文字列を抽出します。次に、文字列を再度アプリケーション定義内に格納します。

•	PL/SQLライブラリの標準メッセージを手動で翻訳します。

•	Generatorを使用して、各ターゲット言語についてアプリケーションのバイナリ・バージョンを生成します。

メリット  上記の方法は、複数言語のアプリケーションを短時間でインプリメントする最も簡単な方法です。このアプローチを使用すると、最も効率よくTranslation Builderを使用できます。動作が安定しているアプリケーションであれば、このアプローチが最適です。

たとえば、4つの言語でアプリケーションを作成し、後でフィールド・ラベルのテキストを変更する必要が生じた場合は、Builder内で変更を行い、定義ファイルに変更を保存します。次に、Translation Builderを使用して新しいフィールド・ラベルを翻訳し、新しいメッセージを定義ファイルに挿入し、再生成して、新しいラベルを含んだバイナリ・ファイルを作成します。

デメリット  アプリケーションで複数の言語を同時にサポートする必要がある場合、かわりに実行時言語切替えアプローチを使用する必要があります。


実行時言語切替えアプローチの使用

  関連項目

アプリケーションの中には、複数の言語を同時にサポートする必要のあるものが少数ながらあります。たとえば、ウィンドウに英語を表示して起動するアプリケーションは終了するまでその状態である必要がありますが、エンド・ユーザーがそのウィンドウ内のボタンを押すことによってプロンプトをフランス語に切り替えたり、また英語に戻したりする場合があります。

アプリケーションで実行時の言語切替えが必要な場合、言語が同じキャラクタ・セットを共有する限り、複数の言語を組み込むことができますが、実行時にテキストを動的に生成している場合は、Translation Builderを使用して翻訳可能なテキストを特定することはできません。そのかわり、case構造（IF...THEN...ELSIF）を構築し、GET_FORM_PROPERTYを使用してNLS環境変数の値をチェックすることによって、アプリケーションの言語を別の言語に変更できます。

実行時言語切替えアプローチでは、次の段階に従ってアプリケーションを開発します。

•	ライブラリも含めて、アプリケーション全体を1つの言語について開発します。

•	各ライブラリを手動で翻訳します。

•	ボイラープレート・ラベルを、実行時に動的に生成される、適切にサイズ設定された表示項目として設計します。

Form Builderでは複数のライブラリを連結できるため、翻訳されるメッセージについて1つのライブラリを使用し、他のライブラリを他の用途に利用できます。

メリット  このアプローチの主なメリットは、フォームが高度に動的になる洗練されたアプリケーションをサポートできることです。フォームが高度に動的になるケースでは、フォームが変わるたびに各言語について個別のファイルを生成する必要がないため、このアプローチによってメンテナンスに関する一部の問題が回避されます。

デメリット  このアプローチは、他のアプローチより複雑です。言語に固有なメッセージの格納、生成およびそのためのメンテナンスを行ったり、手動で翻訳を実行したりするために非常に多くの作業が発生するためです。たとえば、各ボタンにラベルを設定するために、WHEN-NEW-FORM-INSTANCEトリガーを設定し、NLS環境変数の値に基づいて、連結ライブラリから正しいラベルを読み込みます。


コード内文字列についてのPL/SQLライブラリの使用

  例	  関連項目

Translation Builderでは標準のBuilderインタフェースの一部であるメッセージを翻訳できますが、プログラムによって表示されるメッセージでは特別な処理が必要です。PL/SQLライブラリを使用すると、メッセージについて柔軟なメッセージ構造をトリガーまたはプロシージャ内でインプリメントできます。

ビルトイン・ルーチンMESSAGEまたはCHANGE_ALERT_MESSAGEFを使用して画面にプログラムによって表示されるメッセージや、トリガーまたはプロシージャの表示項目にメッセージを割り当てることによって表示されるメッセージなど、アプリケーション固有のメッセージの場合、連結可能なPL/SQLライブラリを使用して、柔軟なメッセージ機能をインプリメントできます。ライブラリはホスト上に格納し、実行時に動的に連結できます。実行時には検索パスに基づいて、フォームに連結されたライブラリを読み込むことができます。（たとえば、ライブラリはイタリア語のメッセージのみを保有している場合があります。）


各国語サポートの例

  関連項目 	  すべての例

文字列比較の例

書式マスクの例

NLS_LANGの例

PL/SQLライブラリの例


ALTER SESSIONの例

  関連項目

次の文は、小数点記号をカンマに、桁グループ・セパレータをピリオドに変更します。

ALTER SESSION
   SET NLS_NUMERIC_CHARACTERS = ',.'

これらの新しい文字は、それらの数値書式要素DとGを使用すると返されます。

SELECT TO_CHAR(SUM(sal), 'L999G999D99') Total FROM emp

TOTAL
--------------
   FF29.025,00

次の文は、ISO通貨記号を、地域がアメリカの場合のISO通貨記号に変更します。

ALTER SESSION
   SET NLS_ISO_CURRENCY = America

アメリカについて定義されたISO通貨記号が使用されます。

SELECT TO_CHAR(SUM(sal), 'C999G999D99') Total FROM emp

TOTAL
---------------
   USD29.025,00

次の文は、各国通貨記号をDMに変更します。

ALTER SESSION
   NLS_CURRENCY = 'DM'

新しい各国通貨記号は、数値書式要素Lを使用すると返されます。

SELECT TO_CHAR(SUM(sal), 'L999G999D99') Total FROM emp

TOTAL
--------------
   DM29.025,00


文字列比較の例

  関連項目 	  すべての例

ISO 8859/1 8ビット・キャラクタ・セットでABC、ABZ、BCDおよびﾄBCの値を含む列（COL1）があると仮定します。また、次の問合せを作成したと仮定します。

SELECT COL1 FROM TAB1 WHERE COL1 > 'B'

ﾄはBよりも高い数値を持つため、この問合せではBCDとﾄBCが返されます。

次に示すとおり、WHERE句でNLSSORTを使用して、言語比較を実行できます。

WHERE NLSSORT(column) operator NLSSORT(string)

NLSSORTを比較演算子の両側で使用する必要があることに注意してください。

SELECT COL1 FROM TAB1 WHERE NLSSORT(COL1) > NLSSORT('B')

ドイツ語の言語ソートが使用されている場合、ドイツ語アルファベットでﾄはBの後に来るため、この問合せではﾄで始める文字列は返されません。スウェーデン語の言語ソートが使用されている場合、スウェーデン語アルファベットでﾄはZの後に来るため、ﾄで始める文字列が返されます。


書式マスクの例

  関連項目 	  すべての例

NLS準拠のアプリケーションの場合、月名を含む文字列はハードコードしないようにします。ただし、ハードコードされた月名が必要な場合は、COPYビルトインを使用しないようにします。COPYを使用すると、指定する言語によっては、月名が正しく設定されなくなる場合があります。（ライブラリで日付を指定するには、日付の変数を使用すると、COPYは正常に動作します。

言語に依存する例（お薦めできません）

:emp.hiredate := '30-DEC-96';

copy ('30-DEC-96','emp.hiredate');

上記の代わりに、次の例に示すTO_DATEを使用します。

言語に依存しない例（お薦めします）

:emp.hiredate := to_date('30-12-1996','DD-MM-YYYY');


NLS_LANGの例

  関連項目 	  すべての例

アプリケーションをフランス語で実行すると仮定します。アプリケーションはフランスで使用されますが、データはWE8ISO8895P1キャラクタ・セットを使用して表示されます。NLS_LANGを次のように設定する必要があります。

NLS_LANG=French_France.WE8ISO8895P1

ここで、アプリケーションはまだフランス語で実行するものの、今度はスイスで使用すると仮定します。NLS_LANGを次のように設定する必要があります。

NLS_LANG=French_Switzerland.WE8ISO8895P1

その他の例

NLS_LANG=Norwegian_Norway.NDK7DEC
NLS_LANG=Norwegian_Norway.WE8ISO8895P1
NLS_LANG=Japanese_Japan.JA16SJIS
NLS_LANG=Arabic_Egypt.AR8MSWIN1256
NLS_LANG=American_America.AR8MSWIN1256
NLS_LANG=American_America.WE8ISO8859P1


PL/SQLライブラリの例

  関連項目 	  すべての例

FUNCTION nls_appl_mesg(index_no NUMBER)

RETURN CHAR

IS

msg CHAR(80);

BEGIN

IF index_no = 1001 THEN

msg := 'L''impiegato che Voi cercate non esiste...';

ELSIF index_no = 1002 THEN

msg := 'Lo stipendio non puo essere minore di zero.';

ELSIF ...

   :

ELSE

msg := 'ERRORE:Indice messaggio inesistente.';

END IF;

RETURN msg;

END;

このようなルーチンは、一般的に文字式が有効な場所ではどこでも使用できます。たとえば、適切に翻訳されたアプリケーション・メッセージを使用して警告を表示するために、フォームに次のコードを組み込む場合があります。

Change_Alert_Message('My_Error_Alert', nls_appl_mesg(1001));

n := Show_Alert('My_Error_Alert');

アプリケーションを別の言語に変更するには、nls_appl_mesg関数を含むPL/SQLライブラリを、テキストの翻訳された、nls_appl_mesg関数を含む同名のライブラリに置き換えるのみです。

アプリケーションで複数の言語を同時にサポートする必要がある場合は、上記の関数で希望の言語を示す追加パラメータを受け入れることができ、コードにはさまざまな言語を処理するための追加レベルのIF...THEN...ELSIF...ELSE...ENDが組み込まれます。


ヘルプの項目がありません。オンライン･ヘルプのキーワードで関連項目を確認してください。


Oracle8オブジェクトの例

  関連項目 	   すべての例

オブジェクト・タイプ

表タイプ

可変配列タイプ

列オブジェクト

オブジェクト表

オブジェクト・ビュー


Oracle8 Serverのサポート

  関連項目

Oracle8 Serverではさまざまな新機能を使用できます。一般に、機能は、次のようなカテゴリに分けられます。

•	拡張性の向上。たとえば、Oracle8データベースには数十TBのデータを格納できます。また、最大10000ユーザーの同時アクセスがサポートされています。表には、最大1000列を含めることができます。CHARデータ型とVARCHAR2データ型は、それぞれ最大2000バイトと4000バイトまで可能です。

•	パフォーマンスと効率の向上。これらのOracle8の機能を使用することによって必要となるユーザ操作はありません。Oracle8 Serverにデータを格納する速度と信頼性の利点が自動的に得られます。

•	ラージ・オブジェクト（LOB）

•	ユーザー定義オブジェクト

Oracle7の継続サポート

Oracle7 Serverの機能もサポートされています（リリース7.3.4以降）。


サポートされているOracle8データ型

  関連項目

このリリースでは、以下のOracle8データ型を引き続きサポートしています。

ラージ・オブジェクト（LOB）

Oracle8では、プログラマは、ラージ・オブジェクト（LOB）を定義できます。ラージ・オブジェクトには、テキスト、イメージ、サウンド、ビデオなどを格納できます。

このリリースでは、次のOracle8ラージ・オブジェクトのデータ型がサポートされています。

•	BLOB（バイナリ・ラージ・オブジェクト）

•	CLOB（シングルバイト・キャラクタ・ラージ・オブジェクト）

•	BFILE（バイナリ・ファイルまたは外部ファイル）

ユーザー定義のオブジェクト

Oracle8では、プログラマはオブジェクト・タイプ（ユーザー定義タイプとも呼ぶ）を定義できます。 オブジェクト・タイプは、Oracle8によってサポートされる既存の単一要素のデータ型に基づく複合要素です。これらのオブジェクト定義を使用して、プログラマは、さまざまな種類の表を作成できます。

現在サポートされているOracle8オブジェクトは、次のとおりです。

•	オブジェクト表。この場合、表全体が1つのオブジェクト・タイプに基づいています。

•	リレーショナル表内の列オブジェクト。この場合、列がオブジェクト・タイプに基づいています。

•	オブジェクト表またはリレーショナル表内のREF列。この場合、列の値が他のオブジェクト表内の行へのポインタとなっています。

新しいスカラー・データ型

このリリースでは、新しいOracle8 FLOATデータ型もサポートされています。このデータ型をそれ自身のNUMBERデータ型にマップします。


Oracle8ラージ・オブジェクト（LOB）について

バイナリ・ラージ・オブジェクト（BLOB）、キャラクタ・ラージ・オブジェクト（CLOBとNCLOB）およびバイナリ・ファイル（BFILE）などのOracle8ラージ・オブジェクト・データ型にアクセスできます。

Oracle8サーバーでは、これらのデータ型は、サイズが4GBまでのオブジェクトを格納できます。Oracle7のLONGデータ型およびLONG RAWデータ型の用途と似ていますが、さらにさまざまな利点が提供されます。

LOBとLONGの比較

LOB	LONG
4GBまで	2GBまで
1つの表につき複数のLOB列	1つの表につき1つのLONG列
レプリケーション可能	レプリケーションなし
ランダム・データ・アクセスが可能	シーケンシャル・アクセスのみ可能
優れた表領域管理（LOBロケータのみを格納）	LOBと比べて効率性に欠ける（表に直接データが格納される）
ユーザー定義のオブジェクト・タイプが使用可能	ユーザー定義のオブジェクト・タイプが使用不可能
プロシージャおよび外部コールに簡単に渡せる	プロシージャおよび外部コールに簡単に渡せない
LOBの詳細

BLOBは、ラージ・オブジェクトをバイナリ形式で格納するときに使用します。CLOBは、文字データを格納するときに使用します。これら2つのタイプは、データがサーバー内に格納されるため、内部LOBとも呼ばれます。データは、コミットとロールバックを含め、トランザクションおよび整合性制御で使用されます。

BFILEは対照的に、サーバーの外に格納されます。サーバーでは、ファイルのオペレーティング・システム・アドレスのみが格納されます。そのため、BFILEはデータベース・トランザクションでは使用できません。

互換性

LOBによってさまざまな利点が提供されるため（前述の表を参照）、任意の新しいアプリケーションでは、LONGではなくLOBを使用することをお薦めします。

ただし、下位互換性を保持するため、LONGも完全にサポートされています。

Forms型

Formでは、LOBは通常、その性質と使用法に基づいて、テキスト、イメージまたはサウンドのいずれかの制御タイプが指定されます。

制限

•	BFILEは読込み専用です。

•	FormsはBLOBの読取り時にBLOB全体をロードしようとしますが、実行時の使用可能仮想メモリ容量の制限を受けます。

•	CLOBの場合、Formsには65,534バイトの制限があります。


Oracle8のユーザー定義オブジェクトについて

  関連項目  [image]  例

Oracle8 Serverに対するサポートとして、このリリースではOracle8のユーザー定義オブジェクトにアクセスできます。ユーザー定義オブジェクトには、オブジェクト表、リレーショナル表の列オブジェクトおよびREF列と呼ばれる特殊な列オブジェクトが含まれます。

オブジェクト表

Oracle8では、オブジェクト表はユーザーのオブジェクト・タイプ定義に基づいています。この定義はそれ自体が複合要素であり、その属性またはコンポーネントがそれぞれ、一般的なOracle8ビルトイン・データ型に基づいています。（オブジェクト・タイプ定義は、他のオブジェクト・タイプ定義に基づかせることができますが、定義は最終的に一般的なOracle8ビルトイン・データ型に依存しています。）

このため、オブジェクト表内の各列は、リレーショナル表の列を扱う場合と同様に個々のデータ項目として扱われます。

リレーショナル表の列オブジェクト

データベース・プログラマは、リレーショナル表の列をオブジェクト・タイプ定義に基づかせることもできます。これには、複合オブジェクトをリレーショナル表に埋め込む効果があります。

埋め込まれた列オブジェクトは複合部分に拡張され、それぞれの部分自体は列として扱われます。

たとえば、Oracle8 Serverに3列のリレーショナル表があり、そのいずれかの列が列オブジェクトで、その列オブジェクトが、4つの部分または属性を持つオブジェクト定義に基づいている場合、その表が6列の表として扱われます（リレーショナル表の列が2つとオブジェクトを構成する列が4つ）。

列オブジェクト定義の個々の属性のいずれかが別のオブジェクト・タイプに基づいている場合は、その部分がさらに拡張され、一連の個別の列として扱われます。

REF列

オブジェクト表またはリレーショナル表のいずれかの列をREF型を持つように定義することができます。REF列はデータを直接保持するのではなく、実際のデータを保持する別のオブジェクト表へのポインタ（参照）を持ちます。

参照は実行時に解決されるため、ユーザーは参照される実際のデータを見ることができます。


Oracle8のユーザー定義オブジェクト: 例

  関連項目

Oracle8 Server内でオブジェクトを作成するには、データベース・プログラマはまずオブジェクト・タイプを定義し、次にそのタイプ定義に基づいて特定のオブジェクトを作成します。作成されるオブジェクトは、オブジェクト表またはリレーショナル表内の列オブジェクトになります。

例

次の定義について考えてみます。最初の定義ではオブジェクト・タイプが作成されます。2番目の定義ではそのタイプの表が作成されます。

CREATE TYPE  emp_type  AS OBJECT

(name     CHAR(30),

title    CHAR(20),

idnum    NUMBER);

CREATE TABLE  emp  OF emp_type;

前述の例では、empという名前のオブジェクト表を作成します。この表には3つの列があり、これらの列は、emp_typeオブジェクト・タイプ定義で確立された名前とデータ型を持ちます。

次は、リレーショナル表内の列オブジェクトの例です。

CREATE TYPE  address_type  AS OBJECT

(street    VARCHAR2(40),

city      VARCHAR2(25),

state     VARCHAR2(2)

zip       NUMBER);

CREATE TABLE  customers

(cust_id  NUMBER,

name     VARCHAR(40),

address  address_type);

この例では、customersという名前のリレーショナル表を作成します。表には3つの列があります。最初の2つの列（cust_idとname）は、通常の関係列です。3つ目の列（address）は、列オブジェクトです。これは、address_typeという名前のオブジェクト・タイプ定義に基づいて作成されます。このaddress列は、オブジェクト定義によって確立された構造とデータ型を持ちます。address列は、4つの部分またはコンポーネント（street、city、stateおよびzip）を持っていると考えることができます。これらの各コンポーネントは、address_typeオブジェクト・タイプ定義で確立されたデータ型を持ちます。（この場合、NUMBER型のzipを除くすべてのコンポーネントはVARCHAR2型です）。

次の例では、3つの列で構成されるリレーショナル表の3番目の列は、それ自体が3つの部分またはコンポーネントを持つオブジェクト・タイプに基づいています。

Oracle8オブジェクトは、部分またはコンポーネントによって作成される複合であることに注意してください。それぞれの部分は、名前および一般的なOracle8データ型を持ちます。オブジェクトが表の場合（実際はオブジェクト表の行）、オブジェクト・タイプ定義内の属性と同じ数の列または部分を持ちます。リレーショナル表の列がオブジェクトに基づいている場合、各オブジェクトの部分は、その表の追加列であると考えることができます。それぞれの部分がオブジェクト・タイプ定義内の属性に基づいているため、これらの部分は属性列と呼ばれることもあります。

Developerにおけるオブジェクトの扱い

オブジェクト表は、リレーショナル表と非常に似た方法で扱われます。それぞれの列は個別に選択できます。すべての列を選択できますが、それぞれの列はアプリケーション内で別々の項目として扱われます。表自体は、環境内のオブジェクトなどの特定の個別性は持ちません。

同様にリレーショナル表の列オブジェクトは、単一の、同類性を持つエンティティとして扱われません。その代わりに、列オブジェクトの各コンポーネントを、個別の、独立したデータ項目として扱います。列オブジェクトの各コンポーネントは選択できます。選択されると、それぞれが独立したデータ項目として扱われます。列オブジェクトのすべてのコンポーネントを選択した場合でも、列オブジェクト自体は、開発環境内のオブジェクトとしての特定の個別性は持ちません。

オブジェクトから選択されたデータ項目には、ColumnObjectName_ItemNameというデフォルト名が付けられます。したがって、前述の例で、addressという名前の列オブジェクトからzipという名前のコンポーネントを選択すると、そのデータ項目はアプリケーション内でaddress_zipという名前が付けられます。


Oracle8のREFについて

  関連項目

REFは、Oracle8の新しいデータ型です。REFによって、他のオブジェクト表にあるデータへのポインタとしての列オブジェクトが確立されます。REF列自体はデータを保有しません。

次に例を示します。

CREATE TYPE  dept_type  AS OBJECT

(deptname     VARCHAR2(24),

deptnumber   NUMBER);

CREATE TABLE  dept_table OF dept_type;

CREATE TABLE  emp

(empname    VARCHAR2(50),

empnumber  NUMBER,

empdept    REF  dept_type);

empという名前のリレーショナル表では、列empdeptはREF列です。これは、タイプdept_typeのオブジェクトを参照します。

タイプと表

REF列を定義すると、特定のオブジェクト表ではなく、オブジェクト・タイプが識別されます。データベースには、単一のオブジェクト・タイプ定義に基づくオブジェクト表が複数含まれる場合があります。このため、REF列の定義自体によって、ターゲット表は識別されません。

ポインタ変換

REF列を含む表を初期化すると、REF列に配置されている値は、希望のデータを持つ特定の表に含まれる行へのポインタになります。実行時には、REF列に参照先のデータ（ポインタではない）が表示されます。

Developerにおける設計時のREFの表示方法

設計時にREF列を含む表の表示を求めると、REF列が拡張された形態で表示されます。つまり、元のREF定義によって参照されるオブジェクト・タイプ内の属性が表示されます。

この例の場合、empdeptが2つのコンポーネントまたは属性列、deptnameとdeptnumberを保有するREF列として表示されます。これらは、REF定義内で識別されたオブジェクト・タイプ（dept_type）内の2つの属性でした。

通常の列オブジェクトと同じように、参照先となるコンポーネントまたは属性の一部またはすべてを選択して、アプリケーション内のデータ項目にすることができます。ただし、通常の列オブジェクトとは対照的に、REF名自体を選択して、アプリケーション内で操作可能な項目にすることもできます。つまり、PL/SQLコード作成でREFを使用することができます。デフォルトで、REFはNULLキャンバスの一部になります。

ユーザーに対するREFの表示方法

アプリケーション設計者は、実行時ユーザーに対する参照先データ（変換されたREF）の表示方法を選択できます。

•	REFがあるデータ・ブロック内のデータを表示（参照方式と呼ばれることもある）

•	REFによって参照されるデータ・ブロック内のデータを表示（マスター/ディテール方式）

最初の方法（REFがあるデータ・ブロックの一部としてデータを表示）は最も単純です。データ・ブロック内に含める項目として目的のREFコンポーネントを選択し、実行時にDeveloperおよびOracle8によって参照が変換され、参照先の実際のデータが表示項目内に配置されます。ユーザーは1つのブロックを見るだけで済みます。

もう1つの方法（参照先データ・ブロックのデータを表示）では、マスター/ディテール・リンクを設定する必要があります。これは、主キー/外部キー・リレーションを持つ2つのブロックについてマスター/ディテール・リンクを設定することと似ています。この場合は、REFによって2つのブロック間にリンクが作成されます。ユーザーには両方のブロックが表示されますが、REFデータは参照先ブロック内にしか表示されません。

Form Builderのデータ・ブロック・ウィザードを使用して、このマスター/ディテール・リレーションを設定できます。


Oracle8オブジェクトのアイコン

オブジェクト・ナビゲータとウィザードでは、アクセスしているOracle8データの型がアイコンによって表示されます。アイコンとその意味は次のとおりです。

             通常の表

             オブジェクト・タイプ

             オブジェクト・ビュー

             オブジェクト表

             ネストしたオブジェクト

             ネストした表

             参照オブジェクト

             可変配列

             メソッド

             不明の型

             サーバー側のスタック・モード

             サーバー側のプログラム単位

             ファイル

             DATEデータ型

             NUMBERデータ型

             CHARACTERデータ型

             RAWデータ型

            BLOBデータ型

             BFILEデータ型

             CLOBデータ型

             rowid

             MLSラベル


Oracle8の拡張性とパフォーマンス

Oracle8 Serverによって、さまざまな点で拡張性およびパフォーマンスの向上が実現します。これらの利点の多くは、自動的に提供されます。

たとえば、Oracle8の次の特性を利用できます。

•	より大きなサイズへの対応。データベース自体のサイズ、同時ユーザーの数および表列の制限数（現行では1000列まで）がすべて増加しました。

•	表と索引のパーティション化

•	クライアント側のオブジェクト・キャッシング

また、パフォーマンスを向上させるOracle8のその他のさまざまな機能を直接利用できます。

•	プリフェッチ。Formsでは、Oracle8のこの機能を使用して（既存の配列サイズ機能と併用）、データベースのラウンドトリップ回数およびメモリ使用量を削減します。プリフェッチ機能は、ユーザーが操作しなくても自動的に実行されます。

•	戻り値句。Formsでは、挿入および更新を行うときに、この新しいDML機能を使用します。戻り値句によって2回目のデータベース問合せ（データに対するサーバー側トリガーの変更を取得する）が不要になるため、処理時間が短縮されます。ユーザーは「DMLの戻り値」プロパティを使用して、この機能を制御できます。

•	ビュー更新用のINSTEAD-OFトリガー。このサーバー側トリガーによって、リレーション・ビューとオブジェクト・ビューを更新する機能が提供されます。 これらのビューは、これ以外の方法では更新できません。


PL/SQL 8のサポート

  関連項目

このリリースでは、クライアントとサーバーでPL/SQL 8を使用します。クライアント側のプログラム単位は、現在Oracle8のオブジェクト関連機能をサポートしていません。ただし、ストアド・プログラム単位は、新しいPL/SQL 8機能をすべて使用できます。

『PL/SQLユーザーズ・ガイドおよびリファレンス、リリース8』マニュアルの付録Aでは、PL/SQL 8の新機能について説明しています。このマニュアルはオンラインで利用できます。「ヘルプ」 -> 「マニュアル」を選択して、オンライン・マニュアルの下のリファレンス・マニュアルに移動します。


PL/SQLの以前のリリースとの互換性

PL/SQL 1またはPL/SQL 2を使用して書かれたクライアント側のプログラム単位は、コードを新しいレベルに変換する必要があります。アップグレードを自動化できるように、PL/SQL 1変換ユーティリティが提供されています。

以前のリリースを使用して作成されたストアド・プログラム単位は、データベース・サーバー上のPL/SQL 8エンジンに対して実行できますが、コンパイル・エラーが発生する場合があります。これらのエラーは、PL/SQL 8とPL/SQL 2との間で構文の互換性がない場合に発生します。 PL/SQL 8の互換性フラグを使用することによってPL/SQL 2との互換性モードを選択できるため、PL/SQL 8エンジンでは、サーバーでPL/SQL 2コードをコンパイルするときに、このようなエラーは発生しません。『Oracle8 Server移行ガイド』の第6章では、この互換性フラグによってサポートされる状況について説明しています。


サポートされていないOracle8機能

  関連項目

このリリース全体では、一部のOracle8機能がサポートされていません。サポートされていない主な機能は次のとおりです。

•	コレクション・タイプ（ネストした表と可変配列）

•	オブジェクト値を返すストアド・プロシージャ

•	スカラー・データ型のNCHARとNVARCHAR2

このリリースではPL/SQL 8をサポートしていますが、クライアント側のPL/SQL 8は一部のOracle8 Serverの機能をまだサポートしていないことに注意してください。（サーバー側のPL/SQL 8ではOracle8 Serverのすべての機能をサポートしています。）


オブジェクト・ナビゲータのOracle8オブジェクト・サポート

オブジェクト・ナビゲータのOracle8機能を利用すると、オブジェクトのデータ型にアクセスし、Oracle8データに対するプログラムをより簡単に行うことができます。追加されたOracle8オブジェクト・サポートを使用すると、ユーザー定義データ型を階層形式で表示したり、ユーザー定義データ型に関連付けられた表、ビュー、列、トリガー、属性、メソッドの検索や表示を行うことができます。

「データベース・オブジェクト」ノードには、現在接続中のデータベース内でアクセス可能なスキーマとそのオブジェクトが含まれます。Oracle8データベースに接続している場合は、使用可能なユーザー定義データ型が（その属性およびメソッドと一緒に）各スキーマ内の「タイプ」ノードに表示されます。ユーザー定義データ型に関連付けられた表、ビュー、列およびトリガーは、「表」ノードと「ビュー」ノードに表示されます。

特に、オブジェクト・ナビゲータのOracle8機能を使用すると、次の項目を表示および検索できます。

•	「表」ノードのオブジェクト表と列オブジェクト

•	「ビュー」ノードのオブジェクト・ビュー

•	「ビュー」ノードのビュー用のInstead Ofトリガー

•	「タイプ」ノードのオブジェクト・タイプ、表タイプおよび可変配列タイプ

•	「タイプ」ノードのオブジェクト・タイプの属性とメソッド

オブジェクト・ナビゲータでは、リレーション・オブジェクトとOracle8オブジェクトを区別するために、アイコンが使用されます。たとえば、通常のリレーショナル表とオブジェクト表、および通常のビューとオブジェクト・ビューは、別々のアイコンで表されます。

Oracle8ユーザー定義データ型の詳細は、Oracle8のマニュアルを参照してください。

関連項目

オブジェクト・タイプ・ノード

表タイプ・ノード

可変配列タイプ・ノード

列オブジェクト・ノード

オブジェクト表ノード

オブジェクト・ビュー・ノード

すべて拡張

Oracle8オブジェクトのアイコン


オブジェクト・タイプ・ノード

  例	  関連項目

オブジェクト・タイプは、オブジェクト・ナビゲータの「タイプ」ノード内に表示されます。オブジェクト・タイプ・ノードは、SQL文のCREATE TYPE AS OBJECTで作成されたタイプを表します。オブジェクト・タイプはオブジェクト・ナビゲータに次のように表示されます。

object-type-name ( Object Type [ * ] & Body [ * ] )

CREATE TYPE AS OBJECT文がデータベースに発行されると、「オブジェクト・タイプ」ラベルが表示されます。タイプ仕様が無効か、またはタイプが不完全な場合は、アスタリスク（ * ）が表示されます。不完全なタイプは、タイプを再帰的に定義するためのプレースホルダになります。

CREATE TYPE BODY文を使用してタイプ本体が作成されると、「オブジェクト本体」ラベルが表示されます。タイプ本体が無効な場合は、アスタリスク（ * ）が表示されます。

オブジェクト･タイプとオブジェクト本体の両方が正常に作成されると、ラベルは「オブジェクト・タイプおよび本体」と表示されます。

オブジェクト・タイプ・ノードは複合ノードで、「属性」と「メソッド」の2つのサブノードを持ちます。オブジェクト・タイプ・ノードを拡張できるのは、有効なタイプ仕様が存在する場合のみです。

オブジェクト・タイプの属性は、「属性」サブノードの下のノードとして表されます。

オブジェクト・タイプのメソッドは、「メソッド」サブノードの下のノードとして表されます。メソッドは、プロシージャとファンクションとして表示されます。メソッドのラベルはオブジェクト・ナビゲータに次のように表示されます。

method-name (Procedure)

および

method-name (Function)

オブジェクト・タイプにマップ・メソッドまたはオーダー・メソッドが指定されている場合、メソッドのラベルは次のように表示されます。

method-name (Map Function)

または

method-name (Order Function)

注意: メソッドの引数リストは表示されません。


オブジェクト・タイプ・ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・タイプemp_typを作成します。

CREATE TYPE emp_typ AS OBJECT
  (ename VARCHAR2(30), esalary NUMBER(5,2),
  MEMBER PROCEDURE raise(amount NUMBER),
  MEMBER FUNCTION get_salary RETURN NUMBER,
  MAP MEMBER FUNCTION compare RETURN NUMBER);

emp_typのサブツリーは次のとおりです。


表タイプ・ノード

  例	  関連項目

表タイプは、オブジェクト・ナビゲータの「タイプ」ノード内に表示されます。表タイプ・ノードは、SQL文のCREATE TYPE AS TABLEで作成されたタイプを表します。表タイプはオブジェクト・ナビゲータに次のように表示されます。

table-type-name (TABLE OF table-subtype-name)

サブタイプがビルトイン・タイプの場合、表タイプ・ノードは拡張できません。サブタイプがオブジェクト・タイプまたは参照オブジェクトの場合は、オブジェクトの属性がサブノードとして表示されます。


表タイプ・ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・タイプemp_typおよび表タイプemp_tblを作成します。

CREATE TYPE emp_typ AS OBJECT
  (ename VARCHAR2(30), esalary NUMBER(5,2),
  MEMBER PROCEDURE raise(amount NUMBER),
  MEMBER FUNCTION get_salary RETURN NUMBER,
  MAP MEMBER FUNCTION compare RETURN NUMBER);

CREATE TYPE emp_tbl AS TABLE OF emp_typ;

emp_tblのサブツリーは次のとおりです。


可変配列タイプ・ノード

  例	  関連項目

可変配列タイプは、オブジェクト・ナビゲータの「タイプ」ノード内に表示されます。可変配列タイプ・ノードは、SQL文のCREATE TYPE AS VARYING ARRAYで作成されたタイプを表します。可変配列タイプはオブジェクト・ナビゲータに次のように表示されます。

varying-array-type-name (VARRAY (size) varying-array-subtype-name)

サブタイプがビルトイン・タイプの場合、可変配列タイプ・ノードは拡張できません。サブタイプがオブジェクト・タイプまたは参照オブジェクトの場合は、オブジェクトの属性がサブノードとして表示されます。


可変配列タイプ・ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・タイプemp_typおよび可変配列タイプemp_aryを作成します。

CREATE TYPE emp_typ AS OBJECT
  (ename VARCHAR2(30), esalary NUMBER(5,2),
  MEMBER PROCEDURE raise(amount NUMBER),
  MEMBER FUNCTION get_salary RETURN NUMBER,
  MAP MEMBER FUNCTION compare RETURN NUMBER);

CREATE TYPE emp_ary AS VARRAY(7) OF emp_typ;

emp_aryのサブツリーは次のとおりです。


列オブジェクト・ノード

  例	  関連項目

列オブジェクトは、「列」ノード内のノードとして表示されます。各オブジェクトには、名前およびカッコで囲まれたタイプのラベルが付きます。列オブジェクト・ノードは複合ノードで、タイプの属性がサブノードとして表示されます。

列オブジェクトのサブタイプには、ネスト・オブジェクト・タイプ、表タイプ、可変配列タイプおよび参照オブジェクト・タイプの4種類があります。オブジェクト・ナビゲータでは、列オブジェクトに次のようなラベルが付きます。

column-name (nested-object-type)

column-name (table-type-name:TABLE OF table-subtype-name)

column-name (varying-array-type-name:VARRAY(size) OF varying-array-subtype-name)

column-name (REF reference-type-name)


列オブジェクト・ノードの例

  関連項目 	   すべての例

次の例では、表emp_tabのemp_col列が、タイプemp_typのネスト・オブジェクトになります。

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TABLE emp_tab (emp_col emp_typ, dept VARCHAR2(2));

emp_tabのサブツリーは次のとおりです。

次の例では、表dept_tabのemps列が、サブタイプemp_tblのネスト表になります。ネスト表には、タイプemp_typの行が含まれます。

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TYPE emp_tbl AS TABLE OF emp_typ;
CREATE TABLE dept_tab (dname VARCHAR2(20), emps emp_tbl)
  NESTED TABLE emps STORE AS emps_tab;

dept_tabのサブツリーは次のとおりです。

次の例では、表dept_tab_aryのemps列が、サブタイプemp_aryの可変配列になります。可変配列には、タイプemp_typの行が含まれます。

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TYPE emp_ary AS VARRAY(7) OF emp_typ;
CREATE TABLE dept_tab_ary (dname VARCHAR2(20), emps emp_ary);

dept_tab_aryのサブツリーは次のとおりです。

次の例では、表dept_refのmanager列が、タイプemp_typの参照オブジェクトになります。

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TABLE dept_ref (dname VARCHAR2(20), manager REF emp_typ);

dept_refのサブツリーは次のとおりです。


オブジェクト表ノード

  例	  関連項目

オブジェクト表は、オブジェクト・ナビゲータの「表」ノード内に表示されます。オブジェクト表ノードは、SQL文のCREATE TABLE OFで作成された表を表します。オブジェクト・ナビゲータでは、オブジェクト表ノードに次のようなラベルが付きます。

object-table-name (object-type-name)

各オブジェクト表ノードには、「トリガー」と「列」の2つのサブノードがあります。「トリガー」サブノードには、オブジェクト表に関連付けられたすべてのトリガーが含まれます。これらのトリガーは、通常のリレーショナル表に関連付けられたトリガーと同じように表示されます。「列」ノードには、オブジェクト表に関連付けられたすべての関係列と列オブジェクトが含まれます。各列には、名前およびカッコで囲まれたタイプのラベルが付きます。


オブジェクト表ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・タイプperson_typおよびオブジェクト表person_tabを作成します。

CREATE TYPE person_typ AS OBJECT
  (name VARCHAR2(30), address VARCHAR2(60));

CREATE TABLE person_tab OF person_typ;

person_tabのサブツリーは次のとおりです。


オブジェクト・ビュー・ノード

  例	  関連項目

オブジェクト・ビューは、オブジェクト・ナビゲータの「ビュー」ノード内に表示されます。オブジェクト・ビュー・ノードは、OF object_type句を使用して作成されたビューを表します。オブジェクト・ビュー・ノードには、名前およびカッコで囲まれたタイプのラベルが付きます。オブジェクトの属性は表示されません。

各オブジェクト・ビュー・ノードには、「トリガー」と「列」の2つのサブノードがあります。「トリガー」サブノードには、Instead Ofトリガーを含む、オブジェクト・ビューに関連付けられたすべてのトリガーが含まれます。Instead Ofトリガーがビューに関連付けられている場合、ラベルは次のように表示されます。

trigger-name (INSTEAD OF trigger-statements)


オブジェクト・ビュー・ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・ビューを作成します。

CREATE TYPE emps_typ AS OBJECT (ename VARCHAR2(30), esalary number(5,2), deptno NUMBER(2));
CREATE TABLE emps (ename VARCHAR2(30), esalary number(5,2), deptno NUMBER(2));
CREATE VIEW dev_emps OF emps_typ
  WITH OBJECT OID (ename)
  AS SELECT ename, esalary, deptno FROM emps WHERE deptno = 10;

オブジェクト・ビューdev_empsのサブツリーは次のとおりです。


すべてのOracle8オブジェクト・ノードの拡張

  関連項目

オブジェクト・ナビゲータで「すべて拡張」を実行しても、Oracle8データ型と属性の各ノードは再帰的に拡張されません。

たとえば、タイプemp_typのmanagerという属性が、別のタイプemp_typの派生項目として表示されている場合、「すべて拡張」を実行してもmanager属性は拡張されません。


環境変数

  関連項目

CA_GPREFS

CA_UPREFS

CUE_PREFS

DEV2000_PROJECT

DEV2000_SOURCECONTROL

DOC60

FORMS60_DEFAULTFONT

FORMS60_EDITOR

FORMSnn_ERROR_DATE/DATETIME_FORMAT

FORMS60_JAVADIR

FORMS60_MAPPING

FORMS60_OUTPUT

FORMSnn_OUTPUT_DATE/DATETIME_FORMAT

FORMS60_PATH

FORMS60_REPFORMAT

FORMSnn_PLSQLV1_NAME_RESOLUTION

FORMS60_TIMEOUT

FORMSnn_USER_DATE/DATETIME_FORMAT

FORMS60_USEREXITS

GRAPHICS60_PATH

INTERRUPT（DOS SQL*Netユーザーのみ）

LOCAL

NLS_LANG

OleCreateObjPoolInMemory

OleDoNotUpdateLinks

OleUpdateLinksPrompt

ORACLE_HOME

ORACLE_PATH

ORAINFONAV_DOCPATH

REPORTS60_CGIDIAGBODYTAGS

REPORTS60_CGIDIAGHEADTAGS

REPORTS60_CGIHLP

REPORTS60_CGIMAP

REPORTS60_CGINODIAG

REPORTS60_CGIPATHONLYURL

REPORTS60_COOKIE_EXPIRE

REPORTS60_DB_AUTH

REPORTS60_ENCRYPTION_KEY

REPORTS60_OWSDIAGBODYTAGS

REPORTS60_OWSDIAGHEADTAGS

REPORTS60_OWSHELP

REPORTS60_OWSMAP

REPORTS60_OWSNODIAG

REPORTS60_OWSPATHONLYURL

REPORTS60_PATH

REPORTS60_REPORTS_SERVER

REPORTS60_SYS_AUTH

REPORTS60_TERMINAL

REPORTS60_TMP

REPORTS60_USEREXIT

REMOTE

UI_ICON

USERNAME

WIN_REMOTE_SESSIONS

XMITTR（DOSユーザーのみ）


レジストリ（Windows95およびWindows NT）

  環境変数

Oracleインストーラは、レジストリ内に新しいORACLEセクションを作成します。Oracleレジストリには、Oracleホーム・ディレクトリの名前、製品の作業環境ファイルのディレクトリ、ヘルプ・ファイルのディレクトリなどを制御する構成パラメータが入っています。

レジストリの表示と変更

Microsoft Windowsレジストリは、レジストリ・エディタを使用して表示およびオプションの編集ができます。このエディタは、Windowsソフトウェアがインストールされているディレクトリに入っています。エディタを起動するには、「スタート」 [image] 「ファイル名を指定して実行」を選択し、続いてREGEDITと入力し、「OK」をクリックします。

レジストリ・エディタ内で、HKEY_LOCAL_MACHINEノードを拡張し、続いてSOFTWAREノードを拡張します。[ORACLE]キーをクリックし、Oracle構成パラメータを表示させます。

パラメータ名をダブルクリックし「文字列の編集」ダイアログを表示させると、どのパラメータ値でも変更できます。「値」データ・テキスト・ボックス内の値を変更し、「OK」をクリックして新しい値を認めます。


構成パラメータ

  環境変数

Oracleインストーラは、多くのパラメータを自動的に設定します。これらのパラメータはOracle製品が必要とするものもあれば、開発者が製品動作のカスタマイズに使用するものもあります。

必要なパラメータ

この項に挙げているパラメータは、Oracleインストーラにより自動的に設定または削除されます。これらのパラメータは、さまざまなOracle製品が正しく動作するために必要なものです。

注意: この項に挙げられているパラメータの設定は変更しないでください。設定を変更すると、1つ以上のOracle製品が正しく動作しなくなります。

次に挙げているパラメータ内のnnは、製品またはコンポーネントのリリース番号を示します。この番号は、Oracle製品の新しいリリースにアップグレードする際に変わる場合があります。

パラメータ	デフォルト値
BROWSERnn	ORACLE_HOME\BROWSE25
DEnn	ORACLE_HOME\TOOLS\COMMON60
FORMSnn	ORACLE_HOME\FORMS60
GRAPHICSnn	ORACLE_HOME\GRAPH60
MMnn	ORACLE_HOME\TOOLS\COMMON60
OCLnn	ORACLE_HOME\GRAPH60
PROnn	ORACLE_HOME\PRO18
RDBMSnn	ORACLE_HOME\RDBMS73
RWnn	ORACLE_HOME\REPORT60
TKnn	ORACLE_HOME\TOOLS\COMMON60
VGSnn	ORACLE_HOME\TOOLS\COMMON60
カスタマイズできるパラメータ

この項に挙げているパラメータは、Oracle製品のさまざまな面を制御します。これらのパラメータの設定を変更し、製品動作をカスタマイズできます。

この後の項では、Oracleインストーラにより自動的に設定される、各パラメータのデフォルト設定（存在する場合）を挙げています。自動的に設定されないパラメータについても述べられています。設定の有効な値および例の説明も合わせて挙げられています。


CA_GPREFS

デフォルト: ORACLE_HOME

有効な値: 任意のドライブの任意のディレクトリ

例:

CA_GPREFS=C:\orawin95

このパラメータは、グローバル作業環境ファイルCAGPREFS.ORAのディレクトリを指定します。グローバル作業環境は、ネットワーク化されたユーザー間で共有されます。この製品は、CAGPREFS.ORAファイルを探すのに、CA_GPREFSパラメータで指定されるディレクトリの他、現行ディレクトリも検索します。

CAGPREFS.ORAファイルは、Oracleインストーラにより自動的に作成されます。グローバル作業環境を変更するには、「メモ帳」などのテキスト・エディタを使用し、このファイルを直接編集してください。CAGPREFS.ORA内のグローバル作業環境は、ローカル作業環境ファイルCAUPREFS.ORA（パラメータCA_UPREFSにより定義される）で上書きできます。


CA_UPREFS

デフォルト: ORACLE_HOME

有効な値: 任意のドライブの任意のディレクトリ

例:

CA_UPREFS=C:\orawin95

このパラメータは、ユーザー作業環境ファイルCAUPREFS.ORAのディレクトリを指定します。CAUPREFS.ORAファイルは、開発者が「ツール」 [image] 「ツール・オプション」から設定する作業環境をメンテナンスします。製品は、CAUPREFS.ORAファイルを探すために、CA_UPREFSパラメータで指定されているディレクトリの他、現行ディレクトリも検索します。

Oracle製品の中には、作業環境情報をCAUPREFS.ORAファイルに書き込むものもあります。ユーザー作業環境を手動で変更するには、「メモ帳」などのテキスト・エディタを使用しこのファイルを編集します。CAUPREFS.ORAに設定されているユーザー作業環境は、CAGPREFS.ORAファイル（パラメータCA_GPREFSで定義する）内のグローバル作業環境を上書きします。


CUE_PREFS

デフォルト: ORACLE_HOME

有効な値: 任意のドライブの任意のディレクトリ

例:

CUE_PREFS=C:\orawin95

このパラメータは、キュー・カードの作業環境ファイルCUEPREF.RESのディレクトリを指定します。CUEPREF.RESファイルは、「キュー・カード・オプション」ダイアログで設定可能なキューカードの作業環境をメンテナンスします。

作業環境は、アプリケーションを終了するたびにCUEPREF.RESファイルに保存されます。このファイルは、手動では変更できません。


DEV2000_SOURCECONTROL

デフォルト: なし

有効な値: Forms DeveloperまたはReports Developerにどのソース制御システムを使用すべきかを指定するキーワード

例:

DEV2000_SOURCECONTROL=PVCS

このパラメータは、Forms DeveloperまたはReports Developerにどのソース制御システムを使用するかを指定します。現在のところ、ソース制御システムを指定しない、またはこのパラメータを値'PVCS'に設定する、のどちらかを指定できます。ソース制御システムのサポートが追加されると、追加されたソース制御システムのキーワードも指定できるようになります。


DEV2000_PROJECT

デフォルト: なし

有効な値: Forms DeveloperまたはReports Developerで使用するソース制御システムのプロジェクト・ファイルを指定するキーワード

例:

DEV2000_PROJECT=c:\pvcs\project1\project1.cfg

このパラメータは、開発者がDEV2000_SOURCECONTROLパラメータ上で選択したソース制御システムのプロジェクト・ファイルの名前を指定します。


DOC60

デフォルト: Oracle_Home\tools\doc60

有効な値: 任意のドライブの任意のディレクトリ

例:

DOC60=c:\orawin95\tools\doc60

このパラメータは、オンライン・ヘルプ、キュー・カード、クイック・ツアーなど、オンライン・ドキュメント・ファイルのディレクトリを指定します。


FORMS60_DEFAULTFONT

デフォルト: なし

有効な値: 任意の有効フォントを指定するテキスト文字列

例:

FORMS60_DEFAULTFONT="MS Sans Serif.8"

このパラメータは、Form Builderのレイアウト・エディタ内のボイラープレートに使用するデフォルト・フォントを指定します。


FORMS60_EDITOR

デフォルト: なし

有効な値: システム・エディタの名前とパス

例:

FORMS60_EDITOR=C:\windows\notepad.exe

このパラメータは、デザイナまたはランフォーム・コンポーネント内でForm Builderの複数行の項目が起動できるエディタを定義します。このパラメータが定義されない限り、ユーザー定義のエディタは起動できません。

注意: エディタを終了する際、ファイルは「ASCIIのみ」のファイルとして保存する必要があります。固有のワープロ形式はサポートされていません。


FORMSnn_ERROR_DATE/DATETIME_FORMAT

目的： 次の環境変数は、エンドユーザーが日付または日時項目に無効な値を入力したときに表示されるランタイム・エラー･メッセージを生成するために、Formsが使用する書式マスクを設定します。

デフォルト: ヘルプ・トピック「日付の書式マスク」を参照してください。

有効な値: 任意の有効な日付/日時書式マスク。

例:

FORMS65_ERROR_DATE_FORMAT YYYY/MM/DD


FORMS60_JAVADIR

デフォルト: Oracle_Home\forms60\java

有効な値: Oracle Java実行時環境の名前およびパス

例:

FORMS60_JAVADIR=C:\orant\forms60\java

このパラメータは、Java Beanエリアを使用し、WebベースのフォームをForm Builderからプレビューするのに必要なOracle Java実行時環境ファイルのロケーションを定義します。


FORMS60_MAPPING

デフォルト: なし

有効な値: 一時作業ディレクトリの仮想位置

例:

FORMS60_MAPPING=http://myhost.com/webtemp

Web上でイメージを処理するために、Forms Serverは一時的な圧縮JPEGファイルを送信します。Web Formsアプリケーションでイメージまたはアイコンを使用する場合は、Forms Serverがイメージやその他の作業ファイルに使用する一時ディレクトリと仮想ディレクトリ（例 C:\ORANT\WEBTEMP）を作成する必要があります。また、Forms Serverが動作しているコンピュータ上にFORMS60_OUTPUT環境変数およびFORMS60_MAPPING環境変数を作成する必要もあります。


FORMS60_OUTPUT

デフォルト: なし

有効な値: Formsサーバーが動作しているコンピュータ上の任意のドライブの任意のディレクトリ

例:

FORMS60_OUTPUT=C:\ORANT\WEBTEMP\

Web上でイメージを処理するために、Forms Serverは一時的な圧縮JPEGファイルを送信します。Web Formsアプリケーションでイメージまたはアイコンを使用する場合は、Forms Serverがイメージやその他の作業ファイルに使用する一時ディレクトリ（例 C:\ORANT\WEBTEMP）を作成する必要があります。また、Forms Serverが動作しているコンピュータ上にFORMS60_OUTPUT環境変数およびFORMS60_MAPPING環境変数を作成する必要もあります。


FORMSnn_OUTPUT_DATE/DATETIME_FORMAT

目的： 次の2つの環境変数は、独自のマスクを持たない任意の日付および日時項目で実行時出力操作を行うためにFormsが使用する書式マスクを設定します。

デフォルト: ヘルプ・トピック「日付の書式マスク」を参照してください。

有効な値: 任意の有効な日付/日時書式マスク。

例:

FORMS65_OUTPUT_DATETIME_FORMAT YYYY/MM/DD HH24:MI:SS


FORMS60_PATH

デフォルト: ORACLE_HOME\FORMS60\PLSQLLIB

有効な値: 任意のドライブの任意のディレクトリ

例:

FORMS60_PATH=C:\oracle\apps\forms;C:\myfiles

このパラメータは、Form Builderのランタイム・アプリケーション内で使用するファイルの検索パスを指定します。これには、フォーム・ファイル（.fmx）、メニュー・ファイル（.mmx）、PL/SQLライブラリ（.pll）、アプリケーションが実行時にロードを試みるその他のオブジェクトが含まれます。たとえば、イメージ・ファイルscooter.tifをインポートすると、Form BuilderはそのファイルをFORMS60_PATHで指定されているディレクトリ内で検索します。

FORMS60_PATHは、複数のディレクトリを指定できます。セミコロン（;）を使用して、パス・リスト内のディレクトリ名を区切ってください。


FORMSnn_PLSQLV1_NAME_RESOLUTION

デフォルト:  オフ

有効な値:  オン、オフ

例:

FORMS6i_PLSQLV1_NAME_RESOLUTION=ON

この環境変数を使用すると、ランタイム・プログラム・ユニット名の解決の動作をR4.5とR5以降のバージョン間で選択できます。オンを指定すると、R4.5の動作が選択されます。オフを指定すると（またはこの環境変数を指定しないと）、R5以降の動作が選択されます。

R4.5の動作:

Formsがプログラム・ユニットのコールに出会うと、まず現行Formsまたはメニューのプログラム・ユニットを探し、次に連結されたライブラリを検索します。この動作により、呼び出されるプログラム・ユニットが、コンパイル時に解決されたのと同じプログラム・ユニットではないので、動的名前の解決の簡易なスタイルが得られます。さらに、同じライブラリが複数のFormsに連結される場合には、各Formsは、インスタンシエーション、パッケージ状態、依存関係を含む一意のセットのライブラリ情報を保持します。これは依存関係情報がForms全体にわたって共有されないことを意味します。

R4.5には次の短所があります。

•	Forms全体にわたって情報が共有されません。SHARE_LIBRARY_STATEは効果がありません。

•	実行時間とメモリー使用量が増えます（R5+と比較した場合）。

R5+の動作:

Formsがプログラム・ユニットのコールに出会うと、まず現行Formsまたはメニューのプログラム・ユニットを探し、次に連結されたライブラリを検索します。しかし、同じライブラリが複数のFormsに連結される場合には、各Formsは一意のセットのライブラリ情報を保持しません。その代わりに、プログラム・ユニット・インスタンシエーションはForms全体にわたって共有されます。これは依存関係情報がForms全体にわたって共有できることを意味します。

推奨事項:

前述の短所とこの環境変数が将来のバージョンで必ずサポートされるとは限らないため、R4.5の動作を選択しないようお薦めします。

その代わりに、動的な名前の解決を取得するために、Execute-Triggerビルトインを使用してください。引数が必要な場合はグローバル変数を使用します。


FORMS60_REPFORMAT

デフォルト: なし

有効な値: HTML、PDF

例:

FORMS60_REPFORMAT=HTML

ブラウザを起動して、フォームからRUN_PRODUCTを使用してレポートを実行する場合は、FORMS60_REPFORMAT環境変数を設定する必要があります。このパラメータは、レポートの書式を指定します。


FORMS60_TIMEOUT

デフォルト:   15

有効な値: 1～1440（1日）

例:

FORMS60_OUTPUT=1440

このパラメータは、クライアントとFormsのサーバーとの通信がない場合に、Formsのサーバーのプロセスが終了するまでの経過時間を分単位で指定します。


FORMSnn_USER_DATE/DATETIME_FORMAT

目的: 次の2つの環境変数は、独自のマスクを持たないDATE型およびDATETIME型の項目から値を取り出すためにFormsが実行時に使用する書式マスクを設定します。

デフォルト: ヘルプ・トピック「日付の書式マスク」を参照してください。

有効な値: 任意の有効な日付/日時書式マスク。複数の書式マスクを垂直バーで区切って指定できます。ランタイム項目の変換時には、その変換が正常に終了するまで（または、書式マスクがなくなるまで）書式マスクが指定された順に使用されます。

例:

FORMS65_USER_DATE_FORMAT  FXFMDD-MM-RRRR


FORMS60_USEREXITS

デフォルト: なし

有効な値: （絶対パスおよび）任意のユーザー・イグジット・ダイナミック・リンク・ライブラリ。

このパラメータにより、複数のDLLを定義し、ユーザー・イグジット・インタフェースから起動できる外部ファンクションを含めることができます。FORMS60_USEREXITSパラメータには、セミコロンで区切られた一連のユーザー・インタフェースDLLが入っています。

FORMS60_USEREXITSには、複数のDLLを指定できます。円記号（\）を使用してパス内のディレクトリを指定し、セミコロン（;）を使用してパスごとに区切ってください。

この値を明示的に設定しないと、Form Builderは値をORACLE_HOME\BIN\F45XTB.DLLと断定します。

例:

FORMS60_USEREXITS = C:\mathlib\add.dll;C:\mathlib\mult.dll


GRAPHICS60_PATH

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

GRAPHICS60_PATH=C:\oracle\apps\graphics;C:\myfiles

このパラメータは、Graphics Runtimeアプリケーション内で使用されるファイルの検索パスを指定します。これは、表示ファイル（.ogr）、イメージ、外部問合せおよびアプリケーションが実行時にファイルからロードを試みるその他のオブジェクトを含みます。たとえば、イメージ・ファイルscooter.tifをインポートすると、Graphics Builderはこのファイルを探すためにGRAPHICS60_PATHで指定されているディレクトリを検索します。

GRAPHICS60_PATHには、複数のディレクトリを指定できます。円記号（\）を使用してパス内のディレクトリを指定し、セミコロン（;）を使用してパスごとに区切ってください。


INTERRUPT（DOS SQL*Netユーザーのみ）

デフォルト: なし

有効な値: DOSのCONFIG.ORAファイルで指定されているものと同じ値

このパラメータは、DOSのOracle製品が使用する割込みベクトル・アドレスを指定します。Windows版のDOS SQL*Netドライバを使用する場合は、CONFIG.ORAファイルがDOSのOracleホーム・ディレクトリに入っていることを確認してください。INTERRUPTパラメータがCONFIG.ORA内に設定されている場合は、レジストリ内でこのパラメータを同じ値に設定する必要があります。DOSのCONFIG.ORAファイル内でこの変数が設定されていない場合は、レジストリ内で設定する必要はありません。

注意: QEMM、386MAX、CEMM、EMM386などのサードパーティのメモリー管理製品を使用する場合は、INTERRUPTを103に設定しないでください。この設定が行われると、SQLPMEおよびSQL*Netを起動後、予期しない動作が起きます。


LOCAL

デフォルト: なし

有効な値: データベースの文字列パラメータを含む、任意の有効なSQL*Netドライバ接頭辞。詳細は、『Oracleネットワーク管理者ガイド』を参照してください。

このパラメータは、製品内でのデータベースの接続に通信ドライバを設定しない場合にこの製品が使用する、SQL*Netドライバと完全な接続文字列を指定します。

LOCALパラメータを追加する場合、そのパラメータをファイルの最後に追加しないでください。Oracle製品は、LOCALパラメータが最後のパラメータとして現れる場合、それを認識しません。

注意: Windows版のDOS SQL*Netドライバを使用する場合は、LOCALパラメータがDOSのOracleホーム・ディレクトリのCONFIG.ORAファイルに設定されているかを確認してください。CONFIG.ORA内でLOCALが設定されている場合、同じ値をレジストリ内で設定する必要があります。


NLS_LANG

デフォルト: AMERICAN_AMERICA.WE8ISO8859P1

有効な値: 利用できる値の現行の一覧を、『NLSリファレンス・マニュアル』またはCDの\bonus\nls\nlsd2r1.wriファイルで参照してください。

例:

NLS_LANG=AMERICAN_AMERICA.WE8ISO8859P1

このパラメータは、メッセージ・ファイルが表示される言語を設定します。NLS_LANGの構文を次に示します。

NLS_LANG=<language>_<territory>.<char_set>

パラメータの内容は次のとおりです。

language	メッセージおよび日と月の名前を表示するための言語とその規約を指定します。
territory	週と日の数を計算するための地域およびその規約を指定します。
char_set	UPPER、LOWERおよびINITCAPファンクションに使用されるキャラクタ・セットと、ORDER BY問合せが使用するソートの型を指定します。この引数は、メッセージの表示に使用するキャラクタ・セットも制御します。


OleCreateObjPoolInMemory

デフォルト:   0

有効な値: 0または1

例:

OleCreateObjPoolInMemory=0

Report Builderでは、このパラメータはOLE2オブジェクト・プールを一時ファイル（0）に作成するか、メモリー（1）に作成するかを指定します。メモリーにプールを作成すると、ディスク・アクセスを減らしパフォーマンスが向上します。OLE2オブジェクトが多いか大きなOLE2オブジェクト（イメージなど）がある場合は、必要なメモリー量が多くなる可能性があります。どれだけのOLE2オブジェクトがあるかを調べるには、繰返し枠内の1つのOLE2ボイラープレート・オブジェクトにOLE2オブジェクトが1つ入っていることを参考にしてください。1つのOLE2フィールドには、フィールドのそれぞれのインスタンスに対しOLE2オブジェクトが1つ入っています。


OleDoNotUpdateLinks

デフォルト:   0

有効な値: 0または1

例:

OleDoNotUpdateLinks=0

Report Builderでは、このパラメータは、レイアウト・エディタがオープンされる場合やレポートが実行される場合、リンクのアップデートを有効（0）または無効（1）にします。リンクされたOLE2オブジェクトには、それらのソース・オブジェクトのキャッシュされたプレゼンテーションが入っています。これらのキャッシュされたプレゼンテーションは、持続したオブジェクト・データに基づく対応するOLE2サーバーにより更新されます。

これらの更新は、リンクの種類に基づき、自動的に、または手動で行われます。キャッシュされたプレゼンテーションの更新はOLE2サーバーの起動を要するため、ソース・オブジェクトが変更されていないことが明らかな場合や、最新の変更を必要としない場合は、更新を無効にしパフォーマンスを向上させることができます。このオプションを指定しない場合も、OLE2オブジェクトが更新される際に表示される標準のダイアログ・ボックスで更新を取り消すことができます。


OleUpdateLinksPrompt

デフォルト:   0

有効な値: 0または1

例:

OleUpdateLinksPrompt=0

Report Builderでは、このパラメータは、リンクしたオブジェクトが見つからない場合にそれを知らせる（0）か知らせない（1）かを指定します。更新時にオブジェクトのソースが見つからない場合ダイアログ・ボックスが表示され、リンク・ソースを再指定するかエラーを無視できます。ダイアログ・ボックスに対応できない場合（レポートを一晩中実行している場合など）、レポートの実行が確実に終了するようにこの確認を無効にできます。


ORACLE_HOME

デフォルト: C:\ORAWIN95

有効な値: 任意のドライブの任意のディレクトリ

例:

ORACLE_HOME=C:\orawin95

このパラメータは、Windows版のOracle製品がインストールされているホーム・ディレクトリを指定します。このディレクトリは、Oracleディレクトリ階層の「トップ」ディレクトリです。

使用上の注意

•	Reports Runtimeを使用している場合は、ORACLE_HOMEとORACLE_PATHで使用できる検索パスの最大長は合計で255文字です。


ORACLE_PATH

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

ORACLE_PATH=C:\oracle\apps\forms;C:\oracle\apps\graphics;
C:\oracle\apps\reports

このパラメータは、Forms Runtime、Graphics RuntimeまたはReports Runtimeにより参照されるファイルの検索パスを指定します。ORACLE_PATHで指定されるディレクトリは、製品固有のパラメータであるFORMS60_PATH、GRAPHICS60_PATHまたはREPORTS60_PATHで指定されるディレクトリの後に検索される点に注意してください。

ORACLE_PATHには、複数のディレクトリを指定できます。セミコロン（;）を使用して、パス・リスト内のディレクトリ名を区切ってください。

使用上の注意

•	Reports Runtimeを使用している場合は、ORACLE_HOMEとORACLE_PATHで使用できる検索パスの最大長は合計で255文字です。


ORAINFONAV_DOCPATH

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

ORAINFONAV_DOCPATH=C:\orawin95\oin

このパラメータは、オンライン・ドキュメントの目次と索引のテーブルのディレクトリを指定します。


REMOTE

デフォルト: なし

有効な値: 任意の有効なSQL*Netドライバ接頭辞およびパラメータ

例:

REMOTE=P:PIPER

このパラメータは、ローカル・データベースを介して接続する場合に使用する、デフォルトのリモートSQL*Netドライバを指定します。このパラメータには、デフォルトのSQL*Netパラメータ（すべてのデータベース文字列）を含めることができます。

この例中のP：は名前付きパイプに対するネットワーク接頭辞、Piperはデータベース名です。

ユーザーがログインを行いREMOTEで指定されたものと一致する明示的なドライバ接頭辞との接続を指定し、SQL*Netパラメータを指定しないと、REMOTEで指定されたパラメータが使用されます。このパラメータによりDBAは、SQL*Netユーザーが接続パラメータを指定する必要がない「通常の」ネットワーク接続を定義できます。このパラメータは、コマンド・ラインでいつでもリセットできます。

注意:Windows版のDOS SQL*Netドライバを使用する場合は、DOSのOracleホーム・ディレクトリに入っているCONFIG.ORAファイルにREMOTEパラメータが設定されているか確認してください。CONFIG.ORAでREMOTEが設定されている場合は、レジストリ内でこのパラメータを同じ値に設定する必要があります。


REPORTS60_CGIDIAGBODYTAGS

Reports Web CGIでは、このパラメータはRWCGI60診断/デバッグ出力で<BODY_>タグとして挿入されるHTMLタグを指定します。たとえば、この環境変数を文字色/背景色とイメージを設定するのに使用することができます。


REPORTS60_CGIDIAGHEADTAGS

Reports Web CGIでは、このパラメータは診断/デバッグ出力のRWCGI60で <HEAD> � </HEAD>タグの間に挿入されるHTMLタグを指定します。たとえば、この環境変数を<TITLE>や<META_>タグを設定するのに使用することができます。


REPORTS60_CGIHLP

Reports Web CGIでは、このパラメータでRWCGI60ヘルプ・ファイルを空の要求で起動したときにナビゲートされるURL/URIを指定します。

http://your_webserver/your_virtual_cgi_dir/rwcgi60.exe?

たとえば、REPORTS60_CGIHLPをhttp://www.yahoo.comに設定すると、指定したWebページが表示され、myhelpfile.htmに設定すると指定したファイルが表示されます。

http://your_webserver/myhelpfile.htm

この変数を定義しない場合は、デフォルトのヘルプ画面が表示されます。


REPORTS60_CGIMAP

Reports Web CGIでは、このパラメータでマップ・ファイル構成が使用される場合に、RWCGI60マップ・ファイルの適切なファイル名および位置を定義します。

c:\orant\report60\mymap.dat


REPORTS60_CGINODIAG

Reports Web CGIでは、このパラメータを定義するとRWCGI60からのすべてのデバッグ/診断出力が使用不可になります。

http://your_webserver/cgi-bin/rwcgi60.exe/help?

使用上の注意

このパラメータは、REPORTS60_CGINODIAGが定義されている場合は使用できません。


REPORTS60_CGIPATHONLYURL

Reports Web CGIでは、このパラメータが定義されている場合（値にかかわらず）、指定されたURLのパス部分にしか戻りません。 たとえば、次のURLに戻るかわりに、

Location: http://your_webserver:port/path

こちらに戻ります。

Location: /Path

この変数は、デフォルトのポートを含む複数のポートを使用するWebサーバーのセットアップに関する問題を解決するのに使用することができます。


REPORTS60_COOKIE_EXPIRE

デフォルト:   30

有効な値: 任意の数（分単位）

例:

REPORTS60_COOKIE_EXPIRE=30

Reports Serverのセキュリティでは、このパラメータはクッキーのアイドル時間（例 REPORTS60_COOKIE_EXPIRE=30）を決定します。クッキーは暗号化されたユーザー名とパスワードをクライアント側で保存します。CGIがクライアントからクッキーを受け取ると、CGIがクッキーに保存された時間と、現在のシステム時間を比較します。

REPORTS60_COOKIE_EXPIREパラメータで指定された時間（例 30分）よりも長い時間が経過している場合は、CGIはクッキーを拒否し、データベース認証フォームとエラー・メッセージをクライアントに返します。レポートを実行するには、ユーザーは再度認証を受けなければなりません。


REPORTS60_DB_AUTH

デフォルト: dbauth.htm

有効な値: 特別な認証アクションを含む、任意のhtmlファイル。デフォルトの状態が望ましい。

例:

REPORTS60_DB_AUTH=dbauth.htm

データベースにログインするのに使用するデータベース認証テンプレートを指定します。


REPORTS60_SYS_AUTH

デフォルト: sysauth.htm

有効な値: 特別な認証アクションを含む、任意のhtmlファイル。デフォルトの状態が望ましい。

例:

REPORTS60_SYS_AUTH=sysauth.htm

アクセスが制限されているReports Serverに対してユーザがレポート要求を実行するときに、ユーザー名とパスワードを認証するのに使用する認証テンプレートを指定します。


REPORTS60_ENCRYPTION_KEY

デフォルト: Reports6.0

有効な値: 任意の暗号キー

例:

REPORTS60_ENCRYPTION_KEY=reports6.0

このパラメータで、ユーザー名とパスワードの暗号化に必要な暗号キーを指定します。


REPORTS60_REPORTS_SERVER

有効な値: 任意のReports Serverサービス・エントリ名

例:

REPORTS60_REPORTS_SERVER=repserver

デフォルトのReports ServerをWeb CartridgeまたはWeb CGI要求に指定します。このパラメータを設定すると、レポート要求でSERVERコマンド･ライン引数を省略し、デフォルト・サーバーを使用してそれらを処理することも、SERVERコマンド･ライン引数を組み込んで、デフォルトより優先させることもできます。


REPORTS60_OWSDIAGBODYTAGS

Reports Webカートリッジでは、このパラメータはRWOWS60診断/デバッグ出力ファイルで<BODY_>タグとして挿入されるHTMLタグを指定します。たとえば、この環境変数を文字や背景の色やイメージなどを指定するのに使用することができます。


REPORTS60_OWSDIAGHEADTAGS

Reports Webカートリッジでは、このパラメータはRWOWS60診断/デバッグ出力ファイルで<HEAD> _</HEAD>タグの間に挿入されるHTMLタグを指定します。たとえば、この環境変数を<TITLE>や<META_>タグなどを指定するのに使用することができます。


REPORTS60_OWSHELP

有効な値:任意のパスとファイル名、またはURL

Reports Web カートリッジでは、このパラメータはRWOWS60ヘルプ・ファイルが空の要求で起動されたときにナビゲートされるURL/URIを指定します。

http://your_webserver/rwows60?

例 このパラメータをhttp://www.yahoo.comに設定すると、Webページが表示され、myhelpfile.htmに設定すると、指定したファイルが表示されます。

http://your_webserver/myhelpfile.htm

このパラメータを定義しない場合は、デフォルトのヘルプ画面が表示されます。


REPORTS60_OWSMAP

Reports Webカートリッジでは、このパラメータはRWOWS60マップ・ファイルの適切なファイル名および位置を指定します（マップ・ファイル構成が使用されている場合）。

C:\ORANT\REPORTS60\MYMAP.DAT


REPORTS60_OWSNODIAG

Reports Webカートリッジでは、このパラメータを定義すると、RWOWS60からのすべてのデバッグ/診断出力が使用不可になります。

http://your_webserver/rwows60/help?

REPORTS60_OWSNODIAGが定義されている場合は、このパラメータを使用することはできません。


REPORTS60_OWSPATHONLYURL

Reports Webカートリッジでは、このパラメータを指定すると（値にかかわらず）、RWOWS60は、レポート出力するHTTPリダイレクションと、RWOWS60が生成する診断出力にURLのパス部分のみを使用します（例 "http://mywebsrv.com:1550/rscache/..."の代わりに"/rscache/..."）。クライアントのブラウザで、レポート出力を検索した後に、"Location"フィールドのオリジナルのURL要求を維持するのに役に立ちます。通常、RWOWS60はURLをレポート出力の場所に置き換えて（例 REPORTS60_WEBLOCで指定されたディレクトリ）、出力されたレポート出力ファイルの名前を、12345679.htmのような意味のない文字列のような形式の名前で表示します。このパラメータを設定することによって、このような"URL の切り替え"を避けることができます。すべてのURLがデフォルトのポート（通常は80）を使用している場合のみ、このパラメータを使用することができます。

しかし、このパラメータを設定する場合の欠点は、メインのレポート出力ファイルに依存している任意の補助ファイル（たとえば画像ファイルなど）をブラウザで検索することができないことです（REPORTS60_WEBLOCで指定した場所に作成はされています）。この問題は、メインのレポート出力ファイルにインクルードしたり、REPORTS60_WEBLOCでRWOWS60実行可能ファイルの場所を、レポート定義の<BASE HREF="...">や<META HREF="...">タグ（メイン・ファイルの場所をフル・パスまたは部分パスで）で指定すると対処できます。

コンピュータ名やIPアドレスのHTTPリダイレクションの依存性を解決するため、REPORTS60_OWSPATHONLYURLを設定すると、1台のコンピュータが複数の異なるIPアドレスを同時に（複数のネットワーク・カードを使用して）持つイントラネットまたはインターネット構成に対処することもできます。


REPORTS60_PATH

デフォルト:ORACLE_HOME\REPORT60\DEMO;ORACLE_HOME\REPORT60\DEMO\BITMAP;ORACLE_HOME\REPORT60\DEMO\REQFILES

有効な値: 任意のドライブの任意のディレクトリ

例:

REPORTS60_PATH=C:\oracle\apps\reports;C:\myfiles

この環境変数は、レポートと、PL/SQLライブラリ、外部問合せ、外部ボイラープレートなどのレポート内で使用する外部オブジェクトの位置を示すのに使用します。この環境変数により、ディレクトリ・パスをハードコード化する必要がなくなり、オペレーティング・システム間で簡単に移植できるレポートを作成することが可能となります。

注意: REPORTSPATHは256文字以内に制限されています。

パスの長さなどのプラットフォーム固有の規則に注意しながら、オペレーティング・システム上の他の環境変数の定義と同じ方法で、REPORTS60_PATHを定義してください。

REPORTS60_PATHを定義する際、ディレクトリ・パスの他、キーワードとなるデータベースを指定できます。この指定は、Report Builderに現在接続しているデータベースを検索するように指示します。

Unixプラットフォームで次のように指定したと仮定します。

setenv REPORTS60_PATH
/home/tkostin/pay:/home/tkostin/receive:DB

Report Builderは、初めにディレクトリ/home/tkostin/payを検索します。探しているファイルが見つからない場合、/home/tkostin/receiveを検索します。それでもファイルが見つからないと、Report Builderセッションを開始したときに接続していたデータベースを検索します。


REPORTS60_TERMINAL

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

REPORTS60_TERMINAL=C:\mytermdefs

この環境変数は、文字モード・レポート内で使用する端末定義の位置を示すのに使用します。この変数に指定するパスは、ORACLE_TERMINAL環境変数よりも優先します。

パスの長さなどのプラットフォーム固有の規則に注意しながら、オペレーティング・システム上の他の環境変数の定義と同じ方法でREPORTS60_TERMINALを定義してください。


REPORTS60_TMP

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

REPORTS60_TMP=C:\tmp

この環境変数は、Report Builderの一時ファイルを格納するディレクトリを設定します。Report Builderは、この目的では1つのディレクトリしか使用しません。 複数のディレクトリを定義しないでください。

パスの長さなどのプラットフォーム固有の規則に注意しながら、ベース・オペレーティング・システム上の他の環境変数の定義と同じ方法でREPORTS60_TMPを定義してください。REPORTS60_TMPを定義しないと、現在使用しているディレクトリがデフォルトで指定されます。


REPORTS60_USEREXIT

デフォルト: なし

有効な値: （絶対パスおよび）任意のユーザー・イグジット・ダイナミック・リンク・ライブラリ

例:

REPORTS60_USEREXIT=C:\mydll.dll;d:\mynew.dll;e:\bin\speed.dll

このパラメータにより、Report Builderおよびその関連する実行可能プログラム（Reports Runtimeなど）が使用する複数のDLLを定義できます。これらのDLLは、Report Builderの実行可能プログラムがコールするように開発者が作成したプログラム・モジュールです。

REPORTS60_USEREXITSには、複数のDLLを指定できます。円記号（\）を使用してパス内のディレクトリを指定し、セミコロン（;）を使用してパスごとに区切ってください。

この値を明示的に指定しないと、Report Builderはシステムのパス変数に従って60xtb32.dllを探します。


UI_ICON

デフォルト: なし

有効な値: 任意のドライブのアクセス可能なディレクトリ

例:

UI_ICON=C:\icon

この環境変数は、レイアウト内のボタンに使用するアイコンを格納するディレクトリを設定します。Report Builderは、この目的では1つのディレクトリしか使用しません。 複数のディレクトリを定義しないでください。

パスの長さのようなプラットフォーム固有の規則に注意しながら、ベース・オペレーティング・システム上の他の環境変数の定義と同じ方法で、UI_ICONを定義してください。


USERNAME

デフォルト: なし

有効な値: （OPS$接頭辞を除く）任意の有効なOracleユーザー名

例:

USERNAME=dsanvita

このパラメータは、デフォルトのログイン・アカウントの変数部分を指定します。USERNAMEパラメータの設定の詳細は、データベースのドキュメントを参照してください。


WIN_REMOTE_SESSIONS

デフォルト: なし

有効な値:   0～33

ログイン時にORA-3100～ORA-3100の範囲のエラーを受け取った場合は、Oracle Serverとの通信バッファを設定するのに十分なリアルモード・メモリーがない可能性があります。NETINIT7.EXEを使用すると、サーバー接続のメモリーを確保しこの問題を解決できます。

このパラメータは、NETINIT7がメモリーを確保する、リモート・サーバーへの接続数を設定します。WIN_REMOTE_SESSIONSパラメータを設定する際、次の規則に注意してください。

•	WIN_REMOTE_SESSIONSを0に設定すると、NETINIT7はリモート・サーバー接続に対しメモリーを確保しません。

•	WIN_REMOTE_SESSIONSを1～33の値に設定すると、指定した接続数に必要なメモリーを確保します。NETINIT7は、各リモート・サーバー接続に対し12KBのリアルモード・メモリーを確保します。

•	WIN_REMOTE_SESSIONSの推奨されるデフォルト値は5。 WIN_REMOTE_SESSIONSを5に設定すると、複数の製品を実行するのに十分なセッションを作成できます。

•	WIN_REMOTE_SESSIONSパラメータを追加しないと、NETINIT7は1つのリモート・サーバー接続に必要なメモリーを確保します。

NETINIT7を使用する場合、次に示すステップを行ってください。

1	WIN_REMOTE_SESSIONSパラメータを追加し、セッション数を設定します。

2	Oracleプログラム・グループ内でNETINIT7アイコンを作成します（アイコンの作成の詳細は、Microsoft Windowsの文書を参照）。Windowsの「アイコンのプロパティ」ダイアログ・ボックスの「コマンド・ライン」フィールドで次のパスを入力します。

ORACLE_HOME\bin\netinit7.exe

3	Oracleプログラム・グループ内のアイコンをダブルクリックし、NETINIT7を起動します。NETINIT7は、必ず製品を起動する前に起動してください。Windowsの起動時にNETINIT7を自動的に実行したい場合は、「Windows起動」プログラム・グループにNETINIT7アイコンを含めてください。

NETINIT7は、設定された数のサーバー接続に必要な実メモリーの確保を試みます。必要なメモリーを割り当てられないと、NETINIT7は警告メッセージを表示し、メモリーを割り当てた実際のセッション数を示します。

メモリーを割り当てた後、NETINIT7のサイズは最小化されます。NETINIT7を復元すると、設定されているセッションの合計数と使用されているメモリーの合計容量が表示されます。NETINIT7をクローズすると、使用されていないすべてのセッション・メモリーが解放されます。アプリケーションでセッション・メモリーがまだ使用されている場合は、NETINIT7はセッション・メモリーが解放される前にアプリケーションのログオフが必要なことを知らせます。

注意: NETINIT7の前にこの製品を起動すると、製品はNETINIT7が認識しないそれ自身のセッション・メモリーを割り当てます。NETINIT7は、起動した製品によりすでに割り当てられているメモリーに加えて設定されているセッション・メモリーを割り当てようとします。


XMITTR（DOSユーザーのみ）

デフォルト: なし

有効な値: DOSのCONFIG.ORAファイルで指定されているものと同じ値

このパラメータは、Oracle DOSのプロテクト・モードの実行可能プログラムのユーザーにのみ適用されます。DOSのOracleホーム・ディレクトリに入っているCONFIG.ORAファイルを確認してください。CONFIG.ORAにXMMITRパラメータが設定されている場合、レジストリ内でこのパラメータを同じ値に設定する必要があります。DOSのCONFIG.ORAファイル内でこの変数が設定されていない場合は、レジストリ内で設定する必要はありません。

拡張メモリー・マネージャの割込みベクトル（Extended Memory Manager Interrupt Vector:XMMITR）は、拡張メモリー・マネージャ、モード遷移ドライバXMMおよびMTD割込みサービスのエントリ・ポイントに使用される割込みベクトルを示す変数です。異なるベクトルを設定するには、新しいベクトルを10進数として表現します。XMMITRは、システム内の別のプログラムが割込みの100（10進）または64（16進）を使用する必要がある場合のみ使用してください。

注意: QEMM、386MAX、CEMM、EMM386などのサードパーティのメモリー管理製品を使用する場合は、XMMITRを103に設定しないでください。この設定が行われると、SQLPMEおよびSQL*Netのロード後、予期しない動作が起きます。


PL/SQL V1変換の例

  関連項目 	   すべての例

デフォルト式を削除する

NULLをRETURN文に追加する

廃止されたビルトインを置換する

ファンクションlength

オーバーロードしたサブプログラムにNULLを渡す

RETURN文が指定されていない

パッケージのプロシージャ名を一意名に変更する

パッケージの接頭辞を削除する

予約語

長さの制限を削除する

変数の宣言


「データ表選択」ダイアログ・ボックス

  関連項目

説明  「データ表選択」ダイアログ・ボックスでは、接続したデータベースのデータ・ソース・オブジェクトを問合せにインクルードできます。

このダイアログ・ボックスの内容:

表示	表、ビュー、問合せ、スナップショット、シノニムのすべて、あるいはどれかをリスト・ボックスに表示するかどうかを指定します。
ドロップダウン・ボックス	オブジェクトを表示するデータ・ソースを指定します。別のアカウントやデータベースから表を選択することもできます。
データ表選択	問合せにインクルードできるデータ・ソース・オブジェクトをリストします。ヒント
情報	選択したオブジェクトに情報を表示します。種類、名前、所有者、作成日、コメントがあります。種類、名前、所有者、作成日、コメントがあります。
インクルード	選択した項目をQuery Builderの作業領域にインクルードします。
クローズ	データ・ソース・オブジェクトをインクルードせずにこのダイアログ・ボックスをクローズします。


現行のデータベースにある他のアカウントへのアクセス

  関連項目

現行のデータベースにある他のアカウントの表にアクセスするには:

1	現行のデータベース名をクリックします。「インクルード」ボタンが「オープン」ボタンに切り替わり、リスト・ボックスには現行のデータベース内のアカウントのリストが表示されます。

2	オープンするアカウントの名前をクリックします。

3	「オープン」ボタンをクリックするか、アカウント名をダブルクリックします。Query Builderにはそのアカウントにある表のリストが表示され、「オープン」ボタンは再び「インクルード」ボタンに切り替わって、通常の方法で表をインクルードできるようになります。


他のアカウントをオープンする

  関連項目

必要な表が現行のデータベース内にリストされていない場合、他のアカウントやデータベースを検索してそのアカウントから表を選択することができます。

他のアカウントおよびデータベースにナビゲートするには:

1	表のリストの上のボックスをクリックします。選択肢は2つあります。現行のデータベースの名前と「データベース」です。現行のデータベースの名前と「データベース」です。

2	現行のデータベースにある他のアカウントの表をコールするには、ここをクリックします。

リストされたデータベースと接続できない場合は、ネットワーク上の異常やリモート・パスワードの変更によってリンクが無効になっていると思われます。このような場合には、データベース管理者に連絡してください。


表の2回以上のインクルード

  関連項目

1つの問合せに同じ表を2回以上インクルードする場合、複製表に、実表の名前の次にアンダースコアと英数字が続く形式で命名されたシステム生成の別名が自動的に割り当てられます。


「リレーション表選択」ダイアログ・ボックス

説明  「リレーション表選択」ダイアログ・ボックスでは「問合せ」ウィンドウで選択した表に関係のある表をインクルードすることができます。

このダイアログ・ボックスの内容:

表示	このオプションは使用できません。
ドロップダウン・ボックス	すべてのリレーション表を指定するかどうかを指定します。
データ表選択	使用できるリレーション表をリストします。ヒント
情報	選択したオブジェクトに情報を表示します。種類、名前、所有者、作成日、コメントがあります。種類、名前、所有者、作成日、コメントがあります。
インクルード	選択した表をインクルードします。
クローズ	リレーション表をインクルードせずにこのダイアログ・ボックスをクローズします。


「表改名」ダイアログ・ボックス

  関連項目

説明  「表改名」ダイアログ・ボックスでは、現在アクティブな表の名前を変更できます。

このダイアログ・ボックスの内容:

デフォルト表名	表の現行名を指定します。
リスト・ボックス	改名のためにオープンした表をリストします。
新規名	新しい表名を指定します。
定義	ダイアログ・ボックスをオープンしたまま表名を更新します。


改名した表の識別

格納された問合せの中では、特定の表の名前がユーザー定義の名前か元の名前かは、すぐには見分けられません。

特定の表が改名されているかどうかを識別するには:

1	アイコン・バーの [image] をクリックします。

2	「処理可能な表」のリストで目的の表をクリックします。

表の名前が変更されている場合は、別名が「新しい名前」フィールドに表示され、別の名前（元の表名）が「デフォルト表名」フィールドに表示されます。

また、SQLを使用している場合でも、アイコン・バーの [image] をクリックすれば、改名された表を識別することができます。これによって、「SQL表示」ダイアログ・ボックスが表示され、表の別名を表す標準SQL構文内のSELECT文の中に、名前の変更が表示されます。


「表リレーション設定」ダイアログ・ボックス

  関連項目

説明  「表リレーション設定」ダイアログ・ボックスでは、2つの表の間に単純リレーション、自己リレーション、複合リレーション、不等価リレーションを設定します。

このダイアログ・ボックスの内容:

リレーション	起点(A->で)列と宛先(B->で)列の名前を指定します。
演算子	列間のリレーションの種類を指定します。
問合せでリレーションを使用	問合せにリレーションを使用するかどうかを指定します。チェックされている種類がデフォルトです。
「Bに一致しないA」ラジオ・ボタン	表Aにあり、表Bにないデータ以外に、両方の表ですべて共通のデータを検索することを指定します。
「Aに一致しないB」ラジオ・ボタン	表Bにあり、表Aにないデータ以外に、両方の表ですべて共通のデータを検索することを指定します。
「不一致を抑制」ラジオ・ボタン	デフォルト。両方に共通のデータを検索することを指定します。


リレーションについて

  関連項目

リレーショナル・データベースは、多くのリレーション表からなります。各表は縦方向に配置された列（フィールドともいいます)からなります。列には名前があり、一意の種類のデータを保存します。

リレーション、つまり結合は、1つの表の列と別の表の列との関係を定義します。必要なリレーションは、ほとんどデータベースに定義されています。リレーションにより、データの冗長性も少なくなります。異なる表の列にリレーションが設定してあれば、それらの表は問合せでまとめて処理できます。注意

リレーション列の名前がいつも同じであるとは限りません。同じデータ型はいつでも関係付けられます。 リレーションに意味があれば、ときには異なるデータ型でも関係付けることができます。たとえば、数値も文字として解釈できるため、通常、NUMBERデータ型の列はCHARACTER型の列と関係付けることができます。実際、ほとんどの列（長いテキストの列を除く）は、CHARACTER型の列と関係付けることができます。リレーションにはユーザー定義（一時）リレーションと、基本データ・ディクショナリに設定されたリレーションがあります。

リレーションにはユーザー定義（一時）リレーションと、基本データ・ディクショナリに設定されたリレーションがあります。データ・ディクショナリのリレーションは、リレーション表（主キー/外部キー関係を持った表）をインクルードすると自動的に表示されます。これらのリレーションはいつでも有効なので、特別な操作をしなくても利用できます。その作成や変更にはSchema Builderを使用します。

ユーザー定義リレーションは、それを作った問合せの中でのみ有効です。ユーザー定義リレーションを作っても基本表には対応する恒久的なリレーションは設定されません。両者の主な違いはユーザー定義リレーションの場合、ユーザーがリレーション線を引く必要がある点です。 データベースに保存されたリレーションの場合は、Query Builderによって自動的にリレーション線が引かれます。

注意（Report Builderのみ）:  Report Builderのデータ・リンクは、Query Builderのリレーションとは異なります。データ・リンクは2つ以上の問合せ間で作成されますが、Query Builderのリレーション（結合）は、1つの問合せ内で作成されます。詳細は、Report Builderのオンライン・ヘルプを参照してください。


リレーションのアクティブ化と非アクティブ化

  関連項目

マウスを使用して作成した関係は、問合せの中での必要に応じて、自動的にアクティブにされたり解除されたりします。アクティブな関係は、黒の太線で表示され、非アクティブな関係は、グレーの線で表示されます。

マウスを使用して手動で関係をアクティブにするには:

  非アクティブな関係線をダブルクリックします。

関係を解除するには:

  アクティブな関係線をダブルクリックします｡


「列定義」ダイアログ・ボックス

説明  「列定義」ダイアログ・ボックスでは、他列の値に基づいて、問合せ内に新しい列を作成できます。定義済みの列は、「データ・ソース」パネルと「結果」ウィンドウの両方に表示されます。

このダイアログ・ボックスの内容:

定義済み列	作成する列の名前を指定します。
リスト・ボックス	既存の定義済み列をリストします。
定義内容	選択した列の式を指定します。
定義	定義を列に適用します。
削除	選択した列を削除します。
列ペースト	「列ペースト」ダイアログ・ボックスを表示します。
関数ペースト	「関数ペースト」ダイアログ・ボックスを表示します。
注意: 定義済み列は問合せの一部にすぎず、データベースに保存された表定義を変更することはありません。


「ソート」ダイアログ・ボックス

説明  「ソート」ダイアログ・ボックスでは、表の列をもとに、問合せにあるデータをソートできます。

このダイアログ・ボックスの内容:

処理可能な列	ソートできる表列を「結果」ウィンドウに表示します。
ソート済み列	現在ソートされている表列を「結果」ウィンドウに表示します。
コピー	「処理可能な列」リストで選択した列を「ソート済み列」リストにコピーします。
削除	「ソート済み列」リストで選択した表列を削除します。
ソート順	選択した列を「昇順」や「降順」でソートします。デフォルトは「昇順」です。


Query Builderヘルプ

  関連項目

新規問合せの作成

問合せに条件を追加

単純関係の作成

列の定義

問合せデータのソート


Query Builderについて

  関連項目

Query Builderは、アナリスト、マネージャ、その他ビジネス・プロフェッショナルのために作成された簡単に使用できるデータ・アクセス・ツールです。社内データベースの情報に、論理的で直感的にアクセスでき、解析や報告に活用できます。

Query Builderはコンピュータのプログラミングやデータベースの基礎知識がないプロフェッショナルを対象に作成されています。また、Query Builderの強力な問合せ機能と構造化問合せ言語(SQL)文のサポートは、経験豊かなデータベース・ユーザーやプログラマにもさまざまな用途を提供します。

Query Builderの視覚的な「問合せ」ウィンドウで、社内データベースにあるデータに対する要求を指定できます。このデータに対する要求を問合せといいます。

Query Builderは、ユーザーがSQL SELECT文で作成するどのような問合せの定義にも対応できます。Query Builder作業領域に表示される列にもとづいて最適なSELECT FROM [table.column]句がQuery Builderにより、自動的に生成されます。


「列順序」ダイアログ・ボックス

説明  「列順序」ダイアログ・ボックスでは、Query Builder作業領域の問合せ結果を調整できます。

このダイアログ・ボックスの内容:

処理可能な列	Query Builder作業領域に表示できる表列をリストします。ヒント
表示中の列	Query Builder作業領域に現在表示されている表列をリストします。
コピー	「処理可能な列」リストから選択した列を「表示中の列」リストにコピーします。
削除	「表示中の列」リストから選択した列を削除します。
フォーマット	「フォーマット」ダイアログ・ボックスを表示します。
合計	「合計」ダイアログ・ボックスを表示します。
実行	問合せを実行します。


「列ペースト」ダイアログ・ボックス

  関連項目

説明  「列ペースト」ダイアログ・ボックスでは、既存の列を選択した表から問合せにペーストできます。

このダイアログ・ボックスの内容:

リスト・ボックス	ペーストできる列をリストします。ヒント


「関数ペースト」ダイアログ・ボックス

説明  「関数ペースト」ダイアログ・ボックスでは、関数を条件や問合せにペーストできます。

このダイアログ・ボックスの内容:

カテゴリ表示	リスト・ボックスに表示される関数の種類を指定します。数値、文字、日付、変換、グループその他があります。
リスト・ボックス	選択したカテゴリで利用できる関数をリストします。
引数ペースト	引数をインクルードするかどうかを指定します（使用する関数に情報を提供する関数のカッコ内の式）。


「SQL表示」ダイアログ・ボックス

  関連項目

「SQL表示」ダイアログ・ボックスでは、ユーザーの問合せ用のSQL文を表示するのみです。「SQL表示」ダイアログ・ボックスではSQL文の編集やコピーはできません。


表内の各行を一意に識別する1つ以上の列。主キーは太字で表示されます。


他の表の主キー値を参照する列。外部キーはイタリック体で表示されます。


問合せが表、ビュー、問合せ、シノニムおよびスナップショットを含むデータを取り出すソース。


1つの論理表を構成する1つまたは複数のデータベース表の列からなるデータ・ソース。


ファンクションまたは操作、および操作対象のデータベース列で構成される文字列(たとえば、SALARY+COMMISSION)。


命名規則に従う場合は、各問合せの名前は文字から始めるものとし、文字および数字で30字以内に収めます。命名規則を使用しないでデータベースの問合せを命名すると、Query Builderにより名前が（二重引用符で囲まれた）「リテラル」値に変換されます。


「条件」パネルについて

「条件」パネルは、「条件」フィールドを含む「問合せ」ウィンドウの1つのセクションであり、ここで式と条件を入力します。Query Builderの条件では、必要に応じてWHERE句やHAVING句が自動的に生成されます。

表名と列名は、条件内でフィルタリングされる列を示します。列名が一意の場合は、表名を省略できます。ヒント

注意: 「条件」フィールドをアクティブにするとカーソルにプラス記号(+)が表示され、クリックする項目が条件に追加されることを示します。これを非アクティブにするには、アイコン・バーの [image] をクリックします。


「問合せ」ウィンドウについて

問合せをオープンすると、Query Builderは次の2つのパネルに分割された「問合せ」ウィンドウにその問合せを表示します。

•	「条件」パネルには「条件」フィールドがあります。このフィールドを使って問合せの詳細を指定します。

•	「データ・ソース」パネルでは、問合せで使用される表（ビューやスナップショットなど）を表示します。

2つのパネルは、好みに応じて垂直または水平に分割できます。

それぞれの表は、表の名前と表内の列の名前を含むボックス内に表示されます。また、たくさんのアイコンがあり、現行のデータベース・オブジェクトを特定するときに使用すると便利です。説明のコメントが添付されているかどうか、データ・ソースのタイプ、列のデータ型、問合せ内の表について索引が定義されているかどうかなど、アイコンによってさまざまな情報が示されます。

リレーション線は、列間のリレーションを示します。リレーションは表間に設定され、ある表の列が別の表の列にどのように関連しているかを特定します。

列名の左にあるチェック・マークは、列が問合せにインクルードされていることを示します。これは、問合せを実行すると、Query Builderがその列名に対応するデータを検索することを意味します。チェック・マークがない場合は、列のデータがインクルードされていないことを示します。


「データ・ソース」パネルについて

  関連項目

「データ・ソース」パネルは、「問合せ」ウィンドウ内のセクションであり、表やリレーションなどの項目が表示されます。


アイコン・バーについて

  関連項目

アイコン・バーはQuery Builderウィンドウの一番上に表示されます。各アイコンをクリックすると説明が表示されます。


「保存」アイコン

指定したファイルに問合せを保存します。


「カット」アイコン

選択したテキストをカットし、オペレーティング・システムのクリップボードに移動します。


「コピー」アイコン

選択したテキストをオペレーティング・システムのクリップボードにコピーします。 元のテキストはそのまま残ります。


「ペースト」アイコン

現行のクリップボードのアイテムをアクティブな場所にペーストします。クリップボードに何もない保存されていない場合、ペーストは行われません。カットやコピーしたテキストは何でもペーストできます。


「消去」アイコン

選択したアイテム（テキストやテーブルなど）を消去します。「カット」コマンドと違って、「消去」で削除したアイテムはオペレーティング・システムのクリップボードには保存されません。


「すべて選択」アイコン

アクティブ・ウィンドウのすべてのアイテムを選択します。たとえば、「条件」パネルがアクティブな場合、パネル内のすべての条件が選択されます。


「データ表選択」アイコン

「データ表選択」ダイアログ・ボックスを表示します。


「リレーション表選択」アイコン

「リレーション表選択」ダイアログ・ボックスを表示します。このアイコンは選択した表と結合されたデータベースに、リレーション表がある場合にのみ使用できます。


「表改名」アイコン

「表改名」ダイアログ・ボックスを表示します。このアイコンは、Query Builder作業領域に少なくとも表が1つないと使用できません。


「情報」アイコン

「情報」ダイアログ・ボックスと、選択したデータベースのオブジェクトに関する情報を表示します。このアイコンはデータ・ソース・オブジェクトがアクティブでないと使用できません。


「表リレーション設定」アイコン

「表リレーション設定」ダイアログ・ボックスを表示します。このアイコンは、関係付ける「データ・ソース」パネルに、複数の表がないと使用できません。


「SQL表示」アイコン

「SQL表示」ダイアログ・ボックスと、アクティブな問合せのSQLを表示します。


「列順序」アイコン

「表示」ダイアログ・ボックスを表示します。


「列定義」アイコン

「列定義」ダイアログ・ボックスを表示します。


「ソート」アイコン

「ソート」ダイアログ・ボックスを表示します。


「And」アイコン

AND演算子を条件に挿入します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。「条件」フィールドに直接ANDと入力することもできます。


「Or」アイコン

OR演算子を条件に挿入します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。「条件」フィールドに直接ORと入力することもできます。


「Not」アイコン

NOT演算子を条件に挿入します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。「条件」フィールドに直接NOTと入力することもできます。


「条件グループ解除」アイコン

AND、OR、NOTなどの論理演算子で結合された条件グループを解除します。このアイコンは、「条件」パネルで論理演算子を選択していないと使用できません。


「アクセプト」アイコン

アクティブな条件の妥当性を検査し、確定します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。「条件」フィールドがアクティブな場合は、[Enter]キーや[Return]キーを押しても、妥当性の検査と確定の処理になります。


「取消」アイコン

現行の条件を取り消します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。


「列ペースト」アイコン

「列ペースト」ダイアログ・ボックスを表示します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。


「関数ペースト」アイコン

「関数ペースト」ダイアログ・ボックスを表示します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。


データ型について

  関連項目

Query Builderの主なデータ型は、次のとおりです。

CHAR またはVARCHAR2	CHARは、固定長の文字データに使用します。 最大サイズで255バイト、デフォルト・サイズは1バイトです。VARCHAR2は、最大サイズ2000バイトの可変長の文字列に使用します。VARCHAR2の場合、サイズを指定してください。
NUMBER	データベース列に数値（整数、小数、その他の型の数値）があることを表します。NUMBER型の数字では計算ができますが、CHAR型の数字では計算できません。
DATE	データベース列に日付値があることを表します。日付の有効範囲は、西暦の紀元前9999年の1月1日から、西暦9999年の12月31日までです。デフォルト・フォーマットはDD-MON-YYです。'01-JAN-92'のように表します。
NUMBER(p,s)	p(小数の精度)の範囲は1から38です。s(スケール)の範囲は-84から127です。保存される桁数は小数の精度で決まります。スケールは小数点の右側の桁数を表します。スケールが負のとき実際のデータは、小数点の左側の指定桁数でまるめられます。たとえば、(10, -2)と指定すると結果は100の位で四捨五入されます。
その他、Query Builderでは、以下のOracleデータ型を一定の範囲でサポートしています。

LONG	LONG列には、2ギガバイト(または231-1)までの可変長英数字データを保存できます。Query Builderの問合せにLONGをインクルードすると、最初の2000文字が表示されます。
RAW	RAWバイナリ・データです。最大サイズは255バイトです。値は16進文字で入力します。値は16進値で表示されます。RAW型ではサイズを指定してください。
LONG RAW	LONG RAWでは、最大2ギガバイトのRAWバイナリ・データを表示します（「結果」ウィンドウには16進で表示される）。LONG RAW型の範囲はRAW型と同じです。
注意:Query Builderでは、条件と式が比較時に異なるデータ型を参照するデータ型の変換もできます。詳細は『Oracle8 Server SQLリファレンス』を参照してください。


「データ型」アイコン

  関連項目

以下に示すデータ型は、データ・ソース・オブジェクトのすべての列で使用できますが、これらはQuery Builder作業領域のオブジェクトの右側列にあるアイコンに表示されます。

データ型	アイコン	説明
文字		CHARACTER型は、固定長の文字データに使用します。最大サイズで255バイト、デフォルト・サイズは1バイトです。 注意: 数字はCHARACTER型でも表せますが、計算には数値データ型を使用してください。
Varchar2		VARCHAR2データ型は、最大サイズ2000バイトの可変長文字列に使用します。VARCHAR2型ではサイズを指定してください。
Number		NUMBER型は、整数や浮動小数点データに使用します。整数データの場合は、精度長（桁数）を指定します。浮動小数点データ型は、小数に使用します。データ型を列に指定するときは、精度とスケールの両方を指定してください。 精度（数値の合計桁数）の範囲は、1から38です。 スケール（小数点の右側の桁数）の範囲は、-84から127です。 スケールが負のとき、実際のデータは小数点の左側の指定桁数でまるめられます。  たとえば、(10, 2)は、小数点以下が2桁の10桁の数値を表します。(10, -2)と指定すると、10桁の整数が100の位で四捨五入されます。
Date		DATE型はどのような種類の日付にも使用できます。西暦の紀元前4712年の1月1日から、西暦4712年の12月31日までです。デフォルト・フォーマットはDD-MON-YY。 '01-JAN-92'のように表します。
Long		LONG型は、最大2ギガバイトの可変長の英数字データのロング・テキスト・フィールドに使用します。
Raw		RAW型はRAWバイナリ・データに使用します。最大サイズは255バイトです。値は16進の文字列で指定します。値は16進で表示されます。RAWデータにはサイズを指定してください。
Long Raw		LONG RAW型は、最大2ギガバイトのRAWバイナリ・データ（指定と表示は16進で行われる）に使用します。LONG RAW型ではサイズの指定は不要です。
MLSLABEL		MLSLABEL型は、機密性の高いオペレーティング・システムで使用するラベルのバイナリ・フォーマットの保存に使用します。Trusted Oracleでは、ラベルを媒体として情報にアクセスします。標準Oracle Serverを使用する場合は、このデータ型で列の定義もできます。Trusted Oracle、このデータ型およびラベルの詳細は、『Trusted Oracle8 Server管理者ガイド』を参照してください。


データ・ソース・オブジェクトの表記

  関連項目

以下に示したのは、リレーションでリンクされた2つのデータ・ソース・オブジェクトの例です。

アイコン、インジケータまたはこれらのオブジェクトの一部をクリックすると説明が表示されます。


オブジェクト型インジケータ

データ・ソース・オブジェクトの左上角のアイコンが、その種類を表します。

  表

  ビュー

  問合せ

  スナップショット

  シノニム


オブジェクト・タイトル

データ・ソース・オブジェクトの名前です。オブジェクト・タイトルをクリックすると名前を変更できます。


コメント・インジケータ

このアイコンは、このオブジェクト（あるいは列）に、コメントが添付されていることを表します。このアイコンをダブルクリックすると「情報」ダイアログ・ボックスがオープンします。 このダイアログ・ボックスにコメントが表示されます。


列名

このオブジェクトにある1つの列の名前です。列名をダブルクリックすると、問合せにその列がインクルードされます。


データ型インジケータ

これらのアイコンは、それぞれの列のデータ型を表します。 アイコンをクリックしたままにすると、ポップアップ・メニューが表示され、別のデータ型を選択できます。


リレーション線

2つの列の間に引かれる灰色の線です。 これは線で結ばれた列の間にリレーションが設定されていることを表します。線は外部キーから主キーに引かれます。


自己リレーション・インジケータ

このアイコンは、この列（外部キー）と同じ表にある別の列（主キー）との間に自己リレーションが設定されていることを表します。


主キー

太字で表示される列名。 列がオブジェクトの主キーであることを表します。


外部キー

イタリック体で表示される列名。 このキーが、別の列の主キーに関係付けられた外部キーであることを表します。外部キーを定義するには、2つの列の間にリレーションを設定する必要があります。


Query Builder関数について

例 	関連項目

関数は、データ項目を操作し結果を返す演算子に似ています。関数が演算子と異なる点は、引数を伴うということです。関数は任意数の引数を対象に（引数がなくても）操作できます。関数名を列に関連付けると、Query Builderでは列の値に対して定義された操作が行われます。

Query Builderにおいて、問合せで使用できる関数は次のとおりです。

•	数値関数

•	文字関数

•	数値を返す文字関数

•	変換関数

•	日付関数

•	グループ関数

•	その他の関数

追加情報: その他の関数の詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


関数および引数

例 	関連項目

関数は特定の列でデータを操作するために使用します。各関数は1つ以上の引数を取ることができます。関数にはカッコが付いており、カッコ内の式が引数です。引数は、関数が使用する情報を提供します。

たとえば、ROUNDという関数があります。この関数は数値を指定された桁に四捨五入します。式ROUND (CREDIT_LIMIT, -2)を入力すると、Query Builderは、CREDIT_LIMITの各値を100の位に四捨五入します。ROUND(CREDIT_LIMIT, 1)を入力すると、CREDIT_LIMITの各値を小数1桁に四捨五入します。

引数で使用できる値は次のとおりです。

引数値	説明
char,set,search,	一重引用符で囲まれた文字定数。
replace	マーク、または式。文字データを返します。
d,e	一重引用符で囲まれた日付定数、または日付データを返す式。
m,n	数値定数、または数値データを返す式。
x	引数のデータ型は、関数の機能性によって変わります。
expr	任意のデータ型の式。
fmt	データの表示方法を変更したりSchema Builderのフィールドにデータを入力するために使用される書式、またはデフォルト以外の書式にする条件。


数値関数

関連項目

数値関数は、数値データを受け取り、数値データを返します。列および条件を定義する際に使用します。

関数(引数)	説明
ABS(n)	nの絶対値。
CEIL(n)	n以上の整数で最小の値を返します。
COS(n)	n（ラジアンで表される角度）のコサインを返します。
COSH(n)	nの双曲線余弦（ハイパーボリック・コサイン）を返します。
EXP(n)	指数表記。e (2.71828183...)のn乗を返します。
FLOOR(n)	n以下の整数で最大の値を返します。
LN(n)	n>0のとき、nの自然対数を返します。
LOG(m,n)	mを底として、nの対数を返します。底mは、0または1以外の正の整数、nは正の整数を返します。
MOD(m,n)	mをnで割った余りを返します。
POWER(m,n)	mのn乗を返します。nが整数でなければ、切り捨てられます。
ROUND(n[,m])	nを小数点以下m桁に四捨五入します。mが省略されると小数点以下桁数は0となります。mが負数であれば、小数点より左の桁で四捨五入されます。
SIGN(n)	n<0であれば-1。n=0であれば0、n>0であれば1を返します。
SIN(n)	n（ラジアンで表される角度）のサインを返します。
SINH(n)	nの双曲線正弦（ハイパーボリック・サイン）を返します。
SQRT(n)	nの平方根を返します。n<0ならばNULLを返します。
TAN(n)	n（ラジアンで表される角度）のタンジェントを返します。
TANH(n)	nの双曲線正接（ハイパーボリック・タンジェント）を返します。
TRUNC(n[,m])	nを小数点以下m桁に切り捨てます。mを省略すると小数点以下0桁となります。mが負ならば小数点より左側の桁で切り捨てられ、その桁は0となります。


文字関数

関連項目

文字関数は、文字データを受け取り、文字データを返します。列および条件を定義する際に使用します。

関数(引数)	説明
CHR(n)	データベース文字セットでバイナリnに対応する文字を返します。
CONCAT(char1, char2)	char1とchar2を連結した文字列を返します。この関数は、連結演算子（||）と同等の意味を持ちます。
INITCAP(char)	charで指定される各語の先頭文字を大文字にして返します。各語間はブランクまたは英数以外の文字で区切られます。
LOWER(char)	charの全文字を小文字にして返します。
LPAD(char1, n[,char2])	char1の左側に文字列char2を必要数追加して、n文字にします。char2の指定がなければ、ブランクが使用されます。
LTRIM(char[, set])	charの先頭から、setに含まれない文字が最初に出現する以前の文字を削除して返します。setのデフォルトは' '（1個のブランク）です。
NLS_INITCAP (char[, nlsparams])	charで指定される各語の先頭文字を大文字にして返します。各語間はブランクまたは英数以外の文字で区切られます。nlsparamsで指定するパラメータには、NLS_SORT=sort形式を使用できます。sortはセッションでの使用言語によるソート順序またはBINARYです。BINARYが指定されるとcharを返します。ソート順序の詳細は、『Oracle8 Server概要』を参照してください。
NLS_LOWER(char [,nlsparams])	charの全文字を小文字にして返します。 引数nlspa-ramsについては、NLS_INITCAPを参照してください。
NLS_UPPER(char [,nlsparams])	charの全文字を大文字にして返します。引数nlspa-ramsについては、NLS_INITCAPを参照してください。
REPLACE(char, search[, replace])	char内の文字定数searchをすべてreplaceに置き換えて返します。replaceを省略すると、searchはすべて削除されます。
RPAD(char1,n[, char2])	char1の右側に文字列char2を必要数追加して、n文字にします。char2の指定がなければ、ブランクが使用されます。
RTRIM(char[, set])	charから、setに含まれない文字が最後に出現した後の文字を末尾まで削除して返します。setのデフォルトは' '（1個のブランク）です。
SOUNDEX(char)	char内の単語の音を表す値を返します。
SUBSTR(char, m[,n])	charから、m文字目からn文字分を返します。nを省略すると、m文字目からcharの末尾までを返します。
SUBSTRB(char, m[,n])	引数mおよびnを文字数でなくバイト単位で指定する以外はSUBSTRと同じです。1バイトのデータベース文字セットの場合は、SUBSTRBとSUBSTRは同等の意味を持ちます。
UPPER(char)	charの全文字を大文字にして返します。


数値を返す文字関数

関連項目

文字関数で数値データを返すことができます。列および条件を定義する際に使用します。

省略形	説明
ASCII(char)	charの最初のキャラクタのASCII値を返します。
INSTR(char1, char2[,n[,m]])	char1内で、n文字目から検索を開始してm番目にchar2が出現する位置を返します。mを省略すると、1が指定されたとみなされます。nを省略すると、1が指定されたとみなされます。n>1の場合でも、char1の先頭文字を基準にした出現位置が返されます。
INSTRB(char1, char2[,n[,m]])	nおよび戻り値に文字数でなくバイト単位を使用する以外はINSTRと同じです。1バイトのデータベース文字セットの場合は、INSTRBとINSTRは同等の意味を持ちます。
LENGTH(char)	charの長さを文字数で返します。
LENGTHB(char)	charの長さを文字数でなくバイト単位で示す以外はLENGTHと同じです。charがNULLの場合、NULLを返します。1バイト・データベース・文字セットの場合は、LENGTHBとLENGTHは同等の意味を持ちます。
NLSSORT(char[, nlsparams])	charをソートするために使用する文字列を返します。nlsparamsで指定するパラメータには、NLS_SORT=sort形式を使用できます。sortはセッションでの使用言語によるソート順序またはBINARYです。BINARYが指定されるとcharを返します。ソート順序の詳細は、『Oracle8 Server概要』を参照してください。


変換関数

関連項目

変換関数は、列および条件を定義する際に、あるデータ型のデータを別のデータ型に変換するために使用します。

省略形	説明
TO_CHAR(d[,fmt])	dを、char値fmtで指定する書式のchar型に変換。fmtを省略すると、dはQuery Builderのデフォルトの日付書式YY-MM-DDのchar型に変換されます。
TO_CHAR(n[,fmt])	nを、char値fmtで指定する書式のchar型に変換。fmtを省略すると、nの桁数を格納するために必要な桁数分のchar型に変換されます。
TO_DATE(char[,fmt])	charで指定される日付を日付型に変換。fmtは、charの書式を指定するchar型です。fmtを省略すると、charはQuery Builderのデフォルトの日付書式YY-MM-DDになります。
TO_DATE(n,[fmt])	数値を日付に変換。fmtはTO_DATEで使用される場合には、日付型を生成する書式（例:JまたはMM）を指定する必要があります。
TO_LABEL(char[,fmt])	CHARデータ型またはVARCHAR2データ型で、fmtで示される書式のラベルを含むcharの文字値をMLSLABELデータ型の値に変換。fmtが指定されなければ、charはデフォルトのラベル書式を指定する必要があります。
TO_MULTI_BYTE(char)	char内の1バイト文字をすべて、対応するマルチバイト文字に変換した形でcharを返します。対応するマルチバイト文字のない1バイト文字は、出力文字中ですべて1バイト文字になります（この関数は、使用するデータベースのキャラクタ・セットに両方のタイプが含まれる場合のみ、利用価値があります）。
TO_NUMBER(char)	数値を含む文字データであるcharをnumber型に変換して返します。
TO_SINGLE_BYTE(char)	char内のマルチバイト文字をすべて、対応する1バイト文字に変換した形でcharを返します。対応する1バイト文字のないマルチバイト文字は、出力文字中ですべてマルチバイト文字になります（この関数は、使用するデータベースのキャラクタ・セットに両方のタイプが含まれる場合のみ、利用価値があります）。


日付関数

関連項目

日付関数は、数値データを返すMONTHS_BETWEEN以外はすべて日付データを返します。列および条件を定義する際に使用します。

省略形	説明
ADD_MONTHS(d,n)	日付dにnか月を加算します。
LAST_DAY(d)	日付dを含む月の末日。
MONTHS_BETWEEN (d,e)	日付dとeの間の月数。dがeより後であれば結果は正数、前であれば負数になります。
NEW_TIME(d,a,b)	タイムゾーンaにおける日時dをタイムゾーンbで示します。aおよびbは文字列で表され、その意味は次のとおりです。
AST,ADT:	大西洋標準時、大西洋夏時間
BST,BDT:	ベーリング標準時、ベーリング夏時間
CST,CDT:	中央標準時、中央夏時間
EST,EDT:	東部標準時、東部夏時間
GMT:	グリニッジ標準時
HST,HDT:	アラスカ・ハワイ標準時、アラスカ・ハワイ夏時間
MST,MDT:	山地標準時、山地夏時間
NST:	ニューファンドランド標準時
PST,PDT:	太平洋標準時、太平洋夏時間
YST,YDT:	ユーコン標準時、ユーコン夏時間
NEXT_DAY (d,char)	日付d以降に最初に来る、charで指定される曜日の日付。
ROUND(d[,fmt])	丸め単位fmtで指定される書式で丸めた値dを返します。fmtを省略すると、最も近い日を返します。
SYSDATE	現在の日付と時刻を返します。引数は不要です。
TRUNC(d[,fmt])	時刻を切り捨て単位fmtに切り捨てた値dを返します。fmtが指定されなければ、時刻が削除されます。
追加情報: ROUNDおよびTRUNC日付関数で使用する書式モデルの表については、『Oracle8 Server SQLリファレンス』を参照してください。


グループ関数

関連項目

グループ関数は、行ごとの1つ1つの結果ではなく、行のグループに基づくデータを取り出します。グループ関数は、平均、カウント、合計および標準偏差のような演算を行います。

またグループ関数を使用して新しい列を定義することもでき、他の列を表示しなければ、結果全体は1つのグループとして扱われます。他の列を表示すると、結果はより小さなグループに分割されます。グループ関数は条件で使用できる（ただし比較演算子を伴う場合のみ）ため、結果全体は1つのグループとして扱われます。たとえば、条件SALARY > AVG(SALARY)は、現在の行のSALARYの値がすべての行のSALARYの平均よりも大きい場合に真です。

グループ関数ではDISTINCTまたはALLオプションが使用できます。DISTINCTではグループ関数は表現の異なる関数のみを考慮します。たとえば、1、1、1、3の平均は1.5ですが、DISTINCTでの平均は2になります。ALLを使用すると、グループ関数は複製も含めてすべての値を考慮します。

以下のグループ関数ではすべて、COUNT(*)を除くNULL値をスキップします。exprがリストされていれば、引数のデータ型は、文字、数値、日付のいずれでもかまいません。

関数(引数)	説明
AVG([DISTINCT|ALL]n)	nの平均値、NULL値は無視します。
COUNT([DISTINCT|ALL]expr)	exprがNULLではない行の数。
COUNT(*)	表の行数。重複行およびNULL値を持つ行も含みます。
GLB([DISTINCT|ALL]label)	labelの最大下限を返します。
LUB([DISTINCT|ALL]label)	labelの最小上限を返します。
追加情報: GLBとLUBはMLSLABELデータ型の値を返します。GLBとLUB関数の詳細は、『Trusted Oracle8 Server管理者ガイド』を参照してください。

関数(引数)	説明
MAX([DISTINCT|ALL]expr)	exprの最大値。
MIN([DISTINCT|ALL]expr)	exprの最小値。
STDDEV([DISTINCT|ALL]n)	nの標準偏差、NULL値は無視。n-1（標本）計算を基にします。
SUM([DISTINCT|ALL]n)	nの値の合計。
VARIANCE([DISTINCT|ALL]n)	nの分散、NULL値は無視します。


その他の関数

関連項目

Query Builderは、以下の関数も使用できます。

関数(引数)	説明
USER	現在のOracleユーザーの名前を返します。引数は不要です。
DECODE(expr,search1, replace1[,search2, replace2,]...[default])	exprがいずれかのsearchと同等であれば、直後のreplaceを返します。同等でなければ、defaultを返します。defaultが指定されず、一致する値がなければ、NULLを返します。exprはいずれのデータ型でもかまいませんが、searchは、このデータ型と同じである必要があります。戻り値は、最初の戻り値と同じデータ型になります。
GREATEST(expr1,expr2,...)	リストの中で最大の値を返します。値expr1より後のすべてのexprは、比較が行われる前に、expr1と同じデータ型に変換されます。
GREATEST_LB(label[,label]...)	ラベルのリストの下限の最大値を返します。各labelは、MLSLABELまたはRAW MLSLABELのいずれかのデータ型であるか、デフォルトのラベル形式で引用符に囲まれたリテラルを指定する必要があります。戻り値のデータ型はRAW MLSLABELとなります。
LEAST(expr1,expr2,...)	リストで最小の値を返します。値expr1より後のすべてのexprは、比較が行われる前に、expr1と同じデータ型に変換されます。
LEAST_UB(label[,label]...)	ラベルのリストの上限の最小値を返します。各labelは、各labelは、MLSLABELまたはRAW MLSLABELのいずれかのデータ型であるか、デフォルトのラベル形式で引用符に囲まれたリテラルを指定する必要があります。戻り値のデータ型はRAW MLSLABELとなります。
NVL(x,expr)	XがNULLであればexprを返します。xがNULLでなければxを返します。xおよびexprはいずれのデータ型でもかまいません。戻り値は、xと同じデータ型になります。
追加情報: GREATEST_LBとLEAST_UBGLB関数の詳細は、『Trusted Oracle8 Server管理者ガイド』を参照してください。


 表をQuery Builderの作業領域に移動するには、目的の表を選択して「インクルード」をクリックする方法の他に、表をダブルクリックする方法があります。連続した範囲にある複数の表を指定するには、[Shift]キーを押しながら、その範囲にある最初と最後の表をクリックします。


リレーションはこのダイアログ・ボックスで設定できますが、できるだけマウスによる操作で作成してください。この方法で作成すると、Query Builderによってリレーション行が自動的にアクティブ化および非アクティブ化されます。


列に強調表示のチェック・マークが付いている場合には、その列がSELECT文の中にあり、問合せ結果の中に表示されることを示しています。また、列にグレー表示のチェック・マークが付いている場合は、列がソートまたはグループ検索条件として使用されることを示しています。


一般に、Query Builderでは、Oracleデータベースの暗黙的な変換機能を使用して解釈できる列を関連付けることができます。暗黙的な変換についての技術的な説明については、『Oracle8 Server SQLリファレンス』を参照してください。


「定義内容」フィールドの数式は、一般に関数または演算および操作の行われるデータベース列で構成されます。列名が複数の表にある場合、表の名前も必ず参照し、列名とはピリオドで区切ってください。列名が一意の場合、列名のみでかまいません。


表の名前を変更しても、データベースに登録してある名前は変更されません。新しい名前はアクティブな問合せにのみ有効であり、その問合せを保存するとその名前も保存されます。


「表リレーション設定」ダイアログ・ボックスを表示するには、アイコン・バーの [image] をクリックします。


「データ表選択」ダイアログ・ボックスを表示するには、アイコン・バーの [image] をクリックします。


「表を改名」ダイアログ・ボックスを表示するには、アイコン・バーの [image] をクリックします。


表から列オブジェクトを選択すると、Query Builderでは問合せで表の別名を自動的に使用します。同じように、「条件」フィールドに列オブジェクトを入れてその条件を受け入れると、Query Builderでは適切な表の別名を自動的に条件に挿入します。


列を選択（または選択解除）するには、次のいずれかの方法を使用します。

•	列の横のチェックボックスをチェックします（またはチェックを外します）。

または

列名をダブルクリックします。


 内部結合関係について

関連項目

内部結合関係は、表を表自体に関係付けます。内部結合関係は、同じ表に含まれる2つの列の間に親子関係を確立するために、限定的かつ、固有に使用されます。たとえば、内部結合関係を使用して子会社を親会社に関係付けたり、社員をその上司に関係付けたりすることができます。

内部結合関係は、表の各列が相互に対応していなければ、有効ではありません。たとえば、サンプル・データベースのEmployee表では、Manager IDがそのマネージャのEmployee IDと同じになっています。このため、内部結合関係アイコンがManager ID列に表示されています。


内部結合関係の作成

関連項目

内部結合関係を作成するには:

1	Query Builderの「リレーション設定」ダイアログ・ボックスに、選択した表とのリレーションが定義されている表のリストが表示されます。

2	表名をクリックします。

3	「インクルード」をクリックします。

4	「OK」をクリックします。

5	上記の手順を同じ表名に繰り返します。

6	関係付けられた表のコピーには、自動的に別名が割り当てられます。元の表名に適合するように、表名を変更します。

注意: データ・ディクショナリ内で、すでに内部結合関係が識別されていれば、表内で関係付けられた2つの列と別名はリレーション線で結合されています。データ・ディクショナリ内で内部結合関係が識別されていない場合は、一時的なリレーション線を引いて、表内の対応する2つの列と別名を結合し、内部結合関係を作成できます。


 単純関係の作成

関連項目

マウスを使用して関係を作成するには:

1	問合せウィンドウで、関係付ける表をオープンします。

2	表が表示された状態で、関係付ける列を選択します（外部キー）。

3	マウス・ボタンを押しながら、2番目の表の関係付ける列（主キー）にカーソルをドラッグし、関係線を引きます。

4	ターゲット列が強調表示された後、マウス・ボタンを離して関係線をアンカーします。デフォルトでは、関係は非アクティブになっています（線は灰色で表示されます）。

「リレーション設定」ダイアログ・ボックスを使用して関係を作成するには:

1	「リレーション設定」ダイアログ・ボックスで、元の列（A->）とターゲット列（->B）の名前を入力します。注意 2つの列の間に関係線が引かれます。

2	「クローズ」をクリックします。

ショートカットを使用して関係を作成するには:

1	「リレーション設定」ダイアログ・ボックスで、フィールドAの内側をクリックします。

2	問合せウィンドウで、列を選択します。フィールドAに、表名と列名が自動的に配置されます。

3	この手順をフィールドBで繰り返します。


複合関係の作成

関連項目

複合関係は、1つの表の複数の列を他の表の複数の列と結合します。たとえば、品目表にある受注番号のIDと品目IDの2つの列を、品目リスト表にある同名の2つの列と結合します。

複合関係を作成するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	結合する2つの表を組み込みます。

3	関係付ける列を選択します（外部キー）。

4	マウス・ボタンを押しながら、2番目の表の関係付ける列（主キー）にカーソルをドラッグします。カーソルの動きに合わせて、関係線が移動することに注意してください。

5	ターゲット列が強調表示された後、マウス・ボタンを離して関係線をアンカーします。デフォルトでは、関係は非アクティブになっています（線は灰色で表示されます）。

複合関係は、問合せの中で該当する数のみ使用することができます。また、複合関係には、他の関係で使用されている列も組み込むことができます。


完全な表名と列名を入力する必要があります（表名と列名はピリオドで区切ります）。A->は表の外部キーを表し、->Bは表の主キーを表します。追加の主キーと外部キーはカンマで区切ります。


不一致関係の作成

関連項目

不一致関係（外部関係）を作成するには:

1	問合せウィンドウで、表を結合する関係線をクリックします。関係線がない場合は、2つの表の間に単純関係を作成します。

2	「リレーション設定」ダイアログ・ボックスで、単純関係に含まれるすべてのレコードを取り出すか、両方の表に対応する値を持つ行のみを取り出すかのどちらかの表示オプションを選択します。

注意: 0（ゼロ）の値を返す行は、不一致の行とは異なります。「不一致を抑制」はNULL値を返す行のみに作用し、0を返す行には作用しません。この機能は、販売品目のない注文、注文したことがない顧客、顧客を持たない営業部員など、表に値が入力されていないデータを表示するときに使用します。


不一致の行の削除

関連項目

不一致関係を削除するには:

1	Query Builder作業領域で、ターゲット表を結合する関係線をクリックします。

2	「リレーション設定」ダイアログ・ボックスで、「不一致を抑制」ラジオ・ボタンを選択します。

3	「OK」をクリックします。


不等価関係の使用

関連項目

「リレーション設定」ダイアログ・ボックスで、不等価関係を作成するには:

演算子を選択します。

不等価関係を設定すると、Query Builderでは、関係線上にアイコン（不等号）が表示されます。


関係の削除

関連項目

関係を削除するには:

1	問合せウィンドウで、2つの表列を結合する関係線をクリックします。

2	両方の列名と関係線がハイライト表示されたら、[Del]キーを押します。


不一致（NULL）の行について

関連項目

Query Builderでは、問合せで関係を使用するときに、不一致の行を取り出すかどうかを選択できます。関係によって結合された表間で、1つの表の値に対してもう1つの表に対応する値がない場合、不一致の行が生じます。SQLのユーザーには、"外部結合"と呼ばれる問合せ条件としてよく知られています。通常、不一致の行はNULL値を戻します。

注意: 0（ゼロ）の値を返す行は、不一致の行とは異なります。「リレーション設定」ダイアログ・ボックスの「不一致を抑制」オプションはNULL値を返す行のみに作用し、0を返す行には作用しません。この機能は、品目のない注文など、表に値が入力されていないデータを表示するときに使用します。不一致関係を使用するときは、不一致のレコードを表示するための片方のみを選択できます。


新規問合せの作成

関連項目

新規問合せを作成するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	データを取り出す表をダブルクリックします。

3	「クローズ」をクリックしてダイアログ・ボックスをクローズし、表を表示します。

4	各列を選択します。選択した各列の横のチェックボックスに、チェック・マークが表示されます。すべての列を組み込むには、表タイトル・バーのチェックボックスをチェックします。ヒント

5	1つ以上の条件を入力して、問合せを詳細化します。

6	「OK」をクリックしてQuery Builderをクローズします。


使用可能な表の表示

関連項目

問合せの中で使用できる表を表示するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	「表示」チェックボックスを使用して、タイプ別に表をソートします。


表の消去

Query Builder作業領域から表を消去するには:

1	問合せウィンドウで表をクリックします。

2	アイコン・バーの [image] をクリックします。Query Builder作業領域から表が削除されます。をクリックすると、再び表を問合せに入れることができます。

表を削除または消去しても、データベースから表が削除されるわけではなく、単に問合せから表が削除されるのみです。


表の改名

関連項目

表を改名するには:注意

1	アイコン・バーの [image] をクリックします。

2	「表改名」ダイアログ・ボックスで、改名する表を「処理可能な表」リストから選択します。

3	「新規名」フィールドの内側をクリックします。

4	不要な情報を削除します。

5	表の新規名を入力します。新規名の長さは30文字までです。

6	「定義」をクリックします。

7	「OK」をクリックします。

Query Builder作業領域で表を改名しても、その基礎となる表では対応する名前は変更されません。新規名は、アクティブな問合せのみ有効となります。


表および列に関する情報とコメントの表示

データベースに格納されている情報およびコメントを表示するには:

作業領域内で、表に関する情報を参照するには、表ヘッダーの右にあるアイコンをダブルクリックします。列に関する情報を参照するには、各列の最初のアイコンをダブルクリックします。


問合せからの列の削除

関連項目

1つの問合せから1つの列を削除するには:

作業領域で、列を選択します。表内のチェック・マークが消えます。


問合せの行のカウント

問合せの実行前に問合せが返す行数をカウントするには:

  Query Builder作業領域で、アイコン・バーの [image] をクリックします。警告ボックスが表示され、取り出される行数が表示されます。


問合せに条件を追加

例	関連項目

問合せに条件を追加するには:

1	条件パネルのブランクの条件フィールドをクリックして、アクティブにします。プラス記号がカーソル矢印の隣に表示されます。マウス・ポインタを使用して、自動的にポイント、クリックして、フィールドの選択を行うことができます。

2	Query Builder作業領域で、条件を適用する列を選択します。使用可能なすべての列のリストを表示するには、アイコン・バーの [image] をクリックします。ヒント

3	アイコン・バーから、該当する「演算子」をクリックします。条件に関数を追加するには、アイコン・バーの [image] をクリックします。

4	演算子の後の条件式の右側に該当する値を入力します。その他の条件を追加するには、[Shift]キーを押しながら[Enter]キーを押し、カーソルを新規行に移動します。

5	式が完成したら、条件パネルの枠内で条件フィールド以外の場所をクリックして条件フィールドを非アクティブにするか、アイコン・バーの [image] をクリックします。条件パネルを消してやり直すには、アイコン・バーの [image] をクリックします。


条件について

例 	関連項目

条件は、必要な情報と不要な情報を選り分けるために、問合せの中に配置するテキスト句です。条件を使用すると表の列を取り出すことができるので、問合せに要する時間が短縮され、問合せを絞り込むことができます。ヒント

たとえば、問合せに従業員表を組み込み、従業員名、給与およびジョブ・タイトルの列を選択します。問合せに条件を組み込まない場合には、データベースに対して実際に「従業員表の従業員名、給与およびジョブの列からすべての従業員のデータを選択する」よう求めることになります。そこで、元の要求に次のような条件を追加できます。

•	月給が1000ドルを超え、2000ドル未満。

•	名字が「Smith」。

•	ジョブがマネージャ以外。

条件の中で、上記の例で示したワードをすべて入力するかわりに、「演算子」を使用すると、条件はほとんど1つの式のように表すことができます。たとえば、3000ドルを超える給与を得ている従業員を指定するには、次のように入力します。

SALARY > 3000

また、関数を使用して、複雑な条件を作成することもできます。


条件の例

関連項目 	すべての例

カリフォルニア州に関するデータのみを表示する問合せを作成すると仮定します。

1	条件フィールドをクリックしてアクティブにします。

2	Query Builder作業領域で、該当する表の「State」列を選択します。条件フィールドに「STATE」の表示が現れます。

3	等号（=）を入力します。

4	条件フィールド内の等号の右隣に'CA'を入力します。

条件は、STATE='CA'と表されているはずです。


演算子について

関連項目

演算子とは、なんらかの演算を実行するときに使用する文字または予約語のことです。Query Builderでは、主に次の3種類の演算子が使用されます。

•	比較

•	算術

•	論理

注意: これらの演算子を基に、否定条件を作成することもできます。


比較演算子

関連項目

比較演算子は、2つの値を比較するときに使用します。条件パネルで列名と値の間に演算子を挿入すると、Query Builderはその列のすべての項目を値と比較して、条件文が当てはまる行のみを返します。

たとえば、CREDIT_LIMIT列の値が6,000ドル未満の行のみを返すには、<（より小さい）演算子を次のように使用します。

CREDIT_LIMIT < 6000

Query Builderの比較演算子

演算子	使用方法
=	等しい
<>	等しくない
<	より小さい
<=	以下
>	より大きい
>=	以上
BETWEEN...AND...	2つの値の間
IN (LIST)	次のリストのいずれかのメンバーに等しい
IS NULL	NULL値。1つの列に値のない行は、NULL値を含む行と呼ばれます。


算術演算子

関連項目

算術演算子は、数値および日付の列で計算を行うときに使用します。計算を処理する場合、Query Builderは最初に乗算または除算を評価し、次に加算または減算を評価します。

•	たとえば、式1+2x3では、最初に2と3を乗算し、その結果に1を足すので、最終的な結果は7になります。

このような優先順位のルールを上書きするには、式の一部をカッコの中に入れます。Query Builderは、カッコの中の式を最初に評価します。

•	たとえば、計算(1+2)x3では、(1+2)が最初に評価され、その結果に3を乗算するので、最終的な結果は9になります。

Query Builderの算術演算子

演算子	使用方法
+	加算
-	減算
*	乗算
/	除算


論理演算子

関連項目

論理演算子（ブール演算子とも呼ばれます）には、AND、ORおよびNOTがあります。

•	ANDは、すべての条件に適合するデータのみを取り出すときに使用します。

•	ORは、指定した条件のうち少なくとも1つに適合するすべてのデータを取り出すときに使用します。

•	NOTは、演算子または条件を否定するときに使用します。

アイコン・バーには、論理演算子用のアイコンがあります。演算子のアイコンは、条件パネルがアクティブになっているとき、または「列定義」ダイアログ・ボックスがオープンしているときに使用できます。アイコン・バーの演算子をクリックすると、条件のテキストまたは定義済み列に演算子を挿入できます。


定義済み（および計算済み）列について

例 	関連項目

Query Builderがデータベースから取り出すデータを計算し、計算済みのデータを新規列（定義済みフィールドとも呼ばれます）として結果ウィンドウに表示することができます。これらの列は、問合せの他の列と同じように名前を付けたり、定義したり、表示したりできます。

Query Builderの問合せで定義済み列を使用すると、"もし～ならば（what if）"のシナリオ、予測、見積りおよび平方偏差や合計に対する割合などの分析を行うことができます。

注意: 集計関数を含む定義済み列（フィールド）を表示すると、Query Builderは対応するGROUP BY句を、集計関数を含まない他の表示される列に自動的に生成します。熟練したユーザーであれば、表示されない列でグループ化するためのGROUP BY列を手動で指定することもできます。

通常、列は「表に格納されたデータの列」と同義ですが、他の列の値から導出または算出された、1つの問合せ内のデータの新規列を表すこともあります。これらの算出された列は、導出済みフィールドまたは定義済みフィールドと呼ばれることがあります。たとえば、従業員表に、給与とコミッションという報酬を記述する2つの列を組み込む場合があります。これらの列の値を、給与とコミッションの合計を示す純支出（Net Pay）という新規列に組み合せる定義済み列を作成することができます。

定義済み列は、必要に応じて1つまたは複数のデータベース列の任意の組合せを基に作成できます。

定義済み列は問合せの中に存在し、データベースには存在しません。定義済み列を列として結果ウィンドウに表示することも、（他の定義済み列の作成に使用するときのように）非表示のままにしておくこともできます。

注意: 定義済み列は問合せの一部にすぎず、データベースに保存された表定義を変更することはありません。


定義済み列の削除

関連項目

問合せから定義済み列を削除するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	削除する列名をクリックします。

3	「削除」をクリックします。


定義済み（および計算済み）列の例

関連項目 	すべての例

たとえば、10%の給与増加を見込んで、来年度の純支出（NET_PAY_NEXT）の予算を見積もるとします。「式」フィールドに次のように入力します。

(SALARY*1.1) + COMMISSION

また、給与とコミッションがそれぞれ10%増加した場合の純支出を検討したいときには、次のように入力します。

(SALARY+COMMISSION) * 1.1

NET_PAYは、SALARY+COMMISSIONなので、これは次の式と同じです。

NET_PAY * 1.1

現行の純支出と来年度の見込み予算の差額を表示する定義済み列を作成することもできます。この列をVARIANCEと名付け、次のように定義します。

NET_PAY_NEXT - NET_PAY

新規列を定義する場合、式に記述する基本列が、基礎となるデータベース内に存在しなくてもかまいません。ただし、最終的には、これらの列は基礎となる表内の列から導出されることになります。たとえば、VARIANCEは次の式と同じです。

((SALARY+COMMISSION) * 1.1) - (SALARY+COMMISSION)


ソート列の削除

関連項目

ソート列を削除するには:

1	Query Builder作業領域で、「ソート」アイコンをクリックします。

2	「ソート済み列」リストで、削除する列名をダブルクリックします。


問合せデータのソート

関連項目

問合せで取り出されたデータをソートするには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	「使用可能列」リストで、ソートの基準にしたい列をダブルクリックします。ソート列は、問合せの中に組み込む必要はありません。

列のデフォルト（昇順）のソート順を変更するには:

1	「ソート済み列」リストで、強調表示する列をクリックします。

2	「降順」ラジオ・ボタンをクリックします。

3	「OK」をクリックします。


列の定義

関連項目

表に新規列を定義するには:

1	列を定義する表をオープンします。

2	アイコン・バーの [image] をクリックします。

3	「定義済み列」ボックスの内側をクリックします。

4	新規列の名前を入力します。

5	「定義内容」ボックスの内側をクリックします。

6	列を定義する式を入力します。

7	「OK」をクリックします。


関数のペースト

例 	関連項目

条件に関数をペーストするには:

1	条件フィールドをアクティブにして、関数を挿入したい位置にカーソルを移動します。

2	アイコン・バーの [image] をクリックします。

3	「カテゴリ表示」チェックボックスを使用して、表示する関数のタイプをフィルタします。

4	リスト・ボックスから関数を選択します。

5	デフォルトの引数を組み込む場合は、「引数ペースト」チェックボックスをクリックします。

6	「OK」をクリックします。

7	条件フィールドで、使用する引数をデフォルトの引数の上から入力します。


関数の例（30文字を超える名前の取出し）

関連項目 	すべての例

メール・ラベルには長すぎる30文字以上の名前の全顧客名をリストしたいと希望しているとします。これらの名前をリストするには、LENGTH関数を使用して条件を作成します。LENGTHは、1つの文字列の文字数をカウントします。

この例では、LENGTH関数内の引数は、顧客表のNAME列です。したがって、関数は条件の中で次のように表されます。

LENGTH (NAME) > 30

Query Builderでは、この条件を使用してNAME列のすべての名前を評価し、フィールド長が30文字より大きい名前を戻します。


ネストした条件の作成

関連項目

ネストした条件を作成するには:

1	「条件」フィールドに、比較演算子を使用して最初の式を入力します（例: TOTAL<1000）。ヒント

2	別の比較演算子を使用して2番目の式を入力します（例: EMP.LAST_NAME=SMITH）。

3	同じ比較演算子（=）を使用して3番目の式を入力します（例: EMP.LAST_NAME=JONES）。

4	2番目と3番目の式を選択します。

5	アイコン・バー.の [image] をクリックします。

6	アイコン・バーの [image] をクリックします。


条件パネルのサイズ設定

条件パネルをサイズ設定するには:

1	Query Builder作業領域スクロール・バーの左下にある黒い四角形をクリックし、カーソルをQuery Builder作業領域まで移動します。

2	条件パネルの幅を広げたり狭めたりするには、黒の太線を左または右にドラッグします。パネル全体が見えなくなると、スクロール・バーの左端に分割バーが表示されます。


条件の構文

関連項目

条件の一般的な書式は次のとおりです。

[expression] [operator] [expression]

各項目の内容は次のとおりです。

expression	条件を定義する値を指定します。式には日付、文字、リテラル値、数字、列、関数およびデータベース列を指定できます。
operator	より大きい（>）、より小さい（<）、等しい（=）などの比較演算子を指定します。頻繁に使用される演算子は、「データ」メニューとアイコン・バーに表示されます。また、BETWEEN、LIKE、INなどの特殊な比較演算子も数多くあります。
日付値

日付を扱う場合、比較演算子は相対的な時間を表します。つまり、"より少ない"（<）は"より前"を意味します。

日付値は一重引用符で囲み、DD-MON-YY形式で指定する必要があります。DDはカレンダーの日付、MONは月、YYは年を表します。

文字値

文字の列では、演算子は英数字順を表します。（AはBより前にあるので、Aで始まる名前はBで始まる名前より"少なく"なります。それ以降も同様です。

リテラル値

リテラル値は、列名と区別するために一重引用符で囲む必要があります。データベース値と指定する値の間の比較には、大/小文字の区別があります。

数字値

入力する値がNUMBERデータ型の場合は、その数字のみを入力します。つまり、カンマや通貨記号（$）などの書式を使用することはできません。数字列の数字値を引用符で囲む必要はありません。

注意: 3種類の論理（ブール）演算子（AND、OR、NOT）を使用すると、複数または否定の条件を作ることもできます。

追加情報: さまざまなデータ型のOracle構文の詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


否定条件の作成

関連項目

否定条件を作成するには:

1	条件を作成します。

2	「条件」フィールドをクリックしてアクティブにします。

3	条件の論理演算子を選択します。

4	アイコン・バーの [image] をクリックします。

5	[Enter]または[Return]キーを押して、条件を確定します。

注意: NOT ANDは、すべての条件を満たす行を除く全行を戻します。NOT ORは、いずれかの条件を満たす行を除く全行を戻します。


問合せのSQL文の保存

関連項目

問合せのSQL文を保存するには:

問合せウィンドウで、「ファイル」 [image] 「保存」を選択して「別名保存」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、ディレクトリとファイル名を指定できます。


列の順序の変更

関連項目

問合せ結果内の列の表示順序を変更するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	「列順序」ダイアログ・ボックスで、「表示される列」リストの列をクリックし、目的の位置にドラッグします。先頭の列は一番左に、最後の列は一番右に表示されます。


問合せのSQL文の表示

関連項目

問合せのSQL文を表示するには:

  Query Builder作業領域で、アイコン・バーの [image] をクリックします。

「SQLの表示」ダイアログ・ボックスは読込み専用です。SQL文を編集またはコピーすることはできません。


問合せへの列の追加

関連項目

問合せに列を追加するには:

問合せウィンドウで、表内の列を選択します。ヒント

チェックされた列は、SQL文および問合せ結果の両方に表示されることを示しています。SQL文に列を組み込み、表示結果の列を非表示にすることはできません。


例

  アルファベット順リスト

アプリケーション・プロパティの例

円弧プロパティの例

軸（値）プロパティの例

軸（日付）プロパティの例

軸（項目）プロパティの例

軸（一般）プロパティの例

ビルトインの例

チャート・ビルトインの例

チャート要素プロパティの例

チャート・プロパティの例

複数テキスト・プロパティの例

データベース・ビルトインの例

図表ビルトインの例

図表プロパティの例

フィールド・テンプレート（軸チャート）プロパティ

フィールド・テンプレート（一般）プロパティの例

枠（軸チャート）プロパティの例

枠（一般）プロパティの例

枠（円グラフ）プロパティの例

枠（表チャート）プロパティの例

一般プロパティの例

図形オブジェクト・ビルトインの例

図形プロパティの例

グループ・プロパティの例

イメージ・プロパティの例

レイヤー・ビルトインの例

線プロパティの例

その他のビルトインの例

パラメータ・ビルトインの例

多角形プロパティの例

プリンタ・プロパティの例

プロパティの例

問合せビルトインの例

問合せプロパティの例

四角形プロパティの例

参照線プロパティの例

丸い四角形プロパティの例

単純テキスト・プロパティの例

サウンド・ビルトインの例

サウンド・プロパティの例

記号プロパティの例

テンプレート・ビルトインの例

テキスト・プロパティの例

タイマー・ビルトインの例

タイマー・プロパティの例

TOOLS_INTビルトインの例

ウィンドウ・ビルトインの例

ウィンドウ・プロパティの例


プロパティの例

  アルファベット順リスト      [image]  すべての例

アプリケーション・プロパティの例

円弧プロパティの例

軸（値）プロパティの例

軸（日付）プロパティの例

軸（項目）プロパティの例

軸（一般）プロパティの例

チャート要素プロパティの例

チャート・プロパティの例

複数テキスト・プロパティの例

図表プロパティの例

フィールド・テンプレート（軸チャート）プロパティ

フィールド・テンプレート（一般）プロパティの例

枠（軸チャート）プロパティの例

枠（一般）プロパティの例

枠（円グラフ）プロパティの例

枠（表チャート）プロパティの例

一般プロパティの例

図形プロパティの例

グループ・プロパティの例

イメージ・プロパティの例

線プロパティの例

多角形プロパティの例

プリンタ・プロパティの例

問合せプロパティの例

四角形プロパティの例

参照線プロパティの例

丸い四角形プロパティの例

単一テキスト・プロパティの例

サウンド・プロパティの例

記号プロパティの例

テキスト・プロパティの例

タイマー・プロパティの例

ウィンドウ・プロパティの例


ビルトインの例

  アルファベット順リスト      [image]  すべての例

チャート・ビルトインの例

データベース・ビルトインの例

図表ビルトインの例

図形オブジェクト・ビルトインの例

レイヤー・ビルトインの例

その他のビルトインの例

パラメータ・ビルトインの例

問合せビルトインの例

サウンド・ビルトインの例

テンプレート・ビルトインの例

タイマー・ビルトインの例

TOOLS_INTビルトインの例

ウィンドウ・ビルトインの例


アプリケーション・プロパティの例

  すべての例     [image]  関連項目

接続文字列プロパティの例

カーソル・プロパティの例

水平レイアウト解像度プロパティの例

水平画面解像度プロパティの例

パスワード・プロパティの例

プラットフォーム・プロパティの例

ユーザー名プロパティの例

垂直レイアウト解像度プロパティの例

垂直画面解像度プロパティの例


円弧プロパティの例

  すべての例     [image]  関連項目

基本円弧プロパティの例

閉じプロパティの例

塗り形状プロパティの例


軸（日付）プロパティの例

  すべての例     [image]  関連項目

自動最大値プロパティの例

自動最小値プロパティの例

自動ステップ・プロパティの例

カスタム書式プロパティの例

曜日書式プロパティの例

年の最初の月プロパティの例

ラベル・プロパティの例

最大値プロパティの例

最小値プロパティの例

月書式プロパティの例

四半期書式プロパティの例

週末をスキップ・プロパティの例

ステップ・プロパティの例

年書式プロパティの例


軸（一般）プロパティの例

  すべての例     [image]  関連項目

軸ラベル・プロパティの例

軸タイプ・プロパティの例

カスタム・ラベル・プロパティの例

方向プロパティの例

主目盛格子プロパティの例

主目盛きざみプロパティの例

補助目盛格子プロパティの例

補助きざみ数プロパティの例

位置プロパティの例

目盛きざみラベル・プロパティの例

目盛きざみ位置プロパティの例

目盛きざみラベル回転プロパティの例


軸（項目）プロパティの例

  すべての例     [image]  関連項目

自動最大値プロパティの例

自動最小値プロパティの例

日付書式プロパティの例

最大項目数プロパティの例

最小項目数プロパティの例

数値書式プロパティの例


軸（値）プロパティの例

  すべての例     [image]  関連項目

自動最大値プロパティの例

自動最小値プロパティの例

自動ステップ・プロパティの例

最大値プロパティの例

最小値プロパティの例

数値書式プロパティの例

パーセント・プロパティの例

パーセント基準プロパティの例

スケール・プロパティの例

ステップ・プロパティの例


チャート・ビルトインの例

  すべての例    [image]  関連項目

OG_Delete_Columnの例

OG_Delete_Fieldの例

OG_Get_Chart_Elementの例

OG_Get_Columnの例

OG_Get_Fieldの例

OG_Get_Rowの例

OG_Insert_Fieldの例

OG_Make_Chartの例

OG_Update_Chartの例


チャート要素プロパティの例

  すべての例     [image]  関連項目

ボタン・プロシージャ・プロパティの例

イベント・プロパティの例

展開プロパティの例

名前プロパティの例


チャート・プロパティの例

  すべての例     [image]  関連項目

自動更新プロパティの例

行終了プロパティの例

フィルタ・プロパティの例

問合せプロパティの例

範囲プロパティの例

サイズと位置プロパティの例

行開始プロパティの例

テンプレート・プロパティの例

タイトル・プロパティの例


複数テキスト・プロパティの例

  すべての例     [image]  関連項目

単一テキスト数プロパティの例


データベース・ビルトインの例

  すべての例     [image]  関連項目

OG_Connectの例

OG_Logged_Onの例

OG_Logoffの例

OG_Logonの例


図表ビルトインの例

  すべての例     [image]  関連項目

OG_Close_Displayの例

OG_Generate_Displayの例

OG_Get_Displayの例

OG_Isnullの例

OG_Open_Displayの例

OG_Save_Displayの例


図表プロパティの例

  すべての例     [image]  関連項目

クローズ・トリガー・プロパティの例

日付書式プロパティの例

高さプロパティの例

オープン・トリガー・プロパティの例

幅プロパティの例


枠（軸チャート）プロパティの例

  すべての例     [image]  関連項目

基本軸プロパティの例

基本線の値プロパティの例

項目幅プロパティの例

カスタム日付書式プロパティの例

カスタム数値書式プロパティの例

参照線数プロパティの例

第２-Y軸プロパティの例


枠（一般）プロパティの例

  すべての例     [image]  関連項目

深さサイズ・プロパティの例

枠タイプ・プロパティの例

フィールド・テンプレート数プロパティの例

凡例中の列数プロパティの例

凡例プロパティの例

名前プロパティの例

表示枠プロパティの例

ルート・プロパティの例

シャドウ方向プロパティの例

シャドウ・サイズ・プロパティの例


枠（円グラフ）プロパティの例

  すべての例     [image]  関連項目

項目プロパティの例

データ値プロパティの例

項目日付書式プロパティの例

オーバーラップなしプロパティの例

項目数値書式プロパティの例

その他プロパティの例

パーセント書式プロパティの例

パーセント値プロパティの例

表示順序プロパティの例

目盛きざみプロパティの例

使用方法プロパティの例

使用方法の値プロパティの例

値書式プロパティの例


枠（表チャート）プロパティの例

  すべての例     [image]  関連項目

自動最大値プロパティの例

自動最小値プロパティの例

列名プロパティの例

格子数プロパティの例

水平格子プロパティの例

最大行数プロパティの例

最小行数プロパティの例

垂直格子プロパティの例


フィールド・テンプレート（一般）プロパティの例

  すべての例     [image]  関連項目

カラー回転プロパティの例

日付書式プロパティの例

名前プロパティの例

数値書式プロパティの例

ルート・プロパティの例


フィールド・テンプレート（軸チャート）プロパティ

  すべての例     [image]  関連項目

軸プロパティの例

カーブ調整プロパティの例

ラベル回転プロパティの例

線の形式プロパティの例

オーバーラップ・プロパティの例

表示位置プロパティの例

表示形式プロパティの例


一般プロパティの例

  すべての例     [image]  関連項目

ボタン・プロシージャ・プロパティの例

列プロパティの例

イベント・プロパティの例

問合せ実行プロパティの例

フォーマット・トリガー・プロパティの例

内側枠ボックス・プロパティの例

名前プロパティの例

外側枠ボックス・プロパティの例

オブジェクト型プロパティの例

親プロパティの例

パラメータ設定プロパティの例

隠しオブジェクト・プロパティの例


グラフィック・プロパティの例

  すべての例     [image]  関連項目

バックグラウンド線カラー・プロパティの例

凹凸スタイル・プロパティの例

バックグラウンド塗りカラー・プロパティの例

端形式プロパティの例

線種スタイル・プロパティの例

境界線パターン・プロパティの例

境界線幅プロパティの例

フォアグラウンド線カラー・プロパティの例

フォアグラウンド塗りカラー・プロパティの例

塗りパターン・プロパティの例

結合形式プロパティの例

回転角度プロパティの例

転送モード・プロパティの例


グループ・プロパティの例

  すべての例     [image]  関連項目

子数プロパティの例

クリップ・フラグ・プロパティの例


イメージ・プロパティの例

  すべての例     [image]  関連項目

クリップ四角形プロパティの例

粗さプロパティの例

高さプロパティの例

位置プロパティの例

品質プロパティの例

幅プロパティの例


レイヤー・ビルトインの例

  すべての例     [image]  関連項目

OG_Activate_Layerの例

OG_Get_Layerの例

OG_Hide_Layerの例

OG_Show_Layerの例


線プロパティの例

  すべての例     [image]  関連項目

矢印スタイル・プロパティの例

終了点プロパティの例

開始点プロパティの例


その他のビルトインの例

  すべての例     [image]  関連項目

OG_Append_Directoryの例

OG_Append_Fileの例

OG_Centerの例

OG_Damage（領域）の例

Do_Sqlの例

OG_Get_Attr（アプリケーション）の例

OG_Get_Attr（軸）の例

OG_Get_Attr（図表）の例

OG_Get_Attr（フィールド・テンプレート）の例

OG_Get_Attr（枠テンプレート）の例

OG_Get_Attr（オブジェクト）の例

OG_Get_Attr（プリンタ）の例

OG_Get_Attr（問合せ）の例

OG_Get_Attr（参照線）の例

OG_Get_Attr（サウンド）の例

OG_Get_Attr（タイマー）の例

OG_Get_Attr（ウィンドウ）の例

OG_Translate_Envvarの例

OG_User_Exitの例


グラフィック・オブジェクト・ビルトインの例

  すべての例     [image]  関連項目

OG_Clone（オブジェクト）の例

OG_Damage（オブジェクト）の例

OG_Delete_Childの例

OG_Delete_Cmptextの例

OG_Delete_Pointの例

OG_Delete_Propertyの例

OG_Delete_Smptextの例

OG_Destroy（オブジェクト）の例

OG_Drawの例

OG_Export_Drawing（図表）の例

OG_Export_Drawing（オブジェクト/レイヤー）の例

OG_Export_Drawing（ウィンドウ）の例

OG_Export_Imageの例

OG_Get_Char_Propertyの例

OG_Get_Childの例

OG_Get_Cmptextの例

OG_Get_Date_Propertyの例

OG_Get_Num_Propertyの例

OG_Get_Objectの例

OG_Get_Pointの例

OG_Get_Smptextの例

OG_Import_Drawingの例

OG_Import_Imageの例

OG_Insert_Childの例

OG_Insert_Cmptextの例

OG_Insert_Pointの例

OG_Insert_Smptextの例

OG_Make_Ellipseの例

OG_Make_Groupの例

OG_Make_Imageの例

OG_Make_Lineの例

OG_Make_Polyの例

OG_Make_Rectの例

OG_Make_Rrectの例

OG_Make_Symbolの例

OG_Make_Textの例

OG_Moveの例

OG_Point_Inの例

OG_Point_Nearの例

OG_Property_Existsの例

OG_Rotateの例

OG_Sameの例

OG_Scaleの例

OG_Set_Edgecolorの例

OG_Set_Fillcolorの例

OG_Set_Propertyの例

OG_Synchronizeの例

OG_Update_Bboxの例


パラメータ・ビルトインの例

  すべての例     [image]  関連項目

OG_Delete_Paramの例

OG_Get_Char_Paramの例

OG_Get_Date_Paramの例

OG_Get_Num_Paramの例

OG_Get_Param_Typeの例

OG_Param_Existsの例

OG_Set_Paramの例


多角形プロパティの例

  すべての例     [image]  関連項目

閉じプロパティの例

点数プロパティの例


プリンタ・プロパティの例

  すべての例     [image]  関連項目

部数プロパティの例

終了ページ・プロパティの例

印刷ファイル・プロパティの例

横プロパティの例

名前プロパティの例

ページ・サイズ・プロパティの例

開始ページ・プロパティの例


問合せビルトインの例

  すべての例     [image]  関連項目

OG_Append_Rowの例

OG_Clear_Queryの例

OG_Data_Changedの例

OG_Data_Queriedの例

OG_Destroy（問合せ）の例

OG_Execute_Queryの例

OG_Get_Charcellの例

OG_Get_Datecellの例

OG_Get_Newrowsの例

OG_Get_Numcellの例

OG_Get_Queryの例

OG_Get_Schemaの例

OG_Insert_Columnの例

OG_Make_Queryの例

OG_Next_Rowの例

OG_Numcolsの例

OG_Numrowsの例

OG_Set_Charcellの例

OG_Set_Datecellの例

OG_Set_Numcellの例

OG_Set_Schemaの例

OG_Start_Fromの例


問合せプロパティの例

  すべての例     [image]  関連項目

キャッシュ・タイプ・プロパティの例

カスタム問合せプロシージャ・プロパティの例

日付書式プロパティの例

オープン時に実行プロパティの例

タイマーで実行プロパティの例

最大行フラグ・プロパティの例

最大行プロパティの例

名前プロパティの例

Post-Queryトリガー・プロシージャ・プロパティの例

問合せソース・プロパティの例

問合せタイプ・プロパティの例


四角形プロパティの例

  すべての例     [image]  関連項目

基本四角形プロパティの例


参照線プロパティの例

  すべての例     [image]  関連項目

軸プロパティの例

日付値プロパティの例

ラベル・プロパティの例

数値プロパティの例


丸い四角形プロパティの例

  すべての例     [image]  関連項目

基本四角形プロパティの例

丸め半径プロパティの例


サウンド・プロパティの例

  すべての例     [image]  関連項目

名前プロパティの例


サウンド・ビルトインの例

  すべての例     [image]  関連項目

OG_Destroy（サウンド）の例

OG_Export_Soundの例

OG_Get_Soundの例

OG_Import_Soundの例

OG_Make_Soundの例

OG_Play_Soundの例

OG_Record_Soundの例

OG_Stop_Soundの例


単純テキスト・プロパティの例

  すべての例     [image]  関連項目

カラー・プロパティの例

フォント・プロパティの例

テキスト文字列プロパティの例


記号プロパティの例

  すべての例     [image]  関連項目

中央プロパティの例

索引プロパティの例

記号サイズ・プロパティの例


テンプレート・ビルトインの例

  すべての例     [image]  関連項目

OG_Clone（テンプレート）の例

OG_Delete_Ftempの例

OG_Delete_Reflineの例

OG_Destroy（テンプレート）の例

OG_Export_Templateの例

OG_Get_Axisの例

OG_Get_Ftempの例

OG_Get_Reflineの例

OG_Get_Templateの例

OG_Import_Templateの例

OG_Insert_Ftempの例

OG_Insert_Reflineの例

OG_Make_Templateの例


タイマー・プロパティの例

  すべての例     [image]  関連項目

アクティブ・プロパティの例

間隔プロパティの例

名前プロパティの例

プロシージャ・プロパティの例


タイマー・ビルトインの例

  すべての例     [image]  関連項目

OG_Activate_Timerの例

OG_Deactivate_Timerの例

OG_Destroy（タイマー）の例

OG_Get_Timerの例

OG_Make_Timerの例


TOOLS_INTビルトインの例

  すべての例     [image]  関連項目

Tool_Int.Add_Parameterの例

Tool_Int.Create_Parameter_Listの例

Tool_Int.Delete_Parameterの例

Tool_Int.Destroy_Parameter_Listの例

Tool_Int.Get_Parameter_Attrの例

Tool_Int.Get_Parameter_Listの例

Tool_Int.Isnullの例

Tool_Int.Run_Productの例

Tool_Int.Set_Parameter_Attrの例


テキスト・プロパティの例

  すべての例     [image]  関連項目

バウンディング・ボックス高さプロパティの例

バウンディング・ボックス幅プロパティの例

キャラクタ・セット・プロパティの例

カラー・プロパティの例

複数テキスト・カウント・プロパティの例

カスタム間隔プロパティの例

固定バウンディング・ボックス・プロパティの例

水平方向整列プロパティの例

水平原点プロパティの例

非表示プロパティの例

カーニング・プロパティの例

近似プロパティの例

ポイント・サイズ・プロパティの例

スケーラブルな境界線プロパティの例

スケーラブル・フォント・プロパティの例

間隔プロパティの例

スタイル・プロパティの例

シンクロ・プロパティの例

タイプフェース・プロパティの例

垂直整列プロパティの例

垂直原点プロパティの例

フォントの太さプロパティの例

幅プロパティの例

丸めプロパティの例


ウィンドウ・プロパティの例

  すべての例     [image]  関連項目

高さプロパティの例

ヘルプ・ターゲット・プロパティの例

名前プロパティの例

位置プロパティの例

幅プロパティの例


ウィンドウ・ビルトインの例

  すべての例     [image]  関連項目

OG_Destroy（ウィンドウ）の例

OG_Get_Window

OG_Hide_Windowの例

OG_Make_Windowの例

OG_Show_Windowの例


複数テキスト・プロパティ

単一テキスト・カウント・プロパティ

複数テキスト・カウント・プロパティ


単一テキスト・カウント・プロパティ

  例	  関連項目

説明  複数テキスト要素を構成する単一テキスト要素の数です。

構文

FUNCTION OG_Get_Stcount
  (text OG_Object,
   cmptext_index  NUMBER)
RETURN NUMBER;

パラメータ

text	記述するテキスト要素です。
cmptext_index	定義中の複数テキスト要素の索引番号。


単一テキスト・カウント・プロパティの例

  アルファベット順リスト [image]  すべての例 [image]  関連項目

*/The following procedure reads the count of
**simple text of the first compound
**text in a text object, and prints the count
**back to the text object.
*/

PROCEDURE simpleText IS

num number;

text og_object;

BEGIN

text := og_get_object('text');

num := og_get_stcount(text,0);

og_set_str(text, num);

END;