NavBarGroupCollection.FindByText(String) Method

Returns a group object with the specified NavBarGroup.Text property value.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

public NavBarGroup FindByText(
    string text
)

VB.NET

Public Function FindByText(
    text As String
) As NavBarGroup

Parameters

Name	Type	Description
text	String	A String value representing the NavBarGroup.Text property value of the required group.

Returns

Type	Description
NavBarGroup	A NavBarGroup object with a specific value of the NavBarGroup.Text property.

Remarks

Use this method to obtain a group specified by a display text assigned to its NavBarGroup.Text property.

Example

The code sample below demonstrates how to populate an ASPxNavBar control with groups and items manually, in unbound mode. The image below shows the result.

C#

protected void Page_Load(object sender, EventArgs e) {
     if (!IsPostBack) {
            CreateNavBar();
     }
}

//Create NavBar initial structure. 
void CreateNavBar() {
     string[] GroupTexts = { "Home", "News", "Products", "Client Center" };
     foreach (string Text in GroupTexts) {
          MyASPxNavBar.Groups.Add(Text);
     }
     MyASPxNavBar.Groups.FindByText("News").Items.Add("Subscriptions");
     NavBarItem[] ProductsItems = { 
          new NavBarItem("Downloads"), 
          new NavBarItem("Support"), 
          new NavBarItem("Order") 
     };
     MyASPxNavBar.Groups.FindByText("Products").Items.Add(ProductsItems);
}

//Add a new group
protected void btnAddGroup_Click(object sender, EventArgs e) {
     if (tbItemName.Text != "") {
          MyASPxNavBar.Groups.Add(tbItemName.Text);
     }
}

//Add a new item
     protected void btnAddItem_Click(object sender, EventArgs e) {
        if ((MyASPxNavBar.ActiveGroup != null) && (tbItemName.Text != "")) {
            MyASPxNavBar.ActiveGroup.Items.Add(tbItemName.Text);
     }
}

VB.NET

Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
     If (Not IsPostBack) Then
          CreateNavBar()
     End If
End Sub

'Create NavBar initial structure. 
Private Sub CreateNavBar()
     Dim GroupTexts() As String = { "Home", "News", "Products", "Client Center" }
     For Each Text As String In GroupTexts
          MyASPxNavBar.Groups.Add(Text)
     Next Text
     MyASPxNavBar.Groups.FindByText("News").Items.Add("Subscriptions")
     Dim ProductsItems() As NavBarItem = { New NavBarItem("Downloads"), New NavBarItem("Support"), New NavBarItem("Order") }
     MyASPxNavBar.Groups.FindByText("Products").Items.Add(ProductsItems)
End Sub

'Add a new group
Protected Sub btnAddGroup_Click(ByVal sender As Object, ByVal e As EventArgs)
     If tbItemName.Text <> "" Then
          MyASPxNavBar.Groups.Add(tbItemName.Text)
     End If
End Sub

'Add a new item
Protected Sub btnAddItem_Click(ByVal sender As Object, ByVal e As EventArgs)
     If (MyASPxNavBar.ActiveGroup IsNot Nothing) AndAlso (tbItemName.Text <> "") Then
          MyASPxNavBar.ActiveGroup.Items.Add(tbItemName.Text)
     End If
End Sub

ASPX

<dx:ASPxNavBar ID="MyASPxNavBar" runat="server" AutoCollapse="True">
</dx:ASPxNavBar>
<dx:ASPxTextBox ID="tbItemName" runat="server" Width="170px">
</dx:ASPxTextBox>
<table>
     <tr>
          <td>
               <dx:ASPxButton ID="btnAddGroup" runat="server" onclick="btnAddGroup_Click" Text="Add Group">
               </dx:ASPxButton>
          </td>
          <td>
               <dx:ASPxButton ID="btnAddItem" runat="server" onclick="btnAddItem_Click" Text="Add Item">
               </dx:ASPxButton>
          </td>
     </tr>
</table>