Struktur OLEUICHANGESOURCEA (oledlg.h)

Artikel
08/25/2023

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 tagOLEUICHANGESOURCEA {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCSTR                lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCSTR                lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEA         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERA lpOleUILinkContainer;
  DWORD                 dwLink;
  LPSTR                 lpszDisplayName;
  ULONG                 nFileLength;
  LPSTR                 lpszFrom;
  LPSTR                 lpszTo;
} OLEUICHANGESOURCEA, *POLEUICHANGESOURCEA, *LPOLEUICHANGESOURCEA;

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

Penunjuk 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 kait 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 lpszTemplateadalah NULL 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 ADALAH 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

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

dwLink

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

lpszDisplayName

Penunjuk ke nama tampilan sumber lengkap.

nFileLength

Bagian moniker file dari lpszDisplayName.

lpszFrom

Penunjuk ke awalan sumber yang diubah.

lpszTo

Penunjuk 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