 | GraphicsDisplayPanel Class |
A container control that can mirror its contents out to a hardware graphics display.
Inheritance HierarchySystemObject
Windows.UI.XamlDependencyObject
Windows.UI.XamlUIElement
Windows.UI.XamlFrameworkElement
Windows.UI.Xaml.ControlsControl
Windows.UI.Xaml.ControlsContentControl
Microsoft.IoT.DeviceCore.ControlsGraphicsDisplayPanel
Windows.UI.XamlDependencyObject
Windows.UI.XamlUIElement
Windows.UI.XamlFrameworkElement
Windows.UI.Xaml.ControlsControl
Windows.UI.Xaml.ControlsContentControl
Microsoft.IoT.DeviceCore.ControlsGraphicsDisplayPanel
Namespace: Microsoft.IoT.DeviceCore.Controls
Assembly: Microsoft.IoT.DeviceCore (in Microsoft.IoT.DeviceCore.dll) Version: 1.0.0.0 (1.0.0.0)
SyntaxThe GraphicsDisplayPanel type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | GraphicsDisplayPanel |
Initializes a new GraphicsDisplayPanel instance.
|
Properties| Name | Description | |
|---|---|---|
 | ActualHeight | Gets the rendered height of a FrameworkElement. (Inherited from FrameworkElement.) |
| ActualWidth | Gets the rendered width of a FrameworkElement. (Inherited from FrameworkElement.) |
| AllowDrop | Gets or sets a value that determines whether this UIElement can be a drop target for purposes of drag-and-drop operations. (Inherited from UIElement.) |
| AutoUpdate |
Gets a value that indicates if the panel should automatically update the display.
|
| Background | Gets or sets a brush that provides the background of the control. (Inherited from Control.) |
| BaseUri | Gets a Uniform Resource Identifier (URI) that represents the base Uniform Resource Identifier (URI) for an XAML-constructed object at XAML load time. This property is useful for Uniform Resource Identifier (URI) resolution at run time. (Inherited from FrameworkElement.) |
| BorderBrush | Gets or sets a brush that describes the border background of a control. (Inherited from Control.) |
| BorderThickness | Gets or sets the border thickness of a control. (Inherited from Control.) |
| CacheMode | Gets or sets a value that indicates that rendered content should be cached as a composited bitmap when possible. (Inherited from UIElement.) |
| CanDrag | (Inherited from UIElement.) |
| CharacterSpacing | Gets or sets the uniform spacing between characters, in units of 1/1000 of an em. (Inherited from Control.) |
| Clip | Gets or sets the RectangleGeometry used to define the outline of the contents of a UIElement. (Inherited from UIElement.) |
| CompositeMode | Gets or sets a property that declares alternate composition and blending modes for the element in its parent layout and window. This is relevant for elements that are involved in a mixed XAML / Microsoft DirectX UI. (Inherited from UIElement.) |
| Content | Gets or sets the content of a ContentControl. (Inherited from ContentControl.) |
| ContentTemplate | Gets or sets the data template that is used to display the content of the ContentControl. (Inherited from ContentControl.) |
| ContentTemplateRoot | Gets the root element of the date template specified by the ContentTemplate property. (Inherited from ContentControl.) |
| ContentTemplateSelector | Gets or sets a selection object that changes the DataTemplate to apply for content, based on processing information about the content item or its container at run time. (Inherited from ContentControl.) |
| ContentTransitions | Gets or sets the collection of Transition style elements that apply to the content of a ContentControl. (Inherited from ContentControl.) |
| DataContext | Gets or sets the data context for a FrameworkElement when it participates in data binding. (Inherited from FrameworkElement.) |
| DesiredSize | Gets the size that this UIElement computed during the measure pass of the layout process. (Inherited from UIElement.) |
| Dispatcher | Gets the CoreDispatcher that this object is associated with. (Inherited from DependencyObject.) |
| Display |
Gets or sets the display that the panel will render to.
|
| FlowDirection | Gets or sets the direction in which text and other UI elements flow within any parent element that controls their layout. This property can be set to either LeftToRight or RightToLeft. Setting FlowDirection to RightToLeft on any element sets the alignment to the right, the reading order to right-to-left and the layout of the control to flow from right to left. (Inherited from FrameworkElement.) |
| FocusState | Gets a value that specifies whether this control has focus, and the mode by which focus was obtained. (Inherited from Control.) |
| FontFamily | Gets or sets the font used to display text in the control. (Inherited from Control.) |
| FontSize | Gets or sets the size of the text in this control. (Inherited from Control.) |
| FontStretch | Gets or sets the degree to which a font is condensed or expanded on the screen. (Inherited from Control.) |
| FontStyle | Gets or sets the style in which the text is rendered. (Inherited from Control.) |
| FontWeight | Gets or sets the thickness of the specified font. (Inherited from Control.) |
| Foreground | Gets or sets a brush that describes the foreground color. (Inherited from Control.) |
| Height | Gets or sets the suggested height of a FrameworkElement. (Inherited from FrameworkElement.) |
| HorizontalAlignment | Gets or sets the horizontal alignment characteristics that are applied to a FrameworkElement when it is composed in a layout parent, such as a panel or items control. (Inherited from FrameworkElement.) |
| HorizontalContentAlignment | Gets or sets the horizontal alignment of the control's content. (Inherited from Control.) |
| IsDoubleTapEnabled | Gets or sets a value that determines whether the DoubleTapped event can originate from that element. (Inherited from UIElement.) |
| IsEnabled | Gets or sets a value indicating whether the user can interact with the control. (Inherited from Control.) |
| IsHitTestVisible | Gets or sets whether the contained area of this UIElement can return true values for hit testing. (Inherited from UIElement.) |
| IsHoldingEnabled | Gets or sets a value that determines whether the Holding event can originate from that element. (Inherited from UIElement.) |
| IsRightTapEnabled | Gets or sets a value that determines whether the RightTapped event can originate from that element. (Inherited from UIElement.) |
| IsTabStop | Gets or sets a value that indicates whether a control is included in tab navigation. (Inherited from Control.) |
| IsTapEnabled | Gets or sets a value that determines whether the Tapped event can originate from that element. (Inherited from UIElement.) |
| IsTextScaleFactorEnabled | (Inherited from Control.) |
| Language | Gets or sets localization/globalization language information that applies to a FrameworkElement, and also to all child elements of the current FrameworkElement in the object representation and in UI. (Inherited from FrameworkElement.) |
| ManipulationMode | Gets or sets the ManipulationModes value used for UIElement behavior and interaction with gestures. (Inherited from UIElement.) |
| Margin | Gets or sets the outer margin of a FrameworkElement. (Inherited from FrameworkElement.) |
| MaxHeight | Gets or sets the maximum height constraint of a FrameworkElement. (Inherited from FrameworkElement.) |
| MaxWidth | Gets or sets the maximum width constraint of a FrameworkElement. (Inherited from FrameworkElement.) |
| MinHeight | Gets or sets the minimum height constraint of a FrameworkElement. (Inherited from FrameworkElement.) |
| MinWidth | Gets or sets the minimum width constraint of a FrameworkElement. (Inherited from FrameworkElement.) |
| Name | Gets or sets the identifying name of the object. When a XAML processor creates the object tree from XAML markup, run-time code can refer to the XAML-declared object by this name. (Inherited from FrameworkElement.) |
| Opacity | Gets or sets the degree of the object's opacity. (Inherited from UIElement.) |
| Padding | Gets or sets the padding inside a control. (Inherited from Control.) |
| Parent | Gets the parent object of this FrameworkElement in the object tree. (Inherited from FrameworkElement.) |
| PointerCaptures | Gets the set of all captured pointers, represented as Pointer values. (Inherited from UIElement.) |
| Projection | Gets or sets the perspective projection (3-D effect) to apply when rendering this element. (Inherited from UIElement.) |
| RenderSize | Gets the final render size of a UIElement. (Inherited from UIElement.) |
| RenderTransform | Gets or sets transform information that affects the rendering position of a UIElement. (Inherited from UIElement.) |
| RenderTransformOrigin | Gets or sets the origin point of any possible render transform declared by RenderTransform, relative to the bounds of the UIElement. (Inherited from UIElement.) |
| RequestedTheme | Gets or sets the UI theme that is used by the UIElement (and its child elements) for resource determination. The UI theme you specify with RequestedTheme can override the app-level RequestedTheme. (Inherited from FrameworkElement.) |
| Resources | Gets the locally defined resource dictionary. In XAML, you can establish resource items as child object elements of a frameworkElement.Resources property element, through XAML implicit collection syntax. (Inherited from FrameworkElement.) |
| Style | Gets or sets an instance Style that is applied for this object during layout and rendering. (Inherited from FrameworkElement.) |
| TabIndex | Gets or sets a value that determines the order in which elements receive focus when the user navigates through controls by pressing the Tab key. (Inherited from Control.) |
| TabNavigation | Gets or sets a value that modifies how tabbing and TabIndex work for this control. (Inherited from Control.) |
| Tag | Gets or sets an arbitrary object value that can be used to store custom information about this object. (Inherited from FrameworkElement.) |
| Template | Gets or sets a control template. The control template defines the visual appearance of a control in UI, and is defined in XAML markup. (Inherited from Control.) |
| Transform3D | (Inherited from UIElement.) |
| Transitions | Gets or sets the collection of Transition style elements that apply to a UIElement. (Inherited from UIElement.) |
| Triggers | Gets the collection of triggers for animations that are defined for a FrameworkElement. Not commonly used. (Inherited from FrameworkElement.) |
| UpdateInterval |
Gets or sets a value that indicates how often the display will be updated in milliseconds.
|
| UseLayoutRounding | Gets or sets a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels. (Inherited from UIElement.) |
| UseSystemFocusVisuals | (Inherited from Control.) |
| VerticalAlignment | Gets or sets the vertical alignment characteristics that are applied to a FrameworkElement when it is composed in a parent object such as a panel or items control. (Inherited from FrameworkElement.) |
| VerticalContentAlignment | Gets or sets the vertical alignment of the control's content. (Inherited from Control.) |
| Visibility | Gets or sets the visibility of a UIElement. A UIElement that is not visible is not rendered and does not communicate its desired size to layout. (Inherited from UIElement.) |
| Width | Gets or sets the width of a FrameworkElement. (Inherited from FrameworkElement.) |
Methods| Name | Description | |
|---|---|---|
| AddHandler | Adds a routed event handler for a specified routed event, adding the handler to the handler collection on the current element. Specify handledEventsToo as true to have the provided handler be invoked even if the event is handled elsewhere. (Inherited from UIElement.) |
| ApplyTemplate | Loads the relevant control template so that its parts can be referenced. (Inherited from Control.) |
| Arrange | Positions child objects and determines a size for a UIElement. Parent objects that implement custom layout for their child elements should call this method from their layout override implementations to form a recursive layout update. (Inherited from UIElement.) |
| CancelDirectManipulations | Cancels ongoing direct manipulation processing (system-defined panning/zooming) on any ScrollViewer parent that contains the current UIElement. (Inherited from UIElement.) |
| CapturePointer | Sets pointer capture to a UIElement. Once captured, only the element that has capture will fire pointer-related events. (Inherited from UIElement.) |
| ClearValue | Clears the local value of a dependency property. (Inherited from DependencyObject.) |
| Equals | (Inherited from Object.) |
| FindName | Retrieves an object that has the specified identifier name. (Inherited from FrameworkElement.) |
| Focus | Attempts to set the focus on the control. (Inherited from Control.) |
| GetAnimationBaseValue | Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Inherited from DependencyObject.) |
| GetBindingExpression | Returns the BindingExpression that represents the binding on the specified property. (Inherited from FrameworkElement.) |
| GetHashCode | (Inherited from Object.) |
| GetType | (Inherited from Object.) |
| GetValue | Returns the current effective value of a dependency property from a DependencyObject. (Inherited from DependencyObject.) |
| InvalidateArrange | Invalidates the arrange state (layout) for a UIElement. After the invalidation, the UIElement will have its layout updated, which will occur asynchronously. (Inherited from UIElement.) |
| InvalidateMeasure | Invalidates the measurement state (layout) for a UIElement. (Inherited from UIElement.) |
| Measure | Updates the DesiredSize of a UIElement. Typically, objects that implement custom layout for their layout children call this method from their own MeasureOverride implementations to form a recursive layout update. (Inherited from UIElement.) |
| ReadLocalValue | Returns the local value of a dependency property, if a local value is set. (Inherited from DependencyObject.) |
| RegisterPropertyChangedCallback | (Inherited from DependencyObject.) |
| ReleasePointerCapture | Releases pointer captures for capture of one specific pointer by this UIElement. (Inherited from UIElement.) |
| ReleasePointerCaptures | Releases all pointer captures held by this element. (Inherited from UIElement.) |
| RemoveHandler | Removes the specified routed event handler from this UIElement. Typically the handler in question was added by AddHandler. (Inherited from UIElement.) |
| SetBinding | Attaches a binding to a FrameworkElement, using the provided binding object. (Inherited from FrameworkElement.) |
| SetValue | Sets the local value of a dependency property on a DependencyObject. (Inherited from DependencyObject.) |
| StartDragAsync | (Inherited from UIElement.) |
| ToString | (Inherited from Object.) |
| TransformToVisual | Returns a transform object that can be used to transform coordinates from the UIElement to the specified object. (Inherited from UIElement.) |
| UnregisterPropertyChangedCallback | (Inherited from DependencyObject.) |
| UpdateLayout | Ensures that all positions of child objects of a UIElement are properly updated for layout. (Inherited from UIElement.) |
Events| Name | Description | |
|---|---|---|
 | DataContextChanged | Occurs when the value of the FrameworkElement.DataContext property changes. (Inherited from FrameworkElement.) |
| DoubleTapped | Occurs when an otherwise unhandled DoubleTap interaction occurs over the hit test area of this element. (Inherited from UIElement.) |
| DragEnter | Occurs when the input system reports an underlying drag event with this element as the target. (Inherited from UIElement.) |
| DragLeave | Occurs when the input system reports an underlying drag event with this element as the origin. (Inherited from UIElement.) |
| DragOver | Occurs when the input system reports an underlying drag event with this element as the potential drop target. (Inherited from UIElement.) |
| DragStarting | (Inherited from UIElement.) |
| Drop | Occurs when the input system reports an underlying drop event with this element as the drop target. (Inherited from UIElement.) |
| DropCompleted | (Inherited from UIElement.) |
| GotFocus | Occurs when a UIElement receives focus. (Inherited from UIElement.) |
| Holding | Occurs when an otherwise unhandled Hold interaction occurs over the hit test area of this element. (Inherited from UIElement.) |
| IsEnabledChanged | Occurs when the IsEnabled property changes. (Inherited from Control.) |
| KeyDown | Occurs when a keyboard key is pressed while the UIElement has focus. (Inherited from UIElement.) |
| KeyUp | Occurs when a keyboard key is released while the UIElement has focus. (Inherited from UIElement.) |
| LayoutUpdated | Occurs when the layout of the visual tree changes. (Inherited from FrameworkElement.) |
| Loaded | Occurs when a FrameworkElement has been constructed and added to the object tree, and is ready for interaction. (Inherited from FrameworkElement.) |
| Loading | (Inherited from FrameworkElement.) |
| LostFocus | Occurs when a UIElement loses focus. (Inherited from UIElement.) |
| ManipulationCompleted | Occurs when a manipulation on the UIElement is complete. (Inherited from UIElement.) |
| ManipulationDelta | Occurs when the input device changes position during a manipulation. (Inherited from UIElement.) |
| ManipulationInertiaStarting | Occurs when the input device loses contact with the UIElement object during a manipulation and inertia begins. (Inherited from UIElement.) |
| ManipulationStarted | Occurs when an input device begins a manipulation on the UIElement. (Inherited from UIElement.) |
| ManipulationStarting | Occurs when the manipulation processor is first created. (Inherited from UIElement.) |
| PointerCanceled | Occurs when a pointer that made contact abnormally loses contact. (Inherited from UIElement.) |
| PointerCaptureLost | Occurs when pointer capture previously held by this element moves to another element or elsewhere. (Inherited from UIElement.) |
| PointerEntered | Occurs when a pointer enters the hit test area of this element. (Inherited from UIElement.) |
| PointerExited | Occurs when a pointer leaves the hit test area of this element. (Inherited from UIElement.) |
| PointerMoved | Occurs when a pointer moves while the pointer remains within the hit test area of this element. (Inherited from UIElement.) |
| PointerPressed | Occurs when the pointer device initiates a Press action within this element. (Inherited from UIElement.) |
| PointerReleased | Occurs when the pointer device that previously initiated a Press action is released, while within this element. (Inherited from UIElement.) |
| PointerWheelChanged | Occurs when the delta value of a pointer wheel changes. (Inherited from UIElement.) |
| RightTapped | Occurs when a right-tap input stimulus happens while the pointer is over the element. (Inherited from UIElement.) |
| SizeChanged | Occurs when either the ActualHeight or the ActualWidth property changes value on a FrameworkElement. (Inherited from FrameworkElement.) |
| Tapped | Occurs when an otherwise unhandled Tap interaction occurs over the hit test area of this element. (Inherited from UIElement.) |
| Unloaded | Occurs when this object is no longer connected to the main object tree. (Inherited from FrameworkElement.) |
RemarksGraphicsDisplayPanel works with any display that implements the IGraphicsDisplay interface. The display must be initialized and assigned to the Display property of this control. After the display has been assigned set the AutoUpdate property to true to begin rendering to the display.
Child content inside of this control should have the same pixel dimensions as the attached graphics display. The default template for this control wraps child content with a Viewbox so that the content will fill available screen space regardless of the native pixel dimensions.
This control must be present in the XAML tree in order for it to work, however it does not have to be opaque. The Opacity property can be set to 0 to keep the control from rendering on an HDMI display while still allowing it to render on the attached graphics display. Importantly, do not set the Visibility property to Collapsed or the XAML framework will not allow the control to render on either display.
See Also