EX* vHelp on the Window Manager-DECW$MWM R ContentsC / CONTENTSCONTENTS8 E[TitlePageTitle Page@E\ CopyrightPageCopyright PageVw%%&KAbouttheWindowManagerAbout the Window Managerk4#&KOverviewoftheWindow&ManagerOverview of the Window ManagerOl!!pAUsing DECwindowsHelpUsing DECwindows HelpF\p@ DECwindowsBasicsDECwindows BasicsH\p@PartsofaWindowParts of a WindowOl!!pAMakingWindowsActiveMaking Windows Active @lpAMovingWindowsMoving Windows"@lp@SizingWindowsSizing Windows'Hlp@ MinimizingWindowsMinimizing Windows,[l''pA Restoring MinimizedWindowsRestoring Minimized Windows0HlpA MaximizingWindowsMaximizing Windows3[l''pA Restoring MaximizedWindowsRestoring Maximized Windows7Flp@ ArrangingWindowsArranging Windows:8l AShuffleUpShuffle Up?<\ AShuffleDownShuffle DownB:\ ANextWindowNext WindowEB\@PreviousWindowPrevious WindowHHlp@UsinganIconBoxUsing an Icon BoxKJlpA CustomizingWindowsCustomizing WindowsQYl&&A CustomizingYour WorkspaceCustomizing Your WorkspaceVJl@ CustomizingBordersCustomizing Borders]Wl%%@ CustomizingBorderColorsCustomizing Border Colorsbn!5&AChangingBorder ForegroundColorChanging Border Foreground Colorhn!5&@ChangingBorder BackgroundColorChanging Border Background Colorio!6'AChangingBorderTopShadowColorChanging Border Top Shadow Colorju$9"AChangingBorderBottomShadowColorChanging Border Bottom Shadow ColoroFlA CustomizingIconsCustomizing IconstSl##A CustomizingIconColorsCustomizing Icon Colorszl 4$AChangingIcon ForegroundColorsChanging Icon Foreground Colorsl 4$AChangingIcon BackgroundColorsChanging Icon Background Colorsm 5%@ChangingIconTopShadowColorsChanging Icon Top Shadow Colorss#8(@ChangingIconBottomShadowColorsChanging Icon Bottom Shadow ColorsVl%%AChangingIconBoxColorsChanging Icon Box Colors^l))@ CustomizingtheWindowMatteCustomizing the Window MatteOl!!@ApplyingYourChangesApplying Your ChangesMl  AApplyingtheOptionsApplying the OptionsJ\A CustomizationErrorCustomization Error_l))A CustomizingOther informationCustomizing Other informationP\!!@Advanced CustomizationAdvanced Customization@\AResourceFilesResource Files]l((AResource ConfigurationFilesResource Configuration Files-D'A CustomizingtheMwmMenus,Keys,andButtonsCustomizing the Mwm Menus, Keys, and ButtonsXl&&A CustomizingtheMwmMenusCustomizing the Mwm MenusT\$$ATheDefaultWindowMenuThe Default Window MenuUl$$@WindowManager FunctionsWindow Manager FunctionsSl##@ CustomizingtheButtonsCustomizing the ButtonsK\ATheDefaultButtonsThe Default ButtonsMl  A CustomizingtheKeysCustomizing the KeysEl@TheDefaultKeysThe Default KeysOl!!@ChangingthecolormapChanging the colormapf1AMwmResourceQuick ReferenceMwm Resource Quick Reference+A'@ CustomizingtheBorderforOne ApplicationCustomizing the Border for One Application/F,A CustomizingtheIconImageforOne ApplicationCustomizing the Icon Image for One Application+A'A CustomizingtheColorsforOne ApplicationCustomizing the Colors for One Applicationt#9+AStartingan ApplicationasanIconStarting an Application as an Iconx%;'@ CustomizingtheBorderandIconFontCustomizing the Border and Icon FontVl%%pAUsingthe WorkspaceMenuUsing the Workspace Menu8\ @PackIconsPack Icons*\ARestart Ll  p@UsingaWindowMenuUsing a Window Menu Elp@TypesofWindowsTypes of WindowsQl""A SecondaryWindowTypesSecondary Window Typesc/&KWindow Management& ShortcutsWindow Management ShortcutsSw##&LWindowManagerGlossaryWindow Manager GlossaryL\  pAClientorWorkAreaClient or Work Areal 4#pA DECwindowsMotifWindowpManagerDECwindows Motif Window Manager+\pAIconIcon4\ pAIconBoxIcon Box-\p@MatteMatte B\p@MaximizebuttonMaximize button!4\ pAMenubarMenu bar"B\pAMinimizebuttonMinimize button#>\p@ResizeborderResize border$6\ p@TitlebarTitle bar%<\ pAWindowFrameWindow Frame&:\ pAWindowmenuWindow menu'I\p@WindowMenubuttonWindow Menu button(5l p@ WorkspaceWorkspace)@lpA WorkspacemenuWorkspace menu* *R((OHelpontheWindowManager  =    O0O62000CompaqComputer CorporationTOCOMPAQ,OpenVMS,VAX,VMS,theCompaqlogo,andtheDIGITALlogo?O RegisteredinU.S.Patentand TrademarkOffice.[O Bookreader,CDA,DDIF,DECalc, DECdecision,DECpage, DECpresent, DECquery,_O DECwindows,andXUIare trademarksofCompaq Information TechnologiesGroup,O3L.P.^OMotif,OSF/1,UNIX,andthe"X"deviceare trademarksofTheOpenGroup.aOiAllotherproductnames mentionedhereinmaybethe trademarksor registered7O trademarksoftheir respective companies.fOF Confidentialcomputer software.'ValidlicensefromCompaqor authorized sublicensoreOrequiredfor possession,use,orcopying.( ConsistentwithFAR12.211and12.212,]O CommercialComputer Software,ComputerSoftwareDocumentation,and TechnicalaODatafor CommercialItemsarelicensedtotheU.S. Governmentundervendor's(OPstandard commerciallicense.iOCompaqshallnotbeliablefor technicalor editorialerrorsor omissions containedO-herein.dOThe informationinthis publicationissubjecttochangewithoutnoticeandisRO provided"ASIS"WITHOUTWARRANTYOFANYKIND.THEENTIRERISKOOMARISINGOUTOFTHEUSEOFTHIS INFORMATIONREMAINSWITHTHEQO RECIPIENT.INNOEVENTSHALLCOMPAQBELIABLEFORANYDIRECT,NOCONSEQUENTIAL, INCIDENTAL,SPECIAL, PUNITIVE,OROTHERDAMAGESNO  WHATSOEVER (INCLUDINGWITHOUT LIMITATION,DAMAGESFORLOSSOFMOW BUSINESSPROFITS,BUSINESS INTERRUPTION,ORLOSSOFBUSINESSSO  INFORMATION),EVENIFCOMPAQHASBEENADVISEDOFTHE POSSIBILITYOO OFSUCHDAMAGES.THE FOREGOINGSHALLAPPLY REGARDLESSOFTHENO  NEGLIGENCEOROTHERFAULTOFEITHERPARTYAND REGARDLESSOFQOa WHETHERSUCH LIABILITYSOUNDSIN CONTRACT, NEGLIGENCE,TORT,ORNO ANYOTHERTHEORYOFLEGAL LIABILITY,ANDNOTWITHSTANDINGANYDO FAILUREOF ESSENTIALPURPOSEOFANYLIMITEDREMEDY.`O Thelimited warrantiesforCompaqproductsare exclusivelysetforthinthebO  documentation accompanyingsuch products.(Nothinghereinshouldbe construedasarelicensedtotheU.S. Governmentundervendor'sstandardO commerciallicense. zSOCompaqshallnotbeliablefor technicalor editorialerrorsor'O omissions containedherein.t /JJOThe informationinthis publicationissubjecttochange?Owithout notice and is provided "AS IS" WITHOUT5O5WARRANTY OFANYKIND.THEENTIRE RISK;OARISINGOUTOFTHEUSEOFTHIS INFORMATION7OREMAINSWITHTHE RECIPIENT.INNOEVENT6O>SHALLCOMPAQBELIABLEFORANYDIRECT,:OCONSEQUENTIAL, INCIDENTAL,SPECIAL, PUNITIVE,4OOROTHERDAMAGES WHATSOEVER (INCLUDING6OHWITHOUT LIMITATION,DAMAGESFORLOSSOF5OBUSINESSPROFITS,BUSINESS INTERRUPTION,9OORLOSSOFBUSINESS INFORMATION),EVENIF>ORCOMPAQHASBEENADVISEDOFTHE POSSIBILITYOF6OSUCHDAMAGES.THE FOREGOINGSHALLAPPLY4O REGARDLESSOFTHE NEGLIGENCEOROTHER7O[FAULTOFEITHERPARTYAND REGARDLESSOF9OWHETHERSUCH LIABILITYSOUNDSIN CONTRACT,8O  NEGLIGENCE,TORT,ORANYOTHERTHEORYOF6OeLEGAL LIABILITY,ANDNOTWITHSTANDINGANY;OFAILUREOF ESSENTIALPURPOSEOFANYLIMITEDOREMEDY.0KOThelimited warrantiesforCompaqproductsare exclusivelyKOsetforthinthe documentation accompanyingsuch products.MO5Nothinghereinshouldbe construedas consitutingafurther#Oor additional warranty. X   !OUsing DECwindowsHelpKOUForanoverviewofthe DECwindowshelpsystem,chooseOn6OWindowfromtheUsingHelpmenuabove.vQOAHelpwindowopensthatdisplaysalistof additionaltopics%Oaboutcommonhelptasks.GO Additionaltopics:a7 `m,mOverviewoftheWindowManager*0IO   O DECwindowsBasicsGOUTodisplay informationaboutusing DECwindows,suchasLOhowtousewindows,menus,dialogboxes,andscrollbars:* 6G`m1.:MovethepointertotheHelpmenuontheSession Manager'smenubar.=`E2.:PressandholdMB1todisplaythismenu.O`3.:MovethepointertotheOnBasicsmenuitemandreleaseMB1.IWAhelpwindowopensthatdisplaysalistof additional7topicsaboutbasic DECwindows techniques.GO Additionaltopics:a7 `m,mOverviewoftheWindowManager*0IO   n[OPartsofaWindow=OUMostwindowsincludethe following components:!  OO ComponentK Description OOAWindowframe:KA Surroundsawindowandusuallyconsistsof;Kresizeborders,atitlebar,awindowmenu9Kbutton,aminimizebutton,andamaximizeK)button.OResizeborders:KSurroundan applicationwindowandletyou-Kresizethe application'swindow.OjTitlebar;KjShowsthenameofthe applicationandcon-7Ktainswindow managementbuttonsthatyou9Kcanuseto rearrangeyourscreendisplay.-KSMostwindowshaveatitlebar.OWindowTitle;K Identifiesthefunctionofawindow.%Fora=Kmainwindow,itusuallycontainsthenameof@Khthe application.#Foradialogbox,itmayalso=Kcontainspecific informationabouttheuseofKthewindow.MO|Windowmenubutton`Displaysthewindowmenu,whichcontains3Kmenuitemsforworkingwithwindows.OODMinimizebuttonLetsyoushrinkawindowtoaniconontheK workspace.O Iconhavenoeffect.AzKOIfnowindowsare obscuringotherwindows,then shuffling/Othewindowswillhavenoeffect. ZBOShuffleDownMOUTolowerthetop-mostwindowtothebottomofthescreen,havenoeffect.DzKOIfnowindowsare obscuringotherwindows,then shuffling/Othewindowswillhavenoeffect. EONextWindowJOUTosetfocustoa previouslyactivewindow,chooseNext-OWindowfromthe Workspacemenu.SF! )SOThiscanbeusefulto circulatethroughallthewindowsontheMOscreen.(Itdiffersfrom shufflingwindows.'NextWindowwillVO5alwaysgotothenextwindowevenifitisnot obscured,andit3Owillalwaysmakethatwindowactive.GWPOForexample,ifyouhavethreewindows:(aclock,thesessionIOmanager,andaDECterm,whichisactive.-IfyouselectHO5NextWindow,thentheclockmaybecomeactive.,IfyouIOselectNextWindowagain,thenthesessionmanagerwillHObecomeactive.,IfyouchoosePreviousWindow,thenthe(O>Clockbecomesactiveagain. HOPreviousWindowLOUTosetfocusinthereverseorderofNextWindow,choose7OPreviousWindowfromthe Workspacemenu.RI! (SOThiscanbeusefulto circulatethroughallthewindowsontheMOscreen.(Itdiffersfrom shufflingwindows.'NextWindowwillUO5alwaysgotothenextwindowevenifitisnotobscuredandit3Owillalwaysmakethatwindowactive.JWPOForexample,ifyouhavethreewindows:(aclock,thesessionIOmanager,andaDECterm,whichisactive.-IfyouselectHO5NextWindow,thentheclockmaybecomeactive.,IfyouIOselectNextWindowagain,thenthesessionmanagerwillHObecomeactive.,IfyouchoosePreviousWindow,thenthe(O>Clockbecomesactiveagain. KOUsinganIconBoxMOUBydefault,iconsare displayedasseparatewindowsonthe1Oscreenandcanbeplaced anywhere.LWPOIfyouwanttodisplayyouriconsinonecentralplace,youROcanstoretheminaniconbox.)AniconboxisawindowthatLO5containstheiconsforallthewindowsonthescreen.-ToROcreateaniconbox,usetheIconOptionsdialogbox,whichisJO availablebychoosingIcons...+fromthe WorkspaceOptionsO>submenu.M QOInaniconbox,ifyou double-clickonanyicon,bydefault,OOthewindowwillbecomeactiveandwillberaisedtotopofMO5thescreen.)Usingthe keyboard,youcanpressReturnonaKO highlightedicontomakethewindowactivefromanicon.OOIfyouShift+double-clickonanyicon,itwillminimizethatPO>window.'Whenawindowisrestoredfromanicon,theiconisOgrayed.N SOIfyoudonotuseaniconbox,whenyourestoreawindowtheOOiconisnotgrayed.'Instead,itisremovedfromthescreen.ONLOTo customizethepositionandsizeoftheiconbox,moveMOandresizetheiconboxandselectApplyOptionsfromthe#O5 WorkspaceOptionsmenu.]P33OYoucanalsominimizetheiconbox. iOh w%-OChangingBorder ForegroundColorMOUTochangetheWindowBorder Foregroundcolor,clickontheGO Foregroundbutton.) DECwindowsdisplaystheColorMixingPOdialogbox,whichletsyouselecttheborder foregroundcolorO^youwant. i Oiw%-OChangingBorder BackgroundColorDOUTochangetheWindowBorder BackgroundColor,clickAOonthe Backgroundbutton./ DECwindowsdisplaystheLOColorMixingdialogbox,whichletsyouselecttheborder'O^ backgroundcoloryouwant.  !j ).OChangingBorderTopShadowColorHOUWindowbordertopandbottomshadowcolorshavetobeEO well-matchedtopresentthethree-dimensionallookofFO DECwindowsMotif., DECwindowshelpsyoutodothisbyFO^ automatically determiningtopandbottomshadowborderNOcolorswhenyouchangethe backgroundcolor.(ThisoptionisGO indicatedbytheshaded Automaticshadowcheckbutton._k55OTochooseyourowntopshadowcolors:il??`m1.:Clickonthe Automaticshadowcheckbutton.m]+WThisoptionwillbe disabled.2`2.:ClickontheTopShadowbutton.|n RGW DECwindowsdisplaystheColorMixingdialogbox,whichEletsyouselecttheTopShadowcoloryouwant..YouFshouldusetheHLSmodelinthecolormixingdialogNaboxtochooseatopshadowcolorthatislighterandless2 saturatedthanthe backgroundcolor. ! "o)1OChangingBorderBottomShadowColorHOUWindowbordertopandbottomshadowcolorshavetobeEO well-matchedtopresentthethree-dimensionallookofFO DECwindowsMotif., DECwindowshelpsyoutodothisbyFO^ automatically determiningtopandbottomshadowcolorsGOwhenyouchangethe backgroundcolors.-ThisoptionisGO indicatedbytheshaded Automaticshadowcheckbutton.bp88OToselectyourownBottomshadowcolors:iq??`m1.:Clickonthe Automaticshadowcheckbutton.r`+WThisoptionwillbe disabled.5`2.:ClickontheBottomShadowbutton.s WGW DECwindowsdisplaystheColorMixingdialogbox,whichHletsyouselecttheBottomShadowcoloryouwant.*YouKshouldusetheHLSmodelofthecolormixingdialogboxKatochooseabottomshadowcolorthatisdarkerandmore2 saturatedthanthe backgroundcolor. \$#%B w,OChangingIcon ForegroundColorsCOUTochange the Icon Foreground Color,!click on theGO Foregroundbutton.) DECwindowsdisplaystheColorMixingSOdialogbox,whichletsyouselecttheicon foregroundcoloryouO^want. \%$&Bw,OChangingIcon BackgroundColorsCOUTochange the Icon background Color,!click on theGO Foregroundbutton.) DECwindowsdisplaystheColorMixingNOdialogbox,whichletsyouselecttheicon backgroundcolorO^youwant. &%' )-OChangingIconTopShadowColorsLOUIcontopandbottomshadowcolorshavetobe well-matchedCOtopresentthethree-dimensionallookof DECwindowsIOMotif.+ DECwindowshelpsyoutodothisby automaticallyJO^ determiningtopandbottomshadowbordercolorswhenyouPOchangetheicon backgroundcolor.'Thisoptionis indicatedby8Otheshaded Automaticshadowcheckbutton.`66OTochooseyourowniconshadowcolors:i??`m1.:Clickonthe Automaticshadowcheckbutton.]+WThisoptionwillbe disabled.2`2.:ClickontheTopShadowbutton.| RGW DECwindowsdisplaystheColorMixingdialogbox,whichEletsyouselecttheTopShadowcoloryouwant..YouFshouldusetheHLSmodelinthecolormixingdialogNaboxtochooseatopshadowcolorthatislighterandless2 saturatedthanthe backgroundcolor. '&(5  0OChangingIconBottomShadowColorsLOUIcontopandbottomshadowcolorshavetobe well-matchedCOtopresentthethree-dimensionallookof DECwindowsIOMotif.+ DECwindowshelpsyoutodothisby automaticallyJO^ determiningtopandbottomshadowcolorswhenyouchangeNOtheicon backgroundcolors.+Thisoptionis indicatedbythe3Oshaded Automaticshadowcheckbutton.8OhToselectyourownBottomshadowcolors:i??`m1.:Clickonthe Automaticshadowcheckbutton.`+WThisoptionwillbe disabled.5`2.:ClickontheBottomShadowbutton. WGW DECwindowsdisplaystheColorMixingdialogbox,whichHletsyouselecttheBottomShadowcoloryouwant.*YouKshouldusetheHLSmodelofthecolormixingdialogboxKatochooseabottomshadowcolorthatisdarkerandmore2 saturatedthanthe backgroundcolor. :(')n]%OChangingIconBoxColors8OUTochangetheIconBox BackgroundColor:a77`m1.:Clickonthe Automaticcolorbutton.Up++WThisoptionwillbe disabled.! !CWClickonthe Backgroundbutton.) DECwindowsdisplaysOtheColorMixingdialogbox,whichletsyouselecttheicon' backgroundcoloryouwant. -) (* )O CustomizingtheWindowMatteIOUTochangeyourmatte features,chooseMatte...,fromthe3.:RestartMwm.e;;OIfthisfiledoesnotexist,copyitfrom  `m>m$decw$system_defaults:decw$mwm_rc.datto decw$user_4defaults:decw$mwm_rc.datforOpenVMSor `E=E/usr/lib/X11/system.mwmrcto~/.mwmrcforothersystems.NPONotethatthisfilediffersfromtheMwmresourcefile.(OnceOOyouhavealocalcopyofthisfile,youmustmergeinanyOO5changesinthesystemfilewhenanewreleaseis installed. 324 $OTheDefaultWindowMenuOOUHereisthedefaultwindowmenufromthe configurationfile."O !&Default%Window&Menu3O" !&Menu% associated%with&window%border!Oi Menu&DefaultWindowMenu O {0 "Restore"_R& AltF5 f.normalizeA "Move" A _M& AltF7f.move "Size"" _S& AltF8f.resize0 "Minimize"p_n& AltF9 f.minimize1 "Maximize"p_x& AltF10p f.maximize*a "Lower"_L& AltF3f.lower no-labelD f.separator "Workspace"K_WD f.menu& WorkspaceMenu)9 "Close"_C& AltF4f.kill "Help"  _HD f.menu& MwmHelpMenu O }oEO Additionaltopics:(Resource ConfigurationFiles*FO i435n\$OWindowManager Functions8OUHereisalistofcommonMwm functions.'NOf.circle_down, f.circle_up,f.dec_customize, f.dec_help,f.exec,OOf.focus_color, f.focus_key,f.kill,f.lower, f.maximize,f.menu,GO5 f.minimize,f.move, f.next_cmap, f.next_key, f.normalize,EOf.normalize_and_raise, f.pack_icons, f.pass_key,f.post_EOsmenu, f.prev_cmap, f.prev_key, f.raise,f.raise_lower,HO> f.refresh, f.refresh_win, f.resize, f.restart, f.send_msg,GO f.separator,f.set_behavior,f.screenf.title, f.quit_mwm xIOFormore informationaboutWindowManager functions,see/OtheOSFMotif Programmer'sGuide. x546#O CustomizingtheButtonsIOUYoucanmodifywhichmousebuttonsareassignedtoMwmO functions.rHHOForexample,tostartDECtermfromMwmusingAltMB3,jL`m1.:Addthisitemtothebuttonbindingsinyourresource configurationfile.Z% 10 hDYhAltroot | window | frame | icon>Yf.exec"create/terminal/detached"forOpenVMSor @DY@Altroot | window | frame | icon9Yf.exec"/usr/bin/dxterm"forothersystems.`2.:RestartMwm.2OThemousebindingsareoftheformO Buttons& BindingName OP {9O Modifier