Udostępnij przez


PDF function (eksperymentalna)

Dotyczy: Aplikacje kanwy

[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 PDF obiektu (blob).

Różne opcje konfiguracji umożliwiają różne wyniki dla wynikowego PDFwygenerowanego elementu .

Ważne

  • PDF generowanie odbywa się na urządzeniu, na którym jest uruchomiona aplikacja. Różne urządzenia, takie jak komputery stacjonarne i urządzenia przenośne, będą miały różne pojemności podczas generowania elementu PDF.
  • Generowanie elementu 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. Należy pamiętać o rozmiarze i liczbie obrazów oraz o liczbie danych, które mają zostać uwzględnione w wygenerowanym PDFobiekcie , w szczególności w przypadku aplikacji przeznaczonych do użycia na urządzeniu przenośnym.

Uwaga

  • Możesz wygenerować element PDF na podstawie zawartości istniejącej na ekranie, na którym wywołano PDF funkcję. Jeśli na przykład dodano PDF funkcję na ekranie dwa, tylko zawartość na ekranie 2 może zostać uwzględniona w wygenerowanych PDFelementach .

Składnia

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

  • Nazwa ekranu lub kontrolki – Wymagane. Ekran lub kontrolka zawierająca zawartość do wygenerowania elementu PDF. Obsługiwane formanty: Galeria pionowy, Kontener w układzie pionowym, Kontener układu poziomego, Kontener, Ekran.

  • Rozmiar – Opcjonalny. Steruje wymiarami wygenerowanego PDFobiektu . 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 PDFelementu . 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 – opcjonalnie. Ciąg określający rozmiar miejsca zarezerwowanego między zawartością a zewnętrzną krawędzią wygenerowanego PDFelementu . Każdy margines wygenerowanego 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. Określa, czy wygenerowany PDF obiekt ma orientację pionową (pionową) lub poziomą (poziomą). Wartość domyślna to portret (pion).

  • ExpandContainers – Opcjonalnie. Wartość logiczna. Określa, czy niektóre kontenery z zawartością przekraczającą przydzielony rozmiar rozszerzają się, aby wyświetlić całą zawartość w wygenerowanych PDFelementach . 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 Podpis Wynik
PDF(Ekran1) PDF Generuje obiekt z ustawieniami domyślnymi. Obiekt PDF jest tworzony na podstawie widocznej zawartości ekranu Screen1.
PDF(Kontener1, {Rozmiar: "A3"}) PDF Generuje obiekt o rozmiarze papieru ustawionym na A3. Obiekt o rozmiarze PDF A3 jest tworzony na podstawie widocznej zawartości kontenera Container1.
PDF(Screen1, {DPI: 72, Margines: "25mm", Orientacja: "Pozioma"}) PDF Generuje obiekt z rozdzielczością (DPI) ustawioną na 72, margines ustawiony na 25 milimetrów, a orientacja ustawiona na poziomą (pozioma). Obiekt PDF o określonej rozdzielczości DPI, marginesie i orientacji jest tworzony w domyślnym rozmiarze (zależnym od ustawień regionalnych) z widocznej zawartości na ekranie Screen1.
PDF(Screen1, {ExpandContainers: true}) PDF Generuje obiekt z rozwiniętymi odpowiednimi kontrolkami. Element jest PDF tworzony, w którym wszystkie kontenery/galerie z większą ilością zawartości niż jest widoczna, są rozwinięte w celu wyświetlenia całej zawartości w wygenerowanym PDFelemecie .

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ński i wagi czcionek oraz style, takie jak pogrubienie i kursywa, mogą nie być wyświetlane w wygenerowanym PDF dla niektórych czcionek.

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