Hantera hyperlänkar i kalkylblad

Det här ämnet diskuterar vilka typer av hyperlänkar som stöds i Aspose.Cells.GridWeb och hur man hanterar dem programmatiskt. Hyperlänkar kan användas för att antingen skapa länkar till webbadresser eller för att utföra återsändning 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 tillämpas på text.
• Bild hyperlänkar, URL-hyperlänkar tillämpas på bilder.
• Cell kommandohyperlänkar, hyperlänkar som skickar data till en server. Sådana hyperlänkar fungerar mer som en knapp som utlöser en händelse på serversidan när den klickas.

Avsnitten nedan beskriver användningen av alla typer av hyperlänkar i detalj. Den diskuterar också hur man kommer åt 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 ett ankare i en cell. När du klickar på den 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 texthyperlänk; annars skapas en bildhyperlänk.

Text hyperlänkar

Så här lägger du till en texthyperlänk till ett kalkylblad:

1. Lägg till Aspose.Cells.GridWeb-kontrollen till ditt webbformulär.
2. Få tillgång till ett arbetsblad.
3. Lägg till en hyperlänk till en cell i kalkylbladet.
4. Ställ in texten som ska visas i cellen.
5. Ställ in hyperlänkens URL.
6. Ställ in hyperlänkens mål, om så önskas.
7. Ställ in ett verktygstips om så önskas.

OBS: Hyperlänksmålet kan ställas in på_ själv,_top eller _parent för att öppna webbadresser i ett nytt, det aktuella respektive det översta fönstret.

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

Utdata: texthyperlänkar läggs 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];

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

Bildhyperlänkar

Så här lägger du till en bildhyperlänk:

1. Lägg till Aspose.Cells.GridWeb-kontrollen till ditt webbformulär.
2. Få tillgång till ett arbetsblad.
3. Lägg till en hyperlänk till en cell.
4. Ställ in webbadressen till bilden som ska visas som hyperlänk.
5. Ställ in hyperlänkens URL.
6. Ställ in ett verktygstips om så önskas.
7. Ställ in hyperlänkstexten om så önskas.

Utdata: bildhyperlänkar har lagts till i kalkylbladet

Att ställa in bildens hyperlänks AltText fyller en liknande funktion som att ställa in en taggen i HTML. Texten visas endast om den hyperlänkade bilden inte visas. (Till exempel om bilden inte finns på den angivna platsen.) Om bilden av den andra hyperlänken inte hittas, skulle utdata från kodavsnittet nedan se ut som följer.

Det gick inte att hitta bilden för bildens webbadress

// 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 Kommandohyperlänkar

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

Så här lägger du till en hyperlänk för ett cellkommando:

1. Lägg till Aspose.Cells.GridWeb-kontrollen till ditt webbformulär.
2. Få tillgång till ett arbetsblad.
3. Lägg till en hyperlänk till en cell.
4. Ställ in hyperlänkens kommando till valfritt värde. Värdet används av hyperlänkens händelsehanterare för att känna igen det.
5. Ställ in ett verktygstips om så önskas.
6. Ställ in URL:en 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 Cell kommandohyperlänkar

Utvecklare måste 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. CellCommand-händelsens händelsehanterare tillhandahåller ett objekt av typen CellEventArgs som erbjuder egenskapen Argument. Använd egenskapen Argument 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 cellkommandot hyperlänk skapad i koden ovan. Hyperlänkens CellCommand var inställd på Click. Så, i händelsehanteraren, kontrollera först den och lägg sedan till kod som visar ett meddelande i A6-cellen.

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

Utdata: text läggs till i A6-cellen 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 till hyperlänkar

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

1. Gå till 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

Så här tar du bort en hyperlänk:

1. Öppna det aktiva arbetsbladet.
2. Ta bort en hyperlänk med hjälp av Hyperlinks-samlingens Remove-metod.

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