Método Icom3270.getScreenData

El método getScreenData extrae el contenido de los datos de la pantalla 3270.

Sintaxis

  
void GetScreenData(  
   ushort position,  
   ushort dataRequested,  
   ushort maxLen,  
   out System.Array dbuf,  
   out System.Array abuf,  
   out System.Array eabuf  
)  

Parámetros

Parámetro Descripción
position Desplazamiento de pantalla basado en 0 del primer carácter solicitado.
dataRequested Combinación bit a bit que describe los datos solicitados. Para obtener más información, vea la sección Comentarios.
maxLen Número máximo de posiciones .screen solicitadas.

Al establecer maxLen en 0, se solicita el resto de la pantalla.
dbuf Cuando este método devuelve un resultado, contiene los datos del búfer de datos de pantalla, si se solicita.
abuf Cuando este método devuelve un resultado, contiene los datos del búfer del atributo de caracteres de pantalla, si se solicita.
eabuf Cuando este método devuelve un resultado, contiene los datos del búfer de atributos extendidos de pantalla, si se solicita.

Valor devuelto

Value Descripción
S_OK El método ha devuelto correctamente
C3270_E_INVALIDPOS La posición de la pantalla especificada es mayor que la posición máxima del carácter para el tamaño de pantalla actual.
C3270_E_NOTCONNECTED El cliente com3270 no está conectado a una sesión mediante una llamada a Icom3270.connect.
C3270_E_SYSERROR Error en el método debido a un error interno.

Excepciones

Notas

Puede solicitar cualquier combinación de los caracteres que se pueden mostrar, los atributos de caracteres y los atributos extendidos de la pantalla.

Tenga en cuenta que los datos devueltos se encuentran en una o varias SAFEARRAYS. Es responsable de liberar SAFEARRAYS después del procesamiento.

En la tabla siguiente se describen los valores posibles de dataRequested.

Valor Descripción
1 Mostrar datos de búfer
2 Datos del búfer de atributos de caracteres
4 Datos de búfer de atributos extendidos