qualifier

HTML (DHTML)

qualifier Property

Internet Development Index

Sets or retrieves the name of the data member provided by a data source object.

Syntax

event.qualifier [ = sQualifier ]

Possible Values

sQualifierString that specifies or receives the default data member either by the name of the data member or an empty string.

The property is read/write. The property has no default value.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.

Remarks

The property is read-only in Microsoft® Internet Explorer 4.0, and read/write in Internet Explorer 5 and later.

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

  1. The DSO supports multiple, named data members.
  2. 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.

<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>

Standards Information

There is no public standard that applies to this property.

Applies To

event

See Also

namedRecordset, Using a Data Source Object that Exposes Multiple Data Members