Metodo IAccessibilityDockingService::GetAvailableSize

Articolo
06/12/2023

Ottiene le dimensioni disponibili per l'ancoraggio di una finestra di accessibilità su un monitor.

Sintassi

HRESULT GetAvailableSize(
  [in]  HMONITOR hMonitor,
  [out] UINT     *puMaxHeight,
  [out] UINT     *puFixedWidth
);

Parametri

hMonitor [in]

Specifica il monitor per il quale verranno recuperate le dimensioni di ancoraggio disponibili.

puMaxHeight [out]

In caso di esito positivo, impostare sull'altezza massima disponibile per l'ancoraggio sul valore hMonitor specificato, in pixel.

In caso di errore, impostare su zero.

puFixedWidth [out]

In caso di esito positivo, impostare sulla larghezza fissa disponibile per l'ancoraggio sul valore hMonitor specificato, in pixel. Qualsiasi finestra ancorata a questo hMonitor verrà ridimensionata in base a questa larghezza.

In caso di errore, impostare su zero.

Valore restituito

Codice restituito	Descrizione
S_OK	Operazione completata.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	Il monitor specificato dall'handle di monitoraggio non supporta l'ancoraggio.

Se puMaxHeight o puFixedWidth sono Null, si verificherà una violazione di accesso.

Commenti

Le finestre di accessibilità possono essere ancorate solo a un monitor con almeno 768 pixel di schermo verticali. Questa API non consentirà l'ancoraggio di tali finestre con un'altezza che causerebbe che le app di Windows Store abbiano meno di 768 pixel dello schermo verticale.

Esempi

IAccessibilityDockingService *pDockingService;
HRESULT hr = CoCreateInstance(CLSID_AccessibilityDockingService, CLSCTX_INPROV_SERVER, nullptr, IID_PPV_ARGS(&pDockingService));
if (SUCCEEDED(hr))
{
    UINT uMaxHeight;
    UINT uFixedWidth;

    HMONITOR hMonitor = MonitorFromWindow(_hwndMyApplication, MONITOR_DEFAULTTONULL);
    if (hMonitor != nullptr)
    {
        hr = pDockingService->GetAvailableSize(hMonitor, &uMaxHeight, &uFixedWidth);
    }
}

Vedere anche

IAccessibilityDockingService

Condividi tramite