バージョン 4.2.5
 —  ステートメント  —

WRITE TITLE

WRITE [(rep)]TITLE [LEFT [JUSTIFIED]] [UNDERLINED]  
  [(statement-parameters)]  
 

nX

'text' [(attributes)]

  nT 'c'( n ) [(attributes)]
  x/y ['='] operand1 [(parameters)]
  [SKIP operand2 [LINES]]    

このドキュメントでは、次のトピックについて説明します。

構文図で使用されている記号については、「構文記号」を参照してください。

関連ステートメント:AT END OF PAGE | AT TOP OF PAGE | CLOSE PRINTER | DEFINE PRINTER | DISPLAY | EJECT | FORMAT | NEWPAGE | PRINT | SKIP | SUSPEND IDENTICAL SUPPRESS | WRITE | WRITE TRAILER

関連機能グループ:「出力レポートの作成


機能

WRITE TITLE ステートメントは、デフォルトのページタイトルではなくユーザー指定のページタイトルを表示するために使用します。 このステートメントは、新しいページが始まるたびに実行されます。

プログラミングガイド』の次のセクションも参照してください。

処理

このステートメントは非手続き型なので、プログラム内の位置ではなくイベントによって実行されます。

レポートが、異なるオブジェクト内のステートメントによって作成される場合、WRITE TITLE ステートメントは、新ページを作成するステートメントと同じオブジェクトで使用されている場合に限って実行されます。

Top of page

制限事項

Top of page

構文説明

オペランド定義テーブル:

オペランド 構文要素 フォーマット ステートメント参照 ダイナミック定義
operand1   S A G N A U N P I F B D T L   G O 不可
operand2 C S           N P I   B             不可

構文要素の説明:

(rep)
レポート指定:

複数のレポートを作成するときは、表記 (rep) を使用して、WRITE TITLE ステートメントを適用するレポートの ID を指定できます。

レポート ID として、範囲 0~31 の値、または DEFINE PRINTER ステートメントを使用して割り当てた論理名を指定できます。

(rep) 指定がない場合、WRITE TITLE ステートメントは最初のレポート(レポート 0)に適用されます。

Natural で作成される出力レポートの形式を制御する方法については、『プログラミングガイド』の「データ出力制御」を参照してください。

LEFT JUSTIFIED
UNDERLINED

桁揃えおよび下線

デフォルトでは、ページタイトルは中央揃えで下線なしです。 LEFT JUSTIFIEDUNDERLINED を指定して上書きできます。

UNDERLINED を指定した場合、下線文字(デフォルトの文字または FORMAT ステートメントのセッションパラメータ UC で指定された文字)が、タイトルの下に行サイズ(セッションパラメータ LS を参照)の幅だけ出力されます。

Natural では、すべての間隔およびタブ指定を適用して行を作成してから、行全体を中央揃えします。 例えば、最初の要素としての 10T 表記により、中央揃えされたヘッダーは右側の 5 の位置に配置されます。

statement-parameters
ステートメントレベルでのパラメータ定義:

1 つまたは複数のパラメータをカッコで囲んで、ステートメントレベルで、つまり WRITE TITLE ステートメントの直後に指定できます。 この方法で指定した各パラメータは、以前に GLOBALS コマンド、SET GLOBALS ステートメント(レポーティングモードでのみ)、または FORMAT ステートメントで指定したパラメータを上書きします。

複数のパラメータを指定する場合は、各エントリ間に 1 つ以上の空白を配置する必要があります。 エントリを 2 行のステートメント行に分割することはできません。

注意:
ここで適用されるパラメータ設定は、変数フィールドにのみ関連し、テキスト定数には影響しません。 テキスト定数にフィールド属性を設定する場合は、この要素に属性を明示的に設定する必要があります(「要素(フィールド)レベルでのパラメータ定義」を参照)。

使用可能なパラメータについては、『ステートメント』ドキュメントの「WRITE」で「パラメータのリスト」を参照してください。

nX
nT
x/y

フォーマット表記と要素間隔:

フォーマット表記と要素間隔」(後述)を参照してください。

'text'
'c' (n)
attributes

テキスト/属性割り当て:

テキスト/属性割り当て」(後述)を参照してください。

operand1
タイトル内に表示するフィールド:

operand1 は、タイトル内に表示するフィールド(複数可)を表します。

実行時にオカレンス数を変更できる、範囲による配列は指定できません。

parameters
要素(フィールド)レベルでのパラメータ定義:

1 つまたは複数のパラメータをカッコで囲んで、要素(フィールド)レベルで、つまり operand1 の直後に指定できます。 この方法で指定した各パラメータは、以前にステートメントレベルGLOBALS コマンド、SET GLOBALS ステートメント(レポーティングモードでのみ)、または FORMAT ステートメントで指定した対応するパラメータを上書きします。

複数のパラメータを指定する場合は、各エントリ間に 1 つ以上の空白を配置する必要があります。 エントリを 2 行のステートメント行に分割することはできません。

使用可能なパラメータについては、『ステートメント』ドキュメントの「WRITE」で「パラメータのリスト」を参照してください。

SKIP operand2 LINES
省略される行:

SKIP を使用して、タイトル行の下に何行か空けることができます。 空ける行数は数値定数または数値変数の内容で指定します。

注意:
WRITE TITLE の後の SKIP は独立したステートメントでなく、常に WRITE TITLE ステートメントの SKIP 節として解釈されます。 WRITE TITLE ステートメントの後に独立した SKIP ステートメントが必要な場合は、セミコロン(;)を使用して 2 つのステートメントを互いに区別します。

フォーマット表記と要素間隔

nX
列の間隔:

この表記により、列の間に n 個のスペースが挿入されます。 n をゼロにすることはできません。

nT
タブ設定:

nT 表記により、位置 n を出力するように位置指定(タブ設定)されます。 後方への位置指定はできません。

x/y
x/y 位置指定:

次の要素は最後のステートメント出力の x 行下、列 y の先頭に配置されます。 y をゼロにすることはできません。 同じ行で後方に位置指定することはできません。

テキスト/属性割り当て

'text' 
テキスト割り当て:

一重引用符で囲まれた文字列が表示されます。

'c'(n)
文字の繰り返し:

フィールド値の直前に、一重引用符で囲まれた文字列が n 回表示されます。

attributes
フィールド表現と色属性:

テキスト/フィールド表示にさまざまな属性を割り当てることができます。 これらの属性と構文については、以下の「出力属性」で説明します。

例:

WRITE TITLE 'TEXT' (BGR)
WRITE TITLE 'TEXT' (B)
WRITE TITLE 'TEXT' (BBLC)

出力属性

attributes は、テキスト表示に使用される出力属性を示します。 可能な属性:

AD=AD-value
BX=BX-value
CD=CD-value
PM=PM-value

AD-value
CD-value

指定可能なセッションパラメータ値については、『パラメータリファレンス』ドキュメントの該当するセクションを参照してください。

注意:
コンパイラは、実際には 1 つの出力フィールドに複数の属性値を受け入れます。 例えば、「AD=BDI」と指定できます。 ただし、この場合は最後の値のみが適用されます。 示した例では、値 I のみが有効になり、出力フィールドは強調表示されます。

Top of page

** Example 'WTIEX1': WRITE  (with TITLE option)                         
************************************************************************
DEFINE DATA LOCAL                                                       
1 EMPL-VIEW VIEW OF EMPLOYEES                                           
  2 NAME                                                                
  2 FIRST-NAME                                                          
  2 CITY                                                                
  2 JOB-TITLE                                                           
END-DEFINE                                                              
*                                                                       
*                                                                       
FORMAT LS=70                                                            
*                                                                       
WRITE TITLE LEFT JUSTIFIED UNDERLINED                                   
      *TIME 3X 'PEOPLE LIVING IN NEW YORK CITY'                         
      11X 'PAGE:' *PAGE-NUMBER                                          
SKIP 1                                                              
*                                                                       
FIND EMPL-VIEW WITH CITY = 'NEW YORK'                                   
  DISPLAY NAME FIRST-NAME 3X JOB-TITLE
END-FIND                              
END                                  

プログラム WTIEX1 の出力:

09:33:16.5   PEOPLE LIVING IN NEW YORK CITY           PAGE:      1   
---------------------------------------------------------------------
                                                                     
        NAME              FIRST-NAME                 CURRENT         
                                                    POSITION         
-------------------- --------------------   -------------------------
                                                                     
RUBIN                SYLVIA                 SECRETARY                
WALLACE              MARY                   ANALYST                 

Top of page