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

See Also

Reference

XAML for Windows Embedded Structures
IXRVisualHost