Editing getCtlItemText - FilterMeisterWiki

When saving, enter the following:

                  ZZ  Z  Z            TTTT   
         |\     /|ZZ  Z  Z             TT    
 ##  ##  ( \   / )ZZ ZZZ Z   ####      TT    
  ####    \ (_) / ZZ ZZZ Z  ##  ##     TT    
   ##      \   /  ZZ ZZZ Z  ##  ##     TT    
  ####      ) (    ZZ ZZZ   ##  ##     TT    
 ##  ##     | |    ZZ  ZZ    ####     TTTT   
 ##  ##     \_/                ###

Visit Preferences to set your user name

= getCtlItemText =

== Syntax ==
{{int getCtlItemText(int n, int item, char* str)}}

== Arguments ==
:'''n'''
::The number of the control
:'''item'''
::The number of the item to retrieve
:'''str'''
::Pointer to a string where the result will be stored

== Return ==
Returns false if the control number is out of range or not in use, or if LB_ERR was returned by the internal Win32 SendMessage calls.  Returns true otherwise.

== Description ==
Gets the text of a ((COMBOBOX)), ((LISTBOX)) or ((TAB)) control item.

== Comment ==
This function only works with LISTBOX, COMBOBOX and TAB controls.  It will currently return true if used with other control types, even though the function didn't succeed.

== Example ==
<code>
%fml

ctl[0]: COMBOBOX(VSCROLL),
        Text="Harry\nLarry\nBarry\n"
        "Gary\nCarrie\nSally", Val=0,
        Size=(*,50)
ctl[6]: STATICTEXT, Text=""

OnCtl(n): {

// Display the selected text value
  if (n == 0) {
    getCtlItemText(0, ctl(0), str0);
    setCtlText(6, str0);
  }

return true;
}
</code>

== See Also ==
((deleteCtlItem)), ((deleteCtlItems)), ((setCtlItemText))

Summary of change:
Add document to category: