CompositionTarget.Rendered 事件

定義

命名空間:

Windows.UI.Xaml.Media

會在核心轉譯程式轉譯框架之後立即發生。 此事件可讓您判斷每個畫面需要多久才能呈現。

// Register
static event_token Rendered(EventHandler<RenderedEventArgs> const& handler) const;

// Revoke with event_token
static void Rendered(event_token const* cookie) const;

// Revoke with event_revoker
static CompositionTarget::Rendered_revoker Rendered(auto_revoke_t, EventHandler<RenderedEventArgs> const& handler) const;

public static event System.EventHandler<RenderedEventArgs> Rendered;

function onRendered(eventArgs) { /* Your code */ }
Windows.UI.Xaml.Media.CompositionTarget.addEventListener("rendered", onRendered);
Windows.UI.Xaml.Media.CompositionTarget.removeEventListener("rendered", onRendered);
- or -
Windows.UI.Xaml.Media.CompositionTarget.onrendered = onRendered;

Public Shared Custom Event Rendered As EventHandler(Of RenderedEventArgs) 

事件類型

EventHandler<RenderedEventArgs>

EventHandler<RenderedEventArgs>

Windows 需求

裝置系列	Windows 10, version 1803 (已於 10.0.17134.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v6.0 引進)

備註

提示

建議您在開發和測試應用程式時，使用 Visual Studio 應用程式時間軸 分析工具。 它會提供應用程式資源耗用量的詳細資訊，包括準備 UI 畫面的時間。

您可以使用 Rendered 事件來測量執行時間的畫面持續時間和應用程式回應性，而不需 Visual Studio 或附加偵錯工具。 例如，這可用來在部署應用程式之後產生應用程式的遙測，或調整應用程式正在執行每個畫面的自訂 DirectX 轉譯工作量。

較長的框架持續時程表示您的應用程式必須在轉譯畫面之前執行更多工作。 畫面持續時間超過大約 16 毫秒，表示您的應用程式無法以每秒 60 個畫面的建議頻率進行更新，因此使用者可能會遇到 UI 回應性明顯延遲。

如果您看到長框架持續時間，請考慮使用 Visual Studio 應用程式時間軸分析您的應用程式，並實作建議的 效能最佳做法。

即使轉譯的處理常式未系結至任何特定 UI 元素，仍會在 UI 執行緒上執行。 當您不再需要任何轉譯處理常式時，最好移除任何轉譯處理常式，並只在您需要它們時才加以新增。