Export (0) Print
Expand All

AdControl Class - Windows 8.1

Microsoft Advertising Services

Updated: October 17, 2013

Published: April 1, 2014

In This Section

Method

Description

AdControl constructor

Create the AdControl.

JavaScript:

dispose(Boolean)

JavaScript only.

You must call this function when you programmatically remove the AdControl from a page.

System_CLiX_warning Warning

Most developers will not use this method.

C#: Refresh()

JavaScript: refresh()

When automatic ad refresh is disabled, a call to this method directs the AdControl to show the next ad when a new one becomes available.

C#: Resume()

JavaScript: resume()

This method is used to resume the normal display of an ad after a call to Suspend.

C#: Suspend()

JavaScript: suspend()

Suspends the current ad. Replaces the current view of the ad with a static snapshot of what was being rendered.

C#: Suspend(bool)

.NET only.

Suspends the current ad. Replaces the current view of the ad with a static snapshot of what was being rendered. This overloaded method allows the ad to be placed in a suspended state while canceling any expanded experience or without closing a full screen ad.

OnApplyTemplate

Reserved

AddAdTag

Reserved

RemoveAdTag

Reserved

Events

Events

Description

C#:AdRefreshed

JavaScript: onAdRefreshed

Raised when the AdControl receives a new ad.

C#:ErrorOccurred

JavaScript: onErrorOccurred

Raised when the AdControl encounters an error in operations.

C#: IsEngagedChanged

JavaScript: onEngagedChanged

Raised when the user clicks the ad.

JavaScript: onPointerDown

Raised when the user starts a click, point or touch action inside the AdControl.

JavaScript: onPointerUp

Raised when the user has stopped doing a click, point or touch action inside the AdControl.

Properties

Properties

Description

AdUnitId

Gets or sets the ad unit identifier for this AdControl instance.

ApplicationId

Gets the application identifier (app ID).

IsAutoRefreshEnabled

Enables or disables automatic rotation of ads.

IsEngaged

Gets a value that indicates whether the user is interacting with an ad.

IsSuspended

Gets a value that shows whether the AdControl is in a suspended state.

Latitude

Gets or sets the latitude.

Longitude

Gets or sets the longitude.

Support and Feedback

Get product support or report a bug in the advertising SDK by visiting the Windows Store Apps developer support page support page. For product support, under "App development" click the "Advertising SDK" link. To post a question in the support forum, scroll down to "Find answers online" and click "Ads-in-Apps for Windows 8 forum".

Send feedback about this documentation to adsfdbk@microsoft.com. There is no product support through this alias. Documentation feedback only.

Community Additions

ADD
Show:
© 2014 Microsoft