ワークシートでハイパーリンクを管理する

このトピックでは、Aspose.Cells.GridWebでサポートされているハイパーリンクの種類とそれらをプログラムで管理する方法について説明します。 ハイパーリンクはWeb URLへのリンクを作成したり、サーバーへのポストバックを実行したりするために使用できます。

ハイパーリンクの操作

ハイパーリンクの種類

一般的に、Aspose.Cells.GridWebでサポートされているハイパーリンクの種類は次のとおりです：

• URLハイパーリンク、Web URLにリンクできるハイパーリンク。
• テキストハイパーリンク、テキストに適用されたURLハイパーリンク。
• 画像ハイパーリンク、画像に適用されたURLハイパーリンク。
• セルコマンドハイパーリンク、サーバーにデータを送信するハイパーリンク。 このようなハイパーリンクは、クリックしたときにサーバーサイドイベントをトリガーするボタンのような役割を果たします。

以下のセクションでは、すべての種類のハイパーリンクの使用方法について詳しく説明します。また、リンクにアクセスしたり削除したりする方法についても説明します。

ハイパーリンクの追加

URLハイパーリンク

URLハイパーリンクは、通常ウェブサイトで見ることができるシンプルなハイパーリンクのように見えます。URLハイパーリンクはセル内のアンカーのように機能します。クリックすると、ウェブページに移動したり、新しいブラウザウィンドウが開かれます。

異なる種類のURLハイパーリンクがあります:

• テキストハイパーリンク。
• 画像ハイパーリンク。

開発者は、ハイパーリンクのための画像を指定できます。画像が指定されていない場合、テキストハイパーリンクが作成されます。それ以外の場合は、画像ハイパーリンクが作成されます。

テキストハイパーリンク

ワークシートにテキストハイパーリンクを追加するには:

1. Aspose.Cells.GridWebコントロールをWebフォームに追加します。
2. ワークシートにアクセスします。
3. ワークシートのセルにハイパーリンクを追加します。
4. セルに表示されるテキストを設定します。
5. ハイパーリンクのURLを設定します。
6. 必要に応じて、ハイパーリンクのターゲットを設定します。
7. 必要に応じてツールヒントを設定します。

注: ハイパーリンクのターゲットは、ウェブURLを新しいウィンドウ、現在のウィンドウ、またはトップウィンドウで開くために、それぞれ_self、_top、_parentに設定できます。

以下の例は、ワークシートに2つのハイパーリンクを追加します。一つはターゲットが指定されていない状態で、もう一つは_parentに設定されています。

出力: ワークシートにテキストハイパーリンクが追加されました

画像ハイパーリンク

画像ハイパーリンクを追加するには:

1. Aspose.Cells.GridWebコントロールをWebフォームに追加します。
2. ワークシートにアクセスします。
3. セルにハイパーリンクを追加します。
4. ハイパーリンクとして表示される画像のURLを設定します。
5. ハイパーリンクのURLを設定します。
6. 必要に応じてツールヒントを設定します。
7. 必要に応じて、ハイパーリンクのテキストを設定します。

出力: ワークシートに画像ハイパーリンクが追加されました

Setting the image hyperlink’s AltText fills a similar function as setting an tag in HTML. The text is displayed only if the hyperlinked image is not displayed. (For example, if the image isn’t at the specified location.) If the image of the second hyperlink is not found, the output of the code snippet below would look as follows.

画像のURLに対応する画像は見つかりませんでした

セルコマンドハイパーリンク

セルコマンドハイパーリンクは、ウェブページを開く代わりにサーバーサイドのイベントをトリガーする特別なハイパーリンクの種類です。開発者は、サーバーサイドイベントにコードを追加し、ハイパーリンクがクリックされたときに任意のタスクを実行できます。この機能により、開発者はよりインタラクティブなアプリケーションを作成することができます。

セルコマンドハイパーリンクを追加する:

1. Aspose.Cells.GridWebコントロールをWebフォームに追加します。
2. ワークシートにアクセスします。
3. セルにハイパーリンクを追加します。
4. ハイパーリンクのコマンドを任意の値に設定します。 その値は、ハイパーリンクのイベントハンドラーがそれを認識するために使用されます。
5. 必要に応じてツールヒントを設定します。
6. ハイパーリンクとして表示される画像のURLを設定します。

ワークシートにセルコマンドハイパーリンクが追加されました

セルコマンドハイパーリンクのイベントハンドリング

特定のセルコマンドハイパーリンクがクリックされたときに特定のタスクを実行するために、開発者はGridWebコントロールのCellCommandイベントのイベントハンドラーを作成する必要があります。CellCommandイベントのイベントハンドラーは、Argumentプロパティを提供するCellEventArgs型のオブジェクトを提供します。Argumentプロパティを使用して、CellCommandの値を比較して特定のハイパーリンクを識別します。

以下の例では、上記のコードで作成されたセルコマンドハイパーリンクに対するイベントハンドラーを作成します。 ハイパーリンクのCellCommandがClickに設定されていたので、イベントハンドラーではまずそれを確認し、その後、A6セルにメッセージを表示するコードを追加します。

ハイパーリンクがクリックされたときにイベントハンドラーが呼び出されます。

出力: ハイパーリンクがクリックされたときにA6セルにテキストが追加されます

ハイパーリンクのアクセス

既存のハイパーリンクにアクセスするには:

1. それを含むセルにアクセスします。
2. セルの参照を取得します。
3. ハイパーリンクのプロパティを変更します。
4. ハイパーリンクコレクションのGetHyperlinkメソッドに参照を渡してハイパーリンクにアクセスします。

ハイパーリンクの削除

ハイパーリンクを削除するには:

1. アクティブなワークシートにアクセスします。
2. HyperlinksコレクションのRemoveメソッドを使用してハイパーリンクを削除します。