Edit

Share via

IApplicationDesignModeSettings::SetNativeDisplaySize method (shobjidl_core.h)

  • Article

Sets a spoofed native display size to be used for a Windows Store app running in design mode.

You must call IInitializeWithWindow::Initialize to set a proxy core window before calling this method. For a code example, see Display WinRT UI objects that depend on CoreWindow.

SetNativeDisplaySize must be called before calling ComputeApplicationSize.

Syntax

HRESULT SetNativeDisplaySize(
  [in] SIZE nativeDisplaySizePixels
);

Parameters

[in] nativeDisplaySizePixels

The native size of the display to spoof, as a SIZE structure. The specified size will be normalized to a landscape orientation. To spoof orientation, see SetApplicationViewState.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code, including the following:

Return code Description
E_NOT_SET

IInitializeWithWindow::Initialize has not been called to set a proxy core window.
E_MONITOR_RESOLUTION_TOO_LOW
You cannot launch or switch to an immersive app when the resolution is this low. This is currently defined as any resolution below 800 horizontal or 600 vertical pixels when in landscape orientation.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Twinapi.dll

See also

IApplicationDesignModeSettings