Gestisci i collegamenti ipertestuali nel foglio di lavoro

Questo argomento illustra quali tipi di collegamenti ipertestuali sono supportati in Aspose.Cells.GridWeb e come gestirli a livello di codice. I collegamenti ipertestuali possono essere utilizzati per creare collegamenti a URL Web o per eseguire il postback su un server.

Lavorare con i collegamenti ipertestuali

Tipi di collegamenti ipertestuali

Generalmente, i seguenti collegamenti ipertestuali sono supportati da Aspose.Cells.GridWeb:

• Collegamenti ipertestuali dell’URL, collegamenti ipertestuali che possono essere collegati a URL Web.
• Collegamenti ipertestuali di testo, collegamenti ipertestuali URL applicati al testo.
• Collegamenti ipertestuali delle immagini, collegamenti ipertestuali URL applicati alle immagini.
• Cell collegamenti ipertestuali di comando, collegamenti ipertestuali che inviano dati a un server. Tali collegamenti ipertestuali agiscono più come un pulsante che attiva un evento lato server quando viene cliccato.

Le sezioni seguenti descrivono in dettaglio l’uso di tutti i tipi di collegamenti ipertestuali. Discute anche su come accedere o rimuovere i link.

Aggiunta di collegamenti ipertestuali

Collegamenti ipertestuali dell’URL

I collegamenti ipertestuali URL assomigliano più a semplici collegamenti ipertestuali che si vedono normalmente sui siti web. Un collegamento ipertestuale URL funziona come un’ancora in una cella. Ogni volta che viene cliccato, naviga verso una pagina web o apre una nuova finestra del browser.

Esistono diversi tipi di collegamenti ipertestuali URL:

• Collegamenti ipertestuali di testo.
• Collegamenti ipertestuali delle immagini.

Gli sviluppatori possono specificare un’immagine per il collegamento ipertestuale. Se non viene specificata un’immagine, viene creato un collegamento ipertestuale di testo; altrimenti viene creato un collegamento ipertestuale immagine.

Collegamenti ipertestuali di testo

Per aggiungere un collegamento ipertestuale di testo a un foglio di lavoro:

1. Aggiungere il controllo Aspose.Cells.GridWeb al Web Form.
2. Accedi a un foglio di lavoro.
3. Aggiungere un collegamento ipertestuale a una cella nel foglio di lavoro.
4. Imposta il testo che verrà mostrato nella cella.
5. Imposta l’URL del collegamento ipertestuale.
6. Impostare la destinazione del collegamento ipertestuale, se lo si desidera.
7. Impostare una descrizione comandi, se lo si desidera.

NOTA: la destinazione del collegamento ipertestuale può essere impostata su_ se stesso,_top o _parent per aprire rispettivamente gli URL web in una finestra nuova, corrente o in alto.

L’esempio seguente aggiunge due collegamenti ipertestuali a un foglio di lavoro. Uno non ha target mentre l’altro è impostato su _parent.

Output: collegamenti ipertestuali di testo aggiunti al foglio di lavoro

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

Collegamenti ipertestuali delle immagini

Per aggiungere un collegamento ipertestuale all’immagine:

1. Aggiungere il controllo Aspose.Cells.GridWeb al Web Form.
2. Accedi a un foglio di lavoro.
3. Aggiungere un collegamento ipertestuale a una cella.
4. Imposta l’URL dell’immagine che verrà visualizzata come collegamento ipertestuale.
5. Imposta l’URL del collegamento ipertestuale.
6. Impostare una descrizione comandi, se lo si desidera.
7. Impostare il testo del collegamento ipertestuale, se lo si desidera.

Output: collegamenti ipertestuali immagine aggiunti al foglio di lavoro

L’impostazione dell’AltText del collegamento ipertestuale dell’immagine svolge una funzione simile all’impostazione di an tag in HTML. Il testo viene visualizzato solo se l’immagine con collegamento ipertestuale non viene visualizzata. (Ad esempio, se l’immagine non si trova nella posizione specificata.) Se l’immagine del secondo collegamento ipertestuale non viene trovata, l’output del frammento di codice seguente avrà il seguente aspetto.

Impossibile trovare l’immagine per l’URL dell’immagine

// 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 Comando Collegamenti ipertestuali

Un collegamento ipertestuale di comando cella è un tipo speciale di collegamento ipertestuale che attiva un evento sul lato server invece di aprire una pagina Web. Gli sviluppatori possono aggiungere codice all’evento lato server ed eseguire qualsiasi attività quando si fa clic sul collegamento ipertestuale. Questa funzione consente agli sviluppatori di creare più applicazioni interattive.

Per aggiungere un collegamento ipertestuale al comando di cella:

1. Aggiungere il controllo Aspose.Cells.GridWeb al Web Form.
2. Accedi a un foglio di lavoro.
3. Aggiungere un collegamento ipertestuale a una cella.
4. Impostare il comando del collegamento ipertestuale su qualsiasi valore desiderato. Il valore viene utilizzato dal gestore dell’evento del collegamento ipertestuale per riconoscerlo.
5. Impostare una descrizione comandi, se lo si desidera.
6. Imposta l’URL per l’immagine che verrà visualizzata come collegamento ipertestuale.

Un collegamento ipertestuale di comando cella è stato aggiunto al foglio di lavoro

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

Gestione degli eventi dei collegamenti ipertestuali di comando Cell

Gli sviluppatori devono creare un gestore eventi per l’evento CellCommand del controllo GridWeb per eseguire attività specifiche quando si fa clic su un collegamento ipertestuale di comando cella specifico. Il gestore dell’evento dell’evento CellCommand fornisce un oggetto del tipo CellEventArgs che offre la proprietà Argument. Utilizzare la proprietà Argument per identificare un collegamento ipertestuale specifico confrontandone il valore CellCommand.

L’esempio seguente crea un gestore eventi per il collegamento ipertestuale del comando cella creato nel codice precedente. Il CellCommand del collegamento ipertestuale è stato impostato su Click. Quindi, nel gestore dell’evento, prima controllalo e poi aggiungi il codice che visualizza un messaggio nella cella A6.

Il gestore dell’evento viene richiamato quando si fa clic sul collegamento ipertestuale.

Output: testo aggiunto alla cella A6 quando si fa clic sul collegamento ipertestuale

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

Accesso ai collegamenti ipertestuali

Per accedere a un collegamento ipertestuale esistente:

1. Accedi alla cella che lo contiene.
2. Ottieni il riferimento di cella.
3. Passare il riferimento al metodo GetHyperlink della raccolta Hyperlinks per accedere al collegamento ipertestuale.
4. Modifica le proprietà del collegamento ipertestuale.

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

Rimozione di collegamenti ipertestuali

Per rimuovere un collegamento ipertestuale:

1. Accedi al foglio di lavoro attivo.
2. Rimuovere un collegamento ipertestuale utilizzando il metodo Remove della raccolta 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];
            
// Removing hyperlink from the specific cell         
sheet.Hyperlinks.Remove(new Data.GridCellArea() {StartRow = 0, EndRow = 0, StartColumn = 1, EndColumn = 1});