st-handler-api.sgml

linux下网络收音机的源码

<!-- ##### SECTION Title ##### -->
STHandler

<!-- ##### SECTION Short_Description ##### -->
an object for handling a stream directory.

<!-- ##### SECTION Long_Description ##### -->
<para>

</para>

<!-- ##### SECTION See_Also ##### -->
<para>
#STCategory, #STHandlerField, <link
linkend="streamtuner-st-handlers-api">st-handlers</link>, #STPlugin,
<link linkend="streamtuner-st-state-api">st-state</link>, #STStream
</para>

<!-- ##### STRUCT STHandler ##### -->
<para>

</para>

@object: 
@priv: 

<!-- ##### ENUM STHandlerFlags ##### -->
<para>

</para>

@ST_HANDLER_NO_CATEGORIES: specifies that the handler has no
categories. There will be no left pane in the handler tab.
@ST_HANDLER_CONFIRM_DELETION: specifies that the user should be prompted
for confirmation before deleting a stream.

<!-- ##### ENUM STHandlerStockField ##### -->
<para>

</para>

@ST_HANDLER_STOCK_FIELD_NAME: the stream name, of type #G_TYPE_STRING
@ST_HANDLER_STOCK_FIELD_GENRE: the stream genre, of type #G_TYPE_STRING
@ST_HANDLER_STOCK_FIELD_DESCRIPTION: the stream description, of type #G_TYPE_STRING
@ST_HANDLER_STOCK_FIELD_HOMEPAGE: the stream homepage URL, of type #G_TYPE_STRING
@ST_HANDLER_STOCK_FIELD_URI_LIST: the stream listen URL list, of type #G_TYPE_VALUE_ARRAY

<!-- ##### ENUM STHandlerEvent ##### -->
<para>

</para>

@ST_HANDLER_EVENT_RELOAD: see #STHandlerReloadCallback.
@ST_HANDLER_EVENT_STREAM_NEW: see #STStreamNewCallback.
@ST_HANDLER_EVENT_STREAM_FIELD_GET: see #STStreamFieldGetCallback.
@ST_HANDLER_EVENT_STREAM_FIELD_SET: see #STStreamFieldSetCallback.
@ST_HANDLER_EVENT_STREAM_FREE: see #STStreamFreeCallback.
@ST_HANDLER_EVENT_STREAM_TUNE_IN: see #STStreamTuneInCallback.
@ST_HANDLER_EVENT_STREAM_RECORD: see #STStreamRecordCallback.
@ST_HANDLER_EVENT_STREAM_BROWSE: see #STStreamBrowseCallback.
@ST_HANDLER_EVENT_CATEGORY_NEW: see #STCategoryNewCallback.
@ST_HANDLER_EVENT_CATEGORY_FREE: see #STCategoryFreeCallback.
@ST_HANDLER_EVENT_THREAD_BEGIN: see #STThreadBeginCallback.
@ST_HANDLER_EVENT_THREAD_END: see #STThreadEndCallback.
@ST_HANDLER_EVENT_STREAM_TUNE_IN_MULTIPLE: see #STStreamTuneInMultipleCallback.
@ST_HANDLER_EVENT_RELOAD_MULTIPLE: see #STHandlerReloadMultipleCallback.
@ST_HANDLER_EVENT_STREAM_MODIFY: see #STStreamModifyCallback.
@ST_HANDLER_EVENT_STREAM_DELETE: see #STStreamDeleteCallback.
@ST_HANDLER_EVENT_STREAM_STOCK_FIELD_GET: see #STStreamStockFieldGetCallback.
@ST_HANDLER_EVENT_STREAM_RESOLVE: see #STStreamResolveCallback.
@ST_HANDLER_EVENT_PREFERENCES_WIDGET_NEW: see #STHandlerPreferencesWidgetNewCallback.
@ST_HANDLER_N_EVENTS: 

<!-- ##### USER_FUNCTION STHandlerReloadCallback ##### -->
<para>

</para>

@category: 
@categories: 
@streams: 
@data: 
@err: 
@Returns: 


<!-- ##### USER_FUNCTION STHandlerReloadMultipleCallback ##### -->
<para>

</para>

@categories: 
@streams: 
@data: 
@err: 
@Returns: 


<!-- ##### USER_FUNCTION STCategoryNewCallback ##### -->
<para>

</para>

@data: 
@Returns: 


<!-- ##### USER_FUNCTION STCategoryFreeCallback ##### -->
<para>

</para>

@category: 
@data: 


<!-- ##### USER_FUNCTION STStreamNewCallback ##### -->
<para>

</para>

@data: 
@Returns: 


<!-- ##### USER_FUNCTION STStreamFieldGetCallback ##### -->
<para>

</para>

@stream: 
@field: 
@value: 
@data: 


<!-- ##### USER_FUNCTION STStreamFieldSetCallback ##### -->
<para>

</para>

@stream: 
@field: 
@value: 
@data: 


<!-- ##### USER_FUNCTION STStreamModifyCallback ##### -->
<para>

</para>

@stream: 
@fields: 
@values: 
@data: 
@err: 
@Returns: 


<!-- ##### USER_FUNCTION STStreamDeleteCallback ##### -->
<para>

</para>

@stream: 
@data: 
@err: 
@Returns: 


<!-- ##### USER_FUNCTION STStreamFreeCallback ##### -->
<para>

</para>

@stream: 
@data: 


<!-- ##### USER_FUNCTION STStreamResolveCallback ##### -->
<para>

</para>

@stream: 
@data: 
@err: 
@Returns: 


<!-- ##### USER_FUNCTION STStreamTuneInCallback ##### -->
<para>

</para>

@stream: 
@data: 
@err: 
@Returns: 


<!-- ##### USER_FUNCTION STStreamRecordCallback ##### -->
<para>

</para>

@stream: 
@data: 
@err: 
@Returns: 


<!-- ##### USER_FUNCTION STStreamBrowseCallback ##### -->
<para>

</para>

@stream: 
@data: 
@err: 
@Returns: 


<!-- ##### USER_FUNCTION STThreadBeginCallback ##### -->
<para>

</para>

@data: 
@Returns: 


<!-- ##### USER_FUNCTION STThreadEndCallback ##### -->
<para>

</para>

@thread_data: 
@data: 


<!-- ##### USER_FUNCTION STStreamTuneInMultipleCallback ##### -->
<para>

</para>

@streams: 
@data: 
@err: 
@Returns: 


<!-- ##### USER_FUNCTION STStreamStockFieldGetCallback ##### -->
<para>

</para>

@stream: 
@stock_field: 
@value: 
@data: 


<!-- ##### USER_FUNCTION STHandlerPreferencesWidgetNewCallback ##### -->
<para>

</para>

@data: 
@Returns: 


<!-- ##### FUNCTION st_handler_new ##### -->
<para>

</para>

@name: 
@Returns: 


<!-- ##### FUNCTION st_handler_new_from_plugin ##### -->
<para>

</para>

@plugin: 
@Returns: 


<!-- ##### FUNCTION st_handler_set_label ##### -->
<para>

</para>

@handler: 
@label: 


<!-- ##### FUNCTION st_handler_set_description ##### -->
<para>

</para>

@handler: 
@description: 


<!-- ##### FUNCTION st_handler_set_home ##### -->
<para>

</para>

@handler: 
@home: 


<!-- ##### FUNCTION st_handler_set_icon_from_pixbuf ##### -->
<para>

</para>

@handler: 
@pixbuf: 


<!-- ##### FUNCTION st_handler_set_stock_categories ##### -->
<para>

</para>

@handler: 
@categories: 


<!-- ##### FUNCTION st_handler_set_flags ##### -->
<para>

</para>

@handler: 
@flags: 


<!-- ##### FUNCTION st_handler_set_stream_version ##### -->
<para>

</para>

@handler: 
@version: 


<!-- ##### FUNCTION st_handler_add_field ##### -->
<para>

</para>

@handler: 
@field: 


<!-- ##### FUNCTION st_handler_bind ##### -->
<para>

</para>

@handler: 
@event: 
@cb: 
@data: 


<!-- ##### FUNCTION st_handler_notice ##### -->
<para>

</para>

@handler: 
@format: 
@Varargs: 


<!-- ##### FUNCTION st_handler_config_register ##### -->
<para>

</para>

@handler: 
@pspec: 


<!-- ##### FUNCTION st_handler_config_lookup ##### -->
<para>

</para>

@handler: 
@key: 
@Returns: 


<!-- ##### USER_FUNCTION STHandlerConfigForeachCallback ##### -->
<para>

</para>

@pspec: 
@value: 
@data: 


<!-- ##### FUNCTION st_handler_config_foreach ##### -->
<para>

</para>

@handler: 
@cb: 
@data: 


<!-- ##### FUNCTION st_handler_config_get_value ##### -->
<para>

</para>

@handler: 
@key: 
@value: 


<!-- ##### FUNCTION st_handler_config_set_value ##### -->
<para>

</para>

@handler: 
@key: 
@value: 


<!-- ##### FUNCTION st_handler_config_get_boolean ##### -->
<para>

</para>

@handler: 
@key: 
@Returns: 


<!-- ##### FUNCTION st_handler_config_set_boolean ##### -->
<para>

</para>

@handler: 
@key: 
@value: 


<!-- ##### FUNCTION st_handler_config_get_int ##### -->
<para>

</para>

@handler: 
@key: 
@Returns: 


<!-- ##### FUNCTION st_handler_config_set_int ##### -->
<para>

</para>

@handler: 
@key: 
@value: 


<!-- ##### FUNCTION st_handler_config_get_uint ##### -->
<para>

</para>

@handler: 
@key: 
@Returns: 


<!-- ##### FUNCTION st_handler_config_set_uint ##### -->
<para>

</para>

@handler: 
@key: 
@value: 


<!-- ##### FUNCTION st_handler_config_get_double ##### -->
<para>

</para>

@handler: 
@key: 
@Returns: 


<!-- ##### FUNCTION st_handler_config_set_double ##### -->
<para>

</para>

@handler: 
@key: 
@value: 


<!-- ##### FUNCTION st_handler_config_get_string ##### -->
<para>

</para>

@handler: 
@key: 
@Returns: 


<!-- ##### FUNCTION st_handler_config_set_string ##### -->
<para>

</para>

@handler: 
@key: 
@value: 


<!-- ##### FUNCTION st_handler_config_get_value_array ##### -->
<para>

</para>

@handler: 
@key: 
@Returns: 


<!-- ##### FUNCTION st_handler_config_set_value_array ##### -->
<para>

</para>

@handler: 
@key: 
@value: 


<!-- ##### FUNCTION st_handler_set_copyright ##### -->
<para>

</para>

@handler: 
@copyright: 


<!-- ##### FUNCTION st_handler_set_info ##### -->
<para>

</para>

@handler: 
@label: 
@copyright: 


<!-- ##### FUNCTION st_handler_set_icon ##### -->
<para>

</para>

@handler: 
@size: 
@data: 


<!-- ##### FUNCTION st_handler_set_icon_from_inline ##### -->
<para>

</para>

@handler: 
@size: 
@data: 


<!-- ##### FUNCTION st_handler_set_icon_from_file ##### -->
<para>

</para>

@handler: 
@filename: 
@err: 
@Returns: 


<!-- ##### MACRO ST_HANDLER_EVENT_REFRESH ##### -->
<para>

</para>



<!-- ##### MACRO ST_HANDLER_EVENT_REFRESH_MULTIPLE ##### -->
<para>

</para>



<!-- ##### MACRO N_ST_HANDLER_EVENTS ##### -->
<para>

</para>



<!-- ##### TYPEDEF STHandlerRefreshCallback ##### -->
<para>

</para>


<!-- ##### TYPEDEF STHandlerRefreshMultipleCallback ##### -->
<para>

</para>