Toolbar Element (List)

Applies to: SharePoint Foundation 2010

Defines the toolbar of a list view, which is the section of a view that is rendered above the view header.

<Toolbar
  Position = "After"
  Type = "Standard" | "FreeForm">
</Toolbar>

Attributes

Attribute

Description

Position

Optional Text. If Position = "After" is specified, the toolbar will appear below the view body. If not specified, the toolbar will appear above the view body.

Type

Required Text. Specifies the kind of toolbar; this can be set to either Standard or FreeForm.

Child Elements

Numerous

Parent Elements

MetaData (List), MetaData (Site), View

Occurrences

Minimum: 0

Maximum: 1

Example

The following excerpt from the Schema.xml file for custom lists defines the New command of the toolbar, displaying the option to create items only to users with permission to add list items.

<Toolbar Position="After" Type="Freeform">
  <IfHasRights>
    <RightsChoices>
      <RightsGroup PermAddListItems="required" />
    </RightsChoices>
    <Then>
      <HTML><![CDATA[ <table width=100% cellpadding=0 cellspacing=0 border=0 > <tr> <td colspan="2" class="ms-partline"><IMG SRC="/_layouts/images/blank.gif" width=1 height=1 alt=""></td> </tr> <tr> <td class="ms-addnew" style="padding-bottom: 3px"> <img src="/_layouts/images/rect.gif" alt="">&nbsp;<a class="ms-addnew" ID="idAddNewItem" href="]]></HTML>
      <URL Cmd="New" /><HTML><![CDATA[" ONCLICK="javascript:NewItem(']]></HTML>
      <URL Cmd="New" /><HTML><![CDATA[', true);javascript:return false;" target="_self">]]></HTML><HTML><!-- _locID_text="onetid6" _locComment="{StringCategory=HTX}" -->$Resources:core,addnewitem;</HTML><HTML><![CDATA[</a> </td> </tr> <tr><td><IMG SRC="/_layouts/images/blank.gif" width=1 height=5 alt=""></td></tr> </table>]]></HTML>
    </Then>
  </IfHasRights>
</Toolbar>

See Also

Other Resources

List Views