Compartir a través de

Método IAccessibilityDockingService::GetAvailableSize

  • Artículo

Obtiene las dimensiones disponibles para acoplar una ventana de accesibilidad en un monitor.

Sintaxis

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

Parámetros

hMonitor [in]

Especifica el monitor para el que se recuperará el tamaño de acoplamiento disponible.

puMaxHeight [out]

Si se ejecuta correctamente, establezca en el alto máximo disponible para acoplarse en el hMonitor especificado, en píxeles.

En caso de error, establezca en cero.

puFixedWidth [out]

Si se ejecuta correctamente, establezca en el ancho fijo disponible para acoplarse en el hMonitor especificado, en píxeles. Cualquier ventana acoplada a este hMonitor se ajustará a este ancho.

En caso de error, establezca en cero.

Valor devuelto

Código devuelto Descripción
S_OK
 Correcto.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)
 El monitor especificado por el identificador de monitor no admite el acoplamiento.

Si puMaxHeight o puFixedWidth son null, se producirá una infracción de acceso.

Comentarios

Las ventanas de accesibilidad solo se pueden acoplar a un monitor que tenga al menos 768 píxeles de pantalla vertical. Esta API no permitirá acoplar estas ventanas con un alto que haría que las aplicaciones de la Tienda Windows tengan menos de 768 píxeles de pantalla verticales.

Ejemplos

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

Vea también

IAccessibilityDockingService