Visualiser des documents PDF avec PdfViewer pour Xamarin.Forms

L'affichage de documents PDF dans votre application mobile sans la nécessité d'installer une solution tierce n'a jamais été aussi simple. Vous pouvez maintenant utiliser l'interface utilisateur Telerik pour le contrôle Xamarin PdfViewer dans votre application. Le contrôle PdfViewer est livré avec un certain nombre de fonctionnalités permettant de visualiser et de manipuler des fichiers PDF.

Nous avons reçu de nombreuses demandes de nos clients pour créer un composant qui leur fournira la meilleure expérience utilisateur possible lors de l'utilisation de documents PDF. Nous avons donc été ravis d'introduire un contrôle à ce sujet dans la version officielle [R12019de]. de UI Telerik pour Xamarin . Depuis lors, nous nous sommes efforcés de l'améliorer davantage en nous basant sur les commentaires reçus de nos utilisateurs. Un nouvel ensemble de fonctionnalités a été introduit en février avec la version du Service Pack .

Dans cet article de blog, vous en apprendrez davantage sur le contrôle PdfViewer pour Xamarin.Forms. Vous y découvrirez également les nouvelles fonctionnalités qui vont avec et comment les utiliser.

Fonctionnalités

• Visualize pdf documents – Affichage de documents PDF contenant du texte, des images, des formes (géométrie), différentes couleurs (dégradés solides, linéaires et radiaux), des listes ordonnées ou à puces, etc.
• Diverses options de source de document – Vous pouvez charger le document PDF à partir d'un flux, d'un fichier ajouté en tant que ressource incorporée ou situé sur le périphérique, etc.
• Fonctionnalité de zoom avec prise en charge des leviers de zoom min et max
• Défilement d'une page et défilement continu Support pour afficher une page à la fois ou toutes les pages en continu dans le visualiseur
• Commandes Support pour zoomer, naviguer de page en page, Ajuster en largeur ou Basculer en mode présentation [19659012] Support de la barre d’outils avec pr Eléments de la barre d’outils de l’interface utilisateur définis avec toutes les commandes PdfViewer

Découvrez plus en détail les fonctionnalités répertoriées ci-dessus.

Diverses options de source de document

PdfViewer vous permet de visualiser des documents PDF via son Source. propriété. Les documents peuvent être chargés à partir de différentes sources de documents telles que:

• FileDocument
• Uri
• ByteArray
• Stream
• FixedDocument

Par exemple, examinons les fichiers FileDocumetSource, FixedDocumentSource, UriDocumentSource:

FileDocumentSouce fait désormais partie des fonctionnalités de PdfViewer définies dans l'interface utilisateur Telerik pour le Service Pack Xamarin R1 2019. Il vous permet de charger un document PDF à partir d'un fichier stocké sur le périphérique. Par exemple:

où FilePath est une propriété de chaîne dans le ViewModel:

 string FilePath {get;} 

Lorsque vous utilisez le FileDocumentSource assurez-vous que vous avez accordé à l'application tous les autorisations nécessaires avant l'utilisation des ressources. Une exception sera générée.

Chargez un document PDF sous forme de ressources incorporées à l'aide de FixedDocumentSource :

 Telerik.Windows.Documents.Fixed. FormatProviders.Pdf.PdfFormatProvider provider = new Telerik.Windows.Documents.Fixed.FormatProviders.Pdf.PdfFormatProvider ();
Assembly Assembly = typeof (KeyFeatures) .Assembly;
string fileName = assembly.GetManifestResourceNames (). FirstOrDefault (n => n.Contains ("pdfName.pdf"));
using (flux stream = assembly.GetManifestResourceStream (NomFichier))
{
   RadFixedDocument document = provider.Import (stream);
   this.pdfViewer.Source = new FixedDocumentSource (document);
} 

Visualisation de documents PDF à partir de Uri :

 Uri uri = new Uri ("https: //....../pdfName.pdf");
cette commande.pdfViewer.Source = uri; 

] ToggleLayoutModeCommand

Pour plus d'informations sur leur utilisation, consultez notre article d'aide .

Lorsqu'un nouveau document est chargé, il est automatiquement ajusté pour s'adapter à la largeur actuelle afin d'optimiser la visualisation. . Cela signifie que la commande FitToWidth est exécutée lors du chargement du document.

Prise en charge de PdfToolbar avec les opérations de commandes intégrées

Toutes les commandes fournies par PdfViewer sont incluses dans le PdfToolbar . Cette fonctionnalité permet à l'utilisateur final de l'application d'utiliser les commandes beaucoup plus facilement avec l'interface utilisateur prédéfinie. Il vous suffit de choisir celles dont vous avez besoin dans l'application en fonction de vos besoins.

Il vous suffit de choisir les commandes et de les inclure en tant qu'objets PdfViewerToolbar . Par exemple:

 
  < Grille >  
   < Grid.RowDefinitions > [19459047]>  
.   < RowDefinition   Height  =  "Auto"  />  
   < RowDefinition   />  
   </  Grid.RowDefinitions >    </  </         RadPdfViewerToolbar   PdfViewer  =  "{Source de reliure = {x: Référence pdfViewer}}" >     < telerikPdfViewer: ZoomInToolbarItem   />  

   < telerikPdfViewer: ZoomOutToolbarItem   />  telerikPdfViewer: ZoomOutToolbarItem   />  />  9047] < telerikPdfViewer: NavigateToNextPageToolbarItem  />  
  < telerikPdf Viewer: NavigateToPreviousPageTagePageToolbarIrem < telerikPdfViewer: NavigateToPageToolbarItem  />  
  [ telerikPdfViewer: FitToWidthToolbarItem  19659047] telerikPdfViewer: ToggleLayoutModeToolbarItem  />  
 [19459047] </  telerikPdfViewer: RadPdfViewerToolbar > /  telerikPdfViewer: RadPdfViewer   x: Nom  =  "pdfViewer"   Grid.Row  =  "1"  />  [1] 19659022]  </  Grille >  
 

L'image ci-dessous montre ce que l ' La barre d'outils PdfViewer ressemble à:

Avons-nous suscité votre intérêt avec le nouveau contrôle PdfViewer et ses fonctionnalités? Vous pouvez trouver diverses démonstrations du nouveau contrôle dans notre SDK Samples Browser et un exemple de First Look avec PdfToolbar dans de Telerik UI pour Xamarin Demo . .

Le contrôle est toujours en version bêta et nous travaillons activement à l’ajout de nouvelles fonctionnalités et à l’officialisation de la prochaine interface utilisateur Telerik pour Xamarin R2 2019. Donc, tout retour d’information est très apprécié, comme toujours. Si vous avez des idées sur les fonctionnalités à ajouter à l'ensemble des fonctionnalités du contrôle, n'hésitez pas à partager ces informations avec nous sur notre interface utilisateur Telerik pour Xamarin Feedback .

Si c'est la première fois que vous ' Pour en savoir plus sur l’interface utilisateur Telerik pour Xamarin, vous pouvez trouver plus d’informations à ce sujet sur notre site Web ou plonger directement dans un essai gratuit de 30 jours aujourd’hui.

---