Kelas COlePropertiesDialog
Merangkum kotak dialog Properti Objek OLE umum Windows.
Sintaks
class COlePropertiesDialog : public COleDialog
Anggota
Konstruktor Publik
Nama | Deskripsi |
---|---|
COlePropertiesDialog::COlePropertiesDialog | Membuat COlePropertiesDialog objek. |
Metode Publik
Nama | Deskripsi |
---|---|
COlePropertiesDialog::D oModal | Menampilkan kotak dialog dan memperbolehkan pengguna membuat pilihan. |
COlePropertiesDialog::OnApplyScale | Dipanggil oleh kerangka kerja saat penskalaan item dokumen telah berubah. |
Anggota Data Publik
Nama | Deskripsi |
---|---|
COlePropertiesDialog::m_gp | Struktur yang digunakan untuk menginisialisasi halaman "Umum" objek COlePropertiesDialog . |
COlePropertiesDialog::m_lp | Struktur yang digunakan untuk menginisialisasi halaman "Tautan" objek COlePropertiesDialog . |
COlePropertiesDialog::m_op | Struktur yang digunakan untuk menginisialisasi COlePropertiesDialog objek. |
COlePropertiesDialog::m_psh | Struktur yang digunakan untuk menambahkan halaman properti kustom tambahan. |
COlePropertiesDialog::m_vp | Struktur yang digunakan untuk mengkustomisasi halaman "Tampilan" objek COlePropertiesDialog . |
Keterangan
Kotak dialog Properti Objek OLE umum menyediakan cara mudah untuk menampilkan dan memodifikasi properti item dokumen OLE dengan cara yang konsisten dengan standar Windows. Properti ini meliputi, antara lain, informasi tentang file yang diwakili oleh item dokumen, opsi untuk menampilkan ikon dan penskalaan gambar, dan informasi tentang tautan item (jika item ditautkan).
Untuk menggunakan COlePropertiesDialog
objek, pertama-tama buat objek menggunakan COlePropertiesDialog
konstruktor. Setelah kotak dialog dibuat, panggil DoModal
fungsi anggota untuk menampilkan kotak dialog dan izinkan pengguna mengubah properti item apa pun. DoModal
mengembalikan apakah pengguna memilih OK (IDOK) atau tombol Batal (IDCANCEL). Selain tombol OK dan Batal, ada tombol Terapkan. Saat pengguna memilih Terapkan, setiap perubahan yang dilakukan pada properti item dokumen diterapkan ke item dan gambarnya diperbarui secara otomatis, tetapi tetap aktif.
Anggota data m_psh adalah penunjuk ke PROPSHEETHEADER
struktur, dan dalam banyak kasus Anda tidak perlu mengaksesnya secara eksplisit. Satu pengecualian adalah ketika Anda memerlukan halaman properti tambahan di luar halaman Umum, Tampilan, dan Tautan default. Dalam hal ini, Anda dapat memodifikasi m_psh
anggota data untuk menyertakan halaman kustom Anda sebelum memanggil DoModal
fungsi anggota.
Untuk informasi selengkapnya tentang kotak dialog OLE, lihat artikel Kotak Dialog di OLE.
Hierarki Warisan
COlePropertiesDialog
Persyaratan
Header: afxodlgs.h
COlePropertiesDialog::COlePropertiesDialog
COlePropertiesDialog
Membuat objek.
COlePropertiesDialog(
COleClientItem* pItem,
UINT nScaleMin = 10,
UINT nScaleMax = 500,
CWnd* pParentWnd = NULL);
Parameter
pItem
Penunjuk ke item dokumen yang propertinya sedang diakses.
nScaleMin
Persentase penskalaan minimum untuk gambar item dokumen.
nScaleMax
Persentase penskalaan maksimum untuk gambar item dokumen.
pParentWnd
Arahkan ke induk atau pemilik kotak dialog.
Keterangan
Dapatkan kelas dialog Properti Objek OLE umum Anda dari COlePropertiesDialog
untuk menerapkan penskalaan untuk item dokumen Anda. Kotak dialog apa pun yang diimplementasikan oleh instans kelas ini tidak akan mendukung penskalaan item dokumen.
Secara default, kotak dialog Properti Objek OLE umum memiliki tiga halaman default:
Umum
Halaman ini berisi informasi sistem untuk file yang diwakili oleh item dokumen terpilih. Dari halaman ini, pengguna dapat mengonversi item terpilih ke tipe lain.
Tampilan
Halaman ini berisi opsi untuk menampilkan item, mengubah ikon, dan mengubah penskalaan gambar.
Tautan
Halaman ini berisi opsi untuk mengubah lokasi item tertaut dan memperbarui item tertaut. Dari halaman ini, pengguna dapat memutuskan tautan item yang dipilih.
Untuk menambahkan halaman di luar yang disediakan secara default, ubah variabel anggota m_psh sebelum keluar dari konstruktor kelas -turunan Anda COlePropertiesDialog
. Ini adalah implementasi lanjutan dari COlePropertiesDialog
konstruktor.
COlePropertiesDialog::D oModal
Panggil fungsi anggota ini untuk menampilkan kotak dialog Properti Objek OLE umum Windows dan izinkan pengguna untuk melihat dan/atau mengubah berbagai properti item dokumen.
virtual INT_PTR DoModal();
Tampilkan Nilai
IDOK atau IDCANCEL jika berhasil; jika tidak, 0. IDOK dan IDCANCEL adalah konstanta yang menunjukkan apakah pengguna memilih tombol OK atau Batal.
Jika IDCANCEL dikembalikan, Anda dapat memanggil fungsi Windows CommDlgExtendedError untuk menentukan apakah terjadi kesalahan.
COlePropertiesDialog::m_gp
Struktur tipe OLEUIGNRLPROPS, digunakan untuk menginisialisasi halaman Umum kotak dialog Properti Objek OLE.
OLEUIGNRLPROPS m_gp;
Keterangan
Halaman ini memperlihatkan tipe dan ukuran penyematan dan memungkinkan pengguna mengakses kotak dialog Konversi. Halaman ini juga memperlihatkan tujuan tautan jika objek adalah tautan.
Untuk informasi selengkapnya tentang OLEUIGNRLPROPS
struktur, lihat Windows SDK.
COlePropertiesDialog::m_lp
Struktur tipe OLEUILINKPROPS, digunakan untuk menginisialisasi halaman Tautan dari kotak dialog Properti Objek OLE.
OLEUILINKPROPS m_lp;
Keterangan
Halaman ini memperlihatkan lokasi item tertaut dan memungkinkan pengguna untuk memperbarui, atau memutuskan, tautan ke item.
Untuk informasi selengkapnya tentang OLEUILINKPROPS
struktur, lihat Windows SDK.
COlePropertiesDialog::m_op
Struktur tipe OLEUIOBJECTPROPS, digunakan untuk menginisialisasi kotak dialog Properti Objek OLE umum.
OLEUIOBJECTPROPS m_op;
Keterangan
Struktur ini berisi anggota yang digunakan untuk menginisialisasi halaman Umum, Tautan, dan Tampilan.
Untuk informasi selengkapnya, lihat struktur OLEUIOBJECTPROPS dan OLEUILINKPROPS di Windows SDK.
COlePropertiesDialog::m_psh
Struktur jenis PROPSHEETHEADER, yang anggotanya menyimpan karakteristik objek dialog.
PROPSHEETHEADER m_psh;
Keterangan
Setelah membuat COlePropertiesDialog
objek, Anda dapat menggunakan m_psh
untuk mengatur berbagai aspek kotak dialog sebelum memanggil DoModal
fungsi anggota.
Jika Anda memodifikasi anggota data secara m_psh
langsung, Anda akan mengambil alih perilaku default apa pun.
Untuk informasi selengkapnya tentang PROPSHEETHEADER
struktur, lihat Windows SDK.
COlePropertiesDialog::m_vp
Struktur tipe OLEUIVIEWPROPS, digunakan untuk menginisialisasi halaman Tampilan dari kotak dialog Properti Objek OLE.
OLEUIVIEWPROPS m_vp;
Keterangan
Halaman ini memungkinkan pengguna untuk beralih antara tampilan "konten" dan "ikonik" objek, dan mengubah penskalaannya dalam kontainer. Ini juga memungkinkan pengguna mengakses kotak dialog Ubah Ikon saat objek ditampilkan sebagai ikon.
Untuk informasi selengkapnya tentang OLEUIVIEWPROPS
struktur, lihat Windows SDK.
COlePropertiesDialog::OnApplyScale
Dipanggil oleh kerangka kerja ketika nilai penskalakan telah berubah dan OK atau Terapkan dipilih.
virtual BOOL OnApplyScale(
COleClientItem* pItem,
int nCurrentScale,
BOOL bRelativeToOrig);
Parameter
pItem
Penunjuk ke item dokumen yang propertinya sedang diakses.
nCurrentScale
Nilai numerik dari skala dialog.
bRelativeToOrig
Menunjukkan apakah penskalaan berlaku untuk ukuran asli item dokumen.
Tampilkan Nilai
Nonzero jika ditangani; jika tidak, 0.
Keterangan
Implementasi default tidak melakukan apa pun. Anda harus mengambil alih fungsi ini untuk mengaktifkan kontrol penskalakan.
Catatan
Sebelum kotak dialog Properti Objek OLE umum ditampilkan, kerangka kerja memanggil fungsi ini dengan NULL untuk pItem dan - 1 untuk nCurrentScale. Ini dilakukan untuk menentukan apakah kontrol penskalakan harus diaktifkan.
Lihat juga
CIRC Sampel MFC
Kelas COleDialog
Bagan Hierarki
Kelas COleDialog
Kelas CPropertyPage