Highlight
% highlight Highlight specified range or date range in a graph
%
% Syntax
%
% [patchHandles, textHandles] = highlight(Range, ...)
% [patchHandles, textHandles] = highlight(AxesHandles, Range, ...)
%
%
% Input Arguments
%
% * Range
[ numeric ] - X-axis range or date range that will be
% highlighted.
%
% * AxesHandles
[ numeric ] - Handle(s) to axes object(s) in which the
% highlight will be made.
%
%
% Output Arguments
%
% * PatchHandles
[ numeric ] - Handle to the highlighted area (patch object).
%
% * TextHandles
[ numeric ] - Handle to the caption (text object).
%
%
% Options
%
% * Text=''
[ cellstr | char | string ] - Annotate the highlighted area
% with a text string.
%
% * Color=0.8
[ numeric | char ] - An RGB color code, a Matlab color
% name, or a scalar shade of gray.
%
% * ExcludeFromLegend=true
[ true
| false
] - Exclude the highlighted
% area from legend.
%
% * HandleVisibility=false
[ true
| false
] - Visibility of the
% handle to the patch object(s) created.
%
%
% Description
%
%
% Example
%
% -IRIS Macroeconomic Modeling Toolbox % -Copyright (c) 2007-2022 IRIS Solutions Team