The requested page is not available for the requested platform. You are viewing the content for Default platform.

XRControl.Bookmark Property

Bindable. Gets or sets the text of a bookmark for this control.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v19.1.dll

Declaration

[SRCategory(ReportStringId.CatNavigation)]
public virtual string Bookmark { get; set; }
<SRCategory(ReportStringId.CatNavigation)>
Public Overridable Property Bookmark As String

Property Value

Type Description
String

A String representing the bookmark's text which is shown in the report's document map.

Remarks

Use this property to specify the string shown as a bookmark's text. Note, that the Bookmark property is bindable. This means that an XRControl object can have several bookmark instances shown in the report's document map. Also, set the XRControl.BookmarkParent property to specify a parent bookmark for the current bookmark. These two properties are used to create a report's document map.

For more information on using bookmarks in XtraReports see the Adding Bookmarks and a Document Map document.

Note

The Bookmark property is bindable, which means that it can be bound to a data field in a report's data source. To learn more, see the Binding Report Controls to Data section.

Not all descendants of the XRControl class use the Bookmark property. For example, the Band class descendants ignore the Bookmark property.

Examples

This example demonstrates how to create a document map with bookmarks for each page in a report.

To implement a document map in your report, do the following.

  1. To create a table report, start with a report that is bound to the "Products" table of the sample Northwind database (the nwind.mdb file included in the XtraReports installation). To learn more about binding a report to a data source, see Providing Data to Reports.
  2. Set the report's XtraReport.Bookmark property to "Table of Contents".

    HowTo_AddBookmark5

  3. To create the report's main content, drop the ProductName field from the Field List onto the report's Detail band.

    How to - GroupData_3

  4. Insert a ReportHeaderBand. To do this, right-click anywhere in the report designer, and in the invoked context menu point to Insert Band, and then click ReportHeader.

    Shared_BandsAddReportHeader

    Drop an XRLabel control on the Report Header and set its XRControl.Bookmark and XRControl.Text properties to "Home".

    HowTo_Bookmarks_0

  5. Insert a PageHeaderBand. To do this, right-click anywhere in the report designer, and in the context menu, point to Insert Band, and then click PageHeader.

    Shared_BandsAddPageHeader

    Drop an XRLabel control on the Page Header. Then, set its XRControl.Bookmark and XRControl.Text properties to "Page", and the XRControl.BookmarkParent property to the Home label.

    HowTo_Bookmarks_1

    Next, handle the Page lable's XRControl.PrintOnPage event as follows.

using System;
using DevExpress.XtraReports.UI;
// ...

private void xrLabel3_PrintOnPage(object sender, PrintOnPageEventArgs e) {
    // Obtain the current page number.
    string s = (e.PageIndex + 1).ToString();

    // Set the label's text and bookmark (this label is located on the PageHeader
    // band, so it will show a bookmark for every report page
    ((XRLabel)sender).Bookmark += s;
    ((XRLabel)sender).Text += s;
}
See Also