NameCtrl Control
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

NameCtrl Control

Windows SharePoint Services 3

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

A NameCtrl control is an ActiveX control that allows a Web page to display presence information for people, and it allows the user to take various actions with respect to those people through an on-object user interface (UI) in Windows SharePoint Services.

When a user passes the pointer over the name of a user on a SharePoint site, a function named EnsureIMNControl is called, which is defined in the file OWS.JS. This function creates the NameCtrl control on the page as follows:

new ActiveXObject("Name.NameCtrl.1")

OWS.JS is located in the Local_Drive:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\LAYOUTS\1033 directory on each front-end Web server in a Windows SharePoint Services deployment.

A developer can create a custom control for displaying presence information if it has the same ProgID (Name.NameCtrl.1), uses the same method or property names, and provides the same functionality that is described in this reference. Functions can be created that handle the event in which the online status of a specified person changes.

When the 2007 Microsoft Office system is installed on the client computer, the NameCtrl control is defined in the NAME.DLL file, a dynamic-link library that is installed on the client during 2007 Office system setup in the Local_Drive:\Program Files\Microsoft Office\OFFICE12 directory.

© 2016 Microsoft