Export (0) Print
Expand All

AxActionPane [AX 2012]

Updated: April 30, 2013

Applies To: Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

The AxActionPane component provides access to the actions that can be performed for the items in a page. The AxActionPane component has the same function as the Action Pane Web Part. Consider using an AxActionPane component in a User Control when you do not want to rely on having an Action Pane web part on the page where the User Control will be used.

To reference the AxActionPane in ASP.NET code for Enterprise Portal in Microsoft Dynamics AX 2012, you must include the following reference in the markup for the User Control:

<%@ Register Assembly="Microsoft.Dynamics.Framework.Portal.SharePoint, Version=6.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
    Namespace="Microsoft.Dynamics.Framework.Portal.SharePoint.UI.WebControls" TagPrefix="dynamics" %>

To reference the AxActionPane in ASP.NET code for Enterprise Portal in Microsoft Dynamics AX 2012 R2, you must include the following reference in the markup for the User Control:

<%@ Register Assembly="Microsoft.Dynamics.Framework.Portal.SharePoint, Version=6.2.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
    Namespace="Microsoft.Dynamics.Framework.Portal.SharePoint.UI.WebControls" TagPrefix="dynamics" %>

If you are using Enterprise Portal with SharePoint 2013, your EP Web Application Project must be set to target the .NET 4 framework to use this component.

After you have added the reference to the assembly that contains the control, you can add the control to the markup. The following ASP.NET code example shows the AxActionPane that was added to a User Control:

<dynamics:AxActionPaneControl ID="ActionPane1" runat="server" 
    DataMember="FCMWorkOrders_Current" DataSourceID="WorkOrderListDataSource" WebMenuName="WorkOrdersActionPane"></dynamics:AxActionPaneControl>

The AxActionPane component has the following properties:

Subsection Heading

Property

Description

AccessKey

Not used for Enterprise Portal.

TabIndex

The tab order of the control.

Appearance

Property

Description

BackColor

This property is inherited from the base control. It is not specific to Enterprise Portal.

BorderColor

This property is inherited from the base control. It is not specific to Enterprise Portal.

BorderStyle

This property is inherited from the base control. It is not specific to Enterprise Portal.

BorderWidth

This property is inherited from the base control. It is not specific to Enterprise Portal.

CssClass

This property is inherited from the base control. It is not specific to Enterprise Portal.

Font

This property is inherited from the base control. It is not specific to Enterprise Portal.

ForeColor

This property is inherited from the base control. It is not specific to Enterprise Portal.

Behavior

Property

Description

Enabled

Specifies whether the action pane is enabled.

EnableTheming

Indicates whether the control can be themed.

EnableViewState

Specifies whether the control automatically saves its state for use in round-trips.

SkinID

The SkinId of the control skin that provides the skin of the control.

ToolTip

Not used for Enterprise Portal.

Visible

Indicates whether the control is visible and rendered.

Data

Property

Description

Expressions

The expressions that are bound to properties of the control.

DataMember

The table or view from the data set that is being used for the action pane.

DataSourceID

Specifies the AxDataSource component that will be used by the action pane to access data.

Layout

Property

Description

Height

The height of the control.

Width

The width of the control.

Microsoft Dynamics AX

Property

Description

Web Menu Name

Specifies the Web Menu item in the AOT that defines the items displayed in the action pane.

Misc

Property

Description

ID

The programmatic name of the control

CausesValidation

Specifies whether the controls in the validation group specified by the ValidationGroup property will be validated when an action pane item is clicked.

EnableMenuItemHelpText

Not applicable for the action pane control.

ValidationGroup

The name of the validation group for which the validation controls will be validated when an action pane item is clicked. Each validation control has a ValidationGroup property that specifies which validation group it is part of.

The AxActionPane component has the events listed in the following table.

Event

Description

ActionMenuItemClicked

Occurs after an item in the action pane has been clicked and the action has been performed.

ActionMenuItemClicking

Occurs after an item in the action pane has been clicked, but before the action has been performed.

DataBinding

Occurs when the server control binds to a data source.

DataBound

Occurs after the server control binds to a data source.

Disposed

Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

Init

Occurs when the server control is initialized, which is the first step in its lifecycle.

Load

Occurs when the server control is loaded into the System.Web.UI.Page object.

PreRender

Occurs after the System.Web.UI.Control object is loaded by prior to rendering.

SetMenuItemProperties

Occurs before the items in the action pane are displayed, allowing the properties to be set.

Unload

Occurs when the server control is unloaded from memory.

In most cases, you define the content displayed by an action pane by using Web Menu and Web Menu Item resources in the AOT. If you need the action pane content to be more dynamic, you can define the action pane content with code you add to the User Control that displays the action pane. You do this by implementing a method that returns an IWebMenuGenerator object for the User Control. This method defines the contents of the action pane. The process to define action pane content with code is the same as the process used to define toolbar content with code. For an example of how to use the IWebMenuGenerator to define content through code, see AxToolbar.

Community Additions

ADD
Show:
© 2014 Microsoft