WRITE TITLE

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

nX

'text' [(attributes)]

  nT 'c'( n ) [(attributes)]
  x/y ['='] operand1 [(parameters)]
  [SKIPoperand2 [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 ステートメントは、新ページを作成するステートメントと同じオブジェクトで使用されている場合に限って実行されます。

制限

  • WRITE TITLE は 1 レポートにつき 1 回だけ指定できます。

  • WRITE TITLE は特殊条件ステートメントブロック内では指定できません。

  • WRITE TITLE はサブルーチン内では指定できません。

構文説明

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

オペランド 構文要素 フォーマット オペランド参照 ダイナミック定義
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 を使用して、タイトル行の下に何行か空けることができます。空ける行数は数値定数または数値変数として operand2 で指定します。

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

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

構文要素 説明
nX
列の間隔:

この表記により、列の間に 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
CD=cd-value
PM=pm-value

ad-value
cd-value

上記の意味は次に示すとおりです。

ad-value、、cd-value および pm-value は、『パラメータリファレンス』ドキュメントの関連セクションで記載されている、対応するセッションパラメータ AD、、CD および PM の可能な値を示します。

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

英数字/Unicode 定数(Natural データフォーマット A または U )の場合は、ad-value または cd-value あるいはその両方を、それぞれの前に先行する CD= または AD= なしで、指定することができます。入力した単一の値が、最初にすべての可能な CD 値に対してチェックされます。例えば、IRE の値は、高輝度表示/赤として解釈されますが、高輝度表示/右詰め/必須としては解釈されません。単一の cd-value またはad-value の前に CD= または AD= が付いた値を組み合わせることはできません。

** 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