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

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

ハイパーリンクの操作

ハイパーリンクの種類

通常、Aspose.Cells.GridWeb では次のハイパーリンクがサポートされています。

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

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

ハイパーリンクの追加

URL ハイパーリンク

URL ハイパーリンクは、Web サイトで通常見られる単純なハイパーリンクに似ています。 URL ハイパーリンクは、セル内のアンカーのように機能します。クリックするたびに、Web ページに移動するか、新しいブラウザー ウィンドウが開きます。

URL ハイパーリンクにはさまざまな種類があります。

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

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

テキスト ハイパーリンク

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

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

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

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

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

画像ハイパーリンク

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

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

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

画像ハイパーリンクの AltText を設定すると、 HTML のタグ。テキストは、ハイパーリンクされた画像が表示されていない場合にのみ表示されます。 (たとえば、画像が指定された場所にない場合。) 2 番目のハイパーリンクの画像が見つからない場合、以下のコード スニペットの出力は次のようになります。

画像 URL の画像が見つかりませんでした

Cell コマンド ハイパーリンク

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

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

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

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

Cell コマンド ハイパーリンクのイベント処理

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

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

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

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

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

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

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

ハイパーリンクの削除

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

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