namespace Tizen.Applications.AttachPanel
{
+ /// <summary>
+ /// Represents immutable class for attach panel.
+ /// </summary>
public partial class AttachPanel
{
- private const string LogTag = "Tizen.Applications.AttachPanel";
-
- private static IntPtr _attachPanel;
-
- private static event EventHandler<StateEventArgs> _eventEventHandler;
- private static event EventHandler<ResultEventArgs> _resultEventHandler;
-
- private static Interop.AttachPanel.AttachPanelEventCallback SetEventListener;
- private static Interop.AttachPanel.AttachPanelResultCallback SetResultListener;
-
+ //private const string LogTag = "Tizen.Applications.AttachPanel";
+
+ /// <summary>
+ /// Represents immutable class for attach panel.
+ /// </summary>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="conformant">The caller's conformant</param>
+ /// <exception cref="OutOfMemoryException">Thrown when an attempt to allocate memory fails.</exception>
+ /// <exception cref="InvalidOperationException">Thrown when the AttachPanel is already exist or the <paramref name="conformant"/> is not a conformant object</exception>
public AttachPanel(IntPtr conformant)
{
+ if (conformant == IntPtr.Zero)
+ {
+ throw new ArgumentNullException("Use the value property, not null value");
+ }
_attachPanel = new IntPtr();
Interop.AttachPanel.ErrorCode err = Interop.AttachPanel.CreateAttachPanel(conformant, ref _attachPanel);
checkException(err);
}
}
+ /// <summary>
+ /// Gets the state of the AttachPanel.
+ /// </summary>
+ /// <value>The AttachPanel window state</value>
public int State
{
get
return state;
}
}
+
+ /// <summary>
+ /// Gets the value that indicates whether the AttachPanel is visible.
+ /// </summary>
+ /// <value>visible value of AttachPanel state</value>
public int Visible
{
get
}
}
+ /// <summary>
+ /// Add a content category in the AttachPanel.
+ /// </summary>
+ /// <param name="category">The ContentCategory to be added in the AttachPanel</param>
+ /// <param name="extraData">The AttachPanel send some information using Bundle</param>
+ /// <privilege>http://tizen.org/privilege/mediastorage</privilege>
+ /// <privilege>http://tizen.org/privilege/camera</privilege>
+ /// <privilege>http://tizen.org/privilege/recorder</privilege>
+ /// <privilege>http://tizen.org/privilege/appmanager.launch</privilege>
+ /// <remarks>
+ /// The caller app has to check the return value of this function.
+ /// Content categories will be shown as the sequence of using AddCategory
+ /// Some contents need time to load it all.
+ /// So, it is needed to use this before the mainloop of Show
+ /// Privileges,
+ /// http://tizen.org/privilege/mediastorage, for using Image or Camera
+ /// http://tizen.org/privilege/camera, for using Camera or TakePicture
+ /// http://tizen.org/privilege/recorder, for using Voice
+ /// http://tizen.org/privilege/appmanager.launch, for adding content categories on the More tab
+ /// Deliver more information to the callee with a bundle if you need.
+ /// http://tizen.org/appcontrol/data/total_count
+ /// http://tizen.org/appcontrol/data/total_size
+ /// </remarks>
+ /// <exception cref="ArgumentOutOfRangeException">Thrown when the <paramref name="category"/> is not a valid category</exception>
+ /// <exception cref="UnauthorizedAccessException">Thrown when application does not have privilege to access this method</exception>
+ /// <exception cref="NotSupportedException">Thrown when the device does not supported the <paramref name="category"/> feature </exception>
+ /// <exception cref="InvalidOperationException">Thrown when the AttachPanel is not created yet or already destroyed</exception>
public void AddCategory(ContentCategory category, Bundle extraData)
{
IntPtr bundle = IntPtr.Zero;
checkException(err);
}
+ /// <summary>
+ /// Removes the ContentCategory from the AttachPanel
+ /// </summary>
+ /// <param name="category">The ContentCategory adding in the AttachPanel</param>
+ /// <exception cref="ArgumentOutOfRangeException">Thrown when the <paramref name="category"/> is not a valid category</exception>
+ /// <exception cref="InvalidOperationException">Thrown when the AttachPanel is not created yet or already destroyed</exception>
public void RemoveCategory(ContentCategory category)
{
Interop.AttachPanel.ErrorCode err = Interop.AttachPanel.RemoveCategory(_attachPanel, (int)category);
checkException(err);
}
+ /// <summary>
+ /// Sets extraData to send to the ContentCategory using a Bundle
+ /// </summary>
+ /// <param name="category">The ContentCategory that some information to be set in the AttachPanel.</param>
+ /// <param name="extraData">The AttachPanel send some information using Bundle</param>
+ /// <exception cref="ArgumentOutOfRangeException">Thrown when the <paramref name="category"/> is not a valid category</exception>
+ /// <exception cref="InvalidOperationException">Thrown when the AttachPanel is destroyed</exception>
+ /// <exception cref="OutOfMemoryException">Thrown when an attempt to allocate memory fails.</exception>
public void SetExtraData(ContentCategory category, Bundle extraData)
{
IntPtr bundle = IntPtr.Zero;
checkException(err);
}
+ /// <summary>
+ /// Shows the attach panel with animations
+ /// </summary>
+ /// <exception cref="InvalidOperationException">Thrown when the AttachPanel is destroyed</exception>
public void Show()
{
Interop.AttachPanel.ErrorCode err = Interop.AttachPanel.Show(_attachPanel);
checkException(err);
}
+ /// <summary>
+ /// Shows the attach panel and selects whether or not to animate
+ /// </summary>
+ /// <exception cref="InvalidOperationException">Thrown when the AttachPanel is destroyed</exception>
public void Show(bool animation)
{
if (animation)
}
}
+ /// <summary>
+ /// Hides the attach panel with animations
+ /// </summary>
+ /// <exception cref="InvalidOperationException">Thrown when the AttachPanel is destroyed</exception>
public void Hide()
{
Interop.AttachPanel.ErrorCode err = Interop.AttachPanel.Hide(_attachPanel);
checkException(err);
}
+ /// <summary>
+ /// Hides the attach panel and selects whether or not to animate
+ /// </summary>
+ /// <exception cref="InvalidOperationException">Thrown when the AttachPanel is destroyed</exception>
public void Hide(bool animation)
{
if (animation)
}
}
+ /// <summary>
+ /// Occurs when reserved events are published from the panel-side.
+ /// </summary>
public event EventHandler<StateEventArgs> EventChanged
{
add
}
}
+ /// <summary>
+ /// Occurs when an user selects and confirms something to attach in the AttachPanel
+ /// </summary>
public event EventHandler<ResultEventArgs> ResultCallback
{
add
{
public partial class AttachPanel
{
+ private static IntPtr _attachPanel;
+
+ private static event EventHandler<StateEventArgs> _eventEventHandler;
+ private static event EventHandler<ResultEventArgs> _resultEventHandler;
+
+ private static Interop.AttachPanel.AttachPanelEventCallback SetEventListener;
+ private static Interop.AttachPanel.AttachPanelResultCallback SetResultListener;
+
private void StateEventListenStart()
{
Interop.AttachPanel.ErrorCode err = 0;
switch (err)
{
case Interop.AttachPanel.ErrorCode.InvalidParameter:
- throw new InvalidOperationException("Invalid parameter error at unmanaged code");
+ throw new ArgumentOutOfRangeException("Invalid parameter error at unmanaged code");
case Interop.AttachPanel.ErrorCode.OutOfMemory:
- throw new InvalidOperationException("Out of Memory");
+ throw new OutOfMemoryException("Out of Memory");
case Interop.AttachPanel.ErrorCode.PermissionDenied:
throw new UnauthorizedAccessException();
case Interop.AttachPanel.ErrorCode.AlreadyExists:
case Interop.AttachPanel.ErrorCode.NotInitialized:
throw new InvalidOperationException("Not initialized");
case Interop.AttachPanel.ErrorCode.UnsupportedContentCategory:
- throw new InvalidOperationException("Unsupported Content Category");
+ throw new NotSupportedException("Unsupported Content Category");
case Interop.AttachPanel.ErrorCode.AlreadyDestroyed:
throw new InvalidOperationException("Already Destroyed");
}
projects / platform / core / csapi / attach-panel.git / commitdiff