DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) 方法

定義

命名空間:

Windows.Devices.Display.Core

嘗試評估所有指定DisplayPath屬性做為條件約束的所有路徑上的最佳模式，以「功能化」此DisplayState。 This method then (optionally, see Remarks) updates all DisplayPath and DisplayView properties with the results of the functionalization. 特別是，所有 DisplayPath 和 DisplayView 屬性都設定為 null，都會計算並設定其值。

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

參數

options

DisplayStateFunctionalizeOptions

要使用的 DisplayStateFunctionalizeOptions 。

傳回

DisplayStateOperationResult

DisplayStateOperationResult值，詳細說明作業的成功或失敗。

備註

使用 ValidateTopologyOnly 選項來防止以功能化的結果更新所有 DisplayPath 屬性。

請注意，呼叫 TryApply 也會在將狀態套用至系統之前隱含地運作狀態，但 TryApply 永遠不會以功能化的結果更新此狀態的 DisplayPath 屬性。

將 DisplayState功能化可能是相當耗費資源的作業，因為它牽涉到查詢顯示驅動程式，並比較許多可能的模式。 如果您在呼叫此方法之前設定更多 DisplayPath 屬性， (或呼叫 TryApply) ，作業通常會比較便宜，因為它會減少評估指定路徑上「最佳」模式所需的工作量。

使用 TryFunctionalize 來判斷目前狀態是否可以在呼叫 TryApply 之前正常運作，因為 TryApply 永遠比 TryFunctionalize更昂貴。 一旦 TryFunctionalize成功，後續對 TryApply的呼叫會比較便宜，因為它不再需要執行功能化模式的工作。