Używanie obrazów w szablonach dokumentów
Istnieją dwa sposoby użycia obrazów w document templates:
- Statycznie — obrazy są umieszczone bezpośrednio w szablonie dokumentu i w każdym dokumencie wygenerowanym ze szablonu będą wyświetlane dokładnie tak, jak zostały umieszczone w szablonie.
- Dynamicznie — obrazy są podłączone za pomocą zmiennej typu File, i w każdym dokumencie wygenerowanym ze szablonu zmienna zostanie zastąpiona obrazem odpowiadającym tej zmiennej w danym momencie.
Aby umieścić dynamiczny obraz w szablonie, można użyć zmiennej z dodatkowymi parametrami lub zmiennej powiązanej z obrazem zastępczym (placeholder), która określa rozmiar i położenie obrazu w finalnym dokumencie. Obie opcje opisano poniżej.
Użycie zmiennej z dodatkowymi parametrami
Ogólnie, aby wstawić obraz do szablonu dokumentu, wystarczy dodać nazwę zmiennej w żądanym miejscu (linii, komórce) szablonu — w każdym tworzonym dokumencie będzie ona zawierać odpowiedni plik obrazu:
Poniższe parametry służą do ustawienia rozmiaru i położenia obrazu w pliku wynikowym:
- Dla szablonów MS Word można jawnie ustawić rozmiar wstawionego obrazu.
Składnia zmiennej:
- {{VariableName::SIZE_X_AXISxSIZE_Y_AXIS}}
Przykład użycia zmiennej z tym parametrem:
- {{Task.File.Employee picture::200x300}}
- Dla szablonów MS Word można też jawnie wybrać opcję zawijania tekstu wokół obrazu. W tym celu używa się parametru wrapping zmiennej:
- Przykład:
- {{System.File::50x50;wrapping=around frame}}
- {{System.File::50x50;wrapping=before text}}
- {{System.File::50x50;wrapping=up and down}}
- Format używany:
- przed nazwą zmiennej dodawany jest separator "::" (dwa dwukropki);
- 50x50 to szerokość x wysokość obrazu w dokumencie wygenerowanym ze szablonu;
- wrapping — wybiera opcję zawijania tekstu.
Uwaga: w powyższych przykładach użyto jednocześnie dwóch parametrów, oddzielonych średnikiem: rozmiaru obrazu oraz zawijania tekstu wokół obrazu.
- Dla szablonów MS Word dostępne są również atrybuty MaxHeight i MaxWidth. Jeśli użyty zostanie jeden z tych atrybutów, drugi zostanie ustawiony proporcjonalnie w pliku wynikowym.
- Przykład użycia zmiennej z dodatkowym atrybutem:
- {{System.File::MaxWidth=150}}
- Rezultat: obraz wstawiony do pliku wynikowego będzie miał szerokość 150 pikseli, a wysokość zostanie dostosowana proporcjonalnie.
- W szablonach MS Excel obrazy domyślnie „wypełniają” komórkę zawierającą zmienną, więc rozmiar i proporcje będą określone przez rozmiar komórki przeznaczonej dla obrazu. Można stosować komórki scalone.
- Aby wstawić obraz w oryginalnym rozmiarze, użyj atrybutu "original". Przykład użycia zmiennej z tym atrybutem:
- {{Task.File.Employee picture::original}}
Użycie zmiennej powiązanej z obrazem zastępczym
W tej opcji do szablonu dokumentu wstawiany jest tymczasowy obraz zastępczy, który określa rozmiar i położenie obrazu w pliku wynikowym. Ta metoda nie wymaga parametrów, ponieważ ustawienia obrazu można skonfigurować „wizualnie” — przesuwając obraz zastępczy w szablonie dokumentu i zmieniając jego rozmiar zgodnie z potrzebą. Obraz zastępczy można powiązać ze zmienną, ustawiając nazwę zmiennej jako nazwę obrazu w szablonie dokumentu.
Aby użyć tej opcji, należy:
- Otworzyć szablon dokumentu w LibreOffice
- Wkleić obraz do pliku i zmienić jego rozmiar/położenie według potrzeby.
- Kliknąć prawym przyciskiem myszy obraz i wybrać:
- dla szablonów Excel — Name (zobacz przykład)
- dla szablonów Word — Properties:
a w oknie, które się otworzy, przejść do karty Parameters, gdzie znajduje się pole Name:
W polu Name wpisz nazwę zmiennej odpowiadającej polu zawierającemu obraz:
Podczas tworzenia dokumentu na podstawie tak przygotowanego szablonu obraz pojawi się w miejscu, które określiłeś, względem pozostałych elementów szablonu.
Przydatne informacje dla tej metody:
- Podczas tworzenia dokumentu obraz z szablonu zostaje zastąpiony obrazem przesłanym do pola wskazanego w nazwie. Dlatego nie ma znaczenia, jaki obraz dodasz do pliku szablonu — jest on jedynie obrazem zastępczym dla obrazu, który zostanie dodany do pliku wynikowego.
- Jeśli nazwa obrazu w pliku szablonu zawiera nazwę nieistniejącego pola, lub jeśli w polu o tej nazwie nie został wgrany żaden obraz, plik wynikowy nie będzie zawierał obrazu.
- Podczas tworzenia dokumentu do pliku zostanie wstawiony obraz o rozmiarze określonym w szablonie. Oznacza to, że jeśli obraz pieczęci w Twoim szablonie ma rozmiar 3"x3", a rzeczywisty rozmiar obrazu wgrany do ogólnego pola "Seal" to 2"x2", obraz zostanie rozciągnięty do 3"x3" w pliku wynikowym.
Użycie tego samego obrazu wielokrotnie
Jeśli potrzebujesz wstawić ten sam obraz (np. pieczęć lub podpis) wielokrotnie w jednym szablonie dokumentu, użyj zmiennej z dodatkowym parametrem. Na przykład:
- {{General.Print::Tag1}}
gdzie parametr Tag1 to dowolny tekst unikatowy dla każdego użycia zmiennej w szablonie (np. Tag1, Tag2 itd.).
Ten dodatkowy parametr, dodawany po symbolach "::" (dwóch dwukropkach), można stosować zarówno w zmiennej z dodatkowymi parametrami, jak i w zmiennej powiązanej z obrazem zastępczym.
Przydatne linki