Metode IOleInPlaceUIWindow::RequestBorderSpace (oleidl.h)
Menentukan apakah ada ruang yang tersedia untuk alat yang akan diinstal di sekitar bingkai jendela objek saat objek aktif di tempatnya.
Sintaks
HRESULT RequestBorderSpace(
[in] LPCBORDERWIDTHS pborderwidths
);
Parameter
[in] pborderwidths
Penunjuk ke struktur BORDERWIDTHS yang berisi lebar yang diminta (dalam piksel) yang diperlukan di setiap sisi jendela untuk alat.
Nilai kembali
Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Objek tidak dapat menginstal bilah alat di objek jendela ini karena implementasi tidak mendukung bilah alat, atau ruang tidak cukup untuk menginstal bilah alat. |
|
Terjadi kesalahan tidak terduga. |
Keterangan
Catatan untuk Penelepon
Objek aktif di tempat memanggil IOleInPlaceUIWindow::RequestBorderSpace untuk menanyakan apakah alat dapat diinstal di dalam bingkai jendela. Alat-alat ini akan dialokasikan antara persegi panjang yang dikembalikan oleh IOleInPlaceUIWindow::GetBorder dan struktur BORDERWIDTHS yang ditentukan dalam argumen untuk panggilan ini.Ruang untuk alat sebenarnya tidak dialokasikan ke objek sampai memanggil IOleInPlaceUIWindow::SetBorderSpace, memungkinkan objek untuk bernegosiasi untuk spasi (seperti saat menyeret toolbar), tetapi menunda pemindahan alat hingga tindakan selesai.
Objek dapat menginstal alat-alat ini dengan meneruskan lebar dalam piksel yang akan digunakan di setiap sisi. Misalnya, jika objek memerlukan 10 piksel di bagian atas, 0 piksel di bagian bawah, dan 5 piksel di sisi kiri dan kanan, objek akan meneruskan struktur BORDERWIDTHS berikut ke IOleInPlaceUIWindow::RequestBorderSpace:
lpbw->top = 10
lpbw->bottom = 0
lpbw->lLeft = 5
lpbw->right = 5
Catatan untuk Pelaksana
Jika jumlah ruang yang digunakan objek aktif untuk toolbarnya tidak relevan dengan kontainer, itu cukup mengembalikan NOERROR seperti yang ditunjukkan dalam contoh IOleInPlaceUIWindow::RequestBorderSpace berikut. Kontainer tidak boleh membatasi tampilan alat secara tidak sengaja oleh objek aktif di tempat.HRESULT InPlaceUIWindow_RequestBorderSpace(
IOleInPlaceFrame * lpThis,
LPCBORDERWIDTHS pborderwidths)
{
// Container allows the object to have as much border space as it
// wants.
return NOERROR;
}
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | oleidl.h |