This document is archived and information here might be outdated.  Recommended version.


IMapControl3.BackColor Property (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (Controls)  

IMapControl3.BackColor Property

Background color of the MapControl.

[Visual Basic .NET]
Public Property BackColor As Integer
[C#]
public int BackColor {get; set;}
[C++]
HRESULT get_BackColor(
  long* BackColor
);
[C++]
HRESULT put_BackColor(
  long BackColor
);
[C++]

Parameters BackColor [out, retval] BackColor is a parameter of type long BackColor [in] BackColor is a parameter of type long

Product Availability

Available with ArcGIS Engine.

Description

Returns or sets the Background Color of the MapControl. Internally the OLE_Color is stored as a long integer where the value may be calculated for any RGB combination as follows:

OLE_Color=(Red) + (Green * 256) + (Blue * 256 * 256)

Where Red, Green and Blue are Long Integers within the range 0 - 255.

Errors Returned

1057 800a0421: The supplied color value is invalid

[C#]

When working directly with AxControls class use the BackColor property as follows:

AxMapControl1.BackColor=System.Drawing.Color.Red;

When using the Controls interop assembly use the BackColor property as follows:

IMapControl3 mapControl=(IMapControl3) AxMapControl1.Object;
mapControl.BackColor=255;

[Visual Basic .NET]

When working directly with AxControls class use the BackColor property as follows:

AxMapControl1.BackColor=System.Drawing.Color.Red

When using the Controls interop assembly use the BackColor property as follows:

Dim mapControl As IMapControl3=AxMapControl1.Object
mapControl.BackColor=Convert.ToUInt32(255)

See Also

IMapControl3 Interface