[MediaContent] Deprecate meaningless media group enum (#5939)
[platform/core/csapi/tizenfx.git] / src / Tizen.Content.MediaContent / Tizen.Content.MediaContent / Tag.cs
1 /*
2  * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved
3  *
4  * Licensed under the Apache License, Version 2.0 (the License);
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an AS IS BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 using System;
18
19 namespace Tizen.Content.MediaContent
20 {
21     /// <summary>
22     /// Represents a special piece of information that may be associated with media.
23     /// Tagging allows a user to organize large number of items into logical groups providing
24     /// a simplified and faster way of accessing media items.
25     /// </summary>
26     /// <since_tizen> 3 </since_tizen>
27     [Obsolete("Deprecated since API12. Will be removed in API14.")]
28     public class Tag
29     {
30         internal Tag(IntPtr handle)
31         {
32             Name = InteropHelper.GetString(handle, Interop.Tag.GetName);
33             Id = InteropHelper.GetValue<int>(handle, Interop.Tag.GetId);
34         }
35
36         /// <summary>
37         /// Gets the ID of the tag.
38         /// </summary>
39         /// <value>The unique ID of the tag.</value>
40         /// <since_tizen> 3 </since_tizen>
41         [Obsolete("Deprecated since API12. Will be removed in API14.")]
42         public int Id { get; }
43
44         /// <summary>
45         /// Gets the name of the tag.
46         /// </summary>
47         /// <value>The name of the tag.</value>
48         /// <since_tizen> 3 </since_tizen>
49         [Obsolete("Deprecated since API12. Will be removed in API14.")]
50         public string Name { get; }
51
52         internal static Tag FromHandle(IntPtr handle) => new Tag(handle);
53
54         /// <summary>
55         /// Returns a string representation of the tag.
56         /// </summary>
57         /// <returns>A string representation of the current tag.</returns>
58         /// <since_tizen> 4 </since_tizen>
59         [Obsolete("Deprecated since API12. Will be removed in API14.")]
60         public override string ToString() => $"Id={Id}, Name={Name}";
61
62     }
63 }