Version History

• 2empowerFM v2.21, released September 4, 2010:
  • epConfig now takes Yes/No values as well as Y/N.
  • Updated for new Hands-Free Printer documentation.
  • All plug-ins will now load properly when your FileMaker path contains certain foreign language or other unicode characters. All plug-ins now have this fix applied and their version number incremented by 0.01.
  • Hands-Free Printer v2.2:
    • Re-wrote documentation and examples database.
    • All options now allow 'Yes' and 'No' values instead of just 'Y' and 'N'.
    • Added option to cancel print job.
    • Added an option to get a list of all paper size and source options for the selected printer.
    • Added an option to halt in the printer properties dialog to aid in debugging troublesome printers.
• 2empowerFM v2.2, released August 27, 2010:
  • Text Toolkit is now a free plug-in.
  • Text Toolkit v2.2:
    • Documentation re-written.
    • Running epRegExMatch or epRegExReplace no longer clears epVar("$lastError").
    • epRegExMatch and epRegExReplace support "Yes" and "No" values for parameters instead of just "Y" and "N".
• 2empowerFM v2.1, released August 20, 2010
  • The parent 2empowerFM plug-in now maintains separate version information from child plug-ins (such as Dialogs Unlimited). Future releases of individual plug-ins will have only the version of the individual plug-in updated.
  • The version number of each plug-in is now included in that plug-in's name when displayed in FileMaker Pro and Server plug-in lists.
  • The epVersion function can now return versions for different plug-ins and it can return in "AutoUpdate" or "ForDisplay" formats.
  • Fixes to optional AutoUpdate of new plug-in versions from FileMaker Server to clients:
    • On Macintosh, the version number reported by epVersion will now always be correct after the script that runs AutoUpdate completes.
    • On Macintosh, fixed issues that could cause the plug-in to crash FileMaker when unloaded and re-loaded during FileMaker's "Auto Update" process. This only fixes auto-update of this version to future versions - the crash can still happen when older versions are auto-updated to this version. If FileMaker crashes, the AutoUpdated version will be successfully installed when FileMaker is restarted.
  • SQL Runner v2.1:
    • Created new HTML documentation and created a new examples database.
  • Dialogs Unlimited v2.1:
    • Spaces are now trimmed from the front and back of menu items, menu values returned, radio buttons, and radio button values returned.
    • A Menu control containing an item assigned that will return a blank value will now be shown by default when a value="" control parameter is included.
    • Improved documentation based on user feedback.
  • Menu Popper v2.1:
    • Spaces are now trimmed from the front and back of menu items and menu values returned.
    • Improved documentation based on user feedback.
  • Developer Assistant v2.1:
    • Improved documentation of Regular Expressions.
• 2empowerFM v2.0, released July 27, 2010
  • Dialogs Unlimited:
    • Added the 'positionRelativeTo=Screen|Parent|FMDesktop' dialog parameter that affects the coordinates that the 'left', 'top', 'alignH', and 'alignV' parameters refer to. 'positionRelativeTo' now defaults to 'FMDesktop' for the 'left' and 'top' parameters.
    • Examples database was added.
    • Tab characters at the start of text controls are no longer trimmed off.
    • The "alignH" control attribute now moves every line of a block of styled text to the left, center, or right, overriding left/center/right alignment applied using styles within the text.
    • On Windows, corrected a bug that could rarely cause dialogs to have Text controls set to zero width with a huge height.
    • On Windows, dialogs will now move so no edge overlaps the taskbar. Previously, they would only move so no edge moves beyond the bounds of the screen.
    • The 'rememberDialog' parameter now defaults to "No" if a Password control is added. This prevents the unlikely possibility of another user showing the last remembered dialog in order to steal the remembered password.
    • "rememberDialog=Yes" now shows an error when applied to floating dialogs (it previously had no effect).
    • If a dialog is accidentally made too tall to fit on the screen and that pushes any part of a dialog button off the bottom of the screen, a close button is now added to the title bar. Since the title bar will always be visible, the dialog can be closed using the title bar close button even if other buttons are too far past the screen bottom to click.
    • When you request to close a dialog that doesn't exist, "notFound" is now returned to indicate the dialog didn't exist.
    • On Macintosh, fixed a bug where having a URL starting with "www." in a Text control followed by a URL starting with "http://" would not make the "www." URL clickable. A number of characters, like periods, that should not be included at the end of URLs are no longer included.
  • TweakUI:
    • New "openScript=<name of script>" command opens the script editor for whatever script name you request.
  • Any number of single-user licenses belonging to any user may now be installed along with any number of organization licenses all belonging to the same organization.
  • The default 2empowerFM toolbox hotkey is now Cmd/Ctrl-Alt-Shift-X instead of Cmd/Ctrl-Alt-Shift-F. This will not change the hotkey for copies previously installed.
  • On Windows, clicking the URL in the About 2empowerFM dialog box works once again.
• 2empowerFM v1.92 Beta, released July 15, 2010
  • Developer Assistant:
    • Updated XML parsing to fix some cases where special XML characters & < > ' " were not found in searches.
  • SQL Runner:
    • Added support for new features available to users of FileMaker 11. SQL statements can handle non-text data by replacing '?' characters with data from function parameters and return non-text data using an epSQLResult function. Using the new SQL engine also fixes some bugs introduced in the old SQL engine, such as the "insert ... select" SQL syntax not working.
    • Added additional error information reported by FileMaker's SQL API (although the errors returned by FileMaker 10 and earlier are not usually useful for debugging your SQL statements).
  • Dialogs Unlimited:
    • Added epDialogResult function. Removed the $dialogButtonPressed system variable.
    • For all control types that expand to the width of the dialog (such as multi-line text and field controls), the rightmost control that has no width assigned will now be the one to widen instead of the leftmost control on a particular line of controls.
    • The rightmost single-line field or password on each line that has no width assigned will now expand to the width of the dialog.
    • Multi-line text controls now wrap text to fit within the width of the dialog (at a minimum of 400 pixels wide), then narrow to the length of their longest line if appropriate. This sometimes eliminates white space to the right of a block of text and may result in a narrower dialog if other controls are not pushing it wider.
    • Multi-line fields and text with a vertical scrollbar no longer expand to 400 wide in the absense of other controls that widen the dialog. The minimum width of these controls increases as the number of lines increases up to a minimum width of 400.
    • You can now prevent the close button in the title bar from showing up even when no other button is added to close the dialog. This can be useful if you add a button that launches a script where the script decides whether or not to close the dialog.
    • Text shown with a scrollbar no longer begins scrolled to the bottom of the text when certain text is entered.
    • The '"{RTF}" to Text' button will now work when blank characters or a ';' character at the start or end of the "{RTF}" string are accidentally selected or copied to the clipboard.
    • On Macintosh, the progress bar window now always displays a blue progress bar instead of only turning from grey to blue when you click the progress bar window.
    • On Macintosh, fixed a case where placing certain characters in a checkbox or radio button could cause those controls to be too narrow, forcing the last word or the last character to wrap to the next line.
    • On Windows, the "buttonDefault" dialog parameter now highlights the button chosen with a bold or blue outline (depending on Windows version). Pressing Enter in any control that doesn't itself respond to Enter will activate the default button, but if you press Tab to cycle between buttons, pressing Enter now activates the button you have selected instead of the default button.
    • The "buttonDefault" dialog parameter may no longer be set to the name of the close button in the title bar.
    • On Macintosh, fixed a bug that could cause some dialogs to freeze if System Preferences > Keyboard > Full Keyboard Access was set to "All controls" (it is not by default).
  • Fixed problems on Macintosh (and possibly on Windows) that could occur if two copies of the plug-in are loaded at the same time. Normally this can't happen since FileMaker won't let you run two copies of itself, but it can happen if you're running FileMaker Pro at the same time as a FileMaker database packaged into a "runtime" application that also includes the plug-in. Problems fixed include freezing or crashing of FileMaker and the need to double click things in FileMaker that normally only need a single click.
  • Removed an error dialog that used to show when a firewall blocked the plug-in from accessing the network, such as to check for updates.
    
• 2empowerFM v1.9 Beta, released June 17, 2010
  • Fixes for Windows displays set to higher DPI (bigger fonts and controls):
    • Used new font in About dialog, progress bar, and Toolbox. New font fixes scaling calculations that formerly left an empty border on the right and bottom of the Toolbox when display DPI was set higher than 96 dpi.
    • Layout Painter: Drawn text no longer scales to match display DPI. This makes it match FileMaker layouts that also do not scale with DPI.
    • Dialogs Unlimited: Dialog controls on Windows are now sized correctly when display DPI is set higher than 96 (or higher than 100%).
    • Dialogs Unlimited: When display DPI is higher than 96 (100%), user specified values in pixels are now scaled up by a percentage that matches the scale of the DPI.
  • Dialogs Unlimited:
    • Added ability to include Radio buttons in dialogs.
    • Added Password control type for secure password entry.
    • New lineCount=X parameter lets you create tall input fields with scrollbars. These input fields have a white background while non-editable Text controls with scrollbars now have a grey background.
    • Dialogs now follow the Apple Human Interface Guidelines and Microsoft User Interface Guidelines. You can switch between the two standards.
    • Buttons now default to having right alignment instead of center. This is in line with interface guidelines from Mac and Windows.
    • Setting the width of a button now changes the visible width of the button instead of the area in which the button is aligned. This makes it possible to give multiple buttons the same width. Button height is not possible to change on the Mac, so it is not allowed to change on Windows dialogs either.
    • Neighboring buttons now have their widths automatically set equal. This can be turned off.
    • Setting buttonDefault or buttonCancel to a non-existant button now displays an error.
    • Many controls were resized slightly to make them look better or align more precisely.
    • Using Center or Right alignment on Text controls that are not in stylized text format now makes the text within the control take on center or right alignment.
    • Dialogs shown in Windows FM11 now center on the active database window even if the edit script or manage script windows are above the active (selected) database window.
    • Dialogs created with no button controls now have a close button added to the title bar.
    • You may now manually add a title bar close button.
    • Dialogs created with no controls at all (usually due to syntax errors in parameters) now show an error followed by an empty dialog with a close button.
    • Dialog controls on Windows now use the same font that FileMaker uses in its dialogs. The new font may make some text very slightly wider than it was with the previously used font.
    • An error is now shown when two controls are given the same name.
    • A button given no name or value parameter now uses its caption as the name returned when it's pressed.
    • A checkbox given no name uses its label as its name.
    • Other types of controls now have their name set to the caption of a preceeding text control if the text is under 40 chars long.
    • Controls without a name no longer return a value.
    • Renamed parameters 'x' to 'left' and 'y' to 'top'. Old names will continue to work but should not be used in future dialogs.
    • 'spaceAbove', 'spaceBelow', 'spaceLeft', and 'spaceRight' have been replaced by 'marginTop', 'marginBottom', 'marginLeft', and 'marginRight'. Added 'margin' parameter to set all four margins to the same value. The old names will continue to be supported but should not be used in future dialogs.
    • Added 'margin', 'marginTop', 'marginBottom', 'marginLeft', and 'marginRight' parameters to the dialog parameters which allows you to adjust the margin added to the edge of the dialog.
    • Added 'marginAdjust' parameters that allow you to adjust margins relative to their default size.
    • You may now specify control width/height/margin in number of characters instead of pixels.
    • You may now specify a set of controls that should take on the minimum or maximum width or height among all controls in the set.
    • Many controls, such as text labels, menus, checkboxes and radio buttons, will equalize their widths automatically when their left edges align.
    • In a menu control, if you don't set the 'menuDefaultDisplay' parameter but you do set the 'value' parameter, the default display is set to the first matching value found in the menu entries.
    • Setting the height of a control no longer prevents that control from aligning vertically next to other taller controls on the same line.
    • Dialog parameter values can now be specified as fulls word like 'Button', 'Text', 'Yes', 'Left', and so on. Single letters like B, T, Y, and L will still be supported.
    • The size of a Text control containing only one character is now calculated correctly on Windows.
    • Text controls containing a single line of text have always had their width set to the minimum width needed to display the single line. However, this feature did not work when large fonts were used on the single line. This is now fixed.
    • Text controls containing multiple lines of text but no scrollbar now also have their width set to the minimum width needed to display that text.
    • Multiline Text and Field controls with a scrollbar now grow to the width of the dialog even if the dialog width changes from default.
    • Single-line fields set to values containing line breaks now show a paragraph symbol instead of a line break (since the line break hides the fact there is more text below the visible line).
    • Cmd-W on Mac or alt-F4 on Windows will now close a dialog if no Button control exists on the dialog or if a button is assigned to 'buttonCancel'. Cmd-W or Alt-F4 return that buttonCancel was pressed if buttonCancel was assigned.
    • Fixed a crash that occurred when a dialog control was created with an illegal alignV value.
    • Reduced each control from requiring three parameters to only two. The old three-parameter syntax will still work but should not be used for new dialogs.
    • In two-parameter syntax, to conditionally prevent display of a control you must write "Hidden" instead of "".
    • Field controls now display the value of their second parameter. This is more consistent with what other controls do. Specifying value='something' in the control parameters still takes precedence over anything put in the second parameter.
    • Field controls no longer size themselves to the width of their content when their content isn't empty. Instead, they always default to 100 pixels wide.
    • Controls on the same line which have text baselines (the line on which most text sits, not including characters like 'y' or 'j' that extend beneath the baseline) within 4 pixels of eachother now have their baselines aligned. This behavior can be turned off.
    • Dialogs will now grow wider (up to 90% of the screen width) to prevent wrapping certain controls to the next line.
    • Dialogs now move so their edges are never cut off by the edge of the screen.
    • Checkboxes entered one after another now behave as a group, lining themselves up and wrapping automatically.
    • Fixed cases where using 'left' and 'top' to absolutely position a control would disrupt the flow of controls where 'left' and 'top' were not specified.
    • Added ability to group controls. Using a group, any number of controls can be included in a single parameter. The old method of simply putting multiple controls in a single parameter will no longer work.
    • Checkboxes and Buttons now use a 'key' parameter to determine the Alt or Option keyboard shortcut that activates them instead of using the & symbol in the caption.
    • If a user types \" (backslash, then double quote) in a field, it will now be returned correctly.
    • Typing Tab to move between controls on Mac no longer allows you to tab to text labels.
    • More descriptive error messages and more error checking was added.
    • Added 'var' and 'varResult' parameters to return a control as a variable instead of in the returned list of named parameters.
    • Added 'rememberDialog' and 'showRememberedDialog' parameters.
    • Added 'closeDialog' dialog parameter to be used to close a floating dialog.
    • Added 'closeDialog' control parameter to make a button that calls a script also close the dialog.
    • Fixed in Macintosh FileMaker 11: Buttons in the Toolbox now function when FileMaker modal dialogs prevent all other windows from being accessed. This allows the use of buttons like 'Text > "{RTF}"'
    • Clickable "word" links that don't show the URL can now be added in Windows using stylized text.
  • Developer Assistant: You can no longer click Evaluate again before closing the result of the previous evaluation. Doing so sometimes led to a crash.
  • Keyboard and Mouse: You can now hotkey variable types other than local or global.
  • Hands-Free Printer: Default paper size and source are no longer set to 'Letter' and 'Automatically Select' when no value is given. These values differ depending on the printer and region of the world.
  • Utility: The Toolbox 'Dump Vars' button no longer tells you the 'Utility' plug-in is not licensed. Utility functions are not meant to require a license.
  • Background of the 2empowerFM Toolbox now matches the color of the active tab on Windows.
  • Warning that used to show on Windows when DPI was set to anything but 96 (100%) no longer shows unless DPI is set to a non-standard value (other than 100%, 125%, or 150%). Warning is shown only once after DPI has changed.
    
• v1.53, released March 26, 2010
  • Dialogs Unlimited: Fixed dialogs sometimes appearing centered over an invisible Inspector window in Windows FileMaker 11.
  • Menu Popper: Added 'left' and 'top' parameters to work with GetLayoutObjectAttribute() coordinates. 'x' and 'y' parameters will continue to work with FieldBounds() coordinates.
  • Menu Popper: New documentation complete.
• v1.52 RC1, released March 18, 2010
  • Updated all plug-ins to be compatible with FileMaker 11.
  • Developer Assistant: Searching for the five special XML characters (" ' & < >) now works without escaping them. This makes it easier to do things like search for '<unknown>' to find cases where scripts or functions have been deleted.
  • Developer Assistant: Searching in 'list lines' in Manage Scripts, then switching to a single script and back to Manage Scripts no longer causes two entries for 'list lines' in the Toolbox "search in" dropdown.
    
• v1.51, released January 31, 2010
  • Dialogs Unlimited: Changed the default font used on PC dialogs. The new font is identical except that it displays a wider range of unicode characters.
  • Dialogs Unlimited: Scrolling text views now have a border.
  • Dialogs Unlimited: Turned on shadow effect beneath Mac Progress Bar dialog.
  • Dialogs Unlimited: You can no longer close PC FileMaker while a non-floating dialog is open.
  • Changed the look of the 2empowerFM Toolbox on Mac, making it smaller with its height dependant on which tab is selected. Turned on shadow effect beneath the toolbox.
  • Fixed a crash on Mac that occurred when 2empowerFM Preferences were opened when the 2empowerFM Toolbox had never been displayed.
• v1.5, released December 27, 2009
  • Removed EULA pop up dialog and changed default usage reporting to false.
  • Split Toolbox functions into multiple tabs so the Toolbox uses less space on screen.
  • Toolbox now saves its last location when you close it and the toolbox is only shown on startup by default if you install Developer Assistant.
  • Began the process of splitting up functions and features into multiple plug-in files, allowing you to install only the features you need. A shared plug-in provides backwards compatibility to existing users and keeps internal functions used by multiple plug-ins in one place.
  • On windows, if you close the Toolbox when no other FileMaker window is open, the question about whether to open the Toolbox next time is no longer displayed behind the main FileMaker window.
  • Added a preference to control whether the message explaining how to open the Toolbox is shown when the Toolbox is first closed.
  • Added commands to epVar: $eraseScriptVars, $eraseWindowVars, $eraseDatabaseVars, $eraseGlobalVars, and $eraseSystemVars. epVar() is still equivalent to epVar("$eraseScriptVars"), but this syntax is deprecated.
  • Discontinued Super Variables plug-in. Its features are now free and included in every other plug-in.
  • Plug-ins that require no user interaction are now compatible with FileMaker Server and FileMaker Server web publishing.
  • Warning about using a display DPI set to a non-standard value is now shown only once when a new value for DPI is encountered.
  • Fixed a crash that could occur when certain other FileMaker plug-ins were installed on Windows.
  • Fixed a crash that could occur randomly, usually when using Keyboard functions. The error message said the crash occurred at location 0x0009fdfd on Windows and could have also affected Macintosh, though no Macintosh crashes were reported.
  • Pressing ESC no longer cancels a running script in Windows FM10 if you hotkeyed ESC or when ESC is set to cancel a progress bar dialog. This was not possible to fix in Mac FM10.
  • epKeyPressOnEvent now prevents Windows FM10 from complaining you need to be in a field before you type.
  • Developer Assistant: Created extensive HTML documentation.
  • Developer Assistant: Added option to "Match Case" when searching.
  • Developer Assistant: Search in scripts now works in all cases when a script group is contained in another script group.
  • Developer Assistant: Search in lists now searches in all columns of the list, not just the first column. This lets you search for things like variable name, value, or type in FileMaker's "Data Viewer".
  • Developer Assistant: Added progress bar to show the progress of a search.
  • Developer Assistant: "Search in database" checkbox has been replaced with a pulldown menu whose contents change depending on what can be searched in the foreground FileMaker dialog.
  • Developer Assistant: If another application has locked the clipboard so FileMaker can't copy to it, Developer Assistant attempts to tell you the name of the window locking the clipboard.
  • Developer Assistant: Fixed a case where your search in scripts would search in the wrong window if you changed which window was in the foreground before continuing your search.
  • Developer Assistant: Added code that may prevent a rare error: "OpenClipboard failed with error 0"
  • Developer Assistant: Fixed a rare crash that could occur when searching with certain types of data already on the clipboard.
  • Dialogs Unlimited: Added three more pixels to the default padding around dialogs.
  • Dialogs Unlimited: On the mac, pop-up menu controls are now drawn with a graphic style that looks like pop-up fields in FileMaker and matches the style used in Windows dialogs.
  • Dialogs Unlimited: Progress bar dialog now grows vertically when given a caption that won't fit on one line.
  • Dialogs Unlimited: Progress bar on Mac is now displayed even at zero percent.
  • Dialogs Unlimited: Controls are now positioned correctly when given a manual vertical (y) value greater than zero.
  • Tweak UI: Fixed a rare case where tweakSortOrderWindow=limitToRemoveFieldsWithADSortOrder had no effect on the sort order window until it was moved or resized.
  • Menu Popper: Clicking a menu that has a sub-menu no longer returns a result on Mac - the click is ignored.
• v1.431 for Windows and Macintosh, released December 8, 2009
  • No changes other than the release date. This release was required because the previous version expired.
• v1.43 for Windows and Macintosh, released September 3, 2009
  • Dialogs Unlimited: In Snow Leopard, showing a floating 2empowerFM dialog will no longer prevent you from clicking FileMaker's "Show Custom Dialog" dialogs.
• v1.42 for Windows and Macintosh, released August 25, 2009
  • Layout Painter: New example in manual demonstrates the ability to draw light grey text inside of empty fields. This text can describe what should be put in the field and disappears when the user types something.
    Layout Painter: epDrawErase now supports two new parameters that let you choose whether to "erase" and/or "delete" drawn objects. This distinction is described in the manual and is only useful in special situations.
• v1.41 for Windows and Macintosh, released August 20, 2009
  • Layout Painter: Added an example to the manual of painting over a label-printing preview to let a user pick which labels to print on a partially-used label sheet.
  • Keyboard Commander: Added a key called "CONTINUE" which will work with epKeyPressOnEvent or epKeyPress to continue a paused script or perform a find. Using the "ENTER" key did not always work for that behavior on the Mac.
  • Keyboard Commander: Hotkeying ESC should now work in FM10 on mac and epKeyPress and epKeyPressOnEvent work in a few more situations on mac.
  • Keyboard Commander: The "RETURN" key is now the "ENTER" key in documentation. "RETURN" will still work but is deprecated.
  • Tweak UI: Fixed error "Invalid server socket." which occured when Tweak UI's "openRemoteOnStartup=Y" option was used and it was time to report usage data when FileMaker was started.
  • Mouse Master: Fixed a case where epMouseClick could return the wrong location when the mouse was clicked in preview mode on the mac.
  • Super Variables: The names of script scope variables are no longer blank in Var Dump.
  • Hands-Free Printer: The openPrintDialog option now defaults to N and the documentation has been updated to indicate this option doesn't work when a script is running. Use the Print[] script step instead of this option when scripting.
    
• v1.4 for Windows and Macintosh, released August 13, 2009
  • Dialogs Unlimited: Buttons can now call a script instead of closing the dialog.
  • Super Variables: Output of Dump Vars now displays using a bullet list on Mac (the bullets formerly only showed up on Windows).
  • Dialogs Unlimited: When showing stylized text in a dialog on Mac it will no longer delete spaces appearing between certain style transitions created in TextEdit. One such place this happened was when non-italic changed to italic text.
  • Layout Painter and TweakUI: No longer fails when a database has a '(' in its file name. Minor problems may still occur when your database name ends with ').fp7'.
  • TweakUI: Removed the "Show Open Remote" option from windows 2empowerFM preferences. This feature must now be accessed with epTweakUI().
  • 2empowerFM Toolbox has been reorganized into sections for each plugin. Changed "Paste RTF" button into "String > RTF" and added a "RTF > String" button. Both buttons now work on Macintosh but will only automatically copy/paste for you on Windows.
  • Updated manual with instructions for creating RTF bullet lists compatible with Mac and PC.
  • Using a function from any particular plugin will now ask if you want to begin a 30-day trial of that plugin. Trial periods for each plugin are now tracked separately and can be viewed in the About Dialog.
• v1.3 for Windows and Macintosh, released August 4, 2009
  • The manual has been redesigned and split into one tab for each 2empowerFM plugin. A new Function Index button lets you jump directly to a particular function. Many topics were edited and clarified. The new manual demonstrates multi-row tabs and horizontally scrolling tabs.
  • Layout Painter can now return to you the size that drawn text will be on your layout so you can choose where to draw it and position things around it.
  • Layout Painter can now draw foreground and background tabs facing up, down, left, or right.
  • Layout Painter's epDrawClear is now epDrawErase and can now take a single parameter with multiple drawn object IDs separated by spaces instead of passing multiple parameters each with a single drawn object ID. It also now works when the drawn object ID is negative.
  • Layout Painter's epDrawShape and epDrawText no longer return blank DrawIDs when called during certain phases of window drawing. Calls to epColorReplace and epDrawErase are no longer ignored during those same times.
  • Layout Painter's epDrawShape and epDrawText of a drawn object that already exists will now move the existing drawn object to the end of the list of objects to be drawn. In this way, the existing object will draw last (in the foreground).
  • Layout Painter's epRepaint is now epDrawCommand and has a new command to be issued after the Refresh Window script step to make sure Layout Painter objects are redrawn in all FM versions. Calling epDrawCommand with no parameters will continue to work like the former epRepaint, but this functionality is deprecated.
  • In Mac FM7, using a script to change the layout and then drawing something in the script should no longer cause improper erasing of previously drawn objects.
  • Mouse Master's epMouseClick now returns unquoted x and y parameters that will produce a number instead of a string when you get the value using epParam("x"; epMouseClick). When comparing a string to a number, "129" > 19 returns false, which meant that the location of a mouse click could be misinterpreted if you did not use GetAsNumber(epParam("x"; epMouseClick)) > 19
  • The epParam function no longer requires a license (it's free), and epVar will work without a license to read (but not write) a variable.
  • The "Variables and Parameters" plugin has become "Super Variables" and has new features: Two new types of variable can be set that are local to the current FileMaker window or local to the current FileMaker database. In other words, the value of epVar("@myDBVar") will be the same in each window that refers to a particular database, while epVar("#myWindowVar") will be different in each open window, regardless of the database. The 2empowerFM manual makes use of these new variables for tracking which tab is active in each window.
  • Super Variable's Dump Variables function now uses bullets and bold variable names to make things easier to read. Values are single quoted so you can tell an empty variable from a space. The name of the currently running script is printed correctly once again and Window and Database scope variables are now included.
  • Menu Popper will no longer show a blank menu item when given a blank line in the menu definition.
  • RegEx Text Master can now be told to end an iteration of RegEx matches before the iteration is complete.
  • Added a new license-free epConfig function to replace some of the functionality formerly handled by epTweakUI. Old calls to epTweakUI will continue to work for the time being but should be changed into epConfig calls.
  • Added epConfig("getToolboxHotkeyDesc") to get an english description of the hotkey that brings up the 2empowerFM Toolbox. This description is shown in various places in the new manual.
  • epLicense now returns "?" on error to be more consistent with errors returned by other functions.
  • A license with a single quote or backslash in it now saves and loads correctly (although nobody had actually purchased such a license).
  • The plugin suite now runs on a 30 day trial period. There is no longer a need to type in a string of digits to close the nag dialog that now informs you each day how many days remain in your trial.
  • Usage reporting is now optional for unlicensed plugins.
  • This 1.3 release begins a new versioning standard where major releases increase by 0.1 and minor releases increase by 0.01. Minor releases tend to be unplanned bug-fix releases. Formerly, major releases increased by 0.001 and minor by 0.0001.
    
• v1.2651 for Windows and Macintosh, released July 16, 2009
  • Fixed a bug affecting FM8 and later in OSX previous to 10.5.6. When using Layout Painter functions in multiple windows, especially multiple windows in the same database, layout painting, last mouse click point, and possibly other functions would sometimes stop working in the additional windows.
  • epError now logs a clearer message when no script is running or when its script parameter is blank.
    
• v1.265 for Windows and Macintosh, released July 9, 2009
  • The Gap_Filler FileMaker plug-in has become the 2empowerFM Plug-in Family. One plugin file will continue to contain the main functions so that users of Gap_Filler don't have to find and replace function names throughout their databases.
  • If you place the 2empowerFM plugin in the same directory as the former Gap_Filler plugin, Gap_Filler will be deleted for you.
  • Using the alwaysRedraw flag in Windows no longer causes the drawn shape to flicker when any part of the screen is redrawn.
  • Windows no longer fails to draw items if items are drawn immediately in the first window you open after starting FileMaker.
  • epKeyPressOnEvent will now work even if the foreground FileMaker window changes before the event occurs on Windows.
  • epMenuShow on Windows will now show the menu at the point you specify in the foreground window when that window is maximized and epMenuShow was called from a background window.
  • The version number of the Mac plugin has been made equal to the Windows version since most Mac features are now implemented.
  • GF_MouseBtnLastDownPos is now called epMouseClick and GF_CursorSet is now called epMousePointer
  • GF_LicenseSet is now called epLicense and takes an additional optional parameter that allows you to get information about all the licenses installed or remove licenses. Multiple regular licenses can now be installed as long as they belong to the same person and organization.
  • GF_VarDEPRECATED (formerly GF_VarSet) has been removed.
    
• v1.2641 for Windows and v0.1101 for Macintosh, released May 29, 2009
  • Mac GF_HotkeyVarSet will now resume a paused script when the keyboard cursor is in a field.
  • Fixed some periodic graphics glitches in the status area in Mac FM7 related to using the new drawing/color replace. The same bug made the cursor difficult to place in a field in Find mode.
  • Fixed a bug introduced in the last version where GF_MouseBtnLastDownPos sometimes returns the wrong value.
  • Added "alwaysRedraw" parameter to GF_DrawShape/Text to allow you to draw something over a FileMaker field that will not get erased when the field is drawn during record scrolling.
  • Found a better way to detect when FM redraws the entire layout in Mac FM8 and later. This fixes intermittant cases of the same object being drawn more than once or not drawn at all.
  • Fixed a situation on Windows where drawn objects could flicker more than necessary.
    
• v1.264 for Windows and v0.110 for Macintosh, released May 29, 2009
  • Mac drawing of shapes, text, and color replacements is complete and out of beta.
  • GF_DrawShape/Text will no longer draw the same thing more than once when you do things that cause the layout to redraw. Drawing more than once used to cause the edges of rounded objects to become blocky. This issue occured on Windows and Mac but the solution was quite different on each platform.
  • Calling GF_DrawShape/Text twice with the exact same parameters will no longer draw a second copy of the object.
  • On Windows, recolored areas are no longer drawn in the wrong location when the window scrolls in uncommon ways.
  • Improved developer license support allows multiple developer licenses to coexist along with a single non-developer license.
  • GF_KeyPressOnEvent now works in more situations on Windows, such as to continue a paused script by clicking anywhere in the layout.
  • GF_KeyPress will now press keys if you pause the active script. Otherwise, keys aren't pressed until no script is running.
  • For better compatability with windows Vista, Gap_Filler preferences are now stored in the "current user" section of the system registry rather than a section shared among all users. Shared configs will automatically convert to per-user configs when you install this version.
  • Fixed a memory leak when using tweakUI to hide the Find/Continue buttons.
  • Corrected documentation for GF_DrawText: A weight of 700, not 1000, makes a font "bold". Weight 1000 is as bold as possible (sometimes called "black").
  • Added a new option to Windows GF_TweakUI: tweakSortOrderWindow. This feature was added by commission at the request of a Gap_Filler user and has been included in the public release with permission.
    
• v1.2632 for Windows and v0.1092 for Macintosh, released April 9, 2009
  • Mac FM7 now works correctly when the layout is scrolled.
  • Windows GF_DrawShape will now draw rectangles, ellipses, and pies with even border line widths without creating faded (antialiased) straight lines.
  • Pie shapes with no border line width now draw 1 pixel wider and taller to correctly match the width/height requested (this change can't be seen on pie shapes with borders).
  • GF_NumberFormat will no longer return an error when given "" or 0 as the number.
  • The unlicensed plugin expired warning now only shows up if you call a Gap_Filler function. GF_Version and GF_LicenseSet will not show an expired warning and can be called even if the unlicensed plugin has expired.
  • Calling GF_LicenseSet with no parameters will now return "?" if the plugin is unlicensed, or it will return your license information in a string parsable with GF_Param.
• v0.1091 for Macintosh, released March 27, 2009
  • This version has beta support for the GF_DrawShape function, but some aspects such as erasing the shapes using GF_DrawClear are still under development.
• v1.263 for Windows and v0.109 for Macintosh, released January 22, 2009
  • All functions updated to work in FileMaker 10.
  • The 'clear=N' option in Mac GF_Clipboard now works.
  • GF_Clipboard now works on 'Mac-FMcs' and 'Mac-FFIs' data which is used in conjunction with 'Text' data to represent character formatting in FileMaker fields copied to the clipboard.
  • You can now set the hotkey used to open the Gap_Filler Toolbox by going to Edit > Preferences > Plug-Ins > Gap_Filler > Configure > Preferences
  • GF_ColorReplace and GF_Draw now affect a tiny sliver of screen next to each scrollbar that was previously omitted.
  • Added GF_TweakUI('ShowToolbox') command.
  • To make it easier for international users with different alphabets, the about dialog now asks you to type in numbers.
    
• v1.262 for Windows and v0.108 for Macintosh, released January 5, 2009
  • You may now place multiple dialog items in the same parameter, as in: GF_Dialog("buttonDefault='ok'"; "'T' '' 'test' 'B' 'name=ok' '&OK'" ) This is useful when you want to build a dialog with a variable numbers of items.
  • Toolbox Search now tells you where it was searching when it can't find a result.
  • Toolbox Search 'in scripts' option changed to 'in database' and works for searching in the Database Manager's Table and Field tabs.
  • Toolbox Search 'Exclude Step Names' was changed to 'Exclude Names' to refer to script step, table, or field names. Some names that were formerly not found, like "Loop", are now correctly found.
    
  • Toolbox Search will work properly when Script Debugger or Data Viewer is open in FM9.
  • Added GF_TweakUI(setErrorCapture and getErrorCapture), along with GF_Var("$lastError")
  • Added "iterateMatches" option to GF_RegExMatch and GF_RegExReplace.
  • In windows, GF_Error no longer centers the error dialog on the last GF_Dialog shown when that dialog is hidden.
  • GF_TweakUI can now be called when no FM window is open.
  • GF_Var is more efficient when setting variables.
  • GF_Var will no longer overwrite a local var in a parent script when a child script with the same name but in a different database file contains a GF_Var with the same name (this situation was rare).
  • GF_MenuShow will now return an empty string instead of a single character NULL when given an empty string value in the menu definition (ie. "Item;" will return an empty string when Item is chosen).
• v0.107 for Macintosh, released September 16, 2008
  • Adds GF_ProgressBar feature to Mac.
  • Option-hotkeys and default/cancel button hotkeys now work no matter where you are in a Mac GF_Dialog.
• v1.2612 for Windows and v0.1061 for Macintosh, released September 8, 2008
  • A recent WinXP update broke Toolbox Search and Evaluate. This release fixes it.
  • GF_Error will no longer overwrite the cache of the last GF_Dialog.
• v1.261 for Windows and v0.106 for Macintosh, released September 1, 2008
  • GF_Error is now available on the mac. It automatically writes the error, FileMaker error code, current file, user, script and layout to /var/log/system.log, The user only sees the error text you supply and they are asked to contact the administrator. The option to include an icon in the user error message has been removed on Mac and PC. If anyone really thought the icon was useful, let me know.
  • Fixed a bug in how dialogs were centered when no database was opened in OSX 10.4 (I don't think 10.5 was affected). Also fixed a centering bug that seems to have only affected the Gap_Filler Preferences window.
  • Fixed a windows bug in GF_Error that prevented it from logging the Script Parameter. Added logging of User Name and Get(LastError).
  • Fixed two bugs in Mac GF_Dialog. One would give certain menus a default size that was too large while the other would not show the last dialog correctly when GF_Dialog is called with no params.
  • Added new 'cache' parameter to allow you to display a non-cached GF_Dialog followed by re-display of a previously cached one.
  • Fixed many bugs with Gap_Filler dialogs and menus that only occurred in FileMaker 7.
  • If you have an error in your SQL syntax, GF_SQLExecute now displays an error with SQL code that's easy to copy and paste to evaluate and test elsewhere.
• v1.260 for Windows and v0.105 for Macintosh, released July 15, 2008
  • GF_HotkeyScript, GF_HotkeyVarSet, GF_HotkeyCommand, GF_Keypress, and GF_KeypressOnEvent are now implemented on mac.
  • Fixed various keys that couldn't be hotkeyed on Windows including F1-F12 and the Windows key.
  • Fixed windows GF_Keypress of 0 to 9 and -.
  • GF_KeypressOnEvent can't be used to press Command-B to exit preview mode on mac. I'm still investigating how to fix this.
  • "About Gap_Filler" dialog on Mac has been fully implemented to work as it does on Windows, including access to preferences.
  • Mac Gap_Filler Toolbox added with functionality for Dump Vars and Preferences.
  • Gap_Filler Toolbox will no longer default to being shown on startup unless you're running FileMaker Developer or Advanced.
    
• v1.2591 for Windows and v0.1041 for Macintosh, released June 28, 2008
  • These versions fix a bug where GF_Dialog would ignore the x and y parameters.
  • Fixed a rare clipboard error 1456 when searching in scripts on Windows.
    
• v1.259 for Windows and v0.104 for Macintosh, released June 18, 2008
  • To support international languages, extensive work was done to make Gap_Filler use 'Unicode' characters for all its functions. Although hundreds of changes were made internally, I spent a lot of time testing everything so I don't expect problems.
  • Warning: Because of the new unicode support, GF_Hash will return a different value than it used to when you pass it any non-standard English characters (any character with unicode value 128 or higher). This includes "smart quotes" (where the left and right quote are a different shape). FileMaker typically inserts smart quotes when you type into a field.
  • GF_Clipboard support added for the Mac.
  • GF_Clipboard("returnAvailableFormats") added to return a list of formats currently on the clipboard.
  • New clipboard samples, a button for creating RTF for Mac dialogs, and SQLExecute information added to the manual.
  • GF_Param now changes line breaks into spaces in the value it returns. This matches the behavior of Evaluate("Let([" & MyParams & "]; ParamName)").
  • The internal "named parameter" parser was re-written to be more efficient and to handle certain rare combinations of escaped characters correctly, such as interpreting the value 'x\\\'' as x\' This change also allows you to use any character other than space or equal in an unquoted parameter name or value, which should be useful for international characters.
  • Fixed an uncommon case on the Mac where a checkbox item in a dialog could be made too narrow to show the text next to the checkbox without wrapping the text to the next line.
  • "An update is available" and license key conflict dialogs will no longer appear until you've opened a database. This guards against a crash that happens on some Macs if a dialog is shown during FileMaker startup.
  • Code was added to support the developer license.
  • Fixed a bug that could cause incorrect graphics to be drawn by GF_DrawShape/Text if you closed a window and opened a window with the same name.
    
• v0.103 BETA for Macintosh, released May 2, 2008
  • GF_MenuShow has been implemented, along with the pop-up menu control in GF_Dialog.
  • GF_MouseBtnLastDownPos now works correctly if layout is not scrolled to its top-left position.
  • Rich text in dialogs will now display the same way on OSX 10.4 and 10.5 (bold/italic formatting and other things were formerly broken in 10.4).
  • Vertical scrollbars now appear on text in a GF_Dialog that is too tall for the height limit you set on the text.
  • Fixed a bug that would crash GF_Dialog if more than one URL appeared in a text control or the URL ran to the end of the text.
  • Your purchased license shows up in about dialog.

  v1.258 released May 2, 2008

  • Added "runWhen" option to ScriptQueue
  • GF_RegExReplace now accepts a "replaceAllMatches" parameter that defaults to "Y" (yes).
  • Fixed the fact that searching in scripts with "Use RegEx" unchecked would sometimes only find the first match over and over.
  • A menu with no default value assigned will no longer default to 100 pixels wide but to the width of the longest value in the menu.
  • Fixed a crash that could occur if you press Evaluate after switching back to FM from another app without first clicking the field you want to evaluate.
  • Fixed a crash that could occur if you pass too few parameters to GF_RegExMatch or GF_RegExReplace
  • Fixed a read past end of buffer error occuring after the weekly usage report.
  • Changed a number of functions to pop up an error message if you pass them the wrong number of parameters instead of just returning "?" in FM9
• v0.102 BETA for Macintosh, released April 22, 2008 (happy Earth Day!)
  • Added support for GF_Dialog (everything except the pop-up menu control).
  • Added GF_MouseBtnLastDownPos, although it will report the wrong point if the layout is scrolled away from the top or left edges. This function uses a mouse tracking feature available only on OSX 10.4.9 (Tiger).
  • Updated manual to be usable on the Mac.
• v0.101 BETA for Macintosh, released April 3, 2008
  • First Macintosh release for public BETA testing. Universal binary supports GF_SQLExecute, GF_Param, GF_Var, GF_RegExMatch, GF_RegExReplace, GF_Hash, GF_ScriptQueue, GF_NumberFormat, GF_MoneyToWords, GF_Version, and GF_LicenseSet.
• v1.257 released March 27, 2008
  • GF_Param("param") now changes ¶ to character code 10 in the value it returns so that it matches what Evaluate("Let([" & Get(ScriptParameter) & "]; param)") would return.
    
• v1.256 released March 22, 2008
  • New GF_SQLExecute function performs SQL queries on FileMaker tables.
  • GF_Param() now changes \\ to \ and \¶ to ¶ in the value it returns. Previously, it would only change \" to ". This also allows you to use FileMaker's Quote("your parameter") to safely pass a parameter containing any character combination to a Gap_Filler function.
  • Replaced [ ] with " " to identify named parameters in all documentation.
  • Changed flags for GF_RegExMatch and GF_RegExReplace to descriptive words. Perl-style single-character flags will continue to work but are not documented and should be avoided so that people reading your scripts who don't know Perl are not confused.
  • Fixed bugs in manual that were caused by adding the version number to its name before each release.
• v1.255 released March 16, 2008
  • Updated EULA and nag dialog.
• v1.254 released March 14, 2008
  • Fixed a memory corruption during plugin initialization that could cause a crash.
• v1.253 released March 8, 2008
  • Added a "RegEx" checkbox to the Toolbox to let you choose whether or not to use regular expressions in your find string.
  • You can now stop the GF_Toolbox from showing on startup by calling GF_TweakUI("showToolboxOnStartup=N"). If TweakUI is called in the Startup Script (under File->File Options) of the first database opened, the Toolbox will never show.
  • Usage stats report more information.
• v1.252 released March 1, 2008
  • Usage stat reporting now includes how many times additional features (such as using Find in the Toolbox) are used.
• v1.251 released February 29, 2008
  • Usage stat reporting now includes how many times each function is called so we know what's most popular and needs development.
  • Turning off usage reporting now asks you why you're turning it off.
  • Clickable URLs in dialog-box text now work again.
  • Option added to show a dialog box when a new version is available. You can turn it off or on in Preferences or with the 'checkForUpdates' option of GF_TweakUI.
  • End User License Agreement now appears as its own dialog if you have not yet agreed to the EULA, and the purchase "nag" dialog only appears when you call a Gap_Filler function. This way, you won't get nagged if you aren't actually using any features of Gap_Filler.
• v1.250 released February 22, 2008
  • GF_Param now allows '[' and ']' in the variable name so that you can name variables in the style of C arrays, ie 'var[2]'.
  • If you have no network installed, you won't see an error when Gap_Filler is started. Errors in usage reporting are also not displayed, though they are logged to the event viewer.
  • One final usage report is sent when you turn off usage reporting.
• v1.249 released February 11, 2008
  • Added "Dump Vars" button to toolbox that will show you the names and values of GF_Vars. Useful for debugging.
  • The width/height parameters of all dialog box controls now act as a maximum instead of just a minimum size.
  • Text controls will now display a vertical scrollbar if the height parameter forces them to be shorter than the text they contain.
  • The Toolbox window opens when you start FileMaker and tells you how to open it again the first time you close it.
  • Minor corrections to "self documentation" of GF_Var & GF_Hash functions.
• v1.248 released February 5, 2008
  • GF_Par renamed to GF_Param to prevent confusing it with GF_Var
  • GF_Param no longer returns bogus values when given a number greater than 2147483647 or less than -2147483647
  • GF_Param accepts . and : in the parameter name or unquoted value.
  • GF_Var is now used to get and set variables. GF_VarSet has been deprecated. Variable type is now indicated by a * in front of the variable name for Globals, and a $ for Systems. While this is the kind of major change we hope to avoid in the future, we believe it has been made early enough that it will affect few users. If you've used a lot of GF_Vars and would like help converting to the new format, please contact us and we will assist you free of charge.
  • Usage statistics are now reported once a week on multiple ports. An error dialog is no longer shown on failure (an error is still logged in event viewer). You can turn usage reporting on and off using the Preferences button on the About Gap_Filler dialog. We hope you'll leave usage reports on to help direct future Gap_Filler development!
• v1.247 released February 3, 2008
  • Includes manual v1.01 with many more examples and a few clarifications.
  • GF_Par now returns unquoted numbers as a numeric data type. This matches with how FM handles unquoted numbers. Ie. Let([x=2]; x) > 10 is false, but Let([x="2"]; x) > 10 is true. Before this change, GF_Par("x"; "x=2") > 10 was true, now it is false.
  • GF_Clipboard works with Mac-XMFD, Mac-XMTB, Mac-XMLO, and presumably any other Mac-XM** formats I'm not aware of.
  • Calling GF_Var to clear local variables when no script is running will no longer return an error. No variables are cleared if no script is running.
  • GF_HotkeyVarSet's 'resumeCurrentScript' parameter now works.
  • Anything that looks like a URL in a GF_Dialog will turn into a hyperlink.
  • GF_DrawShape 'P'ie shape now takes parameters representing a bounding box instead of the center and radius of the pie. This makes it work the same way as the other shapes and allows you to draw oval pies.
  • Fixed a bug that could cause one hotkey to not be removed when executing GF_HotkeyCommand("remove").
• v1.246 released January 6, 2008
  
  • First public release. Previous versions were available only to CNI employees.