Microsoft DirectX 8.1 (C++)

Guide Store Events (Visual Basic)

This topic applies to Windows XP Home Edition and Windows XP Professional only.

This section lists the methods (also known as event handlers) that applications must implement to handle events that are signaled when a top-level Guide Store collection is changed. When an event occurs, the Guide Store calls the event handler in your application, if the handler is implemented.

Events are signaled for changes to the following collections:

The following sample code shows how to set up an event handler for events signaled when an object is removed from the Programs collection. Assume that gs is the initialized GuideStore object and that the Init procedure is called when the application is started.

Dim WithEvents m_programs As Programs

Sub Init()
  Set m_programs = gs.Programs
End Sub

Sub m_programs_ItemRemoved(ByVal idobj As Long)
  ' Your event-handling code here.
End Sub

The following events are defined.

Event Description
ItemAdded An object has been added to the collection.
ItemChanged An object in the collection has changed.
ItemRemoved An object has been removed from the collection.
ItemsChanged Two or more objects in the collection have been changed, added, or removed.

Note   The syntax shown is for Microsoft Visual Basic. Script developers should ignore the information about types for parameters and return values.