Gérer les liens hypertexte dans la feuille de calcul

Cette rubrique explique quels types de liens hypertexte sont pris en charge dans Aspose.Cells.GridWeb et comment les gérer par programme. Les hyperliens peuvent être utilisés pour créer des liens vers des URL Web ou pour effectuer une publication sur un serveur.

Travailler avec des hyperliens

Types d’hyperliens

Généralement, les hyperliens suivants sont pris en charge par Aspose.Cells.GridWeb :

• Liens hypertexte URL, des hyperliens qui peuvent être liés à des URL Web.
• Liens hypertexte de texte, Liens hypertexte URL appliqués au texte.
• Liens hypertexte des images, liens hypertexte URL appliqués aux images.
• Cell hyperliens de commande, liens hypertexte qui envoient des données à un serveur. Ces hyperliens agissent davantage comme un bouton qui déclenche un événement côté serveur lorsqu’il est cliqué.

Les sections ci-dessous décrivent en détail l’utilisation de tous les types d’hyperliens. Il explique également comment accéder ou supprimer des liens.

Ajout d’hyperliens

Liens hypertexte URL

Les hyperliens URL ressemblent davantage à de simples hyperliens que vous voyez normalement sur les sites Web. Un lien hypertexte URL fonctionne comme une ancre dans une cellule. Chaque fois qu’il est cliqué, il navigue vers une page Web ou ouvre une nouvelle fenêtre de navigateur.

Il existe différents types d’hyperliens URL :

• Liens hypertexte de texte.
• Liens hypertexte des images.

Les développeurs peuvent spécifier une image pour le lien hypertexte. Si une image n’est pas spécifiée, un lien hypertexte texte est créé ; sinon, un lien hypertexte vers l’image est créé.

Liens hypertexte de texte

Pour ajouter un lien hypertexte vers une feuille de calcul :

1. Ajoutez le contrôle Aspose.Cells.GridWeb à votre formulaire Web.
2. Accéder à une feuille de calcul.
3. Ajoutez un lien hypertexte vers une cellule de la feuille de calcul.
4. Définissez le texte qui sera affiché dans la cellule.
5. Définissez l’URL du lien hypertexte.
6. Définissez la cible du lien hypertexte, si vous le souhaitez.
7. Définissez une info-bulle, si vous le souhaitez.

REMARQUE : La cible du lien hypertexte peut être définie sur_ soi,_top ou _parent pour ouvrir les URL Web respectivement dans une nouvelle fenêtre, la fenêtre actuelle ou la fenêtre supérieure.

L’exemple ci-dessous ajoute deux liens hypertexte à une feuille de calcul. L’un n’a pas de cible tandis que l’autre est défini sur _parent.

Sortie : liens hypertexte ajoutés à la feuille de calcul

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

Hyperliens d’images

Pour ajouter un lien hypertexte vers une image :

1. Ajoutez le contrôle Aspose.Cells.GridWeb à votre formulaire Web.
2. Accéder à une feuille de calcul.
3. Ajouter un lien hypertexte à une cellule.
4. Définissez l’URL de l’image qui sera affichée sous forme de lien hypertexte.
5. Définissez l’URL du lien hypertexte.
6. Définissez une info-bulle, si vous le souhaitez.
7. Définissez le texte du lien hypertexte, si vous le souhaitez.

Sortie : liens hypertexte d’image ajoutés à la feuille de calcul

La définition de l’AltText du lien hypertexte de l’image remplit une fonction similaire à la définition d’un balise dans HTML. Le texte s’affiche uniquement si l’image hyperliée n’est pas affichée. (Par exemple, si l’image ne se trouve pas à l’emplacement spécifié.) Si l’image du deuxième lien hypertexte est introuvable, la sortie de l’extrait de code ci-dessous se présentera comme suit.

L’image pour l’URL de l’image est introuvable

// 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 Hyperliens de commande

Un lien hypertexte de commande de cellule est un type spécial de lien hypertexte qui déclenche un événement côté serveur au lieu d’ouvrir une page Web. Les développeurs peuvent ajouter du code à l’événement côté serveur et effectuer n’importe quelle tâche lorsque le lien hypertexte est cliqué. Cette fonctionnalité permet aux développeurs de créer des applications plus interactives.

Pour ajouter un hyperlien de commande de cellule :

1. Ajoutez le contrôle Aspose.Cells.GridWeb à votre formulaire Web.
2. Accéder à une feuille de calcul.
3. Ajouter un lien hypertexte à une cellule.
4. Définissez la commande du lien hypertexte sur la valeur souhaitée. La valeur est utilisée par le gestionnaire d’événements du lien hypertexte pour le reconnaître.
5. Définissez une info-bulle, si vous le souhaitez.
6. Définissez l’URL de l’image qui sera affichée sous forme de lien hypertexte.

Un lien hypertexte de commande de cellule a été ajouté à la feuille de calcul

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

Gestion des événements des hyperliens de commande Cell

Les développeurs doivent créer un gestionnaire d’événements pour l’événement CellCommand du contrôle GridWeb afin d’effectuer des tâches spécifiques lorsqu’un lien hypertexte de commande de cellule spécifique est cliqué. Le gestionnaire d’événements de l’événement CellCommand fournit un objet de type CellEventArgs qui offre la propriété Argument. Utilisez la propriété Argument pour identifier un lien hypertexte spécifique en comparant sa valeur CellCommand.

L’exemple ci-dessous crée un gestionnaire d’événements pour le lien hypertexte de commande de cellule créé dans le code ci-dessus. Le CellCommand du lien hypertexte a été défini sur Click. Donc, dans le gestionnaire d’événements, vérifiez-le d’abord, puis ajoutez du code qui affiche un message dans la cellule A6.

Le gestionnaire d’événements est appelé lorsque le lien hypertexte est cliqué.

Sortie : texte ajouté à la cellule A6 lorsque le lien hypertexte est cliqué

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

Accéder aux hyperliens

Pour accéder à un lien hypertexte existant :

1. Accédez à la cellule qui le contient.
2. Obtenez la référence de la cellule.
3. Transmettez la référence à la méthode GetHyperlink de la collection Hyperlinks pour accéder au lien hypertexte.
4. Modifiez les propriétés du lien hypertexte.

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

Suppression des hyperliens

Pour supprimer un lien hypertexte :

1. Accéder à la feuille de calcul active.
2. Supprimez un lien hypertexte à l’aide de la méthode Remove de la collection 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});