DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Intenta "funcionalizar" este DisplayState intentando evaluar los mejores modos en todas las rutas de acceso dadas todas las propiedades de DisplayPath especificadas como restricciones. A continuación, este método (opcionalmente, vea Comentarios) actualiza todas las propiedades DisplayPath y DisplayView con los resultados de la funcionalización. En concreto, todas las propiedades DisplayPath y DisplayView establecidas en null tendrán sus valores calculados y establecidos.
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 DisplayStateOperationResultParámetros
- options
- DisplayStateFunctionalizeOptions
DisplayStateFunctionalizeOptions que se va a usar.
Devoluciones
Valor displayStateOperationResult que detalla el éxito o error de la operación.
Comentarios
Use la opción ValidateTopologyOnly para evitar actualizar todas las propiedades de DisplayPath con los resultados de la funcionalización.
Tenga en cuenta que llamar a TryApply también funcionaliza implícitamente el estado antes de aplicarlo al sistema, pero TryApply nunca actualiza las propiedades displayPath de este estado con los resultados de la funcionalización.
La funcionalización de un DisplayState puede ser una operación bastante costosa, ya que implica consultar controladores de pantalla y comparar muchos modos posibles. La operación suele ser más barata si establece más propiedades de DisplayPath antes de llamar a este método (o llamar a TryApply), ya que reduce la cantidad de trabajo necesario para evaluar el modo "mejor" en una ruta de acceso determinada.
El uso de TryFunctionalize para determinar si el estado actual se puede funcionalizar antes de llamar a TryApply es un procedimiento recomendado, ya que TryApply siempre es más caro que TryFunctionalize. Una vez que TryFunctionalize se realiza correctamente, una llamada posterior a TryApply será más barata, ya que ya no tiene que realizar el trabajo de los modos funcionalizadores.