DkmVisualizedExpression.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.

Location constraint: API must be called from an IDE component (component level > 100,000).

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

Parameters

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