java.lang.Object
javax.swing.text.NavigationFilter
public class NavigationFilter extends Object
NavigationFilter
は、カーソルを配置する場所を限定するために使用されます。 デフォルトのカーソル配置処理がカーソルの再配置を行うとき、JTextComponent
にはnull以外のNavigationFilter
セットがあることを前提にして、NavigationFilter
を呼び出します。 この方法では、NavigationFilter
によりカーソル位置が効果的に限定されます。 同様に、ユーザーが選択範囲を変更しているときにもDefaultCaret
はNavigationFilter
を呼び出し、カーソル位置がより厳密に限定されます。
サブクラスは、条件付きでスーパー・クラスの実装を呼び出してカーソル位置を限定するか、直接FilterBypass
を呼び出します。
- 導入されたバージョン:
- 1.4
- 関連項目:
Caret
,DefaultCaret
,View
-
ネストされたクラスのサマリー
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明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の前に呼び出されます。
-
コンストラクタの詳細
-
NavigationFilter
public NavigationFilter()NavigationFilter
を構築します。
-
-
メソッドの詳細
-
setDot
public void setDot(NavigationFilter.FilterBypass fb, int dot, Position.Bias bias)ドットを設定するCaretの前に呼び出されます。 デフォルトの実装では、渡された引数を使用してFilterBypass
を直接呼び出します。 サブクラスは、条件付きで別の位置を持つスーパー・クラスを呼び出すか、FilterBypass
で必要なメソッドを呼び出します。- パラメータ:
fb
- キャレット位置の変更に使用するFilterBypassdot
- 位置>= 0bias
- ドットを配置するバイアス
-
moveDot
public void moveDot(NavigationFilter.FilterBypass fb, int dot, Position.Bias bias)ドットを移動するCaretの前に呼び出されます。 デフォルトの実装では、渡された引数を使用してFilterBypass
を直接呼び出します。 サブクラスは、条件付きで別の位置を持つスーパー・クラスを呼び出すか、FilterBypass
で必要なメソッドを呼び出します。- パラメータ:
fb
- キャレット位置の変更に使用するFilterBypassdot
- 位置>= 0bias
- 新しい位置のバイアス
-
getNextVisualPositionFrom
public int getNextVisualPositionFrom(JTextComponent text, int pos, Position.Bias bias, int direction, Position.Bias[] biasRet) throws BadLocationException既存の位置からキャレットを置くことのできる、次の可視位置を返します。 デフォルトの実装では、単にメソッドがルートViewに転送されるだけです。 サブクラスは追加された基準に基づいて、位置をより厳密に限定します。- パラメータ:
text
- テキストを含むJTextComponentpos
- 次の位置の決定に使用される位置bias
- 次の位置の決定に使用されるバイアスdirection
- 現在位置からの方向。キーボードに通常見られる矢印キーと見なすことができる。 これは、次の値のいずれかになります。- SwingConstants.WEST
- SwingConstants.EAST
- SwingConstants.NORTH
- SwingConstants.SOUTH
biasRet
- 結果として得られる次の位置のBiasを返すために使用される- 戻り値:
- 次の可視の位置をもっともよく表す、モデル内の位置
- 例外:
BadLocationException
- ドキュメント・モデル内の不適切なロケーションIllegalArgumentException
-direction
が前述の正当な値のどれでもない場合
-