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
sQualifier String 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:
- 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.
<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