4D Write Pro stále nabízí další a další možnosti programování! Řekněme, že chcete programově změnit styl tabulky, odstavce nebo obrázku v existujícím dokumentu 4D Write Pro. S nástrojem 4D v17, je to možné! Nyní můžete programováním přistupovat k libovolnému prvku nebo části dokumentu. Tyto části, nazývané prvky, budou vráceny buď jako kolekce díky funkci WP Get elements funkce, nebo jako jediný prvek pomocí WP Get element by ID funkce.
sbírka prvků
Funkce WP Get elements vrátí kolekci prvků libovolného typu (odstavce, tabulky, obrázky atd. Pokud je předán typový rozsah nebo odkaz, příkaz vrátí kolekci obsahující pouze prvky odpovídajícího typu (pokud není uveden ve druhém parametru). V opačném případě příkaz vrátí kolekci obsahující všechny dostupné prvky bez ohledu na jejich typ.
Například:
- Pokud je prvním parametrem rozsah určitého typu (například rozsah odstavců), pak vrácené prvky budou také odstavce.
- Pokud první parametr není specifický (celý dokument nebo heterogenní rozsah), pak lze vrácené prvky filtrovat pomocí posledního parametru (nepovinné).
// Returns all elements of the document
$allElements:=WP Get elements(wpDoc)
// Returns all table elements of the document
$allTables :=WP Get elements(wpDoc;wk type table)
// Returns all paragraphs of the range
$paragraphCol :=WP Get elements($paragraphRange)
// Returns all paragraphs of the table range
$paragraphCol:=WP Get elements($tableRange;wk type paragraph)
// Returns all the tables of the given range
$someTableCol:=WP Get elements($customRange;wk type table)
Po vytvoření lze kolekci analyzovat. Každý prvek je objekt, který lze použít jako parametr příkazu, WP SET ATTRIBUTES.
Jednotlivý prvek
Příkaz WP Get element by ID Příkaz umožňuje přístup k jednomu prvku. V dokumentech 4D Write Pro mají některé prvky výchozí ID (například obrázky a tabulky). Pokud existují, lze tato ID změnit, a pokud neexistují, lze je vytvořit. S tímto vědomím je chování příkazu poměrně snadno pochopitelné, vrací jediný prvek pro dané ID!
Jakmile získáte prvek, můžete s ním manipulovat, jak je uvedeno níže:
$element:=WP Get element by ID(myDoc; "Table1")
WP SET ATTRIBUTES ($element;wk border style;wk solid)
WP SET ATTRIBUTES ($element;wk border width; "4px")
WP SET ATTRIBUTES ($element;wk border color; "blue")