IApplicationDesignModeSettings 介面 (shobjidl_core.h)

可讓開發工具應用程式動態詐騙系統和用戶狀態，例如原生顯示器解析度、裝置縮放比例和應用程式檢視狀態，以測試在設計模式中執行的各種尺寸規格的 Windows 市集應用程式，而不需要實際硬體。 也可讓您在一般使用者控制的狀態下測試變更，以在各種情況下測試 Windows 市集應用程式。

繼承

IApplicationDesignModeSettings 介面繼承自 IUnknown 介面。 IApplicationDesignModeSettings 也有下列類型的成員：

方法

IApplicationDesignModeSettings 介面具有這些方法。

備註

藉由共同建立CLSID_ApplicationDesignModeSettings來取得此介面。

使用者通常會遵循類似下列的使用模式：

1. 使用 CLSID_ApplicationDesignModeSettings呼叫 CoCreateInstance ，以在 Windows 市集應用程式進程中的線程上建立應用程式設計模式設定物件。
2. 在應用程式設計模式設定物件上呼叫 QueryInterface ，以取得 IInitializeWithWindow 物件。
3. 呼叫 IInitializeWithWindow 物件的 Initialize 方法，傳入 Proxy 核心視窗的 HWND。 在呼叫任何“set” 方法之前，這必須先完成，而且每個進程只會成功一次。 如需程式代碼範例，請參閱 [顯示相依於 CoreWindow 的 WinRT UI 物件] (/windows/apps/develop/ui-input/display-ui-objects#winui-3-with-c) 。
4. 呼叫適用於 IApplicationDesignModeSettings 的 QueryInterface，並呼叫其適當的方法， (SetNativeDisplaySize、SetScaleFactor 等 ) 呼叫必要的測試狀態。 這些方法會觸發針對 Windows 市集應用程式引發的適當 Windows 執行階段 事件。
5. 呼叫 ComputeApplicationSize 方法，根據目前詐騙的狀態來判斷應用程式的適當大小。 所有配置 「set」 方法都必須已經呼叫，否則此呼叫將會失敗。 開發人員工具應用程式會負責適當地定位和調整應用程式視窗的大小。

實作時機

使用時機

範例

此範例顯示此介面使用中的方法。

IApplicationDesignModeSettings *pDesignModeSettings;

// CoCreate the design mode settings object
HRESULT hr = CoCreateInstance(CLSID_ApplicationDesignModeSettings, nullptr, CLSCTX_INPROC, IID_PPV_ARGS(&pDesignModeSettings));
if (SUCCEEDED(hr))
{
    IInitializeWithWindow *pInitializeWithWindow;
    hr = pDesignModeSettings->QueryInterface(IID_PPV_ARGS(&pInitializeWithWindow);
    if (SUCCEEDED(hr))
    {
        // Before we spoof any state, we must first initialize the design
        // mode settings object with a proxy core window. Since apps
        // running in design mode don't have an actual core window, we must
        // supply an HWND that can be used as a proxy.
        hr = pInitializeWithWindow->Initialize(hwndProxyCoreWindow);
        pInitializeWithWindow->Release();
    }

    if (SUCCEEDED(hr))
    {
        // Verify that our desired spoofed settings are supported.
        SIZE sizeNativeDisplay = {1366, 768};
        SCALE_FACTOR scaleFactor = SCALE_100_PERCENT;
        APPLICATION_VIEW_STATE viewState = AVS_FULLSCREEN_LANDSCAPE;
        BOOL fSupported;
        hr = pDesignModeSettings->IsApplicationViewStateSupported(viewState,
                                                                  sizeNativeDisplay,
                                                                  scaleFactor,
                                                                  &fSupported);
    }

    if (SUCCEEDED(hr) && fSupported))
    {
        // Set the spoofed native display size.
        hr = pDesignModeSettings->SetNativeDisplaySize(sizeNativeDisplay);

        if (SUCCEEDED(hr))
        {
            // Set the spoofed scale factor to 100%.
            hr = pDesignModeSettings->SetScaleFactor(SCALE_100_PERCENT);
        }

        if (SUCCEEDED(hr))
        {
            // Set the spoofed application view state to full-screen landscape.
            hr = pDesignModeSettings->SetApplicationViewState(AVS_FULLSCREEN_LANDSCAPE);
        }

        if (SUCCEEDED(hr))
        {
            // Now that all the necessary state has been spoofed, calculate
            // the size that the app should occupy.
            SIZE sizeApplication;
            hr = pDesignModeSettings->ComputeApplicationSize(&sizeApplication);
        }
    }

    pDesignModeSettings->Release();
}

規格需求