{smcl}
{* 11nov2004}{...}
{hline}
help for {hi:{it:areastyle}}{right:manual:  {hi:[G] {it:areastyle}}}
{hline}

{* index areastyle it}{...}
{title:Choices for look of regions}

{p 4 4 2}
{it:areastyle} may be any of the following styles:

	{it:areastyle}{col 28}description
	{hline 62}
	{cmd:background}{...}
{col 28}determined by scheme
	{cmd:foreground}{...}
{col 28}determined by scheme
	{cmd:outline}{...}
{col 28}{cmd:foreground} outline with no fill
	{cmd:plotregion}{...}
{col 28}default for plot regions
	{cmd:histogram}{...}
{col 28}default used for bars of histograms
	{cmd:ci}{...}
{col 28}default used for confidence interval
	{cmd:ci2}{...}
{col 28}default used for second confidence interval
	{cmd:none}{...}
{col 28}no outline and no background color

	{cmd:p1bar} - {cmd:p15bar}{...}
{col 28}used by first - fifteenth "bar" plot
	{cmd:p1box} - {cmd:p15box}{...}
{col 28}used by first - fifteenth "box" plot
	{cmd:p1pie} - {cmd:p15pie}{...}
{col 28}used by first - fifteenth "pie" plot
	{cmd:p1area} - {cmd:p15area}{...}
{col 28}used by first - fifteenth "area" plot
	{cmd:p1} - {cmd:p15}{...}
{col 28}used by first - fifteenth "other" plot
	{hline 62}

{p 8 8 2}
Other {it:areastyles} may be available; type

	    {cmd:.} {bf:{stata graph query areastyle}}

{p 8 8 2}
to obtain a list of all the {it:areastyles} installed on your computer.


{title:Description}

{p 4 4 2}
The shape of the area is determined by context.  The {it:areastyle}
determines whether the area is outlined and filled and, if so, how and
in what color.


{title:Remarks}

{p 4 4 2}
Remarks are presented under the headings

	{hi:Overview of areastyles}
	{hi:Numbered styles}
	{hi:Using numbered styles}
	{hi:When to use areastyles}


{title:Overview of areastyles}

{p 4 4 2}
{it:areastyle} is used to determine the look of

{p 4 8 2}
1.  The entire region in which the graph appears{break}
    (see option {cmd:style(}{it:areastyle}{cmd:)} in help
    {it:{help region_options}}).

{p 4 8 2}
2.  Bars{break}
    (see option {cmd:bstyle(}{it:areastyle}{cmd:)} in help {help graph_bar} or
    help {help twoway_bar}).

{p 4 8 2}
3.  An area filled under a curve{break}
    (see option {cmd:bstyle()} in help {help twoway_area} or
    {help twoway_rarea}).

{p 4 8 2}
4.  Most other enclosed areas, such as the boxes in 
    {help graph_box:box plots}.

{p 4 4 2}
For an example using {it:areastyle} {cmd:none}, see
{hi:Suppressing the border around the plot region} in
help {it:{help region_options}}.


{* index numbered styles}{...}
{title:Numbered styles}

{p 4 8 2}
     {cmd:p1bar} - {cmd:p15bar} are the default styles used for bar charts, 
        including {help twoway_bar:twoway bar} charts and 
        {help graph_bar:bar charts}.  {cmd:p1bar} is used for filling and
        outlining the first set of bars, {cmd:p2bar} for the second, and so
        on.

{p 4 8 2}
     {cmd:p1box} - {cmd:p15box} are the default styles used for 
        {help graph_box:box charts}.  {cmd:p1box} is used for filling and
        outlining the first set of boxes, {cmd:p2box} for the second, and so
        on.

{p 4 8 2}
     {cmd:p1pie} - {cmd:p15pie} are the default styles used for 
        {help graph_pie:pie charts}.  {cmd:p1pie} is used for filling the
        first pie slice, {cmd:p2pie} for the second, and so on.

{p 4 8 2}
     {cmd:p1area} - {cmd:p15area} are the default styles used for area charts,
        including {help twoway_area:twoway area} charts and 
        {help twoway_rarea:twoway rarea}.  {cmd:p1area} is used for filling
        and outlining the first filled area, {cmd:p2area} for the second, and
        so on.

{p 4 8 2}
     {cmd:p1} - {cmd:p15} are the default area styles used for other plot types,
        including
	{help twoway_dropline:twoway dropline} charts,
        {help twoway_spike:twoway spike} charts,
        {help twoway_rspike:twoway rspike} charts,
        {help twoway_rcap:twoway rcap} charts,
        {help twoway_rcapsym:twoway rcapsym} charts, and
        {help twoway_rline:twoway rline} charts.    
        {cmd:p1} is used for filling and outlining the first plot,
        {cmd:p2} for the second, and so on.  Note that for all of the plots
	listed above, only lines are drawn, so the shade settings have no
	effect.


{title:Using numbered styles}

{p 4 4 2}
        The look defined by a numbered style, such as {cmd:p1bar},
        {cmd:p2area}, etc., is determined by the {help schemes:scheme} selected. 
        By "look" we mean such things as color, width of lines, patterns used, 
        etc.

{p 4 4 2}
        Numbered styles provide default "looks" that can be
        controlled by a scheme.  They can also be useful when you wish to
        make, say, the third element on a graph look like the first.  You can,
        for example, specify that the third bar on a bar graph be drawn with
        the style of the first bar by specifying the option 
        {cmd:barstyle(3, bstyle(p1bar))}.


{title:When to use areastyles}

{p 4 4 2}
You can often achieve an identical result by specifying an {cmd:areastyle}
or using more specific options, such as {cmd:bfcolor()} or {cmd:blwidth()},
that change the components of an areastyle -- the fill color and outline
attributes.  You can even specify an {cmd:areastyle} as the base and then
modify the attributes using more specific options.  It is often easiest to
specify options that affect only the fill color or a single outline
characteristic rather than to specify an areastyle.  If, however, you are trying
to make many elements on a graph look the same, specifying the overall
{cmd:areastyle} may be preferred.


{title:Also see}

    Manual:  {hi:[G] {it:areastyle}}

{p 4 13 2}
Online:  help for
{it:{help region_options}};
{help graph_bar},
{help graph_pie},
{help twoway_area},
{help twoway_bar},
{help twoway_rarea}
{p_end}
