GRUPO DE LLAMADAS MOU


MouClose

MouClose cierra el controlador de ratón para la sesión actual.

#define INCL_BASE
#include <os2.h>

HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouClose(MouHandle);

Parámetros

MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouDrawPtr

MouDrawPtr elimina el área restringida por una llamada anterior a MouRemovePtr.

#define INCL_BASE
#include <os2.h>

HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouDrawPtr(MouHandle);

Parámetros

MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouFlushQue

MouFlushQue vacía la cola de eventos de ratón para la sesión actual.

#define INCL_BASE
#include <os2.h>

HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouFlushQue(MouHandle);

Parámetros

MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouGetDevStatus

MouGetDevStatus devuelve los flags de estado del controlador de ratón.

#define INCL_BASE
#include <os2.h>

PUSHORT DeviceStatus;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouGetDevStatus(DeviceStatus, MouHandle);

Parámetros

DeviceStatusPuntero a una posición de memoria donde OS/2 devolverá un conjunto de flags con el estado del controlador.
Bit Descripción
15-10 Reservados. Puestos a cero.
9 Activo si los datos son devueltos en mickeys en vez de en puntos.
8 Activo si el controlador de ratón no pinta el cursor en pantalla.
7-4 Reservados. Puestos a cero.
3 Activo si el cursor no es pintado en pantalla por estar ésta en un modo no soportado.
2 Activo si se está vaciando la cola de eventos.
1 Activo si se está leyendo un bloque.
0 Activo si la cola de eventos está bloqueada por una operación de entrada/salida.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouGetEventMask

MouGetEventMask devuelve los valores actuales de la máscara de eventos del ratón.

#define INCL_BASE
#include <os2.h>

PUSHORT EventMask;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouGetEventMask(EventMask, MouHandle);

Parámetros

EventMaskPuntero a una zona de memoria donde OS/2 devolverá la máscara de eventos actual, cuyos bits representan:
Bit Descripción
15-7 Reservados. Puestos a cero.
6 Activo si se devuelven pulsaciones del boton 3 sin movimiento del ratón.
5 Activo si se devuelven pulsaciones del boton 3 con movimiento del ratón.
4 Activo si se devuelven pulsaciones del boton 2 sin movimiento del ratón.
3 Activo si se devuelven pulsaciones del boton 2 con movimiento del ratón.
2 Activo si se devuelven pulsaciones del boton 1 sin movimiento del ratón.
1 Activo si se devuelven pulsaciones del boton 1 con movimiento del ratón.
0 Activo si se produce un evento al mover el ratón sin ningún boton pulsado.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouGetNumButtons

MouGetNumButtons devuelve el número de botones que soporta el controlador de ratón.

#define INCL_BASE
#include <os2.h>

PUSHORT NumberOfButtons;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouGetNumButtons(NumberOfButtons, MouHandle);

Parámetros

NumberOfButtonsPuntero a una posición de memoria donde OS/2 devolverá el número de botones soportados. Puede valer 1, 2 ó 3.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouGetNumMickeys

MouGetNumMickeys devuelve el número de mickeys por centímetro para el controlador de ratón instalado.

#define INCL_BASE
#include <os2.h>

PUSHORT NumberOfMickeys;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouGetNumMickeys(NumberOfMickeys, MouHandle);

Parámetros

NumberOfMickeysPuntero a una zona de memoria donde OS/2 devolverá el número de unidades físicas de movimiento del ratón. Estas se devuelven en mickeys por centímetro. Este valor es una constante definida en el controlador de ratón.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouGetNumQueEl

MouGetNumQueEl devuelve el estado de la cola de eventos del controlador de ratón.

#define INCL_BASE
#include <os2.h>

PMOUQUEINFO QueDataRecord;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouGetNumQueEl(QueDataRecord, MouHandle);

Parámetros

QueDataRecordPuntero a una estructura donde OS/2 devolverá los siguientes valores:
cEvents (USHORT) Número actual de elementos en la cola, en el rango 0 <= valor <= cmaxEvents.
cmaxEvents (USHORT) Máximo número de elementos que puede contener la cola.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouGetPtrPos

MouGetPtrPos devuelve la fila y columna actual del cursor del ratón.

#define INCL_BASE
#include <os2.h>

PPTRLOC PtrPos;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouGetPtrPos(PtrPos, MouHandle);

Parámetros

PtrPosPuntero a una estructura donde OS/2 devolverá los siguientes valores:
row (USHORT) Fila actual del cursor.
col (USHORT) Columna actual del cursor.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouOpen

MouOpen inicializa el soporte de ratón para la sesión actual.

#define INCL_BASE
#include <os2.h>

PSZ DriverName;
PHMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouOpen(DriverName, MouHandle);

Parámetros

DriverNamePuntero a una cadena con el nombre de dispositivo a usar. Si se usa el controlador por defecto (válido para casi todas las aplicaciones) se debe poner a cero (NULL).
MouHandlePuntero a una zona de memoria donde OS/2 devolverá el Handle de ratón para la sesión actual.

Codigos de error

0Sin error
385No hay ratón.
390Nombre de dispositivo no válido.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouReadEventQue

MouReadEventQue lee un evento desde la cola de eventos y coloca los datos en una estructura adecuada.

#define INCL_BASE
#include <os2.h>

PMOUEVENTINFO Buffer;
PUSHORT ReadType;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouReadEventQue(Buffer, ReadType, MouHandle);

Parámetros

BufferPuntero a una estructura donde OS/2 devolverá los siguientes valores:
fs (USHORT) Contiene los siguientes bits:
15-7 Reservado. Puestos a cero.
6 Boton 3 pulsado.
5 Boton 3 pulsado + movimiento de ratón.
4 Boton 2 pulsado.
3 Boton 2 pulsado + movimiento de ratón.
2 Boton 1 pulsado
1 Boton 1 pulsado + movimiento de ratón.
0 Solo movimiento de ratón.
time (ULONG) Tiempo (en milisegundos) desde que el sistema se ha conectado.
row (SHORT) Fila del cursor.
col (SHORT) Columna del cursor.
ReadTypePuntero a una posición de memoria donde estará almacenada la acción a tomar si la cola de mensajes está vacía: 0 no espera (devuelve un puntero a NULL); 1 espera a que halla un evento disponible.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
387Parámetro no válido.
393No hay datos en la cola de eventos.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouRemovePtr

MouRemovePtr permite definir un área para uso exclusivo de la aplicacion (collision area), la cual no estará disponible para pintar el puntero de ratón.

#define INCL_BASE
#include <os2.h>

PNOPTRRECT PtrArea;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouRemovePtr(PtrArea, MouHandle);

Parámetros

PtrAreaPuntero a una zona de memoria con los siguientes datos:
row (USHORT) Fila superior del área.
col (USHORT) Columna izquierda del área.
cRow (USHORT) Fila inferior del área.
cCol (USHORT) Columna derecha del área.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
387Parámetro no válido.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouSetDevStatus

MouSetDevStatus establece los flags de estado del controlador de ratón.

#define INCL_BASE
#include <os2.h>

PUSHORT DeviceStatus;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouSetDevStatus(DeviceStatus, MouHandle);

Parámetros

DeviceStatusPuntero a una posición de memoria con el conjunto de flags deseados para el estado del controlador.
Bit Descripción
15-10 Reservados. Poner a cero.
9 Activo si los datos deben ser devueltos en mickeys en vez de en puntos.
8 Activo si el controlador de ratón no debe pintar el cursor en pantalla (es necesario activarlo si se va a trabajar en modos gráficos).
7-0 Reservados. Poner a cero.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
387Parámetro no válido.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouSetEventMask

MouSetEventMask establece los valores actuales de la máscara de eventos del ratón.

#define INCL_BASE
#include <os2.h>

PUSHORT EventMask;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouSetEventMask(EventMask, MouHandle);

Parámetros

EventMaskPuntero a una zona de memoria con la máscara de eventos deseada, cuyos bits representan:
Bit Descripción
15-7 Reservados. Puestos a cero.
6 Activo si se devuelven pulsaciones del boton 3 sin movimiento del ratón.
5 Activo si se devuelven pulsaciones del boton 3 con movimiento del ratón.
4 Activo si se devuelven pulsaciones del boton 2 sin movimiento del ratón.
3 Activo si se devuelven pulsaciones del boton 2 con movimiento del ratón.
2 Activo si se devuelven pulsaciones del boton 1 sin movimiento del ratón.
1 Activo si se devuelven pulsaciones del boton 1 con movimiento del ratón.
0 Activo si se produce un evento al mover el ratón sin ningún boton pulsado.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG


MouSetPtrPos

MouSetPtrPos establece la fila y columna actual del cursor del ratón.

#define INCL_BASE
#include <os2.h>

PPTRLOC PtrPos;
HMOU MouHandle;
APIRET rc; /* Codigo de error */

rc = MouSetPtrPos(PtrPos, MouHandle);

Parámetros

PtrPosPuntero a una estructura conteniendo los siguientes valores:
row (USHORT) Nueva fila del cursor.
col (USHORT) Nueva columna del cursor.
MouHandleHandle de ratón devuelto por una llamada anterior a MouOpen.

Codigos de error

0Sin error
385No hay ratón.
387Parámetro no válido.
466MOU inactivo (proceso en Detached)
501Mouse no console
505MOU extended SG

 Indice