# 日本語 OpenVMS
日本語画面管理ライブラリ
利用者の手引き

前へ | 次へ | 目次 | 索引

# SMG$DELETE_LINE

> Delete Line ルーチンは仮想ディスプレイの行を削除します。

## 形式

> SMG$DELETE_LINE display-id ,start-row [,number-of-rows]

## 戻り値

> ###

> OpenVMS 用法 | cond_value
> データ型 | longword (unsigned)
> アクセス | write only
> 受け渡し方 | by value

## 引数

> ### display-id

> OpenVMS 用法 | identifier
> データ型 | longword (unsigned)
> アクセス | read only
> 受け渡し方 | by reference

> 行が削除される仮想ディスプレイの識別子。 display-id 引数は，仮想ディスプレイの識別子を格納した符号なしロングワードのアドレスです。

> この引数は SMG$CREATE_VIRTUAL_DISPLAY ルーチンによって与えられます。

> ### start-row

> OpenVMS 用法 | longword_signed
> データ型 | longword (signed)
> アクセス | read only
> 受け渡し方 | by reference

> 削除開始行。 start-row 引数は，削除する最初の行の番号を格納した符号付きロングワードのアドレスです。

> ### number-of-rows

> OpenVMS 用法 | longword_signed
> データ型 | longword (signed)
> アクセス | read only
> 受け渡し方 | by reference

> 削除行数。 number-of-rows 引数は，削除する行数を格納した符号付きロングワードのアドレスです。

## 説明

> SMG$DELETE_LINE ルーチンは，1行以上を仮想ディスプレイから削除し，残りの行を上にスクロールさせ削除された部分を埋めます。仮想ディスプレイの下部には空行が挿入されます。仮想カーソルは，start-row 引数で指定された行の最初のカラムに移動します。

## 戻される状態値

> SS$_NORMAL | 正常終了。
> SMG$_INVARG | 引数が誤っています。
> SMG$_INVDIS_ID | display-id 引数が誤っています。
> SMG$_INVROW | 行の位置が誤っています。
> SMG$_WILUSERMS | ペーストボードがビデオ・ターミナルでありません。
> SMG$_WRONUMARG | 引数の数が誤っています。

## 例

#1
    C+
    C This FORTRAN example program demonstrates the use of SMG$DELETE_LINE.
    C-

            IMPLICIT INTEGER (A-Z)
    C+
    C Create the virtual display by calling SMG$CREATE_VIRTUAL_DISPLAY.
    C To give it a border, set BORDER = 1.  No border would be BORDER = 0.
    C-

            ROWS = 7
            COLUMNS = 50
            BORDER = 1

            STATUS = SMG$CREATE_VIRTUAL_DISPLAY
         1        (ROWS, COLUMNS, DISPLAY1, BORDER)
            IF (.NOT. STATUS) CALL LIB$SIGNAL(%VAL(STATUS))

    C+
    C Call SMG$CREATE_PASTEBOARD to create the pasteboard.
    C-

            STATUS = SMG$CREATE_PASTEBOARD (PASTE1)
            IF (.NOT. STATUS) CALL LIB$SIGNAL(%VAL(STATUS))

    C+
    C Use SMG$PUT_CHARS to put data in the virtual display.
    C-

            STATUS = SMG$PUT_CHARS ( DISPLAY1,
         1        ' This virtual display has 7 rows and 50 columns.', 2, 1)
            IF (.NOT. STATUS) CALL LIB$SIGNAL(%VAL(STATUS))

            STATUS = SMG$PUT_CHARS ( DISPLAY1,
         1        ' This is a bordered virtual display.', 4, 1)
            IF (.NOT. STATUS) CALL LIB$SIGNAL(%VAL(STATUS))

            STATUS = SMG$PUT_CHARS ( DISPLAY1,
         1        ' SMG$PUT_CHARS puts data in this virtual display.', 6, 1)
            IF (.NOT. STATUS) CALL LIB$SIGNAL(%VAL(STATUS))

    C+
    C Paste the virtual display to the pasteboard using
    C SMG$PASTE_VIRTUAL_DISPLAY.
    C-

            STATUS = SMG$PASTE_VIRTUAL_DISPLAY ( DISPLAY1, PASTE1, 4, 15)
            IF (.NOT. STATUS) CALL LIB$SIGNAL(%VAL(STATUS))

    C+
    C Call SMG$DELETE_LINE to delete rows 3, 4, and 5.
    C-

            STATUS = SMG$DELETE_LINE ( DISPLAY1, 3, 3)
            IF (.NOT. STATUS) CALL LIB$SIGNAL(%VAL(STATUS))

            END

> この FORTRAN プログラムによって，SMG$DELETE_LINE ルーチンを呼び出す前に生成される出力は， 図 8-12 に示すとおりです。

> 図 8-12 SMG$DELETE_LINE ルーチンを呼び出す前に FORTRAN プログラムが生成する出力

SMG$DELETE_LINE ルーチンを呼び出した後に生成される出力は， 図 8-13 に示すとおりです。

図 8-13 SMG$DELETE_LINE ルーチンを呼び出した後に生成される出力

# SMG$DELETE_MENU

> End Access to a Menu in the Virtual Display ルーチンは，指定された仮想ディスプレイのメニュー選択へのアクセスを終了します。

## 形式

> SMG$DELETE_MENU display-id [,flags]

## 戻り値

> ###

> OpenVMS 用法 | cond_value
> データ型 | longword (unsigned)
> アクセス | write only
> 受け渡し方 | by value

## 引数

> ### display-id

> OpenVMS 用法 | identifier
> データ型 | longword (unsigned)
> アクセス | read only
> 受け渡し方 | by reference

> メニュー選択を画面表示する仮想ディスプレイを指定します。 display-id 引数は，ディスプレイ識別子を格納した符号なしロングワードのアドレスです。

> ### flags

> OpenVMS 用法 | mask_longword
> データ型 | longword (unsigned)
> アクセス | read only
> 受け渡し方 | by reference

> 省略可能なビットマスクであり，メニューを削除するときに可能なアクションを指定します。 flags 引数は，フラグを格納した符号なしロングワードのアドレスです。この引数に対して指定できる値は，SMG$M_ERASE_MENUのみです。この値が指定された場合は，メニュー項目が含まれている行すべてが削除されます。

## 説明

> SMG$DELETE_MENU ルーチンは，指定された仮想ディスプレイでのメニュー選択を中断します。 flags 引数は省略可能で，メニューが削除された場合に，ディスプレイからメニュー項目を削除することを指定できます。

## 戻される状態値

> SS$_NORMAL | 正常終了。
> LIB$_xxxx | LIB$FREE_VM から戻された状態値。
> SMG$_xxxx | SMG$ERASE_DISPLAYルーチンから戻された状態値。

# SMG$DELETE_PASTEBOARD

> Delete Pasteboard ルーチンはペーストボードを削除します。

## 形式

> SMG$DELETE_PASTEBOARD pasteboard-id [,flags]

## 戻り値

> ###

> OpenVMS 用法 | cond_value
> データ型 | longword (unsigned)
> アクセス | write only
> 受け渡し方 | by value

## 引数

> ### pasteboard-id

> OpenVMS 用法 | identifier
> データ型 | longword (unsigned)
> アクセス | read only
> 受け渡し方 | by reference

> 削除されるペーストボード識別子。 pasteboard-id 引数は，ペーストボード識別子を格納した符号なしロングワードのアドレスです。

> この引数は SMG$CREATE_PASTEBOARD ルーチンによって与えられます。

> ### flags

> VMS 用法: | mask_longword
> データ型: | longword (unsigned)
> アクセス: | read only
> 受け渡し方: | by reference

> ペーストボード削除後にターミナル画面消去を行うかどうかを指定するフラグ。 flags 引数は省略可能で，フラグを格納した符号なしロングワードのアドレスです。指定できるのは，以下の値です。

> 0 | 画面を消去しない。
> SMG$M_ERASE_PBD | 画面を消去する(省略時の設定値)。

## 説明

> SMG$DELETE_PASTEBOARD ルーチンは仮想ディスプレイに全出力を書き出し，ペーストボードの使用をすべて終了させて，ペーストボードに割り当てられていた資源を解放します。

## 戻される状態値

> SS$_NORMAL | 正常終了。
> SMG$_INVPAS_ID | pasteboard-id 引数が誤っています。
> SMG$_NOTPASTED | 指定された仮想ディスプレイは指定されたペーストボードにペーストされていません。
> SMG$_WILUSERMS | ペーストボードがビデオ・ターミナルではありません。
> SMG$_WRONUMARG | 引数の数が誤っています。
> その他 | $DASSGN，LIB$FREE_VM，LIB$FREE_EF または SMG$FLUSH_BUFFER から戻される状態値。

# SMG$DELETE_SUBPROCESS

> Terminate a Subprocess ルーチンは，SMG$CREATE_SUBPROCESS ルーチンを使用して生成したサブプロセスを削除します。

## 形式

> SMG$DELETE_SUBPROCESS display-id

## 戻り値

> ###

> OpenVMS 用法 | cond_value
> データ型 | longword (unsigned)
> アクセス | write only
> 受け渡し方 | by value

## 引数

> ### display-id

> OpenVMS 用法 | identifier
> データ型 | longword (unsigned)
> アクセス | read only
> 受け渡し方 | by reference

> 削除するサブプロセスに対応づけられている仮想ディスプレイの識別子。 display-id 引数は，この仮想ディスプレイ識別子を格納した符号なしロングワードのアドレスです。

> この引数は SMG$CREATE_VIRTUAL_DISPLAY ルーチンによって与えられます。

## 説明

> SMG$DELETE_SUBPROCESS ルーチンは，SMG$CREATE_SUBPROCESS ルーチンを呼び出すことにより生成されたサブプロセスを削除します。日本語 SMG は独自の終了ハンドラを備えているので，ユーザ独自の終了ハンドラの内部から SMG$DELETE_SUBPROCESS ルーチンを起動しないでください。詳しい説明は， 第 4 章 の 第 4.4 節 を参照してください。

## 戻される状態値

> SS$_NORMAL | 正常終了。
> SMG$_INVDIS_ID | display-id 引数に誤りがあります。
> SMG$_NOSUBEXI | 削除するプロセスが存在しません。
> SS$_xxxx | $DELPRC から戻された状態値。
> LIB$_xxxx | LIB$FREE_VM から戻された状態値。

# SMG$DELETE_VIEWPORT

> Delete a Viewport ルーチンは，ペーストされているペーストボードから指定されたビューポートを削除します。

## 形式

> SMG$DELETE_VIEWPORT display-id

## 戻り値

> ###

> OpenVMS 用法 | cond_value
> データ型 | longword (unsigned)
> アクセス | write only
> 受け渡し方 | by value

## 引数

> ### display-id

> OpenVMS 用法 | identifier
> データ型 | longword (unsigned)
> アクセス | read only
> 受け渡し方 | by reference

> 削除するビューポートに対応づけられている仮想ディスプレイの識別子。 display-id 引数は，ディスプレイ識別子を格納した符号なしロングワードのアドレスです。

## 説明

> SMG$DELETE_VIEWPORT ルーチンはビューポートを削除します。ビューポートは，それがペーストされているペーストボードから自動的に "アンペースト" されます。しかし，削除されるビューポートに対応づけられている仮想ディスプレイは削除されません。この仮想ディスプレイを表示するには，SMG$PASTE_VIRTUAL_DISPLAY ルーチンを使用して仮想ディスプレイをペーストボードにペーストしなければなりません。この仮想ディスプレイを削除するには，SMG$DELETE_VIRTUAL_DISPLAY ルーチンを使用します。

## 戻される状態値

> SS$_NORMAL | 正常終了。
> SMG$_INVDIS_ID | display-id 引数に誤りがあります。
> SMG$_NO_WINASSOC | 仮想ディスプレイに対応づけられているビューポートはありません。
> SMG$_WRONUMARG | 引数の数が誤っています。

# SMG$DELETE_VIRTUAL_DISPLAY

> Delete Virtual Display ルーチンは仮想ディスプレイを削除します。

## 形式

> SMG$DELETE_VIRTUAL_DISPLAY display-id

## 戻り値

> ###

> OpenVMS 用法 | cond_value
> データ型 | longword (unsigned)
> アクセス | write only
> 受け渡し方 | by value

## 引数

> ### display-id

> OpenVMS 用法 | identifier
> データ型 | longword (unsigned)
> アクセス | read only
> 受け渡し方 | by reference

> 削除する仮想ディスプレイを指定します。display-id 引数は，ディスプレイ識別子を格納した符号なしロングワードのアドレスです。

> この引数は SMG$CREATE_VIRTUAL_DISPLAY ルーチンによって与えられます。

## 説明

> SMG$DELETE_VIRTUAL_DISPLAY ルーチンは仮想ディスプレイを削除し，その仮想ディスプレイがペーストされているペーストボードから，仮想ディスプレイを削除します。また，仮想ディスプレイに割り当てられているバッファ空間の割り当てを解除します。

## 戻される状態値

> SS$_NORMAL | 正常終了。
> SMG$_INVDIS_ID | display-id 引数に誤りがあります。
> SMG$_NOTPASTED | 指定された仮想ディスプレイが指定されたペーストボードにペーストされていません。
> SMG$_WILUSERMS | ペーストボードがビデオ・ターミナルではありません。
> SMG$_WRONUMARG | 引数の数が誤っています。
> その他 | LIB$FREE_VM から戻される状態値。 DELPRC から戻される状態値。

# SMG$DELETE_VIRTUAL_KEYBOARD

> Delete Virtual Keyboard ルーチンは仮想キーボードを削除します。

## 形式

> SMG$DELETE_VIRTUAL_KEYBOARD keyboard-id

## 戻り値

> ###

> OpenVMS 用法 | cond_value
> データ型 | longword (unsigned)
> アクセス | write only
> 受け渡し方 | by value

## 引数

> ### keyboard-id

> OpenVMS 用法 | identifier
> データ型 | longword (unsigned)
> アクセス | read only
> 受け渡し方 | by reference

> 削除されるキーボード識別子。 keyboard-id 引数は，キーボード識別子を格納した符号なしロングワードのアドレスです。

> この引数は SMG$CREATE_VIRTUAL_KEYBOARD ルーチンによって与えられます。

## 説明

> SMG$DELETE_VIRTUAL_KEYBOARD ルーチンは，仮想キーボードを削除します。仮想キーボード作成時に設定されたターミナル属性を以前の値に設定し，キーパッド・モード(数値またはアプリケーション・キーパッド・モード)は最初の状態に設定されます。さらに，チャネルの割り当ても解除されます。

> 日本語 SMG ルーチンは独自の終了ハンドラを備えているため，ユーザ独自の終了ハンドラからこのルーチンを呼ばないでください。

## 戻される状態値

> SS$_NORMAL | 正常終了。
> SMG$_INVKBD_ID | keyboard-id 引数が誤っています。
> SMG$_WRONUMARG | 引数の数が誤っています。

前へ | 次へ | 目次 | 索引