qualifier Property

MS Office DHTML, HTML & CSS

previous page next page

Click to return to the DHTML, HTML & CSS home page

protocol Property

readOnly Property

DHTML Properties

Web Workshop | DHTML, HTML & CSS

qualifier Property

Retrieves the name of the data member provided by a data source object.

Syntax

HTML N/A

Scripting [ sQualifier = ] event.qualifier

HTML	N/A
Scripting	[ sQualifier = ] event.qualifier

Possible Values

sQualifier String that specifies the default data member either by the name of the data member or an empty string.

The property is read-only with no default value.

Remarks

Check the qualifier property in the event handlers of a data source object (DSO) if:

The DSO supports multiple, named data members.

You have specified a qualifier in association with the DATASRC attribute of an element bound to that DSO.

Valid qualifiers are specific to the DSO implementation. Check the documentation of the DSO to determine if it supports named data members and to determine the valid names for those data members.

Example

This example uses the qualifier property to show how to handle an ondatasetcomplete event when it is fired by a DSO that supports named data members. The hypothetical spreadsheet control defines the name of its data members to match the ranges that can be specified within a typical spreadsheet environment such as Microsoft® Excel. In the example, the named data member is restricted to the first seven cells of the first column.

Sample Code

<SCRIPT>
// Fired when all the data is available
function handle_dscomplete()
{
    var oEvent = window.event;
    // ignore the notification for the default data member
    if (oEvent.qualifier != "")
    {
        // get a recordset corresponding to the named data member
        // as indicated by the qualifier property
        var oNamedRS = oEvent.srcElement.namedRecordset(oEvent.qualifier);

        // now walk the recordset
        oNamedRS.MoveFirst();
        for (int i = 0; i < oNamedRS.RecordCount; i++)
        {
             var vValue = oNamedRS.Fields(0).value;
             oNamedRS.MoveNext();
        }
    }
}
</SCRIPT>

<!-- The CLASSID below does not correspond to a valid object -->
<OBJECT CLASSID="clsid:00000000-0000-0000-0000-000000000000" ID="dsoSpreadSheet" 
   ondatasetcomplete="handle_dscomplete()">

<!-- Bind the TABLE to the named recordset "A1:A7" provided by 
the spreadsheet control -->
<TABLE DATASRC="#dsoSpreadsheet.A1:A7">
   <TR><TD><SPAN DATAFLD="A"></SPAN></TD></TR>
</TABLE>

Applies To

[ Object Name ]

Platform Version

Win16:

Win32:

Mac:

Unix:

WinCE:

Version data is listed when the mouse hovers over a link, or the link has focus.

event