Release 4.0.0-preview1-00172
[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     public class Tag
27     {
28         internal Tag(IntPtr handle)
29         {
30             Name = InteropHelper.GetString(handle, Interop.Tag.GetName);
31             Id = InteropHelper.GetValue<int>(handle, Interop.Tag.GetId);
32         }
33
34         /// <summary>
35         /// Gets the ID of the tag.
36         /// </summary>
37         /// <value>The unique ID of the tag.</value>
38         public int Id { get; }
39
40         /// <summary>
41         /// Gets the name of the tag.
42         /// </summary>
43         /// <value>The name of the tag.</value>
44         public string Name { get; }
45
46         internal static Tag FromHandle(IntPtr handle) => new Tag(handle);
47
48         /// <summary>
49         /// Returns a string representation of the tag.
50         /// </summary>
51         /// <returns>A string representation of the current tag.</returns>
52         public override string ToString() => $"Id={Id}, Name={Name}";
53
54     }
55 }