Vertoon Vorms Afsonderlik van'n Dokument
Wanneer dokumente verwerk word, is’n algemene taak om al die beelde wat in die dokument gevind word, te onttrek en na’n eksterne plek uit te voer. Hierdie taak word eenvoudig met die Aspose.Words API, wat reeds die funksionaliteit bied vir die onttrekking en stoor van beelddata. Soms wil u egter ook ander soorte grafiese inhoud onttrek wat deur’n ander tipe tekenvoorwerp voorgestel word, byvoorbeeld’n tekskassie met paragrawe, pylvorms en’n klein prent. Daar is geen eenvoudige manier om hierdie voorwerp te lewer nie, aangesien dit’n kombinasie van individuele inhoudelemente is. Jy kan ook’n geval teëkom wanneer die inhoud saam gegroepeer is in die voorwerp wat soos’n enkele prent lyk.
Aspose.Words bied funksionaliteit vir die onttrekking van hierdie tipe inhoud op dieselfde manier as wat jy’n eenvoudige beeld uit’n vorm as weergegee inhoud kan onttrek. Hierdie artikel beskryf hoe om hierdie funksie te gebruik om vorms onafhanklik van die dokument te lewer.
Vorm Tipes in Aspose.Words
Al die inhoud in’n dokument tekening laag word verteenwoordig deur die Shape of GroupShape node in die Aspose.Words Document Object Module (DOM). Sulke inhoud kan teks bokse, beelde, AutoShapes, OLE voorwerpe, ens wees. Sommige velde word ook ingevoer as vorms, byvoorbeeld die INCLUDEPICTURE veld.
‘n eenvoudige beeld word voorgestel deur’n Shape knoop van ShapeType.Image. Hierdie vorm node het geen kind nodes maar die beeld data wat binne hierdie vorm node kan verkry word deur die Shape.ImageData eiendom. Aan die ander kant kan’n vorm ook uit baie kind-knope bestaan. Byvoorbeeld, ‘n teks boks vorm, wat verteenwoordig word deur die ShapeType.TextBox eienskap, kan bestaan uit baie nodes, soos Paragraph en Table. Die meeste vorms kan die Paragraph en Table blokvlak-knope insluit. Dit is dieselfde nodusse as diegene wat in die hoofliggaam verskyn. Vorms is altyd dele van’n paragraaf, of direk in lyn of veranker aan die Paragraph, maar “dryf” op enige plek in die dokument bladsy.
‘n dokument kan ook vorms bevat wat saam gegroepeer is. Groepering kan in Microsoft Word geaktiveer word deur verskeie voorwerpe te kies en op “Groep” in die regskliek-menu te klik.
In Aspose.Words word hierdie groepe vorms voorgestel deur die GroupShape knoop. Dit kan ook op dieselfde manier opgeroep word om die hele groep na beeld te lewer.
Die DOCX - formaat kan spesiale soorte beelde bevat, soos diagramme of kaarte. Hierdie vorms word ook verteenwoordig deur die Shape knoop in Aspose.Words, wat ook’n soortgelyke metode bied om hulle as beelde te lewer. Volgens ontwerp kan’n vorm nie’n ander vorm as kind bevat nie, tensy daardie vorm’n beeld is (ShapeType.Image). Byvoorbeeld, Microsoft Word laat jou nie toe om’n tekskassie in’n ander tekskassie in te voeg nie.
Die vorm tipes hierbo beskryf bied’n spesiale metode om die vorms te lewer deur die ShapeRenderer klas. ‘n voorbeeld van die ShapeRenderer klas word verkry vir a Shape of GroupShape deur die GetShapeRenderer metode of deur die Shape aan die konstruktor van die ShapeRenderer klas te gee. Hierdie klas bied toegang tot lede, wat toelaat dat die lewering van’n vorm aan die volgende:
- Lêer op die skyf met behulp van die Save metode oorlading
- Stroom met behulp van die Save metode oorlading
- .NET Grafiese Voorwerp deur die RenderToSize en RenderToScale metodes te gebruik
Rendering Na Lêer of Stroom
Die Save metode bied oorladings wat’n vorm direk aan’n lêer of stroom weergee. Beide oorladings aanvaar’n geval van die ImageSaveOptions klas, wat toelaat om opsies vir die lewering van die vorm te definieer. Dit werk op dieselfde manier as die Document.Save metode. Selfs al is hierdie parameter vereis, kan jy’n nul waarde slaag, spesifiseer dat daar geen persoonlike opsies.
Die vorm kan uitgevoer word in enige beeld formaat wat in die SaveFormat opsomming. Byvoorbeeld, die beeld kan weergegee word as’n raster beeld, soos JPEG deur die SaveFormat.Jpeg opsomming te spesifiseer, of as’n vektor beeld, soos EMF deur die SaveFormat.Emf te spesifiseer.
Die kode voorbeeld hieronder illustreer die lewering van’n vorm aan’n EMF beeld afsonderlik van dokument, en stoor na skyf:
Die kode voorbeeld hieronder illustreer die lewering van’n vorm aan’n JPEG beeld afsonderlik van dokument, en stoor na’n stroom:
Met die ImageSaveOptions - klas kan u’n verskeidenheid opsies spesifiseer wat beheer hoe die beeld weergegee word. Die funksionaliteit hierbo beskryf kan op dieselfde manier toegepas word op die GroupShape en Shape nodes.
Vertoon Na’n .NET Grafiese Voorwerp
Deur direk na’n Graphics voorwerp te lewer, kan jy jou eie instellings en die toestand vir die Graphics voorwerp definieer. ‘n algemene scenario behels die lewering van’n vorm direk in’n Graphics voorwerp verkry uit’n Windows Vorm of’n Bitmap. Wanneer die Shape knoop weergegee word, sal die instellings die vorm voorkoms beïnvloed. Byvoorbeeld, jy kan die vorm draai of skaal deur die RotateTransform of ScaleTransform metodes vir die Graphics voorwerp te gebruik.
Die onderstaande voorbeeld toon hoe om’n vorm aan’n te gee .NET Graphics voorwerp afsonderlik van die dokument en pas rotasie toe op die weergegee beeld:
Net so, om die RenderToSize metode, die RenderToSizemetode geërf van die NodeRendererBase is nuttig vir die skep van miniatuur van’n dokument inhoud. Die vorm grootte word gespesifiseer deur die konstruktor. Die RenderToSize metode aanvaar die Graphics voorwerp, die X en Y koördinate van die beeld posisie, en die grootte van die beeld (breedte en hoogte) wat op die Graphics voorwerp geteken sal word.
Die Shape kan weergegee word op’n sekere skaal met behulp van die ShapeRenderer.RenderToScale metode geërf van die NodeRendererBase klas. Dit is soortgelyk aan die Document.RenderToScale metode wat dieselfde hoofparameters aanvaar. Die verskil tussen hierdie twee metodes is dat met die ShapeRenderer.RenderToScale metode, in plaas van’n letterlike grootte, kies jy’n drywende waarde wat die vorm skaal tydens sy weergawe. As die drywende waarde gelyk is aan 1.0 veroorsaak dat die vorm weergegee word op 100% van sy oorspronklike grootte. ‘n vloot waarde van 0.5 sal die beeld grootte verminder deur die helfte.
Vertoon’n Vormbeeld
Die Shape klas verteenwoordig voorwerpe in die tekening laag, soos’n AutoShape, teks boks, vrye vorm, OLE voorwerp, ActiveX beheer, of’n prentjie. Deur die Shape klas te gebruik, kan jy vorms in’n Microsoft Word dokument skep of verander. ‘n belangrike eienskap van’n vorm is sy ShapeType. Vorms van verskillende tipes kan verskillende vermoëns in’n Word-dokument hê. Byvoorbeeld, slegs beeld en OLE vorms kan beelde binne hulle hê terwyl die meeste van die vorms slegs teks kan hê.
Die volgende voorbeeld toon hoe om’n Vorm beeld te lewer aan’n JPEG beeld afsonderlik van die dokument en stoor dit op die skyf:
Verkry’n Vormgrootte
Die ShapeRenderer klas bied ook funksionaliteit om die grootte van die vorm in pixels te haal deur die GetSizeInPixels metode. Hierdie metode aanvaar twee float (Enkel) parameters die skaal en DPI, wat gebruik word in die berekening van die vorm grootte wanneer die vorm weergegee word. Die metode gee terug die Size voorwerp, wat die breedte en hoogte van die berekende grootte bevat. Dit is nuttig wanneer dit nodig is om die grootte van die weergegee vorm vooraf te ken, byvoorbeeld wanneer die skep van’n nuwe Bitmap van die weergegee uitset.
Die onderstaande voorbeeld toon hoe om’n Nuwe Bitmap en Grafiese voorwerp te skep met die breedte en hoogte van die vorm wat weergegee moet word:
Wanneer die RenderToSize of RenderToScale metodes gebruik word, word die weergegee beeld grootte ook teruggestuur in die SizeF voorwerp. Dit kan aan’n veranderlike toegeken word en gebruik word indien nodig.
Die SizeInPoints eienskap gee terug Die Vorm grootte gemeet in punte (sien ShapeRenderer. Die resultaat is’n SizeF voorwerp wat die breedte en hoogte bevat.