COM: TYPEFLAGS constants missing?!

[SevenOf9Sleeper]

Hi there, in the type TYPEATTR is the attribute wTypeFlags. I have not found a declaration of these constants?! (info based on jna 4.2.1)
After reading the msdn library this would be my suggestion:

public class TYPEFLAGS {
    private TYPEFLAGS() {
        /* do not instantiate */ }

    /**
     * A type description that describes an Application object.
     */
    public final static int FAPPOBJECT = 0x1;

    /**
     * Instances of the type can be created by ITypeInfo::CreateInstance.
     */
    public final static int FCANCREATE = 0x2;

    /**
     * The type is licensed.
     */
    public final static int FLICENSED = 0x4;

    /**
     * The type is predefined. The client application should automatically create a single instance of the object that
     * has this attribute. The name of the variable that points to the object is the same as the class name of the
     * object.
     */
    public final static int FPREDECLID = 0x8;

    /**
     * The type should not be displayed to browsers.
     */
    public final static int FHIDDEN = 0x10;

    /**
     * The type is a control from which other types will be derived, and should not be displayed to users.
     */
    public final static int FCONTROL = 0x20;

    /**
     * The interface supplies both IDispatch and VTBL binding.
     */
    public final static int FDUAL = 0x40;

    /**
     * The interface cannot add members at run time.
     */
    public final static int FNONEXTENSIBLE = 0x80;

    /**
     * The types used in the interface are fully compatible with Automation, including VTBL binding support. Setting
     * dual on an interface sets this flag in addition to TYPEFLAG_FDUAL. Not allowed on dispinterfaces.
     */
    public final static int FOLEAUTOMATION = 0x100;

    /**
     * Should not be accessible from macro languages. This flag is intended for system-level types or types that type
     * browsers should not display.
     */
    public final static int FRESTRICTED = 0x200;

    /**
     * The class supports aggregation.
     */
    public final static int FAGGREGATABLE = 0x400;

    /**
     * The type is replaceable.
     */
    public final static int FREPLACEABLE = 0x800;

    /**
     * Indicates that the interface derives from IDispatch, either directly or indirectly. This flag is computed. There
     * is no Object Description Language for the flag.
     */
    public final static int FDISPATCHABLE = 0x1000;

    /**
     * The type has reverse binding.
     */
    public final static int FREVERSEBIND = 0x2000;

    /**
     * Interfaces can be marked with this flag to indicate that they will be using a proxy/stub dynamic link library.
     * This flag specifies that the typelib proxy should not be unregistered when the typelib is unregistered.
     */
    public final static int FPROXY = 0x4000;
}

[dblock]

Please contribute, see https://github.com/java-native-access/jna/blob/master/www/Contributing.md.

[SevenOf9Sleeper]

I will try... but first I fear that I need some excercises in git... :-]

[twall]

These might be better defined within an interface rather than a class.

On Mar 8, 2016, at 6:59 PM, Mathias Mehrmann [email protected] wrote:

Hi there, in the type TYPEATTR is the attribute wTypeFlags. I have not found a declaration of these constants?! (info based on jna 4.2.1)
After reading the msdn library this would be my suggestion:

public class TYPEFLAGS {
private TYPEFLAGS() {
/* do not instantiate */ }

/**
 * A type description that describes an Application object.
 */
public final static int FAPPOBJECT = 0x1;

/**
 * Instances of the type can be created by ITypeInfo::CreateInstance.
 */
public final static int FCANCREATE = 0x2;

/**
 * The type is licensed.
 */
public final static int FLICENSED = 0x4;

/**
 * The type is predefined. The client application should automatically create a single instance of the object that
 * has this attribute. The name of the variable that points to the object is the same as the class name of the
 * object.
 */
public final static int FPREDECLID = 0x8;

/**
 * The type should not be displayed to browsers.
 */
public final static int FHIDDEN = 0x10;

/**
 * The type is a control from which other types will be derived, and should not be displayed to users.
 */
public final static int FCONTROL = 0x20;

/**
 * The interface supplies both IDispatch and VTBL binding.
 */
public final static int FDUAL = 0x40;

/**
 * The interface cannot add members at run time.
 */
public final static int FNONEXTENSIBLE = 0x80;

/**
 * The types used in the interface are fully compatible with Automation, including VTBL binding support. Setting
 * dual on an interface sets this flag in addition to TYPEFLAG_FDUAL. Not allowed on dispinterfaces.
 */
public final static int FOLEAUTOMATION = 0x100;

/**
 * Should not be accessible from macro languages. This flag is intended for system-level types or types that type
 * browsers should not display.
 */
public final static int FRESTRICTED = 0x200;

/**
 * The class supports aggregation.
 */
public final static int FAGGREGATABLE = 0x400;

/**
 * The type is replaceable.
 */
public final static int FREPLACEABLE = 0x800;

/**
 * Indicates that the interface derives from IDispatch, either directly or indirectly. This flag is computed. There
 * is no Object Description Language for the flag.
 */
public final static int FDISPATCHABLE = 0x1000;

/**
 * The type has reverse binding.
 */
public final static int FREVERSEBIND = 0x2000;

/**
 * Interfaces can be marked with this flag to indicate that they will be using a proxy/stub dynamic link library.
 * This flag specifies that the typelib proxy should not be unregistered when the typelib is unregistered.
 */
public final static int FPROXY = 0x4000;

}

—
Reply to this email directly or view it on GitHub.

[SevenOf9Sleeper]

Oh... ok... I thought that is dealt as antipattern? (Effective Java, Item 19). On the job we try to avoid the constants in interface-pattern. Or are there some special architectural specialties in jna I don't know yet?

[twall]

Kind of preachy, that.

That item actually recommends adding constants to the class or interface to which they are tightly bound. In this case, that'd probably be the Structure that uses them.

On Mar 8, 2016, at 9:13 PM, Mathias Mehrmann [email protected] wrote:

Oh... ok... I thought that is dealt as antipattern? (Effective Java, Item 19). On the job we try to avoid the constants in interface-pattern. Or are there some special architectural specialties in jna I don't know yet?

—
Reply to this email directly or view it on GitHub.

[SevenOf9Sleeper]

Yeah, perhaps you are right (with the "preachy").
In this case I must admit that the constants are better of direct in the class TYPEATTR where the attribute wTypeFlags is defined. So... if I get my git started I will try the contribution thing...

[SevenOf9Sleeper]

#619 pull request created... I have corrected compile errors in the contribution projects as well and have adapted the .project- and .classpath-files for eclipse

[SevenOf9Sleeper]

#619 closed and created new pull request #621

[matthiasblaesing]

Closing this as #621 was merged by @dblock.