DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Tenta di "funzionalizzare" questo DisplayState cercando di valutare le modalità migliori in tutti i percorsi specificati come vincoli. Questo metodo aggiorna quindi (facoltativamente, vedere La sezione Osservazioni) aggiorna tutte le proprietà DisplayPath e DisplayView con i risultati della funzionalizzazione. In particolare, tutte le proprietà DisplayPath e DisplayView impostate su Null avranno i valori calcolati e impostati.
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 DisplayStateOperationResultParametri
- options
- DisplayStateFunctionalizeOptions
DisplayStateFunctionalizeOptions da utilizzare.
Restituisce
Valore DisplayStateOperationResult che descrive in dettaglio l'esito positivo o negativo dell'operazione.
Commenti
Utilizzare l'opzione ValidateTopologyOnly per impedire l'aggiornamento di tutte le proprietà DisplayPath con i risultati della funzionalità.
Si noti che la chiamata a TryApply consente anche di funzionalizzare in modo implicito lo stato prima di applicarlo al sistema, ma TryApply non aggiorna mai le proprietà DisplayPath di questo stato con i risultati della funzionalizzazione.
La funzionalità di DisplayState può essere un'operazione piuttosto costosa, poiché comporta l'esecuzione di query sui driver di visualizzazione e il confronto di molte modalità possibili. L'operazione sarà in genere più economica se si impostano più proprietà di DisplayPath prima di chiamare questo metodo (o chiamando TryApply), poiché riduce la quantità di lavoro necessaria per valutare la modalità "migliore" in un determinato percorso.
L'uso di TryFunctionalize per determinare se lo stato corrente può essere funzionalizzato prima di chiamare TryApply è una procedura consigliata, poiché TryApply è sempre più costoso di TryFunctionalize. Una volta che TryFunctionalize ha esito positivo, una chiamata successiva a TryApply sarà più economica, poiché non deve più eseguire il lavoro delle modalità di funzionalizzazione.