Metode IOleInPlaceFrame::SetStatusText (oleidl.h)

Artikel
08/25/2023

Mengatur dan menampilkan teks status tentang objek di tempat di baris status jendela bingkai kontainer.

Sintaks

HRESULT SetStatusText(
  [in] LPCOLESTR pszStatusText
);

Parameter

[in] pszStatusText

Pesan yang akan ditampilkan.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_TRUNCATED	Beberapa teks ditampilkan tetapi pesan terlalu panjang dan terpotok.
E_FAIL	Operasi gagal.
E_INVALIDARG	Penunjuk yang ditentukan tidak valid.
E_UNEXPECTED	Terjadi kesalahan tak terduga.

Keterangan

Catatan untuk Penelepon

Anda harus memanggil IOleInPlaceFrame::SetStatusText ketika Anda perlu meminta kontainer untuk menampilkan teks objek di baris status bingkainya, jika memilikinya. Karena jendela bingkai kontainer memiliki baris status, memanggil IOleInPlaceFrame::SetStatusText adalah satu-satunya cara objek dapat menampilkan informasi status di jendela bingkai kontainer. Namun, jika kontainer menolak permintaan objek, aplikasi objek dapat menegosiasikan ruang batas untuk menampilkan jendela statusnya sendiri.

Saat beralih antara menu yang dimiliki oleh kontainer dan objek aktif di tempat, teks bilah status tidak tercermin dengan benar jika objek tidak memanggil metode IOleInPlaceFrame::SetStatusText kontainer. Misalnya, jika, selama sesi di tempat, pengguna harus memilih menu File , bilah status akan mencerminkan tindakan yang akan terjadi jika pengguna memilih menu ini. Jika pengguna kemudian memilih menu Edit (yang dimiliki oleh objek di tempat), teks bilah status tidak akan berubah kecuali IOleInPlaceFrame::SetStatusText kebetulan dipanggil. Ini karena tidak ada cara bagi kontainer untuk mengenali bahwa salah satu menu objek telah dibuat aktif karena semua pesan yang akan dijebak kontainer sekarang masuk ke objek .

Catatan untuk Pelaksana

Untuk menghindari potensi masalah, semua objek yang diaktifkan harus memproses pesan WM_MENUSELECT dan memanggil IOleInPlaceFrame::SetStatusText, bahkan jika objek biasanya tidak memberikan informasi status (dalam hal ini objek hanya dapat meneruskan string NULL untuk teks status yang diminta).

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

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