1¾ « < ž Ÿ C:\EDITORS\C#.STY HPLASMS --SMMFeatureGuideCharacterWindowsStandardMenuManagerFeatureGuideDRAFTBryanFeirMicrosoftApplicationsDivision.c.1.IntroductionThisdocumentdescribesthefeaturesofthenewStandardMenuManagerinterfacetotheCharacterWindows(CW)system.ThissystemreplacestheoldCWmenucommandswithanewAPIsimilartothatofWindowswhichisolatestheapplicationwriterfromthestructureandallowsmenustobemodifieddynamicly..c.2.GeneralFeaturesThefollowingisalistofthefeaturesoftheStandardMenuManager.PleaseseetheInterfacesectionfordetaileddescriptionofthesefeatures.DynamicmenumodificationissimplifiedMulti-linemenubarssupportedtransparentlyHierarchalandPop-upmenussupportedScrollingmenussupportedifmenuislargerthanscreenApplicationdefinabledataspacewithinitemstructureApplicationdefinablestringfunctionforfarstringsordynamicstringchangesSupportforKanaacceleratorsinDBCSMenubarnolongerhastobeontoplineofscreenPreviousmenusystemstillavailablevia#ifdef.c.3.Implementation.c.:3.1CStructuresUsedThemenusystemmakesuseoftwobasicstructurestodescribethemenutree.Theyareasfollows:typedefstruct{HMTMhmtmNext;BITSfDisabled:1BITSfChecked:1BITSfSeparator:1;BITSfString:1;BITSfHelp:1;BITSfMenuBreak:1BITSfiller:10;union{WORDsid;WORDcwString;}WORDid;HMTMhmtmSub;WORDrgwExtra[];}MTM;typedefMTM**HMTM;NOTE:thesestructuresareforinformationonly,andshouldnotbeaccessedbytheapplication.hmtmNext:nextiteminlinkedlistofitems.fDisabled:aflagwhichtellswhetherornottheitemisenabled.Iftheitemisdisabledandhasanattachedmenu,themenucanstillbepulleddown,butallitemsonitwillappeardisabled.fChecked:TRUEiftheitemhasacheckmark.fSeparator:TRUEiftheitemisamenuitemseparator.fString:TRUEiftheitemcontainsthestringwithinit.fHelp:TRUEifthemenuisaspecialhelpmenu,whichwillberightjustifiedonthemenubar.Onlyonehelpmenushouldbeonanylineofthemenubar,andthehelpmenushouldbethelastiteminthebar.fMenuBreak:TRUEifthismenuwillforcethestartofanewlineinthemenubar.Thiswaytheapplicationcancontrolthevariouslinesonthemenubar.sid:thestringIDnumberwhichissenttoSzFromSidtogetthestring;usediffStringisFALSE.Thedefaultinterpretationisthatthisvalueisanearpointertoastring.cwString:thenumberofwordstoskipbeforethestringisfound;usediffStringisTRUE.id:theitemIDnumberpassedtoWM_COMMANDmessagesandusedtolocatetheitem.hmtmSub:themenuattachedtothisitem;NULLindicatesnosubmenu.rgwExtra:extradataforusebytheapplication..c.:3.2SetupInmemory,amenuconsistsofhandletoanMTMwiththemenubartitleandIDinformation,ifwanted.ThisitemcontainsahandletoalinkedlistofMTMstructures,whicharetheitemsofthemenu.AnyoneoralloftheseMTMsmayeitherbeaterminalitem,oramenuinitself,withitsownlistofitems.Menubars,menus,hierarchalmenus,andpopupmenusarealltreatedidentically.TheonlydifferenceisthatthetopmostitemiseithersetwithInitMenu,partofamenubar,partofanothermenu,orjustfloating,respectively..c.:3.3ItemStringsAsshownabove,therearetwopossiblemethodsofstoringstrings:Initem:thestringisphysicallycopiedintothestructureafterthereservednumberofwords.ThisismarkedbyfStringTRUE.cwExtraissettothereservednumberofwordssothatthestringcanbefoundquickly.Stringid#:sidcontainsavaluewhichispassedtoSzFromSidtogetthestring.ThisisusediffStringisFALSE.TheinternalSzFromSidstubjustreturnssid,assumingitisapointertothestring.Inbothcasesthestringwillbeoftheform"Cu~t\tDel",wherethecharacterafterthetildeishilightedasthemenuaccelerator,andthecharactersafterthetabwillberight-justifiedtodesignatethekeyboardacceleratorfortheitem.InKanjiversions,theformatis"~RK/Cut\tDel".Thecharacter'K'istheKanaaccelerator,whichwillbedisplayediftheglobalfKanaAccelisTRUE;otherwise'R',theRomanaccelerator,isdisplayed..c.:3.4ItemID#'sThemenuitemID0xFFFF(idSysMenu)isreservedforsystemuse.ItisusedforVAPcommandsandothersystemwork.TheapplicationshouldneverreceiveamessageaboutamenuitemwithanIDof0xFFFF..c.4.ChangestoCWAPI.c.:4.1NewCommandsThefollowingCWAPIcallswillbeaddedforthemainapplicationtointerfacetotheSMM:.c.::4.1.1HmtmAddItemHMTMHmtmAddItem(hmtmMenu,idBefore,sid,idNew,cwExtra,wFlags)HMTMhmtmMenu;WORDidBefore;WORDsid;WORDidNew;WORDcwExtra;WORDwFlags;ThehmtmMenuparameteristhehandletothemenutobeedited.ThenewitemwillgobeforetheitemwithID#idBefore;ifidBeforeisidNil,itgoesattheend.Thevaluesofsid,idNew,andcwExtradescribethenewitem.TheyrepresentthestringID,theitemID#,andthenumberofextrawordstoallocaterespectively.ThebasicactionMF_valuesareasfollows:ThevaluestospecifythestringIDarecoveredbelow:MF_STRING-thissignifiesthatsidmustbeanearpointertoastring.Thestringwillbecopiedintotheitemhandle.MF_SID-inthiscasesidisavalueusedbytheapplicationtogetthestring.IfthefunctionSzFromSidisnotsupplied,thedefaultfunctionwillassumethatsidisapointertoastring.(default)Andtheinitialstateoftheitemcanbespecifiedwith:MF_SEPARATOR-Theitemisamenuseparator.MF_ENABLED-Theitemisenabled.(default)MF_DISABLED-Theitemisdisabledandgreyed.MF_UNCHECKED-Theitemisunchecked.(default)MF_CHECKED-Theitemhasacheckmark.MF_HELP-Themenuwillberightjustifiedonthemenubar.MF_MENUBREAK-Themenuwillbeatthestartofanewrowonthemenubar..c.::4.1.2DeleteItemVOIDDeleteItem(hmtmMenu,id)HMTMhmtmMenu;WORDid;Thiscommandtakesanitemanddeletesit.Iftheitemisamenu,themenuwillnotbedeleted;atpresent,allitemsmustbedeletedindividually..c.::4.1.3OpenPopupMenuVOIDOpenPopupMenu(hmtmMenu,axLeft,ayTop)HMTMhmtmMenu;AXaxLeft;AYayTop;ThisroutinetakesthemenuspecifiedbyhmtmMenuandputsituponthescreen.Thesystemwillattempttodrawthemenuwiththetopleftcornerat(axLeft,ayTop).Ifthiswouldcausethemenutofallofftherightsideofthescreen,thenthemenuisplacedflushtotherightside..c.::4.1.4CchGetMenuStringWORDCchGetMenuString(id,pch,cchMac)WORDid;CHAR*pch;WORDcchMac;(NYI)ThisfunctionwillcopyuptocchMaxbytesfromthestringinitemidtothebufferpointedtobypchString.Thenumberofcharactersactuallycopiedisreturnedbythefunction..c.::4.1.5HmtmFindExternIdHMTMHmtmFindExternId(hmtm,id)HMTMhmtmMenubar;WORDid;ThisextensionofthestandardHmtmFindIdwillsearchforitemsnotinthepresentmenubar.Itwilldoarecursivesearchofallsubmenusofhmtm.Thisallowsmodificationofitemsinpopupmenus..c.::4.1.6HmtmFindFlatIdHMTMHmtmFindFlatId(hmtmMenubar,id)HMTMhmtmMenubar;WORDid;ThisversionofthestandardHmtmFindIdwillsearchforitemsonlyinhmtmMenubar,andnotinanyofitssubmenus..c.:4.2ModifiedCommandsThefollowingcommandsaredirectreplacementsofsomeofthecommandsintheoldAPI..c.::4.2.1InitMenubarVOIDInitMenubar(pwnd,hmtm,parc,daxSpace)PWNDpwnd;HMTMhmtm;PARCparc;WORDdaxSpace;InitMenubarreplacestheoldInitMenucommand,withaddedfunctionality.Thepwndisthesameasbefore,thehmtmisnowahandletothemenubar,theparccontainstherectangleinwhichthemenubaristobedrawn,anddaxSpacecontainsanumber(0to3)whichrepresentsthenumberofspacesbetweenitemsonthebar.Onreturnfromthefunction,parcismodifiedtocontaintherealrectanglethemenubarfills.Thisistogivetheapplicationknowledgeabouthowmaylinesthebartakesup..c.::4.2.2HmtmFindIdHMTMHmtmFindId(id)WORDid;HmtmFindIdreplacestheoldFindMenuItem,andisalmostidenticaltoitinfunction.However,HmtmFindIdcouldreturnamenuID#aswellasanitemID#..c.:4.3ApplicationSuppliedProcedures.c.::4.3.1SzFromSidCHAR*SzFromSid(sid)WORDsid;ThisfunctionissuppliedbytheapplicationifitwantsspecialtreatmentforStringID's.NormallytheSIDisinterpretedasanearpointertoazero-terminatedcharacterstring.Iftheapplicationsuppliesthiscommand,itwillbepassedsidforeveryDrawItemcommand,andshouldreturnapointertoazero-terminatedstringwhichwillbedrawninthemenuitem.(Optional).c.::4.3.2QuickHelpSzVOIDQuickHelpSz(sz)CHAR*sz;Thisfunctionisusedtoimplementthesingle-linehelpfeatureforsystemmenuitems.IfaitemwithidSysMenuishilited,insteadoftheWM_MENUCOMMANDmessagecomingup,thiscommandwillbecalledwithapointertothetexttobeplacedonthestatusline..c.5.AcceleratorTablesSincekeyboardacceleratorsarenolongerpartofthemenubar,theymustbesetupseparately.Twocommandshavebeenaddedtodothis.Also,aminorchangeintheformathasbeenmadetotheacceleratortable.Thefirstvalueisnowadummyvaluewhichcontainstwopiecesofdata:thevkeyvaluecontainsahashvalueequaltothenegationofalltheothervkey'sinthelistORedtogether,andtheidItemisinterpretedasahandletoanotheracceleratortableinalinkedlist.Anulllinkistheendofthelist.Thevkeyvalueisusedtoquicklydeterminewhetherthetableinquestioncouldpossiblycontainthekey.BothofthesepiecesofdataarecalculatedbyAddAccelTable..c.:5.1AddAccelTableVOIDAddAccelTable(prgmpvkeyid)MPVKEYID**prgmpvkeyid;Thiswilladdanewacceleratortabletothebeginningofthepresentlist.Thefirstentryismodifiedtocontainthehashedvkeyandthehandletothetablethatwasinthefront.Note:sincethenewtableisaddedtothefront,themostrecentlyaddedtablestakeprecedenceovertheolderones.IfprgmpvkeyidisNULL,thiswillbeignored..c.:5.2DeleteAccelTableVOIDDeleteAccelTable(prgmpvkeyid)MPVKEYID**prgmpvkeyid;Thisremovesatablefromthelist.Thehandleisnotdeallocated,itisjustdisconnectedfromthelist.Anyinvalidvalueisignored.z.c.6.ChangestoWndProcsIntheWM_INITMENUPOPUP,WM_COMMAND,andWM_MENUSELECT,intheLOWORD(lParam)value,anypointertoamenuitemormenuisreplacedwiththehandletotheitem.ThisreplacementalsooccursintheHelpcommand..c.7.MenuCreationExampleTocreatethefollowingmenus:FileEditTextNewUndo*HiliteOpen...-------Color:BlackSaveCutBlueSaveAs...CopyGreen----------PasteCyanExitEraseRedAboutDemo...MagentaYellow*WhiteThefollowingsetofcommandsshouldbeused:HMTMHmtmAddItem(hmtmMenu,wId,sid,wIdNew,cwExtra,wFlags)hmtmMenubar=HmtmAddItem(NULL,NULL,NULL,midMenubar,0,MF_ENABLED);hmtmFileMenu=HmtmAddItem(hmtmMenubar,NULL,"~File",midFile,0,MF_ENABLED);HmtmAddItem(hmtmFileMenu,NULL,"~New",midNew,0,MF_ENABLED);HmtmAddItem(hmtmFileMenu,NULL,"~Open...",midOpen,0,MF_DISABLED);HmtmAddItem(hmtmFileMenu,NULL,"~Save",midSave,0,MF_DISABLED);HmtmAddItem(hmtmFileMenu,NULL,"Save~As...",midSaveAs,0,MF_DISABLED);HmtmAddItem(hmtmFileMenu,NULL,NULL,0,0,MF_SEPARATOR);HmtmAddItem(hmtmFileMenu,NULL,"E~xit",midExit,0,MF_ENABLED);HmtmAddItem(hmtmFileMenu,NULL,"A~boutDemo...",midNew,0,MF_ENABLED);hmtmEditMenu=HmtmAddItem(hmtmMenubar,NULL,"~Edit",midEdit,0,MF_DISABLED);HmtmAddItem(hmtmEditMenu,NULL,"~Undo",midUndo,0,MF_DISABLED);HmtmAddItem(hmtmEditMenu,NULL,NULL,0,0,MF_SEPARATOR);HmtmAddItem(hmtmEditMenu,NULL,"~Cut",midCut,0,MF_DISABLED);HmtmAddItem(hmtmEditMenu,NULL,"C~opy",midCopy,0,MF_DISABLED);HmtmAddItem(hmtmEditMenu,NULL,"~Paste",midPaste,0,MF_ENABLED);HmtmAddItem(hmtmEditMenu,NULL,"~Erase",midErase,0,MF_DISABLED);hmtmTextMenu=HmtmAddItem(hmtmMenubar,NULL,"~Text",midText,0,MF_ENABLED);HmtmAddItem(hmtmTextMenu,NULL,"~Hilite",midHilite,0,MF_ENABLED|MF_CHECKED);hmtmColorMenu=HmtmAddItem(hmtmTextMenu,NULL,"~Color",midColor,0,MF_ENABLED);HmtmAddItem(hmtmColorMenu,NULL,"~Black",midBlack,0,MF_ENABLED);HmtmAddItem(hmtmColorMenu,NULL,"Bl~ue",midBlue,0,MF_ENABLED);HmtmAddItem(hmtmColorMenu,NULL,"~Green",midGreen,0,MF_ENABLED);HmtmAddItem(hmtmColorMenu,NULL,"~Cyan",midCyan,0,MF_ENABLED);HmtmAddItem(hmtmColorMenu,NULL,"~Red",midRed,0,MF_ENABLED);HmtmAddItem(hmtmColorMenu,NULL,"~Magenta",midMagenta,0,MF_ENABLED);HmtmAddItem(hmtmColorMenu,NULL,"~Yellow",midYellow,0,MF_ENABLED);HmtmAddItem(hmtmColorMenu,NULL,"~White",midWhite,0,MF_ENABLED|MF_CHECKED);arcMenubar.axLeft=arcWindow.axLeft+1;arcMenubar.ayTop=arcWindow.ayTop+1;arcMenubar.axRight=arcWindow.axRight-1;arcMenubar.ayBottom=arcWindow.ayTop+2;InitMenu(pwndMain,hmtmMenubar,&arcMenubar,2);NotethatunlikeWindows,thissystemisbuiltfromthetopdown:themenubarfirst,thenthemenus,thentheitemsonthemenus.Also,iftheapplicationusestheoldwParamUservariable,thenthecwExtravalue(0inthisexample)shouldbesetto1togiveonewordoffreespace.Thatwordmustbesetbytheapplication..c.8.ProposedExtensionstoMenuManagerThefollowingadditionswillpossiblybeinafutureversionofthemenumanager,buthavenotyetbeenwrittenintothecode:Multi-columnmenus,usingMF_MENUBREAKtogobetweencolumns.Properlyhandledmouseactioninscrollingmenus.Delaybeforesubmenuappearswheninmousemode.DocumentRevisionHistoryOct17/88(1.10)[BKF]FirstDraftproposalOct27/88(1.11)[BKF]Structuressimplified,menuID#'sreturned,APIsimplified,handlesforacceleratortables,Kanainfomovedintostring,andexampleadded.Nov15/88(1.12)[BKF]CleanupofAddItemdescription,additionofextensionssection,fHelpadded,fEnabledchangedtofDisabled.Dec16/88(1.20)[BKF]Hungariannamesfixed,moreparametersforInitMenu[bar],fSubMenuremoved,scrollingmenusadded.TableOfContents.BeginTableC.Introduction1GeneralFeatures1Implementation2CStructuresUsed2Setup3ItemStrings3ItemID#'s3ChangestoCWAPI3NewCommands3HmtmAddItem3DeleteItem4OpenPopupMenu4CchGetMenuString4HmtmFindExternId5HmtmFindFlatId5ModifiedCommands5InitMenubar5HmtmFindId5ApplicationSuppliedProcedures6SzFromSid6QuickHelpSz6AcceleratorTables6AddAccelTable6DeleteAccelTable6ChangestoWndProcs7MenuCreationExample7ProposedExtensionstoMenuManager8.EndTableC.twouldsettheprojectbackabit,recreatingtheworkalreadydone,itwouldbuyAdamsthetimeheneeded.€ ƒ ÿÿ„ v œ ÿÿ q ê ÿÿ m h ÿÿ f U ÿÿX d Þ ÿÿá b ô ÿÿø ` g ÿÿ @@ @ @ @g j y { ÿÿ w ã ÿÿë u s q Ò o Ô ÿÿÜ m k i 9 g @ e s c x a x C y M w Ý u à s q o - m / k Ž i – g Ø e ß c ê a ì _ = ] x = D y ‚ w Š u ± s ´ ÿÿ¸ q à o Þ m â k ô i « g ² e º c Á a _ x " y G w P u u s | q • o ž m ± k ´ i T g ^ e c ¡ a ± ÿÿÊ _ x Ê Ó y } w € u – ÿÿš s ÿÿ q ÿÿ% o 0 m ¶ ÿÿ¾ k i ( g - e 5 c 5 9 y > w Y u c ÿÿf s h q m o s m z k Í i % ÿÿ g ‚ e ñ c ô a 5 c ô < y E w } u € s Z q _ o v ÿÿ€ m ¨ k > ÿÿC i ] ÿÿj g Ò ÿÿÚ e Ç c Ç É ÿÿÎ y ë ÿÿû w ü u T ÿÿZ s y ÿÿ{ q ˜ ÿÿ¡ o ë ÿÿð m ÿÿ k i c ÿÿc m y Ò w Ö u s ÿÿ q , ÿÿ: o ; m … ÿÿ k ® i ¹ g Ú e Ü ÿÿà c c à O ÿÿT y l ÿÿw w Å u Ð s â q ê o m k 3 i 7 g \ e ` c ¡ a à c c¡ © y # w ' u · s ¼ q Ó ÿÿÝ o Þ m ì ÿÿö k ! ÿÿ! i K! ÿÿU! g ‡! ÿÿ‹! e c‹! °! y µ! w Æ! u Ì! s Õ! q Ù" o Ü" m c# k h# i {# ÿÿ€# g ‹# e $ c $ a ¢$ _ ‹! e¢$ ¥$ y ¼$ w Þ% u â% s && q *& o P& m V& k Ë& i Ï& g a' e n' c q' a u' _ ˆ' ] ‹! ˆ' ' y š' w @( u D( s ò( q ý( o ) m ") k 8) i =) g M) e ÿ) c * a * _ a* ] ‹! a* g* y ð* w ó* u + ÿÿ-+ s .+ q 4+ o 5+ m ;+ k <+ i A+ g B+ e G+ c H+ a O+ _ ‹! O+ P+ y V+ w W+ u k+ s l+ q r+ o t+ m y+ k z+ i €+ g + e Š+ c ‹+ a ’+ _ “+ ] ‹! “+ š+ y ›+ w ¡+ u £+ s µ+ q ¶+ o ¾+ m À+ k Ä+ i Å+ g Ë+ e Ì+ c Ô+ a Ö+ _ Ú+ ] ‹! Ú+ Û+ y ì+ w î+ u ü+ s þ+ q , o , m G, k R, i , ÿÿ‚5 g Œ5 e 5 c §5 a !6 _ ‹! !6 $6 y L6 ÿÿp7 w y9 ÿÿŠ9 r < ÿÿ< m G, k R, i , ÿÿ‚5 g Œ5 e 5 c §5 a !6 _ ‹! @€ @€€ ˆ Y Ÿ 7 Þ 5 3 ! . ˜ ) < m= €± A?!H $ ð p `'!H $ ð € `'˜ U v m q l - g \ g … g À g ú g M g v g « g Þ g ô b ] `'!H $³ ± E €= €± = € s v m q ‚ q ã l g Ô g g 9 g s g C g Ý g Ž g ê g = g ‚ g ´ g ± E €= €W €= €´ à v Þ q ô l 8 g b ß b Ñ ] ] ± X } S – N ¬ I ê³ ± = €³ = €E €= €³ = €³ ¬ v q ² l % g ] g Ù b ¦ b à ] X ? X q X ¤ X Ï X X = €E €= €E €= €W €µ = € Z v q q ¨ l > g X b © ] É X æ S / N 6 I ë D ¤= €a €W €µ = €W €µ = €W €µ E €ë v D q l ' g h b Ü ] ÷ X O S g N Å I · D ¤= €W €µ = €³ = €W €µ = €W €µ · Î v ì q ‡! l °! g Æ! b æ! ] c# X {# S ›# N ¢$ I ¼$ D ¤± = €W €µ = €W €µ ³ = €W €µ ¼$ q' v ˆ' q Á' l ) g 8) b t) ] ÿ) X * S ð* N + I -+ D ¤= €± = €± = €W €³ = €W €³ = €-+ , v B, q , q Ê, l - l ö. l H/ l Ô0 l %1 l Ë1 l ý3 l §4 l Ù4 l !6 g L6 b €W €± = €W €= €W €L6 Ì6 v 7 q >7 q p7 q Œ7 l »7 g b8 g è8 g e9 g f9 b y9 ] Š9 ÿÿÙ4 l !6 g L6 b €? €= €U €? €E €= €Š9 9 a ´9 a É9 a â9 G ï9 G : G : G è8 g e9 g f9 b y9 ] Š9 ÿ À€ûð À! €€ûð À!: -: a A: G V: - j: - : - ›: - µ: - è8 €ûð À! À€ûð À! €€ûð À!µ: Í: a æ: G û: - ; - : - ›: - µ: - è8 €ûð À! À€ûð À! €ûð À!; 6; a I; G ^; G w; - : - ›: - µ: - è8 €€ûð À! €ûð À! À€ûð À!w; Œ; a ¤; a ¾; G Ú; G < G < ÿÿ< ÿÿè8 €€ûð À! €€ûð À! À€ûð À! æ8 ÿÿÿÿ”; ÿÿÿÿ ^ 2 ¯ ! ) K1 ñ6 æ8 , 0 1 6 E M U ] NewStandardMenuManager BKF Menu Stillvolatile 1.02.00 12/16/8810/18/88“;
本文档为【MS-DOS6.0完整源代码45docsmm】，请使用软件OFFICE或WPS软件打开。作品中的文字与图均可以修改和编辑，
图片更改请在作品中右键图片并更换，文字修改请直接点击文字进行修改，也可以新增和删除文档中的内容。
该文档来自用户分享，如有侵权行为请发邮件ishare@vip.sina.com联系网站客服，我们会及时删除。
[版权声明] 本站所有资料为用户分享产生，若发现您的权利被侵害，请联系客服邮件isharekefu@iask.cn，我们尽快处理。
本作品所展示的图片、画像、字体、音乐的版权可能需版权方额外授权，请谨慎使用。
网站提供的党政主题相关内容(国旗、国徽、党徽..)目的在于配合国家政策宣传，仅限个人学习分享使用，禁止用于任何广告和商用目的。
浙公网安备 33021202002483