Wprowadzenie możliwości podglądu dokumentów PDF w oparciu o komponent WebView2 (Chromium)

W wersji 2025.0.1 wprowadzono następujące zmiany związane z podglądem dokumentów PDF:

Dodanie klucza „DefaultPdfViewerType” w DMS.exe.config

W wersji 2025.0.1 w ramach pliku DMS.exe.config, znajdującego się w folderze z plikami aplikacji desktopowej, dodano nowy klucz „DefaultPdfViewerType”. Klucz przyjmuje następujące wartości:

„Chromium” – jeśli klucz przyjmuje tę wartość, a <add key=”IntegratedPdfViewer” value=”true” /> (wartość domyślna), wówczas podgląd załącznika może być wyświetlany jako:
- podgląd wbudowany – wówczas podgląd nie ulega zmianie
- podgląd za pomocą Chromium – opisany w punkcie Umożliwienie podglądu dokumentu pdf za pomocą Chromium w ramach szczegółów dokumentu w aplikacji desktop Comarch DMS
- podgląd za pomocą domyślnej aplikacji zewnętrznej – w takim przypadku podgląd nie ulega zmianie
„Devexpress” – wartość domyślna; jeśli klucz przyjmuje tę wartość, a <add key=”IntegratedPdfViewer” value=”true” />, wówczas podgląd załącznika może być wyświetlany jako:
- podgląd wbudowany – wówczas podgląd nie ulega zmianie
- podgląd za pomocą Devexpressa – podgląd nie zmienia się w stosunku do poprzednich wersji
- podgląd za pomocą domyślnej aplikacji zewnętrznej – w takim przypadku podgląd nie ulega zmianie

Klucz „DefaultPdfViewerType” w pliku DMS.exe.config

Ustawienie widoku podglądu pliku zostaje zapamiętane – w przypadku, jeśli zamknięto podgląd, a następnie ponownie otwarto, wówczas zostanie on wyświetlony w typie widoku, jaki był używany ostatnio. Analogicznie, następny plik załącznika w innym dokumencie także zostanie wyświetlony w ostatnio wybranym typie widoku.

Uwaga

Jeżeli ustawiono podgląd pliku załącznika w domyślnej aplikacji zewnętrznej, wówczas po ponownym otwarciu podglądu załącznika zostanie on wyświetlony w podglądzie wewnętrznym.

Uwaga

Klucz ”PdfViewerZoom” w pliku DMS.exe.config ma zastosowanie tylko w przypadku podglądu za pomocą DevExpress lub Chromium.

Dla podglądu za pomocą Chromium wartość ”FitToVisible” w ramach klucza ”PdfViewerZoom” jest traktowana jak brak wartości.

W przypadku, jeśli:

<add key=”DefaultPdfViewerType” value=”Chromium” /> i <add key=”IntegratedPdfViewer” value=”false” />

lub

<add key=”DefaultPdfViewerType” value=”Devexpress” /> i <add key=”IntegratedPdfViewer” value=”false” />

wówczas gdy operator kliknie w nazwę pliku załącznika, podgląd pliku zostanie otwarty w aplikacji zewnętrznej.

Umożliwienie podglądu dokumentu pdf za pomocą Chromium w ramach szczegółów dokumentu w aplikacji desktop Comarch DMS

W wersji 2025.0.1 wprowadzono możliwość podglądu załącznika w formacie PDF za pomocą Chromium w ramach szczegółów dokumentu w aplikacji desktop Comarch DMS. Jeśli w pliku DMS.exe.config wybrano wartości <add key=”DefaultPdfViewerType” value=”Chromium” /> i <add key=”IntegratedPdfViewer” value=”true” />, wówczas operator może przełączać widok podglądu pomiędzy podglądem wbudowanym a podglądem za pomocą Chromium, klikając w przycisk [Przełącz podgląd].

Widok szczegółów dokumentu z podglądem pliku załącznika za pomocą Chromium

W ramach podglądu za pomocą Chromium dostępne są następujące pola:

[Spis treści] – po kliknięciu w przycisk zostaje wyświetlony spis treści w postaci miniatur

Widok podglądu pliku załącznika za pomocą Chromium z wyświetlonym spisem treści

[Zmniejsz] – kliknięcie przycisku powoduje zmniejszenie skali podglądu pliku. Alternatywnie operator może zastosować skrót klawiszowy Ctrl + klawisz Minus

[Powiększ] – kliknięcie przycisku powoduje zwiększenie skali podglądu pliku. Alternatywnie operator może zastosować skrót klawiszowy Ctrl + klawisz Plus

[Dopasuj do strony] – po kliknięciu w przycisk załącznik zostaje wyświetlony z poziomu całej strony; przycisk występujący zamiennie z przyciskiem [Dopasuj do szerokości] (zmienia się w ten przycisk po naciśnięciu). Alternatywnie operator może zastosować skrót klawiszowy Ctrl + \.

Uwaga

Jeśli w pliku DMS.exe.config <add key=”PdfViewerZoom” value=”ToPageLevel” />, wówczas ustawienie „Dopasuj do strony” jest domyślne.

Widok podglądu pliku załącznika za pomocą Chromium po kliknięciu przycisku „Dopasuj do strony”

[Dopasuj do szerokości] – po kliknięciu w przycisk załącznik zostaje wyświetlony w taki sposób, że wielkość dokumentu zostanie dopasowana do wielkości okna podglądu, z uwzględnieniem szerokości dokumentu; przycisk występujący zamiennie z przyciskiem [Dopasuj do strony] (zmienia się w ten przycisk po naciśnięciu). Alternatywnie operator może zastosować skrót klawiszowy Ctrl + \.

Uwaga

Jeśli w pliku DMS.exe.config <add key=”PdfViewerZoom” value=” FitToWidth” />, wówczas ustawienie „Dopasuj do szerokości” jest domyślne.

Widok podglądu pliku załącznika za pomocą Chromium po kliknięciu przycisku „Dopasuj do szerokości”

[Liczba stron] – w ramach tego pola wyświetlana jest strona pliku, której podgląd jest aktualnie wyświetlany oraz całkowita liczba stron pliku. Aby przejść do wybranej strony pliku, należy wpisać numer tej strony i kliknąć przycisk ENTER.

[Obróć] – po kliknięciu w przycisk podgląd załącznika zostaje obrócony w prawo o 90 stopni. Alternatywnie operator może zastosować skrót klawiszowy Ctrl + ].

[Widok strony] – po kliknięciu w przycisk wyświetlone zostają następujące opcje:

Pojedyncza strona – po wyborze tej opcji widok podglądu będzie ustawiony na pojedynczą stronę;
Dwie strony – po wyborze tej opcji widok podglądu będzie ustawiony na dwie strony; dostępna jest również opcja „Pokaż osobno stronę tytułową”

Opcje dostępne po kliknięciu w przycisk „Widok strony”

Uwaga

Jeśli okno podglądu zostanie znacząco zawężone, wówczas opcje „Dopasuj do szerokości”/ „Dopasuj do strony”, „Obróć” i „Widok strony” zostają ukryte pod ikoną [Opcje widoku], na prawo od pola [Liczba stron].

Opcje dostępne po kliknięciu w przycisk „Opcje widoku”

[Znajdź] – po kliknięciu w ten przycisk wyświetla się pole, w ramach którego można wprowadzić frazę do znalezienia w danym pliku. Alternatywnie operator może zastosować skrót klawiszowy Ctrl + F.

Widok podglądu pliku załącznika za pomocą Chromium po kliknięciu przycisku „Znajdź” i wprowadzeniu frazy „pula”

[Drukuj] – przycisk pozwalający na drukowanie załącznika; kliknięcie w tę ikonę otwiera okno „Drukuj” z ustawieniami wydruku. Alternatywnie operator może zastosować skrót klawiszowy Ctrl + P.

Okno podglądu pliku załącznika za pomocą Chromium wraz z otwartym oknem „Drukuj”

[Zapisz] (dla plików jednostronnych)/ [Zapisz jako] (dla plików wielostronnych) – kliknięcie w przycisk otwiera okno „Zapisywanie jako”, w ramach którego operator może zapisać plik załącznika w wybranej lokalizacji na dysku. Alternatywnie można zastosować skrót klawiszowy Ctrl + S.

[Wprowadź plik PDF w trybie pełnoekranowym] – po kliknięciu w ten przycisk podgląd załącznika zostaje wyświetlony w trybie pełnoekranowym (w całym polu podglądu), a pasek narzędzi oraz suwak zostają ukryte.

Okno podglądu pliku załącznika za pomocą Chromium w trybie pełnoekranowym

Uwaga

Jeśli okno podglądu zostanie znacząco zawężone, wówczas opcje „Drukuj”, „Zapisz”, „Zapisz jako” i „Pełny ekran” zostają ukryte pod ikoną [Opcje i ustawienia udostępniania], na prawo od pola [Znajdź].

Opcje dostępne po kliknięciu w przycisk „Opcje i ustawienia udostępniania”

[Ustawienia i nie tylko] – po kliknięciu w ten przycisk wyświetlana jest lista zawierająca następujące opcje:

Przypnij pasek narzędzi – opcja przypięcia (zaznaczenie)/ odpięcia paska narzędzi; w przypadku odznaczenia opcji pasek narzędzi zostaje schowany po przesunięciu kursora poza pole podglądu;
Wyświetl właściwości dokumentu – po wyborze tej opcji zostanie wyświetlony okno „Właściwości dokumentu” z informacjami dotyczącymi danego pliku.

Opcje dostępne po kliknięciu „Ustawienia i nie tylko”

W przypadku, jeśli operator kliknie prawym przyciskiem myszki w podgląd dokumentu PDF, wówczas wyświetlona zostanie lista z następującymi opcjami:

„Odśwież” – po wyborze tej opcji podgląd dokumentu zostaje odświeżony; alternatywnie można zastosować skrót klawiszowy Ctrl + R
„Zapisz” – opcja analogiczna do [Zapisz] (dla plików jednostronnych)
„Drukuj” – opcja analogiczna do [Drukuj]
„Obróć w prawo” – wybór opcji powoduje obrót podglądu załącznika w prawo o 90 stopni; alternatywnie można zastosować skrót klawiszowy Ctrl + ]
„Obróć w lewo” – wybór opcji powoduje obrót podglądu załącznika w lewo o 90 stopni; alternatywnie można zastosować skrót klawiszowy Ctrl +[
„Zrzut ekranu” – wybór opcji pozwala na wykonanie zrzutu ekranu podglądu dokumentu; alternatywnie można zastosować skrót klawiszowy Ctrl + Shift + S. Jeśli operator kliknie w opcję „Zrzut ekranu”, wówczas podgląd załącznika ulega zaciemnieniu i wyświetlone zostają następujące opcje:
- Obszar przechwytywania – opcja przechwytywania części strony; po wybraniu tej opcji operator powinien zaznaczyć część podglądu pliku, którą chce skopiować albo zapisać;
- Obszar przechwytywania ekranu – opcja pozwala na wykonanie zrzutu całego pola podglądu; po kliknięciu w zrzut podglądu załącznika operator może też skorzystać z dodatkowych możliwości jak zapisywanie zrzutu, dodawanie na nim tekstu, itp.

Widok podglądu pliku po wyborze opcji „Zrzut ekranu”

„Wykonaj inspekcje” – jeśli ta opcja jest widoczna, wówczas pozwala na otwarcie okna DevTools