io.qt.core.QByteBindable Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of qtjambi-jre8 Show documentation
The newest version!
/****************************************************************************
**
** Copyright (C) 2009-2022 Dr. Peter Droste, Omix Visualization GmbH & Co. KG. All rights reserved.
**
** This file is part of Qt Jambi.
**
** ** $BEGIN_LICENSE$
** GNU Lesser General Public License Usage
** This file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
** 
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
** $END_LICENSE$
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
****************************************************************************/
package io.qt.core;

import io.qt.QtPrimitiveType;
import io.qt.QtUninvokable;

/**
 * QByteBindable is primitive-typed version of QBindable<Byte>.
 * @see QBindable
 */
public final class QByteBindable extends QUntypedBindable {

	private QByteBindable(QPrivateConstructor p) {
		super(p);
	}

	/**
	 * Creates a new byte-typed invalid bindable.
	 */
	public QByteBindable() {
		super(null, null);
	}
	
	/**
	 * Creates a copy of the provided bindable. 
	 * If the type of the other bindable is not byte it remains invalid.
	 * @param other
	 */
	public QByteBindable(QUntypedBindable other) {
		super(other.data(), other.iface());
		check();
	}
	
	private void check() {
		QBindableInterface iface = iface();
		if(iface!=null) {
			QMetaType metaType = iface.metaType();
			if(metaType==null 
					|| metaType.sizeOf()!=1
					|| (metaType.id()!=QMetaType.Type.SChar.value()
						&& metaType.id()!=QMetaType.Type.Char.value()
						&& metaType.id()!=QMetaType.Type.UChar.value())) {
				setIface(null);
				setData(null);
			}
		}
	}

	QByteBindable(QUntypedPropertyData d, QBindableInterface i) {
		super(d, i);
	}
	
	/**
	 * Creates a new bindable from provided property.
	 * @param property
	 */
	public QByteBindable(QByteProperty property) {
		super(property, bindableInterface(0));
	}
	
	/**
	 * Creates a new bindable from provided property.
	 * @param property
	 */
	public QByteBindable(QObject.QByteProperty property) {
		super(property, bindableInterface(1));
	}
	
	/**
	 * Creates a new bindable from provided property.
	 * @param property
	 */
	public QByteBindable(QObject.QComputedByteProperty property) {
		super(property, bindableInterface(2));
	}
	
	/**
	 * Creates a new bindable from provided property.
	 * If the type of the property is not byte an {@link IllegalArgumentException} is thrown.
	 * @param property
	 */
	public QByteBindable(QProperty<@QtPrimitiveType Byte> property) {
		super(property, QBindable.bindableInterface(property.valueMetaType().id(), 0));
		check();
		if(iface()==null)
			throw new IllegalArgumentException("Given QProperty is not of byte type.");
	}
	
	/**
	 * Creates a new bindable from provided property.
	 * If the type of the property is not byte an {@link IllegalArgumentException} is thrown.
	 * @param property
	 */
	public QByteBindable(QObject.QProperty<@QtPrimitiveType Byte> property) {
		super(property, QBindable.bindableInterface(property.valueMetaType().id(), 1));
		check();
		if(iface()==null)
			throw new IllegalArgumentException("Given QProperty is not of byte type.");
	}
	
	/**
	 * Creates a new bindable from provided property.
	 * If the type of the property is not byte an {@link IllegalArgumentException} is thrown.
	 * @param property
	 */
	public QByteBindable(QObject.QComputedProperty<@QtPrimitiveType Byte> property) {
		super(property, QBindable.bindableInterface(property.valueMetaType().id(), 2));
		check();
		if(iface()==null)
			throw new IllegalArgumentException("Given QProperty is not of byte type.");
	}
	
	static native QBindableInterface bindableInterface(int propertyType);

	/**
	 * Creates a binding to the underlying property.
	 */
	@QtUninvokable
	@Override
	public QBytePropertyBinding makeBinding()
    {
		QUntypedPropertyBinding binding = super.makeBinding();
		if(binding instanceof QBytePropertyBinding) {
			return (QBytePropertyBinding)binding;
		}else {
			return new QBytePropertyBinding(binding);
		}
    }
	
    /**
     * Returns the binding expression that is associated with the underlying property. 
     * A default constructed {@link QBytePropertyBinding} will be returned if no such association exists.
     * @return binding
     */
	@QtUninvokable
	@Override
    public QBytePropertyBinding binding()
    {
		QUntypedPropertyBinding binding = super.binding();
		if(binding instanceof QBytePropertyBinding) {
			return (QBytePropertyBinding)binding;
		}else {
			return new QBytePropertyBinding(binding);
		}
    }
    
	@QtUninvokable
	public QBytePropertyBinding setBinding(QBytePropertyBinding binding)
    {
		QUntypedPropertyBinding oldBinding = super.overrideBinding(binding);
		if(oldBinding instanceof QBytePropertyBinding) {
			return (QBytePropertyBinding)oldBinding;
		}else {
			return new QBytePropertyBinding(oldBinding);
		}
    }
    
	@QtUninvokable
	public QBytePropertyBinding setBinding(QPropertyBinding<@QtPrimitiveType Byte> binding)
    {
		if(binding!=null && !QByteProperty.checkType(binding.valueMetaType()))
			return new QBytePropertyBinding();
		QUntypedPropertyBinding oldBinding = super.overrideBinding(binding);
		if(oldBinding instanceof QBytePropertyBinding) {
			return (QBytePropertyBinding)oldBinding;
		}else {
			return new QBytePropertyBinding(oldBinding);
		}
    }
	
	@QtUninvokable
	public QBytePropertyBinding setBinding(io.qt.QtUtilities.ByteSupplier functor)
    {
		return setBinding(new QBytePropertyBinding(functor));
    }
	
	/**
	 * Disassociates the binding expression from this property and returns it.
	 * After calling this function, the value of the property will only change if you assign a new value to it, or when a new binding is set.
	 * @return the removed binding
	 */
	@QtUninvokable
    public QBytePropertyBinding takeBinding()
    {
        return setBinding(new QBytePropertyBinding());
    }
    
	/**
	 * Returns the value of the underlying property. This may evaluate a binding expression that is tied to the property, before returning the value.
	 * @return value
	 */
    @io.qt.QtUninvokable
    public final byte value() {
        return value(QtJambi_LibraryUtilities.internal.nativeId(this.iface()), QtJambi_LibraryUtilities.internal.nativeId(this.data()));
    }
    
	/**
	 * Assigns newValue to the underlying property and removes the property's associated binding, if present.
	 * @param newValue
	 */
    @io.qt.QtUninvokable
    public final void setValue(byte value) {
        setValue(QtJambi_LibraryUtilities.internal.nativeId(this.iface()), QtJambi_LibraryUtilities.internal.nativeId(this.data()), value);
    }
    
    @io.qt.QtUninvokable
    static native byte value(long ifaceId, long dataId);
    
    @io.qt.QtUninvokable
    static native void setValue(long ifaceId, long dataId, byte value);
}