Create main.yml

.github/workflows/glt-ci.yaml

@@ -0,0 +1,97 @@
+name: GUI Layout Toolbox Continuous Integration
+
+# Controls when the workflow will run.
+on:
+
+  # Triggers the workflow on push or pull request events, but only for the master branch.
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+  # This allows the workflow run to be run manually from the Actions tab in GitHub.
+  workflow_dispatch:
+
+# A workflow run is made up of one or more jobs that can run sequentially or in parallel.
+jobs:
+
+  # Run the GUI Layout Toolbox tests.
+  run-GLT-tests:
+
+    # Define the job strategy.
+    strategy:
+
+      # Set up the job strategy matrix to define the different job configurations.
+      matrix:
+
+        # List of platforms on which to run the tests.        
+        platform: [ ubuntu-latest, windows-latest ]
+
+        # List of MATLAB releases over which to run the tests.        
+        matlab-version: [ R2020b, R2021a, R2021b, R2022a, R2022b, R2023a, R2023b, R2024a ]
+
+        # We don't define any startup options until we reach R2023b (handled separately below).
+        matlab-startup-options: [ '' ]        
+
+        # Windows/Mac are supported from R2021a onwards. Ubuntu is supported from R2020b onwards.
+        # Exclude the Windows job on R2020b.
+        exclude:
+
+          - platform: windows-latest
+            matlab-version: R2020b
+            matlab-startup-options: [ '' ]                 
+
+        # The tests should also be run in the JavaScript Desktop from R2023b onwards (this is the -webui startup option).
+        include:         
+
+          - platform: ubuntu-latest
+            matlab-version: R2023b
+            matlab-startup-options: -webui          
+
+          - platform: windows-latest
+            matlab-version: R2023b
+            matlab-startup-options: -webui          
+
+          - platform: ubuntu-latest
+            matlab-version: R2024a
+            matlab-startup-options: -webui
+
+          - platform: windows-latest
+            matlab-version: R2024a
+            matlab-startup-options: -webui          
+
+    # Specify the platform that the job will run on.
+    runs-on: ${{ matrix.platform }}
+
+    # Don't fail the entire run if one job fails.
+    continue-on-error: true
+
+    # Steps define a sequence of tasks to be executed as part of the job.
+    steps:
+
+      # Check out the repository under $GITHUB_WORKSPACE, so that the job can access it.
+      - name: Check out the repository
+        uses: actions/checkout@v4
+
+      # For Linux jobs, start a display server on the runner.
+      - name: Start a display server for jobs running on Linux.
+        if: ${{ matrix.platform == 'ubuntu-latest' }}
+        run: |
+          sudo apt-get install -y xvfb
+          Xvfb :99 &
+          echo "DISPLAY=:99" >> $GITHUB_ENV
+
+      # Set up MATLAB on the runner.
+      - name: Set up MATLAB on the runner.        
+        uses: matlab-actions/setup-matlab@v2
+        with:
+          # The tests require only base MATLAB.
+          products: MATLAB  
+          release: ${{ matrix.matlab-version }}
+
+      # Run the GUI Layout Toolbox tests.
+      - name: Run the GUI Layout Toolbox tests.
+        uses: matlab-actions/run-command@v2
+        with:
+          startup-options: ${{ matrix.matlab-startup-options }}
+          command: openProject("project.prj"); results = runToolboxTests(); failedTests = table(results([results.Failed])); disp(failedTests); results.assertSuccess();

docsrc/Examples/callbackexample.m

@@ -1,4 +1,4 @@
-function callbackexample()
+function varargout = callbackexample()
 
 %  Copyright 2009-2020 The MathWorks, Inc.
 
@@ -37,11 +37,15 @@ function callbackexample()
 % Add user interactions
 set( hList, 'Callback', @onChangeColor );
 
+% Return output.
+if nargout > 0
+    nargoutchk( 1, 1 )
+    varargout{1} = f;
+end % if
 
     function onChangeColor( source, ~ )
         idx = get( source, 'Value' );
         set( hButton, 'Background', colorValues(idx,:), 'String', colorNames{idx} )
     end % onChangeColor
 
-
 end % main

docsrc/Examples/demoBrowser.m

@@ -1,4 +1,4 @@
-function demoBrowser()
+function varargout = demoBrowser()
 %demoBrowser: an example of using layouts to build a user interface
 %
 %   demoBrowser() opens a simple GUI that allows several of MATLAB's
@@ -25,6 +25,12 @@ function demoBrowser()
 % Explicitly call the demo display so that it gets included if we deploy
 displayEndOfDemoMessage('')
 
+% Return output.
+if nargout > 0
+    nargoutchk( 1, 1 )
+    varargout{1} = gui.Window;
+end % if
+
 %-------------------------------------------------------------------------%
     function data = createData()
         % Create the shared data-structure for this application

docsrc/Examples/dockexample.m

@@ -1,4 +1,4 @@
-function dockexample()
+function varargout = dockexample()
 %DOCKEXAMPLE: An example of using the panelbox dock/undock functionality
 
 %  Copyright 2009-2020 The MathWorks, Inc.
@@ -30,6 +30,12 @@ function dockexample()
 set( panel{2}, 'DockFcn', {@nDock, 2} );
 set( panel{3}, 'DockFcn', {@nDock, 3} );
 
+% Return output.
+if nargout > 0
+    nargoutchk( 1, 1 )
+    varargout{1} = fig;
+end % if
+
 %-------------------------------------------------------------------------%
     function nDock( eventSource, eventData, whichpanel ) %#ok<INUSL>
         % Set the flag

docsrc/Examples/minimizeexample.m

@@ -1,4 +1,4 @@
-function minimizeexample()
+function varargout = minimizeexample()
 %MINIMIZEEXAMPLE: An example of using the panelbox minimize/maximize
 
 %  Copyright 2009-2020 The MathWorks, Inc.
@@ -33,6 +33,12 @@ function minimizeexample()
 set( panel{2}, 'MinimizeFcn', {@nMinimize, 2} );
 set( panel{3}, 'MinimizeFcn', {@nMinimize, 3} );
 
+% Return output.
+if nargout > 0
+    nargoutchk( 1, 1 )
+    varargout{1} = fig;
+end % if
+
 %-------------------------------------------------------------------------%
     function nMinimize( eventSource, eventData, whichpanel ) %#ok<INUSL>
         % A panel has been maximized/minimized
@@ -45,7 +51,7 @@ function nMinimize( eventSource, eventData, whichpanel ) %#ok<INUSL>
             s(whichpanel) = pheightmax;
         end
         set( box, 'Heights', s );
-        
+
         % Resize the figure, keeping the top stationary
         delta_height = pos(1,4) - sum( box.Heights );
         set( fig, 'Position', pos(1,:) + [0 delta_height 0 -delta_height] );

resources/project/Root.type.Files/.github.type.File.xml

@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<Info/>

resources/project/Root.type.Files/.github.type.File/1.type.DIR_SIGNIFIER.xml

@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<Info/>

resources/project/Root.type.Files/.github.type.File/workflows.type.File.xml

@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<Info/>

resources/project/Root.type.Files/.github.type.File/workflows.type.File/1.type.DIR_SIGNIFIER.xml

@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<Info/>

resources/project/Root.type.Files/.github.type.File/workflows.type.File/glt-ci.yaml.type.File.xml

@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<Info/>

resources/project/Root.type.Files/releases.type.File/GUI Layout Toolbox 2.3.6.mltbx.type.File.xml

@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<Info/>

resources/project/Root.type.Files/tbx.type.File/layoutdoc.type.File/custom_toolbox.json.type.File.xml

@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<Info/>

tbx/layout/+uix/TabPanel.m

@@ -20,7 +20,7 @@
         FontName % font name
         FontSize % font size
         FontWeight % font weight
-        FontUnits % font weight
+        FontUnits % font units
         ForegroundColor % tab text color [RGB]
         HighlightColor % border highlight color [RGB]
         ShadowColor % border shadow color [RGB]
@@ -120,6 +120,10 @@
         end % get.FontAngle
 
         function set.FontAngle( obj, value )
+
+            if ~verLessThan( 'matlab', '9.3' )
+                value = convertStringsToChars( value );
+            end % if
 
             % Check
             assert( ischar( value ) && any( strcmp( value, {'normal','italic','oblique'} ) ), ...
@@ -150,6 +154,10 @@
         end % get.FontName
 
         function set.FontName( obj, value )
+
+            if ~verLessThan( 'matlab', '9.3' )
+                value = convertStringsToChars( value );
+            end % if
 
             % Check
             assert( ischar( value ) && any( strcmp( value, obj.FontNames ) ), ...
@@ -212,6 +220,10 @@
         end % get.FontWeight
 
         function set.FontWeight( obj, value )
+
+            if ~verLessThan( 'matlab', '9.3' )
+                value = convertStringsToChars( value );
+            end % if
 
             % Check
             assert( ischar( value ) && any( strcmp( value, {'normal','bold'} ) ), ...
@@ -242,6 +254,10 @@
         end % get.FontUnits
 
         function set.FontUnits( obj, value )
+
+            if ~verLessThan( 'matlab', '9.3' )
+                value = convertStringsToChars( value );
+            end % if
 
             % Check
             assert( ischar( value ) && ...
@@ -400,6 +416,10 @@
         end % get.TabEnables
 
         function set.TabEnables( obj, value )
+
+            if ~verLessThan( 'matlab', '9.3' )
+                value = cellstr( convertStringsToChars( value ) );
+            end % if
 
             % For those who can't tell a column from a row...
             if isrow( value )
@@ -415,7 +435,7 @@
                 isequal( size( value ), size( tabs ) ) && ...
                 all( strcmp( value, 'on' ) | strcmp( value, 'off' ) ), ...
                 'uix:InvalidPropertyValue', ...
-                'Property ''TabEnables'' should be a cell array of strings ''on'' or ''off'', one per tab.' )
+                'Property ''TabEnables'' should be a cell array of character vectors ''on'' or ''off'', or an array of strings, one per tab.' ) %#ok<ISCLSTR>
 
             % Set
             tf = strcmp( value, 'on' );
@@ -440,6 +460,10 @@
         end % get.TabLocation
 
         function set.TabLocation( obj, value )
+
+            if ~verLessThan( 'matlab', '9.3' )
+                value = convertStringsToChars( value );
+            end % if
 
             % Check
             assert( ischar( value ) && ...
@@ -462,6 +486,10 @@
         end % get.TabTitles
 
         function set.TabTitles( obj, value )
+
+            if ~verLessThan( 'matlab', '9.3' )
+                value = cellstr( convertStringsToChars( value ) );
+            end % if
 
             % For those who can't tell a column from a row...
             if isrow( value )
@@ -475,7 +503,7 @@
             assert( iscellstr( value ) && ...
                 isequal( size( value ), size( tabs ) ), ...
                 'uix:InvalidPropertyValue', ...
-                'Property ''TabTitles'' should be a cell array of strings, one per tab.' )
+                'Property ''TabTitles'' should be a cell array of character vectors or an array of strings, one per tab.' ) %#ok<ISCLSTR>
 
             % Set
             n = numel( tabs );
@@ -863,9 +891,14 @@ function onParentChanged( obj, ~, ~ )
             end
 
             if ~isempty( prop )
-                obj.ParentBackgroundColorListener = event.proplistener( obj.Parent, ...
-                    findprop( obj.Parent, prop ), 'PostSet', ...
-                    @( src, evt ) obj.updateParentBackgroundColor( prop ) );
+                foundProp = findprop( obj.Parent, prop );
+                if foundProp.SetObservable
+                    obj.ParentBackgroundColorListener = event.proplistener( obj.Parent, ...
+                        foundProp, 'PostSet', ...
+                        @( src, evt ) obj.updateParentBackgroundColor( prop ) );
+                else
+                    obj.ParentBackgroundColorListener = [];
+                end % if
             else
                 obj.ParentBackgroundColorListener = [];
             end