Hyperlinks im Arbeitsblatt verwalten

In diesem Thema wird erläutert, welche Arten von Hyperlinks in Aspose.Cells.GridWeb unterstützt werden und wie sie programmgesteuert verwaltet werden. Hyperlinks können entweder zum Erstellen von Links zu Web-URLs oder zum Durchführen von Postbacks zu einem Server verwendet werden.

Arbeiten mit Hyperlinks

Arten von Hyperlinks

Im Allgemeinen werden die folgenden Hyperlinks von Aspose.Cells.GridWeb unterstützt:

• URL-Hyperlinks, Hyperlinks, die mit Web-URLs verknüpft werden können.
• Text-Hyperlinks, auf Text angewendete URL-Hyperlinks.
• Bild-Hyperlinks, auf Bilder angewendete URL-Hyperlinks.
• Cell Befehls-Hyperlinks, Hyperlinks, die Daten an einen Server senden. Solche Hyperlinks verhalten sich eher wie eine Schaltfläche, die beim Klicken ein serverseitiges Ereignis auslöst.

In den folgenden Abschnitten wird die Verwendung aller Arten von Hyperlinks im Detail beschrieben. Außerdem wird erläutert, wie auf Links zugegriffen oder diese entfernt werden.

Hinzufügen von Hyperlinks

URL-Hyperlinks

URL-Hyperlinks sehen eher wie einfache Hyperlinks aus, die Sie normalerweise auf Websites sehen. Ein URL-Hyperlink funktioniert wie ein Anker in einer Zelle. Immer wenn es angeklickt wird, navigiert es zu einer Webseite oder öffnet ein neues Browserfenster.

Es gibt verschiedene Arten von URL-Hyperlinks:

• Text-Hyperlinks.
• Bild-Hyperlinks.

Entwickler können ein Bild für den Hyperlink angeben. Wenn kein Bild angegeben ist, wird ein Text-Hyperlink erstellt; andernfalls wird ein Bild-Hyperlink erstellt.

Text-Hyperlinks

So fügen Sie einem Arbeitsblatt einen Text-Hyperlink hinzu:

1. Fügen Sie Ihrem Webformular das Steuerelement Aspose.Cells.GridWeb hinzu.
2. Greifen Sie auf ein Arbeitsblatt zu.
3. Fügen Sie einer Zelle im Arbeitsblatt einen Hyperlink hinzu.
4. Legen Sie den Text fest, der in der Zelle angezeigt wird.
5. Legen Sie die URL des Hyperlinks fest.
6. Legen Sie bei Bedarf das Ziel des Hyperlinks fest.
7. Legen Sie bei Bedarf eine QuickInfo fest.

HINWEIS: Das Hyperlink-Ziel kann auf eingestellt werden_ selbst,_top oder _parent zum Öffnen von Web-URLs in einem neuen, aktuellen oder obersten Fenster.

Im folgenden Beispiel werden einem Arbeitsblatt zwei Hyperlinks hinzugefügt. Einer hat kein Ziel, während der andere auf _parent gesetzt ist.

Ausgabe: Text-Hyperlinks, die dem Arbeitsblatt hinzugefügt wurden

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adds a text hyperlink that goes to Aspose site and opens in new window
int linkIndex = sheet.Hyperlinks.Add("B1", "http://www.aspose.com");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];
link1.Target = "_blank";

// Setting text and tool tip of the hyperlink
link1.TextToDisplay = "Aspose";
link1.ScreenTip = "Open Aspose Web Site in new window";
 
// Adding hyperlink to the worksheet to open in parent window
linkIndex = sheet.Hyperlinks.Add("B2", "http://www.aspose.com/docs/display/cellsnet/Aspose.Cells.GridWeb");
GridHyperlink link2 = sheet.Hyperlinks[linkIndex];
link2.Target = "_parent";

// Setting text and tool tip of the hyperlink
link2.TextToDisplay = "Aspose.Grid Docs";
link2.ScreenTip = "Open Aspose.Grid Docs in parent window";

Bild-Hyperlinks

So fügen Sie einen Bild-Hyperlink hinzu:

1. Fügen Sie Ihrem Webformular das Steuerelement Aspose.Cells.GridWeb hinzu.
2. Greifen Sie auf ein Arbeitsblatt zu.
3. Fügen Sie einer Zelle einen Hyperlink hinzu.
4. Legen Sie die URL des Bildes fest, das als Hyperlink angezeigt wird.
5. Legen Sie die Hyperlink-URL fest.
6. Legen Sie bei Bedarf eine QuickInfo fest.
7. Legen Sie bei Bedarf den Hyperlink-Text fest.

Ausgabe: Bild-Hyperlinks zum Arbeitsblatt hinzugefügt

Das Festlegen des AltText des Bild-Hyperlinks erfüllt eine ähnliche Funktion wie das Festlegen von an Tag in HTML. Der Text wird nur angezeigt, wenn das verlinkte Bild nicht angezeigt wird. (Beispielsweise, wenn sich das Bild nicht an der angegebenen Position befindet.) Wenn das Bild des zweiten Hyperlinks nicht gefunden wird, würde die Ausgabe des folgenden Codeausschnitts wie folgt aussehen.

Das Bild für die Bild-URL konnte nicht gefunden werden

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adding hyperlink to the worksheet
int linkIndex = sheet.Hyperlinks.Add("B5", "http://www.aspose.com");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];
link1.Target = "_blank";

// Setting Image URL and tool tip of hyperlink
link1.ImageURL = "../Images/Aspose.Banner.gif";
link1.ScreenTip = "Open Aspose Web Site in new window";

// Adding hyperlink to the worksheet
linkIndex = sheet.Hyperlinks.Add("B6", "http://www.aspose.com/docs/display/cellsnet/Aspose.Cells.GridWeb");
GridHyperlink link2 = sheet.Hyperlinks[linkIndex];
link2.Target = "_blank";

// Setting URL, tool tip and alt text of hyperlink
link2.ImageURL = "../Images/Aspose.Grid.gif";
link2.ScreenTip = "Open Aspose.Grid Docs in new window";
link2.AltText = "Open Aspose.Grid Docs in new window";

// Resize the rows to display image nicely
sheet.Cells.SetRowHeight(4, 40);
sheet.Cells.SetRowHeight(5, 40);

Cell Befehls-Hyperlinks

Ein Zellenbefehls-Hyperlink ist eine spezielle Art von Hyperlink, der ein serverseitiges Ereignis auslöst, anstatt eine Webseite zu öffnen. Entwickler können dem serverseitigen Ereignis Code hinzufügen und jede Aufgabe ausführen, wenn auf den Hyperlink geklickt wird. Diese Funktion ermöglicht es Entwicklern, interaktivere Anwendungen zu erstellen.

So fügen Sie einen Zellbefehl-Hyperlink hinzu:

1. Fügen Sie Ihrem Webformular das Steuerelement Aspose.Cells.GridWeb hinzu.
2. Greifen Sie auf ein Arbeitsblatt zu.
3. Fügen Sie einer Zelle einen Hyperlink hinzu.
4. Setzen Sie den Befehl des Hyperlinks auf einen beliebigen gewünschten Wert. Der Wert wird vom Ereignishandler des Hyperlinks verwendet, um ihn zu erkennen.
5. Legen Sie bei Bedarf eine QuickInfo fest.
6. Legen Sie die URL für das Bild fest, das als Hyperlink angezeigt wird.

Dem Arbeitsblatt wurde ein Zellenbefehls-Hyperlink hinzugefügt

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adding hyperlink to the worksheet
int linkIndex = sheet.Hyperlinks.Add("B8", "");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];

// Setting the cell command, tool tip and image URL for the hyperlink
link1.Command = "Click";
link1.ScreenTip = "Click Here";
link1.ImageURL = "../Images/button.jpg";

// Resize the row to display image nicely
sheet.Cells.SetRowHeight(7, 30);

Ereignisbehandlung von Cell-Befehls-Hyperlinks

Entwickler müssen einen Ereignishandler für das CellCommand-Ereignis des GridWeb-Steuerelements erstellen, um bestimmte Aufgaben auszuführen, wenn auf einen bestimmten Zellenbefehls-Hyperlink geklickt wird. Die Ereignisbehandlungsroutine des CellCommand-Ereignisses stellt ein Objekt vom Typ CellEventArgs bereit, das die Argument-Eigenschaft bereitstellt. Verwenden Sie die Argument-Eigenschaft, um einen bestimmten Hyperlink zu identifizieren, indem Sie seinen CellCommand-Wert vergleichen.

Das folgende Beispiel erstellt einen Ereignishandler für den im obigen Code erstellten Zellenbefehls-Hyperlink. Der CellCommand des Hyperlinks wurde auf Click gesetzt. Überprüfen Sie es also im Ereignishandler zuerst und fügen Sie dann Code hinzu, der eine Nachricht in der A6-Zelle anzeigt.

Der Ereignishandler wird aufgerufen, wenn auf den Hyperlink geklickt wird.

Ausgabe: Text, der der A6-Zelle hinzugefügt wird, wenn auf den Hyperlink geklickt wird

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Event Handler for CellCommand event
protected void GridWeb1_CellCommand(object sender, Aspose.Cells.GridWeb.CellEventArgs e)
{
    // Checking the CellCommand of the hyperlink
    if (e.Argument.Equals("Click"))
    {
        // Accessing the reference of the worksheet that is currently active
        GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

        // Adding value to "C8" cell
        sheet.Cells["C8"].PutValue("Cell Command Hyperlink Clicked");

        // Resize the column to display message nicely
        sheet.Cells.SetColumnWidth(2, 250);
    }
}

Zugriff auf Hyperlinks

So greifen Sie auf einen vorhandenen Hyperlink zu:

1. Greifen Sie auf die Zelle zu, die es enthält.
2. Holen Sie sich den Zellbezug.
3. Übergeben Sie den Verweis an die GetHyperlink-Methode der Hyperlinks-Auflistung, um auf den Hyperlink zuzugreifen.
4. Ändern Sie die Eigenschaften des Hyperlinks.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Accessing a specific cell that contains hyperlink
GridCell cell = sheet.Cells["B1"];

// Accessing the hyperlink from the specific cell
GridHyperlink link = sheet.Hyperlinks.GetHyperlink(cell);

if (link != null)
{
    // Modifying the text and URL of hyperlink
    link.TextToDisplay = "Aspose.Blogs";
    link.Address = "http://www.aspose.com/Community/Blogs";
} 

Entfernen von Hyperlinks

So entfernen Sie einen Hyperlink:

1. Greifen Sie auf das aktive Arbeitsblatt zu.
2. Entfernen Sie einen Hyperlink mit der Remove-Methode der Hyperlinks-Auflistung.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
            
// Removing hyperlink from the specific cell         
sheet.Hyperlinks.Remove(new Data.GridCellArea() {StartRow = 0, EndRow = 0, StartColumn = 1, EndColumn = 1});