markerlabelstyle.hlp

是一个经济学管理应用软件 很难找的 但是经济学学生又必须用到

{smcl}
{* 07mar2005}{...}
{cmd:help markerlabelstyle}
{hline}
{* index markerlabelstyle it}{...}

{title:Title}

{p2colset 5 29 31 2}{...}
{p2col :{hi:[G] {it:markerlabelstyle}} {hline 2}}Choices for overall look of marker labels{p_end}
{p2colreset}{...}


{title:Syntax}

	{it:markerlabelstyle}{col 30}description
	{hline 57}
	{cmd:p1} - {cmd:p15}{...}
{col 30}used by first - fifteenth plot
	{cmd:p1box} - {cmd:p15box}{...}
{col 30}used by first - fifteenth "box" plot
	{hline 57}

{pin}
Other {it:markerlabelstyles} may be available; type

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

{pin}
to obtain the complete list of {it:markerlabelstyles} installed on your
computer.


{title:Description}

{pstd}
{it:markerlabelstyle} defines the position, gap, angle, size, and color of
the marker label.  See help {it:{help marker_label_options}} for more
information.

{pstd}
{it:markerlabelstyle} is specified in the {cmd:mlabstyle()} option,

{phang2}
	{cmd:. graph} ...{cmd:, mlabstyle(}{it:markerlabelstyle}{cmd:)} ...

{pstd}
In some cases (e.g., with {cmd:twoway} {cmd:scatter}), a
{it:markerlabelstylelist} is allowed:  A {it:markerlabelstylelist} is a
sequence of {it:markerlabelstyles} separated by spaces.  Shorthands are
allowed to make specifying the list easier; see help {it:{help stylelists}}.


{title:Remarks}

{pstd}
Remarks are presented under the headings

	{help markerlabelstyle##remarks1:What is a markerlabel?}
	{help markerlabelstyle##remarks2:What is a markerlabelstyle?}
	{help markerlabelstyle##remarks3:You do not need to specify a markerlabelstyle}
	{help markerlabelstyle##remarks4:Specifying a markerlabelstyle can be convenient}
	{help markerlabelstyle##remarks5:What are numbered styles?}


{marker remarks1}{...}
{title:What is a markerlabel?}

{pstd}
A marker label is identifying text that appears next to (or in place of)
a marker.  Markers are the ink used to mark where points are on a plot.


{marker remarks2}{...}
{title:What is a markerlabelstyle?}

{pstd}
The look of marker labels is defined by four attributes:

{phang2}
     1.  the marker label's position{hline 2}where the marker is located
	 relative to the point;
	 see help {it:{help clockposstyle}}

{phang2}
    2.  the gap between the marker label and the point;
	see help {it:{help clockposstyle}}

{phang2}
    3.  the angle at which the identifying text is presented;
	see help {it:{help anglestyle}}

{phang2}
    4.  the overall style of the text;
	see help {it:{help textstyle}}

{p 12 16 2}
	a.  the size of the text;
	    see help {it:{help textsizestyle}}

{p 12 16 2}
	b.  the color of the text;
	    see help {it:{help colorstyle}}

{pstd}
The {it:markerlabelstyle} specifies all four of these attributes.


{marker remarks3}{...}
{title:You do not need to specify a markerlabelstyle}

{pstd}
The {it:markerlabelstyle} is specified by the option

	{cmd:mstyle(}{it:markerlabelstyle}{cmd:)}

{pstd}
Correspondingly, you will find other options available:

	{cmd:mlabposition(}{it:clockposstyle}{cmd:)}
	{cmd:mlabgap(}{it:relativesize}{cmd:)}
	{cmd:mlabangle(}{it:anglestyle}{cmd:)}
	{cmd:mlabtextstyle(}{it:textstyle}{cmd:)}
	{cmd:mlabsize(}{it:textstyle}{cmd:)}
	{cmd:mlabcolor(}{it:colorstyle}{cmd:)}

{pstd}
You specify the {it:markerlabelstyle} when a style exists that is exactly what
you want or when another style would allow you to specify fewer changes to
obtain what you want.


{marker remarks4}{...}
{title:Specifying a markerlabelstyle can be convenient}

{pstd}
Consider the command

	{cmd:. scatter y1 y2 x, mlabel(country country)}

{pstd}
Assume that you want the marker labels for y2 versus x to appear the same as for
y1 versus x.
(An example of this can be found under
{hi:Eliminating overprinting and overruns} and under {hi:Advanced use} in
{it:{help marker_label_options}}.)
You might set all the attributes for the
marker labels for y1 versus x and then set all the attributes for y2 versus x to be
the same.  It would be easier, however, to type

{phang2}
	{cmd:. scatter y1 y2 x, mlabel(country country) mlabstyle(p1 p1)}

{pstd}
When you do not specify {cmd:mlabstyle()}, results are the same as if you specified

{phang2}
	{cmd:mlabstyle(p1 p2 p3 p4 p5 p6 p7 p8 p9 p10 p11 p12 p13 p14 p15)}

{pstd}
where the extra elements are ignored.  In any case, {cmd:p1} is one set
of marker-label attributes, {cmd:p2} is another set, and so on.

{pstd}
Say that you wanted y2 versus x to look like y1 versus x, except that you
wanted the line to be green; you could type

	{cmd:. scatter y1 y2 x, mlabel(country country) mlabstyle(p1 p1)}
	{cmd:                   mlabcolor(. green)}

{pstd}
There is nothing special about {it:markerlabelstyles} {cmd:p1}, {cmd:p2}, ...;
they merely specify sets of marker-label attributes, just like any other
named {it:markerlabelstyle}.  Type

	{cmd:. graph query markerlabelstyle}

{pstd}
to find out what other marker-label styles are available.

{pstd}
Also see {hi:Styles and composite styles} in {helpb scatter} for
more information.


{* index numbered styles}{...}
{marker remarks5}{...}
{title:What are numbered styles?}

{phang}
     {cmd:p1} - {cmd:p15} are the default styles for marker labels
	in {helpb twoway} graphs that support marker labels, for example,
        {helpb twoway scatter},
        {helpb twoway dropline}, and
        {helpb twoway connected}.  {cmd:p1} is used for the
        first plot, {cmd:p2} for the second, and so on.

{phang}
     {cmd:p1box} - {cmd:p15box} are the default styles used for markers
        showing the outside values on {help graph_box:box charts}.
        {cmd:p1box} is used for the outside values on the first set of boxes,
        {cmd:p2box} for the second set, and so on.

{pstd}
        The look defined by a numbered style such as {cmd:p1},
	{cmd:p3box}, etc.{hline 2}by "look" we include such things as text
	color, text size, position around marker, etc.{hline 2}is determined
	by the {help schemes:scheme} selected.

{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 second set of labels on a graph look like the first.
        See {bf:Specifying a markerlabelstyle can be convenient} above for an
        example.


{title:Also see}

{psee}
Manual:  {bf:[G] {it:markerlabelstyle}}

{psee}
Online:  
{it:{help marker_label_options}}
{p_end}