XPS içindeki tuvallerle (canvases) çalışmak
C++ API’yi kullanarak XPS dosyalarındaki tuval (canvas) öğelerini kırpın (clip) ve dönüştürün (transform)
XPS dosyalarında tuval (canvas), metin, resim ve şekiller gibi görsel içeriklerin çizilebileceği sayfadaki dikdörtgen bir alandır. Bu öğeler için kapsayıcı görevi görür ve bunları düzenlemek ve katmanlara ayırmak (layering) için bir çerçeve sağlar. Tuval öğeleri, belgenin farklı bölümlerinde hatta birden fazla belgede yeniden kullanılabilir; bu da XPS belgesi içindeki içeriği yapılandırmak ve düzenlemek için esnek bir yol sunar. XPS dosyalarındaki tuval öğelerinin temel özellikleri:
- Tuval öğeleri diğer tuval öğelerinin içine yuvalanabilir (nested), bu da karmaşık düzenlere (layouts) ve öğelerin gruplandırılmasına olanak tanıyan hiyerarşik bir yapı oluşturur.
- Tuval öğeleri, öteleme (translation), döndürme (rotation) ve ölçekleme (scaling) gibi çeşitli işlemler kullanılarak dönüştürülebilir (transform). Bu, içerik konumlandırma ve yeniden boyutlandırma esnekliği sağlar.
- Tuval öğeleri belirli bölgelerle kırpılabilir (clip), bu da içeriklerinin görünür alanını sınırlar. Bu, karmaşık şekiller ve efektler oluşturmak için kullanışlıdır.
- Tuval öğeleri, metin çalıştırmaları (text runs), paragraflar ve metin kutuları (text boxes) dahil olmak üzere farklı görsel öğeler içerebilir. Ayrıca resimler, geometrik şekiller ve diğer tuval öğelerini de içerebilirler.
Belgelerdeki tuval öğelerini yönetmek, Aspose.Page for C++ tarafından sunulan özelliklerden biridir. Bu çözüm, farklı sayfa tanımlama dilleriyle, özellikle XPS ile çalışır.
XPS dosyasının tuval öğelerini dönüştürmek (transform) için aşağıdaki kılavuzu izleyin:
- XpsDocument sınıfını kullanarak bir XPS dosyası oluşturun.
- AddCanvas() yöntemini kullanarak tüm sayfa öğeleri için ortak olan ana tuvali oluşturun.
- CreateMatrix() yöntemini kullanarak ana tuvalde sola ve üste kaymalar yapın.
- CreatePathGeometry() yöntemiyle dikdörtgen yol geometrisi (rectangle path geometry) oluşturun.
- XpsBrush sınıfını kullanarak dikdörtgenler için bir dolgu (fill) oluşturun.
- Tuval 2’de bir dikdörtgen oluşturmak ve doldurmak için XpsPath sınıfını kullanın.
- Yeni bir dikdörtgeni önceki dikdörtgenin altına konumlandırmak için tuval 3’ü ötelemek (translate) üzere CreateMatrix() yöntemini kullanın.
- Bu tuvali sayfanın sağ tarafına ötelemek için Translate() yöntemini kullanın.
- Tuval 4’ü ölçeklendirmek (scale) için Scale() yöntemini çağırın.
- Tuval 5’i bir nokta etrafında 45 derece döndürmek (rotate) için RotateAround() yöntemi çok kullanışlıdır.
- XpsDocument.Save() yöntemini kullanarak değiştirilen XPS belgesini kaydedin.
Tuval dönüştürme (canvas transformation)
XPS dosyasının tuval öğelerini kırpmak (clip) için aşağıdaki kılavuzu izleyin:
- XpsDocument sınıfını kullanarak bir XPS dosyası oluşturun veya açın.
- AddCanvas() yöntemini kullanarak tüm sayfa öğeleri için ortak olan ana tuvali oluşturun.
- CreateMatrix() yöntemini kullanarak ana tuvalde sola ve üste kaymalar yapın.
- CreatePathGeometry() yöntemiyle dikdörtgen yol geometrisi oluşturun.
- XpsBrush sınıfını kullanarak dikdörtgenler için bir dolgu oluşturun.
- Ana tuvale kırpmalı (clip) başka bir tuval eklemek için AddCanvas() yöntemini tekrar çağırın.
- XpsPathGeometry sınıfını kullanarak kırpma için daire geometrisi oluşturun.
- Bu tuvalde bir dikdörtgen oluşturmak ve doldurmak için XpsPath sınıfını kullanın.
- AddCanvas() yöntemiyle başka bir tuval ekleyin, ardından bu tuvalde bir dikdörtgen oluşturun ve XpsPathGeometry sınıfıyla çizgisini (stroke) çizin.
- XpsDocument.Save() yöntemini kullanarak değiştirilen XPS belgesini kaydedin.
Tuval kırpma (canvas clipping)
XPS XPS Dosya Biçimi nedir
XPS (XML Paper Specification), Microsoft’un PDF alternatifi olan bir formattır. XML/HTML temelli olup, farklı platformlarda aynı görünümü korur ve işletim sisteminden bağımsızdır.