Windows-Apps
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
EN
Dieser Inhalt ist in Ihrer Sprache leider nicht verfügbar. Im Folgenden finden Sie die englische Version.

Rating.onpreviewchange event

Applies to Windows only

Raised when the user is choosing a new tentative Rating.

Syntax


<div data-win-control="WinJS.UI.Rating" 
    data-win-options="{onpreviewchange : handler}">
</div>


function handler(eventInfo) { /* Your code */ }
 
// addEventListener syntax
rating.addEventListener("previewchange", handler);
rating.removeEventListener("previewchange", handler);


Event information

SynchronousNo
BubblesNo
CancelableYes

 

Event handler parameters

eventInfo

Type: CustomEvent

An object that contains information about the event. The detail property of this object contains the following sub-properties:

detail.tentativeRating

The new userRating.

Remarks

Setting event handlers declaratively (in HTML)

To set the event handler declaratively, it must be accessible to the global scope, and you must also call WinJS.Utilities.markSupportedForProcessing or WinJS.UI.eventHandler on the handler. You can make the handler accessible to the global scope by using WinJS.Namespace.define. For more information, see How to set event handlers declaratively.

Examples

This example defines a handler for the onpreviewchange event. When the user is choosing a new rating value, it outputs the tentative rating value (obtained from eventInfo.detail.tentativeRating) to a div element.


function previewChanged(eventInfo) {
    var previewChangeOutputDiv = document.getElementById("previewChangeOutputDiv");
    previewChangeOutputDiv.innerText = eventInfo.detail.tentativeRating;
}

WinJS.UI.eventHandler(previewChanged);

WinJS.Namespace.define("startPage", {
    previewChangedHandler: previewChanged
});


The next example creates Rating control, sets the onpreviewchange event, and creates the output div in HTML.


<div id="previewChangeRating" 
    data-win-control="WinJS.UI.Rating" 
    data-win-options="{onpreviewchange: startPage.previewChangedHandler}">
</div>
<div id="previewChangeOutputDiv">&nbsp;</div>


Requirements

Minimum WinJS version

WinJS 1.0

Namespace

WinJS.UI

See also

Rating
Quickstart: Adding WinJS controls

 

 

Anzeigen:
© 2017 Microsoft