## TestTweak TestTweak — Tweak interface used for testing |

## Synopsis

    #define             TEST_QUERY_INTERFACE_TWEAK          (object_proxy)
                        TestTweak;
    guint               test_tweak_override_properties      (GObjectClass *klass,
                                                             guint property_id_begin);
    gchar *             test_tweak_get_foo                  (TestTweak *instance);
    EggDBusArraySeq *   test_tweak_get_bar                  (TestTweak *instance);
    TestPoint *         test_tweak_get_baz                  (TestTweak *instance);
    TestPair *          test_tweak_get_baz_forced_to_use_pair
                                                            (TestTweak *instance);
    gchar *             test_tweak_get_some_read_write_property
                                                            (TestTweak *instance);
    TestSomeExampleCType  test_tweak_get_property_with_ctype
                                                            (TestTweak *instance);
    TestVehicle         test_tweak_get_escape_vehicle       (TestTweak *instance);
    TestCreateFlags     test_tweak_get_default_create_flags (TestTweak *instance);
    void                test_tweak_set_some_read_write_property
                                                            (TestTweak *instance,
                                                             const gchar *value);
    void                test_tweak_set_property_with_ctype  (TestTweak *instance,
                                                             TestSomeExampleCType value);
    void                test_tweak_set_escape_vehicle       (TestTweak *instance,
                                                             TestVehicle value);
    void                test_tweak_set_default_create_flags (TestTweak *instance,
                                                             TestCreateFlags value);
    gboolean            test_tweak_block_until_rw_property_changes_sync
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             gchar **out_new_prop_value,
                                                             GCancellable *cancellable,
                                                             GError **error);
    gboolean            test_tweak_change_readable_property_sync
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *new_value,
                                                             GCancellable *cancellable,
                                                             GError **error);
    gboolean            test_tweak_i_can_haz_greetingz_sync (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *greetz,
                                                             gchar **out_word,
                                                             GCancellable *cancellable,
                                                             GError **error);
    gboolean            test_tweak_broadcastz_newz_sync     (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *newz,
                                                             GCancellable *cancellable,
                                                             GError **error);
    gboolean            test_tweak_get_server_unique_name_sync
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             gchar **out_server_unique_name,
                                                             GCancellable *cancellable,
                                                             GError **error);
    gboolean            test_tweak_long_running_method_sync (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             gint msec_to_run,
                                                             GCancellable *cancellable,
                                                             GError **error);
    gboolean            test_tweak_return_gerror_sync       (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *error_domain,
                                                             gint error_code,
                                                             GCancellable *cancellable,
                                                             GError **error);
    gboolean            test_tweak_method_struct_disambiguation_sync
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             TestPair *pair,
                                                             TestPoint *point,
                                                             TestPoint **out_enhanced_point,
                                                             TestPair **out_enhanced_pair,
                                                             GCancellable *cancellable,
                                                             GError **error);
    gboolean            test_tweak_method_with_ctypes_sync  (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             TestSomeExampleCType value,
                                                             TestSomeExampleCType *out_better_value,
                                                             GCancellable *cancellable,
                                                             GError **error);
    guint               test_tweak_block_until_rw_property_changes
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    gboolean            test_tweak_block_until_rw_property_changes_finish
                                                            (TestTweak *instance,
                                                             gchar **out_new_prop_value,
                                                             GAsyncResult *res,
                                                             GError **error);
    guint               test_tweak_change_readable_property (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *new_value,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    gboolean            test_tweak_change_readable_property_finish
                                                            (TestTweak *instance,
                                                             GAsyncResult *res,
                                                             GError **error);
    guint               test_tweak_i_can_haz_greetingz      (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *greetz,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    gboolean            test_tweak_i_can_haz_greetingz_finish
                                                            (TestTweak *instance,
                                                             gchar **out_word,
                                                             GAsyncResult *res,
                                                             GError **error);
    guint               test_tweak_broadcastz_newz          (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *newz,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    gboolean            test_tweak_broadcastz_newz_finish   (TestTweak *instance,
                                                             GAsyncResult *res,
                                                             GError **error);
    guint               test_tweak_get_server_unique_name   (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    gboolean            test_tweak_get_server_unique_name_finish
                                                            (TestTweak *instance,
                                                             gchar **out_server_unique_name,
                                                             GAsyncResult *res,
                                                             GError **error);
    guint               test_tweak_long_running_method      (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             gint msec_to_run,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    gboolean            test_tweak_long_running_method_finish
                                                            (TestTweak *instance,
                                                             GAsyncResult *res,
                                                             GError **error);
    guint               test_tweak_return_gerror            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *error_domain,
                                                             gint error_code,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    gboolean            test_tweak_return_gerror_finish     (TestTweak *instance,
                                                             GAsyncResult *res,
                                                             GError **error);
    guint               test_tweak_method_struct_disambiguation
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             TestPair *pair,
                                                             TestPoint *point,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    gboolean            test_tweak_method_struct_disambiguation_finish
                                                            (TestTweak *instance,
                                                             TestPoint **out_enhanced_point,
                                                             TestPair **out_enhanced_pair,
                                                             GAsyncResult *res,
                                                             GError **error);
    guint               test_tweak_method_with_ctypes       (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             TestSomeExampleCType value,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    gboolean            test_tweak_method_with_ctypes_finish
                                                            (TestTweak *instance,
                                                             TestSomeExampleCType *out_better_value,
                                                             GAsyncResult *res,
                                                             GError **error);
    void                test_tweak_handle_block_until_rw_property_changes_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             const gchar *out_new_prop_value);
    void                test_tweak_handle_change_readable_property_finish
                                                            (EggDBusMethodInvocation *method_invocation);
    void                test_tweak_handle_i_can_haz_greetingz_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             const gchar *out_word);
    void                test_tweak_handle_broadcastz_newz_finish
                                                            (EggDBusMethodInvocation *method_invocation);
    void                test_tweak_handle_get_server_unique_name_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             const gchar *out_server_unique_name);
    void                test_tweak_handle_long_running_method_finish
                                                            (EggDBusMethodInvocation *method_invocation);
    void                test_tweak_handle_return_gerror_finish
                                                            (EggDBusMethodInvocation *method_invocation);
    void                test_tweak_handle_method_struct_disambiguation_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             TestPoint *out_enhanced_point,
                                                             TestPair *out_enhanced_pair);
    void                test_tweak_handle_method_with_ctypes_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             TestSomeExampleCType out_better_value);
    void                test_tweak_emit_signal_newz_notifz  (TestTweak *instance,
                                                             const gchar *destination,
                                                             const gchar *newz);
    void                test_tweak_emit_signal_signal_struct_disambiguation
                                                            (TestTweak *instance,
                                                             const gchar *destination,
                                                             TestPair *pair,
                                                             TestPoint *point);
    void                test_tweak_emit_signal_signal_with_ctype
                                                            (TestTweak *instance,
                                                             const gchar *destination,
                                                             TestSomeExampleCType better_value);
    void                test_tweak_emit_signal_escape_vehicle_changed
                                                            (TestTweak *instance,
                                                             const gchar *destination,
                                                             TestVehicle new_escape_vehicle);

## Object Hierarchy

      GInterface
       +----TestTweak

## Prerequisites

TestTweak requires GObject.

## Known Implementations

TestTweak is implemented by TestTweakImpl.

## Properties

      "bar"                      EggDBusArraySeq*      : Read
      "baz"                      TestPoint*            : Read
      "baz-forced-to-use-pair"   TestPair*             : Read
      "default-create-flags"     TestCreateFlags       : Read / Write
      "escape-vehicle"           TestVehicle           : Read / Write
      "foo"                      gchar*                : Read
      "property-with-ctype"      gint                  : Read / Write
      "some-read-write-property" gchar*                : Read / Write

## Signals

      "escape-vehicle-changed"                         : Run Last
      "newz-notifz"                                    : Run Last
      "signal-struct-disambiguation"                   : Run Last
      "signal-with-ctype"                              : Run Last

## Description

The Tweak interface wraps the D-Bus interface `com.example.Tweak`. It is used in the EggDBus test suite.

## Details

### TEST_QUERY_INTERFACE_TWEAK()

    #define TEST_QUERY_INTERFACE_TWEAK(object_proxy) (TEST_TWEAK (egg_dbus_object_proxy_query_interface (object_proxy, TEST_TYPE_TWEAK)))

Convenience macro to get an interface proxy for the remote object represented by `object_proxy`. See `egg_dbus_object_proxy_query_interface()` for details.

`object_proxy` : | A EggDBusObjectProxy.
Returns : | An instance derived from EggDBusInterfaceProxy that implements the TestTweak interface. This instance can be used to access the com.example.Tweak D-Bus interface on the remote object represented by `object_proxy`. Do not ref or unref the returned instance, it is owned by `object_proxy`.

### TestTweak

    typedef struct _TestTweak TestTweak;

### test_tweak_override_properties ()

    guint               test_tweak_override_properties      (GObjectClass *klass,
                                                             guint property_id_begin);

Convenience function to override properties for a GObject derived class implementing TestTweak.

Typical usage of this function is:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    enum
      {
        PROP_0
        PROP_SOME_UNRELATED_PROPERTY,
        PROP_ANOTHER_UNRELATED_PROPERTY,
        ...

        /* Properties from the TestTweak interface */
        PROP_TEST_TWEAK_FOO,
        PROP_TEST_TWEAK_BAR,
        PROP_TEST_TWEAK_BAZ,
        PROP_TEST_TWEAK_BAZ_FORCED_TO_USE_PAIR,
        PROP_TEST_TWEAK_SOME_READ_WRITE_PROPERTY,
        PROP_TEST_TWEAK_PROPERTY_WITH_CTYPE,
        PROP_TEST_TWEAK_ESCAPE_VEHICLE,
        PROP_TEST_TWEAK_DEFAULT_CREATE_FLAGS,

        ...
      };

and then in the ``class_init()`` function:

    1
    g_assert (test_tweak_override_properties (gobject_class, PROP_TEST_TWEAK_FOO) == PROP_TEST_TWEAK_DEFAULT_CREATE_FLAGS);

`klass` : | The class structure for a class deriving from GObject and implementing TestTweak.
`property_id_begin` : | Property ID of first property to override.
Returns : | Property ID of the last overridden property.

### test_tweak_get_foo ()

    gchar *             test_tweak_get_foo                  (TestTweak *instance);

C getter for the "foo" property.

`instance` : | A TestTweak.
Returns : | The value of the "foo" property.

### test_tweak_get_bar ()

    EggDBusArraySeq *   test_tweak_get_bar                  (TestTweak *instance);

C getter for the "bar" property.

`instance` : | A TestTweak.
Returns : | The value of the "bar" property.

### test_tweak_get_baz ()

    TestPoint *         test_tweak_get_baz                  (TestTweak *instance);

C getter for the "baz" property.

`instance` : | A TestTweak.
Returns : | The value of the "baz" property.

### test_tweak_get_baz_forced_to_use_pair ()

    TestPair *          test_tweak_get_baz_forced_to_use_pair
                                                            (TestTweak *instance);

C getter for the "baz-forced-to-use-pair" property.

`instance` : | A TestTweak.
Returns : | The value of the "baz-forced-to-use-pair" property.

### test_tweak_get_some_read_write_property ()

    gchar *             test_tweak_get_some_read_write_property
                                                            (TestTweak *instance);

C getter for the "some-read-write-property" property.

`instance` : | A TestTweak.
Returns : | The value of the "some-read-write-property" property.

### test_tweak_get_property_with_ctype ()

    TestSomeExampleCType  test_tweak_get_property_with_ctype
                                                            (TestTweak *instance);

C getter for the "property-with-ctype" property.

`instance` : | A TestTweak.
Returns : | The value of the "property-with-ctype" property.

### test_tweak_get_escape_vehicle ()

    TestVehicle         test_tweak_get_escape_vehicle       (TestTweak *instance);

C getter for the "escape-vehicle" property.

`instance` : | A TestTweak.
Returns : | The value of the "escape-vehicle" property.

### test_tweak_get_default_create_flags ()

    TestCreateFlags     test_tweak_get_default_create_flags (TestTweak *instance);

C getter for the "default-create-flags" property.

`instance` : | A TestTweak.
Returns : | The value of the "default-create-flags" property.

### test_tweak_set_some_read_write_property ()

    void                test_tweak_set_some_read_write_property
                                                            (TestTweak *instance,
                                                             const gchar *value);

C setter for the "some-read-write-property" property.

`instance` : | A TestTweak.
`value` : | New value for the "some-read-write-property" property.

### test_tweak_set_property_with_ctype ()

    void                test_tweak_set_property_with_ctype  (TestTweak *instance,
                                                             TestSomeExampleCType value);

C setter for the "property-with-ctype" property.

`instance` : | A TestTweak.
`value` : | New value for the "property-with-ctype" property.

### test_tweak_set_escape_vehicle ()

    void                test_tweak_set_escape_vehicle       (TestTweak *instance,
                                                             TestVehicle value);

C setter for the "escape-vehicle" property.

`instance` : | A TestTweak.
`value` : | New value for the "escape-vehicle" property.

### test_tweak_set_default_create_flags ()

    void                test_tweak_set_default_create_flags (TestTweak *instance,
                                                             TestCreateFlags value);

C setter for the "default-create-flags" property.

`instance` : | A TestTweak.
`value` : | New value for the "default-create-flags" property.

### test_tweak_block_until_rw_property_changes_sync ()

    gboolean            test_tweak_block_until_rw_property_changes_sync
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             gchar **out_new_prop_value,
                                                             GCancellable *cancellable,
                                                             GError **error);

Blocks until "SomeReadWriteProperty" changes

This function synchronously invokes the BlockUntilRWPropertyChanges() method on the com.example.Tweak interface on the object represented by `instance`. See `test_tweak_block_until_rw_property_changes()` for the asynchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`out_new_prop_value` : | The new value of "SomeReadWriteProperty". Free with `g_free()`.
`cancellable` : | A GCancellable or `NULL`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_change_readable_property_sync ()

    gboolean            test_tweak_change_readable_property_sync
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *new_value,
                                                             GCancellable *cancellable,
                                                             GError **error);

Changes the "foo" property

This function synchronously invokes the ChangeReadableProperty() method on the com.example.Tweak interface on the object represented by `instance`. See `test_tweak_change_readable_property()` for the asynchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`new_value` : | New value for the "foo" property
`cancellable` : | A GCancellable or `NULL`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_i_can_haz_greetingz_sync ()

    gboolean            test_tweak_i_can_haz_greetingz_sync (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *greetz,
                                                             gchar **out_word,
                                                             GCancellable *cancellable,
                                                             GError **error);

This method will take a greeting and give a rewritten greeting back

This function synchronously invokes the ICanHazGreetingz() method on the com.example.Tweak interface on the object represented by `instance`. See `test_tweak_i_can_haz_greetingz()` for the asynchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`greetz` : | Greeting to pass to method
`out_word` : | Rewritten greeting. Free with `g_free()`.
`cancellable` : | A GCancellable or `NULL`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_broadcastz_newz_sync ()

    gboolean            test_tweak_broadcastz_newz_sync     (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *newz,
                                                             GCancellable *cancellable,
                                                             GError **error);

Conduit to broadcast newz. This method will make the object emit the "NewzNotifz" signal using the passed in parameter `newz` as the news to broadcast.

This function synchronously invokes the BroadcastzNewz() method on the com.example.Tweak interface on the object represented by `instance`. See `test_tweak_broadcastz_newz()` for the asynchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`newz` : | The news to broadcast
`cancellable` : | A GCancellable or `NULL`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_get_server_unique_name_sync ()

    gboolean            test_tweak_get_server_unique_name_sync
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             gchar **out_server_unique_name,
                                                             GCancellable *cancellable,
                                                             GError **error);

Gets the unique D-Bus name of the server

This function synchronously invokes the GetServerUniqueName() method on the com.example.Tweak interface on the object represented by `instance`. See `test_tweak_get_server_unique_name()` for the asynchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`out_server_unique_name` : | Unique D-Bus name. Free with `g_free()`.
`cancellable` : | A GCancellable or `NULL`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_long_running_method_sync ()

    gboolean            test_tweak_long_running_method_sync (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             gint msec_to_run,
                                                             GCancellable *cancellable,
                                                             GError **error);

A method that takes `msec_to_run` milliseconds to reply

This function synchronously invokes the LongRunningMethod() method on the com.example.Tweak interface on the object represented by `instance`. See `test_tweak_long_running_method()` for the asynchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`msec_to_run` : | Number of milliseconds to wait until replying
`cancellable` : | A GCancellable or `NULL`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_return_gerror_sync ()

    gboolean            test_tweak_return_gerror_sync       (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *error_domain,
                                                             gint error_code,
                                                             GCancellable *cancellable,
                                                             GError **error);

Throws an error identified by `error_domain` and `error_code`. This is mainly for testing that we can transparently hand GError's back and forth.

This function synchronously invokes the ReturnGError() method on the com.example.Tweak interface on the object represented by `instance`. See `test_tweak_return_gerror()` for the asynchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`error_domain` : | A GError error domain
`error_code` : | The error code for `error_domain`
`cancellable` : | A GCancellable or `NULL`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_method_struct_disambiguation_sync ()

    gboolean            test_tweak_method_struct_disambiguation_sync
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             TestPair *pair,
                                                             TestPoint *point,
                                                             TestPoint **out_enhanced_point,
                                                             TestPair **out_enhanced_pair,
                                                             GCancellable *cancellable,
                                                             GError **error);

A method to check we can properly disambiguate what structure wrapper types to use

This function synchronously invokes the MethodStructDisambiguation() method on the com.example.Tweak interface on the object represented by `instance`. See `test_tweak_method_struct_disambiguation()` for the asynchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`pair` : | A pair
`point` : | A point
`out_enhanced_point` : | An enhanced point. Free with `g_object_unref()`.
`out_enhanced_pair` : | An enhanced pair. Free with `g_object_unref()`.
`cancellable` : | A GCancellable or `NULL`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_method_with_ctypes_sync ()

    gboolean            test_tweak_method_with_ctypes_sync  (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             TestSomeExampleCType value,
                                                             TestSomeExampleCType *out_better_value,
                                                             GCancellable *cancellable,
                                                             GError **error);

A method to check we properly support specifying what C type to use for an integral type

This function synchronously invokes the MethodWithCTypes() method on the com.example.Tweak interface on the object represented by `instance`. See `test_tweak_method_with_ctypes()` for the asynchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`value` : | Some value
`out_better_value` : | I can't believe it's a better value!
`cancellable` : | A GCancellable or `NULL`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_block_until_rw_property_changes ()

    guint               test_tweak_block_until_rw_property_changes
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

Blocks until "SomeReadWriteProperty" changes

This function asynchronously invokes the BlockUntilRWPropertyChanges() method on the com.example.Tweak interface on the object represented by `instance`. When the reply is ready, `callback` will be called (on the main thread). You can then call `test_tweak_block_until_rw_property_changes_finish()` to get the result. See `test_tweak_block_until_rw_property_changes_sync()` for the synchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`cancellable` : | A GCancellable or `NULL`.
`callback` : | Callback to invoke when the reply is ready.
`user_data` : | User data to pass to `callback`.
Returns : | A pending call id (never zero) that can be used with `egg_dbus_connection_pending_call_cancel()` or `egg_dbus_connection_pending_call_block()`.

### test_tweak_block_until_rw_property_changes_finish ()

    gboolean            test_tweak_block_until_rw_property_changes_finish
                                                            (TestTweak *instance,
                                                             gchar **out_new_prop_value,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an asynchronous method invocation started with `test_tweak_block_until_rw_property_changes()`.

`instance` : | A TestTweak.
`out_new_prop_value` : | The new value of "SomeReadWriteProperty". Free with `g_free()`.
`res` : | A GAsyncResult obtained from the GAsyncReadyCallback function passed to `test_tweak_block_until_rw_property_changes()`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_change_readable_property ()

    guint               test_tweak_change_readable_property (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *new_value,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

Changes the "foo" property

This function asynchronously invokes the ChangeReadableProperty() method on the com.example.Tweak interface on the object represented by `instance`. When the reply is ready, `callback` will be called (on the main thread). You can then call `test_tweak_change_readable_property_finish()` to get the result. See `test_tweak_change_readable_property_sync()` for the synchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`new_value` : | New value for the "foo" property
`cancellable` : | A GCancellable or `NULL`.
`callback` : | Callback to invoke when the reply is ready.
`user_data` : | User data to pass to `callback`.
Returns : | A pending call id (never zero) that can be used with `egg_dbus_connection_pending_call_cancel()` or `egg_dbus_connection_pending_call_block()`.

### test_tweak_change_readable_property_finish ()

    gboolean            test_tweak_change_readable_property_finish
                                                            (TestTweak *instance,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an asynchronous method invocation started with `test_tweak_change_readable_property()`.

`instance` : | A TestTweak.
`res` : | A GAsyncResult obtained from the GAsyncReadyCallback function passed to `test_tweak_change_readable_property()`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_i_can_haz_greetingz ()

    guint               test_tweak_i_can_haz_greetingz      (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *greetz,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

This method will take a greeting and give a rewritten greeting back

This function asynchronously invokes the ICanHazGreetingz() method on the com.example.Tweak interface on the object represented by `instance`. When the reply is ready, `callback` will be called (on the main thread). You can then call `test_tweak_i_can_haz_greetingz_finish()` to get the result. See `test_tweak_i_can_haz_greetingz_sync()` for the synchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`greetz` : | Greeting to pass to method
`cancellable` : | A GCancellable or `NULL`.
`callback` : | Callback to invoke when the reply is ready.
`user_data` : | User data to pass to `callback`.
Returns : | A pending call id (never zero) that can be used with `egg_dbus_connection_pending_call_cancel()` or `egg_dbus_connection_pending_call_block()`.

### test_tweak_i_can_haz_greetingz_finish ()

    gboolean            test_tweak_i_can_haz_greetingz_finish
                                                            (TestTweak *instance,
                                                             gchar **out_word,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an asynchronous method invocation started with `test_tweak_i_can_haz_greetingz()`.

`instance` : | A TestTweak.
`out_word` : | Rewritten greeting. Free with `g_free()`.
`res` : | A GAsyncResult obtained from the GAsyncReadyCallback function passed to `test_tweak_i_can_haz_greetingz()`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_broadcastz_newz ()

    guint               test_tweak_broadcastz_newz          (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *newz,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

Conduit to broadcast newz. This method will make the object emit the "NewzNotifz" signal using the passed in parameter `newz` as the news to broadcast.

This function asynchronously invokes the BroadcastzNewz() method on the com.example.Tweak interface on the object represented by `instance`. When the reply is ready, `callback` will be called (on the main thread). You can then call `test_tweak_broadcastz_newz_finish()` to get the result. See `test_tweak_broadcastz_newz_sync()` for the synchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`newz` : | The news to broadcast
`cancellable` : | A GCancellable or `NULL`.
`callback` : | Callback to invoke when the reply is ready.
`user_data` : | User data to pass to `callback`.
Returns : | A pending call id (never zero) that can be used with `egg_dbus_connection_pending_call_cancel()` or `egg_dbus_connection_pending_call_block()`.

### test_tweak_broadcastz_newz_finish ()

    gboolean            test_tweak_broadcastz_newz_finish   (TestTweak *instance,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an asynchronous method invocation started with `test_tweak_broadcastz_newz()`.

`instance` : | A TestTweak.
`res` : | A GAsyncResult obtained from the GAsyncReadyCallback function passed to `test_tweak_broadcastz_newz()`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_get_server_unique_name ()

    guint               test_tweak_get_server_unique_name   (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

Gets the unique D-Bus name of the server

This function asynchronously invokes the GetServerUniqueName() method on the com.example.Tweak interface on the object represented by `instance`. When the reply is ready, `callback` will be called (on the main thread). You can then call `test_tweak_get_server_unique_name_finish()` to get the result. See `test_tweak_get_server_unique_name_sync()` for the synchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`cancellable` : | A GCancellable or `NULL`.
`callback` : | Callback to invoke when the reply is ready.
`user_data` : | User data to pass to `callback`.
Returns : | A pending call id (never zero) that can be used with `egg_dbus_connection_pending_call_cancel()` or `egg_dbus_connection_pending_call_block()`.

### test_tweak_get_server_unique_name_finish ()

    gboolean            test_tweak_get_server_unique_name_finish
                                                            (TestTweak *instance,
                                                             gchar **out_server_unique_name,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an asynchronous method invocation started with `test_tweak_get_server_unique_name()`.

`instance` : | A TestTweak.
`out_server_unique_name` : | Unique D-Bus name. Free with `g_free()`.
`res` : | A GAsyncResult obtained from the GAsyncReadyCallback function passed to `test_tweak_get_server_unique_name()`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_long_running_method ()

    guint               test_tweak_long_running_method      (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             gint msec_to_run,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

A method that takes `msec_to_run` milliseconds to reply

This function asynchronously invokes the LongRunningMethod() method on the com.example.Tweak interface on the object represented by `instance`. When the reply is ready, `callback` will be called (on the main thread). You can then call `test_tweak_long_running_method_finish()` to get the result. See `test_tweak_long_running_method_sync()` for the synchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`msec_to_run` : | Number of milliseconds to wait until replying
`cancellable` : | A GCancellable or `NULL`.
`callback` : | Callback to invoke when the reply is ready.
`user_data` : | User data to pass to `callback`.
Returns : | A pending call id (never zero) that can be used with `egg_dbus_connection_pending_call_cancel()` or `egg_dbus_connection_pending_call_block()`.

### test_tweak_long_running_method_finish ()

    gboolean            test_tweak_long_running_method_finish
                                                            (TestTweak *instance,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an asynchronous method invocation started with `test_tweak_long_running_method()`.

`instance` : | A TestTweak.
`res` : | A GAsyncResult obtained from the GAsyncReadyCallback function passed to `test_tweak_long_running_method()`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_return_gerror ()

    guint               test_tweak_return_gerror            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             const gchar *error_domain,
                                                             gint error_code,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

Throws an error identified by `error_domain` and `error_code`. This is mainly for testing that we can transparently hand GError's back and forth.

This function asynchronously invokes the ReturnGError() method on the com.example.Tweak interface on the object represented by `instance`. When the reply is ready, `callback` will be called (on the main thread). You can then call `test_tweak_return_gerror_finish()` to get the result. See `test_tweak_return_gerror_sync()` for the synchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`error_domain` : | A GError error domain
`error_code` : | The error code for `error_domain`
`cancellable` : | A GCancellable or `NULL`.
`callback` : | Callback to invoke when the reply is ready.
`user_data` : | User data to pass to `callback`.
Returns : | A pending call id (never zero) that can be used with `egg_dbus_connection_pending_call_cancel()` or `egg_dbus_connection_pending_call_block()`.

### test_tweak_return_gerror_finish ()

    gboolean            test_tweak_return_gerror_finish     (TestTweak *instance,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an asynchronous method invocation started with `test_tweak_return_gerror()`.

`instance` : | A TestTweak.
`res` : | A GAsyncResult obtained from the GAsyncReadyCallback function passed to `test_tweak_return_gerror()`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_method_struct_disambiguation ()

    guint               test_tweak_method_struct_disambiguation
                                                            (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             TestPair *pair,
                                                             TestPoint *point,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

A method to check we can properly disambiguate what structure wrapper types to use

This function asynchronously invokes the MethodStructDisambiguation() method on the com.example.Tweak interface on the object represented by `instance`. When the reply is ready, `callback` will be called (on the main thread). You can then call `test_tweak_method_struct_disambiguation_finish()` to get the result. See `test_tweak_method_struct_disambiguation_sync()` for the synchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`pair` : | A pair
`point` : | A point
`cancellable` : | A GCancellable or `NULL`.
`callback` : | Callback to invoke when the reply is ready.
`user_data` : | User data to pass to `callback`.
Returns : | A pending call id (never zero) that can be used with `egg_dbus_connection_pending_call_cancel()` or `egg_dbus_connection_pending_call_block()`.

### test_tweak_method_struct_disambiguation_finish ()

    gboolean            test_tweak_method_struct_disambiguation_finish
                                                            (TestTweak *instance,
                                                             TestPoint **out_enhanced_point,
                                                             TestPair **out_enhanced_pair,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an asynchronous method invocation started with `test_tweak_method_struct_disambiguation()`.

`instance` : | A TestTweak.
`out_enhanced_point` : | An enhanced point. Free with `g_object_unref()`.
`out_enhanced_pair` : | An enhanced pair. Free with `g_object_unref()`.
`res` : | A GAsyncResult obtained from the GAsyncReadyCallback function passed to `test_tweak_method_struct_disambiguation()`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_method_with_ctypes ()

    guint               test_tweak_method_with_ctypes       (TestTweak *instance,
                                                             EggDBusCallFlags call_flags,
                                                             TestSomeExampleCType value,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

A method to check we properly support specifying what C type to use for an integral type

This function asynchronously invokes the MethodWithCTypes() method on the com.example.Tweak interface on the object represented by `instance`. When the reply is ready, `callback` will be called (on the main thread). You can then call `test_tweak_method_with_ctypes_finish()` to get the result. See `test_tweak_method_with_ctypes_sync()` for the synchronous version of this function.

`instance` : | A TestTweak.
`call_flags` : | Flags from EggDBusCallFlags detailing how the method should be invoked.
`value` : | Some value
`cancellable` : | A GCancellable or `NULL`.
`callback` : | Callback to invoke when the reply is ready.
`user_data` : | User data to pass to `callback`.
Returns : | A pending call id (never zero) that can be used with `egg_dbus_connection_pending_call_cancel()` or `egg_dbus_connection_pending_call_block()`.

### test_tweak_method_with_ctypes_finish ()

    gboolean            test_tweak_method_with_ctypes_finish
                                                            (TestTweak *instance,
                                                             TestSomeExampleCType *out_better_value,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an asynchronous method invocation started with `test_tweak_method_with_ctypes()`.

`instance` : | A TestTweak.
`out_better_value` : | I can't believe it's a better value!
`res` : | A GAsyncResult obtained from the GAsyncReadyCallback function passed to `test_tweak_method_with_ctypes()`.
`error` : | Return location for error.
Returns : | `TRUE` if the method call succeeded, `FALSE` if `error` is set.

### test_tweak_handle_block_until_rw_property_changes_finish ()

    void                test_tweak_handle_block_until_rw_property_changes_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             const gchar *out_new_prop_value);

Function to be called by implementers of the com.example.Tweak D-Bus interface to finish handling the BlockUntilRWPropertyChanges() method.

`new_prop_value` : | The new value of "SomeReadWriteProperty"
`method_invocation` : | A EggDBusMethodInvocation.

### test_tweak_handle_change_readable_property_finish ()

    void                test_tweak_handle_change_readable_property_finish
                                                            (EggDBusMethodInvocation *method_invocation);

Function to be called by implementers of the com.example.Tweak D-Bus interface to finish handling the ChangeReadableProperty() method.

`method_invocation` : | A EggDBusMethodInvocation.

### test_tweak_handle_i_can_haz_greetingz_finish ()

    void                test_tweak_handle_i_can_haz_greetingz_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             const gchar *out_word);

Function to be called by implementers of the com.example.Tweak D-Bus interface to finish handling the ICanHazGreetingz() method.

`word` : | Rewritten greeting
`method_invocation` : | A EggDBusMethodInvocation.

### test_tweak_handle_broadcastz_newz_finish ()

    void                test_tweak_handle_broadcastz_newz_finish
                                                            (EggDBusMethodInvocation *method_invocation);

Function to be called by implementers of the com.example.Tweak D-Bus interface to finish handling the BroadcastzNewz() method.

`method_invocation` : | A EggDBusMethodInvocation.

### test_tweak_handle_get_server_unique_name_finish ()

    void                test_tweak_handle_get_server_unique_name_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             const gchar *out_server_unique_name);

Function to be called by implementers of the com.example.Tweak D-Bus interface to finish handling the GetServerUniqueName() method.

`server_unique_name` : | Unique D-Bus name
`method_invocation` : | A EggDBusMethodInvocation.

### test_tweak_handle_long_running_method_finish ()

    void                test_tweak_handle_long_running_method_finish
                                                            (EggDBusMethodInvocation *method_invocation);

Function to be called by implementers of the com.example.Tweak D-Bus interface to finish handling the LongRunningMethod() method.

`method_invocation` : | A EggDBusMethodInvocation.

### test_tweak_handle_return_gerror_finish ()

    void                test_tweak_handle_return_gerror_finish
                                                            (EggDBusMethodInvocation *method_invocation);

Function to be called by implementers of the com.example.Tweak D-Bus interface to finish handling the ReturnGError() method.

`method_invocation` : | A EggDBusMethodInvocation.

### test_tweak_handle_method_struct_disambiguation_finish ()

    void                test_tweak_handle_method_struct_disambiguation_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             TestPoint *out_enhanced_point,
                                                             TestPair *out_enhanced_pair);

Function to be called by implementers of the com.example.Tweak D-Bus interface to finish handling the MethodStructDisambiguation() method.

`enhanced_point` : | An enhanced point
`enhanced_pair` : | An enhanced pair
`method_invocation` : | A EggDBusMethodInvocation.

### test_tweak_handle_method_with_ctypes_finish ()

    void                test_tweak_handle_method_with_ctypes_finish
                                                            (EggDBusMethodInvocation *method_invocation,
                                                             TestSomeExampleCType out_better_value);

Function to be called by implementers of the com.example.Tweak D-Bus interface to finish handling the MethodWithCTypes() method.

`better_value` : | I can't believe it's a better value!
`method_invocation` : | A EggDBusMethodInvocation.

### test_tweak_emit_signal_newz_notifz ()

    void                test_tweak_emit_signal_newz_notifz  (TestTweak *instance,
                                                             const gchar *destination,
                                                             const gchar *newz);

Type safe wrapper for emitting the "newz-notifz" signal.

`instance` : | A GObject derived type implementing the TestTweak interface.
`destination` : | The destination of the signal or `NULL` to emit signals to all listeners.
`newz` : | The newz in the tweaked world

### test_tweak_emit_signal_signal_struct_disambiguation ()

    void                test_tweak_emit_signal_signal_struct_disambiguation
                                                            (TestTweak *instance,
                                                             const gchar *destination,
                                                             TestPair *pair,
                                                             TestPoint *point);

Type safe wrapper for emitting the "signal-struct-disambiguation" signal.

`instance` : | A GObject derived type implementing the TestTweak interface.
`destination` : | The destination of the signal or `NULL` to emit signals to all listeners.
`pair` : | A pair
`point` : | A point

### test_tweak_emit_signal_signal_with_ctype ()

    void                test_tweak_emit_signal_signal_with_ctype
                                                            (TestTweak *instance,
                                                             const gchar *destination,
                                                             TestSomeExampleCType better_value);

Type safe wrapper for emitting the "signal-with-ctype" signal.

`instance` : | A GObject derived type implementing the TestTweak interface.
`destination` : | The destination of the signal or `NULL` to emit signals to all listeners.
`better_value` : | Some value

### test_tweak_emit_signal_escape_vehicle_changed ()

    void                test_tweak_emit_signal_escape_vehicle_changed
                                                            (TestTweak *instance,
                                                             const gchar *destination,
                                                             TestVehicle new_escape_vehicle);

Type safe wrapper for emitting the "escape-vehicle-changed" signal.

`instance` : | A GObject derived type implementing the TestTweak interface.
`destination` : | The destination of the signal or `NULL` to emit signals to all listeners.
`new_escape_vehicle` : | The new escape vehicle

## Property Details

### The `"bar"` property

      "bar"                      EggDBusArraySeq*      : Read

The Bar factor

### The `"baz"` property

      "baz"                      TestPoint*            : Read

The Baz indicator

### The `"baz-forced-to-use-pair"` property

      "baz-forced-to-use-pair"   TestPair*             : Read

A slightly different Baz indicator

### The `"default-create-flags"` property

      "default-create-flags"     TestCreateFlags       : Read / Write

The default create flags to use.

Default value: TEST_CREATE_FLAGS_USE_FROBNICATOR

### The `"escape-vehicle"` property

      "escape-vehicle"           TestVehicle           : Read / Write

The vehicle used for escaping.

Default value: TEST_VEHICLE_SPORT_UTILITY_VEHICLE

### The `"foo"` property

      "foo"                      gchar*                : Read

The Foo value

Default value: NULL

### The `"property-with-ctype"` property

      "property-with-ctype"      gint                  : Read / Write

I'm a special C type

Default value: 0

### The `"some-read-write-property"` property

      "some-read-write-property" gchar*                : Read / Write

Hey, I'm promiscuous. I'm writeable!

Default value: NULL

## Signal Details

### The `"escape-vehicle-changed"` signal

    void                user_function                      (TestTweak  *instance,
                                                            TestVehicle new_escape_vehicle,
                                                            gpointer    user_data)               : Run Last

A signal to check we properly support emitting signals with enums

`instance` : | A TestTweak.
`new_escape_vehicle` : | The new escape vehicle
`user_data` : | user data set when the signal handler was connected.

### The `"newz-notifz"` signal

    void                user_function                      (TestTweak *instance,
                                                            gchar     *newz,
                                                            gpointer   user_data)      : Run Last

Emitted when there are NEWZ on the Tweak interface

`instance` : | A TestTweak.
`newz` : | The newz in the tweaked world
`user_data` : | user data set when the signal handler was connected.

### The `"signal-struct-disambiguation"` signal

    void                user_function                      (TestTweak *instance,
                                                            TestPair  *pair,
                                                            TestPoint *point,
                                                            gpointer   user_data)      : Run Last

A signal to check we can properly disambiguate what structure wrapper types to use

`instance` : | A TestTweak.
`pair` : | A pair
`point` : | A point
`user_data` : | user data set when the signal handler was connected.

### The `"signal-with-ctype"` signal

    void                user_function                      (TestTweak *instance,
                                                            gint       better_value,
                                                            gpointer   user_data)         : Run Last

A signal to check we properly support specifying what C type to use for an integral type

`instance` : | A TestTweak.
`better_value` : | Some value
`user_data` : | user data set when the signal handler was connected.