Método IAccessibilityDockingService::GetAvailableSize (shobjidl.h)

Recupera as dimensões disponíveis em uma tela específica para exibir uma janela de acessibilidade.

Sintaxe

HRESULT GetAvailableSize(
  [in]  HMONITOR hMonitor,
  [out] UINT     *pcxFixed,
  [out] UINT     *pcyMax
);

Parâmetros

[in] hMonitor

Tipo: HMONITOR

O identificador do monitor cujo tamanho de encaixe disponível deve ser recuperado. Para obter informações sobre como recuperar um HMONITOR, consulte MonitorFromWindow.

[out] pcxFixed

Tipo: UINT*

Quando esse método retorna com êxito, esse parâmetro recebe a largura fixa, em pixels físicos, disponível para encaixe no monitor especificado. Qualquer janela encaixada nesse monitor será dimensionada para essa largura.

Se o método falhar, esse valor será definido como 0.

Se esse valor for NULL, ocorrerá uma violação de acesso.

[out] pcyMax

Tipo: UINT*

Quando esse método retorna com êxito, esse parâmetro recebe a altura máxima, em pixels físicos, disponível para uma janela encaixada no monitor especificado.

Se o método falhar, esse valor será definido como 0.

Se esse valor for NULL, ocorrerá uma violação de acesso.

Retornar valor

Tipo: HRESULT

Retorna um valor retornado padrão, incluindo o seguinte:

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	O monitor especificado pelo hMonitor não dá suporte ao encaixe.

Comentários

Quando usar

Uma janela de acessibilidade encaixada é limitada na quantidade de espaço que pode ser usada em qualquer tela. Portanto, antes de tentar encaixar uma janela de acessibilidade, chame essa função para obter as dimensões disponíveis. Não é possível encaixar nenhuma janela que faça com que um aplicativo da Windows Store tenha acesso a menos de 768 pixels de tela verticais.

Exemplos

Este exemplo mostra esse método em uso.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl.h

Confira também

IAccessibilityDockingService