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 |
|---|---|
|
Êxito. |
|
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);
}
}