Documentation
¶
Overview ¶
Package scriptingbridge provides purego-based Go bindings for the macOS ScriptingBridge framework.
Apple documentation: https://developer.apple.com/documentation/scriptingbridge
Index ¶
- type Acl_entry_id_t
- type Acl_flag_t
- type Acl_perm_t
- type Acl_tag_t
- type Acl_type_t
- type Clockid_t
- type Dispatch_autorelease_frequency_t
- type Dispatch_block_flags_t
- type EvCmd
- type Filesec_property_t
- type Idtype_t
- type Ipc_info_object_type_t
- type Launch_data_type_t
- type MDLabelDomain
- type MDQueryOptionFlags
- type MDQuerySortOptionFlags
- type Mach_vm_range_flags_t
- type Mach_vm_range_flavor_t
- type Mach_vm_range_tag_t
- type Mpo_flags_t
- type NXMouseButton
- type Os_clockid_t
- type PMPageToPaperMappingType
- type Ptrauth_key
- type Qos_class_t
- type SBApplication
- func (o *SBApplication) Activate()
- func (o *SBApplication) ClassForScriptingClass(className *foundation.NSString) objc.Class
- func (o *SBApplication) Delegate() SBApplicationDelegate
- func (o *SBApplication) InitWithBundleIdentifier(ident *foundation.NSString) *SBApplication
- func (o *SBApplication) InitWithProcessIdentifier(pid int) *SBApplication
- func (o *SBApplication) InitWithURL(url *foundation.NSURL) *SBApplication
- func (o *SBApplication) IsRunning() bool
- func (o *SBApplication) LaunchFlags() launchservices.LSLaunchFlags
- func (o *SBApplication) SendMode() int
- func (o *SBApplication) SetDelegate(delegate SBApplicationDelegate)
- func (o *SBApplication) SetLaunchFlags(launchFlags launchservices.LSLaunchFlags)
- func (o *SBApplication) SetSendMode(sendMode int)
- func (o *SBApplication) SetTimeout(timeout int)
- func (o *SBApplication) Timeout() int
- type SBApplicationDelegate
- type SBElementArray
- func (o *SBElementArray[ObjectType]) ArrayByApplyingSelector(selector objc.SEL) *foundation.NSArray[objc.ID]
- func (o *SBElementArray[ObjectType]) ArrayByApplyingSelectorWithObject(aSelector objc.SEL, argument objc.ID) *foundation.NSArray[objc.ID]
- func (o *SBElementArray[ObjectType]) Get() *foundation.NSArray[ObjectType]
- func (o *SBElementArray[ObjectType]) ObjectAtLocation(location objc.ID) ObjectType
- func (o *SBElementArray[ObjectType]) ObjectWithID(identifier objc.ID) ObjectType
- func (o *SBElementArray[ObjectType]) ObjectWithName(name *foundation.NSString) ObjectType
- type SBObject
- func (o *SBObject) ElementArrayWithCode(code uint) *SBElementArray[objc.ID]
- func (o *SBObject) Get() objc.ID
- func (o *SBObject) Init() *SBObject
- func (o *SBObject) InitWithData(data objc.ID) *SBObject
- func (o *SBObject) InitWithElementCodePropertiesData(code uint, properties *foundation.NSDictionary[*foundation.NSString, objc.ID], ...) *SBObject
- func (o *SBObject) InitWithProperties(properties *foundation.NSDictionary[objc.ID, objc.ID]) *SBObject
- func (o *SBObject) LastError() unsafe.Pointer
- func (o *SBObject) PropertyWithClassCode(cls objc.Class, code uint) *SBObject
- func (o *SBObject) PropertyWithCode(code uint) *SBObject
- func (o *SBObject) SetTo(value objc.ID)
- type Virtual_memory_guard_exception_code_t
- type Xpc_listener_create_flags_t
- type Xpc_session_create_flags_t
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Acl_entry_id_t ¶
type Acl_entry_id_t int64
const ( ACL_FIRST_ENTRY Acl_entry_id_t = 0 ACL_NEXT_ENTRY Acl_entry_id_t = -1 ACL_LAST_ENTRY Acl_entry_id_t = -2 )
func (Acl_entry_id_t) String ¶
func (e Acl_entry_id_t) String() string
type Acl_flag_t ¶
type Acl_flag_t int64
const ( ACL_FLAG_DEFER_INHERIT Acl_flag_t = 1 ACL_FLAG_NO_INHERIT Acl_flag_t = 131072 ACL_ENTRY_INHERITED Acl_flag_t = 16 ACL_ENTRY_FILE_INHERIT Acl_flag_t = 32 ACL_ENTRY_DIRECTORY_INHERIT Acl_flag_t = 64 ACL_ENTRY_LIMIT_INHERIT Acl_flag_t = 128 ACL_ENTRY_ONLY_INHERIT Acl_flag_t = 256 )
func (Acl_flag_t) String ¶
func (e Acl_flag_t) String() string
type Acl_perm_t ¶
type Acl_perm_t int64
const ( ACL_READ_DATA Acl_perm_t = 2 ACL_LIST_DIRECTORY Acl_perm_t = 2 ACL_WRITE_DATA Acl_perm_t = 4 ACL_ADD_FILE Acl_perm_t = 4 ACL_EXECUTE Acl_perm_t = 8 ACL_SEARCH Acl_perm_t = 8 ACL_DELETE Acl_perm_t = 16 ACL_APPEND_DATA Acl_perm_t = 32 ACL_ADD_SUBDIRECTORY Acl_perm_t = 32 ACL_DELETE_CHILD Acl_perm_t = 64 ACL_READ_ATTRIBUTES Acl_perm_t = 128 ACL_WRITE_ATTRIBUTES Acl_perm_t = 256 ACL_READ_EXTATTRIBUTES Acl_perm_t = 512 ACL_WRITE_EXTATTRIBUTES Acl_perm_t = 1024 ACL_READ_SECURITY Acl_perm_t = 2048 ACL_WRITE_SECURITY Acl_perm_t = 4096 ACL_CHANGE_OWNER Acl_perm_t = 8192 ACL_SYNCHRONIZE Acl_perm_t = 1048576 )
func (Acl_perm_t) String ¶
func (e Acl_perm_t) String() string
type Acl_type_t ¶
type Acl_type_t int64
const ( ACL_TYPE_EXTENDED Acl_type_t = 256 ACL_TYPE_ACCESS Acl_type_t = 0 ACL_TYPE_DEFAULT Acl_type_t = 1 ACL_TYPE_AFS Acl_type_t = 2 ACL_TYPE_CODA Acl_type_t = 3 ACL_TYPE_NTFS Acl_type_t = 4 ACL_TYPE_NWFS Acl_type_t = 5 )
func (Acl_type_t) String ¶
func (e Acl_type_t) String() string
type Dispatch_autorelease_frequency_t ¶
type Dispatch_autorelease_frequency_t uint64
const ( DISPATCH_AUTORELEASE_FREQUENCY_INHERIT Dispatch_autorelease_frequency_t = 0 DISPATCH_AUTORELEASE_FREQUENCY_WORK_ITEM Dispatch_autorelease_frequency_t = 1 DISPATCH_AUTORELEASE_FREQUENCY_NEVER Dispatch_autorelease_frequency_t = 2 )
func (Dispatch_autorelease_frequency_t) String ¶
func (e Dispatch_autorelease_frequency_t) String() string
type Dispatch_block_flags_t ¶
type Dispatch_block_flags_t uint64
const ( DISPATCH_BLOCK_BARRIER Dispatch_block_flags_t = 1 DISPATCH_BLOCK_DETACHED Dispatch_block_flags_t = 2 DISPATCH_BLOCK_ASSIGN_CURRENT Dispatch_block_flags_t = 4 DISPATCH_BLOCK_NO_QOS_CLASS Dispatch_block_flags_t = 8 DISPATCH_BLOCK_INHERIT_QOS_CLASS Dispatch_block_flags_t = 16 DISPATCH_BLOCK_ENFORCE_QOS_CLASS Dispatch_block_flags_t = 32 )
func (Dispatch_block_flags_t) String ¶
func (e Dispatch_block_flags_t) String() string
type Filesec_property_t ¶
type Filesec_property_t int64
const ( FILESEC_OWNER Filesec_property_t = 1 FILESEC_GROUP Filesec_property_t = 2 FILESEC_UUID Filesec_property_t = 3 FILESEC_MODE Filesec_property_t = 4 FILESEC_ACL Filesec_property_t = 5 FILESEC_GRPUUID Filesec_property_t = 6 FILESEC_ACL_RAW Filesec_property_t = 100 FILESEC_ACL_ALLOCSIZE Filesec_property_t = 101 )
func (Filesec_property_t) String ¶
func (e Filesec_property_t) String() string
type Ipc_info_object_type_t ¶
type Ipc_info_object_type_t int64
const ( IPC_OTYPE_NONE Ipc_info_object_type_t = 0 IPC_OTYPE_THREAD_CONTROL Ipc_info_object_type_t = 1 IPC_OTYPE_TASK_CONTROL Ipc_info_object_type_t = 2 IPC_OTYPE_HOST Ipc_info_object_type_t = 3 IPC_OTYPE_HOST_PRIV Ipc_info_object_type_t = 4 IPC_OTYPE_PROCESSOR Ipc_info_object_type_t = 5 IPC_OTYPE_PROCESSOR_SET Ipc_info_object_type_t = 6 IPC_OTYPE_PROCESSOR_SET_NAME Ipc_info_object_type_t = 7 IPC_OTYPE_TIMER Ipc_info_object_type_t = 8 IPC_OTYPE_PORT_SUBST_ONCE Ipc_info_object_type_t = 9 IPC_OTYPE_MIG Ipc_info_object_type_t = 10 IPC_OTYPE_MEMORY_OBJECT Ipc_info_object_type_t = 11 IPC_OTYPE_XMM_PAGER Ipc_info_object_type_t = 12 IPC_OTYPE_XMM_KERNEL Ipc_info_object_type_t = 13 IPC_OTYPE_XMM_REPLY Ipc_info_object_type_t = 14 IPC_OTYPE_UND_REPLY Ipc_info_object_type_t = 15 IPC_OTYPE_HOST_NOTIFY Ipc_info_object_type_t = 16 IPC_OTYPE_HOST_SECURITY Ipc_info_object_type_t = 17 IPC_OTYPE_LEDGER Ipc_info_object_type_t = 18 IPC_OTYPE_MAIN_DEVICE Ipc_info_object_type_t = 19 IPC_OTYPE_TASK_NAME Ipc_info_object_type_t = 20 IPC_OTYPE_SUBSYSTEM Ipc_info_object_type_t = 21 IPC_OTYPE_IO_DONE_QUEUE Ipc_info_object_type_t = 22 IPC_OTYPE_SEMAPHORE Ipc_info_object_type_t = 23 IPC_OTYPE_LOCK_SET Ipc_info_object_type_t = 24 IPC_OTYPE_CLOCK Ipc_info_object_type_t = 25 IPC_OTYPE_CLOCK_CTRL Ipc_info_object_type_t = 26 IPC_OTYPE_IOKIT_IDENT Ipc_info_object_type_t = 27 IPC_OTYPE_NAMED_ENTRY Ipc_info_object_type_t = 28 IPC_OTYPE_IOKIT_CONNECT Ipc_info_object_type_t = 29 IPC_OTYPE_IOKIT_OBJECT Ipc_info_object_type_t = 30 IPC_OTYPE_UPL Ipc_info_object_type_t = 31 IPC_OTYPE_MEM_OBJ_CONTROL Ipc_info_object_type_t = 32 IPC_OTYPE_AU_SESSIONPORT Ipc_info_object_type_t = 33 IPC_OTYPE_FILEPORT Ipc_info_object_type_t = 34 IPC_OTYPE_LABELH Ipc_info_object_type_t = 35 IPC_OTYPE_TASK_RESUME Ipc_info_object_type_t = 36 IPC_OTYPE_VOUCHER Ipc_info_object_type_t = 37 IPC_OTYPE_VOUCHER_ATTR_CONTROL Ipc_info_object_type_t = 38 IPC_OTYPE_WORK_INTERVAL Ipc_info_object_type_t = 39 IPC_OTYPE_UX_HANDLER Ipc_info_object_type_t = 40 IPC_OTYPE_UEXT_OBJECT Ipc_info_object_type_t = 41 IPC_OTYPE_ARCADE_REG Ipc_info_object_type_t = 42 IPC_OTYPE_EVENTLINK Ipc_info_object_type_t = 43 IPC_OTYPE_TASK_INSPECT Ipc_info_object_type_t = 44 IPC_OTYPE_TASK_READ Ipc_info_object_type_t = 45 IPC_OTYPE_THREAD_INSPECT Ipc_info_object_type_t = 46 IPC_OTYPE_THREAD_READ Ipc_info_object_type_t = 47 IPC_OTYPE_SUID_CRED Ipc_info_object_type_t = 48 IPC_OTYPE_HYPERVISOR Ipc_info_object_type_t = 49 IPC_OTYPE_TASK_ID_TOKEN Ipc_info_object_type_t = 50 IPC_OTYPE_TASK_FATAL Ipc_info_object_type_t = 51 IPC_OTYPE_KCDATA Ipc_info_object_type_t = 52 IPC_OTYPE_EXCLAVES_RESOURCE Ipc_info_object_type_t = 53 IPC_OTYPE_THREAD_RESUME Ipc_info_object_type_t = 54 IPC_OTYPE_UNKNOWN Ipc_info_object_type_t = 4294967295 )
func (Ipc_info_object_type_t) String ¶
func (e Ipc_info_object_type_t) String() string
type Launch_data_type_t ¶
type Launch_data_type_t int64
const ( LAUNCH_DATA_DICTIONARY Launch_data_type_t = 1 LAUNCH_DATA_ARRAY Launch_data_type_t = 2 LAUNCH_DATA_FD Launch_data_type_t = 3 LAUNCH_DATA_INTEGER Launch_data_type_t = 4 LAUNCH_DATA_REAL Launch_data_type_t = 5 LAUNCH_DATA_BOOL Launch_data_type_t = 6 LAUNCH_DATA_STRING Launch_data_type_t = 7 LAUNCH_DATA_OPAQUE Launch_data_type_t = 8 LAUNCH_DATA_ERRNO Launch_data_type_t = 9 LAUNCH_DATA_MACHPORT Launch_data_type_t = 10 )
func (Launch_data_type_t) String ¶
func (e Launch_data_type_t) String() string
type MDLabelDomain ¶
type MDLabelDomain int64
@typedef MDLabelDomain @abstract These constants are used to specify a domain to MDLabelCreate().
const ( KMDLabelUserDomain MDLabelDomain = 0 KMDLabelLocalDomain MDLabelDomain = 1 )
func (MDLabelDomain) String ¶
func (e MDLabelDomain) String() string
type MDQueryOptionFlags ¶
type MDQueryOptionFlags int64
const ( KMDQuerySynchronous MDQueryOptionFlags = 1 KMDQueryWantsUpdates MDQueryOptionFlags = 4 KMDQueryAllowFSTranslation MDQueryOptionFlags = 8 )
func (MDQueryOptionFlags) String ¶
func (e MDQueryOptionFlags) String() string
type MDQuerySortOptionFlags ¶
type MDQuerySortOptionFlags int64
@enum MDQuerySortOptionFlags @constant kMDQueryReverseSortOrderFlag Sort the attribute in reverse order.
const (
KMDQueryReverseSortOrderFlag MDQuerySortOptionFlags = 1
)
func (MDQuerySortOptionFlags) String ¶
func (e MDQuerySortOptionFlags) String() string
type Mach_vm_range_flags_t ¶
type Mach_vm_range_flags_t int64
const (
MACH_VM_RANGE_NONE Mach_vm_range_flags_t = 0
)
func (Mach_vm_range_flags_t) String ¶
func (e Mach_vm_range_flags_t) String() string
type Mach_vm_range_flavor_t ¶
type Mach_vm_range_flavor_t int64
const ( MACH_VM_RANGE_FLAVOR_INVALID Mach_vm_range_flavor_t = 0 MACH_VM_RANGE_FLAVOR_V1 Mach_vm_range_flavor_t = 1 )
func (Mach_vm_range_flavor_t) String ¶
func (e Mach_vm_range_flavor_t) String() string
type Mach_vm_range_tag_t ¶
type Mach_vm_range_tag_t int64
const ( MACH_VM_RANGE_DEFAULT Mach_vm_range_tag_t = 0 MACH_VM_RANGE_DATA Mach_vm_range_tag_t = 1 MACH_VM_RANGE_FIXED Mach_vm_range_tag_t = 2 )
func (Mach_vm_range_tag_t) String ¶
func (e Mach_vm_range_tag_t) String() string
type Mpo_flags_t ¶
type Mpo_flags_t int64
const ( MPO_PORT Mpo_flags_t = 0 MPO_SERVICE_PORT Mpo_flags_t = 1024 MPO_CONNECTION_PORT Mpo_flags_t = 2048 MPO_REPLY_PORT Mpo_flags_t = 4096 MPO_WEAK_REPLY_PORT Mpo_flags_t = 16384 MPO_NOTIFICATION_PORT Mpo_flags_t = 17408 MPO_EXCEPTION_PORT Mpo_flags_t = 32768 MPO_CONNECTION_PORT_WITH_PORT_ARRAY Mpo_flags_t = 65536 )
func (Mpo_flags_t) String ¶
func (e Mpo_flags_t) String() string
type NXMouseButton ¶
type NXMouseButton int64
const ( NX_OneButton NXMouseButton = 0 NX_LeftButton NXMouseButton = 1 NX_RightButton NXMouseButton = 2 )
func (NXMouseButton) String ¶
func (e NXMouseButton) String() string
type Os_clockid_t ¶
type Os_clockid_t int64
const (
OS_CLOCK_MACH_ABSOLUTE_TIME Os_clockid_t = 32
)
func (Os_clockid_t) String ¶
func (e Os_clockid_t) String() string
type PMPageToPaperMappingType ¶
type PMPageToPaperMappingType int64
const ( KPMPageToPaperMappingNone PMPageToPaperMappingType = 1 KPMPageToPaperMappingScaleToFit PMPageToPaperMappingType = 2 )
func (PMPageToPaperMappingType) String ¶
func (e PMPageToPaperMappingType) String() string
type Ptrauth_key ¶
type Ptrauth_key int64
const ( Ptrauth_key_none Ptrauth_key = -1 Ptrauth_key_asia Ptrauth_key = 0 Ptrauth_key_asib Ptrauth_key = 1 Ptrauth_key_asda Ptrauth_key = 2 Ptrauth_key_asdb Ptrauth_key = 3 Ptrauth_key_process_independent_code Ptrauth_key = 0 Ptrauth_key_process_dependent_code Ptrauth_key = 1 Ptrauth_key_process_independent_data Ptrauth_key = 2 Ptrauth_key_process_dependent_data Ptrauth_key = 3 Ptrauth_key_return_address Ptrauth_key = 1 Ptrauth_key_frame_pointer Ptrauth_key = 3 Ptrauth_key_function_pointer Ptrauth_key = 0 Ptrauth_key_block_function Ptrauth_key = 0 Ptrauth_key_cxx_vtable_pointer Ptrauth_key = 2 Ptrauth_key_method_list_pointer Ptrauth_key = 2 Ptrauth_key_objc_isa_pointer Ptrauth_key = 2 Ptrauth_key_objc_super_pointer Ptrauth_key = 2 Ptrauth_key_objc_sel_pointer Ptrauth_key = 3 Ptrauth_key_objc_class_ro_pointer Ptrauth_key = 2 Ptrauth_key_block_descriptor_pointer Ptrauth_key = 2 Ptrauth_key_init_fini_pointer Ptrauth_key = 0 )
func (Ptrauth_key) String ¶
func (e Ptrauth_key) String() string
type Qos_class_t ¶
type Qos_class_t uint32
const ( QOS_CLASS_USER_INTERACTIVE Qos_class_t = 33 QOS_CLASS_USER_INITIATED Qos_class_t = 25 QOS_CLASS_DEFAULT Qos_class_t = 21 QOS_CLASS_UTILITY Qos_class_t = 17 QOS_CLASS_BACKGROUND Qos_class_t = 9 QOS_CLASS_UNSPECIFIED Qos_class_t = 0 )
func (Qos_class_t) String ¶
func (e Qos_class_t) String() string
type SBApplication ¶
type SBApplication struct {
SBObject
}
Apple documentation: https://developer.apple.com/documentation/scriptingbridge/sbapplication
func SBApplicationApplicationWithBundleIdentifier ¶
func SBApplicationApplicationWithBundleIdentifier(ident *foundation.NSString) *SBApplication
Returns the shared instance representing the target application specified by its bundle identifier. For applications that declare themselves to have a dynamic scripting interface, this method will launch the application if it is not already running. - Parameters: - ident: A bundle identifier specifying an application that is OSA-compliant. - Returns: An instance of a `SBApplication` subclass that represents the target application whose bundle identifier is `ident`. Returns `nil` if no such application can be found or if the application does not have a scripting interface.
func SBApplicationApplicationWithProcessIdentifier ¶
func SBApplicationApplicationWithProcessIdentifier(pid int) *SBApplication
Returns the shared instance representing a target application specified by its process identifier. You should avoid using this method unless you know nothing about a target application but its process ID. In most cases, it is better to use “SBApplication/applicationWithBundleIdentifier:“, which will dynamically locate the application's path at runtime, or “SBApplication/applicationWithURL:“, which is not dependent on the target application being open at the time the method is called. - Parameters: - pid: The BSD process ID of a OSA-compliant application. Often you can get the process ID of a process using the <doc://com.apple.documentation/documentation/Foundation/Process/processIdentifier> method of `NSTask`. - Returns: An instance of an `SBApplication` subclass that represents the target application whose process identifier is `pid`. Returns `nil` if no such application can be found or if the application does not have a scripting interface.
func SBApplicationApplicationWithURL ¶
func SBApplicationApplicationWithURL(url *foundation.NSURL) *SBApplication
Returns the shared instance representing a target application specified by the given URL. For applications that declare themselves to have a dynamic scripting interface, this method will launch the application if it is not already running. This approach to initializing `SBApplication` objects should be used only if you know for certain the URL of the target application. In most cases, it is better to use “SBApplication/applicationWithBundleIdentifier:“ which dynamically locates the target application at runtime. This method currently supports file URLs (`file:`) and remote application URLs (`eppc:`). It checks whether a file exists at the specified path, but it does not check whether an application identified via `eppc:` exists. - Parameters: - url: The Universal Resource Locator (URL) locating an OSA-compliant application. - Returns: An `SBApplication` subclass from which to generate a shared instance of the target application whose URL is `url`. Returns `nil` if no such application can be found or if the application does not have a scripting interface.
func SBApplicationFromID ¶
func SBApplicationFromID(id objc.ID) *SBApplication
func (*SBApplication) Activate ¶
func (o *SBApplication) Activate()
Moves the target application to the foreground immediately. If the target application is not already running, this method launches it.
func (*SBApplication) ClassForScriptingClass ¶
func (o *SBApplication) ClassForScriptingClass(className *foundation.NSString) objc.Class
Returns a class object that represents a particular class in the target application. You invoke this method on an instance of a scriptable application. Once you have the class object, you may allocate an instance of the class and appropriately the raw instance. Or you may use it in a call to <doc://com.apple.documentation/documentation/ObjectiveC/NSObjectProtocol/isKind(of:)> to determine the class type of an object. - Parameters: - className: The name of the scripting class, as it appears in the scripting interface. For example, "document". - Returns: A `Class` object representing the scripting class.
func (*SBApplication) Delegate ¶
func (o *SBApplication) Delegate() SBApplicationDelegate
The error-handling delegate of the receiver. The delegate should implement the “SBApplicationDelegate/eventDidFail:withError:“ method of the “SBApplicationDelegate“ informal protocol.
func (*SBApplication) InitWithBundleIdentifier ¶
func (o *SBApplication) InitWithBundleIdentifier(ident *foundation.NSString) *SBApplication
Returns an instance of an `SBApplication` subclass that represents the target application identified by the given bundle identifier. If you must initialize an `SBApplication` object explictly, you should use this initializer if possible; unlike “SBApplication/initWithProcessIdentifier:“ and “SBApplication/initWithURL:“, this method is not dependent on changeable factors such as the target application's path or process ID. Even so, you should rarely have to initialize an `SBApplication` object yourself; instead, you should initialize an application-specific subclass such as `iTunesApplication`. Note that this method does not check whether an application with the given bundle identifier actually exists. - Parameters: - ident: A bundle identifier specifying an application that is OSA-compliant. - Returns: An initialized shared instance of an `SBApplication` subclass that represents a target application with the bundle identifier of `ident`. Returns `nil` if no such application can be found or if the application does not have a scripting interface.
func (*SBApplication) InitWithProcessIdentifier ¶
func (o *SBApplication) InitWithProcessIdentifier(pid int) *SBApplication
Returns an instance of an `SBApplication` subclass that represents the target application identified by the given process identifier. You should avoid using this method unless you know nothing about an external application but its PID. In most cases, it is better to use “SBApplication/initWithBundleIdentifier:“, which will dynamically locate the external application's path at runtime, or “SBApplication/initWithURL:“, which is not dependent on the external application being open at the time the method is called. - Parameters: - pid: A BSD process ID specifying an application that is OSA-compliant. Often you can get the process ID of a process using the <doc://com.apple.documentation/documentation/Foundation/Process/processIdentifier> method of `NSTask`. - Returns: An initialized `SBApplication` that you can use to communicate with the target application specified by the process ID. Returns `nil` if no such application can be found or if the application does not have a scripting interface.
func (*SBApplication) InitWithURL ¶
func (o *SBApplication) InitWithURL(url *foundation.NSURL) *SBApplication
Returns an instance of an `SBApplication` subclass that represents the target application identified by the given URL. This approach to initializing `SBApplication` objects should be used only if you know for certain the URL of the target application. In most cases, it is better to use “SBApplication/applicationWithBundleIdentifier:“ which dynamically locates the target application at runtime. Even so, you should rarely have to initialize an `SBApplication` yourself. This method currently supports file URLs (`file:`) and remote application URLs (`eppc:`). It checks whether a file exists at the specified path, but it does not check whether an application identified via `eppc:` exists. - Parameters: - url: A Universal Resource Locator (URL) specifying an application that is OSA-compliant. - Returns: An initialized `SBApplication` that you can use to communicate with the target application specified by the process ID. Returns `nil` if an application could not be found or if the application does not have a scripting interface.
func (*SBApplication) IsRunning ¶
func (o *SBApplication) IsRunning() bool
A Boolean that indicates whether the target application represented by the receiver is running. <doc://com.apple.documentation/documentation/swift/true> if the application is running, <doc://com.apple.documentation/documentation/swift/false> otherwise. This may be <doc://com.apple.documentation/documentation/swift/true> for instances initialized with a bundle identifier or URL because `SBApplication` launches the application only when it's necessary to send it an event.
func (*SBApplication) LaunchFlags ¶
func (o *SBApplication) LaunchFlags() launchservices.LSLaunchFlags
The launch flags for the application represented by the receiver. For more information, see <doc://com.apple.documentation/documentation/coreservices/launch_services>.
func (*SBApplication) SendMode ¶
func (o *SBApplication) SendMode() int
The mode for sending Apple events to the target application. For more information, see <doc://com.apple.documentation/documentation/applicationservices/apple_event_manager>. The default send mode is <doc://com.apple.documentation/documentation/coreservices/1542914-anonymous/kaewaitreply>. If the send mode is something other than `kAEWaitReply`, the receiver might not correctly handle reply events from the target application.
func (*SBApplication) SetDelegate ¶
func (o *SBApplication) SetDelegate(delegate SBApplicationDelegate)
func (*SBApplication) SetLaunchFlags ¶
func (o *SBApplication) SetLaunchFlags(launchFlags launchservices.LSLaunchFlags)
func (*SBApplication) SetSendMode ¶
func (o *SBApplication) SetSendMode(sendMode int)
func (*SBApplication) SetTimeout ¶
func (o *SBApplication) SetTimeout(timeout int)
func (*SBApplication) Timeout ¶
func (o *SBApplication) Timeout() int
The period the application will wait to receive reply Apple events. For more information, see <doc://com.apple.documentation/documentation/applicationservices/apple_event_manager>. The default timeout value is <doc://com.apple.documentation/documentation/coreservices/1542814-timeout_constants/kaedefaulttimeout>, which is about a minute. If you want the receiver to wait indefinitely for reply Apple events, use <doc://com.apple.documentation/documentation/coreservices/1542814-timeout_constants/knotimeout>. For more information, see <doc://com.apple.documentation/documentation/applicationservices/apple_event_manager>.
type SBApplicationDelegate ¶
type SBApplicationDelegate interface {
EventDidFailWithError(event *ae.AEDesc, error_ unsafe.Pointer) objc.ID
}
SBApplicationDelegate wraps the ObjC protocol SBApplicationDelegate.
type SBElementArray ¶
type SBElementArray[ObjectType pureobjc.AnyObject] struct { foundation.NSMutableArray[ObjectType] }
Apple documentation: https://developer.apple.com/documentation/scriptingbridge/sbelementarray
func SBElementArrayFromID ¶
func SBElementArrayFromID[ObjectType pureobjc.AnyObject](id objc.ID) *SBElementArray[ObjectType]
func (*SBElementArray[ObjectType]) ArrayByApplyingSelector ¶
func (o *SBElementArray[ObjectType]) ArrayByApplyingSelector(selector objc.SEL) *foundation.NSArray[objc.ID]
Returns an array containing the results of sending the specified message to each object in the receiver. The method identified by `selector` must not take any arguments and must return an Objective-C object. It should not have the side effect of modifying the receiving array. The order of the items in the result array corresponds to the order of the items in the original array. - Parameters: - selector: A selector identifying the message to be sent to each object in the array. - Returns: A new array containing the results of sending the `selector` message to each object in the receiver, starting with the first object and continuing through the element array to the last object.
func (*SBElementArray[ObjectType]) ArrayByApplyingSelectorWithObject ¶
func (o *SBElementArray[ObjectType]) ArrayByApplyingSelectorWithObject(aSelector objc.SEL, argument objc.ID) *foundation.NSArray[objc.ID]
Returns an array containing the results of sending the specified message to each object in the receiver. The method identified by `selector` must take a single argument—whose value is provided in `argument`—and must return an object. It should not have the side effect of modifying the receiving array. The order of the items in the result array corresponds to the order of the items in the original array. - Parameters: - selector: A selector identifying the message to be sent to each object in the array. - argument: The value for the parameter of the message identified by `selector`. - Returns: A new array containing the results of sending the `selector` message to each object in the receiver, starting with the first object and continuing through the element array to the last object.
func (*SBElementArray[ObjectType]) Get ¶
func (o *SBElementArray[ObjectType]) Get() *foundation.NSArray[ObjectType]
Forces evaluation of the receiver, causing the real object to be returned immediately. This method forces the evaluation of the current object reference (the receiver), resulting in the return of the referenced object. By default, Scripting Bridge deals with references to objects until you actually request some concrete data from them or until you call the `get` method. - Returns: The object referenced by the receiver.
func (*SBElementArray[ObjectType]) ObjectAtLocation ¶
func (o *SBElementArray[ObjectType]) ObjectAtLocation(location objc.ID) ObjectType
Returns the object at the given location in the receiver. This method is a generalization of <doc://com.apple.documentation/documentation/Foundation/NSArray/object(at:)> for applications where the "index" is not simply an integer. For example, Finder can specify objects using a <doc://com.apple.documentation/documentation/foundation/nsurl> object as a location. In OSA this is known as "absolute position," a generalization of the notion of “index” in Foundation—it could be an integer, but it doesn't have to be. A single object may even have a number of different "absolute position" values depending on the container. - Parameters: - loc: An object that specifies the absolute position of the object within the array. It can be an integer index, a list of coordinates, a URL, or other determinant. See the discussion for clarification. - Returns: A reference to the “SBObject“ object identified by `loc` or `nil` if the object couldn’t be located.
func (*SBElementArray[ObjectType]) ObjectWithID ¶
func (o *SBElementArray[ObjectType]) ObjectWithID(identifier objc.ID) ObjectType
Returns the object in the array with the given identifier. This method is provided as an alternative to <doc://com.apple.documentation/documentation/Foundation/NSArray/object(at:)> for applications where an identifier is available instead of (or in addition to) an index. A unique ID is generally more stable than an index. For example, it may be more useful to identify a contact in Address Book by its identifier (which doesn't change over time) than by its index in the list of contacts (which can change as contacts are added or removed). - Parameters: - identifier: The identifier of one of the receiver's objects. - Returns: A reference to the identified object or `nil` if could not be found.
func (*SBElementArray[ObjectType]) ObjectWithName ¶
func (o *SBElementArray[ObjectType]) ObjectWithName(name *foundation.NSString) ObjectType
Returns the object in the array with the given name. This method is provided as an alternative to <doc://com.apple.documentation/documentation/Foundation/NSArray/object(at:)> for applications where a name is available instead of (or in addition to) an index. A name is generally more stable than an index. For example, it is typically more useful to identify a mailbox in Mail by its name than by its index in the list of mailboxes. - Parameters: - name: The name of one of the receiver's objects. - Returns: A reference to the designated object or `nil` if the object couldn’t be found.
type SBObject ¶
type SBObject struct {
foundation.NSObject
}
Apple documentation: https://developer.apple.com/documentation/scriptingbridge/sbobject
func SBObjectFromID ¶
func (*SBObject) ElementArrayWithCode ¶
func (o *SBObject) ElementArrayWithCode(code uint) *SBElementArray[objc.ID]
Returns an array containing every child of the receiver with the given class-type code. `SBObject` subclasses use this method to implement application-specific property accessor methods. You should not need to call this method directly. > Note: This method doesn't retrieve the value of the property. To get the value, call “get“. - Parameters: - code: A four-character code that identifies a scripting class. - Returns: An “SBElementArray“ object containing every child of the receiver whose class matches `code`.
func (*SBObject) Get ¶
Forces evaluation of the receiver, causing the real object to be returned immediately. This method forces the current object reference (the receiver) to be evaluated, resulting in the return of the referenced object. By default, Scripting Bridge deals with references to objects until you actually request some concrete data from them or until you call the `get` method. - Returns: For most properties, the result is a Foundation object such as an `NSString`. For properties with no Foundation equivalent, the result is an `NSAppleEventDescriptor` or another “SBObject“ for most elements.
func (*SBObject) Init ¶
Initializes and returns an instance of an `SBObject` subclass. Scripting Bridge does not actually create an object in the target application until you add the object returned from this method to an element array (“SBElementArray“). - Returns: An `SBObject` object or `nil` if the object could not be initialized.
func (*SBObject) InitWithData ¶
Returns an instance of an `SBObject` subclass initialized with the given data. Scripting Bridge does not actually create an object in the target application until you add the object returned from this method to an element array (“SBElementArray“). - Parameters: - data: An object containing data for the new `SBObject` object. The data varies according to the type of scripting object to be created. - Returns: An `SBObject` object or `nil` if the object could not be initialized.
func (*SBObject) InitWithElementCodePropertiesData ¶
func (o *SBObject) InitWithElementCodePropertiesData(code uint, properties *foundation.NSDictionary[*foundation.NSString, objc.ID], data objc.ID) *SBObject
Returns an instance of an `SBObject` subclass initialized with the specified properties and data and added to the designated element array. Unlike the other initializers of this class, this method not only initializes the `SBObject` object but adds it to a specified element array. This method is the designated initializer. - Parameters: - code: A four-character code used to identify an element in the target application’s scripting interface. See <doc://com.apple.documentation/documentation/applicationservices/apple_event_manager> for details. - properties: A dictionary with <doc://com.apple.documentation/documentation/foundation/nsnumber> keys specifying the four-character codes of properties (that is, attributes or to-one relationships) and the values for those properties. Pass `nil` if you are initializing the object by `data` only. - data: An object containing data for the new `SBObject` object. The data varies according to the type of scripting object to be created. Pass `nil` if you initializing the object by `properties` only. - Returns: An `SBObject` object or `nil` if the object could not be initialized.
func (*SBObject) InitWithProperties ¶
func (o *SBObject) InitWithProperties(properties *foundation.NSDictionary[objc.ID, objc.ID]) *SBObject
Returns an instance of an `SBObject` subclass initialized with the specified properties. Scripting Bridge does not actually create an object in the target application until you add the object returned from this method to an element array (“SBElementArray“). - Parameters: - properties: A dictionary with keys specifying the names of properties (that is, attributes or to-one relationships) and the values for those properties. - Returns: An `SBObject` object or `nil` if the object could not be initialized.
func (*SBObject) LastError ¶
The error from the last event this object sent, or nil if it succeeded.
func (*SBObject) PropertyWithClassCode ¶
Returns an object of the designated scripting class representing the specified property of the receiver `SBObject` subclasses use this method to implement application-specific property accessor methods. You should not need to call this method directly. > Note: This method doesn't retrieve the value of the property. To get the value, call “get“. - Parameters: - class: The `SBObject` subclass with which to instantiate the object. - code: A four-character code that uniquely identifies a property of the receiver. - Returns: An instance of the designated `class` that represents the receiver’s property identified by `code`.
func (*SBObject) PropertyWithCode ¶
Returns an object representing the specified property of the receiver. `SBObject` subclasses use this method to implement application-specific property accessor methods. You should not need to call this method directly. - Parameters: - code: A four-character code that uniquely identifies a property of the receiver. - Returns: An object representing the receiver’s property as identified by `code`.
func (*SBObject) SetTo ¶
Sets the receiver to a specified value. You should not call this method directly. - Parameters: - value: The data the receiver should be set to. It can be an <doc://com.apple.documentation/documentation/foundation/nsstring>, <doc://com.apple.documentation/documentation/foundation/nsnumber>, <doc://com.apple.documentation/documentation/foundation/nsarray>, `SBObject`, or any other type of object supported by the Scripting Bridge framework.
type Virtual_memory_guard_exception_code_t ¶
type Virtual_memory_guard_exception_code_t int64
const ( KGUARD_EXC_DEALLOC_GAP Virtual_memory_guard_exception_code_t = 1 KGUARD_EXC_RECLAIM_COPYIO_FAILURE Virtual_memory_guard_exception_code_t = 2 KGUARD_EXC_RECLAIM_INDEX_FAILURE Virtual_memory_guard_exception_code_t = 4 KGUARD_EXC_RECLAIM_DEALLOCATE_FAILURE Virtual_memory_guard_exception_code_t = 8 KGUARD_EXC_RECLAIM_ACCOUNTING_FAILURE Virtual_memory_guard_exception_code_t = 9 KGUARD_EXC_SEC_IOPL_ON_EXEC_PAGE Virtual_memory_guard_exception_code_t = 10 KGUARD_EXC_SEC_EXEC_ON_IOPL_PAGE Virtual_memory_guard_exception_code_t = 11 KGUARD_EXC_SEC_UPL_WRITE_ON_EXEC_REGION Virtual_memory_guard_exception_code_t = 12 KGUARD_EXC_LARGE_ALLOCATION_TELEMETRY Virtual_memory_guard_exception_code_t = 13 KGUARD_EXC_SEC_ACCESS_FAULT Virtual_memory_guard_exception_code_t = 98 KGUARD_EXC_SEC_ASYNC_ACCESS_FAULT Virtual_memory_guard_exception_code_t = 99 KGUARD_EXC_SEC_COPY_DENIED Virtual_memory_guard_exception_code_t = 100 KGUARD_EXC_SEC_SHARING_DENIED Virtual_memory_guard_exception_code_t = 101 KGUARD_EXC_MTE_SYNC_FAULT Virtual_memory_guard_exception_code_t = 200 KGUARD_EXC_MTE_ASYNC_USER_FAULT Virtual_memory_guard_exception_code_t = 201 KGUARD_EXC_MTE_ASYNC_KERN_FAULT Virtual_memory_guard_exception_code_t = 202 KGUARD_EXC_GUARD_OBJECT_ASYNC_USER_FAULT Virtual_memory_guard_exception_code_t = 203 KGUARD_EXC_GUARD_OBJECT_ASYNC_KERN_FAULT Virtual_memory_guard_exception_code_t = 204 )
func (Virtual_memory_guard_exception_code_t) String ¶
func (e Virtual_memory_guard_exception_code_t) String() string
type Xpc_listener_create_flags_t ¶
type Xpc_listener_create_flags_t int64
const ( XPC_LISTENER_CREATE_NONE Xpc_listener_create_flags_t = 0 XPC_LISTENER_CREATE_INACTIVE Xpc_listener_create_flags_t = 1 XPC_LISTENER_CREATE_FORCE_MACH Xpc_listener_create_flags_t = 2 XPC_LISTENER_CREATE_FORCE_XPCSERVICE Xpc_listener_create_flags_t = 4 )
func (Xpc_listener_create_flags_t) String ¶
func (e Xpc_listener_create_flags_t) String() string
type Xpc_session_create_flags_t ¶
type Xpc_session_create_flags_t int64
const ( XPC_SESSION_CREATE_NONE Xpc_session_create_flags_t = 0 XPC_SESSION_CREATE_INACTIVE Xpc_session_create_flags_t = 1 XPC_SESSION_CREATE_MACH_PRIVILEGED Xpc_session_create_flags_t = 2 )
func (Xpc_session_create_flags_t) String ¶
func (e Xpc_session_create_flags_t) String() string