コードを使用したブックマーク

コードを使用したブックマーク(Interaction.Bookmark)プロパティを使用すると、レポート内のブックマークの非常に複雑な構造を形成できます。しかし、このプロパティだけでは不十分な場合があります。例えば、Interaction.Bookmark プロパティを使用せずに、ブックマークのツリーにノードを追加する必要があります。あるいは、ブックマークを別のレベルのネストに配置する必要があります。Stimulsoft ReportsのInteraction.Bookmarkプロパティを使用することができます。これは不可視のプロパティで、コードからしか利用できません。このプロパティを使用するのは非常に簡単です。例えば、ネストの最初のレベルのブックマークを追加するには、次のコードを使用できます。

Bookmark.Add(“My Bookmark”);

このコードは、ブックマークのツリーにこのブックマークを作成します。

2階層目のブックマークをツリーに追加するには、次のようなコードを記述する必要がある。

Bookmark[“My Bookmark”].Add(“Bookmark Level2”);

…そして第三階層の場合:

Bookmark[“My Bookmark”][“Level2”].Add(“Bookmark Level3”);

3つのブックマークすべてを作成するには、上記のコードサンプルを使用できます。Stimulsoft Reportsは、ツリー内の各ブックマークの存在を自動的にチェックし、追加する必要のあるブックマークを追加します。ブックマークを使ってナビゲーションを整理することが必要な場合があります。コンポーネントを見つける必要がある場合、これらのコンポーネントのInteraction.Bookmarkプロパティを記録する必要があります。Interaction.Bookmarkプロパティの値は、作成されたブックマークの名前と同じである必要があります。例えば、ブックマークを追加します。

Booking.Add(Customers.CompanyName);

したがって、Interaction.Bookmarkプロパティの値は次のようになります。

{Customers.CompanyName}

その結果、すべてのコンポーネントに会社名のブックマークが付けられます。同じ会社名がレポートツリーに追加されます。また、レポートツリーのブックマークノードをクリックすると、すべてのコンポーネントが表示されます。