Metode IAccessibilityDockingService::GetAvailableSize

Artikel
06/12/2023

Mendapatkan dimensi yang tersedia untuk menambatkan jendela aksesibilitas pada monitor.

Sintaks

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

Parameter

hMonitor [in]

Menentukan monitor yang ukuran docking yang tersedia akan diambil.

puMaxHeight [out]

Jika berhasil, atur ke tinggi maksimum yang tersedia untuk docking pada hMonitor yang ditentukan, dalam piksel.

Jika gagal, atur ke nol.

puFixedWidth [out]

Jika berhasil, atur ke lebar tetap yang tersedia untuk docking pada hMonitor yang ditentukan, dalam piksel. Jendela apa pun yang ditambatkan ke hMonitor ini akan berukuran sesuai lebar ini.

Jika gagal, atur ke nol.

Mengembalikan nilai

Menampilkan kode	Deskripsi
S_OK	Berhasil.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	Monitor yang ditentukan oleh handel monitor tidak mendukung docking.

Jika puMaxHeight atau puFixedWidth null, pelanggaran akses akan terjadi.

Keterangan

Jendela aksesibilitas hanya dapat ditampung ke monitor yang memiliki setidaknya 768 piksel layar vertikal. API ini tidak akan memungkinkan jendela tersebut ditampung dengan tinggi yang akan menyebabkan aplikasi Windows Store memiliki kurang dari 768 piksel layar vertikal.

Contoh

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

Lihat juga

IAccessibilityDockingService

Bagikan melalui