This documentation is archived and is not being maintained.

AmbientProperties Class

Provides ambient property values to top-level controls.

For a list of all members of this type, see AmbientProperties Members.


[Visual Basic]
NotInheritable Public Class AmbientProperties
public sealed class AmbientProperties
public __gc __sealed class AmbientProperties
public class AmbientProperties

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


An ambient property is a property on a control that, if not set, is retrieved from the parent control. If the control does not have a parent and the property is not set, the control tries to find the value of the ambient property through the Site property. If the control is not sited, the site does not support ambient properties, or the property is not set on the AmbientProperties object, the Control uses its own default values. Some objects derived from the Control class might set the property even if you do not. For example, the Form class always sets the ForeColor and BackColor properties.


Namespace: System.Windows.Forms

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

See Also

AmbientProperties Members | System.Windows.Forms Namespace | Control