La DLL ASP.NET est également un objet COM, ce qui signifie que l'ensemble API GrabzIt ASP.NET peut être utilisé dans de nombreux environnements, tant que l'ordinateur cible a également installé le .NET Framework complet. Par exemple, il peut être utilisé pour prendre une capture d'écran Web à partir d'une macro, CScript, JScript, ASP classique, programme C ++ ou tout autre langage de programmation compatible COM.

Mise en marche

Pour commencer à utiliser GrabzIt comme objet COM, installez d'abord le . NET Framework puis télécharger le Bibliothèque ASP.NET. Ensuite, extrayez les fichiers RegisterCOM.bat et GrabzIt.dll into même répertoire que votre application.

Ensuite, l'objet COM GrabzIt doit être enregistré, cela peut être fait en utilisant le regasm.exe comme d'habitude. Ou vous pouvez utiliser le RegisterCOM.bat fichier. Faites un clic droit sur RegisterCOM.bat et sélectionnez Exécuter en tant qu'administrateur. Choisissez ensuite d'enregistrer l'objet COM en tant que composant binaire 64 ou 32. Vérifiez que la sortie du fichier bat indique que l'objet COM a été correctement enregistré avant de fermer la fenêtre.

Exemples d'utilisation de l'objet COM GrabzIt

Une fois la DLL enregistrée, vous ne pouvez plus l'utiliser dans le système. Les méthodes et les classes rendues disponibles via le composant COM de GrabzIt sont marquées avec COM dans le Documentation ASP.NET.

Vous trouverez ci-dessous un exemple simple de capture d'écran de Google utilisant JScript. N'oubliez pas de vous assurer que le script dispose des droits suffisants pour stocker la capture d'écran dans le répertoire spécifié.

try
{
    var grabzit = new ActiveXObject("GrabzIt.GrabzItClient");
    var options = new ActiveXObject("GrabzIt.Parameters.ImageOptions");

    grabzit.ApplicationKey = "Sign in to view your Application Key";
    grabzit.ApplicationSecret = "Sign in to view your Application Secret")%>";
    grabzit.URLToImage("https://www.tesla.com", options);
    grabzit.SaveTo("C:\\tmp\\test.jpg");
}
catch(e)
{
    //do something with a exception
    //e.description;
}

Pour exécuter l'exemple JScript ci-dessus, save par exemple, screenshot.js, puis ouvrez une fenêtre de ligne de commande. Naviguez jusqu'à l'emplacement du fichier. Puis lancez la commande wscript screenshot.js.

Ensuite, le même objet COM sera utilisé dans un exemple plus complexe utilisant ASP classique. Vous avez peut-être remarqué que la propriété Country, qui est une énumération de la bibliothèque .NET de GrabzIt, est définie sur 1. En effet, les énumérations ne sont pas disponibles dans ASP classique et les valeurs numériques des énumérations, spécifiées dans Documentation ASP.NET, doit être utilisé lors de l’utilisation du composant COM de GrabzIt.

Dim grabzit 
Dim options

set grabzit = Server.CreateObject("GrabzIt.GrabzItClient")
set options = Server.CreateObject("GrabzIt.Parameters.ImageOptions")

options.OutputWidth = 100
options.OutputHeight = 100
options.Country = 1

grabzit.ApplicationKey = "Sign in to view your Application Key"
grabzit.ApplicationSecret = "Sign in to view your Application Secret")%>"
call grabzit.URLToImage("https://www.tesla.com", (options))
call grabzit.SaveTo("C:\\tmp\\test.jpg")

Erreur: appel ou argument de procédure non valide

Cela signifie que la procédure est incorrecte ou qu'un argument est incorrect. Avec l'objet COM de GrabzIt, il est important de s'assurer que tous les arguments sont spécifiés. C’est pourquoi, dans le premier exemple, le ImageOptions l'objet est passé à URLToImage méthode même si aucune option n'est définie.