Amiga Times/AmigaTimes.iso/internet/stricq/textinput.readme

Text File | 1998-10-06 | 13.7 KB | 451 lines

Textinput MUI Custom Class
==========================

This is a combined single/multi line editor gadget. Key features:

· only one compact class for single line/multi line mode,
  efficient due to code sharing
· same prefs for single line/multi line mode
· optional external editing in sync/async mode for multi line
  mode
· fully configurable key bindings
· supports cut & paste
· supports many style configuration options including
  blinking und bar cursor
· includes numeric mode with upper/lower bounds check
· support old stringclass tags/methods for easy "drop in"
  replacement in existing code
· works nicely in virtgroups (unlike the gadgetclass based
  stringclass)

The class is still somewhat in "beta" and doesn't have a
proper documentation. Include file and demo program source
are included, though.

Please copy Textinput.mcc, Textinput.mcp and Textinputscroll.mcc
into the MUI:Libs/MUI/ directory.

History
-------

11.10
-----
(first public release included in MD-2 0.182beta)

11.11
-----
- paste from clipboard now works
- fixed all kind of problems with internal
  status loss during certain operations
- SHIFT-DEL and SHIFT_BS now delete to beginning/to
  end of line

11.12
-----
- fixed problems with marking/cursor pointer
  pointing to freed mem on a buffer expand
- major speedup in text output
- cut & copy into clipboard now works

11.13
-----
- setting MUIA_(Textinput|String)_Contents with NULL
  caused enforcer orgy

11.14
-----
- prefs now have a "Samples" page of their own to
  make the group fit on 640x200 screen
- gadget didn't go inactive upon a cleanup
- DoCopy will now copy the whole contents to clipboard
  if no block is marked

12.0
----
- totally changed key control settings; keys are now
  a list of key/action pairs (up to 32). It's now
  possible to specify more than one key for an action.
- added a key action for calling external editor
  (defaults to "ramiga e")
- added MUIA_Textinput_MinVersion attribute; object
  refuses to create itself if the required version is
  less than current version

12.1
----
- fixed another problem with buffer expanding
- fixed another problem with active state loss

12.2
----
- added asynchronous external editor mode. If set, editor
  is called asynchronously, object remains enabled and
  a notification is made on the temp file. If changes to
  the file are made, it is reread.
- added default popup menu (defaults to on for multi,
  off for single line objects)
- speed up pasting of text from clipboard
- text input is generally faster now
- no longer craps out when trying to past multi line strings
  into a single line gadget

12.3
----
- "Mark all" would place the cursor pointer past the end of
  the buffer, thus creating all kind of not so neat side effects
- copying all text to clipboard caused to add a 0 byte at the
  end of the data
- Added optional wordwrap.

12.4
----
- pressing lamiga/ramiga command keys no longer activates any
  window menu shortcuts

12.5
----
- shortended popup menu title size
- wordwrap now defaults to "ON" for multi line gadgets
  (70 chars)
- "Cut line" now works as advertized
- fixed problem with cutting text loosing cursor pointer focus

12.6
----
- wordwrap defaults can now be specified in the prefs
- external editor can now be started multiple times in
  async mode

12.7
----
- fixed resetting of drawmode to JAM1 (fixes artefacts)
- setting/getting of MUIA_Textinput_Integer (and
  _String_Integer/_Numeric_Value) now works
- added MUIA_Textinput_Changed attribute

12.8
----
- fixed problems with D&D (Mousebutton events weren't eaten
  up, thus triggering D&D during mark)
- now handles attached popup and attached lists correctly
- pressing return in a single line gadget while text is marked
  no longer replaces that text

12.9
----
- fixed a problem with blinking cursor trashing the rastport
  drawmode

13.0
----
- now all keys are configurable independant of MUI navigation
  prefs
- added MUIA_Textinput_RemainActive attribute. Object will
  remain active even after pressing RETURN in a single line
  gadget.
- added MUIM_Textinput_Acknowledge method which is sent on
  pressing RETURN. Default handling is set() of MUIA_Textinput_Acknowledge
  and MUIA_String_Acknowledge to rootclass for backward
  compatibility.
- AcceptChars/RejectChars now work
- IsNumeric now works, including range checking
- notification on MUIA_Textinput_Changed is now possible
- added MUIM_Textinput_TranslateEvent hook method which allows
  to hook into textinput's inputevent->string translation.
  MapRawKey() has already been called at this place so the
  subclass can directly modify the translated buffer.
- MUIM_HandleEvent is now called on the real class, instead of
  being coerced on the textinput class directly, to allow to
  totally hook the input handling
- added MUIM_Textinput_InsertText method to insert text at
  the current cursor position
- pasting of multi line text into single line gadget is now
  possible; the application must be careful to process all
  text during the MUIM_Textinput_Acknowledge method (or
  notification triggered on MUIA_Textinput_Acknowledge),
  because the method is called for every line in the
  clipboard data
- added support for MUIA_Textinput_Secret/MUIA_String_Secret.
  Will not allow cutting/copying from such strings to avoid
  easy revelation of the password in question
- setting MUIA_Textinput_Contents now causes the cursor to
  be at the end of the text, not at the beginning
- multi line textinputs with scroller no longer send a
  scroller inform when the scroller positions haven't changed.
  Speeds up general option esspecially during text input.
- added word left/right functionality

13.1
----
- moved DEL/BS and TAB functionality to configurable keys, too
- changed key config ID to avoid clashes with previous
  (incomplete) key bindings
- fixed duplicate IDs for wordwrap on and wordwrap column
- HELP key no longer causes CSI trash to be inserted into strings

13.2
----
- various operations which modified contents didn't actually
  trigger notification on MUIA_Textinput_Contents/Changed.
- RemainActive now disables the automatic deactivation of
  the gadget when clicking outside of the container bounds
- fixed the "Last line" bug
- fixed bogus xoffset not resetting to 0 on set() of
  string contents

13.3
----
- fixed popup menu "Word wrap" toggling
- fixed string insertion to not always trigger a string
  acknowledge when inserting strings without \n
- fixed excess scrollbar refreshes

13.4
----
- added MUIA_Textinput_Lines attribute (notificable)
- fixed problems with cursor not being made properly
  visible when a left scroll is required
- fixed TAB to not do a double jump
- now holds a class global cache of translated input
  expressions; reduces object setup time drastically
  and reduces per-object memory requirements
- fixed a few more potential problems with the scroll bars
  not being updated correctly
- textinputscroll.mcc now properly forwards MUIM_Notify to
  the textinput object only

13.5
----
- no longer disables menu shortcuts when active

13.6
----
- added MUIA_Textinput_Editable
- works around a nasty problem with IEQUALIFIER_MIDBUTTON
  being set on every and all input events on some systems,
  thus making the input handling not match anything.
  Now strips down matched Qualifiers to keyboard only
  (without CAPSLOCK)

13.7
----
- unmapped special keys no longer cause bogus CSI sequences
  to be inserted
- now handles menu shortcuts again (textinput key defs
  take precedence, though)
- external edit button is now properly disabled in noedit
  mode
- "external edit" popup entry is now properly disabled in noedit
  mode
- secret mode no longer shows a bogus char at the end of line
- "cut line" no longer copies to clipboard (and therefore now
  works in secret mode, too)
- "cut line" didn't check whether the cursor was still visible
- revert changes now works
- pasting of multi line text into single line gadgets was
  hosed

13.8
----
- now raises task priority for more smooth input handling when
  active
- changed default key binding for "cut line" to "ramiga y"
  and for "cut marked" to "ramiga x"
- "Cut marked" now behaves differently in single line mode;
  if nothing is marked, the gadget is erased completely (to
  match standard amiga string gadget behavior)
- added double click mark handling; double click selects word,
  triple click line, quad click everything and more clicks
  deselects again
- added "backspace to start of word" and "delete till end of word"
  functionality, default mappings to control-bs/del
- menu shortcuts no longer trigger gadget shortcuts

13.9
----
- no longer inserts a bogus blank when tabbing out of the gadget
- added MUIM_Textinput_InsertFromFile functionality
- added "Insert file" UI functionality; default key binding "ramiga shift o"

13.10
-----
- added MUIA_Textinputscroll_UseWinBorder
- priority will now be set to normal if the window containing the
  gadget is deactivated

13.11
-----
- now using highly optimized TextFit/TextLength replacement for
  better output speed

13.12
-----
- improved overall speed with various internal optimizations
- fixed cursor size to be calculated from the font's blank width,
  not tf_XSize, which could cause problems with some font sets

13.13
-----
- Prefs: Label for cursor colors accidentally read "marked", too
- fixed a problem with characters not part of the current font
  messing up the size calculations
- now compiled with SAS/C 6.58

13.14
-----
- notify events are now directly CoerceMethod()ed on the notify class
  to avoid going through the areaclass dispatcher/OM_SET method

13.15
-----
- now sets writemask/maxpen on planar display for much better rendering
  speed on AGA systems

13.16
-----
- fixed a problem with the font not being set on initial redraws
- fixed a problem with planemasks not being reset when rendering
  the cursor, thus causing all kinds of artifacts

13.17
-----
- fixed a problem with the gadget not setting up properly when text
  was set()ed before receiving a MUIM_Setup

13.18
-----
- fixed enforcer flood when a object was MUIM_Setup'ed when containing
  text
- no longer does wordwrap in single line gadgets
- no longer wordwraps lines starting with ">" (to avoid messup of
  quoted text)
- reenabled double click functionality

13.19
-----
- modified default color scheme to use the BOOPSI stringclass
  alike color inversions for rendering the cursor
- fixed problems with the gadget remaining visually "active"
  even when the window containing the gadget was deactivated
- fixed task priority screwing

13.20
-----
- fixed disabling of Wordwrap/Insert file popup menu items
  for "NoEdit" mode gadgets
- fixed screwup with non-proportional fonts

13.21
-----
- default cursor color is now the complement of the active
  string color, not the standard string color (this matches
  stringclass behavior)

13.22
-----
- now recognizes some language specific chars as parts of
  words when jumping
- fixed a longstanding bug in the font width calculation
  which went berzerk upon hitting a non-printable character
  (control codes, for example)

13.23
-----
- fixed a bug with textinput going mad if the char kerning
  table had a negative value (xhelvetica, for example)
- "cut" didn't update some internal cursor state variables
  thus causing some messup

13.24
-----
- fixed another bug related to characters below tf_LoChar
  being in the font set
- fixed a race condition with MUIM_GoActive ariving before
  MUIM_Show/MUIM_Setup
- fixed a problem with wordwrap not stopping on a line
  which had other whitespaces before the trailing \n
- fixed a race condition in mccheader.c which could
  cause a big nuke during libopen
- fixed word jump not working with upper case letters

13.25
-----
- fixed another wordwrap related problem
- external editor is now called with 16k stack size
- fixed a long standing bug with asynchronous external
  editor calls only working once
- added MUIA_Textinput_MarkStart | _MarkEnd attributes
  which return the byte offset of the marked area
  start/end or MUIV_Textinput_NoMark

13.26
-----
- fixed another problem with the activation state
  being lost under certain circumstances

13.27
-----
- fixed serious bug with DoubleClick moving the
  internal mark start pointer before the actual buffer,
  causing all kinds of neat side effects including
  Major Crash®
- fixed cursor refresh problem when cursor was
  on a char with negative kerning values

13.28/29 (internal only)
------------------------

13.30
-----
- added hyper textfit/textlen code from V/MUI 4.0,
  improving output speed and esspecially input response
  times

13.31
-----
- fixed the just reimplemented "unknown char" offset bug
  again

13.32
-----
- MUIA_Textinput_MarkStart/End are now both settable.
- MUIA_Textinput_CursorPos is now settable.
- added new overridable method MUIM_Textinput_HandleChar
  which encapsulates the "single printable char"
  handler.

13.33
-----
- modified the activate/inactivate handling a bit

13.34
-----
- fixed handling of menu shortcut selection while TI
  is active
- fixed window activation sometimes not causing a proper
  redraw of the currently active TI object
- fixed some longword boundary alignments in TI's
  data structure which could cause uneccessary slowdowns
  on 68020+
- fixed button up events to no longer trigger a whining
  "Hey, this is a readonly-gadget!" beep in readonly
  mode
- did some general optimizations speeding up normal
  input

13.35
-----
- now strips \r when OM_SETting the complete buffer
- fixed another instance of the bogus "Hey, I'm readonly"
  DisplayBeep()-whining
- fixed broken cursor offset calculation in secret mode
- optimized calculation of current line length

13.36
-----
- fixed a serious bug in the drawline code which could cause
  a RectFill() call with min/max exchanged, thus causing a nuke
  on AGA
- removed all calls to OldOpenLibrary() to make Richard
  Körber happy