Metode IAccessibilityDockingService::GetAvailableSize (shobjidl.h)

Artikel
03/15/2023

Mengambil dimensi yang tersedia pada layar tertentu untuk menampilkan jendela aksesibilitas.

Sintaks

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

Parameter

[in] hMonitor

Jenis: HMONITOR

Handel monitor yang ukuran docking yang tersedia akan diambil. Untuk informasi tentang cara mengambil HMONITOR, lihat MonitorFromWindow.

[out] pcxFixed

Jenis: UINT*

Ketika metode ini berhasil dikembalikan, parameter ini menerima lebar tetap, dalam piksel fisik, tersedia untuk docking pada monitor yang ditentukan. Jendela apa pun yang ditampung ke monitor ini akan berukuran sesuai lebar ini.

Jika metode gagal, nilai ini diatur ke 0.

Jika nilai ini NULL, pelanggaran akses akan terjadi.

[out] pcyMax

Jenis: UINT*

Ketika metode ini berhasil dikembalikan, parameter ini menerima tinggi maksimum, dalam piksel fisik, tersedia untuk jendela yang ditampung pada monitor yang ditentukan.

Jika metode gagal, nilai ini diatur ke 0.

Jika nilai ini NULL, pelanggaran akses akan terjadi.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan nilai pengembalian standar, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	Monitor yang ditentukan oleh hMonitor tidak mendukung docking.

Keterangan

Kapan harus digunakan

Jendela aksesibilitas yang ditampung terbatas dalam jumlah ruang yang dapat digunakannya di layar apa pun. Oleh karena itu, sebelum mencoba merapat ke jendela aksesibilitas, panggil fungsi ini untuk mendapatkan dimensi yang tersedia. Anda tidak dapat menambatkan jendela apa pun yang akan menyebabkan aplikasi Windows Store memiliki akses ke kurang dari 768 piksel layar vertikal.

Contoh

Contoh ini menunjukkan metode ini yang digunakan.


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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl.h

Lihat juga

IAccessibilityDockingService

Bagikan melalui