IXRPopup (Compact 2013)
3/28/2014
This class displays content over existing content.
Syntax
class IXRPopup : public IXRFrameworkElement
Inheritance Hierarchy
IXRPopup
Methods
In addition to the methods inherited from IXRFrameworkElement, this class exposes the following methods.
Name |
Description |
---|---|
Attaches a delegate to the Closed event for this popup. |
|
Attaches a delegate to the Opened event for this popup. |
|
Retrieves the content to be hosted in the popup. |
|
Retrieves the distance between the left side of the parent control and the left side of the popup. |
|
Retrieves whether the popup is currently displaying on the screen. |
|
Retrieves the distance between the top of the parent control and the top of the popup. |
|
Removes a delegate from the Closed event for this popup. |
|
Removes a delegate from the Opened event for this popup. |
|
Sets the content to be hosted in the popup. |
|
Sets the distance between the left side of the parent control and the left side of the popup. |
|
Sets whether the popup is to be displayed on the screen. |
|
Sets the distance between the top of the parent control and the top of the popup. |
Thread Safety
Members of this class are thread-safe if you previously called IXRApplication::CreateHostFromXaml and supplied it with an XRWindowCreateParams structure that has AllowsMultipleThreadAccess set to true.
Remarks
You typically use the IXRPopup class to temporarily display content that performs a particular task. For example, you might use a popup to display help information when the user moves the mouse pointer over a particular control. The content of the IXRPopup is set by using its Child property, and can be any IXRUIElement.
You would typically create a user control to host the popup content, but this is not required. A popup will always appear over the existing content. This includes other popup controls. When you apply scaling or transforms to the parent control of an IXRPopup they are also applied to the popup.
When you create a class instance, use an IXRPopupPtr smart pointer instead of a raw interface pointer. For more information, see XRPtr<Interface>.
You can also define an IXRPopup object in Microsoft Silverlight 3 XAML. For information about the differences between XAML in XAML for Windows Embedded and Silverlight 3, see Differences Between Microsoft Silverlight 3 and XAML for Windows Embedded. For more information about how to define this element in the source XAML for your application, see the Popup Class on MSDN.
.NET Framework Equivalent
System.Windows.Controls.Primitives.Popup
Requirements
Header |
XamlRuntime.h |
sysgen |
SYSGEN_XAML_RUNTIME |