enable/disable figure

enable/disable an entire figure window

Description

Syntax:
  currentState = enableDisableFig(hFig, newState)
 
Description:
enableDisableFig sets the figure hFig's enable/disable state, which is otherwise supported by Matlab only for specific components but not figures. Using this function, the entire figure window, including all internal menus, toolbars and components, is enabled/disabled in a single call. Valid values for newState are true, false, 'on' & 'off' (case insensitive). hFig may be a list of figure handles.
 
Note 1: when the state is enabled, internal figure components may remain disabled if their personal 'enabled' property is 'off'.
 
Note 2: in disabled state, a figure cannot be moved, resized, closed or accessed. None of its menues, toolbars, buttons etc. are clickable.
 
enableDisableFig(newState) sets the state of the current figure (gcf).
 
state = enableDisableFig(hFig) returns the current enabled/disabled state of figure hFig, or of the current figure (gcf) if hFig is not supplied. The returned state is either 'on' or 'off'.
 
Examples:
  state = enableDisableFig;
  state = enableDisableFig(hFig);
  oldState = enableDisableFig(hFig, 'on');
  oldState = enableDisableFig(hFig, result>0);
  oldState = enableDisableFig(true); % on current figure
 
Bugs and suggestions:
Please send to Yair Altman (altmany at gmail dot com)
 
Warning:
This code heavily relies on undocumented and unsupported Matlab functionality. It works on Matlab 7+, but use at your own risk!

Acknowledgements

The author wishes to acknowledge the following in the creation of this submission:
FindJObj - find java handles of Matlab graphic objects, GetJFrame - Retrieves a figure's underlying Java frame

• MATLAB release: MATLAB 7.4 (R2007a)
• Other requirements: Java

[norm thing]

Thank you for this code! Works wonderfull on 2008a!

[Cat H]

Does exactly what it says on the tin! I'm using it to prevent the user being able to create phantom waitbars by pressing the close button.

Many thanks!

[Cem]

Yair,
     Thank you. It worked like a charm.