Hyperlinks in Arbeitsblatt verwalten

Dieses Thema behandelt, welche Arten von Hyperlinks von Aspose.Cells.GridWeb unterstützt werden und wie man sie programmgesteuert verwaltet. Hyperlinks können entweder zum Erstellen von Links zu Web-URLs oder zum Ausführen von Postbacks an einen Server verwendet werden.

Arbeiten mit Hyperlinks

Arten von Hyperlinks

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

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

Die folgenden Abschnitte beschreiben die Verwendung aller Arten von Hyperlinks im Detail. Es wird auch erläutert, wie man Links zugreift oder entfernt.

Hinzufügen von Hyperlinks

URL-Hyperlinks

URL-Hyperlinks sehen eher wie einfache Hyperlinks aus, wie man sie normalerweise auf Websites sieht. Ein URL-Hyperlink funktioniert wie ein Anker in einer Zelle. Wenn darauf geklickt wird, navigiert er 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 festlegen. Wenn kein Bild festgelegt ist, wird ein Text-Hyperlink erstellt, andernfalls ein Bild-Hyperlink.

Text-Hyperlinks

Um einen Text-Hyperlink zu einem Arbeitsblatt hinzuzufügen:

1. Fügen Sie die Aspose.Cells.GridWeb-Steuerung Ihrem Webformular hinzu.
2. Greifen Sie auf ein Arbeitsblatt zu.
3. Fügen Sie einen Hyperlink zu einer Zelle im Arbeitsblatt 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 einen Tool-Tipp fest.

HINWEIS: Das Hyperlink-Ziel kann auf _self, _top oder _parent gesetzt werden, um Web-URLs in einem neuen, dem aktuellen oder dem obersten Fenster zu öffnen.

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

Output: Text-Hyperlinks zum Arbeitsblatt 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];

// 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

Um einen Bild-Hyperlink hinzuzufügen:

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

Ausgabe: Bild-Hyperlinks zum Arbeitsblatt hinzugefügt

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.

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);

Zellenbefehl-Hyperlinks

Ein Zellenbefehl-Hyperlink ist eine spezielle Art von Hyperlink, die anstelle einer Webseite ein serverseitiges Ereignis auslöst. Entwickler können Code zum serverseitigen Ereignis hinzufügen und jede Aufgabe ausführen, wenn auf den Hyperlink geklickt wird. Mit diesem Feature können Entwickler interaktivere Anwendungen erstellen.

Um einen Zellenbefehl-Hyperlink hinzuzufügen:

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

Ein Zellenbefehls-Hyperlink wurde zum Arbeitsblatt 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 Zellenbefehls-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. Der Ereignishandler des CellCommand-Ereignisses stellt ein Objekt vom Typ CellEventArgs bereit, das die Argument-Eigenschaft bietet. Verwenden Sie die Argument-Eigenschaft, um einen bestimmten Hyperlink anhand seines CellCommand-Werts zu identifizieren.

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

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

Ausgabe: Text wird zur Zelle A6 hinzugefügt, 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

Um auf einen vorhandenen Hyperlink zuzugreifen:

1. Greifen Sie auf die Zelle zu, die ihn enthält.
2. Erhalten Sie die Zellreferenz.
3. Übergeben Sie die Referenz an die GetHyperlink-Methode der Hyperlinks-Sammlung, 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";
} 

Hyperlinks entfernen

Um einen Hyperlink zu entfernen:

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

// 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});