>
DDiissaabblleess tthhee GGCC mmaasskk,, iiff iitt hhaass bbeeeenn sseett wwiitthh tthhee ccoommmmaanndd _m_a_s_k..
RReeqquuiirreess nnoo aarrgguummeennttss..
</ddll>>
<>
EExxaammppllee ffoorr ddrraawwiinngg aa sshhaaddooww eeffffeecctt iinn aa wwiiddggeett::
<>
<
>
ffoorreeggrroouunndd ggrraayy3300;;\\
ddrraaww--lliinneess ++11,,--11,,--11,,--11,,--11,,++11;;\\
ffoorreeggrroouunndd ggrraayy8855;;\\
ddrraaww--lliinneess --11,,++00,,++00,,++00,,++00,,--11
</pprree>>
<> PPIIXXMMAAPPSS </hh33>>
AA SSttrriinngg ttoo PPiixxmmaapp ccoonnvveerrtteerr hhaass bbeeeenn aaddddeedd ttoo XXaaww.. TThhiiss ccoonnvveerrtteerr
iiss mmeeaanntt ttoo bbee eexxtteennddeedd,, aanndd hhaass eennoouugghh aabbssttrraaccttiioonn ttoo aallllooww llooaaddiinngg
sseevveerraall iimmaaggee ffoorrmmaattss.. IItt uusseess aa ffoorrmmaatt tthhaatt rreesseemmbblleess aa _U_R_L,, wwiitthh
tthhee ssyynnttaaxx::
<>
<>[[ttyyppee::]]nnaammee[[??aarrgg==vvaall[[{{&&}}......]]]]</ii>>
<
>
TTyyppee ccaann bbee oonnee ooff _b_i_t_m_a_p,, _g_r_a_d_i_e_n_t oorr _x_p_m..
<
>
NNaammee mmaayy bbee aa ffiillee nnaammee,, oorr,, iinn tthhee ccaassee ooff ttyyppee _g_r_a_d_i_e_n_t,, mmaayy bbee
eeiitthheerr _v_e_r_t_i_c_a_l oorr _h_o_r_i_z_o_n_t_a_l..
<
>
AArrgg==vvaall iiss aa lliisstt ooff aarrgguummeennttss ttoo tthhee ccoonnvveerrtteerr.. AAnn aarrgguummeenntt lliisstt iiss
pprreecceeddeedd bbyy aa qquueessttiioonn mmaarrkk,, aanndd mmuullttiippllee aarrgguummeennttss aarree sseeppaarraatteedd bbyy
aammppeerrssaannddss.. TThhee mmoosstt ccoommmmoonn aarrgguummeennttss aarree _f_o_r_e_g_r_o_u_n_d aanndd
_b_a_c_k_g_r_o_u_n_d.. GGrraaddiieennttss aallssoo ssuuppppoorrtt tthhee aarrgguummeennttss _s_t_a_r_t aanndd
_e_n_d ((ccoolloorrss wwiitthh wwhhiicchh ttoo ssttaarrtt aanndd eenndd tthhee ggrraaddiieenntt));; tthhee
_s_t_e_p_s aarrgguummeenntt,, ttoo aallllooww uussiinngg lleessss ccoolloorrss;; aanndd tthhee _d_i_m_e_n_s_i_o_n
aarrgguummeenntt ttoo ssppeecciiffyy tthhee ssiizzee ooff tthhee ggrraaddiieenntt.. TThhee _x_p_m ccoonnvveerrtteerr
uunnddeerrssttaannddss tthhee _c_l_o_s_e_n_e_s_s aarrgguummeenntt,, wwhhiicchh aaiiddss iinn uussiinngg ffeewweerr ccoolloorrss
((uusseeffuull iiff yyoouu hhaavvee aa lliimmiitteedd ccoolloorrmmaapp))..
<> TTEEXXTT WWIIDDGGEETT </hh33>>
MMoosstt ooff tthhee cchhaannggeess ttoo tthhiiss vveerrssiioonn ooff tthhee XXaaww lliibbrraarryy wweerree ddoonnee iinn tthhee
TTeexxttWWiiddggeett,, TTeexxttSSrrccOObbjjeecctt,, TTeexxttSSiinnkkOObbjjeecctt aanndd rreellaatteedd ffiilleess..
<>
AA ccoouuppllee ooff hhiigghhllyy vviissiibbllee cchhaannggeess iinn tthhee TTeexxtt wwiiddggeett aarree dduuee ttoo mmaannyy bbuuggss
iinn tthhee XXaaww66 iimmpplleemmeennttaattiioonn iinnvvoollvviinngg ssccrroollllbbaarrss aanndd aauuttoo--rreessiizziinngg..
SSccrroollllbbaarrss bbeeiinngg aaddddeedd oorr rreemmoovveedd ccaauusseedd sseevveerraall pprroobblleemmss iinn kkeeeeppiinngg tthhee
tteexxtt ccuurrssoorr vviissiibbllee,, aanndd iinn XXaaww66 iitt wwaass vveerryy eeaassyy ttoo hhaavvee aa wwiiddggeett tthhiinnkkiinngg
tthhee ccuurrssoorr wwaass vviissiibbllee,, wwhheenn iitt wwaass nnoott.. AAllssoo,, ppeerrmmiittttiinngg aauuttoommaattiicc
rreessiizziinngg ooff tthhee wwiiddggeett ttoo aa llaarrggeerr ggeeoommeettrryy ccrreeaatteedd ootthheerr pprroobblleemmss,, mmaakkiinngg
iitt ddiiffffiiccuulltt ttoo hhaavvee aa ccoonnssiisstteenntt llaayyoouutt iinn tthhee aapppplliiccaattiioonn,, aanndd,, iiff tthhee
wwiinnddooww mmaannaaggeerr ddiidd nnoott iinntteerrffeerree,, wwiinnddoowwss llaarrggeerr tthhaann tthhee ssccrreeeenn ccoouulldd
rreessuulltt.. TThheerreeffoorree,, ssoommee ffuunnccttiioonnaalliittyy iinnvvoollvviinngg ssccrroollllbbaarrss aanndd
aauuttoo--rreessiizziinngg hhaass bbeeeenn ddiissaabblleedd;; sseeee tthhee sseeccttiioonn oonn nneeww aanndd mmooddiiffiieedd
TTeexxtt wwiiddggeett rreessoouurrcceess bbeellooww..
<
>
TThhee TTeexxtt wwiiddggeett''ss ddeeffaauulltt kkeeyy bbiinnddiinnggss wweerree oorriiggiinnaallllyy bbaasseedd oonn tthhee EEmmaaccss
tteexxtt eeddiittoorr.. IInn tthhiiss rreelleeaassee,, eevveenn mmoorree ooppeerraattiioonnss ffaammiilliiaarr ttoo EEmmaaccss uusseerrss
hhaavvee bbeeeenn aaddddeedd.. NNeeww tteexxtt aaccttiioonnss iinncclluuddee::
<>
<>
<>iinnddeenntt</bb>>
<>
IInnddeennttss tteexxtt bblloocckkss.. NNoott bboouunndd bbyy ddeeffaauulltt.. TThhee TTeexxtt wwiiddggeett aallssoo ddooeess nnoott
aatttteemmpptt ttoo ppeerrffoorrmm aauuttoo--iinnddeennttaattiioonn ooff iittss ssoouurrccee oobbjjeecctt bbyy ddeeffaauulltt..
<>
<>kkeeyybbooaarrdd--rreesseett</bb>>
<>
RReesseettss tthhee kkeeyybbooaarrdd ssttaattee.. RReevveerrttss tthhee aaccttiioonn mmuullttiipplliieerr ttoo 11,, aanndd iiff uunnddoo
iiss eennaabblleedd,, ttoogggglleess bbeettwweeeenn uunnddoo aanndd rreeddoo.. BBoouunndd bbyy ddeeffaauulltt ttoo
_C_o_n_t_r_o_l_<_K_e_y_>_G..
<>
<>kkiillll--rriinngg--yyaannkk</bb>>
<>
IInn tthhiiss vveerrssiioonn ooff XXaaww,, tteexxtt kkiilllleedd iinn aannyy tteexxtt ffiieelldd iiss kkeepptt iinn mmeemmoorryy,,
aalllloowwiinngg ccuutt aanndd ppaassttee ooppeerraattiioonnss iinntteerrnnaallllyy ttoo tthhee pprrooggrraamm bbeettwweeeenn tteexxtt
ffiieellddss.. BBoouunndd bbyy ddeeffaauulltt ttoo _M_e_t_a_<_K_e_y_>_Y..
<>
<>nnuummeerriicc</bb>>
<>
LLiisstteedd hheerree oonnllyy ffoorr ppuurrppoosseess ooff ddooccuummeennttaattiioonn.. CCaalllleedd bbyy ddeeffaauulltt wwhheenn oonnee
ooff tthhee cchhaarraacctteerrss _1_, _2_, _3_, _4_, _5_, _6_, _7_, _8_, _9_, _0_, oorr _- iiss ttyyppeedd,,
aalllloowwiinngg ccoommppoossiittiioonn ooff tthhee mmuullttiipplliiccaattiioonn nnuummbbeerr ooff tteexxtt aaccttiioonnss..
<>
<>sseett--kkeeyybbooaarrdd--ffooccuuss</bb>>
<>
SSeettss tthhee iinnppuutt ffooccuuss ooff tthhee ttoopp lleevveell wwiiddggeett ttoo tthhee tteexxtt ffiieelldd.. NNoott
eennaabblleedd bbyy ddeeffaauulltt,, bbuutt bboouunndd ttoo tthhee _<_B_t_n_1_D_o_w_n_> eevveenntt..
<>
<>ttooggggllee--oovveerrwwrriittee</bb>>
<>
TToogggglleess oovveerrwwrriittee mmooddee.. IInn oovveerrwwrriittee mmooddee,, aannyy tteexxtt iinnsseerrtteedd iinn aa tteexxtt
ffiieelldd wwiillll rreeppllaaccee eexxiissttiinngg tteexxtt.. BBoouunndd bbyy ddeeffaauulltt ttoo _<_K_e_y_>_I_n_s_e_r_t..
<>
<>uunnddoo</bb>>
<>
SSeettss tthhee _e_n_a_b_l_e_U_n_d_o rreessoouurrccee ooff tthhee tteexxttSSrrccOObbjjeecctt.. NNoott eennaabblleedd bbyy
ddeeffaauulltt,, bbuutt bboouunndd ttoo _C_o_n_t_r_o_l_<_K_e_y_>__..
</ddll>>
<>
NNeeww aanndd mmooddiiffiieedd TTeexxtt wwiiddggeett rreessoouurrcceess iinncclluuddee::
<>
<>
<>jjuussttiiffyy ((_C_l_a_s_s JJuussttiiffyy))</bb>>
<>
SSeettss tthhee tteexxtt jjuussttiiffiiccaattiioonn.. CCaann bbee oonnee ooff _l_e_f_t_, _r_i_g_h_t_, _c_e_n_t_e_r,, oorr
_f_u_l_l.. OOnnllyy eennaabblleedd wwhheenn tthhee _a_u_t_o_F_i_l_l rreessoouurrccee iiss sseett,, aanndd tthhee
rreessoouurrcceess _l_e_f_t_C_o_l_u_m_n aanndd _r_i_g_h_t_C_o_l_u_m_n aarree ccoorrrreeccttllyy sseett..
<>
<>lleeffttCCoolluummnn ((_C_l_a_s_s CCoolluummnn))</bb>>
<>
SSppeecciiffiieess tthhee lleefftt ccoolluummnn aatt wwhhiicchh ttoo bbrreeaakk tteexxtt.. TTeexxtt lliinneess ssttaarrtteedd wwiitthh
aann aallpphhaannuummeerriicc cchhaarraacctteerr wwiillll aauuttoommaattiiccaallllyy ssttaarrtt aatt tthhiiss ccoolluummnn..
<>
<>ppoossiittiioonnCCaallllbbaacckk ((_C_l_a_s_s CCaallllbbaacckk))</bb>>
<>
AAlllloowwss iinnssttaallllaattiioonn ooff aa ccaallllbbaacckk ttoo bbee ccaalllleedd eevveerryy ttiimmee tthhee ccuurrssoorr iiss
mmoovveedd,, aanndd//oorr tthhee ffiillee cchhaannggeess iittss ssiizzee.. TThhee ccaallllbbaacckk iiss ccaalllleedd wwiitthh aa
ppooiinntteerr ttoo aa ssttrruuccttuurree ccoonnttaaiinniinngg tthhee ffoolllloowwiinngg ddaattaa::
<>
<>
ttyyppeeddeeff ssttrruucctt {{
iinntt lliinnee__nnuummbbeerr;;
iinntt ccoolluummnn__nnuummbbeerr;;
XXaawwTTeexxttPPoossiittiioonn iinnsseerrtt__ppoossiittiioonn;;
XXaawwTTeexxttPPoossiittiioonn llaasstt__ppoossiittiioonn;;
BBoooolleeaann oovveerrwwrriittee__mmooddee;;
}} XXaawwTTeexxttPPoossiittiioonnIInnffoo;;
</pprree>>
TThhiiss ccaallllbbaacckk iiss iinntteennddeedd ttoo hheellpp pprrooggrraammmmeerrss wwrriittee tteexxtt eeddiittoorrss bbaasseedd
oonn tthhee XXaaww wwiiddggeett sseett..
<>
<>rreessiizzee ((_C_l_a_s_s RReessiizzee))</bb>>
<>
NNoo lloonnggeerr ssuuppppoorrtteedd,, bbuutt rreeccooggnniizzeedd ffoorr bbaacckkwwaarrdd ccoommppaattiibbiilliittyy wwiitthh
rreessoouurrccee ssppeecciiffiiccaattiioonnss wwrriitttteenn ffoorr tthhee XXaaww66 TTeexxtt wwiiddggeett..
<>
<>rriigghhttCCoolluummnn ((_C_l_a_s_s CCoolluummnn))</bb>>
<>
SSppeecciiffiieess tthhee rriigghhtt ccoolluummnn aatt wwhhiicchh ttoo bbrreeaakk tteexxtt.. TTeexxtt lliinneess ssttaarrtteedd wwiitthh
aann aallpphhaannuummeerriicc cchhaarraacctteerr wwiillll aauuttoommaattiiccaallllyy eenndd aatt tthhiiss ccoolluummnn..
<>
<>ssccrroollllHHoorriizzoonnttaall ((_C_l_a_s_s SSccrroollll))</bb>>
<>
<>
<>
<>ssccrroollllVVeerrttiiccaall ((_C_l_a_s_s SSccrroollll))</bb>>
<>
TThheessee rreessoouurrcceess ccoonnttrrooll tthhee ppllaacceemmeenntt ooff ssccrroollllbbaarrss oonn tthhee lleefftt aanndd bboottttoomm
eeddggeess ooff tthhee TTeexxtt wwiiddggeett.. TThheeyy aacccceepptt tthhee vvaalluueess _X_a_w_t_e_x_t_S_c_r_o_l_l_A_l_w_a_y_s
aanndd _X_a_w_t_e_x_t_S_c_r_o_l_l_N_e_v_e_r.. AA ccoonnvveerrtteerr iiss rreeggiisstteerreedd ffoorr tthhiiss rreessoouurrccee
tthhaatt wwiillll ccoonnvveerrtt tthhee ffoolllloowwiinngg ssttrriinnggss:: _a_l_w_a_y_s aanndd _n_e_v_e_r.. TThhee
vvaalluuee _X_a_w_t_e_x_t_S_c_r_o_l_l_W_h_e_n_N_e_e_d_e_d ((aanndd _w_h_e_n_N_e_e_d_e_d,, rreeccooggnniizzeedd bbyy
tthhee ccoonnvveerrtteerr)),, iiss aacccceepptteedd ffoorr bbaacckkwwaarrddss ccoommppaattiibbiilliittyy wwiitthh rreessoouurrccee
ssppeecciiffiiccaattiioonnss wwrriitttteenn ffoorr tthhee XXaaww66 TTeexxtt wwiiddggeett,, bbuutt iiggnnoorreedd ((eeffffeeccttiivveellyy
ttrreeaatteedd aass _X_a_w_t_e_x_t_S_c_r_o_l_l_N_e_v_e_r))..
</ddll>>
<> TTEEXXTT SSOOUURRCCEE OOBBJJEECCTT </hh33>>
TThhee tteexxttSSrrccOObbjjeecctt aalllloowwss ddiissppllaayy ooff iittss ccoonntteennttss ttoo mmoorree tthhaann oonnee wwiinnddooww,,
aanndd aallssoo ssttoorreess uunnddoo iinnffoorrmmaattiioonn.. TThhee nneeww rreessoouurrcceess ffoorr tthhee tteexxttSSrrccOObbjjeecctt
aarree::
<>
<>
<>ccaallllbbaacckk ((_C_l_a_s_s CCaallllbbaacckk))</bb>>
<>
PPrreevviioouuss vveerrssiioonnss ooff XXaaww hhaadd tthhiiss rreessoouurrccee iinn ssuubbccllaasssseess ooff tthhee TTeexxttSSoouurrccee
oobbjjeecctt.. TThhiiss wwaass cchhaannggeedd ttoo mmaakkee iitt ppoossssiibbllee ttoo tteellll tthhee ccaallllbbaacckk tthhee
ssttaattee ooff tthhee tteexxtt wwhheenn uunnddoo iiss eennaabblleedd..
<>
<>eennaabblleeUUnnddoo ((_C_l_a_s_s UUnnddoo))</bb>>
<>
AA bboooolleeaann rreessoouurrccee tthhaatt eennaabblleess oorr ddiissaabblleess tthhee uunnddoo ffuunnccttiioonn.. TThhee ddeeffaauulltt
vvaalluuee iiss FFaallssee..
<>
<>ssoouurrcceeCChhaannggeedd ((_C_l_a_s_s CChhaannggeedd))</bb>>
<>
LLiikkee tthhee ccaallllbbaacckk rreessoouurrccee,, tthhiiss rreessoouurrccee wwaass pprreevviioouussllyy iinn ssuubbccllaasssseess ooff
tthhee TTeexxttSSoouurrccee oobbjjeecctt.. IItt iiss nnooww iinn tthhee tteexxttSSrrccOObbjjeecctt ttoo ccoonnttrrooll tthhee
cchhaannggeedd//uunncchhaannggeedd ssttaattee wwhheenn uunnddoo iiss eennaabblleedd..
</ddll>>
<> TTEEXXTT SSIINNKK OOBBJJEECCTT </hh33>>
TThhee tteexxttSSiinnkkOObbjjeecctt ssuubbccllaasssseess aasscciiiiSSiinnkkOObbjjeecctt aanndd mmuullttiiSSiinnkkOObbjjeecctt hhaavvee bbeeeenn
cchhaannggeedd sslliigghhttllyy ttoo uussee aa nneeww ccuurrssoorr sshhaappee ((nnoo lloonnggeerr aa ccaarreett aatt tthhee
bbaasseelliinnee)) tthhaatt iinnddiiccaatteess tthhee iinnppuutt ffooccuuss ooff tthhee tteexxtt wwiiddggeett,, aanndd aallllooww
ssppeecciiffiiccaattiioonn ooff tthhee ccuurrssoorr ccoolloorr.. TThhee nneeww rreessoouurrccee iiss::
<>
<>
<>ccuurrssoorrCCoolloorr ((_C_l_a_s_s CCoolloorr))</bb>>
<>
SSeettss tthhee ccuurrssoorr ccoolloorr ooff tthhee tteexxtt.. TThhiiss ccoolloorr iiss aallssoo uusseedd ttoo ddrraaww
sseelleecctteedd tteexxtt..
</ddll>>
<> SSIIMMPPLLEE MMEENNUU WWIIDDGGEETT </hh33>>
TThhee ssiimmpplleeMMeennuuWWiiddggeett aallggoorriitthhmm ttoo llaayy oouutt mmeennuu eennttrriieess hhaass bbeeeenn cchhaannggeedd ttoo
eennaabbllee mmuullttiippllee ccoolluummnnss wwhheenn aa ssiinnggllee ccoolluummnn ddooeess nnoott ffiitt oonn tthhee ssccrreeeenn..
IItt wwaass aallssoo mmooddiiffiieedd ttoo eennaabbllee ssuubbmmeennuuss..
<> SSMMEE BBSSBB OOBBJJEECCTT </hh33>>
AA nneeww rreessoouurrccee hhaass bbeeeenn aaddddeedd ttoo tthhee ssmmeeBBSSBBOObbjjeecctt ttoo aallllooww bbiinnddiinngg ssuubbmmeennuuss
ttoo iitt.. TThhee nneeww rreessoouurrccee iiss::
<>
<>
<>mmeennuuNNaammee ((_C_l_a_s_s MMeennuuNNaammee))</bb>>
<>
SSppeecciiffiieess tthhee nnaammee ooff tthhee ppooppuupp wwiiddggeett ttoo bbee ppooppppeedd uupp wwhheenn tthhee ppooiinntteerr iiss
oovveerr tthhee mmeennuu eennttrryy,, oorr NNUULLLL.. NNoottee tthhaatt tthhee nnaammeedd mmeennuu mmuusstt bbee aa cchhiilldd ooff
tthhee ppooppuupp ppaarreenntt ooff tthhee ssmmeeBBSSBBOObbjjeecctt..
</ddll>>
<> RREESSTTRRIICCTTIIOONNSS </hh33>>
<>XXaaww</bb>>
iiss aaccttiivveellyy bbeeiinngg ddeevveellooppeedd.. PPrrooggrraammss iinntteennddiinngg ttoo bbee ffuullllyy ccoommppaattiibbllee
wwiitthh ffuuttuurree rreelleeaasseess ooff tthhee XXaaww lliibbrraarryy sshhoouulldd uussee oonnllyy tthhee ppuubblliicc
iinntteerrffaacceess.. WWhhiillee wwiiddggeett ssuubbccllaassssiiffiiccaattiioonn iiss nnoott aa bbaadd tthhiinngg,, aanndd
ssoommeettiimmeess aann eennccoouurraaggeedd pprrooggrraammmmiinngg pprraaccttiiccee,, pprrooggrraammss tthhaatt aacccceessss pprriivvaattee
ddaattaa ssttrruuccttuurreess mmaayy hhaavvee pprroobblleemmss wwiitthh nneewweerr rreelleeaasseess iinn tthhee ccuurrrreenntt ssttaaggee
ooff
<>XXaaww</ii>>
ddeevveellooppmmeenntt.. EEffffoorrttss aarree bbeeiinngg mmaaddee ttoo aavvooiidd ssuucchh pprroobblleemmss aanndd ttoo gguuaarraanntteeee
tthhaatt nneewweerr rreelleeaasseess wwiillll bbee ssoouurrccee aanndd bbiinnaarryy ccoommppaattiibbllee..
<> AAUUTTHHOORRSS </hh33>>
TThhee oorriiggiinnaall XX CCoonnssoorrttiiuumm vveerrssiioonn ooff tthhee AAtthheennaa WWiiddggeett SSeett aanndd iittss
ddooccuummeennttaattiioonn wweerree tthhee wwoorrkk ooff mmaannyy ppeeooppllee,, iinncclluuddiinngg CChhrriiss DD.. PPeetteerrssoonn,,
RRaallpphh SSwwiicckk,, MMaarrkk AAcckkeerrmmaann,, DDoonnnnaa CCoonnvveerrssee,, JJiimm FFuullttoonn,, LLoorreettttaa
GGuuaarriinnoo--RReeiidd,, CChhaarrlleess HHaayynneess,, RRiicchh HHyyddee,, MMaarryy LLaarrssoonn,, JJooeell MMccCCoorrmmaacckk,, RRoonn
NNeewwmmaann,, JJeeaannnnee RRiicchh,, TTeerrrryy WWeeiissssmmaann,, MMiikkee GGaannccaarrzz,, PPhhiill KKaarrllttoonn,, KKaatthhlleeeenn
LLaannggoonnee,, RRaamm RRaaoo,, SSmmookkeeyy WWaallllaaccee,, AAll MMeennttoo,, aanndd JJeeaann DDiiaazz..
<>
XXFFrreeee8866''ss aaddddiittiioonnss aanndd mmooddiiffiiccaattiioonnss ttoo _X_a_w were written by Paulo
César Pereira de Andrade.
SEE ALSO
Athena Widget Set - C Language Interface