Qt基类翻译-招募人员翻译

ＱgrａｐｈｉcsＩｔemＱgrａpｈｉcｓItem是ＱGrａphiｃsＳｃｅnｅ中全部项目的基类。对于自定义ＱGｒａphicsＳｃene的项目，它供应了重要的功能。包括项目的图形集合，碰撞检测，描绘实现(pａintinｇimpleｍenｔａtioｎ),大事间的相互影响。QGｒａpｈｉcｓItem是TheGｒaｐhｉcsVｉew框架的一部分。Qt供应大多数常用的图形项目：QGrａphicｓEｌｌｉｐsｅIｔｅm供应一个椭圆项目。QGｒapｈiｃsLｉｎeIteｍ供应一个直线项目。ＱGraphicsＰａｔhIｔeｍ供应一个路径项目。QGraphicｓPixmａpＩtem供应一个位图项目QGraｐhiｃsPolｙgｏnIteｍ供应一个区域项目ＱＧraｐhｉcｓRectIteｍ供应一个巨型项目QGraphiｃｓTexｔＩｔｅm供应一个文本项目项目的全部图形集合信息基于自己的坐标系。项目的位置(ｐos（）函数）是唯一一个不基于自己的坐标系的函数，它使用它的父坐标系(ＧｒaphicsＶiｅｗ的坐标系）。你可以使用seｔVisibｌｅ（）设置一个项目是否是可视的(也就是说画和接受大事处理）.隐藏一个项目，它的全部子项目也隐藏了.相同地,可以使用setEnaｂled（)．设置一个项目是否可用。一个项目不行用，它的全部子项目也不行用。选择一个项目,首先设置IｔｅmIsSeleｃtaｂlｅ,标记一个项目启动选择。然后调用setSｅｌｅcｔed（）。通常，作为用户交互的结果GraｐhｉcsSｃeｎe被选择.自己写项目,须继承QＧｒaphicsＩtｅm，类。然后实现２个纯虚方法ｂｏunｄinｇRect（），pａint（）。bｏuｎｄingRect(）返回需要绘画的区域。ｐaｉnｔ（）实现绘画。举个例子:claｓｓSimpｌｅItem:puｂlｉcQGｒａｐhｉcsＩｔeｍ｛pｕｂｌｉc：QReｃtFbouｎｄingＲｅcｔ(）ｃonst{qreａｌpeｎWiｄｔh＝１；rｅtuｒnＱRｅｃｔＦ(－１0－ｐenWidth/2，—10—penＷiｄth/2，20+ｐenＷiｄth/２，20+ｐenWidth／2）;｝ｖoidpａｉnt（ＱPａｉｎter*ｐaiｎter,constQＳtylｅOptionGrａphｉcsＩtｅm*ｏpｔion，QWidget＊wｉdget)｛painter－>drａｗＲouｎdRect(－10，—10，２0,2０);｝｝；ＴheｂoundiｎｇRecｔ（）fｕｎｃtｉonｈaｓｍａnydiｆｆeｒｅnｔpuｒpｏses。ＱGraphｉcsSceｎｅｂasesｉtsｉtemｉｎdｅxonｂｏundｉｎｇＲｅｃt(）,ａnｄQGｒaｐhicsViｅwusesitｂothｆorculｌinｇinｖｉsiblｅitemｓ,andfordeｔeｒmｉnｉngtｈeareathaｔｎeｅdｓtｏbeｒecomposedwhｅndrａｗingoverlａppingiteｍｓ．Ｉnadditｉon,QＧrapｈｉcsItem'scoｌlisioｎdｅtectiｏnmechanｉsmｓuseboundingRecｔ（）toｐrovideanｅfｆｉcｉeｎｔcｕt—ｏfｆ。TheｆinegraｉnedcｏllisionaｌgorｉthmｉｎcoｌlｉdｅsWithＩtｅm（)isｂａｓeｄonｃaｌlｉngshaｐｅ（）,whichｒetuｒnsａnａccurateｏutｌｉｎｅoｆthｅitem'sｓhaｐeａｓaQPainｔerPａth.QGraphicsＳｃeneexpｅctsａlliｔemsｂｏuｎｄingRect()andshaｐｅ(）tｏｒｅmainｕncｈａngeduｎｌeｓｓitiｓnotｉfｉeｄ．Ifyouwaｎtｔｏchaｎgｅaｎitem’sｇeｏmeｔrｙinaｎyｗaｙ，youｍuｓtfirstcａllｐrepareGｅometryChaｎge（)ｔｏalｌoｗQGｒａｐhｉｃsSｃｅnｅtoｕpdateitsbooｋkｅepｉｎg.Coｌlisioｎdｅtecｔioｎcaｎｂedoｎeｉntｗoways：Rｅimplementsｈaｐｅ（）ｔｏretuｒnａnａｃｃｕraｔesｈａpｅforｙouritem,aｎdrelyonthｅｄeｆaultｉｍpleｍｅntａｔｉｏnｏｆcｏllidesWithItｅm()ｔoｄｏsｈape－shａpeintersectｉon。Tｈiｓcanbeｒatherexｐｅnsiｖeifｔheｓｈaｐｅsａrecompleｘ.ReｉmpｌｅｍｅｎtｃｏｌｌｉdesWｉtｈItem（)tｏproｖidｅyouroｗｎcｕstoｍｉtｅｍaｎdsｈａｐｅcｏｌｌisiｏnａlgorithm．Theｃoｎｔaｉns（）funcｔｉoｎｃanbｅcａlｌｅｄtodeterminewhetｈerthｅitemconｔaiｎsapoiｎtｏｒｎot．Thisｆｕnｃｔiｏncanalsｏbeｒｅiｍｐｌemeｎｔedｂｙtｈeiｔem.Tｈedｅfaｕltbeｈavioｒoｆcontaiｎs()isbaｓedoncalliｎgshａｐｅ(）.Iｔemscaｎcoｎtａinotｈｅｒitｅms，aｎdalsobecoｎｔainedbyotheｒｉtems．Aｌliｔemscanｈａｖeaparentｉtemandａlｉｓtｏfchildren。Unlesstheiｔｅｍｈasnopaｒeｎt,itsposｉtｉonｉsinpareｎtｃoordinatｅs（i.e.,tｈepaｒeｎt'ｓloｃａｌcoorｄｉnaｔｅs）.Ｐarｅntiｔeｍsｐropaｇatｅbｏthｔheｉｒｐosiｔionanｄｔｈeｉrtransfｏrmａｔionｔoａllｃhｉｌdｒｅn。QGrapｈｉｃｓIteｍsｕｐｐoｒtsaffｉｎetｒａnsfｏｒｍａｔioｎsｉｎａddｉｔiontoitsbａｓeposiｔiｏｎ，poｓ（).Tｏcｈａｎgetheiｔem＇ｓtraｎsformaｔｉon,yｏucaneｉｔｈerpasｓatraｎsformaｔiｏnmaｔｒiｘtｏsetMａtrix(),ｏrｃalloneｏfthｅｃｏnveｎｉenｃefｕnctｉｏnsｒotaｔe（），ｓｃalｅ（）,tranｓlatｅ（），orshｅar（)。Iｔｅmtrａｎｓformａtｉonsaｃcuｍulaｔefrompareｎtｔｏchｉld,sｏｉfｂothaｐａrenｔaｎｄcｈiｌdiｔemaｒｅｒoｔａtｅd90deｇreeｓ,ｔhecｈｉlｄ’sｔotａｌtrａnsｆｏrmationwilｌbe１80dｅgｒees.Siｍilarlｙ,ｉfｔheitem’spareｎｔisscａｌedto２xitｓoriginaｌsiｚｅ,itsｃｈiｌdｒeｎｗillaｌsobｅtwiceａｓｌarge．Ａniｔem’sｔransfoｒmａtiondoesnｏtaffｅcｔitｓｏwnｌｏcalgeoｍeｔｒy；ａllgeomｅtｒｙfｕncｔioｎs（e．g．，ｃｏntaiｎs（）,updatｅ（）,ａndａllｔｈｅｍappiｎgfuncｔioｎs）stｉllopｅrａtｅinlｏcaｌcｏoｒdinates.Forｃonｖｅnｉｅnce，QGraphicsItempｒｏvidesｔhefuｎｃtｉonssceｎｅMatrｉx(),wｈichretｕrnstheiteｍ'sｔotaltrａnsfｏｒｍａtiｏnmaｔrix(iｎｃludｉngitsposiｔionａnｄａllpaｒents’poｓｉｔiｏnsandtｒａnｓｆoｒmationｓ）,ａndｓcｅnePｏｓ（）,whichreｔurｎsiｔspｏsitｉonｉnｓｃeneｃｏorｄｉｎaｔes.Toresetanitem'smatrｉx,cａlｌrｅsetMａｔｒｉx(）．Thepaiｎt（）ｆｕnctiｏｎiscaｌledbyＱGｒaｐhｉcsVｉewtoｐaｉntｔheiｔeｍ'sｃｏntｅntｓ。Ｔhｅiｔemhａｓnobaｃkgroｕndorｄeｆaｕlｔfｉlloｆｉtsowｎ；whａtｅveｒisbeｈiｎdtｈeiｔｅmwｉllsｈinｅｔhrｏuｇhaｌｌareastｈａtａｒeｎoteｘpｌiｃitlypaintedinthｉｓfuncｔion。Ｙｏuｃaｎcaｌｌupｄate()toscｈeduleａrepaiｎｔ,opｔionallypａsｓｉnｇtｈeｒｅctａｎglｅｔhatnｅedｓａｒｅｐaｉnt。Depｅｎdｉngonwheｔheｒornotthｅitｅｍisｖｉｓibｌｅinaｖiｅw,tｈeiteｍmayormaynｏtbeｒepaｉnｔed;tｈｅｒeisnoeｑｕivaleｎttｏＱWidgｅt::rｅｐaｉnt（）inQGrａｐhｉcｓItｅm．Iteｍsareｐaiｎｔedｂyｔheview,startｉngwiｔhthepaｒｅｎtitemsandtheｎdrawiｎgｃｈｉlｄｒｅｎ,iｎasceｎｄingｓtackｉｎｇｏｒder。Youcａnsｅtanitem＇ｓｓtａckinｇｏrdｅｒbycallinｇsetZＶａlｕe（），aｎdｔestitbycaｌlingzValue（），wherｅiteｍsｗｉtｈlｏwｚ—ｖaｌuesａrepaｉｎｔeｄｂｅｆoｒｅiｔemswiｔhhigｈz—vａｌuｅs。Stａckiｎgorｄerapｐlieｓtｏsibｌｉnｇｉｔｅms；pａrentsarｅaｌwａysdrawnbefoｒetｈeiｒｃhildrｅn。QGrapｈicsItemｒeceivesevenｔsfromQGrapｈicsScenetｈｒoughthｅvｉrｔuaｌｆunｃtioｎｓｃeｎeＥｖent(）.Thiｓｆunctionｄisｔrｉbｕteｓｔｈeｍostｃｏmmｏnｅｖenｔstｏaｓｅtｏfcoｎvｅnienceevｅnｔｈandlｅrｓ：ｃontｅｘtＭｅnｕEvent(）handlesconｔeｘtmenｕeventsfocusIｎEｖent（)ａndｆｏｃusＯｕtEvent(）hａndlefoｃuｓinanｄoutｅvenｔsｈoveｒEｎterEvｅnt（）,hovｅrMoveEvｅｎt（）,andｈoverLeａvｅEｖｅｎt()hａndｌeshovｅrｅnｔer，mｏvｅaｎdｌeaｖeeveｎtsinｐuｔＭetｈoｄＥvｅnt（）ｈanｄｌｅｓinpｕｔｅvents,foｒａccesｓibｉlitysupportkeyPｒessＥｖent(）aｎdkeyRｅleａsｅEvｅnthaｎdlekｅyｐｒessａｎdｒeleａseeventsmousｅPrｅssＥveｎｔ(），mｏuｓｅMovｅＥｖenｔ（），mousｅReｌｅaseＥvｅｎt（），aｎｄmｏuseＤoublｅＣlｉckEvent（）handlesmｏｕsepｒeｓｓ,ｍoｖｅ，rｅleａse，ｃlｉcｋanddｏubｌeｃliｃkevｅnｔsYｏucanｆiｌtｅrevｅntsfoｒanyｏtheｒiteｍbｙiｎstallingeveｎｔｆｉlters．ThiｓｆunctionａlｙｉssｅparａtefrｏmfromQt'srｅｇulaｒevenｔfilｔｅrs（seeQOｂｊeｃｔ：：iｎｓtallEveｎtFilｔeｒ()），wｈｉcｈｏnｌyworkｏnｓuｂｃlaｓsｅsｏｆＱObject.AfteｒinstaｌlｉngyoｕrｉｔeｍａsaｎeveｎtｆilteｒｆoranｏtheｒiｔembycａｌlinginstａｌｌSceｎeＥｖｅntFｉlｔer(），ｔhefiltｅｒedｅventｓwillｂｅrecｅｉvedｂyｔhｅvirｔualfｕncｔionｓceneＥveｎｔＦiｌｔｅｒ（).YoｕcaｎremｏvｅitｅｍeventfｉlteｒｓｂycａｌlingremｏveScenｅEveｎtＦｉlｔer()。Ｓoｍetimesit'sｕsefｕｌtoregistercustomdatawithaｎitem，ｂｅitacuｓtomitｅm，ｏｒａsｔandaｒdｉｔem.YｏuｃanｃaｌｌsｅｔDａta(）onaｎyｉteｍtoｓｔoredａtainiｔusｉnｇakey—ｖalｕeｐaｉｒ（thｅkｅybｅiｎｇaｎｉｎｔｅger,aｎdｔｈevaluｅisaQVariａnt)。Togetcｕstoｍdａtaｆromanｉtem，callｄata（).ThisfunctionａｌiｔｙｉsｃompｌeｔｅlｙunｔouｃｈedbyQtitseｌf；ｉtisprｏｖｉdeｄfoｒtheｕser＇sconｖenieｎｃe。SeeａlsoQＧｒaｐｈicsScene，QGrapｈicｓViｅw，ａｎdTｈｅGrapｈicsViewFｒamｅｗork．MｅmbｅｒＴypeDｏｃｕmenｔationｅnｕmQＧraphicsItem:：GｒaｐhicsIｔｅmＣｈanｇｅTｈisenｕmdescｒibesｔhｅｓtatｅchangｅｓthatareｎotｉfieｄbyQGraphｉｃｓItem：：iteｍCｈangｅ（）．Ｔｈenｏtｉfｉcａtioｎｓａrｅseｎｔaｓthestａｔecｈangｅs,ａndｉnｓoｍecaｓes,ａdｊuｓtｍｅntｓｃａｎbemadｅ（sｅetｈeｄｏcumeｎtaｔionfｏreachｃhanｇeｆoｒdeｔaiｌs）．Notｅ:BｅcaｒefulwｉthcaｌlinｇfunctｉonsonｔhｅＱＧrapｈicsItｅmiｔseｌfiｎｓideiｔｅmChaｎgｅ(），ａｓcertａｉnfunｃtioncallscａnlｅadtｏunwanｔeｄｒｅcｕrsiｏn．Foreｘａmple，youｃａｎｎｏtcalｌsｅtＰos()initｅmChanｇe(）ｏnaｎＩtemＰｏｓitｉonCｈａngenotifiｃatiｏｎ,asｔheseｔPoｓ(）ｆunctiｏnwｉlｌagａｉｎｃallｉteｍCｈａnge（IteｍPoｓitｉoｎChanｇe）．Insteａｄ，ｙoｕｃａnretuｒnｔｈenｅw，adjｕｓｔｅdｐｏsｉtiｏnfrｏmiｔｅmＣｈaｎge（)．ＣoｎstａnｔVａlueDescｒiｐtiｏnＱGｒａpｈiｃｓItem::ItemＥnaｂlｅdChａnge3Ｔheiteｍ＇ｓenabｌｅdｓtateｃhanｇeｓ.Iｆtｈｅitemｉsprｅsｅnｔｌyenaｂled，itwillbｅcoｍｅdiｓabｌｅd,anｄvｉcｅverｃａ.Thevalｕｅａrgumentistheｎeweｎａｂleｄstate（i。e。，ｔrueoｒfａｌse）.DoｎotcallsetEnablｅd（)iｎitemChａnge(）aｓtｈｉsnｏｔificａtｉｏnisdeｌivered．Insteaｄ,yoｕｃanreｔuｒｎtｈeｎｅwsｔatefｒoｍｉtemChangｅ（）.QGrapｈｉｃｓItｅm::ItemＭatrｉxChanｇe1Ｔheiｔem'smａtrｉxchanｇｅs．Tｈｉsｎｏtificationisonlysentwｈentｈeｉｔem'sloｃａlｍaｔｒixchaｎｇes(ｉ．e.,ａsａrｅsｕltｏｆcalｌinｇseｔMａtｒix（),oroｎeｏftｈｅconｖｅnｉencetraｎsformatｉonfunｃtionｓ,suchａsｒoｔate（)）。Tｈevaluearｇｕmentistheneｗｍａtrix(i。ｅ。，ａＱMaｔriｘ）；togeｔthｅolｄmaｔrｉx，cａllｍatrix（）．DonoｔｃallsetMaｔrix()ｏrａｎｙｏfthｅtraｎｓfｏrｍatioｎcｏｎｖｅｎiｅｎｃeｆunｃｔiｏnsiｎitemＣhａnge（)asｔhｉｓnotifｉcationｉｓdeliｖered;insｔead,youcanｒeｔｕrnthenewmａtｒixfｒomitemChange（）.ＱGｒａｐhicsItｅm:：ItemＰｏｓitｉｏnChaｎge0Thｅiｔｅm’spositiｏncｈanｇes．Ｔｈisｎｏtｉfiｃaｔionisｏnlｙsentwhenｔheｉｔｅm’sｌｏcａlpｏsiｔｉoｎchangeｓ,ｒelatｉｖｅｔoitsｐarｅnt,hａｓcｈaｎｇｅｄ（ｉ.e.，asaresuｌtｏfcａlｌingsｅtＰｏｓ()ormovｅBy（））.Thevalueaｒｇｕmｅｎtistheｎｅwｐosiｔｉｏｎ(ｉ．e。，aQPoｉｎｔＦ）。Ｙoｕｃａncalｌpos(）togeｔtｈeorｉｇｉnａｌposiｔｉon.DonotｃalｌｓeｔPoｓ（）ormovｅBy(）ｉniteｍＣhangｅ（）astｈｉｓnoｔifｉcationisdelivｅreｄ;instｅad,ｙｏｕcanreｔｕｒnthenew，ａdjｕstedｐｏsｉｔiｏｎfrｏｍiteｍCｈａnｇe（）．QGrａpｈｉｃｓIｔｅm：:ＩｔｅmSeleｃtｅdChangｅ4Theiｔem＇ｓseｌectedstａteｃhａｎges。Ｉfｔhｅiｔｅmｉｓｐresentlｙselected，itｗillbecomeunselecｔｅd，ａndｖｉcｅｖerca．Theｖaluearguｍenｔisｔｈeneｗｓelecteｄsｔａｔe（i．e。，ｔrueｏrｆaｌse)。DoｎotcaｌlｓetＳelecｔｅｄ（）iｎitemChaｎge（）asｔhiｓnｏｔifiｃａtioniｓｄelｉvｅred（)；insteａｄ,yｏｕcanrｅturnthenewseｌectedstatefromｉtｅmＣｈange(）。ＱGraｐｈｉcsＩtｅm::ＩteｍViｓibｌｅChａnge2Ｔheiｔem＇svisiｂｌestａteｃhanges．Ifｔheiteｍisprｅsenｔlｙvisibｌe,itwiｌlbecomeinvisibｌe，andvｉceｖｅrｃａ.Tｈevaluearguｍｅnｔistｈenｅwｖｉｓｉblｅsｔaｔｅ（i。ｅ.，tｒuｅｏrｆａlｓｅ）．DoｎotｃalｌsｅtVｉｓible（）iniｔｅmＣｈａｎgｅ（)astｈｉsnotｉfｉcatiｏｎisdeｌivｅreｄ;insｔeaｄ,yoｕｃanretuｒｎｔhｅnｅwvisibｌeｓtatｅfroｍiｔemChange（)．QGraｐｈｉcsＩtem::IｔemＰａrｅntＣhａnge5Theiｔem＇ｓparｅnｔｃhangeｓ．Thevalｕeaｒｇumentｉsthenewpａrentiteｍ（i。ｅ．，ａQＧｒaｐhicｓIteｍpｏｉｎｔｅr）.DｏnｏｔｃallseｔPareｎtIteｍ（)ｉｎitemＣｈａnｇｅ()asｔhｉsnotificａtionisｄｅｌivｅred；ｉｎｓtｅad，yｏuｃanｒetuｒｎｔｈｅｎｅwparentfrｏｍｉｔemChaｎｇe().ＱGraphicsIｔem:：IｔemChｉｌdAddｅdＣhanｇｅ６Ａcｈildisａdｄedtothiｓitem.Thｅvaluearｇｕｍentisｔhenewｃhilditeｍ（ｉ.e.,ａQＧraphｉcｓＩtempointer).Donotpasstｈisiｔemtｏａｎyitｅm'ssｅtＰａｒｅntＩteｍ（)ｆuncｔioｎａstｈisｎotifiｃationｉｓdｅlｉvered.Thereｔurｎｖaｌuｅiｓｕｎused；ｙoucannｏｔadｊuｓｔaｎyｔhingiｎthisnotifiｃatiｏn。Notethatthenｅwcｈildｍｉｇhｔnotbｅfｕllｙｃonｓｔｒｕｃtedwｈｅnｔhisnｏｔｉｆicaｔｉoｎissent;callingpuｒｅvｉｒｔuａlfuｎctioｎｓontheｃhildcａnlｅaｄｔoａｃrash.ＱGraｐhｉｃｓIｔeｍ:：IteｍChiｌdRemoveｄＣhaｎgｅ7Ａcｈiｌdｉsremoｖedfrｏｍthisitｅm.Thevａｌuｅａrgｕmｅntisthｅcｈiｌdｉtｅｍtｈatｉsaboutｔｏｂerｅmoveｄ（i.e.，aQGrａpｈｉｃsＩtempointeｒ)。Ｔhｅｒｅturnｖalｕeｉsuｎuｓeｄ；ｙoｕcａnnotａdjustａnｙｔhinｇinthiｓｎotifｉｃatｉoｎ。ｅｎｕmQGrapｈiｃsIｔeｍ：:GｒaphｉcｓItｅmFｌａｇｆｌaｇsQGrａｐhicsItem：：ＧraｐｈicsItｅｍFlａgsTｈｉseｎumdｅsｃriｂeｓdｉｆｆｅrentflagsthatyouｃansｅｔｏｎaniｔemtｏtogglｅdiffｅｒｅntfeatureｓintheiteｍ＇sｂｅhavior.Allｆｌagｓaｒedｉsａblｅdbyｄｅｆａｕlt．CｏnstａntVaｌueDeｓcripｔionQGraｐｈｉcｓＩtｅm:：ItｅmIsＭovablｅ０ｘ1Ｔｈeｉtemｓｕppoｒｔｓiｎteractivemovｅｍentｕsingthemoｕｓe.Byｃｌｉckｉｎｇonｔｈeitemanｄthendｒagｇｉnｇ，ｔｈeｉtemwillmovetogetｈｅｒwiｔhthemｏusｅcursoｒ．Ifｔheiteｍhaｓchildreｎ,aｌｌcｈildｒeｎａｒealｓomoｖed.Iｆthｅｉtemｉｓｐａｒtｏfａsｅleｃtion，ａlｌｓelｅcｔeditｅmｓａrealｓomoved。TｈiｓｆeａｔuｒｅisproｖｉdedａｓａconｖenienｃｅtｈroｕｇhthebaseimｐlementaｔiｏｎoｆＱGｒａpｈｉcsItem’smｏuseｅveｎtｈaｎdlｅrs。ＱGｒａphｉcsItem：：ＩｔemIｓＳeleｃtaｂle０x2Theitｅmsupｐｏrｔssｅlｅctｉon．EnabｌinｇｔｈiｓfeaturewiｌｌeｎabｌesｅｔSeｌecｔｅｄ（）tｏtogｇleselｅcｔｉｏnfｏrtheｉtｅｍ.ItwiｌlalsoｌｅｔｔheiｔｅmbeｓelｅｃtedａutomaｔiｃallyaｓarｅsultofcaｌlingQGraphiｃsSceｎｅ：：ｓetＳelecｔioｎArea（)，byclｉｃkiｎgonａｎitｅm，orbyusingrubｂｅｒbaｎｄselectiｏｎｉnＱGraphｉｃsＶｉeｗ。QGraｐhiｃsItem：:ＩtｅmＩｓFｏcusablｅ0x4Ｔheiｔeｍsupportsｋeyboarｄｉｎpｕtfｏcuｓ（i．e．,itiｓaｎiｎpuｔiｔeｍ）.Enａblinｇtｈisfｌａgwilｌａｌｌoｗtheｉｔeｍtoacceｐｔｆoｃuｓ,ｗhiｃhagａinａｌlowsthedelｉｖｅryofkeyeｖenｔstoQＧrapｈｉcsＩtem:：keｙＰrｅsｓEｖｅnt（)andQＧｒaphicsIｔem：：ｋeyReｌeａseEｖeｎｔ(）.ＴｈeGraｐhicｓＩtemFｌａgstyｐｅｉsatyｐedｅfｆoｒQＦlags〈ＧｒａphｉｃｓItemFｌaｇ>．ItｓtorｅsanＯRcoｍｂinatｉonｏｆGｒａphicsItｅｍFｌａgvａlues.ＭｅmbeｒFuｎctioｎDｏcuｍｅｎtatiｏnQGrａphiｃｓItem::ＱＧｒaｐｈicsＩtem(ＱGrａｐhicｓIｔem*pａｒent＝0,QGｒapｈiｃsSｃeｎe＊scｅne=０）ConstｒuctｓaQＧrａphicｓＩｔeｍｗｉthtｈeｐareｎtｐａrenｔoｎｓcene。Ifparｅnｔis0,thｅiteｍwｉｌlbeａtｏｐ－level．Ifｓｃenｅｉs０,tｈeｉｔｅmｗilｌnotｂeaｓｓocｉatedｗiｔhasｃeｎｅ.SeeａlsｏQGrａphiｃｓSｃｅne：:ａdｄＩtem（）。QGrａｐhicsＩｔｅm：:～ＱGｒaphicｓＩｔem（)??［viｒtuaｌ]DeｓtrｏystｈeQGraphiｃｓIｔemandaｌｌiｔscｈildｒen．Ifｔｈisitｅｍisｃｕrｒentlyａssｏｃiａtedwｉtｈａｓｃeｎe,thｅｉteｍwillberemovｅｄfrｏｍthescｅnebeforeiｔisdeｌeteｄ.boolQGrapｈｉcｓIｔｅm::ａcｃepｔDrｏps()consｔＲｅturｎstrueｉfthｉsｉtｅmcanaccepｔdragａnｄdrｏpevents;othｅｒwｉse，rｅturｎｓfａlｓe.Ｂyｄefａulｔ，itｅmsdｏnotacceptdｒaganddｒｏpevents;ｉｔｅmsａｒetraｎｓpａrenｔｔodraganddrop．ＳｅｅalｓoｓｅtAｃｃepｔDｒops(）。Qt::MousｅButtoｎsQGrａphicsＩtｅm::accepｔeｄMouｓeBｕttons（）ｃｏnstRｅturnstｈemouseｂｕttonｓtｈatthisiｔｅmａｃｃeｐｔｓmｏuseeventsｆor.Byｄefault，aｌlmｏusebｕttｏnsarｅaccｅｐted．Ifaｎｉtemaｃceｐtｓａmousｅbuttoｎ，itｗillbeｃｏｍethemoｕsｅｇｒａbbeｒｉｔemwｈｅnaｍousｅｐrｅssｅｖｅntｉsdeliverｅｄfｏrthaｔmoｕｓｅbｕｔｔon.Howｅver，ｉfｔｈeｉtemｄoｅｓnｏtaｃcｅptthebｕtton,QGraｐhｉｃsSｃｅneｗilｌfｏrwardthemouｓｅeｖenｔstｏthefｉrsｔitemｂeneaｔhiｔｔhatdｏes.SeealｓosetAccｅｐtｅｄMoｕsｅBｕttｏnｓ（）aｎdmousｅPrｅssEvｅnt(）．boｏlQGｒaｐｈicsItem::accｅｐtsＨｏｖerＥvｅｎts（）constRetuｒｎstｒｕeifａｎiｔemａccepｔsｈovｅrｅvｅnｔs（QGraphicｓScｅneＨｏｖerEvent）；otherｗise，rｅｔurｎsfａｌｓe.Ｂyｄefauｌt,iｔeｍsdonｏtacｃeｐｔhovｅｒevｅnｔｓ。SeeaｌsoseｔAcceｐtｓＨｏｖeｒEｖents（）ａｎｄｓeｔＡｃcｅptｅｄMoｕseButｔｏns（)．ｖｏidQGraphicsItem:：advancｅ（ｉntｐｈａsｅ)？?[virtuaｌ］ThｉsviｒｔuaｌfunctｉｏnｉｓｃaｌledtｗiceforａlｌｉｔemｓｂyｔheQＧrａphicsSｃeｎe::adｖance()sｌｏt．Ｉntｈeｆｉrstphasｅ,aｌlitemsａｒｅｃalｌｅdwithpｈase==0,inｄicatingｔｈatｉtemsonｔhesceｎｅareabｏuｔtoadvanｃｅ,andthｅnａlliｔemsareｃａｌｌedwiｔｈpｈaｓｅ＝=1。Rｅimpｌeｍenｔthｉｓｆｕnｃｔiｏnｔoupｄaｔeyouriteｍｉｆyｏuneｅｄsiｍpｌesｃene—controｌｌedanimatiｏn．Ｔｈedeｆauｌｔimｐｌｅmenｔａtioｎdoesｎothiｎg。Foｒinｄividuａliｔemaniｍatiｏn，analｔernatｉvetoｔhｉsfunctiｏniｓtoｅitheｒuｓeＱＧrａｐhiｃsItemAnｉmatioｎ，oｒｔｏmultｉｐｌe－ｉnheｒitｆrｏmQObjectaｎｄQＧraphiｃｓItｅm,ａndanｉmａｔeyouriｔemuｓｉnｇQObjeｃt：：ｓtaｒtTｉmｅr（)andQＯｂｊecｔ：:tｉmerＥｖｅnt().SｅeaｌsｏＱGraphicｓIｔemAnｉmationandQTimeLinｅ。QＲeｃtＦQGrａｐhicsItem：:ｂounｄiｎgRｅct(）const？？[ｐuｒｅｖｉｒtuａl]Ｔhiｓpurｅvｉｒtuａlfuｎctioｎｄｅfinesｔhｅoｕtｅrboundsoftｈeｉtemasarｅcｔanｇle;ａllpaiｎtingｍusｔbｅｒestｒiｃtedｔoiｎsiｄｅanitｅｍ'sbounｄｉnｇrecｔ.QGrａphicsVｉｅwusｅｓtｈisｔoｄetｅｒminｅwhethertｈeitｅmrｅquirｅｓredrawing。Ａｌthoｕｇｈthｅiteｍ＇sshａpecanbｅaｒbitrary,ｔｈｅbounｄingrecｔｉsalwaysreｃｔａｎｇuｌar，andiｔisuｎａｆｆecteｄｂｙthｅiteｍs＇tｒaｎsfｏrmatiｏｎ（scale（)，ｒｏｔａｔｅ（），etc。)。Ｉｆyｏuwanｔtｏｃhangetｈｅiｔeｍ’sboundｉｎgｒectａnglｅ，youmustfirstcａｌlｐrｅpａｒｅGeｏmetｒyＣhange().Ｔｈiｓｎotifieｓthesceneoftｈeimminentchａnｇe，sｏｔhatiｔscanupdａｔeｉtsｉｔｅｍｇｅomｅtrｙindｅx；ｏtｈerwｉｓe,tｈesceｎｅwillbｅｕnａwarｅoｆthｅiｔem＇ｓneｗgeｏｍeｔry，ａｎｄｔhｅresｕltsareｕｎｄｅｆiｎed(tｙｐicａlｌy,ｒendｅｒｉｎgａrｔiｆactsaｒelｅftaroundiｎｔｈｅｖｉeｗ）.ReimplｅmｅnｔｔhisｆｕｎｃtｉｏntoｌetＱGｒａphiｃsViｅｗｄｅteｒmｉnewhａｔｐaｒｔsofthewidｇｅt，ifａｎy，neeｄtobeｒｅdｒaｗｎ．Ｎote:Ｆorshａpｅsthatpainｔanouｔliｎｅ／ｓtrｏke，ｉtiｓｉmpｏrtaｎttｏinｃludeｈａlｆtheｐeｎwｉdｔｈinthebｏundingreｃt.Ｉｔisnｏtｎecｅｓsaｒｙpｅnｓａtefoｒａｎtiaｌiasinｇ，thｏｕgｈ．Ｅxample：QRecｔFＣｉｒcｌｅIｔeｍ：:ｂoｕｎｄｉnｇReｃt（)conｓt｛qreａｌpenＷidｔh=１；ｒｅturnQRectＦ（-raｄius-penWｉｄtｈ/２，—ｒadius—penWｉdtｈ/２，ｄiａｍｅter＋penWidtｈ,ｄiａｍeter+pｅnWｉdｔh)；｝Seeaｌsｏshａｐｅ(）,cｏnｔａinｓ()，ＴheGｒaｐhicsＶｉeｗCｏoｒdｉnａteSｙsｔｅm，andprｅpａrｅＧｅｏmeｔｒyＣhange（）．QList<QＧrａphiｃｓIteｍ＊〉QＧrａphicｓIteｍ：:ｃｈildrｅｎ（)ｃonｓtＲｅtuｒnsａliｓtoftｈｉsｉtｅｍ'ｓcｈilｄｒen。Theiｔeｍsａrｅｒeturnedinnｏpaｒticulaｒoｒder.SeｅalsosｅtParｅntItem(）。QRectFQGraphｉｃｓIｔem：：cｈildreｎＢoundinｇRect（）constＲeｔurnstｈeboundingrｅｃｔｏｆthisitem'sdescendenｔs（i。e.，iｔschｉldrｅｎ,thｅｉｒchildren,etc．）inlｏｃａｌcooｒｄinates.Ｉfｔｈeitemｈａsｎocｈildrｅn,thiｓfuncｔionｒeｔurnsanemptyQRectF．Tｈisdoｅsnotiｎcludｅtｈisitｅm＇sownbｏｕndinｇrect;iｔonｌyrｅtｕｒnsｉｔｓdeｓcｅndｅnts＇aｃｃumｕｌatedｂoｕndiｎgrecｔ．Ifyouneｅdtｏincludethiｓitｅｍ’sboundingrecｔ,ｙｏuｃanaddbｏunｄｉｎgRect()tochｉlｄrｅnBoundｉngＲect()uｓiｎgQＲeｃｔF：:oｐｅraｔor｜()。Thiｓｆuｎcｔｉonｉslinｅarｉｎcompｌexiｔｙ；ｉtdeteｒｍinｅstheｓizeoftｈｅｒetｕｒnｅdboundｉngｒｅctbyitｅｒａｔinｇｔhrｏughaｌlｄｅsｃｅｎdentｓ.ＳｅｅaｌsoboｕｎdinｇRect（)aｎdsceneBounｄingReｃｔ（)．voｉdQＧrapｈｉcｓIｔem：：ｃｌeaｒFocuｓ（）Tａkｅｓｋeｙｂoardinputfocusfromｔhｅitem。Iｆithasfocuｓ,afocｕsouteｖenｔｉssenｔtｏthisiｔemtotｅｌｌiｔthatｉtｉsaｂouttolｏsethｅｆoｃus。ＯnlyitｅｍsthaｔｓettｈeItｅmIｓFocｕsａbleｆlａgcａnａccｅｐtｋeyboaｒdfｏcuｓ.SeｅaｌｓoｓetＦocus(）。bｏolQGraｐhicｓItｅm::ｃｏlliｄesWｉtｈIｔeｍ(ｃｏnｓtQGrａphicsＩtｅm*othｅr,Qｔ：：IｔemＳeleｃtiｏnModｅｍoｄe=Ｑｔ:：InｔerｓｅctsIteｍSｈａpe)ｃonsｔ？？[virｔuaｌ］Retuｒnｓtrueifｔhisitemｃｏｌｌｉdeｓwｉｔhothｅr；otherwｉsereｔｕrnｓｆａｌｓe。Ｔhｅwaｙｓitemｓcoｌｌideisdｅtｅｒminｅdbｙmｏｄｅ．ＴhedefaｕｌtvａluefｏrmodeisQt：：ＩntersｅｃtsItemShaｐe；othercｏllｉdeｓｗｉｔhｔhｉｓitｅmifｉｔeｉtｈｅｒinｔersecｔｏrａrｅcontainｅdbｙｔhiｓitem'sｓｈａｐｅ．Tｈedefauｌtiｍｐlｅmeｎtatiｏnｉｓｂasｅｄonsｈaｐeｉntｅｒsectｉon，andｉtcａｌlsshapｅ()onｂotｈitｅｍs.Beｃａusｅthｅｃoｍｐlexiｔyoｆａrbiｔrarysｈape－shapｅintｅrsｅcｔioｎgroｗswithaｎorderｏfmaｇnitudｅwｈenｔhｅshapesａrｅｃｏmpｌeｘ，thiｓoｐeraｔionｃａnbenoｔｉｃablytiｍｅｃｏnsuｍing．YouhaveｔhｅｏptｉonofreiｍｐlemｅntiｎgｔｈisｆuｎｃｔioniｎａｓｕbclassofQGrａphiｃｓItｅmtoprovidｅacusｔomａｌgｏriｔhm．Thisａllowsyｏutomakeｕｓeofnaｔｕraｌconｓtraｉnｔsintheshaｐeｓofｙouroｗniteｍs,inorｄｅrｔｏimｐｒｏvetｈｅperｆｏrmanｃeoftｈｅcollisioｎdetｅction.Foriｎstanｃｅ，twounｔraｎsformｅdｐｅrfecｔｌyｃircｕlaritems’cｏlliｓｉｏncａnbedeteｒmｉnedveｒyeｆｆicｉｅnｔlybｙｃomｐaｒinｇtｈeirpositｉｏｎsaｎdradii．Keｅpinmindtｈatｗhenrｅｉmpleｍeｎｔｉngthisfｕnctiｏnａｎｄｃalliｎｇｓhaｐe()ｏrbｏｕｎdinｇＲect(）oｎoｔher,theｒeturneｄcooｒdinaｔesmｕstｂｅmapｐeｄtｏｔhｉｓｉｔｅｍ’ｓcoｏｒｄinatｅsysｔｅmｂｅｆｏreaｎyinｔｅｒｓectioｎcａntａｋｅpｌaｃe。Ｓｅeａlsocｏntains(）aｎdsｈaｐｅ（）。booｌQGｒapｈicsＩｔem：:ｃollｉｄesＷiｔhPａtｈ（ｃonstQPaiｎtｅrPａth＆patｈ,Qt：：IｔｅｍSｅｌectiｏnＭodemｏde=Qt：:IｎｔerseｃtsＩｔemShape）ｃｏｎst?？［vｉrtuａl］Ｒeturnstｒｕeiｆtｈｉsitemcoｌliｄeｓwｉthpatｈ。Theｃｏllｉｓｉｏnisｄeteｒｍiｎedbｙｍode．ＴheｄｅfaultvａｌuｅｆormｏdeisＱt::InterｓｅcｔsIteｍShａpe；paｔhcollｉdeｓｗitｈthisｉteｍifiｔeｉtheｒｉntersecｔsｏｒiｓｃoｎtaｉｎedbythiｓitｅｍ＇sshａpe．SｅealsocolｌidｅsWｉｔｈIteｍ（），coｎtainｓ()，ａndshape（)．ＱLiｓt<QGrａｐhiｃsItem*〉QGrａｐhicsIｔem:：ｃoｌlidiｎｇItｅｍｓ（Ｑｔ::ItｅmSelectｉoｎＭodemode=Ｑt：：IntｅｒsectsIｔeｍＳｈａｐｅ)ｃｏnstReｔurnsaｌisｔofallｉteｍsｔｈaｔcｏlｌｉdewitｈtｈisiｔem．Thｅｗaycollisiｏnsaredｅtectedｉsdeterminｅｄbｙmｏdｅ。TｈｅｄefauｌtvaluefｏrmｏdeisQｔ::IｎｔerseｃtsＩteｍSｈａpe；Aｌlitｅｍsｗｈoseshａｐｅinteｒseｃtsorisｃonｔaineｄｂytｈisｉteｍ＇sｓhapeareｒetuｒnｅd.ＳeeaｌsoＱＧraphicsＳｃeｎe::ｃoｌｌidｉｎgItｅmｓ()ａndcｏllidesWithＩｔｅm（）.booｌＱGraｐhicｓItｅm：：conｔaiｎs（cｏnsｔQPoiｎtＦ&poinｔ)ｃｏnst？？[ｖｉrｔual］Rｅturnstｒueifｔhisitｅｍcoｎtainsｐｏiｎｔ,whｉｃhisinｌｏcalcoordinaｔes；otherｗise，falｓｅiｓretuｒｎeｄ.IｔismostｏｆtｅncalｌｅdfｒｏmQGrapｈｉｃsVｉewtodeｔerminｅwhatｉｔemisundeｒｔhecuｒｓoｒ,andfｏｒtｈａtreaｓon，tｈeｉmplemｅntａｔｉｏｎoftｈisfuｎctｉonshｏｕldbｅasｌiｇｈt-ｗeigｈｔasｐossｉblｅ。Byｄeｆault，ｔhｉsfuncｔｉｏｎｃaｌlsshape（),ｂuｔyｏｕｃanｒeimplemeｎtｉtｉnasuｂcｌａsstoｐrovidea（pｅrｈapsmｏreeffiｃieｎt）implｅmentatｉon．Ｓeｅaｌsｏｓhape（）,ｂoｕndingReｃｔ(），andｃoｌliｄesＷithPａｔh（)。vｏidQGｒaｐhiｃsItem：:coｎtexｔMenuＥvenｔ（ＱGｒａphicsSceｎｅCｏntextＭｅnｕEvent*evｅnｔ)？？［virtuａtected］Tｈiseｖenｔhaｎｄleｒ，foreventeveｎt，caｎbereｉmplemeｎteｄtoｒeｃeｉｖeｃonｔｅxｔmenuevenｔsfｏｒtｈisｉtｅm．Ｉｆyouignoｒｅｔheｅｖｅnｔ,(i.e.,byｃallingQEvｅｎt::iｇnorｅ（）,）ｅvｅnｔwｉllｐｒoｐaｇatｅtoａnｙiｔｅｍbeneathtｈisiteｍ.Ifnoｉtemsacceｐｔthｅｅvent,iｔwillbeiｇnｏredbｙtｈescene,anｄｐropａgatｅtothｅviｅw.Ｉt'scｏmmonｔｏｏpeｎaQＭｅnｕinｒｅsｐonseｔｏreceivｉｎgaconteｘtmenueｖeｎt。Exaｍple:voidＣustomＩtem::ｃonｔeｘtMenuEveｎt（QGrapｈicsＳｃeneＣｏntｅxtMeｎuＥvｅｎｔ*ｅvent）｛QＭｅnumｅｎu；QＡctｉoｎ＊reｍｏvｅＡｃtｉｏn=menｕ．aｄｄActioｎ(”Remove"）；ＱActiｏn*markAcｔｉｏn=mｅnu.ａdｄActioｎ("Mａrｋ＂）；QＡcｔiｏn＊ｓｅlｅctedAｃtioｎ=mｅｎu.eｘeｃ(ｅｖｅｎｔ－＞ｓｃreｅnPｏs());//.．.}Ｔheｄeｆａｕlｔｉmplemeｎtatｉｏndoｅsnothiｎｇ．SeealsosceｎeEveｎｔ()．QCuｒsorQGrapｈｉcsＩtem：:curｓoｒ()cｏｎstRetuｒｎsthecurrentcｕｒsorshaｐeforｔheｉtｅm。Tｈeｍouｓecursｏｒwiｌlasｓｕｍethiｓsｈapewheｎiｔ’soverthｉsiteｍ。Seeｔｈeｌistofpreｄeｆinedｃｕｒsｏｒobjｅｃtsfｏｒaranｇeoｆuｓｅｆuｌshapes.AnｅdiｔoｒiｔｅmmｉgｈtwanｔtｏusｅanI—ｂeaｍｃursor：item-〉ｓetCurｓｏr(Qｔ：:IBeamCurｓｏr)；Ifnocｕrsｏrｈasｂｅenseｔ,ｔhepａrenｔ’ｓcursoｒｉsｕsｅd。SeeaｌsoｓetＣｕrsor（)，haｓCursor()，unsｅtCｕrsor（)，QWiｄｇet：：ｃｕrsor，ａndQApｐlicaｔion：：ｏvｅrｒidｅCuｒｓｏｒ()。ＱVariantQGraｐｈiｃsIｔeｍ:：dａｔa（ｉntｋｅy）constＲeｔuｒnsｔｈｉsitｅm＇ｓｃustomｄａｔafoｒthekeykｅyａsaＱVａｒｉant．Cｕsｔｏmiｔemdatａisusefulｆorstｏrｉnｇａrbitｒａｒｙpｒopeｒtiｅｓｉｎａnyｉtｅｍ.Exampｌｅ：sｔａticcｏnsｔintObjeｃｔNａｍｅ=0;ＱＧraphicsIteｍ*ｉtｅm＝sｃｅne.ｉtｅmAt(100，50）;if（iｔeｍ—＞ｄaｔa（ObｊｅｃｔName)．toＳｔring（）。ｉsEmpty（)）｛ｉｆ(ｑgraｐｈicｓｉteｍ_cast<ＢuttonＩtem*〉（iteｍ)）iｔem－〉ｓeｔDaｔａ（ObｊecｔＮaｍe，"Ｂutton”）；}Qtdoesnoｔuｓｅthｉｓｆeaｔｕreｆｏｒｓｔoｒinｇｄaｔａ;iｔｉｓpｒovidedsolｅlyｆortｈeconｖenienceoftheuｓer。SｅｅａｌｓosetDａtａ（).voidQGｒａpｈｉｃｓIｔem:：dragEｎteｒEvｅnt（ＱGｒaｐhicsSceｎｅDragＤｒopEvent*eｖｅnt）?？[viｒtｕalprotecteｄ]Tｈiｓevenｔhａnｄler,forevｅntevｅｎt，cａｎbｅｒeｉｍplemenｔedtｏｒeceiｖedragｅnｔeｒｅvｅntｓfoｒｔhiｓiｔｅm。Ｄｒagenｔereventsaｒeｇeｎeｒaｔedaｓthｅcｕｒｓorentｅｒｓｔｈｅiteｍ'ｓareａ。Bｙaccepｔiｎｇtｈeevent,（ｉ。e。，bｙcaｌlｉｎｇQEvent::acｃｅpt（),）tｈeｉtemwillacｃeｐtｄropevents，inaddｉtiontoｒｅｃｅiｖｉngdragｍoveanddｒaｇｌｅａvｅ．Otｈｅrwisｅ,tｈｅｅｖeｎtｗiｌlbeｉgｎoredａnｄpropａgatetｏtｈｅiteｍｂeｎeatｈ。Iｆｔheｅｖentisaccｅpｔｅd，theiteｍwiｌｌreceｉveadrａgｍｏveeｖentbeforecoｎｔrolｇoｅsbａｃktoｔhｅeｖｅntｌooｐ．ＡｃｏmmonｉmｐlemenｔationｏfdragＥｎterEvenｔacceptｓoｒiｇnorｅsevenｔdｅpeｎdingontheaｓsociａtedmｉmedａtaiｎeｖent．Eｘamplｅ:ＣuｓtomIｔｅm：：CｕｓtｏｍIｔem（)｛sｅtAｃcepｔDrops（trｕｅ）；．。．}vｏｉdＣｕｓtoｍItem：：dragEntｅrEｖeｎｔ(QGrapｈｉｃsSceneDragDrｏpEｖeｎｔ＊evｅｎt）｛eｖent－＞sｅtAccepｔed(event—〉ｍｉmeDaｔa(）－〉hasＦormａt（"text/plａin＂）)；}Iteｍsｄｏnotrｅceｉveｄｒaganddｒoｐevenｔsbｙｄefaｕｌｔ；ｔｏｅｎａｂlethisｆeature，caｌlsetAcceptＤｒops（ｔｒue）.Ｔheｄefａｕltimpｌemenｔaｔｉonｄoesnotｈiｎg。SeealsｏdropＥvent(），ｄragMovｅEveｎt(），ａｎddragLeavｅＥveｎｔ().ｖoｉdＱGraphicsＩtem:：draｇＬeavｅEvent(QＧraｐｈicsＳcenｅDrａｇDｒoｐEｖｅnt＊evｅnｔ）?？［virtualproｔecｔed]Ｔｈiseveｎthandlｅｒ，ｆorｅvenｔeｖｅnt，cａｎｂerｅimplemenｔedｔｏrｅceivｅdｒagleaｖeｅvenｔｓforthisｉｔｅm。Ｄrａgｌeaveeventsaｒegeneratedasｔhｅｃursorｌeａｖｅstheiｔｅm＇ｓarea。Ｍoｓｔofｔenyouｗｉｌｌｎotｎｅedtoreimplemｅｎttｈisｆuncｔioｎ，butitｃanbeｕsefulｆorrｅｓeｔtinｇsｔａteiｎｙｏuｒiｔem(e．g．，ｈighlighｔｉｎg）．CallingＱＥvent：：ｉgｎore（）ｏrQＥvｅｎt：:acceｐｔ（)oneｖｅntｈaｓnｏeｆfect．Ｉtemsdｏnoｔreｃeivedragandｄroｐｅｖeｎtsbｙdｅfaｕlt；toｅｎａblｅtｈisfeatｕre,callｓetAcｃepｔDroｐs(tｒue）.Thedｅfａｕlｔiｍplementatioｎｄoesnothing.SeｅalｓodｒａgＥnteｒEvｅnｔ(）,dropEveｎt(),ａnddragMｏｖｅEvent（）.ｖｏｉｄQGrapｈicsIｔｅm：:dｒaｇＭoveEｖent（QGraｐhiｃsＳｃｅnｅDraｇDrｏｐEvｅnｔ＊evｅnt)？?［virtｕaｌpｒotｅcted］Ｔｈisevenｔhａｎdleｒ,foｒeveｎtevｅｎｔ，cａnberｅimplｅmenteｄtoｒeｃeｉvedragmoveevｅnｔｓfｏrthisiｔem.Drａgmovｅｅvenｔsareｇｅｎeratedａsthｅｃuｒｓormｏｖｅsaｒoundinsidetheiｔｅｍ＇ｓａｒea．Mostｏｆtenyoｕwｉllｎｏtneedｔorｅimpｌemeｎｔthｉｓfuｎction；iｔｉｓｕｓeｄtoiｎdｉcaｔｅthaｔｏnlｙpartｓｏftheitｅmcanacceptdropｓ．CaｌlingQEvenｔ::ｉgnｏrｅ(）orQEｖeｎt：：ａccept（）ｏneventtoggleｓwｈｅｔheroｒnｏttheiteｍwillacceptdropsatｔｈeposｉtionfromtheeｖent．Byｄefaｕlt，ｅｖｅntisaccｅptｅd,ｉndｉｃａtiｎgtｈａtｔheitｅmａlｌｏwｓｄｒｏpｓａttheｓｐｅcｉfiedｐosition.Itｅmsdonotｒeceｉvedrａganddｒopeveｎtｓbｙｄefault;toｅnabletｈｉsfeature，cａllseｔAcｃeｐtDｒｏｐｓ（trｕe)。Thedeｆａulｔimpleｍentａtiondoｅsnｏthing．SｅeaｌsoｄropＥｖent（）,dragＥnｔerEｖenｔ（)，anｄｄraｇLeaｖeＥｖent（）．voｉdQGraｐhiｃsIｔem：：ｄrｏｐＥvｅnt(QＧraphｉｃsＳｃeneDragDｒｏpEvｅnt*eｖｅnｔ)？?［virｔｔｅcｔed］Thisｅｖeｎtｈaｎdler,forevｅｎtｅvｅnt，canｂｅreｉmplｅmenｔｅdtｏreceivｅｄropeｖentsｆortｈｉsｉtｅm.Iteｍsｃanonlｙrecｅｉveｄropeventｓｉftheｌaｓｔｄraｇmｏveeveｎｔwaｓａccｅpｔed.CaｌlingＱEvent：：ｉｇnore（)orQEｖｅｎt：：accepｔ（）ｏｎeｖenthａsnｏeffect。Iｔｅmsｄoｎotreｃeiｖedｒａganｄｄroｐｅvｅntｓbｙdeｆauｌt；toｅnａｂｌeｔhisfeature，ｃａllｓeｔAｃcｅpｔDrops（true)。Thedｅfaulｔimpleｍｅntationdoｅsnothinｇ.SeｅalsodraｇEnｔｅrEｖenｔ（)，drａgMoveＥvent（)，aｎｄdraｇLｅaｖeEｖent()。ｖｏｉｄＱGrａphiｃｓIteｍ::ensｕreVｉｓible（coｎstＱRectF&ｒｅct=QRｅcｔF（)，ｉntｘmargｉn＝50,intyｍargｉn=５０）IｆthｉsｉtemispartofaｓceｎｅthａtisviｅwｅｄｂyａＱＧrａｐhicsＶieｗ，tｈiｓcoｎvｅｎienｃeｆunｃtiｏnｗilｌatｔempｔtｏｓcrｏｌlｔheviewtｏensｕretｈatｒectｉsvisibleinsｉｄethｅvieｗ＇ｓｖieｗpoｒｔ。Ｉｆrｅctisanullrect（ｔhｅdefault），ＱＧraphicsＩtemｗilldefaulｔtｏtheｉtem’sboundｉngrecｔ.ｘmargiｎaｎdymａｒginarethｅｎｕｍbeｒofｐixｅlｓtｈｅviewshoulduｓｅforｍargｉnｓ。Ｉｆｔhesｐeciｆiｅdrｅｃtcａnｎoｔｂｅｒｅacheｄ，theｃｏｎｔeｎtｓarescrｏｌledtｏｔheneａreｓtｖａliｄｐoｓitｉon。ＩfｔhisｉtemiｓnotvｉeｗedbyａQGrａphicsView，ｔhisfｕnｃtiｏｎｄoesｎotｈiｎg.SeeａlsoQGraｐhiｃsＶｉｅw:：eｎsurｅVisｉble(）。vｏidQGｒａphicsItem:：ｅｎｓｕreＶｉｓible（ｑｒealx,qrｅａly，qreａｌw,qｒeaｌh,ｉntxｍａrgin=５０，inｔymargiｎ＝50)Thisisａnoveｒloａｄｅｄｍｅmbeｒｆｕnｃtｉon，proｖiｄeｄforconｖｅｎience.ＴhiｓcoｎｖenienｃｅｆｕncｔiｏｎｉseｑuivａlｅntｔｏｃａllｉｎｇensｕreViｓｉｂｌe（QReｃtF（x，y，w，h)，xｍaｒgiｎ,yｍargin)：GｒaphicsIｔemＦlaｇｓＱGrａｐhｉcsＩｔem::ｆlags（）constRetuｒｎｓthisｉtem’sflａgs。Theｆlagｓdescｒibｅwhatｃonfiguraｂlｅfeatｕｒesofthｅiｔｅｍａｒeenabledandnｏｔ．Ｆorｅｘamｐlｅ，ｉftheｆlagsincluｄeＩtｅmIｓFｏcusablｅ，ｔheiteｍcａnａｃcepｔinputｆocｕs.Bydｅfaｕｌt,ｎoflagｓareｅnaｂｌed.SeｅalsoseｔFｌａgs（)anｄseｔＦｌag（）。vｏiｄQGｒａphicｓIteｍ：：fｏcusInEvent(QFｏcusEvenｔ＊evenｔ）?？［vｉrtｕalｐｒotecｔeｄ］Ｔｈiｓｅvenｔhandler，forｅvｅnteｖent，ｃａnbｅrｅimｐlｅmenteｄtｏｒeceivefｏcusiｎeventｓfortｈisitem。Ｔｈeｄefaultｉmpｌementatiｏndｏｅｓnothiｎｇ。SeｅａlsoｆocｕsOutＥｖeｎt（)andsceｎeEｖeｎｔ（).voiｄQGraphicｓItem：：ｆocｕsOutEｖent(ＱFocusEｖｅnt＊ｅｖｅｎt)?？［ｖiｒtualpｒoｔected］Thisevｅnthandlｅr，ｆｏrevenｔｅvenｔ,canbereｉｍplｅmentedｔorｅｃeｉveｆocｕsｏuｔeｖｅnｔｓfortｈisiteｍ.Thｅｄeｆaultimpｌｅmeｎtationdoesnoｔhing.SeｅaｌｓoｆocｕｓIｎEvent(）ａｎdscｅnｅEvｅnｔ().ＱGｒaｐhｉcｓItｅmGｒouｐ*ＱGｒａphicsItem::ｇroup(）consｔＲeｔurnsａｐointertothiｓiｔｅm＇ｓitemgｒｏｕp,oｒ０ifthisiｔｅmisnotｍｅｍberofagroｕｐ。ＳｅｅaｌsｏsetGrｏuｐ（）,QＧraｐhｉｃｓIｔeｍGroup,aｎdQGraphiｃｓSｃenｅ：:creaｔｅＩteｍGｒｏup（).ｂoolQＧrapｈicsIteｍ：：haｎｄｌｅsChiｌdEvｅｎts（）ｃonsｔＲｅtｕrnsｔrueifthisitemhａndｌeｓｃhiｌdeｖenｔs（i.ｅ．，aｌlevｅｎｔsｉnteｎdeｄfｏrａｎｙofitsｃhｉldrenareinｓｔeａdsenttｏｔｈiｓｉtｅm）；ｏtherwiｓe,ｆalseisｒeｔｕｒned。Ｔｈiｓｐroperｔyiｓuｓｅfuｌｆｏritemgrｏｕps;itallowsｏｎeｉtｅｍtohaｎｄleｅventsｏnbehalｆoｆｉtｓchildreｎ，aｓｏｐpｏｓeｄtoｉtschildｒenhａｎdlingtheiｒeventｓiｎdividｕalｌｙ.Ｔheｄｅｆａultisｔoreturnｆalse；cｈｉldrenｈanｄleｔｈｅｉroｗneｖｅｎtｓ。ThｅｅｘcepｔionfｏrtｈｉsisiｆｔｈｅｉteｍisａQGrapｈicｓＩｔemGroup，thｅnitdefaultstoreｔuｒｎtruｅ．SeealsosetHａnｄlesCｈｉlｄEveｎtｓ（）．bｏｏｌＱGraｐhicsＩtｅm：:ｈasＣursor（）consｔRetｕrｎｓtｒuｅiｆthｉsiteｍhasａcｕrsoｒsｅｔ；oｔherwise，ｆaｌsｅisrｅturned．Ｂyｄeｆault，ｉｔｅmsdon’thaveanycursorset．ｃurｓoｒ（)wilｌｒetｕrnａsｔaｎｄardpｏintｉｎgarｒｏｗcursｏｒ．SeeaｌsouｎseｔＣuｒsｏr()。bｏolＱＧrａphｉcｓIteｍ：：ｈａｓＦocus(）cｏｎsｔRｅｔｕrｎstrueiｆｔｈisｉｔemｈａｓfoｃｕｓ（i。ｅ．，canaｃcｅptkeyeventｓ)；othｅrｗiｓｅ,rｅturnｓｆａｌse．SeｅalsoｓｅtＦｏｃus()ａnｄＱGraphicｓScｅｎe:：sｅtFｏｃusItｅm（）.voｉdQGｒaphｉcsＩtem：:hｉｄe()Hｉdestheiｔｅm。（Iｔemsarevｉsibｌｅbydeｆault．）TｈiｓcoｎvenienｃefｕnｃtｉonｉsequｉvaｌenｔtocａllingｓetViｓiｂle（fａlse）．Seealsoｓhow（）anｄsｅtＶisibｌe（）。voidQＧraｐｈiｃsIｔem：：hoveｒＥntｅrEvent（QGrａｐｈｉｃｓSceneＨoverＥｖｅnt＊eveｎｔ)？？[ｖiｒtualprｏteｃteｄ］Thisｅｖｅntｈanｄlｅｒ,fｏrevｅｎtｅｖent，canｂeｒｅimplｅmentｅｄｔoｒeceivehoveｒｅnterｅｖentｓｆortｈｉ