1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Windows.ApplicationModel.Activation;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
#if WINDOWS_PHONE_APP
/// <summary>
/// ContinuationManager is used to detect if the most recent activation was due
/// to a continuation such as the FileOpenPicker or WebAuthenticationBroker
/// </summary>
public class ContinuationManager
{
IContinuationActivatedEventArgs args = null;
bool handled = false;
Guid id = Guid.Empty;
/// <summary>
/// Sets the ContinuationArgs for this instance. Using default Frame of current Window
/// Should be called by the main activation handling code in App.xaml.cs
/// </summary>
/// <param name="args">The activation args</param>
internal void Continue(IContinuationActivatedEventArgs args)
{
Continue(args, Window.Current.Content as Frame);
}
/// <summary>
/// Sets the ContinuationArgs for this instance. Should be called by the main activation
/// handling code in App.xaml.cs
/// </summary>
/// <param name="args">The activation args</param>
/// <param name="rootFrame">The frame control that contains the current page</param>
internal void Continue(IContinuationActivatedEventArgs args, Frame rootFrame)
{
if (args == null)
throw new ArgumentNullException("args");
if (this.args != null && !handled)
throw new InvalidOperationException("Can't set args more than once");
this.args = args;
this.handled = false;
this.id = Guid.NewGuid();
if (rootFrame == null)
return;
switch (args.Kind)
{
case ActivationKind.PickFileContinuation:
var fileOpenPickerPage = rootFrame.Content as IFileOpenPickerContinuable;
if (fileOpenPickerPage != null)
{
fileOpenPickerPage.ContinueFileOpenPicker(args as FileOpenPickerContinuationEventArgs);
}
break;
case ActivationKind.PickSaveFileContinuation:
var fileSavePickerPage = rootFrame.Content as IFileSavePickerContinuable;
if (fileSavePickerPage != null)
{
fileSavePickerPage.ContinueFileSavePicker(args as FileSavePickerContinuationEventArgs);
}
break;
case ActivationKind.PickFolderContinuation:
var folderPickerPage = rootFrame.Content as IFolderPickerContinuable;
if (folderPickerPage != null)
{
folderPickerPage.ContinueFolderPicker(args as FolderPickerContinuationEventArgs);
}
break;
case ActivationKind.WebAuthenticationBrokerContinuation:
var wabPage = rootFrame.Content as IWebAuthenticationContinuable;
if (wabPage != null)
{
wabPage.ContinueWebAuthentication(args as WebAuthenticationBrokerContinuationEventArgs);
}
break;
}
}
/// <summary>
/// Marks the contination data as 'stale', meaning that it is probably no longer of
/// any use. Called when the app is suspended (to ensure future activations don't appear
/// to be for the same continuation) and whenever the continuation data is retrieved
/// (so that it isn't retrieved on subsequent navigations)
/// </summary>
internal void MarkAsStale()
{
this.handled = true;
}
/// <summary>
/// Retrieves the continuation args, if they have not already been retrieved, and
/// prevents further retrieval via this property (to avoid accidentla double-usage)
/// </summary>
public IContinuationActivatedEventArgs ContinuationArgs
{
get
{
if (handled)
return null;
MarkAsStale();
return args;
}
}
/// <summary>
/// Unique identifier for this particular continuation. Most useful for components that
/// retrieve the continuation data via <see cref="GetContinuationArgs"/> and need
/// to perform their own replay check
/// </summary>
public Guid Id { get { return id; } }
/// <summary>
/// Retrieves the continuation args, optionally retrieving them even if they have already
/// been retrieved
/// </summary>
/// <param name="includeStaleArgs">Set to true to return args even if they have previously been returned</param>
/// <returns>The continuation args, or null if there aren't any</returns>
public IContinuationActivatedEventArgs GetContinuationArgs(bool includeStaleArgs)
{
if (!includeStaleArgs && handled)
return null;
MarkAsStale();
return args;
}
}
/// <summary>
/// Implement this interface if your page invokes the file open picker
/// API.
/// </summary>
interface IFileOpenPickerContinuable
{
/// <summary>
/// This method is invoked when the file open picker returns picked
/// files
/// </summary>
/// <param name="args">Activated event args object that contains returned files from file open picker</param>
void ContinueFileOpenPicker(FileOpenPickerContinuationEventArgs args);
}
/// <summary>
/// Implement this interface if your page invokes the file save picker
/// API
/// </summary>
interface IFileSavePickerContinuable
{
/// <summary>
/// This method is invoked when the file save picker returns saved
/// files
/// </summary>
/// <param name="args">Activated event args object that contains returned file from file save picker</param>
void ContinueFileSavePicker(FileSavePickerContinuationEventArgs args);
}
/// <summary>
/// Implement this interface if your page invokes the folder picker API
/// </summary>
interface IFolderPickerContinuable
{
/// <summary>
/// This method is invoked when the folder picker returns the picked
/// folder
/// </summary>
/// <param name="args">Activated event args object that contains returned folder from folder picker</param>
void ContinueFolderPicker(FolderPickerContinuationEventArgs args);
}
/// <summary>
/// Implement this interface if your page invokes the web authentication
/// broker
/// </summary>
interface IWebAuthenticationContinuable
{
/// <summary>
/// This method is invoked when the web authentication broker returns
/// with the authentication result
/// </summary>
/// <param name="args">Activated event args object that contains returned authentication token</param>
void ContinueWebAuthentication(WebAuthenticationBrokerContinuationEventArgs args);
}
#endif