Anda bisa menggunakan tindakan makro SetValue untuk mengatur nilai access bidang, kontrol, atau properti pada formulir, formulir lembar data, atau laporan.
Catatan: Anda tidak dapat menggunakan tindakan makro SetValue untuk mengatur nilai properti Access yang mengembalikan objek.
Catatan: Tindakan ini tidak akan diperbolehkan jika database tidak tepercaya.
Pengaturan
Tindakan makro SetValue memiliki argumen berikut.
|
Argumen tindakan |
Deskripsi |
|
Item |
Nama bidang, kontrol, atau properti yang nilainya ingin Anda atur. Masukkan nama bidang, kontrol, atau properti dalam kotak Item di bagian Argumen Tindakan dari jendela desain makro. Anda harus menggunakan sintaks lengkap untuk merujuk ke item ini, seperti nama kontrol (untuk kontrol pada formulir atau laporan tempat makro dipanggil) atau Forms!nama formulir! nama kontrol. Ini adalah argumen yang diperlukan. |
|
Ekspresi |
Access ekspresi digunakan untuk mengatur nilai untuk item ini. Anda harus selalu menggunakan sintaks lengkap untuk merujuk ke objek apa pun dalam ekspresi. Misalnya, untuk meningkatkan nilai dalam kontrol Gaji pada formulir Karyawan sebesar 10 persen, gunakan Forms!Employees!Salary*1.1. Ini adalah argumen yang diperlukan. Catatan: Anda tidak boleh menggunakan tanda sama dengan (=) sebelum ekspresi dalam argumen ini. Jika Anda melakukannya, Access mengevaluasi ekspresi lalu menggunakan nilai ini sebagai ekspresi dalam argumen ini. Hal ini dapat menghasilkan hasil yang tidak diharapkan jika ekspresi adalah string. Misalnya, jika Anda mengetik ="String1" untuk argumen ini, Access terlebih dahulu mengevaluasi ekspresi sebagai String1. Lalu menggunakan String1 sebagai ekspresi dalam argumen ini, yang mengharapkan untuk menemukan kontrol atau properti bernama String1 pada formulir atau laporan yang menyebut makro. |
Catatan: Dalam database Access (.mdb atau .accdb), klik tombol Susun untuk menggunakan Penyusun Ekspresi untuk membuat ekspresi bagi salah satu argumen ini.
Keterangan
Anda bisa menggunakan tindakan ini untuk mengatur nilai untuk bidang atau kontrol pada formulir, lembar data formulir, atau laporan. Anda juga dapat mengatur nilai untuk hampir semua properti kontrol, formulir, dan laporan dalam tampilan apa pun. Untuk mengetahui apakah properti tertentu dapat diatur menggunakan makro dan tampilan mana yang dapat diatur, lihat topik Bantuan untuk properti tersebut di Editor Visual Basic.
Anda juga dapat mengatur nilai untuk bidang dalam tabel yang mendasar formulir meskipun formulir tidak berisi kontrol yang terikat ke bidang. Gunakan sintaks Forms!nama formulir! nama bidang dalam kotak Item untuk mengatur nilai untuk bidang tersebut. Anda juga bisa merujuk ke bidang dalam tabel dasar laporan dengan menggunakan sintaks Laporan! nama laporan! nama bidang, tetapi harus ada kontrol pada laporan yang terikat ke bidang ini, atau bidang harus dirujuk dalam kontrol terhitung pada laporan.
Jika Anda mengatur nilai kontrol pada formulir, tindakan makro SetValue tidak memicu aturan validasi tingkat formulir kontrol, tetapi memicu aturan validasi tingkat tabel bidang yang mendasar jika kontrol adalah kontrol terikat. Tindakan makro SetValue juga memicu pengkalkulasian ulang, tetapi pengkalkulasian ulang mungkin tidak langsung terjadi. Untuk memicu pengecatan ulang segera dan memaksa pengkalkulasian ulang selesai, gunakan tindakan makro RepaintObject . Nilai yang Anda atur dalam kontrol menggunakan tindakan makro SetValue juga tidak terpengaruh oleh masker input yang diatur dalam properti InputMask bidang kontrol atau yang mendasar.
Untuk mengubah nilai kontrol, Anda dapat menggunakan tindakan SetValue dalam makro yang ditentukan oleh properti kejadian AfterUpdate kontrol. Namun, Anda tidak bisa menggunakan tindakan SetValue dalam makro yang ditentukan oleh properti kejadian BeforeUpdate kontrol untuk mengubah nilai kontrol (meskipun Anda bisa menggunakan tindakan SetValue untuk mengubah nilai kontrol lain). Anda juga bisa menggunakan tindakan SetValue dalam makro yang ditentukan oleh properti BeforeUpdate atau AfterUpdate formulir untuk mengubah nilai kontrol apa pun dalam rekaman saat ini.
Catatan: Anda tidak bisa menggunakan tindakan makro SetValue untuk mengatur nilai kontrol berikut ini:
-
Kontrol terikat dan kontrol terhitung pada laporan.
-
Kontrol terhitung pada formulir.
Tips
Anda bisa menggunakan tindakan makro SetValue untuk menyembunyikan atau memperlihatkan formulir dalam tampilan Formulir. Masukkan Forms!nama formulir. Terlihat dalam kotak Item dan Tidak atau Ya dalam kotak Ekspresi. Mengatur properti Terlihat formulir modal ke Tidak menyembunyikan formulir dan membuatnya tidak modeless. Mengatur properti ke Ya akan menampilkan formulir dan mengubahnya kembali.
Mengubah nilai atau menambahkan data baru dalam kontrol menggunakan tindakan SetValue dalam makro tidak memicu kejadian seperti BeforeUpdate, BeforeInsert, atau Ubah yang terjadi saat Anda mengubah atau memasukkan data dalam kontrol ini di antarmuka pengguna. Kejadian ini juga tidak terjadi jika Anda mengatur nilai kontrol menggunakan modul Visual Basic for Applications (VBA).
Tindakan ini tidak tersedia dalam modul VBA. Atur nilai secara langsung di VBA.
Contoh
Mengatur nilai kontrol menggunakan makro
Makro berikut ini membuka formulir Tambahkan Produk dari tombol pada formulir Pemasok. Ini memperlihatkan penggunaan tindakan makro Echo, Close, OpenForm, SetValue, dan GoToControl . Tindakan SetValue mengatur kontrol ID Pemasok pada formulir Produk ke pemasok saat ini pada formulir Pemasok. Tindakan GoToControl kemudian memindahkan fokus ke bidang IdKategori, di mana Anda bisa mulai memasukkan data untuk produk baru. Makro ini harus dilampirkan ke tombol Tambahkan Produk pada formulir Pemasok.
|
Tindakan |
Argumen: Pengaturan |
Komentar |
|
Echo |
Gema Pada: Tidak |
Hentikan pembaruan layar saat makro berjalan. |
|
Tutup |
Tipe Objek: Formulir Nama Objek: Daftar Produk Simpan: Tidak |
Tutup formulir Daftar Produk. |
|
OpenForm |
Nama Formulir: Produk Tampilan: Formulir Mode Data: Tambahkan Mode Jendela: Normal |
Buka formulir Produk. |
|
SetValue |
Item: [Forms]![ Produk]! [ID Pemasok] Ekspresi: ID Pemasok |
Atur kontrol ID Pemasok ke pemasok saat ini pada formulir Pemasok. |
|
GoToControl |
Nama Kontrol: CategoryID |
Masuk ke kontrol CategoryID. |
