dx.all.d.ts 635 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842
  1. /*!
  2. * DevExtreme (dx.all.d.ts)
  3. * Version: 19.1.16
  4. * Build date: Tue Oct 18 2022
  5. *
  6. * Copyright (c) 2012 - 2022 Developer Express Inc. ALL RIGHTS RESERVED
  7. * Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
  8. */
  9. /* #StartGlobalDeclaration */
  10. interface JQuery {
  11. }
  12. interface JQueryPromise<T> {
  13. }
  14. interface JQueryCallback {
  15. }
  16. interface JQueryEventObject {
  17. cancel?: boolean;
  18. }
  19. interface PromiseLike<T> {
  20. }
  21. interface Promise<T> {
  22. then<TResult1 = T, TResult2 = never>(
  23. onfulfilled?: ((value: T, extraParameters: T) => TResult1 | PromiseLike<TResult1>) | undefined | null,
  24. onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null
  25. ): Promise<TResult1 | TResult2>;
  26. }
  27. /* #EndGlobalDeclaration */
  28. /* #StartJQueryAugmentation */
  29. interface JQuery {
  30. dxAccordion(): JQuery;
  31. dxAccordion(options: "instance"): DevExpress.ui.dxAccordion;
  32. dxAccordion(options: string): any;
  33. dxAccordion(options: string, ...params: any[]): any;
  34. dxAccordion(options: DevExpress.ui.dxAccordionOptions): JQuery;
  35. }
  36. interface JQuery {
  37. dxActionSheet(): JQuery;
  38. dxActionSheet(options: "instance"): DevExpress.ui.dxActionSheet;
  39. dxActionSheet(options: string): any;
  40. dxActionSheet(options: string, ...params: any[]): any;
  41. dxActionSheet(options: DevExpress.ui.dxActionSheetOptions): JQuery;
  42. }
  43. interface JQuery {
  44. dxAutocomplete(): JQuery;
  45. dxAutocomplete(options: "instance"): DevExpress.ui.dxAutocomplete;
  46. dxAutocomplete(options: string): any;
  47. dxAutocomplete(options: string, ...params: any[]): any;
  48. dxAutocomplete(options: DevExpress.ui.dxAutocompleteOptions): JQuery;
  49. }
  50. interface JQuery {
  51. dxBox(): JQuery;
  52. dxBox(options: "instance"): DevExpress.ui.dxBox;
  53. dxBox(options: string): any;
  54. dxBox(options: string, ...params: any[]): any;
  55. dxBox(options: DevExpress.ui.dxBoxOptions): JQuery;
  56. }
  57. interface JQuery {
  58. dxButton(): JQuery;
  59. dxButton(options: "instance"): DevExpress.ui.dxButton;
  60. dxButton(options: string): any;
  61. dxButton(options: string, ...params: any[]): any;
  62. dxButton(options: DevExpress.ui.dxButtonOptions): JQuery;
  63. }
  64. interface JQuery {
  65. dxButtonGroup(): JQuery;
  66. dxButtonGroup(options: "instance"): DevExpress.ui.dxButtonGroup;
  67. dxButtonGroup(options: string): any;
  68. dxButtonGroup(options: string, ...params: any[]): any;
  69. dxButtonGroup(options: DevExpress.ui.dxButtonGroupOptions): JQuery;
  70. }
  71. interface JQuery {
  72. dxCalendar(): JQuery;
  73. dxCalendar(options: "instance"): DevExpress.ui.dxCalendar;
  74. dxCalendar(options: string): any;
  75. dxCalendar(options: string, ...params: any[]): any;
  76. dxCalendar(options: DevExpress.ui.dxCalendarOptions): JQuery;
  77. }
  78. interface JQuery {
  79. dxCheckBox(): JQuery;
  80. dxCheckBox(options: "instance"): DevExpress.ui.dxCheckBox;
  81. dxCheckBox(options: string): any;
  82. dxCheckBox(options: string, ...params: any[]): any;
  83. dxCheckBox(options: DevExpress.ui.dxCheckBoxOptions): JQuery;
  84. }
  85. interface JQuery {
  86. dxColorBox(): JQuery;
  87. dxColorBox(options: "instance"): DevExpress.ui.dxColorBox;
  88. dxColorBox(options: string): any;
  89. dxColorBox(options: string, ...params: any[]): any;
  90. dxColorBox(options: DevExpress.ui.dxColorBoxOptions): JQuery;
  91. }
  92. interface JQuery {
  93. dxContextMenu(): JQuery;
  94. dxContextMenu(options: "instance"): DevExpress.ui.dxContextMenu;
  95. dxContextMenu(options: string): any;
  96. dxContextMenu(options: string, ...params: any[]): any;
  97. dxContextMenu(options: DevExpress.ui.dxContextMenuOptions): JQuery;
  98. }
  99. interface JQuery {
  100. dxDataGrid(): JQuery;
  101. dxDataGrid(options: "instance"): DevExpress.ui.dxDataGrid;
  102. dxDataGrid(options: string): any;
  103. dxDataGrid(options: string, ...params: any[]): any;
  104. dxDataGrid(options: DevExpress.ui.dxDataGridOptions): JQuery;
  105. }
  106. interface JQuery {
  107. dxDateBox(): JQuery;
  108. dxDateBox(options: "instance"): DevExpress.ui.dxDateBox;
  109. dxDateBox(options: string): any;
  110. dxDateBox(options: string, ...params: any[]): any;
  111. dxDateBox(options: DevExpress.ui.dxDateBoxOptions): JQuery;
  112. }
  113. interface JQuery {
  114. dxDeferRendering(): JQuery;
  115. dxDeferRendering(options: "instance"): DevExpress.ui.dxDeferRendering;
  116. dxDeferRendering(options: string): any;
  117. dxDeferRendering(options: string, ...params: any[]): any;
  118. dxDeferRendering(options: DevExpress.ui.dxDeferRenderingOptions): JQuery;
  119. }
  120. interface JQuery {
  121. dxDiagram(): JQuery;
  122. dxDiagram(options: "instance"): DevExpress.ui.dxDiagram;
  123. dxDiagram(options: string): any;
  124. dxDiagram(options: string, ...params: any[]): any;
  125. dxDiagram(options: DevExpress.ui.dxDiagramOptions): JQuery;
  126. }
  127. interface JQuery {
  128. dxDrawer(): JQuery;
  129. dxDrawer(options: "instance"): DevExpress.ui.dxDrawer;
  130. dxDrawer(options: string): any;
  131. dxDrawer(options: string, ...params: any[]): any;
  132. dxDrawer(options: DevExpress.ui.dxDrawerOptions): JQuery;
  133. }
  134. interface JQuery {
  135. dxDropDownBox(): JQuery;
  136. dxDropDownBox(options: "instance"): DevExpress.ui.dxDropDownBox;
  137. dxDropDownBox(options: string): any;
  138. dxDropDownBox(options: string, ...params: any[]): any;
  139. dxDropDownBox(options: DevExpress.ui.dxDropDownBoxOptions): JQuery;
  140. }
  141. interface JQuery {
  142. dxDropDownButton(): JQuery;
  143. dxDropDownButton(options: "instance"): DevExpress.ui.dxDropDownButton;
  144. dxDropDownButton(options: string): any;
  145. dxDropDownButton(options: string, ...params: any[]): any;
  146. dxDropDownButton(options: DevExpress.ui.dxDropDownButtonOptions): JQuery;
  147. }
  148. interface JQuery {
  149. dxFileManager(): JQuery;
  150. dxFileManager(options: "instance"): DevExpress.ui.dxFileManager;
  151. dxFileManager(options: string): any;
  152. dxFileManager(options: string, ...params: any[]): any;
  153. dxFileManager(options: DevExpress.ui.dxFileManagerOptions): JQuery;
  154. }
  155. interface JQuery {
  156. dxFileUploader(): JQuery;
  157. dxFileUploader(options: "instance"): DevExpress.ui.dxFileUploader;
  158. dxFileUploader(options: string): any;
  159. dxFileUploader(options: string, ...params: any[]): any;
  160. dxFileUploader(options: DevExpress.ui.dxFileUploaderOptions): JQuery;
  161. }
  162. interface JQuery {
  163. dxFilterBuilder(): JQuery;
  164. dxFilterBuilder(options: "instance"): DevExpress.ui.dxFilterBuilder;
  165. dxFilterBuilder(options: string): any;
  166. dxFilterBuilder(options: string, ...params: any[]): any;
  167. dxFilterBuilder(options: DevExpress.ui.dxFilterBuilderOptions): JQuery;
  168. }
  169. interface JQuery {
  170. dxForm(): JQuery;
  171. dxForm(options: "instance"): DevExpress.ui.dxForm;
  172. dxForm(options: string): any;
  173. dxForm(options: string, ...params: any[]): any;
  174. dxForm(options: DevExpress.ui.dxFormOptions): JQuery;
  175. }
  176. interface JQuery {
  177. dxGallery(): JQuery;
  178. dxGallery(options: "instance"): DevExpress.ui.dxGallery;
  179. dxGallery(options: string): any;
  180. dxGallery(options: string, ...params: any[]): any;
  181. dxGallery(options: DevExpress.ui.dxGalleryOptions): JQuery;
  182. }
  183. interface JQuery {
  184. dxHtmlEditor(): JQuery;
  185. dxHtmlEditor(options: "instance"): DevExpress.ui.dxHtmlEditor;
  186. dxHtmlEditor(options: string): any;
  187. dxHtmlEditor(options: string, ...params: any[]): any;
  188. dxHtmlEditor(options: DevExpress.ui.dxHtmlEditorOptions): JQuery;
  189. }
  190. interface JQuery {
  191. dxList(): JQuery;
  192. dxList(options: "instance"): DevExpress.ui.dxList;
  193. dxList(options: string): any;
  194. dxList(options: string, ...params: any[]): any;
  195. dxList(options: DevExpress.ui.dxListOptions): JQuery;
  196. }
  197. interface JQuery {
  198. dxLoadIndicator(): JQuery;
  199. dxLoadIndicator(options: "instance"): DevExpress.ui.dxLoadIndicator;
  200. dxLoadIndicator(options: string): any;
  201. dxLoadIndicator(options: string, ...params: any[]): any;
  202. dxLoadIndicator(options: DevExpress.ui.dxLoadIndicatorOptions): JQuery;
  203. }
  204. interface JQuery {
  205. dxLoadPanel(): JQuery;
  206. dxLoadPanel(options: "instance"): DevExpress.ui.dxLoadPanel;
  207. dxLoadPanel(options: string): any;
  208. dxLoadPanel(options: string, ...params: any[]): any;
  209. dxLoadPanel(options: DevExpress.ui.dxLoadPanelOptions): JQuery;
  210. }
  211. interface JQuery {
  212. dxLookup(): JQuery;
  213. dxLookup(options: "instance"): DevExpress.ui.dxLookup;
  214. dxLookup(options: string): any;
  215. dxLookup(options: string, ...params: any[]): any;
  216. dxLookup(options: DevExpress.ui.dxLookupOptions): JQuery;
  217. }
  218. interface JQuery {
  219. dxMap(): JQuery;
  220. dxMap(options: "instance"): DevExpress.ui.dxMap;
  221. dxMap(options: string): any;
  222. dxMap(options: string, ...params: any[]): any;
  223. dxMap(options: DevExpress.ui.dxMapOptions): JQuery;
  224. }
  225. interface JQuery {
  226. dxMenu(): JQuery;
  227. dxMenu(options: "instance"): DevExpress.ui.dxMenu;
  228. dxMenu(options: string): any;
  229. dxMenu(options: string, ...params: any[]): any;
  230. dxMenu(options: DevExpress.ui.dxMenuOptions): JQuery;
  231. }
  232. interface JQuery {
  233. dxMultiView(): JQuery;
  234. dxMultiView(options: "instance"): DevExpress.ui.dxMultiView;
  235. dxMultiView(options: string): any;
  236. dxMultiView(options: string, ...params: any[]): any;
  237. dxMultiView(options: DevExpress.ui.dxMultiViewOptions): JQuery;
  238. }
  239. interface JQuery {
  240. dxNavBar(): JQuery;
  241. dxNavBar(options: "instance"): DevExpress.ui.dxNavBar;
  242. dxNavBar(options: string): any;
  243. dxNavBar(options: string, ...params: any[]): any;
  244. dxNavBar(options: DevExpress.ui.dxNavBarOptions): JQuery;
  245. }
  246. interface JQuery {
  247. dxNumberBox(): JQuery;
  248. dxNumberBox(options: "instance"): DevExpress.ui.dxNumberBox;
  249. dxNumberBox(options: string): any;
  250. dxNumberBox(options: string, ...params: any[]): any;
  251. dxNumberBox(options: DevExpress.ui.dxNumberBoxOptions): JQuery;
  252. }
  253. interface JQuery {
  254. dxPivotGrid(): JQuery;
  255. dxPivotGrid(options: "instance"): DevExpress.ui.dxPivotGrid;
  256. dxPivotGrid(options: string): any;
  257. dxPivotGrid(options: string, ...params: any[]): any;
  258. dxPivotGrid(options: DevExpress.ui.dxPivotGridOptions): JQuery;
  259. }
  260. interface JQuery {
  261. dxPivotGridFieldChooser(): JQuery;
  262. dxPivotGridFieldChooser(options: "instance"): DevExpress.ui.dxPivotGridFieldChooser;
  263. dxPivotGridFieldChooser(options: string): any;
  264. dxPivotGridFieldChooser(options: string, ...params: any[]): any;
  265. dxPivotGridFieldChooser(options: DevExpress.ui.dxPivotGridFieldChooserOptions): JQuery;
  266. }
  267. interface JQuery {
  268. dxPopover(): JQuery;
  269. dxPopover(options: "instance"): DevExpress.ui.dxPopover;
  270. dxPopover(options: string): any;
  271. dxPopover(options: string, ...params: any[]): any;
  272. dxPopover(options: DevExpress.ui.dxPopoverOptions): JQuery;
  273. }
  274. interface JQuery {
  275. dxPopup(): JQuery;
  276. dxPopup(options: "instance"): DevExpress.ui.dxPopup;
  277. dxPopup(options: string): any;
  278. dxPopup(options: string, ...params: any[]): any;
  279. dxPopup(options: DevExpress.ui.dxPopupOptions): JQuery;
  280. }
  281. interface JQuery {
  282. dxProgressBar(): JQuery;
  283. dxProgressBar(options: "instance"): DevExpress.ui.dxProgressBar;
  284. dxProgressBar(options: string): any;
  285. dxProgressBar(options: string, ...params: any[]): any;
  286. dxProgressBar(options: DevExpress.ui.dxProgressBarOptions): JQuery;
  287. }
  288. interface JQuery {
  289. dxRadioGroup(): JQuery;
  290. dxRadioGroup(options: "instance"): DevExpress.ui.dxRadioGroup;
  291. dxRadioGroup(options: string): any;
  292. dxRadioGroup(options: string, ...params: any[]): any;
  293. dxRadioGroup(options: DevExpress.ui.dxRadioGroupOptions): JQuery;
  294. }
  295. interface JQuery {
  296. dxRangeSlider(): JQuery;
  297. dxRangeSlider(options: "instance"): DevExpress.ui.dxRangeSlider;
  298. dxRangeSlider(options: string): any;
  299. dxRangeSlider(options: string, ...params: any[]): any;
  300. dxRangeSlider(options: DevExpress.ui.dxRangeSliderOptions): JQuery;
  301. }
  302. interface JQuery {
  303. dxRecurrenceEditor(): JQuery;
  304. dxRecurrenceEditor(options: "instance"): DevExpress.ui.dxRecurrenceEditor;
  305. dxRecurrenceEditor(options: string): any;
  306. dxRecurrenceEditor(options: string, ...params: any[]): any;
  307. dxRecurrenceEditor(options: DevExpress.ui.dxRecurrenceEditorOptions): JQuery;
  308. }
  309. interface JQuery {
  310. dxResizable(): JQuery;
  311. dxResizable(options: "instance"): DevExpress.ui.dxResizable;
  312. dxResizable(options: string): any;
  313. dxResizable(options: string, ...params: any[]): any;
  314. dxResizable(options: DevExpress.ui.dxResizableOptions): JQuery;
  315. }
  316. interface JQuery {
  317. dxResponsiveBox(): JQuery;
  318. dxResponsiveBox(options: "instance"): DevExpress.ui.dxResponsiveBox;
  319. dxResponsiveBox(options: string): any;
  320. dxResponsiveBox(options: string, ...params: any[]): any;
  321. dxResponsiveBox(options: DevExpress.ui.dxResponsiveBoxOptions): JQuery;
  322. }
  323. interface JQuery {
  324. dxScheduler(): JQuery;
  325. dxScheduler(options: "instance"): DevExpress.ui.dxScheduler;
  326. dxScheduler(options: string): any;
  327. dxScheduler(options: string, ...params: any[]): any;
  328. dxScheduler(options: DevExpress.ui.dxSchedulerOptions): JQuery;
  329. }
  330. interface JQuery {
  331. dxScrollView(): JQuery;
  332. dxScrollView(options: "instance"): DevExpress.ui.dxScrollView;
  333. dxScrollView(options: string): any;
  334. dxScrollView(options: string, ...params: any[]): any;
  335. dxScrollView(options: DevExpress.ui.dxScrollViewOptions): JQuery;
  336. }
  337. interface JQuery {
  338. dxSelectBox(): JQuery;
  339. dxSelectBox(options: "instance"): DevExpress.ui.dxSelectBox;
  340. dxSelectBox(options: string): any;
  341. dxSelectBox(options: string, ...params: any[]): any;
  342. dxSelectBox(options: DevExpress.ui.dxSelectBoxOptions): JQuery;
  343. }
  344. interface JQuery {
  345. dxSlideOut(): JQuery;
  346. dxSlideOut(options: "instance"): DevExpress.ui.dxSlideOut;
  347. dxSlideOut(options: string): any;
  348. dxSlideOut(options: string, ...params: any[]): any;
  349. dxSlideOut(options: DevExpress.ui.dxSlideOutOptions): JQuery;
  350. }
  351. interface JQuery {
  352. dxSlideOutView(): JQuery;
  353. dxSlideOutView(options: "instance"): DevExpress.ui.dxSlideOutView;
  354. dxSlideOutView(options: string): any;
  355. dxSlideOutView(options: string, ...params: any[]): any;
  356. dxSlideOutView(options: DevExpress.ui.dxSlideOutViewOptions): JQuery;
  357. }
  358. interface JQuery {
  359. dxSlider(): JQuery;
  360. dxSlider(options: "instance"): DevExpress.ui.dxSlider;
  361. dxSlider(options: string): any;
  362. dxSlider(options: string, ...params: any[]): any;
  363. dxSlider(options: DevExpress.ui.dxSliderOptions): JQuery;
  364. }
  365. interface JQuery {
  366. dxSpeedDialAction(): JQuery;
  367. dxSpeedDialAction(options: "instance"): DevExpress.ui.dxSpeedDialAction;
  368. dxSpeedDialAction(options: string): any;
  369. dxSpeedDialAction(options: string, ...params: any[]): any;
  370. dxSpeedDialAction(options: DevExpress.ui.dxSpeedDialActionOptions): JQuery;
  371. }
  372. interface JQuery {
  373. dxSwitch(): JQuery;
  374. dxSwitch(options: "instance"): DevExpress.ui.dxSwitch;
  375. dxSwitch(options: string): any;
  376. dxSwitch(options: string, ...params: any[]): any;
  377. dxSwitch(options: DevExpress.ui.dxSwitchOptions): JQuery;
  378. }
  379. interface JQuery {
  380. dxTabPanel(): JQuery;
  381. dxTabPanel(options: "instance"): DevExpress.ui.dxTabPanel;
  382. dxTabPanel(options: string): any;
  383. dxTabPanel(options: string, ...params: any[]): any;
  384. dxTabPanel(options: DevExpress.ui.dxTabPanelOptions): JQuery;
  385. }
  386. interface JQuery {
  387. dxTabs(): JQuery;
  388. dxTabs(options: "instance"): DevExpress.ui.dxTabs;
  389. dxTabs(options: string): any;
  390. dxTabs(options: string, ...params: any[]): any;
  391. dxTabs(options: DevExpress.ui.dxTabsOptions): JQuery;
  392. }
  393. interface JQuery {
  394. dxTagBox(): JQuery;
  395. dxTagBox(options: "instance"): DevExpress.ui.dxTagBox;
  396. dxTagBox(options: string): any;
  397. dxTagBox(options: string, ...params: any[]): any;
  398. dxTagBox(options: DevExpress.ui.dxTagBoxOptions): JQuery;
  399. }
  400. interface JQuery {
  401. dxTextArea(): JQuery;
  402. dxTextArea(options: "instance"): DevExpress.ui.dxTextArea;
  403. dxTextArea(options: string): any;
  404. dxTextArea(options: string, ...params: any[]): any;
  405. dxTextArea(options: DevExpress.ui.dxTextAreaOptions): JQuery;
  406. }
  407. interface JQuery {
  408. dxTextBox(): JQuery;
  409. dxTextBox(options: "instance"): DevExpress.ui.dxTextBox;
  410. dxTextBox(options: string): any;
  411. dxTextBox(options: string, ...params: any[]): any;
  412. dxTextBox(options: DevExpress.ui.dxTextBoxOptions): JQuery;
  413. }
  414. interface JQuery {
  415. dxTileView(): JQuery;
  416. dxTileView(options: "instance"): DevExpress.ui.dxTileView;
  417. dxTileView(options: string): any;
  418. dxTileView(options: string, ...params: any[]): any;
  419. dxTileView(options: DevExpress.ui.dxTileViewOptions): JQuery;
  420. }
  421. interface JQuery {
  422. dxToast(): JQuery;
  423. dxToast(options: "instance"): DevExpress.ui.dxToast;
  424. dxToast(options: string): any;
  425. dxToast(options: string, ...params: any[]): any;
  426. dxToast(options: DevExpress.ui.dxToastOptions): JQuery;
  427. }
  428. interface JQuery {
  429. dxToolbar(): JQuery;
  430. dxToolbar(options: "instance"): DevExpress.ui.dxToolbar;
  431. dxToolbar(options: string): any;
  432. dxToolbar(options: string, ...params: any[]): any;
  433. dxToolbar(options: DevExpress.ui.dxToolbarOptions): JQuery;
  434. }
  435. interface JQuery {
  436. dxTooltip(): JQuery;
  437. dxTooltip(options: "instance"): DevExpress.ui.dxTooltip;
  438. dxTooltip(options: string): any;
  439. dxTooltip(options: string, ...params: any[]): any;
  440. dxTooltip(options: DevExpress.ui.dxTooltipOptions): JQuery;
  441. }
  442. interface JQuery {
  443. dxTreeList(): JQuery;
  444. dxTreeList(options: "instance"): DevExpress.ui.dxTreeList;
  445. dxTreeList(options: string): any;
  446. dxTreeList(options: string, ...params: any[]): any;
  447. dxTreeList(options: DevExpress.ui.dxTreeListOptions): JQuery;
  448. }
  449. interface JQuery {
  450. dxTreeView(): JQuery;
  451. dxTreeView(options: "instance"): DevExpress.ui.dxTreeView;
  452. dxTreeView(options: string): any;
  453. dxTreeView(options: string, ...params: any[]): any;
  454. dxTreeView(options: DevExpress.ui.dxTreeViewOptions): JQuery;
  455. }
  456. interface JQuery {
  457. dxValidationGroup(): JQuery;
  458. dxValidationGroup(options: "instance"): DevExpress.ui.dxValidationGroup;
  459. dxValidationGroup(options: string): any;
  460. dxValidationGroup(options: string, ...params: any[]): any;
  461. dxValidationGroup(options: DevExpress.ui.dxValidationGroupOptions): JQuery;
  462. }
  463. interface JQuery {
  464. dxValidationSummary(): JQuery;
  465. dxValidationSummary(options: "instance"): DevExpress.ui.dxValidationSummary;
  466. dxValidationSummary(options: string): any;
  467. dxValidationSummary(options: string, ...params: any[]): any;
  468. dxValidationSummary(options: DevExpress.ui.dxValidationSummaryOptions): JQuery;
  469. }
  470. interface JQuery {
  471. dxValidator(): JQuery;
  472. dxValidator(options: "instance"): DevExpress.ui.dxValidator;
  473. dxValidator(options: string): any;
  474. dxValidator(options: string, ...params: any[]): any;
  475. dxValidator(options: DevExpress.ui.dxValidatorOptions): JQuery;
  476. }
  477. interface JQuery {
  478. dxBarGauge(): JQuery;
  479. dxBarGauge(options: "instance"): DevExpress.viz.dxBarGauge;
  480. dxBarGauge(options: string): any;
  481. dxBarGauge(options: string, ...params: any[]): any;
  482. dxBarGauge(options: DevExpress.viz.dxBarGaugeOptions): JQuery;
  483. }
  484. interface JQuery {
  485. dxBullet(): JQuery;
  486. dxBullet(options: "instance"): DevExpress.viz.dxBullet;
  487. dxBullet(options: string): any;
  488. dxBullet(options: string, ...params: any[]): any;
  489. dxBullet(options: DevExpress.viz.dxBulletOptions): JQuery;
  490. }
  491. interface JQuery {
  492. dxChart(): JQuery;
  493. dxChart(options: "instance"): DevExpress.viz.dxChart;
  494. dxChart(options: string): any;
  495. dxChart(options: string, ...params: any[]): any;
  496. dxChart(options: DevExpress.viz.dxChartOptions): JQuery;
  497. }
  498. interface JQuery {
  499. dxCircularGauge(): JQuery;
  500. dxCircularGauge(options: "instance"): DevExpress.viz.dxCircularGauge;
  501. dxCircularGauge(options: string): any;
  502. dxCircularGauge(options: string, ...params: any[]): any;
  503. dxCircularGauge(options: DevExpress.viz.dxCircularGaugeOptions): JQuery;
  504. }
  505. interface JQuery {
  506. dxFunnel(): JQuery;
  507. dxFunnel(options: "instance"): DevExpress.viz.dxFunnel;
  508. dxFunnel(options: string): any;
  509. dxFunnel(options: string, ...params: any[]): any;
  510. dxFunnel(options: DevExpress.viz.dxFunnelOptions): JQuery;
  511. }
  512. interface JQuery {
  513. dxLinearGauge(): JQuery;
  514. dxLinearGauge(options: "instance"): DevExpress.viz.dxLinearGauge;
  515. dxLinearGauge(options: string): any;
  516. dxLinearGauge(options: string, ...params: any[]): any;
  517. dxLinearGauge(options: DevExpress.viz.dxLinearGaugeOptions): JQuery;
  518. }
  519. interface JQuery {
  520. dxPieChart(): JQuery;
  521. dxPieChart(options: "instance"): DevExpress.viz.dxPieChart;
  522. dxPieChart(options: string): any;
  523. dxPieChart(options: string, ...params: any[]): any;
  524. dxPieChart(options: DevExpress.viz.dxPieChartOptions): JQuery;
  525. }
  526. interface JQuery {
  527. dxPolarChart(): JQuery;
  528. dxPolarChart(options: "instance"): DevExpress.viz.dxPolarChart;
  529. dxPolarChart(options: string): any;
  530. dxPolarChart(options: string, ...params: any[]): any;
  531. dxPolarChart(options: DevExpress.viz.dxPolarChartOptions): JQuery;
  532. }
  533. interface JQuery {
  534. dxRangeSelector(): JQuery;
  535. dxRangeSelector(options: "instance"): DevExpress.viz.dxRangeSelector;
  536. dxRangeSelector(options: string): any;
  537. dxRangeSelector(options: string, ...params: any[]): any;
  538. dxRangeSelector(options: DevExpress.viz.dxRangeSelectorOptions): JQuery;
  539. }
  540. interface JQuery {
  541. dxSankey(): JQuery;
  542. dxSankey(options: "instance"): DevExpress.viz.dxSankey;
  543. dxSankey(options: string): any;
  544. dxSankey(options: string, ...params: any[]): any;
  545. dxSankey(options: DevExpress.viz.dxSankeyOptions): JQuery;
  546. }
  547. interface JQuery {
  548. dxSparkline(): JQuery;
  549. dxSparkline(options: "instance"): DevExpress.viz.dxSparkline;
  550. dxSparkline(options: string): any;
  551. dxSparkline(options: string, ...params: any[]): any;
  552. dxSparkline(options: DevExpress.viz.dxSparklineOptions): JQuery;
  553. }
  554. interface JQuery {
  555. dxTreeMap(): JQuery;
  556. dxTreeMap(options: "instance"): DevExpress.viz.dxTreeMap;
  557. dxTreeMap(options: string): any;
  558. dxTreeMap(options: string, ...params: any[]): any;
  559. dxTreeMap(options: DevExpress.viz.dxTreeMapOptions): JQuery;
  560. }
  561. interface JQuery {
  562. dxVectorMap(): JQuery;
  563. dxVectorMap(options: "instance"): DevExpress.viz.dxVectorMap;
  564. dxVectorMap(options: string): any;
  565. dxVectorMap(options: string, ...params: any[]): any;
  566. dxVectorMap(options: DevExpress.viz.dxVectorMapOptions): JQuery;
  567. }
  568. /* #EndJQueryAugmentation */
  569. declare module DevExpress {
  570. export interface ComponentOptions<T = Component> {
  571. /** A function that is executed before the widget is disposed of. */
  572. onDisposing?: ((e: { component?: T }) => any);
  573. /** A function used in JavaScript frameworks to save the widget instance. */
  574. onInitialized?: ((e: { component?: T, element?: DevExpress.core.dxElement }) => any);
  575. /** A function that is executed after a widget option is changed. */
  576. onOptionChanged?: ((e: { component?: T, name?: string, fullName?: string, value?: any }) => any);
  577. }
  578. /** A base class for all components and widgets. */
  579. export class Component {
  580. constructor(options?: ComponentOptions);
  581. /** Prevents the widget from refreshing until the endUpdate() method is called. */
  582. beginUpdate(): void;
  583. /** Refreshes the widget after a call of the beginUpdate() method. */
  584. endUpdate(): void;
  585. /** Gets the widget's instance. Use it to access other methods of the widget. */
  586. instance(): this;
  587. /** Detaches all event handlers from a single event. */
  588. off(eventName: string): this;
  589. /** Detaches a particular event handler from a single event. */
  590. off(eventName: string, eventHandler: Function): this;
  591. /** Subscribes to an event. */
  592. on(eventName: string, eventHandler: Function): this;
  593. /** Subscribes to events. */
  594. on(events: any): this;
  595. /** Gets all widget options. */
  596. option(): any;
  597. /** Gets the value of a single option. */
  598. option(optionName: string): any;
  599. /** Updates the value of a single option. */
  600. option(optionName: string, optionValue: any): void;
  601. /** Updates the values of several options. */
  602. option(options: any): void;
  603. }
  604. export interface DOMComponentOptions<T = DOMComponent> extends ComponentOptions<T> {
  605. bindingOptions?: any;
  606. /** Specifies the attributes to be attached to the widget's root element. */
  607. elementAttr?: any;
  608. /** Specifies the widget's height. */
  609. height?: number | string | (() => number | string);
  610. /** A function that is executed before the widget is disposed of. */
  611. onDisposing?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  612. /** A function that is executed after a widget option is changed. */
  613. onOptionChanged?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, name?: string, fullName?: string, value?: any }) => any);
  614. /** Switches the widget to a right-to-left representation. */
  615. rtlEnabled?: boolean;
  616. /** Specifies the widget's width. */
  617. width?: number | string | (() => number | string);
  618. }
  619. /** A base class for all components. */
  620. export class DOMComponent extends Component {
  621. constructor(element: Element | JQuery, options?: DOMComponentOptions);
  622. /** Specifies the device-dependent default configuration options for this component. */
  623. static defaultOptions(rule: { device?: Device | Array<Device> | Function, options?: any }): void;
  624. /** Disposes of all the resources allocated to the widget instance. */
  625. dispose(): void;
  626. /** Gets the root widget element. */
  627. element(): DevExpress.core.dxElement;
  628. /** Gets the instance of a widget found using its DOM node. */
  629. static getInstance(element: Element | JQuery): DOMComponent;
  630. }
  631. export class DataHelperMixin {
  632. /** Gets the DataSource instance. */
  633. getDataSource(): DevExpress.data.DataSource;
  634. }
  635. /** The device object defines the device on which the application is running. */
  636. export interface Device {
  637. /** Indicates whether or not the device platform is Android. */
  638. android?: boolean;
  639. /** Specifies the type of the device on which the application is running. */
  640. deviceType?: 'phone' | 'tablet' | 'desktop';
  641. /** Indicates whether or not the device platform is generic, which means that the application will look and behave according to a generic "light" or "dark" theme. */
  642. generic?: boolean;
  643. /** Specifies a performance grade of the current device. */
  644. grade?: 'A' | 'B' | 'C';
  645. /** Indicates whether or not the device platform is iOS. */
  646. ios?: boolean;
  647. /** Indicates whether or not the device type is 'phone'. */
  648. phone?: boolean;
  649. /** Specifies the platform of the device on which the application is running. */
  650. platform?: 'android' | 'ios' | 'win' | 'generic';
  651. /** Indicates whether or not the device type is 'tablet'. */
  652. tablet?: boolean;
  653. /** Specifies an array with the major and minor versions of the device platform. */
  654. version?: Array<number>;
  655. /** Indicates whether or not the device platform is Windows. */
  656. win?: boolean;
  657. }
  658. /** An object that serves as a namespace for the methods and events specifying information on the current device. */
  659. export class DevicesObject {
  660. constructor(options: { window?: Window });
  661. /** Gets information on the current device. */
  662. current(): Device;
  663. /** Overrides actual device information to force the application to operate as if it was running on a specified device. */
  664. current(deviceName: string | Device): void;
  665. /** Detaches all event handlers from a single event. */
  666. off(eventName: string): this;
  667. /** Detaches a particular event handler from a single event. */
  668. off(eventName: string, eventHandler: Function): this;
  669. /** Subscribes to an event. */
  670. on(eventName: string, eventHandler: Function): this;
  671. /** Subscribes to events. */
  672. on(events: any): this;
  673. /** Returns the current device orientation. */
  674. orientation(): string;
  675. /** Returns real information about the current device regardless of the value passed to the DevExpress.devices.current(deviceName) method. */
  676. real(): Device;
  677. }
  678. /** The EndpointSelector is an object for managing OData endpoints in your application. */
  679. export class EndpointSelector {
  680. constructor(options: any);
  681. /** Gets an endpoint with a specific key. */
  682. urlFor(key: string): string;
  683. }
  684. /** The manager that performs several specified animations at a time. */
  685. export class TransitionExecutor {
  686. /** Registers the set of elements that should be animated as "entering" using the specified animation configuration. */
  687. enter(elements: JQuery, animation: animationConfig | string): void;
  688. /** Registers a set of elements that should be animated as "leaving" using the specified animation configuration. */
  689. leave(elements: JQuery, animation: animationConfig | string): void;
  690. /** Deletes all the animations registered in the Transition Executor by using the enter(elements, animation) and leave(elements, animation) methods. */
  691. reset(): void;
  692. /** Starts all the animations registered using the enter(elements, animation) and leave(elements, animation) methods beforehand. */
  693. start(): Promise<void> & JQueryPromise<void>;
  694. /** Stops all started animations. */
  695. stop(): void;
  696. }
  697. /** Defines animation options. */
  698. export interface animationConfig {
  699. /** A function called after animation is completed. */
  700. complete?: (($element: DevExpress.core.dxElement, config: any) => any);
  701. /** A number specifying wait time before animation execution. */
  702. delay?: number;
  703. /** Specifies the animation direction for the "slideIn" and "slideOut" animation types. */
  704. direction?: 'bottom' | 'left' | 'right' | 'top';
  705. /** A number specifying the time in milliseconds spent on animation. */
  706. duration?: number;
  707. /** A string specifying the easing function for animation. */
  708. easing?: string;
  709. /** Specifies the initial animation state. */
  710. from?: number | string | any;
  711. /** A number specifying the time period to wait before the animation of the next stagger item starts. */
  712. staggerDelay?: number;
  713. /** A function called before animation is started. */
  714. start?: (($element: DevExpress.core.dxElement, config: any) => any);
  715. /** Specifies a final animation state. */
  716. to?: number | string | any;
  717. /** A string value specifying the animation type. */
  718. type?: 'css' | 'fade' | 'fadeIn' | 'fadeOut' | 'pop' | 'slide' | 'slideIn' | 'slideOut';
  719. }
  720. /** A repository of animations. */
  721. export class animationPresets {
  722. /** Applies the changes made in the animation repository. */
  723. applyChanges(): void;
  724. /** Removes all animations from the repository. */
  725. clear(): void;
  726. /** Deletes an animation with a specific name. */
  727. clear(name: string): void;
  728. /** Gets the configuration of an animation with a specific name. */
  729. getPreset(name: string): any;
  730. /** Registers predefined animations in the animation repository. */
  731. registerDefaultPresets(): void;
  732. /** Adds an animation with a specific name to the animation repository. */
  733. registerPreset(name: string, config: { animation?: animationConfig, device?: Device }): void;
  734. /** Deletes all custom animations. */
  735. resetToDefaults(): void;
  736. }
  737. /** Gets the current global configuration. */
  738. export function config(): globalConfig;
  739. /** Configures your application before its launch. */
  740. export function config(config: globalConfig): void;
  741. export var devices: DevicesObject;
  742. /** Describes dxEvent, a counterpart of the jQuery.Event to be used without jQuery. */
  743. export class dxEvent {
  744. /** The DOM element within the current event propagation stage. */
  745. currentTarget: Element;
  746. /** Data passed to the event handler. */
  747. data: any;
  748. /** The DOM element to which the currently-called event handler was attached. */
  749. delegateTarget: Element;
  750. /** The DOM element that initiated the event. */
  751. target: Element;
  752. /** Checks if the preventDefault() method was called on this event object. */
  753. isDefaultPrevented(): boolean;
  754. /** Checks if the stopImmediatePropagation() method was called on this event object. */
  755. isImmediatePropagationStopped(): boolean;
  756. /** Checks if the stopPropagation() method was called on this event object. */
  757. isPropagationStopped(): boolean;
  758. /** Prevents the event's default action from triggering. */
  759. preventDefault(): void;
  760. /** Stops the event's propagation up the DOM tree, preventing the rest of the handlers from being executed. */
  761. stopImmediatePropagation(): void;
  762. /** Stops the event's propagation up the DOM tree, keeping parent handlers unnotified of the event. */
  763. stopPropagation(): void;
  764. }
  765. export type event = dxEvent | JQueryEventObject;
  766. export function eventsHandler(event: dxEvent, extraParameters: any): boolean;
  767. /** Specifies settings that affect all DevExtreme widgets. */
  768. export interface globalConfig {
  769. /** A decimal separator. Applies only if you do not use the Globalize or Intl library. */
  770. decimalSeparator?: string;
  771. /** The default currency. Accepts a 3-letter ISO 4217 code. */
  772. defaultCurrency?: string;
  773. /** Specifies how editors' text fields are styled in your application. */
  774. editorStylingMode?: 'outlined' | 'underlined' | 'filled';
  775. /** Configures a Floating Action Button (FAB) that emits a stack of related actions (speed dial). */
  776. floatingActionButtonConfig?: { closeIcon?: string, icon?: string, maxSpeedDialActionCount?: number, position?: 'bottom' | 'center' | 'left' | 'left bottom' | 'left top' | 'right' | 'right bottom' | 'right top' | 'top' | positionConfig | Function };
  777. /** Specifies whether dates are parsed and serialized according to the ISO 8601 standard in all browsers. */
  778. forceIsoDateParsing?: boolean;
  779. /** Specifies whether to convert string values to lowercase in filter and search requests to OData services. Applies to the following operations: "startswith", "endswith", "contains", and "notcontains". */
  780. oDataFilterToLower?: boolean;
  781. /** Specifies whether the widgets support a right-to-left representation. Available for individual widgets as well. */
  782. rtlEnabled?: boolean;
  783. /** The decimal separator that is used when submitting a value to the server. */
  784. serverDecimalSeparator?: string;
  785. /** A group separator. Applies only if you do not use the Globalize or Intl library. */
  786. thousandsSeparator?: string;
  787. useLegacyStoreResult?: boolean;
  788. useLegacyVisibleIndex?: boolean;
  789. }
  790. /** Hides the last displayed overlay widget. */
  791. export function hideTopOverlay(): boolean;
  792. /** An object that serves as a namespace for the methods that are used to localize an application. */
  793. export class localization {
  794. /** Converts a Date object to a string using the specified format. */
  795. static formatDate(value: Date, format: DevExpress.ui.format): string;
  796. /** Substitutes the provided value(s) for placeholders in a message that the key specifies. */
  797. static formatMessage(key: string, value: string | Array<string>): string;
  798. /** Converts a numeric value to a string using the specified format. */
  799. static formatNumber(value: number, format: DevExpress.ui.format): string;
  800. /** Loads localized messages. */
  801. static loadMessages(messages: any): void;
  802. /** Gets the current locale identifier. */
  803. static locale(): string;
  804. /** Sets the current locale identifier. */
  805. static locale(locale: string): void;
  806. /** Parses a string into a Date object. */
  807. static parseDate(text: string, format: DevExpress.ui.format): Date;
  808. /** Parses a string into a numeric value. */
  809. static parseNumber(text: string, format: DevExpress.ui.format): number;
  810. }
  811. /** The position object specifies the widget positioning options. */
  812. export interface positionConfig {
  813. /** The target element position that the widget is positioned against. */
  814. at?: 'bottom' | 'center' | 'left' | 'left bottom' | 'left top' | 'right' | 'right bottom' | 'right top' | 'top' | { x?: 'center' | 'left' | 'right', y?: 'bottom' | 'center' | 'top' };
  815. /** The element within which the widget is positioned. */
  816. boundary?: string | Element | JQuery | Window;
  817. /** Specifies the horizontal and vertical offset from the window's boundaries. */
  818. boundaryOffset?: string | { x?: number, y?: number };
  819. /** Specifies how to move the widget if it overflows the screen. */
  820. collision?: 'fit' | 'fit flip' | 'fit flipfit' | 'fit none' | 'flip' | 'flip fit' | 'flip none' | 'flipfit' | 'flipfit fit' | 'flipfit none' | 'none' | 'none fit' | 'none flip' | 'none flipfit' | { x?: 'fit' | 'flip' | 'flipfit' | 'none', y?: 'fit' | 'flip' | 'flipfit' | 'none' };
  821. /** The position of the widget to align against the target element. */
  822. my?: 'bottom' | 'center' | 'left' | 'left bottom' | 'left top' | 'right' | 'right bottom' | 'right top' | 'top' | { x?: 'center' | 'left' | 'right', y?: 'bottom' | 'center' | 'top' };
  823. /** The target element that the widget is positioned against. */
  824. of?: string | Element | JQuery | Window;
  825. /** Specifies horizontal and vertical offset in pixels. */
  826. offset?: string | { x?: number, y?: number };
  827. }
  828. /** Registers a new component in the DevExpress.ui namespace. */
  829. export function registerComponent(name: string, componentClass: any): void;
  830. /** Registers a new component in the specified namespace. */
  831. export function registerComponent(name: string, namespace: any, componentClass: any): void;
  832. /** An object that serves as a namespace for DevExtreme UI widgets as well as for methods implementing UI logic in DevExtreme sites/applications. */
  833. export class ui {
  834. /** Creates a toast message. */
  835. static notify(message: string, type?: string, displayTime?: number): void;
  836. /** Creates a toast message. */
  837. static notify(options: any, type?: string, displayTime?: number): void;
  838. /** Repaints the Floating Action Button. */
  839. static repaintFloatingActionButton(): void;
  840. /** Sets a template engine. */
  841. static setTemplateEngine(templateEngineName: string): void;
  842. /** Sets a custom template engine defined via custom compile and render functions. */
  843. static setTemplateEngine(templateEngineOptions: { compile?: Function, render?: Function }): void;
  844. }
  845. /** An object that serves as a namespace for the methods required to perform validation. */
  846. export class validationEngine {
  847. /** Gets the default validation group. */
  848. static getGroupConfig(): any;
  849. /** Gets a validation group with a specific key. */
  850. static getGroupConfig(group: string | any): any;
  851. /** Registers all the Validator objects extending fields of the specified ViewModel. */
  852. static registerModelForValidation(model: any): void;
  853. /** Resets the values and validation result of the editors that belong to the default validation group. */
  854. static resetGroup(): void;
  855. /** Resets the values and validation result of the editors that belong to the specified validation group. */
  856. static resetGroup(group: string | any): void;
  857. /** Unregisters all the Validator objects extending fields of the specified ViewModel. */
  858. static unregisterModelForValidation(model: any): void;
  859. /** Validates editors from the default validation group. */
  860. static validateGroup(): DevExpress.ui.dxValidationGroupResult;
  861. /** Validates editors from a specific validation group. */
  862. static validateGroup(group: string | any): DevExpress.ui.dxValidationGroupResult;
  863. /** Validates a view model. */
  864. static validateModel(model: any): any;
  865. }
  866. /** An object that serves as a namespace for DevExtreme Data Visualization Widgets. */
  867. export class viz {
  868. /** Gets the current palette's name. */
  869. static currentPalette(): string;
  870. /** Changes the current palette for all data visualization widgets on the page. */
  871. static currentPalette(paletteName: string): void;
  872. /** Gets the current theme's name. */
  873. static currentTheme(): string;
  874. /** Changes the current theme for all data visualization widgets on the page. The color scheme is defined separately. */
  875. static currentTheme(platform: string, colorScheme: string): void;
  876. /** Changes the current theme for all data visualization widgets on the page. */
  877. static currentTheme(theme: string): void;
  878. /** Allows you to export widgets using their SVG markup. */
  879. static exportFromMarkup(markup: string, options: { fileName?: string, format?: string, backgroundColor?: string, proxyUrl?: string, width?: number, height?: number, onExporting?: Function, onExported?: Function, onFileSaving?: Function, margin?: number }): void;
  880. /** Exports one or several widgets to PNG. */
  881. static exportWidgets(widgetInstances: Array<Array<DOMComponent>>): void;
  882. /** Exports one or several widgets. */
  883. static exportWidgets(widgetInstances: Array<Array<DOMComponent>>, options: { fileName?: string, format?: 'GIF' | 'JPEG' | 'PDF' | 'PNG' | 'SVG', backgroundColor?: string, margin?: number, gridLayout?: boolean, verticalAlignment?: 'bottom' | 'center' | 'top', horizontalAlignment?: 'center' | 'left' | 'right', proxyUrl?: string, onExporting?: Function, onExported?: Function, onFileSaving?: Function }): void;
  884. /** Returns a subset of palette colors. */
  885. static generateColors(palette: 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office' | Array<string>, count: number, options: { paletteExtensionMode?: 'alternate' | 'blend' | 'extrapolate', baseColorSet?: 'simpleSet' | 'indicatingSet' | 'gradientSet' }): Array<string>;
  886. /** Gets the SVG markup of specific widgets for their subsequent export. */
  887. static getMarkup(widgetInstances: Array<DOMComponent>): string;
  888. /** Gets the color sets of a predefined or registered palette. */
  889. static getPalette(paletteName: string): any;
  890. /** Gets a predefined or registered theme's settings. */
  891. static getTheme(theme: string): any;
  892. /** The method to be called every time the active entry in the browser history is modified without reloading the current page. */
  893. static refreshPaths(): void;
  894. /** Refreshes the current theme and palette in all data visualization widgets on the page. */
  895. static refreshTheme(): void;
  896. /** Registers a new palette. */
  897. static registerPalette(paletteName: string, palette: any): void;
  898. /** Registers a new theme based on the existing one. */
  899. static registerTheme(customTheme: any, baseTheme: string): void;
  900. }
  901. }
  902. declare module DevExpress.core {
  903. /** A mixin that provides a capability to fire and subscribe to events. */
  904. export class EventsMixin {
  905. /** Detaches all event handlers from a single event. */
  906. off(eventName: string): this;
  907. /** Detaches a particular event handler from a single event. */
  908. off(eventName: string, eventHandler: Function): this;
  909. /** Subscribes to an event. */
  910. on(eventName: string, eventHandler: Function): this;
  911. /** Subscribes to events. */
  912. on(events: any): this;
  913. }
  914. export type dxElement = Element & JQuery;
  915. }
  916. declare module DevExpress.data {
  917. export interface ArrayStoreOptions<T = ArrayStore> extends StoreOptions<T> {
  918. /** Specifies the store's associated array. */
  919. data?: Array<any>;
  920. }
  921. /** The ArrayStore is a store that provides an interface for loading and editing an in-memory array and handling related events. */
  922. export class ArrayStore extends Store {
  923. constructor(options?: ArrayStoreOptions)
  924. /** Clears all the ArrayStore's associated data. */
  925. clear(): void;
  926. /** Creates a Query for the underlying array. */
  927. createQuery(): any;
  928. }
  929. export interface CustomStoreOptions extends StoreOptions<CustomStore> {
  930. /** Specifies a custom implementation of the byKey(key) method. */
  931. byKey?: ((key: any | string | number) => Promise<any> | JQueryPromise<any>);
  932. /** Specifies whether raw data should be saved in the cache. Applies only if loadMode is "raw". */
  933. cacheRawData?: boolean;
  934. /** Specifies a custom implementation of the insert(values) method. */
  935. insert?: ((values: any) => Promise<any> | JQueryPromise<any>);
  936. /** Specifies a custom implementation of the load(options) method. */
  937. load?: ((options: LoadOptions) => Promise<any> | JQueryPromise<any> | Array<any>);
  938. /** Specifies how data returned by the load function is treated. */
  939. loadMode?: 'processed' | 'raw';
  940. /** Specifies a custom implementation of the remove(key) method. */
  941. remove?: ((key: any | string | number) => Promise<void> | JQueryPromise<void>);
  942. /** Specifies a custom implementation of the totalCount(options) method. */
  943. totalCount?: ((loadOptions: { filter?: any, group?: any }) => Promise<number> | JQueryPromise<number>);
  944. /** Specifies a custom implementation of the update(key, values) method. */
  945. update?: ((key: any | string | number, values: any) => Promise<any> | JQueryPromise<any>);
  946. /** Specifies whether the store combines the search and filter expressions. Defaults to true if the loadMode is "raw" and false if it is "processed". */
  947. useDefaultSearch?: boolean;
  948. }
  949. /** The CustomStore enables you to implement custom data access logic for consuming data from any source. */
  950. export class CustomStore extends Store {
  951. constructor(options?: CustomStoreOptions)
  952. /** Deletes data from the cache. Takes effect only if the cacheRawData option is true. */
  953. clearRawDataCache(): void;
  954. }
  955. export interface DataSourceOptions {
  956. /** Custom parameters that should be passed to an OData service with the load query. Available only for the ODataStore. */
  957. customQueryParams?: any;
  958. /** Specifies the navigation properties to be loaded with the OData entity. Available only for the ODataStore. */
  959. expand?: Array<string> | string;
  960. /** Specifies data filtering conditions. */
  961. filter?: string | Array<any> | Function;
  962. /** Specifies data grouping options. */
  963. group?: string | Array<any> | Function;
  964. /** Specifies an item mapping function. */
  965. map?: ((dataItem: any) => any);
  966. /** A function that is executed after data is loaded. */
  967. onChanged?: ((e: { changes?: Array<any> }) => any);
  968. /** A function that is executed when data loading fails. */
  969. onLoadError?: ((error: { message?: string }) => any);
  970. /** A function that is executed when the data loading status changes. */
  971. onLoadingChanged?: ((isLoading: boolean) => any);
  972. /** Specifies the maximum number of data items per page. Applies only if paginate is true. */
  973. pageSize?: number;
  974. /** Specifies whether the DataSource loads data items by pages or all at once. Defaults to false if group is set; otherwise, true. */
  975. paginate?: boolean;
  976. /** Specifies a post processing function. */
  977. postProcess?: ((data: Array<any>) => Array<any>);
  978. /** Specifies the period (in milliseconds) when changes are aggregated before pushing them to the DataSource. */
  979. pushAggregationTimeout?: number;
  980. /** Specifies whether the DataSource requests the total count of data items in the storage. */
  981. requireTotalCount?: boolean;
  982. /** Specifies whether to reapply sorting, filtering, grouping, and other data processing operations after receiving a push. */
  983. reshapeOnPush?: boolean;
  984. /** Specifies the fields to search. */
  985. searchExpr?: string | Function | Array<string | Function>;
  986. /** Specifies the comparison operation used in searching. The following values are accepted: "=", "<>", ">", ">=", "<", "<=", "startswith", "endswith", "contains", "notcontains". */
  987. searchOperation?: string;
  988. /** Specifies the value to which the search expression is compared. */
  989. searchValue?: any;
  990. /** Specifies the fields to select from data objects. */
  991. select?: string | Array<any> | Function;
  992. /** Specifies data sorting options. */
  993. sort?: string | Array<any> | Function;
  994. /** Configures the store underlying the DataSource. */
  995. store?: Store | StoreOptions | Array<any> | any;
  996. }
  997. /** The DataSource is an object that provides an API for processing data from an underlying store. */
  998. export class DataSource {
  999. constructor(data: Array<any>);
  1000. constructor(options: CustomStoreOptions | DataSourceOptions);
  1001. constructor(store: Store);
  1002. constructor(url: string);
  1003. /** Cancels the load operation with a specific identifier. */
  1004. cancel(): boolean;
  1005. /** Disposes of all the resources allocated to the DataSource instance. */
  1006. dispose(): void;
  1007. /** Gets the filter option's value. */
  1008. filter(): any;
  1009. /** Sets the filter option's value. */
  1010. filter(filterExpr: any): void;
  1011. /** Gets the group option's value. */
  1012. group(): any;
  1013. /** Sets the group option's value. */
  1014. group(groupExpr: any): void;
  1015. /** Checks whether the count of items on the current page is less than the pageSize. Takes effect only with enabled paging. */
  1016. isLastPage(): boolean;
  1017. /** Checks whether data is loaded in the DataSource. */
  1018. isLoaded(): boolean;
  1019. /** Checks whether data is being loaded in the DataSource. */
  1020. isLoading(): boolean;
  1021. /** Gets data items the DataSource performs operations on. */
  1022. items(): Array<any>;
  1023. /** Gets the value of the underlying store's key option. */
  1024. key(): any & string & number;
  1025. /** Starts loading data. */
  1026. load(): Promise<any> & JQueryPromise<any>;
  1027. /** Gets an object with current data processing settings. */
  1028. loadOptions(): any;
  1029. /** Detaches all event handlers from a single event. */
  1030. off(eventName: string): this;
  1031. /** Detaches a particular event handler from a single event. */
  1032. off(eventName: string, eventHandler: Function): this;
  1033. /** Subscribes to an event. */
  1034. on(eventName: string, eventHandler: Function): this;
  1035. /** Subscribes to events. */
  1036. on(events: any): this;
  1037. /** Gets the current page index. */
  1038. pageIndex(): number;
  1039. /** Sets the index of the page that should be loaded on the next load() method call. */
  1040. pageIndex(newIndex: number): void;
  1041. /** Gets the page size. */
  1042. pageSize(): number;
  1043. /** Sets the page size. */
  1044. pageSize(value: number): void;
  1045. /** Gets the paginate option's value. */
  1046. paginate(): boolean;
  1047. /** Sets the paginate option's value. */
  1048. paginate(value: boolean): void;
  1049. /** Clears currently loaded DataSource items and calls the load() method. */
  1050. reload(): Promise<any> & JQueryPromise<any>;
  1051. /** Gets the requireTotalCount option's value. */
  1052. requireTotalCount(): boolean;
  1053. /** Sets the requireTotalCount option's value. */
  1054. requireTotalCount(value: boolean): void;
  1055. /** Gets the searchExpr option's value. */
  1056. searchExpr(): string & Function & Array<string | Function>;
  1057. /** Sets the searchExpr option's value. */
  1058. searchExpr(expr: string | Function | Array<string | Function>): void;
  1059. /** Gets the searchOperation option's value. */
  1060. searchOperation(): string;
  1061. /** Sets the searchOperation option's value. */
  1062. searchOperation(op: string): void;
  1063. /** Gets the searchValue option's value. */
  1064. searchValue(): any;
  1065. /** Sets the searchValue option's value. */
  1066. searchValue(value: any): void;
  1067. /** Gets the select option's value. */
  1068. select(): any;
  1069. /** Sets the select option's value. */
  1070. select(expr: any): void;
  1071. /** Gets the sort option's value. */
  1072. sort(): any;
  1073. /** Sets the sort option's value. */
  1074. sort(sortExpr: any): void;
  1075. /** Gets the instance of the store underlying the DataSource. */
  1076. store(): any;
  1077. /** Gets the number of data items in the store after the last load() operation without paging. Takes effect only if requireTotalCount is true */
  1078. totalCount(): number;
  1079. }
  1080. /** The EdmLiteral is an object for working with primitive data types from the OData's Abstract Type System that are not supported in JavaScript. */
  1081. export class EdmLiteral {
  1082. constructor(value: string);
  1083. /** Gets the EdmLiteral's value converted to a string. */
  1084. valueOf(): string;
  1085. }
  1086. /** The Guid is an object used to generate and contain a GUID. */
  1087. export class Guid {
  1088. constructor();
  1089. constructor(value: string);
  1090. /** Gets the GUID. Works identically to the valueOf() method. */
  1091. toString(): string;
  1092. /** Gets the GUID. Works identically to the toString() method. */
  1093. valueOf(): string;
  1094. }
  1095. /** This section describes the loadOptions object's fields. */
  1096. export interface LoadOptions {
  1097. /** An object for storing additional settings that should be sent to the server. Relevant to the ODataStore only. */
  1098. customQueryParams?: any;
  1099. /** An array of strings that represent the names of navigation properties to be loaded simultaneously with the ODataStore. */
  1100. expand?: any;
  1101. /** A filter expression. */
  1102. filter?: any;
  1103. /** A group expression. */
  1104. group?: any;
  1105. /** A group summary expression. Used with the group setting. */
  1106. groupSummary?: any;
  1107. /** The IDs of the rows being expanded. Relevant only when the CustomStore is used in the TreeList widget. */
  1108. parentIds?: Array<any>;
  1109. /** Indicates whether a top-level group count is required. Used in conjunction with the filter, take, skip, requireTotalCount, and group settings. */
  1110. requireGroupCount?: boolean;
  1111. /** Indicates whether the total count of data objects is needed. */
  1112. requireTotalCount?: boolean;
  1113. /** A data field or expression whose value is compared to the search value. */
  1114. searchExpr?: string | Function | Array<string | Function>;
  1115. /** A comparison operation. Can have one of the following values: "=", "<>", ">", ">=", "<", "<=", "startswith", "endswith", "contains", "notcontains", "isblank" and "isnotblank". */
  1116. searchOperation?: string;
  1117. /** The current search value. */
  1118. searchValue?: any;
  1119. /** A select expression. */
  1120. select?: any;
  1121. /** The number of data objects to be skipped from the result set's start. In conjunction with take, used to implement paging. */
  1122. skip?: number;
  1123. /** A sort expression. */
  1124. sort?: any;
  1125. /** The number of data objects to be loaded. In conjunction with skip, used to implement paging. */
  1126. take?: number;
  1127. /** A total summary expression. */
  1128. totalSummary?: any;
  1129. /** An object for storing additional settings that should be sent to the server. */
  1130. userData?: any;
  1131. }
  1132. export interface LocalStoreOptions extends ArrayStoreOptions<LocalStore> {
  1133. /** Specifies a delay in milliseconds between when data changes and the moment these changes are saved in the local storage. Applies only if immediate is false. */
  1134. flushInterval?: number;
  1135. /** Specifies whether the LocalStore saves changes in the local storage immediately. */
  1136. immediate?: boolean;
  1137. /** Specifies the name under which data should be saved in the local storage. The `dx-data-localStore-` prefix will be added to the name. */
  1138. name?: string;
  1139. }
  1140. /** The LocalStore is a store that provides an interface for loading and editing data from HTML Web Storage (also known as window.localStorage) and handling related events. */
  1141. export class LocalStore extends ArrayStore {
  1142. constructor(options?: LocalStoreOptions)
  1143. /** Removes data from the local storage. */
  1144. clear(): void;
  1145. }
  1146. export interface ODataContextOptions {
  1147. /** Specifies a function that customizes the request before it is sent to the server. */
  1148. beforeSend?: ((options: { url?: string, async?: boolean, method?: string, timeout?: number, params?: any, payload?: any, headers?: any }) => any);
  1149. /** Specifies whether stores in the ODataContext serialize/parse date-time values. */
  1150. deserializeDates?: boolean;
  1151. /** Specifies entity collections to be accessed. */
  1152. entities?: any;
  1153. /** Specifies a function that is executed when the ODataContext throws an error. */
  1154. errorHandler?: ((e: { httpStatus?: number, errorDetails?: any, requestOptions?: any }) => any);
  1155. /** Specifies whether to convert string values to lowercase in filter and search requests. Applies to the following operations: "startswith", "endswith", "contains", and "notcontains". */
  1156. filterToLower?: boolean;
  1157. /** Specifies whether data should be sent using JSONP. */
  1158. jsonp?: boolean;
  1159. /** Specifies the URL of an OData service. */
  1160. url?: string;
  1161. /** Specifies the OData version. */
  1162. version?: number;
  1163. /** Specifies whether to send cookies, authorization headers, and client certificates in a cross-origin request. */
  1164. withCredentials?: boolean;
  1165. }
  1166. /** The ODataContent is an object that provides access to an entire OData service. */
  1167. export class ODataContext {
  1168. constructor(options?: ODataContextOptions)
  1169. /** Invokes an OData operation that returns a value. */
  1170. get(operationName: string, params: any): Promise<any> & JQueryPromise<any>;
  1171. /** Invokes an OData operation that returns nothing. */
  1172. invoke(operationName: string, params: any, httpMethod: any): Promise<void> & JQueryPromise<void>;
  1173. /** Gets a link to an entity with a specific key. */
  1174. objectLink(entityAlias: string, key: any | string | number): any;
  1175. }
  1176. export interface ODataStoreOptions extends StoreOptions<ODataStore> {
  1177. /** Specifies a function that customizes the request before it is sent to the server. */
  1178. beforeSend?: ((options: { url?: string, async?: boolean, method?: string, timeout?: number, params?: any, payload?: any, headers?: any }) => any);
  1179. /** Specifies whether the store serializes/parses date-time values. */
  1180. deserializeDates?: boolean;
  1181. /** Specifies a function that is executed when the ODataStore throws an error. */
  1182. errorHandler?: ((e: { httpStatus?: number, errorDetails?: any, requestOptions?: any }) => any);
  1183. /** Specifies the data field types. Accepts the following types: "String", "Int32", "Int64", "Boolean", "Single", "Decimal" and "Guid". */
  1184. fieldTypes?: any;
  1185. /** Specifies whether to convert string values to lowercase in filter and search requests. Applies to the following operations: "startswith", "endswith", "contains", and "notcontains". */
  1186. filterToLower?: boolean;
  1187. /** Specifies whether data should be sent using JSONP. */
  1188. jsonp?: boolean;
  1189. /** Specifies the type of the key property or properties. */
  1190. keyType?: 'String' | 'Int32' | 'Int64' | 'Guid' | 'Boolean' | 'Single' | 'Decimal' | any;
  1191. /** A function that is executed before data is loaded to the store. */
  1192. onLoading?: ((loadOptions: LoadOptions) => any);
  1193. /** Specifies the URL of an OData entity collection. */
  1194. url?: string;
  1195. /** Specifies the OData version. */
  1196. version?: number;
  1197. /** Specifies whether to send cookies, authorization headers, and client certificates in a cross-origin request. */
  1198. withCredentials?: boolean;
  1199. }
  1200. /** The ODataStore is a store that provides an interface for loading and editing data from an individual OData entity collection and handling related events. */
  1201. export class ODataStore extends Store {
  1202. constructor(options?: ODataStoreOptions)
  1203. /** Gets a data item with a specific key. */
  1204. byKey(key: any | string | number): Promise<any> & JQueryPromise<any>;
  1205. /** Gets an entity with a specific key. */
  1206. byKey(key: any | string | number, extraOptions: { expand?: string | Array<string>, select?: string | Array<string> }): Promise<any> & JQueryPromise<any>;
  1207. /** Creates a Query for the OData endpoint. */
  1208. createQuery(loadOptions: any): any;
  1209. }
  1210. export interface PivotGridDataSourceOptions {
  1211. /** Configures pivot grid fields. */
  1212. fields?: Array<PivotGridDataSourceField>;
  1213. /** Specifies data filtering conditions. Cannot be used with an XmlaStore. */
  1214. filter?: string | Array<any> | Function;
  1215. /** A function that is executed after data is successfully loaded. */
  1216. onChanged?: Function;
  1217. /** A function that is executed when all fields are loaded from the store and they are ready to be displayed in the PivotGrid. */
  1218. onFieldsPrepared?: ((fields: Array<PivotGridDataSourceField>) => any);
  1219. /** A function that is executed when data loading fails. */
  1220. onLoadError?: ((error: any) => any);
  1221. /** A function that is executed when the data loading status changes. */
  1222. onLoadingChanged?: ((isLoading: boolean) => any);
  1223. /** Specifies whether the PivotGridDataSource should load data in portions. Can be used only with an XmlaStore. */
  1224. paginate?: boolean;
  1225. /** Specifies whether the data processing operations (filtering, grouping, summary calculation) should be performed on the server. */
  1226. remoteOperations?: boolean;
  1227. /** Specifies whether to auto-generate pivot grid fields from the store's data. */
  1228. retrieveFields?: boolean;
  1229. /** Configures the DataSource's underlying store. */
  1230. store?: Store | StoreOptions | XmlaStore | XmlaStoreOptions | Array<{ type?: 'array' | 'local' | 'odata' | 'xmla' }> | { type?: 'array' | 'local' | 'odata' | 'xmla' };
  1231. }
  1232. /** Configures pivot grid fields. */
  1233. export interface PivotGridDataSourceField {
  1234. /** Specifies whether to take neighboring groups' summary values into account when calculating a running total and absolute or percent variation. */
  1235. allowCrossGroupCalculation?: boolean;
  1236. /** Specifies whether a user can expand/collapse all items within the same column or row header level using the context menu. */
  1237. allowExpandAll?: boolean;
  1238. /** Specifies whether a user can filter the field's values. */
  1239. allowFiltering?: boolean;
  1240. /** Specifies whether a user can change the field's sorting. */
  1241. allowSorting?: boolean;
  1242. /** Specifies whether a user can sort the pivot grid by summary values instead of field values. */
  1243. allowSortingBySummary?: boolean;
  1244. /** Specifies the field's area. */
  1245. area?: 'column' | 'data' | 'filter' | 'row' | undefined;
  1246. /** Specifies the field's order among the other fields in the same area. Corresponds to the field's order in the fields array by default. */
  1247. areaIndex?: number;
  1248. /** Specifies a custom aggregate function. Applies only if the summaryType is "custom" and the remoteOperations is false. Cannot be used with an XmlaStore. */
  1249. calculateCustomSummary?: ((options: { summaryProcess?: string, value?: any, totalValue?: any }) => any);
  1250. /** Specifies a custom post-processing function for summary values. */
  1251. calculateSummaryValue?: ((e: DevExpress.ui.dxPivotGridSummaryCell) => number);
  1252. /** Specifies the field's caption to be displayed in the field chooser and on the field panel. */
  1253. caption?: string;
  1254. /** Customizes the text displayed in summary cells. */
  1255. customizeText?: ((cellInfo: { value?: string | number | Date, valueText?: string }) => string);
  1256. /** Specifies which data source field provides data for the pivot grid field. */
  1257. dataField?: string;
  1258. /** Casts field values to a specific data type. */
  1259. dataType?: 'date' | 'number' | 'string';
  1260. /** Specifies the name of the folder in which the field is located when displayed in the field chooser. */
  1261. displayFolder?: string;
  1262. /** Specifies whether to expand all items within the field's header level. */
  1263. expanded?: boolean;
  1264. /** Specifies whether a user changes the current filter by including (selecting) or excluding (clearing the selection of) values. */
  1265. filterType?: 'exclude' | 'include';
  1266. /** Specifies the values by which the field is filtered. */
  1267. filterValues?: Array<any>;
  1268. /** Formats field values before they are displayed. */
  1269. format?: DevExpress.ui.format;
  1270. /** Specifies the field's index within its group. */
  1271. groupIndex?: number;
  1272. /** Specifies how the field's values are combined into groups for the headers. Cannot be used with an XmlaStore. */
  1273. groupInterval?: 'day' | 'dayOfWeek' | 'month' | 'quarter' | 'year' | number;
  1274. /** Specifies the name of the field's group. */
  1275. groupName?: string;
  1276. /** Configures the field's header filter. */
  1277. headerFilter?: { allowSearch?: boolean, height?: number, width?: number };
  1278. /** Specifies whether the field should be treated as a measure (a field providing data for calculation). */
  1279. isMeasure?: boolean;
  1280. /** Specifies the field's identifier. */
  1281. name?: string;
  1282. /** Specifies whether to calculate the running total by rows or by columns. */
  1283. runningTotal?: 'column' | 'row';
  1284. /** Specifies a function that combines the field's values into groups for the headers. Cannot be used with an XmlaStore or remote operations. */
  1285. selector?: Function;
  1286. /** Specifies whether to display the field's grand totals. Applies only if the field is in the data area. */
  1287. showGrandTotals?: boolean;
  1288. /** Specifies whether to display the field's totals. */
  1289. showTotals?: boolean;
  1290. /** Specifies whether to display the field's summary values. Applies only if the field is in the data area. Inherits the showTotals' value by default. */
  1291. showValues?: boolean;
  1292. /** Specifies how the field's values in the headers should be sorted. */
  1293. sortBy?: 'displayText' | 'value' | 'none';
  1294. /** Sorts the field's values in the headers by the specified measure's summary values. Accepts the measure's name, caption, dataField, or index in the fields array. */
  1295. sortBySummaryField?: string;
  1296. /** Specifies a path to the column or row whose summary values should be used to sort the field's values in the headers. */
  1297. sortBySummaryPath?: Array<number | string>;
  1298. /** Specifies the field values' sorting order. */
  1299. sortOrder?: 'asc' | 'desc';
  1300. /** Specifies a custom comparison function that sorts the field's values in the headers. */
  1301. sortingMethod?: ((a: { value?: string | number, children?: Array<any> }, b: { value?: string | number, children?: Array<any> }) => number);
  1302. /** Specifies a predefined post-processing function. Does not apply when the calculateSummaryValue option is set. */
  1303. summaryDisplayMode?: 'absoluteVariation' | 'percentOfColumnGrandTotal' | 'percentOfColumnTotal' | 'percentOfGrandTotal' | 'percentOfRowGrandTotal' | 'percentOfRowTotal' | 'percentVariation';
  1304. /** Specifies how to aggregate the field's data. Cannot be used with an XmlaStore. */
  1305. summaryType?: 'avg' | 'count' | 'custom' | 'max' | 'min' | 'sum' | string;
  1306. /** Specifies whether the field is visible in the pivot grid and field chooser. */
  1307. visible?: boolean;
  1308. /** Specifies the field's width in pixels when the field is displayed in the pivot grid. */
  1309. width?: number;
  1310. /** Specifies whether text that does not fit into a header item should be wrapped. */
  1311. wordWrapEnabled?: boolean;
  1312. }
  1313. /** The PivotGridDataSource is an object that provides an API for processing data from an underlying store. This object is used in the PivotGrid widget. */
  1314. export class PivotGridDataSource {
  1315. constructor(options?: PivotGridDataSourceOptions)
  1316. /** Collapses all header items of a field with the specified identifier. */
  1317. collapseAll(id: number | string): void;
  1318. /** Collapses a specific header item. */
  1319. collapseHeaderItem(area: string, path: Array<string | number | Date>): void;
  1320. /** Provides access to the facts that were used to calculate a specific summary value. */
  1321. createDrillDownDataSource(options: { columnPath?: Array<string | number | Date>, rowPath?: Array<string | number | Date>, dataIndex?: number, maxRowCount?: number, customColumns?: Array<string> }): DataSource;
  1322. /** Disposes of all the resources allocated to the PivotGridDataSource instance. */
  1323. dispose(): void;
  1324. /** Expands all the header items of a field with the specified identifier. */
  1325. expandAll(id: number | string): void;
  1326. /** Expands a specific header item. */
  1327. expandHeaderItem(area: string, path: Array<any>): void;
  1328. /** Gets all the options of a field with the specified identifier. */
  1329. field(id: number | string): any;
  1330. /** Updates field options' values. */
  1331. field(id: number | string, options: any): void;
  1332. /** Gets all the fields including those generated automatically. */
  1333. fields(): Array<PivotGridDataSourceField>;
  1334. /** Specifies a new fields collection. */
  1335. fields(fields: Array<PivotGridDataSourceField>): void;
  1336. /** Gets the filter option's value. Does not affect an XmlaStore. */
  1337. filter(): any;
  1338. /** Sets the filter option's value. Does not affect an XmlaStore. */
  1339. filter(filterExpr: any): void;
  1340. /** Gets all the fields within an area. */
  1341. getAreaFields(area: string, collectGroups: boolean): Array<PivotGridDataSourceField>;
  1342. /** Gets the loaded data. Another data portion is loaded every time a header item is expanded. */
  1343. getData(): any;
  1344. /** Checks whether the PivotGridDataSource is loading data. */
  1345. isLoading(): boolean;
  1346. /** Starts loading data. */
  1347. load(): Promise<any> & JQueryPromise<any>;
  1348. /** Detaches all event handlers from a single event. */
  1349. off(eventName: string): this;
  1350. /** Detaches a particular event handler from a single event. */
  1351. off(eventName: string, eventHandler: Function): this;
  1352. /** Subscribes to an event. */
  1353. on(eventName: string, eventHandler: Function): this;
  1354. /** Subscribes to events. */
  1355. on(events: any): this;
  1356. /** Clears the loaded PivotGridDataSource data and calls the load() method. */
  1357. reload(): Promise<any> & JQueryPromise<any>;
  1358. /** Gets the current PivotGridDataSource state. */
  1359. state(): any;
  1360. /** Sets the PivotGridDataSource state. */
  1361. state(state: any): void;
  1362. }
  1363. /** The Query is an object that provides a chainable interface for making data queries. */
  1364. export class Query {
  1365. /** Calculates a custom summary for all data items. */
  1366. aggregate(seed: any, step: Function, finalize: Function): Promise<any> & JQueryPromise<any>;
  1367. /** Calculates a custom summary for all data items. */
  1368. aggregate(step: Function): Promise<any> & JQueryPromise<any>;
  1369. /** Calculates the average of all values. Applies only to numeric arrays. */
  1370. avg(): Promise<number> & JQueryPromise<number>;
  1371. /** Calculates the average of all values found using a getter. */
  1372. avg(getter: any): Promise<number> & JQueryPromise<number>;
  1373. /** Calculates the number of data items. */
  1374. count(): Promise<number> & JQueryPromise<number>;
  1375. /** Executes the Query. This is an asynchronous alternative to the toArray() method. */
  1376. enumerate(): Promise<any> & JQueryPromise<any>;
  1377. /** Filters data items using a filter expression. */
  1378. filter(criteria: Array<any>): Query;
  1379. /** Filters data items using a custom function. */
  1380. filter(predicate: Function): Query;
  1381. /** Groups data items by the specified getter. */
  1382. groupBy(getter: any): Query;
  1383. /** Calculates the maximum value. Applies only to numeric arrays. */
  1384. max(): Promise<number | Date> & JQueryPromise<number | Date>;
  1385. /** Calculates the maximum of all values found using a getter. */
  1386. max(getter: any): Promise<number | Date> & JQueryPromise<number | Date>;
  1387. /** Calculates the minimum value. Applies only to numeric arrays. */
  1388. min(): Promise<number | Date> & JQueryPromise<number | Date>;
  1389. /** Calculates the minumum of all values found using a getter. */
  1390. min(getter: any): Promise<number | Date> & JQueryPromise<number | Date>;
  1391. /** Selects individual fields from data objects. */
  1392. select(getter: any): Query;
  1393. /** Gets a specified number of data items starting from a given index. */
  1394. slice(skip: number, take?: number): Query;
  1395. /** Sorts data items by the specified getter in ascending order. */
  1396. sortBy(getter: any): Query;
  1397. /** Sorts data items by the specified getter in the specified sorting order. */
  1398. sortBy(getter: any, desc: boolean): Query;
  1399. /** Calculates the sum of all values. */
  1400. sum(): Promise<number> & JQueryPromise<number>;
  1401. /** Calculates the sum of all values found using a getter. */
  1402. sum(getter: any): Promise<number> & JQueryPromise<number>;
  1403. /** Sorts data items by one more getter in ascending order. */
  1404. thenBy(getter: any): Query;
  1405. /** Sorts data items by one more getter in the specified sorting order. */
  1406. thenBy(getter: any, desc: boolean): Query;
  1407. /** Gets data items associated with the Query. This is a synchronous alternative to the enumerate() method. */
  1408. toArray(): Array<any>;
  1409. }
  1410. export interface StoreOptions<T = Store> {
  1411. /** Specifies the function that is executed when the store throws an error. */
  1412. errorHandler?: Function;
  1413. /** Specifies the key property (or properties) used to access data items. */
  1414. key?: string | Array<string>;
  1415. /** A function that is executed after a data item is added to the store. */
  1416. onInserted?: ((values: any, key: any | string | number) => any);
  1417. /** A function that is executed before a data item is added to the store. */
  1418. onInserting?: ((values: any) => any);
  1419. /** A function that is executed after data is loaded to the store. */
  1420. onLoaded?: ((result: Array<any>) => any);
  1421. /** A function that is executed before data is loaded to the store. */
  1422. onLoading?: ((loadOptions: LoadOptions) => any);
  1423. /** A function that is executed after a data item is added, updated, or removed from the store. */
  1424. onModified?: Function;
  1425. /** A function that is executed before a data item is added, updated, or removed from the store. */
  1426. onModifying?: Function;
  1427. /** The function executed before changes are pushed to the store. */
  1428. onPush?: ((changes: Array<any>) => any);
  1429. /** A function that is executed after a data item is removed from the store. */
  1430. onRemoved?: ((key: any | string | number) => any);
  1431. /** A function that is executed before a data item is removed from the store. */
  1432. onRemoving?: ((key: any | string | number) => any);
  1433. /** A function that is executed after a data item is updated in the store. */
  1434. onUpdated?: ((key: any | string | number, values: any) => any);
  1435. /** A function that is executed before a data item is updated in the store. */
  1436. onUpdating?: ((key: any | string | number, values: any) => any);
  1437. }
  1438. /** The base class for all Stores. */
  1439. export class Store {
  1440. constructor(options?: StoreOptions)
  1441. /** Gets a data item with a specific key. */
  1442. byKey(key: any | string | number): Promise<any> & JQueryPromise<any>;
  1443. /** Adds a data item to the store. */
  1444. insert(values: any): Promise<any> & JQueryPromise<any>;
  1445. /** Gets the key property (or properties) as specified in the key option. */
  1446. key(): any;
  1447. /** Gets a data item's key value. */
  1448. keyOf(obj: any): any;
  1449. /** Starts loading data. */
  1450. load(): Promise<any> & JQueryPromise<any>;
  1451. /** Starts loading data. */
  1452. load(options: LoadOptions): Promise<any> & JQueryPromise<any>;
  1453. /** Detaches all event handlers from a single event. */
  1454. off(eventName: string): this;
  1455. /** Detaches a particular event handler from a single event. */
  1456. off(eventName: string, eventHandler: Function): this;
  1457. /** Subscribes to an event. */
  1458. on(eventName: string, eventHandler: Function): this;
  1459. /** Subscribes to events. */
  1460. on(events: any): this;
  1461. /** Pushes data changes to the store and notifies the DataSource. */
  1462. push(changes: Array<any>): void;
  1463. /** Removes a data item with a specific key from the store. */
  1464. remove(key: any | string | number): Promise<void> & JQueryPromise<void>;
  1465. /** Gets the total count of items the load() function returns. */
  1466. totalCount(obj: { filter?: any, group?: any }): Promise<number> & JQueryPromise<number>;
  1467. /** Updates a data item with a specific key. */
  1468. update(key: any | string | number, values: any): Promise<any> & JQueryPromise<any>;
  1469. }
  1470. export interface XmlaStoreOptions {
  1471. /** Specifies a function that customizes the request before it is sent to the server. */
  1472. beforeSend?: ((options: { url?: string, method?: string, headers?: any, xhrFields?: any, data?: string, dataType?: string }) => any);
  1473. /** Specifies the database (or initial catalog) that contains the OLAP cube to use. */
  1474. catalog?: string;
  1475. /** Specifies the name of the OLAP cube to use from the catalog. */
  1476. cube?: string;
  1477. /** Specifies the OLAP server's URL. */
  1478. url?: string;
  1479. }
  1480. /** The XmlaStore is a store that provides an interface for accessing an OLAP cube according to the XMLA standard. */
  1481. export class XmlaStore {
  1482. constructor(options?: XmlaStoreOptions)
  1483. }
  1484. /** Encodes a string or array of bytes in Base64. */
  1485. export function base64_encode(input: string | Array<number>): string;
  1486. /** Specifies the function that is executed when a data layer object throws an error. */
  1487. export function errorHandler(e: Error): void;
  1488. /** Creates a Query instance. */
  1489. export function query(array: Array<any>): Query;
  1490. /** Creates a Query instance that accesses a remote data service using its URL. */
  1491. export function query(url: string, queryOptions: any): Query;
  1492. }
  1493. declare module DevExpress.data.utils {
  1494. /** Compiles a getter function from a getter expression. */
  1495. export function compileGetter(expr: string | Array<string>): Function;
  1496. /** Compiles a setter function from a setter expression. */
  1497. export function compileSetter(expr: string | Array<string>): Function;
  1498. }
  1499. declare module DevExpress.data.utils.odata {
  1500. /** Contains built-in OData type converters (for String, Int32, Int64, Boolean, Single, Decimal, and Guid) and allows you to register a custom type converter. */
  1501. export var keyConverters: any;
  1502. }
  1503. declare module DevExpress.events {
  1504. /** Detaches all handlers from the specified elements. */
  1505. export function off(element: Element | Array<Element>): void;
  1506. /** Detaches all handlers of the specified event from the specified elements. */
  1507. export function off(element: Element | Array<Element>, eventName: string): void;
  1508. /** Detaches an event handler from the specified elements. */
  1509. export function off(element: Element | Array<Element>, eventName: string, handler: Function): void;
  1510. /** Detaches all event handlers of the specified type attached using the on(element, eventName, selector, data, handler) or on(element, eventName, selector, handler) method. */
  1511. export function off(element: Element | Array<Element>, eventName: string, selector: string): void;
  1512. /** Detaches the specified event handler attached using the on(element, eventName, selector, data, handler) or on(element, eventName, selector, handler) method. */
  1513. export function off(element: Element | Array<Element>, eventName: string, selector: string, handler: Function): void;
  1514. /** Attaches an event handler to the specified elements. Allows you to pass custom data to the handler. */
  1515. export function on(element: Element | Array<Element>, eventName: string, data: any, handler: Function): void;
  1516. /** Attaches an event handler to the specified elements. */
  1517. export function on(element: Element | Array<Element>, eventName: string, handler: Function): void;
  1518. /** Attaches an event handler to the specified elements' descendants. Allows you to pass custom data to the handler. */
  1519. export function on(element: Element | Array<Element>, eventName: string, selector: string, data: any, handler: Function): void;
  1520. /** Attaches an event handler to the specified elements' descendants. */
  1521. export function on(element: Element | Array<Element>, eventName: string, selector: string, handler: Function): void;
  1522. /** Attaches an event handler that is executed only once to the specified elements. Allows you to pass custom data to the handler. */
  1523. export function one(element: Element | Array<Element>, eventName: string, data: any, handler: Function): void;
  1524. /** Attaches an event handler that is executed only once to the specified elements. */
  1525. export function one(element: Element | Array<Element>, eventName: string, handler: Function): void;
  1526. /** Attaches an event handler that is executed only once to the specified elements' descendants. Allows you to pass custom data to the handler. */
  1527. export function one(element: Element | Array<Element>, eventName: string, selector: string, data: any, handler: Function): void;
  1528. /** Attaches an event handler that is executed only once to the specified elements' descendants. */
  1529. export function one(element: Element | Array<Element>, eventName: string, selector: string, handler: Function): void;
  1530. /** Triggers an event for the specified elements. */
  1531. export function trigger(element: Element | Array<Element>, event: string | event): void;
  1532. /** Triggers an event for the specified elements. Allows you to pass custom parameters to event handlers. */
  1533. export function trigger(element: Element | Array<Element>, event: string | event, extraParameters: any): void;
  1534. export function triggerHandler(element: Element | Array<Element>, event: string | event): void;
  1535. export function triggerHandler(element: Element | Array<Element>, event: string | event, extraParameters: any): void;
  1536. }
  1537. declare module DevExpress.exporter {
  1538. /** A DataGrid cell to be exported to Excel. */
  1539. export interface ExcelDataGridCell {
  1540. /** The configuration of the cell's column. */
  1541. column?: DevExpress.ui.dxDataGridColumn;
  1542. /** The data object of the cell's row. */
  1543. data?: any;
  1544. /** The group index of the cell's row. Available when the rowType is "group". */
  1545. groupIndex?: number;
  1546. /** Information about group summary items the cell represents. */
  1547. groupSummaryItems?: Array<{ name?: string, value?: any }>;
  1548. /** The type of the cell's row. */
  1549. rowType?: string;
  1550. /** The identifier of the total summary item that the cell represents. */
  1551. totalSummaryItemName?: string;
  1552. /** The cell's raw value. */
  1553. value?: any;
  1554. }
  1555. /** An object that configures the font in an Excel cell. */
  1556. export interface ExcelFont {
  1557. /** Specifies whether the text should be in bold. */
  1558. bold?: boolean;
  1559. /** The text's color in hexadecimal characters. */
  1560. color?: string;
  1561. /** Specifies whether the text should be in italic. */
  1562. italic?: boolean;
  1563. /** The name of the typeface that should be applied to the text. */
  1564. name?: string;
  1565. /** The font size specified in points (1/72 of an inch). */
  1566. size?: number;
  1567. /** The underline formatting style. */
  1568. underline?: 'double' | 'doubleAccounting' | 'none' | 'single' | 'singleAccounting';
  1569. }
  1570. }
  1571. declare module DevExpress.fx {
  1572. /** Animates an element. */
  1573. export function animate(element: Element, config: animationConfig): Promise<void> & JQueryPromise<void>;
  1574. /** Checks whether an element is being animated. */
  1575. export function isAnimating(element: Element): boolean;
  1576. /** Stops an element's animation. */
  1577. export function stop(element: Element, jumpToEnd: boolean): void;
  1578. }
  1579. declare module DevExpress.ui {
  1580. export interface AjaxFileProviderOptions extends FileProviderOptions<AjaxFileProvider> {
  1581. /** Specifies which data field provides information about nested files and directories. */
  1582. itemsExpr?: string | Function;
  1583. /** Specifies the URL used to load an array of JSON objects that represent files and directories. */
  1584. url?: string;
  1585. }
  1586. /** The Ajax file provider works with a virtual file system represented by an array of JSON objects loaded from a URL. */
  1587. export class AjaxFileProvider extends FileProvider {
  1588. constructor(options?: AjaxFileProviderOptions)
  1589. }
  1590. export interface ArrayFileProviderOptions extends FileProviderOptions<ArrayFileProvider> {
  1591. /** Specifies an array of data objects that represent files and directories. */
  1592. data?: Array<any>;
  1593. /** Specifies which data field provides information about nested files and directories. */
  1594. itemsExpr?: string | Function;
  1595. }
  1596. /** The Array file provider works with a virtual file system represented by an in-memory array of JSON objects. */
  1597. export class ArrayFileProvider extends FileProvider {
  1598. constructor(options?: ArrayFileProviderOptions)
  1599. }
  1600. /** Specifies dependency between the screen factor and the count of columns. */
  1601. export interface ColCountResponsible {
  1602. /** The count of columns for a large screen size. */
  1603. lg?: number;
  1604. /** The count of columns for a middle-sized screen. */
  1605. md?: number;
  1606. /** The count of columns for a small-sized screen. */
  1607. sm?: number;
  1608. /** The count of columns for an extra small-sized screen. */
  1609. xs?: number;
  1610. }
  1611. export interface CollectionWidgetOptions<T = CollectionWidget> extends WidgetOptions<T> {
  1612. /** Binds the widget to data. */
  1613. dataSource?: string | Array<string | CollectionWidgetItem> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions;
  1614. /** The time period in milliseconds before the onItemHold event is raised. */
  1615. itemHoldTimeout?: number;
  1616. /** Specifies a custom template for items. */
  1617. itemTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  1618. /** An array of items displayed by the widget. */
  1619. items?: Array<string | CollectionWidgetItem | any>;
  1620. /** Specifies which data field provides keys for widget items. */
  1621. keyExpr?: string | Function;
  1622. /** The text or HTML markup displayed by the widget if the item collection is empty. */
  1623. noDataText?: string;
  1624. /** A function that is executed when a collection item is clicked or tapped. */
  1625. onItemClick?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, jQueryEvent?: JQueryEventObject, event?: event }) => any) | string;
  1626. /** A function that is executed when a collection item is right-clicked or pressed. */
  1627. onItemContextMenu?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  1628. /** A function that is executed when a collection item has been held for a specified period. */
  1629. onItemHold?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, event?: event }) => any);
  1630. /** A function that is executed after a collection item is rendered. */
  1631. onItemRendered?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number }) => any);
  1632. /** A function that is executed when a collection item is selected or selection is canceled. */
  1633. onSelectionChanged?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, addedItems?: Array<any>, removedItems?: Array<any> }) => any);
  1634. /** The index of the currently selected widget item. */
  1635. selectedIndex?: number;
  1636. /** The selected item object. */
  1637. selectedItem?: any;
  1638. /** Specifies an array of currently selected item keys. */
  1639. selectedItemKeys?: Array<any>;
  1640. /** An array of currently selected item objects. */
  1641. selectedItems?: Array<any>;
  1642. }
  1643. /** The base class for widgets containing an item collection. */
  1644. export class CollectionWidget extends Widget {
  1645. constructor(element: Element, options?: CollectionWidgetOptions)
  1646. constructor(element: JQuery, options?: CollectionWidgetOptions)
  1647. /** Gets the DataSource instance. */
  1648. getDataSource(): DevExpress.data.DataSource;
  1649. }
  1650. /** This section lists the data source fields that are used in a default item template. */
  1651. export interface CollectionWidgetItem {
  1652. /** Specifies whether a widget item should be disabled. */
  1653. disabled?: boolean;
  1654. /** Specifies html code inserted into the widget item element. */
  1655. html?: string;
  1656. /** Specifies an item template that should be used to render this item only. */
  1657. template?: template | (() => string | Element | JQuery);
  1658. /** Specifies text displayed for the widget item. */
  1659. text?: string;
  1660. /** Specifies whether or not a widget item must be displayed. */
  1661. visible?: boolean;
  1662. }
  1663. /** A validation rule that demands that a validated editor has a value that is equal to a specified expression. */
  1664. export interface CompareRule {
  1665. /** Specifies the function whose return value is used for comparison with the validated value. */
  1666. comparisonTarget?: (() => any);
  1667. /** Specifies the operator to be used for comparing the validated value with the target. */
  1668. comparisonType?: '!=' | '!==' | '<' | '<=' | '==' | '===' | '>' | '>=';
  1669. /** If set to true, empty values are valid. */
  1670. ignoreEmptyValue?: boolean;
  1671. /** Specifies the message that is shown for end-users if the current rule is broken. */
  1672. message?: string;
  1673. /** Indicates whether or not the rule should be always checked for the target value or only when the target value changes. */
  1674. reevaluate?: boolean;
  1675. /** Specifies the type of the current rule. */
  1676. type?: 'required' | 'numeric' | 'range' | 'stringLength' | 'custom' | 'compare' | 'pattern' | 'email';
  1677. }
  1678. /** A validation rule with custom validation logic. */
  1679. export interface CustomRule {
  1680. /** Specifies whether the validationCallback should be called for null and undefined values. */
  1681. ignoreEmptyValue?: boolean;
  1682. /** Specifies the message that is shown for end-users if the current rule is broken. */
  1683. message?: string;
  1684. /** Indicates whether the rule should be always checked for the target value or only when the target value changes. */
  1685. reevaluate?: boolean;
  1686. /** Specifies the type of the current rule. */
  1687. type?: 'required' | 'numeric' | 'range' | 'stringLength' | 'custom' | 'compare' | 'pattern' | 'email';
  1688. /** A function that validates the target value. */
  1689. validationCallback?: ((options: { value?: string | number, rule?: any, validator?: any, data?: any }) => boolean);
  1690. }
  1691. export interface DataExpressionMixinOptions<T = DataExpressionMixin> {
  1692. /** Binds the widget to data. */
  1693. dataSource?: string | Array<CollectionWidgetItem | any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions;
  1694. /** Specifies the data field whose values should be displayed. */
  1695. displayExpr?: string | ((item: any) => any);
  1696. /** Specifies a custom template for items. */
  1697. itemTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  1698. /** An array of items displayed by the widget. */
  1699. items?: Array<CollectionWidgetItem | any>;
  1700. /** Specifies the currently selected value. May be an object if dataSource contains objects and valueExpr is not set. */
  1701. value?: any;
  1702. /** Specifies which data field provides unique values to the widget's value. */
  1703. valueExpr?: string | Function;
  1704. }
  1705. export class DataExpressionMixin {
  1706. constructor(options?: DataExpressionMixinOptions)
  1707. /** Gets the DataSource instance. */
  1708. getDataSource(): DevExpress.data.DataSource;
  1709. }
  1710. /** The DiagramDataSourceParameters object. */
  1711. export interface DiagramDataSourceParameters {
  1712. /** The edges. */
  1713. edges?: { dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions, fromExpr?: string | ((data: any) => any), keyExpr?: string | ((data: any) => any), toExpr?: string | ((data: any) => any) };
  1714. /** The key. */
  1715. key?: string;
  1716. /** The layout. */
  1717. layout?: 'tree' | 'sugiyama';
  1718. /** The nodes. */
  1719. nodes?: { dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions, itemsExpr?: string | ((data: any) => any), keyExpr?: string | ((data: any) => any), parentKeyExpr?: string | ((data: any) => any), textExpr?: string | ((data: any) => any), typeExpr?: string | ((data: any) => any) };
  1720. /** The title. */
  1721. title?: string;
  1722. }
  1723. export interface EditorOptions<T = Editor> extends WidgetOptions<T> {
  1724. /** Specifies whether the editor's value is valid. */
  1725. isValid?: boolean;
  1726. /** A function that is executed after the widget's value is changed. */
  1727. onValueChanged?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, value?: any, previousValue?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  1728. /** Specifies whether the editor is read-only. */
  1729. readOnly?: boolean;
  1730. /** Specifies information on the validation error when using a custom validation engine. Should be changed at runtime along with the isValid option. */
  1731. validationError?: any;
  1732. /** Specifies how the message about the validation rules that are not satisfied by this editor's value is displayed. */
  1733. validationMessageMode?: 'always' | 'auto';
  1734. /** Specifies the widget's value. */
  1735. value?: any;
  1736. }
  1737. /** A base class for editors. */
  1738. export class Editor extends Widget {
  1739. constructor(element: Element, options?: EditorOptions)
  1740. constructor(element: JQuery, options?: EditorOptions)
  1741. /** Resets the value option to the default value. */
  1742. reset(): void;
  1743. }
  1744. /** A validation rule that demands that the validated field match the Email pattern. */
  1745. export interface EmailRule {
  1746. /** If set to true, empty values are valid. */
  1747. ignoreEmptyValue?: boolean;
  1748. /** Specifies the message that is shown for end-users if the current rule is broken. */
  1749. message?: string;
  1750. /** Specifies the type of the current rule. */
  1751. type?: 'required' | 'numeric' | 'range' | 'stringLength' | 'custom' | 'compare' | 'pattern' | 'email';
  1752. }
  1753. export interface FileProviderOptions<T = FileProvider> {
  1754. /** Specifies which data field provides timestamps that indicate when a file was last modified. */
  1755. dateModifiedExpr?: string | Function;
  1756. /** Specifies which data field provides information about whether a file system item is a directory. */
  1757. isDirectoryExpr?: string | Function;
  1758. /** Specifies which data field provides file and directory names. */
  1759. nameExpr?: string | Function;
  1760. /** Specifies which data field provides file sizes. */
  1761. sizeExpr?: string | Function;
  1762. /** Specifies which data field provides icons to be used as thumbnails. */
  1763. thumbnailExpr?: string | Function;
  1764. }
  1765. export class FileProvider {
  1766. constructor(options?: FileProviderOptions)
  1767. }
  1768. export interface GridBaseOptions<T = GridBase> extends WidgetOptions<T> {
  1769. /** Specifies whether a user can reorder columns. */
  1770. allowColumnReordering?: boolean;
  1771. /** Specifies whether a user can resize columns. */
  1772. allowColumnResizing?: boolean;
  1773. /** Specifies whether data should be cached. */
  1774. cacheEnabled?: boolean;
  1775. /** Enables a hint that appears when a user hovers the mouse pointer over a cell with truncated content. */
  1776. cellHintEnabled?: boolean;
  1777. /** Specifies whether columns should adjust their widths to the content. */
  1778. columnAutoWidth?: boolean;
  1779. /** Configures the column chooser. */
  1780. columnChooser?: { allowSearch?: boolean, emptyPanelText?: string, enabled?: boolean, height?: number, mode?: 'dragAndDrop' | 'select', searchTimeout?: number, title?: string, width?: number };
  1781. /** Configures column fixing. */
  1782. columnFixing?: { enabled?: boolean, texts?: { fix?: string, leftPosition?: string, rightPosition?: string, unfix?: string } };
  1783. /** Specifies whether the widget should hide columns to adapt to the screen or container size. Ignored if allowColumnResizing is true and columnResizingMode is "widget". */
  1784. columnHidingEnabled?: boolean;
  1785. /** Specifies the minimum width of columns. */
  1786. columnMinWidth?: number;
  1787. /** Specifies how the widget resizes columns. Applies only if allowColumnResizing is true. */
  1788. columnResizingMode?: 'nextColumn' | 'widget';
  1789. /** Specifies the width for all data columns. Has a lower priority than the column.width option. */
  1790. columnWidth?: number;
  1791. /** Overridden. */
  1792. columns?: Array<GridBaseColumn | string>;
  1793. /** Binds the widget to data. */
  1794. dataSource?: string | Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions;
  1795. /** Specifies the format in which date-time values should be sent to the server. Use it only if you do not specify the dataSource at design time. */
  1796. dateSerializationFormat?: string;
  1797. /** Overriden. */
  1798. editing?: GridBaseEditing;
  1799. /** Indicates whether to show the error row. */
  1800. errorRowEnabled?: boolean;
  1801. /** Configures the integrated filter builder. */
  1802. filterBuilder?: dxFilterBuilderOptions;
  1803. /** Configures the popup in which the integrated filter builder is shown. */
  1804. filterBuilderPopup?: dxPopupOptions;
  1805. /** Configures the filter panel. */
  1806. filterPanel?: { customizeText?: ((e: { component?: T, filterValue?: any, text?: string }) => string), filterEnabled?: boolean, texts?: { clearFilter?: string, createFilter?: string, filterEnabledHint?: string }, visible?: boolean };
  1807. /** Configures the filter row. */
  1808. filterRow?: { applyFilter?: 'auto' | 'onClick', applyFilterText?: string, betweenEndText?: string, betweenStartText?: string, operationDescriptions?: { between?: string, contains?: string, endsWith?: string, equal?: string, greaterThan?: string, greaterThanOrEqual?: string, lessThan?: string, lessThanOrEqual?: string, notContains?: string, notEqual?: string, startsWith?: string }, resetOperationText?: string, showAllText?: string, showOperationChooser?: boolean, visible?: boolean };
  1809. /** Specifies whether to synchronize the filter row, header filter, and filter builder. The synchronized filter expression is stored in the filterValue option. */
  1810. filterSyncEnabled?: boolean | 'auto';
  1811. /** Specifies a filter expression. */
  1812. filterValue?: string | Array<any> | Function;
  1813. /** Specifies the index of the column focused initially or currently in the data row area. */
  1814. focusedColumnIndex?: number;
  1815. /** Specifies whether the focused row feature is enabled. */
  1816. focusedRowEnabled?: boolean;
  1817. /** Specifies the initially or currently focused grid row's index. Use it when focusedRowEnabled is true. */
  1818. focusedRowIndex?: number;
  1819. /** Specifies initially or currently focused grid row's key. Use it when focusedRowEnabled is true. */
  1820. focusedRowKey?: any;
  1821. /** Configures the header filter feature. */
  1822. headerFilter?: { allowSearch?: boolean, height?: number, searchTimeout?: number, texts?: { cancel?: string, emptyValue?: string, ok?: string }, visible?: boolean, width?: number };
  1823. /** Specifies whether to highlight rows and cells with edited data. repaintChangesOnly should be true. */
  1824. highlightChanges?: boolean;
  1825. /** Configures keyboard navigation. */
  1826. keyboardNavigation?: { editOnKeyPress?: boolean, enterKeyAction?: 'startEdit' | 'moveFocus', enterKeyDirection?: 'none' | 'column' | 'row' };
  1827. /** Configures the load panel. */
  1828. loadPanel?: { enabled?: boolean | 'auto', height?: number, indicatorSrc?: string, shading?: boolean, shadingColor?: string, showIndicator?: boolean, showPane?: boolean, text?: string, width?: number };
  1829. /** Specifies text shown when the widget does not display any data. */
  1830. noDataText?: string;
  1831. /** A function that is executed before an adaptive detail row is rendered. */
  1832. onAdaptiveDetailRowPreparing?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, formOptions?: any }) => any);
  1833. /** A function that is executed when an error occurs in the data source. */
  1834. onDataErrorOccurred?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, error?: Error }) => any);
  1835. /** A function that is executed before a new row is added to the widget. */
  1836. onInitNewRow?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, data?: any }) => any);
  1837. /** A function that is executed when the widget is in focus and a key has been pressed down. */
  1838. onKeyDown?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, handled?: boolean }) => any);
  1839. /** A function that is executed after a row is collapsed. */
  1840. onRowCollapsed?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, key?: any }) => any);
  1841. /** A function that is executed before a row is collapsed. */
  1842. onRowCollapsing?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, key?: any, cancel?: boolean }) => any);
  1843. /** A function that is executed after a row is expanded. */
  1844. onRowExpanded?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, key?: any }) => any);
  1845. /** A function that is executed before a row is expanded. */
  1846. onRowExpanding?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, key?: any, cancel?: boolean }) => any);
  1847. /** A function that is executed after a new row has been inserted into the data source. */
  1848. onRowInserted?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, error?: Error }) => any);
  1849. /** A function that is executed before a new row is inserted into the data source. */
  1850. onRowInserting?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, data?: any, cancel?: boolean | Promise<void> | JQueryPromise<void> }) => any);
  1851. /** A function that is executed after a row has been removed from the data source. */
  1852. onRowRemoved?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, error?: Error }) => any);
  1853. /** A function that is executed before a row is removed from the data source. */
  1854. onRowRemoving?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, cancel?: boolean | Promise<void> | JQueryPromise<void> }) => any);
  1855. /** A function that is executed after a row has been updated in the data source. */
  1856. onRowUpdated?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, error?: Error }) => any);
  1857. /** A function that is executed before a row is updated in the data source. */
  1858. onRowUpdating?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, oldData?: any, newData?: any, key?: any, cancel?: boolean | Promise<void> | JQueryPromise<void> }) => any);
  1859. /** A function that is executed after cells in a row are validated against validation rules. */
  1860. onRowValidating?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, brokenRules?: Array<RequiredRule | NumericRule | RangeRule | StringLengthRule | CustomRule | CompareRule | PatternRule | EmailRule>, isValid?: boolean, key?: any, newData?: any, oldData?: any, errorText?: string }) => any);
  1861. /** A function that is executed after selecting a row or clearing its selection. */
  1862. onSelectionChanged?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, currentSelectedRowKeys?: Array<any>, currentDeselectedRowKeys?: Array<any>, selectedRowKeys?: Array<any>, selectedRowsData?: Array<any> }) => any);
  1863. /** A function that is executed before the toolbar is created. */
  1864. onToolbarPreparing?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, toolbarOptions?: dxToolbarOptions }) => any);
  1865. /** Configures the pager. */
  1866. pager?: { allowedPageSizes?: Array<number> | 'auto', infoText?: string, showInfo?: boolean, showNavigationButtons?: boolean, showPageSizeSelector?: boolean, visible?: boolean | 'auto' };
  1867. /** Configures paging. */
  1868. paging?: GridBasePaging;
  1869. /** Specifies whether to render the filter row, command columns, and columns with showEditorAlways set to true after other elements. */
  1870. renderAsync?: boolean;
  1871. /** Specifies whether to repaint only those cells whose data changed. */
  1872. repaintChangesOnly?: boolean;
  1873. /** Specifies whether rows should be shaded differently. */
  1874. rowAlternationEnabled?: boolean;
  1875. /** Overridden. A configuration object specifying scrolling options. */
  1876. scrolling?: GridBaseScrolling;
  1877. /** Configures the search panel. */
  1878. searchPanel?: { highlightCaseSensitive?: boolean, highlightSearchText?: boolean, placeholder?: string, searchVisibleColumnsOnly?: boolean, text?: string, visible?: boolean, width?: number };
  1879. /** Allows you to select rows or determine which rows are selected. */
  1880. selectedRowKeys?: Array<any>;
  1881. /** Overridden. */
  1882. selection?: GridBaseSelection;
  1883. /** Specifies whether the outer borders of the widget are visible. */
  1884. showBorders?: boolean;
  1885. /** Specifies whether column headers are visible. */
  1886. showColumnHeaders?: boolean;
  1887. /** Specifies whether vertical lines that separate one column from another are visible. */
  1888. showColumnLines?: boolean;
  1889. /** Specifies whether horizontal lines that separate one row from another are visible. */
  1890. showRowLines?: boolean;
  1891. /** Configures runtime sorting. */
  1892. sorting?: { ascendingText?: string, clearText?: string, descendingText?: string, mode?: 'multiple' | 'none' | 'single' };
  1893. /** Configures state storing. */
  1894. stateStoring?: { customLoad?: (() => Promise<any> | JQueryPromise<any>), customSave?: ((gridState: any) => any), enabled?: boolean, savingTimeout?: number, storageKey?: string, type?: 'custom' | 'localStorage' | 'sessionStorage' };
  1895. /** Specifies whether to enable two-way data binding. */
  1896. twoWayBindingEnabled?: boolean;
  1897. /** Specifies whether text that does not fit into a column should be wrapped. */
  1898. wordWrapEnabled?: boolean;
  1899. }
  1900. /** Overriden. */
  1901. export interface GridBaseEditing {
  1902. /** Configures the form. Used only if editing.mode is "form" or "popup". */
  1903. form?: dxFormOptions;
  1904. /** Specifies how a user edits data. */
  1905. mode?: 'batch' | 'cell' | 'row' | 'form' | 'popup';
  1906. /** Configures the popup. Used only if editing.mode is "popup". */
  1907. popup?: dxPopupOptions;
  1908. /** Specifies operations that are performed after saving changes. */
  1909. refreshMode?: 'full' | 'reshape' | 'repaint';
  1910. /** Specifies whether to select text in a cell when a user starts editing. */
  1911. selectTextOnEditStart?: boolean;
  1912. /** Specifies whether a single or double click should switch a cell to the editing state. Applies if editing.mode is "cell" or "batch". */
  1913. startEditAction?: 'click' | 'dblClick';
  1914. /** Contains options that specify texts for editing-related UI elements. */
  1915. texts?: GridBaseEditingTexts;
  1916. /** Specifies whether the editing column uses icons instead of links. */
  1917. useIcons?: boolean;
  1918. }
  1919. /** Contains options that specify texts for editing-related UI elements. */
  1920. export interface GridBaseEditingTexts {
  1921. /** Specifies text for a hint that appears when a user pauses on the global "Add" button. Applies only if editing.allowAdding is true. */
  1922. addRow?: string;
  1923. /** Specifies text for a hint that appears when a user pauses on the "Discard" button. Applies only if editing.mode is "batch". */
  1924. cancelAllChanges?: string;
  1925. /** Specifies text for a button that cancels changes in a row. Applies only if editing.allowUpdating is true and editing.mode is "row". */
  1926. cancelRowChanges?: string;
  1927. /** Specifies a message that prompts a user to confirm deletion. */
  1928. confirmDeleteMessage?: string;
  1929. /** Specifies a title for the window that asks a user to confirm deletion. */
  1930. confirmDeleteTitle?: string;
  1931. /** Specifies text for buttons that delete rows. Applies only if allowDeleting is true. */
  1932. deleteRow?: string;
  1933. /** Specifies text for buttons that switch rows into the editing state. Applies only if allowUpdating is true. */
  1934. editRow?: string;
  1935. /** Specifies text for a hint that appears when a user pauses on the global "Save" button. Applies only if editing.mode is "batch". */
  1936. saveAllChanges?: string;
  1937. /** Specifies text for a button that saves changes made in a row. Applies only if allowUpdating is true. */
  1938. saveRowChanges?: string;
  1939. /** Specifies text for buttons that recover deleted rows. Applies only if allowDeleting is true and editing.mode is "batch". */
  1940. undeleteRow?: string;
  1941. /** Specifies text for a hint appearing when a user pauses on the button that cancels changes in a cell. Applies only if editing.mode is "cell" and data validation is enabled. */
  1942. validationCancelChanges?: string;
  1943. }
  1944. /** Configures paging. */
  1945. export interface GridBasePaging {
  1946. /** Enables paging. */
  1947. enabled?: boolean;
  1948. /** Specifies the page to be displayed using a zero-based index. */
  1949. pageIndex?: number;
  1950. /** Specifies the page size. */
  1951. pageSize?: number;
  1952. }
  1953. /** Overridden. A configuration object specifying scrolling options. */
  1954. export interface GridBaseScrolling {
  1955. /** Specifies the rendering mode for columns. Applies when columns are left outside the viewport. Requires the columnWidth, columnAutoWidth, or width (for all columns) option specified. */
  1956. columnRenderingMode?: 'standard' | 'virtual';
  1957. /** Specifies whether the widget should load adjacent pages. Applies only if scrolling.mode is "virtual" or "infinite". */
  1958. preloadEnabled?: boolean;
  1959. /** Specifies the rendering mode for loaded rows. */
  1960. rowRenderingMode?: 'standard' | 'virtual';
  1961. /** Specifies whether a user can scroll the content with a swipe gesture. Applies only if useNative is false. */
  1962. scrollByContent?: boolean;
  1963. /** Specifies whether a user can scroll the content with the scrollbar. Applies only if useNative is false. */
  1964. scrollByThumb?: boolean;
  1965. /** Specifies when to show scrollbars. Applies only if useNative is false. */
  1966. showScrollbar?: 'always' | 'never' | 'onHover' | 'onScroll';
  1967. /** Specifies whether the widget should use native or simulated scrolling. */
  1968. useNative?: boolean | 'auto';
  1969. }
  1970. /** Overridden. */
  1971. export interface GridBaseSelection {
  1972. /** Specifies whether a user can select all rows at once. */
  1973. allowSelectAll?: boolean;
  1974. /** Specifies the selection mode. */
  1975. mode?: 'multiple' | 'none' | 'single';
  1976. }
  1977. export class GridBase extends Widget {
  1978. constructor(element: Element, options?: GridBaseOptions)
  1979. constructor(element: JQuery, options?: GridBaseOptions)
  1980. /** Shows the load panel. */
  1981. beginCustomLoading(messageText: string): void;
  1982. /** Gets a data object with a specific key. */
  1983. byKey(key: any | string | number): Promise<any> & JQueryPromise<any>;
  1984. /** Discards changes that a user made to data. */
  1985. cancelEditData(): void;
  1986. /** Gets the value of a cell with a specific row index and a data field, column caption or name. */
  1987. cellValue(rowIndex: number, dataField: string): any;
  1988. /** Sets a new value to a cell with a specific row index and a data field, column caption or name. */
  1989. cellValue(rowIndex: number, dataField: string, value: any): void;
  1990. /** Gets the value of a cell with specific row and column indexes. */
  1991. cellValue(rowIndex: number, visibleColumnIndex: number): any;
  1992. /** Sets a new value to a cell with specific row and column indexes. */
  1993. cellValue(rowIndex: number, visibleColumnIndex: number, value: any): void;
  1994. /** Clears all filters applied to widget rows. */
  1995. clearFilter(): void;
  1996. /** Clears all row filters of a specific type. */
  1997. clearFilter(filterName: string): void;
  1998. /** Clears selection of all rows on all pages. */
  1999. clearSelection(): void;
  2000. /** Clears sorting settings of all columns at once. */
  2001. clearSorting(): void;
  2002. /** Switches the cell being edited back to the normal state. Takes effect only if editing.mode is batch and showEditorAlways is false. */
  2003. closeEditCell(): void;
  2004. /** Collapses the currently expanded adaptive detail row (if there is one). */
  2005. collapseAdaptiveDetailRow(): void;
  2006. /** Gets the data column count. Includes visible and hidden columns, excludes command columns. */
  2007. columnCount(): number;
  2008. /** Gets all options of a column with a specific identifier. */
  2009. columnOption(id: number | string): any;
  2010. /** Gets the value of a single column option. */
  2011. columnOption(id: number | string, optionName: string): any;
  2012. /** Updates the value of a single column option. */
  2013. columnOption(id: number | string, optionName: string, optionValue: any): void;
  2014. /** Updates the values of several column options. */
  2015. columnOption(id: number | string, options: any): void;
  2016. /** Removes a column. */
  2017. deleteColumn(id: number | string): void;
  2018. /** Removes a row with a specific index. */
  2019. deleteRow(rowIndex: number): void;
  2020. /** Clears the selection of all rows on all pages or the currently rendered page only. */
  2021. deselectAll(): Promise<void> & JQueryPromise<void>;
  2022. /** Cancels the selection of rows with specific keys. */
  2023. deselectRows(keys: Array<any>): Promise<any> & JQueryPromise<any>;
  2024. /** Switches a cell with a specific row index and a data field to the editing state. Takes effect only if the editing mode is "batch" or "cell". */
  2025. editCell(rowIndex: number, dataField: string): void;
  2026. /** Switches a cell with specific row and column indexes to the editing state. Takes effect only if the editing mode is "batch" or "cell". */
  2027. editCell(rowIndex: number, visibleColumnIndex: number): void;
  2028. /** Switches a row with a specific index to the editing state. Takes effect only if the editing mode is "row", "popup" or "form". */
  2029. editRow(rowIndex: number): void;
  2030. /** Hides the load panel. */
  2031. endCustomLoading(): void;
  2032. /** Expands an adaptive detail row. */
  2033. expandAdaptiveDetailRow(key: any): void;
  2034. /** Gets a filter expression applied to the widget's data source using the filter(filterExpr) method and the DataSource's filter option. */
  2035. filter(): any;
  2036. /** Applies a filter to the widget's data source. */
  2037. filter(filterExpr: any): void;
  2038. /** Sets focus on the widget. */
  2039. focus(): void;
  2040. /** Sets focus on a specific cell. */
  2041. focus(element: Element | JQuery): void;
  2042. /** Gets a cell with a specific row index and a data field, column caption or name. */
  2043. getCellElement(rowIndex: number, dataField: string): DevExpress.core.dxElement | undefined;
  2044. /** Gets a cell with specific row and column indexes. */
  2045. getCellElement(rowIndex: number, visibleColumnIndex: number): DevExpress.core.dxElement | undefined;
  2046. /** Gets the total filter that combines all the filters applied. */
  2047. getCombinedFilter(): any;
  2048. /** Gets the total filter that combines all the filters applied. */
  2049. getCombinedFilter(returnDataField: boolean): any;
  2050. /** Gets the DataSource instance. */
  2051. getDataSource(): DevExpress.data.DataSource;
  2052. /** Gets the key of a row with a specific index. */
  2053. getKeyByRowIndex(rowIndex: number): any;
  2054. /** Gets the container of a row with a specific index. */
  2055. getRowElement(rowIndex: number): Array<Element> & JQuery | undefined;
  2056. /** Gets the index of a row with a specific key. */
  2057. getRowIndexByKey(key: any | string | number): number;
  2058. /** Gets the instance of the widget's scrollable part. */
  2059. getScrollable(): dxScrollable;
  2060. /** Checks whether the widget has unsaved changes. */
  2061. hasEditData(): boolean;
  2062. /** Hides the column chooser. */
  2063. hideColumnChooser(): void;
  2064. /** Checks whether an adaptive detail row is expanded or collapsed. */
  2065. isAdaptiveDetailRowExpanded(key: any): boolean;
  2066. /** Checks whether a row with a specific key is focused. */
  2067. isRowFocused(key: any): boolean;
  2068. /** Checks whether a row with a specific key is selected. */
  2069. isRowSelected(key: any): boolean;
  2070. /** Gets a data object's key. */
  2071. keyOf(obj: any): any;
  2072. /** Navigates the grid to the data page that contains the row with the specified key and scrolls the grid to display the row if it is not in the viewport. */
  2073. navigateToRow(key: any): void;
  2074. /** Gets the total page count. */
  2075. pageCount(): number;
  2076. /** Gets the current page index. */
  2077. pageIndex(): number;
  2078. /** Switches the widget to a specific page using a zero-based index. */
  2079. pageIndex(newIndex: number): Promise<void> & JQueryPromise<void>;
  2080. /** Gets the current page size. */
  2081. pageSize(): number;
  2082. /** Sets the page size. */
  2083. pageSize(value: number): void;
  2084. /** Reloads data and repaints the widget. */
  2085. refresh(): Promise<void> & JQueryPromise<void>;
  2086. /** Reloads data and repaints the widget or elements whose data changed. */
  2087. refresh(changesOnly: boolean): Promise<void> & JQueryPromise<void>;
  2088. /** Repaints specific rows. */
  2089. repaintRows(rowIndexes: Array<number>): void;
  2090. /** Saves changes that a user made to data. */
  2091. saveEditData(): Promise<void> & JQueryPromise<void>;
  2092. /** Seeks a search string in the columns whose allowSearch option is true. */
  2093. searchByText(text: string): void;
  2094. /** Selects all rows. */
  2095. selectAll(): Promise<void> & JQueryPromise<void>;
  2096. /** Selects rows with specific keys. */
  2097. selectRows(keys: Array<any>, preserve: boolean): Promise<any> & JQueryPromise<any>;
  2098. /** Selects rows with specific indexes. */
  2099. selectRowsByIndexes(indexes: Array<number>): Promise<any> & JQueryPromise<any>;
  2100. /** Shows the column chooser. */
  2101. showColumnChooser(): void;
  2102. /** Gets the current widget state. */
  2103. state(): any;
  2104. /** Sets the widget state. */
  2105. state(state: any): void;
  2106. /** Recovers a row deleted in batch editing mode. */
  2107. undeleteRow(rowIndex: number): void;
  2108. /** Updates the widget's content after resizing. */
  2109. updateDimensions(): void;
  2110. }
  2111. export interface GridBaseColumn {
  2112. /** Aligns the content of the column. */
  2113. alignment?: 'center' | 'left' | 'right' | undefined;
  2114. /** Specifies whether a user can edit values in the column at runtime. By default, inherits the value of the editing.allowUpdating option. */
  2115. allowEditing?: boolean;
  2116. /** Specifies whether data can be filtered by this column. Applies only if filterRow.visible is true. */
  2117. allowFiltering?: boolean;
  2118. /** Specifies whether a user can fix the column at runtime. Applies only if columnFixing.enabled is true. */
  2119. allowFixing?: boolean;
  2120. /** Specifies whether the header filter can be used to filter data by this column. Applies only if headerFilter.visible is true. By default, inherits the value of the allowFiltering option. */
  2121. allowHeaderFiltering?: boolean;
  2122. /** Specifies whether a user can hide the column using the column chooser at runtime. Applies only if columnChooser.enabled is true. */
  2123. allowHiding?: boolean;
  2124. /** Specifies whether this column can be used in column reordering at runtime. Applies only if allowColumnReordering is true. */
  2125. allowReordering?: boolean;
  2126. /** Specifies whether a user can resize the column at runtime. Applies only if allowColumnResizing is true. */
  2127. allowResizing?: boolean;
  2128. /** Specifies whether this column can be searched. Applies only if searchPanel.visible is true. Inherits the value of the allowFiltering option by default. */
  2129. allowSearch?: boolean;
  2130. /** Specifies whether a user can sort rows by this column at runtime. Applies only if sorting.mode differs from "none". */
  2131. allowSorting?: boolean;
  2132. /** Calculates custom cell values. Use this function to create an unbound data column. */
  2133. calculateCellValue?: ((rowData: any) => any);
  2134. /** Calculates custom display values for column cells. Requires specifying the dataField or calculateCellValue option. Used in lookup optimization. */
  2135. calculateDisplayValue?: string | ((rowData: any) => any);
  2136. /** Specifies the column's custom filtering rules. */
  2137. calculateFilterExpression?: ((filterValue: any, selectedFilterOperation: string, target: string) => string | Array<any> | Function);
  2138. /** Calculates custom values to be used in sorting. */
  2139. calculateSortValue?: string | ((rowData: any) => any);
  2140. /** Specifies a caption for the column. */
  2141. caption?: string;
  2142. /** Specifies a custom template for column cells. */
  2143. cellTemplate?: template | ((cellElement: DevExpress.core.dxElement, cellInfo: any) => any);
  2144. /** Specifies a CSS class to be applied to the column. */
  2145. cssClass?: string;
  2146. /** Customizes the text displayed in column cells. */
  2147. customizeText?: ((cellInfo: { value?: string | number | Date, valueText?: string, target?: string, groupInterval?: string | number }) => string);
  2148. /** Binds the column to a field of the dataSource. */
  2149. dataField?: string;
  2150. /** Casts column values to a specific data type. */
  2151. dataType?: 'string' | 'number' | 'date' | 'boolean' | 'object' | 'datetime';
  2152. /** Specifies a custom template for column cells in the editing state. */
  2153. editCellTemplate?: template | ((cellElement: DevExpress.core.dxElement, cellInfo: any) => any);
  2154. /** Configures the default widget used for editing and filtering in the filter row. */
  2155. editorOptions?: any;
  2156. /** Specifies whether HTML tags are displayed as plain text or applied to the values of the column. */
  2157. encodeHtml?: boolean;
  2158. /** In a boolean column, replaces all false items with a specified text. Applies only if showEditorAlways option is false. */
  2159. falseText?: string;
  2160. /** Specifies a set of available filter operations. Applies only if filterRow.visible and allowFiltering are true. */
  2161. filterOperations?: Array<'=' | '<>' | '<' | '<=' | '>' | '>=' | 'notcontains' | 'contains' | 'startswith' | 'endswith' | 'between'>;
  2162. /** Specifies whether a user changes the current filter by including (selecting) or excluding (clearing the selection of) values. Applies only if headerFilter.visible and allowHeaderFiltering are true. */
  2163. filterType?: 'exclude' | 'include';
  2164. /** Specifies the column's filter value displayed in the filter row. */
  2165. filterValue?: any;
  2166. /** Specifies values selected in the column's header filter. */
  2167. filterValues?: Array<any>;
  2168. /** Fixes the column. */
  2169. fixed?: boolean;
  2170. /** Specifies the widget's edge to which the column is fixed. Applies only if columns[].fixed is true. */
  2171. fixedPosition?: 'left' | 'right';
  2172. /** Configures the form item that the column produces in the editing state. Applies only if editing.mode is "form" or "popup". */
  2173. formItem?: dxFormSimpleItem;
  2174. /** Formats a value before it is displayed in a column cell. */
  2175. format?: format;
  2176. /** Specifies a custom template for column headers. */
  2177. headerCellTemplate?: template | ((columnHeader: DevExpress.core.dxElement, headerInfo: any) => any);
  2178. /** Specifies data settings for the header filter. */
  2179. headerFilter?: { allowSearch?: boolean, dataSource?: Array<any> | ((options: { component?: any, dataSource?: DevExpress.data.DataSourceOptions }) => any) | DevExpress.data.DataSourceOptions, groupInterval?: 'day' | 'hour' | 'minute' | 'month' | 'quarter' | 'second' | 'year' | number, height?: number, searchMode?: 'contains' | 'startswith' | 'equals', width?: number };
  2180. /** Specifies the order in which columns are hidden when the widget adapts to the screen or container size. Ignored if allowColumnResizing is true and columnResizingMode is "widget". */
  2181. hidingPriority?: number;
  2182. /** Specifies whether the column bands other columns or not. */
  2183. isBand?: boolean;
  2184. /** Specifies options of a lookup column. */
  2185. lookup?: { allowClearing?: boolean, dataSource?: Array<any> | DevExpress.data.DataSourceOptions | DevExpress.data.Store | ((options: { data?: any, key?: any }) => Array<any> | DevExpress.data.DataSourceOptions | DevExpress.data.Store), displayExpr?: string | ((data: any) => any), valueExpr?: string };
  2186. /** Specifies the minimum width of the column. */
  2187. minWidth?: number;
  2188. /** Specifies the identifier of the column. */
  2189. name?: string;
  2190. /** Specifies the band column that owns the current column. Accepts the index of the band column in the columns array. */
  2191. ownerBand?: number;
  2192. /** Specifies whether to render the column after other columns and elements. Use if column cells have a complex template. Requires the width option specified. */
  2193. renderAsync?: boolean;
  2194. /** Specifies the column's filter operation displayed in the filter row. */
  2195. selectedFilterOperation?: '<' | '<=' | '<>' | '=' | '>' | '>=' | 'between' | 'contains' | 'endswith' | 'notcontains' | 'startswith';
  2196. /** Specifies a function to be invoked after the user has edited a cell value, but before it will be saved in the data source. */
  2197. setCellValue?: ((newData: any, value: any, currentRowData: any) => any);
  2198. /** Specifies whether the column displays its values using editors. */
  2199. showEditorAlways?: boolean;
  2200. /** Specifies whether the column chooser can contain the column header. */
  2201. showInColumnChooser?: boolean;
  2202. /** Specifies the index according to which columns participate in sorting. */
  2203. sortIndex?: number;
  2204. /** Specifies the sort order of column values. */
  2205. sortOrder?: 'asc' | 'desc' | undefined;
  2206. /** Specifies a custom comparison function for sorting. Applies only when sorting is performed on the client. */
  2207. sortingMethod?: ((value1: any, value2: any) => number);
  2208. /** In a boolean column, replaces all true items with a specified text. Applies only if showEditorAlways option is false. */
  2209. trueText?: string;
  2210. /** Specifies validation rules to be checked on updating cell values. */
  2211. validationRules?: Array<RequiredRule | NumericRule | RangeRule | StringLengthRule | CustomRule | CompareRule | PatternRule | EmailRule>;
  2212. /** Specifies whether the column is visible, that is, occupies space in the table. */
  2213. visible?: boolean;
  2214. /** Specifies the position of the column regarding other columns in the resulting widget. */
  2215. visibleIndex?: number;
  2216. /** Specifies the column's width in pixels or as a percentage. Ignored if it is less than minWidth. */
  2217. width?: number | string;
  2218. }
  2219. /** Allows you to customize buttons in the editing column or create a custom command column. Applies only if the column's type is "buttons". */
  2220. export interface GridBaseColumnButton {
  2221. /** Specifies a CSS class to be applied to the button. */
  2222. cssClass?: string;
  2223. /** Specifies the text for the hint that appears when the button is hovered over or long-pressed. */
  2224. hint?: string;
  2225. /** Specifies the button's icon. */
  2226. icon?: string;
  2227. /** Specifies the button's text. Applies only if the button's icon is not specified. */
  2228. text?: string;
  2229. }
  2230. export interface HierarchicalCollectionWidgetOptions<T = HierarchicalCollectionWidget> extends CollectionWidgetOptions<T> {
  2231. /** Specifies the name of the data source item field whose value defines whether or not the corresponding widget item is disabled. */
  2232. disabledExpr?: string | Function;
  2233. /** Specifies the data field whose values should be displayed. */
  2234. displayExpr?: string | ((item: any) => any);
  2235. /** Specifies whether the widget can be focused using keyboard navigation. */
  2236. focusStateEnabled?: boolean;
  2237. /** Specifies whether the widget changes its state when a user pauses on it. */
  2238. hoverStateEnabled?: boolean;
  2239. /** Specifies which data field contains nested items. */
  2240. itemsExpr?: string | Function;
  2241. /** Specifies which data field provides keys for TreeView items. */
  2242. keyExpr?: string | Function;
  2243. /** Specifies the name of the data source item field whose value defines whether or not the corresponding widget items is selected. */
  2244. selectedExpr?: string | Function;
  2245. }
  2246. export class HierarchicalCollectionWidget extends CollectionWidget {
  2247. constructor(element: Element, options?: HierarchicalCollectionWidgetOptions)
  2248. constructor(element: JQuery, options?: HierarchicalCollectionWidgetOptions)
  2249. }
  2250. export interface MapLocation {
  2251. /** The latitude location of the widget. */
  2252. lat?: number;
  2253. /** The longitude location of the widget. */
  2254. lng?: number;
  2255. }
  2256. /** A validation rule that demands that the validated field has a numeric value. */
  2257. export interface NumericRule {
  2258. /** If set to true, empty values are valid. */
  2259. ignoreEmptyValue?: boolean;
  2260. /** Specifies the message that is shown for end-users if the current rule is broken. */
  2261. message?: string;
  2262. /** Specifies the type of the current rule. */
  2263. type?: 'required' | 'numeric' | 'range' | 'stringLength' | 'custom' | 'compare' | 'pattern' | 'email';
  2264. }
  2265. export interface OneDriveFileProviderOptions extends FileProviderOptions<OneDriveFileProvider> {
  2266. }
  2267. /** The OneDrive file provider allows you to connect to OneDrive. */
  2268. export class OneDriveFileProvider extends FileProvider {
  2269. constructor(options?: OneDriveFileProviderOptions)
  2270. }
  2271. /** A validation rule that demands that the validated field match a specified pattern. */
  2272. export interface PatternRule {
  2273. /** If set to true, empty values are valid. */
  2274. ignoreEmptyValue?: boolean;
  2275. /** Specifies the message that is shown for end-users if the current rule is broken. */
  2276. message?: string;
  2277. /** Specifies the regular expression that the validated value must match. */
  2278. pattern?: RegExp | string;
  2279. /** Specifies the type of the current rule. */
  2280. type?: 'required' | 'numeric' | 'range' | 'stringLength' | 'custom' | 'compare' | 'pattern' | 'email';
  2281. }
  2282. /** A validation rule that demands the target value be within the specified value range (including the range's end points). */
  2283. export interface RangeRule {
  2284. /** If set to true, empty values are valid. */
  2285. ignoreEmptyValue?: boolean;
  2286. /** Specifies the maximum value allowed for the validated value. */
  2287. max?: Date | number;
  2288. /** Specifies the message that is shown to end-users if the current rule is broken. */
  2289. message?: string;
  2290. /** Specifies the minimum value allowed for the validated value. */
  2291. min?: Date | number;
  2292. /** Indicates whether the rule should be always checked for the target value or only when the target value changes. */
  2293. reevaluate?: boolean;
  2294. /** Specifies the type of the current rule. */
  2295. type?: 'required' | 'numeric' | 'range' | 'stringLength' | 'custom' | 'compare' | 'pattern' | 'email';
  2296. }
  2297. /** A validation rule that demands that a validated field has a value. */
  2298. export interface RequiredRule {
  2299. /** Specifies the message that is shown for end-users if the current rule is broken. */
  2300. message?: string;
  2301. /** Indicates whether to remove the Space characters from the validated value. */
  2302. trim?: boolean;
  2303. /** Specifies the type of the current rule. */
  2304. type?: 'required' | 'numeric' | 'range' | 'stringLength' | 'custom' | 'compare' | 'pattern' | 'email';
  2305. }
  2306. export interface SearchBoxMixinOptions<T = SearchBoxMixin> {
  2307. /** Configures the search panel. */
  2308. searchEditorOptions?: dxTextBoxOptions;
  2309. /** Specifies whether the search panel is visible. */
  2310. searchEnabled?: boolean;
  2311. /** Specifies a data object's field name or an expression whose value is compared to the search string. */
  2312. searchExpr?: string | Function | Array<string | Function>;
  2313. /** Specifies a comparison operation used to search widget items. */
  2314. searchMode?: 'contains' | 'startswith' | 'equals';
  2315. /** Specifies a delay in milliseconds between when a user finishes typing, and the search is executed. */
  2316. searchTimeout?: number;
  2317. /** Specifies the current search string. */
  2318. searchValue?: string;
  2319. }
  2320. export class SearchBoxMixin {
  2321. constructor(options?: SearchBoxMixinOptions)
  2322. }
  2323. /** A validation rule that demands the target value length be within the specified value range (including the range's end points). */
  2324. export interface StringLengthRule {
  2325. /** If set to true, empty values are valid. */
  2326. ignoreEmptyValue?: boolean;
  2327. /** Specifies the maximum length allowed for the validated value. */
  2328. max?: number;
  2329. /** Specifies the message that is shown for end-users if the current rule is broken. */
  2330. message?: string;
  2331. /** Specifies the minimum length allowed for the validated value. */
  2332. min?: number;
  2333. /** Indicates whether or not to remove the Space characters from the validated value. */
  2334. trim?: boolean;
  2335. /** Specifies the type of the current rule. */
  2336. type?: 'required' | 'numeric' | 'range' | 'stringLength' | 'custom' | 'compare' | 'pattern' | 'email';
  2337. }
  2338. export interface WebApiFileProviderOptions extends FileProviderOptions<WebApiFileProvider> {
  2339. /** Specifies the URL of an endpoint used to access and modify a file system located on the server. */
  2340. endpointUrl?: string;
  2341. /** Specifies which data field provides information about whether a directory has subdirectories. */
  2342. hasSubDirectoriesExpr?: string | Function;
  2343. }
  2344. /** The Web API file provider works with a file system located on the server. */
  2345. export class WebApiFileProvider extends FileProvider {
  2346. constructor(options?: WebApiFileProviderOptions)
  2347. }
  2348. export interface WidgetOptions<T = Widget> extends DOMComponentOptions<T> {
  2349. /** Specifies the shortcut key that sets focus on the widget. */
  2350. accessKey?: string;
  2351. /** Specifies whether or not the widget changes its state when interacting with a user. */
  2352. activeStateEnabled?: boolean;
  2353. /** Specifies whether the widget responds to user interaction. */
  2354. disabled?: boolean;
  2355. /** Specifies whether the widget can be focused using keyboard navigation. */
  2356. focusStateEnabled?: boolean;
  2357. /** Specifies text for a hint that appears when a user pauses on the widget. */
  2358. hint?: string;
  2359. /** Specifies whether the widget changes its state when a user pauses on it. */
  2360. hoverStateEnabled?: boolean;
  2361. /** A function that is executed when the widget's content is ready and each time the content is changed. */
  2362. onContentReady?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  2363. /** Specifies the number of the element when the Tab key is used for navigating. */
  2364. tabIndex?: number;
  2365. /** Specifies whether the widget is visible. */
  2366. visible?: boolean;
  2367. }
  2368. /** The base class for widgets. */
  2369. export class Widget extends DOMComponent {
  2370. constructor(element: Element, options?: WidgetOptions)
  2371. constructor(element: JQuery, options?: WidgetOptions)
  2372. /** Sets focus on the widget. */
  2373. focus(): void;
  2374. /** Registers a handler to be executed when a user presses a specific key. */
  2375. registerKeyHandler(key: string, handler: Function): void;
  2376. /** Repaints the widget without reloading data. Call it to update the widget's markup. */
  2377. repaint(): void;
  2378. }
  2379. export interface dxAccordionOptions extends CollectionWidgetOptions<dxAccordion> {
  2380. /** A number specifying the time in milliseconds spent on the animation of the expanding or collapsing of a panel. */
  2381. animationDuration?: number;
  2382. /** Specifies whether all items can be collapsed or whether at least one item must always be expanded. */
  2383. collapsible?: boolean;
  2384. /** Specifies whether to render the panel's content when it is displayed. If false, the content is rendered immediately. */
  2385. deferRendering?: boolean;
  2386. /** Specifies whether the widget can be focused using keyboard navigation. */
  2387. focusStateEnabled?: boolean;
  2388. /** Specifies the widget's height. */
  2389. height?: number | string | (() => number | string);
  2390. /** Specifies whether the widget changes its state when a user pauses on it. */
  2391. hoverStateEnabled?: boolean;
  2392. /** Specifies a custom template for items. */
  2393. itemTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  2394. /** Specifies a custom template for item titles. */
  2395. itemTitleTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  2396. /** An array of items displayed by the widget. */
  2397. items?: Array<string | dxAccordionItem | any>;
  2398. /** Specifies whether the widget can expand several items or only a single item at once. */
  2399. multiple?: boolean;
  2400. /** A function that is executed when an accordion item's title is clicked or tapped. */
  2401. onItemTitleClick?: ((e: { component?: dxAccordion, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, event?: event }) => any) | string;
  2402. /** Specifies whether to repaint only those elements whose data changed. */
  2403. repaintChangesOnly?: boolean;
  2404. /** The index number of the currently selected item. */
  2405. selectedIndex?: number;
  2406. }
  2407. /** The Accordion widget contains several panels displayed one under another. These panels can be collapsed or expanded by an end user, which makes this widget very useful for presenting information in a limited amount of space. */
  2408. export class dxAccordion extends CollectionWidget {
  2409. constructor(element: Element, options?: dxAccordionOptions)
  2410. constructor(element: JQuery, options?: dxAccordionOptions)
  2411. /** Collapses an item with a specific index. */
  2412. collapseItem(index: number): Promise<void> & JQueryPromise<void>;
  2413. /** Expands an item with a specific index. */
  2414. expandItem(index: number): Promise<void> & JQueryPromise<void>;
  2415. /** Updates the dimensions of the widget contents. */
  2416. updateDimensions(): Promise<void> & JQueryPromise<void>;
  2417. }
  2418. /** This section lists the data source fields that are used in a default template for Accordion items. */
  2419. export interface dxAccordionItem extends CollectionWidgetItem {
  2420. /** Specifies the icon to be displayed in the panel's title. */
  2421. icon?: string;
  2422. /** Specifies text displayed for the widget item title. */
  2423. title?: string;
  2424. }
  2425. export interface dxActionSheetOptions extends CollectionWidgetOptions<dxActionSheet> {
  2426. /** The text displayed in the button that closes the action sheet. */
  2427. cancelText?: string;
  2428. /** An array of items displayed by the widget. */
  2429. items?: Array<string | dxActionSheetItem | any>;
  2430. /** A function that is executed when the Cancel button is clicked or tapped. */
  2431. onCancelClick?: ((e: { component?: dxActionSheet, element?: DevExpress.core.dxElement, model?: any, cancel?: boolean }) => any) | string;
  2432. /** Specifies whether or not to display the Cancel button in action sheet. */
  2433. showCancelButton?: boolean;
  2434. /** A Boolean value specifying whether or not the title of the action sheet is visible. */
  2435. showTitle?: boolean;
  2436. /** Specifies the element the action sheet popover points at. Applies only if usePopover is true. */
  2437. target?: string | Element | JQuery;
  2438. /** The title of the action sheet. */
  2439. title?: string;
  2440. /** Specifies whether or not to show the action sheet within a Popover widget. */
  2441. usePopover?: boolean;
  2442. /** A Boolean value specifying whether or not the ActionSheet widget is visible. */
  2443. visible?: boolean;
  2444. }
  2445. /** The ActionSheet widget is a sheet containing a set of buttons located one under the other. These buttons usually represent several choices relating to a single task. */
  2446. export class dxActionSheet extends CollectionWidget {
  2447. constructor(element: Element, options?: dxActionSheetOptions)
  2448. constructor(element: JQuery, options?: dxActionSheetOptions)
  2449. /** Hides the widget. */
  2450. hide(): Promise<void> & JQueryPromise<void>;
  2451. /** Shows the widget. */
  2452. show(): Promise<void> & JQueryPromise<void>;
  2453. /** Shows or hides the widget depending on the argument. */
  2454. toggle(showing: boolean): Promise<void> & JQueryPromise<void>;
  2455. }
  2456. /** This section lists the data source fields that are used in a default template for action sheet items. */
  2457. export interface dxActionSheetItem extends CollectionWidgetItem {
  2458. /** Specifies the icon to be displayed on the action sheet button. */
  2459. icon?: string;
  2460. /** A handler for the click event raised for the button representing the given action sheet button. */
  2461. onClick?: ((e: { component?: dxActionSheet, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any) | string;
  2462. /** Specifies the type of the button that represents an action sheet item. */
  2463. type?: 'back' | 'danger' | 'default' | 'normal' | 'success';
  2464. }
  2465. export interface dxAutocompleteOptions extends dxDropDownListOptions<dxAutocomplete> {
  2466. /** Specifies the maximum count of items displayed by the widget. */
  2467. maxItemCount?: number;
  2468. /** The minimum number of characters that must be entered into the text box to begin a search. */
  2469. minSearchLength?: number;
  2470. /** Specifies whether the drop-down button is visible. */
  2471. showDropDownButton?: boolean;
  2472. /** Specifies the current value displayed by the widget. */
  2473. value?: string;
  2474. }
  2475. /** The Autocomplete widget is a textbox that provides suggestions while a user types into it. */
  2476. export class dxAutocomplete extends dxDropDownList {
  2477. constructor(element: Element, options?: dxAutocompleteOptions)
  2478. constructor(element: JQuery, options?: dxAutocompleteOptions)
  2479. }
  2480. export interface dxBoxOptions extends CollectionWidgetOptions<dxBox> {
  2481. /** Specifies how widget items are aligned along the main direction. */
  2482. align?: 'center' | 'end' | 'space-around' | 'space-between' | 'start';
  2483. /** Specifies how widget items are aligned cross-wise. */
  2484. crossAlign?: 'center' | 'end' | 'start' | 'stretch';
  2485. /** Specifies the direction of item positioning in the widget. */
  2486. direction?: 'col' | 'row';
  2487. /** An array of items displayed by the widget. */
  2488. items?: Array<string | dxBoxItem | any>;
  2489. }
  2490. /** The Box widget allows you to arrange various elements within it. Separate and adaptive, the Box widget acts as a building block for the layout. */
  2491. export class dxBox extends CollectionWidget {
  2492. constructor(element: Element, options?: dxBoxOptions)
  2493. constructor(element: JQuery, options?: dxBoxOptions)
  2494. }
  2495. /** This section lists the data source fields that are used in a default template for list items. */
  2496. export interface dxBoxItem extends CollectionWidgetItem {
  2497. /** Specifies the base size of an item element along the main direction. */
  2498. baseSize?: number | 'auto';
  2499. /** Holds a Box configuration object for the item. */
  2500. box?: dxBoxOptions;
  2501. /** Specifies the ratio value used to count the item element size along the main direction. */
  2502. ratio?: number;
  2503. /** A factor that defines how much an item shrinks relative to the rest of the items in the container. */
  2504. shrink?: number;
  2505. }
  2506. export interface dxButtonOptions extends WidgetOptions<dxButton> {
  2507. /** A Boolean value specifying whether or not the widget changes its state when interacting with a user. */
  2508. activeStateEnabled?: boolean;
  2509. /** Specifies whether the widget can be focused using keyboard navigation. */
  2510. focusStateEnabled?: boolean;
  2511. /** Specifies whether the widget changes its state when a user pauses on it. */
  2512. hoverStateEnabled?: boolean;
  2513. /** Specifies the icon to be displayed on the button. */
  2514. icon?: string;
  2515. /** A function that is executed when the Button is clicked or tapped. */
  2516. onClick?: ((e: { component?: dxButton, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, validationGroup?: any }) => any);
  2517. /** Specifies how the button is styled. */
  2518. stylingMode?: 'text' | 'outlined' | 'contained';
  2519. /** Specifies a custom template for the Button widget. */
  2520. template?: template | ((buttonData: { text?: string, icon?: string }, contentElement: DevExpress.core.dxElement) => string | Element | JQuery);
  2521. /** The text displayed on the button. */
  2522. text?: string;
  2523. /** Specifies the button type. */
  2524. type?: 'back' | 'danger' | 'default' | 'normal' | 'success';
  2525. /** Specifies whether or not the button must submit an HTML form. */
  2526. useSubmitBehavior?: boolean;
  2527. /** Specifies the name of the validation group to be accessed in the click event handler. */
  2528. validationGroup?: string;
  2529. }
  2530. /** The Button widget is a simple button that performs specified commands when a user clicks it. */
  2531. export class dxButton extends Widget {
  2532. constructor(element: Element, options?: dxButtonOptions)
  2533. constructor(element: JQuery, options?: dxButtonOptions)
  2534. }
  2535. /** This section lists the fields of a context object available in a button template. */
  2536. export interface dxButtonDefaultTemplate {
  2537. /** Holds an icon that is specified using the icon option. */
  2538. icon?: string;
  2539. /** Holds the text that is specified using the text option. */
  2540. text?: string;
  2541. }
  2542. export interface dxButtonGroupOptions extends WidgetOptions<dxButtonGroup> {
  2543. /** Specifies whether the widget can be focused using keyboard navigation. */
  2544. focusStateEnabled?: boolean;
  2545. /** Specifies whether the widget changes its state when a user pauses on it. */
  2546. hoverStateEnabled?: boolean;
  2547. /** Specifies a custom button template. */
  2548. itemTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  2549. /** Configures buttons in the group. */
  2550. items?: Array<dxButtonGroupItem>;
  2551. /** Specifies which data field provides keys used to distinguish between the selected buttons. */
  2552. keyExpr?: string | Function;
  2553. /** A function that is executed when a button is clicked or tapped. */
  2554. onItemClick?: ((e: { component?: dxButtonGroup, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, event?: event }) => any);
  2555. /** A function that is executed when a button is selected or selection is canceled. */
  2556. onSelectionChanged?: ((e: { component?: dxButtonGroup, element?: DevExpress.core.dxElement, model?: any, addedItems?: Array<any>, removedItems?: Array<any> }) => any);
  2557. /** Contains the keys of the selected buttons and allows selecting buttons initially. */
  2558. selectedItemKeys?: Array<any>;
  2559. /** Contains the data objects that correspond to the selected buttons. The data objects are taken from the items array. */
  2560. selectedItems?: Array<any>;
  2561. /** Specifies whether a single or multiple buttons can be in the selected state simultaneously. */
  2562. selectionMode?: 'multiple' | 'single';
  2563. /** Specifies how buttons in the group are styled. */
  2564. stylingMode?: 'text' | 'outlined' | 'contained';
  2565. }
  2566. /** The ButtonGroup is a widget that contains a set of toggle buttons and can be used as a mode switcher. */
  2567. export class dxButtonGroup extends Widget {
  2568. constructor(element: Element, options?: dxButtonGroupOptions)
  2569. constructor(element: JQuery, options?: dxButtonGroupOptions)
  2570. }
  2571. /** This section describes object fields that can be used in the default item template. */
  2572. export interface dxButtonGroupItem extends CollectionWidgetItem {
  2573. /** Specifies a text for the hint that appears when the button is hovered over or long-pressed. */
  2574. hint?: string;
  2575. /** Specifies the icon to be displayed on the button. */
  2576. icon?: string;
  2577. /** Specifies the button type. */
  2578. type?: 'back' | 'danger' | 'default' | 'normal' | 'success';
  2579. }
  2580. export interface dxCalendarOptions extends EditorOptions<dxCalendar> {
  2581. /** Specifies whether or not the widget changes its state when interacting with a user. */
  2582. activeStateEnabled?: boolean;
  2583. /** Specifies a custom template for calendar cells. */
  2584. cellTemplate?: template | ((itemData: { date?: Date, view?: string, text?: string }, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  2585. /** Specifies the date-time value serialization format. Use it only if you do not specify the value at design time. */
  2586. dateSerializationFormat?: string;
  2587. /** Specifies dates to be disabled. */
  2588. disabledDates?: Array<Date> | ((data: { component?: any, date?: Date, view?: string }) => boolean);
  2589. /** Specifies the first day of a week. */
  2590. firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
  2591. /** Specifies whether the widget can be focused using keyboard navigation. */
  2592. focusStateEnabled?: boolean;
  2593. /** Specifies whether the widget changes its state when a user pauses on it. */
  2594. hoverStateEnabled?: boolean;
  2595. /** The latest date the widget allows to select. */
  2596. max?: Date | number | string;
  2597. /** Specifies the maximum zoom level of the calendar. */
  2598. maxZoomLevel?: 'century' | 'decade' | 'month' | 'year';
  2599. /** The earliest date the widget allows to select. */
  2600. min?: Date | number | string;
  2601. /** Specifies the minimum zoom level of the calendar. */
  2602. minZoomLevel?: 'century' | 'decade' | 'month' | 'year';
  2603. /** The value to be assigned to the `name` attribute of the underlying HTML element. */
  2604. name?: string;
  2605. /** Specifies whether or not the widget displays a button that selects the current date. */
  2606. showTodayButton?: boolean;
  2607. /** An object or a value specifying the date and time currently selected in the calendar. */
  2608. value?: Date | number | string;
  2609. /** Specifies the current calendar zoom level. */
  2610. zoomLevel?: 'century' | 'decade' | 'month' | 'year';
  2611. }
  2612. /** The Calendar is a widget that displays a calendar and allows an end user to select the required date within a specified date range. */
  2613. export class dxCalendar extends Editor {
  2614. constructor(element: Element, options?: dxCalendarOptions)
  2615. constructor(element: JQuery, options?: dxCalendarOptions)
  2616. }
  2617. /** This section lists the fields that are used in a default template for calendar cells. */
  2618. export interface dxCalendarCellTemplate {
  2619. /** The Date object associated with the cell. */
  2620. date?: Date;
  2621. /** The text displayed by the cell. */
  2622. text?: string;
  2623. /** The current view's name. */
  2624. view?: 'month' | 'year' | 'decade' | 'century';
  2625. }
  2626. export interface dxCheckBoxOptions extends EditorOptions<dxCheckBox> {
  2627. /** Specifies whether or not the widget changes its state when interacting with a user. */
  2628. activeStateEnabled?: boolean;
  2629. /** Specifies whether the widget can be focused using keyboard navigation. */
  2630. focusStateEnabled?: boolean;
  2631. /** Specifies whether the widget changes its state when a user pauses on it. */
  2632. hoverStateEnabled?: boolean;
  2633. /** The value to be assigned to the `name` attribute of the underlying HTML element. */
  2634. name?: string;
  2635. /** Specifies the text displayed by the check box. */
  2636. text?: string;
  2637. /** Specifies the widget state. */
  2638. value?: boolean;
  2639. }
  2640. /** The CheckBox is a small box, which when selected by the end user, shows that a particular feature has been enabled or a specific option has been chosen. */
  2641. export class dxCheckBox extends Editor {
  2642. constructor(element: Element, options?: dxCheckBoxOptions)
  2643. constructor(element: JQuery, options?: dxCheckBoxOptions)
  2644. }
  2645. export interface dxColorBoxOptions extends dxDropDownEditorOptions<dxColorBox> {
  2646. /** Specifies the text displayed on the button that applies changes and closes the drop-down editor. */
  2647. applyButtonText?: string;
  2648. /** Specifies the way an end-user applies the selected value. */
  2649. applyValueMode?: 'instantly' | 'useButtons';
  2650. /** Specifies the text displayed on the button that cancels changes and closes the drop-down editor. */
  2651. cancelButtonText?: string;
  2652. /** Specifies whether or not the widget value includes the alpha channel component. */
  2653. editAlphaChannel?: boolean;
  2654. /** Specifies a custom template for the input field. Must contain the TextBox widget. */
  2655. fieldTemplate?: template | ((value: string, fieldElement: DevExpress.core.dxElement) => string | Element | JQuery);
  2656. /** Specifies the size of a step by which a handle is moved using a keyboard shortcut. */
  2657. keyStep?: number;
  2658. /** Specifies the currently selected value. */
  2659. value?: string;
  2660. }
  2661. /** The ColorBox is a widget that allows an end user to enter a color or pick it out from the drop-down editor. */
  2662. export class dxColorBox extends dxDropDownEditor {
  2663. constructor(element: Element, options?: dxColorBoxOptions)
  2664. constructor(element: JQuery, options?: dxColorBoxOptions)
  2665. }
  2666. export interface dxContextMenuOptions extends dxMenuBaseOptions<dxContextMenu> {
  2667. /** Specifies whether to close the ContextMenu if a user clicks outside it. */
  2668. closeOnOutsideClick?: boolean | ((event: event) => boolean);
  2669. /** Holds an array of menu items. */
  2670. items?: Array<dxContextMenuItem>;
  2671. /** A function that is executed after the ContextMenu is hidden. */
  2672. onHidden?: ((e: { component?: dxContextMenu, element?: DevExpress.core.dxElement, model?: any }) => any);
  2673. /** A function that is executed before the ContextMenu is hidden. */
  2674. onHiding?: ((e: { component?: dxContextMenu, element?: DevExpress.core.dxElement, model?: any, cancel?: boolean }) => any);
  2675. /** A function that is executed before the ContextMenu is positioned. */
  2676. onPositioning?: ((e: { component?: dxContextMenu, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, position?: positionConfig }) => any);
  2677. /** A function that is executed before the ContextMenu is shown. */
  2678. onShowing?: ((e: { component?: dxContextMenu, element?: DevExpress.core.dxElement, model?: any, cancel?: boolean }) => any);
  2679. /** A function that is executed after the ContextMenu is shown. */
  2680. onShown?: ((e: { component?: dxContextMenu, element?: DevExpress.core.dxElement, model?: any }) => any);
  2681. /** An object defining widget positioning options. */
  2682. position?: positionConfig;
  2683. /** Specifies options for displaying the widget. */
  2684. showEvent?: { delay?: number, name?: string } | string;
  2685. /** Specifies the direction at which submenus are displayed. */
  2686. submenuDirection?: 'auto' | 'left' | 'right';
  2687. /** The target element associated with the context menu. */
  2688. target?: string | Element | JQuery;
  2689. /** A Boolean value specifying whether or not the widget is visible. */
  2690. visible?: boolean;
  2691. }
  2692. /** The ContextMenu widget displays a single- or multi-level context menu. An end user invokes this menu by a right click or a long press. */
  2693. export class dxContextMenu extends dxMenuBase {
  2694. constructor(element: Element, options?: dxContextMenuOptions)
  2695. constructor(element: JQuery, options?: dxContextMenuOptions)
  2696. /** Hides the widget. */
  2697. hide(): Promise<void> & JQueryPromise<void>;
  2698. /** Shows the widget. */
  2699. show(): Promise<void> & JQueryPromise<void>;
  2700. /** Shows or hides the widget depending on the argument. */
  2701. toggle(showing: boolean): Promise<void> & JQueryPromise<void>;
  2702. }
  2703. /** This section lists the data source fields that are used in a default item template. */
  2704. export interface dxContextMenuItem extends dxMenuBaseItem {
  2705. /** Holds an array of menu items. */
  2706. items?: Array<dxContextMenuItem>;
  2707. }
  2708. export interface dxDataGridOptions extends GridBaseOptions<dxDataGrid> {
  2709. /** An array of grid columns. */
  2710. columns?: Array<dxDataGridColumn | string>;
  2711. /** Customizes columns after they are created. */
  2712. customizeColumns?: ((columns: Array<dxDataGridColumn>) => any);
  2713. /** Customizes data before export. You can use the export.customizeExcelCell function instead. */
  2714. customizeExportData?: ((columns: Array<dxDataGridColumn>, rows: Array<dxDataGridRowObject>) => any);
  2715. /** Configures editing. */
  2716. editing?: dxDataGridEditing;
  2717. /** Configures client-side exporting. */
  2718. export?: { allowExportSelectedData?: boolean, customizeExcelCell?: ((options: { component?: dxDataGrid, horizontalAlignment?: 'center' | 'centerContinuous' | 'distributed' | 'fill' | 'general' | 'justify' | 'left' | 'right', verticalAlignment?: 'bottom' | 'center' | 'distributed' | 'justify' | 'top', wrapTextEnabled?: boolean, backgroundColor?: string, fillPatternType?: 'darkDown' | 'darkGray' | 'darkGrid' | 'darkHorizontal' | 'darkTrellis' | 'darkUp' | 'darkVertical' | 'gray0625' | 'gray125' | 'lightDown' | 'lightGray' | 'lightGrid' | 'lightHorizontal' | 'lightTrellis' | 'lightUp' | 'lightVertical' | 'mediumGray' | 'none' | 'solid', fillPatternColor?: string, font?: DevExpress.exporter.ExcelFont, value?: string | number | Date, numberFormat?: string, gridCell?: DevExpress.exporter.ExcelDataGridCell }) => any), enabled?: boolean, excelFilterEnabled?: boolean, excelWrapTextEnabled?: boolean, fileName?: string, ignoreExcelErrors?: boolean, proxyUrl?: string, texts?: { exportAll?: string, exportSelectedRows?: string, exportTo?: string } };
  2719. /** Configures the group panel. */
  2720. groupPanel?: { allowColumnDragging?: boolean, emptyPanelText?: string, visible?: boolean | 'auto' };
  2721. /** Configures grouping. */
  2722. grouping?: { allowCollapsing?: boolean, autoExpandAll?: boolean, contextMenuEnabled?: boolean, expandMode?: 'buttonClick' | 'rowClick', texts?: { groupByThisColumn?: string, groupContinuedMessage?: string, groupContinuesMessage?: string, ungroup?: string, ungroupAll?: string } };
  2723. /** Specifies which data field provides keys for data items. Applies only if data is a simple array. */
  2724. keyExpr?: string | Array<string>;
  2725. /** Allows you to build a master-detail interface in the grid. */
  2726. masterDetail?: { autoExpandAll?: boolean, enabled?: boolean, template?: template | ((detailElement: DevExpress.core.dxElement, detailInfo: { key?: any, data?: any, watch?: Function }) => any) };
  2727. /** A function that is executed when a cell is clicked or tapped. Executed before onRowClick. */
  2728. onCellClick?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, data?: any, key?: any, value?: any, displayValue?: any, text?: string, columnIndex?: number, column?: any, rowIndex?: number, rowType?: string, cellElement?: DevExpress.core.dxElement, row?: dxDataGridRowObject }) => any) | string;
  2729. /** A function that is executed when a cell is double-clicked or double-tapped. Executed before onRowDblClick. */
  2730. onCellDblClick?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, event?: event, data?: any, key?: any, value?: any, displayValue?: any, text?: string, columnIndex?: number, column?: dxDataGridColumn, rowIndex?: number, rowType?: string, cellElement?: DevExpress.core.dxElement, row?: dxDataGridRowObject }) => any);
  2731. /** A function that is executed after the pointer enters or leaves a cell. */
  2732. onCellHoverChanged?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, eventType?: string, data?: any, key?: any, value?: any, text?: string, displayValue?: any, columnIndex?: number, rowIndex?: number, column?: dxDataGridColumn, rowType?: string, cellElement?: DevExpress.core.dxElement, row?: dxDataGridRowObject }) => any);
  2733. /** A function that is executed after a cell is created. */
  2734. onCellPrepared?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, value?: any, displayValue?: any, text?: string, columnIndex?: number, column?: dxDataGridColumn, rowIndex?: number, rowType?: string, row?: dxDataGridRowObject, isSelected?: boolean, isExpanded?: boolean, isNewRow?: boolean, cellElement?: DevExpress.core.dxElement, watch?: Function, oldValue?: any }) => any);
  2735. /** A function that is executed before the context menu is rendered. */
  2736. onContextMenuPreparing?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, items?: Array<any>, target?: string, targetElement?: DevExpress.core.dxElement, columnIndex?: number, column?: dxDataGridColumn, rowIndex?: number, row?: dxDataGridRowObject }) => any);
  2737. /** A function that is executed before a cell or row switches to the editing state. */
  2738. onEditingStart?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, cancel?: boolean, column?: any }) => any);
  2739. /** A function that is executed after an editor is created. Not executed for cells with an editCellTemplate. */
  2740. onEditorPrepared?: ((options: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, parentType?: string, value?: any, setValue?: any, updateValueTimeout?: number, width?: number, disabled?: boolean, rtlEnabled?: boolean, editorElement?: DevExpress.core.dxElement, readOnly?: boolean, dataField?: string, row?: dxDataGridRowObject }) => any);
  2741. /** A function used to customize or replace default editors. Not executed for cells with an editCellTemplate. */
  2742. onEditorPreparing?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, parentType?: string, value?: any, setValue?: any, updateValueTimeout?: number, width?: number, disabled?: boolean, rtlEnabled?: boolean, cancel?: boolean, editorElement?: DevExpress.core.dxElement, readOnly?: boolean, editorName?: string, editorOptions?: any, dataField?: string, row?: dxDataGridRowObject }) => any);
  2743. /** A function that is executed after data is exported. */
  2744. onExported?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any }) => any);
  2745. /** A function that is executed before data is exported. */
  2746. onExporting?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, fileName?: string, cancel?: boolean }) => any);
  2747. /** A function that is executed before a file with exported data is saved to the user's local storage. */
  2748. onFileSaving?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, fileName?: string, format?: string, data?: Blob, cancel?: boolean }) => any);
  2749. /** A function that is executed after the focused cell changes. */
  2750. onFocusedCellChanged?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, cellElement?: DevExpress.core.dxElement, columnIndex?: number, rowIndex?: number, row?: dxDataGridRowObject, column?: dxDataGridColumn }) => any);
  2751. /** A function that is executed before the focused cell changes. */
  2752. onFocusedCellChanging?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, cellElement?: DevExpress.core.dxElement, prevColumnIndex?: number, prevRowIndex?: number, newColumnIndex?: number, newRowIndex?: number, event?: event, rows?: Array<dxDataGridRowObject>, columns?: Array<dxDataGridColumn>, cancel?: boolean, isHighlighted?: boolean }) => any);
  2753. /** A function that is executed after the focused row changes. Applies only when focusedRowEnabled is true. */
  2754. onFocusedRowChanged?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, rowElement?: DevExpress.core.dxElement, rowIndex?: number, row?: dxDataGridRowObject }) => any);
  2755. /** A function that is executed before the focused row changes. Applies only when focusedRowEnabled is true. */
  2756. onFocusedRowChanging?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, rowElement?: DevExpress.core.dxElement, prevRowIndex?: number, newRowIndex?: number, event?: event, rows?: Array<dxDataGridRowObject>, cancel?: boolean }) => any);
  2757. /** A function that is executed when a row is clicked or tapped. */
  2758. onRowClick?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, data?: any, key?: any, values?: Array<any>, columns?: Array<any>, rowIndex?: number, rowType?: string, isSelected?: boolean, isExpanded?: boolean, isNewRow?: boolean, groupIndex?: number, rowElement?: DevExpress.core.dxElement, handled?: boolean }) => any) | string;
  2759. /** A function that is executed when a row is double-clicked or double-tapped. Executed after onCellDblClick. */
  2760. onRowDblClick?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, event?: event, data?: any, key?: any, values?: Array<any>, columns?: Array<dxDataGridColumn>, rowIndex?: number, rowType?: string, isSelected?: boolean, isExpanded?: boolean, isNewRow?: boolean, groupIndex?: number, rowElement?: DevExpress.core.dxElement }) => any);
  2761. /** A function that is executed after a row is created. */
  2762. onRowPrepared?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, values?: Array<any>, columns?: Array<dxDataGridColumn>, rowIndex?: number, rowType?: string, groupIndex?: number, isSelected?: boolean, isExpanded?: boolean, isNewRow?: boolean, rowElement?: DevExpress.core.dxElement }) => any);
  2763. /** Notifies the DataGrid of the server's data processing operations. */
  2764. remoteOperations?: boolean | { filtering?: boolean, groupPaging?: boolean, grouping?: boolean, paging?: boolean, sorting?: boolean, summary?: boolean } | 'auto';
  2765. /** Specifies a custom template for rows. */
  2766. rowTemplate?: template | ((rowElement: DevExpress.core.dxElement, rowInfo: any) => any);
  2767. /** Configures scrolling. */
  2768. scrolling?: dxDataGridScrolling;
  2769. /** Configures runtime selection. */
  2770. selection?: dxDataGridSelection;
  2771. /** Specifies filters for the rows that must be selected initially. Applies only if selection.deferred is true. */
  2772. selectionFilter?: string | Array<any> | Function;
  2773. /** Allows you to sort groups according to the values of group summary items. */
  2774. sortByGroupSummaryInfo?: Array<{ groupColumn?: string, sortOrder?: 'asc' | 'desc', summaryItem?: string | number }>;
  2775. /** Specifies the options of the grid summary. */
  2776. summary?: { calculateCustomSummary?: ((options: { component?: dxDataGrid, name?: string, summaryProcess?: string, value?: any, totalValue?: any, groupIndex?: number }) => any), groupItems?: Array<{ alignByColumn?: boolean, column?: string, customizeText?: ((itemInfo: { value?: string | number | Date, valueText?: string }) => string), displayFormat?: string, name?: string, showInColumn?: string, showInGroupFooter?: boolean, skipEmptyValues?: boolean, summaryType?: 'avg' | 'count' | 'custom' | 'max' | 'min' | 'sum' | string, valueFormat?: format }>, recalculateWhileEditing?: boolean, skipEmptyValues?: boolean, texts?: { avg?: string, avgOtherColumn?: string, count?: string, max?: string, maxOtherColumn?: string, min?: string, minOtherColumn?: string, sum?: string, sumOtherColumn?: string }, totalItems?: Array<{ alignment?: 'center' | 'left' | 'right', column?: string, cssClass?: string, customizeText?: ((itemInfo: { value?: string | number | Date, valueText?: string }) => string), displayFormat?: string, name?: string, showInColumn?: string, skipEmptyValues?: boolean, summaryType?: 'avg' | 'count' | 'custom' | 'max' | 'min' | 'sum' | string, valueFormat?: format }> };
  2777. }
  2778. /** Configures editing. */
  2779. export interface dxDataGridEditing extends GridBaseEditing {
  2780. /** Specifies whether a user can add new rows. */
  2781. allowAdding?: boolean;
  2782. /** Specifies whether a user can delete rows. It is called for each data row when defined as a function. */
  2783. allowDeleting?: boolean | ((options: { component?: dxDataGrid, row?: dxDataGridRowObject }) => boolean);
  2784. /** Specifies whether a user can update rows. It is called for each data row when defined as a function. */
  2785. allowUpdating?: boolean | ((options: { component?: dxDataGrid, row?: dxDataGridRowObject }) => boolean);
  2786. /** Contains options that specify texts for editing-related UI elements. */
  2787. texts?: any;
  2788. }
  2789. /** Configures scrolling. */
  2790. export interface dxDataGridScrolling extends GridBaseScrolling {
  2791. /** Specifies the scrolling mode. */
  2792. mode?: 'infinite' | 'standard' | 'virtual';
  2793. }
  2794. /** Configures runtime selection. */
  2795. export interface dxDataGridSelection extends GridBaseSelection {
  2796. /** Makes selection deferred. */
  2797. deferred?: boolean;
  2798. /** Specifies the mode in which all the records are selected. Applies only if selection.allowSelectAll is true. */
  2799. selectAllMode?: 'allPages' | 'page';
  2800. /** Specifies when to display check boxes in rows. Applies only if selection.mode is "multiple". */
  2801. showCheckBoxesMode?: 'always' | 'none' | 'onClick' | 'onLongTap';
  2802. }
  2803. /** The DataGrid is a widget that represents data from a local or remote source in the form of a grid. This widget offers such basic features as sorting, grouping, filtering, as well as more advanced capabilities, like state storing, export to Excel, master-detail interface, and many others. */
  2804. export class dxDataGrid extends GridBase {
  2805. constructor(element: Element, options?: dxDataGridOptions)
  2806. constructor(element: JQuery, options?: dxDataGridOptions)
  2807. /** Adds a new column. */
  2808. addColumn(columnOptions: any | string): void;
  2809. /** Adds an empty data row. */
  2810. addRow(): void;
  2811. /** Ungroups grid records. */
  2812. clearGrouping(): void;
  2813. /** Collapses master rows or groups of a specific level. */
  2814. collapseAll(groupIndex?: number): void;
  2815. /** Collapses a group or a master row with a specific key. */
  2816. collapseRow(key: any): Promise<void> & JQueryPromise<void>;
  2817. /** Expands master rows or groups of a specific level. Does not apply if data is remote. */
  2818. expandAll(groupIndex?: number): void;
  2819. /** Expands a group or a master row with a specific key. */
  2820. expandRow(key: any): Promise<void> & JQueryPromise<void>;
  2821. /** Exports grid data to Excel. */
  2822. exportToExcel(selectionOnly: boolean): void;
  2823. /** Gets the currently selected rows' keys. */
  2824. getSelectedRowKeys(): Array<any> & Promise<any> & JQueryPromise<any>;
  2825. /** Gets the selected rows' data objects. */
  2826. getSelectedRowsData(): Array<any> & Promise<any> & JQueryPromise<any>;
  2827. /** Gets the value of a total summary item. */
  2828. getTotalSummaryValue(summaryItemName: string): any;
  2829. /** Gets all visible columns. */
  2830. getVisibleColumns(): Array<dxDataGridColumn>;
  2831. /** Gets all visible columns at a specific hierarchical level of column headers. Use it to access banded columns. */
  2832. getVisibleColumns(headerLevel: number): Array<dxDataGridColumn>;
  2833. /** Gets currently rendered rows. */
  2834. getVisibleRows(): Array<dxDataGridRowObject>;
  2835. /** @deprecated Use addRow instead. */
  2836. /** Adds a new data row to a grid. */
  2837. insertRow(): void;
  2838. /** Checks whether a specific group or master row is expanded or collapsed. */
  2839. isRowExpanded(key: any): boolean;
  2840. /** Checks whether a row found using its data object is selected. Takes effect only if selection.deferred is true. */
  2841. isRowSelected(data: any): boolean;
  2842. /** Checks whether a row with a specific key is selected. */
  2843. isRowSelected(key: any): boolean;
  2844. /** @deprecated Use deleteRow instead. */
  2845. /** Removes a row with a specific index. */
  2846. removeRow(rowIndex: number): void;
  2847. /** Gets the total row count. */
  2848. totalCount(): number;
  2849. }
  2850. export interface dxDataGridColumn extends GridBaseColumn {
  2851. /** Specifies whether data from this column should be exported. Applies only if the column is visible. */
  2852. allowExporting?: boolean;
  2853. /** Specifies whether the user can group data by values of this column. Applies only when grouping is enabled. */
  2854. allowGrouping?: boolean;
  2855. /** Specifies whether groups appear expanded or not when records are grouped by a specific column. Setting this option makes sense only when grouping is allowed for this column. */
  2856. autoExpandGroup?: boolean;
  2857. /** Allows you to customize buttons in the editing column or create a custom command column. Applies only if the column's type is "buttons". */
  2858. buttons?: Array<'cancel' | 'delete' | 'edit' | 'save' | 'undelete' | dxDataGridColumnButton>;
  2859. /** Specifies a field name or a function that returns a field name or a value to be used for grouping column cells. */
  2860. calculateGroupValue?: string | ((rowData: any) => any);
  2861. /** An array of grid columns. */
  2862. columns?: Array<dxDataGridColumn | string>;
  2863. /** Specifies a custom template for group cells. */
  2864. groupCellTemplate?: template | ((cellElement: DevExpress.core.dxElement, cellInfo: any) => any);
  2865. /** Specifies the index of a column when grid records are grouped by the values of this column. */
  2866. groupIndex?: number;
  2867. /** Specifies whether or not to display the column when grid records are grouped by it. */
  2868. showWhenGrouped?: boolean;
  2869. /** Specifies the command column that this object customizes. */
  2870. type?: 'adaptive' | 'buttons' | 'detailExpand' | 'groupExpand' | 'selection';
  2871. }
  2872. /** Allows you to customize buttons in the editing column or create a custom command column. Applies only if the column's type is "buttons". */
  2873. export interface dxDataGridColumnButton extends GridBaseColumnButton {
  2874. /** The name used to identify a built-in button. */
  2875. name?: 'cancel' | 'delete' | 'edit' | 'save' | 'undelete' | string;
  2876. /** A function that is executed when the button is clicked or tapped. */
  2877. onClick?: ((e: { component?: dxDataGrid, element?: DevExpress.core.dxElement, model?: any, event?: event, row?: dxDataGridRowObject, column?: dxDataGridColumn }) => any) | string;
  2878. /** Specifies a custom button template. */
  2879. template?: template | ((cellElement: DevExpress.core.dxElement, cellInfo: { component?: dxDataGrid, data?: any, key?: any, columnIndex?: number, column?: dxDataGridColumn, rowIndex?: number, rowType?: string, row?: dxDataGridRowObject }) => string | Element | JQuery);
  2880. /** Specifies the button's visibility. */
  2881. visible?: boolean | ((options: { component?: dxDataGrid, row?: dxDataGridRowObject, column?: dxDataGridColumn }) => boolean);
  2882. }
  2883. /** This section describes the properties of a grid row. An object containing these properties comes to certain event-handling functions. */
  2884. export interface dxDataGridRowObject {
  2885. /** The data object represented by the row. */
  2886. data?: any;
  2887. /** The group index of the row. Available when the rowType is "group". */
  2888. groupIndex?: number;
  2889. /** Indicates whether the row is in the editing state. */
  2890. isEditing?: boolean;
  2891. /** Indicates whether the row is expanded or collapsed. Available if rowType is "data", "detail" or "group". */
  2892. isExpanded?: boolean;
  2893. /** Indicates that the row is added, but not yet saved. */
  2894. isNewRow?: boolean;
  2895. /** Indicates whether the row is selected. Available if rowType is "data". */
  2896. isSelected?: boolean;
  2897. /** The key of the data object represented by the row. */
  2898. key?: any;
  2899. /** The visible index of the row. */
  2900. rowIndex?: number;
  2901. /** The row's type. */
  2902. rowType?: string;
  2903. /** Values of the row as they exist in the data source. */
  2904. values?: Array<any>;
  2905. }
  2906. export interface dxDateBoxOptions extends dxDropDownEditorOptions<dxDateBox> {
  2907. /** Specifies whether or not adaptive widget rendering is enabled on a small screen. */
  2908. adaptivityEnabled?: boolean;
  2909. /** The text displayed on the Apply button. */
  2910. applyButtonText?: string;
  2911. /** Configures the calendar's value picker. Applies only if the pickerType is "calendar". */
  2912. calendarOptions?: dxCalendarOptions;
  2913. /** The text displayed on the Cancel button. */
  2914. cancelButtonText?: string;
  2915. /** Specifies the message displayed if the specified date is later than the max value or earlier than the min value. */
  2916. dateOutOfRangeMessage?: string;
  2917. /** Specifies the date-time value serialization format. Use it only if you do not specify the value at design time. */
  2918. dateSerializationFormat?: string;
  2919. /** Specifies dates to be disabled. Applies only if pickerType is "calendar". */
  2920. disabledDates?: Array<Date> | ((data: { component?: dxDateBox, date?: Date, view?: string }) => boolean);
  2921. /** Specifies the date display format. Ignored if the pickerType option is "native" */
  2922. displayFormat?: format;
  2923. /** Specifies the interval between neighboring values in the popup list in minutes. */
  2924. interval?: number;
  2925. /** Specifies the message displayed if the typed value is not a valid date or time. */
  2926. invalidDateMessage?: string;
  2927. /** The last date that can be selected within the widget. */
  2928. max?: Date | number | string;
  2929. /** @deprecated Use the calendarOptions option instead. */
  2930. /** Specifies the maximum zoom level of a calendar, which is used to pick the date. */
  2931. maxZoomLevel?: 'century' | 'decade' | 'month' | 'year';
  2932. /** The minimum date that can be selected within the widget. */
  2933. min?: Date | number | string;
  2934. /** @deprecated Use the calendarOptions option instead. */
  2935. /** Specifies the minimal zoom level of a calendar, which is used to pick the date. */
  2936. minZoomLevel?: 'century' | 'decade' | 'month' | 'year';
  2937. /** Specifies the type of the date/time picker. */
  2938. pickerType?: 'calendar' | 'list' | 'native' | 'rollers';
  2939. /** Specifies a placeholder for the input field. */
  2940. placeholder?: string;
  2941. /** Specifies whether to show the analog clock in the value picker. Applies only if type is "datetime" and pickerType is "calendar". */
  2942. showAnalogClock?: boolean;
  2943. /** A format used to display date/time information. */
  2944. type?: 'date' | 'datetime' | 'time';
  2945. /** Specifies whether to control user input using a mask created based on the displayFormat. */
  2946. useMaskBehavior?: boolean;
  2947. /** An object or a value specifying the date and time currently selected using the date box. */
  2948. value?: Date | number | string;
  2949. }
  2950. /** The DateBox is a widget that displays date and time in a specified format, and enables a user to pick or type in the required date/time value. */
  2951. export class dxDateBox extends dxDropDownEditor {
  2952. constructor(element: Element, options?: dxDateBoxOptions)
  2953. constructor(element: JQuery, options?: dxDateBoxOptions)
  2954. /** Closes the drop-down editor. */
  2955. close(): void;
  2956. /** Opens the drop-down editor. */
  2957. open(): void;
  2958. }
  2959. export interface dxDeferRenderingOptions extends WidgetOptions<dxDeferRendering> {
  2960. /** Specifies the animation to be used to show the rendered content. */
  2961. animation?: animationConfig;
  2962. /** A function that is executed when the content is rendered but not yet displayed. */
  2963. onRendered?: ((e: { component?: dxDeferRendering, element?: DevExpress.core.dxElement, model?: any }) => any);
  2964. /** A function that is executed when the content is displayed and animation is completed. */
  2965. onShown?: ((e: { component?: dxDeferRendering, element?: DevExpress.core.dxElement, model?: any }) => any);
  2966. /** Specifies when the widget content is rendered. */
  2967. renderWhen?: Promise<void> | JQueryPromise<void> | boolean;
  2968. /** Indicates if a load indicator should be shown until the widget's content is rendered. */
  2969. showLoadIndicator?: boolean;
  2970. /** Specifies a jQuery selector of items that should be rendered using a staggered animation. */
  2971. staggerItemSelector?: string;
  2972. }
  2973. /** The DeferRendering is a widget that waits for its content to be ready before rendering it. While the content is getting ready, the DeferRendering displays a loading indicator. */
  2974. export class dxDeferRendering extends Widget {
  2975. constructor(element: Element, options?: dxDeferRenderingOptions)
  2976. constructor(element: JQuery, options?: dxDeferRenderingOptions)
  2977. }
  2978. export interface dxDiagramOptions extends WidgetOptions<dxDiagram> {
  2979. /** An array of custom shapes. */
  2980. customShapes?: Array<{ allowHasText?: boolean, connectionPoints?: Array<{ side?: 'north' | 'east' | 'south' | 'west', x?: number, y?: number }>, defaultHeight?: number, defaultText?: string, defaultWidth?: number, id?: number, svgHeight?: number, svgLeft?: number, svgTop?: number, svgUrl?: string, svgWidth?: number, textHeight?: number, textLeft?: number, textTop?: number, textWidth?: number, title?: string }>;
  2981. /** An array of diagram edges. */
  2982. edges?: { dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions, fromExpr?: string | ((data: any) => any), keyExpr?: string | ((data: any) => any), toExpr?: string | ((data: any) => any) };
  2983. /** Configures export features. */
  2984. export?: { fileName?: string, proxyUrl?: string };
  2985. /** Specifies an auto-layout algorithm that the widget uses to build a diagram. */
  2986. layout?: 'tree' | 'sugiyama';
  2987. /** An array of diagram nodes. */
  2988. nodes?: { dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions, itemsExpr?: string | ((data: any) => any), keyExpr?: string | ((data: any) => any), parentKeyExpr?: string | ((data: any) => any), textExpr?: string | ((data: any) => any), typeExpr?: string | ((data: any) => any) };
  2989. /** A function that is executed when the diagram's data changes. */
  2990. onDataChanged?: ((e: { component?: dxDiagram, element?: DevExpress.core.dxElement, model?: any, data?: string }) => any);
  2991. }
  2992. /** [tags] ctp The Diagram widget provides a visual interface to help you design new and modify existing diagrams. #include common-ctp-note with { component: "Diagram" } */
  2993. export class dxDiagram extends Widget {
  2994. constructor(element: Element, options?: dxDiagramOptions)
  2995. constructor(element: JQuery, options?: dxDiagramOptions)
  2996. /** Populates the toolbox with items from a data source. */
  2997. createDataSource(parameters: DiagramDataSourceParameters): void;
  2998. /** Removes data source items from the toolbox. */
  2999. deleteDataSource(key: string): void;
  3000. /** Gets the diagram data. */
  3001. getData(): string;
  3002. /** Sets the diagram data. */
  3003. setData(data: string, updateExistingItemsOnly: boolean): void;
  3004. }
  3005. export interface dxDrawerOptions extends WidgetOptions<dxDrawer> {
  3006. /** Specifies the duration of the drawer's opening and closing animation (in milliseconds). Applies only if animationEnabled is true. */
  3007. animationDuration?: number;
  3008. /** Specifies whether to use an opening and closing animation. */
  3009. animationEnabled?: boolean;
  3010. /** Specifies whether to close the drawer if a user clicks or taps the view area. */
  3011. closeOnOutsideClick?: boolean | ((event: event) => boolean);
  3012. /** Specifies the drawer's width or height (depending on the drawer's position) in the opened state. */
  3013. maxSize?: number;
  3014. /** Specifies the drawer's width or height (depending on the drawer's position) in the closed state. */
  3015. minSize?: number;
  3016. /** Specifies whether the drawer is opened. */
  3017. opened?: boolean;
  3018. /** Specifies how the drawer interacts with the view in the opened state. */
  3019. openedStateMode?: 'overlap' | 'shrink' | 'push';
  3020. /** Specifies the drawer's position in relation to the view. */
  3021. position?: 'left' | 'right' | 'top' | 'bottom' | 'before' | 'after';
  3022. /** Specifies the drawer's reveal mode. */
  3023. revealMode?: 'slide' | 'expand';
  3024. /** Specifies whether to shade the view when the drawer is opened. */
  3025. shading?: boolean;
  3026. /** Specifies a CSS selector for the element in which the drawer should be rendered. Applies only when the openedStateMode is "overlap". */
  3027. target?: string | Element | JQuery;
  3028. /** Specifies the drawer's content. */
  3029. template?: template | ((Element: DevExpress.core.dxElement) => any);
  3030. }
  3031. /** The Drawer is a dismissible or permanently visible panel used for navigation in responsive web application layouts. */
  3032. export class dxDrawer extends Widget {
  3033. constructor(element: Element, options?: dxDrawerOptions)
  3034. constructor(element: JQuery, options?: dxDrawerOptions)
  3035. /** Gets the drawer's content. */
  3036. content(): DevExpress.core.dxElement;
  3037. /** Closes the drawer. */
  3038. hide(): Promise<void> & JQueryPromise<void>;
  3039. /** Opens the drawer. */
  3040. show(): Promise<void> & JQueryPromise<void>;
  3041. /** Opens or closes the drawer, reversing the current state. */
  3042. toggle(): Promise<void> & JQueryPromise<void>;
  3043. }
  3044. export interface dxDropDownBoxOptions extends DataExpressionMixinOptions<dxDropDownBox>, dxDropDownEditorOptions<dxDropDownBox> {
  3045. /** Specifies whether the widget allows a user to enter a custom value. */
  3046. acceptCustomValue?: boolean;
  3047. /** Specifies a custom template for the drop-down content. */
  3048. contentTemplate?: template | ((templateData: { component?: dxDropDownBox, value?: any }, contentElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3049. /** Configures the drop-down field which holds the content. */
  3050. dropDownOptions?: dxPopupOptions;
  3051. /** Specifies a custom template for the text field. Must contain the TextBox widget. */
  3052. fieldTemplate?: template | ((value: any, fieldElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3053. /** Specifies whether a user can open the drop-down list by clicking a text field. */
  3054. openOnFieldClick?: boolean;
  3055. /** Specifies the DOM events after which the widget's value should be updated. */
  3056. valueChangeEvent?: string;
  3057. }
  3058. /** The DropDownBox widget consists of a text field, which displays the current value, and a drop-down field, which can contain any UI element. */
  3059. export class dxDropDownBox extends dxDropDownEditor {
  3060. constructor(element: Element, options?: dxDropDownBoxOptions)
  3061. constructor(element: JQuery, options?: dxDropDownBoxOptions)
  3062. /** Gets the DataSource instance. */
  3063. getDataSource(): DevExpress.data.DataSource;
  3064. }
  3065. export interface dxDropDownButtonOptions extends WidgetOptions<dxDropDownButton> {
  3066. /** Provides data for the drop-down menu. */
  3067. dataSource?: string | Array<CollectionWidgetItem | any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions;
  3068. /** Specifies whether to wait until the drop-down menu is opened the first time to render its content. */
  3069. deferRendering?: boolean;
  3070. /** Specifies the data field whose values should be displayed in the drop-down menu. */
  3071. displayExpr?: string | ((itemData: any) => string);
  3072. /** Specifies custom content for the drop-down field. */
  3073. dropDownContentTemplate?: template | ((data: Array<string | number | any> | DevExpress.data.DataSource, contentElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3074. /** Configures the drop-down field. */
  3075. dropDownOptions?: dxPopupOptions;
  3076. /** Specifies whether users can use keyboard to focus the widget. */
  3077. focusStateEnabled?: boolean;
  3078. /** Specifies whether the widget changes its state when a user hovers the mouse pointer over it. */
  3079. hoverStateEnabled?: boolean;
  3080. /** Specifies the button's icon. */
  3081. icon?: string;
  3082. /** Specifies a custom template for drop-down menu items. */
  3083. itemTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3084. /** Provides drop-down menu items. */
  3085. items?: Array<dxDropDownButtonItem | any>;
  3086. /** Specifies which data field provides keys used to distinguish between the selected drop-down menu items. */
  3087. keyExpr?: string;
  3088. /** Specifies text or HTML markup displayed in the drop-down menu when it does not contain any items. */
  3089. noDataText?: string;
  3090. /** A function that is executed when the button is clicked or tapped. If splitButton is true, this function is executed for the action button only. */
  3091. onButtonClick?: ((e: { component?: dxDropDownButton, element?: DevExpress.core.dxElement, model?: any, event?: event, selectedItem?: any }) => any) | string;
  3092. /** A function that is executed when a drop-down menu item is clicked. */
  3093. onItemClick?: ((e: { component?: dxDropDownButton, element?: DevExpress.core.dxElement, model?: any, event?: event, itemData?: any, itemElement?: DevExpress.core.dxElement }) => any) | string;
  3094. /** A function that is executed when an item is selected or selection is canceled. In effect when useSelectMode is true. */
  3095. onSelectionChanged?: ((e: { component?: dxDropDownButton, element?: DevExpress.core.dxElement, model?: any, item?: any, previousItem?: any }) => any) | string;
  3096. /** Specifies whether the drop-down menu is opened. */
  3097. opened?: boolean;
  3098. /** Contains the selected item's data. Available when useSelectMode is true. */
  3099. selectedItem?: string | number | any;
  3100. /** Contains the selected item's key and allows you to specify the initially selected item. Applies when useSelectMode is true. */
  3101. selectedItemKey?: string | number;
  3102. /** Specifies whether the arrow icon should be displayed. */
  3103. showArrowIcon?: boolean;
  3104. /** Specifies whether to split the button in two: one executes an action, the other opens and closes the drop-down menu. */
  3105. splitButton?: boolean;
  3106. /** Specifies how the button is styled. */
  3107. stylingMode?: 'text' | 'outlined' | 'contained';
  3108. /** Specifies the button's text. Applies only if useSelectMode is false. */
  3109. text?: string;
  3110. /** Specifies whether the widget stores the selected drop-down menu item. */
  3111. useSelectMode?: boolean;
  3112. }
  3113. /** The DropDownButton is a button that opens a drop-down menu. */
  3114. export class dxDropDownButton extends Widget {
  3115. constructor(element: Element, options?: dxDropDownButtonOptions)
  3116. constructor(element: JQuery, options?: dxDropDownButtonOptions)
  3117. /** Closes the drop-down menu. */
  3118. close(): Promise<void> & JQueryPromise<void>;
  3119. /** Gets the DataSource instance. */
  3120. getDataSource(): DevExpress.data.DataSource;
  3121. /** Opens the drop-down menu. */
  3122. open(): Promise<void> & JQueryPromise<void>;
  3123. /** Opens or closes the drop-down menu, reversing the current state. */
  3124. toggle(): Promise<void> & JQueryPromise<void>;
  3125. /** Opens or closes the drop-down menu, depending on the argument. */
  3126. toggle(visibility: boolean): Promise<void> & JQueryPromise<void>;
  3127. }
  3128. /** This section describes object fields that can be used in the default item template. */
  3129. export interface dxDropDownButtonItem extends dxListItem {
  3130. }
  3131. export interface dxDropDownEditorOptions<T = dxDropDownEditor> extends dxTextBoxOptions<T> {
  3132. /** Specifies whether or not the widget allows an end-user to enter a custom value. */
  3133. acceptCustomValue?: boolean;
  3134. /** Specifies whether or not the widget changes its state when interacting with a user. */
  3135. activeStateEnabled?: boolean;
  3136. /** Specifies the way an end-user applies the selected value. */
  3137. applyValueMode?: 'instantly' | 'useButtons';
  3138. /** Allows you to add custom buttons to the input text field. */
  3139. buttons?: Array<'clear' | 'dropDown' | dxTextEditorButton>;
  3140. /** Specifies whether to render the drop-down field's content when it is displayed. If false, the content is rendered immediately. */
  3141. deferRendering?: boolean;
  3142. /** Specifies a custom template for the drop-down button. */
  3143. dropDownButtonTemplate?: template | ((buttonData: { text?: string, icon?: string }, contentElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3144. /** A function that is executed once the drop-down editor is closed. */
  3145. onClosed?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  3146. /** A function that is executed once the drop-down editor is opened. */
  3147. onOpened?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  3148. /** Specifies whether a user can open the drop-down list by clicking a text field. */
  3149. openOnFieldClick?: boolean;
  3150. /** Specifies whether or not the drop-down editor is displayed. */
  3151. opened?: boolean;
  3152. /** Specifies whether the drop-down button is visible. */
  3153. showDropDownButton?: boolean;
  3154. /** Specifies the currently selected value. */
  3155. value?: any;
  3156. }
  3157. /** A drop-down editor widget. */
  3158. export class dxDropDownEditor extends dxTextBox {
  3159. constructor(element: Element, options?: dxDropDownEditorOptions)
  3160. constructor(element: JQuery, options?: dxDropDownEditorOptions)
  3161. /** Closes the drop-down editor. */
  3162. close(): void;
  3163. /** Gets the popup window's content. */
  3164. content(): DevExpress.core.dxElement;
  3165. /** Gets the widget's `` element. */
  3166. field(): DevExpress.core.dxElement;
  3167. /** Opens the drop-down editor. */
  3168. open(): void;
  3169. }
  3170. export interface dxDropDownListOptions<T = dxDropDownList> extends DataExpressionMixinOptions<T>, dxDropDownEditorOptions<T> {
  3171. /** Returns the value currently displayed by the widget. */
  3172. displayValue?: string;
  3173. /** Specifies a custom template for group captions. */
  3174. groupTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3175. /** Specifies whether data items should be grouped. */
  3176. grouped?: boolean;
  3177. /** The minimum number of characters that must be entered into the text box to begin a search. Applies only if searchEnabled is true. */
  3178. minSearchLength?: number;
  3179. /** The text or HTML markup displayed by the widget if the item collection is empty. */
  3180. noDataText?: string;
  3181. /** A function that is executed when a list item is clicked or tapped. */
  3182. onItemClick?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: any, itemIndex?: number | any, event?: event }) => any);
  3183. /** A function that is executed when a list item is selected or selection is canceled. */
  3184. onSelectionChanged?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, selectedItem?: any }) => any);
  3185. /** A function that is executed after the widget's value is changed. */
  3186. onValueChanged?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, value?: any, previousValue?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  3187. /** Specifies whether to allow searching. */
  3188. searchEnabled?: boolean;
  3189. /** Specifies the name of a data source item field or an expression whose value is compared to the search criterion. */
  3190. searchExpr?: string | Function | Array<string | Function>;
  3191. /** Specifies a comparison operation used to search widget items. */
  3192. searchMode?: 'contains' | 'startswith';
  3193. /** Specifies the time delay, in milliseconds, after the last character has been typed in, before a search is executed. */
  3194. searchTimeout?: number;
  3195. /** Gets the currently selected item. */
  3196. selectedItem?: any;
  3197. /** Specifies whether or not the widget displays unfiltered values until a user types a number of characters exceeding the minSearchLength option value. */
  3198. showDataBeforeSearch?: boolean;
  3199. /** Specifies the currently selected value. May be an object if dataSource contains objects and valueExpr is not set. */
  3200. value?: any;
  3201. /** Specifies the DOM events after which the widget's value should be updated. */
  3202. valueChangeEvent?: string;
  3203. }
  3204. /** A base class for drop-down list widgets. */
  3205. export class dxDropDownList extends dxDropDownEditor {
  3206. constructor(element: Element, options?: dxDropDownListOptions)
  3207. constructor(element: JQuery, options?: dxDropDownListOptions)
  3208. /** Gets the DataSource instance. */
  3209. getDataSource(): DevExpress.data.DataSource;
  3210. }
  3211. export interface dxDropDownMenuOptions extends WidgetOptions<dxDropDownMenu> {
  3212. /** Specifies whether or not the widget changes its state when interacting with a user. */
  3213. activeStateEnabled?: boolean;
  3214. /** The name of the icon to be displayed by the DropDownMenu button. */
  3215. buttonIcon?: string;
  3216. /** The text displayed in the DropDownMenu button. */
  3217. buttonText?: string;
  3218. /** Overriden */
  3219. dataSource?: string | Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions;
  3220. /** Specifies whether the widget changes its state when a user pauses on it. */
  3221. hoverStateEnabled?: boolean;
  3222. /** Specifies a custom template for items. */
  3223. itemTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3224. /** An array of items displayed by the widget. */
  3225. items?: Array<any>;
  3226. /** A function that is executed when the button that opens the drop-down menu is clicked or tapped. */
  3227. onButtonClick?: ((e: { component?: dxDropDownMenu, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any) | string;
  3228. /** A function that is executed when a menu item is clicked or tapped. */
  3229. onItemClick?: ((e: { component?: dxDropDownMenu, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, event?: event }) => any) | string;
  3230. /** Specifies whether or not the drop-down menu is displayed. */
  3231. opened?: boolean;
  3232. /** Specifies the popup element's height in pixels. */
  3233. popupHeight?: number | string | Function;
  3234. /** Specifies the popup element's width in pixels. */
  3235. popupWidth?: number | string | Function;
  3236. /** Specifies whether or not to show the drop down menu within a Popover widget. */
  3237. usePopover?: boolean;
  3238. }
  3239. /** A drop-down menu widget. */
  3240. export class dxDropDownMenu extends Widget {
  3241. constructor(element: Element, options?: dxDropDownMenuOptions)
  3242. constructor(element: JQuery, options?: dxDropDownMenuOptions)
  3243. /** Closes the drop-down menu. */
  3244. close(): void;
  3245. /** Opens the drop-down menu. */
  3246. open(): void;
  3247. }
  3248. export interface dxFileManagerOptions extends WidgetOptions<dxFileManager> {
  3249. /** Customizes columns in details view. Applies only if itemView.mode is "details". */
  3250. customizeDetailColumns?: ((columns: Array<dxDataGridColumn>) => Array<dxDataGridColumn>);
  3251. /** Allows you to provide custom icons to be used as thumbnails. */
  3252. customizeThumbnail?: ((fileItem: any) => string);
  3253. /** Specifies the file provider. */
  3254. fileProvider?: any;
  3255. /** Configures the file and folder view. */
  3256. itemView?: { mode?: 'details' | 'thumbnails', showFolders?: boolean, showParentFolder?: boolean };
  3257. /** A function that is executed when the selected file is opened. */
  3258. onSelectedFileOpened?: ((e: { component?: dxFileManager, element?: DevExpress.core.dxElement, model?: any, fileItem?: any }) => any);
  3259. /** Specifies actions that a user is allowed to perform on files and folders. */
  3260. permissions?: { copy?: boolean, create?: boolean, move?: boolean, remove?: boolean, rename?: boolean, upload?: boolean };
  3261. /** Specifies whether a user can select a single or multiple files and folders in the item view simultaneously. */
  3262. selectionMode?: 'multiple' | 'single';
  3263. }
  3264. /** [tags] ctp The FileManager is a widget that allows users to upload, select, and manage files and directories in different file storages. #include common-ctp-note with { component: "FileManager" } */
  3265. export class dxFileManager extends Widget {
  3266. constructor(element: Element, options?: dxFileManagerOptions)
  3267. constructor(element: JQuery, options?: dxFileManagerOptions)
  3268. }
  3269. export interface dxFileUploaderOptions extends EditorOptions<dxFileUploader> {
  3270. /** Specifies a file type or several types accepted by the widget. */
  3271. accept?: string;
  3272. /** Specifies if an end user can remove a file from the selection and interrupt uploading. */
  3273. allowCanceling?: boolean;
  3274. /** Restricts file extensions that can be uploaded to the server. */
  3275. allowedFileExtensions?: Array<string>;
  3276. /** Specifies the chunk size in bytes. Applies only if uploadMode is "instantly" or "useButtons". Requires a server that can process file chunks. */
  3277. chunkSize?: number;
  3278. /** Specifies whether the widget can be focused using keyboard navigation. */
  3279. focusStateEnabled?: boolean;
  3280. /** The text displayed when the extension of the file being uploaded is not an allowed file extension. */
  3281. invalidFileExtensionMessage?: string;
  3282. /** The text displayed when the size of the file being uploaded is greater than the maxFileSize. */
  3283. invalidMaxFileSizeMessage?: string;
  3284. /** The text displayed when the size of the file being uploaded is less than the minFileSize. */
  3285. invalidMinFileSizeMessage?: string;
  3286. /** Specifies the text displayed on the area to which an end-user can drop a file. */
  3287. labelText?: string;
  3288. /** Specifies the maximum file size (in bytes) allowed for uploading. Applies only if uploadMode is "instantly" or "useButtons". */
  3289. maxFileSize?: number;
  3290. /** Specifies the minimum file size (in bytes) allowed for uploading. Applies only if uploadMode is "instantly" or "useButtons". */
  3291. minFileSize?: number;
  3292. /** Specifies whether the widget enables an end-user to select a single file or multiple files. */
  3293. multiple?: boolean;
  3294. /** Specifies the value passed to the name attribute of the underlying input element. Required to access uploaded files on the server. */
  3295. name?: string;
  3296. /** A function that is executed when a file segment is uploaded. */
  3297. onProgress?: ((e: { component?: dxFileUploader, element?: DevExpress.core.dxElement, model?: any, file?: File, segmentSize?: number, bytesLoaded?: number, bytesTotal?: number, jQueryEvent?: JQueryEventObject, event?: event, request?: XMLHttpRequest }) => any);
  3298. /** A function that is executed when the file upload is aborted. */
  3299. onUploadAborted?: ((e: { component?: dxFileUploader, element?: DevExpress.core.dxElement, model?: any, file?: File, jQueryEvent?: JQueryEventObject, event?: event, request?: XMLHttpRequest }) => any);
  3300. /** A function that is executed when an error occurs during the file upload. */
  3301. onUploadError?: ((e: { component?: dxFileUploader, element?: DevExpress.core.dxElement, model?: any, file?: File, jQueryEvent?: JQueryEventObject, event?: event, request?: XMLHttpRequest }) => any);
  3302. /** A function that is executed when the file upload is started. */
  3303. onUploadStarted?: ((e: { component?: dxFileUploader, element?: DevExpress.core.dxElement, model?: any, file?: File, jQueryEvent?: JQueryEventObject, event?: event, request?: XMLHttpRequest }) => any);
  3304. /** A function that is executed when a file is successfully uploaded. */
  3305. onUploaded?: ((e: { component?: dxFileUploader, element?: DevExpress.core.dxElement, model?: any, file?: File, jQueryEvent?: JQueryEventObject, event?: event, request?: XMLHttpRequest }) => any);
  3306. /** A function that is executed when one or several files are added to or removed from the selection. */
  3307. onValueChanged?: ((e: { component?: dxFileUploader, element?: DevExpress.core.dxElement, model?: any, value?: Array<File>, previousValue?: Array<File>, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  3308. /** Gets the current progress in percentages. */
  3309. progress?: number;
  3310. /** The message displayed by the widget when it is ready to upload the specified files. */
  3311. readyToUploadMessage?: string;
  3312. /** The text displayed on the button that opens the file browser. */
  3313. selectButtonText?: string;
  3314. /** Specifies whether or not the widget displays the list of selected files. */
  3315. showFileList?: boolean;
  3316. /** The text displayed on the button that starts uploading. */
  3317. uploadButtonText?: string;
  3318. /** The message displayed by the widget on uploading failure. */
  3319. uploadFailedMessage?: string;
  3320. /** Specifies headers for the upload request. */
  3321. uploadHeaders?: any;
  3322. /** Specifies the method for the upload request. */
  3323. uploadMethod?: 'POST' | 'PUT';
  3324. /** Specifies how the widget uploads files. */
  3325. uploadMode?: 'instantly' | 'useButtons' | 'useForm';
  3326. /** Specifies a target Url for the upload request. */
  3327. uploadUrl?: string;
  3328. /** The message displayed by the widget when uploading is finished. */
  3329. uploadedMessage?: string;
  3330. /** Specifies a File instance representing the selected file. Read-only when uploadMode is "useForm". */
  3331. value?: Array<File>;
  3332. }
  3333. /** The FileUploader widget enables an end user to upload files to the server. An end user can select files in the file explorer or drag and drop files to the FileUploader area on the page. */
  3334. export class dxFileUploader extends Editor {
  3335. constructor(element: Element, options?: dxFileUploaderOptions)
  3336. constructor(element: JQuery, options?: dxFileUploaderOptions)
  3337. }
  3338. export interface dxFilterBuilderOptions extends WidgetOptions<dxFilterBuilder> {
  3339. /** Specifies whether the widget can display hierarchical data fields. */
  3340. allowHierarchicalFields?: boolean;
  3341. /** Configures custom filter operations. */
  3342. customOperations?: Array<dxFilterBuilderCustomOperation>;
  3343. /** Configures fields. */
  3344. fields?: Array<dxFilterBuilderField>;
  3345. /** Specifies filter operation descriptions. */
  3346. filterOperationDescriptions?: { between?: string, contains?: string, endsWith?: string, equal?: string, greaterThan?: string, greaterThanOrEqual?: string, isBlank?: string, isNotBlank?: string, lessThan?: string, lessThanOrEqual?: string, notContains?: string, notEqual?: string, startsWith?: string };
  3347. /** Specifies group operation descriptions. */
  3348. groupOperationDescriptions?: { and?: string, notAnd?: string, notOr?: string, or?: string };
  3349. /** Specifies a set of available group operations. */
  3350. groupOperations?: Array<'and' | 'or' | 'notAnd' | 'notOr'>;
  3351. /** Specifies groups' maximum nesting level. */
  3352. maxGroupLevel?: number;
  3353. /** A function that is executed after an editor is created. */
  3354. onEditorPrepared?: ((e: { component?: dxFilterBuilder, element?: DevExpress.core.dxElement, model?: any, value?: any, setValue?: any, editorElement?: DevExpress.core.dxElement, editorName?: string, dataField?: string, filterOperation?: string, updateValueTimeout?: number, width?: number, readOnly?: boolean, disabled?: boolean, rtlEnabled?: boolean }) => any);
  3355. /** A function that is executed before an editor is created. */
  3356. onEditorPreparing?: ((e: { component?: dxFilterBuilder, element?: DevExpress.core.dxElement, model?: any, value?: any, setValue?: any, cancel?: boolean, editorElement?: DevExpress.core.dxElement, editorName?: string, editorOptions?: any, dataField?: string, filterOperation?: string, updateValueTimeout?: number, width?: number, readOnly?: boolean, disabled?: boolean, rtlEnabled?: boolean }) => any);
  3357. /** A function that is executed after the widget's value is changed. */
  3358. onValueChanged?: ((e: { component?: dxFilterBuilder, element?: DevExpress.core.dxElement, model?: any, value?: any, previousValue?: any }) => any);
  3359. /** Allows you to specify a filter. */
  3360. value?: string | Array<any> | Function;
  3361. }
  3362. /** The FilterBuilder widget allows a user to build complex filter expressions with an unlimited number of filter conditions, combined by logical operations using the UI. */
  3363. export class dxFilterBuilder extends Widget {
  3364. constructor(element: Element, options?: dxFilterBuilderOptions)
  3365. constructor(element: JQuery, options?: dxFilterBuilderOptions)
  3366. /** Gets a filter expression that contains only operations supported by the DataSource. */
  3367. getFilterExpression(): string | Array<any> | Function;
  3368. }
  3369. export interface dxFilterBuilderCustomOperation {
  3370. /** Specifies a function that returns a filter expression for this custom operation. */
  3371. calculateFilterExpression?: ((filterValue: any, field: dxFilterBuilderField) => string | Array<any> | Function);
  3372. /** Specifies the operation's caption. */
  3373. caption?: string;
  3374. /** Customizes the field value's text representation. */
  3375. customizeText?: ((fieldInfo: { value?: string | number | Date, valueText?: string, field?: dxFilterBuilderField }) => string);
  3376. /** Specifies for which data types the operation is available by default. */
  3377. dataTypes?: Array<'string' | 'number' | 'date' | 'boolean' | 'object' | 'datetime'>;
  3378. /** Specifies a custom template for the widget used to edit the field value. */
  3379. editorTemplate?: template | ((conditionInfo: { value?: string | number | Date, field?: dxFilterBuilderField, setValue?: Function }, container: DevExpress.core.dxElement) => string | Element | JQuery);
  3380. /** Specifies whether the operation can have a value. If it can, the editor is displayed. */
  3381. hasValue?: boolean;
  3382. /** Specifies the icon that should represent the filter operation. */
  3383. icon?: string;
  3384. /** Specifies the operation's identifier. */
  3385. name?: string;
  3386. }
  3387. /** The FilterBuilder's field structure. */
  3388. export interface dxFilterBuilderField {
  3389. /** Specifies the field's custom filtering rules. */
  3390. calculateFilterExpression?: ((filterValue: any, selectedFilterOperation: string) => string | Array<any> | Function);
  3391. /** Specifies the data field's caption. */
  3392. caption?: string;
  3393. /** Customizes the input value's display text. */
  3394. customizeText?: ((fieldInfo: { value?: string | number | Date, valueText?: string }) => string);
  3395. /** Specifies the name of a field to be filtered. */
  3396. dataField?: string;
  3397. /** Casts field values to a specific data type. */
  3398. dataType?: 'string' | 'number' | 'date' | 'boolean' | 'object' | 'datetime';
  3399. /** Configures the widget used to edit the field value. */
  3400. editorOptions?: any;
  3401. /** Specifies the editor's custom template. */
  3402. editorTemplate?: template | ((conditionInfo: { value?: string | number | Date, filterOperation?: string, field?: dxFilterBuilderField, setValue?: Function }, container: DevExpress.core.dxElement) => string | Element | JQuery);
  3403. /** Specifies the false value text. Applies only if dataType is "boolean". */
  3404. falseText?: string;
  3405. /** Specifies a set of available filter operations. */
  3406. filterOperations?: Array<'=' | '<>' | '<' | '<=' | '>' | '>=' | 'contains' | 'endswith' | 'isblank' | 'isnotblank' | 'notcontains' | 'startswith' | 'between' | string>;
  3407. /** Formats a value before it is displayed. */
  3408. format?: format;
  3409. /** Configures the lookup field. */
  3410. lookup?: { allowClearing?: boolean, dataSource?: Array<any> | DevExpress.data.DataSourceOptions, displayExpr?: string | ((data: any) => any), valueExpr?: string | Function };
  3411. /** Specifies the field's name. Use it to distinguish the field from other fields when they have identical dataField values. */
  3412. name?: string;
  3413. /** Specifies the true value text. Applies only if dataType is "boolean". */
  3414. trueText?: string;
  3415. }
  3416. export interface dxFormOptions extends WidgetOptions<dxForm> {
  3417. /** Specifies whether or not all root item labels are aligned. */
  3418. alignItemLabels?: boolean;
  3419. /** Specifies whether or not item labels in all groups are aligned. */
  3420. alignItemLabelsInAllGroups?: boolean;
  3421. /** The count of columns in the form layout. */
  3422. colCount?: number | 'auto';
  3423. /** Specifies dependency between the screen factor and the count of columns in the form layout. */
  3424. colCountByScreen?: any;
  3425. /** Specifies a function that customizes a form item after it has been created. */
  3426. customizeItem?: ((item: dxFormSimpleItem | dxFormGroupItem | dxFormTabbedItem | dxFormEmptyItem | dxFormButtonItem) => any);
  3427. /** Provides the Form's data. Gets updated every time form fields change. */
  3428. formData?: any;
  3429. /** Holds an array of form items. */
  3430. items?: Array<dxFormSimpleItem | dxFormGroupItem | dxFormTabbedItem | dxFormEmptyItem | dxFormButtonItem>;
  3431. /** Specifies the location of a label against the editor. */
  3432. labelLocation?: 'left' | 'right' | 'top';
  3433. /** The minimum column width used for calculating column count in the form layout. */
  3434. minColWidth?: number;
  3435. /** A function that is executed when the Enter key has been pressed while an editor is focused. */
  3436. onEditorEnterKey?: ((e: { component?: dxForm, element?: DevExpress.core.dxElement, model?: any, dataField?: string }) => any);
  3437. /** A function that is executed when the value of a formData object field is changed. */
  3438. onFieldDataChanged?: ((e: { component?: dxForm, element?: DevExpress.core.dxElement, model?: any, dataField?: string, value?: any }) => any);
  3439. /** The text displayed for optional fields. */
  3440. optionalMark?: string;
  3441. /** Specifies whether all editors on the form are read-only. Applies only to non-templated items. */
  3442. readOnly?: boolean;
  3443. /** The text displayed for required fields. */
  3444. requiredMark?: string;
  3445. /** Specifies the message that is shown for end-users if a required field value is not specified. */
  3446. requiredMessage?: string;
  3447. /** Specifies a function that categorizes screens by their width. */
  3448. screenByWidth?: Function;
  3449. /** A Boolean value specifying whether to enable or disable form scrolling. */
  3450. scrollingEnabled?: boolean;
  3451. /** Specifies whether or not a colon is displayed at the end of form labels. */
  3452. showColonAfterLabel?: boolean;
  3453. /** Specifies whether or not the optional mark is displayed for optional fields. */
  3454. showOptionalMark?: boolean;
  3455. /** Specifies whether or not the required mark is displayed for required fields. */
  3456. showRequiredMark?: boolean;
  3457. /** Specifies whether or not the total validation summary is displayed on the form. */
  3458. showValidationSummary?: boolean;
  3459. /** Gives a name to the internal validation group. */
  3460. validationGroup?: string;
  3461. }
  3462. /** The Form widget represents fields of a data object as a collection of label-editor pairs. These pairs can be arranged in several groups, tabs and columns. */
  3463. export class dxForm extends Widget {
  3464. constructor(element: Element, options?: dxFormOptions)
  3465. constructor(element: JQuery, options?: dxFormOptions)
  3466. /** Gets a button's instance. */
  3467. getButton(name: string): dxButton | undefined;
  3468. /** Gets an editor instance. Takes effect only if the form item is visible. */
  3469. getEditor(dataField: string): Editor | undefined;
  3470. /** Gets a form item's configuration. */
  3471. itemOption(id: string): any;
  3472. /** Updates the value of a single item option. */
  3473. itemOption(id: string, option: string, value: any): void;
  3474. /** Updates the values of several item options. */
  3475. itemOption(id: string, options: any): void;
  3476. /** Resets the editor's value to undefined. */
  3477. resetValues(): void;
  3478. /** Merges the passed `data` object with formData. Matching properties in formData are overwritten and new properties added. */
  3479. updateData(data: any): void;
  3480. /** Updates a formData field and the corresponding editor. */
  3481. updateData(dataField: string, value: any): void;
  3482. /** Updates the dimensions of the widget contents. */
  3483. updateDimensions(): Promise<void> & JQueryPromise<void>;
  3484. /** Validates the values of all editors on the form against the list of the validation rules specified for each form item. */
  3485. validate(): dxValidationGroupResult;
  3486. }
  3487. /** Configures a button form item. */
  3488. export interface dxFormButtonItem {
  3489. /** @deprecated Use horizontalAlignment instead. */
  3490. /** Specifies the button's horizontal alignment. */
  3491. alignment?: 'center' | 'left' | 'right';
  3492. /** Configures the button. */
  3493. buttonOptions?: dxButtonOptions;
  3494. /** Specifies how many columns the item spans. */
  3495. colSpan?: number;
  3496. /** Specifies a CSS class to be applied to the item. */
  3497. cssClass?: string;
  3498. /** Specifies the button's horizontal alignment. */
  3499. horizontalAlignment?: 'center' | 'left' | 'right';
  3500. /** Specifies the item's type. Set it to "button" to create a button item. */
  3501. itemType?: 'empty' | 'group' | 'simple' | 'tabbed' | 'button';
  3502. /** Specifies the item's identifier. */
  3503. name?: string;
  3504. /** Specifies the button's vertical alignment. */
  3505. verticalAlignment?: 'bottom' | 'center' | 'top';
  3506. /** Specifies whether the item is visible. */
  3507. visible?: boolean;
  3508. /** Specifies the item's position regarding other items in a group, tab, or the whole widget. */
  3509. visibleIndex?: number;
  3510. }
  3511. /** This article describes configuration options of an empty form item. */
  3512. export interface dxFormEmptyItem {
  3513. /** Specifies the number of columns spanned by the item. */
  3514. colSpan?: number;
  3515. /** Specifies a CSS class to be applied to the form item. */
  3516. cssClass?: string;
  3517. /** Specifies the item's type. Set it to "empty" to create an empty item. */
  3518. itemType?: 'empty' | 'group' | 'simple' | 'tabbed' | 'button';
  3519. /** Specifies a name that identifies the form item. */
  3520. name?: string;
  3521. /** Specifies whether or not the current form item is visible. */
  3522. visible?: boolean;
  3523. /** Specifies the sequence number of the item in a form, group or tab. */
  3524. visibleIndex?: number;
  3525. }
  3526. /** This article describes configuration options of a group form item. */
  3527. export interface dxFormGroupItem {
  3528. /** Specifies whether or not all group item labels are aligned. */
  3529. alignItemLabels?: boolean;
  3530. /** Specifies the group caption. */
  3531. caption?: string;
  3532. /** The count of columns in the group layout. */
  3533. colCount?: number;
  3534. /** Specifies the relation between the screen size qualifier and the number of columns in the grouped layout. */
  3535. colCountByScreen?: any;
  3536. /** Specifies the number of columns spanned by the item. */
  3537. colSpan?: number;
  3538. /** Specifies a CSS class to be applied to the form item. */
  3539. cssClass?: string;
  3540. /** Specifies the item's type. Set it to "group" to create a group item. */
  3541. itemType?: 'empty' | 'group' | 'simple' | 'tabbed' | 'button';
  3542. /** Holds an array of form items displayed within the group. */
  3543. items?: Array<dxFormSimpleItem | dxFormGroupItem | dxFormTabbedItem | dxFormEmptyItem | dxFormButtonItem>;
  3544. /** Specifies a name that identifies the form item. */
  3545. name?: string;
  3546. /** A template to be used for rendering a group item. */
  3547. template?: template | ((data: { component?: dxForm, formData?: any }, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3548. /** Specifies whether or not the current form item is visible. */
  3549. visible?: boolean;
  3550. /** Specifies the sequence number of the item in a form, group or tab. */
  3551. visibleIndex?: number;
  3552. }
  3553. /** This article describes configuration options of a simple form item. */
  3554. export interface dxFormSimpleItem {
  3555. /** Specifies the number of columns spanned by the item. */
  3556. colSpan?: number;
  3557. /** Specifies a CSS class to be applied to the form item. */
  3558. cssClass?: string;
  3559. /** Specifies the path to the formData object field bound to the current form item. */
  3560. dataField?: string;
  3561. /** Configures the form item's editor. */
  3562. editorOptions?: any;
  3563. /** Specifies which editor widget is used to display and edit the form item value. */
  3564. editorType?: 'dxAutocomplete' | 'dxCalendar' | 'dxCheckBox' | 'dxColorBox' | 'dxDateBox' | 'dxDropDownBox' | 'dxHtmlEditor' | 'dxLookup' | 'dxNumberBox' | 'dxRadioGroup' | 'dxRangeSlider' | 'dxSelectBox' | 'dxSlider' | 'dxSwitch' | 'dxTagBox' | 'dxTextArea' | 'dxTextBox';
  3565. /** Specifies the help text displayed for the current form item. */
  3566. helpText?: string;
  3567. /** Specifies whether the current form item is required. */
  3568. isRequired?: boolean;
  3569. /** Specifies the item's type. Set it to "simple" to create a simple item. */
  3570. itemType?: 'empty' | 'group' | 'simple' | 'tabbed' | 'button';
  3571. /** Specifies options for the form item label. */
  3572. label?: { alignment?: 'center' | 'left' | 'right', location?: 'left' | 'right' | 'top', showColon?: boolean, text?: string, visible?: boolean };
  3573. /** Specifies a name that identifies the form item. */
  3574. name?: string;
  3575. /** A template to be used for rendering the form item. */
  3576. template?: template | ((data: { component?: dxForm, dataField?: string, editorOptions?: any, editorType?: string, name?: string }, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3577. /** An array of validation rules to be checked for the form item editor. */
  3578. validationRules?: Array<RequiredRule | NumericRule | RangeRule | StringLengthRule | CustomRule | CompareRule | PatternRule | EmailRule>;
  3579. /** Specifies whether or not the current form item is visible. */
  3580. visible?: boolean;
  3581. /** Specifies the sequence number of the item in a form, group or tab. */
  3582. visibleIndex?: number;
  3583. }
  3584. /** This article describes configuration options of a tabbed form item. */
  3585. export interface dxFormTabbedItem {
  3586. /** Specifies the number of columns spanned by the item. */
  3587. colSpan?: number;
  3588. /** Specifies a CSS class to be applied to the form item. */
  3589. cssClass?: string;
  3590. /** Specifies the item's type. Set it to "tabbed" to create a tabbed item. */
  3591. itemType?: 'empty' | 'group' | 'simple' | 'tabbed' | 'button';
  3592. /** Specifies a name that identifies the form item. */
  3593. name?: string;
  3594. /** Holds a configuration object for the TabPanel widget used to display the current form item. */
  3595. tabPanelOptions?: dxTabPanelOptions;
  3596. /** An array of tab configuration objects. */
  3597. tabs?: Array<{ alignItemLabels?: boolean, badge?: string, colCount?: number, colCountByScreen?: any, disabled?: boolean, icon?: string, items?: Array<dxFormSimpleItem | dxFormGroupItem | dxFormTabbedItem | dxFormEmptyItem | dxFormButtonItem>, tabTemplate?: template | ((tabData: any, tabIndex: number, tabElement: DevExpress.core.dxElement) => any), template?: template | ((tabData: any, tabIndex: number, tabElement: DevExpress.core.dxElement) => any), title?: string }>;
  3598. /** Specifies whether or not the current form item is visible. */
  3599. visible?: boolean;
  3600. /** Specifies the sequence number of the item in a form, group or tab. */
  3601. visibleIndex?: number;
  3602. }
  3603. export interface dxGalleryOptions extends CollectionWidgetOptions<dxGallery> {
  3604. /** The time, in milliseconds, spent on slide animation. */
  3605. animationDuration?: number;
  3606. /** Specifies whether or not to animate the displayed item change. */
  3607. animationEnabled?: boolean;
  3608. /** Specifies whether the widget can be focused using keyboard navigation. */
  3609. focusStateEnabled?: boolean;
  3610. /** A Boolean value specifying whether or not to allow users to switch between items by clicking an indicator. */
  3611. indicatorEnabled?: boolean;
  3612. /** Specifies the width of an area used to display a single image. */
  3613. initialItemWidth?: number;
  3614. /** An array of items displayed by the widget. */
  3615. items?: Array<string | dxGalleryItem | any>;
  3616. /** A Boolean value specifying whether or not to scroll back to the first item after the last item is swiped. */
  3617. loop?: boolean;
  3618. /** The index of the currently active gallery item. */
  3619. selectedIndex?: number;
  3620. /** A Boolean value specifying whether or not to display an indicator that points to the selected gallery item. */
  3621. showIndicator?: boolean;
  3622. /** A Boolean value that specifies the availability of the "Forward" and "Back" navigation buttons. */
  3623. showNavButtons?: boolean;
  3624. /** The time interval in milliseconds, after which the gallery switches to the next item. */
  3625. slideshowDelay?: number;
  3626. /** Specifies if the widget stretches images to fit the total gallery width. */
  3627. stretchImages?: boolean;
  3628. /** A Boolean value specifying whether or not to allow users to switch between items by swiping. */
  3629. swipeEnabled?: boolean;
  3630. /** Specifies whether or not to display parts of previous and next images along the sides of the current image. */
  3631. wrapAround?: boolean;
  3632. }
  3633. /** The Gallery is a widget that displays a collection of images in a carousel. The widget is supplied with various navigation controls that allow a user to switch between images. */
  3634. export class dxGallery extends CollectionWidget {
  3635. constructor(element: Element, options?: dxGalleryOptions)
  3636. constructor(element: JQuery, options?: dxGalleryOptions)
  3637. /** Shows a specific image. */
  3638. goToItem(itemIndex: number, animation: boolean): Promise<void> & JQueryPromise<void>;
  3639. /** Shows the next image. */
  3640. nextItem(animation: boolean): Promise<void> & JQueryPromise<void>;
  3641. /** Shows the previous image. */
  3642. prevItem(animation: boolean): Promise<void> & JQueryPromise<void>;
  3643. }
  3644. /** This section lists the data source fields that are used in a default template for gallery items. */
  3645. export interface dxGalleryItem extends CollectionWidgetItem {
  3646. /** Specifies the text passed to the alt attribute of the image markup element. */
  3647. imageAlt?: string;
  3648. /** Specifies the URL of the image displayed by the item. */
  3649. imageSrc?: string;
  3650. }
  3651. export interface dxHtmlEditorOptions extends EditorOptions<dxHtmlEditor> {
  3652. /** Allows you to customize Quill and 3rd-party modules. */
  3653. customizeModules?: ((config: any) => any);
  3654. /** Specifies whether the widget can be focused using keyboard navigation. */
  3655. focusStateEnabled?: boolean;
  3656. /** Configures media resizing. */
  3657. mediaResizing?: dxHtmlEditorMediaResizing;
  3658. /** Configures mentions. */
  3659. mentions?: Array<dxHtmlEditorMention>;
  3660. /** The value to be assigned to the `name` attribute of the underlying HTML element. */
  3661. name?: string;
  3662. /** A function that is executed when the widget gets focus. */
  3663. onFocusIn?: ((e: { component?: dxHtmlEditor, element?: DevExpress.core.dxElement, model?: any, event?: event }) => any);
  3664. /** A function that is executed when the widget loses focus. */
  3665. onFocusOut?: ((e: { component?: dxHtmlEditor, element?: DevExpress.core.dxElement, model?: any, event?: event }) => any);
  3666. /** Specifies the text displayed when the input field is empty. */
  3667. placeholder?: string;
  3668. /** Configures the widget's toolbar. */
  3669. toolbar?: dxHtmlEditorToolbar;
  3670. /** Specifies in which markup language the value is stored. */
  3671. valueType?: 'html' | 'markdown';
  3672. /** Configures variables, which are placeholders to be replaced with actual values when processing text. */
  3673. variables?: dxHtmlEditorVariables;
  3674. }
  3675. /** [tags] ctp HtmlEditor is a WYSIWYG editor that allows you to format textual and visual content and to output it in HTML or Markdown. HtmlEditor is built on top of and requires Quill. #include common-ctp-note with { component: "HtmlEditor" } */
  3676. export class dxHtmlEditor extends Editor {
  3677. constructor(element: Element, options?: dxHtmlEditorOptions)
  3678. constructor(element: JQuery, options?: dxHtmlEditorOptions)
  3679. /** Clears the history of changes. */
  3680. clearHistory(): void;
  3681. /** Deletes content from the given range. */
  3682. delete(index: number, length: number): void;
  3683. /** Applies a format to the selected content. Cannot be used with embedded formats. */
  3684. format(formatName: 'background' | 'bold' | 'color' | 'font' | 'italic' | 'link' | 'size' | 'strike' | 'script' | 'underline' | 'blockquote' | 'header' | 'indent' | 'list' | 'align' | 'code-block' | string, formatValue: any): void;
  3685. /** Applies a single block format to all lines in the given range. */
  3686. formatLine(index: number, length: number, formatName: 'background' | 'bold' | 'color' | 'font' | 'italic' | 'link' | 'size' | 'strike' | 'script' | 'underline' | 'blockquote' | 'header' | 'indent' | 'list' | 'align' | 'code-block' | string, formatValue: any): void;
  3687. /** Applies several block formats to all lines in the given range. */
  3688. formatLine(index: number, length: number, formats: any): void;
  3689. /** Applies a single text format to all characters in the given range. */
  3690. formatText(index: number, length: number, formatName: 'background' | 'bold' | 'color' | 'font' | 'italic' | 'link' | 'size' | 'strike' | 'script' | 'underline' | 'blockquote' | 'header' | 'indent' | 'list' | 'align' | 'code-block' | string, formatValue: any): void;
  3691. /** Applies several text formats to all characters in the given range. */
  3692. formatText(index: number, length: number, formats: any): void;
  3693. /** Gets a format, module, or Parchment. */
  3694. get(componentPath: string): any;
  3695. /** Gets formats applied to the content in the specified range. */
  3696. getFormat(index: number, length: number): any;
  3697. /** Gets the instance of a widget found using its DOM node. */
  3698. static getInstance(element: Element | JQuery): DOMComponent;
  3699. /** Gets the entire content's length. */
  3700. getLength(): number;
  3701. /** Gets Quill's instance. */
  3702. getQuillInstance(): any;
  3703. /** Gets the selected content's position and length. */
  3704. getSelection(): any;
  3705. /** Inserts an embedded content at the specified position. */
  3706. insertEmbed(index: number, type: string, config: any): void;
  3707. /** Inserts formatted text at the specified position. Used with all formats except embedded. */
  3708. insertText(index: number, text: string, formats: any): void;
  3709. /** Reapplies the most recent undone change. Repeated calls reapply preceding undone changes. */
  3710. redo(): void;
  3711. /** Registers custom formats and modules. */
  3712. register(modules: any): void;
  3713. /** Registers a handler to be executed when a user presses a specific key. */
  3714. registerKeyHandler(key: string, handler: Function): void;
  3715. /** Removes all formatting and embedded content from the specified range. */
  3716. removeFormat(index: number, length: number): void;
  3717. /** Selects and highlights content in the specified range. */
  3718. setSelection(index: number, length: number): void;
  3719. /** Reverses the most recent change. Repeated calls reverse preceding changes. */
  3720. undo(): void;
  3721. }
  3722. export interface dxHtmlEditorMediaResizing {
  3723. /** Specifies media types that can be resized. Currently, only images are supported. */
  3724. allowedTargets?: Array<string>;
  3725. /** Enables media resizing. */
  3726. enabled?: boolean;
  3727. }
  3728. export interface dxHtmlEditorMention {
  3729. /** Provides data for the suggestion list. */
  3730. dataSource?: Array<string> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions;
  3731. /** Specifies the data field whose values should be displayed in the suggestion list. */
  3732. displayExpr?: string | ((item: any) => string);
  3733. /** Specifies a custom template for suggestion list items. */
  3734. itemTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3735. /** Specifies the prefix that a user enters to activate mentions. You can use different prefixes with different dataSources. */
  3736. marker?: string;
  3737. /** Specifies the minimum number of characters that a user should type to trigger the search. */
  3738. minSearchLength?: number;
  3739. /** Specifies one or several data fields to search. */
  3740. searchExpr?: string | Function | Array<string | Function>;
  3741. /** Specifies the delay between when a user stops typing and when the search is executed. */
  3742. searchTimeout?: number;
  3743. /** Specifies a custom template for mentions. */
  3744. template?: template | ((mentionData: { marker?: string, id?: string | number, value?: any }, contentElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3745. /** Specifies which data field provides unique values to the template's `id` parameter. */
  3746. valueExpr?: string | Function;
  3747. }
  3748. export interface dxHtmlEditorToolbar {
  3749. /** Specifies the container in which to place the toolbar. */
  3750. container?: string | Element | JQuery;
  3751. /** Configures toolbar controls. These controls allow users to format text and execute commands. */
  3752. items?: Array<dxHtmlEditorToolbarItem | 'background' | 'bold' | 'color' | 'font' | 'italic' | 'link' | 'image' | 'size' | 'strike' | 'subscript' | 'superscript' | 'underline' | 'blockquote' | 'header' | 'increaseIndent' | 'decreaseIndent' | 'orderedList' | 'bulletList' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'codeBlock' | 'variable' | 'separator' | 'undo' | 'redo' | 'clear'>;
  3753. }
  3754. /** This section lists the data source fields that are used in a default template for toolbar items. */
  3755. export interface dxHtmlEditorToolbarItem extends dxToolbarItem {
  3756. /** Specifies the built-in control that this object customizes or a format with multiple choices. */
  3757. formatName?: 'background' | 'bold' | 'color' | 'font' | 'italic' | 'link' | 'image' | 'size' | 'strike' | 'subscript' | 'superscript' | 'underline' | 'blockquote' | 'header' | 'increaseIndent' | 'decreaseIndent' | 'orderedList' | 'bulletList' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'codeBlock' | 'variable' | 'separator' | 'undo' | 'redo' | 'clear' | string;
  3758. /** Specifies values for a format with multiple choices. Should be used with the formatName. */
  3759. formatValues?: Array<string | number | boolean>;
  3760. /** Specifies a location for the item on the toolbar. */
  3761. location?: 'after' | 'before' | 'center';
  3762. }
  3763. export interface dxHtmlEditorVariables {
  3764. /** Specifies a collection of variables available for a user. */
  3765. dataSource?: string | Array<string> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions;
  3766. /** Specifies the special character(s) that should surround the variables. */
  3767. escapeChar?: string | Array<string>;
  3768. }
  3769. /** Specifies markup for a widget item. */
  3770. export var dxItem: any;
  3771. export interface dxListOptions extends CollectionWidgetOptions<dxList>, SearchBoxMixinOptions<dxList> {
  3772. /** Specifies whether or not the widget changes its state when interacting with a user. */
  3773. activeStateEnabled?: boolean;
  3774. /** Specifies whether or not an end user can delete list items. */
  3775. allowItemDeleting?: boolean;
  3776. /** Specifies whether a user can reorder list items. Grouped items cannot be moved from one group to another. */
  3777. allowItemReordering?: boolean;
  3778. /** A Boolean value specifying whether to enable or disable the bounce-back effect. */
  3779. bounceEnabled?: boolean;
  3780. /** Specifies whether or not an end-user can collapse groups. */
  3781. collapsibleGroups?: boolean;
  3782. /** Specifies the data field whose values should be displayed. Defaults to "text" when the data source contains objects. */
  3783. displayExpr?: string | ((item: any) => any);
  3784. /** Specifies whether the widget can be focused using keyboard navigation. */
  3785. focusStateEnabled?: boolean;
  3786. /** Specifies a custom template for group captions. */
  3787. groupTemplate?: template | ((groupData: any, groupIndex: number, groupElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3788. /** Specifies whether data items should be grouped. */
  3789. grouped?: boolean;
  3790. /** Specifies whether the widget changes its state when a user pauses on it. */
  3791. hoverStateEnabled?: boolean;
  3792. /** Specifies whether or not to show the loading panel when the DataSource bound to the widget is loading data. */
  3793. indicateLoading?: boolean;
  3794. /** Specifies the way a user can delete items from the list. */
  3795. itemDeleteMode?: 'context' | 'slideButton' | 'slideItem' | 'static' | 'swipe' | 'toggle';
  3796. /** An array of items displayed by the widget. */
  3797. items?: Array<string | dxListItem | any>;
  3798. /** Specifies the array of items for a context menu called for a list item. */
  3799. menuItems?: Array<{ action?: ((itemElement: DevExpress.core.dxElement, itemData: any) => any), text?: string }>;
  3800. /** Specifies whether an item context menu is shown when a user holds or swipes an item. */
  3801. menuMode?: 'context' | 'slide';
  3802. /** The text displayed on the button used to load the next page from the data source. */
  3803. nextButtonText?: string;
  3804. /** A function that is executed when a group element is rendered. */
  3805. onGroupRendered?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, groupData?: any, groupElement?: DevExpress.core.dxElement, groupIndex?: number }) => any);
  3806. /** A function that is executed when a collection item is clicked or tapped. */
  3807. onItemClick?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number | any, jQueryEvent?: JQueryEventObject, event?: event }) => any) | string;
  3808. /** A function that is executed when a collection item is right-clicked or pressed. */
  3809. onItemContextMenu?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number | any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  3810. /** A function that is executed after a list item is deleted from the data source. */
  3811. onItemDeleted?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number | any }) => any);
  3812. /** A function that is executed before a collection item is deleted from the data source. */
  3813. onItemDeleting?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number | any, cancel?: boolean | Promise<void> | JQueryPromise<void> }) => any);
  3814. /** A function that is executed when a collection item has been held for a specified period. */
  3815. onItemHold?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number | any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  3816. /** A function that is executed after a list item is moved to another position. */
  3817. onItemReordered?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number | any, fromIndex?: number, toIndex?: number }) => any);
  3818. /** A function that is executed when a list item is swiped. */
  3819. onItemSwipe?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number | any, direction?: string }) => any);
  3820. /** A function that is executed before the next page is loaded. */
  3821. onPageLoading?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any }) => any);
  3822. /** A function that is executed when the "pull to refresh" gesture is performed. Supported in mobile themes only. */
  3823. onPullRefresh?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any }) => any);
  3824. /** A function that is executed on each scroll gesture. */
  3825. onScroll?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, scrollOffset?: any, reachedLeft?: boolean, reachedRight?: boolean, reachedTop?: boolean, reachedBottom?: boolean }) => any);
  3826. /** A function that is executed when the "Select All" check box value is changed. Applies only if the selectionMode is "all". */
  3827. onSelectAllValueChanged?: ((e: { component?: dxList, element?: DevExpress.core.dxElement, model?: any, value?: boolean }) => any);
  3828. /** Specifies whether the next page is loaded when a user scrolls the widget to the bottom or when the "next" button is clicked. */
  3829. pageLoadMode?: 'nextButton' | 'scrollBottom';
  3830. /** Specifies the text shown in the pullDown panel, which is displayed when the list is scrolled to the bottom. */
  3831. pageLoadingText?: string;
  3832. /** A Boolean value specifying whether or not the widget supports the "pull down to refresh" gesture. */
  3833. pullRefreshEnabled?: boolean;
  3834. /** Specifies the text displayed in the pullDown panel when the list is pulled below the refresh threshold. */
  3835. pulledDownText?: string;
  3836. /** Specifies the text shown in the pullDown panel while the list is being pulled down to the refresh threshold. */
  3837. pullingDownText?: string;
  3838. /** Specifies the text displayed in the pullDown panel while the list is being refreshed. */
  3839. refreshingText?: string;
  3840. /** Specifies whether to repaint only those elements whose data changed. */
  3841. repaintChangesOnly?: boolean;
  3842. /** A Boolean value specifying if the list is scrolled by content. */
  3843. scrollByContent?: boolean;
  3844. /** A Boolean value specifying if the list is scrolled using the scrollbar. */
  3845. scrollByThumb?: boolean;
  3846. /** A Boolean value specifying whether to enable or disable list scrolling. */
  3847. scrollingEnabled?: boolean;
  3848. /** Specifies the mode in which all items are selected. */
  3849. selectAllMode?: 'allPages' | 'page';
  3850. /** Specifies item selection mode. */
  3851. selectionMode?: 'all' | 'multiple' | 'none' | 'single';
  3852. /** Specifies when the widget shows the scrollbar. */
  3853. showScrollbar?: 'always' | 'never' | 'onHover' | 'onScroll';
  3854. /** Specifies whether or not to display controls used to select list items. */
  3855. showSelectionControls?: boolean;
  3856. /** Specifies whether or not the widget uses native scrolling. */
  3857. useNativeScrolling?: boolean;
  3858. }
  3859. /** The List is a widget that represents a collection of items in a scrollable list. */
  3860. export class dxList extends CollectionWidget {
  3861. constructor(element: Element, options?: dxListOptions)
  3862. constructor(element: JQuery, options?: dxListOptions)
  3863. /** Gets the widget's height in pixels. */
  3864. clientHeight(): number;
  3865. /** Collapses a group with a specific index. */
  3866. collapseGroup(groupIndex: number): Promise<void> & JQueryPromise<void>;
  3867. /** Removes an item found using its DOM node. */
  3868. deleteItem(itemElement: Element): Promise<void> & JQueryPromise<void>;
  3869. /** Removes an item with a specific index. */
  3870. deleteItem(itemIndex: number | any): Promise<void> & JQueryPromise<void>;
  3871. /** Expands a group with a specific index. */
  3872. expandGroup(groupIndex: number): Promise<void> & JQueryPromise<void>;
  3873. /** Checks whether an item found using its DOM node is selected. */
  3874. isItemSelected(itemElement: Element): boolean;
  3875. /** Checks whether an item with a specific index is selected. */
  3876. isItemSelected(itemIndex: number | any): boolean;
  3877. /** Reloads list data. */
  3878. reload(): void;
  3879. /** Reorders items found using their DOM nodes. */
  3880. reorderItem(itemElement: Element, toItemElement: Element): Promise<void> & JQueryPromise<void>;
  3881. /** Reorders items with specific indexes. */
  3882. reorderItem(itemIndex: number | any, toItemIndex: number | any): Promise<void> & JQueryPromise<void>;
  3883. /** Scrolls the content by a specified distance. */
  3884. scrollBy(distance: number): void;
  3885. /** Gets the content's height in pixels. */
  3886. scrollHeight(): number;
  3887. /** Scrolls the content to a specific position. */
  3888. scrollTo(location: number): void;
  3889. /** Scrolls the content to an item found using its DOM node. */
  3890. scrollToItem(itemElement: Element): void;
  3891. /** Scrolls the content to an item with a specific index. */
  3892. scrollToItem(itemIndex: number | any): void;
  3893. /** Gets the top scroll offset. */
  3894. scrollTop(): number;
  3895. /** Selects all items. */
  3896. selectAll(): void;
  3897. /** Selects an item found using its DOM node. */
  3898. selectItem(itemElement: Element): void;
  3899. /** Selects an item with a specific index. */
  3900. selectItem(itemIndex: number | any): void;
  3901. /** Cancels the selection of all items. */
  3902. unselectAll(): void;
  3903. /** Cancels the selection of an item found using its DOM node. */
  3904. unselectItem(itemElement: Element): void;
  3905. /** Cancels the selection of an item with a specific index. */
  3906. unselectItem(itemIndex: number | any): void;
  3907. /** Updates the widget scrollbar according to widget content size. */
  3908. updateDimensions(): Promise<void> & JQueryPromise<void>;
  3909. }
  3910. /** This section describes object fields that can be used in the default item template. */
  3911. export interface dxListItem extends CollectionWidgetItem {
  3912. /** Specifies the text of a badge displayed for the list item. */
  3913. badge?: string;
  3914. /** Specifies the list item's icon. */
  3915. icon?: string;
  3916. /** Specifies the name of the list items group in a grouped list. */
  3917. key?: string;
  3918. /** Specifies whether or not to display a chevron for the list item. */
  3919. showChevron?: boolean;
  3920. }
  3921. export interface dxLoadIndicatorOptions extends WidgetOptions<dxLoadIndicator> {
  3922. /** Specifies the path to an image used as the indicator. */
  3923. indicatorSrc?: string;
  3924. }
  3925. /** The LoadIndicator is a UI element notifying the viewer that a process is in progress. */
  3926. export class dxLoadIndicator extends Widget {
  3927. constructor(element: Element, options?: dxLoadIndicatorOptions)
  3928. constructor(element: JQuery, options?: dxLoadIndicatorOptions)
  3929. }
  3930. export interface dxLoadPanelOptions extends dxOverlayOptions<dxLoadPanel> {
  3931. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  3932. animation?: dxLoadPanelAnimation;
  3933. /** Specifies the widget's container. */
  3934. container?: string | Element | JQuery;
  3935. /** The delay in milliseconds after which the load panel is displayed. */
  3936. delay?: number;
  3937. /** Specifies whether or not the widget can be focused. */
  3938. focusStateEnabled?: boolean;
  3939. /** Specifies the widget's height in pixels. */
  3940. height?: number | string | (() => number | string);
  3941. /** A URL pointing to an image to be used as a load indicator. */
  3942. indicatorSrc?: string;
  3943. /** Specifies the maximum height the widget can reach while resizing. */
  3944. maxHeight?: number | string | (() => number | string);
  3945. /** Specifies the maximum width the widget can reach while resizing. */
  3946. maxWidth?: number | string | (() => number | string);
  3947. /** Specifies the text displayed in the load panel. Ignored in the Material Design theme. */
  3948. message?: string;
  3949. /** Positions the widget. */
  3950. position?: 'bottom' | 'center' | 'left' | 'left bottom' | 'left top' | 'right' | 'right bottom' | 'right top' | 'top' | positionConfig | Function;
  3951. /** Specifies the shading color. */
  3952. shadingColor?: string;
  3953. /** A Boolean value specifying whether or not to show a load indicator. */
  3954. showIndicator?: boolean;
  3955. /** A Boolean value specifying whether or not to show the pane behind the load indicator. */
  3956. showPane?: boolean;
  3957. /** Specifies the widget's width in pixels. */
  3958. width?: number | string | (() => number | string);
  3959. }
  3960. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  3961. export interface dxLoadPanelAnimation extends dxOverlayAnimation {
  3962. /** An object that defines the animation options used when the widget is being hidden. */
  3963. hide?: animationConfig;
  3964. /** An object that defines the animation options used when the widget is being shown. */
  3965. show?: animationConfig;
  3966. }
  3967. /** The LoadPanel is an overlay widget notifying the viewer that loading is in progress. */
  3968. export class dxLoadPanel extends dxOverlay {
  3969. constructor(element: Element, options?: dxLoadPanelOptions)
  3970. constructor(element: JQuery, options?: dxLoadPanelOptions)
  3971. }
  3972. export interface dxLookupOptions extends dxDropDownListOptions<dxLookup> {
  3973. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  3974. animation?: { hide?: animationConfig, show?: animationConfig };
  3975. /** The text displayed on the Apply button. */
  3976. applyButtonText?: string;
  3977. /** Specifies the way an end-user applies the selected value. */
  3978. applyValueMode?: 'instantly' | 'useButtons';
  3979. /** The text displayed on the Cancel button. */
  3980. cancelButtonText?: string;
  3981. /** Specifies whether or not the widget cleans the search box when the popup window is displayed. */
  3982. cleanSearchOnOpening?: boolean;
  3983. /** The text displayed on the Clear button. */
  3984. clearButtonText?: string;
  3985. /** Specifies whether to close the drop-down menu if a user clicks outside it. */
  3986. closeOnOutsideClick?: boolean | (() => boolean);
  3987. /** Specifies a custom template for the input field. */
  3988. fieldTemplate?: template | ((selectedItem: any, fieldElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3989. /** Specifies whether the widget can be focused using keyboard navigation. */
  3990. focusStateEnabled?: boolean;
  3991. /** A Boolean value specifying whether or not to display the lookup in full-screen mode. */
  3992. fullScreen?: boolean;
  3993. /** Specifies a custom template for group captions. */
  3994. groupTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  3995. /** A Boolean value specifying whether or not to group widget items. */
  3996. grouped?: boolean;
  3997. /** The text displayed on the button used to load the next page from the data source. */
  3998. nextButtonText?: string;
  3999. /** A function that is executed before the next page is loaded. */
  4000. onPageLoading?: ((e: { component?: dxLookup, element?: DevExpress.core.dxElement, model?: any }) => any);
  4001. /** A function that is executed when the "pull to refresh" gesture is performed on the drop-down item list. Supported in mobile themes only. */
  4002. onPullRefresh?: ((e: { component?: dxLookup, element?: DevExpress.core.dxElement, model?: any }) => any);
  4003. /** A function that is executed on each scroll gesture performed on the drop-down item list. */
  4004. onScroll?: ((e: { component?: dxLookup, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, scrollOffset?: any, reachedLeft?: boolean, reachedRight?: boolean, reachedTop?: boolean, reachedBottom?: boolean }) => any);
  4005. /** A function that is executed when the drop-down list's title is rendered. */
  4006. onTitleRendered?: ((e: { component?: dxLookup, element?: DevExpress.core.dxElement, model?: any, titleElement?: DevExpress.core.dxElement }) => any);
  4007. /** A function that is executed after the widget's value is changed. */
  4008. onValueChanged?: ((e: { component?: dxLookup, element?: DevExpress.core.dxElement, model?: any, value?: any, previousValue?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  4009. /** Specifies whether the next page is loaded when a user scrolls the widget to the bottom or when the "next" button is clicked. */
  4010. pageLoadMode?: 'nextButton' | 'scrollBottom';
  4011. /** Specifies the text shown in the pullDown panel, which is displayed when the widget is scrolled to the bottom. */
  4012. pageLoadingText?: string;
  4013. /** The text displayed by the widget when nothing is selected. */
  4014. placeholder?: string;
  4015. /** Specifies the popup element's height. Applies only if fullScreen is false. */
  4016. popupHeight?: number | string | (() => number | string);
  4017. /** Specifies the popup element's width. Applies only if fullScreen is false. */
  4018. popupWidth?: number | string | (() => number | string);
  4019. /** An object defining widget positioning options. */
  4020. position?: positionConfig;
  4021. /** A Boolean value specifying whether or not the widget supports the "pull down to refresh" gesture. */
  4022. pullRefreshEnabled?: boolean;
  4023. /** Specifies the text displayed in the pullDown panel when the widget is pulled below the refresh threshold. */
  4024. pulledDownText?: string;
  4025. /** Specifies the text shown in the pullDown panel while the list is being pulled down to the refresh threshold. */
  4026. pullingDownText?: string;
  4027. /** Specifies the text displayed in the pullDown panel while the widget is being refreshed. */
  4028. refreshingText?: string;
  4029. /** Specifies whether the search box is visible. */
  4030. searchEnabled?: boolean;
  4031. /** The text that is provided as a hint in the lookup's search bar. */
  4032. searchPlaceholder?: string;
  4033. /** Specifies whether to shade the container when the lookup is active. Applies only if usePopover is false. */
  4034. shading?: boolean;
  4035. /** Specifies whether to display the Cancel button in the lookup window. */
  4036. showCancelButton?: boolean;
  4037. /** Specifies whether or not to display the Clear button in the lookup window. */
  4038. showClearButton?: boolean;
  4039. /** A Boolean value specifying whether or not to display the title in the popup window. */
  4040. showPopupTitle?: boolean;
  4041. /** The title of the lookup window. */
  4042. title?: string;
  4043. /** Specifies a custom template for the title. */
  4044. titleTemplate?: template | ((titleElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4045. /** Specifies whether or not the widget uses native scrolling. */
  4046. useNativeScrolling?: boolean;
  4047. /** Specifies whether or not to show lookup contents in a Popover widget. */
  4048. usePopover?: boolean;
  4049. }
  4050. /** The Lookup is a widget that allows an end user to search for an item in a collection shown in a drop-down menu. */
  4051. export class dxLookup extends dxDropDownList {
  4052. constructor(element: Element, options?: dxLookupOptions)
  4053. constructor(element: JQuery, options?: dxLookupOptions)
  4054. }
  4055. export interface dxMapOptions extends WidgetOptions<dxMap> {
  4056. /** Specifies whether the widget automatically adjusts center and zoom option values when adding a new marker or route, or if a new widget contains markers or routes by default. */
  4057. autoAdjust?: boolean;
  4058. /** An object, a string, or an array specifying which part of the map is displayed at the widget's center using coordinates. The widget can change this value if autoAdjust is enabled. */
  4059. center?: any | string | Array<number>;
  4060. /** Specifies whether or not map widget controls are available. */
  4061. controls?: boolean;
  4062. /** Specifies whether the widget can be focused using keyboard navigation. */
  4063. focusStateEnabled?: boolean;
  4064. /** Specifies the widget's height. */
  4065. height?: number | string | (() => number | string);
  4066. /** A key used to authenticate the application within the required map provider. */
  4067. key?: string | { bing?: string, google?: string, googleStatic?: string };
  4068. /** A URL pointing to the custom icon to be used for map markers. */
  4069. markerIconSrc?: string;
  4070. /** An array of markers displayed on a map. */
  4071. markers?: Array<{ iconSrc?: string, location?: any | string | Array<number>, onClick?: Function, tooltip?: string | { isShown?: boolean, text?: string } }>;
  4072. /** A function that is executed when any location on the map is clicked or tapped. */
  4073. onClick?: ((e: { component?: dxMap, element?: DevExpress.core.dxElement, model?: any, location?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any) | string;
  4074. /** A function that is executed when a marker is created on the map. */
  4075. onMarkerAdded?: ((e: { component?: dxMap, element?: DevExpress.core.dxElement, model?: any, options?: any, originalMarker?: any }) => any);
  4076. /** A function that is executed when a marker is removed from the map. */
  4077. onMarkerRemoved?: ((e: { component?: dxMap, element?: DevExpress.core.dxElement, model?: any, options?: any }) => any);
  4078. /** A function that is executed when the map is ready. */
  4079. onReady?: ((e: { component?: dxMap, element?: DevExpress.core.dxElement, model?: any, originalMap?: any }) => any);
  4080. /** A function that is executed when a route is created on the map. */
  4081. onRouteAdded?: ((e: { component?: dxMap, element?: DevExpress.core.dxElement, model?: any, options?: any, originalRoute?: any }) => any);
  4082. /** A function that is executed when a route is removed from the map. */
  4083. onRouteRemoved?: ((e: { component?: dxMap, element?: DevExpress.core.dxElement, model?: any, options?: any }) => any);
  4084. /** The name of the current map data provider. */
  4085. provider?: 'bing' | 'google' | 'googleStatic';
  4086. /** An array of routes shown on the map. */
  4087. routes?: Array<{ color?: string, locations?: Array<any>, mode?: 'driving' | 'walking', opacity?: number, weight?: number }>;
  4088. /** The type of a map to display. */
  4089. type?: 'hybrid' | 'roadmap' | 'satellite';
  4090. /** Specifies the widget's width. */
  4091. width?: number | string | (() => number | string);
  4092. /** The map's zoom level. The widget can change this value if autoAdjust is enabled. */
  4093. zoom?: number;
  4094. }
  4095. /** The Map is an interactive widget that displays a geographic map with markers and routes. */
  4096. export class dxMap extends Widget {
  4097. constructor(element: Element, options?: dxMapOptions)
  4098. constructor(element: JQuery, options?: dxMapOptions)
  4099. /** Adds a marker to the map. */
  4100. addMarker(markerOptions: any | Array<any>): Promise<any> & JQueryPromise<any>;
  4101. /** Adds a route to the map. */
  4102. addRoute(options: any | Array<any>): Promise<any> & JQueryPromise<any>;
  4103. /** Removes a marker from the map. */
  4104. removeMarker(marker: any | number | Array<any>): Promise<void> & JQueryPromise<void>;
  4105. /** Removes a route from the map. */
  4106. removeRoute(route: any | number | Array<any>): Promise<void> & JQueryPromise<void>;
  4107. }
  4108. export interface dxMenuOptions extends dxMenuBaseOptions<dxMenu> {
  4109. /** Specifies whether adaptive widget rendering is enabled on small screens. Applies only if the orientation is "horizontal". */
  4110. adaptivityEnabled?: boolean;
  4111. /** Specifies whether or not the submenu is hidden when the mouse pointer leaves it. */
  4112. hideSubmenuOnMouseLeave?: boolean;
  4113. /** Holds an array of menu items. */
  4114. items?: Array<dxMenuItem>;
  4115. /** A function that is executed after a submenu is hidden. */
  4116. onSubmenuHidden?: ((e: { component?: dxMenu, element?: DevExpress.core.dxElement, model?: any, rootItem?: DevExpress.core.dxElement }) => any);
  4117. /** A function that is executed before a submenu is hidden. */
  4118. onSubmenuHiding?: ((e: { component?: dxMenu, element?: DevExpress.core.dxElement, model?: any, rootItem?: DevExpress.core.dxElement, cancel?: boolean }) => any);
  4119. /** A function that is executed before a submenu is displayed. */
  4120. onSubmenuShowing?: ((e: { component?: dxMenu, element?: DevExpress.core.dxElement, model?: any, rootItem?: DevExpress.core.dxElement }) => any);
  4121. /** A function that is executed after a submenu is displayed. */
  4122. onSubmenuShown?: ((e: { component?: dxMenu, element?: DevExpress.core.dxElement, model?: any, rootItem?: DevExpress.core.dxElement }) => any);
  4123. /** Specifies whether the menu has horizontal or vertical orientation. */
  4124. orientation?: 'horizontal' | 'vertical';
  4125. /** Specifies options for showing and hiding the first level submenu. */
  4126. showFirstSubmenuMode?: { delay?: { hide?: number, show?: number } | number, name?: 'onClick' | 'onHover' } | 'onClick' | 'onHover';
  4127. /** Specifies the direction at which the submenus are displayed. */
  4128. submenuDirection?: 'auto' | 'leftOrTop' | 'rightOrBottom';
  4129. }
  4130. /** The Menu widget is a panel with clickable items. A click on an item opens a drop-down menu, which can contain several submenus. */
  4131. export class dxMenu extends dxMenuBase {
  4132. constructor(element: Element, options?: dxMenuOptions)
  4133. constructor(element: JQuery, options?: dxMenuOptions)
  4134. }
  4135. export interface dxMenuBaseOptions<T = dxMenuBase> extends HierarchicalCollectionWidgetOptions<T> {
  4136. /** A Boolean value specifying whether or not the widget changes its state when interacting with a user. */
  4137. activeStateEnabled?: boolean;
  4138. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  4139. animation?: { hide?: animationConfig, show?: animationConfig };
  4140. /** Specifies the name of the CSS class to be applied to the root menu level and all submenus. */
  4141. cssClass?: string;
  4142. /** Holds an array of menu items. */
  4143. items?: Array<dxMenuBaseItem>;
  4144. /** Specifies whether or not an item becomes selected if a user clicks it. */
  4145. selectByClick?: boolean;
  4146. /** Specifies the selection mode supported by the menu. */
  4147. selectionMode?: 'none' | 'single';
  4148. /** Specifies options of submenu showing and hiding. */
  4149. showSubmenuMode?: { delay?: { hide?: number, show?: number } | number, name?: 'onClick' | 'onHover' } | 'onClick' | 'onHover';
  4150. }
  4151. export class dxMenuBase extends HierarchicalCollectionWidget {
  4152. constructor(element: Element, options?: dxMenuBaseOptions)
  4153. constructor(element: JQuery, options?: dxMenuBaseOptions)
  4154. /** Selects an item found using its DOM node. */
  4155. selectItem(itemElement: Element): void;
  4156. /** Cancels the selection of an item found using its DOM node. */
  4157. unselectItem(itemElement: Element): void;
  4158. }
  4159. /** This section lists the data source fields that are used in a default item template. */
  4160. export interface dxMenuBaseItem extends CollectionWidgetItem {
  4161. /** Specifies whether a group separator is displayed over the item. */
  4162. beginGroup?: boolean;
  4163. /** Specifies if a menu is closed when a user clicks the item. */
  4164. closeMenuOnClick?: boolean;
  4165. /** Specifies whether or not the menu item is disabled. */
  4166. disabled?: boolean;
  4167. /** Specifies the menu item's icon. */
  4168. icon?: string;
  4169. /** Holds an array of menu items. */
  4170. items?: Array<dxMenuBaseItem>;
  4171. /** Specifies whether or not a user can select a menu item. */
  4172. selectable?: boolean;
  4173. /** Specifies whether or not the item is selected. */
  4174. selected?: boolean;
  4175. /** Specifies the text inserted into the item element. */
  4176. text?: string;
  4177. /** Specifies whether or not the menu item is visible. */
  4178. visible?: boolean;
  4179. }
  4180. /** This section lists the data source fields that are used in a default item template. */
  4181. export interface dxMenuItem extends dxMenuBaseItem {
  4182. /** Holds an array of menu items. */
  4183. items?: Array<dxMenuItem>;
  4184. }
  4185. export interface dxMultiViewOptions<T = dxMultiView> extends CollectionWidgetOptions<T> {
  4186. /** Specifies whether or not to animate the displayed item change. */
  4187. animationEnabled?: boolean;
  4188. /** Specifies whether to render the view's content when it is displayed. If false, the content is rendered immediately. */
  4189. deferRendering?: boolean;
  4190. /** Specifies whether the widget can be focused using keyboard navigation. */
  4191. focusStateEnabled?: boolean;
  4192. /** An array of items displayed by the widget. */
  4193. items?: Array<string | dxMultiViewItem | any>;
  4194. /** A Boolean value specifying whether or not to scroll back to the first item after the last item is swiped. */
  4195. loop?: boolean;
  4196. /** The index of the currently displayed item. */
  4197. selectedIndex?: number;
  4198. /** A Boolean value specifying whether or not to allow users to change the selected index by swiping. */
  4199. swipeEnabled?: boolean;
  4200. }
  4201. /** The MultiView is a widget that contains several views. An end user navigates through the views by swiping them in the horizontal direction. */
  4202. export class dxMultiView extends CollectionWidget {
  4203. constructor(element: Element, options?: dxMultiViewOptions)
  4204. constructor(element: JQuery, options?: dxMultiViewOptions)
  4205. }
  4206. /** This section lists the data source fields that are used in a default template for multi-view items. */
  4207. export interface dxMultiViewItem extends CollectionWidgetItem {
  4208. }
  4209. export interface dxNavBarOptions extends dxTabsOptions<dxNavBar> {
  4210. /** Specifies whether or not an end-user can scroll tabs by swiping. */
  4211. scrollByContent?: boolean;
  4212. }
  4213. /** The NavBar is a widget that navigates the application views. */
  4214. export class dxNavBar extends dxTabs {
  4215. constructor(element: Element, options?: dxNavBarOptions)
  4216. constructor(element: JQuery, options?: dxNavBarOptions)
  4217. }
  4218. /** This section lists the data source fields that are used in a default template for navbar items. */
  4219. export interface dxNavBarItem extends dxTabsItem {
  4220. /** Specifies a badge text for the navbar item. */
  4221. badge?: string;
  4222. }
  4223. export interface dxNumberBoxOptions extends dxTextEditorOptions<dxNumberBox> {
  4224. /** Allows you to add custom buttons to the input text field. */
  4225. buttons?: Array<'clear' | 'spins' | dxTextEditorButton>;
  4226. /** Specifies the value's display format and controls user input accordingly. */
  4227. format?: format;
  4228. /** Specifies the text of the message displayed if the specified value is not a number. */
  4229. invalidValueMessage?: string;
  4230. /** The maximum value accepted by the number box. */
  4231. max?: number;
  4232. /** The minimum value accepted by the number box. */
  4233. min?: number;
  4234. /** Specifies the value to be passed to the type attribute of the underlying `` element. */
  4235. mode?: 'number' | 'text' | 'tel';
  4236. /** Specifies whether to show the buttons that change the value by a step. */
  4237. showSpinButtons?: boolean;
  4238. /** Specifies how much the widget's value changes when using the spin buttons, Up/Down arrow keys, or mouse wheel. */
  4239. step?: number;
  4240. /** Specifies whether to use touch friendly spin buttons. Applies only if showSpinButtons is true. */
  4241. useLargeSpinButtons?: boolean;
  4242. /** The current number box value. */
  4243. value?: number;
  4244. }
  4245. /** The NumberBox is a widget that displays a numeric value and allows a user to modify it by typing in a value, and incrementing or decrementing it using the keyboard or mouse. */
  4246. export class dxNumberBox extends dxTextEditor {
  4247. constructor(element: Element, options?: dxNumberBoxOptions)
  4248. constructor(element: JQuery, options?: dxNumberBoxOptions)
  4249. }
  4250. export interface dxOverlayOptions<T = dxOverlay> extends WidgetOptions<T> {
  4251. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  4252. animation?: dxOverlayAnimation;
  4253. /** Specifies whether to close the widget if a user clicks outside it. */
  4254. closeOnOutsideClick?: boolean | ((event: event) => boolean);
  4255. /** Specifies a custom template for the widget content. */
  4256. contentTemplate?: template | ((contentElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4257. /** Specifies whether to render the widget's content when it is displayed. If false, the content is rendered immediately. */
  4258. deferRendering?: boolean;
  4259. /** Specifies whether or not an end-user can drag the widget. */
  4260. dragEnabled?: boolean;
  4261. /** Specifies the widget's height in pixels. */
  4262. height?: number | string | (() => number | string);
  4263. /** Specifies the maximum height the widget can reach while resizing. */
  4264. maxHeight?: number | string | (() => number | string);
  4265. /** Specifies the maximum width the widget can reach while resizing. */
  4266. maxWidth?: number | string | (() => number | string);
  4267. /** Specifies the minimum height the widget can reach while resizing. */
  4268. minHeight?: number | string | (() => number | string);
  4269. /** Specifies the minimum width the widget can reach while resizing. */
  4270. minWidth?: number | string | (() => number | string);
  4271. /** A function that is executed after the widget is hidden. */
  4272. onHidden?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  4273. /** A function that is executed before the widget is hidden. */
  4274. onHiding?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, cancel?: boolean }) => any);
  4275. /** A function that is executed before the widget is displayed. */
  4276. onShowing?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  4277. /** A function that is executed after the widget is displayed. */
  4278. onShown?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  4279. /** Positions the widget. */
  4280. position?: any;
  4281. /** Specifies whether to shade the background when the widget is active. */
  4282. shading?: boolean;
  4283. /** Specifies the shading color. */
  4284. shadingColor?: string;
  4285. /** A Boolean value specifying whether or not the widget is visible. */
  4286. visible?: boolean;
  4287. /** Specifies the widget's width in pixels. */
  4288. width?: number | string | (() => number | string);
  4289. }
  4290. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  4291. export interface dxOverlayAnimation {
  4292. /** An object that defines the animation options used when the widget is being hidden. */
  4293. hide?: animationConfig;
  4294. /** An object that defines the animation options used when the widget is being shown. */
  4295. show?: animationConfig;
  4296. }
  4297. /** The Overlay widget represents a window overlaying the current view. It displays data located within the HTML element representing the widget. */
  4298. export class dxOverlay extends Widget {
  4299. constructor(element: Element, options?: dxOverlayOptions)
  4300. constructor(element: JQuery, options?: dxOverlayOptions)
  4301. /** Gets the widget's content. */
  4302. content(): DevExpress.core.dxElement;
  4303. /** Hides the widget. */
  4304. hide(): Promise<void> & JQueryPromise<void>;
  4305. /** Recalculates the widget's size and position without rerendering. */
  4306. repaint(): void;
  4307. /** Shows the widget. */
  4308. show(): Promise<void> & JQueryPromise<void>;
  4309. /** Shows or hides the widget depending on the argument. */
  4310. toggle(showing: boolean): Promise<void> & JQueryPromise<void>;
  4311. }
  4312. export interface dxPivotGridOptions extends WidgetOptions<dxPivotGrid> {
  4313. /** Allows an end-user to expand/collapse all header items within a header level. */
  4314. allowExpandAll?: boolean;
  4315. /** Allows a user to filter fields by selecting or deselecting values in the popup menu. */
  4316. allowFiltering?: boolean;
  4317. /** Allows an end-user to change sorting options. */
  4318. allowSorting?: boolean;
  4319. /** Allows an end-user to sort columns by summary values. */
  4320. allowSortingBySummary?: boolean;
  4321. /** Specifies the area to which data field headers must belong. */
  4322. dataFieldArea?: 'column' | 'row';
  4323. /** Binds the widget to data. */
  4324. dataSource?: Array<any> | DevExpress.data.PivotGridDataSource | DevExpress.data.PivotGridDataSourceOptions;
  4325. /** Configures client-side exporting. */
  4326. export?: { enabled?: boolean, fileName?: string, ignoreExcelErrors?: boolean, proxyUrl?: string };
  4327. /** The Field Chooser configuration options. */
  4328. fieldChooser?: { allowSearch?: boolean, applyChangesMode?: 'instantly' | 'onDemand', enabled?: boolean, height?: number, layout?: 0 | 1 | 2, searchTimeout?: number, texts?: { allFields?: string, columnFields?: string, dataFields?: string, filterFields?: string, rowFields?: string }, title?: string, width?: number };
  4329. /** Configures the field panel. */
  4330. fieldPanel?: { allowFieldDragging?: boolean, showColumnFields?: boolean, showDataFields?: boolean, showFilterFields?: boolean, showRowFields?: boolean, texts?: { columnFieldArea?: string, dataFieldArea?: string, filterFieldArea?: string, rowFieldArea?: string }, visible?: boolean };
  4331. /** Configures the header filter feature. */
  4332. headerFilter?: { allowSearch?: boolean, height?: number, searchTimeout?: number, showRelevantValues?: boolean, texts?: { cancel?: string, emptyValue?: string, ok?: string }, width?: number };
  4333. /** Specifies whether or not to hide rows and columns with no data. */
  4334. hideEmptySummaryCells?: boolean;
  4335. /** Specifies options configuring the load panel. */
  4336. loadPanel?: { enabled?: boolean, height?: number, indicatorSrc?: string, showIndicator?: boolean, showPane?: boolean, text?: string, width?: number };
  4337. /** A function that is executed when a pivot grid cell is clicked or tapped. */
  4338. onCellClick?: ((e: { component?: dxPivotGrid, element?: DevExpress.core.dxElement, model?: any, area?: string, cellElement?: DevExpress.core.dxElement, cell?: dxPivotGridPivotGridCell, rowIndex?: number, columnIndex?: number, columnFields?: Array<DevExpress.data.PivotGridDataSourceField>, rowFields?: Array<DevExpress.data.PivotGridDataSourceField>, dataFields?: Array<DevExpress.data.PivotGridDataSourceField>, jQueryEvent?: JQueryEventObject, event?: event, cancel?: boolean }) => any);
  4339. /** A function that is executed after a pivot grid cell is created. */
  4340. onCellPrepared?: ((e: { component?: dxPivotGrid, element?: DevExpress.core.dxElement, model?: any, area?: string, cellElement?: DevExpress.core.dxElement, cell?: dxPivotGridPivotGridCell, rowIndex?: number, columnIndex?: number }) => any);
  4341. /** A function that is executed before the context menu is rendered. */
  4342. onContextMenuPreparing?: ((e: { component?: dxPivotGrid, element?: DevExpress.core.dxElement, model?: any, items?: Array<any>, area?: string, cell?: dxPivotGridPivotGridCell, cellElement?: DevExpress.core.dxElement, columnIndex?: number, rowIndex?: number, dataFields?: Array<DevExpress.data.PivotGridDataSourceField>, rowFields?: Array<DevExpress.data.PivotGridDataSourceField>, columnFields?: Array<DevExpress.data.PivotGridDataSourceField>, field?: DevExpress.data.PivotGridDataSourceField }) => any);
  4343. /** A function that is executed after data is exported. */
  4344. onExported?: ((e: { component?: dxPivotGrid, element?: DevExpress.core.dxElement, model?: any }) => any);
  4345. /** A function that is executed before data is exported. */
  4346. onExporting?: ((e: { component?: dxPivotGrid, element?: DevExpress.core.dxElement, model?: any, fileName?: string, cancel?: boolean }) => any);
  4347. /** A function that is executed before a file with exported data is saved to the user's local storage. */
  4348. onFileSaving?: ((e: { component?: dxPivotGrid, element?: DevExpress.core.dxElement, fileName?: string, format?: string, data?: Blob, cancel?: boolean }) => any);
  4349. /** Specifies the layout of items in the row header. */
  4350. rowHeaderLayout?: 'standard' | 'tree';
  4351. /** A configuration object specifying scrolling options. */
  4352. scrolling?: { mode?: 'standard' | 'virtual', useNative?: boolean | 'auto' };
  4353. /** Specifies whether the outer borders of the grid are visible or not. */
  4354. showBorders?: boolean;
  4355. /** Specifies whether to display the Grand Total column. */
  4356. showColumnGrandTotals?: boolean;
  4357. /** Specifies whether to display the Total columns. */
  4358. showColumnTotals?: boolean;
  4359. /** Specifies whether to display the Grand Total row. */
  4360. showRowGrandTotals?: boolean;
  4361. /** Specifies whether to display the Total rows. Applies only if rowHeaderLayout is "standard". */
  4362. showRowTotals?: boolean;
  4363. /** Specifies where to show the total rows or columns. Applies only if rowHeaderLayout is "standard". */
  4364. showTotalsPrior?: 'both' | 'columns' | 'none' | 'rows';
  4365. /** A configuration object specifying options related to state storing. */
  4366. stateStoring?: { customLoad?: (() => Promise<any> | JQueryPromise<any>), customSave?: ((state: any) => any), enabled?: boolean, savingTimeout?: number, storageKey?: string, type?: 'custom' | 'localStorage' | 'sessionStorage' };
  4367. /** Strings that can be changed or localized in the PivotGrid widget. */
  4368. texts?: { collapseAll?: string, dataNotAvailable?: string, expandAll?: string, exportToExcel?: string, grandTotal?: string, noData?: string, removeAllSorting?: string, showFieldChooser?: string, sortColumnBySummary?: string, sortRowBySummary?: string, total?: string };
  4369. /** Specifies whether long text in header items should be wrapped. */
  4370. wordWrapEnabled?: boolean;
  4371. }
  4372. /** The PivotGrid is a widget that allows you to display and analyze multi-dimensional data from a local storage or an OLAP cube. */
  4373. export class dxPivotGrid extends Widget {
  4374. constructor(element: Element, options?: dxPivotGridOptions)
  4375. constructor(element: JQuery, options?: dxPivotGridOptions)
  4376. /** Binds a Chart to the PivotGrid. */
  4377. bindChart(chart: string | JQuery | any, integrationOptions: { inverted?: boolean, dataFieldsDisplayMode?: string, putDataFieldsInto?: string, alternateDataFields?: boolean, processCell?: Function, customizeChart?: Function, customizeSeries?: Function }): Function & null;
  4378. /** Exports pivot grid data to the Excel file. */
  4379. exportToExcel(): void;
  4380. /** Gets the PivotGridDataSource instance. */
  4381. getDataSource(): DevExpress.data.PivotGridDataSource;
  4382. /** Gets the Popup instance of the field chooser window. */
  4383. getFieldChooserPopup(): dxPopup;
  4384. /** Updates the widget to the size of its content. */
  4385. updateDimensions(): void;
  4386. }
  4387. export interface dxPivotGridFieldChooserOptions extends WidgetOptions<dxPivotGridFieldChooser> {
  4388. /** Specifies whether the field chooser allows searching in the "All Fields" section. */
  4389. allowSearch?: boolean;
  4390. /** Specifies when to apply changes made in the widget to the PivotGrid. */
  4391. applyChangesMode?: 'instantly' | 'onDemand';
  4392. /** The data source of a PivotGrid widget. */
  4393. dataSource?: DevExpress.data.PivotGridDataSource;
  4394. /** Configures the header filter feature. */
  4395. headerFilter?: { allowSearch?: boolean, height?: number, searchTimeout?: number, showRelevantValues?: boolean, texts?: { cancel?: string, emptyValue?: string, ok?: string }, width?: number };
  4396. /** Specifies the widget's height. */
  4397. height?: number | string | (() => number | string);
  4398. /** Specifies the field chooser layout. */
  4399. layout?: 0 | 1 | 2;
  4400. /** A function that is executed before the context menu is rendered. */
  4401. onContextMenuPreparing?: ((e: { component?: dxPivotGridFieldChooser, element?: DevExpress.core.dxElement, model?: any, items?: Array<any>, area?: string, field?: DevExpress.data.PivotGridDataSourceField, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  4402. /** Specifies a delay in milliseconds between when a user finishes typing in the field chooser's search panel, and when the search is executed. */
  4403. searchTimeout?: number;
  4404. /** The widget's state. */
  4405. state?: any;
  4406. /** Strings that can be changed or localized in the PivotGridFieldChooser widget. */
  4407. texts?: { allFields?: string, columnFields?: string, dataFields?: string, filterFields?: string, rowFields?: string };
  4408. }
  4409. /** A complementary widget for the PivotGrid that allows you to manage data displayed in the PivotGrid. The field chooser is already integrated in the PivotGrid and can be invoked using the context menu. If you need to continuously display the field chooser near the PivotGrid widget, use the PivotGridFieldChooser widget. */
  4410. export class dxPivotGridFieldChooser extends Widget {
  4411. constructor(element: Element, options?: dxPivotGridFieldChooserOptions)
  4412. constructor(element: JQuery, options?: dxPivotGridFieldChooserOptions)
  4413. /** Applies changes made in the widget to the PivotGrid. Takes effect only if applyChangesMode is "onDemand". */
  4414. applyChanges(): void;
  4415. /** Cancels changes made in the widget without applying them to the PivotGrid. Takes effect only if applyChangesMode is "onDemand". */
  4416. cancelChanges(): void;
  4417. /** Gets the PivotGridDataSource instance. */
  4418. getDataSource(): DevExpress.data.PivotGridDataSource;
  4419. /** Updates the widget to the size of its content. */
  4420. updateDimensions(): void;
  4421. }
  4422. /** An object containing information about the pivot grid cell. */
  4423. export interface dxPivotGridPivotGridCell {
  4424. /** The cell's column path. Available for data area cells only. */
  4425. columnPath?: Array<string | number | Date>;
  4426. /** The type of the column to which the cell belongs. Available for data area cells only. */
  4427. columnType?: 'D' | 'T' | 'GT';
  4428. /** The data field's index. Available for data area cells only. */
  4429. dataIndex?: number;
  4430. /** Indicates whether the cell is expanded. Available for row or column area cells only. */
  4431. expanded?: boolean;
  4432. /** The path to the row/column cell. Available for row or column area cells only. */
  4433. path?: Array<string | number | Date>;
  4434. /** The cell's row path. Available for data area cells only. */
  4435. rowPath?: Array<string | number | Date>;
  4436. /** The type of the row to which the cell belongs. Available for data area cells only. */
  4437. rowType?: 'D' | 'T' | 'GT';
  4438. /** The text displayed in the cell. */
  4439. text?: string;
  4440. /** The cell's type. Available for row or column area cells only. */
  4441. type?: 'D' | 'T' | 'GT';
  4442. /** The cell's value. */
  4443. value?: any;
  4444. }
  4445. /** An object exposing methods that manipulate a summary cell and provide access to its neighboring cells. */
  4446. export class dxPivotGridSummaryCell {
  4447. /** Gets the child cell in a specified direction. */
  4448. child(direction: string, fieldValue: number | string): dxPivotGridSummaryCell;
  4449. /** Gets all child cells in a specified direction. */
  4450. children(direction: string): Array<dxPivotGridSummaryCell>;
  4451. /** Gets a pivot grid field that corresponds to the summary cell. */
  4452. field(area: string): DevExpress.data.PivotGridDataSourceField;
  4453. /** Gets the Grand Total of the entire pivot grid. */
  4454. grandTotal(): dxPivotGridSummaryCell;
  4455. /** Gets a partial Grand Total cell of a row or column. */
  4456. grandTotal(direction: string): dxPivotGridSummaryCell;
  4457. /** Gets the cell next to the current one in a specified direction. */
  4458. next(direction: string): dxPivotGridSummaryCell;
  4459. /** Gets the cell next to current in a specified direction. */
  4460. next(direction: string, allowCrossGroup: boolean): dxPivotGridSummaryCell;
  4461. /** Gets the parent cell in a specified direction. */
  4462. parent(direction: string): dxPivotGridSummaryCell;
  4463. /** Gets the cell prior to the current one in a specified direction. */
  4464. prev(direction: string): dxPivotGridSummaryCell;
  4465. /** Gets the cell previous to current in a specified direction. */
  4466. prev(direction: string, allowCrossGroup: boolean): dxPivotGridSummaryCell;
  4467. /** Gets the cell located by the path of the source cell with one field value changed. */
  4468. slice(field: DevExpress.data.PivotGridDataSourceField, value: number | string): dxPivotGridSummaryCell;
  4469. /** Gets the value of the current cell. */
  4470. value(): any;
  4471. /** Gets the value of any field linked with the current cell. */
  4472. value(field: DevExpress.data.PivotGridDataSourceField | string): any;
  4473. /** Gets the value of any field linked with the current cell. */
  4474. value(field: DevExpress.data.PivotGridDataSourceField | string, isCalculatedValue: boolean): any;
  4475. /** Gets the value of the current cell. */
  4476. value(isCalculatedValue: boolean): any;
  4477. }
  4478. export interface dxPopoverOptions<T = dxPopover> extends dxPopupOptions<T> {
  4479. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  4480. animation?: dxPopoverAnimation;
  4481. /** A Boolean value specifying whether or not the widget is closed if a user clicks outside of the popover window and outside the target element. */
  4482. closeOnOutsideClick?: boolean | ((event: event) => boolean);
  4483. /** Specifies the widget's height. */
  4484. height?: number | string | (() => number | string);
  4485. /** Specifies options of popover hiding. */
  4486. hideEvent?: { delay?: number, name?: string } | string;
  4487. /** An object defining widget positioning options. */
  4488. position?: 'bottom' | 'left' | 'right' | 'top' | positionConfig;
  4489. /** Specifies whether to shade the background when the widget is active. */
  4490. shading?: boolean;
  4491. /** Specifies options for displaying the widget. */
  4492. showEvent?: { delay?: number, name?: string } | string;
  4493. /** A Boolean value specifying whether or not to display the title in the overlay window. */
  4494. showTitle?: boolean;
  4495. /** The target element associated with the widget. */
  4496. target?: string | Element | JQuery;
  4497. /** Specifies the widget's width. */
  4498. width?: number | string | (() => number | string);
  4499. }
  4500. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  4501. export interface dxPopoverAnimation extends dxPopupAnimation {
  4502. /** An object that defines the animation options used when the widget is being hidden. */
  4503. hide?: animationConfig;
  4504. /** An object that defines the animation options used when the widget is being shown. */
  4505. show?: animationConfig;
  4506. }
  4507. /** The Popover is a widget that shows notifications within a box with an arrow pointing to a specified UI element. */
  4508. export class dxPopover extends dxPopup {
  4509. constructor(element: Element, options?: dxPopoverOptions)
  4510. constructor(element: JQuery, options?: dxPopoverOptions)
  4511. /** Shows the widget. */
  4512. show(): Promise<void> & JQueryPromise<void>;
  4513. /** Shows the widget for a target element. */
  4514. show(target: string | Element | JQuery): Promise<void> & JQueryPromise<void>;
  4515. }
  4516. export interface dxPopupOptions<T = dxPopup> extends dxOverlayOptions<T> {
  4517. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  4518. animation?: dxPopupAnimation;
  4519. /** Specifies the container in which to place the widget. */
  4520. container?: string | Element | JQuery;
  4521. /** Specifies whether or not to allow a user to drag the popup window. */
  4522. dragEnabled?: boolean;
  4523. /** Specifies whether the widget can be focused using keyboard navigation. */
  4524. focusStateEnabled?: boolean;
  4525. /** A Boolean value specifying whether or not to display the widget in full-screen mode. */
  4526. fullScreen?: boolean;
  4527. /** Specifies the widget's height in pixels. */
  4528. height?: number | string | (() => number | string);
  4529. /** A function that is executed each time the widget is resized by one pixel. */
  4530. onResize?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  4531. /** A function that is executed when resizing ends. */
  4532. onResizeEnd?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  4533. /** A function that is executed when resizing starts. */
  4534. onResizeStart?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  4535. /** A function that is executed when the widget's title is rendered. */
  4536. onTitleRendered?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, titleElement?: DevExpress.core.dxElement }) => any);
  4537. /** Positions the widget. */
  4538. position?: 'bottom' | 'center' | 'left' | 'left bottom' | 'left top' | 'right' | 'right bottom' | 'right top' | 'top' | positionConfig | Function;
  4539. /** Specifies whether or not an end user can resize the widget. */
  4540. resizeEnabled?: boolean;
  4541. /** Specifies whether or not the widget displays the Close button. */
  4542. showCloseButton?: boolean;
  4543. /** A Boolean value specifying whether or not to display the title in the popup window. */
  4544. showTitle?: boolean;
  4545. /** The title in the overlay window. */
  4546. title?: string;
  4547. /** Specifies a custom template for the widget title. Does not apply if the title is defined. */
  4548. titleTemplate?: template | ((titleElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4549. /** Configures toolbar items. */
  4550. toolbarItems?: Array<dxPopupToolbarItem>;
  4551. /** Specifies the widget's width in pixels. */
  4552. width?: number | string | (() => number | string);
  4553. }
  4554. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  4555. export interface dxPopupAnimation extends dxOverlayAnimation {
  4556. /** An object that defines the animation options used when the widget is being hidden. */
  4557. hide?: animationConfig;
  4558. /** An object that defines the animation options used when the widget is being shown. */
  4559. show?: animationConfig;
  4560. }
  4561. /** Configures toolbar items. */
  4562. export interface dxPopupToolbarItem {
  4563. /** Specifies whether a toolbar item should be disabled. */
  4564. disabled?: boolean;
  4565. /** Specifies html code inserted into the toolbar item element. */
  4566. html?: string;
  4567. /** Specifies a location for the item on the toolbar. */
  4568. location?: 'after' | 'before' | 'center';
  4569. /** Specifies a configuration object for the widget that presents a toolbar item. */
  4570. options?: any;
  4571. /** Specifies an item template that should be used to render this item only. */
  4572. template?: template;
  4573. /** Specifies text displayed for the toolbar item. */
  4574. text?: string;
  4575. /** Specifies whether the item is displayed on a top or bottom toolbar. */
  4576. toolbar?: 'bottom' | 'top';
  4577. /** Specifies whether or not a widget item must be displayed. */
  4578. visible?: boolean;
  4579. /** A widget that presents a toolbar item. */
  4580. widget?: 'dxAutocomplete' | 'dxButton' | 'dxCheckBox' | 'dxDateBox' | 'dxMenu' | 'dxSelectBox' | 'dxTabs' | 'dxTextBox' | 'dxButtonGroup' | 'dxDropDownButton';
  4581. }
  4582. /** The Popup widget is a pop-up window overlaying the current view. */
  4583. export class dxPopup extends dxOverlay {
  4584. constructor(element: Element, options?: dxPopupOptions)
  4585. constructor(element: JQuery, options?: dxPopupOptions)
  4586. }
  4587. export interface dxProgressBarOptions extends dxTrackBarOptions<dxProgressBar> {
  4588. /** A function that is executed when the value reaches the maximum. */
  4589. onComplete?: ((e: { component?: dxProgressBar, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  4590. /** Specifies whether or not the widget displays a progress status. */
  4591. showStatus?: boolean;
  4592. /** Specifies a format for the progress status. */
  4593. statusFormat?: string | ((ratio: number, value: number) => string);
  4594. /** The current widget value. */
  4595. value?: number;
  4596. }
  4597. /** The ProgressBar is a widget that shows current progress. */
  4598. export class dxProgressBar extends dxTrackBar {
  4599. constructor(element: Element, options?: dxProgressBarOptions)
  4600. constructor(element: JQuery, options?: dxProgressBarOptions)
  4601. }
  4602. export interface dxRadioGroupOptions extends EditorOptions<dxRadioGroup>, DataExpressionMixinOptions<dxRadioGroup> {
  4603. /** Specifies whether or not the widget changes its state when interacting with a user. */
  4604. activeStateEnabled?: boolean;
  4605. /** Specifies whether the widget can be focused using keyboard navigation. */
  4606. focusStateEnabled?: boolean;
  4607. /** Specifies whether the widget changes its state when a user pauses on it. */
  4608. hoverStateEnabled?: boolean;
  4609. /** Specifies the radio group layout. */
  4610. layout?: 'horizontal' | 'vertical';
  4611. /** The value to be assigned to the `name` attribute of the underlying HTML element. */
  4612. name?: string;
  4613. /** Specifies the widget's value. */
  4614. value?: any;
  4615. }
  4616. /** The RadioGroup is a widget that contains a set of radio buttons and allows an end user to make a single selection from the set. */
  4617. export class dxRadioGroup extends Editor {
  4618. constructor(element: Element, options?: dxRadioGroupOptions)
  4619. constructor(element: JQuery, options?: dxRadioGroupOptions)
  4620. /** Gets the DataSource instance. */
  4621. getDataSource(): DevExpress.data.DataSource;
  4622. }
  4623. export interface dxRangeSliderOptions extends dxSliderBaseOptions<dxRangeSlider> {
  4624. /** The right edge of the interval currently selected using the range slider. */
  4625. end?: number;
  4626. /** The value to be assigned to the name attribute of the underlying `` element. */
  4627. endName?: string;
  4628. /** A function that is executed after the widget's value is changed. */
  4629. onValueChanged?: ((e: { component?: dxRangeSlider, element?: DevExpress.core.dxElement, model?: any, start?: number, end?: number, value?: Array<number> }) => any);
  4630. /** The left edge of the interval currently selected using the range slider. */
  4631. start?: number;
  4632. /** The value to be assigned to the name attribute of the underlying `` element. */
  4633. startName?: string;
  4634. /** Specifies the widget's value. */
  4635. value?: Array<number>;
  4636. }
  4637. /** The RangeSlider is a widget that allows an end user to choose a range of numeric values. */
  4638. export class dxRangeSlider extends dxSliderBase {
  4639. constructor(element: Element, options?: dxRangeSliderOptions)
  4640. constructor(element: JQuery, options?: dxRangeSliderOptions)
  4641. }
  4642. export interface dxRecurrenceEditorOptions extends EditorOptions<dxRecurrenceEditor> {
  4643. /** Specifies the widget's value. */
  4644. value?: string;
  4645. }
  4646. /** A base class for editors. */
  4647. export class dxRecurrenceEditor extends Editor {
  4648. constructor(element: Element, options?: dxRecurrenceEditorOptions)
  4649. constructor(element: JQuery, options?: dxRecurrenceEditorOptions)
  4650. }
  4651. export interface dxResizableOptions extends DOMComponentOptions<dxResizable> {
  4652. /** Specifies which borders of the widget element are used as a handle. */
  4653. handles?: 'bottom' | 'left' | 'right' | 'top' | 'all' | string;
  4654. /** Specifies the widget's height. */
  4655. height?: number | string | (() => number | string);
  4656. /** Specifies the upper height boundary for resizing. */
  4657. maxHeight?: number;
  4658. /** Specifies the upper width boundary for resizing. */
  4659. maxWidth?: number;
  4660. /** Specifies the lower height boundary for resizing. */
  4661. minHeight?: number;
  4662. /** Specifies the lower width boundary for resizing. */
  4663. minWidth?: number;
  4664. /** A function that is executed each time the widget is resized by one pixel. */
  4665. onResize?: ((e: { component?: dxResizable, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, width?: number, height?: number }) => any);
  4666. /** A function that is executed when resizing ends. */
  4667. onResizeEnd?: ((e: { component?: dxResizable, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, width?: number, height?: number }) => any);
  4668. /** A function that is executed when resizing starts. */
  4669. onResizeStart?: ((e: { component?: dxResizable, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, width?: number, height?: number }) => any);
  4670. /** Specifies the widget's width. */
  4671. width?: number | string | (() => number | string);
  4672. }
  4673. /** The Resizable widget enables its content to be resizable in the UI. */
  4674. export class dxResizable extends DOMComponent {
  4675. constructor(element: Element, options?: dxResizableOptions)
  4676. constructor(element: JQuery, options?: dxResizableOptions)
  4677. }
  4678. export interface dxResponsiveBoxOptions extends CollectionWidgetOptions<dxResponsiveBox> {
  4679. /** Specifies the collection of columns for the grid used to position layout elements. */
  4680. cols?: Array<{ baseSize?: number | 'auto', ratio?: number, screen?: string, shrink?: number }>;
  4681. /** Specifies the widget's height. */
  4682. height?: number | string | (() => number | string);
  4683. /** An array of items displayed by the widget. */
  4684. items?: Array<string | dxResponsiveBoxItem | any>;
  4685. /** Specifies the collection of rows for the grid used to position layout elements. */
  4686. rows?: Array<{ baseSize?: number | 'auto', ratio?: number, screen?: string, shrink?: number }>;
  4687. /** Specifies the function returning the size qualifier depending on the screen's width. */
  4688. screenByWidth?: Function;
  4689. /** Specifies on which screens all layout elements should be arranged in a single column. Accepts a single or several size qualifiers separated by a space. */
  4690. singleColumnScreen?: string;
  4691. /** Specifies the widget's width. */
  4692. width?: number | string | (() => number | string);
  4693. }
  4694. /** The ResponsiveBox widget allows you to create an application or a website with a layout adapted to different screen sizes. */
  4695. export class dxResponsiveBox extends CollectionWidget {
  4696. constructor(element: Element, options?: dxResponsiveBoxOptions)
  4697. constructor(element: JQuery, options?: dxResponsiveBoxOptions)
  4698. }
  4699. /** This section lists the fields that are used in a default template for widget items. */
  4700. export interface dxResponsiveBoxItem extends CollectionWidgetItem {
  4701. /** Specifies the item location and size against the widget grid. */
  4702. location?: { col?: number, colspan?: number, row?: number, rowspan?: number, screen?: string } | Array<{ col?: number, colspan?: number, row?: number, rowspan?: number, screen?: string }>;
  4703. }
  4704. export interface dxSchedulerOptions extends WidgetOptions<dxScheduler> {
  4705. /** Specifies whether the widget adapts to small screens. */
  4706. adaptivityEnabled?: boolean;
  4707. /** Specifies the name of the data source item field whose value defines whether or not the corresponding appointment is an all-day appointment. */
  4708. allDayExpr?: string;
  4709. /** Specifies an appointment collector's custom template. */
  4710. appointmentCollectorTemplate?: template | ((data: { appointmentCount?: number, isCompact?: boolean }, collectorElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4711. /** Specifies a custom template for appointments. */
  4712. appointmentTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4713. /** Specifies a custom template for appointment tooltips and appointments in the appointment collector's drop-down list. */
  4714. appointmentTooltipTemplate?: template | ((appointmentData: any, contentElement: DevExpress.core.dxElement, targetedAppointmentData: any, itemIndex: number) => string | Element | JQuery);
  4715. /** Specifies cell duration in minutes. */
  4716. cellDuration?: number;
  4717. /** Specifies whether or not an end-user can scroll the view in both directions at the same time. */
  4718. crossScrollingEnabled?: boolean;
  4719. /** Specifies a date displayed on the current scheduler view by default. */
  4720. currentDate?: Date | number | string;
  4721. /** Specifies the currently displayed view. Accepts the view's name or type. */
  4722. currentView?: 'agenda' | 'day' | 'month' | 'timelineDay' | 'timelineMonth' | 'timelineWeek' | 'timelineWorkWeek' | 'week' | 'workWeek';
  4723. /** Customizes the date navigator's text. */
  4724. customizeDateNavigatorText?: ((info: { startDate?: Date, endDate?: Date, text?: string }) => string);
  4725. /** Specifies a custom template for table cells. */
  4726. dataCellTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4727. /** Binds the widget to data. */
  4728. dataSource?: string | Array<dxSchedulerAppointment> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions;
  4729. /** Specifies a custom template for day scale items. */
  4730. dateCellTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4731. /** Specifies the date-time values' serialization format. Use it only if you do not specify the dataSource at design time. */
  4732. dateSerializationFormat?: string;
  4733. /** Specifies the name of the data source item field whose value holds the description of the corresponding appointment. */
  4734. descriptionExpr?: string;
  4735. /** Specifies a custom template for appointments in the appointment collector's drop-down list. */
  4736. dropDownAppointmentTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4737. /** Specifies which editing operations an end-user can perform on appointments. */
  4738. editing?: boolean | { allowAdding?: boolean, allowDeleting?: boolean, allowDragging?: boolean, allowResizing?: boolean, allowUpdating?: boolean };
  4739. /** Specifies the name of the data source item field that defines the ending of an appointment. */
  4740. endDateExpr?: string;
  4741. /** Specifies the name of the data source item field that defines the timezone of the appointment end date. */
  4742. endDateTimeZoneExpr?: string;
  4743. /** Specifies the last hour on the time scale. Accepts integer values from 0 to 24. */
  4744. endDayHour?: number;
  4745. /** Specifies the first day of a week. Does not apply to the agenda view. */
  4746. firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
  4747. /** Specifies whether the widget can be focused using keyboard navigation. */
  4748. focusStateEnabled?: boolean;
  4749. /** If true, appointments are grouped by date first and then by resource; opposite if false. Applies only if appointments are grouped and groupOrientation is "horizontal". */
  4750. groupByDate?: boolean;
  4751. /** Specifies the resource kinds by which the scheduler's appointments are grouped in a timetable. */
  4752. groups?: Array<string>;
  4753. /** Specifies the time interval between when the date-time indicator changes its position, in milliseconds. */
  4754. indicatorUpdateInterval?: number;
  4755. /** The latest date the widget allows you to select. */
  4756. max?: Date | number | string;
  4757. /** Specifies the limit of full-sized appointments displayed per cell. Applies to all views except "agenda". */
  4758. maxAppointmentsPerCell?: number | 'auto' | 'unlimited';
  4759. /** The earliest date the widget allows you to select. */
  4760. min?: Date | number | string;
  4761. /** The text or HTML markup displayed by the widget if the item collection is empty. Available for the Agenda view only. */
  4762. noDataText?: string;
  4763. /** A function that is executed after an appointment is added to the data source. */
  4764. onAppointmentAdded?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, error?: Error }) => any);
  4765. /** A function that is executed before an appointment is added to the data source. */
  4766. onAppointmentAdding?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, cancel?: boolean | Promise<boolean> | JQueryPromise<boolean> }) => any);
  4767. /** A function that is executed when an appointment is clicked or tapped. */
  4768. onAppointmentClick?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, targetedAppointmentData?: any, appointmentElement?: DevExpress.core.dxElement, jQueryEvent?: JQueryEventObject, event?: event, cancel?: boolean }) => any) | string;
  4769. /** A function that is executed when a user attempts to open the browser's context menu for an appointment. Allows you to replace this context menu with a custom context menu. */
  4770. onAppointmentContextMenu?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, targetedAppointmentData?: any, appointmentElement?: DevExpress.core.dxElement, jQueryEvent?: JQueryEventObject, event?: event }) => any) | string;
  4771. /** A function that is executed when an appointment is double-clicked or double-tapped. */
  4772. onAppointmentDblClick?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, targetedAppointmentData?: any, appointmentElement?: DevExpress.core.dxElement, jQueryEvent?: JQueryEventObject, event?: event, cancel?: boolean }) => any) | string;
  4773. /** A function that is executed after an appointment is deleted from the data source. */
  4774. onAppointmentDeleted?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, error?: Error }) => any);
  4775. /** A function that is executed before an appointment is deleted from the data source. */
  4776. onAppointmentDeleting?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, cancel?: boolean | Promise<boolean> | JQueryPromise<boolean> }) => any);
  4777. /** @deprecated Use the onAppointmentFormOpening option instead. */
  4778. /** A function that is executed before an appointment details form is opened. */
  4779. onAppointmentFormCreated?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, form?: dxForm }) => any);
  4780. /** A function that is executed before an appointment details form is opened. */
  4781. onAppointmentFormOpening?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, form?: dxForm }) => any);
  4782. /** A function that is executed when an appointment is rendered. */
  4783. onAppointmentRendered?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, targetedAppointmentData?: any, appointmentElement?: DevExpress.core.dxElement }) => any);
  4784. /** A function that is executed after an appointment is updated in the data source. */
  4785. onAppointmentUpdated?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, appointmentData?: any, error?: Error }) => any);
  4786. /** A function that is executed before an appointment is updated in the data source. */
  4787. onAppointmentUpdating?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, oldData?: any, newData?: any, cancel?: boolean | Promise<boolean> | JQueryPromise<boolean> }) => any);
  4788. /** A function that is executed when a view cell is clicked. */
  4789. onCellClick?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, cellData?: any, cellElement?: DevExpress.core.dxElement, jQueryEvent?: JQueryEventObject, event?: event, cancel?: boolean }) => any) | string;
  4790. /** A function that is executed when a user attempts to open the browser's context menu for a cell. Allows you to replace this context menu with a custom context menu. */
  4791. onCellContextMenu?: ((e: { component?: dxScheduler, element?: DevExpress.core.dxElement, model?: any, cellData?: any, cellElement?: DevExpress.core.dxElement, jQueryEvent?: JQueryEventObject, event?: event }) => any) | string;
  4792. /** Specifies the edit mode for recurring appointments. */
  4793. recurrenceEditMode?: 'dialog' | 'occurrence' | 'series';
  4794. /** Specifies the name of the data source item field that defines exceptions for the current recurring appointment. */
  4795. recurrenceExceptionExpr?: string;
  4796. /** Specifies the name of the data source item field that defines a recurrence rule for generating recurring appointments. */
  4797. recurrenceRuleExpr?: string;
  4798. /** Specifies whether filtering is performed on the server or client side. */
  4799. remoteFiltering?: boolean;
  4800. /** Specifies a custom template for resource headers. */
  4801. resourceCellTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4802. /** Specifies an array of resources available in the scheduler. */
  4803. resources?: Array<{ allowMultiple?: boolean, colorExpr?: string, dataSource?: string | Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions, displayExpr?: string | ((resource: any) => any), fieldExpr?: string, label?: string, useColorAsDefault?: boolean, valueExpr?: string | Function }>;
  4804. /** Currently selected cells' data. */
  4805. selectedCellData?: Array<any>;
  4806. /** Specifies whether to apply shading to cover the timetable up to the current time. */
  4807. shadeUntilCurrentTime?: boolean;
  4808. /** Specifies the "All-day" panel's visibility. Setting this option to false hides the panel along with the all-day appointments. */
  4809. showAllDayPanel?: boolean;
  4810. /** Specifies the current date-time indicator's visibility. */
  4811. showCurrentTimeIndicator?: boolean;
  4812. /** Specifies the name of the data source item field that defines the start of an appointment. */
  4813. startDateExpr?: string;
  4814. /** Specifies the name of the data source item field that defines the timezone of the appointment start date. */
  4815. startDateTimeZoneExpr?: string;
  4816. /** Specifies the first hour on the time scale. Accepts integer values from 0 to 24. */
  4817. startDayHour?: number;
  4818. /** Specifies the name of the data source item field that holds the subject of an appointment. */
  4819. textExpr?: string;
  4820. /** Specifies a custom template for time scale items. */
  4821. timeCellTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4822. /** Specifies the timezone of the widget. */
  4823. timeZone?: string;
  4824. /** Specifies whether a user can switch views using tabs or a drop-down menu. */
  4825. useDropDownViewSwitcher?: boolean;
  4826. /** Specifies and configures the views to be available in the view switcher. */
  4827. views?: Array<'day' | 'week' | 'workWeek' | 'month' | 'timelineDay' | 'timelineWeek' | 'timelineWorkWeek' | 'timelineMonth' | 'agenda' | { agendaDuration?: number, appointmentCollectorTemplate?: template | ((data: { appointmentCount?: number, isCompact?: boolean }, collectorElement: DevExpress.core.dxElement) => string | Element | JQuery), appointmentTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery), appointmentTooltipTemplate?: template | ((appointmentData: any, contentElement: DevExpress.core.dxElement, targetedAppointmentData: any, itemIndex: number) => string | Element | JQuery), cellDuration?: number, dataCellTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery), dateCellTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery), dropDownAppointmentTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery), endDayHour?: number, firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6, groupByDate?: boolean, groupOrientation?: 'horizontal' | 'vertical', groups?: Array<string>, intervalCount?: number, maxAppointmentsPerCell?: number | 'auto' | 'unlimited', name?: string, resourceCellTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery), startDate?: Date | number | string, startDayHour?: number, timeCellTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery), type?: 'agenda' | 'day' | 'month' | 'timelineDay' | 'timelineMonth' | 'timelineWeek' | 'timelineWorkWeek' | 'week' | 'workWeek' }>;
  4828. }
  4829. /** The Scheduler is a widget that represents scheduled data and allows a user to manage and edit it. */
  4830. export class dxScheduler extends Widget {
  4831. constructor(element: Element, options?: dxSchedulerOptions)
  4832. constructor(element: JQuery, options?: dxSchedulerOptions)
  4833. /** Adds an appointment. */
  4834. addAppointment(appointment: any): void;
  4835. /** Deletes an appointment from the timetable and its object from the data source. */
  4836. deleteAppointment(appointment: any): void;
  4837. /** Gets the DataSource instance. */
  4838. getDataSource(): DevExpress.data.DataSource;
  4839. /** Gets the current view's end date. */
  4840. getEndViewDate(): Date;
  4841. /** Gets the current view's start date. */
  4842. getStartViewDate(): Date;
  4843. /** Hides an appointment details form. */
  4844. hideAppointmentPopup(saveChanges?: boolean): void;
  4845. /** Hides an appointment tooltip. */
  4846. hideAppointmentTooltip(): void;
  4847. /** Scrolls the current view to a specific day and time. */
  4848. scrollToTime(hours: number, minutes: number, date?: Date): void;
  4849. /** Shows the appointment details form. */
  4850. showAppointmentPopup(appointmentData?: any, createNewAppointment?: boolean, currentAppointmentData?: any): void;
  4851. /** Shows a tooltip for a target element. */
  4852. showAppointmentTooltip(appointmentData: any, target: string | Element | JQuery, currentAppointmentData?: any): void;
  4853. /** Updates an appointment. */
  4854. updateAppointment(target: any, appointment: any): void;
  4855. }
  4856. /** This section lists the fields that are used in a default template for scheduler appointments. */
  4857. export interface dxSchedulerAppointment extends CollectionWidgetItem {
  4858. /** Specifies whether the appointment lasts all day. */
  4859. allDay?: boolean;
  4860. /** Specifies a detail description of the appointment. */
  4861. description?: string;
  4862. /** Specifies whether an appointment should be disabled. */
  4863. disabled?: boolean;
  4864. /** Specifies the ending of the appointment. */
  4865. endDate?: Date;
  4866. /** Specifies the timezone of the appointment end date. Applies only if timeZone is not specified. */
  4867. endDateTimeZone?: string;
  4868. /** Specifies HTML code inserted into the appointment element. */
  4869. html?: string;
  4870. /** Specifies exceptions for the current recurring appointment. */
  4871. recurrenceException?: string;
  4872. /** Specifies a recurrence rule for generating recurring appointments in the scheduler. */
  4873. recurrenceRule?: string;
  4874. /** Specifies the start of the appointment. */
  4875. startDate?: Date;
  4876. /** Specifies the timezone of the appointment start date. Applies only if timeZone is not specified. */
  4877. startDateTimeZone?: string;
  4878. /** Specifies an appointment template that should be used to render this appointment only. */
  4879. template?: template;
  4880. /** Specifies the subject of the appointment. */
  4881. text?: string;
  4882. /** Specifies whether or not an appointment must be displayed. */
  4883. visible?: boolean;
  4884. }
  4885. /** This section lists the fields that are used in a default template for scheduler appointment tooltips. */
  4886. export interface dxSchedulerAppointmentTooltipTemplate {
  4887. /** Specifies whether or not the current appointment is an all-day appointment. */
  4888. allDay?: boolean;
  4889. /** Specifies the appointment description. */
  4890. description?: string;
  4891. /** Specifies the ending of the appointment. */
  4892. endDate?: Date;
  4893. /** Specifies the timezone of the appointment end date. */
  4894. endDateTimeZone?: string;
  4895. /** Specifies exceptions for a the current recurring appointment. */
  4896. recurrenceException?: string;
  4897. /** Specifies a recurrence rule for generating recurring appointments in the scheduler. */
  4898. recurrenceRule?: string;
  4899. /** Specifies the start of the appointment. */
  4900. startDate?: Date;
  4901. /** Specifies the timezone of the appointment start date. */
  4902. startDateTimeZone?: string;
  4903. /** Specifies the subject of the appointment. */
  4904. text?: string;
  4905. }
  4906. export interface dxScrollViewOptions extends dxScrollableOptions<dxScrollView> {
  4907. /** A function that is executed when the "pull to refresh" gesture is performed. Supported in mobile themes only. */
  4908. onPullDown?: ((e: { component?: dxScrollView, element?: DevExpress.core.dxElement, model?: any }) => any);
  4909. /** A function that is executed when the content is scrolled down to the bottom. */
  4910. onReachBottom?: ((e: { component?: dxScrollView, element?: DevExpress.core.dxElement, model?: any }) => any);
  4911. /** Specifies the text shown in the pullDown panel when pulling the content down lowers the refresh threshold. */
  4912. pulledDownText?: string;
  4913. /** Specifies the text shown in the pullDown panel while pulling the content down to the refresh threshold. */
  4914. pullingDownText?: string;
  4915. /** Specifies the text shown in the pullDown panel displayed when content is scrolled to the bottom. */
  4916. reachBottomText?: string;
  4917. /** Specifies the text shown in the pullDown panel displayed when the content is being refreshed. */
  4918. refreshingText?: string;
  4919. }
  4920. /** The ScrollView is a widget that enables a user to scroll its content. */
  4921. export class dxScrollView extends dxScrollable {
  4922. constructor(element: Element, options?: dxScrollViewOptions)
  4923. constructor(element: JQuery, options?: dxScrollViewOptions)
  4924. /** Locks the widget until the release(preventScrollBottom) method is called and executes the function passed to the onPullDown option and the handler assigned to the pullDown event. */
  4925. refresh(): void;
  4926. /** Notifies the ScrollView that data loading is finished. */
  4927. release(preventScrollBottom: boolean): Promise<void> & JQueryPromise<void>;
  4928. }
  4929. export interface dxScrollableOptions<T = dxScrollable> extends DOMComponentOptions<T> {
  4930. /** A Boolean value specifying whether to enable or disable the bounce-back effect. */
  4931. bounceEnabled?: boolean;
  4932. /** A string value specifying the available scrolling directions. */
  4933. direction?: 'both' | 'horizontal' | 'vertical';
  4934. /** A Boolean value specifying whether or not the widget can respond to user interaction. */
  4935. disabled?: boolean;
  4936. /** A function that is executed on each scroll gesture. */
  4937. onScroll?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, scrollOffset?: any, reachedLeft?: boolean, reachedRight?: boolean, reachedTop?: boolean, reachedBottom?: boolean }) => any);
  4938. /** A function that is executed each time the widget is updated. */
  4939. onUpdated?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, scrollOffset?: any, reachedLeft?: boolean, reachedRight?: boolean, reachedTop?: boolean, reachedBottom?: boolean }) => any);
  4940. /** A Boolean value specifying whether or not an end-user can scroll the widget content swiping it up or down. Applies only if useNative is false */
  4941. scrollByContent?: boolean;
  4942. /** A Boolean value specifying whether or not an end-user can scroll the widget content using the scrollbar. */
  4943. scrollByThumb?: boolean;
  4944. /** Specifies when the widget shows the scrollbar. */
  4945. showScrollbar?: 'onScroll' | 'onHover' | 'always' | 'never';
  4946. /** Indicates whether to use native or simulated scrolling. */
  4947. useNative?: boolean;
  4948. }
  4949. /** A widget used to display scrollable content. */
  4950. export class dxScrollable extends DOMComponent {
  4951. constructor(element: Element, options?: dxScrollableOptions)
  4952. constructor(element: JQuery, options?: dxScrollableOptions)
  4953. /** Gets the widget's height. */
  4954. clientHeight(): number;
  4955. /** Gets the widget's width. */
  4956. clientWidth(): number;
  4957. /** Gets the widget's content. */
  4958. content(): DevExpress.core.dxElement;
  4959. /** Scrolls the content by a specific distance. */
  4960. scrollBy(distance: number): void;
  4961. /** Scrolls the content by a specific distance in horizontal and vertical directions. */
  4962. scrollBy(distanceObject: any): void;
  4963. /** Gets the scrollable content's height in pixels. */
  4964. scrollHeight(): number;
  4965. /** Gets the left scroll offset. */
  4966. scrollLeft(): number;
  4967. /** Gets the scroll offset. */
  4968. scrollOffset(): any;
  4969. /** Scrolls the content to a specific position. */
  4970. scrollTo(targetLocation: number): void;
  4971. /** Scrolls the content to a specific position. */
  4972. scrollTo(targetLocation: any): void;
  4973. /** Scrolls the content to an element. */
  4974. scrollToElement(element: Element | JQuery): void;
  4975. /** Gets the top scroll offset. */
  4976. scrollTop(): number;
  4977. /** Gets the scrollable content's width in pixels. */
  4978. scrollWidth(): number;
  4979. /** Updates the scrollable contents' dimensions. */
  4980. update(): Promise<void> & JQueryPromise<void>;
  4981. }
  4982. export interface dxSelectBoxOptions<T = dxSelectBox> extends dxDropDownListOptions<T> {
  4983. /** Specifies whether the widget allows a user to enter a custom value. Requires the onCustomItemCreating handler implementation. */
  4984. acceptCustomValue?: boolean;
  4985. /** Specifies a custom template for the text field. Must contain the TextBox widget. */
  4986. fieldTemplate?: template | ((selectedItem: any, fieldElement: DevExpress.core.dxElement) => string | Element | JQuery);
  4987. /** A function that is executed when a user adds a custom item. Requires acceptCustomValue to be set to true. */
  4988. onCustomItemCreating?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, text?: string, customItem?: string | any | Promise<any> | JQueryPromise<any> }) => any);
  4989. /** Specifies whether a user can open the drop-down list by clicking a text field. */
  4990. openOnFieldClick?: boolean;
  4991. /** The text that is provided as a hint in the select box editor. */
  4992. placeholder?: string;
  4993. /** Specifies whether the drop-down button is visible. */
  4994. showDropDownButton?: boolean;
  4995. /** Specifies whether or not to display selection controls. */
  4996. showSelectionControls?: boolean;
  4997. /** Specifies the DOM events after which the widget's value should be updated. Applies only if acceptCustomValue is set to true. */
  4998. valueChangeEvent?: string;
  4999. }
  5000. /** The SelectBox widget is an editor that allows an end user to select an item from a drop-down list. */
  5001. export class dxSelectBox extends dxDropDownList {
  5002. constructor(element: Element, options?: dxSelectBoxOptions)
  5003. constructor(element: JQuery, options?: dxSelectBoxOptions)
  5004. }
  5005. export interface dxSlideOutOptions extends CollectionWidgetOptions<dxSlideOut> {
  5006. /** A Boolean value specifying whether or not the widget changes its state when interacting with a user. */
  5007. activeStateEnabled?: boolean;
  5008. /** Specifies a custom template for the widget content. Rendered only once - when the widget is created. */
  5009. contentTemplate?: template | ((container: DevExpress.core.dxElement) => string | Element | JQuery);
  5010. /** An array of items displayed by the widget. */
  5011. items?: Array<string | dxSlideOutItem | any>;
  5012. /** Specifies a custom template for group captions. */
  5013. menuGroupTemplate?: template | ((groupData: any, groupIndex: number, groupElement: any) => string | Element | JQuery);
  5014. /** A Boolean value specifying whether or not to display a grouped menu. */
  5015. menuGrouped?: boolean;
  5016. /** Specifies a custom template for menu items. */
  5017. menuItemTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  5018. /** Specifies the current menu position. */
  5019. menuPosition?: 'inverted' | 'normal';
  5020. /** Specifies whether or not the slide-out menu is displayed. */
  5021. menuVisible?: boolean;
  5022. /** A function that is executed when a group menu item is rendered. */
  5023. onMenuGroupRendered?: ((e: { component?: dxSlideOut, element?: DevExpress.core.dxElement, model?: any }) => any);
  5024. /** A function that is executed when a regular menu item is rendered. */
  5025. onMenuItemRendered?: ((e: { component?: dxSlideOut, element?: DevExpress.core.dxElement, model?: any }) => any);
  5026. /** The index number of the currently selected item. */
  5027. selectedIndex?: number;
  5028. /** Indicates whether the menu can be shown/hidden by swiping the widget's main panel. */
  5029. swipeEnabled?: boolean;
  5030. }
  5031. /** The SlideOut widget is a classic slide-out menu paired with a view. An end user opens the menu by swiping away the view. */
  5032. export class dxSlideOut extends CollectionWidget {
  5033. constructor(element: Element, options?: dxSlideOutOptions)
  5034. constructor(element: JQuery, options?: dxSlideOutOptions)
  5035. /** Hides the widget's slide-out menu. */
  5036. hideMenu(): Promise<void> & JQueryPromise<void>;
  5037. /** Displays the widget's slide-out menu. */
  5038. showMenu(): Promise<void> & JQueryPromise<void>;
  5039. /** Shows or hides the slide-out menu depending on the argument. */
  5040. toggleMenuVisibility(showing: boolean): Promise<void> & JQueryPromise<void>;
  5041. }
  5042. /** This section lists the data source fields that are used in a default template for SlideOut items. */
  5043. export interface dxSlideOutItem extends CollectionWidgetItem {
  5044. /** Specifies a template that should be used to render a menu item. */
  5045. menuTemplate?: template | (() => string | Element | JQuery);
  5046. }
  5047. export interface dxSlideOutViewOptions extends WidgetOptions<dxSlideOutView> {
  5048. /** Specifies a custom template for the widget content. */
  5049. contentTemplate?: template | ((contentElement: DevExpress.core.dxElement) => any);
  5050. /** Specifies the current menu position. */
  5051. menuPosition?: 'inverted' | 'normal';
  5052. /** Specifies a custom template for the menu content. */
  5053. menuTemplate?: template | ((menuElement: DevExpress.core.dxElement) => any);
  5054. /** Specifies whether or not the menu panel is visible. */
  5055. menuVisible?: boolean;
  5056. /** Specifies whether or not the menu is shown when a user swipes the widget content. */
  5057. swipeEnabled?: boolean;
  5058. }
  5059. /** The SlideOutView widget is a classic slide-out menu paired with a view. This widget is very similar to the SlideOut with only one difference - the SlideOut always contains the List in the slide-out menu, while the SlideOutView can hold any collection there. */
  5060. export class dxSlideOutView extends Widget {
  5061. constructor(element: Element, options?: dxSlideOutViewOptions)
  5062. constructor(element: JQuery, options?: dxSlideOutViewOptions)
  5063. /** Gets the widget's content. */
  5064. content(): DevExpress.core.dxElement;
  5065. /** Hides the widget's slide-out menu. */
  5066. hideMenu(): Promise<void> & JQueryPromise<void>;
  5067. /** Gets the slide-out menu's content. */
  5068. menuContent(): DevExpress.core.dxElement;
  5069. /** Shows the slide-out menu. */
  5070. showMenu(): Promise<void> & JQueryPromise<void>;
  5071. /** Shows or hides the slide-out menu depending on the argument. */
  5072. toggleMenuVisibility(): Promise<void> & JQueryPromise<void>;
  5073. }
  5074. export interface dxSliderOptions extends dxSliderBaseOptions<dxSlider> {
  5075. /** The current slider value. */
  5076. value?: number;
  5077. }
  5078. /** The Slider is a widget that allows an end user to set a numeric value on a continuous range of possible values. */
  5079. export class dxSlider extends dxSliderBase {
  5080. constructor(element: Element, options?: dxSliderOptions)
  5081. constructor(element: JQuery, options?: dxSliderOptions)
  5082. }
  5083. export interface dxSliderBaseOptions<T = dxSliderBase> extends dxTrackBarOptions<T> {
  5084. /** Specifies whether or not the widget changes its state when interacting with a user. */
  5085. activeStateEnabled?: boolean;
  5086. /** Specifies whether the widget can be focused using keyboard navigation. */
  5087. focusStateEnabled?: boolean;
  5088. /** Specifies whether the widget changes its state when a user pauses on it. */
  5089. hoverStateEnabled?: boolean;
  5090. /** Specifies the step by which a handle moves when a user presses Page Up or Page Down. */
  5091. keyStep?: number;
  5092. /** Configures the labels displayed at the min and max values. */
  5093. label?: { format?: format, position?: 'bottom' | 'top', visible?: boolean };
  5094. /** The value to be assigned to the `name` attribute of the underlying HTML element. */
  5095. name?: string;
  5096. /** Specifies whether to highlight the selected range. */
  5097. showRange?: boolean;
  5098. /** Specifies the step by which the widget's value changes when a user drags a handler. */
  5099. step?: number;
  5100. /** Configures a tooltip. */
  5101. tooltip?: { enabled?: boolean, format?: format, position?: 'bottom' | 'top', showMode?: 'always' | 'onHover' };
  5102. }
  5103. export class dxSliderBase extends dxTrackBar {
  5104. constructor(element: Element, options?: dxSliderBaseOptions)
  5105. constructor(element: JQuery, options?: dxSliderBaseOptions)
  5106. }
  5107. export interface dxSpeedDialActionOptions extends WidgetOptions<dxSpeedDialAction> {
  5108. /** Specifies the icon the FAB or speed dial action button displays. */
  5109. icon?: string;
  5110. /** A function that is executed when the FAB or speed dial action button is clicked or tapped. */
  5111. onClick?: ((e: { event?: event, component?: dxSpeedDialAction, element?: DevExpress.core.dxElement, actionElement?: DevExpress.core.dxElement }) => any);
  5112. /** A function that is executed when the widget's content is ready and each time the content is changed. */
  5113. onContentReady?: ((e: { component?: dxSpeedDialAction, element?: DevExpress.core.dxElement, model?: any, actionElement?: DevExpress.core.dxElement }) => any);
  5114. }
  5115. /** The SpeedDialAction is a button that performs a custom action. It can be represented by a Floating Action Button (FAB) or a button in a speed dial menu opened with the FAB. */
  5116. export class dxSpeedDialAction extends Widget {
  5117. constructor(element: Element, options?: dxSpeedDialActionOptions)
  5118. constructor(element: JQuery, options?: dxSpeedDialActionOptions)
  5119. }
  5120. export interface dxSwitchOptions extends EditorOptions<dxSwitch> {
  5121. /** Specifies whether or not the widget changes its state when interacting with a user. */
  5122. activeStateEnabled?: boolean;
  5123. /** Specifies whether the widget can be focused using keyboard navigation. */
  5124. focusStateEnabled?: boolean;
  5125. /** Specifies whether the widget changes its state when a user pauses on it. */
  5126. hoverStateEnabled?: boolean;
  5127. /** The value to be assigned to the `name` attribute of the underlying HTML element. */
  5128. name?: string;
  5129. /** @deprecated Use the switchedOffText option instead. */
  5130. /** Text displayed when the widget is in a disabled state. */
  5131. offText?: string;
  5132. /** @deprecated Use the switchedOnText option instead. */
  5133. /** Text displayed when the widget is in an enabled state. */
  5134. onText?: string;
  5135. /** Specifies the text displayed when the widget is switched off. */
  5136. switchedOffText?: string;
  5137. /** Specifies the text displayed when the widget is switched on. */
  5138. switchedOnText?: string;
  5139. /** A Boolean value specifying whether the current switch state is "On" or "Off". */
  5140. value?: boolean;
  5141. }
  5142. /** The Switch is a widget that can be in two states: "On" and "Off". */
  5143. export class dxSwitch extends Editor {
  5144. constructor(element: Element, options?: dxSwitchOptions)
  5145. constructor(element: JQuery, options?: dxSwitchOptions)
  5146. }
  5147. export interface dxTabPanelOptions extends dxMultiViewOptions<dxTabPanel> {
  5148. /** Specifies whether or not to animate the displayed item change. */
  5149. animationEnabled?: boolean;
  5150. /** Specifies whether the widget can be focused using keyboard navigation. */
  5151. focusStateEnabled?: boolean;
  5152. /** Specifies whether the widget changes its state when a user pauses on it. */
  5153. hoverStateEnabled?: boolean;
  5154. /** Specifies a custom template for item titles. */
  5155. itemTitleTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  5156. /** An array of items displayed by the widget. */
  5157. items?: Array<string | dxTabPanelItem | any>;
  5158. /** A function that is executed when a tab is clicked or tapped. */
  5159. onTitleClick?: ((e: { component?: dxTabPanel, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, event?: event }) => any) | string;
  5160. /** A function that is executed when a tab has been held for a specified period. */
  5161. onTitleHold?: ((e: { component?: dxTabPanel, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, event?: event }) => any);
  5162. /** A function that is executed after a tab is rendered. */
  5163. onTitleRendered?: ((e: { component?: dxTabPanel, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement }) => any);
  5164. /** Specifies whether to repaint only those elements whose data changed. */
  5165. repaintChangesOnly?: boolean;
  5166. /** A Boolean value specifying if tabs in the title are scrolled by content. */
  5167. scrollByContent?: boolean;
  5168. /** A Boolean indicating whether or not to add scrolling support for tabs in the title. */
  5169. scrollingEnabled?: boolean;
  5170. /** Specifies whether navigation buttons should be available when tabs exceed the widget's width. */
  5171. showNavButtons?: boolean;
  5172. /** A Boolean value specifying whether or not to allow users to change the selected index by swiping. */
  5173. swipeEnabled?: boolean;
  5174. }
  5175. /** The TabPanel is a widget consisting of the Tabs and MultiView widgets. It automatically synchronizes the selected tab with the currently displayed view and vice versa. */
  5176. export class dxTabPanel extends dxMultiView {
  5177. constructor(element: Element, options?: dxTabPanelOptions)
  5178. constructor(element: JQuery, options?: dxTabPanelOptions)
  5179. }
  5180. /** This section lists the data source fields that are used in a default template for tab panel items. */
  5181. export interface dxTabPanelItem extends dxMultiViewItem {
  5182. /** Specifies a badge text for the tab. */
  5183. badge?: string;
  5184. /** Specifies the icon to be displayed in the tab's title. */
  5185. icon?: string;
  5186. /** Specifies a template that should be used to render the tab for this item only. */
  5187. tabTemplate?: template | (() => string | Element | JQuery);
  5188. /** Specifies the item title text displayed on a corresponding tab. */
  5189. title?: string;
  5190. }
  5191. export interface dxTabsOptions<T = dxTabs> extends CollectionWidgetOptions<T> {
  5192. /** Specifies whether the widget can be focused using keyboard navigation. */
  5193. focusStateEnabled?: boolean;
  5194. /** Specifies whether the widget changes its state when a user pauses on it. */
  5195. hoverStateEnabled?: boolean;
  5196. /** An array of items displayed by the widget. */
  5197. items?: Array<string | dxTabsItem | any>;
  5198. /** Specifies whether to repaint only those elements whose data changed. */
  5199. repaintChangesOnly?: boolean;
  5200. /** Specifies whether or not an end-user can scroll tabs by swiping. */
  5201. scrollByContent?: boolean;
  5202. /** Specifies whether or not an end-user can scroll tabs. */
  5203. scrollingEnabled?: boolean;
  5204. /** An array of currently selected item objects. */
  5205. selectedItems?: Array<string | number | any>;
  5206. /** Specifies whether the widget enables an end-user to select only a single item or multiple items. */
  5207. selectionMode?: 'multiple' | 'single';
  5208. /** Specifies whether navigation buttons should be available when tabs exceed the widget's width. */
  5209. showNavButtons?: boolean;
  5210. }
  5211. /** The Tabs is a tab strip used to switch between pages or views. This widget is included in the TabPanel widget, but you can use the Tabs separately as well. */
  5212. export class dxTabs extends CollectionWidget {
  5213. constructor(element: Element, options?: dxTabsOptions)
  5214. constructor(element: JQuery, options?: dxTabsOptions)
  5215. }
  5216. /** This section lists the data source fields that are used in a default template for tabs. */
  5217. export interface dxTabsItem extends CollectionWidgetItem {
  5218. /** Specifies a badge text for the tab. */
  5219. badge?: string;
  5220. /** Specifies the icon to be displayed on the tab. */
  5221. icon?: string;
  5222. }
  5223. export interface dxTagBoxOptions extends dxSelectBoxOptions<dxTagBox> {
  5224. /** Specifies how the widget applies values. */
  5225. applyValueMode?: 'instantly' | 'useButtons';
  5226. /** A Boolean value specifying whether or not to hide selected items. */
  5227. hideSelectedItems?: boolean;
  5228. /** Specifies the limit on displayed tags. On exceeding it, the widget replaces all tags with a single multi-tag that displays the number of selected items. */
  5229. maxDisplayedTags?: number;
  5230. /** A Boolean value specifying whether or not the widget is multiline. */
  5231. multiline?: boolean;
  5232. /** A function that is executed before the multi-tag is rendered. */
  5233. onMultiTagPreparing?: ((e: { component?: dxTagBox, element?: DevExpress.core.dxElement, model?: any, multiTagElement?: DevExpress.core.dxElement, selectedItems?: Array<string | number | any>, text?: string, cancel?: boolean }) => any);
  5234. /** A function that is executed when the "Select All" check box value is changed. Applies only if showSelectionControls is true. */
  5235. onSelectAllValueChanged?: ((e: { component?: dxTagBox, element?: DevExpress.core.dxElement, model?: any, value?: boolean }) => any);
  5236. /** A function that is executed when a list item is selected or selection is canceled. */
  5237. onSelectionChanged?: ((e: { component?: dxTagBox, element?: DevExpress.core.dxElement, model?: any, addedItems?: Array<string | number | any>, removedItems?: Array<string | number | any> }) => any);
  5238. /** Specifies the mode in which all items are selected. */
  5239. selectAllMode?: 'allPages' | 'page';
  5240. /** Gets the currently selected items. */
  5241. selectedItems?: Array<string | number | any>;
  5242. /** Specifies whether the drop-down button is visible. */
  5243. showDropDownButton?: boolean;
  5244. /** Specifies whether the multi-tag is shown without ordinary tags. */
  5245. showMultiTagOnly?: boolean;
  5246. /** Specifies a custom template for tags. */
  5247. tagTemplate?: template | ((itemData: any, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  5248. /** Specifies the selected items. */
  5249. value?: Array<string | number | any>;
  5250. }
  5251. /** The TagBox widget is an editor that allows an end user to select multiple items from a drop-down list. */
  5252. export class dxTagBox extends dxSelectBox {
  5253. constructor(element: Element, options?: dxTagBoxOptions)
  5254. constructor(element: JQuery, options?: dxTagBoxOptions)
  5255. }
  5256. export interface dxTemplateOptions {
  5257. /** Specifies the name of the template. */
  5258. name?: string;
  5259. }
  5260. /** A custom template's markup. */
  5261. export class dxTemplate {
  5262. constructor(options?: dxTemplateOptions)
  5263. }
  5264. export interface dxTextAreaOptions extends dxTextBoxOptions<dxTextArea> {
  5265. /** A Boolean value specifying whether or not the auto resizing mode is enabled. */
  5266. autoResizeEnabled?: boolean;
  5267. /** Specifies the maximum height of the widget. */
  5268. maxHeight?: number | string;
  5269. /** Specifies the minimum height of the widget. */
  5270. minHeight?: number | string;
  5271. /** Specifies whether or not the widget checks the inner text for spelling mistakes. */
  5272. spellcheck?: boolean;
  5273. }
  5274. /** The TextArea is a widget that enables a user to enter and edit a multi-line text. */
  5275. export class dxTextArea extends dxTextBox {
  5276. constructor(element: Element, options?: dxTextAreaOptions)
  5277. constructor(element: JQuery, options?: dxTextAreaOptions)
  5278. }
  5279. export interface dxTextBoxOptions<T = dxTextBox> extends dxTextEditorOptions<T> {
  5280. /** Specifies the maximum number of characters you can enter into the textbox. */
  5281. maxLength?: string | number;
  5282. /** The "mode" attribute value of the actual HTML input element representing the text box. */
  5283. mode?: 'email' | 'password' | 'search' | 'tel' | 'text' | 'url';
  5284. /** Specifies a value the widget displays. */
  5285. value?: string;
  5286. }
  5287. /** The TextBox is a widget that enables a user to enter and edit a single line of text. */
  5288. export class dxTextBox extends dxTextEditor {
  5289. constructor(element: Element, options?: dxTextBoxOptions)
  5290. constructor(element: JQuery, options?: dxTextBoxOptions)
  5291. }
  5292. export interface dxTextEditorOptions<T = dxTextEditor> extends EditorOptions<T> {
  5293. /** Allows you to add custom buttons to the input text field. */
  5294. buttons?: Array<string | 'clear' | dxTextEditorButton>;
  5295. /** Specifies whether the widget can be focused using keyboard navigation. */
  5296. focusStateEnabled?: boolean;
  5297. /** Specifies whether the widget changes its state when a user pauses on it. */
  5298. hoverStateEnabled?: boolean;
  5299. /** Specifies the attributes to be passed on to the underlying HTML element. */
  5300. inputAttr?: any;
  5301. /** The editor mask that specifies the custom format of the entered string. */
  5302. mask?: string;
  5303. /** Specifies a mask placeholder character. */
  5304. maskChar?: string;
  5305. /** A message displayed when the entered text does not match the specified pattern. */
  5306. maskInvalidMessage?: string;
  5307. /** Specifies custom mask rules. */
  5308. maskRules?: any;
  5309. /** The value to be assigned to the `name` attribute of the underlying HTML element. */
  5310. name?: string;
  5311. /** A function that is executed when the widget loses focus after the text field's content was changed using the keyboard. */
  5312. onChange?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5313. /** A function that is executed when the widget's input has been copied. */
  5314. onCopy?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5315. /** A function that is executed when the widget's input has been cut. */
  5316. onCut?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5317. /** A function that is executed when the Enter key has been pressed while the widget is focused. */
  5318. onEnterKey?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5319. /** A function that is executed when the widget gets focus. */
  5320. onFocusIn?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5321. /** A function that is executed when the widget loses focus. */
  5322. onFocusOut?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5323. /** A function that is executed each time the widget's input is changed while the widget is focused. */
  5324. onInput?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5325. /** A function that is executed when a user is pressing a key on the keyboard. */
  5326. onKeyDown?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5327. /** A function that is executed when a user presses a key on the keyboard. */
  5328. onKeyPress?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5329. /** A function that is executed when a user releases a key on the keyboard. */
  5330. onKeyUp?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5331. /** A function that is executed when the widget's input has been pasted. */
  5332. onPaste?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event }) => any);
  5333. /** The text displayed by the widget when the widget value is empty. */
  5334. placeholder?: string;
  5335. /** Specifies whether to display the Clear button in the widget. */
  5336. showClearButton?: boolean;
  5337. /** Specifies when the widget shows the mask. Applies only if useMaskedValue is true. */
  5338. showMaskMode?: 'always' | 'onFocus';
  5339. /** Specifies whether or not the widget checks the inner text for spelling mistakes. */
  5340. spellcheck?: boolean;
  5341. /** Specifies how the widget's text field is styled. */
  5342. stylingMode?: 'outlined' | 'underlined' | 'filled';
  5343. /** The read-only option that holds the text displayed by the widget input element. */
  5344. text?: string;
  5345. /** Specifies whether the value should contain mask characters or not. */
  5346. useMaskedValue?: boolean;
  5347. /** Specifies the current value displayed by the widget. */
  5348. value?: any;
  5349. /** Specifies the DOM events after which the widget's value should be updated. */
  5350. valueChangeEvent?: string;
  5351. }
  5352. /** A base class for text editing widgets. */
  5353. export class dxTextEditor extends Editor {
  5354. constructor(element: Element, options?: dxTextEditorOptions)
  5355. constructor(element: JQuery, options?: dxTextEditorOptions)
  5356. /** Removes focus from the input element. */
  5357. blur(): void;
  5358. /** Sets focus to the input element representing the widget. */
  5359. focus(): void;
  5360. /** Gets an instance of a custom action button. */
  5361. getButton(name: string): dxButton | undefined;
  5362. }
  5363. export interface dxTextEditorButton {
  5364. /** Specifies whether to place the button before or after the input text field. */
  5365. location?: 'after' | 'before';
  5366. /** Specifies the button's name. */
  5367. name?: string;
  5368. /** Configures the Button widget used as the action button. */
  5369. options?: dxButtonOptions;
  5370. }
  5371. export interface dxTileViewOptions extends CollectionWidgetOptions<dxTileView> {
  5372. /** A Boolean value specifying whether or not the widget changes its state when interacting with a user. */
  5373. activeStateEnabled?: boolean;
  5374. /** Specifies the height of the base tile view item. */
  5375. baseItemHeight?: number;
  5376. /** Specifies the width of the base tile view item. */
  5377. baseItemWidth?: number;
  5378. /** Specifies whether tiles are placed horizontally or vertically. */
  5379. direction?: 'horizontal' | 'vertical';
  5380. /** Specifies whether the widget can be focused using keyboard navigation. */
  5381. focusStateEnabled?: boolean;
  5382. /** Specifies the widget's height. */
  5383. height?: number | string;
  5384. /** Specifies whether the widget changes its state when a user pauses on it. */
  5385. hoverStateEnabled?: boolean;
  5386. /** Specifies the distance in pixels between adjacent tiles. */
  5387. itemMargin?: number;
  5388. /** An array of items displayed by the widget. */
  5389. items?: Array<string | dxTileViewItem | any>;
  5390. /** A Boolean value specifying whether or not to display a scrollbar. */
  5391. showScrollbar?: boolean;
  5392. }
  5393. /** The TileView widget contains a collection of tiles. Tiles can store much more information than ordinary buttons, that is why they are very popular in apps designed for touch devices. */
  5394. export class dxTileView extends CollectionWidget {
  5395. constructor(element: Element, options?: dxTileViewOptions)
  5396. constructor(element: JQuery, options?: dxTileViewOptions)
  5397. /** Gets the current scroll position. */
  5398. scrollPosition(): number;
  5399. }
  5400. /** This section lists the data source fields that are used in a default template for tile view items. */
  5401. export interface dxTileViewItem extends CollectionWidgetItem {
  5402. /** Specifies a multiplier for the baseItemHeight option value (for the purpose of obtaining the actual item height). */
  5403. heightRatio?: number;
  5404. /** Specifies a multiplier for the baseItemWidth option value (for the purpose of obtaining the actual item width). */
  5405. widthRatio?: number;
  5406. }
  5407. export interface dxToastOptions extends dxOverlayOptions<dxToast> {
  5408. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  5409. animation?: dxToastAnimation;
  5410. /** A Boolean value specifying whether or not the toast is closed if a user clicks it. */
  5411. closeOnClick?: boolean;
  5412. /** Specifies whether to close the widget if a user clicks outside it. */
  5413. closeOnOutsideClick?: boolean | ((event: event) => boolean);
  5414. /** A Boolean value specifying whether or not the toast is closed if a user swipes it out of the screen boundaries. */
  5415. closeOnSwipe?: boolean;
  5416. /** The time span in milliseconds during which the Toast widget is visible. */
  5417. displayTime?: number;
  5418. /** Specifies the widget's height in pixels. */
  5419. height?: number | string | (() => number | string);
  5420. /** Specifies the maximum width the widget can reach while resizing. */
  5421. maxWidth?: number | string | (() => number | string);
  5422. /** The Toast message text. */
  5423. message?: string;
  5424. /** Specifies the minimum width the widget can reach while resizing. */
  5425. minWidth?: number | string | (() => number | string);
  5426. /** Positions the widget. */
  5427. position?: positionConfig | string;
  5428. /** Specifies whether to shade the background when the widget is active. */
  5429. shading?: boolean;
  5430. /** Specifies the Toast widget type. */
  5431. type?: 'custom' | 'error' | 'info' | 'success' | 'warning';
  5432. /** Specifies the widget's width in pixels. */
  5433. width?: number | string | (() => number | string);
  5434. }
  5435. /** Configures widget visibility animations. This object contains two fields: show and hide. */
  5436. export interface dxToastAnimation extends dxOverlayAnimation {
  5437. /** An object that defines the animation options used when the widget is being hidden. */
  5438. hide?: animationConfig;
  5439. /** An object that defines the animation options used when the widget is being shown. */
  5440. show?: animationConfig;
  5441. }
  5442. /** The Toast is a widget that provides pop-up notifications. */
  5443. export class dxToast extends dxOverlay {
  5444. constructor(element: Element, options?: dxToastOptions)
  5445. constructor(element: JQuery, options?: dxToastOptions)
  5446. }
  5447. export interface dxToolbarOptions extends CollectionWidgetOptions<dxToolbar> {
  5448. /** An array of items displayed by the widget. */
  5449. items?: Array<string | dxToolbarItem | any>;
  5450. /** Specifies a custom template for menu items. */
  5451. menuItemTemplate?: template | ((itemData: any, itemIndex: number, itemElement: DevExpress.core.dxElement) => string | Element | JQuery);
  5452. /** Informs the widget about its location in a view HTML markup. */
  5453. renderAs?: 'bottomToolbar' | 'topToolbar';
  5454. }
  5455. /** The Toolbar is a widget containing items that usually manage screen content. Those items can be plain text or widgets. */
  5456. export class dxToolbar extends CollectionWidget {
  5457. constructor(element: Element, options?: dxToolbarOptions)
  5458. constructor(element: JQuery, options?: dxToolbarOptions)
  5459. }
  5460. /** This section lists the data source fields that are used in a default template for toolbar items. */
  5461. export interface dxToolbarItem extends CollectionWidgetItem {
  5462. /** Specifies a CSS class to be applied to the item. */
  5463. cssClass?: string;
  5464. /** Specifies when to display an item in the toolbar's overflow menu. */
  5465. locateInMenu?: 'always' | 'auto' | 'never';
  5466. /** Specifies a location for the item on the toolbar. */
  5467. location?: 'after' | 'before' | 'center';
  5468. /** Specifies a template that should be used to render a menu item. */
  5469. menuItemTemplate?: template | (() => string | Element | JQuery);
  5470. /** Specifies a configuration object for the widget that presents a toolbar item. */
  5471. options?: any;
  5472. /** Specifies when to display the text for the widget item. */
  5473. showText?: 'always' | 'inMenu';
  5474. /** A widget that presents a toolbar item. */
  5475. widget?: 'dxAutocomplete' | 'dxButton' | 'dxCheckBox' | 'dxDateBox' | 'dxMenu' | 'dxSelectBox' | 'dxTabs' | 'dxTextBox' | 'dxButtonGroup' | 'dxDropDownButton';
  5476. }
  5477. export interface dxTooltipOptions extends dxPopoverOptions<dxTooltip> {
  5478. }
  5479. /** The Tooltip widget displays a tooltip for a specified element on the page. */
  5480. export class dxTooltip extends dxPopover {
  5481. constructor(element: Element, options?: dxTooltipOptions)
  5482. constructor(element: JQuery, options?: dxTooltipOptions)
  5483. }
  5484. export interface dxTrackBarOptions<T = dxTrackBar> extends EditorOptions<T> {
  5485. /** The maximum value the widget can accept. */
  5486. max?: number;
  5487. /** The minimum value the widget can accept. */
  5488. min?: number;
  5489. }
  5490. /** A base class for track bar widgets. */
  5491. export class dxTrackBar extends Editor {
  5492. constructor(element: Element, options?: dxTrackBarOptions)
  5493. constructor(element: JQuery, options?: dxTrackBarOptions)
  5494. }
  5495. export interface dxTreeListOptions extends GridBaseOptions<dxTreeList> {
  5496. /** Specifies whether all rows are expanded initially. */
  5497. autoExpandAll?: boolean;
  5498. /** Configures columns. */
  5499. columns?: Array<dxTreeListColumn | string>;
  5500. /** Customizes columns after they are created. */
  5501. customizeColumns?: ((columns: Array<dxTreeListColumn>) => any);
  5502. /** Notifies the widget of the used data structure. */
  5503. dataStructure?: 'plain' | 'tree';
  5504. /** Configures editing. */
  5505. editing?: dxTreeListEditing;
  5506. /** Specifies whether nodes appear expanded or collapsed after filtering is applied. */
  5507. expandNodesOnFiltering?: boolean;
  5508. /** Specifies keys of the initially expanded rows. */
  5509. expandedRowKeys?: Array<any>;
  5510. /** Specifies whether to show filtered rows with ancestors and descendants (full branch) or with ancestors only. */
  5511. filterMode?: 'fullBranch' | 'withAncestors';
  5512. /** Specifies which data field defines whether the node has children. */
  5513. hasItemsExpr?: string | Function;
  5514. /** Specifies which data field contains nested items. Set this option when your data has a hierarchical structure. */
  5515. itemsExpr?: string | Function;
  5516. /** Specifies which data field provides keys for nodes. */
  5517. keyExpr?: string | Function;
  5518. /** A function that is executed when a cell is clicked or tapped. Executed before onRowClick. */
  5519. onCellClick?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, data?: any, key?: any, value?: any, displayValue?: any, text?: string, columnIndex?: number, column?: any, rowIndex?: number, rowType?: string, cellElement?: DevExpress.core.dxElement, row?: dxTreeListRowObject }) => any) | string;
  5520. /** A function that is executed when a cell is double-clicked or double-tapped. Executed before onRowDblClick. */
  5521. onCellDblClick?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, event?: event, data?: any, key?: any, value?: any, displayValue?: any, text?: string, columnIndex?: number, column?: dxTreeListColumn, rowIndex?: number, rowType?: string, cellElement?: DevExpress.core.dxElement, row?: dxTreeListRowObject }) => any);
  5522. /** A function that is executed after the pointer enters or leaves a cell. */
  5523. onCellHoverChanged?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, eventType?: string, data?: any, key?: any, value?: any, text?: string, displayValue?: any, columnIndex?: number, rowIndex?: number, column?: dxTreeListColumn, rowType?: string, cellElement?: DevExpress.core.dxElement, row?: dxTreeListRowObject }) => any);
  5524. /** A function that is executed after a grid cell is created. */
  5525. onCellPrepared?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, value?: any, displayValue?: any, text?: string, columnIndex?: number, column?: dxTreeListColumn, rowIndex?: number, rowType?: string, row?: dxTreeListRowObject, isSelected?: boolean, isExpanded?: boolean, isNewRow?: boolean, cellElement?: DevExpress.core.dxElement, watch?: Function, oldValue?: any }) => any);
  5526. /** A function that is executed before the context menu is rendered. */
  5527. onContextMenuPreparing?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, items?: Array<any>, target?: string, targetElement?: DevExpress.core.dxElement, columnIndex?: number, column?: dxTreeListColumn, rowIndex?: number, row?: dxTreeListRowObject }) => any);
  5528. /** A function that is executed before a cell or row switches to the editing state. */
  5529. onEditingStart?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, cancel?: boolean, column?: any }) => any);
  5530. /** A function that is executed after an editor is created. Not executed for cells with an editCellTemplate. */
  5531. onEditorPrepared?: ((options: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, parentType?: string, value?: any, setValue?: any, updateValueTimeout?: number, width?: number, disabled?: boolean, rtlEnabled?: boolean, editorElement?: DevExpress.core.dxElement, readOnly?: boolean, dataField?: string, row?: dxTreeListRowObject }) => any);
  5532. /** A function used to customize or replace default editors. Not executed for cells with an editCellTemplate. */
  5533. onEditorPreparing?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, parentType?: string, value?: any, setValue?: any, updateValueTimeout?: number, width?: number, disabled?: boolean, rtlEnabled?: boolean, cancel?: boolean, editorElement?: DevExpress.core.dxElement, readOnly?: boolean, editorName?: string, editorOptions?: any, dataField?: string, row?: dxTreeListRowObject }) => any);
  5534. /** A function that is executed after the focused cell changes. */
  5535. onFocusedCellChanged?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, cellElement?: DevExpress.core.dxElement, columnIndex?: number, rowIndex?: number, row?: dxTreeListRowObject, column?: dxTreeListColumn }) => any);
  5536. /** A function that is executed before the focused cell changes. */
  5537. onFocusedCellChanging?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, cellElement?: DevExpress.core.dxElement, prevColumnIndex?: number, prevRowIndex?: number, newColumnIndex?: number, newRowIndex?: number, event?: event, rows?: Array<dxTreeListRowObject>, columns?: Array<dxTreeListColumn>, cancel?: boolean, isHighlighted?: boolean }) => any);
  5538. /** A function that executed when the focused row changes. Applies only when focusedRowEnabled is true. */
  5539. onFocusedRowChanged?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, rowElement?: DevExpress.core.dxElement, rowIndex?: number, row?: dxTreeListRowObject }) => any);
  5540. /** A function that is executed before the focused row changes. Applies only when focusedRowEnabled is true. */
  5541. onFocusedRowChanging?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, rowElement?: DevExpress.core.dxElement, prevRowIndex?: number, newRowIndex?: number, event?: event, rows?: Array<dxTreeListRowObject>, cancel?: boolean }) => any);
  5542. /** A function that is executed after the loaded nodes are initialized. */
  5543. onNodesInitialized?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, root?: dxTreeListNode }) => any);
  5544. /** A function that is executed when a grid row is clicked or tapped. */
  5545. onRowClick?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, data?: any, key?: any, values?: Array<any>, columns?: Array<any>, rowIndex?: number, rowType?: string, isSelected?: boolean, isExpanded?: boolean, isNewRow?: boolean, rowElement?: DevExpress.core.dxElement, handled?: boolean, node?: dxTreeListNode, level?: number }) => any) | string;
  5546. /** A function that is executed when a row is double-clicked or double-tapped. Executed after onCellDblClick. */
  5547. onRowDblClick?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, event?: event, data?: any, key?: any, values?: Array<any>, columns?: Array<dxTreeListColumn>, rowIndex?: number, rowType?: string, isSelected?: boolean, isExpanded?: boolean, isNewRow?: boolean, rowElement?: DevExpress.core.dxElement }) => any);
  5548. /** A function that is executed after a row is created. */
  5549. onRowPrepared?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, data?: any, key?: any, values?: Array<any>, columns?: Array<dxTreeListColumn>, rowIndex?: number, rowType?: string, isSelected?: boolean, isExpanded?: boolean, isNewRow?: boolean, rowElement?: DevExpress.core.dxElement, node?: dxTreeListNode, level?: number }) => any);
  5550. /** Configures paging. */
  5551. paging?: dxTreeListPaging;
  5552. /** Specifies which data field provides parent keys. */
  5553. parentIdExpr?: string | Function;
  5554. /** Notifies the TreeList of the server's data processing operations. Applies only if data has a plain structure. */
  5555. remoteOperations?: { filtering?: boolean, grouping?: boolean, sorting?: boolean } | 'auto';
  5556. /** Specifies the root node's identifier. Applies if dataStructure is "plain". */
  5557. rootValue?: any;
  5558. /** Configures scrolling. */
  5559. scrolling?: dxTreeListScrolling;
  5560. /** Configures runtime selection. */
  5561. selection?: dxTreeListSelection;
  5562. }
  5563. /** Configures editing. */
  5564. export interface dxTreeListEditing extends GridBaseEditing {
  5565. /** Specifies whether a user can add new rows. It is called for each data row when defined as a function. */
  5566. allowAdding?: boolean | ((options: { component?: dxTreeList, row?: dxTreeListRowObject }) => boolean);
  5567. /** Specifies whether a user can delete rows. It is called for each data row when defined as a function. */
  5568. allowDeleting?: boolean | ((options: { component?: dxTreeList, row?: dxTreeListRowObject }) => boolean);
  5569. /** Specifies whether a user can update rows. It is called for each data row when defined as a function */
  5570. allowUpdating?: boolean | ((options: { component?: dxTreeList, row?: dxTreeListRowObject }) => boolean);
  5571. /** Contains options that specify texts for editing-related UI elements. */
  5572. texts?: dxTreeListEditingTexts;
  5573. }
  5574. /** Contains options that specify texts for editing-related UI elements. */
  5575. export interface dxTreeListEditingTexts extends GridBaseEditingTexts {
  5576. /** Specifies text for the button that adds a new nested row. Applies if the editing.mode is "batch" or "cell". */
  5577. addRowToNode?: string;
  5578. }
  5579. /** Configures paging. */
  5580. export interface dxTreeListPaging extends GridBasePaging {
  5581. /** Enables paging. */
  5582. enabled?: boolean;
  5583. }
  5584. /** Configures scrolling. */
  5585. export interface dxTreeListScrolling extends GridBaseScrolling {
  5586. /** Specifies the scrolling mode. */
  5587. mode?: 'standard' | 'virtual';
  5588. }
  5589. /** Configures runtime selection. */
  5590. export interface dxTreeListSelection extends GridBaseSelection {
  5591. /** Specifies whether selection is recursive. */
  5592. recursive?: boolean;
  5593. }
  5594. /** The TreeList is a widget that represents data from a local or remote source in the form of a multi-column tree view. This widget offers such features as sorting, filtering, editing, selection, etc. */
  5595. export class dxTreeList extends GridBase {
  5596. constructor(element: Element, options?: dxTreeListOptions)
  5597. constructor(element: JQuery, options?: dxTreeListOptions)
  5598. /** Adds a new column. */
  5599. addColumn(columnOptions: any | string): void;
  5600. /** Adds an empty data row to the highest hierarchical level. */
  5601. addRow(): void;
  5602. /** Adds an empty data row to a specified parent row. */
  5603. addRow(parentId: any): void;
  5604. /** Collapses a row with a specific key. */
  5605. collapseRow(key: any): Promise<void> & JQueryPromise<void>;
  5606. /** Expands a row with a specific key. */
  5607. expandRow(key: any): Promise<void> & JQueryPromise<void>;
  5608. /** Performs a pre-order tree traversal, executing a function on each visited node. Starts traversing from the top level nodes. */
  5609. forEachNode(callback: Function): void;
  5610. /** Performs a pre-order tree traversal, executing a function on each visited node. Starts traversing from the specified nodes. */
  5611. forEachNode(nodes: Array<dxTreeListNode>, callback: Function): void;
  5612. /** Gets a node with a specific key. */
  5613. getNodeByKey(key: any | string | number): dxTreeListNode;
  5614. /** Gets the root node. */
  5615. getRootNode(): dxTreeListNode;
  5616. /** Gets the keys of the rows selected explicitly via the API or via a click or tap. */
  5617. getSelectedRowKeys(): Array<any>;
  5618. /** @deprecated Use the [getSelectedRowKeys(mode)](/api-reference/10%20UI%20Widgets/dxTreeList/3%20Methods/getSelectedRowKeys(mode).md '/Documentation/ApiReference/UI_Widgets/dxTreeList/Methods/#getSelectedRowKeysmode') method instead. */
  5619. /** Gets the selected rows' keys. */
  5620. getSelectedRowKeys(leavesOnly: boolean): Array<any>;
  5621. /** Gets the selected rows' keys. */
  5622. getSelectedRowKeys(mode: string): Array<any>;
  5623. /** Gets the data objects of the rows selected explicitly via the API or via a click or tap. */
  5624. getSelectedRowsData(): Array<any>;
  5625. /** Gets the selected rows' data objects. */
  5626. getSelectedRowsData(mode: string): Array<any>;
  5627. /** Gets all visible columns. */
  5628. getVisibleColumns(): Array<dxTreeListColumn>;
  5629. /** Gets all visible columns at a specific hierarchical level of column headers. Use it to access banded columns. */
  5630. getVisibleColumns(headerLevel: number): Array<dxTreeListColumn>;
  5631. /** Gets currently rendered rows. */
  5632. getVisibleRows(): Array<dxTreeListRowObject>;
  5633. /** Checks whether a row is expanded or collapsed. */
  5634. isRowExpanded(key: any): boolean;
  5635. /** Loads all root node descendants (all data items). Takes effect only if data has the plain structure and remoteOperations | filtering is true. */
  5636. loadDescendants(): Promise<void> & JQueryPromise<void>;
  5637. /** Loads a specific node's descendants. Takes effect only if data has the plain structure and remoteOperations | filtering is true. */
  5638. loadDescendants(keys: Array<any>): Promise<void> & JQueryPromise<void>;
  5639. /** Loads all or only direct descendants of specific nodes. Takes effect only if data has the plain structure and remoteOperations | filtering is true. */
  5640. loadDescendants(keys: Array<any>, childrenOnly: boolean): Promise<void> & JQueryPromise<void>;
  5641. }
  5642. export interface dxTreeListColumn extends GridBaseColumn {
  5643. /** Allows you to customize buttons in the editing column or create a custom command column. Applies only if the column's type is "buttons". */
  5644. buttons?: Array<'add' | 'cancel' | 'delete' | 'edit' | 'save' | 'undelete' | dxTreeListColumnButton>;
  5645. /** Configures columns. */
  5646. columns?: Array<dxTreeListColumn | string>;
  5647. /** Specifies the command column that this object customizes. */
  5648. type?: 'adaptive' | 'buttons';
  5649. }
  5650. /** Allows you to customize buttons in the editing column or create a custom command column. Applies only if the column's type is "buttons". */
  5651. export interface dxTreeListColumnButton extends GridBaseColumnButton {
  5652. /** The name used to identify a built-in button. */
  5653. name?: 'add' | 'cancel' | 'delete' | 'edit' | 'save' | 'undelete' | string;
  5654. /** A function that is executed when the button is clicked or tapped. */
  5655. onClick?: ((e: { component?: dxTreeList, element?: DevExpress.core.dxElement, model?: any, event?: event, row?: dxTreeListRowObject, column?: dxTreeListColumn }) => any) | string;
  5656. /** Specifies a custom button template. */
  5657. template?: template | ((cellElement: DevExpress.core.dxElement, cellInfo: { component?: dxTreeList, data?: any, key?: any, columnIndex?: number, column?: dxTreeListColumn, rowIndex?: number, rowType?: string, row?: dxTreeListRowObject }) => string | Element | JQuery);
  5658. /** Specifies the button's visibility. */
  5659. visible?: boolean | ((options: { component?: dxTreeList, row?: dxTreeListRowObject, column?: dxTreeListColumn }) => boolean);
  5660. }
  5661. /** A TreeList node's structure. */
  5662. export interface dxTreeListNode {
  5663. /** Contains all child nodes. */
  5664. children?: Array<dxTreeListNode>;
  5665. /** The node's data object. */
  5666. data?: any;
  5667. /** Indicates whether the node has child nodes. */
  5668. hasChildren?: boolean;
  5669. /** The node's key. */
  5670. key?: any;
  5671. /** The node's hierarchical level. */
  5672. level?: number;
  5673. /** The parent node. */
  5674. parent?: dxTreeListNode;
  5675. /** Indicates whether the node is visualized as a row. */
  5676. visible?: boolean;
  5677. }
  5678. /** The TreeList row object's structure. */
  5679. export interface dxTreeListRowObject {
  5680. /** Indicates whether the row is in the editing state. */
  5681. isEditing?: boolean;
  5682. /** Indicates whether the row is expanded or collapsed. Available if rowType is "data" or "detail". */
  5683. isExpanded?: boolean;
  5684. /** Indicates that the row is added, but not yet saved. */
  5685. isNewRow?: boolean;
  5686. /** Indicates whether the row is selected. Available if rowType is "data" or "detail". */
  5687. isSelected?: boolean;
  5688. /** The row's key. Available if rowType is "data", "detail" or "detailAdaptive". */
  5689. key?: any;
  5690. /** The row's hierarchical level. Available if rowType is "data" or "detail". */
  5691. level?: number;
  5692. /** The row's node. Available if rowType is "data" or "detail". */
  5693. node?: dxTreeListNode;
  5694. /** The row's visible index. This index is zero-based and available if rowType is "data", "detail" or "detailAdaptive". */
  5695. rowIndex?: number;
  5696. /** The row's type. */
  5697. rowType?: string;
  5698. /** Values displayed in the row's cells. */
  5699. values?: Array<any>;
  5700. }
  5701. export interface dxTreeViewOptions extends HierarchicalCollectionWidgetOptions<dxTreeView>, SearchBoxMixinOptions<dxTreeView> {
  5702. /** Specifies whether or not to animate item collapsing and expanding. */
  5703. animationEnabled?: boolean;
  5704. /** Allows you to load nodes on demand. */
  5705. createChildren?: ((parentNode: dxTreeViewNode) => Promise<any> | JQueryPromise<any> | Array<any>);
  5706. /** Notifies the widget of the used data structure. */
  5707. dataStructure?: 'plain' | 'tree';
  5708. /** Specifies whether or not a user can expand all tree view items by the "*" hot key. */
  5709. expandAllEnabled?: boolean;
  5710. /** Specifies the event on which to expand/collapse a node. */
  5711. expandEvent?: 'dblclick' | 'click';
  5712. /** Specifies whether or not all parent nodes of an initially expanded node are displayed expanded. */
  5713. expandNodesRecursive?: boolean;
  5714. /** Specifies which data source field specifies whether an item is expanded. */
  5715. expandedExpr?: string | Function;
  5716. /** Specifies the name of the data source item field whose value defines whether or not the corresponding node includes child nodes. */
  5717. hasItemsExpr?: string | Function;
  5718. /** An array of items displayed by the widget. */
  5719. items?: Array<dxTreeViewItem>;
  5720. /** A function that is executed when a collection item is clicked or tapped. */
  5721. onItemClick?: ((e: { component?: dxTreeView, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number | any, jQueryEvent?: JQueryEventObject, event?: event, node?: dxTreeViewNode }) => any);
  5722. /** A function that is executed when a tree view item is collapsed. */
  5723. onItemCollapsed?: ((e: { component?: dxTreeView, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, jQueryEvent?: JQueryEventObject, event?: event, node?: dxTreeViewNode }) => any);
  5724. /** A function that is executed when a collection item is right-clicked or pressed. */
  5725. onItemContextMenu?: ((e: { component?: dxTreeView, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number | any, jQueryEvent?: JQueryEventObject, event?: event, node?: dxTreeViewNode }) => any);
  5726. /** A function that is executed when a tree view item is expanded. */
  5727. onItemExpanded?: ((e: { component?: dxTreeView, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, jQueryEvent?: JQueryEventObject, event?: event, node?: dxTreeViewNode }) => any);
  5728. /** A function that is executed when a collection item has been held for a specified period. */
  5729. onItemHold?: ((e: { component?: dxTreeView, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, event?: event, node?: dxTreeViewNode }) => any);
  5730. /** A function that is executed after a collection item is rendered. */
  5731. onItemRendered?: ((e: { component?: dxTreeView, element?: DevExpress.core.dxElement, model?: any, itemData?: any, itemElement?: DevExpress.core.dxElement, itemIndex?: number, node?: dxTreeViewNode }) => any);
  5732. /** A function that is executed when a tree view item is selected or selection is canceled. */
  5733. onItemSelectionChanged?: ((e: { component?: dxTreeView, element?: DevExpress.core.dxElement, model?: any, node?: dxTreeViewNode, itemElement?: DevExpress.core.dxElement }) => any);
  5734. /** A function that is executed when the "Select All" check box value is changed. Applies only if showCheckBoxesMode is "selectAll" and selectionMode is "multiple". */
  5735. onSelectAllValueChanged?: ((e: { component?: dxTreeView, element?: DevExpress.core.dxElement, model?: any, value?: boolean }) => any);
  5736. /** A function that is executed when a tree view item is selected or selection is canceled. */
  5737. onSelectionChanged?: ((e: { component?: dxTreeView, element?: DevExpress.core.dxElement, model?: any }) => any);
  5738. /** Specifies the name of the data source item field for holding the parent key of the corresponding node. */
  5739. parentIdExpr?: string | Function;
  5740. /** Specifies the parent ID value of the root item. */
  5741. rootValue?: any;
  5742. /** A string value specifying available scrolling directions. */
  5743. scrollDirection?: 'both' | 'horizontal' | 'vertical';
  5744. /** Specifies the text displayed at the "Select All" check box. */
  5745. selectAllText?: string;
  5746. /** Specifies whether or not an item becomes selected if a user clicks it. */
  5747. selectByClick?: boolean;
  5748. /** Specifies whether or not to select nodes recursively. */
  5749. selectNodesRecursive?: boolean;
  5750. /** Specifies item selection mode. */
  5751. selectionMode?: 'multiple' | 'single';
  5752. /** Specifies the current check boxes display mode. */
  5753. showCheckBoxesMode?: 'none' | 'normal' | 'selectAll';
  5754. /** Enables the virtual mode in which nodes are loaded on demand. Use it to enhance the performance on large datasets. */
  5755. virtualModeEnabled?: boolean;
  5756. }
  5757. /** The TreeView widget is a tree-like representation of textual data. */
  5758. export class dxTreeView extends HierarchicalCollectionWidget {
  5759. constructor(element: Element, options?: dxTreeViewOptions)
  5760. constructor(element: JQuery, options?: dxTreeViewOptions)
  5761. /** Collapses all items. */
  5762. collapseAll(): void;
  5763. /** Collapses an item with a specific key. */
  5764. collapseItem(itemData: any): void;
  5765. /** Collapses an item found using its DOM node. */
  5766. collapseItem(itemElement: Element): void;
  5767. /** Collapses an item with a specific key. */
  5768. collapseItem(key: any): void;
  5769. /** Expands all items. If you load items on demand, this method expands only the loaded items. */
  5770. expandAll(): void;
  5771. /** Expands an item found using its data object. */
  5772. expandItem(itemData: any): void;
  5773. /** Expands an item found using its DOM node. */
  5774. expandItem(itemElement: Element): void;
  5775. /** Expands an item with a specific key. */
  5776. expandItem(key: any): void;
  5777. /** Gets all nodes. */
  5778. getNodes(): Array<dxTreeViewNode>;
  5779. /** Selects all items. */
  5780. selectAll(): void;
  5781. /** Selects an item found using its data object. */
  5782. selectItem(itemData: any): void;
  5783. /** Selects an item found using its DOM node. */
  5784. selectItem(itemElement: Element): void;
  5785. /** Selects an item with a specific key. */
  5786. selectItem(key: any): void;
  5787. /** Cancels the selection of all items. */
  5788. unselectAll(): void;
  5789. /** Cancels the selection of an item found using its data object. */
  5790. unselectItem(itemData: any): void;
  5791. /** Cancels the selection of an item found using its DOM node. */
  5792. unselectItem(itemElement: Element): void;
  5793. /** Cancels the selection of an item with a specific key. */
  5794. unselectItem(key: any): void;
  5795. /** Updates the tree view scrollbars according to the current size of the widget content. */
  5796. updateDimensions(): Promise<void> & JQueryPromise<void>;
  5797. }
  5798. /** This section lists the data source fields that are used in a default item template. */
  5799. export interface dxTreeViewItem extends CollectionWidgetItem {
  5800. /** Specifies whether or not the tree view item is displayed expanded. */
  5801. expanded?: boolean;
  5802. /** Specifies whether or not the tree view item has children. */
  5803. hasItems?: boolean;
  5804. /** Specifies the tree view item's icon. */
  5805. icon?: string;
  5806. /** Holds an array of tree view items. */
  5807. items?: Array<dxTreeViewItem>;
  5808. /** Holds the key of the parent item. */
  5809. parentId?: number | string;
  5810. /** Specifies whether or not the tree view item is displayed selected. */
  5811. selected?: boolean;
  5812. }
  5813. /** A TreeView node. */
  5814. export interface dxTreeViewNode {
  5815. /** Contains all the child nodes of the current node. */
  5816. children?: Array<dxTreeViewNode>;
  5817. /** Equals to true if the node is disabled; otherwise false. */
  5818. disabled?: boolean;
  5819. /** Equals true if the node is expanded; false if collapsed. */
  5820. expanded?: boolean;
  5821. /** Contains the data source object corresponding to the node. */
  5822. itemData?: any;
  5823. /** Contains the key value of the node. */
  5824. key?: any;
  5825. /** Refers to the parent node of the current node. */
  5826. parent?: dxTreeViewNode;
  5827. /** Equals to true if the node is selected; false if not. */
  5828. selected?: boolean;
  5829. /** Contains the text displayed by the node. */
  5830. text?: string;
  5831. }
  5832. export interface dxValidationGroupOptions extends DOMComponentOptions<dxValidationGroup> {
  5833. }
  5834. /** The ValidationGroup is a widget that allows you to validate several editors simultaneously. */
  5835. export class dxValidationGroup extends DOMComponent {
  5836. constructor(element: Element, options?: dxValidationGroupOptions)
  5837. constructor(element: JQuery, options?: dxValidationGroupOptions)
  5838. /** Resets the value and validation result of the editors that are included to the current validation group. */
  5839. reset(): void;
  5840. /** Validates rules of the validators that belong to the current validation group. */
  5841. validate(): dxValidationGroupResult;
  5842. }
  5843. /** A group validation result. */
  5844. export interface dxValidationGroupResult {
  5845. /** Rules that failed to pass the check. */
  5846. brokenRules?: Array<RequiredRule | NumericRule | RangeRule | StringLengthRule | CustomRule | CompareRule | PatternRule | EmailRule>;
  5847. /** Indicates whether all the rules checked for the group are satisfied. */
  5848. isValid?: boolean;
  5849. /** Validator widgets included in the validated group. */
  5850. validators?: Array<any>;
  5851. }
  5852. export interface dxValidationSummaryOptions extends CollectionWidgetOptions<dxValidationSummary> {
  5853. /** Specifies the validation group for which summary should be generated. */
  5854. validationGroup?: string;
  5855. }
  5856. /** A widget for displaying the result of checking validation rules for editors. */
  5857. export class dxValidationSummary extends CollectionWidget {
  5858. constructor(element: Element, options?: dxValidationSummaryOptions)
  5859. constructor(element: JQuery, options?: dxValidationSummaryOptions)
  5860. }
  5861. export interface dxValidatorOptions extends DOMComponentOptions<dxValidator> {
  5862. /** An object that specifies what and when to validate, and how to apply the validation result. */
  5863. adapter?: { applyValidationResults?: Function, bypass?: Function, focus?: Function, getValue?: Function, reset?: Function, validationRequestsCallbacks?: Array<Function> | JQueryCallback };
  5864. /** Specifies the editor name to be used in the validation default messages. */
  5865. name?: string;
  5866. /** A function that is executed after a value is validated. */
  5867. onValidated?: ((validatedInfo: { name?: string, isValid?: boolean, value?: any, validationRules?: Array<RequiredRule | NumericRule | RangeRule | StringLengthRule | CustomRule | CompareRule | PatternRule | EmailRule>, brokenRule?: RequiredRule | NumericRule | RangeRule | StringLengthRule | CustomRule | CompareRule | PatternRule | EmailRule }) => any);
  5868. /** Specifies the validation group the editor will be related to. */
  5869. validationGroup?: string;
  5870. /** An array of validation rules to be checked for the editor with which the dxValidator object is associated. */
  5871. validationRules?: Array<RequiredRule | NumericRule | RangeRule | StringLengthRule | CustomRule | CompareRule | PatternRule | EmailRule>;
  5872. }
  5873. /** A widget that is used to validate the associated DevExtreme editors against the defined validation rules. */
  5874. export class dxValidator extends DOMComponent {
  5875. constructor(element: Element, options?: dxValidatorOptions)
  5876. constructor(element: JQuery, options?: dxValidatorOptions)
  5877. /** Sets focus to the editor associated with the current Validator object. */
  5878. focus(): void;
  5879. /** Resets the value and validation result of the editor associated with the current Validator object. */
  5880. reset(): void;
  5881. /** Validates the value of the editor that is controlled by the current Validator object against the list of the specified validation rules. */
  5882. validate(): dxValidatorResult;
  5883. }
  5884. /** A validation result. */
  5885. export interface dxValidatorResult {
  5886. /** A rule that failed to pass the check. */
  5887. brokenRule?: RequiredRule | NumericRule | RangeRule | StringLengthRule | CustomRule | CompareRule | PatternRule | EmailRule;
  5888. /** Indicates whether all the checked rules are satisfied. */
  5889. isValid?: boolean;
  5890. /** Validation rules specified for the Validator. */
  5891. validationRules?: Array<RequiredRule | NumericRule | RangeRule | StringLengthRule | CustomRule | CompareRule | PatternRule | EmailRule>;
  5892. /** The value being validated. */
  5893. value?: any;
  5894. }
  5895. /** Formats values. */
  5896. export type format = 'billions' | 'currency' | 'day' | 'decimal' | 'exponential' | 'fixedPoint' | 'largeNumber' | 'longDate' | 'longTime' | 'millions' | 'millisecond' | 'month' | 'monthAndDay' | 'monthAndYear' | 'percent' | 'quarter' | 'quarterAndYear' | 'shortDate' | 'shortTime' | 'thousands' | 'trillions' | 'year' | 'dayOfWeek' | 'hour' | 'longDateLongTime' | 'minute' | 'second' | 'shortDateShortTime' | string | ((value: number | Date) => string) | { currency?: string, formatter?: ((value: number | Date) => string), parser?: ((value: string) => number | Date), precision?: number, type?: 'billions' | 'currency' | 'day' | 'decimal' | 'exponential' | 'fixedPoint' | 'largeNumber' | 'longDate' | 'longTime' | 'millions' | 'millisecond' | 'month' | 'monthAndDay' | 'monthAndYear' | 'percent' | 'quarter' | 'quarterAndYear' | 'shortDate' | 'shortTime' | 'thousands' | 'trillions' | 'year' | 'dayOfWeek' | 'hour' | 'longDateLongTime' | 'minute' | 'second' | 'shortDateShortTime' };
  5897. /** A template notation used to specify templates for widget elements. */
  5898. export type template = string | Function | Element | JQuery;
  5899. /** An object that serves as a namespace for methods displaying a message in an application/site. */
  5900. export class dialog {
  5901. /** Displays an alert dialog with a message and OK button. */
  5902. static alert(messageHtml: string, title: string): Promise<void> & JQueryPromise<void>;
  5903. /** Creates a confirmation dialog with a message and Yes and No buttons. */
  5904. static confirm(messageHtml: string, title: string): Promise<boolean> & JQueryPromise<boolean>;
  5905. /** Creates a dialog with custom buttons. */
  5906. static custom(options: { title?: string, messageHtml?: string, buttons?: Array<dxButtonOptions>, showTitle?: boolean, message?: string, dragEnabled?: boolean }): any;
  5907. }
  5908. /** An object that serves as a namespace for the methods that work with DevExtreme CSS Themes. */
  5909. export class themes {
  5910. /** Gets the current theme's name. */
  5911. static current(): string;
  5912. /** Sets a theme with a specific name. */
  5913. static current(themeName: string): void;
  5914. /** Specifies a function to be executed after the theme is loaded. */
  5915. static ready(callback: Function): void;
  5916. }
  5917. }
  5918. declare module DevExpress.ui.dxOverlay {
  5919. /** Specifies the base z-index for all overlay widgets. */
  5920. export function baseZIndex(zIndex: number): void;
  5921. }
  5922. declare module DevExpress.utils {
  5923. /** Cancels an animation frame request scheduled with the requestAnimationFrame method. */
  5924. export function cancelAnimationFrame(requestID: number): void;
  5925. /** Sets parameters for the viewport meta tag. Takes effect for mobile applications only. */
  5926. export function initMobileViewport(options: { allowZoom?: boolean, allowPan?: boolean, allowSelection?: boolean }): void;
  5927. /** Makes the browser call a function to update animation before the next repaint. */
  5928. export function requestAnimationFrame(callback: Function): number;
  5929. }
  5930. declare module DevExpress.viz {
  5931. /** An object that provides information about a bar in the BarGauge widget. */
  5932. export interface BarGaugeBarInfo {
  5933. /** The bar's hexadecimal color code. */
  5934. color?: string;
  5935. /** The bar's zero-based index. Bars closest to the gauge's center have higher indexes. */
  5936. index?: number;
  5937. /** The bar's value. */
  5938. value?: number;
  5939. }
  5940. /** An object that provides information about a legend item in the BarGauge widget. */
  5941. export interface BarGaugeLegendItem {
  5942. /** The bar that the legend item represents. */
  5943. item?: BarGaugeBarInfo;
  5944. /** The text that the legend item displays. */
  5945. text?: string;
  5946. /** Indicates and specifies whether the legend item is visible. */
  5947. visible?: boolean;
  5948. }
  5949. export interface BaseChartOptions<T = BaseChart> extends BaseWidgetOptions<T> {
  5950. /** Specifies adaptive layout options. */
  5951. adaptiveLayout?: BaseChartAdaptiveLayout;
  5952. /** Specifies animation options. */
  5953. animation?: { duration?: number, easing?: 'easeOutCubic' | 'linear', enabled?: boolean, maxPointCountSupported?: number } | boolean;
  5954. /** Customizes the appearance of an individual point label. */
  5955. customizeLabel?: ((pointInfo: any) => dxChartSeriesTypesCommonSeriesLabel);
  5956. /** Customizes the appearance of an individual series point. */
  5957. customizePoint?: ((pointInfo: any) => dxChartSeriesTypesCommonSeriesPoint);
  5958. /** Binds the widget to data. */
  5959. dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string;
  5960. /** Specifies options of the legend. */
  5961. legend?: BaseChartLegend;
  5962. /** A function that is executed when all series are ready. */
  5963. onDone?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  5964. /** A function that is executed when a series point is clicked or tapped. */
  5965. onPointClick?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, target?: basePointObject }) => any) | string;
  5966. /** A function that is executed after the pointer enters or leaves a series point. */
  5967. onPointHoverChanged?: ((e: { component?: any, element?: any, target?: basePointObject }) => any);
  5968. /** A function that is executed when a series point is selected or selection is canceled. */
  5969. onPointSelectionChanged?: ((e: { component?: any, element?: any, target?: basePointObject }) => any);
  5970. /** A function that is executed when a tooltip becomes hidden. */
  5971. onTooltipHidden?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, target?: basePointObject | dxChartAnnotationConfig | any }) => any);
  5972. /** A function that is executed when a tooltip appears. */
  5973. onTooltipShown?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, target?: basePointObject | dxChartAnnotationConfig | any }) => any);
  5974. /** Sets the palette to be used for colorizing series and their elements. */
  5975. palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office';
  5976. /** Specifies what to do with colors in the palette when their number is less than the number of series (in the Chart widget) or points in a series (in the PieChart widget). */
  5977. paletteExtensionMode?: 'alternate' | 'blend' | 'extrapolate';
  5978. /** Specifies whether a single point or multiple points can be selected in the chart. */
  5979. pointSelectionMode?: 'multiple' | 'single';
  5980. /** Specifies options for series. */
  5981. series?: any | Array<any>;
  5982. /** Configures tooltips. */
  5983. tooltip?: BaseChartTooltip;
  5984. }
  5985. /** Specifies adaptive layout options. */
  5986. interface BaseChartAdaptiveLayout {
  5987. /** Specifies the minimum container height at which the layout begins to adapt. */
  5988. height?: number;
  5989. /** Specifies whether point labels should be kept when the widget adapts the layout. */
  5990. keepLabels?: boolean;
  5991. /** Specifies the minimum container width at which the layout begins to adapt. */
  5992. width?: number;
  5993. }
  5994. /** Specifies options of the legend. */
  5995. interface BaseChartLegend extends BaseLegend {
  5996. /** Allows you to change the order, text, and visibility of legend items. */
  5997. customizeItems?: ((items: Array<BaseChartLegendItem>) => Array<BaseChartLegendItem>);
  5998. }
  5999. /** Configures tooltips. */
  6000. interface BaseChartTooltip extends BaseWidgetTooltip {
  6001. /** Formats the point argument before it is displayed in the tooltip. To format the point value, use the format option. */
  6002. argumentFormat?: DevExpress.ui.format;
  6003. /** Allows you to change tooltip appearance. */
  6004. customizeTooltip?: ((pointInfo: any) => any);
  6005. }
  6006. /** A base class for all chart widgets included in the ChartJS library. */
  6007. export class BaseChart extends BaseWidget {
  6008. constructor(element: Element, options?: BaseChartOptions)
  6009. constructor(element: JQuery, options?: BaseChartOptions)
  6010. /** Deselects the chart's selected series. The series is displayed in an initial style. */
  6011. clearSelection(): void;
  6012. /** Gets all the series. */
  6013. getAllSeries(): Array<baseSeriesObject>;
  6014. /** Gets the DataSource instance. */
  6015. getDataSource(): DevExpress.data.DataSource;
  6016. /** Gets a series with a specific name. */
  6017. getSeriesByName(seriesName: any): chartSeriesObject;
  6018. /** Gets a series with a specific index. */
  6019. getSeriesByPos(seriesIndex: number): chartSeriesObject;
  6020. /** Hides all widget tooltips. */
  6021. hideTooltip(): void;
  6022. /** Reloads data and repaints the widget. */
  6023. refresh(): void;
  6024. /** Redraws the widget. */
  6025. render(): void;
  6026. /** Redraws the widget. */
  6027. render(renderOptions: any): void;
  6028. }
  6029. /** An object that provides information about a legend item in the Chart and PolarChart widgets. */
  6030. export interface BaseChartLegendItem {
  6031. /** The series that the item represents on the legend. */
  6032. series?: baseSeriesObject;
  6033. /** The text that the legend item displays. */
  6034. text?: string;
  6035. /** Indicates and specifies whether the legend item is visible. */
  6036. visible?: boolean;
  6037. }
  6038. export interface BaseGaugeOptions<T = BaseGauge> extends BaseWidgetOptions<T> {
  6039. /** Specifies animation options. */
  6040. animation?: BaseGaugeAnimation;
  6041. /** Specifies the color of the parent page element. */
  6042. containerBackgroundColor?: string;
  6043. /** Configures the loading indicator. */
  6044. loadingIndicator?: BaseGaugeLoadingIndicator;
  6045. /** A function that is executed when a tooltip becomes hidden. */
  6046. onTooltipHidden?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, target?: any }) => any);
  6047. /** A function that is executed when a tooltip appears. */
  6048. onTooltipShown?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, target?: any }) => any);
  6049. /** Specifies options of the gauge's range container. */
  6050. rangeContainer?: BaseGaugeRangeContainer;
  6051. /** Specifies options of the gauge's scale. */
  6052. scale?: BaseGaugeScale;
  6053. /** Specifies a set of subvalues to be designated by the subvalue indicators. */
  6054. subvalues?: Array<number>;
  6055. /** Configures tooltips. */
  6056. tooltip?: BaseGaugeTooltip;
  6057. /** Specifies the main value on a gauge. */
  6058. value?: number;
  6059. }
  6060. /** Specifies animation options. */
  6061. interface BaseGaugeAnimation {
  6062. /** Determines how long animation runs. */
  6063. duration?: number;
  6064. /** Specifies the animation easing mode. */
  6065. easing?: 'easeOutCubic' | 'linear';
  6066. /** Indicates whether or not animation is enabled. */
  6067. enabled?: boolean;
  6068. }
  6069. /** Configures the loading indicator. */
  6070. interface BaseGaugeLoadingIndicator extends BaseWidgetLoadingIndicator {
  6071. }
  6072. /** Specifies options of the gauge's range container. */
  6073. interface BaseGaugeRangeContainer {
  6074. /** Specifies a range container's background color. */
  6075. backgroundColor?: string;
  6076. /** Specifies the offset of the range container from an invisible scale line in pixels. */
  6077. offset?: number;
  6078. /** Specifies the palette to be used for colorizing ranges in the range container. */
  6079. palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office';
  6080. /** Specifies what to do with colors in the palette when their number is less than the number of ranges in the range container. */
  6081. paletteExtensionMode?: 'alternate' | 'blend' | 'extrapolate';
  6082. /** An array of objects representing ranges contained in the range container. */
  6083. ranges?: Array<{ color?: string, endValue?: number, startValue?: number }>;
  6084. }
  6085. /** Specifies options of the gauge's scale. */
  6086. interface BaseGaugeScale {
  6087. /** Specifies whether to allow decimal values on the scale. When false, the scale contains integer values only. */
  6088. allowDecimals?: boolean;
  6089. /** Specifies an array of custom minor ticks. */
  6090. customMinorTicks?: Array<number>;
  6091. /** Specifies an array of custom major ticks. */
  6092. customTicks?: Array<number>;
  6093. /** Specifies the end value for the scale of the gauge. */
  6094. endValue?: number;
  6095. /** Specifies common options for scale labels. */
  6096. label?: BaseGaugeScaleLabel;
  6097. /** Specifies options of the gauge's minor ticks. */
  6098. minorTick?: { color?: string, length?: number, opacity?: number, visible?: boolean, width?: number };
  6099. /** Specifies an interval between minor ticks. */
  6100. minorTickInterval?: number;
  6101. /** Specifies the minimum distance between two neighboring major ticks in pixels. */
  6102. scaleDivisionFactor?: number;
  6103. /** Specifies the start value for the scale of the gauge. */
  6104. startValue?: number;
  6105. /** Specifies options of the gauge's major ticks. */
  6106. tick?: { color?: string, length?: number, opacity?: number, visible?: boolean, width?: number };
  6107. /** Specifies an interval between major ticks. */
  6108. tickInterval?: number;
  6109. }
  6110. /** Specifies common options for scale labels. */
  6111. interface BaseGaugeScaleLabel {
  6112. /** Specifies a callback function that returns the text to be displayed in scale labels. */
  6113. customizeText?: ((scaleValue: { value?: number, valueText?: string }) => string);
  6114. /** Specifies font options for the text displayed in the scale labels of the gauge. */
  6115. font?: Font;
  6116. /** Formats a value before it is displayed in a scale label. Accepts only numeric formats. */
  6117. format?: DevExpress.ui.format;
  6118. /** Decides how to arrange scale labels when there is not enough space to keep all of them. */
  6119. overlappingBehavior?: 'hide' | 'none';
  6120. /** Specifies whether or not scale labels should be colored similarly to their corresponding ranges in the range container. */
  6121. useRangeColors?: boolean;
  6122. /** Specifies whether or not scale labels are visible on the gauge. */
  6123. visible?: boolean;
  6124. }
  6125. /** Configures tooltips. */
  6126. interface BaseGaugeTooltip extends BaseWidgetTooltip {
  6127. /** Allows you to change the appearance of specified tooltips. */
  6128. customizeTooltip?: ((scaleValue: { value?: number, valueText?: string }) => any);
  6129. }
  6130. /** A gauge widget. */
  6131. export class BaseGauge extends BaseWidget {
  6132. constructor(element: Element, options?: BaseGaugeOptions)
  6133. constructor(element: JQuery, options?: BaseGaugeOptions)
  6134. /** Gets subvalues. */
  6135. subvalues(): Array<number>;
  6136. /** Updates subvalues. */
  6137. subvalues(subvalues: Array<number>): void;
  6138. /** Gets the main value. */
  6139. value(): number;
  6140. /** Updates the main value. */
  6141. value(value: number): void;
  6142. }
  6143. export interface BaseLegend {
  6144. /** Colors the legend's background. */
  6145. backgroundColor?: string;
  6146. /** Configures the legend's border. */
  6147. border?: { color?: string, cornerRadius?: number, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', opacity?: number, visible?: boolean, width?: number };
  6148. /** Arranges legend items into several columns. */
  6149. columnCount?: number;
  6150. /** Specifies an empty space between item columns in pixels. */
  6151. columnItemSpacing?: number;
  6152. /** Specifies the legend items' font options. */
  6153. font?: Font;
  6154. /** Along with verticalAlignment, specifies the legend's position. */
  6155. horizontalAlignment?: 'center' | 'left' | 'right';
  6156. /** Specifies the text's position relative to the marker in a legend item. */
  6157. itemTextPosition?: 'bottom' | 'left' | 'right' | 'top';
  6158. /** Aligns items in the last column or row (depending on the legend's orientation). Applies when legend items are not divided into columns or rows equally. */
  6159. itemsAlignment?: 'center' | 'left' | 'right';
  6160. /** Generates an empty space, measured in pixels, around the legend. */
  6161. margin?: number | { bottom?: number, left?: number, right?: number, top?: number };
  6162. /** Specifies the marker's size in a legend item in pixels. */
  6163. markerSize?: number;
  6164. /** Arranges legend items vertically (in a column) or horizontally (in a row). The default value is "horizontal" if the legend.horizontalAlignment is "center". Otherwise, it is "vertical". */
  6165. orientation?: 'horizontal' | 'vertical';
  6166. /** Generates an empty space, measured in pixels, between the legend's left/right border and its items. */
  6167. paddingLeftRight?: number;
  6168. /** Generates an empty space, measured in pixels, between the legend's top/bottom border and its items. */
  6169. paddingTopBottom?: number;
  6170. /** Arranges legend items in several rows. */
  6171. rowCount?: number;
  6172. /** Specifies an empty space between item rows in pixels. */
  6173. rowItemSpacing?: number;
  6174. /** Configures the legend title. */
  6175. title?: { font?: Font, horizontalAlignment?: 'center' | 'left' | 'right', margin?: { bottom?: number, left?: number, right?: number, top?: number }, placeholderSize?: number, subtitle?: { font?: Font, offset?: number, text?: string } | string, text?: string, verticalAlignment?: 'bottom' | 'top' } | string;
  6176. /** Along with horizontalAlignment, specifies the legend's position. */
  6177. verticalAlignment?: 'bottom' | 'top';
  6178. /** Specifies the legend's visibility. */
  6179. visible?: boolean;
  6180. }
  6181. export interface BaseSparklineOptions<T = BaseSparkline> extends BaseWidgetOptions<T> {
  6182. /** A function that is executed when a tooltip becomes hidden. */
  6183. onTooltipHidden?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  6184. /** A function that is executed when a tooltip appears. */
  6185. onTooltipShown?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  6186. /** Configures the tooltip. */
  6187. tooltip?: BaseSparklineTooltip;
  6188. }
  6189. /** Configures the tooltip. */
  6190. interface BaseSparklineTooltip extends BaseWidgetTooltip {
  6191. /** Allows you to change tooltip appearance. */
  6192. customizeTooltip?: ((pointsInfo: any) => any);
  6193. /** Enables tooltips. */
  6194. enabled?: boolean;
  6195. }
  6196. /** Overridden by descriptions for particular widgets. */
  6197. export class BaseSparkline extends BaseWidget {
  6198. constructor(element: Element, options?: BaseSparklineOptions)
  6199. constructor(element: JQuery, options?: BaseSparklineOptions)
  6200. }
  6201. export interface BaseWidgetOptions<T = BaseWidget> extends DOMComponentOptions<T> {
  6202. /** Specifies whether the widget responds to the user interaction. */
  6203. disabled?: boolean;
  6204. /** Configures the exporting and printing features. */
  6205. export?: BaseWidgetExport;
  6206. /** Configures the loading indicator. */
  6207. loadingIndicator?: BaseWidgetLoadingIndicator;
  6208. /** Generates space around the widget. */
  6209. margin?: BaseWidgetMargin;
  6210. /** A function that is executed when the widget's rendering has finished. */
  6211. onDrawn?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  6212. /** A function that is executed after the widget is exported. */
  6213. onExported?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any }) => any);
  6214. /** A function that is executed before the widget is exported. */
  6215. onExporting?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, fileName?: string, cancel?: boolean, format?: string }) => any);
  6216. /** A function that is executed before a file with exported widget is saved to the user's local storage. */
  6217. onFileSaving?: ((e: { component?: T, element?: DevExpress.core.dxElement, fileName?: string, format?: string, data?: Blob, cancel?: boolean }) => any);
  6218. /** A function that is executed when an error or warning occurs. */
  6219. onIncidentOccurred?: ((e: { component?: T, element?: DevExpress.core.dxElement, model?: any, target?: any }) => any);
  6220. /** Notifies the widget that it is embedded into an HTML page that uses a tag modifying the path. */
  6221. pathModified?: boolean;
  6222. /** Specifies whether to redraw the widget when the size of the parent browser window changes or a mobile device rotates. */
  6223. redrawOnResize?: boolean;
  6224. /** Switches the widget to a right-to-left representation. */
  6225. rtlEnabled?: boolean;
  6226. /** Specifies the widget's size in pixels. */
  6227. size?: BaseWidgetSize;
  6228. /** Sets the name of the theme the widget uses. */
  6229. theme?: 'generic.dark' | 'generic.light' | 'generic.contrast' | 'ios7.default' | 'generic.carmine' | 'generic.darkmoon' | 'generic.darkviolet' | 'generic.greenmist' | 'generic.softblue' | 'material.blue.light' | 'material.lime.light' | 'material.orange.light' | 'material.purple.light' | 'material.teal.light';
  6230. /** Configures the widget's title. */
  6231. title?: BaseWidgetTitle | string;
  6232. /** Configures tooltips - small pop-up rectangles that display information about a data-visualizing widget element being pressed or hovered over with the mouse pointer. */
  6233. tooltip?: BaseWidgetTooltip;
  6234. }
  6235. /** Configures the exporting and printing features. */
  6236. interface BaseWidgetExport {
  6237. /** Specifies the color that will fill transparent regions in the resulting file or document. */
  6238. backgroundColor?: string;
  6239. /** Enables the client-side exporting in the widget. */
  6240. enabled?: boolean;
  6241. /** Specifies a default name for the file to which the widget will be exported. */
  6242. fileName?: string;
  6243. /** Specifies a set of export formats. */
  6244. formats?: Array<'GIF' | 'JPEG' | 'PDF' | 'PNG' | 'SVG'>;
  6245. /** Adds an empty space around the exported widget; measured in pixels. */
  6246. margin?: number;
  6247. /** Enables the printing feature in the widget. Applies only if the export.enabled option is true. */
  6248. printingEnabled?: boolean;
  6249. /** Specifies the URL of the server-side proxy that streams the resulting file to the end user to enable exporting in the Safari browser. */
  6250. proxyUrl?: string;
  6251. }
  6252. /** Configures the loading indicator. */
  6253. interface BaseWidgetLoadingIndicator {
  6254. /** Colors the background of the loading indicator. */
  6255. backgroundColor?: string;
  6256. /** Specifies whether the loading indicator should be displayed and hidden automatically. */
  6257. enabled?: boolean;
  6258. /** Specifies font options for the loading indicator. */
  6259. font?: Font;
  6260. /** Allows you to change the loading indicator's visibility. */
  6261. show?: boolean;
  6262. /** Specifies the text to be displayed by the loading indicator. */
  6263. text?: string;
  6264. }
  6265. /** Generates space around the widget. */
  6266. interface BaseWidgetMargin {
  6267. /** Specifies the bottom margin of the widget in pixels. */
  6268. bottom?: number;
  6269. /** Specifies the left margin of the widget in pixels. */
  6270. left?: number;
  6271. /** Specifies the right margin of the widget in pixels. */
  6272. right?: number;
  6273. /** Specifies the top margin of the widget in pixels. */
  6274. top?: number;
  6275. }
  6276. /** Specifies the widget's size in pixels. */
  6277. interface BaseWidgetSize {
  6278. /** Specifies the height of the widget in pixels. */
  6279. height?: number;
  6280. /** Specifies the width of the widget in pixels. */
  6281. width?: number;
  6282. }
  6283. /** Configures the widget's title. */
  6284. interface BaseWidgetTitle {
  6285. /** Specifies font options for the title. */
  6286. font?: Font;
  6287. /** Specifies the title's alignment in a horizontal direction. */
  6288. horizontalAlignment?: 'center' | 'left' | 'right';
  6289. /** Generates space around the title. */
  6290. margin?: number | { bottom?: number, left?: number, right?: number, top?: number };
  6291. /** Reserves a pixel-measured space for the title. */
  6292. placeholderSize?: number;
  6293. /** Configures the widget's subtitle. */
  6294. subtitle?: { font?: Font, offset?: number, text?: string, textOverflow?: 'ellipsis' | 'hide' | 'none', wordWrap?: 'normal' | 'breakWord' | 'none' } | string;
  6295. /** Specifies the title's text. */
  6296. text?: string;
  6297. /** Specifies what to do with the title when it overflows the allocated space after applying wordWrap: hide, truncate it and display an ellipsis, or do nothing. */
  6298. textOverflow?: 'ellipsis' | 'hide' | 'none';
  6299. /** Specifies the title's alignment in a vertical direction. */
  6300. verticalAlignment?: 'bottom' | 'top';
  6301. /** Specifies how to wrap the title if it does not fit into a single line. */
  6302. wordWrap?: 'normal' | 'breakWord' | 'none';
  6303. }
  6304. /** Configures tooltips - small pop-up rectangles that display information about a data-visualizing widget element being pressed or hovered over with the mouse pointer. */
  6305. interface BaseWidgetTooltip {
  6306. /** Specifies the length of a tooltip's arrow in pixels. */
  6307. arrowLength?: number;
  6308. /** Configures a tooltip's border. */
  6309. border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', opacity?: number, visible?: boolean, width?: number };
  6310. /** Colors all tooltips. */
  6311. color?: string;
  6312. /** Specifies the container in which to draw tooltips. The default container is the HTML DOM `` element. */
  6313. container?: string | Element | JQuery;
  6314. /** Makes all the tooltip's corners rounded. */
  6315. cornerRadius?: number;
  6316. /** Enables tooltips. */
  6317. enabled?: boolean;
  6318. /** Specifies tooltips' font options. */
  6319. font?: Font;
  6320. /** Formats a value before it is displayed it in a tooltip. */
  6321. format?: DevExpress.ui.format;
  6322. /** Specifies tooltips' transparency. */
  6323. opacity?: number;
  6324. /** Generates an empty space, measured in pixels, between a tooltip's left/right border and its text. */
  6325. paddingLeftRight?: number;
  6326. /** Generates an empty space, measured in pixels, between a tooltip's top/bottom border and its text. */
  6327. paddingTopBottom?: number;
  6328. /** Configures a tooltip's shadow. */
  6329. shadow?: { blur?: number, color?: string, offsetX?: number, offsetY?: number, opacity?: number };
  6330. /** Specifies a tooltip's z-index. */
  6331. zIndex?: number;
  6332. }
  6333. /** This section describes options and methods that are common to all widgets. */
  6334. export class BaseWidget extends DOMComponent {
  6335. constructor(element: Element, options?: BaseWidgetOptions)
  6336. constructor(element: JQuery, options?: BaseWidgetOptions)
  6337. /** Exports the widget. */
  6338. exportTo(fileName: string, format: string): void;
  6339. /** Gets the current widget size. */
  6340. getSize(): BaseWidgetSize;
  6341. /** Hides the loading indicator. */
  6342. hideLoadingIndicator(): void;
  6343. /** Opens the browser's print window. */
  6344. print(): void;
  6345. /** Redraws the widget. */
  6346. render(): void;
  6347. /** Shows the loading indicator. */
  6348. showLoadingIndicator(): void;
  6349. /** Gets the widget's SVG markup. */
  6350. svg(): string;
  6351. }
  6352. /** Specifies options for Chart widget series. */
  6353. export interface ChartSeries extends dxChartSeriesTypesCommonSeries {
  6354. /** Specifies the name that identifies the series. */
  6355. name?: string;
  6356. /** Specifies data about a series. */
  6357. tag?: any;
  6358. /** Sets the series type. */
  6359. type?: 'area' | 'bar' | 'bubble' | 'candlestick' | 'fullstackedarea' | 'fullstackedbar' | 'fullstackedline' | 'fullstackedspline' | 'fullstackedsplinearea' | 'line' | 'rangearea' | 'rangebar' | 'scatter' | 'spline' | 'splinearea' | 'stackedarea' | 'stackedbar' | 'stackedline' | 'stackedspline' | 'stackedsplinearea' | 'steparea' | 'stepline' | 'stock';
  6360. }
  6361. /** A base object for gauge value and subvalue indicators. Includes the options of indicators of all types. */
  6362. export interface CommonIndicator {
  6363. /** Specifies the length of an arrow for the indicator of the textCloud type in pixels. */
  6364. arrowLength?: number;
  6365. /** Specifies the background color for the indicator of the rangeBar type. */
  6366. backgroundColor?: string;
  6367. /** Specifies the base value for the indicator of the rangeBar type. */
  6368. baseValue?: number;
  6369. /** Specifies a radius small enough for the indicator to begin adapting. */
  6370. beginAdaptingAtRadius?: number;
  6371. /** Specifies a color of the indicator. */
  6372. color?: string;
  6373. /** Specifies the orientation of the rangeBar indicator. Applies only if the geometry.orientation option is "vertical". */
  6374. horizontalOrientation?: 'left' | 'right';
  6375. /** Specifies the distance between the needle and the center of a gauge for the indicator of a needle-like type. */
  6376. indentFromCenter?: number;
  6377. /** Specifies the indicator length. */
  6378. length?: number;
  6379. /** Specifies the distance between the indicator and the invisible scale line. */
  6380. offset?: number;
  6381. /** Sets the palette to be used to colorize indicators differently. */
  6382. palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office';
  6383. /** Specifies the second color for the indicator of the twoColorNeedle type. */
  6384. secondColor?: string;
  6385. /** Specifies the length of a twoNeedleColor type indicator tip as a percentage. */
  6386. secondFraction?: number;
  6387. /** Specifies the range bar size for an indicator of the rangeBar type. */
  6388. size?: number;
  6389. /** Specifies the inner diameter in pixels, so that the spindle has the shape of a ring. */
  6390. spindleGapSize?: number;
  6391. /** Specifies the spindle's diameter in pixels for the indicator of a needle-like type. */
  6392. spindleSize?: number;
  6393. /** Specifies the appearance of the text displayed in an indicator of the rangeBar type. */
  6394. text?: { customizeText?: ((indicatedValue: { value?: number, valueText?: string }) => string), font?: Font, format?: DevExpress.ui.format, indent?: number };
  6395. /** Specifies the orientation of the rangeBar indicator. Applies only if the geometry.orientation option is "horizontal". */
  6396. verticalOrientation?: 'bottom' | 'top';
  6397. /** Specifies the width of an indicator in pixels. */
  6398. width?: number;
  6399. }
  6400. /** Font options. */
  6401. export interface Font {
  6402. /** Specifies font color. */
  6403. color?: string;
  6404. /** Specifies font family. */
  6405. family?: string;
  6406. /** Specifies font opacity. */
  6407. opacity?: number;
  6408. /** Specifies font size. */
  6409. size?: string | number;
  6410. /** Specifies font weight. Accepts values from 100 to 900 in increments of 100. Higher values increase boldness. */
  6411. weight?: number;
  6412. }
  6413. /** An object that provides information about a legend item in the Funnel widget. */
  6414. export interface FunnelLegendItem {
  6415. /** The funnel item that the legend item represents. */
  6416. item?: dxFunnelItem;
  6417. /** The text that the legend item displays. */
  6418. text?: string;
  6419. /** Indicates and specifies whether the legend item is visible. */
  6420. visible?: boolean;
  6421. }
  6422. export interface GaugeIndicator extends CommonIndicator {
  6423. /** Specifies the type of gauge indicators. */
  6424. type?: 'circle' | 'rangeBar' | 'rectangle' | 'rectangleNeedle' | 'rhombus' | 'textCloud' | 'triangleMarker' | 'triangleNeedle' | 'twoColorNeedle';
  6425. }
  6426. /** This section describes the Layer object, which represents a vector map layer. */
  6427. export class MapLayer {
  6428. /** The type of the layer elements. */
  6429. elementType: string;
  6430. /** The layer index in the layers array. */
  6431. index: number;
  6432. /** The name of the layer. */
  6433. name: string;
  6434. /** The layer type. Can be "area", "line" or "marker". */
  6435. type: string;
  6436. /** Deselects all layer elements. */
  6437. clearSelection(): void;
  6438. /** Returns the DataSource instance. */
  6439. getDataSource(): DevExpress.data.DataSource;
  6440. /** Gets all layer elements. */
  6441. getElements(): Array<MapLayerElement>;
  6442. }
  6443. /** This section describes the Layer Element object, which represents a vector map layer element. */
  6444. export class MapLayerElement {
  6445. /** The parent layer of the layer element. */
  6446. layer: any;
  6447. /** Applies the layer element settings and updates element appearance. */
  6448. applySettings(settings: any): void;
  6449. /** Gets the value of an attribute. */
  6450. attribute(name: string): any;
  6451. /** Sets the value of an attribute. */
  6452. attribute(name: string, value: any): void;
  6453. /** Gets the layer element coordinates. */
  6454. coordinates(): any;
  6455. /** Gets the selection state of the layer element. */
  6456. selected(): boolean;
  6457. /** Sets the selection state of the layer element. */
  6458. selected(state: boolean): void;
  6459. }
  6460. /** An object that provides information about a legend item in the PieChart widget. */
  6461. export interface PieChartLegendItem {
  6462. /** The argument of the point(s) that the legend item represents. */
  6463. argument?: string | Date | number;
  6464. /** The zero-based index of the legend item used to identify the item among other legend items with the same argument. */
  6465. argumentIndex?: number;
  6466. /** An array of points that the legend item represents. Can contain more than one point only in a multi-series PieChart. */
  6467. points?: Array<piePointObject>;
  6468. /** The text that the legend item displays. */
  6469. text?: any;
  6470. /** Indicates and specifies whether the legend item is visible. */
  6471. visible?: boolean;
  6472. }
  6473. /** Specifies options for the series of the PieChart widget. */
  6474. export interface PieChartSeries extends dxPieChartSeriesTypesCommonPieChartSeries {
  6475. /** Specifies the name that identifies the series. */
  6476. name?: string;
  6477. /** Specifies data about a series. */
  6478. tag?: any;
  6479. }
  6480. /** Specifies options for PolarChart widget series. */
  6481. export interface PolarChartSeries extends dxPolarChartSeriesTypesCommonPolarChartSeries {
  6482. /** Specifies the name that identifies the series. */
  6483. name?: string;
  6484. /** Specifies data about a series. */
  6485. tag?: any;
  6486. /** Sets the series type. */
  6487. type?: 'area' | 'bar' | 'line' | 'scatter' | 'stackedbar';
  6488. }
  6489. /** A class describing a scale break range. Inherited by scale breaks in the Chart and RangeSelector. */
  6490. export interface ScaleBreak {
  6491. /** Along with the startValue option, limits the scale break. */
  6492. endValue?: number | Date | string;
  6493. /** Along with the endValue option, limits the scale break. */
  6494. startValue?: number | Date | string;
  6495. }
  6496. /** An object that provides information about a legend item in the VectorMap widget. */
  6497. export interface VectorMapLegendItem {
  6498. /** The color of the legend item's marker. */
  6499. color?: string;
  6500. /** The end value of the group that the legend item indicates. */
  6501. end?: number;
  6502. /** The diameter of the legend item's marker in pixels. */
  6503. size?: number;
  6504. /** The start value of the group that the legend item indicates. */
  6505. start?: number;
  6506. /** Indicates and specifies whether the legend item is visible. */
  6507. visible?: boolean;
  6508. }
  6509. export interface VizRange {
  6510. /** The range's end value. */
  6511. endValue?: number | Date | string;
  6512. /** The range's length. */
  6513. length?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  6514. /** The range's start value. */
  6515. startValue?: number | Date | string;
  6516. }
  6517. /** A class describing various time intervals. Inherited by tick intervals in Chart and RangeSelector. */
  6518. export type VizTimeInterval = number | { days?: number, hours?: number, milliseconds?: number, minutes?: number, months?: number, quarters?: number, seconds?: number, weeks?: number, years?: number } | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  6519. /** This section describes the Label object, which represents a point label. */
  6520. export class baseLabelObject {
  6521. /** Gets the parameters of the label's minimum bounding rectangle (MBR). */
  6522. getBoundingRect(): any;
  6523. /** Hides the point label. */
  6524. hide(): void;
  6525. /** Hides the point label and keeps it invisible until the show() method is called. */
  6526. hide(holdInvisible: boolean): void;
  6527. /** Checks whether the point label is visible. */
  6528. isVisible(): boolean;
  6529. /** Shows the point label. */
  6530. show(): void;
  6531. /** Shows the point label and keeps it visible until the hide() method is called. */
  6532. show(holdVisible: boolean): void;
  6533. }
  6534. /** This section describes the Point object, which represents a series point. */
  6535. export class basePointObject {
  6536. /** Contains the data object that the series point represents. */
  6537. data: any;
  6538. /** Provides information about the state of the point object. */
  6539. fullState: number;
  6540. /** Returns the point's argument value that was set in the data source. */
  6541. originalArgument: string | number | Date;
  6542. /** Returns the point's value that was set in the data source. */
  6543. originalValue: string | number | Date;
  6544. /** Returns the series object to which the point belongs. */
  6545. series: any;
  6546. /** Returns the tag of the point. */
  6547. tag: any;
  6548. /** Switches the point from the hover state back to normal. */
  6549. clearHover(): void;
  6550. /** Deselects the point. */
  6551. clearSelection(): void;
  6552. /** Gets the color of a particular point. */
  6553. getColor(): string;
  6554. /** Allows you to obtain the label(s) of the series point. */
  6555. getLabel(): baseLabelObject & Array<baseLabelObject>;
  6556. /** Hides the tooltip of the point. */
  6557. hideTooltip(): void;
  6558. /** Switches the point into the hover state, the same as when a user places the mouse pointer on it. */
  6559. hover(): void;
  6560. /** Provides information about the hover state of a point. */
  6561. isHovered(): boolean;
  6562. /** Provides information about the selection state of a point. */
  6563. isSelected(): boolean;
  6564. /** Selects the point. The point is displayed in a 'selected' style until another point is selected or the current point is deselected programmatically. */
  6565. select(): void;
  6566. /** Shows the tooltip of the point. */
  6567. showTooltip(): void;
  6568. }
  6569. /** This section describes the Series object, which represents a series. */
  6570. export class baseSeriesObject {
  6571. /** Provides information about the state of the series object. */
  6572. fullState: number;
  6573. /** Returns the name of the series. */
  6574. name: any;
  6575. /** Returns the tag of the series. */
  6576. tag: any;
  6577. /** Returns the type of the series. */
  6578. type: string;
  6579. /** Switches the series from the hover state back to normal. */
  6580. clearHover(): void;
  6581. /** Unselects all the selected points of the series. The points are displayed in an initial style. */
  6582. clearSelection(): void;
  6583. /** Deselects the specified point. The point is displayed in an initial style. */
  6584. deselectPoint(point: basePointObject): void;
  6585. /** Gets all points in the series. */
  6586. getAllPoints(): Array<basePointObject>;
  6587. /** Gets the color of a particular series. */
  6588. getColor(): string;
  6589. /** Gets a series point with the specified index. */
  6590. getPointByPos(positionIndex: number): basePointObject;
  6591. /** Gets a series point with the specified argument value. */
  6592. getPointsByArg(pointArg: number | string | Date): Array<basePointObject>;
  6593. /** Gets visible series points. */
  6594. getVisiblePoints(): Array<basePointObject>;
  6595. /** Hides a series at runtime. */
  6596. hide(): void;
  6597. /** Switches the series into the hover state, the same as when a user places the mouse pointer on it. */
  6598. hover(): void;
  6599. /** Provides information about the hover state of a series. */
  6600. isHovered(): boolean;
  6601. /** Provides information about the selection state of a series. */
  6602. isSelected(): boolean;
  6603. /** Provides information about the visibility state of a series. */
  6604. isVisible(): boolean;
  6605. /** Selects the series. */
  6606. select(): void;
  6607. /** Selects the specified point. The point is displayed in a 'selected' style. */
  6608. selectPoint(point: basePointObject): void;
  6609. /** Makes a particular series visible. */
  6610. show(): void;
  6611. }
  6612. /** This section describes the Axis object. This object represents a chart axis. */
  6613. export class chartAxisObject {
  6614. /** Gets the axis' displayed range. */
  6615. visualRange(): VizRange;
  6616. /** Sets the axis's displayed range. */
  6617. visualRange(visualRange: Array<number | string | Date> | VizRange): void;
  6618. }
  6619. export interface chartPointAggregationInfoObject {
  6620. /** Contains the length of the aggregation interval in axis units (numbers or dates). If the interval is set in pixels (using the aggregationGroupWidth option), it will be converted to axis units. */
  6621. aggregationInterval?: any;
  6622. /** Contains data objects that were aggregated into this point. */
  6623. data?: Array<any>;
  6624. /** Contains the end value of the interval to which the point belongs. */
  6625. intervalEnd?: any;
  6626. /** Contains the start value of the interval to which the point belongs. */
  6627. intervalStart?: any;
  6628. }
  6629. /** This section describes the Point object, which represents a series point. */
  6630. export class chartPointObject extends basePointObject {
  6631. /** Provides information about the aggregation interval and the data objects that fall within it. */
  6632. aggregationInfo: chartPointAggregationInfoObject;
  6633. /** Contains the close value of the point. This field is useful for points belonging to a series of the candle stick or stock type only. */
  6634. originalCloseValue: number | string;
  6635. /** Contains the high value of the point. This field is useful for points belonging to a series of the candle stick or stock type only. */
  6636. originalHighValue: number | string;
  6637. /** Contains the low value of the point. This field is useful for points belonging to a series of the candle stick or stock type only. */
  6638. originalLowValue: number | string;
  6639. /** Contains the first value of the point. This field is useful for points belonging to a series of the range area or range bar type only. */
  6640. originalMinValue: string | number | Date;
  6641. /** Contains the open value of the point. This field is useful for points belonging to a series of the candle stick or stock type only. */
  6642. originalOpenValue: number | string;
  6643. /** Contains the size of the bubble as it was set in the data source. This field is useful for points belonging to a series of the bubble type only. */
  6644. size: number | string;
  6645. /** Gets the parameters of the point's minimum bounding rectangle (MBR). */
  6646. getBoundingRect(): any;
  6647. }
  6648. /** This section describes the Series object, which represents a series. */
  6649. export class chartSeriesObject extends baseSeriesObject {
  6650. /** Returns the name of the value axis of the series. */
  6651. axis: string;
  6652. /** The name of the series' barOverlapGroup. */
  6653. barOverlapGroup: string;
  6654. /** Returns the name of the series pane. */
  6655. pane: string;
  6656. /** The name of the series' stack. */
  6657. stack: string;
  6658. /** Gets the argument axis to which the series belongs. */
  6659. getArgumentAxis(): chartAxisObject;
  6660. /** Gets the value axis to which the series belongs. */
  6661. getValueAxis(): chartAxisObject;
  6662. }
  6663. /** An object that defines a gauge indicator of the rangeBar type. */
  6664. export type circularRangeBar = CommonIndicator;
  6665. /** An object that defines a gauge indicator of the rectangleNeedle type. */
  6666. export type circularRectangleNeedle = CommonIndicator;
  6667. /** An object that defines a gauge indicator of the textCloud type. */
  6668. export type circularTextCloud = CommonIndicator;
  6669. /** An object that defines a gauge indicator of the triangleMarker type. */
  6670. export type circularTriangleMarker = CommonIndicator;
  6671. /** An object that defines a gauge indicator of the triangleNeedle type. */
  6672. export type circularTriangleNeedle = CommonIndicator;
  6673. /** An object that defines a gauge indicator of the twoColorNeedle type. */
  6674. export type circularTwoColorNeedle = CommonIndicator;
  6675. export interface dxBarGaugeOptions extends BaseWidgetOptions<dxBarGauge> {
  6676. /** Specifies animation options. */
  6677. animation?: any;
  6678. /** Specifies a color for the remaining segment of the bar's track. */
  6679. backgroundColor?: string;
  6680. /** Specifies a distance between bars in pixels. */
  6681. barSpacing?: number;
  6682. /** Specifies a base value for bars. */
  6683. baseValue?: number;
  6684. /** Specifies an end value for the gauge's invisible scale. */
  6685. endValue?: number;
  6686. /** Defines the shape of the gauge's arc. */
  6687. geometry?: { endAngle?: number, startAngle?: number };
  6688. /** Specifies the options of the labels that accompany gauge bars. */
  6689. label?: { connectorColor?: string, connectorWidth?: number, customizeText?: ((barValue: { value?: number, valueText?: string }) => string), font?: Font, format?: DevExpress.ui.format, indent?: number, visible?: boolean };
  6690. /** Configures the legend. */
  6691. legend?: dxBarGaugeLegend;
  6692. /** Configures the loading indicator. */
  6693. loadingIndicator?: dxBarGaugeLoadingIndicator;
  6694. /** A function that is executed when a tooltip becomes hidden. */
  6695. onTooltipHidden?: ((e: { component?: dxBarGauge, element?: DevExpress.core.dxElement, model?: any, target?: any }) => any);
  6696. /** A function that is executed when a tooltip appears. */
  6697. onTooltipShown?: ((e: { component?: dxBarGauge, element?: DevExpress.core.dxElement, model?: any, target?: any }) => any);
  6698. /** Sets the palette to be used for colorizing bars in the gauge. */
  6699. palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office';
  6700. /** Specifies what to do with colors in the palette when their number is less than the number of bars in the gauge. */
  6701. paletteExtensionMode?: 'alternate' | 'blend' | 'extrapolate';
  6702. /** Defines the radius of the bar that is closest to the center relatively to the radius of the topmost bar. */
  6703. relativeInnerRadius?: number;
  6704. /** Specifies how the widget should behave when bar labels overlap: hide certain labels or leave them overlapped. */
  6705. resolveLabelOverlapping?: 'hide' | 'none';
  6706. /** Specifies a start value for the gauge's invisible scale. */
  6707. startValue?: number;
  6708. /** Configures tooltips. */
  6709. tooltip?: dxBarGaugeTooltip;
  6710. /** Specifies the array of values to be indicated on a bar gauge. */
  6711. values?: Array<number>;
  6712. }
  6713. /** Configures the legend. */
  6714. export interface dxBarGaugeLegend extends BaseLegend {
  6715. /** Specifies the hint that appears when a user hovers the mouse pointer over a legend item. */
  6716. customizeHint?: ((arg: { item?: BarGaugeBarInfo, text?: string }) => string);
  6717. /** Allows you to change the order, text, and visibility of legend items. */
  6718. customizeItems?: ((items: Array<BarGaugeLegendItem>) => Array<BarGaugeLegendItem>);
  6719. /** Customizes the text displayed by legend items. */
  6720. customizeText?: ((arg: { item?: BarGaugeBarInfo, text?: string }) => string);
  6721. /** Formats the item text before it is displayed. Accepts only numeric formats. When unspecified, it inherits the label's format. */
  6722. itemTextFormat?: DevExpress.ui.format;
  6723. /** Specifies the legend's visibility. */
  6724. visible?: boolean;
  6725. }
  6726. /** Configures the loading indicator. */
  6727. export interface dxBarGaugeLoadingIndicator extends BaseWidgetLoadingIndicator {
  6728. }
  6729. /** Configures tooltips. */
  6730. export interface dxBarGaugeTooltip extends BaseWidgetTooltip {
  6731. /** Allows you to change tooltip appearance. */
  6732. customizeTooltip?: ((scaleValue: { value?: number, valueText?: string, index?: number }) => any);
  6733. }
  6734. /** The BarGauge widget contains several circular bars that each indicates a single value. */
  6735. export class dxBarGauge extends BaseWidget {
  6736. constructor(element: Element, options?: dxBarGaugeOptions)
  6737. constructor(element: JQuery, options?: dxBarGaugeOptions)
  6738. /** Gets all the values. */
  6739. values(): Array<number>;
  6740. /** Updates all the values. */
  6741. values(values: Array<number>): void;
  6742. }
  6743. export interface dxBulletOptions extends BaseSparklineOptions<dxBullet> {
  6744. /** Specifies a color for the bullet bar. */
  6745. color?: string;
  6746. /** Specifies an end value for the invisible scale. */
  6747. endScaleValue?: number;
  6748. /** Specifies whether or not to show the target line. */
  6749. showTarget?: boolean;
  6750. /** Specifies whether or not to show the line indicating zero on the invisible scale. */
  6751. showZeroLevel?: boolean;
  6752. /** Specifies a start value for the invisible scale. */
  6753. startScaleValue?: number;
  6754. /** Specifies the value indicated by the target line. */
  6755. target?: number;
  6756. /** Specifies a color for both the target and zero level lines. */
  6757. targetColor?: string;
  6758. /** Specifies the width of the target line. */
  6759. targetWidth?: number;
  6760. /** Specifies the primary value indicated by the bullet bar. */
  6761. value?: number;
  6762. }
  6763. /** The Bullet widget is useful when you need to compare a single measure to a target value. The widget comprises a horizontal bar indicating the measure and a vertical line indicating the target value. */
  6764. export class dxBullet extends BaseSparkline {
  6765. constructor(element: Element, options?: dxBulletOptions)
  6766. constructor(element: JQuery, options?: dxBulletOptions)
  6767. }
  6768. export interface dxChartOptions extends BaseChartOptions<dxChart> {
  6769. /** Specifies whether to adjust the value axis's visualRange when the argument axis is being zoomed or panned. */
  6770. adjustOnZoom?: boolean;
  6771. /** Specifies the annotation collection. */
  6772. annotations?: Array<dxChartAnnotationConfig | any>;
  6773. /** Configures the argument axis. */
  6774. argumentAxis?: dxChartArgumentAxis;
  6775. /** Specifies whether to hide series point markers automatically to reduce visual clutter. */
  6776. autoHidePointMarkers?: boolean;
  6777. /** Controls the padding and consequently the width of a group of bars with the same argument using relative units. Ignored if the barGroupWidth option is set. */
  6778. barGroupPadding?: number;
  6779. /** Specifies a fixed width for groups of bars with the same argument, measured in pixels. Takes precedence over the barGroupPadding option. */
  6780. barGroupWidth?: number;
  6781. /** @deprecated Use CommonSeries.barPadding instead. */
  6782. /** Controls the width of bars in the widget. Applies only to bar-like series and when the equalBarWidth option is true. */
  6783. barWidth?: number;
  6784. /** Specifies settings common for all annotations in the chart. */
  6785. commonAnnotationSettings?: dxChartCommonAnnotationConfig;
  6786. /** Defines common settings for both the argument and value axis in a chart. */
  6787. commonAxisSettings?: dxChartCommonAxisSettings;
  6788. /** Defines common settings for all panes in a chart. */
  6789. commonPaneSettings?: dxChartCommonPaneSettings;
  6790. /** Specifies settings common for all series in the chart. */
  6791. commonSeriesSettings?: dxChartCommonSeriesSettings;
  6792. /** Colors the background of the chart container. */
  6793. containerBackgroundColor?: string;
  6794. /** Configures the crosshair feature. */
  6795. crosshair?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', enabled?: boolean, horizontalLine?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', label?: { backgroundColor?: string, customizeText?: ((info: { value?: Date | number | string, valueText?: string, point?: chartPointObject }) => string), font?: Font, format?: DevExpress.ui.format, visible?: boolean }, opacity?: number, visible?: boolean, width?: number } | boolean, label?: { backgroundColor?: string, customizeText?: ((info: { value?: Date | number | string, valueText?: string, point?: chartPointObject }) => string), font?: Font, format?: DevExpress.ui.format, visible?: boolean }, opacity?: number, verticalLine?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', label?: { backgroundColor?: string, customizeText?: ((info: { value?: Date | number | string, valueText?: string, point?: chartPointObject }) => string), font?: Font, format?: DevExpress.ui.format, visible?: boolean }, opacity?: number, visible?: boolean, width?: number } | boolean, width?: number };
  6796. /** Customizes an individual annotation. */
  6797. customizeAnnotation?: ((annotationItem: dxChartAnnotationConfig | any) => dxChartAnnotationConfig);
  6798. /** Processes data before visualizing it. */
  6799. dataPrepareSettings?: { checkTypeForAllData?: boolean, convertToAxisDataType?: boolean, sortingMethod?: boolean | ((a: any, b: any) => number) };
  6800. /** Specifies which pane should be used by default. */
  6801. defaultPane?: string;
  6802. /** @deprecated Use CommonSeries.ignoreEmptyPoints instead. */
  6803. /** Specifies whether all bars should have equal width, even if some values are missing from a series. Applies only to bar-like series. */
  6804. equalBarWidth?: boolean;
  6805. /** Specifies the options of a chart's legend. */
  6806. legend?: dxChartLegend;
  6807. /** Specifies a coefficient determining the diameter of the largest bubble. */
  6808. maxBubbleSize?: number;
  6809. /** Specifies the diameter of the smallest bubble measured in pixels. */
  6810. minBubbleSize?: number;
  6811. /** Forces the widget to treat negative values as zeroes. Applies to stacked-like series only. */
  6812. negativesAsZeroes?: boolean;
  6813. /** A function that is executed when a label on the argument axis is clicked or tapped. */
  6814. onArgumentAxisClick?: ((e: { component?: dxChart, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, argument?: Date | number | string }) => any) | string;
  6815. /** A function that is executed when a legend item is clicked or tapped. */
  6816. onLegendClick?: ((e: { component?: dxChart, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, target?: chartSeriesObject }) => any) | string;
  6817. /** A function that is executed when a series is clicked or tapped. */
  6818. onSeriesClick?: ((e: { component?: dxChart, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, target?: chartSeriesObject }) => any) | string;
  6819. /** A function that is executed after the pointer enters or leaves a series. */
  6820. onSeriesHoverChanged?: ((e: { component?: dxChart, element?: DevExpress.core.dxElement, model?: any, target?: chartSeriesObject }) => any);
  6821. /** A function that is executed when a series is selected or selection is canceled. */
  6822. onSeriesSelectionChanged?: ((e: { component?: dxChart, element?: DevExpress.core.dxElement, model?: any, target?: chartSeriesObject }) => any);
  6823. /** A function that is executed when zooming or panning ends. */
  6824. onZoomEnd?: ((e: { component?: dxChart, element?: DevExpress.core.dxElement, model?: any, event?: event, rangeStart?: Date | number, rangeEnd?: Date | number, axis?: chartAxisObject, range?: VizRange, previousRange?: VizRange, cancel?: boolean, actionType?: 'zoom' | 'pan', zoomFactor?: number, shift?: number }) => any);
  6825. /** A function that is executed when zooming or panning begins. */
  6826. onZoomStart?: ((e: { component?: dxChart, element?: DevExpress.core.dxElement, model?: any, event?: event, axis?: chartAxisObject, range?: VizRange, cancel?: boolean, actionType?: 'zoom' | 'pan' }) => any);
  6827. /** Declares a collection of panes. */
  6828. panes?: dxChartPanes | Array<dxChartPanes>;
  6829. /** Specifies how the chart must behave when series point labels overlap. */
  6830. resolveLabelOverlapping?: 'hide' | 'none' | 'stack';
  6831. /** Swaps the axes around making the value axis horizontal and the argument axis vertical. */
  6832. rotated?: boolean;
  6833. /** Specifies the settings of the scroll bar. */
  6834. scrollBar?: { color?: string, offset?: number, opacity?: number, position?: 'bottom' | 'left' | 'right' | 'top', visible?: boolean, width?: number };
  6835. /** @deprecated Use the zoomAndPan option instead. */
  6836. /** Enables scrolling in your chart. */
  6837. scrollingMode?: 'all' | 'mouse' | 'none' | 'touch';
  6838. /** Specifies options for Chart widget series. */
  6839. series?: ChartSeries | Array<ChartSeries>;
  6840. /** Specifies whether a single series or multiple series can be selected in the chart. */
  6841. seriesSelectionMode?: 'multiple' | 'single';
  6842. /** Defines options for the series template. */
  6843. seriesTemplate?: { customizeSeries?: ((seriesName: any) => ChartSeries), nameField?: string };
  6844. /** Specifies whether a point should remain in the hover state when the mouse pointer moves away. */
  6845. stickyHovering?: boolean;
  6846. /** Indicates whether or not to synchronize value axes when they are displayed on a single pane. */
  6847. synchronizeMultiAxes?: boolean;
  6848. /** Configures tooltips. */
  6849. tooltip?: dxChartTooltip;
  6850. /** @deprecated Use CommonSeries.aggregation.enabled instead. */
  6851. /** Specifies whether or not to filter the series points depending on their quantity. */
  6852. useAggregation?: boolean;
  6853. /** Configures the value axis. */
  6854. valueAxis?: dxChartValueAxis | Array<dxChartValueAxis>;
  6855. /** Configures zooming and panning. */
  6856. zoomAndPan?: { allowMouseWheel?: boolean, allowTouchGestures?: boolean, argumentAxis?: 'both' | 'none' | 'pan' | 'zoom', dragBoxStyle?: { color?: string, opacity?: number }, dragToZoom?: boolean, panKey?: 'alt' | 'ctrl' | 'meta' | 'shift', valueAxis?: 'both' | 'none' | 'pan' | 'zoom' };
  6857. /** @deprecated Use the zoomAndPan option instead. */
  6858. /** Enables zooming in your chart. */
  6859. zoomingMode?: 'all' | 'mouse' | 'none' | 'touch';
  6860. }
  6861. /** Configures the argument axis. */
  6862. export interface dxChartArgumentAxis extends dxChartCommonAxisSettings {
  6863. /** Specifies the length of aggregation intervals in pixels. May be ignored in favor of the aggregationInterval option. */
  6864. aggregationGroupWidth?: number;
  6865. /** Specifies the length of aggregation intervals in axis units. Applies only to axes of continuous and logarithmic types. */
  6866. aggregationInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  6867. /** Casts arguments to a specified data type. */
  6868. argumentType?: 'datetime' | 'numeric' | 'string';
  6869. /** Specifies the minimum distance between two neighboring major ticks in pixels. Applies only to the axes of the "continuous" and "logarithmic" types. */
  6870. axisDivisionFactor?: number;
  6871. /** Declares a scale break collection. Applies only if the axis' type is "continuous" or "logarithmic". */
  6872. breaks?: Array<ScaleBreak>;
  6873. /** Specifies the order of categories on an axis of the "discrete" type. */
  6874. categories?: Array<number | string | Date>;
  6875. /** Specifies the appearance of those constant lines that belong to the argument axis. */
  6876. constantLineStyle?: dxChartArgumentAxisConstantLineStyle;
  6877. /** Declares a collection of constant lines belonging to the argument axis. */
  6878. constantLines?: Array<dxChartArgumentAxisConstantLines>;
  6879. /** Specifies whether to force the axis to start and end on ticks. */
  6880. endOnTick?: boolean;
  6881. /** Dates to be excluded from the axis when workdaysOnly is true. */
  6882. holidays?: Array<Date | string> | Array<number>;
  6883. /** Specifies chart elements to be highlighted when a user points to an axis label. */
  6884. hoverMode?: 'allArgumentPoints' | 'none';
  6885. /** Configures the labels of the argument axis. */
  6886. label?: dxChartArgumentAxisLabel;
  6887. /** Specifies the value to be raised to a power when generating ticks for an axis of the "logarithmic" type. */
  6888. logarithmBase?: number;
  6889. /** @deprecated Use the argumentAxis.visualRange option instead. */
  6890. /** Coupled with the min option, focuses the widget on a specific chart segment. Applies only to the axes of the "continuous" and "logarithmic" type. */
  6891. max?: number | Date | string;
  6892. /** @deprecated Use the argumentAxis.visualRange option instead. */
  6893. /** Coupled with the max option, focuses the widget on a specific chart segment. Applies only to the axes of the "continuous" and "logarithmic" type. */
  6894. min?: number | Date | string;
  6895. /** Specifies the minimum length of the visual range. */
  6896. minVisualRangeLength?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  6897. /** Specifies how many minor ticks to place between two neighboring major ticks. */
  6898. minorTickCount?: number;
  6899. /** Specifies the interval between minor ticks. Applies only to the axes of the "continuous" type. */
  6900. minorTickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  6901. /** Relocates the argument axis. */
  6902. position?: 'bottom' | 'left' | 'right' | 'top';
  6903. /** Dates to be included on the axis when workdaysOnly is true. */
  6904. singleWorkdays?: Array<Date | string> | Array<number>;
  6905. /** Declares a collection of strips belonging to the argument axis. */
  6906. strips?: Array<dxChartArgumentAxisStrips>;
  6907. /** Specifies the interval between major ticks. */
  6908. tickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  6909. /** Configures the axis title. */
  6910. title?: dxChartArgumentAxisTitle;
  6911. /** Specifies the type of the argument axis. */
  6912. type?: 'continuous' | 'discrete' | 'logarithmic';
  6913. /** Defines the axis' displayed range. Cannot be wider than the wholeRange. */
  6914. visualRange?: VizRange | Array<number | string | Date>;
  6915. /** Specifies how the axis's visual range should behave when chart data is updated. */
  6916. visualRangeUpdateMode?: 'auto' | 'keep' | 'reset' | 'shift';
  6917. /** Defines the range where the axis can be zoomed and panned. */
  6918. wholeRange?: VizRange | Array<number | string | Date>;
  6919. /** Specifies which days are workdays. The array can contain values from 0 (Sunday) to 6 (Saturday). Applies only if workdaysOnly is true. */
  6920. workWeek?: Array<number>;
  6921. /** Leaves only workdays on the axis: the work week days plus single workdays minus holidays. Applies only if the axis' argumentType is "datetime". */
  6922. workdaysOnly?: boolean;
  6923. }
  6924. /** Specifies the appearance of those constant lines that belong to the argument axis. */
  6925. export interface dxChartArgumentAxisConstantLineStyle extends dxChartCommonAxisSettingsConstantLineStyle {
  6926. /** Specifies the appearance of the labels of those constant lines that belong to the argument axis. */
  6927. label?: dxChartArgumentAxisConstantLineStyleLabel;
  6928. }
  6929. /** Specifies the appearance of the labels of those constant lines that belong to the argument axis. */
  6930. export interface dxChartArgumentAxisConstantLineStyleLabel extends dxChartCommonAxisSettingsConstantLineStyleLabel {
  6931. /** Aligns constant line labels in the horizontal direction. */
  6932. horizontalAlignment?: 'center' | 'left' | 'right';
  6933. /** Aligns constant line labels in the vertical direction. */
  6934. verticalAlignment?: 'bottom' | 'center' | 'top';
  6935. }
  6936. /** Declares a collection of constant lines belonging to the argument axis. */
  6937. export interface dxChartArgumentAxisConstantLines extends dxChartCommonAxisSettingsConstantLineStyle {
  6938. /** Specifies whether to display the constant line behind or in front of the series. */
  6939. displayBehindSeries?: boolean;
  6940. /** Specifies whether to extend the axis's default visual range to display the constant line. */
  6941. extendAxis?: boolean;
  6942. /** Configures the constant line label. */
  6943. label?: dxChartArgumentAxisConstantLinesLabel;
  6944. /** Specifies the value indicated by a constant line. Setting this option is necessary. */
  6945. value?: number | Date | string;
  6946. }
  6947. /** Configures the constant line label. */
  6948. export interface dxChartArgumentAxisConstantLinesLabel extends dxChartCommonAxisSettingsConstantLineStyleLabel {
  6949. /** Aligns constant line labels in the horizontal direction. */
  6950. horizontalAlignment?: 'center' | 'left' | 'right';
  6951. /** Specifies the text of a constant line label. By default, equals to the value of the constant line. */
  6952. text?: string;
  6953. /** Aligns constant line labels in the vertical direction. */
  6954. verticalAlignment?: 'bottom' | 'center' | 'top';
  6955. }
  6956. /** Configures the labels of the argument axis. */
  6957. export interface dxChartArgumentAxisLabel extends dxChartCommonAxisSettingsLabel {
  6958. /** Specifies the hint that appears when a user points to an axis label. */
  6959. customizeHint?: ((argument: { value?: Date | number | string, valueText?: string }) => string);
  6960. /** Customizes the text displayed by axis labels. */
  6961. customizeText?: ((argument: { value?: Date | number | string, valueText?: string }) => string);
  6962. /** Formats a value before it is displayed in an axis label. */
  6963. format?: DevExpress.ui.format;
  6964. }
  6965. /** Declares a collection of strips belonging to the argument axis. */
  6966. export interface dxChartArgumentAxisStrips extends dxChartCommonAxisSettingsStripStyle {
  6967. /** Specifies the color of the strip. */
  6968. color?: string;
  6969. /** Along with the startValue option, limits the strip. */
  6970. endValue?: number | Date | string;
  6971. /** Configures the strip label. */
  6972. label?: dxChartArgumentAxisStripsLabel;
  6973. /** Along with the endValue option, limits the strip. */
  6974. startValue?: number | Date | string;
  6975. }
  6976. /** Configures the strip label. */
  6977. export interface dxChartArgumentAxisStripsLabel extends dxChartCommonAxisSettingsStripStyleLabel {
  6978. /** Specifies the text of the strip label. */
  6979. text?: string;
  6980. }
  6981. /** Configures the axis title. */
  6982. export interface dxChartArgumentAxisTitle extends dxChartCommonAxisSettingsTitle {
  6983. /** Specifies the text of the axis title. */
  6984. text?: string;
  6985. }
  6986. /** Defines common settings for both the argument and value axis in a chart. */
  6987. export interface dxChartCommonAxisSettings {
  6988. /** Specifies whether to allow decimal values on the axis. When false, the axis contains integer values only. */
  6989. allowDecimals?: boolean;
  6990. /** Configures the scale breaks' appearance. */
  6991. breakStyle?: { color?: string, line?: 'straight' | 'waved', width?: number };
  6992. /** Specifies the color of the axis line. */
  6993. color?: string;
  6994. /** Configures the appearance of all constant lines in the widget. */
  6995. constantLineStyle?: dxChartCommonAxisSettingsConstantLineStyle;
  6996. /** Specifies whether ticks and grid lines should cross axis labels or lie between them. Applies only to the axes of the "discrete" type. */
  6997. discreteAxisDivisionMode?: 'betweenLabels' | 'crossLabels';
  6998. /** Specifies whether to force the axis to start and end on ticks. */
  6999. endOnTick?: boolean;
  7000. /** Configures the grid. */
  7001. grid?: { color?: string, opacity?: number, visible?: boolean, width?: number };
  7002. /** Inverts the axis. */
  7003. inverted?: boolean;
  7004. /** Configures axis labels. */
  7005. label?: dxChartCommonAxisSettingsLabel;
  7006. /** Controls the empty space between the maximum series points and the axis. Applies only to the axes of the "continuous" and "logarithmic" type. */
  7007. maxValueMargin?: number;
  7008. /** Controls the empty space between the minimum series points and the axis. Applies only to the axes of the "continuous" and "logarithmic" type. */
  7009. minValueMargin?: number;
  7010. /** Configures the minor grid. */
  7011. minorGrid?: { color?: string, opacity?: number, visible?: boolean, width?: number };
  7012. /** Configures the appearance of minor axis ticks. */
  7013. minorTick?: { color?: string, length?: number, opacity?: number, shift?: number, visible?: boolean, width?: number };
  7014. /** Specifies how transparent the axis line should be. */
  7015. opacity?: number;
  7016. /** Reserves a pixel-measured space for the axis. */
  7017. placeholderSize?: number;
  7018. /** Configures the appearance of strips. */
  7019. stripStyle?: dxChartCommonAxisSettingsStripStyle;
  7020. /** Configures the appearance of major axis ticks. */
  7021. tick?: { color?: string, length?: number, opacity?: number, shift?: number, visible?: boolean, width?: number };
  7022. /** Configures axis titles. */
  7023. title?: dxChartCommonAxisSettingsTitle;
  7024. /** Adds an empty space between the axis and the minimum and maximum series points. */
  7025. valueMarginsEnabled?: boolean;
  7026. /** Makes the axis line visible. */
  7027. visible?: boolean;
  7028. /** Specifies the width of the axis line in pixels. */
  7029. width?: number;
  7030. }
  7031. /** Configures the appearance of all constant lines in the widget. */
  7032. export interface dxChartCommonAxisSettingsConstantLineStyle {
  7033. /** Specifies the color of constant lines. */
  7034. color?: string;
  7035. /** Specifies the dash style of constant lines. */
  7036. dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid';
  7037. /** Configures constant line labels. */
  7038. label?: dxChartCommonAxisSettingsConstantLineStyleLabel;
  7039. /** Generates a pixel-measured empty space between the left/right side of a constant line and the constant line label. */
  7040. paddingLeftRight?: number;
  7041. /** Generates a pixel-measured empty space between the top/bottom side of a constant line and the constant line label. */
  7042. paddingTopBottom?: number;
  7043. /** Specifies the width of constant lines in pixels. */
  7044. width?: number;
  7045. }
  7046. /** Configures constant line labels. */
  7047. export interface dxChartCommonAxisSettingsConstantLineStyleLabel {
  7048. /** Specifies font options for constant line labels. */
  7049. font?: Font;
  7050. /** Specifies the position of constant line labels on the chart plot. */
  7051. position?: 'inside' | 'outside';
  7052. /** Makes constant line labels visible. */
  7053. visible?: boolean;
  7054. }
  7055. /** Configures axis labels. */
  7056. export interface dxChartCommonAxisSettingsLabel {
  7057. /** Aligns axis labels in relation to ticks. */
  7058. alignment?: 'center' | 'left' | 'right';
  7059. /** Allows you to rotate or stagger axis labels. Applies to the horizontal axis only. */
  7060. displayMode?: 'rotate' | 'stagger' | 'standard';
  7061. /** Specifies font options for axis labels. */
  7062. font?: Font;
  7063. /** Adds a pixel-measured empty space between an axis and its labels. */
  7064. indentFromAxis?: number;
  7065. /** Decides how to arrange axis labels when there is not enough space to keep all of them. */
  7066. overlappingBehavior?: 'rotate' | 'stagger' | 'none' | 'hide';
  7067. /** Specifies the rotation angle of axis labels. Applies only if displayMode or overlappingBehavior is "rotate". */
  7068. rotationAngle?: number;
  7069. /** Adds a pixel-measured empty space between two staggered rows of axis labels. Applies only if displayMode or overlappingBehavior is "stagger". */
  7070. staggeringSpacing?: number;
  7071. /** Specifies what to do with axis labels that overflow the allocated space after applying wordWrap: hide, truncate them and display an ellipsis, or do nothing. */
  7072. textOverflow?: 'ellipsis' | 'hide' | 'none';
  7073. /** Shows/hides axis labels. */
  7074. visible?: boolean;
  7075. /** Specifies how to wrap texts that do not fit into a single line. */
  7076. wordWrap?: 'normal' | 'breakWord' | 'none';
  7077. }
  7078. /** Configures the appearance of strips. */
  7079. export interface dxChartCommonAxisSettingsStripStyle {
  7080. /** Configures the appearance of strip labels. */
  7081. label?: dxChartCommonAxisSettingsStripStyleLabel;
  7082. /** Generates a pixel-measured empty space between the left/right border of a strip and the strip label. */
  7083. paddingLeftRight?: number;
  7084. /** Generates a pixel-measured empty space between the top/bottom border of a strip and the strip label. */
  7085. paddingTopBottom?: number;
  7086. }
  7087. /** Configures the appearance of strip labels. */
  7088. export interface dxChartCommonAxisSettingsStripStyleLabel {
  7089. /** Specifies font options for strip labels. */
  7090. font?: Font;
  7091. /** Aligns strip labels in the horizontal direction. */
  7092. horizontalAlignment?: 'center' | 'left' | 'right';
  7093. /** Aligns strip labels in the vertical direction. */
  7094. verticalAlignment?: 'bottom' | 'center' | 'top';
  7095. }
  7096. /** Configures axis titles. */
  7097. export interface dxChartCommonAxisSettingsTitle {
  7098. /** Aligns the axis title to the left, center, or right of the axis. */
  7099. alignment?: 'center' | 'left' | 'right';
  7100. /** Specifies font options for the axis title. */
  7101. font?: Font;
  7102. /** Adds a pixel-measured empty space between the axis title and axis labels. */
  7103. margin?: number;
  7104. /** Specifies what to do with the axis title when it overflows the allocated space after applying wordWrap: hide, truncate them and display an ellipsis, or do nothing. */
  7105. textOverflow?: 'ellipsis' | 'hide' | 'none';
  7106. /** Specifies how to wrap the axis title if it does not fit into a single line. */
  7107. wordWrap?: 'normal' | 'breakWord' | 'none';
  7108. }
  7109. /** Defines common settings for all panes in a chart. */
  7110. export interface dxChartCommonPaneSettings {
  7111. /** Specifies the color of the pane's background. */
  7112. backgroundColor?: string;
  7113. /** Configures the pane border. */
  7114. border?: { bottom?: boolean, color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', left?: boolean, opacity?: number, right?: boolean, top?: boolean, visible?: boolean, width?: number };
  7115. }
  7116. /** Specifies settings common for all series in the chart. */
  7117. export interface dxChartCommonSeriesSettings extends dxChartSeriesTypesCommonSeries {
  7118. /** Defines common settings for all area series. */
  7119. area?: any;
  7120. /** Defines common settings for all bar series. */
  7121. bar?: any;
  7122. /** Defines common settings for all bubble series. */
  7123. bubble?: any;
  7124. /** Defines common settings for all candlestick series. */
  7125. candlestick?: any;
  7126. /** Defines common settings for all full-stacked area series. */
  7127. fullstackedarea?: any;
  7128. /** Defines common settings for all full-stacked bar series. */
  7129. fullstackedbar?: any;
  7130. /** Defines common settings for all full-stacked line series. */
  7131. fullstackedline?: any;
  7132. /** Defines common settings for all full-stacked spline series. */
  7133. fullstackedspline?: any;
  7134. /** Defines common settings for all full-stacked spline area series. */
  7135. fullstackedsplinearea?: any;
  7136. /** Defines common settings for all line series. */
  7137. line?: any;
  7138. /** Defines common settings for all range area series. */
  7139. rangearea?: any;
  7140. /** Defines common settings for all range bar series. */
  7141. rangebar?: any;
  7142. /** Defines common settings for all scatter series. */
  7143. scatter?: any;
  7144. /** Defines common settings for all spline series. */
  7145. spline?: any;
  7146. /** Defines common settings for all spline area series. */
  7147. splinearea?: any;
  7148. /** Defines common settings for all stacked area series. */
  7149. stackedarea?: any;
  7150. /** Defines common settings for all stacked bar series. */
  7151. stackedbar?: any;
  7152. /** Defines common settings for all stacked line series. */
  7153. stackedline?: any;
  7154. /** Defines common settings for all stacked spline series. */
  7155. stackedspline?: any;
  7156. /** Defines common settings for all stacked spline area series. */
  7157. stackedsplinearea?: any;
  7158. /** Defines common settings for all step area series. */
  7159. steparea?: any;
  7160. /** Defines common settings for all step line series. */
  7161. stepline?: any;
  7162. /** Defines common settings for all stock series. */
  7163. stock?: any;
  7164. /** Specifies the type of the series. */
  7165. type?: 'area' | 'bar' | 'bubble' | 'candlestick' | 'fullstackedarea' | 'fullstackedbar' | 'fullstackedline' | 'fullstackedspline' | 'fullstackedsplinearea' | 'line' | 'rangearea' | 'rangebar' | 'scatter' | 'spline' | 'splinearea' | 'stackedarea' | 'stackedbar' | 'stackedline' | 'stackedspline' | 'stackedsplinearea' | 'steparea' | 'stepline' | 'stock';
  7166. }
  7167. /** Specifies the options of a chart's legend. */
  7168. export interface dxChartLegend extends BaseChartLegend {
  7169. /** Specifies the text for a hint that appears when a user hovers the mouse pointer over a legend item. */
  7170. customizeHint?: ((seriesInfo: { seriesName?: any, seriesIndex?: number, seriesColor?: string }) => string);
  7171. /** Specifies a callback function that returns the text to be displayed by a legend item. */
  7172. customizeText?: ((seriesInfo: { seriesName?: any, seriesIndex?: number, seriesColor?: string }) => string);
  7173. /** Specifies what series elements to highlight when a corresponding item in the legend is hovered over. */
  7174. hoverMode?: 'excludePoints' | 'includePoints' | 'none';
  7175. /** Specifies whether the legend is located outside or inside the chart's plot. */
  7176. position?: 'inside' | 'outside';
  7177. }
  7178. /** Declares a collection of panes. */
  7179. export interface dxChartPanes extends dxChartCommonPaneSettings {
  7180. /** Specifies the name of the pane. */
  7181. name?: string;
  7182. }
  7183. /** Configures tooltips. */
  7184. export interface dxChartTooltip extends BaseChartTooltip {
  7185. /** Specifies whether the tooltip must be located in the center of a series point or on its edge. Applies to bar-like and bubble series only. */
  7186. location?: 'center' | 'edge';
  7187. /** Specifies the kind of information to display in a tooltip. */
  7188. shared?: boolean;
  7189. }
  7190. /** Configures the value axis. */
  7191. export interface dxChartValueAxis extends dxChartCommonAxisSettings {
  7192. /** Enables auto-calculated scale breaks. Applies only if the axis' type is "continuous" or "logarithmic" and valueType is "numeric". */
  7193. autoBreaksEnabled?: boolean;
  7194. /** Specifies the minimum distance between two neighboring major ticks in pixels. Applies only to the axes of the "continuous" and "logarithmic" types. */
  7195. axisDivisionFactor?: number;
  7196. /** Declares a custom scale break collection. Applies only if the axis' type is "continuous" or "logarithmic". */
  7197. breaks?: Array<ScaleBreak>;
  7198. /** Specifies the order of categories on an axis of the "discrete" type. */
  7199. categories?: Array<number | string | Date>;
  7200. /** Specifies the appearance of those constant lines that belong to the value axis. */
  7201. constantLineStyle?: dxChartValueAxisConstantLineStyle;
  7202. /** Declares a collection of constant lines belonging to the value axis. */
  7203. constantLines?: Array<dxChartValueAxisConstantLines>;
  7204. /** Specifies whether to force the axis to start and end on ticks. */
  7205. endOnTick?: boolean;
  7206. /** Configures the labels of the value axis. */
  7207. label?: dxChartValueAxisLabel;
  7208. /** Specifies the value to be raised to a power when generating ticks for an axis of the "logarithmic" type. */
  7209. logarithmBase?: number;
  7210. /** @deprecated Use the valueAxis.visualRange option instead. */
  7211. /** Coupled with the min option, focuses the widget on a specific chart segment. Applies only to the axes of the "continuous" and "logarithmic" type. */
  7212. max?: number | Date | string;
  7213. /** Sets a limit on auto-calculated scale breaks. Custom scale breaks are not counted. */
  7214. maxAutoBreakCount?: number;
  7215. /** @deprecated Use the valueAxis.visualRange option instead. */
  7216. /** Coupled with the max option, focuses the widget on a specific chart segment. Applies only to the axes of the "continuous" and "logarithmic" type. */
  7217. min?: number | Date | string;
  7218. /** Specifies the minimum length of the visual range. */
  7219. minVisualRangeLength?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  7220. /** Specifies how many minor ticks to place between two neighboring major ticks. */
  7221. minorTickCount?: number;
  7222. /** Specifies the interval between minor ticks. Applies only to continuous axes. */
  7223. minorTickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  7224. /** Adds a pixel-measured empty space between two side-by-side value axes. Applies if several value axes are located on one side of the chart. */
  7225. multipleAxesSpacing?: number;
  7226. /** Specifies the name of the value axis. */
  7227. name?: string;
  7228. /** Binds the value axis to a pane. */
  7229. pane?: string;
  7230. /** Relocates the value axis. */
  7231. position?: 'bottom' | 'left' | 'right' | 'top';
  7232. /** Specifies whether or not to show zero on the value axis. */
  7233. showZero?: boolean;
  7234. /** Declares a collection of strips belonging to the value axis. */
  7235. strips?: Array<dxChartValueAxisStrips>;
  7236. /** Synchronizes two or more value axes with each other at a specific value. */
  7237. synchronizedValue?: number;
  7238. /** Specifies the interval between major ticks. Does not apply to discrete axes. */
  7239. tickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  7240. /** Configures the axis title. */
  7241. title?: dxChartValueAxisTitle;
  7242. /** Specifies the type of the value axis. */
  7243. type?: 'continuous' | 'discrete' | 'logarithmic';
  7244. /** Casts values to a specified data type. */
  7245. valueType?: 'datetime' | 'numeric' | 'string';
  7246. /** Defines the axis' displayed range. Cannot be wider than the wholeRange. */
  7247. visualRange?: VizRange | Array<number | string | Date>;
  7248. /** Specifies how the axis's visual range should behave when chart data is updated. */
  7249. visualRangeUpdateMode?: 'auto' | 'keep' | 'reset' | 'shift';
  7250. /** Defines the range where the axis can be zoomed and panned. */
  7251. wholeRange?: VizRange | Array<number | string | Date>;
  7252. }
  7253. /** Specifies the appearance of those constant lines that belong to the value axis. */
  7254. export interface dxChartValueAxisConstantLineStyle extends dxChartCommonAxisSettingsConstantLineStyle {
  7255. /** Specifies the appearance of the labels of those constant lines that belong to the value axis. */
  7256. label?: dxChartValueAxisConstantLineStyleLabel;
  7257. }
  7258. /** Specifies the appearance of the labels of those constant lines that belong to the value axis. */
  7259. export interface dxChartValueAxisConstantLineStyleLabel extends dxChartCommonAxisSettingsConstantLineStyleLabel {
  7260. /** Aligns constant line labels in the horizontal direction. */
  7261. horizontalAlignment?: 'center' | 'left' | 'right';
  7262. /** Aligns constant line labels in the vertical direction. */
  7263. verticalAlignment?: 'bottom' | 'center' | 'top';
  7264. }
  7265. /** Declares a collection of constant lines belonging to the value axis. */
  7266. export interface dxChartValueAxisConstantLines extends dxChartCommonAxisSettingsConstantLineStyle {
  7267. /** Specifies whether to display the constant line behind or in front of the series. */
  7268. displayBehindSeries?: boolean;
  7269. /** Specifies whether to extend the axis's default visual range to display the constant line. */
  7270. extendAxis?: boolean;
  7271. /** Configures the constant line label. */
  7272. label?: dxChartValueAxisConstantLinesLabel;
  7273. /** Specifies the value indicated by a constant line. Setting this option is necessary. */
  7274. value?: number | Date | string;
  7275. }
  7276. /** Configures the constant line label. */
  7277. export interface dxChartValueAxisConstantLinesLabel extends dxChartCommonAxisSettingsConstantLineStyleLabel {
  7278. /** Aligns constant line labels in the horizontal direction. */
  7279. horizontalAlignment?: 'center' | 'left' | 'right';
  7280. /** Specifies the text of a constant line label. By default, equals to the value of the constant line. */
  7281. text?: string;
  7282. /** Aligns constant line labels in the vertical direction. */
  7283. verticalAlignment?: 'bottom' | 'center' | 'top';
  7284. }
  7285. /** Configures the labels of the value axis. */
  7286. export interface dxChartValueAxisLabel extends dxChartCommonAxisSettingsLabel {
  7287. /** Specifies the hint that appears when a user points to an axis label. */
  7288. customizeHint?: ((axisValue: { value?: Date | number | string, valueText?: string }) => string);
  7289. /** Customizes the text displayed by axis labels. */
  7290. customizeText?: ((axisValue: { value?: Date | number | string, valueText?: string }) => string);
  7291. /** Formats a value before it is displayed in an axis label. */
  7292. format?: DevExpress.ui.format;
  7293. }
  7294. /** Declares a collection of strips belonging to the value axis. */
  7295. export interface dxChartValueAxisStrips extends dxChartCommonAxisSettingsStripStyle {
  7296. /** Specifies the color of the strip. */
  7297. color?: string;
  7298. /** Along with the startValue option, limits the strip. */
  7299. endValue?: number | Date | string;
  7300. /** Configures the strip label. */
  7301. label?: dxChartValueAxisStripsLabel;
  7302. /** Along with the endValue option, limits the strip. */
  7303. startValue?: number | Date | string;
  7304. }
  7305. /** Configures the strip label. */
  7306. export interface dxChartValueAxisStripsLabel extends dxChartCommonAxisSettingsStripStyleLabel {
  7307. /** Specifies the text of the strip label. */
  7308. text?: string;
  7309. }
  7310. /** Configures the axis title. */
  7311. export interface dxChartValueAxisTitle extends dxChartCommonAxisSettingsTitle {
  7312. /** Specifies the text of the axis title. */
  7313. text?: string;
  7314. }
  7315. /** The Chart is a widget that visualizes data from a local or remote storage using a great variety of series types along with different interactive elements, such as tooltips, crosshair pointer, legend, etc. */
  7316. export class dxChart extends BaseChart {
  7317. constructor(element: Element, options?: dxChartOptions)
  7318. constructor(element: JQuery, options?: dxChartOptions)
  7319. /** Gets the argument axis. */
  7320. getArgumentAxis(): chartAxisObject;
  7321. /** Gets a value axis. */
  7322. getValueAxis(): chartAxisObject;
  7323. /** Gets a value axis with the specified name. */
  7324. getValueAxis(name: string): chartAxisObject;
  7325. /** Resets the visual ranges of both axes to the data range or to the whole range if it is within the data range. */
  7326. resetVisualRange(): void;
  7327. /** Sets the argument axis' start and end values. */
  7328. zoomArgument(startValue: number | Date | string, endValue: number | Date | string): void;
  7329. }
  7330. export interface dxChartAnnotationConfig extends dxChartCommonAnnotationConfig {
  7331. /** Specifies the annotation's name. */
  7332. name?: string;
  7333. }
  7334. export interface dxChartCommonAnnotationConfig {
  7335. /** Specifies whether users can drag and drop the annotation. */
  7336. allowDragging?: boolean;
  7337. /** Positions the annotation relative to a specific argument. */
  7338. argument?: number | Date | string;
  7339. /** Specifies the length of the annotation's arrow in pixels. */
  7340. arrowLength?: number;
  7341. /** Specifies the width of the annotation's arrow at its junction with the annotation rectangle. */
  7342. arrowWidth?: number;
  7343. /** Specifies the name of the value axis on which the value is specified. Useful for a multi-axis chart. */
  7344. axis?: string;
  7345. /** Configures the appearance of the annotation's border. */
  7346. border?: { color?: string, cornerRadius?: number, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', opacity?: number, visible?: boolean, width?: number };
  7347. /** Specifies the color that fills the annotation. */
  7348. color?: string;
  7349. /** Customizes the text and appearance of the annotation's tooltip. */
  7350. customizeTooltip?: ((annotationItem: dxChartAnnotationConfig | any) => any);
  7351. /** Specifies the annotation's description displayed in the tooltip. */
  7352. description?: string;
  7353. /** Specifies the annotation's font options. Applies only to text annotations. */
  7354. font?: Font;
  7355. /** Specifies the annotation's height in pixels. */
  7356. height?: number;
  7357. /** Configures the image to be displayed in the annotation. Applies only if the type is "image". */
  7358. image?: string | { height?: number, url?: string, width?: number };
  7359. /** Moves the annotation horizontally. */
  7360. offsetX?: number;
  7361. /** Moves the annotation vertically. */
  7362. offsetY?: number;
  7363. /** Specifies the annotation's opacity. */
  7364. opacity?: number;
  7365. /** Along with paddingTopBottom, generates an empty space around the annotation's text or image; specified in pixels. */
  7366. paddingLeftRight?: number;
  7367. /** Along with paddingLeftRight, generates an empty space around the annotation's text or image; specified in pixels. */
  7368. paddingTopBottom?: number;
  7369. /** Anchors the annotation to a series point. Accepts the name of the point's series. */
  7370. series?: string;
  7371. /** Configures the annotation's shadows. */
  7372. shadow?: { blur?: number, color?: string, offsetX?: number, offsetY?: number, opacity?: number };
  7373. /** Specifies the annotation's text. Applies only if the type is "text". */
  7374. text?: string;
  7375. /** Specifies what to do with the annotation's text when it overflows the allocated space after applying wordWrap: hide, truncate it and display an ellipsis, or do nothing. */
  7376. textOverflow?: 'ellipsis' | 'hide' | 'none';
  7377. /** Specifies whether the annotation tooltip is enabled. */
  7378. tooltipEnabled?: boolean;
  7379. /** Specifies whether the annotation displays a text or an image. This is a required setting. */
  7380. type?: 'text' | 'image';
  7381. /** Positions the annotation relative to a value on the specified value axis. */
  7382. value?: number | Date | string;
  7383. /** Specifies the annotation's width in pixels. */
  7384. width?: number;
  7385. /** Specifies how to wrap the annotation's text if it does not fit into a single line. */
  7386. wordWrap?: 'normal' | 'breakWord' | 'none';
  7387. /** Along with y, positions the annotation's center at a specific pixel coordinate. (0, 0) is the upper left corner of the chart. */
  7388. x?: number;
  7389. /** Along with x, positions the annotation's center at a specific pixel coordinate. (0, 0) is the upper left corner of the chart. */
  7390. y?: number;
  7391. }
  7392. /** This section lists objects that define options used to configure series of specific types. */
  7393. interface dxChartSeriesTypes {
  7394. /** Describes settings supported by a series of the area type. */
  7395. AreaSeries?: dxChartSeriesTypesAreaSeries;
  7396. /** Describes settings supported by a series of the bar type. */
  7397. BarSeries?: dxChartSeriesTypesBarSeries;
  7398. /** Describes settings supported by a series of the bubble type. */
  7399. BubbleSeries?: dxChartSeriesTypesBubbleSeries;
  7400. /** Describes settings supported by a series of the candlestick type. */
  7401. CandleStickSeries?: dxChartSeriesTypesCandleStickSeries;
  7402. /** An object that defines configuration options for chart series. */
  7403. CommonSeries?: dxChartSeriesTypesCommonSeries;
  7404. /** Describes settings supported by a series of the full-stacked area type. */
  7405. FullStackedAreaSeries?: dxChartSeriesTypesFullStackedAreaSeries;
  7406. /** Describes settings supported by a series of the full-stacked bar type. */
  7407. FullStackedBarSeries?: dxChartSeriesTypesFullStackedBarSeries;
  7408. /** Describes settings supported by a series of the full-stacked line type. */
  7409. FullStackedLineSeries?: dxChartSeriesTypesFullStackedLineSeries;
  7410. /** Describes settings supported by a series of the full-stacked spline area type. */
  7411. FullStackedSplineAreaSeries?: dxChartSeriesTypesFullStackedSplineAreaSeries;
  7412. /** Describes settings supported by a series of the full-stacked spline area type. An object defining a series of the fullStackedSpline type. */
  7413. FullStackedSplineSeries?: dxChartSeriesTypesFullStackedSplineSeries;
  7414. /** Describes settings supported by a series of the line type. */
  7415. LineSeries?: dxChartSeriesTypesLineSeries;
  7416. /** Describes settings supported by a series of the range area type. */
  7417. RangeAreaSeries?: dxChartSeriesTypesRangeAreaSeries;
  7418. /** Describes settings supported by a series of the range bar type. */
  7419. RangeBarSeries?: dxChartSeriesTypesRangeBarSeries;
  7420. /** Describes settings supported by a series of the scatter type. */
  7421. ScatterSeries?: dxChartSeriesTypesScatterSeries;
  7422. /** Describes settings supported by a series of the spline area type. */
  7423. SplineAreaSeries?: dxChartSeriesTypesSplineAreaSeries;
  7424. /** Describes settings supported by a series of the spline type. */
  7425. SplineSeries?: dxChartSeriesTypesSplineSeries;
  7426. /** Describes settings supported by a series of the stacked area type. */
  7427. StackedAreaSeries?: dxChartSeriesTypesStackedAreaSeries;
  7428. /** Describes settings supported by a series of the stacked bar type. */
  7429. StackedBarSeries?: dxChartSeriesTypesStackedBarSeries;
  7430. /** Describes settings supported by a series of the stacked line type. */
  7431. StackedLineSeries?: dxChartSeriesTypesStackedLineSeries;
  7432. /** Describes settings supported by a series of the stacked spline area type. */
  7433. StackedSplineAreaSeries?: dxChartSeriesTypesStackedSplineAreaSeries;
  7434. /** Describes settings supported by a series of the stacked spline type. */
  7435. StackedSplineSeries?: dxChartSeriesTypesStackedSplineSeries;
  7436. /** Describes settings supported by a series of the step rea type. */
  7437. StepAreaSeries?: dxChartSeriesTypesStepAreaSeries;
  7438. /** Describes settings supported by a series of the step line type. */
  7439. StepLineSeries?: dxChartSeriesTypesStepLineSeries;
  7440. /** Describes settings supported by a series of the stock type. */
  7441. StockSeries?: dxChartSeriesTypesStockSeries;
  7442. }
  7443. /** Describes settings supported by a series of the area type. */
  7444. interface dxChartSeriesTypesAreaSeries extends dxChartSeriesTypesCommonSeries {
  7445. /** Configures data aggregation for the series. */
  7446. aggregation?: dxChartSeriesTypesAreaSeriesAggregation;
  7447. /** Specifies series elements to be highlighted when a user points to a series. */
  7448. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  7449. /** Configures point labels. */
  7450. label?: dxChartSeriesTypesAreaSeriesLabel;
  7451. /** Configures series points in scatter, line- and area-like series. */
  7452. point?: dxChartSeriesTypesAreaSeriesPoint;
  7453. /** Specifies series elements to be highlighted when a user selects a series. */
  7454. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  7455. }
  7456. /** Configures data aggregation for the series. */
  7457. interface dxChartSeriesTypesAreaSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7458. /** Specifies how to aggregate series points. */
  7459. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  7460. }
  7461. /** Configures point labels. */
  7462. interface dxChartSeriesTypesAreaSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7463. /** Customizes the text displayed by point labels. */
  7464. customizeText?: ((pointInfo: any) => string);
  7465. }
  7466. /** Configures series points in scatter, line- and area-like series. */
  7467. interface dxChartSeriesTypesAreaSeriesPoint extends dxChartSeriesTypesCommonSeriesPoint {
  7468. /** Makes the series points visible. */
  7469. visible?: boolean;
  7470. }
  7471. /** Describes settings supported by a series of the bar type. */
  7472. interface dxChartSeriesTypesBarSeries extends dxChartSeriesTypesCommonSeries {
  7473. /** Configures data aggregation for the series. */
  7474. aggregation?: dxChartSeriesTypesBarSeriesAggregation;
  7475. /** Specifies series elements to be highlighted when a user points to a series. */
  7476. hoverMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7477. /** Configures point labels. */
  7478. label?: dxChartSeriesTypesBarSeriesLabel;
  7479. /** Specifies series elements to be highlighted when a user selects a bar. */
  7480. selectionMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7481. }
  7482. /** Configures data aggregation for the series. */
  7483. interface dxChartSeriesTypesBarSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7484. /** Specifies how to aggregate series points. */
  7485. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  7486. }
  7487. /** Configures point labels. */
  7488. interface dxChartSeriesTypesBarSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7489. /** Customizes the text displayed by point labels. */
  7490. customizeText?: ((pointInfo: any) => string);
  7491. }
  7492. /** Describes settings supported by a series of the bubble type. */
  7493. interface dxChartSeriesTypesBubbleSeries extends dxChartSeriesTypesCommonSeries {
  7494. /** Configures data aggregation for the series. */
  7495. aggregation?: dxChartSeriesTypesBubbleSeriesAggregation;
  7496. /** Specifies series elements to be highlighted when a user points to a series. */
  7497. hoverMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7498. /** Configures point labels. */
  7499. label?: dxChartSeriesTypesBubbleSeriesLabel;
  7500. /** Specifies series elements to be highlighted when a user selects a bubble. */
  7501. selectionMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7502. }
  7503. /** Configures data aggregation for the series. */
  7504. interface dxChartSeriesTypesBubbleSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7505. /** Specifies how to aggregate series points. */
  7506. method?: 'avg' | 'custom';
  7507. }
  7508. /** Configures point labels. */
  7509. interface dxChartSeriesTypesBubbleSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7510. /** Customizes the text displayed by point labels. */
  7511. customizeText?: ((pointInfo: any) => string);
  7512. }
  7513. /** Describes settings supported by a series of the candlestick type. */
  7514. interface dxChartSeriesTypesCandleStickSeries extends dxChartSeriesTypesCommonSeries {
  7515. /** Configures data aggregation for the series. */
  7516. aggregation?: dxChartSeriesTypesCandleStickSeriesAggregation;
  7517. /** Specifies which data source field provides arguments for series points. */
  7518. argumentField?: string;
  7519. /** Specifies series elements to be highlighted when a user pauses on a series. */
  7520. hoverMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7521. /** Configures the appearance adopted by the series when a user points to it. */
  7522. hoverStyle?: dxChartSeriesTypesCandleStickSeriesHoverStyle;
  7523. /** Configures point labels. */
  7524. label?: dxChartSeriesTypesCandleStickSeriesLabel;
  7525. /** Specifies series elements to be highlighted when a user selects a point. */
  7526. selectionMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7527. /** Configures the appearance adopted by the series when a user selects it. */
  7528. selectionStyle?: dxChartSeriesTypesCandleStickSeriesSelectionStyle;
  7529. }
  7530. /** Configures data aggregation for the series. */
  7531. interface dxChartSeriesTypesCandleStickSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7532. /** Specifies how to aggregate series points. */
  7533. method?: 'ohlc' | 'custom';
  7534. }
  7535. /** Configures the appearance adopted by the series when a user points to it. */
  7536. interface dxChartSeriesTypesCandleStickSeriesHoverStyle extends dxChartSeriesTypesCommonSeriesHoverStyle {
  7537. /** Configures hatching that applies when a user points to the series. */
  7538. hatching?: dxChartSeriesTypesCandleStickSeriesHoverStyleHatching;
  7539. }
  7540. /** Configures hatching that applies when a user points to the series. */
  7541. interface dxChartSeriesTypesCandleStickSeriesHoverStyleHatching extends dxChartSeriesTypesCommonSeriesHoverStyleHatching {
  7542. /** Specifies the direction of hatching lines. */
  7543. direction?: 'left' | 'none' | 'right';
  7544. }
  7545. /** Configures point labels. */
  7546. interface dxChartSeriesTypesCandleStickSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7547. /** Customizes the text displayed by point labels. */
  7548. customizeText?: ((pointInfo: any) => string);
  7549. }
  7550. /** Configures the appearance adopted by the series when a user selects it. */
  7551. interface dxChartSeriesTypesCandleStickSeriesSelectionStyle extends dxChartSeriesTypesCommonSeriesSelectionStyle {
  7552. /** Configures hatching that applies when a user selects the series. */
  7553. hatching?: dxChartSeriesTypesCandleStickSeriesSelectionStyleHatching;
  7554. }
  7555. /** Configures hatching that applies when a user selects the series. */
  7556. interface dxChartSeriesTypesCandleStickSeriesSelectionStyleHatching extends dxChartSeriesTypesCommonSeriesSelectionStyleHatching {
  7557. /** Specifies the direction of hatching lines. */
  7558. direction?: 'left' | 'none' | 'right';
  7559. }
  7560. /** An object that defines configuration options for chart series. */
  7561. interface dxChartSeriesTypesCommonSeries {
  7562. /** Configures data aggregation for the series. */
  7563. aggregation?: dxChartSeriesTypesCommonSeriesAggregation;
  7564. /** Specifies which data source field provides arguments for series points. */
  7565. argumentField?: string;
  7566. /** Binds the series to a value axis. */
  7567. axis?: string;
  7568. /** Allows you to group bar series so that bars with the same argument overlap. */
  7569. barOverlapGroup?: string;
  7570. /** Controls the padding and consequently the width of all bars in a series using relative units. Ignored if the barWidth option is set. */
  7571. barPadding?: number;
  7572. /** Specifies a fixed width for all bars in a series, measured in pixels. Takes precedence over the barPadding option. */
  7573. barWidth?: number;
  7574. /** Configures the series border (in area-like series) or the series point border (in bar-like and bubble series). */
  7575. border?: dxChartSeriesTypesCommonSeriesBorder;
  7576. /** Specifies which data source field provides close values for points of a financial series. */
  7577. closeValueField?: string;
  7578. /** Specifies the color of the series. */
  7579. color?: string;
  7580. /** Makes bars look rounded. Applies only to bar-like series. */
  7581. cornerRadius?: number;
  7582. /** Specifies the dash style of the series line. Applies only to line-like series. */
  7583. dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid';
  7584. /** Specifies which data source field provides high values for points of a financial series. */
  7585. highValueField?: string;
  7586. /** Specifies series elements to be highlighted when a user points to a series. */
  7587. hoverMode?: 'allArgumentPoints' | 'allSeriesPoints' | 'excludePoints' | 'includePoints' | 'nearestPoint' | 'none' | 'onlyPoint';
  7588. /** Configures the appearance adopted by the series when a user points to it. */
  7589. hoverStyle?: dxChartSeriesTypesCommonSeriesHoverStyle;
  7590. /** Specifies whether the series should ignore null data points. */
  7591. ignoreEmptyPoints?: boolean;
  7592. /** Specifies a filling color for the body of a series point that visualizes a non-reduced value. Applies only to candlestick series. */
  7593. innerColor?: string;
  7594. /** Configures point labels. */
  7595. label?: dxChartSeriesTypesCommonSeriesLabel;
  7596. /** Specifies which data source field provides low values for points of a financial series. */
  7597. lowValueField?: string;
  7598. /** Specifies a limit for the number of point labels. */
  7599. maxLabelCount?: number;
  7600. /** Specifies the minimal possible height (or length if the chart is rotated) of a bar in pixels. Applies only to bar-like series. */
  7601. minBarSize?: number;
  7602. /** Specifies how transparent the series should be. */
  7603. opacity?: number;
  7604. /** Specifies which data source field provides open values for points of a financial series. */
  7605. openValueField?: string;
  7606. /** Specifies which pane the series should belong to. Accepts the name of the pane. */
  7607. pane?: string;
  7608. /** Configures series points in scatter, line- and area-like series. */
  7609. point?: dxChartSeriesTypesCommonSeriesPoint;
  7610. /** Coupled with the rangeValue2Field option, specifies which data source field provides values for a range-like series. */
  7611. rangeValue1Field?: string;
  7612. /** Coupled with the rangeValue1Field option, specifies which data source field provides values for a range-like series. */
  7613. rangeValue2Field?: string;
  7614. /** Specifies reduction options for financial series. */
  7615. reduction?: { color?: string, level?: 'close' | 'high' | 'low' | 'open' };
  7616. /** Specifies series elements to be highlighted when a user selects a series. */
  7617. selectionMode?: 'allArgumentPoints' | 'allSeriesPoints' | 'excludePoints' | 'includePoints' | 'none' | 'onlyPoint';
  7618. /** Configures the appearance adopted by the series when a user selects it. */
  7619. selectionStyle?: dxChartSeriesTypesCommonSeriesSelectionStyle;
  7620. /** Specifies whether to show the series in the legend or not. */
  7621. showInLegend?: boolean;
  7622. /** Specifies which data source field provides size values for bubbles. Required by and applies only to bubble series. */
  7623. sizeField?: string;
  7624. /** Specifies which stack the series should belongs to. Applies only to stacked bar and full-stacked bar series. */
  7625. stack?: string;
  7626. /** Specifies which data source field provides auxiliary data for series points. */
  7627. tagField?: string;
  7628. /** Configures error bars. */
  7629. valueErrorBar?: { color?: string, displayMode?: 'auto' | 'high' | 'low' | 'none', edgeLength?: number, highValueField?: string, lineWidth?: number, lowValueField?: string, opacity?: number, type?: 'fixed' | 'percent' | 'stdDeviation' | 'stdError' | 'variance', value?: number };
  7630. /** Specifies which data source field provides values for series points. */
  7631. valueField?: string;
  7632. /** Specifies whether the series is visible or not. */
  7633. visible?: boolean;
  7634. /** Specifies the width of the series line in pixels. Applies only to line-like series. */
  7635. width?: number;
  7636. }
  7637. /** Configures data aggregation for the series. */
  7638. interface dxChartSeriesTypesCommonSeriesAggregation {
  7639. /** Specifies a custom aggregate function. Applies only if the aggregation method is "custom". */
  7640. calculate?: ((aggregationInfo: chartPointAggregationInfoObject, series: chartSeriesObject) => any | Array<any>);
  7641. /** Enables data aggregation for the series. */
  7642. enabled?: boolean;
  7643. /** Specifies how to aggregate series points. */
  7644. method?: 'avg' | 'count' | 'max' | 'min' | 'ohlc' | 'range' | 'sum' | 'custom';
  7645. }
  7646. /** Configures the series border (in area-like series) or the series point border (in bar-like and bubble series). */
  7647. interface dxChartSeriesTypesCommonSeriesBorder {
  7648. /** Colors the series border (in area-like series) or the series point border (in bar-like and bubble series). */
  7649. color?: string;
  7650. /** Sets a dash style for the series border (in area-like series) or for the series point border (in bar-like and bubble series). */
  7651. dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid';
  7652. /** Shows the series border (in area-like series) or the series point border (in bar-like and bubble series). */
  7653. visible?: boolean;
  7654. /** Sets a pixel-measured width for the series border (in area-like series) or for the series point border (in bar-like and bubble series). */
  7655. width?: number;
  7656. }
  7657. /** Configures the appearance adopted by the series when a user points to it. */
  7658. interface dxChartSeriesTypesCommonSeriesHoverStyle {
  7659. /** Configures the appearance adopted by the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user points to the series. */
  7660. border?: dxChartSeriesTypesCommonSeriesHoverStyleBorder;
  7661. /** Specifies the color of the series in the hovered state. */
  7662. color?: string;
  7663. /** Specifies the dash style of the series line when the series is in the hovered state. Applies only to line-like series. */
  7664. dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid';
  7665. /** Configures hatching that applies when a user points to the series. */
  7666. hatching?: dxChartSeriesTypesCommonSeriesHoverStyleHatching;
  7667. /** Specifies the pixel-measured width of the series line when the series is in the hovered state. */
  7668. width?: number;
  7669. }
  7670. /** Configures the appearance adopted by the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user points to the series. */
  7671. interface dxChartSeriesTypesCommonSeriesHoverStyleBorder {
  7672. /** Colors the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user points to the series. */
  7673. color?: string;
  7674. /** Sets a dash style for the series border (in area-like series) or for the series point border (in bar-like and bubble series) when a user points to the series. */
  7675. dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid';
  7676. /** Shows the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user points to the series. */
  7677. visible?: boolean;
  7678. /** Sets a pixel-measured width for the series border (in area-like series) or for the series point border (in bar-like and bubble series) when a user points to the series. */
  7679. width?: number;
  7680. }
  7681. /** Configures hatching that applies when a user points to the series. */
  7682. interface dxChartSeriesTypesCommonSeriesHoverStyleHatching {
  7683. /** Specifies the direction of hatching lines. */
  7684. direction?: 'left' | 'none' | 'right';
  7685. /** Specifies how transparent hatching lines should be. */
  7686. opacity?: number;
  7687. /** Specifies the distance between two side-by-side hatching lines in pixels. */
  7688. step?: number;
  7689. /** Specifies the width of hatching lines in pixels. */
  7690. width?: number;
  7691. }
  7692. /** Configures point labels. */
  7693. interface dxChartSeriesTypesCommonSeriesLabel {
  7694. /** Aligns point labels in relation to their points. */
  7695. alignment?: 'center' | 'left' | 'right';
  7696. /** Formats the point argument before it is displayed in the point label. To format the point value, use the format option. */
  7697. argumentFormat?: DevExpress.ui.format;
  7698. /** Colors the point labels' background. The default color is inherited from the points. */
  7699. backgroundColor?: string;
  7700. /** Configures the borders of point labels. */
  7701. border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number };
  7702. /** Configures the label connectors. */
  7703. connector?: { color?: string, visible?: boolean, width?: number };
  7704. /** Customizes the text displayed by point labels. */
  7705. customizeText?: ((pointInfo: any) => string);
  7706. /** Specifies font options for point labels. */
  7707. font?: Font;
  7708. /** Formats the point value before it will be displayed in the point label. */
  7709. format?: DevExpress.ui.format;
  7710. /** Along with verticalOffset, shifts point labels from their initial positions. */
  7711. horizontalOffset?: number;
  7712. /** Specifies whether to display point labels inside or outside of series points. Applies only to bubble, range-like and bar-like series. */
  7713. position?: 'inside' | 'outside';
  7714. /** Rotates point labels. */
  7715. rotationAngle?: number;
  7716. /** Specifies whether or not to show labels for points with zero value. Applies only to bar-like series. */
  7717. showForZeroValues?: boolean;
  7718. /** Along with horizontalOffset, shifts point labels from their initial positions. */
  7719. verticalOffset?: number;
  7720. /** Makes the point labels visible. */
  7721. visible?: boolean;
  7722. }
  7723. /** Configures series points in scatter, line- and area-like series. */
  7724. interface dxChartSeriesTypesCommonSeriesPoint {
  7725. /** Configures the appearance of the series point border in scatter, line- and area-like series. */
  7726. border?: { color?: string, visible?: boolean, width?: number };
  7727. /** Colors the series points. */
  7728. color?: string;
  7729. /** Specifies series elements to be highlighted when a user pauses on a series point. */
  7730. hoverMode?: 'allArgumentPoints' | 'allSeriesPoints' | 'none' | 'onlyPoint';
  7731. /** Configures the appearance adopted by a series point when a user pauses on it. */
  7732. hoverStyle?: { border?: { color?: string, visible?: boolean, width?: number }, color?: string, size?: number };
  7733. /** Substitutes the standard point symbols with an image. */
  7734. image?: string | { height?: number | { rangeMaxPoint?: number, rangeMinPoint?: number }, url?: string | { rangeMaxPoint?: string, rangeMinPoint?: string }, width?: number | { rangeMaxPoint?: number, rangeMinPoint?: number } };
  7735. /** Specifies series elements to be highlighted when a user selects a series point. */
  7736. selectionMode?: 'allArgumentPoints' | 'allSeriesPoints' | 'none' | 'onlyPoint';
  7737. /** Configures the appearance of a selected series point. */
  7738. selectionStyle?: { border?: { color?: string, visible?: boolean, width?: number }, color?: string, size?: number };
  7739. /** Specifies the diameter of series points in pixels. */
  7740. size?: number;
  7741. /** Specifies which symbol should represent series points in scatter, line- and area-like series. */
  7742. symbol?: 'circle' | 'cross' | 'polygon' | 'square' | 'triangleDown' | 'triangleUp';
  7743. /** Makes the series points visible. */
  7744. visible?: boolean;
  7745. }
  7746. /** Configures the appearance adopted by the series when a user selects it. */
  7747. interface dxChartSeriesTypesCommonSeriesSelectionStyle {
  7748. /** Configures the appearance adopted by the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user selects the series. */
  7749. border?: dxChartSeriesTypesCommonSeriesSelectionStyleBorder;
  7750. /** Specifies the color of the series in the selected state. */
  7751. color?: string;
  7752. /** Specifies the dash style of the series line when the series is in the selected state. Applies only to line-like series. */
  7753. dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid';
  7754. /** Configures hatching that applies when a user selects the series. */
  7755. hatching?: dxChartSeriesTypesCommonSeriesSelectionStyleHatching;
  7756. /** Specifies the pixel-measured width of the series line when the series is in the selected state. */
  7757. width?: number;
  7758. }
  7759. /** Configures the appearance adopted by the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user selects the series. */
  7760. interface dxChartSeriesTypesCommonSeriesSelectionStyleBorder {
  7761. /** Colors the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user selects the series. */
  7762. color?: string;
  7763. /** Sets a dash style for the series border (in area-like series) or for the series point border (in bar-like and bubble series) when a user selects the series. */
  7764. dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid';
  7765. /** Shows the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user selects the series. */
  7766. visible?: boolean;
  7767. /** Sets a pixel-measured width for the series border (in area-like series) or for the series point border (in bar-like and bubble series) when a user selects the series. */
  7768. width?: number;
  7769. }
  7770. /** Configures hatching that applies when a user selects the series. */
  7771. interface dxChartSeriesTypesCommonSeriesSelectionStyleHatching {
  7772. /** Specifies the direction of hatching lines. */
  7773. direction?: 'left' | 'none' | 'right';
  7774. /** Specifies how transparent hatching lines should be. */
  7775. opacity?: number;
  7776. /** Specifies the distance between two side-by-side hatching lines in pixels. */
  7777. step?: number;
  7778. /** Specifies the width of hatching lines in pixels. */
  7779. width?: number;
  7780. }
  7781. /** Describes settings supported by a series of the full-stacked area type. */
  7782. interface dxChartSeriesTypesFullStackedAreaSeries extends dxChartSeriesTypesCommonSeries {
  7783. /** Configures data aggregation for the series. */
  7784. aggregation?: dxChartSeriesTypesFullStackedAreaSeriesAggregation;
  7785. /** Specifies series elements to be highlighted when a user points to a series. */
  7786. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  7787. /** An object defining the label configuration options. */
  7788. label?: dxChartSeriesTypesFullStackedAreaSeriesLabel;
  7789. /** Configures series points in scatter, line- and area-like series. */
  7790. point?: dxChartSeriesTypesFullStackedAreaSeriesPoint;
  7791. /** Specifies series elements to be highlighted when a user selects a series. */
  7792. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  7793. }
  7794. /** Configures data aggregation for the series. */
  7795. interface dxChartSeriesTypesFullStackedAreaSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7796. /** Specifies how to aggregate series points. */
  7797. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  7798. }
  7799. /** An object defining the label configuration options. */
  7800. interface dxChartSeriesTypesFullStackedAreaSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7801. /** Customizes the text displayed by point labels. */
  7802. customizeText?: ((pointInfo: any) => string);
  7803. }
  7804. /** Configures series points in scatter, line- and area-like series. */
  7805. interface dxChartSeriesTypesFullStackedAreaSeriesPoint extends dxChartSeriesTypesCommonSeriesPoint {
  7806. /** Makes the series points visible. */
  7807. visible?: boolean;
  7808. }
  7809. /** Describes settings supported by a series of the full-stacked bar type. */
  7810. interface dxChartSeriesTypesFullStackedBarSeries extends dxChartSeriesTypesCommonSeries {
  7811. /** Configures data aggregation for the series. */
  7812. aggregation?: dxChartSeriesTypesFullStackedBarSeriesAggregation;
  7813. /** Specifies series elements to be highlighted when a user points to a series. */
  7814. hoverMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7815. /** Configures point labels. */
  7816. label?: dxChartSeriesTypesFullStackedBarSeriesLabel;
  7817. /** Specifies series elements to be highlighted when a user selects a bar. */
  7818. selectionMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7819. }
  7820. /** Configures data aggregation for the series. */
  7821. interface dxChartSeriesTypesFullStackedBarSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7822. /** Specifies how to aggregate series points. */
  7823. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  7824. }
  7825. /** Configures point labels. */
  7826. interface dxChartSeriesTypesFullStackedBarSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7827. /** Customizes the text displayed by point labels. */
  7828. customizeText?: ((pointInfo: any) => string);
  7829. /** Specifies whether to display point labels inside or outside of series points. Applies only to bubble, range-like and bar-like series. */
  7830. position?: 'inside' | 'outside';
  7831. }
  7832. /** Describes settings supported by a series of the full-stacked line type. */
  7833. interface dxChartSeriesTypesFullStackedLineSeries extends dxChartSeriesTypesCommonSeries {
  7834. /** Configures data aggregation for the series. */
  7835. aggregation?: dxChartSeriesTypesFullStackedLineSeriesAggregation;
  7836. /** Specifies series elements to be highlighted when a user points to a series. */
  7837. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  7838. /** Configures point labels. */
  7839. label?: dxChartSeriesTypesFullStackedLineSeriesLabel;
  7840. /** Specifies series elements to be highlighted when a user selects a series. */
  7841. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  7842. }
  7843. /** Configures data aggregation for the series. */
  7844. interface dxChartSeriesTypesFullStackedLineSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7845. /** Specifies how to aggregate series points. */
  7846. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  7847. }
  7848. /** Configures point labels. */
  7849. interface dxChartSeriesTypesFullStackedLineSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7850. /** Customizes the text displayed by point labels. */
  7851. customizeText?: ((pointInfo: any) => string);
  7852. }
  7853. /** Describes settings supported by a series of the full-stacked spline area type. */
  7854. interface dxChartSeriesTypesFullStackedSplineAreaSeries extends dxChartSeriesTypesCommonSeries {
  7855. /** Configures data aggregation for the series. */
  7856. aggregation?: dxChartSeriesTypesFullStackedSplineAreaSeriesAggregation;
  7857. /** Specifies series elements to be highlighted when a user points to a series. */
  7858. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  7859. /** Configures point labels. */
  7860. label?: dxChartSeriesTypesFullStackedSplineAreaSeriesLabel;
  7861. /** Configures series points in scatter, line- and area-like series. */
  7862. point?: dxChartSeriesTypesFullStackedSplineAreaSeriesPoint;
  7863. /** Specifies series elements to be highlighted when a user selects a series. */
  7864. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  7865. }
  7866. /** Configures data aggregation for the series. */
  7867. interface dxChartSeriesTypesFullStackedSplineAreaSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7868. /** Specifies how to aggregate series points. */
  7869. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  7870. }
  7871. /** Configures point labels. */
  7872. interface dxChartSeriesTypesFullStackedSplineAreaSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7873. /** Customizes the text displayed by point labels. */
  7874. customizeText?: ((pointInfo: any) => string);
  7875. }
  7876. /** Configures series points in scatter, line- and area-like series. */
  7877. interface dxChartSeriesTypesFullStackedSplineAreaSeriesPoint extends dxChartSeriesTypesCommonSeriesPoint {
  7878. /** Makes the series points visible. */
  7879. visible?: boolean;
  7880. }
  7881. /** Describes settings supported by a series of the full-stacked spline area type. An object defining a series of the fullStackedSpline type. */
  7882. interface dxChartSeriesTypesFullStackedSplineSeries extends dxChartSeriesTypesCommonSeries {
  7883. /** Configures data aggregation for the series. */
  7884. aggregation?: dxChartSeriesTypesFullStackedSplineSeriesAggregation;
  7885. /** Specifies series elements to be highlighted when a user points to a series. */
  7886. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  7887. /** Configures point labels. */
  7888. label?: dxChartSeriesTypesFullStackedSplineSeriesLabel;
  7889. /** Specifies series elements to be highlighted when a user selects a series. */
  7890. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  7891. }
  7892. /** Configures data aggregation for the series. */
  7893. interface dxChartSeriesTypesFullStackedSplineSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7894. /** Specifies how to aggregate series points. */
  7895. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  7896. }
  7897. /** Configures point labels. */
  7898. interface dxChartSeriesTypesFullStackedSplineSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7899. /** Customizes the text displayed by point labels. */
  7900. customizeText?: ((pointInfo: any) => string);
  7901. }
  7902. /** Describes settings supported by a series of the line type. */
  7903. interface dxChartSeriesTypesLineSeries extends dxChartSeriesTypesCommonSeries {
  7904. /** Configures data aggregation for the series. */
  7905. aggregation?: dxChartSeriesTypesLineSeriesAggregation;
  7906. /** Specifies series elements to be highlighted when a user points to a series. */
  7907. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  7908. /** Configures point labels. */
  7909. label?: dxChartSeriesTypesLineSeriesLabel;
  7910. /** Specifies series elements to be highlighted when a user selects a series. */
  7911. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  7912. }
  7913. /** Configures data aggregation for the series. */
  7914. interface dxChartSeriesTypesLineSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7915. /** Specifies how to aggregate series points. */
  7916. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  7917. }
  7918. /** Configures point labels. */
  7919. interface dxChartSeriesTypesLineSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7920. /** Customizes the text displayed by point labels. */
  7921. customizeText?: ((pointInfo: any) => string);
  7922. }
  7923. /** Describes settings supported by a series of the range area type. */
  7924. interface dxChartSeriesTypesRangeAreaSeries extends dxChartSeriesTypesCommonSeries {
  7925. /** Configures data aggregation for the series. */
  7926. aggregation?: dxChartSeriesTypesRangeAreaSeriesAggregation;
  7927. /** Specifies series elements to be highlighted when a user points to a series. */
  7928. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  7929. /** Configures point labels. */
  7930. label?: dxChartSeriesTypesRangeAreaSeriesLabel;
  7931. /** Configures series points in scatter, line- and area-like series. */
  7932. point?: dxChartSeriesTypesRangeAreaSeriesPoint;
  7933. /** Specifies series elements to be highlighted when a user selects a series. */
  7934. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  7935. }
  7936. /** Configures data aggregation for the series. */
  7937. interface dxChartSeriesTypesRangeAreaSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7938. /** Specifies how to aggregate series points. */
  7939. method?: 'range' | 'custom';
  7940. }
  7941. /** Configures point labels. */
  7942. interface dxChartSeriesTypesRangeAreaSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7943. /** Customizes the text displayed by point labels. */
  7944. customizeText?: ((pointInfo: any) => string);
  7945. }
  7946. /** Configures series points in scatter, line- and area-like series. */
  7947. interface dxChartSeriesTypesRangeAreaSeriesPoint extends dxChartSeriesTypesCommonSeriesPoint {
  7948. /** Makes the series points visible. */
  7949. visible?: boolean;
  7950. }
  7951. /** Describes settings supported by a series of the range bar type. */
  7952. interface dxChartSeriesTypesRangeBarSeries extends dxChartSeriesTypesCommonSeries {
  7953. /** Configures data aggregation for the series. */
  7954. aggregation?: dxChartSeriesTypesRangeBarSeriesAggregation;
  7955. /** Specifies series elements to be highlighted when a user points to a series. */
  7956. hoverMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7957. /** Configures point labels. */
  7958. label?: dxChartSeriesTypesRangeBarSeriesLabel;
  7959. /** Specifies series elements to be highlighted when a user selects a range bar. */
  7960. selectionMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  7961. }
  7962. /** Configures data aggregation for the series. */
  7963. interface dxChartSeriesTypesRangeBarSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7964. /** Specifies how to aggregate series points. */
  7965. method?: 'range' | 'custom';
  7966. }
  7967. /** Configures point labels. */
  7968. interface dxChartSeriesTypesRangeBarSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7969. /** Customizes the text displayed by point labels. */
  7970. customizeText?: ((pointInfo: any) => string);
  7971. }
  7972. /** Describes settings supported by a series of the scatter type. */
  7973. interface dxChartSeriesTypesScatterSeries extends dxChartSeriesTypesCommonSeries {
  7974. /** Configures data aggregation for the series. */
  7975. aggregation?: dxChartSeriesTypesScatterSeriesAggregation;
  7976. /** Configures point labels. */
  7977. label?: dxChartSeriesTypesScatterSeriesLabel;
  7978. }
  7979. /** Configures data aggregation for the series. */
  7980. interface dxChartSeriesTypesScatterSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  7981. /** Specifies how to aggregate series points. */
  7982. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  7983. }
  7984. /** Configures point labels. */
  7985. interface dxChartSeriesTypesScatterSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  7986. /** Customizes the text displayed by point labels. */
  7987. customizeText?: ((pointInfo: any) => string);
  7988. }
  7989. /** Describes settings supported by a series of the spline area type. */
  7990. interface dxChartSeriesTypesSplineAreaSeries extends dxChartSeriesTypesCommonSeries {
  7991. /** Configures data aggregation for the series. */
  7992. aggregation?: dxChartSeriesTypesSplineAreaSeriesAggregation;
  7993. /** Specifies series elements to be highlighted when a user points to a series. */
  7994. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  7995. /** Configures point labels. */
  7996. label?: dxChartSeriesTypesSplineAreaSeriesLabel;
  7997. /** Configures series points in scatter, line- and area-like series. */
  7998. point?: dxChartSeriesTypesSplineAreaSeriesPoint;
  7999. /** Specifies series elements to be highlighted when a user selects a series. */
  8000. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  8001. }
  8002. /** Configures data aggregation for the series. */
  8003. interface dxChartSeriesTypesSplineAreaSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8004. /** Specifies how to aggregate series points. */
  8005. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  8006. }
  8007. /** Configures point labels. */
  8008. interface dxChartSeriesTypesSplineAreaSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8009. /** Customizes the text displayed by point labels. */
  8010. customizeText?: ((pointInfo: any) => string);
  8011. }
  8012. /** Configures series points in scatter, line- and area-like series. */
  8013. interface dxChartSeriesTypesSplineAreaSeriesPoint extends dxChartSeriesTypesCommonSeriesPoint {
  8014. /** Makes the series points visible. */
  8015. visible?: boolean;
  8016. }
  8017. /** Describes settings supported by a series of the spline type. */
  8018. interface dxChartSeriesTypesSplineSeries extends dxChartSeriesTypesCommonSeries {
  8019. /** Configures data aggregation for the series. */
  8020. aggregation?: dxChartSeriesTypesSplineSeriesAggregation;
  8021. /** Specifies series elements to be highlighted when a user points to a series. */
  8022. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  8023. /** Configures point labels. */
  8024. label?: dxChartSeriesTypesSplineSeriesLabel;
  8025. /** Specifies series elements to be highlighted when a user selects a series. */
  8026. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  8027. }
  8028. /** Configures data aggregation for the series. */
  8029. interface dxChartSeriesTypesSplineSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8030. /** Specifies how to aggregate series points. */
  8031. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  8032. }
  8033. /** Configures point labels. */
  8034. interface dxChartSeriesTypesSplineSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8035. /** Customizes the text displayed by point labels. */
  8036. customizeText?: ((pointInfo: any) => string);
  8037. }
  8038. /** Describes settings supported by a series of the stacked area type. */
  8039. interface dxChartSeriesTypesStackedAreaSeries extends dxChartSeriesTypesCommonSeries {
  8040. /** Configures data aggregation for the series. */
  8041. aggregation?: dxChartSeriesTypesStackedAreaSeriesAggregation;
  8042. /** Specifies series elements to be highlighted when a user points to a series. */
  8043. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  8044. /** Configures point labels. */
  8045. label?: dxChartSeriesTypesStackedAreaSeriesLabel;
  8046. /** Configures series points in scatter, line- and area-like series. */
  8047. point?: dxChartSeriesTypesStackedAreaSeriesPoint;
  8048. /** Specifies series elements to be highlighted when a user selects a series. */
  8049. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  8050. }
  8051. /** Configures data aggregation for the series. */
  8052. interface dxChartSeriesTypesStackedAreaSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8053. /** Specifies how to aggregate series points. */
  8054. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  8055. }
  8056. /** Configures point labels. */
  8057. interface dxChartSeriesTypesStackedAreaSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8058. /** Customizes the text displayed by point labels. */
  8059. customizeText?: ((pointInfo: any) => string);
  8060. }
  8061. /** Configures series points in scatter, line- and area-like series. */
  8062. interface dxChartSeriesTypesStackedAreaSeriesPoint extends dxChartSeriesTypesCommonSeriesPoint {
  8063. /** Makes the series points visible. */
  8064. visible?: boolean;
  8065. }
  8066. /** Describes settings supported by a series of the stacked bar type. */
  8067. interface dxChartSeriesTypesStackedBarSeries extends dxChartSeriesTypesCommonSeries {
  8068. /** Configures data aggregation for the series. */
  8069. aggregation?: dxChartSeriesTypesStackedBarSeriesAggregation;
  8070. /** Specifies series elements to be highlighted when a user points to a series. */
  8071. hoverMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  8072. /** Configures point labels. */
  8073. label?: dxChartSeriesTypesStackedBarSeriesLabel;
  8074. /** Specifies series elements to be highlighted when a user selects a bar. */
  8075. selectionMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  8076. }
  8077. /** Configures data aggregation for the series. */
  8078. interface dxChartSeriesTypesStackedBarSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8079. /** Specifies how to aggregate series points. */
  8080. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  8081. }
  8082. /** Configures point labels. */
  8083. interface dxChartSeriesTypesStackedBarSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8084. /** Customizes the text displayed by point labels. */
  8085. customizeText?: ((pointInfo: any) => string);
  8086. /** Specifies whether to display point labels inside or outside of series points. Applies only to bubble, range-like and bar-like series. */
  8087. position?: 'inside' | 'outside';
  8088. }
  8089. /** Describes settings supported by a series of the stacked line type. */
  8090. interface dxChartSeriesTypesStackedLineSeries extends dxChartSeriesTypesCommonSeries {
  8091. /** Configures data aggregation for the series. */
  8092. aggregation?: dxChartSeriesTypesStackedLineSeriesAggregation;
  8093. /** Specifies series elements to be highlighted when a user points to a series. */
  8094. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  8095. /** Configures point labels. */
  8096. label?: dxChartSeriesTypesStackedLineSeriesLabel;
  8097. /** Specifies series elements to be highlighted when a user selects a series. */
  8098. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  8099. }
  8100. /** Configures data aggregation for the series. */
  8101. interface dxChartSeriesTypesStackedLineSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8102. /** Specifies how to aggregate series points. */
  8103. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  8104. }
  8105. /** Configures point labels. */
  8106. interface dxChartSeriesTypesStackedLineSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8107. /** Customizes the text displayed by point labels. */
  8108. customizeText?: ((pointInfo: any) => string);
  8109. }
  8110. /** Describes settings supported by a series of the stacked spline area type. */
  8111. interface dxChartSeriesTypesStackedSplineAreaSeries extends dxChartSeriesTypesCommonSeries {
  8112. /** Configures data aggregation for the series. */
  8113. aggregation?: dxChartSeriesTypesStackedSplineAreaSeriesAggregation;
  8114. /** Specifies series elements to be highlighted when a user points to a series. */
  8115. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  8116. /** Configures point labels. */
  8117. label?: dxChartSeriesTypesStackedSplineAreaSeriesLabel;
  8118. /** Configures series points in scatter, line- and area-like series. */
  8119. point?: dxChartSeriesTypesStackedSplineAreaSeriesPoint;
  8120. /** Specifies series elements to be highlighted when a user selects a series. */
  8121. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  8122. }
  8123. /** Configures data aggregation for the series. */
  8124. interface dxChartSeriesTypesStackedSplineAreaSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8125. /** Specifies how to aggregate series points. */
  8126. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  8127. }
  8128. /** Configures point labels. */
  8129. interface dxChartSeriesTypesStackedSplineAreaSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8130. /** Customizes the text displayed by point labels. */
  8131. customizeText?: ((pointInfo: any) => string);
  8132. }
  8133. /** Configures series points in scatter, line- and area-like series. */
  8134. interface dxChartSeriesTypesStackedSplineAreaSeriesPoint extends dxChartSeriesTypesCommonSeriesPoint {
  8135. /** Makes the series points visible. */
  8136. visible?: boolean;
  8137. }
  8138. /** Describes settings supported by a series of the stacked spline type. */
  8139. interface dxChartSeriesTypesStackedSplineSeries extends dxChartSeriesTypesCommonSeries {
  8140. /** Configures data aggregation for the series. */
  8141. aggregation?: dxChartSeriesTypesStackedSplineSeriesAggregation;
  8142. /** Specifies series elements to be highlighted when a user points to a series. */
  8143. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  8144. /** Configures point labels. */
  8145. label?: dxChartSeriesTypesStackedSplineSeriesLabel;
  8146. /** Specifies series elements to be highlighted when a user selects a series. */
  8147. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  8148. }
  8149. /** Configures data aggregation for the series. */
  8150. interface dxChartSeriesTypesStackedSplineSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8151. /** Specifies how to aggregate series points. */
  8152. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  8153. }
  8154. /** Configures point labels. */
  8155. interface dxChartSeriesTypesStackedSplineSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8156. /** Customizes the text displayed by point labels. */
  8157. customizeText?: ((pointInfo: any) => string);
  8158. }
  8159. /** Describes settings supported by a series of the step rea type. */
  8160. interface dxChartSeriesTypesStepAreaSeries extends dxChartSeriesTypesCommonSeries {
  8161. /** Configures data aggregation for the series. */
  8162. aggregation?: dxChartSeriesTypesStepAreaSeriesAggregation;
  8163. /** Configures the series border (in area-like series) or the series point border (in bar-like and bubble series). */
  8164. border?: dxChartSeriesTypesStepAreaSeriesBorder;
  8165. /** Specifies series elements to be highlighted when a user points to a series. */
  8166. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  8167. /** Configures the appearance adopted by the series when a user points to it. */
  8168. hoverStyle?: dxChartSeriesTypesStepAreaSeriesHoverStyle;
  8169. /** Configures point labels. */
  8170. label?: dxChartSeriesTypesStepAreaSeriesLabel;
  8171. /** Configures series points in scatter, line- and area-like series. */
  8172. point?: dxChartSeriesTypesStepAreaSeriesPoint;
  8173. /** Specifies series elements to be highlighted when a user selects a series. */
  8174. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  8175. /** Configures the appearance adopted by the series when a user selects it. */
  8176. selectionStyle?: dxChartSeriesTypesStepAreaSeriesSelectionStyle;
  8177. }
  8178. /** Configures data aggregation for the series. */
  8179. interface dxChartSeriesTypesStepAreaSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8180. /** Specifies how to aggregate series points. */
  8181. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  8182. }
  8183. /** Configures the series border (in area-like series) or the series point border (in bar-like and bubble series). */
  8184. interface dxChartSeriesTypesStepAreaSeriesBorder extends dxChartSeriesTypesCommonSeriesBorder {
  8185. /** Shows the series border (in area-like series) or the series point border (in bar-like and bubble series). */
  8186. visible?: boolean;
  8187. }
  8188. /** Configures the appearance adopted by the series when a user points to it. */
  8189. interface dxChartSeriesTypesStepAreaSeriesHoverStyle extends dxChartSeriesTypesCommonSeriesHoverStyle {
  8190. /** Configures the appearance adopted by the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user points to the series. */
  8191. border?: dxChartSeriesTypesStepAreaSeriesHoverStyleBorder;
  8192. }
  8193. /** Configures the appearance adopted by the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user points to the series. */
  8194. interface dxChartSeriesTypesStepAreaSeriesHoverStyleBorder extends dxChartSeriesTypesCommonSeriesHoverStyleBorder {
  8195. /** Shows the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user points to the series. */
  8196. visible?: boolean;
  8197. }
  8198. /** Configures point labels. */
  8199. interface dxChartSeriesTypesStepAreaSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8200. /** Customizes the text displayed by point labels. */
  8201. customizeText?: ((pointInfo: any) => string);
  8202. }
  8203. /** Configures series points in scatter, line- and area-like series. */
  8204. interface dxChartSeriesTypesStepAreaSeriesPoint extends dxChartSeriesTypesCommonSeriesPoint {
  8205. /** Makes the series points visible. */
  8206. visible?: boolean;
  8207. }
  8208. /** Configures the appearance adopted by the series when a user selects it. */
  8209. interface dxChartSeriesTypesStepAreaSeriesSelectionStyle extends dxChartSeriesTypesCommonSeriesSelectionStyle {
  8210. /** Configures the appearance adopted by the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user selects the series. */
  8211. border?: dxChartSeriesTypesStepAreaSeriesSelectionStyleBorder;
  8212. }
  8213. /** Configures the appearance adopted by the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user selects the series. */
  8214. interface dxChartSeriesTypesStepAreaSeriesSelectionStyleBorder extends dxChartSeriesTypesCommonSeriesSelectionStyleBorder {
  8215. /** Shows the series border (in area-like series) or the series point border (in bar-like and bubble series) when a user selects the series. */
  8216. visible?: boolean;
  8217. }
  8218. /** Describes settings supported by a series of the step line type. */
  8219. interface dxChartSeriesTypesStepLineSeries extends dxChartSeriesTypesCommonSeries {
  8220. /** Configures data aggregation for the series. */
  8221. aggregation?: dxChartSeriesTypesStepLineSeriesAggregation;
  8222. /** Specifies series elements to be highlighted when a user points to a series. */
  8223. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  8224. /** Configures point labels. */
  8225. label?: dxChartSeriesTypesStepLineSeriesLabel;
  8226. /** Specifies series elements to be highlighted when a user selects a series. */
  8227. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  8228. }
  8229. /** Configures data aggregation for the series. */
  8230. interface dxChartSeriesTypesStepLineSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8231. /** Specifies how to aggregate series points. */
  8232. method?: 'avg' | 'count' | 'max' | 'min' | 'sum' | 'custom';
  8233. }
  8234. /** Configures point labels. */
  8235. interface dxChartSeriesTypesStepLineSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8236. /** Customizes the text displayed by point labels. */
  8237. customizeText?: ((pointInfo: any) => string);
  8238. }
  8239. /** Describes settings supported by a series of the stock type. */
  8240. interface dxChartSeriesTypesStockSeries extends dxChartSeriesTypesCommonSeries {
  8241. /** Configures data aggregation for the series. */
  8242. aggregation?: dxChartSeriesTypesStockSeriesAggregation;
  8243. /** Specifies which data source field provides arguments for series points. */
  8244. argumentField?: string;
  8245. /** Specifies series elements to be highlighted when a user pauses on a series. */
  8246. hoverMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  8247. /** Configures point labels. */
  8248. label?: dxChartSeriesTypesStockSeriesLabel;
  8249. /** Specifies series elements to be highlighted when a user selects a point. */
  8250. selectionMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  8251. }
  8252. /** Configures data aggregation for the series. */
  8253. interface dxChartSeriesTypesStockSeriesAggregation extends dxChartSeriesTypesCommonSeriesAggregation {
  8254. /** Specifies how to aggregate series points. */
  8255. method?: 'ohlc' | 'custom';
  8256. }
  8257. /** Configures point labels. */
  8258. interface dxChartSeriesTypesStockSeriesLabel extends dxChartSeriesTypesCommonSeriesLabel {
  8259. /** Customizes the text displayed by point labels. */
  8260. customizeText?: ((pointInfo: any) => string);
  8261. }
  8262. export interface dxCircularGaugeOptions extends BaseGaugeOptions<dxCircularGauge> {
  8263. /** Specifies the options required to set the geometry of the CircularGauge widget. */
  8264. geometry?: { endAngle?: number, startAngle?: number };
  8265. /** Specifies gauge range container options. */
  8266. rangeContainer?: dxCircularGaugeRangeContainer;
  8267. /** Specifies a gauge's scale options. */
  8268. scale?: dxCircularGaugeScale;
  8269. /** Specifies the appearance options of subvalue indicators. */
  8270. subvalueIndicator?: GaugeIndicator;
  8271. /** Specifies the appearance options of the value indicator. */
  8272. valueIndicator?: GaugeIndicator;
  8273. }
  8274. /** Specifies gauge range container options. */
  8275. export interface dxCircularGaugeRangeContainer extends BaseGaugeRangeContainer {
  8276. /** Specifies the orientation of the range container in the CircularGauge widget. */
  8277. orientation?: 'center' | 'inside' | 'outside';
  8278. /** Specifies the range container's width in pixels. */
  8279. width?: number;
  8280. }
  8281. /** Specifies a gauge's scale options. */
  8282. export interface dxCircularGaugeScale extends BaseGaugeScale {
  8283. /** Specifies common options for scale labels. */
  8284. label?: dxCircularGaugeScaleLabel;
  8285. /** Specifies the orientation of scale ticks. */
  8286. orientation?: 'center' | 'inside' | 'outside';
  8287. }
  8288. /** Specifies common options for scale labels. */
  8289. export interface dxCircularGaugeScaleLabel extends BaseGaugeScaleLabel {
  8290. /** Specifies which label to hide in case of overlapping. */
  8291. hideFirstOrLast?: 'first' | 'last';
  8292. /** Specifies the spacing between scale labels and ticks. */
  8293. indentFromTick?: number;
  8294. }
  8295. /** The CircularGauge is a widget that indicates values on a circular numeric scale. */
  8296. export class dxCircularGauge extends BaseGauge {
  8297. constructor(element: Element, options?: dxCircularGaugeOptions)
  8298. constructor(element: JQuery, options?: dxCircularGaugeOptions)
  8299. }
  8300. export interface dxFunnelOptions extends BaseWidgetOptions<dxFunnel> {
  8301. /** Specifies adaptive layout options. */
  8302. adaptiveLayout?: { height?: number, keepLabels?: boolean, width?: number };
  8303. /** Specifies the algorithm for building the funnel. */
  8304. algorithm?: 'dynamicHeight' | 'dynamicSlope';
  8305. /** Specifies which data source field provides arguments for funnel items. The argument identifies a funnel item and represents it on the legend. */
  8306. argumentField?: string;
  8307. /** Specifies which data source field provides colors for funnel items. If this field is absent, the palette provides the colors. */
  8308. colorField?: string;
  8309. /** Binds the widget to data. */
  8310. dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string;
  8311. /** Specifies whether funnel items change their style when a user pauses on them. */
  8312. hoverEnabled?: boolean;
  8313. /** Turns the funnel upside down. */
  8314. inverted?: boolean;
  8315. /** Configures funnel items' appearance. */
  8316. item?: { border?: { color?: string, visible?: boolean, width?: number }, hoverStyle?: { border?: { color?: string, visible?: boolean, width?: number }, hatching?: { direction?: 'left' | 'none' | 'right', opacity?: number, step?: number, width?: number } }, selectionStyle?: { border?: { color?: string, visible?: boolean, width?: number }, hatching?: { direction?: 'left' | 'none' | 'right', opacity?: number, step?: number, width?: number } } };
  8317. /** Configures funnel item labels. */
  8318. label?: { backgroundColor?: string, border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number }, connector?: { color?: string, opacity?: number, visible?: boolean, width?: number }, customizeText?: ((itemInfo: { item?: dxFunnelItem, value?: number, valueText?: string, percent?: number, percentText?: string }) => string), font?: Font, format?: DevExpress.ui.format, horizontalAlignment?: 'left' | 'right', horizontalOffset?: number, position?: 'columns' | 'inside' | 'outside', showForZeroValues?: boolean, textOverflow?: 'ellipsis' | 'hide' | 'none', visible?: boolean, wordWrap?: 'normal' | 'breakWord' | 'none' };
  8319. /** Configures the legend. */
  8320. legend?: dxFunnelLegend;
  8321. /** Specifies the ratio between the height of the neck and that of the whole funnel. Accepts values from 0 to 1. Applies only if the algorithm is "dynamicHeight". */
  8322. neckHeight?: number;
  8323. /** Specifies the ratio between the width of the neck and that of the whole funnel. Accepts values from 0 to 1. Applies only if the algorithm is "dynamicHeight". */
  8324. neckWidth?: number;
  8325. /** A function that is executed after the pointer enters or leaves a funnel item. */
  8326. onHoverChanged?: ((e: { component?: dxFunnel, element?: DevExpress.core.dxElement, model?: any, item?: dxFunnelItem }) => any);
  8327. /** A function that is executed when a funnel item is clicked or tapped. */
  8328. onItemClick?: ((e: { component?: dxFunnel, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, item?: dxFunnelItem }) => any) | string;
  8329. /** A function that is executed when a legend item is clicked or tapped. */
  8330. onLegendClick?: ((e: { component?: dxFunnel, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, item?: dxFunnelItem }) => any) | string;
  8331. /** A function that is executed when a funnel item is selected or selection is canceled. */
  8332. onSelectionChanged?: ((e: { component?: dxFunnel, element?: DevExpress.core.dxElement, model?: any, item?: dxFunnelItem }) => any);
  8333. /** Sets the palette to be used to colorize funnel items. */
  8334. palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office';
  8335. /** Specifies what to do with colors in the palette when their number is less than the number of funnel items. */
  8336. paletteExtensionMode?: 'alternate' | 'blend' | 'extrapolate';
  8337. /** Specifies how item labels should behave when they overlap. */
  8338. resolveLabelOverlapping?: 'hide' | 'none' | 'shift';
  8339. /** Specifies whether a single or multiple funnel items can be in the selected state at a time. Assigning "none" disables the selection feature. */
  8340. selectionMode?: 'multiple' | 'none' | 'single';
  8341. /** Specifies whether to sort funnel items. */
  8342. sortData?: boolean;
  8343. /** Configures tooltips - small pop-up rectangles that display information about a data-visualizing widget element being pressed or hovered over with the mouse pointer. */
  8344. tooltip?: dxFunnelTooltip;
  8345. /** Specifies which data source field provides values for funnel items. The value defines a funnel item's area. */
  8346. valueField?: string;
  8347. }
  8348. /** Configures the legend. */
  8349. export interface dxFunnelLegend extends BaseLegend {
  8350. /** Specifies the hint that appears when a user hovers the mouse pointer over a legend item. */
  8351. customizeHint?: ((itemInfo: { item?: dxFunnelItem, text?: string }) => string);
  8352. /** Allows you to change the order, text, and visibility of legend items. */
  8353. customizeItems?: ((items: Array<FunnelLegendItem>) => Array<FunnelLegendItem>);
  8354. /** Customizes the text displayed by legend items. */
  8355. customizeText?: ((itemInfo: { item?: dxFunnelItem, text?: string }) => string);
  8356. /** Specifies the legend's visibility. */
  8357. visible?: boolean;
  8358. }
  8359. /** Configures tooltips - small pop-up rectangles that display information about a data-visualizing widget element being pressed or hovered over with the mouse pointer. */
  8360. export interface dxFunnelTooltip extends BaseWidgetTooltip {
  8361. /** Customizes a specific tooltip's appearance. */
  8362. customizeTooltip?: ((info: { item?: dxFunnelItem, value?: number, valueText?: string, percent?: number, percentText?: string }) => any);
  8363. }
  8364. /** The Funnel is a widget that visualizes a value at different stages. It helps assess value changes throughout these stages and identify potential issues. The Funnel widget conveys information using different interactive elements (tooltips, labels, legend) and enables you to create not only a funnel, but also a pyramid chart. */
  8365. export class dxFunnel extends BaseWidget {
  8366. constructor(element: Element, options?: dxFunnelOptions)
  8367. constructor(element: JQuery, options?: dxFunnelOptions)
  8368. /** Cancels the selection of all funnel items. */
  8369. clearSelection(): void;
  8370. /** Provides access to all funnel items. */
  8371. getAllItems(): Array<dxFunnelItem>;
  8372. /** Gets the DataSource instance. */
  8373. getDataSource(): DevExpress.data.DataSource;
  8374. /** Hides all widget tooltips. */
  8375. hideTooltip(): void;
  8376. }
  8377. /** This section describes the Item object, which represents a funnel item. */
  8378. export class dxFunnelItem {
  8379. /** The item's argument. */
  8380. argument: string | Date | number;
  8381. /** The item's original data object. */
  8382. data: any;
  8383. /** The item's calculated percentage value. */
  8384. percent: number;
  8385. /** The item's value. */
  8386. value: number;
  8387. /** Gets the funnel item's color specified in the data source or palette. */
  8388. getColor(): string;
  8389. /** Changes the funnel item's hover state. */
  8390. hover(state: boolean): void;
  8391. /** Indicates whether the funnel item is in the hover state. */
  8392. isHovered(): boolean;
  8393. /** Indicates whether the funnel item is selected. */
  8394. isSelected(): boolean;
  8395. /** Selects or cancels the funnel item's selection. */
  8396. select(state: boolean): void;
  8397. /** Shows the funnel item's tooltip. */
  8398. showTooltip(): void;
  8399. }
  8400. export interface dxLinearGaugeOptions extends BaseGaugeOptions<dxLinearGauge> {
  8401. /** Specifies the options required to set the geometry of the LinearGauge widget. */
  8402. geometry?: { orientation?: 'horizontal' | 'vertical' };
  8403. /** Specifies gauge range container options. */
  8404. rangeContainer?: dxLinearGaugeRangeContainer;
  8405. /** Specifies the gauge's scale options. */
  8406. scale?: dxLinearGaugeScale;
  8407. /** Specifies the appearance options of subvalue indicators. */
  8408. subvalueIndicator?: GaugeIndicator;
  8409. /** Specifies the appearance options of the value indicator. */
  8410. valueIndicator?: GaugeIndicator;
  8411. }
  8412. /** Specifies gauge range container options. */
  8413. export interface dxLinearGaugeRangeContainer extends BaseGaugeRangeContainer {
  8414. /** Specifies the orientation of the range container. Applies only if the geometry.orientation option is "vertical". */
  8415. horizontalOrientation?: 'center' | 'left' | 'right';
  8416. /** Specifies the orientation of the range container. Applies only if the geometry.orientation option is "horizontal". */
  8417. verticalOrientation?: 'bottom' | 'center' | 'top';
  8418. /** Specifies the width of the range container's start and end boundaries in the LinearGauge widget. */
  8419. width?: { end?: number, start?: number } | number;
  8420. }
  8421. /** Specifies the gauge's scale options. */
  8422. export interface dxLinearGaugeScale extends BaseGaugeScale {
  8423. /** Specifies the orientation of scale ticks. Applies only if the geometry.orientation option is "vertical". */
  8424. horizontalOrientation?: 'center' | 'left' | 'right';
  8425. /** Specifies common options for scale labels. */
  8426. label?: dxLinearGaugeScaleLabel;
  8427. /** Specifies the minimum distance between two neighboring major ticks in pixels. */
  8428. scaleDivisionFactor?: number;
  8429. /** Specifies the orientation of scale ticks. Applies only if the geometry.orientation option is "horizontal". */
  8430. verticalOrientation?: 'bottom' | 'center' | 'top';
  8431. }
  8432. /** Specifies common options for scale labels. */
  8433. export interface dxLinearGaugeScaleLabel extends BaseGaugeScaleLabel {
  8434. /** Specifies the spacing between scale labels and ticks. */
  8435. indentFromTick?: number;
  8436. }
  8437. /** The LinearGauge is a widget that indicates values on a linear numeric scale. */
  8438. export class dxLinearGauge extends BaseGauge {
  8439. constructor(element: Element, options?: dxLinearGaugeOptions)
  8440. constructor(element: JQuery, options?: dxLinearGaugeOptions)
  8441. }
  8442. export interface dxPieChartOptions extends BaseChartOptions<dxPieChart> {
  8443. /** Specifies adaptive layout options. */
  8444. adaptiveLayout?: dxPieChartAdaptiveLayout;
  8445. /** An object defining the configuration options that are common for all series of the PieChart widget. */
  8446. commonSeriesSettings?: any;
  8447. /** Specifies the diameter of the pie. */
  8448. diameter?: number;
  8449. /** Specifies the fraction of the inner radius relative to the total radius in the series of the 'doughnut' type. The value should be between 0 and 1. */
  8450. innerRadius?: number;
  8451. /** Specifies PieChart legend options. */
  8452. legend?: dxPieChartLegend;
  8453. /** Specifies the minimum diameter of the pie. */
  8454. minDiameter?: number;
  8455. /** A function that is executed when a legend item is clicked or tapped. */
  8456. onLegendClick?: ((e: { component?: dxPieChart, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, target?: string | number, points?: Array<piePointObject> }) => any) | string;
  8457. /** Sets the palette to be used to colorize series and their elements. */
  8458. palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office';
  8459. /** Specifies how a chart must behave when point labels overlap. */
  8460. resolveLabelOverlapping?: 'hide' | 'none' | 'shift';
  8461. /** Specifies the direction that the pie chart segments will occupy. */
  8462. segmentsDirection?: 'anticlockwise' | 'clockwise';
  8463. /** Specifies options for the series of the PieChart widget. */
  8464. series?: PieChartSeries | Array<PieChartSeries>;
  8465. /** Defines options for the series template. */
  8466. seriesTemplate?: { customizeSeries?: ((seriesName: any) => PieChartSeries), nameField?: string };
  8467. /** Allows you to display several adjoining pies in the same size. */
  8468. sizeGroup?: string;
  8469. /** Specifies the angle in arc degrees from which the first segment of a pie chart should start. */
  8470. startAngle?: number;
  8471. /** Specifies the type of the pie chart series. */
  8472. type?: 'donut' | 'doughnut' | 'pie';
  8473. }
  8474. /** Specifies adaptive layout options. */
  8475. export interface dxPieChartAdaptiveLayout extends BaseChartAdaptiveLayout {
  8476. /** Specifies whether point labels should be kept when the widget adapts the layout. */
  8477. keepLabels?: boolean;
  8478. }
  8479. /** Specifies PieChart legend options. */
  8480. export interface dxPieChartLegend extends BaseChartLegend {
  8481. /** Specifies the text for a hint that appears when a user hovers the mouse pointer over a legend item. */
  8482. customizeHint?: ((pointInfo: { pointName?: any, pointIndex?: number, pointColor?: string }) => string);
  8483. /** Allows you to change the order, text, and visibility of legend items. */
  8484. customizeItems?: ((items: Array<PieChartLegendItem>) => Array<PieChartLegendItem>);
  8485. /** Specifies a callback function that returns the text to be displayed by a legend item. */
  8486. customizeText?: ((pointInfo: { pointName?: any, pointIndex?: number, pointColor?: string }) => string);
  8487. /** Specifies what chart elements to highlight when a corresponding item in the legend is hovered over. */
  8488. hoverMode?: 'none' | 'allArgumentPoints';
  8489. }
  8490. /** The PieChart is a widget that visualizes data as a circle divided into sectors that each represents a portion of the whole. */
  8491. export class dxPieChart extends BaseChart {
  8492. constructor(element: Element, options?: dxPieChartOptions)
  8493. constructor(element: JQuery, options?: dxPieChartOptions)
  8494. }
  8495. /** This section lists the objects that define options to be used to configure series of particular types. */
  8496. export interface dxPieChartSeriesTypes {
  8497. /** An object that defines configuration options for chart series. */
  8498. CommonPieChartSeries?: dxPieChartSeriesTypesCommonPieChartSeries;
  8499. /** An object defining a series of the doughnut type. */
  8500. DoughnutSeries?: any;
  8501. /** An object defining a series of the pie type. */
  8502. PieSeries?: any;
  8503. }
  8504. /** An object that defines configuration options for chart series. */
  8505. export interface dxPieChartSeriesTypesCommonPieChartSeries {
  8506. /** Specifies the data source field that provides arguments for series points. */
  8507. argumentField?: string;
  8508. /** Specifies the required type for series arguments. */
  8509. argumentType?: 'datetime' | 'numeric' | 'string';
  8510. /** An object defining the series border configuration options. */
  8511. border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number };
  8512. /** Specifies a series color. */
  8513. color?: string;
  8514. /** Specifies the chart elements to highlight when a series is hovered over. */
  8515. hoverMode?: 'none' | 'onlyPoint';
  8516. /** An object defining configuration options for a hovered series. */
  8517. hoverStyle?: { border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number }, color?: string, hatching?: { direction?: 'left' | 'none' | 'right', opacity?: number, step?: number, width?: number } };
  8518. /** An object defining the label configuration options. */
  8519. label?: { argumentFormat?: DevExpress.ui.format, backgroundColor?: string, border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number }, connector?: { color?: string, visible?: boolean, width?: number }, customizeText?: ((pointInfo: any) => string), font?: Font, format?: DevExpress.ui.format, position?: 'columns' | 'inside' | 'outside', radialOffset?: number, rotationAngle?: number, textOverflow?: 'ellipsis' | 'hide' | 'none', visible?: boolean, wordWrap?: 'normal' | 'breakWord' | 'none' };
  8520. /** Specifies how many points are acceptable to be in a series to display all labels for these points. Otherwise, the labels will not be displayed. */
  8521. maxLabelCount?: number;
  8522. /** Specifies a minimal size of a displayed pie segment. */
  8523. minSegmentSize?: number;
  8524. /** Specifies the chart elements to highlight when the series is selected. */
  8525. selectionMode?: 'none' | 'onlyPoint';
  8526. /** An object defining configuration options for the series when it is selected. */
  8527. selectionStyle?: { border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number }, color?: string, hatching?: { direction?: 'left' | 'none' | 'right', opacity?: number, step?: number, width?: number } };
  8528. /** Specifies chart segment grouping options. */
  8529. smallValuesGrouping?: { groupName?: string, mode?: 'none' | 'smallValueThreshold' | 'topN', threshold?: number, topCount?: number };
  8530. /** Specifies the name of the data source field that provides data about a point. */
  8531. tagField?: string;
  8532. /** Specifies the data source field that provides values for series points. */
  8533. valueField?: string;
  8534. }
  8535. export interface dxPolarChartOptions extends BaseChartOptions<dxPolarChart> {
  8536. /** Specifies adaptive layout options. */
  8537. adaptiveLayout?: dxPolarChartAdaptiveLayout;
  8538. /** Specifies argument axis options for the PolarChart widget. */
  8539. argumentAxis?: dxPolarChartArgumentAxis;
  8540. /** Controls the padding and consequently the angular width of a group of bars with the same argument using relative units. Ignored if the barGroupWidth option is set. */
  8541. barGroupPadding?: number;
  8542. /** Specifies a fixed angular width for groups of bars with the same argument, measured in degrees. Takes precedence over the barGroupPadding option. */
  8543. barGroupWidth?: number;
  8544. /** @deprecated Use CommonPolarChartSeries.barPadding instead. */
  8545. /** Specifies a common bar width as a percentage from 0 to 1. */
  8546. barWidth?: number;
  8547. /** An object defining the configuration options that are common for all axes of the PolarChart widget. */
  8548. commonAxisSettings?: dxPolarChartCommonAxisSettings;
  8549. /** An object defining the configuration options that are common for all series of the PolarChart widget. */
  8550. commonSeriesSettings?: dxPolarChartCommonSeriesSettings;
  8551. /** Specifies the color of the parent page element. */
  8552. containerBackgroundColor?: string;
  8553. /** An object providing options for managing data from a data source. */
  8554. dataPrepareSettings?: { checkTypeForAllData?: boolean, convertToAxisDataType?: boolean, sortingMethod?: boolean | ((a: { arg?: Date | number | string, val?: Date | number | string }, b: { arg?: Date | number | string, val?: Date | number | string }) => number) };
  8555. /** @deprecated Use CommonPolarChartSeries.ignoreEmptyPoints instead. */
  8556. /** Specifies whether or not all bars in a series must have the same angle, or may have different angles if any points in other series are missing. */
  8557. equalBarWidth?: boolean;
  8558. /** Specifies the options of a chart's legend. */
  8559. legend?: dxPolarChartLegend;
  8560. /** Forces the widget to treat negative values as zeroes. Applies to stacked-like series only. */
  8561. negativesAsZeroes?: boolean;
  8562. /** A function that is executed when a label on the argument axis is clicked or tapped. */
  8563. onArgumentAxisClick?: ((e: { component?: dxPolarChart, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, argument?: Date | number | string }) => any) | string;
  8564. /** A function that is executed when a legend item is clicked or tapped. */
  8565. onLegendClick?: ((e: { component?: dxPolarChart, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, target?: polarChartSeriesObject }) => any) | string;
  8566. /** A function that is executed when a series is clicked or tapped. */
  8567. onSeriesClick?: ((e: { component?: dxPolarChart, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, target?: polarChartSeriesObject }) => any) | string;
  8568. /** A function that is executed after the pointer enters or leaves a series. */
  8569. onSeriesHoverChanged?: ((e: { component?: dxPolarChart, element?: DevExpress.core.dxElement, model?: any, target?: polarChartSeriesObject }) => any);
  8570. /** A function that is executed when a series is selected or selection is canceled. */
  8571. onSeriesSelectionChanged?: ((e: { component?: dxPolarChart, element?: DevExpress.core.dxElement, model?: any, target?: polarChartSeriesObject }) => any);
  8572. /** Specifies how the chart must behave when series point labels overlap. */
  8573. resolveLabelOverlapping?: 'hide' | 'none';
  8574. /** Specifies options for PolarChart widget series. */
  8575. series?: PolarChartSeries | Array<PolarChartSeries>;
  8576. /** Specifies whether a single series or multiple series can be selected in the chart. */
  8577. seriesSelectionMode?: 'multiple' | 'single';
  8578. /** Defines options for the series template. */
  8579. seriesTemplate?: { customizeSeries?: ((seriesName: any) => PolarChartSeries), nameField?: string };
  8580. /** Configures tooltips. */
  8581. tooltip?: dxPolarChartTooltip;
  8582. /** Indicates whether or not to display a "spider web". */
  8583. useSpiderWeb?: boolean;
  8584. /** Specifies value axis options for the PolarChart widget. */
  8585. valueAxis?: dxPolarChartValueAxis;
  8586. }
  8587. /** Specifies adaptive layout options. */
  8588. export interface dxPolarChartAdaptiveLayout extends BaseChartAdaptiveLayout {
  8589. /** Specifies the minimum container height at which the layout begins to adapt. */
  8590. height?: number;
  8591. /** Specifies the minimum container width at which the layout begins to adapt. */
  8592. width?: number;
  8593. }
  8594. /** Specifies argument axis options for the PolarChart widget. */
  8595. export interface dxPolarChartArgumentAxis extends dxPolarChartCommonAxisSettings {
  8596. /** Specifies the desired type of axis values. */
  8597. argumentType?: 'datetime' | 'numeric' | 'string';
  8598. /** Specifies the minimum distance between two neighboring major ticks in pixels. Applies only to the axes of the "continuous" and "logarithmic" types. */
  8599. axisDivisionFactor?: number;
  8600. /** Specifies the order in which arguments (categories) are arranged on the discrete argument axis. */
  8601. categories?: Array<number | string | Date>;
  8602. /** Defines an array of the argument axis constant lines. */
  8603. constantLines?: Array<dxPolarChartArgumentAxisConstantLines>;
  8604. /** Specifies whether or not to display the first point at the angle specified by the startAngle option. */
  8605. firstPointOnStartAngle?: boolean;
  8606. /** Specifies the elements that will be highlighted when the argument axis is hovered over. */
  8607. hoverMode?: 'allArgumentPoints' | 'none';
  8608. /** Specifies options for argument axis labels. */
  8609. label?: dxPolarChartArgumentAxisLabel;
  8610. /** Specifies the value to be raised to a power when generating ticks for a logarithmic axis. */
  8611. logarithmBase?: number;
  8612. /** Specifies the options of the minor ticks. */
  8613. minorTick?: dxPolarChartArgumentAxisMinorTick;
  8614. /** Specifies the number of minor ticks between two neighboring major ticks. */
  8615. minorTickCount?: number;
  8616. /** Specifies the interval between minor ticks. */
  8617. minorTickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  8618. /** Specifies the value to be used as the origin for the argument axis. */
  8619. originValue?: number;
  8620. /** Specifies the period of the argument values in the data source. */
  8621. period?: number;
  8622. /** Specifies the angle in arc degrees to which the argument axis should be rotated. The positive values rotate the axis clockwise. */
  8623. startAngle?: number;
  8624. /** Specifies options for argument axis strips. */
  8625. strips?: Array<dxPolarChartArgumentAxisStrips>;
  8626. /** An object defining the configuration options for axis ticks. */
  8627. tick?: dxPolarChartArgumentAxisTick;
  8628. /** Specifies an interval between axis ticks/grid lines. */
  8629. tickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  8630. /** Specifies the required type of the argument axis. */
  8631. type?: 'continuous' | 'discrete' | 'logarithmic';
  8632. }
  8633. /** Defines an array of the argument axis constant lines. */
  8634. export interface dxPolarChartArgumentAxisConstantLines extends dxPolarChartCommonAxisSettingsConstantLineStyle {
  8635. /** Specifies whether to display the constant line behind or in front of the series. */
  8636. displayBehindSeries?: boolean;
  8637. /** Specifies whether to extend the axis to display the constant line. */
  8638. extendAxis?: boolean;
  8639. /** An object defining constant line label options. */
  8640. label?: dxPolarChartArgumentAxisConstantLinesLabel;
  8641. /** Specifies a value to be displayed by a constant line. */
  8642. value?: number | Date | string;
  8643. }
  8644. /** An object defining constant line label options. */
  8645. export interface dxPolarChartArgumentAxisConstantLinesLabel extends dxPolarChartCommonAxisSettingsConstantLineStyleLabel {
  8646. /** Specifies the text to be displayed in a constant line label. */
  8647. text?: string;
  8648. }
  8649. /** Specifies options for argument axis labels. */
  8650. export interface dxPolarChartArgumentAxisLabel extends dxPolarChartCommonAxisSettingsLabel {
  8651. /** Specifies the text for a hint that appears when a user hovers the mouse pointer over a label on the argument axis. */
  8652. customizeHint?: ((argument: { value?: Date | number | string, valueText?: string }) => string);
  8653. /** Specifies a callback function that returns the text to be displayed by argument axis labels. */
  8654. customizeText?: ((argument: { value?: Date | number | string, valueText?: string }) => string);
  8655. /** Formats a value before it is displayed in an axis label. */
  8656. format?: DevExpress.ui.format;
  8657. }
  8658. /** Specifies the options of the minor ticks. */
  8659. export interface dxPolarChartArgumentAxisMinorTick extends dxPolarChartCommonAxisSettingsMinorTick {
  8660. /** Shifts minor ticks from the reference position. */
  8661. shift?: number;
  8662. }
  8663. /** Specifies options for argument axis strips. */
  8664. export interface dxPolarChartArgumentAxisStrips extends dxPolarChartCommonAxisSettingsStripStyle {
  8665. /** Specifies a color for a strip. */
  8666. color?: string;
  8667. /** Specifies an end value for a strip. */
  8668. endValue?: number | Date | string;
  8669. /** An object that defines the label configuration options of a strip. */
  8670. label?: dxPolarChartArgumentAxisStripsLabel;
  8671. /** Specifies a start value for a strip. */
  8672. startValue?: number | Date | string;
  8673. }
  8674. /** An object that defines the label configuration options of a strip. */
  8675. export interface dxPolarChartArgumentAxisStripsLabel extends dxPolarChartCommonAxisSettingsStripStyleLabel {
  8676. /** Specifies the text displayed in a strip. */
  8677. text?: string;
  8678. }
  8679. /** An object defining the configuration options for axis ticks. */
  8680. export interface dxPolarChartArgumentAxisTick extends dxPolarChartCommonAxisSettingsTick {
  8681. /** Shifts ticks from the reference position. */
  8682. shift?: number;
  8683. }
  8684. /** An object defining the configuration options that are common for all axes of the PolarChart widget. */
  8685. export interface dxPolarChartCommonAxisSettings {
  8686. /** Specifies whether to allow decimal values on the axis. When false, the axis contains integer values only. */
  8687. allowDecimals?: boolean;
  8688. /** Specifies the color of the line that represents an axis. */
  8689. color?: string;
  8690. /** Specifies the appearance of all the widget's constant lines. */
  8691. constantLineStyle?: dxPolarChartCommonAxisSettingsConstantLineStyle;
  8692. /** Specifies whether ticks/grid lines of a discrete axis are located between labels or cross the labels. */
  8693. discreteAxisDivisionMode?: 'betweenLabels' | 'crossLabels';
  8694. /** Specifies whether to force the axis to start and end on ticks. */
  8695. endOnTick?: boolean;
  8696. /** An object defining the configuration options for the grid lines of an axis in the PolarChart widget. */
  8697. grid?: { color?: string, opacity?: number, visible?: boolean, width?: number };
  8698. /** Indicates whether or not an axis is inverted. */
  8699. inverted?: boolean;
  8700. /** An object defining the label configuration options that are common for all axes in the PolarChart widget. */
  8701. label?: dxPolarChartCommonAxisSettingsLabel;
  8702. /** Specifies the options of the minor grid. */
  8703. minorGrid?: { color?: string, opacity?: number, visible?: boolean, width?: number };
  8704. /** Specifies the options of the minor ticks. */
  8705. minorTick?: dxPolarChartCommonAxisSettingsMinorTick;
  8706. /** Specifies the opacity of the line that represents an axis. */
  8707. opacity?: number;
  8708. /** An object defining configuration options for strip style. */
  8709. stripStyle?: dxPolarChartCommonAxisSettingsStripStyle;
  8710. /** An object defining the configuration options for axis ticks. */
  8711. tick?: dxPolarChartCommonAxisSettingsTick;
  8712. /** Indicates whether or not the line that represents an axis in a chart is visible. */
  8713. visible?: boolean;
  8714. /** Specifies the width of the line that represents an axis in the chart. */
  8715. width?: number;
  8716. }
  8717. /** Specifies the appearance of all the widget's constant lines. */
  8718. export interface dxPolarChartCommonAxisSettingsConstantLineStyle {
  8719. /** Specifies a color for a constant line. */
  8720. color?: string;
  8721. /** Specifies a dash style for a constant line. */
  8722. dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid';
  8723. /** An object defining constant line label options. */
  8724. label?: dxPolarChartCommonAxisSettingsConstantLineStyleLabel;
  8725. /** Specifies a constant line width in pixels. */
  8726. width?: number;
  8727. }
  8728. /** An object defining constant line label options. */
  8729. export interface dxPolarChartCommonAxisSettingsConstantLineStyleLabel {
  8730. /** Specifies font options for a constant line label. */
  8731. font?: Font;
  8732. /** Indicates whether or not to display labels for the axis constant lines. */
  8733. visible?: boolean;
  8734. }
  8735. /** An object defining the label configuration options that are common for all axes in the PolarChart widget. */
  8736. export interface dxPolarChartCommonAxisSettingsLabel {
  8737. /** Specifies font options for axis labels. */
  8738. font?: Font;
  8739. /** Specifies the spacing between an axis and its labels in pixels. */
  8740. indentFromAxis?: number;
  8741. /** Decides how to arrange axis labels when there is not enough space to keep all of them. */
  8742. overlappingBehavior?: 'none' | 'hide';
  8743. /** Indicates whether or not axis labels are visible. */
  8744. visible?: boolean;
  8745. }
  8746. /** Specifies the options of the minor ticks. */
  8747. export interface dxPolarChartCommonAxisSettingsMinorTick {
  8748. /** Specifies a color for the minor ticks. */
  8749. color?: string;
  8750. /** Specifies minor tick length. */
  8751. length?: number;
  8752. /** Specifies an opacity for the minor ticks. */
  8753. opacity?: number;
  8754. /** Indicates whether or not the minor ticks are displayed on an axis. */
  8755. visible?: boolean;
  8756. /** Specifies minor tick width. */
  8757. width?: number;
  8758. }
  8759. /** An object defining configuration options for strip style. */
  8760. export interface dxPolarChartCommonAxisSettingsStripStyle {
  8761. /** An object defining the configuration options for a strip label style. */
  8762. label?: dxPolarChartCommonAxisSettingsStripStyleLabel;
  8763. }
  8764. /** An object defining the configuration options for a strip label style. */
  8765. export interface dxPolarChartCommonAxisSettingsStripStyleLabel {
  8766. /** Specifies font options for a strip label. */
  8767. font?: Font;
  8768. }
  8769. /** An object defining the configuration options for axis ticks. */
  8770. export interface dxPolarChartCommonAxisSettingsTick {
  8771. /** Specifies ticks color. */
  8772. color?: string;
  8773. /** Specifies tick length. */
  8774. length?: number;
  8775. /** Specifies tick opacity. */
  8776. opacity?: number;
  8777. /** Indicates whether or not ticks are visible on an axis. */
  8778. visible?: boolean;
  8779. /** Specifies tick width. */
  8780. width?: number;
  8781. }
  8782. /** An object defining the configuration options that are common for all series of the PolarChart widget. */
  8783. export interface dxPolarChartCommonSeriesSettings extends dxPolarChartSeriesTypesCommonPolarChartSeries {
  8784. /** An object that specifies configuration options for all series of the area type in the chart. */
  8785. area?: any;
  8786. /** An object that specifies configuration options for all series of the 'bar' type in the chart. */
  8787. bar?: any;
  8788. /** An object that specifies configuration options for all series of the 'line' type in the chart. */
  8789. line?: any;
  8790. /** An object that specifies configuration options for all series of the 'scatter' type in the chart. */
  8791. scatter?: any;
  8792. /** An object that specifies configuration options for all series of the 'stackedBar' type in the chart. */
  8793. stackedbar?: any;
  8794. /** Sets a series type. */
  8795. type?: 'area' | 'bar' | 'line' | 'scatter' | 'stackedbar';
  8796. }
  8797. /** Specifies the options of a chart's legend. */
  8798. export interface dxPolarChartLegend extends BaseChartLegend {
  8799. /** Specifies the text for a hint that appears when a user hovers the mouse pointer over a legend item. */
  8800. customizeHint?: ((seriesInfo: { seriesName?: any, seriesIndex?: number, seriesColor?: string }) => string);
  8801. /** Specifies a callback function that returns the text to be displayed by legend items. */
  8802. customizeText?: ((seriesInfo: { seriesName?: any, seriesIndex?: number, seriesColor?: string }) => string);
  8803. /** Specifies what series elements to highlight when a corresponding item in the legend is hovered over. */
  8804. hoverMode?: 'excludePoints' | 'includePoints' | 'none';
  8805. }
  8806. /** Configures tooltips. */
  8807. export interface dxPolarChartTooltip extends BaseChartTooltip {
  8808. /** Specifies the kind of information to display in a tooltip. */
  8809. shared?: boolean;
  8810. }
  8811. /** Specifies value axis options for the PolarChart widget. */
  8812. export interface dxPolarChartValueAxis extends dxPolarChartCommonAxisSettings {
  8813. /** Specifies a coefficient for dividing the value axis. */
  8814. axisDivisionFactor?: number;
  8815. /** Specifies the order in which discrete values are arranged on the value axis. */
  8816. categories?: Array<number | string | Date>;
  8817. /** Defines an array of the value axis constant lines. */
  8818. constantLines?: Array<dxPolarChartValueAxisConstantLines>;
  8819. /** Specifies whether to force the axis to start and end on ticks. */
  8820. endOnTick?: boolean;
  8821. /** Specifies options for value axis labels. */
  8822. label?: dxPolarChartValueAxisLabel;
  8823. /** Specifies the value to be raised to a power when generating ticks for a logarithmic axis. */
  8824. logarithmBase?: number;
  8825. /** Specifies a coefficient that determines the spacing between the maximum series point and the axis. */
  8826. maxValueMargin?: number;
  8827. /** Specifies a coefficient that determines the spacing between the minimum series point and the axis. */
  8828. minValueMargin?: number;
  8829. /** Specifies the number of minor ticks between two neighboring major ticks. */
  8830. minorTickCount?: number;
  8831. /** Specifies the interval between minor ticks. */
  8832. minorTickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  8833. /** Specifies whether or not to indicate a zero value on the value axis. */
  8834. showZero?: boolean;
  8835. /** Specifies options for value axis strips. */
  8836. strips?: Array<dxPolarChartValueAxisStrips>;
  8837. /** An object defining the configuration options for axis ticks. */
  8838. tick?: dxPolarChartValueAxisTick;
  8839. /** Specifies an interval between axis ticks/grid lines. */
  8840. tickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year';
  8841. /** Specifies the required type of the value axis. */
  8842. type?: 'continuous' | 'discrete' | 'logarithmic';
  8843. /** Indicates whether to display series with indents from axis boundaries. */
  8844. valueMarginsEnabled?: boolean;
  8845. /** Specifies the desired type of axis values. */
  8846. valueType?: 'datetime' | 'numeric' | 'string';
  8847. }
  8848. /** Defines an array of the value axis constant lines. */
  8849. export interface dxPolarChartValueAxisConstantLines extends dxPolarChartCommonAxisSettingsConstantLineStyle {
  8850. /** Specifies whether to display the constant line behind or in front of the series. */
  8851. displayBehindSeries?: boolean;
  8852. /** Specifies whether to extend the axis to display the constant line. */
  8853. extendAxis?: boolean;
  8854. /** An object defining constant line label options. */
  8855. label?: dxPolarChartValueAxisConstantLinesLabel;
  8856. /** Specifies a value to be displayed by a constant line. */
  8857. value?: number | Date | string;
  8858. }
  8859. /** An object defining constant line label options. */
  8860. export interface dxPolarChartValueAxisConstantLinesLabel extends dxPolarChartCommonAxisSettingsConstantLineStyleLabel {
  8861. /** Specifies the text to be displayed in a constant line label. */
  8862. text?: string;
  8863. }
  8864. /** Specifies options for value axis labels. */
  8865. export interface dxPolarChartValueAxisLabel extends dxPolarChartCommonAxisSettingsLabel {
  8866. /** Specifies the text for a hint that appears when a user hovers the mouse pointer over a label on the value axis. */
  8867. customizeHint?: ((axisValue: { value?: Date | number | string, valueText?: string }) => string);
  8868. /** Specifies a callback function that returns the text to be displayed in value axis labels. */
  8869. customizeText?: ((axisValue: { value?: Date | number | string, valueText?: string }) => string);
  8870. /** Formats a value before it is displayed in an axis label. */
  8871. format?: DevExpress.ui.format;
  8872. }
  8873. /** Specifies options for value axis strips. */
  8874. export interface dxPolarChartValueAxisStrips extends dxPolarChartCommonAxisSettingsStripStyle {
  8875. /** Specifies a color for a strip. */
  8876. color?: string;
  8877. /** Specifies an end value for a strip. */
  8878. endValue?: number | Date | string;
  8879. /** An object that defines the label configuration options of a strip. */
  8880. label?: dxPolarChartValueAxisStripsLabel;
  8881. /** Specifies a start value for a strip. */
  8882. startValue?: number | Date | string;
  8883. }
  8884. /** An object that defines the label configuration options of a strip. */
  8885. export interface dxPolarChartValueAxisStripsLabel extends dxPolarChartCommonAxisSettingsStripStyleLabel {
  8886. /** Specifies the text displayed in a strip. */
  8887. text?: string;
  8888. }
  8889. /** An object defining the configuration options for axis ticks. */
  8890. export interface dxPolarChartValueAxisTick extends dxPolarChartCommonAxisSettingsTick {
  8891. /** Indicates whether or not ticks are visible on an axis. */
  8892. visible?: boolean;
  8893. }
  8894. /** The PolarChart is a widget that visualizes data in a polar coordinate system. */
  8895. export class dxPolarChart extends BaseChart {
  8896. constructor(element: Element, options?: dxPolarChartOptions)
  8897. constructor(element: JQuery, options?: dxPolarChartOptions)
  8898. }
  8899. /** This section lists objects that define options used to configure series of specific types. */
  8900. export interface dxPolarChartSeriesTypes {
  8901. /** An object that defines configuration options for polar chart series. */
  8902. CommonPolarChartSeries?: dxPolarChartSeriesTypesCommonPolarChartSeries;
  8903. /** An object defining a series of the area type. */
  8904. areapolarseries?: dxPolarChartSeriesTypesAreapolarseries;
  8905. /** An object defining a series of the bar type. */
  8906. barpolarseries?: dxPolarChartSeriesTypesBarpolarseries;
  8907. /** An object defining a series of the line type. */
  8908. linepolarseries?: dxPolarChartSeriesTypesLinepolarseries;
  8909. /** An object defining a series of the scatter type. */
  8910. scatterpolarseries?: any;
  8911. /** An object defining a series of the stackedBar type. */
  8912. stackedbarpolarseries?: dxPolarChartSeriesTypesStackedbarpolarseries;
  8913. }
  8914. /** An object that defines configuration options for polar chart series. */
  8915. export interface dxPolarChartSeriesTypesCommonPolarChartSeries {
  8916. /** Specifies the data source field that provides arguments for series points. */
  8917. argumentField?: string;
  8918. /** Controls the padding and consequently the angular width of all bars in a series using relative units. Ignored if the barWidth option is set. */
  8919. barPadding?: number;
  8920. /** Specifies a fixed angular width for all bars in a series, measured in degrees. Takes precedence over the barPadding option. */
  8921. barWidth?: number;
  8922. /** An object defining the series border configuration options. */
  8923. border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number };
  8924. /** Specifies whether or not to close the chart by joining the end point with the first point. */
  8925. closed?: boolean;
  8926. /** Specifies a series color. */
  8927. color?: string;
  8928. /** Specifies the dash style of the series' line. */
  8929. dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid';
  8930. /** Specifies the series elements to highlight when a series is hovered over. */
  8931. hoverMode?: 'allArgumentPoints' | 'allSeriesPoints' | 'excludePoints' | 'includePoints' | 'nearestPoint' | 'none' | 'onlyPoint';
  8932. /** An object defining configuration options for a hovered series. */
  8933. hoverStyle?: { border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number }, color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', hatching?: { direction?: 'left' | 'none' | 'right', opacity?: number, step?: number, width?: number }, width?: number };
  8934. /** Specifies whether the series should ignore null data points. */
  8935. ignoreEmptyPoints?: boolean;
  8936. /** An object defining the label configuration options. */
  8937. label?: dxPolarChartSeriesTypesCommonPolarChartSeriesLabel;
  8938. /** Specifies how many points are acceptable to be in a series to display all labels for these points. Otherwise, the labels will not be displayed. */
  8939. maxLabelCount?: number;
  8940. /** Specifies the minimal length of a displayed bar in pixels. */
  8941. minBarSize?: number;
  8942. /** Specifies opacity for a series. */
  8943. opacity?: number;
  8944. /** An object defining configuration options for points in line and area series. */
  8945. point?: dxPolarChartSeriesTypesCommonPolarChartSeriesPoint;
  8946. /** Specifies the series elements to highlight when the series is selected. */
  8947. selectionMode?: 'allArgumentPoints' | 'allSeriesPoints' | 'excludePoints' | 'includePoints' | 'none' | 'onlyPoint';
  8948. /** An object defining configuration options for a selected series. */
  8949. selectionStyle?: { border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number }, color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', hatching?: { direction?: 'left' | 'none' | 'right', opacity?: number, step?: number, width?: number }, width?: number };
  8950. /** Specifies whether or not to show the series in the chart's legend. */
  8951. showInLegend?: boolean;
  8952. /** Specifies the name of the stack where the values of the 'stackedBar' series must be located. */
  8953. stack?: string;
  8954. /** Specifies the name of the data source field that provides data about a point. */
  8955. tagField?: string;
  8956. /** Configures error bars. */
  8957. valueErrorBar?: { color?: string, displayMode?: 'auto' | 'high' | 'low' | 'none', edgeLength?: number, highValueField?: string, lineWidth?: number, lowValueField?: string, opacity?: number, type?: 'fixed' | 'percent' | 'stdDeviation' | 'stdError' | 'variance', value?: number };
  8958. /** Specifies the data source field that provides values for series points. */
  8959. valueField?: string;
  8960. /** Specifies the visibility of a series. */
  8961. visible?: boolean;
  8962. /** Specifies a line width. */
  8963. width?: number;
  8964. }
  8965. /** An object defining the label configuration options. */
  8966. export interface dxPolarChartSeriesTypesCommonPolarChartSeriesLabel {
  8967. /** Formats the point argument before it is displayed in the point label. To format the point value, use the format option. */
  8968. argumentFormat?: DevExpress.ui.format;
  8969. /** Colors the point labels' background. The default color is inherited from the points. */
  8970. backgroundColor?: string;
  8971. /** Specifies border options for point labels. */
  8972. border?: { color?: string, dashStyle?: 'dash' | 'dot' | 'longDash' | 'solid', visible?: boolean, width?: number };
  8973. /** Specifies connector options for series point labels. */
  8974. connector?: { color?: string, visible?: boolean, width?: number };
  8975. /** Specifies a callback function that returns the text to be displayed by point labels. */
  8976. customizeText?: ((pointInfo: any) => string);
  8977. /** Specifies font options for the text displayed in point labels. */
  8978. font?: Font;
  8979. /** Formats a value before it is displayed in a point label. */
  8980. format?: DevExpress.ui.format;
  8981. /** Specifies a label position in bar-like series. */
  8982. position?: 'inside' | 'outside';
  8983. /** Specifies the angle used to rotate point labels from their initial position. */
  8984. rotationAngle?: number;
  8985. /** Specifies whether or not to show a label when the point has a zero value. */
  8986. showForZeroValues?: boolean;
  8987. /** Specifies the visibility of point labels. */
  8988. visible?: boolean;
  8989. }
  8990. /** An object defining configuration options for points in line and area series. */
  8991. export interface dxPolarChartSeriesTypesCommonPolarChartSeriesPoint {
  8992. /** Specifies border options for points in the line and area series. */
  8993. border?: { color?: string, visible?: boolean, width?: number };
  8994. /** Specifies the points color. */
  8995. color?: string;
  8996. /** Specifies what series points to highlight when a point is hovered over. */
  8997. hoverMode?: 'allArgumentPoints' | 'allSeriesPoints' | 'none' | 'onlyPoint';
  8998. /** An object defining configuration options for a hovered point. */
  8999. hoverStyle?: { border?: { color?: string, visible?: boolean, width?: number }, color?: string, size?: number };
  9000. /** An object specifying the parameters of an image that is used as a point marker. */
  9001. image?: string | { height?: number, url?: string, width?: number };
  9002. /** Specifies what series points to highlight when a point is selected. */
  9003. selectionMode?: 'allArgumentPoints' | 'allSeriesPoints' | 'none' | 'onlyPoint';
  9004. /** An object defining configuration options for a selected point. */
  9005. selectionStyle?: { border?: { color?: string, visible?: boolean, width?: number }, color?: string, size?: number };
  9006. /** Specifies the point diameter in pixels for those series that represent data points as symbols (not as bars for instance). */
  9007. size?: number;
  9008. /** Specifies a symbol for presenting points of the line and area series. */
  9009. symbol?: 'circle' | 'cross' | 'polygon' | 'square' | 'triangle';
  9010. /** Specifies the points visibility for a line and area series. */
  9011. visible?: boolean;
  9012. }
  9013. /** An object defining a series of the area type. */
  9014. export interface dxPolarChartSeriesTypesAreapolarseries extends dxPolarChartSeriesTypesCommonPolarChartSeries {
  9015. /** Specifies series elements to be highlighted when a user points to the series. */
  9016. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  9017. /** An object defining configuration options for points in line and area series. */
  9018. point?: dxPolarChartSeriesTypesAreapolarseriesPoint;
  9019. /** Specifies series elements to be highlighted when a user selects the series. */
  9020. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  9021. }
  9022. /** An object defining configuration options for points in line and area series. */
  9023. export interface dxPolarChartSeriesTypesAreapolarseriesPoint extends dxPolarChartSeriesTypesCommonPolarChartSeriesPoint {
  9024. /** Specifies the points visibility for a line and area series. */
  9025. visible?: boolean;
  9026. }
  9027. /** An object defining a series of the bar type. */
  9028. export interface dxPolarChartSeriesTypesBarpolarseries extends dxPolarChartSeriesTypesCommonPolarChartSeries {
  9029. /** Specifies series elements to be highlighted when a user points to the series. */
  9030. hoverMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  9031. /** Specifies series elements to be highlighted when a user selects the series. */
  9032. selectionMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  9033. }
  9034. /** An object defining a series of the line type. */
  9035. export interface dxPolarChartSeriesTypesLinepolarseries extends dxPolarChartSeriesTypesCommonPolarChartSeries {
  9036. /** Specifies series elements to be highlighted when a user points to the series. */
  9037. hoverMode?: 'nearestPoint' | 'includePoints' | 'excludePoints' | 'none';
  9038. /** Specifies series elements to be highlighted when a user selects the series. */
  9039. selectionMode?: 'includePoints' | 'excludePoints' | 'none';
  9040. }
  9041. /** An object defining a series of the stackedBar type. */
  9042. export interface dxPolarChartSeriesTypesStackedbarpolarseries extends dxPolarChartSeriesTypesCommonPolarChartSeries {
  9043. /** Specifies series elements to be highlighted when a user points to the series. */
  9044. hoverMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  9045. /** An object defining the label configuration options. */
  9046. label?: dxPolarChartSeriesTypesStackedbarpolarseriesLabel;
  9047. /** Specifies series elements to be highlighted when a user selects the series. */
  9048. selectionMode?: 'onlyPoint' | 'allSeriesPoints' | 'allArgumentPoints' | 'none';
  9049. }
  9050. /** An object defining the label configuration options. */
  9051. export interface dxPolarChartSeriesTypesStackedbarpolarseriesLabel extends dxPolarChartSeriesTypesCommonPolarChartSeriesLabel {
  9052. /** Specifies a label position in bar-like series. */
  9053. position?: 'inside' | 'outside';
  9054. }
  9055. export interface dxRangeSelectorOptions extends BaseWidgetOptions<dxRangeSelector> {
  9056. /** Specifies the options for the range selector's background. */
  9057. background?: { color?: string, image?: { location?: 'center' | 'centerBottom' | 'centerTop' | 'full' | 'leftBottom' | 'leftCenter' | 'leftTop' | 'rightBottom' | 'rightCenter' | 'rightTop', url?: string }, visible?: boolean };
  9058. /** Specifies the RangeSelector's behavior options. */
  9059. behavior?: { allowSlidersSwap?: boolean, animationEnabled?: boolean, callValueChanged?: 'onMoving' | 'onMovingComplete', manualRangeSelectionEnabled?: boolean, moveSelectedRangeByClick?: boolean, snapToTicks?: boolean };
  9060. /** Specifies the options required to display a chart as the range selector's background. */
  9061. chart?: { barGroupPadding?: number, barGroupWidth?: number, barWidth?: number, bottomIndent?: number, commonSeriesSettings?: dxChartCommonSeriesSettings, dataPrepareSettings?: { checkTypeForAllData?: boolean, convertToAxisDataType?: boolean, sortingMethod?: boolean | ((a: { arg?: Date | number | string, val?: Date | number | string }, b: { arg?: Date | number | string, val?: Date | number | string }) => number) }, equalBarWidth?: boolean, maxBubbleSize?: number, minBubbleSize?: number, negativesAsZeroes?: boolean, palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office', paletteExtensionMode?: 'alternate' | 'blend' | 'extrapolate', series?: ChartSeries | Array<ChartSeries>, seriesTemplate?: { customizeSeries?: ((seriesName: any) => ChartSeries), nameField?: string }, topIndent?: number, useAggregation?: boolean, valueAxis?: { inverted?: boolean, logarithmBase?: number, max?: number, min?: number, type?: 'continuous' | 'logarithmic', valueType?: 'datetime' | 'numeric' | 'string' } };
  9062. /** Specifies the color of the parent page element. */
  9063. containerBackgroundColor?: string;
  9064. /** Specifies a data source for the scale values and for the chart at the background. */
  9065. dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string;
  9066. /** Specifies the data source field that provides data for the scale. */
  9067. dataSourceField?: string;
  9068. /** Range selector's indent options. */
  9069. indent?: { left?: number, right?: number };
  9070. /** A function that is executed after the widget's value is changed. */
  9071. onValueChanged?: ((e: { component?: dxRangeSelector, element?: DevExpress.core.dxElement, model?: any, value?: Array<number | string | Date>, previousValue?: Array<number | string | Date>, event?: event }) => any);
  9072. /** Specifies options of the range selector's scale. */
  9073. scale?: { aggregationGroupWidth?: number, aggregationInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year', allowDecimals?: boolean, breakStyle?: { color?: string, line?: 'straight' | 'waved', width?: number }, breaks?: Array<ScaleBreak>, categories?: Array<number | string | Date>, endOnTick?: boolean, endValue?: number | Date | string, holidays?: Array<Date | string> | Array<number>, label?: { customizeText?: ((scaleValue: { value?: Date | number | string, valueText?: string }) => string), font?: Font, format?: DevExpress.ui.format, overlappingBehavior?: 'hide' | 'none', topIndent?: number, visible?: boolean }, logarithmBase?: number, marker?: { label?: { customizeText?: ((markerValue: { value?: Date | number, valueText?: string }) => string), format?: DevExpress.ui.format }, separatorHeight?: number, textLeftIndent?: number, textTopIndent?: number, topIndent?: number, visible?: boolean }, maxRange?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year', minRange?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year', minorTick?: { color?: string, opacity?: number, visible?: boolean, width?: number }, minorTickCount?: number, minorTickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year', placeholderHeight?: number, showCustomBoundaryTicks?: boolean, singleWorkdays?: Array<Date | string> | Array<number>, startValue?: number | Date | string, tick?: { color?: string, opacity?: number, width?: number }, tickInterval?: number | any | 'day' | 'hour' | 'millisecond' | 'minute' | 'month' | 'quarter' | 'second' | 'week' | 'year', type?: 'continuous' | 'discrete' | 'logarithmic' | 'semidiscrete', valueType?: 'datetime' | 'numeric' | 'string', workWeek?: Array<number>, workdaysOnly?: boolean };
  9074. /** Specifies the color of the selected range. */
  9075. selectedRangeColor?: string;
  9076. /** Specifies how the selected range should behave when data is updated. Applies only when the RangeSelector is bound to a data source. */
  9077. selectedRangeUpdateMode?: 'auto' | 'keep' | 'reset' | 'shift';
  9078. /** Specifies range selector shutter options. */
  9079. shutter?: { color?: string, opacity?: number };
  9080. /** Specifies the appearance of the range selector's slider handles. */
  9081. sliderHandle?: { color?: string, opacity?: number, width?: number };
  9082. /** Defines the options of the range selector slider markers. */
  9083. sliderMarker?: { color?: string, customizeText?: ((scaleValue: { value?: Date | number | string, valueText?: string }) => string), font?: Font, format?: DevExpress.ui.format, invalidRangeColor?: string, paddingLeftRight?: number, paddingTopBottom?: number, placeholderHeight?: number, visible?: boolean };
  9084. /** The selected range (initial or current). Equals the entire scale when not set. */
  9085. value?: Array<number | string | Date> | VizRange;
  9086. }
  9087. /** The RangeSelector is a widget that allows a user to select a range of values on a scale. */
  9088. export class dxRangeSelector extends BaseWidget {
  9089. constructor(element: Element, options?: dxRangeSelectorOptions)
  9090. constructor(element: JQuery, options?: dxRangeSelectorOptions)
  9091. /** Gets the DataSource instance. */
  9092. getDataSource(): DevExpress.data.DataSource;
  9093. /** Gets the currently selected range. */
  9094. getValue(): Array<number | string | Date>;
  9095. /** Redraws the widget. */
  9096. render(): void;
  9097. /** Redraws the widget. */
  9098. render(skipChartAnimation: boolean): void;
  9099. /** Sets the selected range. */
  9100. setValue(value: Array<number | string | Date> | VizRange): void;
  9101. }
  9102. export interface dxSankeyOptions extends BaseWidgetOptions<dxSankey> {
  9103. /** Specifies adaptive layout options. */
  9104. adaptiveLayout?: { height?: number, keepLabels?: boolean, width?: number };
  9105. /** Aligns node columns vertically. */
  9106. alignment?: 'bottom' | 'center' | 'top' | Array<'bottom' | 'center' | 'top'>;
  9107. /** Binds the widget to data. */
  9108. dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string;
  9109. /** Specifies whether nodes and links change their style when they are hovered over or pressed. */
  9110. hoverEnabled?: boolean;
  9111. /** Configures sankey nodes' labels. */
  9112. label?: { border?: { color?: string, visible?: boolean, width?: number }, customizeText?: ((itemInfo: dxSankeyNode) => string), font?: Font, horizontalOffset?: number, overlappingBehavior?: 'ellipsis' | 'hide' | 'none', shadow?: { blur?: number, color?: string, offsetX?: number, offsetY?: number, opacity?: number }, useNodeColors?: boolean, verticalOffset?: number, visible?: boolean };
  9113. /** Configures sankey links' appearance. */
  9114. link?: { border?: { color?: string, visible?: boolean, width?: number }, color?: string, colorMode?: 'none' | 'source' | 'target' | 'gradient', hoverStyle?: { border?: { color?: string, visible?: boolean, width?: number }, color?: string, hatching?: { direction?: 'left' | 'none' | 'right', opacity?: number, step?: number, width?: number }, opacity?: number }, opacity?: number };
  9115. /** Configures sankey nodes' appearance. */
  9116. node?: { border?: { color?: string, visible?: boolean, width?: number }, color?: string, hoverStyle?: { border?: { color?: string, visible?: boolean, width?: number }, color?: string, hatching?: { direction?: 'left' | 'none' | 'right', opacity?: number, step?: number, width?: number }, opacity?: number }, opacity?: number, padding?: number, width?: number };
  9117. /** A function that is executed when a sankey link is clicked or tapped. */
  9118. onLinkClick?: ((e: { component?: dxSankey, element?: DevExpress.core.dxElement, model?: any, event?: event, target?: dxSankeyLink }) => any) | string;
  9119. /** A function that is executed after the pointer enters or leaves a sankey link. */
  9120. onLinkHoverChanged?: ((e: { component?: dxSankey, element?: DevExpress.core.dxElement, model?: any, target?: dxSankeyLink }) => any);
  9121. /** A function that is executed when a sankey node is clicked or tapped. */
  9122. onNodeClick?: ((e: { component?: dxSankey, element?: DevExpress.core.dxElement, model?: any, event?: event, target?: dxSankeyNode }) => any) | string;
  9123. /** A function that is executed after the pointer enters or leaves a sankey node. */
  9124. onNodeHoverChanged?: ((e: { component?: dxSankey, element?: DevExpress.core.dxElement, model?: any, target?: dxSankeyNode }) => any);
  9125. /** Sets the palette to be used to colorize sankey nodes. */
  9126. palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office';
  9127. /** Specifies how to extend the palette when it contains less colors than the number of sankey nodes. */
  9128. paletteExtensionMode?: 'alternate' | 'blend' | 'extrapolate';
  9129. /** Specifies nodes' sorting order in their columns. */
  9130. sortData?: any;
  9131. /** Specifies which data source field provides links' source nodes. */
  9132. sourceField?: string;
  9133. /** Specifies which data source field provides links' target nodes. */
  9134. targetField?: string;
  9135. /** Configures tooltips - small pop-up rectangles that display information about a data-visualizing widget element being pressed or hovered over with the mouse pointer. */
  9136. tooltip?: dxSankeyTooltip;
  9137. /** Specifies which data source field provides links' weights. */
  9138. weightField?: string;
  9139. }
  9140. /** Configures tooltips - small pop-up rectangles that display information about a data-visualizing widget element being pressed or hovered over with the mouse pointer. */
  9141. export interface dxSankeyTooltip extends BaseWidgetTooltip {
  9142. /** Customizes link tooltips' appearance. */
  9143. customizeLinkTooltip?: ((info: { source?: string, target?: string, weight?: number }) => any);
  9144. /** Customizes node tooltips' appearance. */
  9145. customizeNodeTooltip?: ((info: { title?: string, weightIn?: number, weightOut?: number }) => any);
  9146. /** Enables tooltips. */
  9147. enabled?: boolean;
  9148. }
  9149. /** The Sankey is a widget that visualizes the flow magnitude between value sets. The values being connected are called nodes; the connections - links. The higher the flow magnitude, the wider the link is. */
  9150. export class dxSankey extends BaseWidget {
  9151. constructor(element: Element, options?: dxSankeyOptions)
  9152. constructor(element: JQuery, options?: dxSankeyOptions)
  9153. /** Gets all sankey links. */
  9154. getAllLinks(): Array<dxSankeyLink>;
  9155. /** Gets all sankey nodes. */
  9156. getAllNodes(): Array<dxSankeyNode>;
  9157. /** Gets the DataSource instance. */
  9158. getDataSource(): DevExpress.data.DataSource;
  9159. /** Hides all widget tooltips. */
  9160. hideTooltip(): void;
  9161. }
  9162. export interface dxSankeyConnectionInfoObject {
  9163. /** The title of the link's source node. */
  9164. source?: string;
  9165. /** The title of the link's target node. */
  9166. target?: string;
  9167. /** The link's weight. */
  9168. weight?: number;
  9169. }
  9170. /** A sankey link's structure. */
  9171. export class dxSankeyLink {
  9172. /** An object that describes the connection. */
  9173. connection: dxSankeyConnectionInfoObject;
  9174. /** Hides the sankey link's tooltip. */
  9175. hideTooltip(): void;
  9176. /** Changes the sankey link's hover state. */
  9177. hover(state: boolean): void;
  9178. /** Indicates whether the sankey link is in the hover state. */
  9179. isHovered(): boolean;
  9180. /** Shows the sankey link's tooltip. */
  9181. showTooltip(): void;
  9182. }
  9183. /** A sankey node's structure. */
  9184. export class dxSankeyNode {
  9185. /** The node's incoming links. */
  9186. linksIn: Array<any>;
  9187. /** The node's outgoing links. */
  9188. linksOut: Array<any>;
  9189. /** The node's title. */
  9190. title: string;
  9191. /** Hides the sankey node's tooltip. */
  9192. hideTooltip(): void;
  9193. /** Changes the sankey node's hover state. */
  9194. hover(state: boolean): void;
  9195. /** Indicates whether the sankey node is in the hover state. */
  9196. isHovered(): boolean;
  9197. /** Shows the sankey node's tooltip. */
  9198. showTooltip(): void;
  9199. }
  9200. export interface dxSparklineOptions extends BaseSparklineOptions<dxSparkline> {
  9201. /** Specifies the data source field that provides arguments for a sparkline. */
  9202. argumentField?: string;
  9203. /** Sets a color for the bars indicating negative values. Available for a sparkline of the bar type only. */
  9204. barNegativeColor?: string;
  9205. /** Sets a color for the bars indicating positive values. Available for a sparkline of the bar type only. */
  9206. barPositiveColor?: string;
  9207. /** Binds the widget to data. */
  9208. dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string;
  9209. /** Sets a color for the boundary of both the first and last points on a sparkline. */
  9210. firstLastColor?: string;
  9211. /** Specifies whether the sparkline should ignore null data points. */
  9212. ignoreEmptyPoints?: boolean;
  9213. /** Sets a color for a line on a sparkline. Available for the sparklines of the line- and area-like types. */
  9214. lineColor?: string;
  9215. /** Specifies a width for a line on a sparkline. Available for the sparklines of the line- and area-like types. */
  9216. lineWidth?: number;
  9217. /** Sets a color for the bars indicating the values that are less than the winloss threshold. Available for a sparkline of the winloss type only. */
  9218. lossColor?: string;
  9219. /** Sets a color for the boundary of the maximum point on a sparkline. */
  9220. maxColor?: string;
  9221. /** Specifies the maximum value of the sparkline's value axis. */
  9222. maxValue?: number;
  9223. /** Sets a color for the boundary of the minimum point on a sparkline. */
  9224. minColor?: string;
  9225. /** Specifies the minimum value of the sparkline value axis. */
  9226. minValue?: number;
  9227. /** Sets a color for points on a sparkline. Available for the sparklines of the line- and area-like types. */
  9228. pointColor?: string;
  9229. /** Specifies the diameter of sparkline points in pixels. Available for the sparklines of line- and area-like types. */
  9230. pointSize?: number;
  9231. /** Specifies a symbol to use as a point marker on a sparkline. Available for the sparklines of the line- and area-like types. */
  9232. pointSymbol?: 'circle' | 'cross' | 'polygon' | 'square' | 'triangle';
  9233. /** Specifies whether or not to indicate both the first and last values on a sparkline. */
  9234. showFirstLast?: boolean;
  9235. /** Specifies whether or not to indicate both the minimum and maximum values on a sparkline. */
  9236. showMinMax?: boolean;
  9237. /** Determines the type of a sparkline. */
  9238. type?: 'area' | 'bar' | 'line' | 'spline' | 'splinearea' | 'steparea' | 'stepline' | 'winloss';
  9239. /** Specifies the data source field that provides values for a sparkline. */
  9240. valueField?: string;
  9241. /** Sets a color for the bars indicating the values greater than a winloss threshold. Available for a sparkline of the winloss type only. */
  9242. winColor?: string;
  9243. /** Specifies a value that serves as a threshold for the sparkline of the winloss type. */
  9244. winlossThreshold?: number;
  9245. }
  9246. /** The Sparkline widget is a compact chart that contains only one series. Owing to their size, sparklines occupy very little space and can be easily collected in a table or embedded straight in text. */
  9247. export class dxSparkline extends BaseSparkline {
  9248. constructor(element: Element, options?: dxSparklineOptions)
  9249. constructor(element: JQuery, options?: dxSparklineOptions)
  9250. /** Gets the DataSource instance. */
  9251. getDataSource(): DevExpress.data.DataSource;
  9252. }
  9253. export interface dxTreeMapOptions extends BaseWidgetOptions<dxTreeMap> {
  9254. /** Specifies the name of the data source field that provides nested items for a group. Applies to hierarchical data sources only. */
  9255. childrenField?: string;
  9256. /** Specifies the name of the data source field that provides colors for tiles. */
  9257. colorField?: string;
  9258. /** Manages the color settings. */
  9259. colorizer?: { colorCodeField?: string, colorizeGroups?: boolean, palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office', paletteExtensionMode?: 'alternate' | 'blend' | 'extrapolate', range?: Array<number>, type?: 'discrete' | 'gradient' | 'none' | 'range' };
  9260. /** Binds the widget to data. */
  9261. dataSource?: Array<any> | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string;
  9262. /** Configures groups. */
  9263. group?: { border?: { color?: string, width?: number }, color?: string, headerHeight?: number, hoverEnabled?: boolean, hoverStyle?: { border?: { color?: string, width?: number }, color?: string }, label?: { font?: Font, textOverflow?: 'ellipsis' | 'hide' | 'none', visible?: boolean }, selectionStyle?: { border?: { color?: string, width?: number }, color?: string } };
  9264. /** Specifies whether tiles and groups change their style when a user pauses on them. */
  9265. hoverEnabled?: boolean;
  9266. /** Specifies the name of the data source field that provides IDs for items. Applies to plain data sources only. */
  9267. idField?: string;
  9268. /** Specifies whether the user will interact with a single tile or its group. */
  9269. interactWithGroup?: boolean;
  9270. /** Specifies the name of the data source field that provides texts for tile and group labels. */
  9271. labelField?: string;
  9272. /** Specifies the layout algorithm. */
  9273. layoutAlgorithm?: 'sliceanddice' | 'squarified' | 'strip' | ((e: { rect?: Array<number>, sum?: number, items?: Array<any> }) => any);
  9274. /** Specifies the direction in which the items will be laid out. */
  9275. layoutDirection?: 'leftBottomRightTop' | 'leftTopRightBottom' | 'rightBottomLeftTop' | 'rightTopLeftBottom';
  9276. /** Specifies how many hierarchical levels must be visualized. */
  9277. maxDepth?: number;
  9278. /** A function that is executed when a node is clicked or tapped. */
  9279. onClick?: ((e: { component?: dxTreeMap, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, node?: dxTreeMapNode }) => any) | string;
  9280. /** A function that is executed when a user drills up or down. */
  9281. onDrill?: ((e: { component?: dxTreeMap, element?: DevExpress.core.dxElement, model?: any, node?: dxTreeMapNode }) => any);
  9282. /** A function that is executed after the pointer enters or leaves a node. */
  9283. onHoverChanged?: ((e: { component?: dxTreeMap, element?: DevExpress.core.dxElement, model?: any, node?: dxTreeMapNode }) => any);
  9284. /** A function that is executed only once, after the nodes are initialized. */
  9285. onNodesInitialized?: ((e: { component?: dxTreeMap, element?: DevExpress.core.dxElement, model?: any, root?: dxTreeMapNode }) => any);
  9286. /** A function that is executed before the nodes are displayed and each time the collection of active nodes is changed. */
  9287. onNodesRendering?: ((e: { component?: dxTreeMap, element?: DevExpress.core.dxElement, model?: any, node?: dxTreeMapNode }) => any);
  9288. /** A function that is executed when a node is selected or selection is canceled. */
  9289. onSelectionChanged?: ((e: { component?: dxTreeMap, element?: DevExpress.core.dxElement, model?: any, node?: dxTreeMapNode }) => any);
  9290. /** Specifies the name of the data source field that provides parent IDs for items. Applies to plain data sources only. */
  9291. parentField?: string;
  9292. /** @deprecated Use the tile.label.textOverflow option instead. */
  9293. /** Decides whether those labels that overflow their tile/group should be hidden or truncated with ellipsis. */
  9294. resolveLabelOverflow?: 'ellipsis' | 'hide';
  9295. /** Specifies whether a single or multiple nodes can be in the selected state simultaneously. */
  9296. selectionMode?: 'multiple' | 'none' | 'single';
  9297. /** Configures tiles. */
  9298. tile?: { border?: { color?: string, width?: number }, color?: string, hoverStyle?: { border?: { color?: string, width?: number }, color?: string }, label?: { font?: Font, textOverflow?: 'ellipsis' | 'hide' | 'none', visible?: boolean, wordWrap?: 'normal' | 'breakWord' | 'none' }, selectionStyle?: { border?: { color?: string, width?: number }, color?: string } };
  9299. /** Configures tooltips - small pop-up rectangles that display information about a data-visualizing widget element being pressed or hovered over with the mouse pointer. */
  9300. tooltip?: dxTreeMapTooltip;
  9301. /** Specifies the name of the data source field that provides values for tiles. */
  9302. valueField?: string;
  9303. }
  9304. /** Configures tooltips - small pop-up rectangles that display information about a data-visualizing widget element being pressed or hovered over with the mouse pointer. */
  9305. export interface dxTreeMapTooltip extends BaseWidgetTooltip {
  9306. /** Allows you to change tooltip appearance. */
  9307. customizeTooltip?: ((info: { value?: number, valueText?: string, node?: dxTreeMapNode }) => any);
  9308. }
  9309. /** The TreeMap is a widget that displays hierarchical data by using nested rectangles. */
  9310. export class dxTreeMap extends BaseWidget {
  9311. constructor(element: Element, options?: dxTreeMapOptions)
  9312. constructor(element: JQuery, options?: dxTreeMapOptions)
  9313. /** Deselects all nodes in the widget. */
  9314. clearSelection(): void;
  9315. /** Drills one level up. */
  9316. drillUp(): void;
  9317. /** Gets the current node. */
  9318. getCurrentNode(): dxTreeMapNode;
  9319. /** Gets the DataSource instance. */
  9320. getDataSource(): DevExpress.data.DataSource;
  9321. /** Gets the root node. */
  9322. getRootNode(): dxTreeMapNode;
  9323. /** Hides the tooltip. */
  9324. hideTooltip(): void;
  9325. /** Resets the drill down level. */
  9326. resetDrillDown(): void;
  9327. }
  9328. /** This section describes the Node object, which represents a treemap node. */
  9329. export class dxTreeMapNode {
  9330. /** The object from the data source visualized by the node. */
  9331. data: any;
  9332. /** The index of the current node in the array of all nodes on the same level. */
  9333. index: number;
  9334. /** The level that the current node occupies in the hierarchy of nodes. */
  9335. level: number;
  9336. /** Customizes the node. */
  9337. customize(options: any): void;
  9338. /** Drills down into the node. */
  9339. drillDown(): void;
  9340. /** Returns all nodes nested in the current node. */
  9341. getAllChildren(): Array<dxTreeMapNode>;
  9342. /** Returns all descendant nodes. */
  9343. getAllNodes(): Array<dxTreeMapNode>;
  9344. /** Gets a specific node from a collection of direct descendants. */
  9345. getChild(index: number): dxTreeMapNode;
  9346. /** Indicates how many direct descendants the current node has. */
  9347. getChildrenCount(): number;
  9348. /** Returns the parent node of the current node. */
  9349. getParent(): dxTreeMapNode;
  9350. /** Indicates whether the current node is active. */
  9351. isActive(): boolean;
  9352. /** Indicates whether the node is in the hover state or not. */
  9353. isHovered(): boolean;
  9354. /** Indicates whether the node is visualized by a tile or a group of tiles. */
  9355. isLeaf(): boolean;
  9356. /** Indicates whether the node is selected or not. */
  9357. isSelected(): boolean;
  9358. /** Returns the label of the node. */
  9359. label(): string;
  9360. /** Sets the label to the node. */
  9361. label(label: string): void;
  9362. /** Reverts the appearance of the node to the initial state. */
  9363. resetCustomization(): void;
  9364. /** Sets the selection state of a node. */
  9365. select(state: boolean): void;
  9366. /** Shows the tooltip. */
  9367. showTooltip(): void;
  9368. /** Gets the raw value of the node. */
  9369. value(): number;
  9370. }
  9371. export interface dxVectorMapOptions extends BaseWidgetOptions<dxVectorMap> {
  9372. /** Specifies the options for the map background. */
  9373. background?: { borderColor?: string, color?: string };
  9374. /** Specifies the positioning of a map in geographical coordinates. */
  9375. bounds?: Array<number>;
  9376. /** Specifies the geographical coordinates of the center for a map. */
  9377. center?: Array<number>;
  9378. /** Configures the control bar. */
  9379. controlBar?: { borderColor?: string, color?: string, enabled?: boolean, horizontalAlignment?: 'center' | 'left' | 'right', margin?: number, opacity?: number, verticalAlignment?: 'bottom' | 'top' };
  9380. /** Specifies options for VectorMap widget layers. */
  9381. layers?: Array<{ borderColor?: string, borderWidth?: number, color?: string, colorGroupingField?: string, colorGroups?: Array<number>, customize?: ((elements: Array<MapLayerElement>) => any), dataField?: string, dataSource?: any | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string, elementType?: 'bubble' | 'dot' | 'image' | 'pie', hoverEnabled?: boolean, hoveredBorderColor?: string, hoveredBorderWidth?: number, hoveredColor?: string, label?: { dataField?: string, enabled?: boolean, font?: Font }, maxSize?: number, minSize?: number, name?: string, opacity?: number, palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office', paletteSize?: number, selectedBorderColor?: string, selectedBorderWidth?: number, selectedColor?: string, selectionMode?: 'multiple' | 'none' | 'single', size?: number, sizeGroupingField?: string, sizeGroups?: Array<number>, type?: 'area' | 'line' | 'marker' }> | { borderColor?: string, borderWidth?: number, color?: string, colorGroupingField?: string, colorGroups?: Array<number>, customize?: ((elements: Array<MapLayerElement>) => any), dataField?: string, dataSource?: any | DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string, elementType?: 'bubble' | 'dot' | 'image' | 'pie', hoverEnabled?: boolean, hoveredBorderColor?: string, hoveredBorderWidth?: number, hoveredColor?: string, label?: { dataField?: string, enabled?: boolean, font?: Font }, maxSize?: number, minSize?: number, name?: string, opacity?: number, palette?: Array<string> | 'Bright' | 'Default' | 'Harmony Light' | 'Ocean' | 'Pastel' | 'Soft' | 'Soft Pastel' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Dark Violet' | 'Green Mist' | 'Soft Blue' | 'Material' | 'Office', paletteSize?: number, selectedBorderColor?: string, selectedBorderWidth?: number, selectedColor?: string, selectionMode?: 'multiple' | 'none' | 'single', size?: number, sizeGroupingField?: string, sizeGroups?: Array<number>, type?: 'area' | 'line' | 'marker' };
  9382. /** Configures map legends. */
  9383. legends?: Array<dxVectorMapLegends>;
  9384. /** Specifies a map's maximum zoom factor. */
  9385. maxZoomFactor?: number;
  9386. /** A function that is executed each time the center coordinates are changed. */
  9387. onCenterChanged?: ((e: { component?: dxVectorMap, element?: DevExpress.core.dxElement, model?: any, center?: Array<number> }) => any);
  9388. /** A function that is executed when any location on the map is clicked or tapped. */
  9389. onClick?: ((e: { component?: dxVectorMap, element?: DevExpress.core.dxElement, model?: any, jQueryEvent?: JQueryEventObject, event?: event, target?: MapLayerElement }) => any) | string;
  9390. /** A function that is executed when a layer element is selected or selection is canceled. */
  9391. onSelectionChanged?: ((e: { component?: dxVectorMap, element?: DevExpress.core.dxElement, model?: any, target?: MapLayerElement }) => any);
  9392. /** A function that is executed when a tooltip becomes hidden. */
  9393. onTooltipHidden?: ((e: { component?: dxVectorMap, element?: DevExpress.core.dxElement, model?: any, target?: MapLayerElement }) => any);
  9394. /** A function that is executed when a tooltip appears. */
  9395. onTooltipShown?: ((e: { component?: dxVectorMap, element?: DevExpress.core.dxElement, model?: any, target?: MapLayerElement }) => any);
  9396. /** A function that is executed each time the zoom factor is changed. */
  9397. onZoomFactorChanged?: ((e: { component?: dxVectorMap, element?: DevExpress.core.dxElement, model?: any, zoomFactor?: number }) => any);
  9398. /** Disables the panning capability. */
  9399. panningEnabled?: boolean;
  9400. /** Specifies the map projection. */
  9401. projection?: any;
  9402. /** Configures tooltips. */
  9403. tooltip?: dxVectorMapTooltip;
  9404. /** Specifies whether the map should respond to touch gestures. */
  9405. touchEnabled?: boolean;
  9406. /** Specifies whether or not the map should respond when a user rolls the mouse wheel. */
  9407. wheelEnabled?: boolean;
  9408. /** Specifies a number that is used to zoom a map initially. */
  9409. zoomFactor?: number;
  9410. /** Disables the zooming capability. */
  9411. zoomingEnabled?: boolean;
  9412. }
  9413. /** Configures map legends. */
  9414. export interface dxVectorMapLegends extends BaseLegend {
  9415. /** Specifies text for a hint that appears when a user hovers the mouse pointer over the text of a legend item. */
  9416. customizeHint?: ((itemInfo: { start?: number, end?: number, index?: number, color?: string, size?: number }) => string);
  9417. /** Allows you to change the order and visibility of legend items. */
  9418. customizeItems?: ((items: Array<VectorMapLegendItem>) => Array<VectorMapLegendItem>);
  9419. /** Specifies text for legend items. */
  9420. customizeText?: ((itemInfo: { start?: number, end?: number, index?: number, color?: string, size?: number }) => string);
  9421. /** Specifies the legend items' font options. */
  9422. font?: Font;
  9423. /** Specifies the color of item markers in the legend. The specified color applied only when the legend uses 'size' source. */
  9424. markerColor?: string;
  9425. /** Specifies the shape of item markers. */
  9426. markerShape?: 'circle' | 'square';
  9427. /** Specifies the marker's size in a legend item in pixels. */
  9428. markerSize?: number;
  9429. /** Specifies the source of data for the legend. */
  9430. source?: { grouping?: string, layer?: string };
  9431. }
  9432. /** Configures tooltips. */
  9433. export interface dxVectorMapTooltip extends BaseWidgetTooltip {
  9434. /** Specifies text and appearance of a set of tooltips. */
  9435. customizeTooltip?: ((info: MapLayerElement) => any);
  9436. }
  9437. /** The VectorMap is a widget that visualizes geographical locations. This widget represents a geographical map that contains areas and markers. Areas embody continents and countries. Markers flag specific points on the map, for example, towns, cities or capitals. */
  9438. export class dxVectorMap extends BaseWidget {
  9439. constructor(element: Element, options?: dxVectorMapOptions)
  9440. constructor(element: JQuery, options?: dxVectorMapOptions)
  9441. /** Gets the current map center coordinates. */
  9442. center(): Array<number>;
  9443. /** Sets the map center coordinates. */
  9444. center(centerCoordinates: Array<number>): void;
  9445. /** Deselects all the selected area and markers on a map at once. The areas and markers are displayed in their initial style after. */
  9446. clearSelection(): void;
  9447. /** Converts client area coordinates into map coordinates. */
  9448. convertCoordinates(x: number, y: number): Array<number>;
  9449. /** Gets a layer with a specific index. */
  9450. getLayerByIndex(index: number): MapLayer;
  9451. /** Gets a layer with a specific name. */
  9452. getLayerByName(name: string): MapLayer;
  9453. /** Gets all layers. */
  9454. getLayers(): Array<MapLayer>;
  9455. /** Gets the current map viewport coordinates. */
  9456. viewport(): Array<number>;
  9457. /** Sets the map viewport coordinates. */
  9458. viewport(viewportCoordinates: Array<number>): void;
  9459. /** Gets the current zoom factor value. */
  9460. zoomFactor(): number;
  9461. /** Sets the zoom factor value. */
  9462. zoomFactor(zoomFactor: number): void;
  9463. }
  9464. /** An object that defines a gauge indicator of the circle type. */
  9465. export type linearCircle = CommonIndicator;
  9466. /** An object that defines a gauge indicator of the rangeBar type. */
  9467. export type linearRangeBar = CommonIndicator;
  9468. /** An object defining a gauge indicator of the rectangle type. */
  9469. export type linearRectangle = CommonIndicator;
  9470. /** An object defining a gauge indicator of the rhombus type. */
  9471. export type linearRhombus = CommonIndicator;
  9472. /** An object that defines a gauge indicator of the textCloud type. */
  9473. export type linearTextCloud = CommonIndicator;
  9474. /** An object that defines a gauge indicator of the triangleMarker type. */
  9475. export type linearTriangleMarker = CommonIndicator;
  9476. /** This section describes the Series object, which represents a series. */
  9477. export class pieChartSeriesObject extends baseSeriesObject {
  9478. }
  9479. /** This section describes the Point object, which represents a series point. */
  9480. export class piePointObject extends basePointObject {
  9481. /** Gets the percentage value of the specific point. */
  9482. percent: string | number | Date;
  9483. /** Hides a specific point. */
  9484. hide(): void;
  9485. /** Hides the tooltip of the point. */
  9486. hideTooltip(): void;
  9487. /** Provides information about the visibility state of a point. */
  9488. isVisible(): boolean;
  9489. /** Makes a specific point visible. */
  9490. show(): void;
  9491. /** Shows the tooltip of the point. */
  9492. showTooltip(): void;
  9493. }
  9494. /** This section describes the Series object, which represents a series. */
  9495. export class polarChartSeriesObject extends baseSeriesObject {
  9496. }
  9497. /** This section describes the Point object, which represents a series point. */
  9498. export class polarPointObject extends basePointObject {
  9499. }
  9500. }
  9501. declare module DevExpress.viz.map {
  9502. /** Creates a new projection. */
  9503. export function projection(data: { to?: Function, from?: Function, aspectRatio?: number }): any;
  9504. }
  9505. declare module DevExpress.viz.map.projection {
  9506. /** Adds a new projection to the internal projections storage. */
  9507. export function add(name: string, projection: any): void;
  9508. /** Gets the default or custom projection from the projection storage. */
  9509. export function get(name: string): any;
  9510. }
  9511. declare module DevExpress.viz {
  9512. /** @deprecated Use DevExpress.viz.ChartSeries instead */
  9513. export type dxChartSeries = DevExpress.viz.ChartSeries;
  9514. /** @deprecated Use DevExpress.viz.PieChartSeries instead */
  9515. export type dxPieChartSeries = DevExpress.viz.PieChartSeries;
  9516. /** @deprecated Use DevExpress.viz.PolarChartSeries instead */
  9517. export type dxPolarChartSeries = DevExpress.viz.PolarChartSeries;
  9518. /** @deprecated Use DevExpress.viz instead */
  9519. export module charts {
  9520. export type dxChartOptions = DevExpress.viz.dxChartOptions;
  9521. export type dxChartArgumentAxis = DevExpress.viz.dxChartArgumentAxis;
  9522. export type dxChartArgumentAxisConstantLines = DevExpress.viz.dxChartArgumentAxisConstantLines;
  9523. export type dxChartArgumentAxisConstantLinesLabel = DevExpress.viz.dxChartArgumentAxisConstantLinesLabel;
  9524. export type dxChartArgumentAxisConstantLineStyle = DevExpress.viz.dxChartArgumentAxisConstantLineStyle;
  9525. export type dxChartArgumentAxisConstantLineStyleLabel = DevExpress.viz.dxChartArgumentAxisConstantLineStyleLabel;
  9526. export type dxChartArgumentAxisLabel = DevExpress.viz.dxChartArgumentAxisLabel;
  9527. export type dxChartArgumentAxisStrips = DevExpress.viz.dxChartArgumentAxisStrips;
  9528. export type dxChartArgumentAxisStripsLabel = DevExpress.viz.dxChartArgumentAxisStripsLabel;
  9529. export type dxChartArgumentAxisTitle = DevExpress.viz.dxChartArgumentAxisTitle;
  9530. export type dxChartCommonAxisSettings = DevExpress.viz.dxChartCommonAxisSettings;
  9531. export type dxChartCommonAxisSettingsConstantLineStyle = DevExpress.viz.dxChartCommonAxisSettingsConstantLineStyle;
  9532. export type dxChartCommonAxisSettingsConstantLineStyleLabel = DevExpress.viz.dxChartCommonAxisSettingsConstantLineStyleLabel;
  9533. export type dxChartCommonAxisSettingsLabel = DevExpress.viz.dxChartCommonAxisSettingsLabel;
  9534. export type dxChartCommonAxisSettingsStripStyle = DevExpress.viz.dxChartCommonAxisSettingsStripStyle;
  9535. export type dxChartCommonAxisSettingsStripStyleLabel = DevExpress.viz.dxChartCommonAxisSettingsStripStyleLabel;
  9536. export type dxChartCommonAxisSettingsTitle = DevExpress.viz.dxChartCommonAxisSettingsTitle;
  9537. export type dxChartCommonPaneSettings = DevExpress.viz.dxChartCommonPaneSettings;
  9538. export type dxChartCommonSeriesSettings = DevExpress.viz.dxChartCommonSeriesSettings;
  9539. export type dxChartLegend = DevExpress.viz.dxChartLegend;
  9540. export type dxChartPanes = DevExpress.viz.dxChartPanes;
  9541. export type dxChartSeries = DevExpress.viz.dxChartSeries;
  9542. export type dxChartTooltip = DevExpress.viz.dxChartTooltip;
  9543. export type dxChartValueAxis = DevExpress.viz.dxChartValueAxis;
  9544. export type dxChartValueAxisConstantLines = DevExpress.viz.dxChartValueAxisConstantLines;
  9545. export type dxChartValueAxisConstantLinesLabel = DevExpress.viz.dxChartValueAxisConstantLinesLabel;
  9546. export type dxChartValueAxisConstantLineStyle = DevExpress.viz.dxChartValueAxisConstantLineStyle;
  9547. export type dxChartValueAxisConstantLineStyleLabel = DevExpress.viz.dxChartValueAxisConstantLineStyleLabel;
  9548. export type dxChartValueAxisLabel = DevExpress.viz.dxChartValueAxisLabel;
  9549. export type dxChartValueAxisStrips = DevExpress.viz.dxChartValueAxisStrips;
  9550. export type dxChartValueAxisStripsLabel = DevExpress.viz.dxChartValueAxisStripsLabel;
  9551. export type dxChartValueAxisTitle = DevExpress.viz.dxChartValueAxisTitle;
  9552. export type dxPieChartOptions = DevExpress.viz.dxPieChartOptions;
  9553. export type dxPieChartAdaptiveLayout = DevExpress.viz.dxPieChartAdaptiveLayout;
  9554. export type dxPieChartLegend = DevExpress.viz.dxPieChartLegend;
  9555. export type dxPieChartSeries = DevExpress.viz.dxPieChartSeries;
  9556. export type dxPolarChartOptions = DevExpress.viz.dxPolarChartOptions;
  9557. export type dxPolarChartAdaptiveLayout = DevExpress.viz.dxPolarChartAdaptiveLayout;
  9558. export type dxPolarChartArgumentAxis = DevExpress.viz.dxPolarChartArgumentAxis;
  9559. export type dxPolarChartArgumentAxisConstantLines = DevExpress.viz.dxPolarChartArgumentAxisConstantLines;
  9560. export type dxPolarChartArgumentAxisConstantLinesLabel = DevExpress.viz.dxPolarChartArgumentAxisConstantLinesLabel;
  9561. export type dxPolarChartArgumentAxisLabel = DevExpress.viz.dxPolarChartArgumentAxisLabel;
  9562. export type dxPolarChartArgumentAxisStrips = DevExpress.viz.dxPolarChartArgumentAxisStrips;
  9563. export type dxPolarChartArgumentAxisStripsLabel = DevExpress.viz.dxPolarChartArgumentAxisStripsLabel;
  9564. export type dxPolarChartCommonAxisSettings = DevExpress.viz.dxPolarChartCommonAxisSettings;
  9565. export type dxPolarChartCommonAxisSettingsConstantLineStyle = DevExpress.viz.dxPolarChartCommonAxisSettingsConstantLineStyle;
  9566. export type dxPolarChartCommonAxisSettingsConstantLineStyleLabel = DevExpress.viz.dxPolarChartCommonAxisSettingsConstantLineStyleLabel;
  9567. export type dxPolarChartCommonAxisSettingsLabel = DevExpress.viz.dxPolarChartCommonAxisSettingsLabel;
  9568. export type dxPolarChartCommonAxisSettingsStripStyle = DevExpress.viz.dxPolarChartCommonAxisSettingsStripStyle;
  9569. export type dxPolarChartCommonAxisSettingsStripStyleLabel = DevExpress.viz.dxPolarChartCommonAxisSettingsStripStyleLabel;
  9570. export type dxPolarChartCommonAxisSettingsTick = DevExpress.viz.dxPolarChartCommonAxisSettingsTick;
  9571. export type dxPolarChartCommonSeriesSettings = DevExpress.viz.dxPolarChartCommonSeriesSettings;
  9572. export type dxPolarChartLegend = DevExpress.viz.dxPolarChartLegend;
  9573. export type dxPolarChartSeries = DevExpress.viz.dxPolarChartSeries;
  9574. export type dxPolarChartTooltip = DevExpress.viz.dxPolarChartTooltip;
  9575. export type dxPolarChartValueAxis = DevExpress.viz.dxPolarChartValueAxis;
  9576. export type dxPolarChartValueAxisConstantLines = DevExpress.viz.dxPolarChartValueAxisConstantLines;
  9577. export type dxPolarChartValueAxisConstantLinesLabel = DevExpress.viz.dxPolarChartValueAxisConstantLinesLabel;
  9578. export type dxPolarChartValueAxisLabel = DevExpress.viz.dxPolarChartValueAxisLabel;
  9579. export type dxPolarChartValueAxisStrips = DevExpress.viz.dxPolarChartValueAxisStrips;
  9580. export type dxPolarChartValueAxisStripsLabel = DevExpress.viz.dxPolarChartValueAxisStripsLabel;
  9581. export type dxPolarChartValueAxisTick = DevExpress.viz.dxPolarChartValueAxisTick;
  9582. }
  9583. /** @deprecated Use DevExpress.viz instead */
  9584. export module funnel {
  9585. export type dxFunnelOptions = DevExpress.viz.dxFunnelOptions;
  9586. export type dxFunnelTooltip = DevExpress.viz.dxFunnelTooltip;
  9587. }
  9588. /** @deprecated Use DevExpress.viz instead */
  9589. export module gauges {
  9590. export type dxCircularGaugeOptions = DevExpress.viz.dxCircularGaugeOptions;
  9591. export type dxCircularGaugeRangeContainer = DevExpress.viz.dxCircularGaugeRangeContainer;
  9592. export type dxCircularGaugeScale = DevExpress.viz.dxCircularGaugeScale;
  9593. export type dxCircularGaugeScaleLabel = DevExpress.viz.dxCircularGaugeScaleLabel;
  9594. export type dxLinearGaugeOptions = DevExpress.viz.dxLinearGaugeOptions;
  9595. export type dxLinearGaugeRangeContainer = DevExpress.viz.dxLinearGaugeRangeContainer;
  9596. export type dxLinearGaugeScale = DevExpress.viz.dxLinearGaugeScale;
  9597. export type dxLinearGaugeScaleLabel = DevExpress.viz.dxLinearGaugeScaleLabel;
  9598. export type dxBarGaugeOptions = DevExpress.viz.dxBarGaugeOptions;
  9599. export type dxBarGaugeTooltip = DevExpress.viz.dxBarGaugeTooltip;
  9600. }
  9601. /** @deprecated Use DevExpress.viz instead */
  9602. export module rangeSelector {
  9603. export type dxRangeSelectorOptions = DevExpress.viz.dxRangeSelectorOptions;
  9604. }
  9605. /** @deprecated Use DevExpress.viz instead */
  9606. export module sparklines {
  9607. export type dxSparklineOptions = DevExpress.viz.dxSparklineOptions;
  9608. export type dxBulletOptions = DevExpress.viz.dxBulletOptions;
  9609. }
  9610. /** @deprecated Use DevExpress.viz instead */
  9611. export module map {
  9612. export type dxVectorMapOptions = DevExpress.viz.dxVectorMapOptions;
  9613. export type dxVectorMapTooltip = DevExpress.viz.dxVectorMapTooltip;
  9614. }
  9615. /** @deprecated Use DevExpress.viz instead */
  9616. export module treeMap {
  9617. export type dxTreeMapOptions = DevExpress.viz.dxTreeMapOptions;
  9618. export type dxTreeMapTooltip = DevExpress.viz.dxTreeMapTooltip;
  9619. }
  9620. }
  9621. declare module DevExpress.ui {
  9622. /** @deprecated Use DevExpress.ui.dxAccordionItem */
  9623. export type dxAccordionItemTemplate = DevExpress.ui.dxAccordionItem;
  9624. /** @deprecated Use DevExpress.ui.dxActionSheetItem */
  9625. export type dxActionSheetItemTemplate = DevExpress.ui.dxActionSheetItem;
  9626. /** @deprecated Use DevExpress.ui.dxBoxItem */
  9627. export type dxBoxItemTemplate = DevExpress.ui.dxBoxItem;
  9628. /** @deprecated Use DevExpress.ui.dxGalleryItem */
  9629. export type dxGalleryItemTemplate = DevExpress.ui.dxGalleryItem;
  9630. /** @deprecated Use DevExpress.ui.dxMultiViewItem */
  9631. export type dxMultiViewItemTemplate = DevExpress.ui.dxMultiViewItem;
  9632. /** @deprecated Use DevExpress.ui.dxNavBarItem */
  9633. export type dxNavBarItemTemplate = DevExpress.ui.dxNavBarItem;
  9634. /** @deprecated Use DevExpress.ui.dxResponsiveBoxItem */
  9635. export type dxResponsiveBoxItemTemplate = DevExpress.ui.dxResponsiveBoxItem;
  9636. /** @deprecated Use DevExpress.ui.dxSchedulerAppointment */
  9637. export type dxSchedulerAppointmentTemplate = DevExpress.ui.dxSchedulerAppointment;
  9638. /** @deprecated Use DevExpress.ui.dxSlideOutItem */
  9639. export type dxSlideOutItemTemplate = DevExpress.ui.dxSlideOutItem;
  9640. /** @deprecated Use DevExpress.ui.dxTabsItem */
  9641. export type dxTabsItemTemplate = DevExpress.ui.dxTabsItem;
  9642. /** @deprecated Use DevExpress.ui.dxTabPanelItem */
  9643. export type dxTabPanelItemTemplate = DevExpress.ui.dxTabPanelItem;
  9644. /** @deprecated Use DevExpress.ui.dxTileViewItem */
  9645. export type dxTileViewItemTemplate = DevExpress.ui.dxTileViewItem;
  9646. /** @deprecated Use DevExpress.ui.dxToolbarItem */
  9647. export type dxToolbarItemTemplate = DevExpress.ui.dxToolbarItem;
  9648. /** @deprecated Use DevExpress.ui.CollectionWidgetItem */
  9649. export type CollectionWidgetItemTemplate = DevExpress.ui.CollectionWidgetItem;
  9650. /** @deprecated Use DevExpress.ui.dxContextMenuItem */
  9651. export type dxContextMenuItemTemplate = DevExpress.ui.dxContextMenuItem;
  9652. /** @deprecated Use DevExpress.ui.dxMenuBaseItem */
  9653. export type dxMenuBaseItemTemplate = DevExpress.ui.dxMenuBaseItem;
  9654. /** @deprecated Use DevExpress.ui.CollectionWidgetItem */
  9655. export type DataExpressionMixinItemTemplate = DevExpress.ui.CollectionWidgetItem;
  9656. /** @deprecated Use DevExpress.ui.dxListItem */
  9657. export type dxListItemTemplate = DevExpress.ui.dxListItem;
  9658. /** @deprecated Use DevExpress.ui.dxMenuItem */
  9659. export type dxMenuItemTemplate = DevExpress.ui.dxMenuItem;
  9660. /** @deprecated Use DevExpress.ui.dxTreeViewItem */
  9661. export type dxTreeViewItemTemplate = DevExpress.ui.dxTreeViewItem;
  9662. }