IDkmCustomVisualizer.UseDefaultEvaluationBehavior Method

Definition

Called by the expression evaluator when a visualized expression's children are being expanded, the the value is being set, or the underlying string is being obtained. If the visualizer addin wants complete control of the expression it should return false. It will then receive calls to GetChildren, GetItems, SetValueAsString, and GetUnderlyingString. If the visualizer addin wants to completely defer these operations to the expression evaluator, it should return true. It must also give the expression evaluator back the instance of DkmEvaluationResult that came from the EE via one of the IDkmCustomVisualizerCallback methods. Note that the addin MUST have obtained the default DkmEvaluationResult from the EE if it wants the EE to control the object. Returning true from this method is primarily used by visualizer addins that just tweak something small like the view of a value but don't want to modify expansion or setting values.

public:
 void UseDefaultEvaluationBehavior(Microsoft::VisualStudio::Debugger::Evaluation::DkmVisualizedExpression ^ visualizedExpression, [Runtime::InteropServices::Out] bool % useDefaultEvaluationBehavior, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResult ^ % defaultEvaluationResult);
public void UseDefaultEvaluationBehavior (Microsoft.VisualStudio.Debugger.Evaluation.DkmVisualizedExpression visualizedExpression, out bool useDefaultEvaluationBehavior, out Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResult defaultEvaluationResult);
abstract member UseDefaultEvaluationBehavior : Microsoft.VisualStudio.Debugger.Evaluation.DkmVisualizedExpression * bool * DkmEvaluationResult -> unit
Public Sub UseDefaultEvaluationBehavior (visualizedExpression As DkmVisualizedExpression, ByRef useDefaultEvaluationBehavior As Boolean, ByRef defaultEvaluationResult As DkmEvaluationResult)

Parameters

visualizedExpression
DkmVisualizedExpression

[In] Dispatcher object used for custom visualization through a concord EE addin.

useDefaultEvaluationBehavior
Boolean

[Out] Return true to use default expansion, false otherwise.

defaultEvaluationResult
DkmEvaluationResult

[Out,Optional] The instance of DkmEvaluationResult returned from a call to one of the methods of IDkmCustomVisualizerCallback. The expression evaluator can only control DkmEvaluationResults it understands.

Applies to