Struktur OLEUICONVERTA (oledlg.h)

Artikel
03/01/2024

Berisi informasi yang digunakan Pustaka Antarmuka Pengguna OLE untuk menginisialisasi kotak dialog Konversi , dan ruang bagi pustaka untuk mengembalikan informasi saat kotak dialog ditutup.

Sintaks

typedef struct tagOLEUICONVERTA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPSTR         lpszUserType;
  BOOL          fObjectsIconChanged;
  LPSTR         lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTA, *POLEUICONVERTA, *LPOLEUICONVERTA;

Anggota

cbStruct

Ukuran struktur, dalam byte. Anggota ini harus diisi pada input.

dwFlags

Pada input, bidang ini menentukan bendera inisialisasi dan pembuatan. Saat keluar, ini menentukan pilihan pengguna. Ini mungkin kombinasi dari bendera berikut.

Nilai	Makna
CF_SHOWHELPBUTTON	Kotak dialog akan menampilkan tombol Bantuan . Bendera ini diatur pada input.
CF_SETCONVERTDEFAULT	Kelas yang CLSID-nya ditentukan oleh clsidConvertDefault akan digunakan sebagai pilihan default. Pilihan ini muncul di kotak daftar kelas saat tombol radio Konversi Ke dipilih. Bendera ini diatur pada input.
CF_SETACTIVATEDEFAULT	Kelas yang CLSID-nya ditentukan oleh clsidActivateDefault akan digunakan sebagai pilihan default. Pilihan ini muncul di kotak daftar kelas saat tombol radio Aktifkan Sebagai dipilih. Bendera ini diatur pada input.
CF_SELECTCONVERTTO	Pada input, bendera ini menentukan bahwa Konversi Ke awalnya akan dipilih (perilaku default). Bendera ini diatur pada output jika Konversi Ke dipilih saat pengguna menutup kotak dialog.
CF_SELECTACTIVATEAS	Pada input, bendera ini menentukan bahwa Aktifkan Sebagai awalnya akan dipilih. Bendera ini diatur pada output jika Aktifkan Sebagai dipilih ketika pengguna menutup kotak dialog.
CF_DISABLEDISPLAYASICON	Tombol Tampilkan Sebagai Ikon akan dinonaktifkan pada inisialisasi.
CF_DISABLEACTIVATEAS	Tombol radio Aktifkan Sebagai akan dinonaktifkan pada inisialisasi.
CF_HIDECHANGEICON	Tombol Ubah Ikon akan disembunyikan dalam kotak dialog Konversi .
CF_CONVERTONLY	Tombol radio Aktifkan Sebagai akan dinonaktifkan dalam kotak dialog Konversi .

hWndOwner

Jendela yang memiliki kotak dialog. Anggota ini tidak boleh NULL.

lpszCaption

Penunjuk ke string yang akan digunakan sebagai judul kotak dialog. Jika NULL, maka pustaka menggunakan Konversi.

lpfnHook

Penunjuk ke fungsi hook yang memproses pesan yang ditujukan untuk kotak dialog. Fungsi hook harus mengembalikan nol untuk meneruskan pesan bahwa tidak diproses kembali ke prosedur kotak dialog di pustaka. Fungsi hook harus mengembalikan nilai bukan nol untuk mencegah prosedur kotak dialog pustaka memproses pesan yang telah diproses.

lCustData

Data yang ditentukan aplikasi yang diteruskan pustaka ke fungsi hook yang diarahkan oleh anggota lpfnHook . Pustaka meneruskan penunjuk ke struktur OLEUICONVERT dalam parameter lParam dari pesan WM_INITDIALOG; pointer ini dapat digunakan untuk mengambil anggota lCustData .

hInstance

Instans yang berisi templat kotak dialog yang ditentukan oleh anggota lpszTemplate . Anggota ini diabaikan jika anggota lpszTemplateadalah NULL atau tidak valid.

lpszTemplate

Penunjuk ke string yang dihentikan null yang menentukan nama file sumber daya untuk templat kotak dialog yang akan diganti untuk templat kotak dialog Konversi pustaka.

hResource

Penanganan sumber daya untuk kotak dialog kustom. Jika anggota ini ADALAH NULL, maka pustaka menggunakan templat kotak dialog Konversi standar, atau jika valid, templat yang dinamai oleh anggota lpszTemplate .

clsid

CLSID objek yang akan dikonversi atau diaktifkan. Anggota ini diatur pada input.

clsidConvertDefault

CLSID yang digunakan sebagai kelas default saat Konversi Ke dipilih. Anggota ini diabaikan jika anggota dwFlags tidak menyertakan CF_SETCONVERTDEFAULT. Anggota ini diatur pada input.

clsidActivateDefault

CLSID yang digunakan sebagai kelas default saat Aktifkan Sebagai dipilih. Anggota ini diabaikan jika anggota dwFlags tidak menyertakan CF_SETACTIVATEDEFAULT. Anggota ini diatur pada input.

clsidNew

CLSID dari kelas yang dipilih. Anggota ini diatur pada output.

dvAspect

Aspek objek . Ini harus DVASPECT_CONTENT atau DVASPECT_ICON. Jika dvAspect DVASPECT_ICON pada input, maka kotak Tampilkan Sebagai Ikon dicentang dan ikon objek ditampilkan. Anggota ini diatur pada input dan output. Untuk informasi selengkapnya, lihat DVASPECT.

wFormat

Format data objek yang akan dikonversi atau diaktifkan.

fIsLinkedObject

TRUE jika objek ditautkan. Anggota ini diatur pada input.

hMetaPict

METAFILEPICT yang berisi aspek ikonik. Anggota ini diatur pada input dan output.

lpszUserType

Penunjuk ke nama Jenis Pengguna objek yang akan dikonversi atau diaktifkan. Jika nilai ini NULL, maka kotak dialog akan mengambil nama Jenis Pengguna dari registri. String ini dibebaskan saat keluar.

fObjectsIconChanged

TRUE jika ikon objek berubah. (artinya, jika OleUIChangeIcon dipanggil dan tidak dibatalkan.). Anggota ini diatur pada output.

lpszDefLabel

Arahkan ke label default yang akan digunakan untuk ikon. Jika NULL, nama jenis pengguna pendek akan digunakan. Jika objek adalah tautan, penelepon harus meneruskan nama tampilan sumber tautan. Ini dibebaskan saat keluar.

cClsidExclude

Jumlah CLSID dalam lpClsidExclude.

lpClsidExclude

Arahkan ke daftar CLSID untuk dikecualikan dari daftar.

Keterangan

Catatan

Header oledlg.h mendefinisikan OLEUICONVERT sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga

OleUIChangeIcon

OleUIConvert

Bagikan melalui