Package org.luwrain.controls.edit

Interface MultilineEdit.Model

All Superinterfaces:
Lines
All Known Subinterfaces:
MultilineEditCorrector
All Known Implementing Classes:
EditAugmentationUtils, EditCorrectorHooks, EditCorrectors.IndentationCorrector, EditCorrectors.WordWrapCorrector, EditUtils.ActiveCorrector, EditUtils.CorrectorChangeListener, EditUtils.EmptyCorrector, LegacyMultilineTranslator, MultilineEditTranslator, NewLineIndent
Enclosing class:
MultilineEdit
public static interface MultilineEdit.Model extends Lines
The model for MultilineEdit. It is supposed that this interface is a front-end for MutableLines in conjunction with HotPointControl, but you may use it freely as it is necessary for a particular purpose. See MultilineEditTranslator for a default implementation.

MultilineEdit guarantees that each user action results exactly in a single call of some method of this interface. This allows substitution of any method, which makes changes in the model, by any number of other methods in any order, and this will keep all structures consistent.

If some operation is addressed at the position outside of the stored text, the result may be undefined. The implementation of this interface should not issue any speech output.

See Also:

  • Method Details

    • getHotPointX

      int getHotPointX()

    • getHotPointY

      int getHotPointY()

    • getTabSeq

      String getTabSeq()

    • deleteChar

      MultilineEdit.ModificationResult deleteChar(int pos, int lineIndex)

    • deleteRegion

      MultilineEdit.ModificationResult deleteRegion(int fromX, int fromY, int toX, int toY)

    • insertRegion

      MultilineEdit.ModificationResult insertRegion(int x, int y, String[] lines)

    • putChars

      MultilineEdit.ModificationResult putChars(int pos, int lineIndex, String chars)
      Puts one or several characters at some position. The position expects to be valid in the content of the model, except of the case when there are no lines at all, lineIndex equals to zero and pos equals to zero. In this case the method must insert one empty line prior to making any required changes.

      After performing the operation, the method must prepare the MultilineEdit.ModificationResult object. If the chars arguments has the length greater than one, the string argument of the result must be set to the value of chars argument.

      If chars argument has the length equals to one, this single character must be returned as the character argument of the result. If the method is requested to insert a single spacing character, the string argument of the result must contain the last word prior to the inserting position. If there is no any word prior to the inserting position, the result may have the string argument empty.

      Parameters:
      pos - The position on the line to put characters at
      lineIndex - The index of the line to put characters on
      chars - The characters to put
      Returns:
      The MultilineEdit.ModificationResult object with the flag if the operation was performed and other corresponding information

    • mergeLines

      MultilineEdit.ModificationResult mergeLines(int firstLineIndex)

    • splitLine

      MultilineEdit.ModificationResult splitLine(int pos, int lineIndex)
      Splits the specified line at the specified position. This method removes on the line all the content after the specified position and puts the deleted fragment on new line which is inserted just after modified. If the position is given outside of the stored text, the behaviour of this method is undefined.
      Parameters:
      pos - The 0-based position to split line at
      lineIndex - The 0-based index of the line to split
      Returns:
      The fragment moved onto newly inserted line