Added unlockUIFig(), for bringing back access via external browsers!

See example in the updated README.md.

Author: Dev-iL

README.md

@@ -32,6 +32,7 @@ published Wednesday, September 7th, 2016.
 [`setStyle`](#setStyle) - Modify a specified style property.  
 [`setTimeout`](#setTimeout) - Override the default timeout for dojo commands, for a specific `uifigure`.  
 [`textAlign`](#textAlign) - Modify text alignment.  
+[`unlockUIFig`](#unlockUIFig) - Modify this UIFigure to allow viewing it in an external browser, on release R2017b and newer.  
 [`waitForFigureReady`](#waitForFigureReady) - A blocking method that only returns after the uifigure is fully loaded.
 
 -----------------
@@ -335,6 +336,35 @@ myGUI = DOMdemoGUI;
 mlapptools.textAlign(myGUI.TextArea, 'right');
 ```
 
+-----------------
+<a name="unlockUIFig"></a>
+
+#### *mlapptools*.**unlockUIFig**(*hUIFig*)
+
+##### Description
+
+This method modifies the properties of the UIFigure controller such that opening the UIFigure in a browser (using the webwindow URL) becomes possible. This method has no effect on MATLAB releases before R2017b (where no such restriction exists in the first place).
+
+##### Examples
+
+Using the demo GUI generated by `./Demo/DOMdemoGUI.m`
+
+```MATLAB
+% Create a uifigure:
+myGUI = DOMdemoGUI;
+
+% Attempt to open it using an external browser:
+hWW = mlapptools.getWebWindow(myGUI.UIFigure);
+web(hWW.URL,'-browser'); pause(3);
+
+% "Unlock" the uifigure:
+mlapptools.unlockUIFig(myGUI.UIFigure);
+
+% Attempt to open again:
+web(hWW.URL,'-browser');
+```
+The 1<sup>st</sup> browser window should be empty, whereas the 2<sup>nd</sup> should correctly show the contents of the UIFigure.
+
 -----------------
 <a name="waitForFigureReady"></a>
 

mlapptools.m

@@ -16,6 +16,7 @@
     % setStyle       - Modify a specified style property.
     % setTimeout     - Override the default timeout for dojo commands, for a specific uifigure.
     % textAlign      - Modify text alignment.
+    % unlockUIFig    - Allow the uifigure to be opened using an external browser.
     % waitForFigureReady - A blocking method that only returns after the uifigure is fully loaded.
     %
     % See README.md for detailed documentation and examples.
@@ -106,6 +107,8 @@ function fontWeight(uiElement, weight)
         % A method for dumping the HTML code of a uifigure.
         % Intended for R2017b (and onward?) where the CEF url cannot be simply opened in 
         % an external browser.        
+        % Mostly irrelevant for UIFigures as of the introduction of mlapptools.unlockUIFig(...),
+        % but can be useful for other non-uifigure webwindows.
             %% Obtain webwindow handle:
             if isa(hFigOrWin,'matlab.ui.Figure')
                 win = mlapptools.getWebWindow(hFigOrWin);
@@ -341,6 +344,16 @@ function textAlign(uiElement, alignment)
 
             mlapptools.setStyle(win, 'textAlign', alignment, ID_struct);
         end % textAlign
+
+        function unlockUIFig(hUIFig)
+        % This method allows the uifigure to be opened in an external browser,
+        % as was possible before R2017b.
+            if verLessThan('matlab','9.3')
+                % Do nothing, since this is not required pre-R2017b.
+            else              
+                struct(hUIFig).Controller.ProxyView.PeerNode.setProperty('hostType','""');
+            end
+        end % unlockUIFig
 
         function win = waitForFigureReady(hUIFig)
         % This blocking method waits until a UIFigure and its widgets have fully loaded.