AdControl 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表在應用程式中顯示橫幅廣告的控制項。
public ref class AdControl sealed : StackPanel, IClosableclass AdControl sealed : StackPanel, IClosable[Windows.Foundation.Metadata.Activatable(1)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.Foundation.Metadata.WebHostHidden]
public sealed class AdControl : StackPanel, System.IDisposablePublic NotInheritable Class AdControl
Inherits StackPanel
Implements IDisposable- 繼承
-
AdControl
- 屬性
- 實作
-
System.IDisposable
其他功能與需求
| 軟體開發套件 | |
| 支援 OS 的最低版本 |
Windows 10 (10.0.10240.0)
|
備註
如需示範如何使用此類型的逐步解說和程式碼範例，請參閱 GitHub 上的 XAML 和 .NET 中的 AdControl、 HTML 5 中的 AdControl 和 JavaScript 和 Advertising 範例。
建構函式
| AdControl() |
初始化 AdControl 類別的新實例。 |
屬性
| AdUnitId |
取得或設定這個 AdControl 物件的廣告單位識別碼。 此值可在合作夥伴中心取得。 |
| ApplicationId |
取得或設定這個 AdControl 物件的應用程式識別碼。 此值可在合作夥伴中心取得。 |
| AutoRefreshIntervalInSeconds |
取得或設定 AdControl 以秒為單位重新整理目前顯示的橫幅廣告的間隔。 |
| CountryOrRegion |
取得或設定使用者所在的兩個字母國家或地區代碼。 |
| HasAd |
取得值，指出 AdControl 目前是否正在提供橫幅廣告。 |
| IsAutoRefreshEnabled |
取得或設定值，這個值表示是否啟用橫幅廣告的自動輪替。 |
| IsEngaged |
取得值，指出使用者是否與橫幅廣告互動。 |
| IsSuspended |
取得值，這個值表示 AdControl 是否處於暫停狀態。 |
| Keywords |
取得或設定以廣告物件為目標的關鍵字。 |
| PostalCode |
取得或設定要設為橫幅廣告目標的郵遞區號。 |
方法
| AddAdTag(String, String) |
將廣告標籤新增至 AdControl。 |
| Close() |
釋放 控制項所使用的相關聯繫統資源。 |
| Dispose() |
執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 |
| Refresh() |
指示 AdControl 在新的廣告可用時顯示下一個廣告，如果停用自動重新整理。 目前呈現的廣告會維持不變，直到下一個廣告可供使用為止。 |
| RemoveAdTag(String) |
從 AdControl移除廣告標籤。 |
| Resume() |
在呼叫 Suspend之後繼續顯示橫幅廣告的正常顯示。 |
| Suspend() |
暫停目前的橫幅廣告，並將橫幅廣告的目前檢視取代為所呈現專案的靜態快照集。 |
事件
| AdRefreshed |
當 AdControl 收到新的橫幅廣告時引發。 |
| ErrorOccurred |
當 AdControl 遇到操作錯誤時引發。 |
| IsEngagedChanged |
當使用者按一下橫幅廣告，並與它互動，而不是應用程式時引發。 |
| OnManipulationStateChanged |
當 AdControl 收到橫幅廣告中的操作狀態變更事件時引發。 |
| OnMouseWheel |
當 AdControl 收到滑鼠滾輪事件時引發。 |
| OnPointerDown |
當使用者按一下、指向或觸碰橫幅廣告時引發。 |
| OnPointerMove |
移動指向裝置時引發。 |
| OnPointerUp |
當使用者停止按一下、指向或觸控橫幅廣告時引發。 |