Método IAccessibilityDockingService::GetAvailableSize

Obtém as dimensões disponíveis para encaixar uma janela de acessibilidade em um monitor.

Sintaxe

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

Parâmetros

hMonitor [in]

Especifica o monitor para o qual o tamanho de encaixe disponível será recuperado.

puMaxHeight [out]

Em caso de êxito, defina como a altura máxima disponível para encaixe no hMonitor especificado, em pixels.

Em caso de falha, defina como zero.

puFixedWidth [out]

Em caso de êxito, defina como a largura fixa disponível para encaixe no hMonitor especificado, em pixels. Qualquer janela encaixada nesse hMonitor será dimensionada para essa largura.

Em caso de falha, defina como zero.

Valor retornado

Código de retorno	Descrição
S_OK	Êxito.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	O monitor especificado pelo identificador do monitor não dá suporte ao encaixe.

Se puMaxHeight ou puFixedWidth forem nulos, ocorrerá uma violação de acesso.

Comentários

As janelas de acessibilidade só podem ser encaixadas em um monitor que tenha pelo menos 768 pixels de tela verticais. Essa API não permitirá que essas janelas sejam encaixadas com uma altura que faria com que os aplicativos da Windows Store tivessem menos de 768 pixels de tela verticais.

Exemplos

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);
    }
}

Confira também

IAccessibilityDockingService