L56997enx-Latin1frRapportRapportPPE ExtIndexExtIndexPPParagrapheParagraphPB L9329EN2 L93303 L9331     L9332Global Index4 L93335 L9334 L9335 L9336CF@ L9337EN( L9338rV L273) L9339 * L9340 L9341Library* L9342 L9343GrifKernel( L9344rV L343) L9345 * L9346 L9347Errors* L9348 L9349in API functions( L9350rV L351) L9351 * L9352 L9353TtaGetErrorCode( L9354rV L360) L9355 * L9356 L9357TtaGetErrorCode( L9358rV L364) L9359 * L9360 L9361TtaSetErrorMessages( L9418rV L591) L9419 * L9420 L9421TtaInitialize( L9422) L9423 * L9424 L9425TtaQuit( L32622) L32623 * L32624 L32625TtaInitializeAppRegistry( L32630) L32631 * L32632 L32633TtaSaveAppRegistry( L32638) L32639 * L32640 L32641TtaGetEnvString( L9426rV L629) L9427 * L9428 L9429TtaGetMemory( L9430rV L669) L9431 * L9432 L9433TtaFreeMemory( L9434rV L677) L9435 * L9436 L9437TtaGetMemory( L9438rV L709) L9439 * L9440 L9441TtaSetErrorMessages( L9442rV L737) L9443 * L9444 L9445TtaGetVersion( L9446rV L759) L9447 * L9448 L9449TtaGetErrorCode( L9450rV L782) L9451 * L9452 L9453TtaGetStrError( L9454rV L831) L9455 * L9456 L9457TtaOpenDocument( L9458rV L840) L9459 * L9460 L9461TtaNewDocument( L9462rV L844) L9463 * L9464 L9465TtaGiveSchemasOfDocument( L9466rV L866) L9467 * L9468 L9469TtaSaveDocument( L9470rV L870) L9471 * L9472 L9473TtaOpenDocument( L9474rV L890) L9475 * L9476 L9477TtaOpenDocument( L9478rV L904) L9479 * L9480 L9481TtaSetDocumentPath( L9482rV L912) L9483 * L9484 L9485TtaNewDocument( L9486rV L918) L9487 * L9488 L9489TtaSetSchemaPath( L9490rV L922) L9491 * L9492 L9493TtaNewNature( L9494rV L935) L9495 * L9496 L9497TtaSetDocumentAccessMode( L9498rV L981) L9499 * L9500 L9501TtaNewDocument( L9502rV L1010) L9503 * L9504 L9505TtaSetDocumentPath( L9506rV L1024) L9507 * L9508 L9509TtaOpenDocument( L9510rV L1049) L9511 * L9512 L9513TtaSetDocumentPath( L9514rV L1066) L9515 * L9516 L9517TtaSaveDocument( L9518rV L1095) L9519 * L9520 L9521TtaSetDocumentPath( L9522rV L1099) L9523 * L9524 L9525TtaOpenDocument( L9526rV L1103) L9527 * L9528 L9529TtaNewDocument( L9530rV L1107) L9531 * L9532 L9533TtaRemoveDocument( L13419rV L13418) L13420 * L13421 L13422TtaSaveDocument( L9534rV L1112) L9535 * L9536 L9537TtaCloseDocument( L9538rV L1137) L9539 * L9540 L9541TtaRemoveDocument( L9542rV L1161) L9543 * L9544 L9545TtaSetDocumentPath( L9546rV L1169) L9547 * L9548 L9549TtaOpenDocument( L9550rV L1189) L9551 * L9552 L9553TtaAppendDocumentPath( L9554rV L1213) L9555 * L9556 L9557TtaSetSchemaPath( L9558rV L1242) L9559 * L9560 L9561TtaNewNature( L9562rV L1285) L9563 * L9564 L9565TtaNewSchemaExtension( L9566rV L1330) L9567 * L9568 L9569TtaRemoveSchemaExtension( L9570rV L1377) L9571 * L9572 L9573TtaSetPSchema( L9574rV L1408) L9575 * L9576 L9577TtaSetDocumentDirectory( L13460rV L13459) L13461 * L13462 L13463TtaSetDocumentName( L9578rV L1438) L9579 * L9580 L9581TtaSetDocumentAccessMode( L13495rV L13494) L13496 * L13497 L13498TtaSetDocumentBackUpInterval( L9582rV L1468) L9583 * L9584 L9585TtaSetNotificationMode( L9586rV L1498) L9587 * L9588 L9589TtaSetDocumentModified( L9590rV L1523) L9591 * L9592 L9593TtaSetDocumentUnmodified( L9594rV L1551) L9595 * L9596 L9597TtaGetDocumentName( L9598rV L1582) L9599 * L9600 L9601TtaGetDocumentFromName( L9602rV L1613) L9603 * L9604 L9605TtaGetDocumentSSchema( L9606rV L1646) L9607 * L9608 L9609TtaGetSSchemaName( L9610rV L1678) L9611 * L9612 L9613TtaGetPSchemaName( L9614rV L1710) L9615 * L9616 L9617TtaGetDocumentDirectory( L9618rV L1755) L9619 * L9620 L9621TtaGetSSchema( L9622rV L1793) L9623 * L9624 L9625TtaSameSSchemas( L9626rV L1831) L9627 * L9628 L9629TtaGiveSchemasOfDocument( L9630rV L1881) L9631 * L9632 L9633TtaNextSchemaExtension( L9634rV L1920) L9635 * L9636 L9637TtaNextNature( L9638rV L1960) L9639 * L9640 L9641TtaIsDocumentModified( L9642rV L1968) L9643 * L9644 L9645TtaSetDocumentModified( L13532rV L13531) L13533 * L13534 L13535TtaGetDocumentBackUpInterval( L9646rV L1996) L9647 * L9648 L9649TtaGetDocumentAccessMode( L9650rV L2028) L9651 * L9652 L9653TtaGetNotificationMode( L9654rV L2064) L9655 * L9656 L9657TtaGetDocumentPath( L9658rV L2072) L9659 * L9660 L9661TtaOpenDocument( L9662rV L2108) L9663 * L9664 L9665TtaGetSchemaPath( L9666rV L2147) L9667 * L9668 L9669TtaGetDocumentOfSavedElements( L9670rV L2213) L9671 * L9672 L9673TtaSetCheckingMode( L9674rV L2222) L9675 * L9676 L9677TtaListAbstractTree( L9678rV L2250) L9679 * L9680 L9681TtaNewElement( L9682rV L2254) L9683 * L9684 L9685TtaNewTree( L9686rV L2258) L9687 * L9688 L9689TtaCopyTree( L9690rV L2262) L9691 * L9692 L9693TtaInsertSibling( L9694rV L2266) L9695 * L9696 L9697TtaInsertFirstChild( L9698rV L2270) L9699 * L9700 L9701TtaAttachNewTree( L9702rV L2284) L9703 * L9704 L9705TtaNewElement( L9706rV L2288) L9707 * L9708 L9709TtaNewTree( L9710rV L2292) L9711 * L9712 L9713TtaCopyTree( L9714rV L2296) L9715 * L9716 L9717TtaSearchElementByLabel( L9718rV L2300) L9719 * L9720 L9721TtaGetElementLabel( L9722rV L2345) L9723 * L9724 L9725TtaNewElement( L9726rV L2383) L9727 * L9728 L9729TtaNewTree( L9730rV L2427) L9731 * L9732 L9733TtaCopyTree( L9734) L9735 * L9736 L9737TtaCreateDescent( L25553) L25554 * L25555 L25556TtaCreateDescentWithContent( L9738rV L2522) L9739 * L9740 L9741TtaDeleteTree( L9742rV L2553) L9743 * L9744 L9745TtaAttachNewTree( L53266rV L53265) L53267 * L53268 L53269TtaExportTree( L9746rV L2587) L9747 * L9748 L9749TtaInsertSibling( L9750rV L2629) L9751 * L9752 L9753TtaInsertFirstChild( L32713) L32714 * L32715 L32716TtaCreateElement( L32721) L32722 * L32723 L32724TtaInsertElement( L9754rV L2677) L9755 * L9756 L9757TtaRemoveTree( L9758rV L2707) L9759 * L9760 L9761TtaSetAccessRight( L9762rV L2742) L9763 * L9764 L9765TtaHolophrastElement( L9766rV L2779) L9767 * L9768 L9769TtaSetCheckingMode( L9770rV L2807) L9771 * L9772 L9773TtaGetMainRoot( L9774rV L2839) L9775 * L9776 L9777TtaNextAssociatedRoot( L9778rV L2879) L9779 * L9780 L9781TtaGetFirstChild( L9782rV L2911) L9783 * L9784 L9785TtaGetLastChild( L9786rV L2943) L9787 * L9788 L9789TtaPreviousSibling( L9790rV L2977) L9791 * L9792 L9793TtaNextSibling( L9794rV L3010) L9795 * L9796 L9797TtaGetSuccessor( L9798rV L3044) L9799 * L9800 L9801TtaGetPredecessor( L9802rV L3077) L9803 * L9804 L9805TtaGetParent( L9806rV L3109) L9807 * L9808 L9809TtaGetCommonAncestor( L9810rV L3147) L9811 * L9812 L9813TtaGetTypedAncestor( L9814rV L3185) L9815 * L9816 L9817TtaGetElementType( L9818rV L3218) L9819 * L9820 L9821TtaGetElementTypeName( L9822rV L3250) L9823 * L9824 L9825TtaGiveTypeFromName( L9826rV L3289) L9827 * L9828 L9829TtaSameTypes( L9830rV L3328) L9831 * L9832 L9833TtaGetElementLabel( L9834rV L3360) L9835 * L9836 L9837TtaIsConstant( L9838rV L3392) L9839 * L9840 L9841TtaIsLeaf( L9842rV L3426) L9843 * L9844 L9845TtaGetConstructOfType( L9846rV L3458) L9847 * L9848 L9849TtaGetConstruct( L9850rV L3490) L9851 * L9852 L9853TtaGetAccessRight( L9854rV L3522) L9855 * L9856 L9857TtaIsHolophrasted( L9858rV L3555) L9859 * L9860 L9861TtaIsReadOnly( L9862rV L3587) L9863 * L9864 L9865TtaIsHidden( L9866rV L3619) L9867 * L9868 L9869TtaIsInAnInclusion( L9870rV L3652) L9871 * L9872 L9873TtaIsAncestor( L9874rV L3690) L9875 * L9876 L9877TtaIsBefore( L32297) L32298 * L32299 L32300TtaCanInsertSibling( L32305) L32306 * L32307 L32308TtaCanInsertFirstChild( L9878rV L3728) L9879 * L9880 L9881TtaIsFirstPairedElement( L9882rV L3760) L9883 * L9884 L9885TtaGetDocument( L9886rV L3793) L9887 * L9888 L9889TtaNextCopiedElement( L9890rV L3826) L9891 * L9892 L9893TtaGetCopiedDocument( L9894rV L3859) L9895 * L9896 L9897TtaSearchTypedElement( L9898rV L3904) L9899 * L9900 L9901TtaSearchElementByLabel( L9902rV L3942) L9903 * L9904 L9905TtaSearchEmptyElement( L9906rV L3981) L9907 * L9908 L9909TtaSearchOtherPairedElement( L9910rV L4013) L9911 * L9912 L9913TtaSearchNoPageBreak( L9914rV L4055) L9915 * L9916 L9917TtaListAbstractTree( L9918rV L4100) L9919 * L9920 L9921TtaSetTextContent( L9922rV L4144) L9923 * L9924 L9925TtaAppendTextContent( L9926rV L4181) L9927 * L9928 L9929TtaInsertTextContent( L9930rV L4223) L9931 * L9932 L9933TtaDeleteTextContent( L9934rV L4266) L9935 * L9936 L9937TtaSplitText( L9938rV L4302) L9939 * L9940 L9941TtaMergeText( L9942rV L4343) L9943 * L9944 L9945TtaSetGraphicsShape( L9946rV L4380) L9947 * L9948 L9949TtaAddPointInPolyline( L9950rV L4421) L9951 * L9952 L9953TtaDeletePointInPolyline( L9954rV L4457) L9955 * L9956 L9957TtaModifyPointInPolyline( L9958rV L4499) L9959 * L9960 L9961TtaChangeLimitOfPolyline( L9962rV L4534) L9963 * L9964 L9965TtaCopyPage( L9966rV L4570) L9967 * L9968 L9969TtaGetTextLength( L9970rV L4602) L9971 * L9972 L9973TtaGiveTextContent( L9974rV L4660) L9975 * L9976 L9977TtaGiveSubString( L9978rV L4711) L9979 * L9980 L9981TtaGetGraphicsShape( L9982rV L4744) L9983 * L9984 L9985TtaGetPolylineLength( L9986rV L4768) L9987 * L9988 L9989TtaGivePolylinePoint( L9990rV L4810) L9991 * L9992 L9993TtaGetPageNumber( L9994rV L4842) L9995 * L9996 L9997TtaGetPageView( L9998rV L4893) L9999 * L10000 L10001TtaNewAttribute( L10002rV L4897) L10003 * L10004 L10005TtaAttachAttribute( L10006rV L4907) L10007 * L10008 L10009TtaNewAttribute( L10010rV L4940) L10011 * L10012 L10013TtaAttachAttribute( L10014rV L4976) L10015 * L10016 L10017TtaRemoveAttribute( L10018rV L5016) L10019 * L10020 L10021TtaSetAttributeValue( L10022rV L5059) L10023 * L10024 L10025TtaSetAttributeText( L10026rV L5105) L10027 * L10028 L10029TtaNextAttribute( L10030rV L5145) L10031 * L10032 L10033TtaGetAttribute( L10034rV L5183) L10035 * L10036 L10037TtaGiveAttributeType( L10038rV L5224) L10039 * L10040 L10041TtaGiveAttributeTypeFromName( L10042rV L5272) L10043 * L10044 L10045TtaGetAttributeName( L10046rV L5304) L10047 * L10048 L10049TtaSameAttributeTypes( L10050rV L5342) L10051 * L10052 L10053TtaGetAttributeValue( L10054rV L5375) L10055 * L10056 L10057TtaGetTextAttributeLength( L10058rV L5407) L10059 * L10060 L10061TtaGiveTextAttributeValue( L10062rV L5460) L10063 * L10064 L10065TtaSearchAttribute( L10066rV L5528) L10067 * L10068 L10069TtaSetReference( L10070rV L5571) L10071 * L10072 L10073TtaNewInclusion( L10074rV L5615) L10075 * L10076 L10077TtaCopyReference( L10078rV L5645) L10079 * L10080 L10081TtaSetAttributeReference( L10082rV L5694) L10083 * L10084 L10085TtaCopyAttributeReference( L46843rV L46842) L46844 * L46845 L46846TtaCopyIncludedElem( L43584rV L43583) L43585 * L43586 L43587TtaUpdateInclusionElements( L10086rV L5735) L10087 * L10088 L10089TtaGiveReferredElement( L10090rV L5783) L10091 * L10092 L10093TtaIsElementTypeReference( L10094rV L5815) L10095 * L10096 L10097TtaSameReferences( L10098rV L5853) L10099 * L10100 L10101TtaGiveReferenceAttributeValue( L10102rV L5901) L10103 * L10104 L10105TtaIsElementReferred( L10106rV L5933) L10107 * L10108 L10109TtaSameReferenceAttributes( L10110rV L5976) L10111 * L10112 L10113TtaNextLoadedReference( L10114rV L6042) L10115 * L10116 L10117TtaNextUnloadedReferringDocument( L10118rV L6087) L10119 * L10120 L10121TtaSearchReferenceElement( L10122rV L6157) L10123 * L10124 L10125TtaNewLanguage( L10126rV L6220) L10127 * L10128 L10129TtaLoadLanguageDictionaries( L10130rV L6258) L10131 * L10132 L10133TtaUnLoadLanguageDictionaries( L13901) L13902 * L13903 L13904 TtaLoadTypoDictionaries( L13905) L13906 * L13907 L13908 TtaUnLoadTypoDictionaries( L10134rV L6287) L10135 * L10136 L10137TtaGetLanguageIdFromName( L10138rV L6319) L10139 * L10140 L10141TtaGetDefaultLanguage( L10142rV L6340) L10143 * L10144 L10145TtaGetLanguageIdFromAlphabet( L10146rV L6372) L10147 * L10148 L10149TtaGetAlphabet( L10150rV L6405) L10151 * L10152 L10153TtaGetLanguageName( L10154rV L6437) L10155 * L10156 L10157TtaGetPrincipalDictionary( L10158rV L6460) L10159 * L10160 L10161TtaGetSecondaryDictionary( L13957) L13958 * L13959 L13960 TtaGetPrincipalTypoDictionary( L13961) L13962 * L13963 L13964 TtaGetSecondaryTypoDictionary( L10162rV L6483) L10163 * L10164 L10165TtaGetNumberOfLanguages( L10166rV L6516) L10167 * L10168 L10169TtaNewPRule( L10170rV L6520) L10171 * L10172 L10173TtaCopyPRule( L10174rV L6524) L10175 * L10176 L10177TtaAttachPRule( L10178rV L6534) L10179 * L10180 L10181TtaNewPRule( L10182rV L6578) L10183 * L10184 L10185TtaNewPRuleForNamedView( L10186rV L6623) L10187 * L10188 L10189TtaCopyPRule( L10190rV L6655) L10191 * L10192 L10193TtaAttachPRule( L10194rV L6692) L10195 * L10196 L10197TtaRemovePRule( L10198rV L6732) L10199 * L10200 L10201TtaSetPRuleValue( L10202rV L6840) L10203 * L10204 L10205TtaChangeBoxSize( L10206rV L6887) L10207 * L10208 L10209TtaChangeBoxPosition( L10210rV L6940) L10211 * L10212 L10213TtaGiveBoxSize( L10214rV L6987) L10215 * L10216 L10217TtaGiveBoxPosition( L10218rV L7035) L10219 * L10220 L10221TtaNextPRule( L10222rV L7074) L10223 * L10224 L10225TtaGetPRule( L10226rV L7113) L10227 * L10228 L10229TtaGetPRuleType( L10230rV L7145) L10231 * L10232 L10233TtaGetPRuleValue( L10234rV L7235) L10235 * L10236 L10237TtaSamePRules( L10238rV L7287) L10239 * L10240 L10241TtaOpenMainView( L10242rV L7295) L10243 * L10244 L10245TtaSetPSchema( L10246rV L7334) L10247 * L10248 L10249TtaOpenView( L10250rV L7342) L10251 * L10252 L10253TtaSetPSchema( L10254rV L7386) L10255 * L10256 L10257TtaOpenSubView( L10258rV L7394) L10259 * L10260 L10261TtaSetPSchema( L10262rV L7449) L10263 * L10264 L10265TtaChangeViewTitle( L10266rV L7484) L10267 * L10268 L10269TtaCloseView( L10270rV L7519) L10271 * L10272 L10273TtaSetSensibility( L10274rV L7555) L10275 * L10276 L10277TtaSetZoom( L10278rV L7591) L10279 * L10280 L10281TtaShowElement( L28969rV L28968) L28970 * L28971 L28972TtaRaiseView( L10282rV L7634) L10283 * L10284 L10285TtaSetDisplayMode( L10286rV L7668) L10287 * L10288 L10289TtaGetSensibility( L10290rV L7707) L10291 * L10292 L10293TtaGetZoom( L10294rV L7745) L10295 * L10296 L10297TtaGetDisplayMode( L10298rV L7777) L10299 * L10300 L10301TtaIsPSchemaValid( L10302rV L7816) L10303 * L10304 L10305TtaGiveViewsToOpen( L10306rV L7861) L10307 * L10308 L10309TtaGetViewName( L10310rV L7899) L10311 * L10312 L10313TtaGetViewFromName( L10314rV L7938) L10315 * L10316 L10317TtaGiveActiveView( L29018rV L29017) L29019 * L29020 L29021TtaIsViewOpened( L25773rV L25772) L25774 * L25775 L25776TtaListView( L10318rV L7993) L10319 * L10320 L10321TtaSelectElement( L10322rV L8024) L10323 * L10324 L10325TtaSelectString( L10326rV L8066) L10327 * L10328 L10329TtaExtendSelection( L10330rV L8103) L10331 * L10332 L10333 TtaSelectInterval( L10334rV L8132) L10335 * L10336 L10337TtaUnselect( L10338rV L8165) L10339 * L10340 L10341TtaSetSelectionMode( L10342rV L8202) L10343 * L10344 L10345TtaGiveFirstSelectedElement( L10346rV L8252) L10347 * L10348 L10349TtaGiveNextSelectedElement( L10354rV L8372) L10355 * L10356 L10357TtaSetCallback( L10362rV L8412) L10363 * L10364 L10365TtaHandlePendingEvents( L10370rV L8491) L10371 * L10372 L10373TtaAddAction( L10398rV L8691) L10399 * L10400 L10401TtaClickAnElement( L10402rV L8724) L10403 * L10404 L10405TtaResetButton( L10406rV L8761) L10407 * L10408 L10409TtaSuspendButton( L10410rV L8797) L10411 * L10412 L10413TtaSetCursorWatch( L10414rV L8827) L10415 * L10416 L10417TtaResetCursor( L10418rV L8869) L10419 * L10420 L10421environment variable* L10422 L10423(for) Application messages( L10424rV L8927) L10425 * L10426 L10427TtaGetMessageTable( L10428rV L8968) L10429 * L10430 L10431TtaGetMessage( L10432rV L9005) L10433 * L10434 L10435message level( L10436rV L9007) L10437 * L10438 L10439TtaDisplaySimpleMessage( L10446rV L9057) L10447 * L10448 L10449TtaDisplayMessage( L10460) L10461 * L10462 L10463TtaCreatePixmapLogo( L10464) L10465 * L10466 L10467TtaCreateBitmapLogo( L10468rV L9232) L10469 * L10470 L10471TtaListDirectory( L10472rV L9290) L10473 * L10474 L10475TtaIsSuffixFileIn( L10476rV L958) L10477 * L10478 L10479TtaNewNatureC L10480EN L56614DF; L53429 L56613DF< eV L9331 L53430> L53432 L53433 L53434 L53435 L53436E L53437 L53438 L53439 L53440 L53443Environment variable L53444# L53445 L53446 L53447 L53449(for) Application messages L53450 L53451 L53452 L53453 L53455rV L8869 L5345623" L53454rV L10419 L53457 L53458 L53459 L53461Errors L53462# L53463 L53464 L53465 L53467in API functions L53468 L53469 L53470 L53471 L53473rV L343 L534745" L53472rV L9345 L53475 L53476 L53477 L53478L L53479 L53480 L53481 L53482 L53484Library L53485# L53486 L53487 L53488 L53490GrifKernel L53491 L53492 L53493 L53494 L53496rV L273 L534974" L53495rV L9339 L53498 L53499 L53500 L53501M L53502 L53503 L53504 L53505 L53507Message level L53508 L53509 L53510 L53511 L53513rV L9005 L53514 L5351525! L53516rV L9115 L5351726" L53512rV L10433 L53518 L53519 L53520 L53521T L53522 L53523 L53524 L53525 L53527TtaAddAction L53528 L53529 L53530 L53531 L53533rV L8491 L5353415" L53532rV L10371 L53535 L53536 L53538rV L32957 L5353916" L53537rV L10371 L53540 L53541 L53542 L53544TtaAddPointInPolyline L53545 L53546 L53547 L53548 L53550rV L4380 L5355189" L53549rV L9947 L53552 L53553 L53554 L53556TtaAppendDocumentPath L53557 L53558 L53559 L53560 L53562rV L1189 L5356345" L53561rV L9551 L53564 L53565 L53566 L53568TtaAppendTextContent L53569 L53570 L53571 L53572 L53574rV L4144 L5357586" L53573rV L9923 L53576 L53577 L53578 L53580TtaAttachAttribute L53581 L53582 L53583 L53584 L53586rV L4897 L5358797" L53585rV L10003 L53588 L53589 L53591rV L4940 L5359298" L53590rV L10011 L53593 L53594 L53595 L53597TtaAttachNewTree L53598 L53599 L53600 L53601 L53603rV L2270 L5360461" L53602rV L9699 L53605 L53606 L53608rV L2553 L5360965" L53607rV L9743 L53610 L53611 L53612 L53614TtaAttachPRule L53615 L53616 L53617 L53618 L53620rV L6524 L53621122" L53619rV L10175 L53622 L53623 L53625rV L6655 L53626124" L53624rV L10191 L53627 L53628 L53629 L53631TtaCanInsertFirstChild L53632 L53633 L53634 L53635 L53637rV L32304 L5363881" L53636rV L32306 L53639 L53640 L53641 L53643TtaCanInsertSibling L53644 L53645 L53646 L53647 L53649rV L32296 L5365080" L53648rV L32298 L53651 L53652 L53653 L53655TtaChangeBoxPosition L53656 L53657 L53658 L53659 L53661rV L6887 L53662127" L53660rV L10207 L53663 L53664 L53665 L53667TtaChangeBoxSize L53668 L53669 L53670 L53671 L53673rV L6840 L53674126" L53672rV L10203 L53675 L53676 L53677 L53679TtaChangeLimitOfPolyline L53680 L53681 L53682 L53683 L53685rV L4499 L5368691" L53684rV L9959 L53687 L53688 L53689 L53691TtaChangeViewTitle L53692 L53693 L53694 L53695 L53697rV L7449 L53698134" L53696rV L10263 L53699 L53700 L53701 L53703TtaClickAnElement L53704 L53705 L53706 L53707 L53709rV L8691 L5371017" L53708rV L10399 L56615CF L53711 L53712 L53713 L53715TtaCloseDocument L53716 L53717 L53718 L53719 L53721rV L1112 L5372244" L53720rV L9535 L53723 L53724 L53725 L53727TtaCloseView L53728 L53729 L53730 L53731 L53733rV L7484 L53734134" L53732rV L10267 L53735 L53736 L53737 L53739TtaCopyAttributeReference L53740 L53741 L53742 L53743 L53745rV L5694 L53746107" L53744rV L10083 L53747 L53748 L53749 L53751TtaCopyIncludedElem L53752 L53753 L53754 L53755 L53757rV L46842 L53758107" L53756rV L46844 L53759 L53760 L53761 L53763TtaCopyPage L53764 L53765 L53766 L53767 L53769rV L4534 L5377091" L53768rV L9963 L53771 L53772 L53773 L53775TtaCopyPRule L53776 L53777 L53778 L53779 L53781rV L6520 L53782122" L53780rV L10171 L53783 L53784 L53786rV L6623 L53787123" L53785rV L10187 L53788 L53789 L53790 L53792TtaCopyReference L53793 L53794 L53795 L53796 L53798rV L5615 L53799106" L53797rV L10075 L53800 L53801 L53802 L53804TtaCopyTree L53805 L53806 L53807 L53808 L53810rV L2292 L5381161" L53809rV L9711 L53812 L53813 L53815rV L2258 L5381661" L53814rV L9687 L53817 L53818 L53820rV L2427 L5382163" L53819rV L9731 L53822 L53823 L53824 L53826TtaCreateDescent L53827 L53828 L53829 L53830 L53832rV L25514 L5383363" L53831rV L9735 L53834 L53835 L53836 L53838TtaCreateDescentWithContent L53839 L53840 L53841 L53842 L53844rV L25552 L5384564" L53843rV L25554 L53846 L53847 L53848 L53850TtaCreateElement L53851 L53852 L53853 L53854 L53856rV L32712 L5385767" L53855rV L32714 L53858 L53859 L53860 L53862TtaDeletePointInPolyline L53863 L53864 L53865 L53866 L53868rV L4421 L5386990" L53867rV L9951 L53870 L53871 L53872 L53874TtaDeleteTextContent L53875 L53876 L53877 L53878 L53880rV L4223 L5388187" L53879rV L9931 L53882 L53883 L53884 L53886TtaDeleteTree L53887 L53888 L53889 L53890 L53892rV L2522 L5389364" L53891rV L9739 L53894 L53895 L53896 L53898TtaDisplayMessage L53899 L53900 L53901 L53902 L53904rV L9057 L5390525" L53903rV L10447 L53906 L53907 L53908 L53910TtaDisplaySimpleMessage L53911 L53912 L53913 L53914 L53916rV L9007 L5391725" L53915rV L10437 L53918 L53919 L53920 L53922TtaExportTree L53923 L53924 L53925 L53926 L53928rV L53265 L5392965" L53927rV L53267 L53930 L53931 L53932 L53934TtaExtendSelection L53935 L53936 L53937 L53938 L53940rV L8066 L53941143" L53939rV L10327 L53942 L53943 L53944 L53946TtaFreeMemory L53947 L53948 L53949 L53950 L53952rV L669 L5395311" L53951rV L9431 L53954 L53955 L53956 L53958TtaGetAccessRight L53959 L53960 L53961 L53962 L53964rV L3490 L5396577" L53963rV L9851 L53966 L53967 L53968 L53970TtaGetAlphabet L53971 L53972 L53973 L53974 L53976rV L6372 L53977118" L53975rV L10147 L53978 L53979 L53980 L53982TtaGetAttribute L53983 L53984 L53985 L53986 L53988rV L5145 L53989100" L53987rV L10031 L53990 L53991 L53992 L53994TtaGetAttributeName L53995 L53996 L53997 L53998 L54000rV L5272 L54001101" L53999rV L10043 L54002 L54003 L54004 L54006TtaGetAttributeValue L54007 L54008 L54009 L54010 L54012rV L5342 L54013102" L54011rV L10051 L54014 L54015 L54016 L54018TtaGetCommonAncestor L54019 L54020 L54021 L54022 L54024rV L3109 L5402573" L54023rV L9807 L54026 L54027 L54028 L54030TtaGetConstruct L54031 L54032 L54033 L54034 L54036rV L3458 L5403777" L54035rV L9847 L54038 L54039 L54040 L54042TtaGetConstructOfType L54043 L54044 L54045 L54046 L54048rV L3426 L5404976" L54047rV L9843 L54050 L54051 L54052 L54054TtaGetCopiedDocument L54055 L54056 L54057 L54058 L54060rV L3826 L5406182" L54059rV L9891 L54062 L54063 L54064 L54066TtaGetDefaultLanguage L54067 L54068 L54069 L54070 L54072rV L6319 L54073118" L54071rV L10139 L54074 L54075 L54076 L54078TtaGetDisplayMode L54079 L54080 L54081 L54082 L54084rV L7745 L54085138" L54083rV L10295 L54086 L54087 L54088 L54090TtaGetDocument L54091 L54092 L54093 L54094 L54096rV L3760 L5409781" L54095rV L9883 L54098 L54099 L54100 L54102TtaGetDocumentAccessMode L54103 L54104 L54105 L54106 L54108rV L1996 L5410957" L54107rV L9647 L54110 L54111 L54112 L54114TtaGetDocumentBackUpInterval L54115 L54116 L54117 L54118 L54120rV L13531 L5412157" L54119rV L13533 L54122 L54123 L54124 L54126TtaGetDocumentDirectory L54127 L54128 L54129 L54130 L54132rV L1710 L5413353" L54131rV L9615 L56616CF L54134 L54135 L54136 L54138TtaGetDocumentFromName L54139 L54140 L54141 L54142 L54144rV L1582 L5414551" L54143rV L9599 L54146 L54147 L54148 L54150TtaGetDocumentName L54151 L54152 L54153 L54154 L54156rV L1551 L5415751" L54155rV L9595 L54158 L54159 L54160 L54162TtaGetDocumentOfSavedElements L54163 L54164 L54165 L54166 L54168rV L2147 L5416959" L54167rV L9667 L54170 L54171 L54172 L54174TtaGetDocumentPath L54175 L54176 L54177 L54178 L54180rV L2064 L5418158" L54179rV L9655 L54182 L54183 L54184 L54186TtaGetDocumentSSchema L54187 L54188 L54189 L54190 L54192rV L1613 L5419352" L54191rV L9603 L54194 L54195 L54196 L54198TtaGetElementLabel L54199 L54200 L54201 L54202 L54204rV L2300 L5420561" L54203rV L9719 L54206 L54207 L54209rV L3328 L5421075" L54208rV L9831 L54211 L54212 L54213 L54215TtaGetElementType L54216 L54217 L54218 L54219 L54221rV L3185 L5422274" L54220rV L9815 L54223 L54224 L54225 L54227TtaGetElementTypeName L54228 L54229 L54230 L54231 L54233rV L3218 L5423474" L54232rV L9819 L54235 L54236 L54237 L54239TtaGetEnvString L54240 L54241 L54242 L54243 L54245rV L32637 L5424610" L54244rV L32639 L54247 L54248 L54249 L54251TtaGetErrorCode L54252 L54253 L54254 L54255 L54257rV L360 L542585" L54256rV L9355 L54259 L54260 L54262rV L351 L542635" L54261rV L9351 L54264 L54265 L54267rV L759 L5426813" L54266rV L9447 L54269 L54270 L54271 L54273TtaGetFirstChild L54274 L54275 L54276 L54277 L54279rV L2879 L5428070" L54278rV L9779 L54281 L54282 L54283 L54285TtaGetGraphicsShape L54286 L54287 L54288 L54289 L54291rV L4711 L5429294" L54290rV L9979 L54293 L54294 L54295 L54297TtaGetLanguageIdFromAlphabet L54298 L54299 L54300 L54301 L54303rV L6340 L54304118" L54302rV L10143 L54305 L54306 L54307 L54309TtaGetLanguageIdFromName L54310 L54311 L54312 L54313 L54315rV L6287 L54316117" L54314rV L10135 L54317 L54318 L54319 L54321TtaGetLanguageName L54322 L54323 L54324 L54325 L54327rV L6405 L54328119" L54326rV L10151 L54329 L54330 L54332rV L36192 L54333119" L54331rV L10151 L54334 L54335 L54337rV L36161 L54338119" L54336rV L10151 L54339 L54340 L54341 L54343TtaGetLastChild L54344 L54345 L54346 L54347 L54349rV L2911 L5435071" L54348rV L9783 L54351 L54352 L54353 L54355TtaGetMainRoot L54356 L54357 L54358 L54359 L54361rV L2807 L5436269" L54360rV L9771 L54363 L54364 L54365 L54367TtaGetMemory L54368 L54369 L54370 L54371 L54373rV L677 L5437411" L54372rV L9435 L54375 L54376 L54378rV L629 L5437911" L54377rV L9427 L54380 L54381 L54382 L54384TtaGetMessage L54385 L54386 L54387 L54388 L54390rV L8968 L5439124" L54389rV L10429 L54392 L54393 L54394 L54396TtaGetMessageTable L54397 L54398 L54399 L54400 L54402rV L8927 L5440324" L54401rV L10425 L54404 L54405 L54406 L54408TtaGetNotificationMode L54409 L54410 L54411 L54412 L54414rV L2028 L5441557" L54413rV L9651 L54416 L54417 L54418 L54420TtaGetNumberOfLanguages L54421 L54422 L54423 L54424 L54426rV L6483 L54427121" L54425rV L10163 L54428 L54429 L54430 L54432TtaGetPageNumber L54433 L54434 L54435 L54436 L54438rV L4810 L5443995" L54437rV L9991 L54440 L54441 L54442 L54444TtaGetPageView L54445 L54446 L54447 L54448 L54450rV L4842 L5445196" L54449rV L9995 L54452 L54453 L54454 L54456TtaGetParent L54457 L54458 L54459 L54460 L54462rV L3077 L5446372" L54461rV L9803 L54464 L54465 L54466 L54468TtaGetPolylineLength L54469 L54470 L54471 L54472 L54474rV L4744 L5447594" L54473rV L9983 L54476 L54477 L54478 L54480TtaGetPredecessor L54481 L54482 L54483 L54484 L54486rV L3044 L5448772" L54485rV L9799 L54488 L54489 L54490 L54492TtaGetPrincipalDictionary L54493 L54494 L54495 L54496 L54498rV L6437 L54499120" L54497rV L10155 L54500 L54501 L54502 L54504TtaGetPrincipalTypoDictionary L54505 L54506 L54507 L54508 L54510rV L13912 L54511120" L54509rV L13958 L54512 L54513 L54514 L54516TtaGetPRule L54517 L54518 L54519 L54520 L54522rV L7074 L54523129" L54521rV L10223 L54524 L54525 L54526 L54528TtaGetPRuleType L54529 L54530 L54531 L54532 L54534rV L7113 L54535129" L54533rV L10227 L54536 L54537 L54538 L54540TtaGetPRuleValue L54541 L54542 L54543 L54544 L54546rV L7145 L54547130" L54545rV L10231 L54548 L54549 L54551rV L36850 L54552131" L54550rV L10231 L54553 L54554 L54555 L54557TtaGetPSchemaName L54558 L54559 L54560 L54561 L54563rV L1678 L5456453" L54562rV L9611 L54565 L54566 L54567 L54569TtaGetSchemaPath L54570 L54571 L54572 L54573 L54575rV L2108 L5457658" L54574rV L9663 L56617CF L54577 L54578 L54579 L54581TtaGetSecondaryDictionary L54582 L54583 L54584 L54585 L54587rV L6460 L54588120" L54586rV L10159 L54589 L54590 L54591 L54593TtaGetSecondaryTypoDictionary L54594 L54595 L54596 L54597 L54599rV L13935 L54600121" L54598rV L13962 L54601 L54602 L54603 L54605TtaGetSensibility L54606 L54607 L54608 L54609 L54611rV L7668 L54612137" L54610rV L10287 L54613 L54614 L54615 L54617TtaGetSSchema L54618 L54619 L54620 L54621 L54623rV L1755 L5462454" L54622rV L9619 L54625 L54626 L54627 L54629TtaGetSSchemaName L54630 L54631 L54632 L54633 L54635rV L1646 L5463652" L54634rV L9607 L54637 L54638 L54639 L54641TtaGetStrError L54642 L54643 L54644 L54645 L54647rV L782 L5464813" L54646rV L9451 L54649 L54650 L54651 L54653TtaGetSuccessor L54654 L54655 L54656 L54657 L54659rV L3010 L5466072" L54658rV L9795 L54661 L54662 L54663 L54665TtaGetTextAttributeLength L54666 L54667 L54668 L54669 L54671rV L5375 L54672102" L54670rV L10055 L54673 L54674 L54675 L54677TtaGetTextLength L54678 L54679 L54680 L54681 L54683rV L4570 L5468492" L54682rV L9967 L54685 L54686 L54687 L54689TtaGetTypedAncestor L54690 L54691 L54692 L54693 L54695rV L3147 L5469673" L54694rV L9811 L54697 L54698 L54699 L54701TtaGetVersion L54702 L54703 L54704 L54705 L54707rV L737 L5470812" L54706rV L9443 L54709 L54710 L54711 L54713TtaGetViewFromName L54714 L54715 L54716 L54717 L54719rV L7899 L54720139" L54718rV L10311 L54721 L54722 L54723 L54725TtaGetViewName L54726 L54727 L54728 L54729 L54731rV L7861 L54732139" L54730rV L10307 L54733 L54734 L54735 L54737TtaGetZoom L54738 L54739 L54740 L54741 L54743rV L7707 L54744137" L54742rV L10291 L54745 L54746 L54747 L54749TtaGiveActiveView L54750 L54751 L54752 L54753 L54755rV L7938 L54756140" L54754rV L10315 L54757 L54758 L54759 L54761TtaGiveAttributeType L54762 L54763 L54764 L54765 L54767rV L5183 L54768100" L54766rV L10035 L54769 L54770 L54771 L54773TtaGiveAttributeTypeFromName L54774 L54775 L54776 L54777 L54779rV L5224 L54780101" L54778rV L10039 L54781 L54782 L54783 L54785TtaGiveBoxPosition L54786 L54787 L54788 L54789 L54791rV L6987 L54792128" L54790rV L10215 L54793 L54794 L54795 L54797TtaGiveBoxSize L54798 L54799 L54800 L54801 L54803rV L6940 L54804127" L54802rV L10211 L54805 L54806 L54807 L54809TtaGiveFirstSelectedElement L54810 L54811 L54812 L54813 L54815rV L33392 L54816145" L54814rV L10343 L54817 L54818 L54820rV L8202 L54821145" L54819rV L10343 L54822 L54823 L54825rV L46786 L54826145" L54824rV L10343 L54827 L54828 L54829 L54831TtaGiveNextSelectedElement L54832 L54833 L54834 L54835 L54837rV L8252 L54838146" L54836rV L10347 L54839 L54840 L54841 L54843TtaGivePolylinePoint L54844 L54845 L54846 L54847 L54849rV L4768 L5485095" L54848rV L9987 L54851 L54852 L54853 L54855TtaGiveReferenceAttributeValue L54856 L54857 L54858 L54859 L54861rV L5853 L54862110" L54860rV L10099 L54863 L54864 L54865 L54867TtaGiveReferredElement L54868 L54869 L54870 L54871 L54873rV L5735 L54874108" L54872rV L10087 L54875 L54876 L54877 L54879TtaGiveSchemasOfDocument L54880 L54881 L54882 L54883 L54885rV L844 L5488639" L54884rV L9463 L54887 L54888 L54890rV L1831 L5489154" L54889rV L9627 L54892 L54893 L54894 L54896TtaGiveSubString L54897 L54898 L54899 L54900 L54902rV L4660 L5490393" L54901rV L9975 L54904 L54905 L54906 L54908TtaGiveTextAttributeValue L54909 L54910 L54911 L54912 L54914rV L5407 L54915103" L54913rV L10059 L54916 L54917 L54918 L54920TtaGiveTextContent L54921 L54922 L54923 L54924 L54926rV L4602 L5492793" L54925rV L9971 L54928 L54929 L54930 L54932TtaGiveTypeFromName L54933 L54934 L54935 L54936 L54938rV L3250 L5493974" L54937rV L9823 L54940 L54941 L54942 L54944TtaGiveViewsToOpen L54945 L54946 L54947 L54948 L54950rV L7816 L54951138" L54949rV L10303 L54952 L54953 L54954 L54956TtaHandlePendingEvents L54957 L54958 L54959 L54960 L54962rV L25485 L5496315" L54961rV L10363 L54964 L54965 L54967rV L8412 L5496815" L54966rV L10363 L54969 L54970 L54971 L54973TtaHolophrastElement L54974 L54975 L54976 L54977 L54979rV L2742 L5498069" L54978rV L9763 L54981 L54982 L54983 L54985TtaInitialize L54986 L54987 L54988 L54989 L54991rV L591 L549929" L54990rV L9419 L54993 L54994 L54995 L54997TtaInitializeAppRegistry L54998 L54999 L55000 L55001 L55003rV L32621 L550049" L55002rV L32623 L56618CF L55005 L55006 L55007 L55009TtaInsertElement L55010 L55011 L55012 L55013 L55015rV L32720 L5501667" L55014rV L32722 L55017 L55018 L55019 L55021TtaInsertFirstChild L55022 L55023 L55024 L55025 L55027rV L2266 L5502861" L55026rV L9695 L55029 L55030 L55032rV L2629 L5503366" L55031rV L9751 L55034 L55035 L55036 L55038TtaInsertSibling L55039 L55040 L55041 L55042 L55044rV L2262 L5504561" L55043rV L9691 L55046 L55047 L55049rV L2587 L5505066" L55048rV L9747 L55051 L55052 L55053 L55055TtaInsertTextContent L55056 L55057 L55058 L55059 L55061rV L4181 L5506287" L55060rV L9927 L55063 L55064 L55065 L55067TtaIsAncestor L55068 L55069 L55070 L55071 L55073rV L3652 L5507479" L55072rV L9871 L55075 L55076 L55077 L55079TtaIsBefore L55080 L55081 L55082 L55083 L55085rV L3690 L5508679" L55084rV L9875 L55087 L55088 L55089 L55091TtaIsConstant L55092 L55093 L55094 L55095 L55097rV L3360 L5509876" L55096rV L9835 L55099 L55100 L55101 L55103TtaIsDocumentModified L55104 L55105 L55106 L55107 L55109rV L1960 L5511056" L55108rV L9639 L55111 L55112 L55113 L55115TtaIsElementReferred L55116 L55117 L55118 L55119 L55121rV L5901 L55122110" L55120rV L10103 L55123 L55124 L55125 L55127TtaIsElementTypeReference L55128 L55129 L55130 L55131 L55133rV L5783 L55134109" L55132rV L10091 L55135 L55136 L55137 L55139TtaIsFirstPairedElement L55140 L55141 L55142 L55143 L55145rV L3728 L5514680" L55144rV L9879 L55147 L55148 L55149 L55151TtaIsHidden L55152 L55153 L55154 L55155 L55157rV L3587 L5515878" L55156rV L9863 L55159 L55160 L55161 L55163TtaIsHolophrasted L55164 L55165 L55166 L55167 L55169rV L3522 L5517077" L55168rV L9855 L55171 L55172 L55173 L55175TtaIsInAnInclusion L55176 L55177 L55178 L55179 L55181rV L3619 L5518279" L55180rV L9867 L55183 L55184 L55185 L55187TtaIsLeaf L55188 L55189 L55190 L55191 L55193rV L3392 L5519476" L55192rV L9839 L55195 L55196 L55197 L55199TtaIsPSchemaValid L55200 L55201 L55202 L55203 L55205rV L7777 L55206138" L55204rV L10299 L55207 L55208 L55209 L55211TtaIsReadOnly L55212 L55213 L55214 L55215 L55217rV L3555 L5521878" L55216rV L9859 L55219 L55220 L55221 L55223TtaIsSuffixFileIn L55224 L55225 L55226 L55227 L55229rV L35703 L5523037" L55228rV L10473 L55231 L55232 L55234rV L9290 L5523537" L55233rV L10473 L55236 L55237 L55238 L55240TtaIsViewOpened L55241 L55242 L55243 L55244 L55246rV L29017 L55247140" L55245rV L29019 L55248 L55249 L55250 L55252TtaListAbstractTree L55253 L55254 L55255 L55256 L55258rV L2222 L5525960" L55257rV L9675 L55260 L55261 L55263rV L4055 L5526485" L55262rV L9915 L55265 L55266 L55267 L55269TtaListDirectory L55270 L55271 L55272 L55273 L55275rV L34387 L5527627" L55274rV L10469 L55277 L55278 L55280rV L34475 L5528127" L55279rV L10469 L55282 L55283 L55285rV L34519 L5528628" L55284rV L10469 L55287 L55288 L55290rV L35163 L5529129" L55289rV L10469 L55292 L55293 L55295rV L34633 L5529630" L55294rV L10469 L55297 L55298 L55300rV L34679 L5530132" L55299rV L10469 L55302 L55303 L55305rV L34656 L5530632" L55304rV L10469 L55307 L55308 L55310rV L34702 L5531133" L55309rV L10469 L55312 L55313 L55315rV L34748 L5531634" L55314rV L10469 L55317 L55318 L55320rV L34725 L5532134" L55319rV L10469 L55322 L55323 L55325rV L34771 L5532635" L55324rV L10469 L55327 L55328 L55330rV L9232 L5533136" L55329rV L10469 L55332 L55333 L55334 L55336TtaListView L55337 L55338 L55339 L55340 L55342rV L25772 L55343141" L55341rV L25774 L55344 L55345 L55346 L55348TtaLoadLanguageDictionaries L55349 L55350 L55351 L55352 L55354rV L6220 L55355116" L55353rV L10127 L55356 L55357 L55358 L55360TtaLoadTypoDictionaries L55361 L55362 L55363 L55364 L55366rV L13840 L55367116" L55365rV L13902 L55368 L55369 L55370 L55372TtaMergeText L55373 L55374 L55375 L55376 L55378rV L4302 L5537988" L55377rV L9939 L55380 L55381 L55382 L55384TtaModifyPointInPolyline L55385 L55386 L55387 L55388 L55390rV L4457 L5539190" L55389rV L9955 L55392 L55393 L55394 L55396TtaNewAttribute L55397 L55398 L55399 L55400 L55402rV L4893 L5540397" L55401rV L9999 L55404 L55405 L55407rV L4907 L5540897" L55406rV L10007 L55409 L55410 L55411 L55413TtaNewDocument L55414 L55415 L55416 L55417 L55419rV L840 L5542039" L55418rV L9459 L55421 L55422 L55424rV L912 L5542540" L55423rV L9483 L55426 L55427 L55429rV L981 L5543042" L55428rV L9499 L55431 L55432 L55434rV L1103 L5543543" L55433rV L9527 L55436 L55437 L55438 L55440TtaNewElement L55441 L55442 L55443 L55444 L55446rV L2250 L5544761" L55445rV L9679 L55448 L55449 L55451rV L2284 L5545261" L55450rV L9703 L55453 L55454 L55456rV L2345 L5545762" L55455rV L9723 L55458 L55459 L55460 L55462TtaNewInclusion L55463 L55464 L55465 L55466 L55468rV L5571 L55469105" L55467rV L10071 L55470 L55471 L55472 L55474TtaNewLanguage L55475 L55476 L55477 L55478 L55480rV L6157 L55481114" L55479rV L10123 L55482 L55483 L55484 L55486TtaNewNature L55487 L55488 L55489 L55490 L55492rV L922 L5549340" L55491rV L9491 L55494 L55495 L55497rV L958 L5549841" L55496rV L10477 L55499 L55500 L55502rV L1242 L5550346" L55501rV L9559 L55504 L55505 L55506 L55508TtaNewPRule L55509 L55510 L55511 L55512 L55514rV L6534 L55515122" L55513rV L10179 L55516 L55517 L55519rV L6516 L55520122" L55518rV L10167 L55521 L55522 L55523 L55525TtaNewPRuleForNamedView L55526 L55527 L55528 L55529 L55531rV L6578 L55532123" L55530rV L10183 L56619CF L55533 L55534 L55535 L55537TtaNewSchemaExtension L55538 L55539 L55540 L55541 L55543rV L1285 L5554446" L55542rV L9563 L55545 L55546 L55547 L55549TtaNewTree L55550 L55551 L55552 L55553 L55555rV L2254 L5555661" L55554rV L9683 L55557 L55558 L55560rV L2288 L5556161" L55559rV L9707 L55562 L55563 L55565rV L2383 L5556662" L55564rV L9727 L55567 L55568 L55569 L55571TtaNextAssociatedRoot L55572 L55573 L55574 L55575 L55577rV L2839 L5557870" L55576rV L9775 L55579 L55580 L55581 L55583TtaNextAttribute L55584 L55585 L55586 L55587 L55589rV L5105 L5559099" L55588rV L10027 L55591 L55592 L55593 L55595TtaNextCopiedElement L55596 L55597 L55598 L55599 L55601rV L3793 L5560282" L55600rV L9887 L55603 L55604 L55605 L55607TtaNextLoadedReference L55608 L55609 L55610 L55611 L55613rV L5976 L55614111" L55612rV L10111 L55615 L55616 L55617 L55619TtaNextNature L55620 L55621 L55622 L55623 L55625rV L1920 L5562656" L55624rV L9635 L55627 L55628 L55629 L55631TtaNextPRule L55632 L55633 L55634 L55635 L55637rV L7035 L55638128" L55636rV L10219 L55639 L55640 L55641 L55643TtaNextSchemaExtension L55644 L55645 L55646 L55647 L55649rV L1881 L5565055" L55648rV L9631 L55651 L55652 L55653 L55655TtaNextSibling L55656 L55657 L55658 L55659 L55661rV L2977 L5566271" L55660rV L9791 L55663 L55664 L55665 L55667TtaNextUnloadedReferringDocument L55668 L55669 L55670 L55671 L55673rV L6042 L55674112" L55672rV L10115 L55675 L55676 L55677 L55679TtaOpenDocument L55680 L55681 L55682 L55683 L55685rV L870 L5568639" L55684rV L9471 L55687 L55688 L55690rV L831 L55691 L5569239! L55693rV L926 L5569440" L55689rV L9455 L55695 L55696 L55698rV L890 L5569940" L55697rV L9475 L55700 L55701 L55703rV L1024 L5570442" L55702rV L9507 L55705 L55706 L55708rV L1099 L5570943" L55707rV L9523 L55710 L55711 L55713rV L1169 L5571445" L55712rV L9547 L55715 L55716 L55718rV L2072 L5571958" L55717rV L9659 L55720 L55721 L55722 L55724TtaOpenMainView L55725 L55726 L55727 L55728 L55730rV L7287 L55731132" L55729rV L10239 L55732 L55733 L55734 L55736TtaOpenSubView L55737 L55738 L55739 L55740 L55742rV L7386 L55743133" L55741rV L10255 L55744 L55745 L55746 L55748TtaOpenView L55749 L55750 L55751 L55752 L55754rV L7334 L55755132" L55753rV L10247 L55756 L55757 L55758 L55760TtaPreviousSibling L55761 L55762 L55763 L55764 L55766rV L2943 L5576771" L55765rV L9787 L55768 L55769 L55770 L55772TtaQuit L55773 L55774 L55775 L55776 L55778rV L615 L557799" L55777rV L9423 L55780 L55781 L55783rV L32577 L5578412" L55782rV L9423 L55785 L55786 L55787 L55789TtaRaiseView L55790 L55791 L55792 L55793 L55795rV L28968 L55796136" L55794rV L28970 L55797 L55798 L55799 L55801TtaRemoveAttribute L55802 L55803 L55804 L55805 L55807rV L4976 L5580898" L55806rV L10015 L55809 L55810 L55811 L55813TtaRemoveDocument L55814 L55815 L55816 L55817 L55819rV L1107 L5582043" L55818rV L9531 L55821 L55822 L55824rV L1137 L5582544" L55823rV L9539 L55826 L55827 L55828 L55830TtaRemovePRule L55831 L55832 L55833 L55834 L55836rV L6692 L55837124" L55835rV L10195 L55838 L55839 L55840 L55842TtaRemoveSchemaExtension L55843 L55844 L55845 L55846 L55848rV L1330 L5584947" L55847rV L9567 L55850 L55851 L55852 L55854TtaRemoveTree L55855 L55856 L55857 L55858 L55860rV L2677 L5586168" L55859rV L9755 L55862 L55863 L55864 L55866TtaResetButton L55867 L55868 L55869 L55870 L55872rV L33061 L5587318" L55871rV L10403 L55874 L55875 L55877rV L8724 L5587818" L55876rV L10403 L55879 L55880 L55881 L55883TtaResetCursor L55884 L55885 L55886 L55887 L55889rV L8827 L5589022" L55888rV L10415 L55891 L55892 L55893 L55895TtaSameAttributeTypes L55896 L55897 L55898 L55899 L55901rV L5304 L55902102" L55900rV L10047 L55903 L55904 L55905 L55907TtaSamePRules L55908 L55909 L55910 L55911 L55913rV L7235 L55914131" L55912rV L10235 L55915 L55916 L55917 L55919TtaSameReferenceAttributes L55920 L55921 L55922 L55923 L55925rV L5933 L55926111" L55924rV L10107 L55927 L55928 L55929 L55931TtaSameReferences L55932 L55933 L55934 L55935 L55937rV L5815 L55938109" L55936rV L10095 L55939 L55940 L55941 L55943TtaSameSSchemas L55944 L55945 L55946 L55947 L55949rV L1793 L5595054" L55948rV L9623 L55951 L55952 L55953 L55955TtaSameTypes L55956 L55957 L55958 L55959 L55961rV L3289 L5596275" L55960rV L9827 L55963 L55964 L55965 L55967TtaSaveAppRegistry L55968 L55969 L55970 L55971 L55973rV L32629 L5597410" L55972rV L32631 L55975 L55976 L55977 L55979TtaSaveDocument L55980 L55981 L55982 L55983 L55985rV L866 L5598639" L55984rV L9467 L55987 L55988 L55990rV L13418 L5599143" L55989rV L13420 L55992 L55993 L55995rV L1066 L5599643" L55994rV L9515 L55997 L55998 L55999 L56001TtaSearchAttribute L56002 L56003 L56004 L56005 L56007rV L5460 L56008103" L56006rV L10063 L56620CF L56009 L56010 L56011 L56013TtaSearchElementByLabel L56014 L56015 L56016 L56017 L56019rV L2296 L5602061" L56018rV L9715 L56021 L56022 L56024rV L3904 L5602583" L56023rV L9899 L56026 L56027 L56028 L56030TtaSearchEmptyElement L56031 L56032 L56033 L56034 L56036rV L3942 L5603784" L56035rV L9903 L56038 L56039 L56040 L56042TtaSearchNoPageBreak L56043 L56044 L56045 L56046 L56048rV L4013 L5604985" L56047rV L9911 L56050 L56051 L56052 L56054TtaSearchOtherPairedElement L56055 L56056 L56057 L56058 L56060rV L3981 L5606184" L56059rV L9907 L56062 L56063 L56064 L56066TtaSearchReferenceElement L56067 L56068 L56069 L56070 L56072rV L6087 L56073113" L56071rV L10119 L56074 L56075 L56076 L56078TtaSearchTypedElement L56079 L56080 L56081 L56082 L56084rV L3859 L5608583" L56083rV L9895 L56086 L56087 L56088 L56090TtaSelectElement L56091 L56092 L56093 L56094 L56096rV L37101 L56097142" L56095rV L10319 L56098 L56099 L56101rV L7993 L56102142" L56100rV L10319 L56103 L56104 L56105 L56107TtaSelectInterval L56108 L56109 L56110 L56111 L56113rV L8103 L56114144" L56112rV L10331 L56115 L56116 L56117 L56119TtaSelectString L56120 L56121 L56122 L56123 L56125rV L8024 L56126143" L56124rV L10323 L56127 L56128 L56129 L56131TtaSetAccessRight L56132 L56133 L56134 L56135 L56137rV L2707 L5613868" L56136rV L9759 L56139 L56140 L56141 L56143TtaSetAttributeReference L56144 L56145 L56146 L56147 L56149rV L5645 L56150106" L56148rV L10079 L56151 L56152 L56153 L56155TtaSetAttributeText L56156 L56157 L56158 L56159 L56161rV L5059 L5616299" L56160rV L10023 L56163 L56164 L56165 L56167TtaSetAttributeValue L56168 L56169 L56170 L56171 L56173rV L5016 L5617498" L56172rV L10019 L56175 L56176 L56177 L56179TtaSetCallback L56180 L56181 L56182 L56183 L56185rV L8372 L5618614" L56184rV L10355 L56187 L56188 L56189 L56191TtaSetCheckingMode L56192 L56193 L56194 L56195 L56197rV L2213 L5619860" L56196rV L9671 L56199 L56200 L56202rV L2779 L5620369" L56201rV L9767 L56204 L56205 L56206 L56208TtaSetCursorWatch L56209 L56210 L56211 L56212 L56214rV L8797 L5621521" L56213rV L10411 L56216 L56217 L56218 L56220TtaSetDisplayMode L56221 L56222 L56223 L56224 L56226rV L7634 L56227136" L56225rV L10283 L56228 L56229 L56230 L56232TtaSetDocumentAccessMode L56233 L56234 L56235 L56236 L56238rV L935 L5623940" L56237rV L9495 L56240 L56241 L56243rV L1438 L5624449" L56242rV L9579 L56245 L56246 L56247 L56249TtaSetDocumentBackUpInterval L56250 L56251 L56252 L56253 L56255rV L13494 L5625649" L56254rV L13496 L56257 L56258 L56259 L56261TtaSetDocumentDirectory L56262 L56263 L56264 L56265 L56267rV L1408 L5626848" L56266rV L9575 L56269 L56270 L56271 L56273TtaSetDocumentModified L56274 L56275 L56276 L56277 L56279rV L1498 L5628050" L56278rV L9587 L56281 L56282 L56284rV L1968 L5628556" L56283rV L9643 L56286 L56287 L56288 L56290TtaSetDocumentName L56291 L56292 L56293 L56294 L56296rV L13459 L5629748" L56295rV L13461 L56298 L56299 L56300 L56302TtaSetDocumentPath L56303 L56304 L56305 L56306 L56308rV L904 L5630940" L56307rV L9479 L56310 L56311 L56313rV L1010 L5631442" L56312rV L9503 L56315 L56316 L56318rV L1049 L5631943" L56317rV L9511 L56320 L56321 L56323rV L1095 L5632443" L56322rV L9519 L56325 L56326 L56328rV L1161 L5632945" L56327rV L9543 L56330 L56331 L56332 L56334TtaSetDocumentUnmodified L56335 L56336 L56337 L56338 L56340rV L1523 L5634150" L56339rV L9591 L56342 L56343 L56344 L56346TtaSetErrorMessages L56347 L56348 L56349 L56350 L56352rV L364 L563535" L56351rV L9359 L56354 L56355 L56357rV L709 L5635812" L56356rV L9439 L56359 L56360 L56361 L56363TtaSetGraphicsShape L56364 L56365 L56366 L56367 L56369rV L4343 L5637089" L56368rV L9943 L56371 L56372 L56373 L56375TtaSetNotificationMode L56376 L56377 L56378 L56379 L56381rV L1468 L5638249" L56380rV L9583 L56383 L56384 L56385 L56387TtaSetPRuleValue L56388 L56389 L56390 L56391 L56393rV L6732 L56394125" L56392rV L10199 L56395 L56396 L56398rV L36750 L56399126" L56397rV L10199 L56400 L56401 L56402 L56404TtaSetPSchema L56405 L56406 L56407 L56408 L56410rV L1377 L5641147" L56409rV L9571 L56412 L56413 L56415rV L7342 L56416132" L56414rV L10251 L56417 L56418 L56420rV L7295 L56421132" L56419rV L10243 L56422 L56423 L56425rV L7394 L56426133" L56424rV L10259 L56427 L56428 L56429 L56431TtaSetReference L56432 L56433 L56434 L56435 L56437rV L5528 L56438105" L56436rV L10067 L56439 L56440 L56441 L56443TtaSetSchemaPath L56444 L56445 L56446 L56447 L56449rV L918 L5645040" L56448rV L9487 L56451 L56452 L56454rV L1213 L5645545" L56453rV L9555 L56456 L56457 L56458 L56460TtaSetSelectionMode L56461 L56462 L56463 L56464 L56466rV L8165 L56467144" L56465rV L10339 L56468 L56469 L56470 L56472TtaSetSensibility L56473 L56474 L56475 L56476 L56478rV L7519 L56479134" L56477rV L10271 L56480 L56481 L56482 L56484TtaSetTextContent L56485 L56486 L56487 L56488 L56490rV L4100 L5649186" L56489rV L9919 L56621 CF L56492 L56493 L56494 L56496TtaSetZoom L56497 L56498 L56499 L56500 L56502rV L7555 L56503135" L56501rV L10275 L56504 L56505 L56506 L56508TtaShowElement L56509 L56510 L56511 L56512 L56514rV L7591 L56515135" L56513rV L10279 L56516 L56517 L56518 L56520TtaSplitText L56521 L56522 L56523 L56524 L56526rV L4266 L5652788" L56525rV L9935 L56528 L56529 L56530 L56532TtaSuspendButton L56533 L56534 L56535 L56536 L56538rV L8761 L5653919" L56537rV L10407 L56540 L56541 L56543rV L33126 L5654419" L56542rV L10407 L56545 L56546 L56548rV L33157 L5654920" L56547rV L10407 L56550 L56551 L56553rV L33188 L5655420" L56552rV L10407 L56555 L56556 L56558rV L33225 L5655921" L56557rV L10407 L56560 L56561 L56562 L56564TtaUnLoadLanguageDictionaries L56565 L56566 L56567 L56568 L56570rV L6258 L56571116" L56569rV L10131 L56572 L56573 L56574 L56576TtaUnLoadTypoDictionaries L56577 L56578 L56579 L56580 L56582rV L36560 L56583115" L56581rV L13906 L56584 L56585 L56587rV L13878 L56588117" L56586rV L13906 L56589 L56590 L56591 L56593TtaUnselect L56594 L56595 L56596 L56597 L56599rV L8132 L56600144" L56598rV L10335 L56601 L56602 L56603 L56605TtaUpdateInclusionElements L56606 L56607 L56608 L56609 L56611rV L43583 L56612107" L56610rV L43585 L56622CFA L32937EN. L32938/ L32939 0 L32940 L329411 L32942rV  L32943CF L2EN L13381DF L13380DF L41 L36381 L36382The Thot Tool Kit API L42 L43ThotLib V2.1a L44 L45Draft, October 6, 1997 L46 L47The Thot Tool Kit API L48 L49 L50 L51Vincent Q L52T PUINT L53, Irne V L54T PATTON L55 L56 L57 L58 L59The Thot tool kit is a comprehensive set of editing functions that can be used for building applications that handle structured documents in the Unix / X Window environment. It is constituted by a set of C libraries that can be linked to any program. It allows application programs to perform the same kind of operations as a user working with a structured document editor. Typically, an application can use the tool kit for creating new documents, for modifying existing documents, for extracting information from documents, for displaying (parts of) documents, etc. The tool kit can be used either for automatic manipulations performed solely by a program or for allowing a human user to cooperate with a program that processes documents. In this latter case, it uses OSF/Motif for implementing the user interface. L34065 L34066 L34067The functions provided by the tool are based on the Thot document model. Documents produced with the tool kit can be stored as Unix files in the same standard format as documents produced by the Thot editor (pivot format indicated by the .PIV suffix). Thot editor is also able to save documents in other formats and obviously this capability is provided by the tool kit. Thot documents can be processed by all tools available in the Thot environment and by all applications developed with the tool kit. The Thot environment includes in particular flexible tools for editing, printing and translating documents.' L63( L64) L65 L66Introduction to the document model' L67( L68) L69 L70Logical structure* L71 L72 L73 L74In the editing tool kit, a  L75document L76 is primarily considered as an abstract structure that assembles typed  L77elements L78. Examples of elements types are titles, chapters, sections, paragraphs, lists, notes, etc. The structure itself is basically a hierarchy of such elements; it is called an  L79abstract tree L80. The lowest level elements (also called  L81basic elements L82) represent the actual  L83contents L84 of the document: character stings, mathematical symbols, pictures, and graphical elements. In addition to this tree structure, non-hierarchical links (also called  L85references L86) relate elements independently of the  L56673CF L56672tree structure, thus representing cross- references and other types of hypertext links. L88 L89 L90As the type of an element is not always sufficient for completely representing the role of that element in the document logical structure, the notion of  L91logical attribute L92 has been introduced. A logical attribute is an information associated with an element that adds semantics to that element. L93 L94 L95The logical structure of a document is constrained by a model, called a  L96structure schema L97. Several structure schemas can be used, one for each type of document. A structure schema defines a document type, by specifying all types of elements that can be used in the logical structure of a document of that type. It also specifies the attributes that can be associated with each type of element and all structural relationships that can be set between elements. Structure schemas are written in a specific declarative language, called S. A compiler for the S language is available, so that new document types can be defined, according to the requirements of applications.( L98) L99 L100Presentation* L101 L102 L103 L104The graphical appearance of a document (also called  L105presentation L106) is derived from its logical structure and is generically specified by a  L107presentation schema L108. A presentation schema is associated with a structure schema and specifies the appearance of documents of the type defined by the structure schema. For each type of element defined in the structure schema, the presentation schema contains a set of presentation rules that define the style and the format of the logical elements. Using these rules, the system can then produce the graphical representation of a document, on the basis of its logical structure. L109 L110 L111Presentation schemas are written in the language P and a compiler for that language is available. New presentation schemas can then be developed. Notice that several presentation schemas can be associated with the same structure schema, thus defining alternative presentations for the same type of document. L112 L113 L114In addition, each presentation schema may define different  L115views L116. A view is a subset of the document that can be formatted in a different way and displayed separately: each view is presented in a different window on the screen. L117 L118 L119For balancing this rigid principle of presentation with a certain degree of flexibility, it is possible to associate with some element instances a special type of attribute, called  L120specific presentation rule L121. A specific presentation rule is a presentation rule of the  L56675CF L56674same kind as those of the presentation schema, but it applies only to the element instance with which it is associated, not to all elements of that type. L123 L124 L125With that approach to document representation, documents are first specified generically, by writing structure schemas and presentation schemas. Then end-users and application programs can manipulate document instances very simply, by referring to the schemas. Most of the work consists in handling a logical structure consistent with the chosen structure schema and in handling the contents (the basic elements) of that structure. All the rest, especially formatting and displaying, is done by the tool kit. In addition, the logical structure is a very efficient help for moving across the document and for locating the parts to be modified.( L126) L127 L128Tool kit structure' L129( L130) L131 L132Structure of this manual* L133 L134 L135 L136The tool kit contains about 200 functions. For the sake of clarity, they are presented by groups, each group focusing on a different aspect of documents. L137 L138 L139 L140 L141 L142Group  L143application L144 (section > L145rV L576 L146) concerns the administration of the tool kit by the application. L219 L220 L221 L222Group  L223interface L224 (section > L225rV L8356 L226) allows the application program to modify and extend the Thot editor. L147 L148 L149 L150Group  L151document L152 (section > L153rV L822 L154) allows the application to manage schemas and whole documents. L155 L156 L157 L158Group  L159tree L160 (section > L161rV L2176 L162) handles the hierarchical logical structure of documents. L163 L164 L165 L166Group  L167contents L168 (section > L169rV L4085 L170) allows the application to manipulate the contents of the leaves of the structure. L171 L172 L173 L174Group  L175attribute L176 (section > L177rV L4874 L178) concerns logical attributes. L179 L180 L181 L182Group  L183reference L184 (section > L185rV L5513 L186) contains functions for manipulating non hierarchical relationships (hypertext links). L187 L188 L189 L190Group  L191language L192 (section > L193rV L6125 L194) concerns natural languages used in text contents. L195 L196 L197 L198Group  L199presentation L200 (section > L201rV L6504 L202) handles specific presentation. L203 L204 L205 L206Group  L207view L208 (section > L209rV L7272 L210) handles views. L56676CF L211 L212 L213 L214Group  L215selection L216 (section > L217rV L7975 L218) contains the functions that handle the selection. L228 L229 L230 L231Group  L232message L233 (section > L234rV L8857 L235) allows the application program to display messages intended to the user. L22145 L22146 L22147 L22148Group  L22149dialogue L22150 (section > L22151rV L9217 L22152) allows the application program to manage menus and forms intended to the user. L236 L237 L238Each section presenting a group of functions is divided into subsections which correspond to the following four broad categories: L239 L240 L241 L242 L243 L244constructors L245 are functions that create or generate new things. By extension, they also include reverse functions, which delete or destroy the same things. L246 L247 L248 L249modificators L250 are functions that modify existing things in different ways. L251 L252 L253 L254accessors L255 are the functions that allow the application program to access things. L256 L257 L258 L259locators L260 are the functions that search various kind of things in document, according to different criteria.( L261) L262 L263Libraries* L264 L265 L266 L267The Thot editing tool kit is accessed through an API that is defined in sections > L268rV L576 L269 to > L22153rV L9217 L271. The tool kit takes the form of two libraries for editing documents. Each library is suited to a different type of application and an application uses only one of the two editing libraries: the second library includes the first one.' L272 L273rV L9338+( L274) L275 L276Thot Kernel library* L277 L278 L279 L280The first library allows an application to handle the logical structure and the contents of Thot documents in automatic mode. This subset of the tool kit, called Thot Kernel, does not produce the graphical aspect of documents. It does not provide either any service for the user interface. It is typically designed for applications performing automatic operations on the logical structure and contents of documents without direct manipulation by a user. L281 L282 L283The last five groups of functions (those handling views, selections, and user interface to the editor) are not part of that library. Sections > L284rV L7272 L285 to > L22154rV L9217 L287 of that document do not concern that library. L288 L56677CF( L291) L292 L293Thot Editor library* L294 L295 L296 L297The second library, called Thot Editor, includes all facilities provided by the Kernel, with the same interface, and provides additional services for displaying the graphical aspect of documents. It also contains the whole Thot editor with its user interface. All editing functions of Thot can be accessed by the user and by application programs. The Thot Editor tool kit is typically intended to interactive applications that handle documents under the control of a user and that add new functions to the editor. L298 L299 L300All groups of functions presented in this document are part of that library. Functions that are also part of the Thot Kernel have exactly the same interface when used in the context of Thot Editor. The only difference is that, in the case of Thot Kernel, they do not display anything, and that, in the case of Thot Editor, some of them (namely constructors and modificators) modify the picture displayed on the screen. As a consequence, application programs that have been developed for automatic processing can be reused in the context of an interactive application without any change: the Thot Editor automatically takes in charge all displaying problems that are not handled by the Thot Kernel.( L339) L340 L341Using the Thot tool kit' L342 L343rV L9344+( L344) L345 L346Errors* L347 L348 L349 L350Almost all functions of the tool kit can detect errors. In that case the function is not performed and an error code is set. The tool kit provides the application program with the function  L351rV L9350f+ L352TtaGetErrorCode L353 L354 for accessing the error code. That function returns the completion code of the last tool kit function called by the application. Only the completion code of the most recently called function is available. A 0 completion code means a successful operation; other values are defined in files  L355application.h L356. L357 L358 L359In addition to the error code returned to the application program by the function  L360rV L9354h+ L361TtaGetErrorCode L362 L363, the tool kit prints an error message on the standard error file stderr whenever an error is raised. Error messages are printed by default, but the application program can ask the tool kit to stop printing these messages, by calling the function  L364rV L9358j+ L365TtaSetErrorMessages L366 L367. L368 L56678CF( L369) L370 L371Include files* L372 L373 L374 L375Each group of functions has an associated include file. Available include files are: application.h, document.h, tree.h, content.h, attribute.h, reference.h, language.h, presentation.h, view.h, selection.h, interface.h. These files must be included in each module of the application program that calls at least one function of the corresponding group. They contain the interface definition of the functions and the types and constants (#define) used by these functions.( L380) L381 L382Buffers* L383 L384 L385 L386Whenever a function may return a long character string (20 characters or more), the buffer must be provided by the application when calling the function. If the buffer is too small, the tool kit raises an error. But the size of the character string can generally be asked before calling such functions, by using another function.( L398) L399 L400Types used by the Thot editing tool kit* L401 L402 L403 L404The tool kit performs operations on various entities, such as schemas, documents, elements, attributes, views, etc. Each entity is identified by a unique identifier which is assigned by Thot. Therefore, an application program must get that identifier before manipulating any entity. An identifier can be obtained by constructors, accessors and locators. L405 L406 L407The following types are used by the editing tool kit: L408 L409 L410 L411 L413SSchema L414 L415 L416 L417 L418a structure schema loaded by the tool kit. L419 L420 L422Document L423 L424 L425 L426 L427a document loaded or created by the tool kit. L428 L429 L431Element L432 L433 L434 L435 L436an element in the logical structure of a document. L437 L438 L440Attribute L441 L442 L443 L444 L445a logical attribute. L446 L447 L449PRule L450 L451 L452 L453 L454a specific presentation rule. L33581 L33582 L33583TypeUnit L33584 L33585 L33588 L33587UnRelative, UnXHeight, UnPoint, UnPixel, UnPercent L455 L456 L458View L459 L460 L461 L462 L463a view created by the editor (Thot Editor only). L464 L465 L467ElementType L468 L469 L470 L471 L472the type of an element. L473 L474 L476AttributeType L477 L478 L479 L480 L481the type of an attribute. L482 L483 L485Language L486 L487 L488 L489 L490the identifier of a natural language. L56679CF L491 L492 L493SSchemas, Elements, Attributes, and PRules are pointers (addresses), whereas Documents and Views are integers. Language is an unsigned character. Both ElementType and AttributeType are structures containing a SSchema (the schema that defines the corresponding element type or attribute type) and an integer which is the number of the element type or attribute type in that structure schema. Structure ElementType is defined in file  L494tree.h L495: L496 L497 L498 L499typedef struct _ElementType L500 L501{ L502 L503SSchema ElSSchema; L504 L505 int ElTypeNum; L506 L507} ElementType; L508 L509RP+ L510Structure AttributeType is defined in file  L511attribute.h L512: L513 L514 L515 L516typedef struct _AttributeType L517 L518{ L519 L520SSchema AttrSSchema; L521 L522int AttrTypeNum; L523 L524} AttributeType; L525 L526 L527In addition some integers are used for exchanging parameters between the application program and the tool kit. Available parameters with their possible values are: L529 L530JF L531CF L532 L534Search domain L535 L536 L537 L538 L539SearchForward, SearchBackward, SearchInTree. L540CF L541 L543Access rights L544 L545 L546 L547 L548ReadWrite, ReadOnly, Hidden, Inherited. L549CF L550 L552Construct L553 L554 L555 L556 L557ConstructIdentity, ConstructList, ConstructChoice, ConstructOrderedAggregate, ConstructUnorderedAggregate, ConstructConstant, ConstructReference, ConstructBasicType, ConstructNature, ConstructPair. L558CF L559 L561Presentation rules L562 L563 L564 L565 L566PRSize, PRStyle, PRFont, PRUnderline, PRThickness, PRIndent, PRLineSpacing, PRDepth, PRAdjust, PRJustify, PRLineStyle, PRLineWeight, PRFillPattern, PRBackground, PRForeground, PRHyphenate. L567CF L568 L570Display modes L571 L572 L573 L574 L575DisplayImmediately, DeferredDisplay, NoComputedDisplay. L22180 UF( L32865) L32866 L32867Initialization* L32868 L32871 L32872 L32873Group application contains the functions for managing the tool kit API. These functions require that file  L32874application.h L32875 be included in the module that calls them. L32876 L32877 L32878Applications generated by an interface schema EDITOR.A don't have to call these functions.' L32879( L32880) L32881 L32882Constructors' L32897( L590 L591rV L9418~+) L592 L593TtaInitialize L594* L595 L596 L597RP+ L598Initializes the Thot editing tool kit for an application. This function must be called before any other function of the tool kit. L20320 L20321CF L20322 L20323TPFHRP+ L20324FRvoid TtaInitialize(char *applicationName) L605 L606 L607 L608Parameter: L609 L610 L611RP- L612applicationName L613: name of the application that requires services from the tool kit. This name is used for accessing the ressources defined in the Registry.( L614 L615rV L9422+) L616 L617TtaQuit L618* L619 L620 L621RP+ L622Quits the Thot tool kit. No other function of the tool kit can then be called by the application. L20328 L20329CF L20330 L20331TPFHRP+ L20332void TtaQuit()( L32469 L32621rV L32622+) L32471 L32472TtaInitializeAppRegistry L32628* L32474 L32475 L32476RP+ L32477Initialize the Thot Registry. This is done by default by TtaInitialize. On Unix platforms the Registry is physically stored in the  L32645FCT PThot.ini L32646 file, on Windows platforms the native Registry is used. L56680 CF L32478 L32479CF L32480 L32481TPFHRP+ L32482void TtaInitializeAppRegistry(char *applicationName) L32519 L32520 L32521 L32522Parameter: L32523 L32524 L32525RP- L32526applicationName L32527: name of the application.( L32528 L32629rV L32630+) L32530 L32531TtaSaveAppRegistry L32636* L32533 L32534 L32535RP+ L32536Commit the changes made to the Thot Registry. This is done by default by TtaQuit. L32537 L32538CF L32539 L32540TPFHRP+ L32541void TtaSaveAppRegistry()( L32551 L32637rV L32638+) L32553 L32554TtaGetEnvString L32644* L32556 L32557 L32558RP+ L32559Reads an entry from the Thot Registry. It returns a  L32574SBT Pnon-modifiable L32575 string associated to the name given as parameter. Thot first looks for a specific value associated to the current application, and if not found try to find one in the "thot" section. Hence settings saved in the "thot" section are shared by all applications based on the Thot library, but can be refined to fit each application specific needs. If no value is found for the requested entry, the function returns NULL. L32560 L32561CF L32562 L32563TPFHRP+ L32564char *TtaGetEnvString(const char *name) L32565 L32566 L32567 L32568Parameters: L32569 L32570 L32571RP- L32572name L32573: name of the entry.( L576) L577 L578Application* L579 L580 L581 L582Group application contains the functions for managing the tool kit API. These functions require that file  L583application.h L584 be included in the module that calls them. L56681 CF' L585( L586) L587 L588Constructors' L589( L628 L629rV L9426+) L630 L631TtaGetMemory L632* L633 L634 L635RP+ L636Allocates dynamically a buffer of a specific size. L20336 L20337CF L20338 L20339TPFHRP+ L20340 char *TtaGetMemory(int size) L643 L644 L645 L646Parameter: L647 L648 L649RP- L650size L651: size in bytes (like using malloc) of the desired allocated buffer. L652 L653 L654 L655Return value: L656 L657 L658 L659the address of the allocated buffer. L660 L661 L662 L663See also: L664 L665 L666 L667TtaFreeMemory.( L668 L669rV L9430 +) L670 L671TtaFreeMemory L672* L673 L674 L675RP+ L676Frees the memory allocated to a buffer by  L677rV L9434l+ L678TtaGetMemory L679 L680. L20344 L20345CF L20346 L20347TPFHRP+ L20348FRvoid TtaFreeMemory(char *buffer) L687 L688 L689 L690Parameter: L691 L692 L693RP- L694buffer L695: the address of the buffer. L696 L697 L698 L699See also: L700 L701 L702 L703TtaGetMemory. L56682 CF( L704) L705 L706Modificators' L707( L708 L709rV L9438 +) L710 L711TtaSetErrorMessages L712* L713 L714 L715RP+ L716Indicates to the tool kit whether error messages must be printed or not. L20352 L20353CF L20354 L20355TPFHRP+ L20356void TtaSetErrorMessages(int on) L723 L724 L725 L726Parameters: L727 L728 L729RP- L730on L731: 1 if error messages must be printed, 0 if not.( L32576 L32577rV L9422O+P) L32578 L32579TtaSetEnvString L32580P* L32581 L32582 L32583RP+ L32584Set an entry in the Thot Registry for the current application.  L32587 L32588CF L32589 L32590TPFHRP+ L32591int TtaSetEnvString(const char *name, const char *value, int overwrite) L32592 L32593 L32594 L32595Parameters: L32596 L32597 L32598RP- L32599name L32600: name of the entry. L32606RP- L32607value L32608: value associated to the entry. L32609RP- L32610overwrite L32611: should we overwrite an existing entry?( L732) L733 L734Accessors' L735( L736 L737rV L9442+) L738 L739TtaGetVersion L740* L741 L742 L743RP+ L744Returns the identifier of the current version of the Thot editing tool kit. L20360 L20361CF L20362 L20363TPFHRP+ L20364FRchar *TtaGetVersion() L750 L751 L752 L753Return value: L754 L755 L756 L757identifier of the current version. L56683 CF( L758 L759rV L9446+) L760 L761TtaGetErrorCode L762* L763 L764 L765RP+ L766Returns the error code set by the last call to the Thot editing tool kit. See file  L767application.h L768 for the possible values. L20368 L20369CF L20370 L20371TPFHRP+ L20372 int TtaGetErrorCode() L773 L774 L775 L776Return value: L777 L778 L779 L780last error code, 0 if the last call was successful.( L781 L782rV L9450+) L783 L784TtaGetStrError L785* L786 L787 L788RP+ L789Returns a pointer to the message text for a given error code. L20376 L20377CF L20378 L20379TPFHRP+ L20380 char *TtaGetStrError(int errorCode) L796 L797 L798 L799Parameter: L800 L801 L802RP- L803errorCode L804: an error code. L805 L806 L807 L808Return value: L809 L810 L811 L812pointer to the message text of the error. L813 L814 L815 L816See also: L817 L818 L819 L820TtaGetErrorCode L53420CF( L8356) L8357 L8358Interface* L8359 L8360 L8361 L8362The functions described in this section require that file  L8363interface.h L8364 be included in the module that calls them. They are available only in the Thot Editor library. L56684CF' L8366( L8367) L8368 L8369Constructors' L8370( L8371 L8372rV L10354+) L8373 L8374TtaSetCallback L8375* L8376 L8377 L8378RP+ L8379This function reserves a set of reference for creating dialogue elements (forms, menus, submenus, labels, etc.) and specifies the procedure that is called back when the user activates these dialogue elements. L32929 L32928RP+ L32927Dialogue elements have to be created by the application using references between the "base" value returned by this function and the value "base+numberOfRef-1". So, this function must be called first. L32905 L32904RP+ L32903 It is possible to define different sets of dialogue elements by calling this function more than one time with different  L32933FCT PcallbackProcedure L32932 procedure in the same application. L32908 L32907RP+ L32906The  L32898FCT PcallbackProcedure L32899 procedure declared is called for each event concerning these specific dialogue items. It receives three parameters: the dialogue item reference, the data type, and the data value: L32902FCT P L32901RP+ L32900void callbakProcedure(reference, datatype, data)int reference;int datatype; L8380FCT P L8381RP+ L8382char *data;  L22321 L22322 L22323 L22324TPFHRP+JFCF L22325FRint TtaSetCallback(void (*callbackProcedure) (), int numberOfRef) L8389 L8390 L8391 L8392Parameter: L8393 L8394 L8395RP- L8396callbakProcedure L8397: the application callback procedure. L32913 L32911 L32914numberOfRef L32915: the nmber of reference reserved. L32919 L32920 L32921 L32922Return value: L32923 L32924 L32925 L32926the "base" value for the  L32934FCT PnumberOfRef L32935 specific dialogue elements to be created. L56685CF( L8411 L8412rV L10362+) L8413 L8414TtaHandlePendingEvents L8415* L8416 L8417 L8418 L8419This function manages all Thot and Motif pending events. The application have to call this function to allow user's interactions and display updatesto be managed during long treatments. L21952 L21953 L21954 L21955TPFHRP+ L21956FRvoid TtaHandlePendingEvents()( L25484 L25485rV L10362+) L25486 L25487TtaHandleOneEvent L25488* L25489 L25490 L25491 L25492This function processes one event within Thot and Motif. The application which controls a local loop of events have to call this function to allow managment of specific Thot and Motif events. L25493 L25494 L25495 L25496TPFHRP+ L25497FRvoid TtaHandlePendingEvents(XEvent *event) L25501 L25502 L25503 L25504Parameter: L25505 L25506 L25507RP- L25508event L25509: the X event to be managed.( L8490 L8491rV L10370+) L8492 L8493TtaAddButton L8494* L8495 L8496 L8497RP+ L8498Adds a new button into the document view button bar. This function must specify a valid view of a valid document. The procedure parameter gives the call back procedure that will be run when user select the button. This procedure will receive two parametrers: the document and the view concerned. L8532 L8533RP- L8534An example of callback procedure is. L8535 L8536 L8537 L8538void callback_procedure (document, view) L8539 L8540Document document; L8541 L8542View view; L8544 L8545{ L8546 L8547.... L8548 L8549} L33026 L33027RP+ L33028If the icon parameter in NULL, a space button is generated and the callback procedure is ignored. L56686CF L21984 L21985CF L21986 L21987TPFHRP+ L21988int TtaAddButton(Document document, View view, Pixmap icon, void (*procedure) ()) L8511 L8512 L8513 L8514Parameters: L8515 L8516 L8517RP- L8518document L8519: the concerned document. L8520 L8521RP- L8522view L8523: the concerned view. L8524 L8525RP- L8526icon L8527: the pixmap of the new button or NULL. L8528 L8529RP- L8530procedure L8531: procedure to be executed when the button is selected by the user or NULL. L32947 L32948 L32949 L32950Return value: L32951 L32952 L32953 L32954The button index.( L32956 L32957rV L10370+) L32958 L32959TtaAddTextZone L32960* L32961 L33046 L33047RP+ L33048Adds a new text-zone into the document view commands. This function must specify a valid view of a valid document. The editable parameter indicates that user can edit this text-zone. The procedure parameter gives the call back procedure that will be run when user changes the text-zone: the user press the  L33054FCT PReturn L33055 key. This procedure will receive two parametrers: the document and the view concerned. L33043 L33044RP- L33045An example of callback procedure is. L33029 L33030 L33031 L33032void callback_procedure (document, view) L33033 L33034Document document; L33035 L33036View view; L33037 L33038{ L33039 L33040.... L33041 L33042} L33049 L33053 L33052If the text-zone is not editable the procedure have to be NULL. L32965 L32966CF L32967 L32968TPFHRP+ L32969int TtaAddTextZone(Document document, View view, char *label, boolean editable, void (*procedure) ()) L56687CF L32970 L32971 L32972 L32973Parameters: L32974 L32975 L32976RP- L32977document L32978: the concerned document. L32979 L32980RP- L32981view L32982: the concerned view. L32983 L32984RP- L32985label L32986: the label of the text-zone. L33056RP- L33057editable L33058: True is user can edit the text-zone. L32987 L32988RP- L32989procedure L32990: procedure to be executed when the text is modified by the user. L33008 L33009 L33010 L33011Return value: L33012 L33013 L33014 L33015The text-zone index.( L8610) L8611 L8612Accessors' L8613( L8677) L8679 L8680TtaGetCurrentDisplay* L8682 L8683 L8684RP+ L8685Returns the current display descriptor. L22040 L22041 L22042 L22043TPFHRP+ L22044FRDisplay *TtaGetCurrentDisplay()( L13701) L13702 L13703TtaGetScreenDepth* L13704 L13705 L13706RP+ L13707Returns the screen depth of the display. L22048 L22049 L22050 L22051TPFHRP+ L22052int TtaGetScreenDepth()( L8690 L8691rV L10398+) L8692 L8693TtaClickAnElement L8694* L8695 L8696 L8697RP+ L8698Waits for a click from end-user and returns the element and document selected. If the user clicks out of any document view, the returned values are null. L22056 L22057CF L22058 L22059TPFHRP+ L22060FRvoid TtaClickAnElement(Document document, Element element) L56688CF L8707 L8708 L8709 L8710Parameters L8711 L8712 L8713RP- L8714document L8715: the document selected by the user or 0. L8716RP- L8717element L8718: the element selected by the user or 0.( L8719) L8720 L8721Modificators' L8722( L8723 L8724rV L10402+) L8725 L8726TtaChangeButton L8727* L8728 L8729 L8730RP+ L8731This function changes the button icon. This function must specify a valid view of a valid document and a valid button index. L22064 L22065CF L22066 L22067TPFHRP+ L22068FRvoid TtaChangeButton(Document document, View view, int buttonIndex, Pixmap icon) L8743 L8744 L8745 L8746Parameters: L8747 L33111 L33112RP- L33113document L33114: the concerned document. L33107 L33108RP- L33109view L33110: the concerned view. L8756 L8757RP- L8758buttonIndex L8759: the button index, numbered from 1 to n. L33103 L33104RP- L33105icon L33106: the pixmap of the new button or NULL.( L33060 L33061rV L10402+) L33062 L33063TtaSetTextZone L33064* L33065 L33118 L33119RP+ L33120This function gets the text to be displayed in the text-zone. This function must specify a valid view of a valid document and a valid text-zone index. L33069 L33070CF L33071 L33072TPFHRP+ L33073FRvoid TtaSetTextZone(Document document, View view, int textIndex, char *text) L33074 L33075 L33076 L33077Parameters: L33078 L33099 L33100RP- L33101document L33102: the concerned document. L33095 L33096RP- L33097view L33098: the concerned view. L56689CF L33087 L33088RP- L33089textIndex L33090: the button index, numbered from 1 to n. L33121 L33122RP- L33123text L33124: the text to be displayed into the text-zone.( L8760 L8761rV L10406+) L8762 L8763TtaSetMenuOff L8764* L8765 L8766 L8767RP+ L8768Sets inactive a menu in the menu bar of the view of the document. If the document and view parameters are null, the menu is a application window menu. L22072 L22073CF L22074 L22075TPFHRP+ L22076void TtaSetMenuOff(Document document, View view, int menuID) L8779 L8780 L8781 L8782Parameters: L8783 L8784 L8785RP- L8786document L8787: the document concerned or 0. L8788 L8789RP- L8790view L8791: the view concerned or 0. L8792 L8793RP- L8794menuID L8795: the menu identification in the EDITOR.h file.( L33125 L33126rV L10406+) L33127 L33128TtaSetMenuOn L33129* L33130 L33131 L33132RP+ L33133Sets active a menu in the menu bar of the view of the document. If the document and view parameters are null, the menu is a application window menu. L33134 L33135CF L33136 L33137TPFHRP+ L33138void TtaSetMenuOn(Document document, View view, int menuID) L33139 L33140 L33141 L33142Parameters: L33143 L33144 L33145RP- L33146document L33147: the document concerned or 0. L33148 L33149RP- L33150view L33151: the view concerned or 0. L33152 L33153RP- L33154menuID L33155: the menu identification in the EDITOR.h file. L56690CF( L33156 L33157rV L10406+) L33158 L33159TtaSetActionOff L33160* L33161 L33162 L33163RP+ L33164Sets inactive a menu action in the menu bar of the view of the document. If the document and view parameters are null, the menu is a application window menu. L33165 L33166CF L33167 L33168TPFHRP+ L33169void TtaSetActionOff(Document document, View view, int menuID, int itemID) L33170 L33171 L33172 L33173Parameters: L33174 L33175 L33176RP- L33177document L33178: the document concerned or 0. L33179 L33180RP- L33181view L33182: the view concerned or 0. L33183 L33184RP- L33185menuID L33186: the main menu (even if the item is located into a submenu) identification in the EDITOR.h file. L33218RP- L33219itemID L33220: the item identification in the EDITOR.h file.( L33187 L33188rV L10406+) L33189 L33190TtaSetActionOn L33191* L33192 L33193 L33194RP+ L33195Sets active a menu action in the menu bar of the view of the document. If the document and view parameters are null, the menu is a application window menu. L33196 L33197CF L33198 L33199TPFHRP+ L33200void TtaSetActionOn(Document document, View view, int menuID, int itemID) L33201 L33202 L33203 L33204Parameters: L33205 L33206 L33207RP- L33208document L33209: the document concerned or 0. L33210 L33211RP- L33212view L33213: the view concerned or 0. L33214 L33215RP- L33216menuID L33217: the main menu (even if the item is located into a submenu) identification in the EDITOR.h file. L33221RP- L33222itemID L33223: the item identification in the EDITOR.h file. L56691CF( L33224 L33225rV L10406+) L33226 L33227TtaSetToggleItem L33228* L33229 L33230 L33231RP+ L33232Sets on/off the toggle of an item in the menu bar of the view of the document. If the document and view parameters are null, the menu is a application window menu. L33233 L33234CF L33235 L33236TPFHRP+ L33237void TtaSetActionOn(Document document, View view, int menuID, int itemID, boolean on) L33238 L33239 L33240 L33241Parameters: L33242 L33243 L33244RP- L33245document L33246: the document concerned or 0. L33247 L33248RP- L33249view L33250: the view concerned or 0. L33251 L33252RP- L33253menuID L33254: the main menu (even if the item is located into a submenu) identification in the EDITOR.h file. L33255RP- L33256itemID L33257: the item identification in the EDITOR.h file. L33258RP- L33259on L33260: the value True or False to be set.( L8796 L8797rV L10410+) L8798 L8799TtaSetCursorWatch L8800* L8801 L8802 L8803RP+ L8804Displays the cursor watch within the view of the document. If the document and view parameters are NULL, displays the cursor watch within all views of documents. L22080 L22081 L22082 L22083TPFHRP+ L22084void TtaSetCursorWatch (Document document, View view) L8813 L8814 L8815 L8816Parameters: L8817 L8818 L8819RP- L8820document L8821: the document concerned or 0. L8822 L8823RP- L8824view L8825: the view concerned or 0. L56692CF( L8826 L8827rV L10414+) L8828 L8829TtaResetCursor L8830* L8831 L8832 L8833RP+ L8834Resets the standard cursor within the view of the document. If the document and view parameters are NULL, resets the standard cursor within all views of documents. L22088 L22089 L22090 L22091TPFHRP+ L22092FRvoid TtaResetCursor(Document document, View view) L8844 L8845 L8846 L8847Parameters: L8848 L8849 L8850RP- L8851dument L8852: the documen or 0. L8853 L8854RP- L8855view L8856: the view or 0. L22158UF( L8857) L8858 L8859Messages* L8860 L8861 L8862 L8863The functions described in this section require that file  L8864message.h L8865 be included in the modules that call them. L8866 L8867 L8868The following functions are available in both the Thot Editor library and the ThotKernel library. They allow an application program to manage messages and dialogue text, as Thot tool kits do. Text of dialogue boxes and error messages is defined out of the application code and is dynamically loaded when the application is executed. This method allows application to adapt its interface to the current user (English text for English user, French text for French user, etc.). Each message is numbered, code referencing the message by its number and an external file associating this number with its corresponding text. An  L8869rV L10418 +  L8870environment variable L8871  L8872 is used to reach the correct file that contains text of messages at the execution time. If this file is not reachable, a warning message is sent to the standard output, but the execution is not automatically stopped. Nevertheless, the Thot Editor library stops execution when its text file is not reachable because it cannot work without. L8873 L8874 L8875We give an example of an application that needs four messages. The applicationMSG.h file is used to address correct message in source code and the en-applicationTXT gives the English version of messages text: L8876YC+ L8877 L8878 L8879AG L8880 L8881#define APP_start 0 L8882AG L8883 L8884#define APP_abort1 L8885AG L8886 L8887#define APP_no_file2  L8888AG L8889 L8890#define APP_complete3 L8891AG L8892 L8893#define APP_MSG_MAX 4 L34078AG L34076 L34077applicationMSG.h L8897 L8898 L8899 L89000 Application L8901 L8902 L89031 Application aborted L8904 L8905 L89062 Unreachable file %s L8907 L8908 L89093 End of application L34082 L34081 L34080  L34085 L34084 L34083en-applicationTXT L34086 L34088 L34089  L33862 L33864RP+ L33865The application has to load the rigth message table: L33867 L33869 L33870 L33871errorTable = TtaGetMessageTable("applicationTXT", APP_MSG_MAX); L33873 L33874RP+ L33875and displays the third error message using one of available display function (for example the TtaDisplayMessage function and TtaGetMessage): L33876 L33877 L33878 L33879TtaDisplayMessage(FATAL, TtaGetMessage(errorTable, APP_no_file), filename); L56693CF' L8921( L8922) L8923 L8924Constructors' L8925( L8926 L8927rV L10424 + ) L8928 L8929TtaGetMessageTable L8930 * L8931 L8932 L8933 L8934Loads text of application messages in a dynamically allocated table and returns the identifcation of this messages table. The  L33888FCT PmsgFile L33889 is the generic name of the message file to be loaded. The  L33880FCT PmsgNumber L33881 parameter denotes the number of messages to be read in the file.The full name of the loaded file is  L33882FCT P$THOTDIR/config/$LANG-msgFile L33883, where  L33884FCT P$THOTDIR L33885 represents the root path of Thot hierarchy and  L33886FCT P$LANG L33887 represents the current language (for example  L33890FCT Pen L33891).  L33896FCT PRP+$THOTDIR L33897 is computed by the Thot toolkit and  L33894FCT PRP+$LANG L33895 can be set in the user registry  L33892FCT PRP+thot.ini L33893. L22096 L22097CF L22098 L22099TPFHRP+ L22100int TtaGetMessageTable(char *msgFile, int msgNumber) L8943 L8944 L8945 L8946Parameters: L8947 L8948 L8949RP- L8950msgFile L8951: the generic name of the message file. L8952 L8953RP- L8954msgNumber: the number of messages. L8955 L8956 L8957 L8958Return value: L8959 L8960 L8961RP- L8962The messages table identifier or -1 if the table is not allocated and loaded.( L8963) L8964 L8965Accessors' L8966( L8967 L8968rV L10428 + ) L8969 L8970TtaGetMessage L8971 * L8972 L8973 L8974RP+ L8975Returns the text of the corresponding message. L22104 L22105CF L22106 L22107TPFHRP+ L22108FRchar *TtaGetMessage(int msgTableID, int msgIndex) L8984 L8985 L8986 L8987Parameters: L8988 L8989 L8990RP- L8991msgTableID L8992: identifier of the messages table. L8993 L8994RP- L8995msgIndex L8996: index of the message. L56694CF L8997 L8998 L8999 L9000Return value: L9001 L9002 L9003RP- L9004Text of the message (an empty text if the table or the message is not found). L9005rV L10432 + ( L9006 L9007rV L10436 + ) L9008 L9009TtaDisplaySimpleMessage L9010 * L9011 L9012 L9013 L9014Displays the text of a simple message. This message is often displayed in the message area of the main application window  L9015 L9016 if it exists L9017   L9018 L9019 or directed to the standard output for batch applications. L33900 L33899 L33898The msgType parameter defines the importance of the message: L33901 L33903 L33904 L33905 L33910 L33909INFO: the message is displayed in the message area of the main application window just as an information. L33914 L33915 L33920 L33919OVERHEAD: the message replaces the previous message in the message area of the main application window. L33906 L33907 L33913 L33912FATAL: the message stops the application with an error code. L33921 L33922 L33925 L33924CONFIRM: the message pops a message box to display the message within and waits for until the end user confirms the message has been read. L22112 L22113CF L22114 L22115TPFHRP+ L22116void TtaDisplaySimpleMessage(int msgType, int msgTableID, int msgIndex) L9038 L9039 L9040 L9041Parameters: L9042 L9047RP- L9048msgType L9049: the message type (INFO, OVERHEAD, FATAL L9050FR, CONFIRM L9051). L9043 L9044RP- L9045msgTableID L9046: identifier of the messages table (LIB for the standard Thot messages). L9052 L9053RP- L9054msgIndex L9055: index of the message.( L9056 L9057rV L10446 + ) L9058 L9059TtaDisplayMessage L9060 * L9061 L9062 L9063 L9064Displays a message mixing static text (the text of the message) with a variable number of parameters. The static text plays the role of a format (like the prinf format) and may include necessary format commandes for each parameter: a %s for a string, a %d for an integer. Number and type of variable parameters depend on format commands included in the message text. L9069 L9070 L33928. L56695CF L22120 L22121 L22122 L22123TPFHRP+ L22124FRvoid TtaDisplayMessage(int msgType, msgTableID, int msgIndex, ...) L9091 L9092 L9093 L9094Parameters: L9095 L33933RP- L33934msgType L33935: the message type (INFO, OVERHEAD, FATAL L33936FR, CONFIRM L33937). L33929 L33930RP- L33931msgTableID L33932: identifier of the messages table (LIB for the standard Thot messages). L9105 L9106RP- L9107msgIndex L9108: index of the message. L9112RP- L9113... L9114: variable parameters.  L9115 ( L9217) L9218 L9219Dialogue* L9220 L307 L308 L309The Thot editing tool kit provides dialogue functions. There are high level functions that hide most of the complex aspects of OSF/Motif and thus allows an application to use OSF/Motif very easily and dynamically (all dialogue entities such as menus, buttons, forms, etc. can be created and modified at any time). As these dialogue functions are already used internally by the editing tool kit, another reason for an application to use it, is to present the user with a homogeneous and consistent look and feel for the whole application. L9221 L9222 L9223The functions described in this section require that file  L9224dialogue.h L9225 be included in the module that calls them. They are available only in the Thot Editor library. L34591 L34590 L34589Each dialogue element is identified by a unique reference. This reference is associated to the dialogue element at the creation time and will be used all along the time it exists to perform any action on it (intialization, display, undisplay and destruction). L34597 L34596 L34595The application receives dialogue callbacks from created and displayed dialogue elements through predefined specific callback procedures. The application can define several callback procedures (at least one) and each callback procedure can manage callbacks from several dialogue elements. Each callback identifies the concerned element dialogue and allows the procedure to switch on the correct management. L56696CF' L9226( L9227) L9228 L9229Constructors' L9230( L34386 L34387rV L10468 + ) L34388 L34389TtaSetCallback L34390 * L34391 L34392 L34393 L34394This function defines a callback procedure for a set of dialogue elements (menus. forms, etc.). The function returns the current base value of concerned dialogue elements and reserves the set of references contained between "base" and "base+set-1". Each element can be created now after.  L34588 L34587 L34586When user acts on these dialogue elements, the callback procedure is called with three parameters: L34562 L34564 L34565 L34566 L34571 L34570the reference of the concerned dialogue element, L34567 L34568 L34574 L34573the type of the returned value (INTEGER_DATA or STRING_DATA) depending of the dialogue element type (menu, form, text-form, etc.), L34578 L34579 L34582 L34581the returned data. L34395 L34396CF L34397 L34398TPFHRP+ L34399 int TtaSetCallback (void (*callbakProcedure) (), int set) L34400 L34401 L34402 L34403Parameters: L34404 L34405 L34406RP- L34407 callbakProcedure L34408: the callback procedure to be called This function has to be previously declared like that:void Proc (int reference, int typeData, char *data) L34427RP- L34428 set L34429: the number of concerned dialogue elements. L34601 L34602 L34603 L34604Return value: L34605 L34606 L34607 L34608the base of dialogue element references.( L34474 L34475rV L10468 + ) L34476 L34477TtaNewForm L34478 * L34479 L34480 L34481 L34482This function creates a form element attached to the ThotWidget parent. When the parent ThotWidget is distroyed, the ThotWidget that realizes this form is automatically destroyed. Usually the parent is the document view frame returned by the API function  L34999SRT PFCTtaGetViewFrame (document, view)  L35000and the form has to be destroyed before closing the document view. L35021 L35020 L35019As seen in the example below, the fonction automatically generates two buttons on the bottom of the form: L56697CF L35027 L35029 L35030 L35031 L35036 L35035a "confirm" button L35032 L35033 L35039 L35038and a "cancel/done" button. L35050 L35052 L35053The parameter dbutton controls the choice of the "cancel/done" button. Two values are available: D_CANCEL or D_DONE./ L35022 L35024PSLAP+HAP+form.gif L34483 L34484CF L34485 L34486TPFHRP+ L34487 void TtaNewForm (int ref, ThotWidget parent, char *title, boolean horizontal, int packet, char button, int dbutton) L34488 L34489 L34490 L34491Parameters: L34492 L34493 L34494RP- L34495 ref L34496: the unique reference attached to the dialogue element. L34981RP- L34982 parent L34983: the ThotWidget parent (usually TtaGetViewFrame (document, view)). L34984RP- L34985 title L34986 the title or NULL. L34987RP- L34988 horizontal L34989 is TRUE if dialogue elements included into the form are arranged horizontally. L34990RP- L34991 packet L34992 number of dialogue elements in the same line if arranged horizontally or in the same column is arranged vertically. L34993RP- L34994 button L34995 the mouse button used to select the element dialogue: L56698CF L35002 L35003 L35004 L35005 L35010 L35009'L' for left button, L35006 L35007 L35013 L35012'M' for middle button, L35014 L35015 L35018 L35017'R' for right button. L34996RP- L34997 dbutton L34998 the type of "cancel/done" button: D_CANCEL or D_DONE.( L34518YP+ L34519rV L10468 + ) L34520 L34521TtaNewSheet L34522 * L34523 L34524 L34525 L35071 L35072 L35073This function creates a sheet element attached to the ThotWidget parent. When the parent ThotWidget is distroyed, the ThotWidget that realizes this sheet is automatically destroyed. Usually the parent is the document view frame returned by the API function TtaGetViewFrame (document, view) and the sheet has to be destroyed before closing the document view.  L35124 L35122 L35123A sheet is similar to a form element, but only the "cancel/done" button is automatically generated and other extra buttons are explicitly declared. The parameter dbutton controls the choice of the "cancel/done" button. Two values are available: D_CANCEL or D_DONE. In the example below, four extra buttons had been declared: "Skip and next", "Skip (+dic)", "Replace and next" and "Replace (+dic)". L56699CF/ L35572 L35574PSLAP+HAP+sheet.gif L34527 L34528CF L34529 L34530TPFHRP+ L34531 void TtaNewSheet (int ref, ThotWidget parent, char *title, int number, char *text, boolean horizontal, int packet, char button, int dbutton) L34532 L34533 L34534 L34535Parameters: L34536 L35118 L35119RP- L35120 ref L35121: the unique reference attached to the dialogue element. L35115RP- L35116 parent L35117: the ThotWidget parent (usually TtaGetViewFrame (document, view)). L35112RP- L35113 title L35114 the title or NULL. L34537 L34538RP- L34539 number L34540: number of extra buttons declared in the sheet. L56700CF L35158 L35159RP- L35160 text L35161: the list of strings declaring extra buttons ("A\0B\0" for two extra buttons A and B). L35109RP- L35110 horizontal L35111 is TRUE if dialogue elements included into the form are arranged horizontally. L35106RP- L35107 packet L35108 number of dialogue elements in the same line if arranged horizontally or in the same column is arranged vertically. L35103RP- L35104 button L35105 the mouse button used to select the element dialogue: L35089 L35090 L35091 L35092 L35093 L35094'L' for left button, L35095 L35096 L35097 L35098'M' for middle button, L35099 L35100 L35101 L35102'R' for right button. L35086RP- L35087 dbutton L35088 the type of "cancel/done" button: D_CANCEL or D_DONE.( L35162 L35163rV L10468 + ) L35164 L35165TtaNewDialogSheet L35166 * L35167 L35168 L35169 L35170 L35171 L35172This function creates a dialog sheet element attached to the ThotWidget parent. When the parent ThotWidget is distroyed, the ThotWidget that realizes this sheet is automatically destroyed. Usually the parent is the document view frame returned by the API function TtaGetViewFrame (document, view) and the sheet has to be destroyed before closing the document view.  L35178 L35179 L35180A dialog sheet is similar to a sheet element, but no "cancel/done" button is automatically generated. L35181 L35182CF L35183 L35184TPFHRP+ L35185 void TtaNewDialogSheet (int ref, ThotWidget parent, char *title, int number, char *text, boolean horizontal, int packet, char button) L35186 L35187 L35188 L35189Parameters: L35190 L35191 L35192RP- L35193 ref L35194: the unique reference attached to the dialogue element. L35195RP- L35196 parent L35197: the ThotWidget parent (usually TtaGetViewFrame (document, view)). L35198RP- L35199 title L35200 the title or NULL. L35201 L35202RP- L35203 number L35204: number of extra buttons declared in the sheet. L56701 CF L35205 L35206RP- L35207 text L35208: the list of strings declaring extra buttons ("A\0B\0" for two extra buttons "A" and "B"). L35209RP- L35210 horizontal L35211 is TRUE if dialogue elements included into the form are arranged horizontally. L35212RP- L35213 packet L35214 number of dialogue elements in the same line if arranged horizontally or in the same column is arranged vertically. L35215RP- L35216 button L35217 the mouse button used to select the element dialogue: L35218 L35219 L35220 L35221 L35222 L35223'L' for left button, L35224 L35225 L35226 L35227'M' for middle button, L35228 L35229 L35230 L35231'R' for right button.( L34632 L34633rV L10468 + ) L34634 L34635TtaNewSubmenu L34636 * L34637 L34638 L34639 L34640This function creates a submenu element attached to a menu entry or a form (form, sheet or dialog sheet). In a form, a submenu is displayed as a radio menu (see the menu "Paper Format" in the example presented in > L35281rV L34518 L35280). Only one entry of this menu can be selected at the same time. L35323 L35322 L35321Each entry is typed: L35299 L35300 L35301 L35302 L35303 L35304a simple button, L35305 L35306 L35307 L35308a link towards a form, L35309 L35310 L35311 L35312a link towards a submenu, L35313 L35314 L35315 L35316toggle button, L35317 L35318 L35319 L35320a separator. L34641 L34642CF L34643 L34644TPFHRP+ L34645 void TtaNewSubmenu (int ref, int ref_parent, int entry, char *title, int number, char *text, char *equiv, boolean react) L34646 L34647 L34648 L34649Parameters: L34650 L35249 L35250RP- L35251 ref L35252: the unique reference attached to the dialogue element. L35246RP- L35247 ref_parent L35248: the reference of parent element (a menu or a form). L35274RP- L35275 entry L35276: the entry index (0 to n) in the parent menu which the submenu is attached to. For a submenu attached to a form this paramameter is not treated. L56702!CF L35243RP- L35244 title L35245 the title or NULL. L35239 L35240RP- L35241 number L35242: number of entries declared in the submenu. L35235 L35236RP- L35237 text L35238: the list of strings declaring entries. Each entry starts with a special character that fixes the entry function: L35256 L35257 L35258 L35259 L35260'B' the entry is a simple button, L35261 L35262 L35263 L35264'F' the entry calls a form, L35265 L35266 L35267 L35268'M' the entry calls a submenu, L35269 L35270 L35273 L35272'T' the entry is a toggle. L35291 L35292 L35295 L35294'S" the entry is a separator (the entry string is limited to this character). L35255 L35254RP- L35253For example the text value "TA\0B" declares a toggle entry "A" and a button entry "B". L34651 L34652RP- L34653 equiv L34654: the list of strings declaring shortcuts attached to each entry. This parameter can be NULL if no shortcut is declared. L35277RP- L35278 react L35279: TRUE if the application wants to be informed as soon as the user selects in this submenu in a form. FALSE if the application prefers to wait for the confirmation of the form to receive the selected value.( L34678 L34679rV L10468 + ) L34680 L34681TtaNewIconMenu L34682 * L34683 L35404 L35405 L35406This function creates a submenu element attached to a menu entry or a form (form, sheet or dialog sheet). This submenu is composed of icons. Only one entry of this menu can be selected at the same time. This menu is always reactive. L34687 L34688CF L34689 L34690TPFHRP+ L34691 void TtaNewIconMenu (int ref, int ref_parent, int entry, char *title, int number, Pixmap * icons, boolean horizontal) L34692 L34693 L34694 L34695Parameters: L35413 L35414 L35415RP- L35416 ref L35417: the unique reference attached to the dialogue element. L35466RP- L35467 ref_parent L35468: the reference of parent element (a menu or a form). L35469RP- L35470 entry L35471: the entry index (0 to n) in the parent menu which the submenu is attached to. For a submenu attached to a form this paramameter is not treated. L56703"CF L35472RP- L35473 title L35474 the title or NULL. L35475 L35476RP- L35477 number L35478: number of entries declared in the menu. L35479 L35480RP- L35481 icons L35482: the list of pixmaps. L35514RP- L35515 horizontal L35516 is TRUE if entries are arranged horizontally.( L34655 L34656rV L10468 + ) L34657 L34658TtaNewToggleMenu L34659 * L34660 L35286 L35287 L35288This function creates a toggle menu element attached to a form (form, sheet or dialog sheet). This menu is displayed as a toggle menu (see the menu "Options" in the example presented in > L35289rV L34518 L35290). Only or more entries of this menu can be selected at the same time. L35324 L35325 L35326Each entry is typed: L35327 L35328 L35329 L35330 L35331 L35332a toggle, L35345 L35346 L35347 L35348a separator. L34664 L34665CF L34666 L34667TPFHRP+ L34668 void TtaNewToggleMenu (int ref, int ref_parent, char *title, int number, char *text, char *equiv, boolean react) L34669 L34670 L34671 L34672Parameters: L34673 L35397 L35398RP- L35399 ref L35400: the unique reference attached to the dialogue element. L35394RP- L35395 ref_parent L35396: the reference of parent element (a form). L35388RP- L35389 title L35390 the title or NULL. L35384 L35385RP- L35386 number L35387: number of entries declared in the menu. L35380 L35381RP- L35382 text L35383: the list of strings declaring entries. Each entry starts with a special character that fixes the entry function: L35359 L35360 L35361 L35362 L35363'B' or 'T' the entry is a simple button, L35376 L35377 L35378 L35379'S" the entry is a separator (the entry string is limited to this character). L35356 L35357RP- L35358For example the text value "TA\0S\0BC" declares an entry "A", a separator and an entry "C". L35352 L35353RP- L35354 equiv L35355: the list of strings declaring shortcuts attached to each entry. This parameter can be NULL if no shortcut is declared. L56704#CF L35349RP- L35350 react L35351: TRUE if the application wants to be informed as soon as the user selects in this submenu in a form. FALSE if the application prefers to wait for the confirmation of the form to receive the selected value.( L34701 L34702rV L10468 + ) L34703 L34704TtaNewSelector L34705 * L34706 L35557 L35558 L35559This function creates a selector element attached to a form (form, sheet or dialog sheet). L35620 L35619 L35618The selector can be displayed with or without a text input zone (controled by the parameter  L35576FCT PwithText L35577) that allows user to choose a predefined string into the selector or to insert directly a free text. The selector can be displayed with or without a label (controled by the parameter  L35578FCT Plabel L35579) that allow user to select this fixed. L35617 L35616 L35621In the previous example presented in > L35581rV L34518 L35580, a selector is displayed with the title "Spell checking ...", a text zone and the label "W3C". L34710 L34711CF L34712 L34713TPFHRP+ L34714 void TtaNewSelector (int ref, int ref_parent, char *title, int number, char *text, int height, char *label, boolean withText, boolean react) L34715 L34716 L34717 L34718Parameters: L34719 L35550 L35551RP- L35552 ref L35553: the unique reference attached to the dialogue element. L35547RP- L35548 ref_parent L35549: the reference of parent element (a form). L35544RP- L35545 title L35546 the title or NULL. L35540 L35541RP- L35542 number L35543: number of entries declared in the submenu. L35536 L35537RP- L35538 text L35539: the list of strings declaring entries. For example the text value "A\0B\0C" declares an entrries "A", "B" and "C". L35520 L35521RP- L35522 height L35523: the height of the selector (number of entries displayed). L35562RP- L35563 label L35564: the label string of the extra entry or NULL. L35565RP- L35566 withText L35567: TRUE if the application wants to display a text zone at the selector bottom. L35517RP- L35518 react L35519: TRUE if the application wants to be informed as soon as the user selects in this selector. FALSE if the application prefers to wait for the confirmation of the form to receive the selected value. L56705$CF( L34724 L34725rV L10468 + ) L34726 L34727TtaNewLabel L34728 * L34729 L35596 L35597 L35598This function creates a label element attached to a form (form, sheet or dialog sheet). In the previous example presented in > L35603rV L34518 L35604, there is a label element "Language: English". L34733 L34734CF L34735 L34736TPFHRP+ L34737 void TtaNewLabel (int ref, int ref_parent, char *text) L34738 L34739 L34740 L34741Parameters: L34742 L35586 L35587RP- L35588 ref L35589: the unique reference attached to the dialogue element. L35583RP- L35584 ref_parent L35585: the reference of parent element (a form). L35590RP- L35591 text L35592: the text of the label.( L34747 L34748rV L10468 + ) L34749 L34750TtaNewTextForm L34751 * L34752 L35610 L35611 L35612This function creates a text input zone attached to a form (form, sheet or dialog sheet). In the previous example presented in > L35613rV L34518 L35614, there is a text input zone without title. L34756 L34757CF L34758 L34759TPFHRP+ L34760 TtaNewTextForm (int ref, int ref_parent, char *title, int width, int height, boolean react) L34761 L34762 L34763 L34764Parameters: L34765 L35649 L35650RP- L35651 ref L35652: the unique reference attached to the dialogue element. L35646RP- L35647 ref_parent L35648: the reference of parent element (a form). L35643RP- L35644 title L35645 the title or NULL. L35639 L35640RP- L35641 width L35642: number of charaters displayed. L35631 L35632RP- L35633 height L35634: tnumber of lines displayed. L35622RP- L35623 react L35624: TRUE if the application wants to be informed as soon as the user inserts characters. FALSE if the application prefers to wait for the confirmation of the form to receive the final string. L53421CF L56706%CF( L34770 L34771rV L10468 + ) L34772 L34773TtaNewNumberForm L34774 * L34775 L35656 L35657 L35658This function creates an input zone for integer values attached to a form (form, sheet or dialog sheet). In the previous example presented in > L35659rV L34518 L35660, there is an input zone for integer values (from 1 to 10) displayed with the title "Number of proposals". L34779 L34780CF L34781 L34782TPFHRP+ L34783 void TtaNewNumberForm (int ref, int ref_parent, char *title, int min, int max, boolean react) L34784 L34785 L34786 L34787Parameters: L34788 L35678 L35679RP- L35680 ref L35681: the unique reference attached to the dialogue element. L35675RP- L35676 ref_parent L35677: the reference of parent element (a form). L35672RP- L35673 title L35674 the title or NULL. L35668 L35669RP- L35670 min L35671: the minimum integer value. L35664 L35665RP- L35666 max L35667: the maximum integer value. L35661RP- L35662 react L35663: TRUE if the application wants to be informed as soon as the user inserts characters. FALSE if the application prefers to wait for the confirmation of the form to receive the final string.( L35913) L35914 L35915TtaDestroyDialogue* L35916 L35917 L35918 L35919This function destroys an existing dialogue element. L35920 L35921 L35922 L35923TPFHRP+ L35924 void TtaDestroyDialogue (int ref) L35925 L35926 L35927 L35928Parameters: L35929 L35930RP- L35931 ref L35932: the unique reference attached to the dialogue element.( L9231 L9232rV L10468 + ) L9233 L9234TtaListDirectory L9235 * L9236 L9237 L9238 L9239Creates one or two selectors that allow end-user to select a directory and/or a file included within the current specified directory. This function supposes that the application had first created a form where selectors have to be inserted. The application is able to create either only the directory selector or only the file selector. A suffix can be  L56708&CF L56707specified if the application wants to filter a specific class of files. It is the responsibility of the application to receive and handle the selectors callback. L22128 L22129CF L22130 L22131TPFHRP+ L22132 void TtaListDirectory(char *aDirectory, int formRef, char *dirTitle, int dirRef, char *suffix, char *fileTitle, int fileRef) L9259 L9260 L9261 L9262Parameters: L9263 L9264 L9265RP- L9266 aDirectory L9267: the current designated directory. L9268 L9269RP- L9270 formRef L9271: the form identification. L9272 L9273RP- L9274 dirTitle L9275: the title of the directory selector. L9276RP- L9277 dirRef L9278: the directory selector identification or -1 if this selector is not desired. L9279 L9280RP- L9281suffix L9282: the suffix used for filtering files (for example ".PIV") L9283RP- L9284 fileTitle L9285: the title of the file selector. L9286RP- L9287 fileRef L9288: the file selector identification or -1 if this selector is not desired.( L9289 L9290rV L10472 + ) L9291 L9292TtaIsSuffixFileIn L9293 * L9294 L9295 L9296 L9297Returns True if the specified directory contains files with the specified suffix. L22136 L22137 L22138 L22139TPFHRP+ L22140 boolean TtaIsSuffixFileIn(char *aDirectory, char *suffix) L9306 L9307 L9308 L9309Parameters: L9310 L9311 L9312RP- L9313 aDirectory L9314: the current designated directory. L9315 L9316RP- L9317suffix L9318: the suffix used for filtering files (for example ".PIV") L9319 L9320 L9321 L9322Return value: L9323 L9324 L9325 L9326True or False. L56709'CF( L35682) L35683 L35684Modificators' L35701( L35702 L35703rV L10472 + ) L35704 L35705TtaSetMenuForm L35706 * L35707 L35708 L35709 L35710Selects an entry in a radio menu (submenu) of a form. L35711 L35712 L35713 L35714TPFHRP+ L35715 void TtaSetMenuForm (int ref, int entry) L35716 L35717 L35718 L35719Parameters: L35720 L35851RP- L35852 ref L35853: the unique reference attached to the dialogue element. L35725 L35726RP- L35727entry L35728: the selected entry (0 to n).( L35737) L35738 L35739TtaSetToggleMenu* L35794 L35795 L35796 L35797Changes the status of a toggle entry of a menu (submenu or toggle menu) in a form. L35824 L35825 L35826 L35827TPFHRP+ L35828 void TtaSetToggleMenu (int ref, int value, boolean on) L35829 L35830 L35831 L35832Parameters: L35833 L35858RP- L35859 ref L35860: the unique reference attached to the dialogue element. L35854 L35855RP- L35856entry L35857: the selected entry (0 to n). L35838 L35839RP- L35840on L35841: fixes the status of the toggle; TRUE if the toggle is selected.( L35861) L35862 L35863TtaShowDialogue* L35864 L35865 L35866 L35867This function displays an existing dialogue (form, sheet, dialog sheet). L35868 L35869 L35870 L35871TPFHRP+ L35872 void TtaShowDialogue (int ref, boolean remanent) L35873 L35874 L35875 L35876Parameters: L35877 L35878RP- L35879 ref L35880: the unique reference attached to the dialogue element. L35885 L35886RP- L35887remanent L35888: TRUE if the dialogue element is not automatically unmapped. L56710(CF( L35889) L35890 L35891TtaUnmapDialogue* L35892 L35893 L35894 L35895This function undisplays an existing dialogue (form, sheet, dialog sheet). L35896 L35897 L35898 L35899TPFHRP+ L35900 void TtaUnmapDialogue (int ref) L35901 L35902 L35903 L35904Parameter: L35905 L35906RP- L35907 ref L35908: the unique reference attached to the dialogue element.( L822) L823 L824Documents and schemas* L825 L826 L827 L828The functions described in this section require that file  L829document.h L830 be included in the module that calls them. L831rV L9454+ L832 L833 L834 L835Document identification L836 L837 L838 L839An application program using the Thot editing tool kit can handle several documents at the same time. These documents can be defined by the same structure schema or by different structure schemas as well. Before any other operation can be performed, a document must be either created ( L840rV L9458+  L841TtaNewDocument L842  L843), if it does not exist yet, or opened (TtaOpenDocument), if it exists in a file. These two functions return a value of type Document that is then used for identifying the document to which subsequent operations apply. The only exception is the function  L844rV L9462+! L845TtaGiveSchemasOfDocument L846! L847 which accesses a document by its name. L849 L850 L851The name of a document is a character string (maximum length is 19 characters, not including the extension) that is used for naming the file containing the document and that appears in the user dialogue (Thot Editor only). L852 L853 L854 L855Document files L856 L857 L858 L859Documents are stored in Unix files. Actually, a single document is represented by several files. All these files have the same name as the document, with different extensions: L860 L861 L862 L863 L864 L865The .PIV file contains the last version of the document (logical structure, contents, logical attributes and specific presentation rules). A .PIV file is created each time the document is saved, either by the  L56712)CF L56711user or by the application program (function  L866rV L9466+" L867TtaSaveDocument L868" L869). The .PIV file is the file read by the  L870rV L9470n+# L871TtaOpenDocument L872# L873 function. L874 L875 L876 L877The .OLD file contains the previous version of the document. It is a copy of the .PIV file before the last save operation. L878 L879 L880 L881The .BAK file contains a version of the document that is written periodically for allowing recovery from crashes. It is removed each time the document is saved successfully, but if the system or the application crashes, it must be renamed .PIV and can be used as an ordinary document file.  L882 L883 L884 L885The .SAV file is also a backup file. It is created by the tool kit when an internal error occurs and when it can save the document. This file contains the state of the document at the very moment of the crash. It can be used in the same way as the .BAK file. L886 L887 L888 L889The .EXT and .REF files contain the representation of the links that relate the document with other documents. These files do not exist if the document has no relations (references) with other documents. If they exist, they must be in the same directory as the .PIV file. They are read by the function  L890rV L9474p+$ L891TtaOpenDocument L892$ L893. L894 L895 L896 L897Directories L898 L899 L900 L901A list of directories, called the  L902document path L903, is used for searching the files needed when opening a document (.PIV, .REF and .EXT files). This path is initially set by the environment variable THOTDOC and it can be changed at any time by the function  L904rV L9478r+% L905TtaSetDocumentPath L906% L907. When a document is created (TtaNewDocument), all corresponding files are created in the first directory of the document path. L909 L910 L911Another list of directories is used when searching the schemas needed by a document that is created ( L912rV L9482 +& L913TtaNewDocument L914& L915) or opened (TtaOpenDocument). The  L916schema path L917 is initially set by the environment variable THOTSCH and it can be changed at any time by the function  L918rV L9486"+' L919TtaSetSchemaPath L920' L921. This path is also used by the function  L922rV L9490$+( L923TtaNewNature L924( L925.  L926 L927 L928 L929 L930Access mode L931 L932 L933 L934When using Thot Editor, the application program may ask the tool kit to prevent the user from modifying the document: an access mode (allowed  L56714*CF L56713values are read/write and read only) is associated with the whole document. The functions of the editing tool kit are not affected by the access mode; an application program can modify a document even if it is in read only mode. The access mode only applies to the operations performed by the user, who cannot modify a document that is in read only mode. When creating or opening a document, the access mode is set to read/write, but it can be changed at any time by the function  L935rV L9494&+) L936TtaSetDocumentAccessMode L937) L938. L939 L940 L941An application program can more precisely control the operations that the user is allowed to perform, by associating an access mode with each element in a document. This is explained in section > L942rV L2176 L943. L945 L946 L947 L948Natures L949 L950 L951 L952Many structured documents contain objects of different  L953natures L954, such as tables, equations, drawings, bibliographic items, etc. which are themselves logically structured. For avoiding to define the structure of these objects in the structure schemas of all document types, these objects are defined in separate structure schemas, one for each nature of objects, and they can be dynamically linked to document structure schemas. This can be repeated recursively: if an object of a given nature includes objects of other natures, its structure schema must include the structure schemas of the included natures. L955 L956 L957When the first object of a given nature is created in a document or in an object of another nature, the structure schema that defines the new nature must be linked to the structure schema that defines the document or object in which it is included. This is achieved by calling the function  L958rV L10476t++ L959TtaNewNature L960+ L961. L963 L964 L965 L966Schema extensions L967 L968 L969 L970Documents produced by Thot may be processed by other applications, which are either independent from the editor or included in it. Examples of such applications are the comparison of two versions of a document (independent from the editor) or the electronic index (included in the editor). Many of these applications make use of their own structural elements or attributes, which are related to the application itself and which are necessary for the application, whatever the document type. A  L973structure schema extension L974 is a special type of structure schema that defines attributes and elements of that kind and that can be associated to the main structure schema of any document for allowing an application to create in the document its own attributes and elements, which  L56716+CF L56715are not defined in the document structure schema. When several applications have to work on the same document, several schema extensions can be associated to the main structure schema of that document.' L975( L976) L977 L978Constructors' L979( L980 L981rV L9498*+,) L982 L983TtaNewDocument L984,* L985 L986 L987RP+ L988Creates the internal representation of a new document according to a given structure schema. No file is created immediately, but the backup files (.BAK and .SAV) and the document file (.PIV, see TtaNewDocument) will be created in the first directory of the document path (see TtaSetDocumentPath). L20384 L20385CF L20386 L20387TPFHRP+ L20388FRDocument TtaNewDocument(char *structureSchema, char *documentName) L997 L998 L999 L1000Parameters: L1001 L1002 L1003RP- L1004structureSchema L1005: name of the structure schema that defines the type of document to be created. L1006 L1007RP- L1008documentName L1009: name of the document to be created (maximum length 19 characters). The directory name is not part of this parameter (see  L1010rV L9502x+- L1011TtaSetDocumentPath L1012- L1013). L1014 L1015 L1016 L1017Return value: L1018 L1019 L1020 L1021the document that has been created or 0 if the document has not been created.( L1023 L1024rV L9506,+.) L1025 L1026TtaOpenDocument L1027.* L1028 L1029 L1030RP+ L1031Opens an existing document for subsequent operations. L20392 L20393CF L20394 L20395TPFHRP+ L20396FRDocument TtaOpenDocument(char *documentName, int accessMode) L56717,CF L1032 L1033 L1034 L1035Document TtaOpenDocument(documentName, accessMode) L1036 L1037char *documentName; L1038 L1039int accessMode; L1040 L1041 L1042 L1043Parameters: L1044 L1045 L1046RP- L1047documentName L1048: name of the file containing the document to be open. (maximum length 19 characters). The directory name is not part of this parameter (see  L1049rV L9510z+/ L1050TtaSetDocumentPath L1051/ L1052). L1053 L1054RP- L1055accessMode L1056: 0 = read only, 1 = read-write. L1057 L1058 L1059 L1060Return value: L1061 L1062 L1063 L1064the opened document, or 0 if the document cannot be open.( L1065 L1066rV L9514.+0) L1067 L1068TtaSaveDocument L10690* L1070 L1071 L1072RP+ L1073Saves a document into a file in Thot format (.PIV). The document is not closed by the function and can still be accessed by the application program. L20400 L20401CF L20402 L20403TPFHRP+ L20404ENvoid TtaSaveDocument(Document document, char *documentName) L1082 L1083 L1084 L1085Parameters: L1086 L1087 L1088RP- L1089document L1090: the document to be saved. L1091 L1092RP- L1093documentName L1094: name of the file in which the document must be saved. (maximum length 19 characters). The directory name is not part of this parameter (see  L1095rV L9518|+1 L1096TtaSetDocumentPath L10971 L1098). If the documentName is not the same as the one used when opening (see  L1099rV L9522[+2 L1100TtaOpenDocument L11012 L1102) or creating (see  L1103rV L9526]+3 L1104TtaNewDocument L11053 L1106) the document, a new file is created and the file with the old name is unchanged, i. e. a new version is created. If necessary, the old file can be removed by the function  L1107rV L9530_+4 L1108TtaRemoveDocument L11094 L1110. L56718-CF( L13382 L13418rV L13419 +) L13383 L13384TtaExportDocument L13424* L13385 L13386 L13387RP+ L13388Saves a document into a file in a particular format. The output format is specified by a translation schema. The document is not closed by the function and it can still be accessed by the application program. L20408 L20409CF L20410 L20411TPFHRP+ L20412FRvoid TtaExportDocument(Document document, char *fileName, char *TSchemaName) L13397 L13398 L13399 L13400Parameters: L13401 L13402 L13403RP- L13404document L13405: the document to be exported. L13406 L13407RP- L13408fileName L13409: name of the file in which the document must be saved, including the directory name. L13428RP- L13429TSchemaName L13430: name of the translation schema to be used. The directory name must not be specified in parameter TSchemaName. See function TtaSetSchemaPath.( L1111 L1112rV L95340+5) L1113 L1114TtaCloseDocument L11155* L1116 L1117 L1118RP+ L1119Closes a document that is no longer needed and releases all ressources allocated to the document. This function does not save the document. L20416 L20417CF L20418 L20419TPFHRP+ L20420void TtaCloseDocument(Document document) L1127 L1128 L1129 L1130Parameter: L1131 L1132 L1133RP- L1134document L1135: the document to be closed.( L1136EN L1137rV L9538c+6) L1138 L1139TtaRemoveDocument L11406* L1141 L1142 L1143RP+ L1144Closes a document, releases all ressources allocated to that document, removes all files related to the document and updates all links connecting the removed document with other documents. L56719.CF L20424 L20425CF L20426 L20427TPFHRP+ L20428FRvoid TtaRemoveDocument(Document document) L1151 L1152 L1153 L1154Parameter: L1155 L1156 L1157RP- L1158document L1159: the document to be removed.( L1160 L1161rV L95422+7) L1162 L1163TtaSetDocumentPath L11647* L1165 L1166 L1167RP+ L1168Sets a new list of document directories. This list replaces the existing one. It is used for searching a document when it is open either by the user or by the application program (see  L1169rV L9546d+8 L1170TtaOpenDocument L11718 L1172). The first directory in the list is used when a new document is created (see TtaNewDocument). L20432 L20433CF L20434 L20435TPFHRP+ L20436FRvoid TtaSetDocumentPath(char *path) L1179 L1180 L1181 L1182Parameter: L1183 L1184 L1185RP- L1186path L1187: the directory list, where directory names are separated by the character ':'.( L1188 L1189rV L9550+9) L1190 L1191TtaAppendDocumentPath L11929* L1193 L1194 L1195RP+ L1196Appends a new directory in the list of document directories. The function controls that the parameter is the name of an existing directory and sets an error if it is not. If the new directory is within the list of document directories yet, the function has no effect. L20440 L20441CF L20442 L20443TPFHRP+ L20444FRvoid TtaAppendDocumentPath(aDirectory) L1203 L1204 L1205 L1206Parameter: L1207 L1208 L1209RP- L1210aDirectory L1211: the new directory name. L56720/CF( L1212 L1213rV L95544+:) L1214 L1215TtaSetSchemaPath L1216:* L1217 L1218 L1219RP+ L1220Sets a new list of schema directories. This list replaces the existing one. It is used for searching schemas. L20448 L20449CF L20450 L20451TPFHRP+ L20452void TtaSetSchemaPath(char *path) L1228 L1229 L1230 L1231Parameter: L1232 L1233 L1234RP- L1235path L1236: the directory list, where directory names are separated by the character ':'.( L1237) L1238 L1239Modificators' L1240( L1241 L1242rV L95586+;) L1243 L1244TtaNewNature L1245;* L1246 L1247 L1248RP+ L1249Adds a new nature in a structure schema and returns the structure schema of the new nature. If the nature already exists in that structure schema, the function simply returns the structure schema of that nature. L20456 L20457CF L20458 L20459TPFHRP+ L20460SSchema TtaNewNature(SSchema schema, char *natureName, char *presentationName) L1260 L1261 L1262 L1263Parameters: L1264 L1265 L1266RP- L1267schema L1268: the structure schema to which the nature is added. L1269 L1270RP- L1271natureName L1272: name of the nature to be added in the structure schema. L1273RP- L1274presentationName L1275: name of the presentation schema to be associated with the extension schema. If presentationName is an empty string, the default presentation schema is associated. If the nature already exists, presentationName is ignored. L1276 L1277 L1278 L1279Return value: L1280 L1281 L1282 L1283the structure schema of the new nature; NULL if the structure schema has not been loaded. L567210CF( L1284 L1285rV L95628+<) L1286 L1287TtaNewSchemaExtension L1288<* L1289 L1290 L1291RP+ L1292Loads a structure schema extension and associates it with a given document. L20464 L20465CF L20466 L20467TPFHRP+ L20468SSchema TtaNewSchemaExtension(Document document, char *extensionName, char *presentationName) L1303 L1304 L1305 L1306Parameters: L1307 L1308 L1309RP- L1310document L1311: the document whose structure schema must be extended. L1312 L1313RP- L1314extensionName L1315: name of the extension schema. L1317 L1318RP- L1319presentationName L1320: name of the presentation schema to be associated with the extension schema. If presentationName is an empty string, the default presentation schema is associated. L1321 L1322 L1323 L1324Return value: L1325 L1326 L1327 L1328the extension schema, NULL if the extension schema has not been loaded.( L1329 L1330rV L9566:+=) L1331 L1332TtaRemoveSchemaExtension L1333=* L1334 L1335 L1336RP+ L1337Removes a structure schema extension from a given document. Removes also from the document all attributes and elements defined in that structure schema extension. L20472 L20473CF L20474 L20475TPFHRP+ L20476void TtaRemoveSchemaExtension(Document document, SSchema extension, int *removedElements, int *removedAttributes) L1350 L1351 L1352 L1353Parameters: L1354 L1355 L1356RP- L1357document L1358: the document. L1359 L1360RP- L1361extension L1362: the structure schema extension to be removed. L1363 L1364 L1365 L1366Return parameters: L1367 L1368 L1369RP- L1370removedElements L1371: number of elements actually removed. L1372 L1373RP- L1374removedAttributes L1375: number of attributes actually removed. L567221CF( L1376 L1377rV L9570?+>) L1378 L1379TtaSetPSchema L1380>* L1381 L1382 L1383RP+ L1384Sets or changes the main presentation schema of a document. The document must be open, but no view must be open for that document. L20480 L20481CF L20482 L20483TPFHRP+ L20484void TtaSetPSchema(Document document, char *presentationName) L1393 L1394 L1395 L1396Parameters: L1397 L1398 L1399RP- L1400document L1401: the document. L1402 L1403RP- L1404presentationName L1405: Name of the presentation schema to be associated with the document.( L1407 L1408rV L9574+?) L1409 L1410TtaSetDocumentDirectory L1411?* L1412 L1413 L1414RP+ L1415Sets the directory to which the document will be saved when calling TtaSaveDocument. L20488 L20489CF L20490 L20491TPFHRP+ L20492void TtaSetDocumentDirectory(Document document, char *directory) L1424 L1425 L1426 L1427Parameters: L1428 L1429 L1430RP- L1431document L1432: the document whose directory is set. L1433 L1434RP- L1435directory L1436: new document directory.( L13431 L13459rV L13460"+!) L13432 L13433TtaSetDocumentName L13465!* L13434 L13435 L13436RP+ L13437Sets or changes the name of a document. The document must be loaded. L20496 L20497CF L20498 L20499TPFHRP+ L20500FRvoid TtaSetDocumentName(Document document, char *documentName) L567232CF L13446 L13447 L13448 L13449Parameters: L13450 L13451 L13452RP- L13453document L13454: the document whose name is set. L13455 L13456RP- L13457documentName L13458: new document name. This is only the name, without any suffix, without directory name. See function TtaSetDocumentDirectory for changing the directory of a document.The name must not exceed 31 characters.( L1437 L1438rV L9578<+@) L1439 L1440TtaSetDocumentAccessMode L1441@* L1442 L1443 L1444RP+ L1445Sets the access mode for a document. L20504 L20505CF L20506 L20507TPFHRP+ L20508FRvoid TtaSetDocumentAccessMode(Document document, int accessMode) L1454 L1455 L1456 L1457Parameters: L1458 L1459 L1460RP- L1461document L1462: the document whose access mode is changed. L1463 L1464RP- L1465accessMode L1466: 0 = read only, 1 = read-write.( L13466 L13494rV L13495$+#) L13467 L13468TtaSetDocumentBackUpInterval L13500#* L13469 L13470 L13471RP+ L13472Sets the backup interval for a document. L20512 L20513CF L20514 L20515TPFHRP+ L20516void TtaSetDocumentBackUpInterval(Document document, int interval) L13481 L13482 L13483 L13484Parameters: L13485 L13486 L13487RP- L13488document L13489: the document whose backup interval is changed. L13490 L13491RP- L13492interval L13493: 0 : the backup mechanism must be disabledpositive integer : number of characters typed which triggers automatic save of the document into a .BAK file. L567243CF( L1467FR L1468rV L9582+A) L1469 L1470TtaSetNotificationMode L1471A* L1472 L1473 L1474RP+ L1475Sets the ECF notification mode for a document. L20520 L20521CF L20522 L20523TPFHRP+ L20524void TtaSetNotificationMode(Document document, int notificationMode) L1484 L1485 L1486 L1487Parameters: L1488 L1489 L1490RP- L1491document L1492: the document whose notification mode is changed. L1493 L1494RP- L1495notificationMode L1496: 0 = only roots of created, copied and deleted subtrees must be notified, 1 = all elements of created, copied and deleted subtrees must be notified.( L1497FR L1498rV L9586>+B) L1499 L1500TtaSetDocumentModified L1501B* L1502 L1503 L1504RP+ L1505Notifies the tool kit that a document has been modified by the application. As a consequence, the user will be asked to save the document when closing it. L20528 L20529CF L20530 L20531TPFHRP+ L20532void TtaSetDocumentModified(Document document) L1513 L1514 L1515 L1516Parameter: L1517 L1518 L1519RP- L1520document L1521: the document.( L1522FR L1523rV L9590 W+C) L1524 L1525TtaSetDocumentUnmodified L1526C* L1527 L1528 L1529RP+ L1530Notifies the tool kit that a document must be considered as not modified. As a consequence, if no further modification is made to that document, the user will not be asked to save the document when closing it. L20536 L20537CF L20538 L20539TPFHRP+ L20540void TtaSetDocumentUnmodified(Document document) L22162 L22163 L22164 L22165Parameter: L22166 L22167RP- L22168document L22169: the document. L567254CF( L1546) L1547 L1548Accessors' L1549( L13657) L13658 L13659TtaGetSchemaExtension* L13660 L13661 L13662 L13663Returns the extension structure schema  L13684ENassociated with the given document L13685. L20544 L20545CF L20546 L20547TPFHRP+ L20548SSchema TtaGetSchemaExtension(Document document, char *ExtensionName) L13672 L13673 L13674 L13675Parameter: L13676 L13677RP- L13678document L13679: the document L13686EN for which the extension structure schema is asked L13687. L13680 L13681RP- L13682ExtensionName L13683: the extension name.( L1550 L1551rV L9594 #+D) L1552 L1553TtaGetDocumentName L1554D* L1555 L1556 L1557RP+ L1558Returns the name of a document. L20552 L20553CF L20554 L20555TPFHRP+ L20556char *TtaGetDocumentName(Document document) L1565 L1566 L1567 L1568Parameter: L1569 L1570RP- L1571document L1572: the document whose name is asked. L1573 L1574 L1575 L1576Return value: L1577 L1578 L1579 L1580name of that document.( L1581 L1582rV L9598+E) L1583 L1584TtaGetDocumentFromName L1585E* L1586 L1587 L1588RP+ L1589Returns the document having a given name. L20560 L20561CF L20562 L20563TPFHRP+ L20564Document TtaGetDocumentFromName(char *documentName) L567265CF L1596 L1597 L1598 L1599Parameter: L1600 L1601RP- L1602documentName L1603: the document name. L1604 L1605 L1606 L1607Return value: L1608 L1609 L1610 L1611the document having that name.( L1612 L1613rV L9602@+F) L1614 L1615TtaGetDocumentSSchema L1616F* L1617 L1618 L1619RP+ L1620Returns the main structure schema of a document. L20568 L20569CF L20570 L20571TPFHRP+ L20572SSchema TtaGetDocumentSSchema(Document document) L1628 L1629 L1630 L1631Parameter: L1632 L1633 L1634RP- L1635document L1636: the document for which the structure schema is asked. L1637 L1638 L1639 L1640Return value: L1641 L1642 L1643 L1644the structure schema of that document.( L1645 L1646rV L9606B+G) L1647 L1648TtaGetSSchemaName L1649G* L1650 L1651 L1652RP+ L1653Returns the name of a structure schema. L20576 L20577CF L20578 L20579TPFHRP+ L20580char *TtaGetSSchemaName(SSchema schema) L1660 L1661 L1662 L1663Parameter: L1664 L1665 L1666RP- L1667schema L1668: the structure schema of interest. L1669 L1670 L1671 L1672Return value: L1673 L1674 L1675 L1676name of that structure schema. L567276CF( L1677 L1678rV L9610 +H) L1679 L1680TtaGetPSchemaName L1681H* L1682 L1683 L1684RP+ L1685Returns the name of the presentation schema currently associated with a given structure schema. L20584 L20585CF L20586 L20587TPFHRP+ L20588char *TtaGetPSchemaName(SSchema schema) L1692 L1693 L1694 L1695Parameter: L1696 L1697 L1698RP- L1699schema L1700: the structure schema of interest. L1701 L1702 L1703 L1704Return value: L1705 L1706 L1707 L1708name of the associated presentation schema.( L1709 L1710rV L9614 2+I) L1711 L1712TtaGetDocumentDirectory L1713I* L1714 L1715 L1716RP+ L1717Returns the directory to which the document is supposed to be saved. L20592 L20593CF L20594 L20595TPFHRP+ L20596FRvoid TtaGetDocumentDirectory(Document document, char *buffer, int bufferLength) L1728 L1729 L1730 L1731Parameters: L1732 L1733RP- L1734document L1735: the document whose directory is asked. L1736 L1737RP- L1738buffer L1739: a buffer provided by the caller. L1740 L1741RP- L1742bufferLength L1743: the length of that buffer. L1745 L1746 L1747 L1748Return parameter: L1749 L1750 L1751RP- L1752buffer L1753: the document directory. L567287CF( L1754 L1755rV L9618+J) L1756 L1757TtaGetSSchema L1758J* L1759 L1760 L1761RP+ L1762Returns a structure schema whose name is known and that is used in a given document. L20600 L20601CF L20602 L20603TPFHRP+ L20604FRSSchema TtaGetSSchema(char *name, Document document) L1771 L1772 L1773 L1774Parameter: L1775 L1776 L1777RP- L1778name L1779: the name of the structure schema of interest. L1780 L1781RP- L1782document L1783: the document that uses this structure schema. L1784 L1785 L1786 L1787Return value: L1788 L1789 L1790 L1791the structure schema having this name, or NULL if this structure schema is not loaded or not used by the document. L53422CF( L1792 L1793rV L9622+K) L1794 L1795TtaSameSSchemas L1796K* L1797 L1798 L1799RP+ L1800Compares two structure schemas. L20608 L20609CF L20610 L20611TPFHRP+ L20612int TtaSameSSchemas(SSchema schema1, SSchema schema2) L1809 L1810 L1811 L1812Parameters: L1813 L1814 L1815RP- L1816schema1 L1817: first structure schema. L1818 L1819RP- L1820schema2 L1821: second structure schema. L1822 L1823 L1824 L1825Return value: L1826 L1827 L1828 L18290 if both schemas are different, 1 if they are identical.( L1830 L1831rV L9626D+L) L1832 L1833TtaGiveSchemasOfDocument L1834L* L1835 L1836 L1837RP+ L1838Returns the names of the main structure schema and presentation schema associated with a given document. The document does not need to be open and the schemas are not loaded by this function. L567298CF L20616 L20617CF L20618 L20619TPFHRP+ L20620void TtaGiveSchemasOfDocument(char *documentName, char *structureName, char *presentationName) L1850 L1851 L1852 L1853Parameters: L1854 L1855 L1856RP- L1857documentName L1858: Name of the document to be checked (maximum length 19 characters). L1859 L1860RP- L1861structureName L1862: buffer. L1863 L1864RP- L1865presentationName L1866: buffer. L1867 L1868 L1869 L1870Return value: L1871 L1872 L1873RP- L1874structureName L1875: Name of the document structure schema. L1876 L1877RP- L1878presentationName L1879: Name of the document presentation schema.( L1880 L1881rV L9630F+M) L1882 L1883TtaNextSchemaExtension L1884M* L1885 L1886 L1887RP+ L1888Returns a structure schema extension associated with a given document. L20624 L20625CF L20626 L20627TPFHRP+ L20628FRvoid TtaNextSchemaExtension(Document document, SSchema *extension) L1897 L1898 L1899 L1900Parameters: L1901 L1902 L1903RP- L1904document L1905: the document of interest. L1906 L1907RP- L1908extension L1909: a schema extension of that document. NULL for accessing the first schema extension. L1910 L1911 L1912 L1913Return parameter: L1914 L1915 L1916RP- L1917extension L1918: the schema extension that follows or the first schema extension of the document if parameter extension is NULL. NULL if there is no more schema extension. L567309CF( L1919FR L1920rV L9634?+N) L1921 L1922TtaNextNature L1923N* L1924 L1925 L1926RP+ L1927Returns the structure schema of a nature used in a given document. L20632 L20633CF L20634 L20635TPFHRP+ L20636void TtaNextNature(Document document, SSchema *nature) L1936 L1937 L1938 L1939Parameters: L1940 L1941 L1942RP- L1943document L1944: the document of interest. L1945 L1946RP- L1947nature L1948: the structure schema of a nature for that document. NULL for accessing the first nature. L1950 L1951 L1952 L1953Return parameter: L1954 L1955 L1956RP- L1957nature L1958: the structure schema of the next nature, or the structure schema of the first nature of the document if parameter nature was NULL when calling. NULL if there is no more nature for the document.( L1959 L1960rV L9638H+O) L1961 L1962TtaIsDocumentModified L1963O* L1964 L1965 L1966RP+ L1967Indicates whether a document has been modified by the user or not. Modifications made by the application program are not considered, except when explicitly notified by  L1968rV L9642~+P L1969TtaSetDocumentModified L1970P L1971. L20640 L20641CF L20642 L20643TPFHRP+ L20644FRint TtaIsDocumentModified(Document document) L1978 L1979 L1980 L1981Parameter: L1982 L1983 L1984RP- L1985document L1986: the document. L1987 L1988 L1989 L1990Return value: L1991 L1992 L1993 L19941 if the document has been modified by the user since it has been saved, loaded or created, 0 if it has not been modified. L56731:CF( L13501 L13531rV L13532&+%) L13502 L13503TtaGetDocumentBackUpInterval L13537%* L13504 L13505 L13506RP+ L13507Returns the backup interval for a document. L20648 L20649CF L20650 L20651TPFHRP+ L20652FRint TtaGetDocumentBackUpInterval(Document document) L13514 L13515 L13516 L13517Parameter: L13518 L13519 L13520RP- L13521document L13522: the document whose backup interval is asked. L13523 L13524 L13525 L13526Return value: L13527 L13528 L13529 L135300 : the backup mechanism is disabledpositive integer : number of typed characters which trigger an autamatic save of the document into a .BAK file.( L1995 L1996rV L9646J+Q) L1997 L1998TtaGetDocumentAccessMode L1999Q* L2000 L2001 L2002RP+ L2003Returns the access mode for a document. L20656 L20657CF L20658 L20659TPFHRP+ L20660int TtaGetDocumentAccessMode(Document document) L2010 L2011 L2012 L2013Parameter: L2014 L2015 L2016RP- L2017document L2018: the document whose access mode is asked. L2019 L2020 L2021 L2022Return value: L2023 L2024 L2025 L20260 if access mode is read only, 1 if access mode is read-write.( L2027FR L2028rV L9650+R) L2029 L2030TtaGetNotificationMode L2031R* L2032 L2033 L2034RP+ L2035Returns the ECF notification mode for a document. L20664 L20665CF L20666 L20667TPFHRP+ L20668int TtaGetNotificationMode(Document document) L2042 L2043 L2044 L2045Parameters: L2046 L2047 L2048RP- L2049document L2050: the document whose notification mode is asked. L56732;CF L2051 L2052 L2053 L2054Return value: L2055 L2056 L2057 L20580 = if only roots of created and deleted subtrees must be notified, L2059 L2060 L20611 = all elements of created and deleted subtrees must be notified.( L2063 L2064rV L9654L+S) L2065 L2066TtaGetDocumentPath L2067S* L2068 L2069 L2070RP+ L2071Returns the current list of the directories used when a document is open (see  L2072rV L9658+T L2073TtaOpenDocument L2074T L2075). L20672 L20673CF L20674 L20675TPFHRP+ L20676void TtaGetDocumentPath(char *buffer, int bufferLength) L2084 L2085 L2086 L2087Parameters: L2088 L2089 L2090RP- L2091buffer L2092: a buffer provided by the caller. L2093 L2094RP- L2095bufferLength L2096: the length of that buffer. L2097 L2098 L2099 L2100Return parameter: L2101 L2102 L2103RP- L2104buffer L2105: the list of directories. Directory names are separated by the character ':'.( L2107 L2108rV L9662N+U) L2109 L2110TtaGetSchemaPath L2111U* L2112 L2113 L2114RP+ L2115Returns the current list of directories used for accessing schemas. L20680 L20681CF L20682 L20683TPFHRP+ L20684FRvoid TtaGetSchemaPath(char *buffer, int bufferLength) L2124 L2125 L2126 L2127Parameters: L2128 L2129 L2130RP- L2131buffer L2132: a buffer provided by the caller. L2133 L2134RP- L2135bufferLength L2136: the length of that buffer. L2137 L2138 L2139 L2140Return parameter: L2141 L2142 L2143RP- L2144buffer L2145: the list of directories. Directory names are separated by the character ':'. L56733<CF( L2146 L2147rV L9666+V) L2148 L2149TtaGetDocumentOfSavedElements L2150V* L2151 L2152 L2153RP+ L2154Returns the document for which the last Copy or Cut command has been issued. L20688 L20689CF L20690 L20691TPFHRP+ L20692Document TtaGetDocumentOfSavedElements() L2159 L2160 L2161 L2162Parameters: L2163 L2164 L2165RP- L2166no parameter L2167 L2168 L2169 L2170Return value: L2171 L2172 L2173RP- L2174the document for which the last Copy or Cut command has been issued. 0 if the clipboard is empty. L22176=UF( L2176) L2177 L2178Tree structures* L2179 L2180 L2181 L2182The largest group of functions in the editing tool kit handles the tree structures that represent the logical organization of a document. L2183 L2184 L2185The functions described in this section require that file  L2186tree.h L2187 be included in the module that calls them. L2188 L2189 L2190 L2191Main tree and associated trees L2192 L2193 L2194 L2195A document is in fact represented by a  L2196forest L2197, as several trees may be necessary for representing its abstract structure. The  L2198main tree L2199 represents the main stream of information in a document. In addition to that tree, there may exist some  L2200associated trees L2201, which represent other streams of information, such as notes, illustrations, comments, etc. These associated trees are specified in the structure schema of the document. L2202 L2203 L2204 L2205Structure of abstract trees L2206 L2207 L2208 L2209Several functions in this group allow to build or modify the structure of an abstract tree. As stated above, the structure of these trees is constrained by structure schemas. Therefore the programmer must be careful when handling abstract trees. All functions that change a tree structure check that the result will be consistent with the structure schema and they raise an error in case of inconsistency. L2210 L2211 L2212Checking can be made in two modes, a strict mode and a relaxed mode. In strict mode, all mandatory elements must always be present. In relaxed mode, even elements that are not stated optional in their structure schema can be omitted. The checking mode apply to the operations made by the application program, but also to the editing commands issued by the end-user, when using ThotEditor. The function  L2213rV L9670+W L2214TtaSetCheckingMode L2215W L2216 (see section > L2217rV L2778 L2218) changes checking mode. L2219 L2220 L2221For building a correct tree, the programmer must follow the structure schema. He or she can also consider existing Thot documents as examples. For that purpose, the function  L2222rV L9674+X L2223TtaListAbstractTree L2224X L2225 (see section > L2226rV L4054 L2227) can produce a human-readable form of an abstract tree. L2228 L2229 L2230 L2231Element types L2232 L2233 L2234 L2235When creating or searching elements in an abstract tree, the type of the concerned elements must be given. As presented in section > L2236rV L398 L2237, an element type  L56735>CF L56734contains a type number, but this number does not appear explicitly in a structure schema: it is generated by the schema compiler. For obtaining all type numbers of a structure schema, use the command: L2240 printsch -h SchemaName L2241which lists on the standard output a file that can be included into a C program. This file also contains all attribute numbers of the schema L2242 L2243 L2244 L2245Order of operations L2246 L2247 L2248 L2249As a general rule, as soon as an element or a tree has been created (by functions  L2250rV L9678+Y L2251TtaNewElement L2252Y L2253,  L2254rV L9682+Z L2255TtaNewTree L2256Z L2257, or  L2258rV L9686+[ L2259TtaCopyTree L2260[ L2261), it must be included into the main tree or an associated tree of a document (by functions  L2262rV L9690+\ L2263TtaInsertSibling L2264\ L2265,  L2266rV L9694+] L2267TtaInsertFirstChild L2268] L2269, or  L2270rV L9698+^ L2271TtaAttachNewTree L2272^ L2273), prior any other function can be performed. L2274 L2275 L2276 L2277Labels L2278 L2279 L2280 L2281Each element in a document has a unique identifier called a  L2282label L2283. Labels are automatically assigned to elements by all functions that create new elements ( L2284rV L9702+_ L2285TtaNewElement L2286_ L2287,  L2288rV L9706+` L2289TtaNewTree L2290` L2291, or  L2292rV L9710+a L2293TtaCopyTree L2294a L2295). Labels can be accessed by functions  L2296rV L9714+b L2297TtaSearchElementByLabel L2298b L2299 and  L2300rV L9718+c L2301TtaGetElementLabel L2302c L2303. L2304 L2305 L2306 L2307Access rights L2308 L2309 L2310 L2311An access right can be associated with each element. Three access rights are defined: L2312 L2313 L2314 L2315 L2316Read/write L2317 L2318 L2319 L2320The element can be seen and modified by the user. L2321 L2322 L2323Read only L2324 L2325 L2326 L2327The element can be seen by the user, but no changes are allowed. L2328 L2329 L2330Hidden L2331 L2332 L2333 L2334The element is not displayed and cannot be changed by the user. L2335 L2336 L2337These rights only apply to the end user who manipulates a document interactively with the commands provided by the Thot editor. They do not apply to the application program that manipulate the document through the editing tool kit. L56736?CF' L2339( L2340) L2341 L2342Constructors' L2343( L2344 L2345rV L9722O+d) L2346 L2347TtaNewElement L2348d* L2349 L2350 L2351RP+ L2352Creates a new element of a given type. L20696 L20697CF L20698 L20699TPFHRP+ L20700Element TtaNewElement(Document document, ElementType elementType) L2361 L2362 L2363 L2364Parameters: L2365 L2366 L2367RP- L2368document L2369: the document for which the element is created. L2370 L2371RP- L2372elementType L2373: type of the element to be created. L2374 L2375 L2376 L2377Return value: L2378 L2379 L2380 L2381the created element.( L2382 L2383rV L9726Q+e) L2384 L2385TtaNewTree L2386e* L2387 L2388 L2389RP+ L2390Creates a new element of a given type and all its descendants, according to the structure schema. L20704 L20705CF L20706 L20707TPFHRP+ L20708FRElement TtaNewTree(Document document, ElementType elementType , char *label) L2401 L2402 L2403 L2404Parameters: L2405 L2406 L2407RP- L2408document L2409: the document for which the tree is created. L2410 L2411RP- L2412elementType L2413: type of the root element of the tree to be created. L2414 L2415RP- L2416label L2417: label of the root element to be created. Empty string if the value of the label is undefined. L2418 L2419 L2420 L2421Return value: L2422 L2423 L2424 L2425the root element of the created tree. L56737@CF( L2426 L2427rV L9730S+f) L2428 L2429TtaCopyTree L2430f* L2431 L2432 L2433RP+ L2434Creates a copy of a tree. L20712 L20713CF L20714 L20715TPFHRP+ L20716FRElement TtaCopyTree(Element sourceElement, Document sourceDocument, Document destinationDocument, Element parent) L2448 L2449 L2450 L2451Parameters: L2452 L2453 L2454RP- L2455sourceElement L2456: element to be copied. L2457 L2458RP- L2459sourceDocument L2460: the document containing the element to be copied. L2461 L2462RP- L2463destinationDocument L2464: the document for which the copy must be created. L2465 L2466RP- L2467parent L2468: element that will become the parent of the created tree. L2469 L2470 L2471 L2472Return value: L2473 L2474 L2475 L2476the root element of the created tree.( L25513 L25514rV L9734U+) L25515 L25516TtaCreateDescent L25517* L25518 L25519 L25520RP+ L25521Creates a new element of a given type and inserts it in the tree as a descendant of a given element. All elements of the descent required by the structure schema are also created. L25522 L25523CF L25524 L25525TPFHRP+ L25526FRElement TtaCreateDescent(Document document, Element element, ElementType elementType) L25527 L25528 L25529 L25530Parameters: L25531 L25532 L25533RP- L25534document L25535: the document for which the tree is created. L25536 L25537RP- L25538element L25539: the element for which a descent will be created. L25540 L25541RP- L25542elementType L25543: type of the element to be created as the last descendant. L25544 L25545 L25546 L25547Return value: L25548 L25549 L25550 L25551the last descendant created or NULL if the element cannot be created. This element is empty. L56738ACF( L2477 L25552rV L25553+) L2479 L2480TtaCreateDescentWithContent L25559* L2482 L2483 L2484RP+ L2485Creates a new element of a given type and inserts it in the tree as a descendant of a given element. All elements of the descent required by the structure schema are created, as well as the content of the requested element. L20720 L20721CF L20722 L20723TPFHRP+ L20724FRElement TtaCreateDescentWithContent(Document document, Element element, ElementType elementType) L2496 L2497 L2498 L2499Parameters: L2500 L2501 L2502RP- L2503document L2504: the document for which the tree is created. L2505 L2506RP- L2507element L2508: the element for which a descent will be created. L2509 L2510RP- L2511elementType L2512: type of the element to be created as the last descendant. L2513 L2514 L2515 L2516Return value: L2517 L2518 L2519 L2520the last descendant created or NULL if the element cannot be created. If not NULL, the minimum content of that element has been created.( L2521 L2522rV L9738W+h) L2523 L2524TtaDeleteTree L2525h* L2526 L2527 L2528RP+ L2529Deletes a tree (or a single element) and frees it. All references that points at any element of that tree are cancelled. The deleted element must not be used later. L20728 L20729CF L20730 L20731TPFHRP+ L20732FRvoid TtaDeleteTree(Element element, Document document) L2538 L2539 L2540 L2541Parameters: L2542 L2543 L2544RP- L2545element L2546: the element (or root of the tree) to be deleted. L2547 L2548RP- L2549document L2550: the document containing the element to be deleted. L56739BCF( L2552 L2553rV L9742Y+i) L2554 L2555TtaAttachNewTree L2556i* L2557 L2558 L2559RP+ L2560Attaches an entire tree (main tree or associated tree) to a document. L20736 L20737CF L22177TPFHRP+ L22178void TtaAttachNewTree(Element tree, Document document) L2569 L2570 L2571 L2572Parameters: L2573 L2574 L2575RP- L2576tree L2577: root of the tree to be attached. This tree must be a valid main tree or associated tree according to the document structure schema. L2578 L2579RP- L2580document L2581: the document to which the tree is to be attached.( L53224 L53265rV L53266 C+ B) L53225 L53226TtaExportTree L53272 B* L53227 L53228 L53232 L53231Saves an abstract tree into a file in a particular format. The output format is specified by a translation schema. L53235 L53236CF L53237TPFHRP+ L53238void TtaExportTree (Element element, Document document, char *fileName, char *TSchemaName) L53239 L53240 L53241 L53242Parameters: L53243 L53244 L53245RP- L53246element L53247: the root of the tree to be exported L53248 L53249RP- L53250document L53251: the document containing the tree to be exported. L53252RP- L53253fileName L53254: name of the file in which the tree must be saved, including the directory name. L53262RP- L53263TSchemaName L53264: name of the translation schema to be used. The directory name must not be specified in parameter TSchemaName. See function TtaSetSchemaPath. L56740CCF( L2582) L2583 L2584Modificators' L2585( L2586 L2587rV L9746[+j) L2588 L2589TtaInsertSibling L2590j* L2591 L2592 L2593RP+ L2594Inserts an element in a tree, as an immediate sibling of a given element. The element to be inserted must not yet be part of a document. You can call  L32455FCT PTtaCanInsertSibling L32456 before to check whether that insertion is allowed or not (see section > L32459rV L32216 L32458). L20744 L20745CF L20746 L20747TPFHRP+ L20748FRvoid TtaInsertSibling(Element newElement, Element sibling, boolean before, Document document) L2607 L2608 L2609 L2610Parameters: L2611 L2612 L2613RP- L2614newElement L2615: the element (or root of the tree) to be inserted. L2616 L2617RP- L2618sibling L2619: an element belonging to a tree. This element must not be the root of a tree. L2620 L2621RP- L2622before L2623: if True, inserts newElement as previous sibling of sibling, if False, inserts newElement as next sibling of sibling. L2624 L2625RP- L2626document L2627: the document to which both elements belong.( L2628 L2629rV L9750]+k) L2630 L2631TtaInsertFirstChild L2632k* L2633 L2634 L2635RP+ L2636Inserts an element in a tree, as the first child of a given element. The element to be inserted must not yet be part of a document. This function can also be used for attaching an option to a choice. You can call  L32463FCT PTtaCanInsertFirstChild L32464 before to check whether that insertion is allowed or not (see section > L32465rV L32256 L32466). L20752 L20753CF L20754 L20755TPFHRP+ L20756FRvoid TtaInsertFirstChild(Element *newElement, Element parent, Document document) L2648 L2649 L2650 L2651Parameters: L2652 L2653 L2654RP- L2655newElement L2656: the element (or root of the tree) to be inserted. L2657 L2658RP- L2659parent L2660: an element belonging to a tree. L2661 L2662RP- L2663document L2664: the document to which both elements belong. L56741DCF L2665 L2666 L2667 L2668Return parameter: L2669 L2670 L2671 L2672If newElement is an option that replaces the choice, newElement takes L2673 L2674 L2675the value of parent.( L32647 L32712rV L32713m+l) L32649 L32650TtaCreateElement L32719l* L32652 L32653 L32654RP+ L32686Creates an element of a given type and insert it at the current position within a given document. The current position is defined by the current selection. If the current position is a single position (insertion point) the new element is simply inserted at that position. If one or several characters and/or elements are selected, the new element is created at that position and the selected characters/elements become the content of the new element, provided the structure schema allows it. L32660 L32661CF L32662 L32663TPFHRP+JF L32664FRJFvoid TtaCreateElement(ElementType elementType, Document document) L32665 L32666 L32667 L32668Parameters: L32669 L32670 L32671RP- L32672elementType L32673: type of the element to be created. L32682 L32683RP- L32684document L32685: the document for which the element is created.( L32687 L32720rV L32721o+n) L32688 L32689TtaInsertElement L32727n* L32690 L32691 L32692RP+ L32693Creates an element of a given type and insert it at the current position within a given document. The current position is defined by the current selection. If the current position is a single position (insertion point) the new element is simply inserted at that position. If one or several characters and/or elements are selected, the new element is created before the first selected character/element and the selected characters/elements are not changed. L32694 L32695CF L32696 L32697TPFHRP+JF L32698FRJFvoid TtaInsertElement(ElementType elementType, Document document) L56742ECF L32699 L32700 L32701 L32702Parameters: L32703 L32704 L32705RP- L32706elementType L32707: type of the element to be created. L32708 L32709RP- L32710document L32711: the document for which the element is created.( L2676 L2677rV L9754_+l) L2678 L2679TtaRemoveTree L2680l* L2681 L2682 L2683RP+ L2684Removes a tree (or a single element) from its tree, without freeing it. L20760 L20761CF L20762 L20763TPFHRP+ L20764FRvoid TtaRemoveTree(Element element, Document document) L2693 L2694 L2695 L2696Parameters: L2697 L2698 L2699RP- L2700element L2701: the element (or root of the tree) to be removed. L2702 L2703RP- L2704document L2705: the document containing the element to be removed.( L2706 L2707rV L9758a+m) L2708 L2709TtaSetAccessRight L2710m* L2711 L2712 L2713RP+ L2714Sets the access rights for a given element. Access rights apply only during the current editing session; they are not saved with the document. They must be set each time the document is loaded. L20768 L20769CF L20770 L20771TPFHRP+ L20772FRvoid TtaSetAccessRight(Element element, AccessRight right, Document document) L2725 L2726 L2727 L2728Parameters: L2729 L2730 L2731RP- L2732element L2733: the element. L2734 L2735RP- L2736right L2737: access right for that element (ReadOnly, ReadWrite, Hidden, Inherited). L2738RP- L2739document L2740: the document to which the element belongs. L56743FCF( L2741 L2742rV L9762c+n) L2743 L2744TtaHolophrastElement L2745n* L2746 L2747 L2748RP+ L2749Changes the holophrasting status of a given element. L20776 L20777CF L20778 L20779TPFHRP+ L20780FRvoid TtaHolophrastElement(Element element, boolean holophrast, Document document) L2761 L2762 L2763 L2764Parameters: L2765 L2766 L2767RP- L2768element L2769: the element. L2770 L2771RP- L2772holophrast L2773: True: the element gets holophrasted if it is not, False: if the element is holphrasted, it gets expanded. L2774 L2775RP- L2776document L2777: the document to which the element belongs.( L2778 L2779rV L9766e+o) L2780 L2781TtaSetCheckingMode L2782o* L2783 L2784 L2785RP+ L2786Changes checking mode. L20784 L20785CF L20786 L20787TPFHRP+ L20788void TtaSetCheckingMode(boolean strict) L2793 L2794 L2795 L2796Parameter: L2797 L2798 L2799RP- L2800strict L2801: if True, the presence of all mandatory elements is checked.( L2802) L2803 L2804Accessors' L2805( L2806 L2807rV L9770g+p) L2808 L2809TtaGetMainRoot L2810p* L2811 L2812 L2813RP+ L2814Returns the root element of the main abstract tree representing a document. L20792 L20793CF L20794 L20795TPFHRP+ L20796FRElement TtaGetMainRoot(Document document) L2821 L2822 L2823 L2824Parameter: L2825 L2826 L2827RP- L2828document L2829: the document. L56744GCF L2830 L2831 L2832 L2833Return value: L2834 L2835 L2836 L2837the root element of the main abstract tree.( L2838 L2839rV L9774i+q) L2840 L2841TtaNextAssociatedRoot L2842q* L2843 L2844 L2845RP+ L2846Returns the root element of the associated tree that follows the tree to which a given element belongs. L20800 L20801CF L20802 L20803TPFHRP+ L20804FRvoid TtaNextAssociatedRoot(Document document, Element root) L2856 L2857 L2858 L2859Parameters: L2860 L2861 L2862RP- L2863document L2864: the document. L2865 L2866RP- L2867root L2868: the element for which the next associated tree is searched. That element does not need to be the root of a tree. If root is NULL or if root is an element in the main tree, the root of the first associated tree is returned. L2869 L2870 L2871 L2872Return parameter: L2873 L2874 L2875RP- L2876root L2877: the root element of the next associated tree. NULL if there is no next associated tree for the document.( L2878 L2879rV L9778k+r) L2880 L2881TtaGetFirstChild L2882r* L2883 L2884 L2885RP+ L2886Returns the first child element of a given element. L20808 L20809CF L20810 L20811TPFHRP+ L20812Element TtaGetFirstChild(Element parent) L2893 L2894 L2895 L2896Parameter: L2897 L2898 L2899RP- L2900parent L2901: the element for which the first child element is asked. L2902 L2903 L2904 L2905Return value: L2906 L2907 L2908 L2909the first child element of parent; NULL if parent has no child. L56745HCF( L2910 L2911rV L9782m+s) L2912 L2913TtaGetLastChild L2914s* L2915 L2916 L2917RP+ L2918Returns the last child element of a given element. L20816 L20817CF L20818 L20819TPFHRP+ L20820FRElement TtaGetLastChild(Element parent) L2925 L2926 L2927 L2928Parameter: L2929 L2930 L2931RP- L2932parent L2933: the element for which the last child element is asked. L2934 L2935 L2936 L2937Return value: L2938 L2939 L2940 L2941the last child element of parent; NULL if parent has no child.( L2942 L2943rV L9786o+t) L2944 L2945TtaPreviousSibling L2946t* L2947 L2948 L2949RP+ L2950Returns the previous sibling element of a given element. L20832 L20833CF L20834 L20835TPFHRP+ L20836void TtaPreviousSibling(Element *element) L2957 L2958 L2959 L2960Parameter: L2961 L2962 L2963RP- L2964element L2965: the element whose previous sibling is asked. L2967 L2968 L2969 L2970Return parameter: L2971 L2972 L2973RP- L2974element L2975: the previous sibling element, or NULL if there is no previous sibling.( L2976 L2977rV L9790q+u) L2978 L2979TtaNextSibling L2980u* L2981 L2982 L2983RP+ L2984Returns the next sibling element of a given element. L20840 L20841CF L20842 L20843TPFHRP+ L20844FRvoid TtaNextSibling(Element *element) L2991 L2992 L2993 L2994Parameter: L2995 L2996 L2997RP- L2998element L2999: the element whose next sibling is asked. L56746ICF L3000 L3001 L3002 L3003Return parameter: L3004 L3005 L3006RP- L3007element L3008: the next sibling element, or NULL if there is no next sibling.( L3009 L3010rV L9794s+v) L3011 L3012TtaGetSuccessor L3013v* L3014 L3015 L3016RP+ L3017Returns the element that follows a given element at the same level or at  L3018FRthe first upper level where there is a following element L3019. L20848 L20849CF L20850 L20851TPFHRP+ L20852Element TtaGetSuccessor(Element element) L3026 L3027 L3028 L3029Parameter: L3030 L3031 L3032RP- L3033element L3034: the element whose successor is asked. L3035 L3036 L3037 L3038Return value: L3039 L3040 L3041 L3042the successor, or NULL if there is no successor.( L3043FR L3044rV L97984+w) L3045 L3046TtaGetPredecessor L3047w* L3048 L3049 L3050RP+ L3051Returns the element that precedes a given element at the same level or at the first upper level where there is a preceding element. L20856 L20857CF L20858 L20859TPFHRP+ L20860Element TtaGetPredecessor(Element element) L3058 L3059 L3060 L3061Parameter: L3062 L3063 L3064RP- L3065element L3066: the element whose predecessor is asked. L3067 L3068 L3069 L3070Return value: L3071 L3072 L3073 L3074the predecessor, or NULL if there is no predecessor.( L3076 L3077rV L9802u+x) L3078 L3079TtaGetParent L3080x* L3081 L3082 L3083RP+ L3084Returns the parent element (i.e. first ancestor) of a given element. L20864 L20865CF L20866 L20867TPFHRP+ L20868Element TtaGetParent(Element element) L56747JCF L3091 L3092 L3093 L3094Parameter: L3095 L3096 L3097RP- L3098element L3099: the element whose the parent is asked. L3100 L3101 L3102 L3103Return value: L3104 L3105 L3106 L3107the parent element, or NULL if there is no parent (root).( L3108 L3109rV L9806w+y) L3110 L3111TtaGetCommonAncestor L3112y* L3113 L3114 L3115RP+ L3116Returns the common ancestor element of two given elements. L20872 L20873CF L20874 L20875TPFHRP+ L20876FRElement TtaGetCommonAncestor(Element element1, Element element2) L3125 L3126 L3127 L3128Parameters: L3129 L3130 L3131RP- L3132element1 L3133: the first element whose ancestor is asked. L3134 L3135RP- L3136element2 L3137: the second element whose ancestor is asked. L3138 L3139 L3140 L3141Return value: L3142 L3143 L3144 L3145the common ancestor, or NULL if there is no common ancestor. L53423CF( L3146 L3147rV L9810y+z) L3148 L3149TtaGetTypedAncestor L3150z* L3151 L3152 L3153RP+ L3154Returns the first ancestor of a given type for a given element. L20880 L20881CF L20882 L20883TPFHRP+ L20884FRElement TtaGetTypedAncestor(Element element, ElementType ancestorType) L3163 L3164 L3165 L3166Parameters: L3167 L3168 L3169RP- L3170element L3171: the element whose ancestor is asked. L3172 L3173RP- L3174ancestorType L3175: type of the asked ancestor. L3176 L3177 L3178 L3179Return value: L3180 L3181 L3182 L3183the ancestor, or NULL if there is no ancestor of that type. L56748KCF( L3184 L3185rV L9814{+{) L3186 L3187TtaGetElementType L3188{* L3189 L3190 L3191RP+ L3192Returns the type of a given element. L20888 L20889CF L20890 L20891TPFHRP+ L20892FRElementType TtaGetElementType(Element element) L3200 L3201 L3202 L3203Parameter: L3204 L3205 L3206RP- L3207element L3208: the element. L3209 L3210 L3211 L3212Return value: L3213 L3214 L3215 L3216type of the element.( L3217 L3218rV L9818}+|) L3219 L3220TtaGetElementTypeName L3221|* L3222 L3223 L3224RP+ L3225Returns the name of an element type. L20896 L20897CF L20898 L20899TPFHRP+ L20900FRchar *TtaGetElementTypeName(ElementType elementType) L3232 L3233 L3234 L3235Parameter: L3236 L3237 L3238RP- L3239elementType L3240: element type. L3241 L3242 L3243 L3244Return value: L3245 L3246 L3247 L3248name of that type.( L56824 L56825rV L9818+) L56826 L56827TtaGetElementTypeOriginalName L56828* L56829 L56830 L56831RP+ L56832Returns the original name of an element type, as it is defined in the structure schema. L56833 L56834CF L56835 L56836TPFHRP+ L56837FRchar *TtaGetElementTypeOriginalName(ElementType elementType) L56838 L56839 L56840 L56841Parameter: L56842 L56843 L56844RP- L56845elementType L56846: element type. L56847 L56848 L56849 L56850Return value: L56851 L56852 L56853 L56854original name of that type.( L3249 L3250rV L9822+}) L3251 L3252TtaGiveTypeFromName L3253}* L3254 L3255 L3256RP+ L3257Gives an element type whose name is known (the structure schema that defines that type must be loaded). That type is searched in a given structure schema (elementType.ElSSchema) and in all structure schemas that are extensions of that structure schema or natures used in that structure schema. L20904 L20905CF L20906 L20907TPFHRP+ L20908FRvoid TtaGiveTypeFromName(ElementType *elementType, char *name) L56749LCF L3266 L3267 L3268 L3269Parameters: L3270 L3271 L3272RP- L3273elementType.ElSSchema L3274: the structure schema of interest. L3275 L3276RP- L3277name L3278: the name of the type of interest. L3279 L3280 L3281 L3282Return parameter: L3283 L3284 L3285RP- L3286elementType L3287: the type having this name, or elementType.ElTypeNum = 0 if the type is not found.( L56855 L56856rV L9822+) L56857 L56858TtaGiveTypeFromOriginalName L56859* L56860 L56861 L56862RP+ L56863Gives an element type whose original name (in the language it is given in the structure schema) is known (the structure schema that defines that type must be loaded). That type is searched in a given structure schema (elementType.ElSSchema) and in all structure schemas that are extensions of that structure schema or natures used in that structure schema. L56864 L56865CF L56866 L56867TPFHRP+ L56868FRvoid TtaGiveTypeFromOriginalName(ElementType *elementType, char *name) L56869 L56870 L56871 L56872Parameters: L56873 L56874 L56875RP- L56876elementType.ElSSchema L56877: the structure schema of interest. L56878 L56879RP- L56880name L56881: the original name of the type of interest. L56882 L56883 L56884 L56885Return parameter: L56886 L56887 L56888RP- L56889elementType L56890: the type having this name, or elementType.ElTypeNum = 0 if the type is not found.( L3288 L3289rV L9826+~) L3290 L3291TtaSameTypes L3292~* L3293 L3294 L3295RP+ L3296Compares two element types. L20912 L20913CF L20914 L20915TPFHRP+ L20916FRint TtaSameTypes(ElementType type1, ElementType type2) L3306 L3307 L3308 L3309Parameters: L3310 L3311 L3312RP- L3313type1 L3314: first element type. L3315 L3316RP- L3317type2 L3318: second element type. L3319 L3320 L3321 L3322Return value: L3323 L3324 L3325 L33260 if both types are different, 1 if they are identical.( L3327 L3328rV L9830+) L3329 L3330TtaGetElementLabel L3331* L3332 L3333 L3334RP+ L3335Returns the label of a given element. L20920 L20921CF L20922 L20923TPFHRP+ L20924FRchar *TtaGetElementLabel(Element element) L3342 L3343 L3344 L3345Parameter: L3346 L3347 L3348RP- L3349element L3350: the element. L3351 L3352 L3353 L3354Return value: L3355 L3356 L3357 L3358label of the element. L56750MCF( L3359 L3360rV L9834+) L3361 L3362TtaIsConstant L3363* L3364 L3365 L3366RP+ L3367Indicates whether an element type is a constant. L20928 L20929CF L20930 L20931TPFHRP+ L20932FRint TtaIsConstant(ElementType elementType) L3374 L3375 L3376 L3377Parameter: L3378 L3379 L3380RP- L3381elementType L3382: type to be tested. L3383 L3384 L3385 L3386Return value: L3387 L3388 L3389 L33901 = the type is a constant, 0 = the type is not a constant.( L3391 L3392rV L9838+) L3393 L3394TtaIsLeaf L3395* L3396 L3397 L3398RP+ L3399Indicates whether an element type is a leaf. L20936 L20937CF L20938 L20939TPFHRP+ L20940FRint TtaIsLeaf(ElementType elementType) L3406 L3407 L3408 L3409Parameter: L3410 L3411 L3412RP- L3413elementType L3414: type to be tested. L3415 L3416 L3417 L3418Return value: L3419 L3420 L3421 L34221 if the type is a leaf, 0 if the type is not a leaf.( L3425 L3426rV L9842 +) L3427 L3428TtaGetConstructOfType L3429* L3430 L3431 L3432RP+ L3433Returns the construct of an element type. L20944 L20945CF L20946 L20947TPFHRP+ L20948FRConstruct TtaGetConstructOfType(ElementType elementType) L3440 L3441 L3442 L3443Parameter: L3444 L3445 L3446RP- L3447elementType L3448: the element type of interest. L56751NCF L3449 L3450 L3451 L3452Return value: L3453 L3454 L3455 L3456the construct that defines the structure of that element type.( L3457 L3458rV L9846+) L3459 L3460TtaGetConstruct L3461* L3462 L3463 L3464RP+ L3465Returns the construct of an element. L20952 L20953CF L20954 L20955TPFHRP+ L20956FRConstruct TtaGetConstruct(Element element) L3472 L3473 L3474 L3475Parameter: L3476 L3477 L3478RP- L3479element L3480: the element of interest. L3481 L3482 L3483 L3484Return value: L3485 L3486 L3487 L3488the construct that defines the structure of that element.( L3489 L3490rV L9850+) L3491 L3492TtaGetAccessRight L3493* L3494 L3495 L3496RP+ L3497Returns the access rights for a given element. L20960 L20961CF L20962 L20963TPFHRP+ L20964AccessRight TtaGetAccessRight(Element element) L3504 L3505 L3506 L3507Parameter: L3508 L3509 L3510RP- L3511element L3512: the element. L3513 L3514 L3515 L3516Return Value: L3517 L3518 L3519 L3520access right for that element (ReadOnly, ReadWrite, Hidden, Inherited).( L3521 L3522rV L9854+) L3523 L3524TtaIsHolophrasted L3525* L3526 L3527 L3528RP+ L3529Tests whether a given element is holphrasted or not. L20968 L20969CF L20970 L20971TPFHRP+ L20972FRint TtaIsHolophrasted(Element element) L56752OCF L3536 L3537 L3538 L3539Parameter: L3540 L3541 L3542RP- L3543element L3544: the element to be tested. L3546 L3547 L3548 L3549Return Value: L3550 L3551 L3552 L35531 if the element is holphrasted, 0 if not.( L3554FR L3555rV L9858+) L3556 L3557TtaIsReadOnly L3558* L3559 L3560 L3561RP+ L3562Tests whether a given element is protected against user modifications (ReadOnly). L20976 L20977CF L20978 L20979TPFHRP+ L20980int TtaIsReadOnly(Element element) L3569 L3570 L3571 L3572Parameter: L3573 L3574 L3575RP- L3576element L3577: the element to be tested. L3578 L3579 L3580 L3581Return Value: L3582 L3583 L3584 L35851 if the element is protected, 0 if not.( L3586FR L3587rV L9862+) L3588 L3589TtaIsHidden L3590* L3591 L3592 L3593RP+ L3594Tests whether a given element is hidden to the user (Hidden). L20984 L20985CF L20986 L20987TPFHRP+ L20988int TtaIsHidden(Element element) L3601 L3602 L3603 L3604Parameter: L3605 L3606 L3607RP- L3608element L3609: the element to be tested. L3610 L3611 L3612 L3613Return Value: L3614 L3615 L3616 L36171 if the element is hidden, 0 if not. L56753PCF( L3618FR L3619rV L9866+) L3620 L3621TtaIsInAnInclusion L3622* L3623 L3624 L3625RP+ L3626Tests whether a given element is (in) an included element. An included element is a "live" copy of another element. L20992 L20993CF L20994 L20995TPFHRP+ L20996int TtaIsInAnInclusion(Element element) L3633 L3634 L3635 L3636Parameter: L3637 L3638 L3639RP- L3640element L3641: the element to be tested. L3642 L3643 L3644 L3645Return Value: L3646 L3647 L3648 L36491 if the element is included, 0 if not.( L3651 L3652rV L9870+) L3653 L3654TtaIsAncestor L3655* L3656 L3657 L3658RP+ L3659Tests if an element is an ancestor of another element. L21000 L21001CF L21002 L21003TPFHRP+ L21004int TtaIsAncestor(Element element, Element ancestor) L3668 L3669 L3670 L3671Parameters: L3672 L3673 L3674RP- L3675element L3676: an element. L3677 L3678RP- L3679ancestor L3680: the supposed ancestor of element. L3681 L3682 L3683 L3684Return value: L3685 L3686 L3687 L36881 if ancestor in an ancestor of element, 0 if not.( L3689 L3690rV L9874+) L3691 L3692TtaIsBefore L3693* L3694 L3695 L3696RP+ L3697Tests if an element precedes another element in the preorder traversal of the tree. L21008 L21009CF L21010 L21011TPFHRP+ L21012FRint TtaIsBefore(Element element1, Element element2) L56754QCF L3706 L3707 L3708 L3709Parameters: L3710 L3711 L3712RP- L3713element1 L3714: the first element. L3715 L3716RP- L3717element2 L3718: the second element. L3719 L3720 L3721 L3722Return value: L3723 L3724 L3725 L37261 if the first element precedes the second element, 0 if not.( L3727 L3728rV L9878+) L3729 L3730TtaIsFirstPairedElement L3731* L3732 L3733 L3734RP+ L3735Indicates if a given paired element is the first or the second of the pair. L21016 L21017CF L21018 L21019TPFHRP+ L21020int TtaIsFirstPairedElement(Element element) L3742 L3743 L3744 L3745Parameter: L3746 L3747 L3748RP- L3749element L3750: the paired element. L3751 L3752 L3753 L3754Return value: L3755 L3756 L3757 L37581 if it is the first element of the pair, 0 if it is the second.( L32216 L32296rV L32297+) L32218 L32219TtaCanInsertSibling L32303* L32221 L32222 L32223RP+ L32224Checks whether an element of a given type can be inserted in an abstract tree as an immediate sibling of an existing element. L32225 L32226CF L32227 L32228TPFHRP+ L32229boolean TtaCanInsertSibling(ElementType elementType, Element sibling, boolean before, Document document) L32230 L32231 L32232 L32233Parameter: L32234 L32235 L32236RP- L32237elementType L32238: the element type to be checked. L32247RP- L32248sibling L32249: an existing element which is part of an abstract tree. L32250RP- L32251before L32252: if True, checks if insertion is allowed before element "sibling".If False, checks if insertion is allowed after element "sibling". L32253RP- L32254document L32255: the document to which element "sibling" belongs. L56755RCF L32239 L32240 L32241 L32242Return value: L32243 L32244 L32245 L32246True if that element type can be inserted, False if the structure schema does not allow that insertion.( L32256 L32304rV L32305+) L32258 L32259TtaCanInsertFirstChild L32311* L32261 L32262 L32263RP+ L32264Checks whether an element of a given type can be inserted in an abstract tree as the first child of an existing element (parent). L32265 L32266CF L32267 L32268TPFHRP+ L32269boolean TtaCanInsertFirstChild(ElementType elementType, Element parent, Document document) L32270 L32271 L32272 L32273Parameter: L32274 L32275 L32276RP- L32277elementType L32278: the element type to be checked. L32279RP- L32280parent L32281: an existing element which is part of an abstract tree. L32285RP- L32286document L32287: the document to which element "parent" belongs. L32288 L32289 L32290 L32291Return value: L32292 L32293 L32294 L32295True if that element type can be inserted, False if the structure schema does not allow that insertion.( L3759 L3760rV L9882+) L3761 L3762TtaGetDocument L3763* L3764 L3765 L3766RP+ L3767Returns the document containing a given element L21024 L21025CF L21026 L21027TPFHRP+ L21028FRDocument TtaGetDocument(Element element) L3775 L3776 L3777 L3778Parameters: L3779 L3780 L3781RP- L3782element L3783: the element for which document is asked. L3784 L3785 L3786 L3787Return value: L3788 L3789 L3790 L3791the document containing that element or 0 if the element does not belong to any document. L56756SCF( L3792FR L3793rV L9886+) L3794 L3795TtaNextCopiedElement L3796* L3797 L3798 L3799RP+ L3800Returns one of the elements that have been copied into the ``clipboard'' by the last Copy or Cut command. (This function is available only in the ThotEditor library). L21032 L21033CF L21034 L21035TPFHRP+ L21036void TtaNextCopiedElement(Element *element) L3807 L3808 L3809 L3810Parameter: L3811 L3812 L3813RP- L3814element L3815: NULL if the first element of the clipboard is asked; an element of the clipboard if the next one is asked. L3816 L3817 L3818 L3819Return parameter: L3820 L3821 L3822RP- L3823element L3824: the asked element if it exists, or NULL if there is no next element in the clipboard or if the clipboard is empty.( L3825FR L3826rV L9890+) L3827 L3828TtaGetCopiedDocument L3829* L3830 L3831 L3832RP+ L3833Returns the document from which the current content of the clipboard has been copied or cut. (This function is available only in the ThotEditor library). L21040 L21041CF L21042 L21043TPFHRP+ L21044Document TtaGetCopiedDocument() L3838 L3839 L3840 L3841Parameters: L3842 L3843 L3844 L3845No parameter. L3846 L3847 L3848 L3849Return value: L3850 L3851 L3852 L3853the document from which the current content of the clipboard has been copied or cut; 0 if the clipboard is empty. L56757TCF( L3854) L3855 L3856Locators' L3857( L3858 L3859rV L9894+) L3860 L3861TtaSearchTypedElement L3862* L3863 L3864 L3865RP+ L3866Returns the first element of a given type. Searching can be done in a tree or starting from a given element towards the beginning or the end of the abstract tree. L21048 L21049CF L21050 L21051TPFHRP+ L21052FRElement TtaSearchTypedElement(ElementType searchedType, SearchDomain scope, Element element) L3878 L3879 L3880 L3881Parameters: L3882 L3883 L3884RP- L3885searchedType L3886: type of element to be searched. If searchedType.ElSSchema is NULL, searchedType must be a basic type ; then the next basic element of that type will be returned, whatever its structure schema. L3887 L3888RP- L3889scope L3890: SearchForward, SearchBackward or SearchInTree. L3891 L3892RP- L3893element L3894: the element that is the root of the tree (if scope = SearchInTree) or the starting element (if scope = SearchForward or SearchBackward). L3895 L3896 L3897 L3898Return value: L3899 L3900 L3901 L3902the element found, or NULL if no element has been found.( L3903 L3904rV L9898+) L3905 L3906TtaSearchElementByLabel L3907* L3908 L3909 L3910RP+ L3911Searches the element that has a given label. The search is done in a given tree. L21056 L21057CF L21058 L21059TPFHRP+ L21060Element TtaSearchElementByLabel(char *searchedLabel, Element element) L3920 L3921 L3922 L3923Parameters: L3924 L3925 L3926RP- L3927searchedLabel L3928: label of element to be searched. L3929 L3930RP- L3931element L3932: the element that is the root of the tree in which the search is done. L3933 L3934 L3935 L3936Return value: L3937 L3938 L3939 L3940the element found, or NULL if no element has been found. L56758UCF( L3941 L3942rV L9902+) L3943 L3944TtaSearchEmptyElement L3945* L3946 L3947 L3948RP+ L3949Searches the next empty element. An empty element is either a compound element without child or a leaf without content. Searching can be done in a tree or starting from a given element towards the beginning or the end of the abstract tree. L21064 L21065CF L21066 L21067TPFHRP+ L21068FRElement TtaSearchEmptyElement(SearchDomain scope, Element element) L3959 L3960 L3961 L3962Parameters: L3963 L3964 L3965RP- L3966scope L3967: SearchForward, SearchBackward or SearchInTree. L3968 L3969RP- L3970element L3971: the element that is the root of the tree (if scope = SearchInTree) or the starting element (if scope = SearchForward or SearchBackward). L3972 L3973 L3974 L3975Return values: L3976 L3977 L3978 L3979the element found, or NULL if not found.( L3980 L3981rV L9906+) L3982 L3983TtaSearchOtherPairedElement L3984* L3985 L3986 L3987RP+ L3988Returns the element that is part of the same pair as a given element. L21072 L21073CF L21074 L21075TPFHRP+ L21076Element TtaSearchOtherPairedElement(Element element) L3995 L3996 L3997 L3998Parameter: L3999 L4000 L4001RP- L4002element L4003: the element whose paired element is searched. L4004 L4005 L4006 L4007Return value: L4008 L4009 L4010 L4011the paired element. L56759VCF( L4012 L4013rV L9910+) L4014 L4015TtaSearchNoPageBreak L4016* L4017 L4018 L4019RP+ L4020Returns the first sibling element that is not a page break. L21080 L21081CF L21082 L21083TPFHRP+ L21084FRElement TtaSearchNoPageBreak(Element element, boolean forward) L4029 L4030 L4031 L4032Parameter: L4033 L4034 L4035RP- L4036element L4037: the element. L4038 L4039RP- L4040forward L4041: True for skipping the next page breaks, False for skipping the previous ones. L4042 L4043 L4044 L4045Return value: L4046 L4047 L4048 L4049the first sibling element, or NULL if there are only page breaks.( L4050) L4051 L4052Help' L4053( L4054 L4055rV L9914+) L4056 L4057TtaListAbstractTree L4058* L4059 L4060 L4061RP+ L4062Produces in a file a human-readable form of an abstract tree. L21088 L21089CF L21090 L21091TPFHRP+ L21092void TtaListAbstractTree(Element root, FILE *fileDescriptor) L4072 L4073 L4074 L4075Parameters: L4076 L4077 L4078RP- L4079root L4080: the root element of the tree to be listed. L4081 L4082RP- L4083fileDescriptor L4084: file descriptor of the file that will contain the list. This file must be open when calling the function. L22179WUF( L4085) L4086 L4087Contents* L4088 L4089 L4090 L4091The functions described in this section require that file  L4092content.h L4093 be included in the module that calls them.' L4094( L4095) L4096 L4097Modificators' L4098( L4099 L4100rV L9918+) L4101 L4102TtaSetTextContent L4103* L4104 L4105 L4106RP+ L4107Changes the content of a Text basic element. The full content (if any) is deleted and replaced by the new one. This function can also be used for changing the content (the file name) of a Picture basic element. L21096 L21097CF L21098 L21099TPFHRP+ L21100void TtaSetTextContent(Element element, char *content, Language language, Document document) L4120 L4121 L4122 L4123Parameters: L4124 L4125 L4126RP- L4127element L4128: the Text element to be modified. L4129 L4130RP- L4131content L4132: new content for that element. L4133 L4134RP- L4135language L4136: language of that Text element (see section > L4137rV L6125 L4138). L4139 L4140RP- L4141document L4142: the document containing that element.( L4143 L4144rV L9922+) L4145 L4146TtaAppendTextContent L4147* L4148 L4149 L4150RP+ L4151Appends a character string at the end of a Text basic element. L21104 L21105CF L21106 L21107TPFHRP+ L21108FRvoid TtaAppendTextContent(Element element, char *content, Document document) L4163 L4164 L4165 L4166Parameters: L4167 L4168 L4169RP- L4170element L4171: the Text element to be modified. L4172 L4173RP- L4174content L4175: the character string to be appended. L4176 L4177RP- L4178document L4179: the document containing that element. L56760XCF( L4180 L4181rV L9926+) L4182 L4183TtaInsertTextContent L4184* L4185 L4186 L4187RP+ L4188Inserts a character string in a text basic element. L21112 L21113CF L21114 L21115TPFHRP+ L21116void TtaInsertTextContent(Element element, int position, char *content, Document document) L4201 L4202 L4203 L4204Parameters: L4205 L4206 L4207RP- L4208element L4209: the Text element to be modified. L4210 L4211RP- L4212position L4213: rank of the character after which the new string must be inserted. 0 for inserting before the first character. L4214 L4215RP- L4216content L4217: the character string to be inserted. L4218 L4219RP- L4220document L4221: the document containing the text element.( L4222 L4223rV L9930+) L4224 L4225TtaDeleteTextContent L4226* L4227 L4228 L4229RP+ L4230Deletes a character string in a text basic element. L21120 L21121CF L21122 L21123TPFHRP+ L21124void TtaDeleteTextContent(Element element, int position, int length, Document document) L4243 L4244 L4245 L4246Parameters: L4247 L4248 L4249RP- L4250element L4251: the Text element to be modified. L4252 L4253RP- L4254position L4255: rank of the first character to be deleted. L4256 L4257RP- L4258length L4259: length of the character string to be deleted. L4260 L4261RP- L4262document L4263: the document containing the text element. L56761YCF( L4265 L4266rV L9934+) L4267 L4268TtaSplitText L4269* L4270 L4271 L4272RP+ L4273Divides a text element into two elements. L21128 L21129 L21130 L21131TPFHRP+ L21132FRvoid TtaSplitText(Element element, int position, Document document) L4284 L4285 L4286 L4287Parameters: L4288 L4289 L4290RP- L4291element L4292: the text element to be divided. A new text element containing the second part of the text is created as the next sibling. L4293 L4294RP- L4295position L4296: rank of the character after which the element must be cut. L4297 L4298RP- L4299document L4300: the document to which the element belongs.( L4301 L4302rV L9938+) L4303 L4304TtaMergeText L4305* L4306 L4307 L4308RP+ L4309Merges two text elements. L21136 L21137 L21138 L21139TPFHRP+ L21140void TtaMergeText(Element element, Document document) L4310 L4311 L4312 L4313void TtaMergeText(element, document) L4314 L4315Element element; L4316 L4317Document document; L4318 L4319 L4320 L4321Parameters: L4322 L4323 L4324RP- L4325element L4326: the first text element. Merging occurs only if L4327 L4328 L4329the next sibling is a text element with the same attributes. L4330 L4331RP- L4332document L4333: the document to which the text element belongs. L4334 L4335 L4336 L4337Return value: L4338 L4339 L4340 L4341True if successful.. L56762ZCF( L4342 L4343rV L9942+) L4344 L4345TtaSetGraphicsShape L4346* L4347 L4348 L4349RP+ L4350Changes the shape of a Graphics or Symbol basic element. L21144 L21145 L21146 L21147TPFHRP+CF L21148 void TtaSetGraphicsShape(Element element, char shape, Document document) L4361 L4362 L4363 L4364Parameters: L4365 L4366 L4367RP- L4368element L4369: the element to be changed. This element must be a basic element of type Graphics or Symbol. L4370 L4371RP- L4372shape L4373: new shape for that element. L4374 L4375RP- L4376document L4377: the document containing that element.( L4379 L4380rV L9946+) L4381 L4382TtaAddPointInPolyline L4383* L4384 L4385 L4386RP+ L4387Adds a new point in a Polyline basic element. L21152 L21153 L21154 L21155TPFHRP+ L21156FRvoid TtaAddPointInPolyline(Element element, int rank, TypeUnit unit, int x, int y, Document document) L4400 L4401 L4402 L4403Parameters: L4404 L4405 L4406RP- L4407element L4408: the element to be changed. This element must be a basic element of type Polyline. L4409 L4410RP- L4411rank L4412: rank of the new point to be inserted. If rank is greater than the actual number of points, the new point is appended. rank must be strictly positive. L33720 L33721unit L33722: the absolute unit (UnPixel or UnPoint) used for the values. L4413 L4414 L4415x, y: coordinate of the new point, in units, relatively to the upper left corner of the box. x and y must be positive or null. L4416 L4417RP- L4418document L4419: the document containing the polyline element. L53424CF L56763[CF( L4420 L4421rV L9950+) L4422 L4423TtaDeletePointInPolyline L4424* L4425 L4426 L4427RP+ L4428Deletes a point in a Polyline basic element. L21160 L21161 L21162 L21163TPFHRP+ L21164 void TtaDeletePointInPolyline(Element element, int rank, Document document) L4439 L4440 L4441 L4442Parameters: L4443 L4444 L4445RP- L4446element L4447: the element to be changed. This element must be a basic element of type Polyline. L4448 L4449RP- L4450rank L4451: rank of the point to be deleted. If rank is greater than the actual number of points, the last point is deleted. rank must be strictly positive. L4452 L4453RP- L4454document L4455: the document containing the polyline element.( L4456 L4457rV L9954+) L4458 L4459TtaModifyPointInPolyline L4460* L4461 L4462 L4463RP+ L4464Changes the coordinates of a point in a Polyline basic element. L21168 L21169 L21170 L21171TPFHRP+ L21172FRvoid TtaModifyPointInPolyline(Element element, int rank, TypeUnit unit, int x, int y, Document document) L4478 L4479 L4480 L4481Parameters: L4482 L4483 L4484RP- L4485element L4486: the element to be changed. This element must be a basic element of type Polyline. L4487 L4488RP- L4489rank L4490: rank of the point to be modified. If rank is greater than the actual number of points, the last point is changed. rank must be strictly positive. L33723 L33724unit L33725: the absolute unit (UnPixel or UnPoint) used for the values. L4491 L4492 L4493x, y: new coordinates of the point, in units, relatively to the upper left corner of the enclosing rectangle. x and y must be positive or null. L4494 L4495RP- L4496document L4497: the document containing the polyline element. L56764\CF( L4498 L4499rV L9958+) L4500 L4501TtaChangeLimitOfPolyline L4502* L4503 L4504 L4505RP+ L4506Changes the coordinates of the lower left corner of the box containing a Polyline basic element. L21176 L21177 L21178 L21179TPFHRP+ L21180 void TtaChangeLimitOfPolyline(Element element, TypeUnit unit, int x, int y, Document document) L4517 L4518 L4519 L4520Parameters: L4521 L4522 L4523RP- L4524element L4525: the element to be changed. This element must be a basic element of type Polyline. L33726 L33727unit L33728: the absolute unit (UnPixel or UnPoint) used for the values. L4526 L4527 L4528x, y: new coordinates of the lower left corner, in units, relatively to the upper left corner of the box. x and y must be positive or null and the box must contain all points of the polyline. L4529 L4530RP- L4531document L4532: the document containing the polyline element.( L4533 L4534rV L9962+) L4535 L4536TtaCopyPage L4537* L4538 L4539 L4540RP+ L4541Copies the page element source into the page element destination. Both page elements must be in an abstract tree. L21184 L21185 L21186 L21187TPFHRP+ L21188FRvoid TtaCopyPage(Element destination, Element source) L4551 L4552 L4553 L4554Parameters: L4555 L4556 L4557RP- L4558destination L4559: identifier of the page element to be modified. L4560 L4561RP- L4562source L4563: identifier of the source page element. L56765]CF( L4565) L4566 L4567Accessors' L4568( L34350) L34351 L34352TtaGetPictureType* L34353 L34354 L34355RP+ L34356Returns the type of Picture element. The type is one of the following values: xbm_type, eps_type, xpm_type, gif_type, jpeg_type, png_type, unknow_type. L34357 L34358 L34359 L34360TPFHRP+ L34361PicType TtaGetPictureType(Element element) L34362 L34363 L34364 L34365Parameter: L34366 L34367 L34368RP- L34369element L34370: the element of interest. This element must be a picture element. L34371 L34372 L34373 L34374Return value: L34375 L34376 L34377 L34378The type of the element.( L4569 L4570rV L9966+) L4571 L4572TtaGetTextLength L4573* L4574 L4575 L4576RP+ L4577Returns the length of a Text basic element. L21192 L21193 L21194 L21195TPFHRP+ L21196int TtaGetTextLength(Element element) L4584 L4585 L4586 L4587Parameter: L4588 L4589 L4590RP- L4591element L4592: the element of interest. This element must be a basic element of type Text. L4593 L4594 L4595 L4596Return value: L4597 L4598 L4599 L4600length (number of characters) of the character string contained in the element. The null character terminating a C string is not counted. L56766^CF( L4601 L4602rV L9970+) L4603 L4604TtaGiveTextContent L4605* L4606 L4607 L4608RP+ L4609Returns the content of a Text basic element. L21200 L21201CF L21202 L21203TPFHRP+ L21204FRvoid TtaGiveTextContent(Element element, char *buffer, int *length, Language *language) L4622 L4623 L4624 L4625Parameters: L4626 L4627 L4628RP- L4629element L4630: the element of interest. This element must be a basic element of type Text. L4631 L4632RP- L4633buffer L4634: the buffer that will contain the text. L4635 L4636RP- L4637length L4638: maximum length of that buffer. L4639 L4640 L4641 L4642Return parameters: L4643 L4644 L4645RP- L4646buffer L4647: (the buffer contains the text, including the terminating null character). L4649 L4650RP- L4651length L4652: actual length of the text in the buffer, excluding the null character terminating the string. L4653 L4654RP- L4655language L4656: language of the text (see section > L4657rV L6125 L4658).( L4659 L4660rV L9974+) L4661 L4662TtaGiveSubString L4663* L4664 L4665 L4666RP+ L4667Returns a substring from a Text basic element. L21208 L21209CF L21210 L21211TPFHRP+ L21212FRvoid TtaGiveSubString(Element element, char *buffer, int position, int length) L4680 L4681 L4682 L4683Parameters: L4684 L4685 L4686RP- L4687element L4688: the element of interest. This element must be a basic element of type Text. L4689 L4690RP- L4691buffer L4692: the buffer that will contain the substring. This buffer must be at least of size length. L56767_CF L4693 L4694RP- L4695position L4696: the rank of the first character of the substring. rank must be strictly positive. L4697 L4698RP- L4699length L4700: the length of the substring. Must be strictly positive. L4701 L4702 L4703 L4704Return parameter: L4705 L4706 L4707RP- L4708buffer L4709: (the buffer contains the substring).( L4710 L4711rV L9978+) L4712 L4713TtaGetGraphicsShape L4714* L4715 L4716 L4717RP+ L4718Returns the content of a Graphics or Symbol basic element. L21216 L21217 L21218 L21219TPFHRP+ L21220 char TtaGetGraphicsShape(Element element) L4725 L4726 L4727 L4728Parameter: L4729 L4730 L4731RP- L4732element L4733: the element of interest. This element must be a basic element of type Graphics or Symbol. L4734 L4735 L4736 L4737Return value: L4738 L4739 L4740 L4741a single character representing the shape of the graphics element or symbol contained in the element.( L4743 L4744rV L9982+) L4745 L4746TtaGetPolylineLength L4747* L4748 L4749 L4750RP+ L4751Returns the number of points in a Polyline basic element. L21224 L21225 L21226 L21227TPFHRP+ L21228FRint TtaGetPolylineLength(Element element) L4758 L4759 L4760 L4761Parameter: L4762 L4763 L4764RP- L4765element L4766: the Polyline element. This element must be a basic element of type Polyline. L56768`CF( L4767 L4768rV L9986+) L4769 L4770TtaGivePolylinePoint L4771* L4772 L4773 L4774RP+ L4775Returns the coordinates of a point in a Polyline basic element. L21232 L21233 L21234 L21235TPFHRP+ L21236 void TtaGivePolylinePoint(Element element, int rank, TypeUnit unit, int *x, int *y) L4788 L4789 L4790 L4791Parameters: L4792 L4793 L4794RP- L4795element L4796: the Polyline element. This element must be a basic element of type Polyline. L4797 L4798RP- L4799rank L4800: rank of the point in the PolyLine. If rank is greater than the actual number of points, an error is raised. rank must be strictly positive. L33729 L33730unit L33731: the absolute unit (UnPixel or UnPoint) used for the values. L4801 L4802 L4803 L4804Return values: L4805 L4806 L4807 L4808x, y: coordinates of the point, in units, relatively to the upper left corner of the enclosing rectangle.( L4809 L4810rV L9990+) L4811 L4812TtaGetPageNumber L4813* L4814 L4815 L4816RP+ L4817Returns the page number of a Page basic element. L21240 L21241 L21242 L21243TPFHRP+ L21244FRint TtaGetPageNumber(Element pageElement) L4824 L4825 L4826 L4827Parameter: L4828 L4829 L4830RP- L4831pageElement L4832: the page element. L4833 L4834 L4835 L4836Return value: L4837 L4838 L4839 L4840page number of that page element. L56769aCF( L4841 L4842rV L9994+) L4843 L4844TtaGetPageView L4845* L4846 L4847 L4848RP+ L4849Returns the view corresponding to a Page basic element. L21248 L21249 L21250 L21251TPFHRP+ L21252int TtaGetPageView(Element pageElement) L4857 L4858 L4859 L4860Parameter: L4861 L4862 L4863RP- L4864pageElement L4865: the page element. L4866 L4867 L4868 L4869Return value: L4870 L4871 L4872 L4873view of that page. L22309bUF( L4874) L4875 L4876Logical attributes* L4877 L4878 L4879 L4880The functions described in this section require that file  L4881attribute.h L4882 be included in the module that calls them. L4883 L4884 L4885When creating or searching attributes in an abstract tree, the type of the concerned attributes must be given. As presented in section > L4886rV L398 L4887, an attribute type contains an attribute number, but this number does not appear explicitly in a structure schema: it is generated by the schema compiler. For obtaining all attribute numbers of a structure schema, use the command: L4888 printsch -h SchemaName L4889which lists on the standard output a file that can be included into a C program. L4890 L4891 L4892When a new attribute is created (function  L4893rV L9998+ L4894TtaNewAttribute L4895 L4896), it must be attached (function  L4897rV L10002+ L4898TtaAttachAttribute L4899 L4900) to an element which is itself part of an abstract tree of a document, before any other action can be performed on that attribute.' L4901( L4902) L4903 L4904Constructors' L4905( L4906 L4907rV L10006+) L4908 L4909TtaNewAttribute L4910* L4911 L4912 L4913RP+ L4914Creates an attribute that will be attached to an element. L21256 L21257 L21258 L21259TPFHRP+ L21260Attribute TtaNewAttribute(AttributeType attributeType) L4921 L4922 L4923 L4924Parameter: L4925 L4926 L4927RP- L4928attributeType L4929: type of the attribute to be created. L4930 L4931 L4932 L4933Return value: L4934 L4935 L4936 L4937the attribute that has been created. L56770cCF( L4939 L4940rV L10010+) L4941 L4942TtaAttachAttribute L4943* L4944 L4945 L4946RP+ L4947Attaches an attribute to an element. L21264 L21265CF L21266 L21267TPFHRP+ L21268FRvoid TtaAttachAttribute(Element element, Attribute attribute, Document document) L4958 L4959 L4960 L4961Parameters: L4962 L4963 L4964RP- L4965element L4966: the element to which the attribute has to be attached. L4967 L4968RP- L4969attribute L4970: the attribute to be attached. L4971 L4972RP- L4973document L4974: the document to which the element belongs.( L4975 L4976rV L10014+) L4977 L4978TtaRemoveAttribute L4979* L4980 L4981 L4982RP+ L4983Removes an attribute from an element and release that attribute. L21272 L21273CF L21274 L21275TPFHRP+ L21276void TtaRemoveAttribute(Element element, Attribute attribute, Document document) L4994 L4995 L4996 L4997Parameters: L4998 L4999 L5000RP- L5001element L5002: the element with which the attribute is associated. L5003 L5004RP- L5005attribute L5006: the attribute to be removed. L5007 L5008RP- L5009document L5010: the document to which the element belongs.( L5011) L5012 L5013Modificators' L5014( L5015 L5016rV L10018+) L5017 L5018TtaSetAttributeValue L5019* L5020 L5021 L5022RP+ L5023Changes the value of an attribute of type integer or enumerate. L21280 L21281CF L21282 L21283TPFHRP+ L21284FRvoid TtaSetAttributeValue(Attribute attribute, int value, Element element, Document document) L56771dCF L5036 L5037 L5038 L5039Parameters: L5040 L5041 L5042RP- L5043attribute L5044: the attribute to be modified. L5045 L5046RP- L5047value L5048: new value of the attribute. L5049 L5050RP- L5051element L5052: the element with which the attribute is associated, NULL if the attribute is not yet associated with an element. L5054 L5055RP- L5056document L5057: the document to which the element belongs. Must be 0 if element is NULL.( L5058 L5059rV L10022+) L5060 L5061TtaSetAttributeText L5062* L5063 L5064 L5065RP+ L5066Changes the value of an attribute of type text. L21288 L21289CF L21290 L21291TPFHRP+ L21292void TtaSetAttributeText(Attribute attribute, char *buffer, Element element, Document document) L5079 L5080 L5081 L5082Parameters: L5083 L5084 L5085RP- L5086attribute L5087: the attribute to be modified. L5088 L5089RP- L5090buffer L5091: character string representing the new value of the attribute. L5092 L5093RP- L5094element L5095: the element with which the attribute is associated, NULL if the attribute is not yet associated with an element. L5096 L5097RP- L5098document L5099: the document to which the element belongs. Must be 0 if element is NULL.( L5100) L5101 L5102Accessors' L5103( L5104 L5105rV L10026+) L5106 L5107TtaNextAttribute L5108* L5109 L5110 L5111RP+ L5112Returns the first attribute associated with a given element (if attribute is NULL) or the attribute that follows a given attribute of a given element. L21296 L21297 L21298 L21299TPFHRP+ L21300void TtaNextAttribute(Element element, Attribute *attribute) L56772eCF L5121 L5122 L5123 L5124Parameters: L5125 L5126 L5127RP- L5128element L5129: the element of interest. L5130 L5131RP- L5132attribute L5133: an attribute of that element, or NULL if the first attribute is asked. L5134 L5135 L5136 L5137Return parameter: L5138 L5139 L5140RP- L5141attribute L5142: the next attribute, or NULL if attribute is the last attribute of the element.( L5144 L5145rV L10030+) L5146 L5147TtaGetAttribute L5148* L5149 L5150 L5151RP+ L5152Returns an attribute of a given type associated with a given element. L21304 L21305CF L21306 L21307TPFHRP+ L21308FRAttribute TtaGetAttribute(Element element, AttributeType attributeType) L5161 L5162 L5163 L5164Parameters: L5165 L5166 L5167RP- L5168element L5169: the element of interest. L5170 L5171RP- L5172attributeType L5173: type of the desired attribute.. If the attribute "Language" is searched, attributeType.AttrTypeNum must be 1. If the attribute "Language" is searched whatever its structure schema, attributeType.AttrSSchema must be NULL. A NULL attributeType.AttrSSchema is accepted only when an attribute "Language" is searched. L5174 L5175 L5176 L5177Return value: L5178 L5179 L5180 L5181the attribute found, or NULL if the element does not have this type of attribute.( L5182 L5183rV L10034+) L5184 L5185TtaGiveAttributeType L5186* L5187 L5188 L5189RP+ L5190Returns the type of a given attribute. L21312 L21313CF L21314 L21315TPFHRP+ L21316void TtaGiveAttributeType(Attribute attribute, AttributeType attributeType, int *attrKind) L56773fCF L5201 L5202 L5203 L5204Parameter: L5205 L5206 L5207RP- L5208attribute L5209: the attribute of interest. L5210 L5211 L5212 L5213Return parameters: L5214 L5215 L5216RP- L5217attributeType L5218: type of the attribute. L5219 L5220RP- L5221attrKind L5222: kind of the attribute: 0 = Enumerate, 1 = Integer, 2 = Text, 3 = Reference( L5223 L5224rV L10038+) L5225 L5226TtaGiveAttributeTypeFromName L5227* L5228 L5229 L5230RP+ L5231Retrieves the type of an attribute from its name. L21320 L21321CF L21322 L21323TPFHRP+ L21324FRvoid TtaGiveAttributeTypeFromName(char *name, Element element, AttributeType *attributeType, int *attrKind) L5245 L5246 L5247 L5248Parameter: L5249 L5250 L5251RP- L5252name L5253: name of the attribute. L5254 L5255RP- L5256element L5257: the element with which the attribute is associated. L5258 L5259 L5260 L5261Return parameters: L5262 L5263 L5264RP- L5265attributeType L5266: type of the attribute. L5267 L5268RP- L5269attrKind L5270: kind of the attribute: 0 = Enumerate, 1 = Integer, 2 = Text, 3 = Reference( L56927 L56928rV L10038 + ) L56929 L56930TtaGiveAttributeTypeFromOriginalName L56931 * L56932 L56933 L56934RP+ L56935Retrieves the type of an attribute from its original name (in the language it is defined in the structure schema). L56936 L56937CF L56938 L56939TPFHRP+ L56940FRvoid TtaGiveAttributeTypeFromOriginalName(char *name, Element element, AttributeType *attributeType, int *attrKind) L56941 L56942 L56943 L56944Parameter: L56945 L56946 L56947RP- L56948name L56949: original name of the attribute. L56950 L56951RP- L56952element L56953: the element with which the attribute is associated. L56954 L56955 L56956 L56957Return parameters: L56958 L56959 L56960RP- L56961attributeType L56962: type of the attribute. L56963 L56964RP- L56965attrKind L56966: kind of the attribute: 0 = Enumerate, 1 = Integer, 2 = Text, 3 = Reference( L5271 L5272rV L10042+) L5273 L5274TtaGetAttributeName L5275* L5276 L5277 L5278RP+ L5279Returns the name of an attribute type. L21328 L21329 L21330 L21331TPFHRP+ L21332char *TtaGetAttributeName(AttributeType attributeType) L5286 L5287 L5288 L5289Parameter: L5290 L5291 L5292RP- L5293attributeType L5294: type of the attribute. L56774gCF L5295 L5296 L5297 L5298Return value: L5299 L5300 L5301 L5302name of that type.( L56967 L56968rV L10042 +) L56969 L56970TtaGetAttributeOriginalName L56971* L56972 L56973 L56974RP+ L56975Returns the original name of an attribute type (in the language it is defined in the structure schema). L56976 L56977 L56978 L56979TPFHRP+ L56980char *TtaGetAttributeOriginalName(AttributeType attributeType) L56981 L56982 L56983 L56984Parameter: L56985 L56986 L56987RP- L56988attributeType L56989: type of the attribute. L56990 L56991 L56992 L56993Return value: L56994 L56995 L56996 L56997name of that type.( L5303 L5304rV L10046+) L5305 L5306TtaSameAttributeTypes L5307* L5308 L5309 L5310RP+ L5311Compares two attribute types. L21336 L21337CF L21338 L21339TPFHRP+ L21340FRint TtaSameAttributeTypes(AttributeType type1, AttributeType type2) L5320 L5321 L5322 L5323Parameter: L5324 L5325 L5326RP- L5327type1 L5328: first attribute type. L5329 L5330RP- L5331type2 L5332: second attribute type. L5333 L5334 L5335 L5336Return value: L5337 L5338 L5339 L53400 if both types are different, 1 if they are identical.( L5341 L5342rV L10050+) L5343 L5344TtaGetAttributeValue L5345* L5346 L5347 L5348RP+ L5349Returns the value of a given attribute of type integer or enumerate. L21344 L21345 L21346 L21347TPFHRP+ L21348FRint TtaGetAttributeValue(Attribute attribute) L5357 L5358 L5359 L5360Parameter: L5361 L5362 L5363RP- L5364attribute L5365: the attribute of interest. L5366 L5367 L5368 L5369Return value: L5370 L5371 L5372 L5373Value of that attribute.( L5374 L5375rV L10054+) L5376 L5377TtaGetTextAttributeLength L5378* L5379 L5380 L5381RP+ L5382Returns the length of a given attribute of type text. L21352 L21353 L21354 L21355TPFHRP+ L21356int TtaGetTextAttributeLength(Attribute attribute) L56775hCF L5389 L5390 L5391 L5392Parameter: L5393 L5394 L5395RP- L5396attribute L5397: the attribute of interest. L5398 L5399 L5400 L5401Return values: L5402 L5403 L5404 L5405length of the character string contained in the attribute.( L5406 L5407rV L10058+) L5408 L5409TtaGiveTextAttributeValue L5410* L5411 L5412 L5413RP+ L5414Returns the value of a given attribute of type text. L21360 L21361CF L21362 L21363TPFHRP+ L21364FRvoid TtaGiveTextAttributeValue(Attribute attribute, char *buffer, int *length) L5425 L5426 L5427 L5428Parameters: L5429 L5430 L5431RP- L5432attribute L5433: the attribute of interest. L5434 L5435RP- L5436buffer L5437: address of the buffer that will contain the value of the attribute. L5438 L5439RP- L5440length L5441: size of the buffer (in bytes). L5442 L5443 L5444 L5445Return values: L5446 L5447 L5448RP- L5449buffer L5450: character string representing the value of the attribute. L5451 L5452RP- L5453length L5454: actual length of the character string.( L5455) L5456 L5457Locators' L5458( L5459 L5460rV L10062+) L5461 L5462TtaSearchAttribute L5463* L5464 L5465 L5466RP+ L5467Searches the next element that has a given attribute. Searching can be done in a subtree or starting from a given element towards the beginning or the end of the abstract tree. L21368 L21369CF L21370 L21371TPFHRP+ L21372void TtaSearchAttribute(AttributeType searchedAttribute, SearchDomain scope, Element element, Element *elementFound, Attribute *attributeFound) L56776iCF L5483 L5484 L5485 L5486Parameters: L5487 L5488 L5489RP- L5490searchedAttribute L5491: attribute to be searched. If searchedAttribute.AttrSSchema is NULL, the next element that has an attribute is seached, whatever the attribute. L5492 L5493RP- L5494scope L5495: SearchForward, SearchBackward or SearchInTree. L5496 L5497RP- L5498element L5499: the element that is the root of the tree (if scope = SearchInTree) or the starting element (if scope = SearchForward or SearchBackward). L5500 L5501 L5502 L5503Return parameters: L5504 L5505 L5506RP- L5507elementFound L5508: the element found, or NULL if not found. L5509 L5510RP- L5511attributeFound L5512: the searched attribute, or NULL if not found. L22310jUF( L5513) L5514 L5515References and links* L5516 L5517 L5518 L5519The functions described in this section require that file  L5520reference.h L5521 be included in the module that calls them.' L5522( L5523) L5524 L5525Modificators' L5526( L5527 L5528rV L10066+) L5529 L5530TtaSetReference L5531* L5532 L5533 L5534RP+ L5535Changes (or sets) the target of a reference element. The reference element must be part of an abstract tree. L21376 L21377CF L21378 L21379TPFHRP+ L21380FRvoid TtaSetReference(Element element, Document document, Element target, Document targetDocument) L5549 L5550 L5551 L5552Parameters: L5553 L5554 L5555RP- L5556element L5557: the reference element to be set. L5558 L5559RP- L5560document L5561: the document containing the reference element. L5562 L5563RP- L5564target L5565: the target element (NULL for resetting the reference). L5566 L5567RP- L5568targetDocument L5569: the document containing the target element.( L5570 L5571rV L10070+) L5572 L5573TtaNewInclusion L5574* L5575 L5576 L5577RP+ L5578Creates an inclusion of a given element. L21384 L21385CF L21386 L21387TPFHRP+ L21388 Element TtaNewInclusion(Document document, Element target, Document targetDocument) L5589 L5590 L5591 L5592Parameters: L5593 L5594 L5595RP- L5596document L5597: the document for which the inclusion is created. L5598 L5599RP- L5600target L5601: the element to be included. L5602 L5603RP- L5604targetDocument L5605: the document containing the element to be included. L56777kCF L5606 L5607 L5608 L5609Return value: L5610 L5611 L5612 L5613the created inclusion.( L5614 L5615rV L10074+) L5616 L5617TtaCopyReference L5618* L5619 L5620 L5621RP+ L5622Copies a reference element into another reference element. Both reference elements must be in an abstract tree. L21392 L21393 L21394 L21395TPFHRP+ L21396FRvoid TtaCopyReference(Element element, Element source) L5631 L5632 L5633 L5634Parameters: L5635 L5636 L5637RP- L5638element L5639: the reference element to be set. L5640 L5641RP- L5642source L5643: the element to be copied.( L5644 L5645rV L10078+) L5646 L5647TtaSetAttributeReference L5648* L5649 L5650 L5651RP+ L5652Changes the value of an attribute of type reference L21400 L21401CF L21402 L21403TPFHRP+ L21404FRvoid TtaSetAttributeReference(Attribute attribute, Element element, Document document, Element target, Document targetDocument) L5668 L5669 L5670 L5671Parameters: L5672 L5673 L5674RP- L5675attribute L5676: the attribute to be changed. L5677 L5678RP- L5679element L5680: the element with which the attribute is associated. L5681 L5682RP- L5683document L5684: the document containing the attribute. L5685 L5686RP- L5687target L5688: the target element (NULL for resetting the reference). L5689 L5690RP- L5691targetDocument L5692: the document containing the target element. L53425CF L56778lCF( L5693 L5694rV L10082+) L5695 L5696TtaCopyAttributeReference L5697* L5698 L5699 L5700RP+ L5701Copies the reference attribute source into the reference attribute attribute. Both attributes must be attached to an element in an abstract tree. L21408 L21409CF L21410 L21411TPFHRP+ L21412void TtaCopyAttributeReference(Attribute attribute, Element element, Attribute source) L5712 L5713 L5714 L5715Parameters: L5716 L5717 L5718RP- L5719attribute L5720: the reference attribute to be set. L5721 L5722RP- L5723element L5724: the element to which attribute is attached. L5725 L5726RP- L5727source L5728: the source attribute.( L46817 L46842rV L46843 + ) L46818 L46819TtaCopyIncludedElem L46849 * L46820 L46821 L46822 L46823Up to date the value of inclusion element with the value of its source. L46824 L46825 L46826 L46827FHTPSRRP+ L46828void TtaCopyIncludedElem( Element element, Document document) L46829 L46830 L46831 L46832Parameters L46833 L46834 L46835 L46836SIelement L46837: the element to be up to dated. L46838 L46839 L46840SIdocument L46841: the document that contains the element.( L40347 L43583rV L43584 + ) L40348 L40349TtaUpdateInclusionElements L43590 * L40350 L40351 L40355 L40354Up to date the value of inclusions that belong to the document. L46782 L46781 L46780If loadExternalDoc is TRUE, the inclusions whose the sources belong to another document, are up to date too. In this case, the other documents are opened temporarely. If removeExclusions is TRUE, the exclusions are removed from the documents opened temporarely. L56779mCF L40390 L40392 L40397TPFHRP+ L40398void TtaUpdateInclusionElements(Document document, boolean loadExternalDoc, boolean removeExclusions) L40364 L40366 L40367 L40368Parameters: L40369 L40370 L40374 L40373SIdocument L40375: the document in question. L46774 L46773 L46772SIloadExternalDoc L46778: TRUE if it is necessary to up to date the inclusions whose the sources belong to another (external) document. L46777 L46776 L46775SIremoveExclusions L46779: TRUE if exclusions of external documents have to be removed when these ones are temporarely opened.( L5730) L5731 L5732Accessors' L5733( L5734 L5735rV L10086+) L5736 L5737TtaGiveReferredElement L5738* L5739 L5740 L5741RP+ L5742Returns the element referred by a given reference element. L21416 L21417CF L21418 L21419TPFHRP+ L21420FRvoid TtaGiveReferredElement(Element element, Element *target, char *targetDocumentName, Document *targetDocument) L5755 L5756 L5757 L5758Parameter: L5759 L5760 L5761RP- L5762element L5763: the reference element. L5765 L5766 L5767 L5768Return parameters: L5769 L5770 L5771RP- L5772target L5773: the referred element, or NULL if that element is not accessible (empty reference or referred document not open). L5774 L5775RP- L5776targetDocumentName L5777: name of the document containing the referred element; empty string if the referred element is in the same document as the reference element. L56780nCF L5778 L5779RP- L5780targetDocument L5781: the document containing the referred element; 0 if the document containing the referred element is not loaded or if the referred element is in the same document as the reference element.( L5782 L5783rV L10090+) L5784 L5785TtaIsElementTypeReference L5786* L5787 L5788 L5789RP+ L5790Indicates whether an element type is a reference. L21424 L21425CF L21426 L21427TPFHRP+ L21428int TtaIsElementTypeReference(ElementType elementType) L5797 L5798 L5799 L5800Parameter: L5801 L5802 L5803RP- L5804elementType L5805: type to be tested. L5806 L5807 L5808 L5809Return value: L5810 L5811 L5812 L58131 = the type is a reference, 0 = the type is not a reference.( L5814 L5815rV L10094+) L5816 L5817TtaSameReferences L5818* L5819 L5820 L5821RP+ L5822Compares two reference elements. L21432 L21433CF L21434 L21435TPFHRP+ L21436FRint TtaSameReferences(Element element1, Element element2) L5831 L5832 L5833 L5834Parameters: L5835 L5836 L5837RP- L5838element1 L5839: first reference element. L5840 L5841RP- L5842element2 L5843: second reference element. L5844 L5845 L5846 L5847Return value: L5848 L5849 L5850 L58510 if both references are different, 1 if they are identical. L56781oCF( L5852 L5853rV L10098+) L5854 L5855TtaGiveReferenceAttributeValue L5856* L5857 L5858 L5859RP+ L5860Returns the value of a given attribute of type reference L21440 L21441CF L21442 L21443TPFHRP+ L21444void TtaGiveReferenceAttributeValue(Attributeattribute, Element *target, char *targetDocumentName, Document *targetDocument) L5874 L5875 L5876 L5877Parameter: L5878 L5879 L5880RP- L5881attribute L5882: the attribute of interest. L5883 L5884 L5885 L5886Return parameters: L5887 L5888 L5889RP- L5890target L5891: the element referred by the attribute, or NULL if that element is not accessible (empty reference or referred document not loaded) L5892 L5893RP- L5894targetDocumentName L5895: name of the document containing the referred element; empty string if the referred element is in the same document as the attribute. L5896 L5897RP- L5898targetDocument L5899: the document containing the referred element; 0 if the document containing the referred element is not loaded or if the referred element is in the same document as the attribute.( L5900 L5901rV L10102+) L5902 L5903TtaIsElementReferred L5904* L5905 L5906 L5907RP+ L5908Tells whether a given element is the target of a reference or not. L21448 L21449 L21450 L21451TPFHRP+ L21452int TtaIsElementReferred(Element element) L5915 L5916 L5917 L5918Parameter: L5919 L5920 L5921RP- L5922element L5923: the element. L5924 L5925 L5926 L5927Return value: L5928 L5929 L5930 L59311 if the element is referred by another element or an attribute, 0 if not. L56782pCF( L5932 L5933rV L10106+) L5934 L5935TtaSameReferenceAttributes L5936* L5937 L5938 L5939RP+ L5940Compares two reference attributes. L21456 L21457CF L21458 L21459TPFHRP+ L21460FRint TtaSameReferenceAttributes(Attribute attribute1, Attribute attribute2) L5949 L5950 L5951 L5952Parameters: L5953 L5954 L5955RP- L5956attribute1 L5957: first reference attribute. L5958 L5959RP- L5960attribute2 L5961: second reference attribute. L5962 L5963 L5964 L5965Return value: L5966 L5967 L5968 L59690 if both references are different, 1 if they are identical.( L5971) L5972 L5973Locators' L5974( L5975 L5976rV L10110+) L5977 L5978TtaNextLoadedReference L5979* L5980 L5981 L5982RP+ L5983Searches a reference that has a given element as a target and that belongs to a document currently loaded. L21464 L21465CF L21466 L21467TPFHRP+ L21468FRvoid TtaNextLoadedReference(Element target, Document targetDocument, Element *referenceElement, Attribute *referenceAttribute, Document *referenceDocument) L5998 L5999 L6000 L6001Parameters: L6002 L6003 L6004RP- L6005target L6006: the target element. L6007 L6008RP- L6009targetDocument L6010: the document to which the target element belongs. L6011 L6012RP- L6013referenceElement L6014: previous element found by the function; NULL if the first reference is searched. (Both referenceElement and referenceAttribute must be NULL if the first reference is searched.) L56783qCF L6015 L6016RP- L6017referenceAttribute L6018: previous reference attribute found; NULL if the first reference is searched or if the previous reference found by the function was an element. L6019 L6020RP- L6021referenceDocument L6022: document to which the previous reference found belongs; Zero if the first reference is searched. L6023 L6024 L6025 L6026Return parameters: L6027 L6028 L6029RP- L6030referenceAttribute L6031: the reference attribute found. NULL if the reference found is an element or if no reference is found. L6032 L6033RP- L6034referenceElement L6035: the element found. If referenceAttribute is NULL, this element is a reference element, else it is the element with which the reference attribute found is associated. If both referenceAttribute and referenceElement are NULL, then no reference has been found. L6036 L6037RP- L6038referenceDocument L6039: the document to which the reference found belongs. Zero if no reference has been found.( L6041 L6042rV L10114+) L6043 L6044TtaNextUnloadedReferringDocument L6045* L6046 L6047 L6048RP+ L6049Returns the name of a document that is not currently loaded and that contains references to a given target element. L21472 L21473CF L21474 L21475TPFHRP+ L21476FRvoid TtaNextUnloadedReferringDocument(Element target, Document targetDocument, char *referringDocumentName) L6060 L6061 L6062 L6063Parameters: L6064 L6065 L6066RP- L6067target L6068: the target element. L6069 L6070RP- L6071targetDocument L6072: the document to which the target element belongs. L6073 L6074RP- L6075referringDocumentName L6076: name of the previous document found. Empty string if the first referring document is searched. L6077 L6078 L6079 L6080Return parameter: L6081 L6082 L6083RP- L6084referringDocumentName L6085: name of the document found. Empty string if no referring document has been found. L56784rCF( L6086 L6087rV L10118+) L6088 L6089TtaSearchReferenceElement L6090* L6091 L6092 L6093RP+ L6094Searches the next reference element. Searching can be done in a subtree or starting from a given element towards the beginning or the end of the abstract tree. L21480 L21481CF L21482 L21483TPFHRP+ L21484FRElement TtaSearchReferenceElement(SearchDomain scope, Element element) L6103 L6104 L6105 L6106Parameters: L6107 L6108 L6109RP- L6110scope L6111: SearchForward, SearchBackward or SearchInTree. L6112 L6113RP- L6114element L6115: the element that is the root of the subtree (if scope = SearchInTree) or the starting element (if scope = SearchForward or SearchBackward). L6116 L6117 L6118 L6119Return value: L6120 L6121 L6122 L6123the element found, or NULL if not found. L22311sUF( L6125) L6126 L6127Languages* L6128 L6129 L6130 L6131Group language contains the functions for managing natural languages. These functions require that file  L6132language.h L6133 be included in the module that calls them. L6134 L6135 L6136Thot needs to know in which language each basic text element is written, for instance for hyphenating words or for checking the spelling. Therefore, an attribute called Language is defined by default in each structure schema and it can be associated with any element (see section > L6137rV L4874 L6138). A text element inherits the language specified by it first ancestor having a Language attribute, unless it carries its own Language attribute. L6139 L6140 L6141The tool kit maintains a table of all languages used in the documents that it handles. Each language has a name and an associated alphabet. Other information may be associated to a language, such as a dictionary (for hyphenation or spelling checking). A language is identified by an identifier of type  L6142Language L6143. L6144 L6145 L6146There are five predefined languages, whose names are: ISO_latin_1, Franais, English, Symbol and Greek. ``Languages'' ISO_latin_1 and Symbol are not natural languages in the same sense as Franais, English or Greek. They are used when a character string must be written in the corresponding alphabet, but is not candidate to such linguistic processing as word hyphenation or spelling checking. For instance, a piece of C program should be considered as written in the language ISO_latin_1; a mathematical symbol such as  L6147EL L6148 or  L6149EL L6150 should be considered as written in the language Symbol. L13832 L13831 L13830Other predefined languages, called  L13837typographic languages L13838, are used by a typographic checker (acronym, short, expo). The tool kit maintains a table of all typographic languages used in the documents that it handles. Each typographic language has a name and an associated alphabet. Other information may be associated to a language, such as a dictionary (for typographic checking). A typographic language is identified by an identifier of type  L13835Language L13836.' L6151( L6152) L6153 L6154Constructors' L6155( L6156 L6157rV L10122+) L6158 L6159TtaNewLanguage L6160* L6161 L6164 L6165RP+ L6166Declares a new language, its alphabet and optionally the names of the principal and secondary dictionaries. All languages used in a Thot document must be explicitly declared, except for predefined languages. Thot registers all declared languages and allocates a different identifier to each of them. his function does not load dictionaries  L56786tCF L56785but loads their name. If  L34071principalDictionary L34072 and/or  L34073secondDictionary L34074 are not NULL values, dictionaries are loaded when necessary from files $DICOPAR/principalDictionary and or $DICOPAR/secondDictionary. If an application redeclares an existing language, this new declaration has no effect. L21488 L21489CF L21490 L21491TPFHRP+ L21492FRLanguage TtaNewLanguage(char *languageName, char languageAlphabet, char *principalDictionary, char *secondDictionary) L6187 L6188 L6189 L6190Parameters: L6191 L6192 L6193RP- L6194languageName L6195: name of the language. L6196 L6197RP- L6198languageAlphabet L6199: alphabet to be used for writing that language: L6200 L6201 L6202`L' for ISO-Latin-1, `G' for Symbol (Greek). L6203 L6204RP- L6205principalDictionary L6206: name of the principal dictionary or NULL. L6207 L6208RP- L6209secondDictionary L6210: name of the secondary dictionary or NULL. L6211 L6212 L6213 L6214Return value: L6215 L6216 L6217 L6218identifier of the new language or 0 if the language cannot be added.( L36559 L36560 +rV L13905 ) L36561 L36562TtaRemoveLanguage L36563 * L36564 L36565 L36566RP+ L36567Remove a language from the Thot language table. The removed language may be a predefined language or a language added by  L36582x-Latin1TtaNewLanguage L36583 (see section > L36585rV L6156 L36584). L36568 L36569 L36570 L36571TPFHRP+ L36572FRvoid  L36587ENTtaRemoveLanguage L36588FR(Language languageId) L36573 L36574 L36575 L36576Parameters: L36577 L36578 L36579RP- L36580languageId L36581: identifier of the language to be removed. L56787uCF( L6219 L6220rV L10126+) L6221 L6222TtaLoadLanguageDictionaries L6223* L6224 L6225 L6226RP+ L6227Loads the dictionary associated with a language, if it is not loaded yet and registers that a dictionary associated with this language has been loaded. L21496 L21497 L21498 L21499TPFHRP+ L21500 boolean TtaLoadLanguageDictionaries(Language languageId) L6234 L6235 L6236 L6237Parameters: L6238 L6239 L6240RP- L6241languageId L6242: name of the concerned language. L6243 L6244 L6245 L6246Return value: L6247 L6248 L6249 L6250-1 if the mandatory dictionary can not be loaded. L6251 L6252 L62530 if no dictionary has been loaded. L6254 L6255 L62561 if the mandatory dictionary is loaded.( L6257 L6258rV L10130 +) L6259 L6260TtaUnLoadLanguageDictionaries L6261* L6262 L6263 L6264RP+ L6265Unloads dictionaries associated with a given language. L21504 L21505CF L21506 L21507TPFHRP+ L21508FRvoid TtaUnLoadLanguageDictionaries(Language languageId) L6272 L6273 L6274 L6275Parameters: L6276 L6277 L6278RP- L6279languageId L6280: identifier of the language.( L13839 L13840 +rV L13901) L13841 L13842TtaLoadTypoDictionaries L13843* L13844 L13845 L13846RP+ L13847Loads the dictionary associated with a typographic language, if it is not loaded yet and registers that a dictionary associated with this typographic language has been loaded. L21512 L21513 L21514 L21515TPFHRP+ L21516boolean TtaLoadTypoDictionaries(Language languageId) L56788vCF L13854 L13855 L13856 L13857Parameters: L13858 L13859 L13860RP- L13861languageId L13862: identifier of the concerned typographic language. L13863 L13864 L13865 L13866Return value: L13867 L13868 L13869 L13870-1 if the mandatory dictionary can not be loaded. L13871 L13872 L138730 if no dictionary has been loaded. L13874 L13875 L138761 if the mandatory dictionary is loaded.( L13877 L13878+rV L13905) L13879 L13880TtaUnLoadTypoDictionaries L13881* L13882 L13883 L13884RP+ L13885Unloads dictionaries associated with a given typographic language. L21520 L21521 L21522 L21523TPFHRP+ L21524FRvoid TtaUnLoadTypoDictionaries(Language languageId) L13892 L13893 L13894 L13895Parameters: L13896 L13897 L13898RP- L13899languageId L13900: identifier of the concerned typographic language.( L6282) L6283 L6284Accessors' L6285( L6286 L6287rV L10134 +) L6288 L6289TtaGetLanguageIdFromName L6290* L6291 L6292 L6293RP+ L6294Returns the identifier of a language that matches a language name. If this language name is unknown, returns the identifier of a typographic language that matches this language name.. L21528 L21529CF L21530 L21531TPFHRP+ L21532Language TtaGetLanguageIdFromName(char *languageName) L6301 L6302 L6303 L6304Parameter: L6305 L6306 L6307RP- L6308languageName L6309: name of the language or of the typographic language. L6310 L6311 L6312 L6313Return value: L6314 L6315 L6316 L6317identifier of that language or of the typographic language or 0 if the language is unknown. L56789wCF( L6318 L6319rV L10138 +) L6320 L6321TtaGetDefaultLanguage L6322* L6323 L6324 L6325RP+ L6326Returns the identifier of the default language. L21536 L21537 L21538 L21539TPFHRP+ L21540FRLanguage TtaGetDefaultLanguage() L6331 L6332 L6333 L6334Return value: L6335 L6336 L6337 L6338identifier of the default language.( L6339 L6340rV L10142+) L6341 L6342TtaGetLanguageIdFromAlphabet L6343* L6344 L6345 L6346RP+ L6347Returns the identifier of the first language that uses a given alphabet. L21544 L21545CF L21546 L21547TPFHRP+ L21548Language TtaGetLanguageIdFromAlphabet(char *languageAlphabet) L6354 L6355 L6356 L6357Parameter: L6358 L6359 L6360RP- L6361languageAlphabet L6362: the alphabet of interest (`L' = latin, `G' = greek). L6363 L6364 L6365 L6366Return value: L6367 L6368 L6369 L6370identifier of that language or 0 if the language is unknown.( L6371 L6372rV L10146+) L6373 L6374TtaGetAlphabet L6375* L6376 L6377 L6378RP+ L6379Returns the alphabet associated with a given language. L21552 L21553 L21554 L21555TPFHRP+ L21556FRchar TtaGetAlphabet(Language languageId) L6386 L6387 L6388 L6389Parameter: L6390 L6391 L6392RP- L6393languageId L6394: name of the language. L6395 L6396 L6397 L6398Return value: L6399 L6400 L6401 L6402a character that identifies the alphabet (`L' = latin, `G' = greek). L56790xCF( L6404 L6405rV L10150+) L6406 L6407TtaGetLanguageName L6408* L6409 L6410 L6411RP+ L6412Returns the name of a given language. L21560 L21561 L21562 L21563TPFHRP+ L21564char *TtaGetLanguageName(Language languageId) L6419 L6420 L6421 L6422Parameter: L6423 L6424 L6425RP- L6426languageId L6427: identifier of the language. L6428 L6429 L6430 L6431Return value: L6432 L6433 L6434 L6435the name of the language.( L36160 L36161rV L10150 + ) L36162 L36163TtaGetLanguageNameFromCode L36164 * L36165 L36166 L36167RP+ L36168Returns the name of a language whose RFC-1766 code is known L36169 L36170 L36171 L36172TPFHRP+ L36173char *TtaGetLanguageNameFromCode (char *code) L36174 L36175 L36176 L36177Parameter: L36178 L36179 L36180RP- L36181code L36182: code of the language, according to RFC-1766, a superset of ISO-639 L36183 L36184 L36185 L36186Return value: L36187 L36188 L36189 L36190the name of the language.( L36191 L36192rV L10150 + ) L36193 L36194TtaGetLanguageCodeFromName L36195 * L36196 L36197 L36198RP+ L36199Returns the RFC-1766 code of a language whose name is known. L36200 L36201 L36202 L36203TPFHRP+ L36204char *TtaGetLanguageCodeFromName (char *name) L36205 L36206 L36207 L36208Parameter: L36209 L36210 L36211RP- L36212name L36213: the name of the language, for instance "English", "French", "American", etc. L56791yCF L36214 L36215 L36216 L36217Return value: L36218 L36219 L36220 L36221code of the language, according to RFC-1766, a superset of ISO-639.( L6436 L6437rV L10154+) L6438 L6439TtaGetPrincipalDictionary L6440* L6441 L6442 L6443RP+ L6444Returns a pointer to the principal dictionary associated to a language. L21568 L21569 L21570 L21571TPFHRP+ L21572FRDictionary TtaGetPrincipalDictionary(Language languageId) L6451 L6452 L6453 L6454Return value: L6455 L6456 L6457 L6458the pointer to that dictionary or NULL if there is no dictionary for this language.( L6459 L6460+rV L10158) L6461 L6462TtaGetSecondaryDictionary L6463* L6464 L6465 L6466RP+ L6467Returns a pointer to the secondary dictionary associated to a language. L21576 L21577 L21578 L21579TPFHRP+ L21580 Dictionary TtaGetSecondaryDictionary(Language languageId) L6474 L6475 L6476 L6477Return value: L6478 L6479 L6480 L6481the pointer to that dictionary or NULL if there is no dictionary for this language.( L13911 L13912+rV L13957) L13913 L13914TtaGetPrincipalTypoDictionary L13915* L13916 L13917 L13918RP+ L13919Returns a pointer to the principal dictionary associated to a typographic language. L21584 L21585CF L21586 L21587TPFHRP+ L21588FRDictionary TtaGetPrincipalTypoDictionary(Language languageId) L56792zCF L13926 L13927 L13928 L13929Return value: L13930 L13931 L13932 L13933the pointer to that dictionary or NULL if there is no dictionary for this typographic language.( L13934 L13935+rV L13961) L13936 L13937TtaGetSecondaryTypoDictionary L13938* L13939 L13940 L13941RP+ L13942Returns a pointer to the secondary dictionary associated to a typographic language. L21592 L21593CF L21594 L21595TPFHRP+ L21596Dictionary TtaGetSecondaryTypoDictionary(Language languageId) L13949 L13950 L13951 L13952Return value: L13953 L13954 L13955 L13956the pointer to that dictionary or NULL if there is no dictionary for this typographic language.( L6482 L6483rV L10162+) L6484 L6485TtaGetNumberOfLanguages L6486* L6487 L6488 L6489RP+ L6490Returns the current number of languages known by Thot. L21600 L21601 L21602 L21603TPFHRP+ L21604FRint TtaGetNumberOfLanguages() L6495 L6496 L6497 L6498Return value: L6499 L6500 L6501 L6502the current number of languages. L22312{UF L53426CF( L6504) L6505 L6506Specific presentation* L6507 L6508 L6509 L6510The functions described in this section require that file  L6511presentation.h L6512 be included in the module that calls them. L6513 L6514 L6515When a new specific presentation rule is created (functions  L6516rV L10166+ L6517TtaNewPRule L6518 L6519, TtaNewPRuleForNamedView and  L6520rV L10170+ L6521TtaCopyPRule) L6522 L6523, it must be attached (function  L6524rV L10174+ L6525TtaAttachPRule L6526 L6527) to an element which is itself part of an abstract tree of a document, before any other action can be performed on that specific presentation rule.' L6528( L6529) L6530 L6531Constructors' L6532( L6533 L6534rV L10178+) L6535 L6536TtaNewPRule L6537* L6538 L6539 L6540RP+ L6541Creates a new presentation rule of a given type for a given view of a given document. L21608 L21609CF L21610 L21611TPFHRP+ L21612PRule TtaNewPRule(int presentationType, View view, Document document) L6552 L6553 L6554 L6555Parameter: L6556 L6557 L6558RP- L6559presentationType L6560: type of the presentation rule to be created. Available values are PRSize, PRStyle, PRFont, PRUnderline, PRThickness, PRIndent, PRLineSpacing, PRDepth, PRAdjust, PRJustify, PRLineStyle, PRLineWeight, PRFillPattern, PRBackground, PRForeground, PRHyphenate. L6561 L6562RP- L6563view L6564: the view (this view must be open). L6565 L6566RP- L6567document L6568: the document. L6569 L6570 L6571 L6572Return value: L6573 L6574 L6575 L6576new presentation rule. L56793|CF( L6577FR L6578rV L10182+) L6579 L6580TtaNewPRuleForNamedView L6581* L6582 L6583 L6584RP+ L6585Creates a new presentation rule of a given type for a given view of a given document. The view is identified by its name. L21616 L21617CF L21618 L21619TPFHRP+ L21620PRule TtaNewPRuleForNamedView(int presentationType, char *viewName, Document document) L6597 L6598 L6599 L6600Parameter: L6601 L6602 L6603RP- L6604presentationType L6605: type of the presentation rule to be created. Available values are PRSize, PRStyle, PRFont, PRUnderline, PRThickness, PRIndent, PRLineSpacing, PRDepth, PRAdjust, PRJustify, PRLineStyle, PRLineWeight, PRFillPattern, PRBackground, PRForeground, PRHyphenate. L6606 L6607RP- L6608viewName L6609: the name of the view (this view does not need to be open). L6610 L6611RP- L6612document L6613: the document. L6614 L6615 L6616 L6617Return value: L6618 L6619 L6620 L6621new presentation rule.( L6622 L6623rV L10186+) L6624 L6625TtaCopyPRule L6626* L6627 L6628 L6629RP+ L6630Creates a new presentation rule and initializes it with a copy of an existing presentation rule. L21624 L21625 L21626 L21627TPFHRP+ L21628PRule TtaCopyPRule(PRule pRule) L6637 L6638 L6639 L6640Parameter: L6641 L6642 L6643RP- L6644pRule L6645: presentation rule to be copied. L6646 L6647 L6648 L6649Return value: L6650 L6651 L6652 L6653new presentation rule. L56794}CF( L6654 L6655rV L10190+) L6656 L6657TtaAttachPRule L6658* L6659 L6660 L6661RP+ L6662Attaches a presentation rule to an element. L21632 L21633CF L21634 L21635TPFHRP+ L21636FRvoid TtaAttachPRule(Element element, PRule pRule, Document document) L6663 L6664 L6665 L6666void TtaAttachPRule(element, pRule, document) L6667 L6668Element element; L6669 L6670PRule pRule; L6671 L6672Document document; L6673 L6674 L6675 L6676Parameters: L6677 L6678 L6679RP- L6680element L6681: the element to which the presentation rule has to be attached. L6682 L6683RP- L6684pRule L6685: the presentation rule to be attached. L6686 L6687RP- L6688document L6689: the document to which the element belongs.( L6691 L6692rV L10194!+) L6693 L6694TtaRemovePRule L6695* L6696 L6697 L6698RP+ L6699Removes a presentation rule from an element and release that rule. L21640 L21641CF L21642 L21643TPFHRP+ L21644void TtaRemovePRule(Element element, PRule pRule, Document document L6710 L6711 L6712 L6713Parameters: L6714 L6715 L6716RP- L6717element L6718: the element with which the presentation rule is associated. L6719 L6720RP- L6721pRule L6722: the presentation rule to be removed. L6723 L6724RP- L6725document L6726: the document to which the element belongs. L56795~CF( L6727) L6728 L6729Modificators' L6730( L6731 L6732rV L10198#+) L6733 L6734TtaSetPRuleValue L6735* L6736 L6737 L6738RP+ L6739Changes the value of a presentation rule. The presentation rule must be attached to an element that is part of a document. L21648 L21649CF L21650 L21651TPFHRP+ L21652FRvoid TtaSetPRuleValue(Element element, PRule pRule, int value, Document document) L6752 L6753 L6754 L6755Parameters: L6756 L6757 L6758RP- L6759element L6760: the element to which the presentation rule is attached. L6761 L6762RP- L6763pRule L6764: the presentation rule to be changed. L6765 L6766RP- L6767value L6768: the value to be set. L6769 L6770RP- L6771document L6772: the document to which the element belongs. L6773 L6774 L6775 L6776Valid values according to rule type: L6777 L6778 L6779RP- L6780RSize L6781: an integer between 6 and 72 (body size in points). L6782 L6783RP- L6784RStyle L6785: StyleRoman, StyleBold, StyleItalics, StyleOblique, StyleBoldItalics, StyleBoldOblique. L6786 L6787RP- L6788RFont L6789: FontTimes, FontHelvetica, FontCourier. L6790 L6791RP- L6792RUnderline L6793: NoUnderline, Underline, Overline, CrossOut. L6794 L6795RP- L6796RThickness L6797: ThinUnderline, ThickUnderline. L6798 L6799RP- L6800RIndent L6801: a positive, null or negative integer (indentation in points). L6803 L6804RP- L6805RLineSpacing L6806: a positive integer (line spacing in points). L6807 L6808RP- L6809RDepth L6810: a positive integer (depth of the element). L6811 L6812RP- L6813RAdjust L6814: AdjustLeft, AdjustRight, Centered, LeftWithDots. L6815 L6816RP- L6817RJustify L6818: Justified, NotJustified. L6819RP- L6820RHyphenate L6821: Hyphenation, NoHyphenation. L6822 L6823RP- L6824RLineStyle L6825: SolidLine, DashedLine, DottedLine. L6826 L6827RP- L6828RLineWeight L6829: a positive or null integer (stroke width for graphics). L6830RP- L6831RFillPattern L6832: rank of the pattern in the file thot.pattern. L56796CF L6833RP- L6834RBackground L6835: rank of the background color in the file thot.color. L6836RP- L6837RForeground L6838: rank of the foreground color in the file thot.color.( L36749 L36750rV L10198 _+ `) L36751 L36752TtaSetPRuleView L36753 `* L36754 L36755 L36756RP+ L36757Sets the view to which a presentation rule applies. The presentation rule must not be attached yet to an element. L36758 L36759CF L36760 L36761TPFHRP+ L36762FRvoid TtaSetPRuleView (PRule pRule, int view) L36763 L36764 L36765 L36766Parameters: L36767 L36772 L36773RP- L36774pRule L36775: the presentation rule to be changed. L36776 L36777RP- L36778view L36779: the value to be set.( L6839FR L6840rV L10202%+) L6841 L6842TtaChangeBoxSize L6843* L6844 L6845 L6846RP+ L6847Changes the height and width of the box corresponding to an element in a given view. L21656 L21657CF L21658 L21659TPFHRP+ L21660void TtaChangeBoxSize(Element element, Document document, View view, int deltaX, int deltaY, TypeUnit unit) L6862 L6863 L6864 L6865Parameters: L6866 L6867 L6868RP- L6869element L6870: the element of interest. L33435 L33436document L33437: the document to which the element belongs. L6871 L6872RP- L6873view L6874: the view. L6875 L6876RP- L6877deltaX L6878: width increment in units (positive, negative or zero). L6879 L6880RP- L6881deltaY L6882: height increment in units (positive, negative or zero). L6883 L6884unit L6885: the unit used for the values. L56797CF( L6886FR L6887rV L10206'+) L6888 L6889TtaChangeBoxPosition L6890* L6891 L6892 L6893RP+ L6894Moves the box of an element in a given view. L21664 L21665CF L21666 L21667TPFHRP+ L21668void TtaChangeBoxPosition(Element element, Document document, View view, int deltaX, int deltaY, TypeUnit unit) L6910 L6911 L6912 L6913Parameters: L6914 L6915 L6916RP- L6917element L6918: the element of interest. L33438 L33439document L33440: the document to which the element belongs. L6919 L6920RP- L6921view L6922: the view. L6923 L6924RP- L6925deltaX L6926: horizontal shift in units (positive, negative or zero). L6927 L6928RP- L6929deltaY L6930: vertical shift in units (positive, negative or zero). L6931 L6932unit L6933: the unit used for the values.( L6935) L6936 L6937Accessors' L6938( L6939FR L6940rV L10210)+) L6941 L6942TtaGiveBoxSize L6943* L6944 L6945 L6946RP+ L6947Returns the height and width of the box corresponding to an element in a given view. L21672 L21673 L21674 L21675TPFHRP+ L21676void TtaGiveBoxSize(Element element, Document document, View view, TypeUnit unit, int *width, int *height) L6960 L6961 L6962 L6963Parameters: L6964 L6965 L6966RP- L6967element L6968: the element of interest. L33855 L33856document L33857: the document to which the element belongs. L6969 L6970RP- L6971view L6972: the view. L33441 L33442unit L33443: the unit used for the values. L56798CF L6973 L6974 L6975 L6976Return parameters: L6977 L6978 L6979RP- L6980width L6981: box width in units. L6982 L6983RP- L6984height L6985: box height in units.( L6986FR L6987rV L10214++) L6988 L6989TtaGiveBoxPosition L6990* L6991 L6992 L6993RP+ L6994Returns the x and y coordinates of the box corresponding to an element in a given view. The returned coordinates indicate the distance in points between the upper left corner of the box and the upper left corner of its parent box. L21680 L21681CF L21682 L21683TPFHRP+ L21684void TtaGiveBoxPosition(Element element, Document document, View view, TypeUnit unit, int *xCoord, int *yCoord) L7008 L7009 L7010 L7011Parameters: L7012 L7013 L7014RP- L7015element L7016: the element of interest. L33858 L33859document L33860: the document to which the element belongs. L7017 L7018RP- L7019view L7020: the view. L33444 L33445unit L33446: the unit used for the values. L7021 L7022 L7023 L7024Return parameters: L7025 L7026 L7027RP- L7028xCoord L7029: distance from the left edge of the parent box to the left edge of the box, in units. L33447RP- L33448yCoord L33449: distance from the top edge of the parent box to the top edge of the box, in units.( L7034 L7035rV L10218-+) L7036 L7037TtaNextPRule L7038* L7039 L7040 L7041RP+ L7042Returns the first presentation rule associated with a given element (if pRule is NULL) or the presentation rule that follows a given rule of a given element. L21688 L21689 L21690 L21691TPFHRP+ L21692void TtaNextPRule(Element element, PRule *pRule) L56799CF L7051 L7052 L7053 L7054Parameters: L7055 L7056 L7057RP- L7058element L7059: the element of interest. L7060 L7061RP- L7062pRule L7063: a presentation rule of that element, or NULL if the first rule is asked. L7064 L7065 L7066 L7067Return parameter: L7068 L7069 L7070RP- L7071pRule L7072: the next presentation rule, or NULL if pRule is the last rule of the element.( L7073 L7074rV L10222/+) L7075 L7076TtaGetPRule L7077* L7078 L7079 L7080RP+ L7081Returns a presentation rule of a given type associated with a given element. L21696 L21697 L21698 L21699TPFHRP+ L21700FRPRule TtaGetPRule(Element element, int presentationType) L7090 L7091 L7092 L7093Parameters: L7094 L7095 L7096RP- L7097element L7098: the element of interest. L7099 L7100RP- L7101presentationType L7102: type of the desired presentation rule. Available values are PRSize, PRStyle, PRFont, PRUnderline, PRThickness, PRIndent, PRLineSpacing, PRDepth, PRAdjust, PRJustify, PRLineStyle, PRLineWeight, PRFillPattern, PRBackground, PRForeground, PRHyphenate. L7104 L7105 L7106 L7107Return value: L7108 L7109 L7110 L7111the presentation rule found, or NULL if the element does not have this type of presentation rule.( L7112 L7113rV L102261+) L7114 L7115TtaGetPRuleType L7116* L7117 L7118 L7119RP+ L7120Returns the type of a presentation rule. L21704 L21705 L21706 L21707TPFHRP+ L21708int TtaGetPRuleType(PRule pRule) L56800CF L7127 L7128 L7129 L7130Parameters: L7131 L7132 L7133RP- L7134pRule L7135: the presentation rule of interest. L7136 L7137 L7138 L7139Return value: L7140 L7141 L7142 L7143type of that presentation rule. Available values are PRSize, PRStyle, PRFont, PRUnderline, PRThickness, PRIndent, PRLineSpacing, PRDepth, PRAdjust, PRJustify, PRLineStyle, PRLineWeight, PRFillPattern, PRBackground, PRForeground, PRHyphenate.( L7144 L7145rV L102303+) L7146 L7147TtaGetPRuleValue L7148* L7149 L7150 L7151RP+ L7152Returns the value of a presentation rule. L21712 L21713 L21714 L21715TPFHRP+ L21716FRint TtaGetPRuleValue(PRule pRule) L7159 L7160 L7161 L7162Parameters: L7163 L7164 L7165RP- L7166pRule L7167: the presentation rule of interest. L7168 L7169 L7170 L7171Return values according to rule type: L7172 L7173 L7174RP- L7175RSize L7176: an integer between 6 and 72 (body size in points). L7177 L7178RP- L7179RStyle L7180: StyleRoman, StyleBold, StyleItalics, StyleOblique, StyleBoldItalics, StyleBoldOblique. L7181 L7182RP- L7183RFont L7184: FontTimes, FontHelvetica, FontCourier. L7185 L7186RP- L7187RUnderline L7188: NoUnderline, Underline, Overline, CrossOut. L7189 L7190RP- L7191RThickness L7192: ThinUnderline, ThickUnderline. L7193 L7194RP- L7195RIndent L7196: a positive, null or negative integer (indentation in points). L7197 L7198RP- L7199RLineSpacing L7200: a positive integer (line spacing in points). L7201 L7202RP- L7203RDepth L7204: a positive integer (depth of the element). L7205 L7206RP- L7207RAdjust L7208: AdjustLeft, AdjustRight, Centered, LeftWithDots. L7209 L7210RP- L7211RJustify L7212: Justified, NotJustified. L7214RP- L7215RHyphenate L7216: Hyphenation, NoHyphenation. L7217 L7218RP- L7219RLineStyle L7220: SolidLine, DashedLine, DottedLine. L7221 L7222RP- L7223RLineWeight L7224: a positive or null integer (stroke width for graphics). L56801CF L7225RP- L7226RFillPattern L7227: rank of the pattern in the file thot.pattern. L7228RP- L7229RBackground L7230: rank of the background color in the file thot.color. L7231RP- L7232RForeground L7233: rank of the foreground color in the file thot.color.( L36849 L36850rV L10230 a+ b) L36851 L36852TtaGetPRuleView L36853 b* L36854 L36855 L36856RP+ L36857Returns the number of the view to which a presentation rule applies. L36858 L36859 L36860 L36861TPFHRP+ L36862FRint TtaGetPRuleView(PRule pRule) L36863 L36864 L36865 L36866Parameters: L36867 L36868 L36869RP- L36870pRule L36871: the presentation rule of interest. L36872 L36873 L36874 L36875Return value: L36876 L36877 L36878RP- L36880number of the view to which a presentation rule applies.( L7234 L7235rV L102345+) L7236 L7237TtaSamePRules L7238* L7239 L7240 L7241RP+ L7242Compares two presentation rules associated with the same element or with different elements. L21720 L21721 L21722 L21723TPFHRP+ L21724int TtaSamePRules(PRule pRule1, PRule pRule2) L7251 L7252 L7253 L7254Parameters: L7255 L7256 L7257RP- L7258pRule1 L7259: first presentation rule to be compared. L7260 L7261RP- L7262pRule2 L7263: second presentation rule to be compared. L7264 L7265 L7266 L7267Return value: L7268 L7269 L7270 L72710 if both rules are different, 1 if they are identical. L22313UF( L7272) L7273 L7274Views* L7275 L7276 L7277 L7278The functions described in this section require that file  L7279view.h L7280 be included in the module that calls them. They are available only in the Thot Editor library.' L7281( L7282) L7283 L7284Constructors' L7285( L7286 L7287rV L102387+) L7288 L7289TtaOpenMainView L7290* L7291 L7292 L7293RP+ L7294Opens the main view of a document. This document must have a PSchema (see  L7295rV L10242+ L7296TtaSetPSchema L7297 L7298). L21728 L21729 L21730 L21731TPFHRP+ L21732FRView TtaOpenMainView(Document document, int x, int y, int w, int h) L7308 L7309 L7310 L7311Parameters: L7312 L7313 L7314RP- L7315document L7316: the document for which a window must be open. L7317 L7318RP- L7319x, y L7320: coordinate (in millimeters) of the upper left corner of the window that will display the view. L7321 L7322RP- L7323w, h L7324: width and height (in millimeters) of the upper left corner of the window that will display the view. L7325 L7326 L7327 L7328Return value: L7329 L7330 L7331 L7332the view opened or 0 if the view cannot be opened.( L7333 L7334rV L102469+) L7335 L7336TtaOpenView L7337* L7338 L7339 L7340RP+ L7341Opens a view for a document. This document must have a PSchema (see  L7342rV L10250+ L7343TtaSetPSchema L7344 L7345). L21736 L21737 L21738 L21739TPFHRP+ L21740View TtaOpenView(Document document, char *viewName, int x, int y, int w, int h) L56802CF L7356 L7357 L7358 L7359Parameters: L7360 L7361 L7362RP- L7363document L7364: the document. L7365 L7366RP- L7367viewName L7368: name of the view to be opened. L7369 L7370RP- L7371x, y L7372: coordinate (in millimeters) of the upper left corner of the window that will display the view. L7373 L7374RP- L7375w, h L7376: width and height (in millimeters) of the upper left corner of the window that will display the view. L7377 L7378 L7379 L7380Return value: L7381 L7382 L7383 L7384the view opened or 0 if the view cannot be opened.( L7385 L7386rV L10254;+) L7387 L7388TtaOpenSubView L7389* L7390 L7391 L7392RP+ L7393Opens a view that shows only a subtree. This document must have a PSchema (see  L7394rV L10258+ L7395TtaSetPSchema L7396 L7397). L21744 L21745CF L21746 L21747TPFHRP+ L21748FRView TtaOpenSubView(Document document, char *viewName, int x, int y, int w, int h, Element subtree) L7411 L7412 L7413 L7414Parameters: L7415 L7416 L7417RP- L7418document L7419: the document. L7420 L7421RP- L7422viewName L7423: name of the view to be opened. L7424 L7425 L7426x, y: coordinate (in millimeters) of the upper left corner of the L7427 L7428 L7429window that will display the view. L7430 L7431 L7432w, h: width and height (in millimeters) of the upper left corner of the L7433 L7434 L7435window that will display the view. L7436 L7437RP- L7438subtree L7439: root element of the subtree to be shown in the view. L7440 L7441 L7442 L7443Return value: L7444 L7445 L7446 L7447the view opened or 0 if the view cannot be opened. L56803CF( L7448 L7449rV L10262+) L7450 L7451TtaChangeViewTitle L7452* L7453 L7454 L7455RP+ L7456Changes the title of a view. L21752 L21753 L21754 L21755TPFHRP+ L21756void TtaChangeViewTitle(Document document, View view, char *title) L7467 L7468 L7469 L7470Parameters: L7471 L7472 L7473RP- L7474document L7475: the document. L7476 L7477RP- L7478view L7479: the view . L7480 L7481 L7482title: the new title.( L7483 L7484rV L10266=+) L7485 L7486TtaCloseView L7487* L7488 L7489 L7490RP+ L7491Closes a view. L21760 L21761 L21762 L21763TPFHRP+ L21764FRvoid TtaCloseView(Document document, View view) L7500 L7501 L7502 L7503Parameters: L7504 L7505 L7506RP- L7507document L7508: the document for which a view must be closed. L7509 L7510RP- L7511view L7512: the view to be closed.( L7514) L7515 L7516Modificators' L7517( L7518 L7519rV L10270A+) L7520 L7521TtaSetSensibility L7522* L7523 L7524 L7525RP+ L7526Changes the current sensibility used to display a given view of a given document. L21768 L21769 L21770 L21771TPFHRP+ L21772void TtaSetSensibility(Document document, View view, int value) L56804CF L7537 L7538 L7539 L7540Parameters: L7541 L7542 L7543RP- L7544document L7545: the document. Cannot be 0. L7546 L7547RP- L7548view L7549: the view. L7550 L7551RP- L7552value L7553: new value of the sensibility.( L7554 L7555rV L10274C+) L7556 L7557TtaSetZoom L7558* L7559 L7560 L7561RP+ L7562Changes the current zoom used to display a given view of a given document. L21776 L21777 L21778 L21779TPFHRP+ L21780FRvoid TtaSetZoom(Document document, View view, int value) L7573 L7574 L7575 L7576Parameters: L7577 L7578 L7579RP- L7580document L7581: the document. Cannot be 0. L7582 L7583RP- L7584view L7585: the view. L7586 L7587RP- L7588value L7589: new value of the zoom.( L7590FR L7591rV L10278+) L7592 L7593TtaShowElement L7594* L7595 L7596 L7597RP+ L7598Shows a given element in a given view of a given document. L21784 L21785CF L21786 L21787TPFHRP+ L21788void TtaShowElement(Document document, View view, Element element, int position) L7611 L7612 L7613 L7614Parameters: L7615 L7616 L7617RP- L7618document L7619: the document to which the element to be shown belongs. Cannot be 0. L7620 L7621RP- L7622view L7623: the view where the element must be shown. L7624 L7625RP- L7626element L7627: the element to be shown. L7629 L7630RP- L7631position L7632: position of the top of the element in the window. Supposing that the y axis is oriented from the top of the window (coordinate 0) to the bottom (coordinate 100, whatever the actual height of the window), position is  L56806CF L56805the desired y coordinate of the top of the element. This value is can be negative.( L28935 L28968rV L28969{+z) L28936 L28937TtaRaiseView L28974z* L28938 L28939 L28940RP+ L28941Maps and raises a given view of a given document. L28942 L28943CF L28944 L28945TPFHRP+ L28946void TtaRaiseView(Document document, View view) L28947 L28948 L28949 L28950Parameters: L28951 L28952 L28953RP- L28954document L28955: the document to which the element to be shown belongs. Cannot be 0. L28956 L28957RP- L28958view L28959: the view where the element must be shown.( L7633 L7634rV L10282E+) L7635 L7636TtaSetDisplayMode L7637* L7638 L7639 L7640RP+ L7641Changes display mode for a document. Three display modes are available (DisplayImmediately, DeferredDisplay and NoComputedDisplay). In the immediate mode, each modification made in the abstract tree of a document is immediately reflected in all opened views where the modification can be seen. In the deferred mode, the programmer can decide when the modifications are made visible to the user; this avoids the image of the document to blink when several elementary changes are made successively. Modifications are displayed when mode is changed to DisplayImmediately. In the NoComputedDisplay mode, the modifications are not displayed and not computed by the editor; the execution is more rapid but the current image is lost. When mode is changed to DisplayImmediately or DeferredDisplay, the image is completely redrawn by the editor. An application that handles several documents at the same time can choose different modes for different documents. When a document is open or created, it is initially in the immediate mode. L21792 L21793CF L21794 L21795TPFHRP+ L21796FRvoid TtaSetDisplayMode(Document document, DisplayMode newDisplayMode) L56807CF L7650 L7651 L7652 L7653Parameters: L7654 L7655 L7656RP- L7657document L7658: the document. L7659 L7660RP- L7661NewDisplayMode L7662: new display mode for that document.( L7663) L7664 L7665Accessors' L7666( L7667 L7668rV L10286G+) L7669 L7670TtaGetSensibility L7671* L7672 L7673 L7674RP+ L7675Reads the current sensibility used to display a given view of a given document. L21800 L21801 L21802 L21803TPFHRP+ L21804int TtaGetSensibility(Document document, View view) L7684 L7685 L7686 L7687Parameters: L7688 L7689 L7690RP- L7691document L7692: the document. Cannot be 0. L7693 L7694RP- L7695view L7696: the view. L7698 L7699 L7700 L7701Return value: L7702 L7703 L7704 L7705current value of the sensibility.( L7706 L7707rV L10290I+) L7708 L7709TtaGetZoom L7710* L7711 L7712 L7713RP+ L7714Reads the current zoom used to display a given view of a given document. L21808 L21809 L21810 L21811TPFHRP+ L21812FRint TtaGetZoom(Document document, View view) L7715 L7716 L7717 L7718int TtaGetZoom(document, view) L7719 L7720Document document; L7721 L7722View view; L7723 L7724 L7725 L7726Parameters: L7727 L7728 L7729RP- L7730document L7731: the document. Cannot be 0. L7732 L7733RP- L7734view L7735: the view. L7736 L7737 L7738 L7739Return value: L7740 L7741 L7742 L7743current value of the zoom. L56808CF( L56624 L56625rV L10294 + ) L56626 L56627TtaGetFirstElementShown L56628 * L56629 L56630 L56631RP+ L56632Returns the first visible element in the view of the document. The function returns also, the position of the top of this element within the view. L56633 L56634 L56635 L56636TPFHRP+ L56637Element TtaGetFirstElementShown (Document document, View view, int *position) L56638 L56639 L56640 L56641Parameters: L56642 L56643 L56644RP- L56645document L56646: the document. L56655RP- L56656view L56657: the view. L56647 L56648 L56649 L56650Return parameter: L56651 L56669RP- L56670position L56671: position of the top of the element in the window. Supposing that the y axis is oriented from the top of the window (coordinate 0) to the bottom (coordinate 100, whatever the actual height of the window), position is the desired y coordinate of the top of the element. This value is can be negative. L56661 L56662 L56663 L56664Return value: L56665 L56666 L56667 L56668current display mode for that document.( L7744 L7745rV L10294K+) L7746 L7747TtaGetDisplayMode L7748* L7749 L7750 L7751RP+ L7752Returns the current display mode for a document. L21816 L21817 L21818 L21819TPFHRP+ L21820DisplayMode TtaGetDisplayMode(Document document) L7759 L7760 L7761 L7762Parameter: L7763 L7764 L7765RP- L7766document L7767: the document. L7768 L7769 L7770 L7771Return value: L7772 L7773 L7774 L7775current display mode for that document. L56809CF( L7776 L7777rV L10298M+) L7778 L7779TtaIsPSchemaValid L7780* L7781 L7782 L7783RP+ L7784Checks if a presentation schema can be applied to a document of a given class. No document is needed and the schemas are not loaded by this function. L21824 L21825CF L21826 L21827TPFHRP+ L21828FRint TtaIsPSchemaValid(char *structureName, char *presentationName) L7793 L7794 L7795 L7796Parameters: L7797 L7798 L7799RP- L7800structureName L7801: Name of the document class. L7802 L7803RP- L7804presentationName L7805: Name of the presentation schema to be checked. L7806 L7807 L7808 L7809Return value: L7810 L7811 L7812 L78131 if the presentation schema can be applied, 0 if it can not.( L7815 L7816rV L10302O+) L7817 L7818TtaGiveViewsToOpen L7819* L7820 L7821 L7822RP+ L7823Returns the names of the views that can be opened for a document. L21832 L21833CF L21834 L21835TPFHRP+ L21836void TtaGiveViewsToOpen(Document document, char *buffer, int nbViews) L7834 L7835 L7836 L7837Parameters: L7838 L7839 L7840RP- L7841document L7842: the document. L7843 L7844RP- L7845buffer L7846: a buffer that will contain the result. L7847 L7848 L7849 L7850Return parameters: L7851 L7852 L7853RP- L7854buffer L7855: list of view names. Each name is a character string with a final '\0'. Names of views that are already open have a '*' at the end. L7856 L7857RP- L7858nbViews L7859: number of names in the list, 0 if not any view can be open. L53427 CF L56810CF( L7860 L7861rV L10306Q+) L7862 L7863TtaGetViewName L7864* L7865 L7866 L7867RP+ L7868Returns the name of an open view. L21840 L21841 L21842 L21843TPFHRP+ L21844FRchar *TtaGetViewName(Document document, View view) L7877 L7878 L7879 L7880Parameters: L7881 L7882 L7883RP- L7884document L7885: the document to which the view belongs. L7886 L7887RP- L7888view L7889: the view. L7890 L7891 L7892 L7893Return value: L7894 L7895 L7896 L7897Name of the view. The buffer must be provided by the caller.( L7898EN L7899rV L10310+) L7900 L7901TtaGetViewFromName L7902* L7903 L7904 L7905RP+ L7906Returns the identifier of a view of a given document from its name. L21848 L21849 L21850 L21851TPFHRP+ L21852View TtaGetViewFromName(Document document, char *viewName) L7915 L7916 L7917 L7918Parameters: L7919 L7920 L7921RP- L7922document L7923: the document to which the view belongs. L7924 L7925RP- L7926viewName L7927: the name of the view. L7928 L7929 L7930 L7931Return value: L7932 L7933 L7934 L7935the view. 0 if no view of that name is currently open for the document.( L7937 L7938rV L10314S+) L7939 L7940TtaGiveActiveView L7941* L7942 L7943 L7944RP+ L7945Returns the active view and the document to which that view belongs. The active view is the one that receives the characters typed by the user. L21856 L21857 L21858 L21859TPFHRP+ L21860FRvoid TtaGiveActiveView(Document *document, View *view) L56811CF L7954 L7955 L7956 L7957Parameter: L7958 L7959 L7960 L7961No parameter. L7962 L7963 L7964 L7965Return values: L7966 L7967 L7968RP- L7969document L7970: the active document. L7971 L7972RP- L7973view L7974: the active view.( L28975 L29017rV L29018}+|) L28976 L28977TtaIsViewOpened L29023|* L28978 L28979 L28980RP+ L28981Indicates whether a view is opened. L28982 L28983 L28984 L28985TPFHRP+ L28986FRboolean TtaIsViewOpened(Document document, View view) L28987 L28988 L28989 L28990Parameter: L28991 L29009 L29010RP- L29011document L29012: the document. L29013 L29014RP- L29015view L29016: the view. L28995 L28996 L28997 L28998Return values: L28999 L29000 L29001RP- L29008 True if the view is already opened.( L25740) L25741 L25742Help' L25743( L25744 L25772rV L25773V+U) L25745 L25746TtaListView L25778U* L25747 L25748 L25749RP+ L25750Produces in a file a human-readable form of the current picture of the document view. L25751 L25752CF L25753 L25754TPFHRP+JF L25755void TtaListView(Document document, View view, FILE *fileDescriptor) L25756 L25757 L25758 L25759Parameters: L25760 L25761 L25762RP- L25763document L25764: the document to be listed. L25769RP- L25770view L25771: the view to be listed. L56812CF L25765 L25766RP- L25767fileDescriptor L25768: file descriptor of the file that will contain the list. This file must be open when calling the function. L22314UF( L7975) L7976 L7977Selection* L7978 L7979 L7980 L7981The functions described in this section require that file  L7982selection.h L7983 be included in the module that calls them. They are available only in the Thot Editor library. L7984 L7985 L7986These functions allow an application program to change the selection set by the user of the Thot Editor. The selection is the part of a document that will be concerned by the next editing command issued by the end user. Tool kit functions that modify a document are independent from the selection in the sense that they can change any part of a document independently of the current selection; but, when necessary, they can also have access to the current user selection, by using the following functions.' L7987( L7988) L7989 L7990Constructors' L7991( L7992 L7993rV L10318U+) L7994 L7995TtaSelectElement L7996* L7997 L7998 L7999RP+ L8000Selects a single element. This element is highlighted in all views where it can be displayed. If it cannot be displayed in any existing view, a new view is eventually open for displaying it. L21864 L21865CF L21866 L21867TPFHRP+ L21868FRvoid TtaSelectElement(Document document, Element selectedElement) L8010 L8011 L8012 L8013Parameters: L8014 L8015 L8016RP- L8017document L8018: the document containing the element to be selected. L8019 L8020RP- L8021selectedElement L8022: the element to be selected. NULL for cancelling the selection in the document.( L37100 L37101rV L10318 + ) L37102 L37103TtaSelectView L37104 * L37105 L37106 L37107RP+ L37108Define the selected view of the document. This function has no effect if the document is not the current selected document and if the current selected element is an associated element. L37109 L37110CF L37111 L37112TPFHRP+ L37113FRvoid TtaSelectView(Document document, View view) L56813CF L37114 L37115 L37116 L37117Parameters: L37118 L37119 L37120RP- L37121document L37122: the document containing the eselected lement. L37123 L37124RP- L37125view L37126: one view where the selected element is displayed.( L8023 L8024rV L10322W+) L8025 L8026TtaSelectString L8027* L8028 L8029 L8030RP+ L8031Selects a substring or places the insertion caret within a Text basic element. This substring is highlighted in all views where it can be displayed. L21872 L21873CF L21874 L21875TPFHRP+ L21876void TtaSelectString(Document document, Element textElement, int firstCharacter, int lastCharacter) L8044 L8045 L8046 L8047Parameters: L8048 L8049 L8050RP- L8051document L8052: the document containing the string to be selected. L8053 L8054RP- L8055textElement L8056: the Text element containing the string to be selected. L8057 L8058RP- L8059firstCharacter L8060: position within the text element of the first character to be selected. L8061 L8062RP- L8063lastCharacter L8064: position within the text element of the last character to be selected, 0 if a caret is to be placed before the position of the character of rank firstCharacter.( L8065 L8066rV L10326Y+) L8067 L8068TtaExtendSelection L8069* L8070 L8071 L8072RP+ L8073Extends the current selection to a given element. L21880 L21881CF L21882 L21883TPFHRP+ L21884FRvoid TtaExtendSelection(Document document, Element element, int lastCharacter) L8084 L8085 L8086 L8087Parameters: L8088 L8089 L8090RP- L8091document L8092: the document for which the selection must be extended. L8093 L8094RP- L8095element L8096: the element to which the selection must be extended. L8097 L8098RP- L8099lastCharacter L8100: position within this element of the last character to be selected. 0 if the whole element must be selected. L56814CF( L8102 L8103rV L10330[+) L8104 L8105TtaSelectInterval L8106* L8107 L8108 L8109RP+ L8110If a pair of paired elements is selected, select also all elements between the two paired elements. Nothing is done if the current selection is not a pair. L21888 L21889 L21890 L21891TPFHRP+ L21892 void TtaSelectInterval() L8115 L8116 L8117 L8118Parameter: L8119 L8120 L8121 L8122No parameter L8123 L8124 L8125 L8126Return value: L8127 L8128 L8129 L8130No return value( L8131 L8132rV L10334 +) L8133 L8134TtaUnselect L8135* L8136 L8137 L8138RP+ L8139Turns the selection off for a document. L21896 L21897 L21898 L21899TPFHRP+ L21900FRvoid TtaUnselect(Document document) L8146 L8147 L8148 L8149Parameter: L8150 L8151 L8152RP- L8153document L8154: the document for which the selection must be turned off L8155 L8156 L8157 L8158Return value: L8159 L8160 L8161 L8162No return value( L8164 L8165rV L10338+) L8166 L8167TtaSetSelectionMode L8168* L8169 L8170 L8171RP+ L8172Change selection mode. If withMenu = False functions TtaSelectElement, TtaSelectString, TtaExtendSelection and TtaUnselect do not update the menus that depend on the selection and do not display the selection message. Default mode is withMenu = True. L21904 L21905 L21906 L21907TPFHRP+ L21908void TtaSetSelectionMode(boolean withMenu) L56815CF L8179 L8180 L8181 L8182Parameter: L8183 L8184 L8185RP- L8186withMenu L8187: the new selection mode. L8188 L8189 L8190 L8191Return value: L8192 L8193 L8194 L8195No return value( L8197) L8198 L8199Accessors' L8200( L46785 L46786rV L10342 + ) L46787 L46788TtaGetSelectedDocument L46789 * L46790 L46791 L46792RP+ L46793Returns the selected document. L46794 L46795CF L46796 L46797TPFHRP+ L46798Document TtaGetSelectedDocument () L46799 L46800 L46801 L46802Return value: L46803 L46804 L46805RP- L46806document L46807: the selected document or 0.( L33391 L33392rV L10342 + ) L33393 L33394TtaIsDocumentSelected L33395 * L33396 L33397 L33398RP+ L33399Indicates whether a document is selected. L33400 L33401CF L33402 L33403TPFHRP+ L33404boolean TtaIsDocumentSelected(Document document) L33405 L33406 L33407 L33408Parameter: L33409 L33410 L33411RP- L33412document L33413: the document. L33414 L33415 L33416 L33417Return value: L33418 L33419 L33420RP- L33434True if the current selection concerns this document.( L8201 L8202rV L10342]+) L8203 L8204TtaGiveFirstSelectedElement L8205* L8206 L8207 L8208RP+ L8209Returns the first element in the current selection in a given document. If this element is a Text element and if only a substring is selected, return also the rank of the first and last characters in the selection. If the current selection is an insert caret, the first character follows the last one.  L56816CF L21912 L21913CF L21914 L21915TPFHRP+ L21916void TtaGiveFirstSelectedElement(Document document, Element *selectedElement, int *firstCharacter, int *lastCharacter) L8222 L8223 L8224 L8225Parameter: L8226 L8227 L8228RP- L8229document L8230: the document for which the selection is asked. L8231 L8232 L8233 L8234Return parameters: L8235 L8236 L8237RP- L8238selectedElement L8239: the first selected element, NULL if no element is selected in the document. L8240 L8241RP- L8242firstCharacter L8243: rank of the first character in the selection, or 0 if the whole element is in the selection. L8244 L8245RP- L8246lastCharacter L8247: rank of the last character in the selection, or 0 if the L8248 L8249 L8250whole element is in the selection.( L8251 L8252rV L10346_+) L8253 L8254TtaGiveNextSelectedElement L8255* L8256 L8257 L8258RP+ L8259Returns the element that follows a given element in the current selection in a given document. If this element is a Text element and if only a substring is selected, return also the rank of the first and last characters in the selection. L21920 L21921CF L21922 L21923TPFHRP+ L21924void TtaGiveNextSelectedElement(Document document, Element *selectedElement, int *firstCharacter, int *lastCharacter) L8272 L8273 L8274 L8275Parameters: L8276 L8277 L8278RP- L8279document L8280: the document for which the selection is asked. L8281 L8282RP- L8283selectedElement L8284: the current element. L8286 L8287 L8288 L8289Return parameters: L8290 L8291 L8292RP- L8293selectedElement L8294: the next selected element, NULL if this was the last selected element in the document. L56817CF L8295 L8296RP- L8297firstCharacter L8298: rank of the first character in the selection, or 0 if the whole element is in the selection. L8299 L8300RP- L8301lastCharacter L8302: rank of the last character in the selection, or 0 if the L8303 L8304 L8305whole element is in the selection.( L34092) L34093 L34094Printing* L34095 L34281 L34283 L34286The procedures described in this section are for printing Thot documents. Their use require that file  L34290print.h L34291 be included in the modules that call them. They are available only in the Thot Editor library. L34294 L34293 L34292These procedures let the application launch the printing process, also specify print parameters, and define an export function for pre-processing documents to be printed.' L34102( L34103) L34104 L34105Constructors' L34110( L34111) L34112 L34113TtaPrint* L34114 L34115 L34116 L34117This procedure prints some views of a document with current print parameters. The names of the views to be printed have to be consistant with those given in the presentation schema used for printing. The application may change the presentation schema of the document if it does not match the paper size specified in the parameters (The paper size relative to a presentation schema are given in the  L34343SIT P.conf  L34344file). L34118 L34119 L34120 L34121TPFHRP+ L34122 void TtaPrint(Document document, char *viewName) L34123 L34124 L34125 L34126Paramters: L34127 L34128 L34129RP- L34130 document  L34131: the document to be printed. L34132 L34133RP- L34134viewNames  L34135: the names of the views to be printed, seprated by a blank character. L56818CF( L34136) L34137 L34138Modificators' L34143( L34144) L34145 L34146TtaSetPrintExportProc* L34147 L34304 L34306 L34307This procedure let an application have its own export function before printing a document. If an application wants to pre-process a document before printing it, it can be done by specifing an export procedure used instead the standard one.  L34151 L34152 L34153The export function have to create the pivot file with the given filename and path and save the document to be printed into it. It returns TRUE if the export was succesful. The export function have the following prototype : L34154 L34155FHTPRP+LAC+YC+X C+ L34156boolean exportFunc (Document document, char * docName, char* dirName) L34157 L34158 L34159 L34160TPFHRP+ L34161 void TtaSetPrintExportFunc (Func exportFunc) L34162 L34163 L34164 L34165Parameter: L34166 L34167 L34168RP- L34169 exportProc L34170: the export procedure or NULL to restore the standard export.( L36138) L36139 L36140TtaSetPrintSchema* L36141 L36142 L36143 L36144This procedure defines the presentation schema that has to be used by the editor when printing or saving a PostScript file. By default, he name is "" and the editor searches in the configuration file $STRUCTURE.conf the first presentation schema supporting the current paper format (A4 or US). To return to the default status, the application has to resets the empty name "". L36145 L36146 L36147 L36148TPFHRP+ L36149 void TtaSetPrintSchema (char *name) L36150 L36151 L36152 L36153Parameter : L36154 L36155 L36156RP- L36157 name L36158: The schema name without the suffix .PRS. L56819CF( L34171) L34172 L34173TtaSetPrintParameter* L34174 L34175 L34176 L34177Thit procedure changes a print paramenter. Modifiable parameters belongs to PrintParameter type. The different parameters are listed below, with the range of their values. L34329 L34328 L34327  L34178 L34179 L34319SIT P L34320SQ L34321PrintParameter L34322 L34323 L34326 L34325Range L34180 L34181 L34182PP_FirstPage L34183 L34184 L34185 L341860 to 999 L34187 L34188 L34189PP_LastPage L34190 L34191 L34192 L341930 to 999 L34194 L34195 L34196PP_Scale L34197 L34198 L34199 L3420010 to 300 L34201 L34202 L34203PP_NumberCopies L34204 L34205 L34206 L342071 to 100 L34208 L34209 L34210PP_ManualFeed L34211 L34212 L34213 L34214PP_ON or PP_OFF L34215 L34216 L34217PP_PagesPerSheet L34218 L34219 L34220 L342211, 2 or 4 L34222 L34223 L34224PP_PaperSize L34225 L34226 L34227 L34228PP_A4 or PP_US L34229 L34230 L34231PP_Destination L34232 L34233 L34234 L34235PP_PRINTER or PP_PS L34236 L34237 L34238  L34239 L34240 L34241 L34242FHTPRP+ L34243void TtaSetPrintParameter (PrintParameter parameter, int value)  L34244 L34245 L34246 L34247Parameters: L34248 L34249 L34250RP- L34251 parameter  L34252: A print parameter. L34253 L34254 L34255SIT Pvalue L34256 : The new value of the parameter.( L34257) L34258 L34259TtaSetPrintCommand* L34260 L34333 L34335 L34336This procedure modifies the system printing command called by the editor (the default value is given by the parameter THOTPRINT in  L34345SIT P.thotrc L34346 file). It may be used for changing the printer name or a printer-side printing option. L34267 L34268 L34269 L34270TPFHRP+ L34271 void TtaSetPrintCommand (char *command) L56820CF L34272 L34273 L34274 L34275Parameter: L34276 L34277 L34278RP- L34279 command  L34280: The printing command.( L36049) L36050 L36051TtaSetPsFile* L36052 L36053 L36054 L36055This procedure modifies the current path used by the editor when saving a PostScript file. L36058 L36059 L36060 L36061TPFHRP+ L36062 void TtaSetPsFile (char *path) L36063 L36064 L36065 L36066Parameter : L36067 L36068 L36069RP- L36070 path L36071: The PostScript file path.( L35934) L35935 L35936Accessors' L35947( L35948) L35949 L35950TtaGetPrintParameter* L35951 L35952 L35953 L35954Thit procedure returns a print paramenter value. Modifiable parameters belongs to PrintParameter type. The different parameters are listed below, with the range of their values. L35955 L35956 L35957  L35958 L35959 L35960SIT P L35961SQ L35962PrintParameter L35963 L35964 L35965 L35966Range L35967 L35968 L35969PP_FirstPage L35970 L35971 L35972 L359730 to 999 L35974 L35975 L35976PP_LastPage L35977 L35978 L35979 L359800 to 999 L35981 L35982 L35983PP_Scale L35984 L35985 L35986 L3598710 to 300 L35988 L35989 L35990PP_NumberCopies L35991 L35992 L35993 L359941 to 100 L35995 L35996 L35997PP_ManualFeed L35998 L35999 L36000 L36001PP_ON or PP_OFF L36002 L36003 L36004PP_PagesPerSheet L36005 L36006 L36007 L360081, 2 or 4 L36009 L36010 L36011PP_PaperSize L36012 L36013 L36014 L36015PP_A4 or PP_US L36016 L36017 L36018PP_Destination L36019 L36020 L36021 L36022PP_PRINTER or PP_PS L36023 L36024 L36025  L56821CF L36026 L36027 L36028 L36029FHTPRP+ L36030int TtaGetPrintParameter (PrintParameter parameter)  L36031 L36032 L36033 L36034Parameter: L36035 L36036 L36037RP- L36038 parameter  L36039: A print parameter. L36123 L36124 L36125 L36126Return value: L36127 L36132 L36133 L36136The current value of the parameter.( L36095) L36096 L36097TtaGetPrintCommand* L36098 L36099 L36100 L36101This procedure returns the current printing command. L36104 L36105 L36106 L36107TPFHRP+ L36108 void TtaGetPrintCommand (char *command) L36109 L36110 L36111 L36112Return parameter: L36113 L36114 L36115RP- L36116 command  L36117: The current printing command.( L36074) L36075 L36076TtaGetPsFile* L36077 L36078 L36079 L36080This procedure returns the current path used by the editor when saving a PostScript file. L36081 L36082 L36083 L36084TPFHRP+ L36085 void TtaGetPsFile (char *path) L36086 L36087 L36088 L36089Return parameter: L36090 L36091 L36092RP- L36093 path L36094: The current PostScript file path. L53428 CF L56822CF