Friday 12 June 2015

Page Viewer Web Part

Page Viewer Web Part are used to display a Web page, file, or folder on a Web Part Page. One can  enter a hyperlink, file path, or folder name to link to the content.

NOTES   
  • You can use the Page Viewer Web Part only in a browser that supports the HTML IFRAME element.
  • Displaying a file or folder requires Microsoft Internet Explorer.


One can use the Page Viewer Web Part to display:
  • A favorite Internet news source in a dedicated news summary section of a Web Part Page.
  • A list of active work group files on a network server that you want to view on a regular basis.
  • A commonly used document or spreadsheet.

How the Page Viewer Web Part displays a Web page within a Web Part Page

The linked content of the Page Viewer Web Part is isolated from other content on the Web Part Page through the use of the HTML IFRAME element. This element ensures that any HTML elements that are displayed as content in the Page Viewer Web Part do not conflict with other HTML elements on the Web Part Page. For example, the Web Part Page may already contain an HTML FORM element, and the page would not be displayed correctly if the linked content also contained an HTML FORM element that was not inside the HTML IFRAME element.
The Page Viewer Web Part displays content asynchronously from the rest of the page. This means that you can view and use other Web Parts on the page if the link happens to take a long time to return the content.



Custom properties of the Page Viewer Web Part


The custom properties of the Page Viewer Web Part are listed below.
NOTE   You cannot view or edit any of these custom properties in personal view.
Property
Description
Web Page,Folder, or Filegroup
Specifies the type of content that you want to display in the Page Viewer Web Part.
Select one of the following:
  • Web Page     Select this option if you want to display a Web page as the content of the Page Viewer Web Part. This option automatically enters the Hypertext Transfer Protocol (http://) in theLink text box and hides the Browse button if it is visible. This is the default value.
  • Folder     Select this option if you want to display a list of files in a folder. This option hides theBrowse button if it is visible.
  • File     Select this option to display the contents of a file. This option also displays the Browsebutton under the Link text box. The file opens either in a separate browser window or inside the Web Part if the application that opens the file supports inline activation for that file in the browser window.
Link
Specifies a hyperlink, folder, or file to link to the content that you want displayed in the Page Viewer Web Part:
  • If you select Web Page above, you must enter a valid hyperlink. The two valid hyperlink protocols that you can use are:
    • Hypertext Transfer Protocol (http://)
    • Hypertext Transfer Protocol with privacy, which uses Secure Sockets Layer (SSL) encryption (https://)
      You can use an absolute URL or a relative URL. However, you cannot use a file path.
  • If you select Folder above, you must enter a valid local or network folder. Displaying a folder requires Microsoft Internet Explorer.
  • If you select File above, you must enter a valid file path. Displaying a file requires Microsoft Internet Explorer. You can also click Browse to locate the file.

Common properties of Web Parts

All Web Parts share a common set of properties that control their appearance, layout, and advanced characteristics.
NOTE   The common Web Part properties that you see in the tool pane may be different from what is documented in this section for several reasons:
  • To see the Advanced section in the tool pane, you must have appropriate permission.
  • For a specific Web Part, a Web Part developer may have chosen not to display one or more of these common properties or may have chosen to create and display additional properties that are not listed below in theAppearanceLayout, and Advanced sections of the tool pane.
  • Some permission and property settings may disable or hide Web Part properties.
Appearance
Property
Description
Title
Specifies the title of the Web Part that appears in the Web Part title bar.
Height
Specifies the height of the Web Part.
Width
Specifies the width of the Web Part.
Chrome State
Specifies whether the entire Web Part appears on the page when a user opens the Web Part Page. By default, the chrome state is set to Normal and the entire Web Part appears. Only the title bar appears when the state is set to Minimized.
Chrome Type
Specifies whether the title bar and border of the Web Part frame are displayed.
Layout
Property
Description
Hidden
Specifies whether the Web Part is visible when a user opens the Web Part Page. If the check box is selected, the Web Part is visible only when you are designing the page and has the suffix (Hidden)appended to the title.
You can hide a Web Part if you want to use it to provide data to another Web Part through a Web Part connection, but you don't want to display the Web Part.
Direction
Specifies the direction of the text in the Web Part content. For example, Arabic is a right-to-left language; English and most other European languages are left-to-right languages. This setting may not be available for all types of Web Parts.
Zone
Specifies the zone on the Web Part Page where the Web Part is located.
NOTE   Zones on the Web Part Page are not listed in the list box when you do not have permission to modify the zone.
Zone Index
Specifies the position of the Web Part in a zone when the zone contains more than one Web Part.
To specify the order, type a positive integer in the text box.
If the Web Parts in the zone are ordered from top to bottom, a value of 1 means that the Web Part appears at the top of the zone. If the Web Parts in the zone are ordered from left to right, a value of 1 means that the Web Part appears on the left of the zone.
For example, when you add a Web Part to an empty zone that is ordered from top to bottom, the Zone Index is 0. When you add a second Web Part to the bottom of the zone, its Zone Index is 1. To move the second Web Part to the top of the zone, type 0, and then type 1 for the first Web Part.
NOTE   Each Web Part in the zone must have a unique Zone Index value. Therefore, changing the Zone Index value for the current Web Part can also change the Zone Index value for other Web Parts in the zone.
Advanced
Property
Description
Allow Minimize
Specifies whether the Web Part can be minimized.
Allow Close
Specifies whether the Web Part can be removed from the Web Part Page.
Allow Hide
Specifies whether the Web Part can be hidden.
Allow Zone Change
Specifies whether the Web Part can be moved to a different zone.
Allow Connections
Specifies whether the Web Part can participate in connections with other Web Parts.
Allow Editing in Personal View
Specifies whether the Web Part properties can be modified in a personal view.
Export Mode
Specifies the level of data that is permitted to be exported for this Web Part. Depending on your configuration, this setting may not be available.
Title URL
Specifies the URL of a file containing additional information about the Web Part. The file is displayed in a separate browser window when you click the Web Part title.
Description
Specifies the ScreenTip that appears when you rest the mouse pointer on the Web Part title or Web Part icon. The value of this property is used when you search for Web Parts by using theSearch command on the Find Web Parts menu of the tool pane in the following Web Part galleries: Site, Virtual Server, and Web Part Page.
Help URL
Specifies the location of a file containing Help information about the Web Part. The Help information is displayed in a separate browser window when you click the Help command on the Web Part menu.
Help Mode
Specifies how a browser will display Help content for a Web Part.
Select one of the following:
  • Modal Opens a separate browser window, if the browser has this capability. A user must close the window before returning to the Web page.
  • Modeless Opens a separate browser window, if the browser has this capability. A user does not have to close the window before returning to the Web page. This is the default value.
  • Navigate Opens the Web page in the current browser window.
NOTE   Even though custom Microsoft ASP.NET Web Parts support this property, default Windows SharePoint Services 3.0 Help topics open only in a separate browser window.
Catalog Icon Image URL
Specifies the location of a file containing an image to be used as the Web Part icon in the Web Part List. The image size must be 16 by 16 pixels.
Title Icon Image URL
Specifies the location of a file containing an image to be used in the Web Part title bar. The image size must be 16 by 16 pixels.
Import Error Message
Specifies a message that appears if there is a problem importing the Web Part.

No comments: