Buttons

Button controls are used for each of the button types in a Microsoft Dynamics GP form. The button controls on a WinForm for a Microsoft Dynamics GP project get their additional characteristics from the dexButtonProvider you see on the WinForm layout. The ButtonType property is an additional property available for each button. It specifies how the button control is displayed and what characteristics it will have. You can set the AutoSetDexColors property to True so the button colors will match colors in Microsoft Dynamics GP.

The following is a list of the settings for the ButtonType property, and a description of how each button type is used.

Standard

Standard buttons don't have their appearance modified changed when placed on a WinForm for a Dynamics GP project. The following illustration shows a standard button.

Toolbar

Buttons with the ButtonType set to Toolbar are typically placed in the control area of a Microsoft Dynamics GP form. These buttons have a flat appearance, with a special color highlighting when the pointer is placed over them. It is also common for these buttons to have pictures on them. The following illustration shows a toolbar button.

ToolbarWithSeparator

The buttons with the type ToolbarWithSeparator buttons are typically placed in the control area, like buttons with the type Toolbar. However, they have an additional separator line drawn on the right side of the button to separate it from the other controls in the control area. The following illustration shows two buttons that have the type ToolbarWithSeparator. Notice the separator line drawn to the right of each button.

StatusArea

Buttons placed in the status area at the bottom of a window should have the type StatusArea. These buttons should display only graphics, and will have a special 3-D border drawn around them when the pointer is placed over them. These buttons should have the Tooltip property set so they will display a description of the action the button performs. A status area button is shown in the following illustration. It displays a tooltip that describes the purpose of the button.

Field

Buttons that show only pictures, and are placed next to other controls in the form should have the ButtonType property set to Field. These buttons are used for things like lookups or expansions. Several buttons with this type are shown next to a text control in the following illustration.

Pictures for buttons

Each Visual Studio for Microsoft Dynamics GP project includes several standard images that are used for buttons in Microsoft Dynamics GP. These images (in PNG format) should be used with the buttons you create for your integrations. The following table lists the images and describes how they are used.

Image

Name

Description

Cc543558.Field_Delete(en-us,MSDN.10).gif

Field_Delete.png

Used for delete buttons in the window area placed next to fields.

Cc543558.Field_Edit(en-us,MSDN.10).gif

Field_Edit.png

Used for edit buttons in the window area placed next to fields.

Cc543558.Field_Expansion(en-us,MSDN.10).gif

Field_Expansion.png

Used for expansion buttons in the window area placed next to fields.

Cc543558.Field_Lookup(en-us,MSDN.10).gif

Field_Lookup.png

Used for lookup buttons in the window area placed next to fields.

Cc543558.Field_MapPoint(en-us,MSDN.10).gif

Field_MapPoint.png

Used for MapPoint buttons in the window area placed next to fields.

Cc543558.Field_NoteAbsent(en-us,MSDN.10).gif

Field_NoteAbsent.png

Used for note buttons in the window area placed next to fields.

Cc543558.Field_NotePresent(en-us,MSDN.10).gif

Field_NotePresent.png

Used for note buttons in the window area placed next to fields.

Cc543558.HelpImage(en-us,MSDN.10).gif

HelpImage.png

Used for the Help button placed in the status area of the window.

Cc543558.Toolbar_Cancel(en-us,MSDN.10).gif

Toolbar_Cancel.png

Used for the Cancel button placed in the window control area.

Cc543558.Toolbar_Clear(en-us,MSDN.10).gif

Toolbar_Clear.png

Used for the Clear button placed in the window control area.

Cc543558.Toolbar_Copy(en-us,MSDN.10).gif

Toolbar_Copy.png

Used for the Copy button placed in the window control area.

Cc543558.Toolbar_Delete(en-us,MSDN.10).gif

Toolbar_Delete.png

Used for the Delete button placed in the window control area.

Cc543558.Toolbar_DeleteAll(en-us,MSDN.10).gif

Toolbar_DeleteAll.png

Used for the Delete All button placed in the window control area.

Cc543558.Toolbar_New(en-us,MSDN.10).gif

Toolbar_New.png

Used for the New button placed in the window control area.

Cc543558.Toolbar_Open(en-us,MSDN.10).gif

Toolbar_Open.png

Used for the Open button placed in the window control area.

Cc543558.Toolbar_Post(en-us,MSDN.10).gif

Toolbar_Post.png

Used for the Post button placed in the window control area.

Cc543558.Toolbar_Print(en-us,MSDN.10).gif

Toolbar_Print.png

Used for the Print button placed in the window control area.

Cc543558.Toolbar_Redisplay(en-us,MSDN.10).gif

Toolbar_Redisplay.png

Used for the Redisplay button placed in the window control area.

Cc543558.Toolbar_Save(en-us,MSDN.10).gif

Toolbar_Save.png

Used for the Save button placed in the window control area.

Cc543558.Toolbar_Void(en-us,MSDN.10).gif

Toolbar_Void.png

Used for the Void button placed in the window control area.

Cc543558.VCR_First(en-us,MSDN.10).gif

VCR_First.png

Used for the First browse control in the window status area.

Cc543558.VCR_Last(en-us,MSDN.10).gif

VCR_Last.png

Used for the Last browse control in the window status area.

Cc543558.VCR_Next(en-us,MSDN.10).gif

VCR_Next.png

Used for the Next browse control in the window status area.

Cc543558.VCR_Previous(en-us,MSDN.10).gif

VCR_Previous.png

Used for the Previous browse control in the window status area.

Cc543558.Window_NoteAbsent(en-us,MSDN.10).gif

Window_NoteAbsent.png

Used for the note button in the window status area.

Cc543558.Window_NotePresent(en-us,MSDN.10).gif

Window_NotePresent.png

Used for the note button in the window status area.