Bagikan melalui

FrameworkPropertyMetadata Konstruktor

  • Referensi

Definisi

Ruang nama:
System.Windows
Rakitan:
PresentationFramework.dll

Menginisialisasi instans baru kelas FrameworkPropertyMetadata.

Overload

FrameworkPropertyMetadata()

Menginisialisasi instans baru kelas FrameworkPropertyMetadata.
FrameworkPropertyMetadata(Object)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default yang ditentukan.
FrameworkPropertyMetadata(PropertyChangedCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan panggilan balik yang ditentukan PropertyChangedCallback .
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default yang disediakan dan opsi metadata tingkat kerangka kerja.
FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default yang disediakan dan panggilan balik yang ditentukan PropertyChangedCallback .
FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan panggilan balik yang ditentukan.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default dan opsi metadata kerangka kerja yang disediakan, dan panggilan balik yang ditentukan PropertyChangedCallback .
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default yang disediakan dan panggilan balik yang ditentukan.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default dan opsi metadata kerangka kerja yang disediakan, dan panggilan balik yang ditentukan.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default dan opsi metadata kerangka kerja yang disediakan, panggilan balik yang ditentukan, dan Boolean yang dapat digunakan untuk mencegah animasi properti.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default dan opsi metadata kerangka kerja yang disediakan, panggilan balik yang ditentukan, Boolean yang dapat digunakan untuk mencegah animasi properti, dan pemicu pembaruan pengikatan data default.

FrameworkPropertyMetadata()

Menginisialisasi instans baru kelas FrameworkPropertyMetadata.

public:
 FrameworkPropertyMetadata();
public FrameworkPropertyMetadata ();
Public Sub New ()

Keterangan

Tanda tangan ini menginisialisasi semua nilai FrameworkPropertyMetadata ke default propertinya. DefaultValue akan menjadi null, dan berbagai FrameworkPropertyMetadata properti Boolean akan menjadi false.

Lihat juga

Berlaku untuk

FrameworkPropertyMetadata(Object)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default yang ditentukan.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue);
public FrameworkPropertyMetadata (object defaultValue);
new System.Windows.FrameworkPropertyMetadata : obj -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object)

Parameter

defaultValue
Object

Nilai default properti dependensi, biasanya disediakan sebagai nilai dari jenis tertentu.

Pengecualian

ArgumentException

defaultValue diatur ke UnsetValue.

Contoh

Contoh berikut memanggil tanda tangan konstruktor ini:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(Double.NaN);

Keterangan

Jenis nilai yang disediakan untuk defaultValue harus cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi. Sistem properti tidak mengevaluasi nilai efektif properti hingga durasi, sehingga hasil dari tipe nilai default/tipe properti tidak cocok adalah kesalahan run-time.

Nilai UnsetValue memiliki arti khusus dalam sistem properti, dan tidak dapat digunakan sebagai nilai default properti dependensi.

Lihat juga

Berlaku untuk

FrameworkPropertyMetadata(PropertyChangedCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan panggilan balik yang ditentukan PropertyChangedCallback .

public:
 FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);
public FrameworkPropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);
new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (propertyChangedCallback As PropertyChangedCallback)

Parameter

propertyChangedCallback
PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil sistem properti setiap kali nilai efektif properti berubah.

Contoh

Contoh berikut memanggil tanda tangan konstruktor ini:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));

Berlaku untuk

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default yang disediakan dan opsi metadata tingkat kerangka kerja.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions)

Parameter

defaultValue
Object

Nilai default properti dependensi, biasanya disediakan sebagai nilai dari jenis tertentu.

flags
FrameworkPropertyMetadataOptions

Opsi metadata menandai (kombinasi FrameworkPropertyMetadataOptions nilai). Opsi ini menentukan karakteristik properti dependensi yang berinteraksi dengan sistem seperti tata letak atau pengikatan data.

Pengecualian

ArgumentException

defaultValue diatur ke UnsetValue.

Contoh

Contoh berikut memanggil tanda tangan konstruktor ini:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault)
);

Keterangan

Jenis nilai yang disediakan untuk defaultValue harus cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi. Sistem properti tidak mengevaluasi nilai efektif properti hingga durasi, sehingga hasil dari tipe nilai default/tipe properti tidak cocok adalah kesalahan run-time.

Nilai UnsetValue memiliki arti khusus dalam sistem properti, dan tidak dapat digunakan sebagai nilai default properti dependensi.

Nilai yang ditandai sebagai bendera set dalam flags parameter akan mengatur nilai FrameworkPropertyMetadata Properti Boolean yang cocok dengan FrameworkPropertyMetadataOptions nama bendera tersebut menjadi true. Anda kemudian dapat mengubah nilai properti dalam metadata, selama metadata belum diterapkan ke operasi sistem properti tertentu.

Lihat juga

Berlaku untuk

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default yang disediakan dan panggilan balik yang ditentukan PropertyChangedCallback .

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)

Parameter

defaultValue
Object

Nilai default properti dependensi, biasanya disediakan sebagai nilai dari jenis tertentu.

propertyChangedCallback
PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil sistem properti setiap kali nilai efektif properti berubah.

Pengecualian

ArgumentException

defaultValue diatur ke UnsetValue.

Contoh

Contoh berikut memanggil tanda tangan konstruktor ini:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

Keterangan

Jenis nilai yang disediakan untuk defaultValue harus cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi. Sistem properti tidak mengevaluasi nilai efektif properti hingga durasi, sehingga hasil dari tipe nilai default/tipe properti tidak cocok adalah kesalahan run-time.

Nilai UnsetValue memiliki arti khusus dalam sistem properti, dan tidak dapat digunakan sebagai nilai default properti dependensi.

Lihat juga

Berlaku untuk

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan panggilan balik yang ditentukan.

public:
 FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);
public FrameworkPropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);
new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parameter

propertyChangedCallback
PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil sistem properti setiap kali nilai efektif properti berubah.

coerceValueCallback
CoerceValueCallback

Referensi ke implementasi handler akan dipanggil setiap kali sistem properti memanggil CoerceValue(DependencyProperty) properti dependensi ini.

Contoh

Contoh berikut memanggil tanda tangan konstruktor ini:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Keterangan

Implementasi ini memanggil penginisialisasi dasar lalu menambahkan dengan mengatur properti pada instans coerceValueCallback dasar.

Lihat juga

Berlaku untuk

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default dan opsi metadata kerangka kerja yang disediakan, dan panggilan balik yang ditentukan PropertyChangedCallback .

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback)

Parameter

defaultValue
Object

Nilai default properti dependensi, biasanya disediakan sebagai nilai dari jenis tertentu.

flags
FrameworkPropertyMetadataOptions

Opsi metadata menandai (kombinasi FrameworkPropertyMetadataOptions nilai). Opsi ini menentukan karakteristik properti dependensi yang berinteraksi dengan sistem seperti tata letak atau pengikatan data.

propertyChangedCallback
PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil sistem properti setiap kali nilai efektif properti berubah.

Pengecualian

ArgumentException

defaultValue diatur ke UnsetValue.

Contoh

Contoh berikut memanggil tanda tangan konstruktor ini:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

Keterangan

Jenis nilai yang disediakan untuk defaultValue harus cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi. Sistem properti tidak mengevaluasi nilai efektif properti hingga durasi, sehingga hasil dari tipe nilai default/tipe properti tidak cocok adalah kesalahan run-time.

Nilai UnsetValue memiliki arti khusus dalam sistem properti, dan tidak dapat digunakan sebagai nilai default properti dependensi.

Nilai yang ditandai sebagai bendera set dalam flags parameter akan mengatur nilai FrameworkPropertyMetadata Properti Boolean yang cocok dengan FrameworkPropertyMetadataOptions nama bendera tersebut menjadi true. Anda masih dapat mengubah nilai properti dalam metadata, selama metadata belum diterapkan ke operasi sistem properti tertentu.

Lihat juga

Berlaku untuk

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default yang disediakan dan panggilan balik yang ditentukan.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parameter

defaultValue
Object

Nilai default properti dependensi, biasanya disediakan sebagai jenis tertentu.

propertyChangedCallback
PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil sistem properti setiap kali nilai efektif properti berubah.

coerceValueCallback
CoerceValueCallback

Referensi ke implementasi handler yang akan dipanggil setiap kali sistem properti memanggil CoerceValue(DependencyProperty) properti dependensi ini.

Pengecualian

ArgumentException

defaultValue diatur ke UnsetValue.

Contoh

Contoh berikut memanggil tanda tangan konstruktor ini:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Keterangan

Jenis nilai yang disediakan untuk defaultValue harus cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi. Sistem properti tidak mengevaluasi nilai efektif properti hingga durasi, sehingga hasil dari tipe nilai default/tipe properti tidak cocok adalah kesalahan run-time.

Nilai UnsetValue memiliki arti khusus dalam sistem properti, dan tidak dapat digunakan sebagai nilai default properti dependensi.

Lihat juga

Berlaku untuk

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default dan opsi metadata kerangka kerja yang disediakan, dan panggilan balik yang ditentukan.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parameter

defaultValue
Object

Nilai default properti dependensi, biasanya disediakan sebagai jenis tertentu.

flags
FrameworkPropertyMetadataOptions

Opsi metadata menandai (kombinasi FrameworkPropertyMetadataOptions nilai). Opsi ini menentukan karakteristik properti dependensi yang berinteraksi dengan sistem seperti tata letak atau pengikatan data.

propertyChangedCallback
PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil sistem properti setiap kali nilai efektif properti berubah.

coerceValueCallback
CoerceValueCallback

Referensi ke implementasi handler yang akan dipanggil setiap kali sistem properti memanggil CoerceValue(DependencyProperty) terhadap properti ini.

Pengecualian

ArgumentException

defaultValue diatur ke UnsetValue.

Contoh

Contoh berikut memanggil tanda tangan konstruktor ini:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Keterangan

Jenis nilai yang disediakan untuk defaultValue harus cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi. Sistem properti tidak mengevaluasi nilai efektif properti hingga durasi, sehingga hasil dari tipe nilai default/tipe properti tidak cocok adalah kesalahan run-time.

Nilai UnsetValue memiliki arti khusus dalam sistem properti, dan tidak dapat digunakan sebagai nilai default properti dependensi.

Nilai yang ditandai sebagai bendera set dalam flags parameter akan mengatur nilai FrameworkPropertyMetadata Properti Boolean yang cocok dengan FrameworkPropertyMetadataOptions nama bendera tersebut menjadi true. Anda masih dapat mengubah nilai properti dalam metadata, selama metadata belum diterapkan ke operasi sistem properti tertentu.

Lihat juga

Berlaku untuk

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default dan opsi metadata kerangka kerja yang disediakan, panggilan balik yang ditentukan, dan Boolean yang dapat digunakan untuk mencegah animasi properti.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean)

Parameter

defaultValue
Object

Nilai default properti dependensi, biasanya disediakan sebagai jenis tertentu.

flags
FrameworkPropertyMetadataOptions

Opsi metadata menandai (kombinasi FrameworkPropertyMetadataOptions nilai). Opsi ini menentukan karakteristik properti dependensi yang berinteraksi dengan sistem seperti tata letak atau pengikatan data.

propertyChangedCallback
PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil sistem properti setiap kali nilai efektif properti berubah.

coerceValueCallback
CoerceValueCallback

Referensi ke implementasi handler yang akan dipanggil setiap kali sistem properti memanggil CoerceValue(DependencyProperty) properti dependensi ini.

isAnimationProhibited
Boolean

true untuk mencegah sistem properti menganimasikan properti tempat metadata ini diterapkan. Properti tersebut akan meningkatkan pengecualian run-time yang berasal dari sistem properti jika animasinya dicoba. false untuk mengizinkan animasi properti. Default adalah false.

Pengecualian

ArgumentException

defaultValue diatur ke UnsetValue.

Contoh

Contoh berikut memanggil tanda tangan konstruktor ini:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading),
    true //Animation prohibited
);

Keterangan

Jenis nilai yang disediakan untuk defaultValue harus cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi. Sistem properti tidak mengevaluasi nilai efektif properti hingga durasi, sehingga hasil dari tipe nilai default/tipe properti tidak cocok adalah kesalahan run-time.

Nilai UnsetValue memiliki arti khusus dalam sistem properti, dan tidak dapat digunakan sebagai nilai default properti dependensi.

Parameter isAnimationProhibited menetapkan nilai awal properti yang IsAnimationProhibited dideklarasikan oleh kelas dasar UIPropertyMetadata langsung.

Nilai yang ditandai sebagai bendera set dalam flags parameter akan mengatur nilai FrameworkPropertyMetadata Properti Boolean yang cocok dengan FrameworkPropertyMetadataOptions nama bendera tersebut menjadi true. Anda masih dapat mengubah nilai properti dalam metadata, selama metadata belum diterapkan ke operasi sistem properti tertentu.

Lihat juga

Berlaku untuk

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)

Menginisialisasi instans FrameworkPropertyMetadata baru kelas dengan nilai default dan opsi metadata kerangka kerja yang disediakan, panggilan balik yang ditentukan, Boolean yang dapat digunakan untuk mencegah animasi properti, dan pemicu pembaruan pengikatan data default.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited, System::Windows::Data::UpdateSourceTrigger defaultUpdateSourceTrigger);
public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited, System.Windows.Data.UpdateSourceTrigger defaultUpdateSourceTrigger);
new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool * System.Windows.Data.UpdateSourceTrigger -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean, defaultUpdateSourceTrigger As UpdateSourceTrigger)

Parameter

defaultValue
Object

Nilai default properti dependensi, biasanya disediakan sebagai jenis tertentu.

flags
FrameworkPropertyMetadataOptions

Opsi metadata menandai (kombinasi FrameworkPropertyMetadataOptions nilai). Opsi ini menentukan karakteristik properti dependensi yang berinteraksi dengan sistem seperti tata letak atau pengikatan data.

propertyChangedCallback
PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil sistem properti setiap kali nilai efektif properti berubah.

coerceValueCallback
CoerceValueCallback

Referensi ke implementasi handler yang akan dipanggil setiap kali sistem properti memanggil CoerceValue(DependencyProperty) terhadap properti ini.

isAnimationProhibited
Boolean

true untuk mencegah sistem properti menganimasikan properti tempat metadata ini diterapkan. Properti tersebut akan meningkatkan pengecualian run-time yang berasal dari sistem properti jika animasinya dicoba. Default adalah false.

defaultUpdateSourceTrigger
UpdateSourceTrigger

untuk UpdateSourceTrigger digunakan saat pengikatan untuk properti ini diterapkan yang telah diatur UpdateSourceTrigger ke Default.

Pengecualian

ArgumentException

defaultValue diatur ke UnsetValue.

Contoh

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading),
    true //Animation prohibited
    , UpdateSourceTrigger.PropertyChanged
);

Keterangan

Jenis nilai yang disediakan untuk defaultValue harus cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi. Sistem properti tidak mengevaluasi nilai efektif properti hingga durasi, sehingga hasil dari tipe nilai default/tipe properti tidak cocok adalah kesalahan run-time.

Nilai UnsetValue memiliki arti khusus dalam sistem properti, dan tidak dapat digunakan sebagai nilai default properti dependensi.

Parameter isAnimationProhibited menetapkan nilai awal properti yang IsAnimationProhibited dideklarasikan oleh kelas dasar UIPropertyMetadata langsung.

Untuk informasi selengkapnya tentang perilaku sumber pembaruan untuk pengikatan, lihat Gambaran Umum Pengikatan Data.

Nilai yang ditandai sebagai bendera set dalam flags parameter akan mengatur nilai FrameworkPropertyMetadata Properti Boolean yang cocok dengan FrameworkPropertyMetadataOptions nama bendera tersebut menjadi true. Anda masih dapat mengubah nilai properti dalam metadata, selama metadata belum diterapkan ke operasi sistem properti tertentu.

Lihat juga

Berlaku untuk