{"id":2285,"date":"2021-04-07T13:46:38","date_gmt":"2021-04-07T17:46:38","guid":{"rendered":"https:\/\/anvil-of-time.com\/?p=2285"},"modified":"2021-04-07T13:46:38","modified_gmt":"2021-04-07T17:46:38","slug":"100-days-of-powerbuilder-tutorial-day-8-adding-a-menu","status":"publish","type":"post","link":"https:\/\/anvil-of-time.com\/powerbuilder\/100-days-of-powerbuilder-tutorial-day-8-adding-a-menu\/","title":{"rendered":"100 Days of PowerBuilder – Tutorial – Day 8 – Adding a Menu"},"content":{"rendered":"

This is part of my project ‘100 Days of PowerBuilder’ which is a series of discussions focused on basic PowerBuilder development.<\/p>\r\n\r\n\r\n\r\n

Note: This article is written with examples created in PowerBuilder 2019 R3. Most steps\/examples will be identical with any version going back to 9.<\/em><\/p>\r\n\r\n\r\n\r\n

Let’s take a look at menus.\u00a0 We will create a simple menu for our main application window created earlier.\u00a0 Choose File – New – PB Object – Menu then click OK.<\/p>\r\n

\"\"<\/a><\/p>\r\n

Now you have your newly created menu object called ‘untitled0’.\u00a0 Notice the Menu Style on the Appearance tab of the Properties is ‘traditionalmenu!’; change this to contemporarymenu! to open up the various other options.<\/p>\r\n

\"\"<\/a> \u00a0<\/p>\r\n

Now save the menu to the ‘firstapp’ pbl as m_main.<\/p>\r\n

\"\"<\/a><\/p>\r\n

Right click on the ‘m_main’ menu item and choose Insert Submenu Item; give it the name ‘File’.<\/p>\r\n

\"\"<\/a><\/p>\r\n

Then save the menu.\u00a0 Now associate the menu with the main window of the application by opening the w_main object and clicking on the elipsis button next to the MenuName property. \u00a0<\/p>\r\n

\"\"<\/a><\/p>\r\n

Now save the window and run the application.\u00a0 You should see the menu:<\/p>\r\n

\"\"<\/a><\/p>\r\n

Now granted the menu doesn’t do anything at all now but at least we know we have correctly associated it with the window.\u00a0 Go back and open the menu painter.\u00a0 Right click on the ‘File’ menu item and choose Insert Submenu Item.\u00a0 Give it the name ‘Save’.\u00a0 \u00a0Once the control loses focus notice the visual example and the Name property are changed to reflect the menu item text.<\/p>\r\n

\"\"<\/a> \"\"<\/a><\/p>\r\n

Now associate a menu icon with this option by clicking on the elipsis button next to MenuImage.<\/p>\r\n

\"\"<\/a><\/p>\r\n

Then choosing PB menu or toolbar icons<\/p>\r\n

\"\"<\/a><\/p>\r\n

Search for ‘Save’ and then select the Save1! image, click OK, then save the menu. Open the w_main window again and add an event called ‘we_save’ and insert the following:<\/p>\r\n

\/\/ save the window then exit.\r\n\/\/\r\n\/\/insert save checking logic\r\nclose(THIS)<\/code><\/pre>\r\n
<\/code><\/code><\/p>\r\n
<\/code> Save the window and go back the the menu. In the clicked event of the Save menu option place the following:<\/p>\r\n
parentwindow.triggerevent \"we_save\"<\/code><\/pre>\r\n
Now run the application.\u00a0 From the main menu click on ‘File’ and then ‘Save’.\u00a0 You should be prompted for closing the window (same functionality as from the earlier window example). Now reopen the w_main window, go to the event list and delete the ‘we_save’ event and then save the window.<\/p>\r\n
\"\"<\/a><\/p>\r\n
Now run the application and choose Save from the File menu.\u00a0 Nothing should happen now.\u00a0 This shows how the triggerevent method on menus can be used to create generic functionality.\u00a0 Non existing events can be triggered in PowerScript without the application crashing as would be the case of a function call.<\/p>\r\n
Using Menu Methods<\/strong><\/p>\r\n
I consider it best practice to use menus primarily to trigger events on their parent windows.\u00a0 Although menus can have their own methods to do whatever processing is desired,\u00a0 I don’t believe there are any compelling reasons to architect an application this way \u00a0<\/p>","protected":false},"excerpt":{"rendered":"
This is part of my project ‘100 Days of PowerBuilder’ which is a series of discussions focused on basic PowerBuilder development. Note: This article is written with examples created in PowerBuilder 2019 R3. Most steps\/examples will be identical with any version going back to 9. Let’s take a look at menus.\u00a0 We will create a…<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[86,3],"tags":[62],"_links":{"self":[{"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/posts\/2285"}],"collection":[{"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/comments?post=2285"}],"version-history":[{"count":7,"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/posts\/2285\/revisions"}],"predecessor-version":[{"id":2305,"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/posts\/2285\/revisions\/2305"}],"wp:attachment":[{"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/media?parent=2285"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/categories?post=2285"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/anvil-of-time.com\/wp-json\/wp\/v2\/tags?post=2285"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}