Fonction PDF (expérimentale)
S’applique à :
Applications canevas Applications pilotées par modèle
[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]
Exportez le contenu de l’écran actuel vers un objet pour une utilisation dans plusieurs scénarios.
Important
- Il s’agit d’une fonctionnalité expérimentale.
- Les fonctionnalités expérimentales ne sont pas destinées à une utilisation en production et peuvent avoir des fonctionnalités restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires. En savoir plus : Comprendre les fonctionnalités expérimentales, en version préliminaire et retirées dans les applications canevas
- Le comportement décrit dans cet article n’est disponible que lorsque la fonctionnalité expérimentale Fonction PDF au niveau de la formule dans Paramètres > Fonctionnalités à venir > Expérimental est activée (elle est désactivée par défaut).
- Vos commentaires nous sont très utiles. Donnez-nous votre avis sur le forum de la communauté des fonctionnalités expérimentales Power Apps.
Description
La fonction PDF permet de sélectionner un écran ou des portions d’écran à exporter vers un objet PDF (blob).
Différentes options de configuration permettent différents résultats pour le PDF généré résultant.
Important
- La génération de PDF se produit sur l’appareil sur lequel l’application est en cours d’exécution. Différents appareils tels que les ordinateurs de bureau et les appareils mobiles auront des capacités différentes lorsque vous générez un PDF.
- La génération d’un PDF avec une taille de fichier exceptionnellement grande peut entraîner le blocage de l’application. Cela dépend de la capacité de l’appareil sur lequel vous exécutez l’application. Soyez conscient de la taille et du nombre d’images et de la quantité de données à inclure dans le PDF généré, en particulier pour les applications destinées à être utilisées sur un appareil mobile.
Note
- Vous ne pouvez générer un PDF qu’à partir du contenu existant sur l’écran où vous avez appelé la fonction PDF. Par exemple, si vous avez ajouté la fonction PDF sur l’écran deux, seul le contenu de l’écran deux peut être inclus dans le PDF généré.
Syntaxe
PDF(Nom de l’écran ou du contrôle [,{Taille, DPI, Marge, Orientation, ExpandContainers}])
Nom de l’écran ou du contrôle – Obligatoire. L’écran ou le champ contenant le contenu à utiliser pour générer le PDF. Contrôles pris en charge : Galerie verticale, Conteneur de mise en page verticale, Conteneur de mise en page horizontale, Conteneur, Écran.
Taille – Facultatif. Contrôle les dimensions du PDF généré. La valeur par défaut dépend des paramètres régionaux de l’utilisateur de l’application ; lettre pour les États-Unis et le Canada et A4 pour les autres paramètres régionaux.
DPI – Facultatif. Contrôle la mise à l’échelle/résolution du PDF généré. Doit être une valeur supérieure à 0. Le contenu dépassant l’espace autorisé par les marges spécifiées peut entraîner un DPI effectif plus élevé. La valeur par défaut est 96.
Marge – Facultatif. Une chaîne spécifiant la taille de l’espace réservé entre le contenu et le bord extérieur du PDF généré. Chaque marge du PDF généré (haut, droite, bas, gauche) peut prendre en charge une valeur différente. Les unités de mesure prises en charge pour cette valeur incluent in, cm, mm, pt et px. La valeur par défaut est de 0,5 pouce (12,7 mm) pour toutes les marges.
Orientation – Facultatif. Contrôle si le PDF généré a une orientation portrait (vertical) ou paysage (horizontal). La valeur par défaut est portrait (vertical).
ExpandContainers – Facultatif. Booléenne. Contrôle si certains conteneurs dont le contenu dépasse leur taille allouée se développent pour afficher tout le contenu du PDF généré. Les contrôles concernés incluent les écrans, les conteneurs, les conteneurs verticaux et horizontaux, les galeries verticales à hauteur fixe (non imbriquées), les formulaires et les contrôles de canevas défilants. La valeur par défaut est false.
Examples
| Formule | Description | Résultat |
|---|---|---|
| PDF (Écran 1) | Génère un objet PDF avec les paramètres par défaut. | Un objet PDF est créé à partir du contenu visible de Screen1. |
| PDF(Conteneur1, {Taille : A3}) | Génère un objet PDF avec le format de papier défini sur A3. | Un objet PDF au format A3 est créé à partir du contenu visible de Container1. |
| PDF(Écran1, {DPI : 72, Marge : "25 mm", Orientation : "Paysage"}) | Génère un objet PDF avec la résolution (DPI) définie sur 72, la marge définie sur 25 millimètres et l’orientation définie sur paysage (horizontal). | Un PDF avec le PPP, la marge et l’orientation spécifiés est créé dans la taille par défaut (en fonction des paramètres régionaux) à partir du contenu visible sur Screen1. |
| PDF(Screen1, {ExpandContainers : true}) | Génère un objet PDF avec les contrôles applicables développés. | Un PDF est créé dans lequel tous les conteneurs/galeries avec plus de contenu que ce qui est visible sont développés pour afficher tout le contenu du PDF généré. |
Limitations connues
Certains contrôles ne sont actuellement pas pris en charge. Il s’agit notamment des graphiques, de la vignette Power BI, de cartes et de certaines configurations de contrôles PCF tiers.
Les galeries imbriquées ne sont pas prises en charge.
Les types d’écritures non latines et les poids et styles de police tels que le gras et l’italique peuvent ne pas apparaître dans le PDF généré pour certaines polices.
La création de fichiers PDF à remplir n’est pas prise en charge.