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

  • 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

See Also

Reference

XAML for Windows Embedded Structures
IXRVisualHost