Compartir a través de

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

  • Artículo

Recupera las dimensiones disponibles en una pantalla específica para mostrar una ventana de accesibilidad.

Sintaxis

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

Parámetros

[in] hMonitor

Tipo: HMONITOR

Identificador del monitor cuyo tamaño de acoplamiento disponible se va a recuperar. Para obtener información sobre cómo recuperar un HMONITOR, vea MonitorFromWindow.

[out] pcxFixed

Tipo: UINT*

Cuando este método devuelve correctamente, este parámetro recibe el ancho fijo, en píxeles físicos, disponible para acoplarse en el monitor especificado. Cualquier ventana acoplada a este monitor se ajustará a este ancho.

Si se produce un error en el método, este valor se establece en 0.

Si este valor es NULL, se producirá una infracción de acceso.

[out] pcyMax

Tipo: UINT*

Cuando este método se devuelve correctamente, este parámetro recibe el alto máximo, en píxeles físicos, disponible para una ventana acoplada en el monitor especificado.

Si se produce un error en el método, este valor se establece en 0.

Si este valor es NULL, se producirá una infracción de acceso.

Valor devuelto

Tipo: HRESULT

Devuelve un valor devuelto estándar, incluido lo siguiente:

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)
 El monitor especificado por hMonitor no admite el acoplamiento.

Comentarios

Cuándo usar

Una ventana de accesibilidad acoplada está limitada en la cantidad de espacio que puede usar en cualquier pantalla. Por lo tanto, antes de intentar acoplar una ventana de accesibilidad, llame a esta función para obtener las dimensiones disponibles. No puedes acoplar ninguna ventana que haga que una aplicación de la Tienda Windows tenga acceso a menos de 768 píxeles de pantalla verticales.

Ejemplos

En este ejemplo se muestra este método en 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 Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl.h

Consulte también

IAccessibilityDockingService