4.16 对象属性（Object properties）

Object Properties

Graphical objects can have various properties depending on the object type. All objects used in technical analysis are bound to the time and price coordinates: trendline, channels, Fibonacci tools, etc. But there is a number of auxiliary objects intended to improve the user interface that are bound to the always visible part of a chart (main chart windows or indicator subwindows):

Object	ID	X/Y	Width/Height	Date/Price	OBJPROP_CORNER	OBJPROP_ANCHOR	OBJPROP_ANGLE
Text	OBJ_TEXT	—	—	Yes	—	Yes	Yes
Label	OBJ_LABEL	Yes	Yes (read only)	—	Yes	Yes	Yes
Button	OBJ_BUTTON	Yes	Yes	—	Yes	—	—
Bitmap	OBJ_BITMAP	—	Yes (read only)	Yes	—	Yes	—
Bitmap Label	OBJ_BITMAP_LABEL	Yes	Yes (read only)	—	Yes	Yes	—
Edit	OBJ_EDIT	Yes	Yes	—	Yes	—	—
Rectangle Label	OBJ_RECTANGLE_LABEL	Yes	Yes	—	Yes	—	—

The following designations are used in the table:

• X/Y – coordinates of anchor points specified in pixels relative to a chart corner;
• Width/Height – objects have width and height. For “read only”, the width and height values are calculated only once the object is rendered on chart;
• Date/Price – anchor point coordinates are specified using the date and price values;
• OBJPROP_CORNER – defines the chart corner relative to which the anchor point coordinates are specified. Can be one of the 4 values of the ENUM_BASE_CORNER enumeration;
• OBJPROP_ANCHOR – defines the anchor point in object itself and can be one of the 9 values of the ENUM_ANCHOR_POINT enumeration. Coordinates in pixels are specified from this very point to selected chart corner;
• OBJPROP_ANGLE – defines the object rotation angle counterclockwise.

对象值函数同ObjectGet() 和 ObjectSet() 功能一起使用。它可能是以下的任意值:

常数	值	类型	描述
OBJPROP_TIME1	0	datetime	日期时间值设置为第一协调时间部分。
OBJPROP_PRICE1	1	double	双重值设置为第一协调价格部分。
OBJPROP_TIME2	2	datetime	日期时间值设置为第二协调时间部分。
OBJPROP_PRICE2	3	double	双重值设置为第二协调价格部分。
OBJPROP_TIME3	4	datetime	日期时间值设置为第三协调时间部分。
OBJPROP_PRICE3	5	double	双重值设置为第三协调价格部分。
OBJPROP_COLOR	6	color	颜色值设置对象颜色。
OBJPROP_STYLE	7	int	STYLE_SOLID, STYLE_DASH, STYLE_DOT, STYLE_DASHDOT, STYLE_DASHDOTDOT 常数中的一个设置为对象线风格。
OBJPROP_WIDTH	8	int	设置对象线宽度的整数值。可以从1到5。
OBJPROP_BACK	9	bool	设定对象背景的布尔值。
OBJPROP_RAY	10	bool	设定对象射线的布尔值。
OBJPROP_ELLIPSE	11	bool	设置椭圆状的弧形布尔值。
OBJPROP_SCALE	12	double	设置对象属性的双重值。
OBJPROP_ANGLE	13	double	在级别上设置对象属性的双重值。
OBJPROP_ARROWCODE	14	int	设置对象属性箭头代码的整数值和箭头计数 。
OBJPROP_TIMEFRAMES	15	int	设置对象属性的时间范围一个值或者可见性对象常数 的组合值。
OBJPROP_DEVIATION	16	double	为标准离差对象设定双重值的离差属性。
OBJPROP_FONTSIZE	100	int	对于对象文本字体大小设定整数值。
OBJPROP_CORNER	101	int	对标记对象设定整数值的固定装置角。必须是从0-3。
OBJPROP_XDISTANCE	102	int	在像点设定整数值固定装置X间隔对象。
OBJPROP_YDISTANCE	103	int	在像点设定整数值固定装置Y间隔对象。
OBJPROP_FIBOLEVELS	200	int	设置斐波纳契对象水平数为整数值。可以从0 到32 。
OBJPROP_LEVELCOLOR	201	color	设置对象水平颜色线的颜色值。
OBJPROP_LEVELSTYLE	202	int	STYLE_SOLID, STYLE_DASH, STYLE_DOT, STYLE_DASHDOT, STYLE_DASHDOTDOT 常数中的一个设置为对象线风格。
OBJPROP_LEVELWIDTH	203	int	设置对象线宽度的整数值。可以从1到5。
OBJPROP_FIRSTLEVEL+n	210+n	int	斐波纳契水平函数是设置n的水平函数。可

Methods of Object Binding

ENUM_ANCHOR_POINT

ID	Description
ANCHOR_LEFT_UPPER	Anchor point at the upper left corner
ANCHOR_LEFT	Anchor point to the left in the center
ANCHOR_LEFT_LOWER	Anchor point at the lower left corner
ANCHOR_LOWER	Anchor point below in the center
ANCHOR_RIGHT_LOWER	Anchor point at the lower right corner
ANCHOR_RIGHT	Anchor point to the right in the center
ANCHOR_RIGHT_UPPER	Anchor point at the upper right corner
ANCHOR_UPPER	Anchor point above in the center
ANCHOR_CENTER	Anchor point strictly in the center of the object

Methods of Object Binding

ENUM_ARROW_ANCHOR

ID	Description
ANCHOR_TOP	Anchor on the top side
ANCHOR_BOTTOM	Anchor on the bottom side

Object Properties

For functions ObjectSetInteger() and ObjectGetInteger()

ENUM_OBJECT_PROPERTY_INTEGER

Identifier	Description	Property Type
OBJPROP_COLOR	Color	color
OBJPROP_STYLE	Style	ENUM_LINE_STYLE
OBJPROP_WIDTH	Line thickness	int
OBJPROP_BACK	Object in the background	bool
OBJPROP_ZORDER	Priority of a graphical object for receiving events of clicking on a chart (CHARTEVENT_CLICK). The default zero value is set when creating an object; the priority can be increased if necessary. When objects are placed one atop another, only one of them with the highest priority will receive the CHARTEVENT_CLICK event.	long
OBJPROP_HIDDEN	Prohibit showing of the name of a graphical object in the list of objects from the terminal menu “Charts” – “Objects” – “List of objects”. The true value allows to hide an object from the list. By default, true is set to the objects that display calendar events, trading history and to the objects created from MQL4 programs. To see such graphical objects and access their properties, click on the “All” button in the “List of objects” window.	bool
OBJPROP_SELECTED	Object is selected	bool
OBJPROP_READONLY	Ability to edit text in the Edit object	bool
OBJPROP_TYPE	Object type	ENUM_OBJECT   r/o
OBJPROP_TIME	Time coordinate	datetime   modifier=number of anchor point
OBJPROP_SELECTABLE	Object availability	bool
OBJPROP_CREATETIME	Time of object creation	datetime    r/o
OBJPROP_LEVELS	Number of levels	int
OBJPROP_LEVELCOLOR	Color of the line-level	color   modifier=level number
OBJPROP_LEVELSTYLE	Style of the line-level	ENUM_LINE_STYLE modifier=level number
OBJPROP_LEVELWIDTH	Thickness of the line-level	int      modifier=level number
OBJPROP_ALIGN	Horizontal text alignment in the “Edit” object (OBJ_EDIT)	ENUM_ALIGN_MODE
OBJPROP_FONTSIZE	Font size	int
OBJPROP_RAY_RIGHT	Ray goes to the right	bool
OBJPROP_ELLIPSE	Showing the full ellipse of the Fibonacci Arc object (OBJ_FIBOARC)	bool
OBJPROP_ARROWCODE	Arrow code for the Arrow object	uchar
OBJPROP_TIMEFRAMES	Visibility of an object at timeframes	set of flags flags
OBJPROP_ANCHOR	Location of the anchor point of a graphical object	ENUM_ARROW_ANCHOR (for OBJ_ARROW),ENUM_ANCHOR_POINT (for OBJ_LABEL, OBJ_BITMAP_LABEL and OBJ_TEXT)
OBJPROP_XDISTANCE	The distance in pixels along the X axis from the binding corner (see note)	int
OBJPROP_YDISTANCE	The distance in pixels along the Y axis from the binding corner (see note)	int
OBJPROP_DRAWLINES	Displaying lines for marking the Elliott Wave	bool
OBJPROP_STATE	Button state (pressed / depressed)	bool
OBJPROP_XSIZE	The object’s width along the X axis in pixels. Specified for  OBJ_LABEL (read only), OBJ_BUTTON, OBJ_BITMAP, OBJ_BITMAP_LABEL, OBJ_EDIT, OBJ_RECTANGLE_LABEL objects.	int
OBJPROP_YSIZE	The object’s height along the Y axis in pixels. Specified for  OBJ_LABEL (read only), OBJ_BUTTON, OBJ_BITMAP, OBJ_BITMAP_LABEL, OBJ_EDIT, OBJ_RECTANGLE_LABEL objects.	int
OBJPROP_XOFFSET	The X coordinate of the upper left corner of the rectangular visible area in the graphical objects “Bitmap Label” and “Bitmap” (OBJ_BITMAP_LABEL and OBJ_BITMAP). The value is set in pixels relative to the upper left corner of the original image.	int
OBJPROP_YOFFSET	The Y coordinate of the upper left corner of the rectangular visible area in the graphical objects “Bitmap Label” and “Bitmap” (OBJ_BITMAP_LABEL and OBJ_BITMAP). The value is set in pixels relative to the upper left corner of the original image.	int
OBJPROP_BGCOLOR	The background color for  OBJ_EDIT, OBJ_BUTTON, OBJ_RECTANGLE_LABEL	color
OBJPROP_CORNER	The corner of the chart to link a graphical object	ENUM_BASE_CORNER
OBJPROP_BORDER_TYPE	Border type for the “Rectangle label” object	ENUM_BORDER_TYPE
OBJPROP_BORDER_COLOR	Border color for the OBJ_EDIT and OBJ_BUTTON objects	color

For objects OBJ_BITMAP_LABEL and OBJ_BITMAP, a special mode of image display can be set programmatically. In this mode, only part of an original image (at which a rectangular visible area is applied) is displayed, while the rest of the image becomes invisible. The size of this area should be set using the properties OBJPROP_XSIZE and OBJPROP_YSIZE. The visible area can be “moved” only within the original image using the properties OBJPROP_XOFFSET and OBJPROP_YOFFSET.

For the fixed-sized objects: OBJ_BUTTON, OBJ_RECTANGLE_LABEL and OBJ_EDIT, properties OBJPROP_XDISTANCE and OBJPROP_YDISTANCE set the position of the top left point of the object relative to the chart corner (OBJPROP_CORNER), from which the X and Y coordinates will be counted in pixels.

For functions ObjectSetDouble() and ObjectGetDouble()

ENUM_OBJECT_PROPERTY_DOUBLE

Identifier	Description	Property Type
OBJPROP_PRICE	Price coordinate	double    modifier=number of anchor point
OBJPROP_LEVELVALUE	Level value	double    modifier=level number
OBJPROP_SCALE	Scale (properties of Gann objects, Fibonacci Arcs and Ellipse)	double
OBJPROP_ANGLE	Angle.  For the objects with no angle specified, created from a program, the value is equal to EMPTY_VALUE	double
OBJPROP_DEVIATION	Deviation for the Standard Deviation Channel	double

For functions ObjectSetString() and ObjectGetString()

ENUM_OBJECT_PROPERTY_STRING

Identifier	Description	Property Type
OBJPROP_NAME	Object name	string
OBJPROP_TEXT	Description of the object (the text contained in the object)	string
OBJPROP_TOOLTIP	The text of a tooltip. If the property is not set, then the tooltip generated automatically by the terminal is shown. A tooltip can be disabled by setting the “\n” (line feed) value to it	string
OBJPROP_LEVELTEXT	Level description	string    modifier=level number
OBJPROP_FONT	Font	string
OBJPROP_BMPFILE	The name of BMP-file for Bitmap Label. See also Resources	string    modifier: 0-state ON, 1-state OFF
OBJPROP_SYMBOL	Symbol for the Chart object	string

For the OBJ_RECTANGLE_LABEL object (“Rectangle label”) one of the three design modes can be set, to which the following values of ENUM_BORDER_TYPE correspond.

ENUM_BORDER_TYPE

Identifier	Description
BORDER_FLAT	Flat form
BORDER_RAISED	Prominent form
BORDER_SUNKEN	Concave form

For the OBJ_EDIT object (“Edit”) and for the ChartScreenShot()function, you can specify the horizontal alignment type using the values of the ENUM_ALIGN_MODE enumeration.

ENUM_ALIGN_MODE

Identifier	Description
ALIGN_LEFT	Left alignment
ALIGN_CENTER	Centered (only for the Edit object)
ALIGN_RIGHT	Right alignment

标签 MT4编程, MT4编程手册