Struct itunes_com::wrappers::Track

pub struct Track { /* private fields */ }

Safe wrapper over a IITTrack

Implementations

impl Track

pub fn as_file_or_cd_track(&self) -> Result<FileOrCDTrack>

In case the concrete COM object for this track actually is a derived FileOrCDTrack, this is a way to retrieve it

Examples found in repository

examples/wrappers.rs (line 52)

fn search_tracks(iTunes: &itunes_com::wrappers::iTunes, search_text: &str) -> windows::core::Result<()> {
    println!("Searching for \"{}\"...", search_text);

    let library_playlist = iTunes.LibraryPlaylist()?;
    let results = library_playlist.Search(search_text.into(), ITPlaylistSearchField::ITPlaylistSearchFieldAll)?;

    for result in results.iter()? {
        let file_location = result.as_file_or_cd_track().map(|foct| foct.Location());

        println!("  * {} at {:?}", result.Name()?, file_location);
    }

    Ok(())
}

Trait Implementations

impl IITObjectWrapper for Track

fn GetITObjectIDs(&self) -> Result<ObjectIDs>

Returns the four IDs that uniquely identify this object.

fn Name(&self) -> Result<String>

The name of the object.

fn set_Name(&mut self, Name: &str) -> Result<()>

The name of the object.

fn Index(&self) -> Result<i32>

The index of the object in internal application order (1-based).

fn sourceID(&self) -> Result<i32>

The source ID of the object.

fn playlistID(&self) -> Result<i32>

The playlist ID of the object.

fn trackID(&self) -> Result<i32>

The track ID of the object.

fn TrackDatabaseID(&self) -> Result<i32>

The track database ID of the object.

impl IITTrackWrapper for Track

fn Delete(&self) -> Result<()>

Delete this track.

fn Play(&self) -> Result<()>

Start playing this track.

fn AddArtworkFromFile(&self, filePath: &str) -> Result<Artwork>

Add artwork from an image file to this track.

fn Kind(&self) -> Result<ITTrackKind>

The track kind.

fn Playlist(&self) -> Result<Playlist>

The playlist that contains this track.

fn Album(&self) -> Result<String>

The album containing the track.

fn set_Album(&mut self, Album: &str) -> Result<()>

The album containing the track.

fn Artist(&self) -> Result<String>

The artist/source of the track.

fn set_Artist(&mut self, Artist: &str) -> Result<()>

The artist/source of the track.

fn BitRate(&self) -> Result<i32>

The bit rate of the track (in kbps).

fn BPM(&self) -> Result<i32>

The tempo of the track (in beats per minute).

fn set_BPM(&mut self, BPM: i32) -> Result<()>

The tempo of the track (in beats per minute).

fn Comment(&self) -> Result<String>

Freeform notes about the track.

fn set_Comment(&mut self, Comment: &str) -> Result<()>

Freeform notes about the track.

fn is_Compilation(&self) -> Result<bool>

True if this track is from a compilation album.

fn set_Compilation(&mut self, Compilation: bool) -> Result<()>

True if this track is from a compilation album.

fn Composer(&self) -> Result<String>

The composer of the track.

fn set_Composer(&mut self, Composer: &str) -> Result<()>

The composer of the track.

fn DateAdded(&self) -> Result<f64>

The date the track was added to the playlist.

fn DiscCount(&self) -> Result<i32>

The total number of discs in the source album.

fn set_DiscCount(&mut self, DiscCount: i32) -> Result<()>

The total number of discs in the source album.

fn DiscNumber(&self) -> Result<i32>

The index of the disc containing the track on the source album.

fn set_DiscNumber(&mut self, DiscNumber: i32) -> Result<()>

The index of the disc containing the track on the source album.

fn Duration(&self) -> Result<i32>

The length of the track (in seconds).

fn is_Enabled(&self) -> Result<bool>

True if the track is checked for playback.

fn set_Enabled(&mut self, Enabled: bool) -> Result<()>

True if the track is checked for playback.

fn EQ(&self) -> Result<String>

The name of the EQ preset of the track.

fn set_EQ(&mut self, EQ: &str) -> Result<()>

The name of the EQ preset of the track.

fn set_Finish(&mut self, Finish: i32) -> Result<()>

The stop time of the track (in seconds).

fn Finish(&self) -> Result<i32>

The stop time of the track (in seconds).

fn Genre(&self) -> Result<String>

The music/audio genre (category) of the track.

fn set_Genre(&mut self, Genre: &str) -> Result<()>

The music/audio genre (category) of the track.

fn Grouping(&self) -> Result<String>

The grouping (piece) of the track. Generally used to denote movements within classical work.

fn set_Grouping(&mut self, Grouping: &str) -> Result<()>

The grouping (piece) of the track. Generally used to denote movements within classical work.

fn KindAsString(&self) -> Result<String>

A text description of the track.

fn ModificationDate(&self) -> Result<f64>

The modification date of the content of the track.

fn PlayedCount(&self) -> Result<i32>

The number of times the track has been played.

fn set_PlayedCount(&mut self, PlayedCount: i32) -> Result<()>

The number of times the track has been played.

fn PlayedDate(&self) -> Result<f64>

The date and time the track was last played. A value of zero means no played date.

fn set_PlayedDate(&mut self, PlayedDate: f64) -> Result<()>

The date and time the track was last played. A value of zero means no played date.

fn PlayOrderIndex(&self) -> Result<i32>

The play order index of the track in the owner playlist (1-based).

fn Rating(&self) -> Result<i32>

The rating of the track (0 to 100).

fn set_Rating(&mut self, Rating: i32) -> Result<()>

The rating of the track (0 to 100).

fn SampleRate(&self) -> Result<i32>

The sample rate of the track (in Hz).

fn Size(&self) -> Result<i32>

The size of the track (in bytes).

fn Start(&self) -> Result<i32>

The start time of the track (in seconds).

fn set_Start(&mut self, Start: i32) -> Result<()>

The start time of the track (in seconds).

fn Time(&self) -> Result<String>

The length of the track (in MM:SS format).

fn TrackCount(&self) -> Result<i32>

The total number of tracks on the source album.

fn set_TrackCount(&mut self, TrackCount: i32) -> Result<()>

The total number of tracks on the source album.

fn TrackNumber(&self) -> Result<i32>

The index of the track on the source album.

fn set_TrackNumber(&mut self, TrackNumber: i32) -> Result<()>

The index of the track on the source album.

fn VolumeAdjustment(&self) -> Result<i32>

The relative volume adjustment of the track (-100% to 100%).

fn set_VolumeAdjustment(&mut self, VolumeAdjustment: i32) -> Result<()>

The relative volume adjustment of the track (-100% to 100%).

fn Year(&self) -> Result<i32>

The year the track was recorded/released.

fn set_Year(&mut self, Year: i32) -> Result<()>

The year the track was recorded/released.

fn Artwork(&self) -> Result<ArtworkCollection>

Returns a collection of artwork.