ContentControl Class

Article
10/15/2012

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Constitutes the base class for all controls that contain a single piece of content.

Inheritance Hierarchy

Namespace: Microsoft.SPOT.Presentation.Controls
Assembly: Microsoft.SPOT.TinyCore (in Microsoft.SPOT.TinyCore.dll)

Syntax

'Declaration
Public MustInherit Class ContentControl _
    Inherits Control

public abstract class ContentControl : Control

public ref class ContentControl abstract : public Control

[<AbstractClass>]
type ContentControl =  
    class
        inherit Control
    end

public abstract class ContentControl extends Control

The ContentControl type exposes the following members.

Constructors

	Name	Description
	ContentControl	Initializes a new instance of the ContentControl class.

Top

Properties

	Name	Description
	ActualHeight	Gets the rendered height of this element. (Inherited from UIElement.)
	ActualWidth	Gets the rendered width of this element. (Inherited from UIElement.)
	Background	Gets or sets the brush used to paint a control's background. (Inherited from Control.)
	Child	Gets or sets a child element (child control) contained in the current ContentControl object.
	Font	Gets or sets a control's font. (Inherited from Control.)
	Foreground	Gets or sets the brush used to paint a control's foreground. (Inherited from Control.)
	Height	Gets or sets the suggested height of this element. (Inherited from UIElement.)
	HorizontalAlignment	Gets or sets the horizontal alignment characteristics that are applied to this element when it is composed within a parent element, such as a Panel. (Inherited from UIElement.)
	InstanceEventHandlersStore	Gets the event-handler store for this element. (Inherited from UIElement.)
	IsArrangeValid	Gets a value indicating whether the computed size and position of child elements in this element's layout are valid. (Inherited from UIElement.)
	IsEnabled	Gets or sets a value indicating whether this element is enabled in the user interface (UI). (Inherited from UIElement.)
	IsFocused	Gets a value that determines whether this element has logical focus. (Inherited from UIElement.)
	IsMeasureValid	Gets a value indicating whether the current size returned by layout measure is valid. (Inherited from UIElement.)
	IsVisible	Gets a value indicating whether this element is visible in the user interface (UI). (Inherited from UIElement.)
	LogicalChildren	Gets an enumerator for this element's logical child elements. (Inherited from UIElement.)
	Parent	Gets the logical parent element of this element. (Inherited from UIElement.)
	RootUIElement	Gets the logical root element of this element. (Inherited from UIElement.)
	VerticalAlignment	Gets or sets the vertical alignment characteristics that are applied to this element when it is composed within a parent element, such as a Panel. (Inherited from UIElement.)
	Visibility	Gets or sets the user interface (UI) visibility of this element. (Inherited from UIElement.)
	Width	Gets or sets the suggested width of this element. (Inherited from UIElement.)

Top

Methods

	Name	Description
	AddHandler	Adds a routed-event handler for a specified routed event, adding the handler to the current element's event handler collection. (Inherited from UIElement.)
	AddToEventRoute	Adds handlers to the specified event route for the current element's event handler collection. (Inherited from UIElement.)
	Arrange	Positions child elements in a particular region on the screen. (Inherited from UIElement.)
	ArrangeOverride	Positions child elements and determines a size for a UIElement-derived class when implemented in a derived class. (Inherited from UIElement.)
	CheckAccess	Determines whether the calling thread has access to the current DispatcherObject object. (Inherited from DispatcherObject.)
	ChildElementFromPoint	Returns the most recently created child control that is located at a specified point on the display. (Inherited from UIElement.)
	ContainsPoint	Determines whether a specified point is contained by this UIElement. (Inherited from UIElement.)
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetDesiredSize	Gets the current element's size, as computed during the measure pass of the layout process. (Inherited from UIElement.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetLayoutOffset	Gets the current element's offset, relative to the upper-left corner of the screen. (Inherited from UIElement.)
	GetMargin	Gets the width of the current element's margins. (Inherited from UIElement.)
	GetPointerTarget	Returns the visible child of this UIElement that contains a specified screen point. (Inherited from UIElement.)
	GetRenderSize	Gets the final render size of the current element. (Inherited from UIElement.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	GetUnclippedSize	Returns the unclipped size of this element. (Inherited from UIElement.)
	Invalidate	Invalidates the rendering of the current element and forces a complete new layout pass. (Inherited from UIElement.)
	InvalidateArrange	Invalidates the arrange state of the current element's layout. (Inherited from UIElement.)
	InvalidateMeasure	Invalidates the measurement state of the current element's layout. (Inherited from UIElement.)
	InvalidateRect	Invalidates the specified rectangle. (Inherited from UIElement.)
	Measure	Determines the size requirements for the layout of a child element. (Inherited from UIElement.)
	MeasureOverride	Re-measures a control for layout on a display device. (Overrides UIElement. . :: . .MeasureOverride(Int32, Int32, Int32%, Int32%).)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnButtonDown	Adds class handling for an unhandled ButtonDownEvent attached event when that event reaches, by way of its route, an element that is derived from the UIElement class. (Inherited from UIElement.)
	OnButtonUp	Adds class handling for an unhandled ButtonUpEvent attached event when that event reaches, by way of its route, an element that is derived from the UIElement class. (Inherited from UIElement.)
	OnChildDesiredSizeChanged	Supports the layout system when a child element is resized. (Inherited from UIElement.)
	OnChildrenChanged	Called when the UIElementCollection of this UIElement is edited. (Inherited from UIElement.)
	OnGenericEvent	Called when this UIElement generates a generic event. (Inherited from UIElement.)
	OnGotFocus	Adds class handling for an unhandled GotFocusEvent attached event when that event reaches, by way of its route, an element that is derived from the UIElement class. (Inherited from UIElement.)
	OnLostFocus	Adds class handling for an unhandled LostFocusEvent attached event when that event reaches, by way of its route, an element that is derived from the UIElement class. (Inherited from UIElement.)
	OnPreviewButtonDown	Adds class handling for an unhandled PreviewButtonDownEvent attached event when that event reaches, by way of its route, an element that is derived from the UIElement class. (Inherited from UIElement.)
	OnPreviewButtonUp	Adds class handling for an unhandled PreviewButtonUpEvent attached event when that event reaches, by way of its route, an element that is derived from the UIElement class. (Inherited from UIElement.)
	OnRender	Draws a control to a display device. (Inherited from Control.)
	OnTouchDown	Handles a touch down (or stylus down) event. (Inherited from UIElement.)
	OnTouchGestureChanged	Handles a TouchGestureChanged event. (Inherited from UIElement.)
	OnTouchGestureEnded	Handles a TouchGestureEnd event. (Inherited from UIElement.)
	OnTouchGestureStarted	Handles a TouchGestureStart event. (Inherited from UIElement.)
	OnTouchMove	Invoked when an unhandled TouchMove attached event reaches an element in its route that is derived from this class. Implement this method to add class handling for this event. (Inherited from UIElement.)
	OnTouchUp	Invoked when an unhandled TouchUp attached event reaches an element in its route that is derived from this class. Implement this method to add class handling for this event. (Inherited from UIElement.)
	PointToClient	Returns the client UIElement that is the top-level ancestor of this UIElement object, and expresses the given point in the coordinate space of that ancestor. (Inherited from UIElement.)
	PointToScreen	Converts a point expressed in the coordinate space of this UIElement into screen coordinates. (Inherited from UIElement.)
	RaiseEvent	Raises a specific routed event. (Inherited from UIElement.)
	RenderRecursive	Renders this element and all its child elements. (Inherited from UIElement.)
	SetMargin(Int32)	Sets the size of the current element's margin, using the same (specified) width for each of the four sides of the element. (Inherited from UIElement.)
	SetMargin(Int32, Int32, Int32, Int32)	Sets the size of the current element's margin, using a specified width for each of the four sides of the element. (Inherited from UIElement.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	UpdateLayout	Ensures that all visual child elements of the current element are properly updated for layout. (Inherited from UIElement.)
	VerifyAccess	Determines whether the calling thread has access to the current DispatcherObject object. (Inherited from DispatcherObject.)

Top

Events

	Name	Description
	IsEnabledChanged	Occurs when the value of the IsEnabled property changes for the current element. (Inherited from UIElement.)
	IsVisibleChanged	Occurs when the value of the IsVisible property changes for the current element. (Inherited from UIElement.)
	TouchDown	Occurs when the user initially touches the tablet screen or puts the tip of the stylus onto the tablet screen. (Inherited from UIElement.)
	TouchGestureChanged	Indicates that a touch or stylus gesture changed. (Inherited from UIElement.)
	TouchGestureEnd	Indicates that a touch or stylus gesture ended. (Inherited from UIElement.)
	TouchGestureStart	Indicates that a touch or stylus gesture started. (Inherited from UIElement.)
	TouchMove	Occurs when the user's finger or stylus moves while it is touching the tablet. (Inherited from UIElement.)
	TouchUp	Occurs when the user raises their finger or stylus from the touch screen. (Inherited from UIElement.)

Top

Fields

	Name	Description
	_background	Contains the brush used to paint a control's background. (Inherited from Control.)
	_font	Specifies the current font used for text in a control. (Inherited from Control.)
	_foreground	Contains the brush used to paint a control's foreground. (Inherited from Control.)
	_horizontalAlignment	Specifies the horizontal alignment characteristics that are applied to the current element when it is composed within a parent element, such as a Panel object. (Inherited from UIElement.)
	_verticalAlignment	Specifies the vertical alignment characteristics that are applied to the current element when it is composed within a parent element, such as a Panel object. (Inherited from UIElement.)
	Dispatcher	Contains the Dispatcher object that the current DispatcherObject object is associated with. (Inherited from DispatcherObject.)

Top

Remarks

Note that ContentControl objects have a limited default style. Your program can instantiate a ContentControl object (that is, a control), but its appearance will be very simple. If you want to enhance the appearance of the control, derive a new class from ContentControl. The ContentControl class is useful for creating custom controls because it provides a model for controls that have a single piece of content.

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.

Share via