Metode IOleInPlaceUIWindow::SetBorderSpace (oleidl.h)

Artikel
03/01/2024

Mengalokasikan ruang untuk batas yang diminta dalam panggilan ke IOleInPlaceUIWindow::RequestBorderSpace.

Sintaks

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

Parameter

[in] pborderwidths

Penunjuk ke struktur BORDERWIDTHS yang berisi lebar alat yang diminta, dalam piksel. Ini bisa NULL, menunjukkan objek tidak memerlukan ruang apa pun.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
OLE_E_INVALIDRECT	Persegi panjang tidak terletak dalam spesifikasi yang dikembalikan oleh IOleInPlaceUIWindow::GetBorder.

Keterangan

Objek harus memanggil IOleInPlaceUIWindow::SetBorderSpace. Ini dapat melakukan salah satu hal berikut:

Gunakan bilah alatnya sendiri, meminta ruang batas dengan ukuran tertentu.
Gunakan tidak ada toolbar, tetapi paksa kontainer untuk menghapus toolbar-nya dengan melewati struktur BORDERWIDTHS yang valid yang tidak berisi apa pun selain nol dalam parameter pborderwidths .
Gunakan tidak ada toolbar tetapi izinkan kontainer di tempat untuk membiarkan toolbar-nya naik dengan meneruskan NULL sebagai parameter pborderwidths .

Struktur BORDERWIDTHS yang digunakan dalam panggilan ini umumnya akan diteruskan dalam panggilan sebelumnya ke IOleInPlaceUIWindow::RequestBorderSpace, yang harus mengembalikan S_OK.

Jika objek harus menegosiasikan ulang ruang di batas, objek dapat memanggil IOleInPlaceUIWindow::SetBorderSpace lagi dengan lebar baru. Jika panggilan ke IOleInPlaceUIWindow::SetBorderSpace gagal, objek dapat melakukan negosiasi penuh untuk ruang batas dengan panggilan ke IOleInPlaceUIWindow::GetBorder, IOleInPlaceUIWindow::RequestBorderSpace, dan IOleInPlaceUIWindow::SetBorderSpace.

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

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

Lihat juga

IOleInPlaceUIWindow

IOleInPlaceUIWindow::GetBorder

IOleInPlaceUIWindow::RequestBorderSpace

Bagikan melalui