# 日本語 Compaq OpenVMS
DEC XTPU
リファレンス・マニュアル

前へ | 次へ | 目次 | 索引

# KEY_NAME

> この組込みプロシージャは，1つのキーまたは複数のキーの組合わせを示す DEC XTPU キーワードを通知します。

## 形式

> keyword2 := KEY_NAME ({integer|key-name|string} [，SHIFT_KEY] [，{FUNCTION|KEYPAD}])

## 引数

> ### integer

> キーを示すキーワードの整数表現，DEC XTPU が ISO Latin1 文字セットに解釈する 0から 255 までの整数。

> ### key-name

> キーに対するDEC XTPU キー名を示すキーワード。

> ### string

> メイン・キーボードのキーの値を示す文字列。

> ### SHIFT_KEY

> 戻されるキーワードの前に1つまたは複数のシフト・キーが存在することを示すパラメータ。SHIFT_KEY はDEC XTPU が定義する SHIFT キーで，(省略時の値は `[PF1]`)，キーボードの `[Shift]` キーではありません。

> ### FUNCTION

> パラメータでファンクション・キーによって発生するコードを指定していることを示す。

> ### KEYPAD

> パラメータでキーパッドによって発生するコードを指定していることを示す。

## 説明

> KEY_NAME 組込みプロシージャについての基本的な説明は，『DEC Text Processing Utility Reference Manual』を参照してください。

> string パラメータに，日本語の全角文字を指定することができます。また，日本語の全角文字もキー定義に使用することができます。

## シグナル・エラー

> XTPU$_BADKEY | WARNING | 指定できるキーワードは SHIFT_KEY，FUNCTION， KEYPAD のみである
> XTPU$_INCKWDCOM | WARNING | キーワードの組み合せが正しくない
> XTPU$_MUSTBEONE | WARNING | 文字列は 1 文字でなければならない
> XTPU$_NOTDEFINABLE | WARNING | キーに定義されない値が指定された
> XTPU$_NEEDTOASSIGN | ERROR | KEY_NAME は代入文の右辺でのみ使用できる
> XTPU$_ARGMISMATCH | ERROR | パラメータのデータ・タイプが正しくない
> XTPU$_TOOFEW | ERROR | パラメータの数が少なすぎる
> XTPU$_TOOMANY | ERROR | パラメータの数が多すぎる

## 例

>     1. key1 := KEY_NAME ('タ')

> この代入ステートメントはキーボードの "タ" というキーに対して key1 というキー名を作成します。

>     2. key2 := KEY_NAME ('タ', SHIFY_KEY)

> この例では，キーの組合せに対してキー名を作成するために KEY_NAME が使用されています。

# MARK

> この組込みプロシージャは，現在のバッファの現在の文字位置にマーカを設定して，そのマーカを戻します。マーカがスクリーンにどのように表示されるかを (NONE，REVERSE，BOLD，または UNDERLINE)指定しなければなりません。

## 形式

> marker := MARK (keyword)

## 引数

> ### keyword

> 以下のいずれかのキーワードを使用しなければなりません。

> BLINK | マーカが点滅することを指定します。
> BOLD | マーカがボールド体で表示されることを指定します。
> FREE_CURSOR | マーカがフリー・マーカ(文字に対応しないマーカ)であることを指定します。MARK (FREE_CURSOR) が実行されたときのカーソル位置が，行頭より前，行末より後ろ，タブの中，DEC 漢字文字の第2カラム上，バッファの終端より下でないときにはフリー・マーカにはなりません。フリー・マーカはビデオ属性を持ちません。
> NONE | ビデオ属性がマーカに適用されないことを指定します。
> REVERSE | マーカが反転表示されることを指定します。
> UNDERLINE | マーカにアンダーラインが引かれることを指定します。

## 説明

> MARK 組込みプロシージャに関する基本的な説明は，『DEC Text Processing Utility Reference Manual』を参照してください。

> マーカは文字の境界にセットされます。したがって，たとえば漢字上にカーソルがあるときに，マーカをセットしようとすると，現在の文字位置が漢字の2 カラム目にあるときでも，マーカはその文字の1カラム目にセットされます。ただしフリー・マーカは漢字の2カラム目にセットすることができます。

## シグナル・エラー

> XTPU$_NOCURRENTBUF | WARNING | マーカはバッファ中にのみ設定できる
> XTPU$_TOOFEW | ERROR | パラメータの数が少なすぎる
> XTPU$_TOOMANY | ERROR | パラメータの数が多すぎる
> XTPU$_NEEDTOASSIGN | ERROR | MARK は代入文の右辺でのみ使用できる
> XTPU$_INVPARAM | ERROR | パラメータのデータ・タイプが正しくない
> XTPU$_BADKEY | ERROR | 指定できるキーワードは NONE，BOLD，BLINK， REVERSE，UNDERLINE，FREE_CURSOR のいずれかである
> XTPU$_UNKKEYWORD | ERROR | 正しくないキーワードが指定された
> XTPU$_INSVIRMEM | FATAL | マーカを作るのに十分なメモリがない

# PCS_CLASS

> この組込みプロシージャは，指定した文字が属するPCS (Primitive Character Set) をビット・フィールド形式で整数値として戻します。

## 形式

> integer2 := PCS_CLASS (string [，integer1])

## 引数

> ### string

> 文字が属するPCSを知りたい文字を指定します。2文字以上の文字列を指定したときには最初の文字のみが有効です。

> ### inteter1

> PCSのグループ番号を指定します。このパラメータは将来32以上のPCSを扱うために用意されていますが，現在はグループ番号0のみが使われますので，省略可能です。省略時の値は0です。

## 説明

> 次の表はPCSを示すビットの割り当てを示しています。プログラム中では予め定義された定数と，PCS_CLASSから戻される値を論理演算で比較することになります。

> クラス | ビット | 定数
> --- | --- | ---
> ASCII_CHAR | 0 | XTPU$K_ASCII_CHAR
> DEC_SUPPLEMENTAL | 1 | XTPU$K_DEC_SUPP
> LATIN1_SUPPLEMENTAL | 2 | XTPU$K_LATIN1_SUPP
> JIS_ROMAN | 3 | XTPU$K_JIS_ROMAN
> JIS_KATAKANA | 4 | XTPU$K_JIS_KATAKANA
> KANJI_1 (JIS X0208) | 8 | XTPU$K_KANJI_1
> KANJI_UDC | 16 | XTPU$K_KANJI_UDC

## シグナル・エラー

> XTPU$_INVPARAM | ERROR | 引数の型が正しくない
> XTPU$_NEEDTOASSIGN | ERROR | PCS_CLASS は代入文の右辺でのみ使用できる
> XTPU$_TOOFEW | ERROR | パラメータの数が少なすぎる
> XTPU$_TOOMANY | ERROR | パラメータの数が多すぎる

# READ_CHAR

> この組込みプロシージャは，次にキーボードから入力される文字を文字列で通知します。

## 形式

> string := READ_CHAR

## 引数

> ### なし

## 説明

> READ_CHAR 組込みプロシージャに関する基本的な説明は，『DEC Text Processing Utility Reference Manual』を参照してください。

> キーボードから入力される文字コードの解釈は，キーボード・コードセットの設定に従います。詳しくは GET_INFO (SYSTEM，"keyboard_codeset") および SET (KEYBOARD_CODESET) を参照してください。

## シグナル・エラー

> XTPU$_NEEDTOASSIGN | ERROR | READ_CHAR は代入文の右辺でのみ使用できる
> XTPU$_NOCHARREAD | WARNING | READ_CHARが文字を読まなかった
> XTPU$_TOOMANY | ERROR | パラメータの数が多すぎる

# READ_KEY

> この組込みプロシージャは，次のキーボードからの入力を待ち，そのキーに対するキーワードを通知します。このプロシージャは，エスケープ・シーケンスを送るキーやコントロール・キーも受け付けます。

## 形式

> keyword := READ_KEY

## 引数

> ### なし

## 説明

> READ_KEY 組込みプロシージャに関する基本的な説明は，『DEC Text Processing Utility Reference Manual』を参照してください。

> キーボードから入力される文字コードの解釈は，キーボード・コードセットの設定に従います。詳しくは GET_INFO (SYSTEM，"keyboard_codeset") および SET (KEYBOARD_CODESET) を参照してください。

## シグナル・エラー

> XTPU$_CONTROLC | ERROR | READ_KEY の実行中に `[Ctrl/C]` が押された
> XTPU$_NEEDTOASSIGN | ERROR | READ_KEY は代入文の右辺でのみ使用できる
> XTPU$_REQUIRESTERM | ERROR | NODISPLAY モードでは READ_KEYを使用できない
> XTPU$_TOOMANY | ERROR | パラメータの数が多すぎる

# READ_LINE

> この組込みプロシージャは，入力を要求するプロンプトとして指定されたテキストを表示し，プロンプトに対する応答として入力された情報を読み込みます。読み込みたい文字の最大のバイト数を指定することもできます。READ_LINE は，プロンプトに対する応答として入力されたデータを含む文字列を通知します。

## 形式

> string2 := READ_LINE [(string1 [，integer])]

## 引数

> ### string1

> 入力を要求するプロンプトとして使用されるテキストを指定します。このパラメータは省略することができます。

> ### integer

> プロンプトに対する応答として入力されたデータから何バイトを読み込むかを指定します。指定できる最大値は 132 文字です。このパラメータは省略することができます。このパラメータが指定されなかったときには，`[Return]` キーまたは `[Ctrl/Z]` が入力されるまで，あるいは文字列の長さが 132 文字になるまで入力できます。

## 説明

> READ_LINE 組込みプロシージャに関する基本的な説明は，『DEC Text Processing Utility Reference Manual』を参照してください。

> キーボードから入力される文字コードの解釈は，キーボード・コードセットの設定に従います。詳しくは GET_INFO (SYSTEM，"keyboard_codeset") および SET (KEYBOARD_CODESET) を参照してください。

## シグナル・エラー

> XTPU$_INVPARAM | ERROR | パラメータのデータ・タイプが正しくない
> XTPU$_NEEDTOASSIGN | ERROR | READ_LINEは代入文の右辺でのみ使用できる
> XTPU$_TOOMANY | ERROR | パラメータの数が多すぎる

# SELECT

> この組込みプロシージャは現在のバッファの現在の文字位置にマーカをセットして，そのマーカを返します。マーカがスクリーンにどのように表示されるかを指定しなければなりません(NONE，REVERSE，BOLD，BLINK，または UNDERLINE)。

> SELECT から通知されるマーカは選択・レンジの最初の文字位置を示しています。マーカに対して指定したビデオ属性は選択・レンジに含まれるすべての文字に適用されます。選択・レンジの作成方法については，SELECT_RANGE を参照してください。

## 形式

> marker := SELECT (keyword)

## 引数

> ### keyword

> 戻されるマーカがスクリーン上でどのように表示されるかを指定します。以下のいずれかのキーワードを使用しなければなりません。

> BLINK | マーカが点滅することを指定します
> BOLD | マーカがボールド体で表示されることを指定します
> NONE | ビデオ属性がマーカに適用されないことを指定します
> REVERSE | マーカが反転表示されることを指定します
> UNDERLINE | マーカにアンダーラインが引かれることを指定します

## 説明

> SELECT 組込みプロシージャに関する基本的な説明は，『DEC Text Processing Utility Reference Manual』を参照してください。

> SELECT が実行されたときに，現在の編集位置が複数カラム文字の2カラム目以降にあった場合には，マーカは1カラム目にセットされます(現在の編集位置は動きません)。

## シグナル・エラー

> XTPU$_BADKEY | WARNING | 正しくないキーワードが指定された
> XTPU$_NOCURRENTBUF | WARNING | 現在のバッファが設定されていない
> XTPU$_ONESELECT | WARNING | SELECT は現在のバッファですでに実行中である
> XTPU$_TOOFEW | ERROR | パラメータの数が少なすぎる
> XTPU$_TOOMANY | ERROR | パラメータの数が多すぎる
> XTPU$_NEEDTOASSIGN | ERROR | SELECT は代入文の右辺でのみ使用できる
> XTPU$_INVPARM | ERROR | SELECT のパラメータがキーワードでない

# SELECT_RANGE

> この組込みプロシージャは SELECT 組込みプロシージャを使ってセットされたマーカと現在の文字位置の間のすべての文字を含むレンジを通知します。SELECT_RANGE の場合，選択されたレンジの中の最後の位置には文字は含まれません。

## 形式

> range := SELECT_RANGE

## 引数

> ### なし

## 説明

> SELECT_RANGE 組込みプロシージャに関する基本的な説明は，『DEC Text Processing Utility Reference Manual』を参照してください。

> SELECT_RANGE を実行したときに現在の編集位置が複数カラム文字の2カラム目以降にあった場合には，編集位置が1カラム目にあるときと同様に動作します。

## シグナル・エラー

> XTPU$_NOCURRENTBUF | WARNING | 現在のバッファが設定されていない
> XTPU$_NOSELECT | WARNING | 現在のバッファで SELECT が実行されていない
> XTPU$_SELRANGEZERO | WARNING | 選択されたレンジに文字が入っていない
> XTPU$_NEEDTOASSIGN | ERROR | SELECT_RANGE は代入文の右辺でのみ使用できる
> XTPU$_TOOMANY | ERROR | パラメータの数が多すぎる

# SET

> この組込みプロシージャは， DEC XTPU セッションの特定の機能を設定または変更するために使用されます。 SET 組込みプロシージャでは最初のパラメータとしてキーワードを指定しなければなりません。キーワードはエディタのどの機能をセットするのかを指定します。セットできる機能はテキスト入力モード，スクリーンの特定の部分に表示されるテキスト，バッファの方向，バッファのステータスなどです。

## 形式

> SET (keyword, parameter [])

## 引数

> ### keyword

> 最初のパラメータとして使用されるキーワードは，設定または変更される機能を指定します。 SET 組込みプロシージャに対して以下のキーワードを指定することができます。アスタリスク (＊)がついたものは DEC XTPU で追加されたもので，後の節で説明されています。

> > ACTIVE_AREA
> > AUTO_REPEAT
> > BELL
> > CLIENT_MESSAGE
> > CODESET (＊)
> > COLUMN_MOVE_VERTICAL
> > CROSS_WINDOW_BOUNDS
> > DEBUG
> > DEFAULT_DIRECTORY
> > DEFAULT_FILE
> > DETACHED_ACTION
> > DISPLAY_VALUE
> > DRM_HIERARCHY
> > ENABLE_RESIZE
> > EOB_TEXT
> > ERASE_UNMODIFIABLE
> > FACILITY_NAME
> > FILL_NOT_BEGIN (＊)
> > FILL_NOT_END (＊)
> > FILL_TRIM_SPACE (＊)
> > FIRST_INPUT_ACTION
> > FORWARD
> > GLOBAL_SELECT
> > GLOBAL_SELECT_GRAB
> > GLOBAL_SELECT_READ
> > GLOBAL_SELECT_TIME
> > GLOBAL_SELECT_UNGRAB
> > HEIGHT
> > ICON_NAME
> > ICON_PIXMAP
> > INFORMATIONAL
> > INPUT_FOCUS
> > INPUT_FOCUS_GRAB
> > INPUT_FOCUS_UNGRAB
> > INSERT
> > JOURNALING
> > KEY_MAP_LIST
> > KEYSTROKE_RECOVERY
> > KEYBOARD_CODESET (＊)
> > LEFT_MARGIN
> > LEFT_MARGIN_ACTION
> > LINE_NUMBER
> > MAPPED_WHEN_MANAGED
> > MARGINS
> > MARGIN_ALLOWANCE (＊)
> > MAX_LINES
> > MENU_POSITION
> > MESSAGE_ACTION_LEVEL
> > MESSAGE_ACTION_TYPE
> > MESSAGE_CODESET (＊)
> > MESSAGE_FLAGS
> > MODIFIABLE
> > MODIFIED
> > MOUSE
> > MOVE_VERTICAL_CONTEXT
> > NO_WRITE
> > OUTPUT_CODESET (＊)
> > OUTPUT_FILE
> > OVERSTRIKE
> > PAD
> > PAD_OVERSTRUCK_TABS
> > PERMANENT
> > POST_KEY_PROCEDURE
> > PRE_KEY_PROCEDURE
> > PROMPT_AREA
> > RECORD_ATTRIBUTE
> > RECORD_MODE
> > RESIZE_ACTION
> > REVERSE
> > RIGHT_MARGIN
> > RIGHT_MARGIN_ACTION
> > SCREEN_LIMITS
> > SCREEN_UPDATE
> > SCROLL_BAR
> > SCROLL_BAR_AUTO_THUMB
> > SCROLLING
> > SELF_INSERT
> > SHIFT_KEY
> > SPECIAL_ERROR_SYMBOL
> > STATUS_LINE
> > SUCCESS
> > SYSTEM
> > TAB_STOPS
> > TEXT
> > TIMER
> > TRACEBACK
> > UID
> > UNDEFINED_KEY
> > VIDEO
> > VIDEO_CHARACTER_SET (＊)
> > WIDGET
> > WIDGET_CALL_DATA
> > WIDGET_CALL_BACK
> > WIDGET_CONTEXT_HELP
> > WIDGET_RESOURCE_TYPES
> > WIDTH

> これらの各キーワードとその後に指定されるパラメータについては，以降のページで詳しく説明します。キーワードはアルファベット順に説明されています。

> ### parameter []

> 最初のパラメータの後に指定されるパラメータの数は，どのキーワードを使用したかによって異なります。パラメータはキーワードの説明の形式の部分に示されています。

## 説明

> SET 組込みプロシージャは編集インタフェースを作成するプログラマ，およびその編集インタフェースを利用する人が使用できるように設計されています。プログラマは編集インタフェースの特定の省略時の動作や，スクリーン表示を設定することができます。また，ユーザは省略時の動作を変更し，SET 組込みプロシージャを使って既存の DEC XTPU セッションを簡単にカスタマイズすることができます。

前へ | 次へ | 目次 | 索引