IEPGItem

[This is preliminary documentation and subject to change.]

The IEPGItem interface provides methods to retrieve Program Guide data from an object.

When to Implement

Implement IEPGItem in objects that wrap Guide database records. These objects are required as input parameters during calls to methods such as ITVViewer::SetReminder

When to Use

You can call the methods of IEPGItem to retrieve field data from the object.

Methods in Vtable Order

IUnknown Methods Description
QueryInterface Returns pointers to supported interfaces
AddRef Increments reference count
Release Decrements reference count

IEPGItem Description
TuningInfo Gets the tuning space identifier and channel.
StartTime Gets the starting time.
EndTime Gets the ending time.
Length Gets the length of the item, in minutes.
OnNow Returns a value indicating whether the item is being broadcast now. In other words, this method indicates whether the current system time is later than the item's starting time and earlier than the item's ending time.
Title Gets the title.
BodyText Gets the description.
PreviewGraphic Gets the file name of the preview graphic.
NumIcons Returns the total number of icons.
GetIcon Gets the file name of the specified icon.
NumOptions Returns the total number of options.
OptionPrompt Gets the option prompt.
GetOption Gets the specified option.

Remarks

IEPGItem is an abstract interface is inherited by objects that wrap records stored in the Guide database. The IEPGEpisode interface inherits from IEPGItem.

QuickInfo

  Windows NT: Unsupported.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Import Library: User-defined.
  Unicode: Yes.

See Also

ITVViewer::DeleteReminder, ITVViewer::HasEnhancement, ITVViewer::HasReminder, ITVViewer::SetReminder, ITVControl::EpisodeStatusChanged