Bagikan melalui

Kelas COleInsertDialog

  • Artikel

Digunakan untuk kotak dialog Sisipkan Objek OLE.

Sintaks

class COleInsertDialog : public COleDialog

Anggota

Konstruktor Publik

Nama Deskripsi
COleInsertDialog::COleInsertDialog Membuat COleInsertDialog objek.

Metode Publik

Nama Deskripsi
COleInsertDialog::CreateItem Membuat item yang dipilih dalam kotak dialog.
COleInsertDialog::D oModal Menampilkan kotak dialog Sisipkan Objek OLE.
COleInsertDialog::GetClassID Mendapatkan CLSID yang terkait dengan item yang dipilih.
COleInsertDialog::GetDrawAspect Memberi tahu apakah akan menggambar item sebagai ikon.
COleInsertDialog::GetIconicMetafile Mendapatkan handel ke metafile yang terkait dengan bentuk ikonik item ini.
COleInsertDialog::GetPathName Mendapatkan jalur lengkap ke file yang dipilih dalam kotak dialog.
COleInsertDialog::GetSelectionType Mendapatkan tipe objek yang dipilih.

Anggota Data Publik

Nama Deskripsi
COleInsertDialog::m_io Struktur jenis OLEUIINSERTOBJECT yang mengontrol perilaku kotak dialog.

Keterangan

Buat objek kelas COleInsertDialog saat Anda ingin memanggil kotak dialog ini. COleInsertDialog Setelah objek dibuat, Anda dapat menggunakan struktur m_io untuk menginisialisasi nilai atau status kontrol dalam kotak dialog. Strukturnya m_io berjenis OLEUIINSERTOBJECT. Untuk informasi selengkapnya tentang menggunakan kelas dialog ini, lihat fungsi anggota DoModal .

Catatan

Kode kontainer yang dihasilkan Application Wizard menggunakan kelas ini.

Untuk informasi selengkapnya, lihat struktur OLEUIINSERTOBJECT di Windows SDK.

Untuk informasi selengkapnya tentang kotak dialog khusus OLE, lihat artikel Kotak Dialog di OLE.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleInsertDialog

Persyaratan

Header: afxodlgs.h

COleInsertDialog::COleInsertDialog

Fungsi ini hanya COleInsertDialog membuat objek.

COleInsertDialog (
    DWORD dwFlags = IOF_SELECTCREATENEW,
    CWnd* pParentWnd = NULL);

Parameter

dwFlags
Bendera pembuatan yang berisi sejumlah nilai berikut yang akan digabungkan menggunakan operator bitwise-OR:

  • IOF_SHOWHELP Menentukan bahwa tombol Bantuan akan ditampilkan saat kotak dialog dipanggil.

  • IOF_SELECTCREATENEW Menentukan bahwa tombol radio Buat Baru akan dipilih awalnya saat kotak dialog dipanggil. Ini adalah default dan tidak dapat digunakan dengan IOF_SELECTCREATEFROMFILE.

  • IOF_SELECTCREATEFROMFILE Menentukan bahwa tombol radio Buat Dari File akan dipilih awalnya saat kotak dialog dipanggil. Tidak dapat digunakan dengan IOF_SELECTCREATENEW.

  • IOF_CHECKLINK Menentukan bahwa kotak centang Tautan akan dicentang awalnya saat kotak dialog dipanggil.

  • IOF_DISABLELINK Menentukan bahwa kotak centang Tautan akan dinonaktifkan saat kotak dialog dipanggil.

  • IOF_CHECKDISPLAYASICON Menentukan bahwa kotak centang Tampilkan Sebagai Ikon akan dicentang awalnya, ikon saat ini akan ditampilkan, dan tombol Ubah Ikon akan diaktifkan saat kotak dialog dipanggil.

  • IOF_VERIFYSERVERSEXIST Menentukan bahwa kotak dialog harus memvalidasi kelas yang ditambahkannya ke kotak daftar dengan memastikan bahwa server yang ditentukan dalam database pendaftaran ada sebelum kotak dialog ditampilkan. Mengatur bendera ini dapat secara signifikan mengganggu performa.

pParentWnd
Arahkan ke objek jendela induk atau pemilik (jenis CWnd) tempat objek dialog berada. Jika NULL, jendela induk objek dialog diatur ke jendela aplikasi utama.

Keterangan

Untuk menampilkan kotak dialog, panggil fungsi DoModal .

COleInsertDialog::CreateItem

Panggil fungsi ini untuk membuat objek jenis COleClientItem hanya jika DoModal mengembalikan IDOK.

BOOL CreateItem(COleClientItem* pItem);

Parameter

pItem
Menunjuk ke item yang akan dibuat.

Tampilkan Nilai

Bukan nol jika item dibuat; jika tidak, 0.

Keterangan

Anda harus mengalokasikan COleClientItem objek sebelum dapat memanggil fungsi ini.

COleInsertDialog::D oModal

Panggil fungsi ini untuk menampilkan kotak dialog Sisipkan Objek OLE.

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Parameter

dwFlags
Salah satu dari nilai berikut:

COleInsertDialog::DocObjectsOnly menyisipkan hanya DocObjects.

COleInsertDialog::ControlsOnly menyisipkan hanya kontrol ActiveX.

Nol menyisipkan docObject atau kontrol ActiveX. Nilai ini menghasilkan implementasi yang sama dengan prototipe pertama yang tercantum di atas.

Tampilkan Nilai

Status penyelesaian untuk kotak dialog. Salah satu dari nilai berikut:

  • IDOK jika kotak dialog berhasil ditampilkan.

  • IDCANCEL jika pengguna membatalkan kotak dialog.

  • IDABORT jika terjadi kesalahan. Jika IDABORT dikembalikan, panggil fungsi anggota COleDialog::GetLastError untuk mendapatkan informasi selengkapnya tentang jenis kesalahan yang terjadi. Untuk daftar kemungkinan kesalahan, lihat fungsi OleUIInsertObject di Windows SDK.

Keterangan

Jika Anda ingin menginisialisasi berbagai kontrol kotak dialog dengan mengatur anggota struktur m_io , Anda harus melakukan ini sebelum memanggil DoModal, tetapi setelah objek dialog dibangun.

Jika DoModal mengembalikan IDOK, Anda dapat memanggil fungsi anggota lain untuk mengambil pengaturan atau input informasi ke dalam kotak dialog oleh pengguna.

COleInsertDialog::GetClassID

Panggil fungsi ini untuk mendapatkan CLSID yang terkait dengan item yang dipilih hanya jika DoModal mengembalikan IDOK dan jenis pilihannya adalah COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Tampilkan Nilai

Mengembalikan CLSID yang terkait dengan item yang dipilih.

Keterangan

Untuk informasi selengkapnya, lihat Kunci CLSID di Windows SDK.

COleInsertDialog::GetDrawAspect

Panggil fungsi ini untuk menentukan apakah pengguna memilih untuk menampilkan item yang dipilih sebagai ikon.

DVASPECT GetDrawAspect() const;

Tampilkan Nilai

Metode yang diperlukan untuk merender objek.

  • DVASPECT_CONTENT Dikembalikan jika kotak centang Tampilkan Sebagai Ikon tidak dicentang.

  • DVASPECT_ICON Dikembalikan jika kotak centang Tampilkan Sebagai Ikon dicentang.

Keterangan

Panggil fungsi ini hanya jika DoModal mengembalikan IDOK.

Untuk informasi selengkapnya tentang aspek menggambar, lihat struktur data FORMATETC di Windows SDK.

COleInsertDialog::GetIconicMetafile

Panggil fungsi ini untuk mendapatkan handel ke metafile yang berisi aspek ikonik dari item yang dipilih.

HGLOBAL GetIconicMetafile() const;

Tampilkan Nilai

Handel ke metafile yang berisi aspek ikonik dari item yang dipilih, jika kotak centang Tampilkan Sebagai Ikon dicentang saat dialog dihentikan dengan memilih OK; jika tidak, NULL.

COleInsertDialog::GetPathName

Panggil fungsi ini untuk mendapatkan jalur lengkap file yang dipilih hanya jika DoModal mengembalikan IDOK dan jenis pilihannya bukan COleInsertDialog::createNewItem.

CString GetPathName() const;

Tampilkan Nilai

Jalur lengkap ke file yang dipilih dalam kotak dialog. Jika jenis pilihan adalah createNewItem, fungsi ini mengembalikan tidak CString berarti dalam mode rilis atau menyebabkan pernyataan dalam mode debug.

COleInsertDialog::GetSelectionType

Panggil fungsi ini untuk mendapatkan tipe pilihan yang dipilih ketika kotak dialog Sisipkan Objek diberhentikan dengan memilih OK.

UINT GetSelectionType() const;

Tampilkan Nilai

Jenis pilihan yang dibuat.

Keterangan

Nilai jenis pengembalian ditentukan oleh Selection jenis enumerasi yang dideklarasikan dalam COleInsertDialog kelas.

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

Deskripsi singkat tentang nilai-nilai ini mengikuti:

  • COleInsertDialog::createNewItem Tombol radio Buat Baru dipilih.

  • COleInsertDialog::insertFromFile Tombol radio Buat Dari File dipilih dan kotak centang Tautan tidak dicentang.

  • COleInsertDialog::linkToFile Tombol radio Buat Dari File dipilih dan kotak centang Tautan dicentang.

COleInsertDialog::m_io

Struktur tipe OLEUIINSERTOBJECT yang digunakan untuk mengontrol perilaku kotak dialog Sisipkan Objek.

OLEUIINSERTOBJECT m_io;

Keterangan

Anggota struktur ini dapat dimodifikasi baik secara langsung atau melalui fungsi anggota.

Untuk informasi selengkapnya, lihat struktur OLEUIINSERTOBJECT di Windows SDK.

Baca juga

Sampel MFC OCLIENT
Kelas COleDialog
Bagan Hierarki
Kelas COleDialog