Metode IOleInPlaceUIWindow::RequestBorderSpace (oleidl.h)

Artikel
08/25/2023

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
INPLACE_E_NOTOOLSPACE	Objek tidak dapat menginstal bilah alat di objek jendela ini karena implementasi tidak mendukung bilah alat, atau ruang tidak cukup untuk menginstal bilah alat.
E_UNEXPECTED	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-&gt;top    = 10 
lpbw-&gt;bottom =  0 
lpbw-&gt;lLeft  =  5 
lpbw-&gt;right  =  5

Catatan Saat menjalankan IOleInPlaceUIWindow::RequestBorderSpace, jangan melakukan panggilan ke fungsi PeekMessage atau GetMessage , atau kotak dialog. Melakukannya dapat menyebabkan kebuntuan sistem. Ada batasan lebih lanjut tentang metode dan fungsi antarmuka OLE mana yang dapat dipanggil dari dalam IOleInPlaceUIWindow::RequestBorderSpace.

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