Function COMMETHOD

comtypes/_memberspec.py:192–212

Specifies a COM method slot with idlflags. XXX should explain the sematics of the arguments.

(idlflags, restype, methodname, *argspec)

def COMMETHOD(idlflags, restype, methodname, *argspec) -> _ComMemberSpec:
    """Specifies a COM method slot with idlflags.

    XXX should explain the sematics of the arguments.
    """
    # collect all helpstring instances
    # We should suppress docstrings when Python is started with -OO
    # join them together(does this make sense?) and replace by None if empty.
    helptext = "".join(t for t in idlflags if isinstance(t, helpstring)) or None
    paramflags, argtypes = _resolve_argspec(argspec)
    if "propget" in idlflags:
        name = f"_get_{methodname}"
    elif "propput" in idlflags:
        name = f"_set_{methodname}"
    elif "propputref" in idlflags:
        name = f"_setref_{methodname}"
    else:
        name = methodname
    return _ComMemberSpec(
        restype, name, argtypes, paramflags, tuple(idlflags), helptext
    )


################################################################