Udostępnij za pośrednictwem

Funkcja PDF (wersja eksperymentalna)

  • Artykuł

Dotyczy: Aplikacje kanwy Aplikacje oparte na modelu

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Eksport zawartości z bieżącego ekranu do obiektu w celu użycia w kilku scenariuszach.

Ważne

opis

Funkcja PDF umożliwia wybranie ekranu lub części ekranu do wyeksportowania do obiektu PDF (blobu).

Różne opcje konfiguracji umożliwiają wygenerowanie różnych wyników w wygenerowanym pliku PDF.

Ważne

  • Generowanie plików PDF odbywa się na urządzeniu, na którym działa aplikacja. Różne urządzenia, takie jak komputery stacjonarne i urządzenia mobilne, będą miały różne pojemności podczas generowania pliku PDF.
  • Generowanie pliku PDF o wyjątkowo dużym rozmiarze pliku może spowodować awarię aplikacji. Zależy to od wydajności urządzenia, na podstawie których uruchamiana jest aplikacja. Zwróć uwagę na rozmiar i liczbę obrazów oraz ilość danych, które chcesz uwzględnić w wygenerowanym pliku PDF, szczególnie w przypadku aplikacji przeznaczonych do użycia na urządzeniu przenośnym.

Uwaga

  • Plik PDF można wygenerować tylko z zawartości znajdującej się na ekranie, na którym wywołano funkcję PDF. Na przykład, jeśli dodano funkcję PDF na drugim ekranie, to tylko zawartość z drugiego ekranu może zostać uwzględniona w wygenerowanym pliku PDF.

Składnia

PDF(Nazwa ekranu lub formantu [,{Rozmiar, DPI, Margines, Orientacja, RozwińKontenery}])

  • Nazwa ekranu lub kontrolki – Wymagane. Ekran lub formant zawierający zawartość, która ma być generowana w celu wygenerowania pliku PDF. Obsługiwane formanty: Galeria pionowy, Kontener w układzie pionowym, Kontener układu poziomego, Kontener, Ekran.

  • Rozmiar – opcjonalny. Steruje rozmiarami wygenerowanego pliku PDF. Wartość domyślna zależy od ustawień regionalnych użytkownika aplikacji; List dla USA i Kanady oraz A4 dla innych ustawień regionalnych.

  • DPI– Opcjonalnie. Steruje skalowaniem/rozdzielczością wygenerowanego pliku PDF. Musi być wartością większą niż 0. Zawartość przekraczająca przestrzeń dozwoloną przez określone marginesy może skutkować wyższym efektywnym DPI. Domyślna wartość wynosi 96.

  • Margines – opcjonalny. Ciąg określający rozmiar miejsca zarezerwowanego między treścią a zewnętrzną krawędzią wygenerowanego pliku PDF. Każdy margines wygenerowanego pliku PDF (górny, prawy, dolny, lewy) może obsługiwać inną wartość. Obsługiwane jednostki miary dla tej wartości to cale, cm, mm, pt i px. Domyślna wartość wszystkich marży to 0,5 cala (12,7 mm).

  • Orientacja – opcjonalnie. Umożliwia określenie, czy generowany plik PDF ma orientację pionową (pionową) czy poziomą. Wartość domyślna to portret (pion).

  • ExpandContainers – Opcjonalnie. Wartość logiczna. Kontroluje, czy niektóre kontenery z zawartością przekraczającą ich przydzielony rozmiar rozszerzają się, aby wyświetlić całą zawartość w wygenerowanym pliku PDF. Kontrolki, na które ma wpływ, obejmują ekrany, kontenery, kontenery pionowe i poziome, pionowe galerie o stałej wysokości (nie zagnieżdżone), formularze i przewijalne kontrolki kanwy. Wartość domyślna to false.

Przykłady

Formuła Opis Wynik
Plik PDF (ekran 1) Wygeneruje obiekt PDF o ustawieniach domyślnych. Obiekt pliku PDF jest tworzony z widocznej treści ekranu 1.
PDF(Kontener1, { Rozmiar: A3}) Wygeneruje obiekt PDF o rozmiarze dokumentu ustawionym na wartość A3. Obiekt PDF o rozmiarze A3 jest tworzony z widocznej zawartości Container1.
PDF(Ekran1, { DPI: 72, Margines: "25mm", Orientacja: "Pozioma")} Generuje obiekt PDF z rozdzielczością (DPI) ustawioną na 72, marginesem ustawionym na 25 milimetrów i orientacją ustawioną na poziomą (poziomą). Plik PDF z określonym DPI, marginesem i orientacją jest tworzony w domyślnym rozmiarze (zależnym od ustawień regionalnych) z widocznej zawartości na ekranie Screen1.
PDF(Screen1,ExpandContainers {: true}) Tworzy obiekt pliku PDF z rozwiniętą odpowiednich formantów. Plik PDF jest tworzony, gdy wszystkie kontenery/galerie z większą zawartością niż jest widoczna, są rozwijane, aby pokazać całą zawartość wygenerowanego pliku PDF.

Znane ograniczenia

  • Niektóre kontrolki nie są obecnie obsługiwane. Należą do nich wykresy, kafelek usługi Power BI, mapa i niektóre konfiguracje kontrolek PCF innych firm.

  • Galerie zagnieżdżone nie są obsługiwane.

  • Typy skryptów innych niż łacińskie, grubości i style czcionek, takie jak pogrubienie i kursywa, mogą nie pojawiać się w wygenerowanym pliku PDF w przypadku niektórych czcionek.

  • Tworzenie wypełnianego pliku PDF nie jest obsługiwane.