--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/java.desktop/share/classes/javax/swing/plaf/TextUI.java Sun Aug 17 15:54:13 2014 +0100
@@ -0,0 +1,165 @@
+/*
+ * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+package javax.swing.plaf;
+
+import javax.swing.Action;
+import javax.swing.BoundedRangeModel;
+import java.awt.Point;
+import java.awt.Rectangle;
+import java.awt.Insets;
+import javax.swing.text.*;
+
+/**
+ * Text editor user interface
+ *
+ * @author Timothy Prinzing
+ */
+public abstract class TextUI extends ComponentUI
+{
+ /**
+ * Converts the given location in the model to a place in
+ * the view coordinate system.
+ *
+ * @param pos the local location in the model to translate >= 0
+ * @return the coordinates as a rectangle
+ * @exception BadLocationException if the given position does not
+ * represent a valid location in the associated document
+ */
+ public abstract Rectangle modelToView(JTextComponent t, int pos) throws BadLocationException;
+
+ /**
+ * Converts the given location in the model to a place in
+ * the view coordinate system.
+ *
+ * @param pos the local location in the model to translate >= 0
+ * @return the coordinates as a rectangle
+ * @exception BadLocationException if the given position does not
+ * represent a valid location in the associated document
+ */
+ public abstract Rectangle modelToView(JTextComponent t, int pos, Position.Bias bias) throws BadLocationException;
+
+ /**
+ * Converts the given place in the view coordinate system
+ * to the nearest representative location in the model.
+ *
+ * @param pt the location in the view to translate. This
+ * should be in the same coordinate system as the mouse
+ * events.
+ * @return the offset from the start of the document >= 0
+ */
+ public abstract int viewToModel(JTextComponent t, Point pt);
+
+ /**
+ * Provides a mapping from the view coordinate space to the logical
+ * coordinate space of the model.
+ *
+ * @param pt the location in the view to translate.
+ * This should be in the same coordinate system
+ * as the mouse events.
+ * @param biasReturn
+ * filled in by this method to indicate whether
+ * the point given is closer to the previous or the next
+ * character in the model
+ *
+ * @return the location within the model that best represents the
+ * given point in the view >= 0
+ */
+ public abstract int viewToModel(JTextComponent t, Point pt,
+ Position.Bias[] biasReturn);
+
+ /**
+ * Provides a way to determine the next visually represented model
+ * location that one might place a caret. Some views may not be visible,
+ * they might not be in the same order found in the model, or they just
+ * might not allow access to some of the locations in the model.
+ *
+ * @param t the text component for which this UI is installed
+ * @param pos the position to convert >= 0
+ * @param b the bias for the position
+ * @param direction the direction from the current position that can
+ * be thought of as the arrow keys typically found on a keyboard.
+ * This may be SwingConstants.WEST, SwingConstants.EAST,
+ * SwingConstants.NORTH, or SwingConstants.SOUTH
+ * @param biasRet an array to contain the bias for the returned position
+ * @return the location within the model that best represents the next
+ * location visual position
+ * @exception BadLocationException for a bad location within a document model
+ * @exception IllegalArgumentException for an invalid direction
+ */
+ public abstract int getNextVisualPositionFrom(JTextComponent t,
+ int pos, Position.Bias b,
+ int direction, Position.Bias[] biasRet)
+ throws BadLocationException;
+
+ /**
+ * Causes the portion of the view responsible for the
+ * given part of the model to be repainted.
+ *
+ * @param p0 the beginning of the range >= 0
+ * @param p1 the end of the range >= p0
+ */
+ public abstract void damageRange(JTextComponent t, int p0, int p1);
+
+ /**
+ * Causes the portion of the view responsible for the
+ * given part of the model to be repainted.
+ *
+ * @param p0 the beginning of the range >= 0
+ * @param p1 the end of the range >= p0
+ */
+ public abstract void damageRange(JTextComponent t, int p0, int p1,
+ Position.Bias firstBias,
+ Position.Bias secondBias);
+
+ /**
+ * Fetches the binding of services that set a policy
+ * for the type of document being edited. This contains
+ * things like the commands available, stream readers and
+ * writers, etc.
+ *
+ * @return the editor kit binding
+ */
+ public abstract EditorKit getEditorKit(JTextComponent t);
+
+ /**
+ * Fetches a View with the allocation of the associated
+ * text component (i.e. the root of the hierarchy) that
+ * can be traversed to determine how the model is being
+ * represented spatially.
+ *
+ * @return the view
+ */
+ public abstract View getRootView(JTextComponent t);
+
+ /**
+ * Returns the string to be used as the tooltip at the passed in location.
+ *
+ * @see javax.swing.text.JTextComponent#getToolTipText
+ * @since 1.4
+ */
+ public String getToolTipText(JTextComponent t, Point pt) {
+ return null;
+ }
+}