NameCtrl Control

Applies to: SharePoint Foundation 2010

An ActiveX control that enables a webpage to display presence information for people, and lets the user take various actions with respect to those people through an on-object user interface (UI) in Microsoft SharePoint Foundation.

Remarks

This control is defined in NAME.dll, a dynamic-link library (DLL) that is installed in the %ProgramFiles%\Microsoft Office\Office14\ directory on the client computer during Microsoft Office Setup.

To instantiate this control, use the following function in ECMAScript (JavaScript, JScript):

var obj = new ActiveXObject('Name.NameCtrl.1');

In Microsoft Visual Basic Scripting Edition (VBScript), use the following to instantiate the control:

Set obj = CreateObject('Name.NameCtrl.1')

In both cases, the argument is the programmatic identifier (ProgId) of the control, Name.NameCtrl.1. For more information about ProgIds, see <ProgID> Key.

In SharePoint Foundation, when a page that contains a view of a document library opens, code in the file OWS.js determines whether Microsoft Office is installed and, if it is, instantiates the control. After the control is instantiated, presence information is displayed whenever the mouse pointer passes over the name of a user on a webpage.

The file OWS.js is located in the %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\1033 directory on each front-end web server in a SharePoint Foundation deployment.