Enumerasi OLEMISC (oleidl.h)

  • Artikel

Menjelaskan karakteristik lain-lain dari objek atau kelas objek. Kontainer dapat memanggil metode IOleObject::GetMiscStatus untuk menentukan bit OLEMISC yang diatur untuk objek. Nilai yang ditentukan dalam entri CLSID\MiscStatus server objek dalam database pendaftaran didasarkan pada enumerasi OLEMISC . Konstanta ini juga digunakan dalam anggota dwStatus dari struktur OBJECTDESCRIPTOR .

Sintaks

typedef enum tagOLEMISC {
  OLEMISC_RECOMPOSEONRESIZE = 0x1,
  OLEMISC_ONLYICONIC = 0x2,
  OLEMISC_INSERTNOTREPLACE = 0x4,
  OLEMISC_STATIC = 0x8,
  OLEMISC_CANTLINKINSIDE = 0x10,
  OLEMISC_CANLINKBYOLE1 = 0x20,
  OLEMISC_ISLINKOBJECT = 0x40,
  OLEMISC_INSIDEOUT = 0x80,
  OLEMISC_ACTIVATEWHENVISIBLE = 0x100,
  OLEMISC_RENDERINGISDEVICEINDEPENDENT = 0x200,
  OLEMISC_INVISIBLEATRUNTIME = 0x400,
  OLEMISC_ALWAYSRUN = 0x800,
  OLEMISC_ACTSLIKEBUTTON = 0x1000,
  OLEMISC_ACTSLIKELABEL = 0x2000,
  OLEMISC_NOUIACTIVATE = 0x4000,
  OLEMISC_ALIGNABLE = 0x8000,
  OLEMISC_SIMPLEFRAME = 0x10000,
  OLEMISC_SETCLIENTSITEFIRST = 0x20000,
  OLEMISC_IMEMODE = 0x40000,
  OLEMISC_IGNOREACTIVATEWHENVISIBLE = 0x80000,
  OLEMISC_WANTSTOMENUMERGE = 0x100000,
  OLEMISC_SUPPORTSMULTILEVELUNDO = 0x200000
} OLEMISC;

Konstanta

 
OLEMISC_RECOMPOSEONRESIZE
Nilai: 0x1
Saat kontainer mengubah ukuran ruang yang dialokasikan untuk menampilkan salah satu presentasi objek, objek ingin mengolah ulang presentasi. Ini berarti bahwa pada mengubah ukuran, objek ingin melakukan lebih dari skala gambarnya. Jika bit ini diatur, kontainer harus memaksa objek ke status berjalan dan memanggil IOleObject::SetExtent dengan ukuran baru.
OLEMISC_ONLYICONIC
Nilai: 0x2
Objek tidak memiliki tampilan isi yang berguna selain ikonnya. Dari perspektif pengguna, kotak centang Tampilkan Sebagai Ikon (dalam kotak dialog Tempel Spesial ) untuk objek ini harus selalu dicentang, dan tidak boleh dicentang. Perhatikan bahwa objek seperti itu masih harus memiliki aspek konten yang dapat digambar; tampilannya akan terlihat sama dengan tampilan ikonnya.
OLEMISC_INSERTNOTREPLACE
Nilai: 0x4
Objek telah menginisialisasi dirinya sendiri dari data dalam pilihan kontainer saat ini. Kontainer harus memeriksa bit ini setelah memanggil IOleObject::InitFromData untuk menginisialisasi objek dari pilihan saat ini. Jika diatur, kontainer harus menyisipkan objek di samping pilihan saat ini daripada mengganti pilihan saat ini. Jika bit ini tidak disetel, objek yang sedang disisipkan menggantikan pilihan saat ini.
OLEMISC_STATIC
Nilai: 0x8
Objek ini adalah objek statis, yang merupakan objek yang hanya berisi presentasi; tidak berisi data asli. Lihat OleCreateStaticFromData.
OLEMISC_CANTLINKINSIDE
Nilai: 0x10
Objek ini tidak dapat menjadi sumber tautan yang ketika terikat untuk mengaktifkan (menjalankan) objek. Jika objek dipilih dan disalin ke clipboard, kontainer objek dapat menawarkan tautan dalam transfer data clipboard yang, ketika terikat, harus terhubung ke bagian luar objek. Pengguna akan melihat objek yang dipilih dalam kontainernya, tidak terbuka untuk pengeditan. Daripada melakukan ini, kontainer hanya dapat menolak untuk menawarkan sumber tautan saat mentransfer objek dengan set bit ini. Contoh objek yang memiliki set bit ini termasuk objek OLE1, objek statis, dan tautan.
OLEMISC_CANLINKBYOLE1
Nilai: 0x20
Objek ini dapat ditautkan dengan kontainer OLE 1. Bit ini digunakan dalam anggota dwStatus dari struktur OBJECTDESCRIPTOR yang ditransfer dengan format Deskriptor Sumber Objek dan Tautan. Objek dapat ditautkan oleh kontainer OLE 1 jika merupakan dokumen tanpa judul, file, atau pilihan data dalam file. Objek yang disematkan atau objek pseudo yang terkandung dalam objek tertanam tidak dapat ditautkan oleh kontainer OLE 1 (yaitu, kontainer OLE 1 tidak dapat menautkan ke sumber tautan yang, ketika terikat, memerlukan lebih dari satu server objek untuk dijalankan.
OLEMISC_ISLINKOBJECT
Nilai: 0x40
Objek ini adalah objek tautan. Bit ini signifikan untuk OLE 1 dan diatur oleh objek tautan OLE 2; aplikasi objek tidak perlu mengatur bit ini.
OLEMISC_INSIDEOUT
Nilai: 0x80
Objek ini mampu mengaktifkan di tempat, tanpa memerlukan penginstalan menu dan bilah alat untuk dijalankan. Beberapa objek tersebut dapat aktif secara bersamaan. Beberapa kontainer, seperti formulir, dapat memilih untuk mengaktifkan objek tersebut secara otomatis.
OLEMISC_ACTIVATEWHENVISIBLE
Nilai: 0x100
Bit ini diatur hanya ketika OLEMISC_INSIDEOUT diatur, dan menunjukkan bahwa objek ini lebih suka diaktifkan setiap kali terlihat. Beberapa kontainer mungkin selalu mengabaikan petunjuk ini.
OLEMISC_RENDERINGISDEVICEINDEPENDENT
Nilai: 0x200
Objek ini tidak memperhatikan perangkat target. Data presentasinya akan sama dalam semua kasus.
OLEMISC_INVISIBLEATRUNTIME
Nilai: 0x400
Nilai ini digunakan dengan kontrol. Ini menunjukkan bahwa kontrol tidak memiliki antarmuka pengguna run-time, tetapi harus terlihat pada waktu desain. Misalnya, kontrol timer yang mengaktifkan peristiwa tertentu secara berkala tidak akan menampilkan dirinya pada durasi, tetapi memerlukan antarmuka pengguna waktu desain sehingga desainer formulir dapat mengatur periode peristiwa dan properti lainnya.
OLEMISC_ALWAYSRUN
Nilai: 0x800
Nilai ini digunakan dengan kontrol. Ini memberi tahu kontainer bahwa kontrol ini selalu ingin dijalankan. Akibatnya, kontainer harus memanggil OleRun saat memuat atau membuat objek.
OLEMISC_ACTSLIKEBUTTON
Nilai: 0x1000
Nilai ini digunakan dengan kontrol. Ini menunjukkan bahwa kontrol seperti tombol karena memahami dan mematuhi properti sekitar DisplayAsDefault kontainer.
OLEMISC_ACTSLIKELABEL
Nilai: 0x2000
Nilai ini digunakan dengan kontrol. Ini menandai kontrol sebagai label untuk kontrol apa pun yang datang setelah itu dalam urutan formulir. Menekan tombol mnemonik untuk kontrol label mengaktifkan kontrol setelahnya.
OLEMISC_NOUIACTIVATE
Nilai: 0x4000
Nilai ini digunakan dengan kontrol. Ini menunjukkan bahwa kontrol tidak memiliki status aktif UI, yang berarti tidak memerlukan alat di tempat, tidak ada menu bersama, dan tidak ada akselerator. Ini juga berarti bahwa kontrol tidak pernah membutuhkan fokus.
OLEMISC_ALIGNABLE
Nilai: 0x8000
Nilai ini digunakan dengan kontrol. Ini menunjukkan bahwa kontrol memahami cara menyelaraskan dirinya dalam persegi panjang tampilannya, sesuai dengan properti perataan seperti kiri, tengah, dan kanan.
OLEMISC_SIMPLEFRAME
Nilai: 0x10000
Nilai ini digunakan dengan kontrol. Ini menunjukkan bahwa kontrol adalah pengelompokan sederhana kontrol lain dan melakukan sedikit lebih dari meneruskan pesan Windows ke kontainer kontrol yang mengelola formulir. Kontrol semacam ini memerlukan implementasi ISimpleFrameSite di situs kontainer.
OLEMISC_SETCLIENTSITEFIRST
Nilai: 0x20000
Nilai ini digunakan dengan kontrol. Ini menunjukkan bahwa kontrol ingin menggunakan IOleObject::SetClientSite sebagai fungsi inisialisasinya, bahkan sebelum panggilan seperti IPersistStreamInit::InitNew atau IPersistStorage::InitNew. Ini memungkinkan kontrol untuk mengakses properti sekitar kontainer sebelum memuat informasi dari penyimpanan persisten. Perhatikan bahwa implementasi OleCreate, OleCreateFromData, OleCreateFromFile, OleLoad saat ini, dan handler default tidak memahami nilai ini. Kontainer kontrol yang ingin menghormati nilai ini saat ini harus menerapkan versi fungsi-fungsi ini sendiri untuk menetapkan urutan inisialisasi yang benar untuk kontrol.
OLEMISC_IMEMODE
Nilai: 0x40000
Kedaluwarsa. Kontrol yang berfungsi dengan komponen sistem Input Method Editor (IME) dapat mengontrol status IME melalui properti IMEMode daripada menggunakan nilai ini dalam enumerasi OLEMISC. Anda dapat menggunakan komponen IME untuk memasukkan informasi dalam kumpulan karakter Asia dengan keyboard biasa. IME Jepang, misalnya, memungkinkan Anda mengetik kata seperti "sushi," pada keyboard biasa dan ketika Anda menekan bilah spasi, komponen IME mengonversi kata itu ke kanji yang sesuai atau mengusulkan pilihan yang mungkin. Nilai OLEMISC_IMEMODE sebelumnya digunakan untuk menandai kontrol sebagai mampu mengontrol komponen sistem mode IME.
OLEMISC_IGNOREACTIVATEWHENVISIBLE
Nilai: 0x80000
Agar kontrol ActiveX baru berfungsi dalam kontainer yang lebih lama, kontrol mungkin harus memiliki kumpulan nilai OLEMISC_ACTIVATEWHENVISIBLE. Namun, dalam kontainer yang lebih baru yang memahami dan menggunakan IPointerInactive, kontrol tidak ingin diaktifkan di tempat ketika menjadi terlihat. Untuk memungkinkan kontrol berfungsi di kedua jenis kontainer, kontrol dapat mengatur nilai ini. Kemudian, kontainer mengabaikan OLEMISC_ACTIVATEWHENVISIBLE dan tidak mengaktifkan kontrol di tempat saat terlihat.
OLEMISC_WANTSTOMENUMERGE
Nilai: 0x100000
Kontrol yang dapat menggabungkan menunya dengan kontainernya mengatur nilai ini.
OLEMISC_SUPPORTSMULTILEVELUNDO
Nilai: 0x200000
Kontrol yang mendukung urungkan multi-tingkat menetapkan nilai ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header oleidl.h

Lihat juga

IOleObject::GetMiscStatus

OBJECTDESCRIPTOR