{smcl}
{* *! version 1.1.0  14feb2009}{...}
{cmd:help areastyle}
{hline}

{title:Title}

{p2colset 5 22 24 2}{...}
{p2col :{manlinki G areastyle} {hline 2}}Choices for look of regions{p_end}
{p2colreset}{...}


{title:Syntax}

{p2colset 9 30 32 2}{...}
{p2col : {it:areastyle}}
	description{p_end}
{p2line}
{p2col : {cmd:background}}
	determined by scheme{p_end}
{p2col : {cmd:foreground}}
	determined by scheme{p_end}
{p2col : {cmd:outline}}
	{cmd:foreground} outline with no fill{p_end}
{p2col : {cmd:plotregion}}
	default for plot regions{p_end}
{p2col : {cmd:histogram}}
	default used for bars of histograms{p_end}
{p2col : {cmd:ci}}
	default used for confidence interval{p_end}
{p2col : {cmd:ci2}}
	default used for second confidence interval{p_end}
{p2col : {cmd:none}}
	no outline and no background color{p_end}

{p2col : {cmd:p1bar} - {cmd:p15bar}}
	used by first - fifteenth "bar" plot{p_end}
{p2col : {cmd:p1box} - {cmd:p15box}}
	used by first - fifteenth "box" plot{p_end}
{p2col : {cmd:p1pie} - {cmd:p15pie}}
	used by first - fifteenth "pie" plot{p_end}
{p2col : {cmd:p1area} - {cmd:p15area}}
	used by first - fifteenth "area" plot{p_end}
{p2col : {cmd:p1} - {cmd:p15}}
	used by first - fifteenth "other" plot{p_end}
{p2line}
{p2colreset}{...}

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

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

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


{title:Description}

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


{title:Remarks}

{pstd}
Remarks are presented under the following headings:

	{help areastyle##remarks1:Overview of areastyles}
	{help areastyle##remarks2:Numbered styles}
	{help areastyle##remarks3:Using numbered styles}
	{help areastyle##remarks4:When to use areastyles}


{marker remarks1}{...}
{title:Overview of areastyles}

{pstd}
{it:areastyle} is used to determine the look of

{phang}
1.  the entire region in which the graph appears{break}
    (see option {cmd:style(}{it:areastyle}{cmd:)} in 
    {manhelpi region_options G})

{phang}
2.  bars{break}
    (see option {cmd:bstyle(}{it:areastyle}{cmd:)} in
    {manhelp graph_bar G:graph bar} or
    {manhelp twoway bar G:graph twoway bar})

{phang}
3.  an area filled under a curve{break}
    (see option {cmd:bstyle()} in {helpb twoway area} or
    {manhelp twoway_rarea G:graph twoway rarea})

{phang}
4.  most other enclosed areas, such as the boxes in 
    {help graph box:box plots}

{pstd}
For an example of the use of the {it:areastyle} {cmd:none}, see
{hi:Suppressing the border around the plot region} in
{manhelpi region_options G}.


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

{phang}
     {cmd:p1bar} - {cmd:p15bar} are the default styles used for bar charts, 
        including {helpb 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.

{phang}
     {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.

{phang}
     {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.

{phang}
     {cmd:p1area} - {cmd:p15area} are the default styles used for area charts,
        including {helpb twoway area:twoway area} charts and 
        {helpb twoway rarea:twoway rarea} charts.  {cmd:p1area} is used for
        filling and outlining the first filled area, {cmd:p2area} for the
        second, and so on.

{phang}
     {cmd:p1} - {cmd:p15} are the default area styles used for other plottypes,
        including
	{helpb twoway dropline} charts,
        {helpb twoway spike} charts,
        {helpb twoway rspike} charts,
        {helpb twoway rcap} charts,
        {helpb twoway rcapsym} charts, and
        {helpb twoway rline} charts.    
        {cmd:p1} is used for filling and outlining the first plot,
        {cmd:p2} for the second, and so on.  For all the plots
	listed above, only lines are drawn, so the shade settings have no
	effect.


{marker remarks3}{...}
{title:Using numbered styles}

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

{pstd}
        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))}.


{marker remarks4}{...}
{title:When to use areastyles}

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


{title:Also see}

{psee}
Manual:  {manlinki G areastyle}

{psee}
{space 2}Help:  {manhelpi region_options G};
{manhelp graph_bar G:graph bar},
{manhelp graph_pie G:graph pie},
{manhelp twoway_area G:graph twoway area},
{manhelp twoway_bar G:graph twoway bar},
{manhelp twoway_rarea G:graph twoway rarea}
{p_end}
