Gérer les hyperliens dans la feuille de calcul

Ce sujet traite des types de hyperliens pris en charge dans Aspose.Cells.GridWeb et de comment les gérer de manière programmable. Les hyperliens peuvent être utilisés soit pour créer des liens vers des URL Web, soit pour effectuer un retour au serveur.

Travailler avec les hyperliens

Types de hyperliens

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

• Hyperliens URL, des hyperliens pouvant être liés à des URL Web.
• Hyperliens textuels, hyperliens URL appliqués au texte.
• Hyperliens d’images, hyperliens URL appliqués aux images.
• Hyperliens de commande de cellule, des hyperliens qui transmettent des données à un serveur. De tels 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 discute également de l’accès ou de la suppression des liens.

Ajout de liens hypertexte

Hyperliens URL

Les hyperliens URL ressemblent davantage à des hyperliens simples que vous voyez normalement sur les sites Web. Un hyperlien 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 :

• Hyperliens textuels.
• Hyperliens d’images.

Les développeurs peuvent spécifier une image pour l’hyperlien. Si aucune image n’est spécifiée, un hyperlien textuel est créé ; sinon, un hyperlien d’image est créé.

Liens hypertextes de texte

Pour ajouter un lien hypertexte à un classeur :

1. Ajoutez le contrôle Aspose.Cells.GridWeb à votre formulaire Web.
2. Accéder à une feuille de calcul.
3. Ajoutez un lien hypertexte à 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 désiré.
7. Définissez une info-bulle, si désiré.

REMARQUE : La cible du lien hypertexte peut être définie sur _self, _top ou _parent pour ouvrir les URL web dans une nouvelle, la fenêtre actuelle ou la fenêtre principale respectivement.

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

Sortie : hyperliens de texte 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";

Liens hypertextes d’image

Pour ajouter un lien hypertexte d’image :

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

Résultat: des liens hypertexte d’image ajoutés à la feuille de calcul

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.

L’image pour l’URL de l’image n’a pas pu être trouvée.

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

Liens hypertexte de commandes de cellules

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 lien hypertexte de commande de cellule :

1. Ajoutez le contrôle Aspose.Cells.GridWeb à votre formulaire Web.
2. Accéder à une feuille de calcul.
3. Ajoutez un lien hypertexte à une cellule.
4. Définissez la commande du lien hypertexte à n’importe quelle valeur désiré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 désiré.
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 liens hypertexte de commandes de cellules

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 de commande de cellule.

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. La commande de cellule du lien hypertexte a été définie sur Clic. Donc, dans le gestionnaire d’événements, vérifiez d’abord cela et ajoutez ensuite du code qui affiche un message dans la cellule A6.

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

Résultat: 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ès aux liens hypertexte

Pour accéder à un hyperlien 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 à l’hyperlien.
4. Modifiez les propriétés de l’hyperlien.

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

1. Accédez à la feuille de calcul active.
2. Supprimez un hyperlien à 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});