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

前へ 次へ 目次 索引

SMG$DELETE_LINE
- 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 DEC 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

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

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

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

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

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 から戻される状態値。

SMG$DELETE_VIRTUAL_KEYBOARD
- 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 引数の数が誤っています。

前へ 次へ 目次 索引