DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) Metode

Definisi

Ruang nama:

Windows.Devices.Display.Core

Mencoba untuk "memfungsikan" DisplayState ini dengan mencoba mengevaluasi mode terbaik pada semua jalur mengingat semua properti DisplayPath yang ditentukan sebagai batasan. Metode ini kemudian (opsional, lihat Keterangan) memperbarui semua properti DisplayPath dan DisplayView dengan hasil fungsionalisasi. Secara khusus, semua properti DisplayPath dan DisplayView yang diatur ke null akan memiliki nilainya yang dihitung dan diatur.

public:
 virtual DisplayStateOperationResult ^ TryFunctionalize(DisplayStateFunctionalizeOptions options) = TryFunctionalize;

DisplayStateOperationResult TryFunctionalize(DisplayStateFunctionalizeOptions const& options);

public DisplayStateOperationResult TryFunctionalize(DisplayStateFunctionalizeOptions options);

function tryFunctionalize(options)

Public Function TryFunctionalize (options As DisplayStateFunctionalizeOptions) As DisplayStateOperationResult

Parameter

options

DisplayStateFunctionalizeOptions

DisplayStateFunctionalizeOptions untuk digunakan.

Mengembalikan

DisplayStateOperationResult

Nilai DisplayStateOperationResult yang merinci keberhasilan atau kegagalan operasi.

Keterangan

Gunakan opsi ValidateTopologyOnly untuk mencegah pembaruan semua properti DisplayPath dengan hasil fungsionalisasi.

Perhatikan bahwa memanggil TryApply juga secara implisit memfungsikan status sebelum menerapkannya ke sistem, tetapi TryApply tidak pernah memperbarui properti DisplayPath status ini dengan hasil fungsionalisasi.

Fungsionalisasi DisplayState bisa menjadi operasi yang cukup mahal, karena melibatkan kueri driver tampilan dan membandingkan banyak mode yang mungkin. Operasi biasanya akan lebih murah jika Anda mengatur lebih banyak properti DisplayPath Anda sebelum memanggil metode ini (atau memanggil TryApply), karena mengurangi jumlah pekerjaan yang diperlukan untuk mengevaluasi mode "terbaik" pada jalur tertentu.

Menggunakan TryFunctionalize untuk menentukan apakah status saat ini dapat difungsikan sebelum memanggil TryApply adalah praktik yang baik, karena TryApply selalu lebih mahal daripada TryFunctionalize. Setelah TryFunctionalize berhasil, panggilan berikutnya ke TryApply akan lebih murah, karena tidak lagi harus melakukan pekerjaan mode fungsionalisasi.