XRWindowCreateParams (Compact 2013)
3/28/2014
This structure defines the window that you create to contain the visual host for your application.
Syntax
struct XRWindowCreateParams{
DWORD Style;
DWORD ExStyle;
const WCHAR *pTitle;
UINT Left;
UINT Top;
UINT Width;
UINT Height;
XR_HOOKPROC pHookProc;
VOID *pvUserParam;
bool AllowsMultipleThreadAccess;
HWND ParentWindow;
};
Members
- Style
Contains any combination of the XAML for Windows Embedded Window Style Constants that you can use to customize the window for the visual host.
- ExStyle
Contains any combination of the XAML for Windows Embedded Extended Window Style Constants that you can use to customize the window for the visual host.
- pTitle
String that contains the default title of this host window. This value is optional.
- Left
Indicates the x-axis position of the upper-left corner of the window for the visual host.
- Top
Indicates the y-axis position of the upper-left corner of the window for the visual host.
- Width
Indicates the starting width, in device units, of the window for the visual host.
- Height
Indicates the starting height, in device units, of the window for the visual host.
- pHookProc
Points to an optional procedure that you implement using the XR_HOOKPROC signature. This hook procedure intercepts all messages before the visual host window receives them.
- pvUserParam
Custom parameter that XAML for Windows Embedded passes into the hook procedure that is specified in pHookProc. This parameter holds custom data, such as a handle to an object, an integer, NULL, or anything that you want to use in the hook procedure. This member is optional.
- AllowsMultipleThreadAccess
[optional] Set to true to protect the IXRApplication from being accessed by more than one thread at a time. XAML for Windows Embedded is single threaded. Use this member if multiple threads can access the same element tree.
- ParentWindow
[optional] Handle to the parent window.
Remarks
If you set Style to WS_POPUP, the client area of the window is scaled with the exact characteristics you specify. If you set it to another value, the window is scaled to include a border, which can result in a clipped window.
To define custom parameters for the window for the visual host, you can use this structure as a parameter in IXRApplication::CreateHostFromXaml or IXRApplication::CreateHostFromElementTree. Otherwise, XAML for Windows Embedded uses the default values for the window.
Requirements
Header |
XamlRuntime.h |
sysgen |
SYSGEN_XAML_RUNTIME |