Objective-C selectores en Xamarin.iOS

  • Artículo

El Objective-C idioma se basa en selectores. Un selector es un mensaje que se puede enviar a un objeto o a una clase. Xamarin.iOS asigna selectores de instancias a métodos de instancia y selectores de clases a métodos estáticos.

A diferencia de las funciones normales de C (y como las funciones miembro de C++), no se puede invocar directamente un selector mediante P/Invoke En su lugar, los selectores se envían a una Objective-C clase o instancia mediante elobjc_msgSend Función.

Para obtener más información sobre los mensajes de Objective-C, eche un vistazo a la guía Trabajar con objetos de Apple.

Ejemplo

Supongamos que desea invocar elsizeWithFont:forWidth:lineBreakMode: selector en NSString. La declaración (de la documentación de Apple) es:

- (CGSize)sizeWithFont:(UIFont *)font forWidth:(CGFloat)width lineBreakMode:(UILineBreakMode)lineBreakMode

Esta API tiene las siguientes características:

  • El tipo de valor devuelto es CGSize para la API unificada.
  • El font parámetro es uiFont (y un tipo (indirectamente) derivado de NSObject y se asigna a System.IntPtr.
  • El width parámetro , , CGFloatse asigna a nfloat.
  • El lineBreakMode parámetro , , UILineBreakModeya se ha enlazado en Xamarin.iOS como .UILineBreakMode Enumeración.

En su conjunto, la objc_msgSend declaración debe coincidir con:

CGSize objc_msgSend(
    IntPtr target,
    IntPtr selector,
    IntPtr font,
    nfloat width,
    UILineBreakMode mode
);

Declárela de la siguiente manera:

[DllImport (Constants.ObjectiveCLibrary, EntryPoint="objc_msgSend")]
static extern CGSize cgsize_objc_msgSend_IntPtr_float_int (
    IntPtr target,
    IntPtr selector,
    IntPtr font,
    nfloat width,
    UILineBreakMode mode
);

Para llamar a este método, use código como el siguiente:

NSString target = ...
Selector selector = new Selector ("sizeWithFont:forWidth:lineBreakMode:");
UIFont font = ...
nfloat width = ...
UILineBreakMode mode = ...

CGSize size = cgsize_objc_msgSend_IntPtr_float_int(
    target.Handle,
    selector.Handle,
    font == null ? IntPtr.Zero : font.Handle,
    width,
    mode
);

Si el valor devuelto era una estructura con un tamaño inferior a 8 bytes (como el anterior SizeF usado antes de cambiar a las API unificadas), el código anterior se ejecutaría en el simulador, pero se bloquearía en el dispositivo. Para llamar a un selector que devuelve un valor inferior a 8 bits de tamaño, declare la objc_msgSend_stret función :

[DllImport (MonoTouch.Constants.ObjectiveCLibrary, EntryPoint="objc_msgSend_stret")]
static extern void cgsize_objc_msgSend_stret_IntPtr_float_int (
    out CGSize retval,
    IntPtr target,
    IntPtr selector,
    IntPtr font,
    nfloat width,
    UILineBreakMode mode
);

Para llamar a este método, use código como el siguiente:

NSString      target = ...
Selector    selector = new Selector ("sizeWithFont:forWidth:lineBreakMode:");
UIFont          font = ...
nfloat          width = ...
UILineBreakMode mode = ...

CGSize size;

if (Runtime.Arch == Arch.SIMULATOR)
    size = cgsize_objc_msgSend_IntPtr_float_int(
        target.Handle,
        selector.Handle,
        font == null ? IntPtr.Zero : font.Handle,
        width,
        mode
    );
else
    cgsize_objc_msgSend_stret_IntPtr_float_int(
        out size,
        target.Handle, selector.Handle,
        font == null ? IntPtr.Zero: font.Handle,
        width,
        mode
    );

Invocar un selector

La invocación de un selector tiene tres pasos:

  1. Obtiene el destino del selector.
  2. Obtiene el nombre del selector.
  3. Llame a objc_msgSend con los argumentos adecuados.

Destinos del selector

Un destino de selector es una instancia de objeto o una Objective-C clase. Si el destino es una instancia de y procede de un tipo de Xamarin.iOS enlazado, use la ObjCRuntime.INativeObject.Handle propiedad .

Si el destino es una clase, use ObjCRuntime.Class para obtener una referencia a la instancia de clase y, a continuación, use la Class.Handle propiedad .

Nombres de selector

Los nombres de selector se enumeran en la documentación de Apple. Por ejemplo, NSString incluye sizeWithFont: y sizeWithFont:forWidth:lineBreakMode: selectores. Los dos puntos incrustados y finales forman parte del nombre del selector y no se pueden omitir.

Una vez que tenga un nombre de selector, puede crear una ObjCRuntime.Selector instancia para ella.

Llamar a objc_msgSend

objc_msgSend envía un mensaje (selector) a un objeto . Esta familia de funciones toma al menos dos argumentos necesarios: el destino del selector (un identificador de instancia o clase), el propio selector y los argumentos necesarios para el selector. Los argumentos de instancia y selector deben ser System.IntPtr, y todos los argumentos restantes deben coincidir con el tipo que espera el selector, por ejemplo, para nint , into para System.IntPtr todos los NSObjecttipos derivados. Use elNSObject.Handle para obtener un IntPtr para una Objective-C instancia de tipo.

Hay más de una objc_msgSend función:

  • Use objc_msgSend_stret para selectores que devuelven una estructura. En ARM, esto incluye todos los tipos devueltos que no son una enumeración ni ninguno de los tipos integrados de C (char, short, int, long, float, double). En x86 (el simulador), este método debe usarse para todas las estructuras de más de 8 bytes de tamaño (CGSize es de 8 bytes y no se usa objc_msgSend_stret en el simulador).
  • Se usa objc_msgSend_fpret para selectores que devuelven un valor de punto flotante solo en x86. Esta función no necesita usarse en ARM; en su lugar, use objc_msgSend.
  • La función principal objc_msgSend se usa para todos los demás selectores.

Una vez que haya decidido qué objc_msgSend funciones necesita llamar (el simulador y el dispositivo pueden requerir un método diferente), puede usar un método normal [DllImport] para declarar la función para la invocación posterior.

Se puede encontrar un conjunto de declaraciones realizadas objc_msgSend previamente en ObjCRuntime.Messaging.

Diferentes invocaciones en el simulador y el dispositivo

Como se ha descrito anteriormente, Objective-C tiene tres tipos de objc_msgSend métodos: uno para las invocaciones normales, una para las invocaciones que devuelven valores de punto flotante (solo x86) y otra para las invocaciones que devuelven valores de estructura. Este último incluye el sufijo _stret en ObjCRuntime.Messaging.

Si invoca un método que devolverá ciertas estructuras (reglas descritas a continuación), debe invocar el método con el valor devuelto como primer parámetro como valor out :

// The following returns a PointF structure:
PointF ret;
Messaging.PointF_objc_msgSend_stret_PointF_IntPtr (out ret, this.Handle, selConvertPointFromWindow.Handle, point, window.Handle);

La regla para cuándo usar el _stret_ método difiere en x86 y ARM. Si desea que los enlaces funcionen tanto en el simulador como en el dispositivo, agregue código como el siguiente:

if (Runtime.Arch == Arch.DEVICE)
{
    PointF ret;
    Messaging.PointF_objc_msgSend_stret_PointF_IntPtr (out ret, myHandle, selector.Handle);
    return ret;
}
else
{
    return Messaging.PointF_objc_msgSend_PointF_IntPtr (myHandle, selector.Handle);
}

Uso del método objc_msgSend_stret

Al compilar para ARM, useobjc_msgSend_stretpara cualquier tipo de valor que no sea una enumeración o ninguno de los tipos base de una enumeración (int, byte, short, long, double, ). float

Al compilar para x86, useobjc_msgSend_stret para cualquier tipo de valor que no sea una enumeración o ninguno de los tipos base de una enumeración (int, byte, short, long, double, float) y cuyo tamaño nativo sea superior a 8 bytes.

Creación de sus propias firmas

Si es necesario, se puede usar el siguiente gist para crear sus propias firmas.