DxHtmlElement.ForEach(Action<DxHtmlElement>, Predicate<DxHtmlElement>) Method

Modifies all child elements that match the given predicate. This method searches for matching elements recursively: first among this element’s Children collection, then among child elements of these children, and so on, until it reaches the lowermost elements.

Namespace: DevExpress.Utils.Html

Assembly: DevExpress.Data.Desktop.v24.1.dll

NuGet Packages: DevExpress.Data.Desktop, DevExpress.ExpressApp.Win.Design

Declaration

C#

public void ForEach(
    Action<DxHtmlElement> action,
    Predicate<DxHtmlElement> predicate = null
)

VB.NET

Public Sub ForEach(
    action As Action(Of DxHtmlElement),
    predicate As Predicate(Of DxHtmlElement) = Nothing
)

Parameters

Name	Type	Description
action	Action<DxHtmlElement>	The action that modifies found elements.

Optional Parameters

Name	Type	Default	Description
predicate	Predicate<DxHtmlElement>	null	The condition used to find HTML elements.

Remarks

The code below finds all elements with the "specs" class and disables them.

C#

void OnHtmlElementMouseClick(object sender, WinExplorerViewHtmlElementHandledEventArgs e) {
    e.Element.ForEach(x => x.Disabled = true, p => p.ClassName == "specs");
}

VB.NET

Private Sub OnHtmlElementMouseClick(ByVal sender As Object, ByVal e As WinExplorerViewHtmlElementHandledEventArgs)
    e.Element.ForEach(Sub(x) x.Disabled = True, Function(p) p.ClassName = "specs")
End Sub

If you want to modify only elements directly owned by the current HTML element, and prevent looking for elements outside the Children collection, add a second condition as shown below.

C#

using System.Linq;

void OnHtmlElementMouseClick(object sender, WinExplorerViewHtmlElementHandledEventArgs e) {
    e.Element.ForEach(x => x.Disabled = true,
        p => p.ClassName == "specs"  && e.Element.Children.Contains(p) == true);
}

VB.NET

Imports System.Linq

Private Sub OnHtmlElementMouseClick(ByVal sender As Object, ByVal e As WinExplorerViewHtmlElementHandledEventArgs)
    e.Element.ForEach(Sub(x) x.Disabled = True, Function(p) p.ClassName = "specs" AndAlso e.Element.Children.Contains(p) = True)
End Sub