Bagikan melalui

Kelas COleConvertDialog

  • Artikel

Untuk informasi selengkapnya, lihat struktur OLEUICONVERT di Windows SDK.

Sintaks

class COleConvertDialog : public COleDialog

Anggota

Konstruktor Publik

Nama Deskripsi
COleConvertDialog::COleConvertDialog Membuat COleConvertDialog objek.

Metode Publik

Nama Deskripsi
COleConvertDialog::D oConvert Melakukan konversi yang ditentukan dalam kotak dialog.
COleConvertDialog::D oModal Menampilkan kotak dialog OLE Ubah Item.
COleConvertDialog::GetClassID Mendapatkan CLSID yang terkait dengan item yang dipilih.
COleConvertDialog::GetDrawAspect Menentukan apakah akan menggambar item sebagai ikon.
COleConvertDialog::GetIconicMetafile Mendapatkan handel ke metafile yang terkait dengan bentuk ikonik item ini.
COleConvertDialog::GetSelectionType Mendapatkan jenis pilihan yang dipilih.

Anggota Data Publik

Nama Deskripsi
COleConvertDialog::m_cv Struktur yang mengontrol perilaku kotak dialog.

Keterangan

Catatan

Kode kontainer yang dihasilkan Application Wizard menggunakan kelas ini.

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

Hierarki Warisan

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleConvertDialog

Persyaratan

Header: afxodlgs.h

COleConvertDialog::COleConvertDialog

Membuat hanya COleConvertDialog objek.

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

Parameter

pItem
Menunjuk ke item yang akan dikonversi atau diaktifkan.

dwFlags
Bendera pembuatan, yang berisi sejumlah nilai berikut yang digabungkan menggunakan bitwise-atau operator:

  • CF_SELECTCONVERTTO Menentukan bahwa tombol radio Konversi Ke akan dipilih pada awalnya saat kotak dialog dipanggil. Ini adalah default.

  • CF_SELECTACTIVATEAS Menentukan bahwa tombol radio Aktifkan Sebagai akan dipilih awalnya saat kotak dialog dipanggil.

  • CF_SETCONVERTDEFAULT Menentukan bahwa kelas yang CLSID-nya ditentukan oleh clsidConvertDefault anggota m_cv struktur akan digunakan sebagai pilihan default dalam kotak daftar kelas saat tombol radio Konversi Ke dipilih.

  • CF_SETACTIVATEDEFAULT Menentukan bahwa kelas yang CLSID-nya ditentukan oleh clsidActivateDefault anggota m_cv struktur akan digunakan sebagai pilihan default dalam kotak daftar kelas saat tombol radio Aktifkan Sebagai dipilih.

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

pClassID
Arahkan ke CLSID item yang akan dikonversi atau diaktifkan. Jika NULL, CLSID yang terkait dengan pItem akan digunakan.

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

Keterangan

Untuk menampilkan kotak dialog, panggil fungsi DoModal .

Untuk informasi selengkapnya, lihat Kunci CLSID dan struktur OLEUICONVERT .

COleConvertDialog::D oConvert

Panggil fungsi ini, setelah berhasil kembali dari DoModal, baik untuk mengonversi atau mengaktifkan objek jenis COleClientItem.

BOOL DoConvert(COleClientItem* pItem);

Parameter

pItem
Menunjuk ke item yang akan dikonversi atau diaktifkan. Tidak boleh NULL.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Item dikonversi atau diaktifkan sesuai dengan informasi yang dipilih oleh pengguna dalam kotak dialog Konversi.

COleConvertDialog::D oModal

Panggil fungsi ini untuk menampilkan kotak dialog Konversi OLE.

virtual INT_PTR DoModal();

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 OleUIConvert di Windows SDK.

Keterangan

Jika Anda ingin menginisialisasi berbagai kontrol kotak dialog dengan mengatur anggota struktur m_cv , 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 informasi yang dimasukkan oleh pengguna ke dalam kotak dialog.

COleConvertDialog::GetClassID

Panggil fungsi ini untuk mendapatkan CLSID yang terkait dengan item yang dipilih pengguna dalam kotak dialog Konversi.

REFCLSID GetClassID() const;

Tampilkan Nilai

CLSID yang terkait dengan item yang dipilih dalam kotak dialog Konversi.

Keterangan

Panggil fungsi ini hanya setelah DoModal mengembalikan IDOK.

Untuk informasi selengkapnya, lihat Kunci CLSID di Windows SDK.

COleConvertDialog::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 setelah DoModal mengembalikan IDOK.

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

COleConvertDialog::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.

COleConvertDialog::GetSelectionType

Panggil fungsi ini untuk menentukan jenis konversi yang dipilih dalam kotak dialog Konversi.

UINT GetSelectionType() const;

Tampilkan Nilai

Jenis pilihan yang dibuat.

Keterangan

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

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Deskripsi singkat tentang nilai-nilai ini mengikuti:

  • COleConvertDialog::noConversion Dikembalikan jika kotak dialog dibatalkan atau pengguna tidak memilih konversi. Jika COleConvertDialog::DoModal IDOK yang dikembalikan, ada kemungkinan pengguna memilih ikon yang berbeda dari yang sebelumnya dipilih.

  • COleConvertDialog::convertItem Dikembalikan jika tombol radio Konversi Ke dicentang, pengguna memilih item lain untuk dikonversi, dan DoModal mengembalikan IDOK.

  • COleConvertDialog::activateAs Dikembalikan jika tombol radio Aktifkan Sebagai dicentang, pengguna memilih item lain untuk diaktifkan, dan DoModal mengembalikan IDOK.

COleConvertDialog::m_cv

Struktur tipe OLEUICONVERT yang digunakan untuk mengontrol perilaku kotak dialog Konversi.

OLEUICONVERT m_cv;

Keterangan

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

Untuk informasi selengkapnya, lihat struktur OLEUICONVERT di Windows SDK.

Lihat juga

Kelas COleDialog
Bagan Hierarki
Kelas COleDialog