csharp: updating eldbus_pending docs and hide api.

Summary: ref T8361

Reviewers: lauromoura, felipealmeida, segfaultxavi, woohyun

Reviewed By: lauromoura

Subscribers: cedric, #reviewers, #committers

Tags: #efl

Maniphest Tasks: T8361

Differential Revision: https://phab.enlightenment.org/D10427
This commit is contained in:
Bruno da Silva Belo 2019-10-17 15:25:17 -03:00 committed by Lauro Moura
parent 351b9650df
commit 62a773c17e
1 changed files with 39 additions and 2 deletions

View File

@ -2,12 +2,14 @@
using System;
using System.Runtime.InteropServices;
using System.ComponentModel;
using static eldbus.EldbusPendingNativeFunctions;
namespace eldbus
{
[EditorBrowsable(EditorBrowsableState.Never)]
public static class EldbusPendingNativeFunctions
{
[DllImport(efl.Libs.Eldbus)] public static extern void
@ -42,12 +44,15 @@ public static class EldbusPendingNativeFunctions
}
/// <summary>Represents a DBus pending.
///
/// Since EFL 1.23.
/// <para>Since EFL 1.23.</para>
/// </summary>
public class Pending
{
[EditorBrowsable(EditorBrowsableState.Never)]
public IntPtr Handle {get;set;} = IntPtr.Zero;
/// <summary>Whether this managed list owns the native one.
/// <para>Since EFL 1.23.</para>
/// </summary>
public bool Own {get;set;} = true;
private void InitNew(IntPtr handle, bool own)
@ -65,11 +70,17 @@ public class Pending
}
}
[EditorBrowsable(EditorBrowsableState.Never)]
public Pending(IntPtr handle, bool own)
{
InitNew(handle, own);
}
/// <summary>
/// Releases the native handler.
/// <para>Since EFL 1.23.</para>
/// </summary>
/// <returns>The native handler.</returns>
public IntPtr Release()
{
IntPtr h = Handle;
@ -77,12 +88,22 @@ public class Pending
return h;
}
/// <summary>
/// Cancel the pending message.
/// <para>Since EFL 1.23.</para>
/// </summary>
public void Cancel()
{
CheckHandle();
eldbus_pending_cancel(Handle);
}
/// <summary>
/// Get the destination of the pending message.
/// <para>Since EFL 1.23.</para>
/// </summary>
/// <returns>A string corresponding to the destination of the
/// message</returns>
public string GetDestination()
{
CheckHandle();
@ -90,6 +111,11 @@ public class Pending
return Eina.StringConversion.NativeUtf8ToManagedString(ptr);
}
/// <summary>
/// Get the path of the pending message.
/// <para>Since EFL 1.23.</para>
/// </summary>
/// <returns>A string corresponding to the path of the message.</returns>
public string GetPath()
{
CheckHandle();
@ -97,6 +123,12 @@ public class Pending
return Eina.StringConversion.NativeUtf8ToManagedString(ptr);
}
/// <summary>
/// Get the interface of the pending message.
/// <para>Since EFL 1.23.</para>
/// </summary>
/// <returns>A string corresponding to the interface of the
/// message.</returns>
public string GetInterface()
{
CheckHandle();
@ -104,6 +136,11 @@ public class Pending
return Eina.StringConversion.NativeUtf8ToManagedString(ptr);
}
/// <summary>
/// Get the method of the pending message.
/// <para>Since EFL 1.23.</para>
/// </summary>
/// <returns>A string corresponding to the method of the message.</returns>
public string GetMethod()
{
CheckHandle();