Bagikan melalui

Kelas COleChangeIconDialog

  • Artikel

Digunakan untuk kotak dialog Ikon Perubahan OLE.

Sintaks

class COleChangeIconDialog : public COleDialog

Anggota

Konstruktor Publik

Nama Deskripsi
COleChangeIconDialog::COleChangeIconDialog Membuat COleChangeIconDialog objek.

Metode Publik

Nama Deskripsi
COleChangeIconDialog::D oChangeIcon Melakukan perubahan yang ditentukan dalam kotak dialog.
COleChangeIconDialog::D oModal Menampilkan kotak dialog Ubah Ikon OLE 2.
COleChangeIconDialog::GetIconicMetafile Mendapatkan handel ke metafile yang terkait dengan bentuk ikonik item ini.

Anggota Data Publik

Nama Deskripsi
COleChangeIconDialog::m_ci Struktur yang mengontrol perilaku kotak dialog.

Keterangan

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

Untuk informasi selengkapnya, lihat struktur OLEUICHANGEICON 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

COleChangeIconDialog

Persyaratan

Header: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

Fungsi ini hanya COleChangeIconDialog membuat objek.

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

Parameter

pItem
Menunjuk ke item yang akan dikonversi.

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

  • CIF_SELECTCURRENT Menentukan bahwa tombol radio Saat ini akan dipilih pada awalnya ketika kotak dialog dipanggil. Ini adalah default.

  • CIF_SELECTDEFAULT Menentukan bahwa tombol radio Default akan dipilih pada awalnya saat kotak dialog dipanggil.

  • CIF_SELECTFROMFILE Menentukan bahwa tombol radio Dari File akan dipilih pada awalnya saat kotak dialog dipanggil.

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

  • CIF_USEICONEXE Menentukan bahwa ikon harus diekstrak dari executable yang ditentukan di szIconExe bidang m_ci alih-alih diambil dari jenis . Ini berguna untuk menyematkan atau menautkan ke file non-OLE.

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

Keterangan

Untuk menampilkan kotak dialog, panggil fungsi DoModal .

Untuk informasi selengkapnya, lihat struktur OLEUICHANGEICON di Windows SDK.

COleChangeIconDialog::D oChangeIcon

Panggil fungsi ini untuk mengubah ikon yang mewakili item menjadi item yang dipilih dalam kotak dialog setelah DoModal mengembalikan IDOK.

BOOL DoChangeIcon(COleClientItem* pItem);

Parameter

pItem
Menunjuk ke item yang ikonnya berubah.

Tampilkan Nilai

Bukan nol jika perubahan berhasil; jika tidak, 0.

COleChangeIconDialog::D oModal

Panggil fungsi ini untuk menampilkan kotak dialog Ikon Perubahan 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 COleDialog::GetLastError fungsi anggota untuk mendapatkan informasi selengkapnya tentang jenis kesalahan yang terjadi. Untuk daftar kemungkinan kesalahan, lihat fungsi OleUIChangeIcon di Windows SDK.

Keterangan

Jika Anda ingin menginisialisasi berbagai kontrol kotak dialog dengan mengatur anggota struktur m_ci , 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.

COleChangeIconDialog::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 ikon ikon baru, jika kotak dialog dimatikan dengan memilih OK; jika tidak, ikon seperti sebelum dialog ditampilkan.

COleChangeIconDialog::m_ci

Struktur tipe OLEUICHANGEICON yang digunakan untuk mengontrol perilaku kotak dialog Ubah Ikon.

OLEUICHANGEICON m_ci;

Keterangan

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

Untuk informasi selengkapnya, lihat struktur OLEUICHANGEICON di Windows SDK.

Baca juga

Kelas COleDialog
Bagan Hierarki
Kelas COleDialog