Operazioni con DataCell e Attribute

Questa macro illustra come utilizzare DataCell e AttributeSet per ispezionare testo e attributi in una determinata riga/colonna sullo schermo. In questo esempio si può vedere:

Come ottenere una raccolta di DataCell per una determinata posizione e lunghezza.
Come eseguire l'iterazione sui DataCell per creare una stringa di testo
Come, per confronto, è possibile eseguire un'operazione simile anche utilizzando getText().
E infine, come eseguire operazioni con gli attributi, ottenere un elenco di stringhe o determinare se stringhe specifiche sono impostate in una determinata posizione dello schermo.

var macro = createMacro(function*() {
  'use strict';
  
  // Ottenere PresentationSpace per interagire con l'host
  var ps = session.getPresentationSpace();
  
  // Dichiarare le variabili da utilizzare successivamente
  var cells;
  var text;
  var attrs;
  
  // Impostare il valore di timeout predefinito per le funzioni "wait"
  wait.setDefaultTimeout(10000);
  
  // Macro di esempio per operazioni con DataCell e Attributi
  try {
    yield wait.forCursor(new Position(24, 2));
    
    // Ottenere DataCell dallo spazio di presentazione.
    // Riga 19, col 3 è il prompt, lunghezza 35 caratteri
    // "Choose from the following commands:"
    cells = ps.getDataCells({row:19, col:3}, 35);
    text = '';
    
    // È possibile visualizzare il testo utilizzando getText
    yield ui.message("Screen text: " + ps.getText({row:19, col:3}, 35));
    
    // Oppure è possibile assemblare il testo da DataCell a ogni posizione
    for(var index = 0; index < cells.length; index++) {
      text = text.concat(cells[index].getChar());
    }
    // E visualizzare il testo
    yield ui.message("Cells text: " + text);
    
    // Ottenere gli attributi per la prima DataCell (cell[0])
    attrs = cells[0].getAttributes();
    
    // Visualizzare se sono presenti attributi nella cella dati
    yield ui.message("Attribute set is empty: " + attrs.isEmpty());
    
    // Visualizzare il numero di attributi impostato set
    yield ui.message("Number of attributes: " + attrs.size());
    
    // Visualizzare quali attributi sono impostati
    yield ui.message("Attributes: " + attrs.toString());
    
    // Ora visualizzare se l'attributo high intensity è impostato
    yield ui.message("Is high intensity: "
             + attrs.contains(Attribute.HIGH_INTENSITY));
    
    // Ora visualizzare se l'attributo underline è impostato
    yield ui.message("Is underline: "
             + attrs.contains(Attribute.UNDERLINE));
    
    // Ora visualizzare se sono impostati gli attributi alphanumeric, intensified e pen-detectable
    yield ui.message("Is alphanumeric, intensified and pen-detectable: "
             + attrs.containsAll([Attribute.ALPHA_NUMERIC, Attribute.HIGH_INTENSITY, Attribute.PEN_DETECTABLE]));
    
    // Ora visualizzare se sono impostati gli attributi underline, intensified e pen-detectable
    yield ui.message("Is underline, intensified and pen-detectable: "
             + attrs.containsAll([Attribute.UNDERLINE, Attribute.HIGH_INTENSITY, Attribute.PEN_DETECTABLE]));
  } catch (error) {
    yield ui.message(error);
  }
  //Fine della macro generata
});

// Eseguire la macro
return macro();