Apply method

Captures the initial display of an object's content for a transition.

Syntax

HRESULT retVal = object.Apply();

Parameters

This method has no parameters.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Call this method when the element in its current state is to be the first input of a two-input transition. When ICSSFilterDispatch::Apply is called, the filter draws to its cached output so that any filters that rely on this filter for input will have an updated surface. Changes to the object's properties are not displayed until you call the ICSSFilterDispatch::Play method to start the transition.

If playing, this method stops the current transition and resets progress to zero. The HTMLFrameSiteEvents::onfilterchange event is not fired when the user calls ICSSFilterDispatch::Apply on a transition that's currently playing.

See also

How to Apply a Transition on an Image