Metodo IAccessibilityDockingService::GetAvailableSize (shobjidl.h)

Articolo
03/13/2024

Recupera le dimensioni disponibili in una schermata specifica per la visualizzazione di una finestra di accessibilità.

Sintassi

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

Parametri

[in] hMonitor

Tipo: HMONITOR

Handle del monitor la cui dimensione di ancoraggio disponibile deve essere recuperata. Per informazioni su come recuperare un HMONITOR, vedere MonitorFromWindow.

[out] pcxFixed

Tipo: UINT*

Quando questo metodo viene restituito correttamente, questo parametro riceve la larghezza fissa, in pixel fisici, disponibile per l'ancoraggio sul monitor specificato. Qualsiasi finestra ancorata a questo monitor verrà ridimensionata in base a questa larghezza.

Se il metodo ha esito negativo, questo valore viene impostato su 0.

Se questo valore è NULL, si verificherà una violazione di accesso.

[out] pcyMax

Tipo: UINT*

Quando questo metodo viene restituito correttamente, questo parametro riceve l'altezza massima, in pixel fisici, disponibile per una finestra ancorata sul monitor specificato.

Se il metodo ha esito negativo, questo valore viene impostato su 0.

Se questo valore è NULL, si verificherà una violazione di accesso.

Valore restituito

Tipo: HRESULT

Restituisce un valore restituito standard, incluso quanto segue:

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	Il monitor specificato da hMonitor non supporta l'ancoraggio.

Commenti

Quando usare

Una finestra di accessibilità ancorata è limitata nella quantità di spazio che può essere usata su qualsiasi schermo. Pertanto, prima di tentare di ancorare una finestra di accessibilità, chiamare questa funzione per ottenere le dimensioni disponibili. Non è possibile ancorare alcuna finestra che provocherebbe l'accesso a un'app di Windows Store inferiore a 768 pixel dello schermo verticale.

Esempio

In questo esempio viene illustrato questo metodo in 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);
     }
 }

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl.h

Vedi anche

IAccessibilityDockingService

Condividi tramite