Hey, Ten A.

Thx for taking the time to answer.

Actually, I had made a little mistake, and was entering wrong numbers as the arguments for "itemByRange()", so the returned object seemed to be empty, and thus, nothing worked.

Nonetheless, as soon as I discovered that mistake, I spent some hours to make it work.

What I was trying to accomplish, was to find text in just a page range of my document.

So, if anyone is interested, the snippet of code that I used for obtaining a clean array containing the findings of a "find" statement only in a range of pages, is this (sorry, it's a little cluttered, but I'm still learning on it. It's meant only for learning purposes):

case pagesRangeRB:
var fromPageNum     :int     = (new Number(ini_TI.text) - 1) as int;
var toPageNum     :int     = (new Number(fin_TI.text) - 1) as int;
var pagesRange     :Object     = 
inDesignDocument.pages.itemByRange(fromPageNum,toPageNum);
 
 
var framesRange1     :TextFrames          = pagesRange.textFrames;
                                   
foundText = new Array();
                                   
                                   
//There's no need for traversing the array of TextFrames. Actually, the search is performed 
//     in the whole array of frames, when you search in the first one, and an error is dispatched
//     when one searches within other TextFrames.
var iTextFrames               :int      = 0 ;
var foundTextByFrame     :Array     = 
     (framesRange1.item(iTextFrames) as TextFrame).findText() as Array;
                                   
for (var iFindText:int = 0 ; iFindText < foundTextByFrame.length ; iFindText++)
{
     if (foundTextByFrame[iFindText] is Array)
     {
          var currentFoundTextByFrameArray     :Array = foundTextByFrame[iFindText] as Array; 
                              
     if ( currentFoundTextByFrameArray.length > 0 )
     {
          for (var iFoundTextByFrame:int = 0 ; iFoundTextByFrame < currentFoundTextByFrameArray.length ; iFoundTextByFrame++)
          {
               var textItemToPush     :com.adobe.indesign.Text     = currentFoundTextByFrameArray[iFoundTextByFrame] as com.adobe.indesign.Text;
                  foundText.push( currentFoundTextByFrameArray[iFoundTextByFrame] );
          }
        }
     }
     else
     {
          if ( foundTextByFrame[iFindText] != null )
       {
          foundText.push( foundTextByFrame[iFindText] );
       }
     }                                   
}     
break;

_______

The main two problems, I think, with CS_SDK is that:

1- Documentation is poor

2- Many method results are not strong typed, and thus, they are masked when called from Flash/Flex Builder, because the only thing you see is a CSHostObject, which you don't know whether represents a Text, and Array, or anything else, and which doesn't present you neither with properties nor methods whatsoever.

To overcome this, I'm starting to use a "trace()" statement after I declare any variable by using one of this methods that return ":Object" (or CSHostObject, which is how I see them in Flash builder)