Kelas COleChangeSourceDialog

Digunakan untuk kotak dialog Ubah Sumber OLE.

Sintaks

class COleChangeSourceDialog : public COleDialog

Anggota

Konstruktor Publik

Nama	Deskripsi
COleChangeSourceDialog::COleChangeSourceDialog	Membuat COleChangeSourceDialog objek.

Metode Publik

Nama	Deskripsi
COleChangeSourceDialog::D oModal	Menampilkan kotak dialog Ubah Sumber OLE.
COleChangeSourceDialog::GetDisplayName	Mendapatkan nama tampilan sumber lengkap.
COleChangeSourceDialog::GetFileName	Mendapatkan nama file dari nama sumber.
COleChangeSourceDialog::GetFromPrefix	Mendapatkan awalan dari sumber sebelumnya.
COleChangeSourceDialog::GetItemName	Mendapatkan nama item dari nama sumber.
COleChangeSourceDialog::GetToPrefix	Mendapatkan awalan sumber baru
COleChangeSourceDialog::IsValidSource	Menunjukkan apakah sumber valid.

Anggota Data Publik

Nama	Deskripsi
COleChangeSourceDialog::m_cs	Struktur yang mengontrol perilaku kotak dialog.

Keterangan

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

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

COleChangeSourceDialog

Persyaratan

Header: afxodlgs.h

COleChangeSourceDialog::COleChangeSourceDialog

Fungsi ini membangun COleChangeSourceDialog objek.

explicit COleChangeSourceDialog(
    COleClientItem* pItem,
    CWnd* pParentWnd = NULL);

Parameter

pItem
Arahkan ke COleClientItem tertaut yang sumbernya akan diperbarui.

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 OLEUICHANGESOURCE dan fungsi OleUIChangeSource di Windows SDK.

COleChangeSourceDialog::D oModal

Panggil fungsi ini untuk menampilkan kotak dialog Ubah Sumber 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 OleUIChangeSource di Windows SDK.

Keterangan

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

Jika DoModal mengembalikan IDOK, Anda dapat memanggil fungsi anggota untuk mengambil pengaturan atau informasi yang dimasukkan pengguna dari kotak dialog. Daftar berikut ini menamai fungsi kueri umum:

• GetFileName

• GetDisplayName

• GetItemName

COleChangeSourceDialog::GetDisplayName

Panggil fungsi ini untuk mengambil nama tampilan lengkap untuk item klien yang ditautkan.

CString GetDisplayName();

Tampilkan Nilai

Nama tampilan sumber lengkap (moniker) untuk COleClientItem yang ditentukan dalam konstruktor.

COleChangeSourceDialog::GetFileName

Panggil fungsi ini untuk mengambil bagian moniker file dari nama tampilan untuk item klien yang ditautkan.

CString GetFileName();

Tampilkan Nilai

Bagian moniker file dari nama tampilan sumber untuk COleClientItem yang ditentukan dalam konstruktor.

Keterangan

Moniker file bersama dengan item moniker memberikan nama tampilan lengkap.

COleChangeSourceDialog::GetFromPrefix

Panggil fungsi ini untuk mendapatkan string awalan sebelumnya untuk sumbernya.

CString GetFromPrefix();

Tampilkan Nilai

String awalan sumber sebelumnya.

Keterangan

Panggil fungsi ini hanya setelah DoModal mengembalikan IDOK.

Nilai ini berasal langsung dari lpszFrom anggota struktur OLEUICHANGESOURCE .

Untuk informasi selengkapnya, lihat struktur OLEUICHANGESOURCE di Windows SDK.

COleChangeSourceDialog::GetItemName

Panggil fungsi ini untuk mengambil bagian item moniker dari nama tampilan untuk item klien yang ditautkan.

CString GetItemName();

Tampilkan Nilai

Bagian moniker item dari nama tampilan sumber untuk COleClientItem yang ditentukan dalam konstruktor.

Keterangan

Moniker file bersama dengan item moniker memberikan nama tampilan lengkap.

COleChangeSourceDialog::GetToPrefix

Panggil fungsi ini untuk mendapatkan string awalan baru untuk sumbernya.

CString GetToPrefix();

Tampilkan Nilai

String awalan baru sumber.

Keterangan

Panggil fungsi ini hanya setelah DoModal mengembalikan IDOK.

Nilai ini berasal langsung dari lpszTo anggota struktur OLEUICHANGESOURCE .

Untuk informasi selengkapnya, lihat struktur OLEUICHANGESOURCE di Windows SDK.

COleChangeSourceDialog::m_cs

Anggota data ini adalah struktur jenis OLEUICHANGESOURCE.

OLEUICHANGESOURCE m_cs;

Keterangan

OLEUICHANGESOURCE digunakan untuk mengontrol perilaku kotak dialog Ubah Sumber OLE. Anggota struktur ini dapat dimodifikasi secara langsung.

Untuk informasi selengkapnya, lihat struktur OLEUICHANGESOURCE di Windows SDK.

COleChangeSourceDialog::IsValidSource

Panggil fungsi ini untuk menentukan apakah sumber baru valid.

BOOL IsValidSource();

Tampilkan Nilai

Bukan nol jika sumber baru valid, jika tidak, 0.

Keterangan

Panggil fungsi ini hanya setelah DoModal mengembalikan IDOK.

Untuk informasi selengkapnya, lihat struktur OLEUICHANGESOURCE di Windows SDK.

Baca juga

Kelas COleDialog
Bagan Hierarki
Kelas COleDialog