Post here any things you want implemented in the scripting API.

I will update this post to include all suggestions made.

Enhancements to existing features

Not currently possible with scripts

• Debug window to include filename as well as line number
  
• Pointers for functions (for API Callbacks) (2 people want this)
  
• Options dialogue accessable from the scripts menu
  
• Version number, about dialogue, homepage address all accessable from the scripts dialogue
  
• Prototype method to add functions to objects. (hard to explain, so I provided a link) (2 people want this)
  
• Enumerate timers (so we can retreive/check which timers are currently running)
  
• A function to see how many milliseconds there are left on a timer
  
• Being able to have received messages longer than they originally are
  
• Being able to format received messages
  
• Aborting scripts in case of an infinate loop

• OnEvent_ChatWndReceiveMessage to include all types of messages (i.e. file transfer, nudges)
  
• Getting the font and font colour of contacts.
  
• Sortable listview columns (2 people want this)
  
• Making scripts to be able to actually use the TranslationId property in the Window element.
  
• The e-mail of the user to be added as a param to Origin in ChatWndReceiveMessage Patchou has said this is impossible

• The ability to perform action messages seen by both users, or just the local user. (3 People want this)
  
• Add to chat log, i.e. the ability to add an item to a conversation chat log (2 people want this)
  
• The ability to change a contact's name in the contact list only.
  
• Changing the size and opacity of buttons
  
• Update system (the ability to automatically download the new plsc file, uninstall the current version, and install the new version)
  
• Being able to stop and restart scripts
  
• OnEvent_EmailReceived (2 People want this)
  
• Greater control over file transfers
  
• OnProcessEvent_Terminate

• A function to work out contacts MSN ID's
  
• The ability to set a personal message natively
  
• The ability to add your own submenu's in the right click context menu in the contactlist (in the "msgplus extras" menu) both for contacts as for groups.
  
• A function to calculate the user hashes in the registry (2 people want this)

• Debug Window to include filename as well as line number

• Making scripts to be able to actually use the TranslationId property in the Window element.
  
• An explanation why I can't anchor childwindow elements to the parent window so they resize with it?
  
• ... (can be updated)

quote:

---

Originally posted by Mattike
An explanation why I can't anchor childwindow elements to the parent window so they resize with it?

---

Getting the font and font color of the contact you are talking to would help a lot.

I think this has been requested before, but I'm not sure if its possible.

• A StripEmoticons function

the messages in the scripting system already have the shortcuts instead of the emoticons in them. just add "/noicon " before the message and voila

quote:

---

Originally posted by Jesus
the messages in the scripting system already have the shortcuts instead of the emoticons in them. just add "/noicon " before the message and voila

---

Can you add:

Convo Window function to perform an action message sent to both users (The messages with ----------- above and below them), like in the Add-ins API.

Convo Window function to perform an action message seen only by the current user.


Don't know how possible those are, but they'd be very handy.

quote:

---

Originally posted by alexp2_ad
Can you add:

Convo Window function to perform an action message sent to both users (The messages with ----------- above and below them), like in the Add-ins API.

Convo Window function to perform an action message seen only by the current user.


Don't know how possible those are, but they'd be very handy.

---

Well when you send a nudge, it has this:

_____________________________
You have just sent a nudge!
_____________________________

An action message is that, but with any you want

Incidently this feature will be in Stuffplug 3.

quote:

---

Originally posted by saralk
can you rephrase that, i'm not quite sure what you mean

---

A method to get a pointer for functions (so that we can use API callbacks)

oh and a way to display text into the conversation that wont get sent (useful for debugging/ notifying the user)

quote:

---

Originally posted by fatfreechicken

But that adds characters to the message and the due to limitations the length of text sent to the chat window cannot exceed it's original length... Or am I missing something here?

---

quote:

---

Originally posted by fatfreechicken

quote:

---

Originally posted by Jesus
the messages in the scripting system already have the shortcuts instead of the emoticons in them. just add "/noicon " before the message and voila

---

But that adds characters to the message and the due to limitations the length of text sent to the chat window cannot exceed it's original length... Or am I missing something here?

---

Three words, "sortable listview columns"

quote:

---

Originally posted by CookieRevised
* My main request is to first fix existing stuff, before adding new stuff...
eg: "CookieRevised's reply to [BUG] WriteString() doesn't handle BSTR's as BSTR's"

---

quote:

---

Originally posted by saralk
Since bugs would take priority over features, I wont include them in here, Patchou would probably fix all the existing bugs before he adds any new features.

---

* The ability to perform action messages seen by both users, or just the local user. (2 People want this)
* A function to calculate the user hashes in the registry
* Add to chat log, i.e. the ability to add an item to a conversation chat log

These would be very nice, I suppose. Also, as requested here -- http://shoutbox.menthix.net/showthread.php?tid=65...d=722675#pid722675 — the ability to properly change contact's nicknames in contact list would be nice (for example, to display their status behind the nick, or another features, I am sure there will be many many different nice things possible to do with scripts if nicknames in contact list / conversations (separate from each other) would be editable).

quote:

---

A method to get a pointer for functions (so that we can use API callbacks)

---

quote:

---

Originally posted by Mothuim
Three words, "sortable listview columns"

---

I am not a coder myself, but I think Scripts miss a lot of features they should have. Scripts are like Extensions in Firefox, IMO. They are neat little tools to add functions to Messenger quickly and easily. Yet, they lack several things Firefox Extensions have and I find that very important. Well, they are...

1. Versions
This is very important. I find it very annoying that I can't track whether this bug in a script is fixed or not. Is my script outdated, etc. I think this is crucial.

2. Options Dialogue
Well, scripts can have an option dialogue, but I think it'd be more useful if there's an options button in the scripts preferences menu. It is more organized that way, rather than clicking options in the contact list only.

3. Homepage of a script
People can check for news of the script, etc.

4. About Dialogue
We can actually know what they do with this, in case we forget.

5. Script Menus are in a compact menu
In the plus' icon's dropdown menu, both the one in conversation windows and the one in contact list, scripts menus (options, etc) are just in a stack of pile. This makes the dropdown menu very long if you have a lot of script. Making it a compact menu would be lovely.

Multiline support for the RichStaticControl !!

Setting the size of the text in RichStaticControl

Add prototype support for msgplus objects so we can add methods and variables to msgplus objects.

quote:

---

Add prototype support for msgplus objects so we can add methods and variables to msgplus objects

---

That's easy with Interop functions, one line each but that's a bit besides the point

i'd like the ability to disable logs for a specific event, if its possable, althought i doubt it is

quote:

---

Originally posted by deAd
That's easy with Interop functions, one line each but that's a bit besides the point

---

quote:

---

Originally posted by NiteMare
i'd like the ability to disable logs for a specific event, if its possable, althought i doubt it is

---

code:

---

OnEvent_EventLogEventAdded(
    [string] Origin,
    [string] Description,
    [enum] Icon
);

---

code:

---

OnEvent_ChatLogEventAdded(
    [string] Origin,
    [string] Description
);

---

E-Mail Count.

As the list grows, I think there must a distinction be made between stuff which is already possible by scripting and things which aren't possible with scripting.

--------------

Another suggested not possible with scripting and which would be highly used if available: The ability to add your own submenu's in the right click context menu in the contactlist (in the "msgplus extras" menu) both for contacts as for groups. And the click events would obviously also return the groupname or contactemail.

(for the groups, you can't do much with the groupname yet, but I think it should be returned nevertheless or to be taken in account for later use )

Agreed.

The "sortable listview column" idea can be done already just by using a sorting algorithm and making in into a function. I would have the parameter as; sLVControlID, bDescending, iColumnID, ofcourse thats coming from a multilingual background , so I'm guessing you would have to keep to your preferred variable naming syntax for consistency.

quote:

---

Originally posted by CookieRevised
As the list grows, I think there must a distinction be made between stuff which is already possible by scripting and things which aren't possible with scripting.

---

some corrections on the categories:

# Sortable listview columns (2 people want this)
# Making scripts to be able to actually use the TranslationId property in the Window element.

both are also not impossible todo with scripting.

----------

# Version number, about dialogue, homepage address all accessable from the scripts dialogue

All this is the responsebility of the scripter himself tbh. If the scripter does not provide an about dialog with the info in it, doesn't provide a version number inside the ScriptInfo and script code, etc, Plus! wouldn't be able todo anything about it.

What might be new is a config button in the scripts preference dialog of Plus!, just like in Plus!3, but all the other stuff is really the responsebility of the programmer.

----------

# A function to calculate the user hashes in the registry (2 people want this)

this is possible, if the method is getting documented that is.

quote:

---

Originally posted by CookieRevised
# Version number, about dialogue, homepage address all accessable from the scripts dialogue

All this is the responsebility of the scripter himself tbh. If the scripter does not provide an about dialog with the info in it, doesn't provide a version number inside the ScriptInfo and script code, etc, Plus! wouldn't be able todo anything about it.

What might be new is a config button in the scripts preference dialog of Plus!, just like in Plus!3, but all the other stuff is really the responsebility of the programmer.

---

my recent wish (totally not possible atm): enumerate timers...

at the moment there is no way to retrieve/ check what times are running. If there was a way to determine this, developpers can more easly (and more elagant) check for important things like timers which are still running when another user signs in (common mistake to make in scripts which use timers).

example of workaround (which I actually turned into a 'feature', see disclaimer) and more notes about this in my script nudge flood protection.


EDIT: and while at it, a function to see how many time (in ms) there is left for a specific timer.

quote:

---

Originally posted by CookieRevised
my recent wish (totally not possible atm): enumerate timers...

at the moment there is no way to retrieve/ check what times are running. If there was a way to determine this, developpers can more easly (and more elagant) check for important things like timers which are still running when another user signs in (common mistake to make in scripts which use timers).

example of workaround (which I actually turned into a 'feature', see disclaimer) and more notes about this in my script nudge flood protection.


EDIT: and while at it, a function to see how many time (in ms) there is left for a specific timer.

---

quote:

---

Originally posted by saralk
The e-mail of the user to be added as a param to Origin in ChatWndReceiveMessage

---

quote:

---

Originally posted by Patchou
So you honestly think I would send you the name of the contact if I could send you his email?

Messenger Plus! itself has no idea what the email of the contact is when a message is received in a chat. That's because messages are analysed when inserted in the edit box, not when received in the protocol stream (and there's a lot of other advantages to that).

So there's no way I can help you on this. What I can tell you though is that Messenger Plus! has always worked this way for some features, by guessing, and nobody ever complained about it. Changes that somebody is talking to multiple contacts in the same window who have the exact same names are very poor.

---

quote:

---

Originally posted by saralk
Getting the font and font colour of contacts.

---

quote:

---

Originally posted by saralk
Options dialogue accessable from the scripts menu

---

quote:

---

Originally posted by Matty

quote:

---

Originally posted by saralk
Getting the font and font colour of contacts.

---

Why? What is the point of adding a feature that has only 1 purpose? Which is to set the font style and colour to imitate your contact. No one has created a chat logging system (that I am aware of).

---

quote:

---

Originally posted by phalanxii
Yes, I would like something like this as well. Perhaps events like:

code:

---

OnEvent_EventLogEventAdded(
    [string] Origin,
    [string] Description,
    [enum] Icon
);

---

and

code:

---

OnEvent_ChatLogEventAdded(
    [string] Origin,
    [string] Description
);

---

The events could work like OnEvent_ChatWndSendMessage, requiring a return value of Description (so that if it's empty, the event is not added).

---

quote:

---

Originally posted by markee

quote:

---

Originally posted by CookieRevised
my recent wish (totally not possible atm): enumerate timers...

at the moment there is no way to retrieve/ check what times are running. If there was a way to determine this, developpers can more easly (and more elagant) check for important things like timers which are still running when another user signs in (common mistake to make in scripts which use timers).

example of workaround (which I actually turned into a 'feature', see disclaimer) and more notes about this in my script nudge flood protection.


EDIT: and while at it, a function to see how many time (in ms) there is left for a specific timer.

---

If you want to be creative using global variables you can check the first one about if a timer is currently in use (though there will be a very small amount of time either side where it will still say that it is being used), though it would be good for us to be able to check rather than have to rely on extra variables.  Though the second one would become very useful i think.

---

quote:

---

Originally posted by CookieRevised

quote:

---

Originally posted by markee

quote:

---

Originally posted by CookieRevised
my recent wish (totally not possible atm): enumerate timers...

at the moment there is no way to retrieve/ check what times are running. If there was a way to determine this, developpers can more easly (and more elagant) check for important things like timers which are still running when another user signs in (common mistake to make in scripts which use timers).

example of workaround (which I actually turned into a 'feature', see disclaimer) and more notes about this in my script nudge flood protection.


EDIT: and while at it, a function to see how many time (in ms) there is left for a specific timer.

---

If you want to be creative using global variables you can check the first one about if a timer is currently in use (though there will be a very small amount of time either side where it will still say that it is being used), though it would be good for us to be able to check rather than have to rely on extra variables.  Though the second one would become very useful i think.

---

can you explain what you're on about here as I don't understand it..... What I suggested is a function to enumerate timers, dunno what this has todo with "being creative with global variables"...

---

quote:

---

Originally posted by Matty

quote:

---

Originally posted by saralk
Getting the font and font colour of contacts.

---

Why? What is the point of adding a feature that has only 1 purpose? Which is to set the font style and colour to imitate your contact. No one has created a chat logging system (that I am aware of).

---

quote:

---

quote:

---

Originally posted by saralk
Options dialogue accessable from the scripts menu

---

Again why? This is up to the Programmer of the script to add in the menus.

---

quote:

---

quote:

---

Originally posted by saralk
Options dialogue accessable from the scripts menu

---

Again why? This is up to the Programmer of the script to add in the menus.

---

My own suggestion: some way of aborting scripts if it goes into an infinate loop.

quote:

---

Originally posted by NiteMare

quote:

---

Originally posted by phalanxii
Yes, I would like something like this as well. Perhaps events like:

code:

---

OnEvent_EventLogEventAdded(
    [string] Origin,
    [string] Description,
    [enum] Icon
);

---

and

code:

---

OnEvent_ChatLogEventAdded(
    [string] Origin,
    [string] Description
);

---

The events could work like OnEvent_ChatWndSendMessage, requiring a return value of Description (so that if it's empty, the event is not added).

---

no you mis understood
i wan thte ability to have an event NOT loged, such as for my count down script, i would like the logs not to show teh DOZENS of log entrys it will make

---

An update feature...
I have an auto update in one of my scripts which downloads the new .plsc, and automaticaly executes it. But this does not update the currently running script (I believe the script is loaded in the memory?)
Or perhaps the ability to restart the script... (something like Script.Restart()). talking 'bout that.. maybe stopping the script too, when your script detects some critical error, that it gives a message to contact the author and automaticaly stops itself (Script.Stop())

And also, I would like a way to get the quickname of contacts... WLM has the option the give a contact a custom name, different then theirs... I really would like a way to get that name

But mainly that update feature, or the ability to restart the script...

ok dont get up me for reviving this old thread but i have a good idea

i hate how you have to go to you contacts list to get the debug window up.

my idea is put it into the scripting window and have it automaticly go to the script that you are working on


********

another idea is when adding a comment into a script ( /* comment */ ) it should turn an orange colour like this /* comment */ so that it is easier to read them

quote:

---

Originally posted by NanaFreak
ok dont get up me for reviving this old thread but i have a good idea

---

quote:

---

Originally posted by NanaFreak
i hate how you have to go to you contacts list to get the debug window up.

my idea is put it into the scripting window and have it automaticly go to the script that you are working on

---

quote:

---

Originally posted by NanaFreak
another idea is when adding a comment into a script ( /* comment */ ) it should turn an orange colour like this /* comment */ so that it is easier to read them

---

quote:

---

Originally posted by NanaFreak
so that it is easier to read them

---

quote:

---

Originally posted by Jesus
the debug window's background color is theme specific

---

quote:

---

Originally posted by NanaFreak
i wasnt talking about the debug window there... i was talking about in the scripting window where you write the /* */

---

I'd realy like to have more control over the file transfers, like Messenger.FileTransfers returns a FileTrans object which can be iterated to retrieve a FileTran object with methods like FileTran.Stop, and Properties like FileTran.FileName, FileTran.FileSize, FileTran.Speed, FileTran.Direction (return enumerator, 0 = inbound, 1 = outbound).

Also, if a message is received, the raw package seems to include the email too, so maybe it's not that impossible to include the email as a parameter in the OnEvent_ChatWndReceiveMessage, I intercepted 2 interesting packages with Xniff:


« (283) MSG email@gmail.com his%20name 89  MIME-Version: 1.0  Content-Type: text/x-msmsgscontrol  TypingUser: email@gmail.com
   
« (325) MSG email@gmail.com his%20name 130  MIME-Version: 1.0  Content-Type: text/plain; charset=UTF-8  X-MMS-IM-Format: FN=MS%20Shell%20Dlg; EF=; CO=0; CS=0; PF=0    heya


As you can see (i changed the emailadress a bit of course) the email address is sent, followed by the name that is going to be displayed (if you change this, you got that chat-only-name feature, i guess) and at the end somewhere is the actual message.
Also the first message shows an incoming "<user> is typing." message, which you can block if outbound, so nobody can see that you are typing (a script request for this has been made actually)

Maybe it's an idea to include the raw package as a parameter in OnEvent_ChatWndReceiveMessage and OnEvent_ChatWndSendMessage, and/or make 2 events like OnEvent_ReceiveRawPackage and OnEvent_SendRawPackage (triggered before actual sending, so you can edit it), so that you can have just that little bit of extra control over the raw packages.

quote:

---

Originally posted by Plan-1130
so maybe it's not that impossible to include the email as a parameter in the OnEvent_ReceivedMessage

---

Plan-1130, Plus! doesn't use packet sniffing. It uses as little as possible the protocol.

quote:

---

Originally posted by CookieRevised
Plan-1130, Plus! doesn't use packet sniffing. It uses as little as possible the protocol.

---

quote:

---

Originally posted by scripting docs
This event is generated some time (generally within 10 seconds) after the current user signs in the Messenger service. Messenger Plus! waits until no more "ILN - initially online" message is received from the server.

---

quote:

---

It uses as little as possible the protocol.

---

quote:

---

Originally posted by Jesus
If you were replying to my suggestion here, but I meant an OnEvent_EmailReceived event, fired when you receive a new email message.
If you meant the OnEvent_ChatWndReceiveMessage, an Email parameter would be cool, but if it was possible to determine which contact the message came from (this is currently impossible for MP!L) I'd rather have a Contact object added as a parameter.

---

quote:

---

Originally posted by CookieRevised
It uses as little as possible the protocol.

---

quote:

---

Originally posted by Plan-1130
if a message is received, the raw package seems to include the email too, so maybe it's not that impossible to include the email as a parameter in the OnEvent_ChatWndReceiveMessage, I intercepted 2 interesting packages with Xniff:


« (283) MSG email@gmail.com his%20name 89  MIME-Version: 1.0  Content-Type: text/x-msmsgscontrol  TypingUser: email@gmail.com
   
« (325) MSG email@gmail.com his%20name 130  MIME-Version: 1.0  Content-Type: text/plain; charset=UTF-8  X-MMS-IM-Format: FN=MS%20Shell%20Dlg; EF=; CO=0; CS=0; PF=0    heya

---

That is why i requested MsgPlus to include the raw package, the email, or the contact as a parameter... Or even an OnEvent_ReceiveRawPackage and OnEvent_SendRawPackage...
If those last 2 could be added, it would be so cool. I'd love to learn a bit more about the raw packages, it would give so much control if you know it all.
I'd even beg Cookie for helping me with Regular Expressions, i truly still don't get the syntax, and raw packages are almost impossible to split using .split() method.

If this won't be added for some reason, and someone has the time, and feels like it, and knows how to, and is willing to etc. We could try to make a dll that intercepts raw packages. Not a packet sniffer, but an intercepter, one that holds them, processes them and passes them through, and maybe can send them too.
Not that I know how to do it, but I'd die to learn how to do it.

NEW IDEA: Maybe it's a good thing to change the Timer feature so that it calles a function you define, other that calling OnEvent_Timer with the id as a parameter.
Ex:

code:

---

function OnEvent_ChatWndReceiveMessage(ChatWnd, Origin, Message, MessageKind)
{
MsgPlus.AddTimer("DelayedFunction(\"first parameter\",ChatWnd)", 1500);
}

function DelayedFunction(Text, Window)
{
Window.SendMessage(Text);
}

---

quote:

---

Originally posted by Patchou
So you honestly think I would send you the name of the contact if I could send you his email?

Messenger Plus! itself has no idea what the email of the contact is when a message is received in a chat. That's because messages are analysed when inserted in the edit box, not when received in the protocol stream (and there's a lot of other advantages to that).

So there's no way I can help you on this. What I can tell you though is that Messenger Plus! has always worked this way for some features, by guessing, and nobody ever complained about it. Changes that somebody is talking to multiple contacts in the same window who have the exact same names are very poor.

---

well I guess you're right when you say it's nothing safer, but what I would like to do is send parameters too, including objects.
Ah, maybe just forget that thing...

quote:

---

Originally posted by Patchou
So you honestly think I would send you the name of the contact if I could send you his email? (Smilie)

Messenger Plus! itself has no idea what the email of the contact is when a message is received in a chat. That's because messages are analysed when inserted in the edit box, not when received in the protocol stream (and there's a lot of other advantages to that).

So there's no way I can help you on this. What I can tell you though is that Messenger Plus! has always worked this way for some features, by guessing, and nobody ever complained about it. Changes that somebody is talking to multiple contacts in the same window who have the exact same names are very poor.

---

I understand what you're saying, but one of the reasons the protocol is used as little as possible is security (Plus! has been blamed to cause a whole range of connection problems before, even when it didn't used anything from the protocol and didn't interfeared with the protocol at all). And there are probably many more reasons why it is done as it is done now.

If things where so easy (and to show it isn't that easy to make a always working, no interfearing, reliable sniffer and stuff look at the few sniffers around which don't always work), it would have been done that way...

I'm not disputing the fact that more things could be done when the protocol is used, but only noting that there are reasons why something isn't done (yet).

------------

quote:

---

Originally posted by Plan-1130
well I guess you're right when you say it's nothing safer, but what I would like to do is send parameters too, including objects.

---

when markee and i were trying to set control text of a Text Element it wouldnt work... so then we looking into the scripting docs and we found out that you cant set the control text of it. we know a way of making it work (by hard coding it) but we really wanted to be able to use:

code:

---

WndId.SetControlText(ControlId, Stuff to put);

---

quote:

---

Originally posted by NanaFreak
when markee and i were trying to set control text of a Text Element it wouldnt work... so then we looking into the scripting docs and we found out that you cant set the control text of it. we know a way of making it work (by hard coding it) but we really wanted to be able to use:

code:

---

WndId.SetControlText(ControlId, Stuff to put);

---

to do it... maybe in a future release?

---

quote:

---

Originally posted by deAd
You can't change any element's properties after the window is created. If you want to change the text at runtime make it a StaticControl.

---

NanaFreak didn't give enough information, it was a custom look of a Radio Control so you can only use an Element hence why we are having the problem with the TextElement.  I wish we could change it to a StaticControl or to be able to send text to a TextElement.

quote:

---

Originally posted by markee
NanaFreak didn't give enough information, it was a custom look of a Radio Control so you can only use an Element hence why we are having the problem with the TextElement.  I wish we could change it to a StaticControl or to be able to send text to a TextElement.

---

quote:

---

Originally posted by deAd
Now I see your point. This is a dirty solution, but it'll work:
(1) Make a CustomLook RadioButton with no text
(2) Place a StaticControl next to it on the window
(3) Change the text of the StaticControl.

---

quote:

---

Originally posted by NanaFreak

quote:

---

Originally posted by deAd
Now I see your point. This is a dirty solution, but it'll work:
(1) Make a CustomLook RadioButton with no text
(2) Place a StaticControl next to it on the window
(3) Change the text of the StaticControl.

---

thanks for the idea but it wont work because when you click on the Radio Control the text goes from normal to bold

we were think of making multiple xml's for each language to fix it but then we thought it would be too much work for the translators / us and also when getting a new language it would be difficult

---

We've discussed it and are going to use your dirty method and use 2 static controls for each radio control to be able to get the text size and bolding (for one of them) without hard coding it.  Though this would be much better if we had this ability rather than doing this dirty method, maybe we'll be lucky and get this functionality soon....

quote:

---

Originally posted by saralk
Pointers for functions (for API Callbacks) (2 people want this)

---

quote:

---

Originally posted by saralk
Sortable listview columns (2 people want this)

---

quote:

---

Originally posted by saralk
Changing the size and opacity of buttons

---

You've
The e-mail of the user to be added as a param to Origin in ChatWndReceiveMessage

listed twice. one with .... and one normal on the same list.

I would like greater control over file transfer

Usable TreeViewControl!

quote:

---

Originally posted by saralk
Pointers for functions (for API Callbacks) (2 people want this)

---

This has been mentioned before, but I would like to be able to detect action messages, nudges and that kind of stuff in OnEvent_ChatWndReceiveMessage (or maybe a seperate event)



Oh yeah, why isn't this thread sticky??

• Sortable listview columns
  
• Update system (the ability to automatically download the new plsc file, uninstall the current version, and install the new version)
  
• Being able to stop and restart scripts

quote:

---

Originally posted by Matty

quote:

---

Originally posted by saralk
Pointers for functions (for API Callbacks) (2 people want this)

---

Patchou told me this isn't possible, however you never know.

---

quote:

---

One thing more to add to the scripting engine: The ability to call functions which return void. Currently, functions called with Interop.Call must return something. I'd like to call functions such OutputDebugString or Sleep which return nothing (void).

---

no, thanks I could do that DLL, but currently I don't need to call any of those APIs in my scripts. However, other people may need to call them, or I may want to call them in the future, that's why i suggested it to be included in Plus.

Anyway, if you have that DLL, you can upload it (if you want) therefore people can take benefit from it

quote:

---

Originally posted by tryxter
Update system (the ability to automatically download the new plsc file, uninstall the current version, and install the new version)

---

quote:

---

Originally posted by tryxter
Being able to stop and restart scripts

---

quote:

---

Originally posted by Choli
One thing more to add to the scripting engine: The ability to call functions which return void. Currently, functions called with Interop.Call must return something. I'd like to call functions such OutputDebugString or Sleep which return nothing (void).

---

I would like a function to grey out certain controls (eg. CheckBoxes) in PlusWnd objects

edit: and maybe even to make them (in)visible too...

Or a more VB-alike way of controlling the controls in a pluswnd, so that you can access and edit any property a control has through scripting.

Example: PlusWnd.ControlId.Property = value;

quote:

---

Originally posted by Eljay

quote:

---

Originally posted by Jesus
I would like a function to grey out certain controls (eg. CheckBoxes) in PlusWnd objects

---

If you mean to disable them, this should do the trick:

code:

---

Interop.Call("user32", "EnableWindow", PlusWnd.GetControlHandle("YourControl"), 0);

---

---

code:

---

Interop.Call("user32", "EnableWindow", PlusWnd.GetControlHandle("YourControl"), true);

---

code:

---

Interop.Call("user32", "EnableWindow", PlusWnd.GetControlHandle("YourControl"), false);

---

quote:

---

Originally posted by vikke
Actually it would be:
Enable:

code:

---

Interop.Call("user32", "EnableWindow", PlusWnd.GetControlHandle("YourControl"), true);

---

Disable:

code:

---

Interop.Call("user32", "EnableWindow", PlusWnd.GetControlHandle("YourControl"), false);

---

Because it's a BOOL over at MSDN

---

quote:

---

Originally posted by windef.h
#define FALSE    0
#define TRUE    1

---

lol I hadn't thought about Interop.Call yet, gonna try that now. Thanks for the tip.

Anyway I still want the VB-like way of editing properties like in the edit in my previous post...

quote:

---

Originally posted by Jesus
lol I hadn't thought about Interop.Call yet, gonna try that now. Thanks for the tip.

Anyway I still want the VB-like way of editing properties like in the edit in my previous post...

---

quote:

---

Originally posted by Eljay
I guess I could make a script/library that allowed for that sort of thing, but it would be complex (especially as we can't extend the Plus default objects (in this case PlusWnd)).

---

quote:

---

Originally posted by Jesus
would that make it just complex or impossible (for now)?

this is the thread for scripting API suggestions, so we could add "the possibility to extend Plus! default objects" to the list too (if it isn't already on the list, that is)

---

quote:

---

Originally posted by Eljay

quote:

---

Originally posted by vikke
Actually it would be:
Enable:

code:

---

Interop.Call("user32", "EnableWindow", PlusWnd.GetControlHandle("YourControl"), true);

---

Disable:

code:

---

Interop.Call("user32", "EnableWindow", PlusWnd.GetControlHandle("YourControl"), false);

---

Because it's a BOOL over at MSDN

---

quote:

---

Originally posted by windef.h
#define FALSE    0
#define TRUE    1

---

---

quote:

---

Originally posted by vikke
I know your code was working but it should be a bool

---

quote:

---

Originally posted by Script Docs > Interop.Call

If the parameter is a boolean, a number is sent: 1 for true, 0 for false.

---

I just got a nice idea for a feature! What do you think about creating a Plus! window based on an actual string instead of creating it based on a file name? That way, we could first load the XML in the script, make some changes and then create the window, like this:

code:

---

var txt = new ActiveXObject("Scripting.FileSystemObject").GetFile(MsgPlus.ScriptFilesPath + "\\Windows.xml").OpenAsTextStream(1, -1).ReadAll();
txt = txt.replace("helol", "hello");
var PlusWnd = MsgPlus.CreateWndFromString(txt, "WndPref");

---

code:

---

var node = xml.selectSingleNode("//Window[@Id='WndPref']");
var PlusWnd = MsgPlus.CreateWndFromNode(node);

---

It could have its uses I guess (although I don't know any which could be shorter than the normal method). eg: Not for translating as that could be done a lot easier and shorter by simply altering the controls' caption.

quote:

---

Originally posted by CookieRevised
It could have its uses I guess (although I don't know any which could be shorter than the normal method). eg: Not for translating as that could be done a lot easier and shorter by simply altering the controls' caption.

---

The ability to preview your PSM in colour?

eg with your name when you add colour you can see it but your psm displays the colour codes.

I agree with Mattike. And the great thing is not only to translate controls or reduce CPU... the great thing is that you can create a window with dynamic controls, ie: when developing the script, the developer may not know how many buttons his window should show. But in run time, the script can create a XML code that includes as many buttons as they're needed and then show the window.

quote:

---

Originally posted by Ashylay
The ability to preview your PSM in colour?

eg with your name when you add colour you can see it but your psm displays the colour codes.

---

quote:

---

Originally posted by Felu
[
3. The PSM space below the nice cannot show the PSM colored as Patchou still hasn't found a way on how to do it .

---

quote:

---

Originally posted by Eljay
The problem is you can only translate controls in this way, elements cant be translated. So a better suggestion would be some sort of PlusWnd.SetElementText() method to make translation easier.

---

Time for some bumping.  Anyway, I found something that I'd like.  The ability to cancel the closing of a Plus Window.  Something like returning false to the OnWindowidEvent_Destroyed function would suffice I think.  This way I could just hide the window for a moment even if the user has tried to close the window through the task bar or the X in the corner or something.

I would really like to have an OnProcessEvent_Terminate.

Why would this be beneficial to scripts? Simple. When dealing with system wide hooks, like hot keys. If the Windows Live Messenger process is terminated unexpectedly then you have all this cleanup to perform but no way of actually doing so. The benefit of this event would allow scripters to properly cleanup after themselves as if they would when OnEvent_Uninitialize is called.

Better yet instead of having a new event when the Windows Live Messenger process is terminated instead of just exiting why not allow the scripts to cleanup and call their Uninitialize event. This would make the most sense.

quote:

---

Originally posted by matty
I would really like to have an OnProcessEvent_Terminate.

Why would this be beneficial to scripts? Simple. When dealing with system wide hooks, like hot keys. If the Windows Live Messenger process is terminated unexpectedly then you have all this cleanup to perform but no way of actually doing so. The benefit of this event would allow scripters to properly cleanup after themselves as if they would when OnEvent_Uninitialize is called.

Better yet instead of having a new event when the Windows Live Messenger process is terminated instead of just exiting why not allow the scripts to cleanup and call their Uninitialize event. This would make the most sense.

---

quote:

---

Originally posted by markee
Time for some bumping.  Anyway, I found something that I'd like.  The ability to cancel the closing of a Plus Window.  Something like returning false to the OnWindowidEvent_Destroyed function would suffice I think.  This way I could just hide the window for a moment even if the user has tried to close the window through the task bar or the X in the corner or something.

---

quote:

---

Originally posted by Scripting docs
Return Value
A boolean value used by Messenger Plus! to ignore the request. If the function returns true, the cancel request is ignored, if it returns false (default the event is not handled), the window is destroyed.

---

I'd like an OnEvent_Import() as the initialize argument is also true when the script is enbaled =/

Ok, wow i forgot about this thread, i'll update the front page.

Also, if someone could tell me if any of the requests have been added?

quote:

---

Originally posted by MeEtc

quote:

---

Originally posted by markee
Time for some bumping.  Anyway, I found something that I'd like.  The ability to cancel the closing of a Plus Window.  Something like returning false to the OnWindowidEvent_Destroyed function would suffice I think.  This way I could just hide the window for a moment even if the user has tried to close the window through the task bar or the X in the corner or something.

---

This is already possible, using OnWindowidEvent_Cancel

quote:

---

Originally posted by Scripting docs
Return Value
A boolean value used by Messenger Plus! to ignore the request. If the function returns true, the cancel request is ignored, if it returns false (default the event is not handled), the window is destroyed.

---

---

I propose a new function for creating windows with a string and not just an .xml file.  This wouldmake translations easier and would mean that you wouldn't have those problems with unicode formatting, etc.  You could also have it more dynamic, like what as wanted in Adding labels to a window via script.

quote:

---

Originally posted by markee
I propose a new function for creating windows with a string and not just an .xml file.  This wouldmake translations easier and would mean that you wouldn't have those problems with unicode formatting, etc.  You could also have it more dynamic, like what as wanted in Adding labels to a window via script.

---

It has been a while since this thread was bumped and I didn't feel like making my own, new thread, so here goes.

I first wrote about this idea in markee's reply to Compatibility with Messenger 2009 Beta but it wasn't acknowledged.  I seriously think that it can't be too much effort for script developers to now have control over the colour of toasts and adding their own images to where the DP normally sits.  It would be very nice to have this ability so that toasts were easier to recognise if they were coming from a particular script.  Admittedly, I would love the ability to use my own plus window (even if we had to use the exact same dimensions), but I guess that would be asking a bit much when there are many other more valid features to be added first that are all scattered throughout this thread.

Commands like (!VER) sent to scripts before being parsed by Plus!?

quote:

---

Originally posted by SmokingCookie
Commands like (!VER) sent to scripts before being parsed by Plus!?

---

JScript code:

---

function OnEvent_ChatWndSendMessage(objChatWnd,strMessage) {
    Debug.Trace(strMessage);
    var Pattern = new RegExp("(!VER)","gim");
    if(strMessage.search(Pattern) > -1 && strMessage.search(Pattern) < strMessage.length) {
        strMessage = strMessage.replace(Pattern,"(!VER)\n" + Script.Name + ": " + Script.Version);
    }
    return strMessage;
}

---

quote:

---

Originally posted by Debugger
Windows Vista Home Premium Service Pack 1 (6.0.6001)
Windows Live Messenger 8.5.1018
Messenger Plus! Live 4.79.0.342
Messenger-skin: Windows Aero Messenger 2.0.2.

---

My bad you have to use this:

JScript code:

---

function OnEvent_ChatWndSendMessage(objChatWnd,strMessage) {
    Debug.Trace(tmpmsg);
}

---

I think scripts should be able to access information on the debug window (from the running script and others) as it would make it a lot easier for novice users to send bug reports.

"Click the option 'Copy Debug' and paste it here"

This was a personal request to Patchou in which I text messaged him and requested it and it is being considered for Script Developers.

The request was the ability to step through the script to see exactly which line is causing the error. I had an issue with a script where the line was something like

JScript code:

---

a(b(), c());

---

Well, let me focus on some issues I have with scripting.

First of all, I already reported it on the BETA testing forums (see [FixMe] Scripts: Colorization with Mosaic) but apparently no-one had a look at it yet:

quote:

---

An ImageElement with a Mosaic set to something like ResizeToFit doesn't get its colorization applied. This is very annoying when you have an image which you want as a background for a whole area, but you also want it to match the window color.

The code I'm using:

XML code:

---

<!-- Images: Me-Area Preview -->
<Element xsi:type="ImageElement" Id="ImgMeMain">
   <Position Left="12" Top="5" Width="568" Height="129">
      <Anchor Horizontal="LeftRightFixed" Vertical="BottomFixed"/>
      <Units>AllPixels</Units>
   </Position>
   <Image>
      <Name>mearea-main</Name>
   </Image>
   <Mosaic>ResizeToFit</Mosaic>
   <Colorization Enable="true">
      <Color><GlobalColor>ref</GlobalColor></Color>
   </Colorization>
</Element>

---

---

JScript code:

---

var fCtrlClickEvent = function(PlusWnd, CtrlId) {
   if(CtrlId === "BtnThis") {
      myClass.doThis(PlusWnd);
   }
};
PlusWnd.AddEvent("CtrlClicked", fCtrlClickEvent);

---

code:

---

this.myButton.Click += new System.EventHandler(this.myButton_Click);

---

Something to compress stuff to a ZIP file..?

I agree with SmokingCookie that would be good, also can someone give me an example of retreiveing a contacts font name and colour.

quote:

---

Originally posted by SourSpud
I agree with SmokingCookie that would be good, also can someone give me an example of retreiveing a contacts font name and colour.

---

(Better) support for tabbed chats..?

quote:

---

Originally posted by SmokingCookie
(Better) support for tabbed chats..?

---

A method of halting script execution by X milliseconds.  For example:

Javascript code:

---

function Two()
{
    PartOne();
    MsgPlus.Pause(500);    PartTwo();
}

---

Javascript code:

---

function Two()
{
    PartOne();
    MsgPlus.AddTimer("Two", 500);
}
 
function OnEvent_Timer(TimerId)
{
    if (TimerId === "Two")
    {
        PartTwo();
    }
}

---

quote:

---

Originally posted by whiz

JScript code:

---

    MsgPlus.Pause(500);

---

---

quote:

---

Originally posted by Choli

quote:

---

Originally posted by whiz

JScript code:

---

    MsgPlus.Pause(500);

---

---

Maybe you can use Interop.Call to call the function Sleep

---

quote:

---

Originally posted by Felu
Yeah, but that would freeze the msnmsgr process as well

---

quote:

---

Originally posted by Choli

quote:

---

Originally posted by Felu
Yeah, but that would freeze the msnmsgr process as well

---

Aren't scripts executed in other thread than messenger's?

---

quote:

---

From the scripting documentation
Note: every function and properties of every object listed here is intended to be called from the main thread of the application. Functions and properties will fail or may create unexpected bugs if called from a different thread.

---

quote:

---

Originally posted by Choli

quote:

---

Originally posted by Felu
Yeah, but that would freeze the msnmsgr process as well

---

Aren't scripts executed in other thread than messenger's?

---

Then I see quite complex to pause the execution of a script without freezing or interfering with the messenger process.

Having a sleep() function seems like a very bad idea because it will be misused quite a lot. In fact, I can't see any good use for it. You should always use a timer instead.

A sleep function is sycroneous, and as long as each script doesn't have its own thread, it should realy not be used at all. Even when scripts are running in their own thread, Plus! would then not be able anymore to call other events at the appropiate time and custom interface windows will stop working; go blank, etc.

A function like sleep is only 'good' (mind the quotes; as it is actually never good) in a one-process-one-thread-no-gui environment.

Alright, how about this: dynamically add/edit/remove menu items in a MenuButtonControl (maybe in a similar way to OnGetScriptMenu() with the script menu).

quote:

---

Originally posted by whiz
Alright, how about this: dynamically add/edit/remove menu items in a MenuButtonControl (maybe in a similar way to OnGetScriptMenu() with the script menu).

---

I am bumping this thread because there is going to be talks surrounding the new scripting engine and I wanted to find out from everyone what they would like to see in Plus! 5 scripting engine.

Pretty much anything in this thread..? (Long as it's possible, of course)

Yeah I figured that but are there any suggestions outside of this thread? For instance Matti and I were discussing the possibility of being able to have controls some how be an object which you can assign a dynamic function to. Just as an example.

Or being able to assign dynamic callback functions to Windows. We haven't worked it out quite yet it was just an idea discussed.

As in .NET programming? Like MyForm.BtnHello = new Button(); or something?

how about much better dynamic window support? like not having to have it as a xml then edit the xml to change the window?

quote:

---

Originally posted by SmokingCookie
As in .NET programming? Like MyForm.BtnHello = new Button(); or something?

---

Javascript code:

---

var MyWnd = MsgPlus.CreateWnd("Interfaces.xml", "MyWnd");
// Acquire control object for a ListViewControl
var LvFiles = MyWnd.GetControl("LvFiles");
// Methods
LvFiles.AddItem("alpha.txt");
LvFiles.AddItem("beta.txt");
// Properties
Debug.Trace("Item count: "+LvFiles.ItemCount); // = 2
// Events
LvFiles.AddEventHandler("Clicked", OnLvFilesEvent_Clicked);
LvFiles.AddEventHandler("SelStateChange", function(ItemIdx, SelectedState) {
    Debug.Trace("Item #"+ItemIdx+" selection state changed to "+SelectedState);
    Debug.Trace("Item data: " + this.GetItemData(ItemIdx) );
});

---

• I believe it would be better to pass event callbacks as function objects instead of function names to prevent global scope saturation.
  
• The "this" context inside the event callback could be set to the control object. By doing so, you don't need to pass PlusWnd and ControlId as parameters to the function, you could access everything through the control object itself. If you still need the window or the control ID, the control object could have properties such as Control:arent and Control::ControlId.

quote:

---

Originally posted by NanaFreak
how about much better dynamic window support? like not having to have it as a xml then edit the xml to change the window?

---

I think this would indeed be better. But I thinkt the new engine should be backwards compatible.

quote:

---

Originally posted by SmokingCookie
I think this would indeed be better. But I thinkt the new engine should be backwards compatible.

---

Just had another idea: call script functions from the command line.

For example, you could make shortcuts to activate certain functions, or you could apply them to files, like in the SendTo menu, or as a context menu entry.

Maybe if it's called like this:

code:

---

C:\...\MPTools.exe /script <email> "<script name>" <function> <param1> <param2> ... <paramX>

---

code:

---

C:\...\MPTools.exe /script <email> "File Reader" OpenFile "%1" sendto

---

Javascript code:

---

OpenFile("C:\\Some File.txt", "sendto");

---

Well, I guess you'd need to specify which intance of Messenger is used to run the script function; could be done by typing an email address into the command line I think.

Something else that could be useful: being able to add menu options in to other places, such as the Plus! menu bar list, or the system tray icon menu.  Also, perhaps a way of just having a single option in the script menu (i.e. not a sub-menu) if only a single link is required.

Keep your ideas coming guys. I will be going in October to Montreal to work with the dev team to improve the scripting engine.

quote:

---

Originally posted by whiz
Something else that could be useful: being able to add menu options in to other places, such as the Plus! menu bar list, or the system tray icon menu.

---

quote:

---

Originally posted by whiz
Also, perhaps a way of just having a single option in the script menu (i.e. not a sub-menu) if only a single link is required.

---