region_options.hlp

来自「是一个经济学管理应用软件 很难找的 但是经济学学生又必须用到」· HLP 代码 · 共 467 行 · 第 1/2 页

{smcl}
{* 07mar2005}{...}
{cmd:help region options}
{hline}
{* index size of graph}{...}
{* index axes, setting offset between and plot region}{...}
{* index plot region, suppressing border around}{...}
{* index borders, suppressing around plot region}{...}
{* index colors, setting background and fill}{...}
{* index available area}{...}
{* index plot region}{...}
{* index graph region}{...}
{* index ysize() tt option}{...}
{* index xsize() tt option}{...}
{* index graphregion() tt option}{...}
{* index plotregion() tt option}{...}

{title:Title}

{p2colset 5 27 29 2}{...}
{p2col :{hi:[G] {it:region_options}} {hline 2}}Options for shading and outlining regions and controlling graph size{p_end}
{p2colreset}{...}


{title:Syntax}

	{it:region_options}{col 41}description
	{hline 70}
	{cmdab:ysiz:e:(}{it:#}{cmd:)}{...}
{col 41}height of {it:available area} (in inches)
	{cmdab:xsiz:e:(}{it:#}{cmd:)}{...}
{col 41}width of {it:available area} (in inches)
	{cmdab:graphr:egion:(}{it:suboptions}{cmd:)}{...}
{col 41}attributes of {it:graph region}
	{cmdab:plotr:egion:(}{it:suboptions}{cmd:)}{...}
{col 41}attributes of {it:plot region}
	{hline 70}
{pin}
Options {cmd:ysize()} and {cmd:xsize()} are {it:rightmost};
options {cmd:graphregion()} and {cmd:plotregion()} are
{it:merged-implicit}; see {help repeated options}.

	{it:suboptions}{col 41}description
	{hline 70}
	{cmdab:sty:le:(}{it:{help areastyle}}{cmd:)}{...}
{col 41}overall style of outer region
	{cmdab:c:olor:(}{it:{help colorstyle}}{cmd:)}{...}
{col 41}line and fill color of outer region
	{cmdab:fc:olor:(}{it:{help colorstyle}}{cmd:)}{...}
{col 41}fill color of outer region
	{cmdab:ls:tyle:(}{it:{help linestyle}}{cmd:)}{...}
{col 41}overall style of outline
	{cmdab:lc:olor:(}{it:{help colorstyle}}{cmd:)}{...}
{col 41}color of outline
	{cmdab:lw:idth:(}{it:{help linewidthstyle}}{cmd:)}{...}
{col 41}thickness of outline
	{cmdab:lp:attern:(}{it:{help linepatternstyle}}{cmd:)}{...}
{col 41}whether outline is solid, dashed, etc.

	{cmdab:isty:le:(}{it:{help areastyle}}{cmd:)}{...}
{col 41}overall style of inner region
	{cmdab:ic:olor:(}{it:{help colorstyle}}{cmd:)}{...}
{col 41}line and fill color of inner region
	{cmdab:ifc:olor:(}{it:{help colorstyle}}{cmd:)}{...}
{col 41}fill color of inner region
	{cmdab:ils:tyle:(}{it:{help linestyle}}{cmd:)}{...}
{col 41}overall style of outline
	{cmdab:ilc:olor:(}{it:{help colorstyle}}{cmd:)}{...}
{col 41}color of outline
	{cmdab:ilw:idth:(}{it:{help linewidthstyle}}{cmd:)}{...}
{col 41}thickness of outline
	{cmdab:ilp:attern:(}{it:{help linepatternstyle}}{cmd:)}{...}
{col 41}whether outline is solid, dashed, etc.

	{cmdab:m:argin:(}{it:{help marginstyle}}{cmd:)}{...}
{col 41}margin between inner and outer regions
	{hline 70}

{pstd}
The {it:available area}, {it:graph region}, and {it:plot region} are defined

	 {it:available area:}
	{c TLC}{hline 41}{c TRC}
	{c |}{it:(outer graph region)}             {it:margin}  {c |}
	{c |} {c TLC}{hline 37}{c TRC} {c |}
	{c |} {c |}{it:(inner graph region)}                 {c |} {c |}    {it:titles appear outside}
	{c |} {c |}                                     {c |} {c |}      {it:the borders of outer}
	{c |} {c |}   {c TLC}{hline 28}{c TRC}    {c |} {c |}      {it:plot region}
	{c |} {c |}   {c |}{it:(outer plot region)}  {it:margin} {c |}    {c |} {c |}
	{c |} {c |}   {c |} {c TLC}{hline 24}{c TRC} {c |}    {c |} {c |}{...}
{col 56}{it:axes appear on the}
	{c |} {c |}   {c |} {c |}                        {c |} {c |}    {c |} {c |}      {it:borders of the outer}
	{c |}m{c |}   {c |}m{c |}                        {c |}m{c |}    {c |}m{c |}      {it:plot region}
	{c |}a{c |}   {c |}a{c |}                        {c |}a{c |}    {c |}a{c |}
	{c |}r{c |}   {c |}r{c |}    {it:(inner plot}         {c |}r{c |}    {c |}r{c |}{...}
{col 56}{it:plot appears in inner}
	{c |}g{c |}   {c |}g{c |}             {it:region)}    {c |}g{c |}    {c |}g{c |}      {it:plot region}
	{c |}i{c |}   {c |}i{c |}                        {c |}i{c |}    {c |}i{c |}
	{c |}n{c |}   {c |}n{c |}                        {c |}n{c |}    {c |}n{c |}
	{c |} {c |}   {c |} {c |}                        {c |} {c |}    {c |} {c |}
	{c |} {c |}   {c |} {c BLC}{hline 24}{c BRC} {c |}    {c |} {c |}{...}
{col 56}{it:Note: what are called}
	{c |} {c |}   {c |}            {it:margin}          {c |}    {c |} {c |}{...}
{col 58}{it:"graph region" and}
	{c |} {c |}   {c BLC}{hline 28}{c BRC}    {c |} {c |}{...}
{col 58}{it:"plot region" are}
	{c |} {c |}                                     {c |} {c |}{...}
{col 58}{it:sometimes the inner}
	{c |} {c |}                                     {c |} {c |}{...}
{col 58}{it:and sometimes the}
	{c |} {c BLC}{hline 37}{c BRC} {c |}{...}
{col 58}{it:outer regions.}
	{c |}                  {it:margin}                 {c |}{...}
{col 58}
	{c BLC}{hline 41}{c BRC}{txt}{...}
{col 58}

	{it:The available area and outer graph region}
	{it:are almost coincident; they differ only by}
	{it:the width of the border.}

	{it:The borders of the outer plot or graph}
	{it:region are sometimes called the outer}
	{it:borders of the plot or graph region.}


{title:Description}

{pstd}
The {it:region_options} set the size, margins, and color of the area in which
the graph appears.


{title:Options}

{phang}
{cmd:ysize(}{it:#}{cmd:)} and {cmd:xsize(}{it:#}{cmd:)}
    specify in inches the height and width of the {it:available area}.  The
    defaults are usually {cmd:ysize(4)} and {cmd:xsize(5)}, but this, of
    course, is controlled by the scheme; see {help schemes}.  These two
    options can be used to control the overall aspect ratio of a graph.  See
    {hi:Controlling the aspect ratio} below.

{phang}
{cmd:graphregion(}{it:suboptions}{cmd:)} and
{cmd:plotregion(}{it:suboptions}{cmd:)}
    specify attributes for the {it:graph region} and {it:plot region}.


{title:Suboptions}

{phang}
{cmd:style(}{it:areastyle}{cmd:)} and
{cmd:istyle(}{it:areastyle}{cmd:)}
    specify the overall style of the outer and inner regions.
    The other suboptions allow you to change the region's attributes
    individually, but {cmd:style()} and {cmd:istyle()} provide the
    starting points.
    See {it:{help areastyle}} for a list of choices.

{phang}
{cmd:color(}{it:colorstyle}{cmd:)} and
{cmd:icolor(}{it:colorstyle}{cmd:)}
    specify the color of the line used to outline the outer and inner regions;
    see {it:{help colorstyle}} for a list of choices.

{phang}
{cmd:fcolor(}{it:colorstyle}{cmd:)} and
{cmd:ifcolor(}{it:colorstyle}{cmd:)}
    specify the fill color for the outer and inner regions;
    see {it:{help colorstyle}} for a list of choices.

{phang}
{cmd:lstyle(}{it:linestyle}{cmd:)} and
{cmd:ilstyle(}{it:linestyle}{cmd:)}
    specify the overall style of the line used to outline the outer and inner
    regions, which includes its pattern (solid, dashed, etc.), thickness,
    and color.  The other suboptions listed below allow you to change the
    line's attributes individually, but {cmd:lstyle()} and {cmd:ilstyle()} are
    the starting points.  See {it:{help linestyle}} for a list of choices.

{phang}
{cmd:lcolor(}{it:colorstyle}{cmd:)} and
{cmd:ilcolor(}{it:colorstyle}{cmd:)}
    specify the color of the line used to outline the outer and inner regions;
    see {it:{help colorstyle}} for a list of choices.

{phang}
{cmd:lwidth(}{it:linewidthstyle}{cmd:)} and
{cmd:ilwidth(}{it:linewidthstyle}{cmd:)}
    specify the thickness of the line used to outline the outer and inner
    regions; see {it:{help linewidthstyle}} for a list of choices.

{phang}
{cmd:lpattern(}{it:linepatternstyle}{cmd:)} and
{cmd:ilpattern(}{it:linepatternstyle}{cmd:)}
    specify whether the line used to outline the outer and inner regions is
    solid, dashed, etc.; see {it:{help linepatternstyle}} for a list of
    choices.

{phang}
{cmd:margin(}{it:marginstyle}{cmd:)}
    specifies the margin between the outer and inner regions.


{title:Remarks}

{pstd}
Remarks are presented under the headings

	{help region_options##remarks1:Setting the offset between the axes and the plot region}
	{help region_options##remarks2:Controlling the aspect ratio}
	{help region_options##remarks3:Suppressing the border around the plot region}
	{help region_options##remarks4:Setting background and fill colors}
	{help region_options##remarks5:How graphs are constructed}


{marker remarks1}{...}
{title:Setting the offset between the axes and the plot region}

{* index offset between axes and data, setting}{...}
{pstd}
By default, most schemes (see {help schemes}) offset the axes from the
region in which the data are plotted.  This offset is
specified {cmd:plotregion(margin(}{it:marginstyle}{cmd:))};
see 
{it:{help marginstyle}}.

{pstd}
If you do not want the axes offset from the contents of the plot,
specify {cmd:plotregion(margin(zero))}.  Compare

	{cmd:. sysuse auto, clear}