Why am I unable to make an hggroup object the parent of a light object in MATLAB 7.0 (R14)?

I created an hggroup object and a light object. When I try to make the hggroup object the parent to the light object as in the following code:

h = surf(peaks);

hg = hggroup;

hl = light('Position',[1 0 0],'Style','infinite','Parent',hg);

I receive the following error :

 ??? Error using ==> light

 Bad value for light property: 'Parent'.

However, the documentation for the "Parent" property of a light object listed at

web([docroot,'/techdoc/ref/light_props.html'])

states that the parent of a light object is the axes, hggroup, or hgtransform object that contains it.

Answer 1

[MathWorks Support Team]

This change has been incorporated into the documentation in Release 14 Service Pack 3 (R14SP3). For previous releases, read below for any additional information:

This is a documentation error in MATLAB 7.0 (R14) within the "Light Properties" section under the "MATLAB Function Reference."

Light objects can not be parented by a hggroup or a hgtransform object.