Export (0) Print
Expand All
ABS
AND
ASC
COS
DAY
DDB
EXP
FV
IF
INT
LEN
LN
LOG
MAX
Me
MID
MIN
MOD
NOT
IS
NPV
ODD
OR
PI
PMT
PV
SIN
SLN
SUM
SYD
T
TAN
VAR
Expand Minimize

Common Web Part properties

Archived content. No warranty is made as to technical accuracy. Content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

All Web Parts share a common set ofproperties that control their appearance, layout, and advanced characteristics.The common Web Part properties are listed below with their corresponding base classproperty name in parentheses.

About viewing the common propertiesin the tool pane

This topic describesall the common Web Part properties. However, the common Web Part properties you see inthe tool pane may be different than what is documented in this topic for severalreasons:

  • To see the Advanced section in thetool pane, you must have appropriate permission.

  • For a specificWeb Part, a Web Part developer may have chosen not to display one or more ofthese common properties, or may have chosen to create and display additional propertiesnot listed below in the Appearance , Layout , and Advanced sections of thetool pane.

  • Some permissions and property settings may disable orhide Web Part properties.

Appearance

Title (Title)

Specifies thetitle of the Web Part displayed in the Web Part title bar.

Typea string in the text box. To make it easier to edit a long string, click Text Builder Cc767469.ZA060472181033(en-us,TechNet.10).gif .

Height(Height)

Specifies the height of the Web Part.

Do one of the following:

  • To specify afixed height, select Yes , type a positive number in the text box, andthen select a unit of measurement. The following are valid units ofmeasurement: Centimeters , Inches , Millimeters , Points , Picas , and Pixels (the default).

  • To automatically adjust the height of the Web Part in the zone, select No . This is the default.

Width (Width)

Specifiesthe width of the Web Part.

Do one of the following:

  • To specify a fixed width, select Yes , typea positive number in the text box, and then select a unit of measurement. Thefollowing are valid units of measurement: Centimeters , Inches , Millimeters , Points , Picas , and Pixels (the default).

To automatically adjust thewidth of the Web Part in the zone, select No . This is thedefault.

Frame State(FrameState)

Specifies the initial state of the WebPart frame.

Do one of the following:

  • To display only the Web Part title bar, select Minimized .

  • To display the entire Web Part, select Normal . This is the default.

Frame Style(FrameType)

Specifies the style of the Web Partframe.

Do one of the following:

  • To use the value of the FrameType Web Part zone property specified, select Default . This is the default.

  • To display the content, but not the title bar and frame, select None .

  • To display the title bar, content, and frame, select Title Bar and Border .

  • To display the title barand content, but no frame, select Title Bar Only .

Layout

Visible on Page (IsVisible)

Specifies whether the Web Part is displayed or hidden when browsing theWeb Part Page. The Web Part is still visible when you are designing the page and has the suffix (hidden) appended to the title.

You might makea Web Part hidden if you want to use it to provide data to another Web Part through a Web Part connection, but don't need to display the Web Part.

Do one of thefollowing:

  • To display the Web Part, selectthe check box. This is the default.

  • To hide the Web Part, clear the check box.

Direction(Dir)

Specifies the direction of the text in theWeb Part content. For example, Arabic and Hebrew are right-to-left languages;English and most other European languages are left-to-right languages.

Do one of the following:

  • Toautomatically choose a text direction based on the language setting of the siteor subsite the Web Part Page is located in, select Default . This is the default.

  • To set the text direction to read left to right, select Left toRight .

  • To set the text direction to read right to left,select Right to Left .

Zone (ZoneID)

Specifies the zone on the Web Part Page where the Web Part is located.

To choose a zone, select a zone name from thelist.

Note: Zones on the Web Part Page are not listed in the list boxwhen you do not have permission to modify the zone.

PartOrder (PartOrder)

Specifies the position of the WebPart in a zone when the zone contains more than one Web Part.

Tospecify the order, type a positive integer in the text box.

Avalue of 1 means the Web Part is placed at the top of the zone, if the WebParts in the zone stack from top to bottom, or to the left of the zone, if theWeb Parts in the zone stack from left to right.

For example, whenyou add a Web Part to an empty zone that stacks from top to bottom, the PartOrder is 1 . When you add a second Web Part to the bottom of the zone, its PartOrder is 2 . To move the second Web Part to the top of the zone, type 1 , and then type 2 for the first Web Part .

Note: Each Web Part in thezone must have a unique Part Order number. Therefore, changing the Part Ordervalue for the current Web Part can also change the Part Order value for other WebParts in the zone.

Advanced

Allow Minimize (AllowMinimize)

Specifies whether or not the Web Part can be minimized.

Doone of the following:

  • To allow a Web Part tobe minimized, select the check box. This is the default.

  • Toprevent a Web Part from being minimized, clear the check box.

Allow Close(AllowRemove)

Specifies whether or not the Web Partcan be removed from the Web Part Page.

Do one of the following:

  • To allow a Web Part to be closed, select the checkbox. This is the default.

  • To prevent a Web Part from beingclosed, clear the check box.

Allow Zone Change(AllowZoneChange)

Specifies whether or not the WebPart can be moved to a different zone.

Do one of thefollowing:

  • To allow a Web Part to be moved toa different zone, select the check box. This is the default.

  • Toprevent a Web Part from being moved to a different zone, clear the checkbox.

Allow ExportSensitive Properties(ExportSensitiveProperties)

Controls whether a usercan export to a Web Part description file (.dwp) thevalues of one or more specific properties when making changes to a Web Part Pagein personal view. This property also controls whether a Web Part property can be accessed by the Web Part Services Component (WPSC) that runs on the client computer or used in the default web service.

The ExportControlledProperties propertyis useful for preventing the viewing and distribution of one or more propertyvalues that may contain sensitive information, such as a social securitynumber, a credit card number, or a connection string.

To enable the ExportControlledProperties property, the developer of the Web Part must markthe specific Web Part properties with the ControlledExport attribute by settingthe attribute value to True .

After the Web Part is installed at a site and uploaded to a Web Part gallery, the ExportControlledProperties property of the Web Part is False by default, which means one or more of the Web Part's properties marked as sensitive by the ControlledExport attribute cannot be exported in personal view, accessed through the WPSC, and used in the default web service. However, a site administrator or user with permission can still set the ExportControlledProperties property to True , if desired or necessary. For more information about how touse this property, see the .

Do one of the following:

  • Toprevent a user from exporting values of the specified properties in personal view, access by the Web Part Services Component (WPSC) that runs on the client computer, or used in the default web service, clear the check box (The sets the property value to False ). This is thedefault.

  • To allow a user to export values of the specified properties in personal view, access by the Web Part Services Component (WPSC) that runs on the client computer, or used in the default web service, selectthe check box (This sets the property value to True ).

DetailLink (DetailLink)

Specifies the URL of a filecontaining additional information about the Web Part. The file is displayed ina separate browser window when you click the Web Part title.

Typea file path or hyperlink in the text box. To make it easier to edit a long string, click Text Builder Cc767469.ZA060472181033(en-us,TechNet.10).gif .

Description (Description)

Specifies the ScreenTip that appears when you rest the mouse pointer onthe Web Part title or Web Part icon. When you search for Web Parts by using the Search command on the Find Web Parts menu of the tool pane, the value of this property is used when searching the following Web Part galleries: Site, Virtual Server, and Web Part Page.

Typea string in the text box. To make it easier to edit a long string, click Text Builder Cc767469.ZA060472181033(en-us,TechNet.10).gif .

Help Link(HelpLink)

Specifies the location of a file containinghelp information about the Web Part. The help information is displayed in aseparate browser window when you click the Help command on the WebPart menu.

Typea file path or hyperlink in the text box. To make it easier to edit a long string, click Text Builder Cc767469.ZA060472181033(en-us,TechNet.10).gif .

Icon File(Large) (PartImageLarge)

Specifies the location of afile containing a large Web Part icon. The image size must be 16 by 16 pixels.

Typea file path or hyperlink in the text box. To make it easier to edit a long string, click Text Builder Cc767469.ZA060472181033(en-us,TechNet.10).gif .

Icon File (Small)(PartImageSmall)

Caution: This property is reserved for future use by Microsoft, and the value is not saved if you enter it in the tool pane.

Missing Assembly Error(MissingAssembly)

Specifies a message that appears ifthe Web Part assembly file is missing or incorrect.

Typea string in the text box. To make it easier to edit a long string, click Text Builder Cc767469.ZA060472181033(en-us,TechNet.10).gif .

IsIncluded Filter (IsIncludedFilter)

Note: The name of this property in the tool pane can be customized by a siteadministrator or Web Part developer and may be different than the name "IsIncluded Filter."

Specifies a query string with criteria definedby a developer or site administrator to determine whether or not todisplay the Web Part. This property is used by developers whowant to customizeMicrosoft to target the display of Web Parts for certain groupsof people. This property is not displayed in the tool pane if it is not used, and it is always the last property displayed in the Advanced section of the tool pane. For more information about how touse this property, see the

Typea string in the text box. To make it easier to edit a long string, click Text Builder Cc767469.ZA060472181033(en-us,TechNet.10).gif .

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft