ContactPostActivatedEventArgs 類別

定義

在啟動應用程式以張貼連絡人時提供資料。

JAVAscript 此類型會顯示為 WebUIContactPostActivatedEventArgs

public ref class ContactPostActivatedEventArgs sealed : IActivatedEventArgs, IContactPostActivatedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ContactPostActivatedEventArgs final : IActivatedEventArgs, IContactPostActivatedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ContactPostActivatedEventArgs : IActivatedEventArgs, IContactPostActivatedEventArgs
Public NotInheritable Class ContactPostActivatedEventArgs
Implements IActivatedEventArgs, IContactPostActivatedEventArgs
繼承
Object Platform::Object IInspectable ContactPostActivatedEventArgs
屬性
實作

Windows 需求

裝置系列
Windows Desktop Extension SDK (已於 10.0.10240.0 引進)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (已於 v1.0 引進)

範例

以下是您需要處理 Facebook Id 啟用後連絡程式碼的範例。

protected override void OnActivated(IActivatedEventArgs args)
{
    if (args.Kind == ActivationKind.Contact)
    {
        var contactArgs = args as IContactActivatedEventArgs;
        if (contactArgs.Verb == Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.Post)
        {
            IContactPostActivatedEventArgs postArgs = contactArgs as IContactPostActivatedEventArgs;

            //get contact display info
            var contactName = postArgs.Contact.DisplayName;
            var contactThumbnail = postArgs.Contact.Thumbnail;

            if (postArgs.ServiceId == "facebook.com")
            {
                var userId = postArgs.ServiceUserId;
                //add posting logic for Facebook Ids
            }
        }
    }
}
void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs const& args)
{
    if (args.Kind() == Windows::ApplicationModel::Activation::ActivationKind::Contact)
    {
        auto contactArgs{ args.as<Windows::ApplicationModel::Activation::IContactActivatedEventArgs>() };
        if (contactArgs.Verb() == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::Post())
        {
            auto postArgs{ contactArgs.as<Windows::ApplicationModel::Activation::ContactPostActivatedEventArgs>() };

            // Get contact display info.
            auto contactName{ postArgs.Contact().DisplayName() };
            auto contactThumbnail{ postArgs.Contact().Thumbnail() };

            if (postArgs.ServiceId() == L"facebook.com")
            {
                auto userId = postArgs.ServiceUserId();
                //add messaging logic for Skype Ids
            }
        }
    }
}
void App::OnActivated(IActivatedEventArgs^ args)
{
    if (args->Kind == ActivationKind::Contact)
    {
        auto contactArgs = dynamic_cast<IContactActivatedEventArgs^>(args);
        if (contactArgs->Verb == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::Post)
        {
            auto postArgs = dynamic_cast<ContactPostActivatedEventArgs^>(contactArgs);

            //get contact display info
            auto contactName = postArgs->Contact->DisplayName;
            auto contactThumbnail = postArgs->Contact->Thumbnail;

            if (postArgs->ServiceId == "facebook.com")
            {
                auto userId = postArgs->ServiceUserId;
                //add posting logic for Facebook Ids
            }
        }
    }
}

備註

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>

在資訊清單中註冊之後,即可針對連絡人張貼合約啟用您的應用程式。 當您的應用程式啟用時,您可以使用事件資訊來識別啟用後,並擷取參數,以協助您完成使用者的張貼案例。

屬性

Contact

取得貼文的連絡人。

Kind

取得啟用類型。

PreviousExecutionState

取得應用程式啟動前的執行狀態。

ServiceId

取得用於張貼之服務的識別碼。

ServiceUserId

取得用於張貼之服務的使用者識別碼。

SplashScreen

取得啟動顯示畫面物件,該物件提供從啟動顯示畫面轉換到啟動應用程式的相關資訊。

Verb

取得要執行的動作。

適用於

另請參閱