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

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.

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

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é

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.

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.