Twitter

Definition

A non-visible component that enables communication with Twitter. Once a user has logged into their Twitter account (and the authorization has been confirmed successful by the IsAuthorized event), many more operations are available:

• Searching Twitter for tweets or labels (SearchTwitter)
• Sending a Tweet (Tweet)
• Sending a Tweet with an Image (TweetWithImage)
• Directing a message to a specific user (DirectMessage)
• Receiving the most recent messages directed to the logged-in user (RequestDirectMessages)
• Following a specific user (Follow)
• Ceasing to follow a specific user (StopFollowing)
• Getting a list of users following the logged-in user (RequestFollowers)
• Getting the most recent messages of users followed by the logged-in user (RequestFriendTimeline)
• Getting the most recent mentions of the logged-in user (RequestMentions)

You must obtain a Consumer Key and Consumer Secret for Twitter authorization specific to your app from http://twitter.com/oauth_clients/new

Properties

ConsumerKey

The consumer key to be used when authorizing with Twitter via OAuth.

ConsumerSecret

The consumer secret to be used when authorizing with Twitter via OAuth.

DirectMessages

This property contains a list of the most recent messages mentioning the logged-in user. Initially, the list is empty. To set it, the program must:

1. Call the Authorize method.
2. Wait for the IsAuthorized event.
3. Call the RequestDirectMessages method. 4, Wait for the DirectMessagesReceived event.

The value of this property will then be set to the list of direct messages retrieved (and maintain that value until any subsequent call to RequestDirectMessages).

Followers

This property contains a list of the followers of the logged-in user. Initially, the list is empty. To set it, the program must:

1. Call the Authorize method.
2. Wait for the IsAuthorized event.
3. Call the RequestFollowers method.
4. Wait for the FollowersReceived event.

The value of this property will then be set to the list of followers (and maintain its value until any subsequent call to RequestFollowers).

FriendTimeline

This property contains the 20 most recent messages of users being followed. Initially, the list is empty. To set it, the program must:

1. Call the Authorize method.
2. Wait for the IsAuthorized event.
3. Specify users to follow with one or more calls to the Follow method.
4. Call the RequestFriendTimeline method.
5. Wait for the FriendTimelineReceived event.

The value of this property will then be set to the list of messages (and maintain its value until any subsequent call to RequestFriendTimeline.

Mentions

This property contains a list of mentions of the logged-in user. Initially, the list is empty. To set it, the program must:

1. Call the Authorize method.
2. Wait for the IsAuthorized event.
3. Call the RequestMentions method.
4. Wait for the MentionsReceived event.

The value of this property will then be set to the list of mentions (and will maintain its value until any subsequent calls to RequestMentions).

SearchResults

This property, which is initially empty, is set to a list of search results after the program:

1. Calls the SearchTwitter method.
2. Waits for the SearchSuccessful event.

The value of the property will then be the same as the parameter to SearchSuccessful. Note that it is not necessary to call the Authorize method before calling SearchTwitter.

Username

The user name of the authorized user. Empty if there is no authorized user.