GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/elisp/Window-Point.html ・ emacs-doc.conao3.com

29.21 Windows と Point

各ウィンドウは、同じバッファを表示している他のウィンドウのポイント値とは独立して、独自のポイント値(Pointを参照)、すなわちウィンドウポイントを持ちます。これは、1つのバッファを複数のウィンドウで表示する場合に有用です。

Emacsはデフォルトで、各ウィンドウのポイントの位置に、矩形のブロックとしてカーソルを表示します。ユーザーがウィンドウ内の別のバッファに切り替えると、Emacsはそのウィンドウのカーソルを、そのバッファにおけるポイントの位置に移動させます。ポイントの正確な位置が、表示文字列や画像などの表示要素の背後に隠れている場合、Emacsはその表示要素の直前または直後にカーソルを表示します。

関数: window-point &optional window

この関数は、window に対応するウィンドウポイントを返します。選択されていないウィンドウの場合、これは、そのウィンドウが選択されていた場合に(そのウィンドウのバッファ内で)ポイントが示す値となります。window のデフォルトは、選択中のウィンドウです。

window が選択中のウィンドウである場合、返される値はそのウィンドウのバッファにおける point の値となります。厳密に言えば、いかなる save-excursion フォームの外側にある point のトップレベルの値を返す方がより正確でしょう。しかし、その値を特定するのは困難です。

関数: set-window-point window position

この関数は、windowのバッファ内の位置positionに点windowを配置します。戻り値はpositionです。

window が選択された場合、これは単に window のバッファ内で goto-char を実行します。

変数: window-point-insertion-type

この変数は、window-point のマーカー挿入タイプ(マーカー挿入タイプを参照)を指定します。デフォルトは nil であるため、window-point はそこに挿入されたテキストの後ろに配置されます。

関数: set-window-cursor-type window type

この関数は、window のカーソル形状を設定します。この設定は cursor-type 変数よりも優先され、type はその変数の値と同じ形式となります。カーソルパラメータ を参照してください。window が nil の場合、選択中のウィンドウのカーソルタイプを設定することを意味します。

新規ウィンドウの初期値は t であり、これはバッファローカルな値 cursor-type を尊重することを意味します。この関数で設定された値は window で表示されるバッファ間でも保持されるため、set-window-buffer によってリセットされることはありません。バッファとウィンドウ を参照してください。

関数: window-cursor-type &optional window

この関数は、選択中のウィンドウをデフォルトとして、window のカーソルタイプを返します。

関数: window-cursor-info &optional window

この関数は、デフォルトで選択中のウィンドウとなる window のカーソルに関する情報を返します。

関数が返す値は、[type x y width height ascent] という形式のベクトルです。このベクトルの各成分の説明は以下の通りです。

type

カーソルの種類(シンボル)。これは window-cursor-type が返す値と同じです。

x
y

windowのテキスト領域の左上隅を基準とした、カーソルの左上隅のピクセル座標。

width
height

カーソルのピクセル寸法。

ascent

カーソルがベースラインから上に伸びるピクセル数。

window に対して現在カーソルが表示されていない場合、この関数は nil を返します。

返されるベクトルの先頭要素以外の任意の要素は -1 となる場合があり、これは実際の値が現在取得不能であることを意味します。