ProtectedBorder

Abstract

This topic describes the ProtectedBorder component in SPEAK.

The ProtectedBorder control is similar to the Border control:

  • It contains other controls.

  • It creates a placeholder called Content when you add it to a page, and the ProtectedBorder control contains any control that has this placeholder as the PlaceholderKey.

It has two properties that the Border control does not have: RequiresRead and RequiresWrite. When you use these properties, the ProtectedBorder control only renders the controls it contains if the context user has specified access rights.

A ProtectedBorder control can have a border and padding. You can align the controls it contains in different ways.

You cannot set the size of a ProtectedBorder control; it has no specific size set.

Name

Description

Default

Appearance

ContentAlign

Specify the alignment of the contained controls: Left, Center, or Right.

Left

Height

Specify the height of the control in pixels.

Null

RequiresRead

If true, the ProtectedBorder control only renders the controls it contains if the context user has Read rights on the data source item.

False

RequiresWrite

If true, the ProtectedBorder control only renders the controls it contains if the context user has Write rights on the data source item.

False

ShowBorder

If true, the ProtectedBorder control has a border.

False

UsePadding

If true, the ProtecteBorder control has padding. The padding is the extra space between the content and the border — it does not matter if the border is visible or not.

False

You can create a configuration item for a ProtectedBorder control by creating an item based on the ProtecteBorder Parameters template.

The configuration item has these specific fields:

  • ContentAlignment

  • ShowBorder

  • UsePadding

It inherits these fields:

  • IsVisible

  • AccessKey

  • Tooltip

  • Behaviors

  • Id