%WAITFOR Block execution and wait for event.
%   WAITFOR(H) returns when the graphics object identified by H
%   is deleted or when Ctrl-C is typed in the Command Window. If H does 
%   not exist, waitfor returns immediately without processing any events.
%
%   WAITFOR(H,'PropertyName'), in addition to the conditions in the 
%   previous syntax, returns when the value of 'PropertyName' for the 
%   graphics object H changes. If 'PropertyName' is not a valid property 
%   for the object, waitfor returns immediately without processing 
%   any events.
%
%   WAITFOR(H,'PropertyName',PropertyValue), in addition to the
%   conditions in the previous syntax, returns when the value of
%   'PropertyName' for the graphics object H changes to PropertyValue. 
%   If 'PropertyName' is set to PropertyValue, waitfor returns 
%   immediately without processing any events.
%
%   While waitfor blocks an execution stream, it processes events as 
%   would drawnow, allowing callbacks to execute.  Nested calls to 
%   waitfor are supported, and earlier calls to waitfor will not return 
%   until all later calls have returned, even if the condition upon which 
%   the earlier call is blocking has been met.
%
%   See also DRAWNOW, UIWAIT, UIRESUME.

%   Copyright 1984-2002 The MathWorks, Inc.
%   $Revision: 1.10.4.1 $  $Date: 2004/10/22 19:45:15 $
%   Built-in function.
