ContactPostActivatedEventArgs クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
連絡先を投稿するためにアプリがアクティブ化されたときにデータを提供します。
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, IContactPostActivatedEventArgsPublic NotInheritable Class ContactPostActivatedEventArgs
Implements IActivatedEventArgs, IContactPostActivatedEventArgs- 継承
- 属性
- 実装
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 Search エクスペリエンスから連絡先に投稿できます。 アクティブ化後の連絡先コントラクトを実装することで、Windows はアプリを起動してユーザーに投稿できます。
アクティブ化後に受信するには、アプリがマニフェストの "windows.contact" 拡張機能カテゴリに登録する必要があります。 この拡張機能の下には、"Verb" 属性が "post" と等しい "LaunchAction" 要素を含める必要があります。その後、"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 |
実行するアクションを取得します。 |