Hantera hyperlänkar i kalkylblad

Detta ämne diskuterar vilka typer av hyperlänkar som stöds i Aspose.Cells.GridWeb och hur man hanterar dem programmatiskt. Hyperlänkar kan användas antingen för att skapa länkar till webbadresser eller för att utföra återuppringning till en server.

Arbeta med hyperlänkar

Typer av hyperlänkar

I allmänhet stöds följande hyperlänkar av Aspose.Cells.GridWeb:

• URL-hyperlänkar, hyperlänkar som kan länkas till webbadresser.
• Text hyperlänkar, URL-hyperlänkar som tillämpas på text.
• Bild hyperlänkar, URL-hyperlänkar tillämpade på bilder.
• Cellkommandohyperlänkar, hyperlänkar som skickar data till en server. Sådana hyperlänkar fungerar mer som en knapp som utlöser en serverhändelse när de klickas.

Nedan avsnitt beskriver användningen av alla typer av hyperlänkar i detalj. Det diskuterar också hur man får åtkomst till eller tar bort länkar.

Lägga till hyperlänkar

URL-hyperlänkar

URL-hyperlänkar ser mer ut som enkla hyperlänkar som du normalt ser på webbplatser. En URL-hyperlänk fungerar som en ankarpunkt i en cell. När den klickas navigerar den till en webbsida eller öppnar ett nytt webbläsarfönster.

Det finns olika typer av URL-hyperlänkar:

• Text hyperlänkar.
• Bild hyperlänkar.

Utvecklare kan ange en bild för hyperlänken. Om en bild inte anges skapas en text hyperlänk; annars skapas en bildhyperlänk.

Text Hyperlinks

För att lägga till en text hyperlänk i ett kalkylblad:

1. Lägg till Aspose.Cells.GridWeb-kontrollen i ditt webbformulär.
2. Hämta ett arbetsblad.
3. Lägg till en hyperlänk i en cell i kalkylarket.
4. Ange den text som ska visas i cellen.
5. Ange hyperlänkens URL.
6. Ange hyperlänkens mål, om så önskas.
7. Ange en verktygstips, om så önskas.

OBS: Hyperlänkens mål kan anges som _self, _top eller _parent för att öppna webbadresser i ett nytt, det aktuella eller det översta fönstret respektive.

Exemplet nedan lägger till två hyperlänkar till ett kalkylblad. En har inget mål medan den andra är inställd på _parent.

Utmatning: text hyperlänkar tillagt i kalkylbladet

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

För att lägga till en bildhyperlänk:

1. Lägg till Aspose.Cells.GridWeb-kontrollen i ditt webbformulär.
2. Hämta ett arbetsblad.
3. Lägg till en hyperlänk i en cell.
4. Ange URL:en för bilden som ska visas som hyperlänk.
5. Ange hyperlänkens URL.
6. Ange en verktygstips, om så önskas.
7. Ange hyperlänkens text, om så önskas.

Output: bildhyperlänkar tillagda i kalkylarket

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.

Bilden för bild-URL:en kunde inte hittas

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

Cellkommandohyperlänkar

En cellkommandohyperlänk är en speciell typ av hyperlänk som utlöser en serverhändelse istället för att öppna en webbsida. Utvecklare kan lägga till kod till serverhändelsen och utföra vilken uppgift som helst när hyperlänken klickas på. Denna funktion gör att utvecklare kan skapa mer interaktiva applikationer.

För att lägga till en cellkommandohyperlänk:

1. Lägg till Aspose.Cells.GridWeb-kontrollen i ditt webbformulär.
2. Hämta ett arbetsblad.
3. Lägg till en hyperlänk i en cell.
4. Ange kommandot för hyperlänken till önskat värde. Värdet används av hyperlänkens händelsehanterare för att känna igen det.
5. Ange en verktygstips, om så önskas.
6. Ange URL för bilden som ska visas som en hyperlänk.

En cellkommandohyperlänk har lagts till i kalkylbladet

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

Händelsehantering av cellkommandohyperlänkar

Utvecklare behöver skapa en händelsehanterare för GridWeb-kontrollens CellCommand-händelse för att utföra specifika uppgifter när en specifik cellkommandohyperlänk klickas på. CellCommand-händelsens händelsehanterare tillhandahåller ett objekt av typen CellEventArgs som erbjuder egenskapen Argument. Använd Argument-egenskapen för att identifiera en specifik hyperlänk genom att jämföra dess CellCommand-värde.

Exemplet nedan skapar en händelsehanterare för cellkommandohyperlänken som skapades i koden ovan. Hyperlänkens CellCommand var inställd på Klicka. Så, i händelsehanteraren, kontrollera först det och lägg sedan till kod som visar ett meddelande i cellen A6.

Händelsehanteraren aktiveras när hyperlänken klickas.

Resultat: text tillagd i cellen A6 när hyperlänken klickas

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

Åtkomst av hyperlänkar

För att komma åt en befintlig hyperlänk:

1. Åtkomst cellen som innehåller den.
2. Hämta cellreferensen.
3. Skicka referensen till Hyperlinks-samlingens GetHyperlink-metod för att komma åt hyperlänken.
4. Ändra hyperlänkens egenskaper.

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

Ta bort hyperlänkar

För att ta bort en hyperlänk:

1. Åtkomst till aktivt kalkylblad.
2. Ta bort en hyperlänk med hjälp av Remove-metoden i Hyperlinks-samlingen.

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