javax.swing.text
類別 NavigationFilter

java.lang.Object
  javax.swing.text.NavigationFilter

public class NavigationFilter
extends Object

NavigationFilter 可用於限制鼠標的定位。當預設鼠標定位操作嘗試重新定位鼠標時，它們將調用 NavigationFilter，（假定 JTextComponent 有一個非 null NavigationFilter 集合）。通過這種方式，NavigationFilter 可以有效地限制鼠標定位。同樣，當使用者更改選定內容以進一步限定鼠標的位置時，DefaultCaret 將調用 NavigationFilter。

子類別可以有條件地調用父級類別實作以限制可以放置鼠標的位置，或者直接調用 FilterBypass。

從以下版本開始：

1.4

另請參見：

Caret, DefaultCaret, View

巢狀類別摘要

static class

NavigationFilter.FilterBypass 用作防止回調插入符以定位鼠標的方式。

建構子摘要

NavigationFilter()

方法摘要

int	getNextVisualPositionFrom(JTextComponent text, int pos, Position.Bias bias, int direction, Position.Bias[] biasRet) 返回從現在位置起的下一個放置插入符的可視位置。
void	moveDot(NavigationFilter.FilterBypass fb, int dot, Position.Bias bias) 在 Caret 移動點之前調用。
void	setDot(NavigationFilter.FilterBypass fb, int dot, Position.Bias bias) 在 Caret 設置點之前調用。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

NavigationFilter

public NavigationFilter()

方法詳細資訊

setDot

public void setDot(NavigationFilter.FilterBypass fb,
                   int dot,
                   Position.Bias bias)

在 Caret 設置點之前調用。預設實作直接調用具有傳入參數的 FilterBypass。子類別可能希望有條件地調用具有不同位置的父級類別，或在 FilterBypass 上調用必需的方法。

參數：

fb - 可用於改變插入符位置的 FilterBypass

dot - 位置，該值 >= 0

bias - 距所在點的偏差

moveDot

public void moveDot(NavigationFilter.FilterBypass fb,
                    int dot,
                    Position.Bias bias)

在 Caret 移動點之前調用。預設實作直接調用具有傳入參數的 FilterBypass。子類別可能希望有條件地調用具有不同位置的父級類別，或在 FilterBypass 上調用必需的方法。

參數：

fb - 可用於改變插入符位置的 FilterBypass

dot - 位置，該值 >= 0

bias - 新位置的偏差

getNextVisualPositionFrom

public int getNextVisualPositionFrom(JTextComponent text,
                                     int pos,
                                     Position.Bias bias,
                                     int direction,
                                     Position.Bias[] biasRet)
                              throws BadLocationException

返回從現在位置起的下一個放置插入符的可視位置。預設實作只將該方法轉發給根視圖。子類別可能希望根據其他標準進一步限制放置插入符的位置。

參數：

text - 套件含文本的 JTextComponent

pos - 用於確定下一個位置的位置

bias - 用於確定下一個位置的偏差

direction - 相對於當前位置的方向，可以視為通常在鍵盤上找到的方向鍵。它將是以下值之一：

• SwingConstants.WEST
• SwingConstants.EAST
• SwingConstants.NORTH
• SwingConstants.SOUTH

biasRet - 用於返回下一個位置的偏差結果

返回：

此模型中最能表示下一個可見位置的位置

拋出：

BadLocationException

IllegalArgumentException - 如果 direction 不是上面的合法值之一