WebUIContactPostActivatedEventArgs 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在啟動應用程式以張貼連絡人時提供資料。
public ref class WebUIContactPostActivatedEventArgs sealed : IActivatedEventArgs, IContactPostActivatedEventArgs, IActivatedEventArgsDeferral
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIContactPostActivatedEventArgs final : IActivatedEventArgs, IContactPostActivatedEventArgs, IActivatedEventArgsDeferral
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIContactPostActivatedEventArgs : IActivatedEventArgs, IContactPostActivatedEventArgs, IActivatedEventArgsDeferral
Public NotInheritable Class WebUIContactPostActivatedEventArgs
Implements IActivatedEventArgs, IActivatedEventArgsDeferral, IContactPostActivatedEventArgs
- 繼承
- 屬性
- 實作
Windows 需求
裝置系列 |
Windows Desktop Extension SDK (已於 10.0.10240.0 引進)
|
API contract |
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (已於 v1.0 引進)
|
範例
JavaScript
function activated(eventObject) {
if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.contact) {
if (eventObject.detail.verb === Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.post) {
//get contact display info
var contactName = eventObject.detail.contact.displayName;
var contactThumbnail = eventObject.detail.contact.thumbnail;
if (eventObject.detail.serviceId === "facebook.com") {
var userId = eventObject.detail.serviceUserId;
//add posting logic for Facebook Ids
}
}
}
}
備註
當您在ContactActivationKind時實作WinJS.Application.Onactivated或Windows.UI.WebUI.WebUIApplication.activated事件的事件處理常式時,就會存取此物件。
注意
這個類別不是敏捷的,這表示您必須考慮其執行緒模型和封送處理行為。 如需詳細資訊,請參閱 執行緒和封送處理 (C++/CX) 。
Windows 8.1可讓使用者從連絡人卡片或 Windows 搜尋體驗張貼到其連絡人。 藉由實作連絡人啟用後合約,Windows 可以啟動您的應用程式來張貼給使用者。
若要接收啟用後,您的應用程式必須在其資訊清單中註冊 「windows.contact」 擴充功能類別。 在此延伸底下,您必須包含 「LaunchAction」 元素,其中 「Verb」 屬性等於 「post」。然後,您可以指定 「ServiceId」 元素,以指定應用程式可以張貼的服務功能變數名稱,例如 「facebook.com」。
如果有多個應用程式已註冊此合約,使用者可以選擇其中一個應用程式作為處理張貼的預設值。
以下是資訊清單註冊的範例:
<m2:Extension Category="windows.contact" xmlns:m2="http://schemas.microsoft.com/appx/2013/manifest">
<m2:Contact>
<m2:ContactLaunchActions>
<m2:LaunchAction Verb="post" DesiredView="useLess">
<m2:ServiceId>facebook.com</m2:ServiceId>
</m2:LaunchAction>
</m2:ContactLaunchActions>
</m2:Contact>
</m2:Extension>
在資訊清單中註冊之後,即可針對連絡人張貼合約啟用您的應用程式。 當您的應用程式啟用時,您可以使用事件資訊來識別啟用後,並擷取參數,以協助您完成使用者的張貼案例。
以下是您需要處理 Facebook Id 啟用後連絡程式碼的範例:
屬性
ActivatedOperation |
取得應用程式啟動的作業。 |
Contact |
取得貼文的連絡人。 |
Kind |
取得啟用類型。 |
PreviousExecutionState |
取得應用程式啟動前的執行狀態。 |
ServiceId |
取得用於張貼之服務的識別碼。 |
ServiceUserId |
取得用於張貼之服務的使用者識別碼。 |
SplashScreen |
取得啟動顯示畫面物件,該物件提供從啟動顯示畫面轉換到啟動應用程式的相關資訊。 |
Verb |
取得要執行的動作。 |