DialogPropertyValueEditor Class

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Container for all dialog-editing logic for P:System.Activities.Presentation.PropertyEditing.PropertyContainer.PropertyEntry objects.

Namespace:   System.Activities.Presentation.PropertyEditing
Assembly:  System.Activities.Presentation (in System.Activities.Presentation.dll)


public class DialogPropertyValueEditor : PropertyValueEditor


Creates a new instance of the DialogPropertyValueEditor class with no specific templates.

System_CAPS_pubmethodDialogPropertyValueEditor(DataTemplate, DataTemplate)

Creates a new instance of the T:System.Activities.Design.PropertyEditing.DialogPropertyValueEditor class with the specified dialog editor and inline editor templates.


Gets or sets the DataTemplate that is hosted by a host-specific dialog and has its DataContext set to a PropertyValue.


Gets or sets the InlineEditorTemplate, the DataTemplate that is used for an inline editor.(Inherited from PropertyValueEditor.)


Determines whether the specified object is equal to the current object.(Inherited from Object.)


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)


Serves as the default hash function. (Inherited from Object.)


Gets the Type of the current instance.(Inherited from Object.)


Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodShowDialog(PropertyValue, IInputElement)

Called when the DialogEditorTemplate is null and a dialog has been invoked by the user.


Returns a string that represents the current object.(Inherited from Object.)

Use the DialogPropertyValueEditor class to show an inline editor that can have an associated dialog box editor.

The DialogPropertyValueEditor class can hold either a DataTemplate for a dialog box editor or custom logic that is called when the dialog box is invoked.

Use the EditModeSwitchButton in your DataTemplate to invoke your custom DialogPropertyValueEditor class.

You can provide a DataTemplate which is shown in a host dialog box, or you can override the T:Systems.Windows.Forms.ShowDialog method, which enables the reuse of existing or system dialog boxes.

The following list shows the rules for determining whether the DataTemplate or T:Systems.Windows.Forms.ShowDialog method is used.

If the DialogEditorTemplate property is not a null reference (Nothing in Visual Basic), that DataTemplate is hosted in a host-specific dialog box, which provides host styling. The T:Systems.Windows.Forms.ShowDialog is not called.

If the DialogEditorTemplate property is a null reference (Nothing in Visual Basic), the virtual T:Systems.Windows.Forms.ShowDialog method is called and you can override this method to show any dialog box.

.NET Framework
Available since 4.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top