Fungsi OleCreatePropertyFrameIndirect (olectl.h)

  • Artikel

Membuat bingkai properti, yaitu, kotak dialog lembar properti, berdasarkan struktur (OCPFIPARAMS) yang berisi parameter, daripada menentukan parameter terpisah seperti saat memanggil OleCreatePropertyFrame.

Sintaks

WINOLECTLAPI OleCreatePropertyFrameIndirect(
  [in] LPOCPFIPARAMS lpParams
);

Parameter

[in] lpParams

Penunjuk ke struktur yang dialokasikan pemanggil yang berisi parameter pembuatan untuk kotak dialog.

Nilai kembali

Fungsi ini mendukung nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_UNEXPECTED, serta yang berikut ini:

Menampilkan kode Deskripsi
S_OK
 Kotak dialog dipanggil dan berhasil dioperasikan.
E_POINTER
 Alamat di lpParams tidak valid. Misalnya, mungkin NULL.

Keterangan

Selain cbStructSize (ukuran struktur) dan dispIDInitialProperty, semua anggota struktur OCPFIPARAMS memiliki semantik yang sama dengan parameter untuk OleCreatePropertyFrame. Ketika dispIDInitialProperty DISPID_UNKNOWN, perilaku kedua fungsi identik.

Bekerja bersama dengan IPerPropertyBrowsing dan IPropertyPage2, dispIDInitialProperty memungkinkan pemanggil untuk menentukan properti tunggal mana yang harus disorot saat kotak dialog dibuat terlihat. Fitur ini tidak tersedia saat menggunakan OleCreatePropertyFrame. Untuk menentukan halaman dan properti yang akan ditampilkan pada awalnya, bingkai properti akan melakukan hal berikut:

  1. Panggil (*ppUnk)->QueryInterface(IID_IPerPropertyBrowsing, ...) untuk mendapatkan penunjuk antarmuka ke objek pertama.
  2. Panggil IPerPropertyBrowsing::MapPropertyToPage(dispIDInitialProperty, ...) untuk menentukan halaman mana YANG CLSID berisi properti yang akan disorot. Semua objek yang bingkai ini sedang dipanggil harus mendukung kumpulan properti yang ditampilkan dalam bingkai.
  3. Saat kotak dialog dibuat, halaman properti dengan CLSID yang diambil di Langkah 2 diaktifkan dengan IPropertyPage::Activate.
  4. Bingkai properti meminta halaman aktif untuk IPropertyPage2.
  5. Jika berhasil, bingkai memanggil IPropertyPage2::EditProperty(dispIDInitialProperty) untuk menyoroti bidang yang benar dalam kotak dialog tersebut.

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 olectl.h
Pustaka OleAut32.lib
DLL OleAut32.dll

Lihat juga

OCPFIPARAMS

OleCreatePropertyFrame