*************************************************************** * * * This file contains the update notes on the textfield.gadget * * * *************************************************************** Version 3.1 ----------- NEW: - For what it's worth, the gadget is now compiled with the final SAS/C patch, 6.55. That made it a touch larger. - There is a bug in MUI, for version < 9 that doesn't allow BOOPSI objects to be deleted if they are created inside of MUI, and with the MUIA_Boopsi_Smart flag set to true. See the example code for how to fix the problem correctly. - Renamed the amigaguide gadget docs to textfield_gc.guide. - Renamed the debug gadget to textfield.gadget.db. - I never mentioned it, but be aware that the text you pass to the gadget is copied into an internal buffer, so you can reuse the buffer you pass. FIXED: - I have expanded which keys get passed on to the application when in read-only mode. Now just about everything. Only certain RAMGIA keys will not get passed. The keys for Select All (RAMIGA-A) and Copy (RAMIGA-C) will always be eaten by textfield. And if UserAlign is turned on, the alignment keys will be eaten: RAMIGA-[, RAMIGA-], RAMIGA-=, and RAMIGA-\. However, no RAMIGA key will be passed unless PassCommand is turned on. - Since TEXTFIELD_ReadOnly mode was put in, the alignment commands from inside the editor (RAMIGA-[ = \ ]) didn't work. They now work. - In 3.0 highlighting by dragging could have been excessively slow if Workbench's Input prefs had a long double-click time selected. This version fixes that problem. - A longstanding problem where hitting return near the start of a line should make the text in front of the cursor move up to the previous line has been characterized and fixed. - The TEXTFIELD_Modified flag now has applicability (ISGNU). It will notify when there is a change in the flag. - The TEXTFIELD_Modified flag never worked as far as I can tell. - Some improvments in speed are in this version. Backspacing should be faster now. - The SAS/C autoinit and autoterm functions have been fixed to inform the user when the gadget doesn't open. Version 3.0 ----------- NEW: - The autodoc (and guide file) has been restructured into many more sections so that pertinent information can be found more quickly. - TEXTFIELD_TabSpaces is a new tag that when set to 0 does nothing, but when set to a number greater than 0 sets how many spaces are inserted at the cursor position when the TAB key is pressed. - TEXTFIELD_NonPrintChars is a new tag that allows all characters into the text buffer in case you have a font that makes use of character position other than just Latin 1 printable. See the autodocs for more information. - TEXTFIELD_GetCopyright() is a new function in the library that returns a copyright string ready to use in a requester. See the autodocs and example program for more information on how to use it. - Now when you hold the SHIFT key and click in the gadget, text is marked from the current cursor position to the place you clicked. - You can double-click to mark whole words, or check the docs for what happens when you don't click on words. FIXED: - One copy of the 2.2 version made it out with a library version of 2.1. A replacement version was made, but did not get picked up. The library version is correct in this version. - The fix to speed up clipboard functions in 2.x ended up not freeing memory. It's all fixed now. Version 2.2 ----------- NEW: - There is now support for HSPascal in the directory of the same name. FIXED: - It seems that in repairing the delete bug in 2.1 I missed some other serious problems. Backspace after two or more returns now works. - Minor: I also left out the main Textfield.info in the 2.1 archive. Version 2.1 ----------- FIXED: - To scroll you had to be more than one font height away from the top or bottom of the gadget. You only have to be outside the gadget now. - Pasting into the gadget is much faster. - A serious bug with ALT BACKSPACE has been repaired. The bug would make it look like the computer was locked up, but really if you waited long enough, you could get things back, but it was nasty. In fact this is the first serious bug. Version 2.0 ----------- NEW: - The TextFieldAuto.c and now contain the TextFieldBase like before, and also the TextFieldClass. This keeps the opening and getting of the class hidden for a simpler API. (If you already had a TextFieldClass variable of your own, sorry, but you can just remove yours now.) (SAS/C applicable) - There are now keyboard commands to delete words at a time: Alt- Backspace deletes a word at a time to the left of the cursor, starting at the current cursor position (if you started at the middle of a word, it deletes to the beginning of the word, like you would think), Alt-Delete deletes a word at a time to the right of the cursor, starting at the current cursor position (again, if you are in the middle of a word, it only deletes the last part). - There is a real line delete command now: CTRL-x. It deletes everything on the line. It's not a command to delete all characters between to CRs, though. It's a visual line delete, not conceptual line delete. - Now when you click and drag to scroll the text display, the further you are away from the actual gadget bounds, the faster it will scroll. - TEXTFIELD_ReadOnly is a new attribute that gives the user a read only mode, but the user can still highlight text to use the clipboard. The old way of GA_Disabled and TEXTFIELD_NoGhost can still be used for a read only mode without clipboard support. It is important to know that the client (program using the gadget) can still add or delete text with TEXTFIELD_Text and TEXTFIEL_InsertText. See the autodoc for more details. There are issues discussed about which keyboard events get passed on to the application. - TEXTFIELD_Modified is a new attribute that allows you to tell if the text in the gadget has been modified in any way. It to FALSE at creation time, but can be set or read at any time. See the autodoc for more details - TEXTFIELD_AcceptChars is a new atrribute that allows you to set specifically which characters you will allow in your instance of a textfield gadget. Non-printable characters are still filtered for you as usual. These characters may not be accepted if they are also included in the rejection characters. Also see TEXTFIELD_RejectChars. And check the autodoc for more details. - TEXTFIELD_RejectChars is a new attribute that allows you to set specifically which characters to not allow in your instance of a textfield gadget. Non-printable characters are still automatically rejected. Characters listed here are always rejected. Also see TEXTFIELD_AcceptChars. Check the autodoc for more details. - TEXTFIELD_PassCommand is a flag that if TRUE will cause the gadget to pass Right Amiga key sequences on to the application if the gadget does not use it. If FALSE, the gadget just eats the events like it always has. When this is TRUE and a Right Amiga key command is received that the gadget does not use, the gadget is forced to become inactive (not disabled). - TEXTFIELD_LineLength lets you get a particular line size (the number of characters on that line). You pass the line you want and that value gets replaced by that line's length. See the autodoc for some issues when using this. - TEXTFIELD_SelectSize lets you turn on highlighting and set the number of character to be highlighted. It's always the number of characters from the current cursor position. If you pass 0, then highlighting is turned off. You can also get this attribute: 0 for no highlighting, otherwise returns the number of characters highlighted. - TEXTFIELD_MaxSizeBeep allows you to turn on beeping (DisplayBeep()) if text is entered when the buffer is full (buffer size equals the size you passed to TEXTFIEL_MaxSize). - TEXTFIELD_DeleteText allows you to delete text at the current cursor position. Only the size needs to be passed. This gives closure to the text insertion functions. - GA_IntuiText allows you to give the gadget a list of IntuiTexts that are rendered relative to the gadget's upper left corner. /* MENU COMMANDS */ The following are implemented so that programmers can put them in a menu to give the user a visual interface to the RAMIGA keys. - TEXTFIELD_Copy if text is highlighted, this will copy it to the clipboard. This command is just like RAMIGA-c when the gadget is active. - TEXTFIELD_CopyAll this always copies all the text to the clipboard. This command does not affect the state of the gadget. - TEXTFIELD_Cut if text is highlighted, this will erase the text and put it on the clipboard. This command is just like RAMIGA-x when the gadget is active. - TEXTFIELD_Paste pastes text from the clipboard to the current cursor position. If there was any highlighted text, it is deleted first. If you need to make sure that text is not highlighted first then do set of TEXTFIELD_SelectSize, 0. This command is just like RAMIGA-v when the gadget is active. - TEXTFIELD_Erase will remove all text from the gadget and place it in the undo buffer. This command is just like issuing RAMIGA-e when the gadget is active. - TEXTFIELD_Undo will paste from the undo buffer into the gadget, just as if the user had hit RAMIGA-u when the gadget is active. FIXED: - In V1.2, if you used the ActivateGadget() function on this gadget it would get put into highlight mode, and therefore the first typed key would be lost. - In previous versions, if you had TEXTFIELD_Partial on, the partial line would flicker when editing in the gadget. - In previous versions, the TEXTFIELD_Text attribute did not cause the cursor to move to the beginning. It now does. - TEXTFIELD_ClipStream2 now has a synonym: TEXTFIELD_UndoStream. The new name is easier to remember, but the old name can still be used. - GA_Image used to be offset from the upper left corner of the gadget's text box, not the upper left corner of the gadget itself. It's now fixed. (Only applies if border was set to something.) - Apparently there is a bug in RectFill() in pre-3.0 OSes. I've taken measures not to be bit by the bug, which could have shown up in previous versions of the gadget. - There was a major effort on my part to update the autodoc to better represent the features of the gadget. It seems that I had really only made a sparse effort before, and I apologize. Each part of the main documentation has a section title now. The document has grown by 16K. I also apologize if you hate reading docs. And I also apologize if you hate apologies. - A bug existed in previous versions that would allow you to have an active textfield gadget even if it was disabled. Specifically, if you called ActivateGadget() on a disabled gadget, the gadget would go active anyway. (I thought the OS did that.) It's fixed. - The command to move backward by words (ALT-CURSOR left) would skip a word if the was at the first of a line sometimes. Version 1.2 ----------- - The name is no longer editor.gadget. That name was too general, as Christoph Feck pointed out. The name textfield.gadget has been chosen as the new name since it more accurately describes the gadget's purpose. So that you will know how to convert, here is a list of files that have changed names that would affect development: doc/editor_gc.doc -> textfield_gc.doc doc/editor_gc.guide -> textfield_gc.guide fd/editor.fd -> textfield.fd gadgets/editor.gadget -> textfield.gadget include/gadgets/editor.h -> textfield.h include/pragmas/editor_pragmas.h -> textfield_pragmas.h include/proto/editor.h -> textfield.h Also, in your source code I think I've made it easy to change, but if you have problems, I'm very sorry. Here's how: use your text editor to replace all occurances of EDIT_ with TEXTFIELD_. - The text pen now defaults to TEXTPEN instead of SHADOWPEN. - The undo buffer is now cleared after you undo so that you don't accidentally undo the same thing multiple times. I should note that the undo function just drops the text at the current cursor position. - As per request of a few people, the TEXTFIELD_Down event now will not let the last line scroll to the top of the gadget, but rather it stops at the bottom, like when you cursor down. - There is no highlight or block mode anymore in the old sense of turning it on and off. You only need to click and drag to highlight text. Hitting any key replaces the highlighted text like normal, and hitting backspace or delete removes the highlighted text like normal. The cut, copy, and paste keys also work normally. The new features are that the right and down cursor keys unhighlight the text and take you to the end of the highlighted text. And the left and up cursor keys unhighlight the text and take you to the front of the highlighted text. (This new method can make scrolling with with the mouse pointer unfriendly, and you can accidentally delete text after scrolling by hitting a single key, but if an undo IFF stream is provided then the user can get the text back. I have asked many people whether they prefer single or double-click block modes and it has been about 50-50. This method conforms to modern thinking, from what I understand.) - A memory leak that occurred if the library was expunged has been fixed. It was usually about 4k. - TEXTFIELD_CursorPos now will scroll the text to the position the cursor is set to if needed. Version 1.1 ----------- - The EDIT_Text now works in all cases. It used to only work on creation and get methods.