Microsoft Knowledge Base Email Alertz

KBAlertz.com: (153092) - Sometimes it is desirable to add a new menu item to a window's System menu. This can be accomplished by using the AppendMenu API call and a Windows sub-classing control such as Message Blaster(tm). This article explains how to implement this action...

Receive Microsoft Knowledge Base articles by E-Mail?

Every night we scan the Microsoft Knowledge Base. If technologies you're interested in are updated, we'll send you an e-mail. You only get one e-mail a day, and only when new articles are added.

Click here to create a
FREE account
Already have an account?
[Click here to Login]

Search KbAlertz

Advanced Search

Webmasters
Put kbAlertz on your website.
[ Click Here for more! ]





ASP.NET 2.0 Web Hosting with SQL 2005: Click Here!
Discount ASP.NET Hosting


Bug Tracking Software
For bug tracking software or defect tracking software or issue tracking software, visit Axosoft.


Community Site



We Send hundreds of thousands of emails using ASP.NET Email



Expert Web Design & Graphic Design
Design44.com




Mentioned In








Microsoft Knowledge Base Article

This article contents is Microsoft Copyrighted material.
©2005-©2007 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks




SAMPLE: How to Add New Menu Items to the System Menu

Article ID:153092
Last Review:August 5, 2004
Revision:5.1
This article was previously published under Q153092
On This Page

SUMMARY

Sometimes it is desirable to add a new menu item to a window's System menu. This can be accomplished by using the AppendMenu API call and a Windows sub-classing control such as Message Blaster(tm). This article explains how to implement this action and provides a code sample.

In order to use the Message Blaster control, you can download the sample, free of charge, from the Microsoft Download Center. The following file is available for download from the Microsoft Download Center:
Msgblast.exe (http://download.microsoft.com/download/vb30/sample8/1/w9xnt4/en-us/msgblast.exe)
For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:
119591 (http://kbalertz.com/Feedback.aspx?kbNumber=119591/EN-US/) How to Obtain Microsoft Support Files from Online Services
Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

Back to the top

MORE INFORMATION

Step-by-Step Example

1.Download the Message Blaster Control.
2.Start Visual Basic, or choose New Project from the File menu if Visual Basic is already running. Form1 is created by default.
3.From the Tools menu, go to the Custom Controls option and add the MSGBLAST.VBX control to the project.
4.Place a Message Blaster Control on the form.
5.Place a Command button on Form1. Change the Caption to "&ADD."
6.Add the following code to the general declarations section of Form1:
   Option Explicit

   Private Declare Function RemoveMenu% Lib "User" (ByVal hMenu%, ByVal _
      nPosition%, ByVal wFlags%)
   Private Declare Function GetSystemMenu Lib "User" (ByVal hWnd%, ByVal _
      revert%) As Integer
   Private Declare Function GetWindowLong Lib "User" (ByVal hWnd As _
      Integer,ByVal nIndex As Integer) As Long
   Private Declare Function SetWindowLong Lib "User" (ByVal hWnd As _
      Integer, ByVal nIndex As Integer, ByVal dwNewLong As Long) As Long
   Private Declare Function AppendMenu Lib "User" (ByVal hMenu As _
      Integer, ByVal wFlags As Integer, ByVal wIDNewItem As Integer, _
      ByVal lpNewItem As Any) As Integer

   Private Const MF_STRING = &H0
   Private Const MF_BYCOMMAND = &H0
   Private Const WM_SYSCOMMAND = &H112

   'Enter the line below as one line of code
   Private Sub RemoveControlMenuItemByPosition(frm As Form, iPosition As
   Integer)
     Dim iHSysMenu As Integer
     Dim iReturn As Integer
     Dim lDW As Long
     Dim lRR As Long
     iHSysMenu = GetSystemMenu(frm.hWnd, 0)
     iReturn = RemoveMenu(iHSysMenu, iPosition, MF_BYPOSITION)
     lDW = GetWindowLong(frm.hWnd, -16)   'Window style
     lDW = lDW And &HFFFEFFFF    'Turn off bits for Maximize arrow button
     lRR = SetWindowLong(frm.hWnd, -16, lDW)
   End Sub

   Private Sub RemoveControlMenuItemByCommand(frm As Form, lCommand As _
     Long)
     Dim iHSysMenu As Integer
     Dim iReturn As Integer
     Dim lDW As Long
     Dim lRR As Long
     iHSysMenu = GetSystemMenu(frm.hWnd, 0)
     iReturn = RemoveMenu(iHSysMenu, lCommand, MF_BYCOMMAND)
     lDW = GetWindowLong(frm.hWnd, -16)   'Window style
     lDW = lDW And &HFFFEFFFF    'Turn off bits for Maximize arrow button
     lRR = SetWindowLong(frm.hWnd, -16, lDW)
   End Sub

   Private Sub cmdRemoveMenuItems_Click()
     Call RemoveControlMenuItemByPosition(Me, 0)
   End Sub

					
7.Place the following code in the Form Load Event:
   Private Sub Form_Load()
     MsgBlaster1.hWndTarget = Me.hWnd
     MsgBlaster1.MsgList(0) = WM_SYSCOMMAND
   End Sub

					
8.Place the following code in the Message event of the Message Blaster Control:
   'Enter the line below as one line of code

   Private Sub MsgBlaster1_Message(MsgVal As Integer, wParam As Integer,
   lParam As Long, ReturnVal As Long)
     Select Case wParam
       Case 1
         MsgBox "You clicked to About"
       Case 2
         MsgBox "You clicked on Help"
       Case 3
       'This option removes the custom added menu items and the separator.
       Dim iHSysMenu As Integer
       Dim iReturn As Integer
       iHSysMenu = GetSystemMenu(Me.hWnd, 0)
       Call RemoveControlMenuItemByCommand(Me, 1)
       Call RemoveControlMenuItemByCommand(Me, 2)
       Call RemoveControlMenuItemByCommand(Me, 3)
     End Select
   End Sub

					
9.Place the following code in the Command1 Click event:
   Private Sub Command1_Click()
     Dim iReturn As Integer
     Dim iHSysMenu As Integer
     iHSysMenu = GetSystemMenu(Me.hWnd, 0)
     iReturn = AppendMenu(iHSysMenu, MF_STRING, 1, "About...")
     iReturn = AppendMenu(iHSysMenu, MF_STRING, 2, "Help...")
     iReturn = AppendMenu(iHSysMenu, MF_STRING, 3, "Remove items...")
   End Sub

					
10.Press the F5 key or choose Start from the Run menu to run the project. Click the Add button. View the System menu and note that the new items have been added.

Back to the top

REFERENCES

For additional information, please see the following articles in the Microsoft Knowledge Base:
110498 (http://kbalertz.com/Feedback.aspx?kbNumber=110498/EN-US/) How to Add Items into Control Menu Box of Visual Basic Form

110104 (http://kbalertz.com/Feedback.aspx?kbNumber=110104/EN-US/) Using MSGBLAST.VBX Control to Process Windows Messages from VB

Back to the top


APPLIES TO
Microsoft Visual Basic 4.0 Standard Edition
Microsoft Visual Basic 4.0 Professional Edition
Microsoft Visual Basic 4.0 Enterprise Edition

Back to the top

Keywords: 
kb16bitonly kbfile kbsample KB153092

Back to the top

       

Community Feedback System

Very often, it takes hours to solve a problem. Very often, you've looked high and low, and have tried a lot of solutions. When you finally found it, chances are, it was because someone else helped you. Here's your chance to give back. Use our community feedback tool to let others know what worked for you and what didn't.

Please also understand that the community feedback system is not warranted to be correct, it's simply a system that we've built to let people try and help each other. If something in a feedback response doesn't make sense to you, or you're not comfortable making changes that the feedback talks about (like registry edits), please consult a professional.

Thank you for using kbAlertz.com Feedback System.

-- Scott Cate

Be the first to leave feedback, to help others about this knowledge base article.

(Optional) Name

(Optional) Public URL Or Email

Comments
No HTML -- Text Only Please