989d921f5d
I'm very pleased to announce the release of our new website and documentation using the new toolchain with Hugo and AsciiDoctor. To get more information about the new toolchain please read the FreeBSD Documentation Project Primer[1], Hugo docs[2] and AsciiDoctor docs[3]. Acknowledgment: Benedict Reuschling <bcr@> Glen Barber <gjb@> Hiroki Sato <hrs@> Li-Wen Hsu <lwhsu@> Sean Chittenden <seanc@> The FreeBSD Foundation [1] https://docs.FreeBSD.org/en/books/fdp-primer/ [2] https://gohugo.io/documentation/ [3] https://docs.asciidoctor.org/home/ Approved by: doceng, core
127 lines
4 KiB
Groff
127 lines
4 KiB
Groff
.\" $Id: curs_addch.3,v 1.4 2002-05-18 07:12:54 horikawa Exp $
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.TH curs_addch 3 ""
|
|
.SH 名称
|
|
\fBaddch\fR, \fBwaddch\fR, \fBmvaddch\fR, \fBmvwaddch\fR,
|
|
\fBechochar\fR,
|
|
\fBwechochar\fR - 文字を (属性とともに) \fBncurses\fR ウィンドウに追加してから、カーソルを進める
|
|
.SH 書式
|
|
\fB#include <ncurses.h>\fR
|
|
|
|
\fBaddch(chtype ch);\fR
|
|
.br
|
|
\fBwaddch(WINDOW *win, chtype ch);\fR
|
|
.br
|
|
\fBmvaddch(int y, int x, chtype ch);\fR
|
|
.br
|
|
\fBmvwaddch(WINDOW *win, int y, int x, chtype ch);\fR
|
|
.br
|
|
\fBechochar(chtype ch);\fR
|
|
.br
|
|
\fBwechochar(WINDOW *win, chtype ch);\fR
|
|
.br
|
|
.SH 解説
|
|
\fBaddch\fR, \fBwaddch\fR, \fBmvaddch\fR
|
|
および \fBmvwaddch\fR の各ルーチンは、
|
|
指定のウィンドウの現在のウィンドウ位置に文字 \fIch\fR を設定し、
|
|
その位置を進行します。
|
|
これらは \fBstdio\fR(3) の \fBputchar\fR に類似しています。
|
|
進行が右端余白の場合、カーソルは自動的に次の行の先頭にラップします。
|
|
\fBscrollok\fR が有効な場合、スクロール領域の下端では、
|
|
スクロール領域が 1 行だけ上にスクロールします。
|
|
|
|
\fIch\fR がタブ、改行、またはバックスペースの場合、
|
|
カーソルはウィンドウ内部で適切に移動させられます。
|
|
改行は \fBclrtoeol\fR を行ってから移動します。
|
|
タブは、8 カラムごとにあると見なされます。
|
|
|
|
\fIch\fR がタブ、改行、バックスペース以外の制御文字の場合、
|
|
それは \fB^\fR\fIX\fR 表記で描かれます。
|
|
制御文字を追加した後に \fBwinch\fR を呼び出しても、
|
|
制御文字は戻らず、代わりに制御文字の表現が返されます
|
|
(制御文字を文字どおり送るには、\fBechochar\fRを使用します)。
|
|
|
|
ビデオ属性は 1 つの文字と論理和 (OR) を取ることによって、
|
|
結合されてパラメータに入れることができます。
|
|
この結果、これらの属性も設定されることになります
|
|
(ここで意図することは、属性を含めてテキストが、
|
|
\fBinch\fR と \fBaddch\fR を使用して、
|
|
ある場所から別の場所にコピーできるということです)。
|
|
[ curs_attr(3) ページの、定義済みビデオ属性定数である
|
|
\fBstandout\fR を参照してください]。
|
|
|
|
\fBechochar\fR ルーチンと \fBwechochar\fR ルーチンは、
|
|
\fBaddch\fR の呼び出しの後に
|
|
\fBrefresh\fR の呼び出しが続いたもの、
|
|
または \fBwaddch\fR の呼び出しの後に
|
|
\fBwrefresh\fR の呼び出しが続いたものと機能的に同等です。
|
|
1 つの文字だけが出力されていることを考慮に入れ、
|
|
制御文字でない文字の場合は、これらのルーチンを、
|
|
同等のものの代わりに使用すると、性能が大幅に向上することがあります。
|
|
.SS ライングラフィックス
|
|
以降の変数を使用して、\fBaddch\fR ファミリのルーチンで、
|
|
ライン描画文字を画面に追加できます。
|
|
以下にリストしたデフォルト文字が使用されるのは、
|
|
\fBacsc\fR 機能がターミナル固有の代わりのものを定義しない場合です。
|
|
名前は VT100 命名法から取ってあります。
|
|
|
|
.TS
|
|
l l l
|
|
_ _ _
|
|
l l l.
|
|
\fl名称\fR \fIデフォルト\fR \fI記述\fR
|
|
ACS_ULCORNER + 左上コーナー
|
|
ACS_LLCORNER + 左下コーナー
|
|
ACS_URCORNER + 右上コーナー
|
|
ACS_LRCORNER + 右下コーナー
|
|
ACS_RTEE + 右ツリー
|
|
ACS_LTEE + 左ツリー
|
|
ACS_BTEE + 下端ツリー
|
|
ACS_TTEE + 上端ツリー
|
|
ACS_HLINE - 水平線
|
|
ACS_VLINE | 垂直線
|
|
ACS_PLUS + プラス
|
|
ACS_S1 - 走査線 1
|
|
ACS_S9 \&_ 走査線 9
|
|
ACS_DIAMOND + ダイアモンド
|
|
ACS_CKBOARD : チェッカーボード (点描)
|
|
ACS_DEGREE ' 度のシンボル
|
|
ACS_PLMINUS # プラス / マイナス
|
|
ACS_BULLET o ブレット
|
|
ACS_LARROW < 左向き矢印
|
|
ACS_RARROW > 右向き矢印
|
|
ACS_DARROW v 下向き矢印
|
|
ACS_UARROW ^ 上向き矢印
|
|
ACS_BOARD # 正方形のボード
|
|
ACS_LANTERN # ランタンのシンボル
|
|
ACS_BLOCK # 埋められた正方形のブロック
|
|
.TE
|
|
|
|
.SH 戻り値
|
|
ルーチンはすべて、処理が失敗すると整数 \fBERR\fR で返ります。
|
|
処理が成功して完了すると、\fBERR\fR 以外の整数値が返されます。
|
|
ただし、これまでのルーチンの説明で異なるように注記した場合は別です。
|
|
.SH バグ
|
|
.SH 注釈
|
|
\fBaddch\fR, \fBmvaddch\fR, \fBmvwaddch\fR
|
|
および \fBechochar\fR はマクロである可能性があります。
|
|
|
|
386 と 486 のコンソールでは、
|
|
\fBwechochar\fR に上位ビットを設定した引数を指定すると、
|
|
対応する高さが半分の ASCIIZ グラフィックが生成されます
|
|
(SVr4 curses にもこの特徴がありますが、
|
|
ドキュメントに記載はされていません)。
|
|
しかし、制御文字引数は通常、対応するグラフィックを作成しないものです。
|
|
CR, NL, FF および TAB のような文字は、
|
|
通常、コンソールドライバ自体によって解釈され、
|
|
ESC は制御シーケンスの先頭と解釈されます。
|
|
.SH 関連項目
|
|
\fBncurses\fR(3),
|
|
\fBcurs_attr\fR(3),
|
|
\fBcurs_clear\fR(3),
|
|
\fBcurs_inch\fR(3),
|
|
\fBcurs_outopts\fR(3),
|
|
\fBcurs_refresh\fR(3),
|
|
\fBputc\fR(3).
|