Struktur OLEUICHANGESOURCEW (oledlg.h)

Artikel
03/01/2024

Berisi informasi yang digunakan untuk menginisialisasi kotak dialog Ubah Sumber standar. Ini memungkinkan pengguna untuk memodifikasi tujuan atau sumber tautan. Ini mungkin hanya memerlukan pemilihan nama file yang berbeda untuk tautan, atau mungkin mengubah referensi item dalam file, misalnya, mengubah rentang tujuan sel dalam spreadsheet tempat tautan berada.

Sintaks

typedef struct tagOLEUICHANGESOURCEW {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCWSTR               lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCWSTR               lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEW         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERW lpOleUILinkContainer;
  DWORD                 dwLink;
  LPWSTR                lpszDisplayName;
  ULONG                 nFileLength;
  LPWSTR                lpszFrom;
  LPWSTR                lpszTo;
} OLEUICHANGESOURCEW, *POLEUICHANGESOURCEW, *LPOLEUICHANGESOURCEW;

Anggota

cbStruct

Ukuran struktur, dalam byte.

dwFlags

Pada input, bidang ini menentukan bendera inisialisasi dan pembuatan. Saat keluar, ini menentukan pilihan pengguna. Ini mungkin kombinasi dari bendera berikut.

Nilai	Makna
CSF_SHOWHELP	Mengaktifkan atau memperlihatkan tombol Bantuan.
CSF_VALIDSOURCE	Menunjukkan bahwa tautan telah divalidasi.
CSF_ONLYGETSOURCE	Menonaktifkan validasi otomatis sumber tautan saat pengguna menekan OK. Jika Anda menentukan bendera ini, Anda harus memvalidasi sumber saat kotak dialog mengembalikan OK.

hWndOwner

Jendela yang memiliki kotak dialog.

lpszCaption

Penunjuk ke string yang akan digunakan sebagai judul kotak dialog. Jika NULL, maka pustaka menggunakan Ubah Sumber.

lpfnHook

Arahkan ke fungsi hook yang memproses pesan yang ditujukan untuk kotak dialog. Fungsi hook harus mengembalikan nol untuk meneruskan pesan bahwa tidak diproses kembali ke prosedur kotak dialog di pustaka. Fungsi hook harus mengembalikan nilai bukan nol untuk mencegah prosedur kotak dialog pustaka memproses pesan yang telah diproses.

lCustData

Data yang ditentukan aplikasi yang diteruskan pustaka ke fungsi hook yang diarahkan oleh struktur OLEUICHANGEICON dalam parameter lParam dari pesan WM_INITDIALOG; pointer ini dapat digunakan untuk mengambil anggota lCustData .

hInstance

Instans yang berisi templat kotak dialog yang ditentukan oleh anggota lpszTemplate . Anggota ini diabaikan jika anggota lpszTemplateNULL atau tidak valid.

lpszTemplate

Penunjuk ke string yang dihentikan null yang menentukan nama file sumber daya untuk templat kotak dialog yang akan diganti untuk templat kotak dialog Konversi pustaka.

hResource

Penanganan sumber daya untuk kotak dialog kustom. Jika anggota ini NULL, maka pustaka menggunakan templat kotak dialog Konversi standar, atau jika valid, templat yang dinamai oleh anggota lpszTemplate .

lpOFN

Arahkan ke struktur OPENFILENAME , yang berisi informasi yang digunakan oleh sistem operasi untuk menginisialisasi kotak dialog Buka atau Simpan Sebagai yang ditentukan sistem.

dwReserved1[4]

Anggota ini dicadangkan.

lpOleUILinkContainer

Arahkan ke implementasi kontainer antarmuka IOleUILinkContainer , yang digunakan untuk memvalidasi sumber tautan. Kotak dialog Edit Tautan menggunakan ini untuk memungkinkan kontainer memanipulasi tautannya.

dwLink

Pengidentifikasi tautan unik yang ditentukan kontainer yang digunakan untuk memvalidasi sumber tautan. Digunakan oleh lpOleUILinkContainer.

lpszDisplayName

Arahkan ke nama tampilan sumber lengkap.

nFileLength

Bagian moniker file dari lpszDisplayName.

lpszFrom

Penunjuk ke awalan sumber yang diubah.

lpszTo

Arahkan ke awalan sumber yang akan diubah.

Keterangan

Catatan

Header oledlg.h mendefinisikan OLEUICHANGESOURCE sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	oledlg.h

Lihat juga

IOleUILinkContainer

OleUIChangeSource

Bagikan melalui