DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Versucht, diesen DisplayState zu "funktionalisieren", indem versucht wird, die besten Modi für alle Pfade auszuwerten, wenn alle angegebenen DisplayPath-Eigenschaften als Einschränkungen angegeben sind. Diese Methode aktualisiert dann (optional unter Hinweise) alle DisplayPath - und DisplayView-Eigenschaften mit den Ergebnissen der Funktionalisierung. Insbesondere werden für alle DisplayPath - und DisplayView-Eigenschaften , die auf NULL festgelegt sind, ihre Werte berechnet und festgelegt.
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 DisplayStateOperationResultParameter
- options
- DisplayStateFunctionalizeOptions
Die zu verwendenden DisplayStateFunctionalizeOptions.The DisplayStateFunctionalizeOptions to use.
Gibt zurück
Ein DisplayStateOperationResult-Wert , der den Erfolg oder Fehler des Vorgangs detailliert darstellt.
Hinweise
Verwenden Sie die Option ValidateTopologyOnly , um zu verhindern, dass alle DisplayPath-Eigenschaften mit den Ergebnissen der Funktionalisierung aktualisiert werden.
Beachten Sie, dass der Aufruf von TryApply auch implizit den Zustand funktionalisiert, bevor er auf das System angewendet wird. TryApply aktualisiert jedoch niemals die DisplayPath-Eigenschaften dieses Zustands mit den Ergebnissen der Funktionalisierung.
Die Funktionalisierung eines DisplayState kann ein ziemlich kostspieliger Vorgang sein, da dies das Abfragen von Anzeigetreibern und den Vergleich vieler möglicher Modi umfasst. Der Vorgang ist in der Regel günstiger, wenn Sie vor dem Aufrufen dieser Methode (oder dem Aufrufen von TryApply) mehr Ihrer DisplayPath-Eigenschaften festlegen, da er den Arbeitsaufwand reduziert, der zum Auswerten des "besten" Modus für einen bestimmten Pfad erforderlich ist.
Die Verwendung von TryFunctionalize , um zu bestimmen, ob der aktuelle Zustand vor dem Aufruf von TryApply funktionalisiert werden kann, ist eine bewährte Methode, da TryApply immer teurer als TryFunctionalize ist. Sobald TryFunctionalize erfolgreich ist, ist ein späterer Aufruf von TryApply günstiger, da die Funktionalisierungsmodi nicht mehr ausgeführt werden müssen.