You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Summary: Executes a list of statements within a widget.
8
+
9
+
Introduced: 8.0
10
+
11
+
OS: mac,windows,linux,ios,android
12
+
13
+
Platforms: desktop,mobile
14
+
15
+
Example:
16
+
// Use JavaScript to hide "myButton" in the page displayed in a browser widget.
17
+
do "document.getElementById('myButton').hidden = 'hidden'" in widget "myBrowser"
18
+
19
+
Parameters:
20
+
script (string): The code to execute within the widget.
21
+
widget: A widget reference
22
+
23
+
Description:
24
+
Use the <do in widget> command to execute statements in a widget. LiveCode sends a "OnDo" message with <script> as parameter to the widget, which can then handle that messages to run the code appropriately.
Syntax: go { forward | forth | back[ward] } in <widget>
6
+
7
+
Summary: Navigates forward or backward in a widget.
8
+
9
+
Introduced: 8.0
10
+
11
+
OS: mac,windows,linux,ios,android
12
+
13
+
Platforms: desktop,mobile
14
+
15
+
Example:
16
+
// Navigate to previous page in browser widget.
17
+
go back in widget "myBrowser"
18
+
19
+
Example:
20
+
// Return after previous call to "go back"
21
+
go forward in widget "myBrowser"
22
+
23
+
Parameters:
24
+
widget: A widget reference.
25
+
26
+
Description:
27
+
Use the <go in widget> command to navigate within a widget. LiveCode sends a "OnGoBack" or "OnGoForward" message to the widget, which can then handle those messages to provide back / forward navigation.
launch url "http://www.livecode.com" in widget "myWebBrowser"
17
+
18
+
Parameters:
19
+
url (string): The URL to launch. The supported url types will vary depending on the capabilities of the widget.
20
+
widget: A widget reference.
21
+
22
+
Description:
23
+
Use the <launch url> command to open a url within a widget. When <launch url in widget> is called, LiveCode sends a "OnLaunchURL" message to that widget with <url> as the parameter. The widget can then display the url in an appropriate manner.
Summary: Locks the clipboard to prevent updates by other apps.
8
+
9
+
Introduced: 8.0
10
+
11
+
OS: mac,windows,linux
12
+
13
+
Platforms: desktop
14
+
15
+
Example:
16
+
lock the clipboard
17
+
18
+
Description:
19
+
Use the <lock clipboard> <command> to ensure that other apps do not change the contents of the clipboard while you are working with it.
20
+
21
+
>*Note:* If you use the <clipboardData> or <fullClipboardData> properties, locking the clipboard is not required (it will be done automatically) but is recommended.
22
+
23
+
While the clipboard is locked, the contents of the clipboard available via the <clipboardData>, <fullClipboardData> and <rawClipboardData> properties will not change due to accesses by other apps. Similarly, changes made within LiveCode will not be visible to other apps until the clipboard is unlocked (using the <unlock clipboard> <command>).
24
+
25
+
>*Tip:* Use <lock clipboard> to ensure the clipboard does not change between accesses.
26
+
27
+
Locking the clipboard will throw an error if it is already locked.
Summary: Unlocks the clipboard and pushes the changes to the system clipboard.
8
+
9
+
Introduced: 8.0
10
+
11
+
OS: mac,windows,linux
12
+
13
+
Platforms: desktop
14
+
15
+
Example:
16
+
unlock the clipboard
17
+
18
+
Description:
19
+
Use the <unlock clipboard> <command> to make the contents of the clipboard available to other apps.
20
+
21
+
>*Note:* If you use the <clipboardData> or <fullClipboardData> properties, locking the clipboard is not required (it will be done automatically) but is recommended.
22
+
23
+
>*Tip:* Use <lock clipboard> to ensure the clipboard does not change between accesses.
24
+
25
+
Unlocking the clipboard will throw an error if the clipboard is not locked.
@@ -39,6 +39,9 @@ put revOpenDatabase("sqlite", "mydb.sqlite", "binary,extensions") -- enable both
39
39
Example:
40
40
get revOpenDatabase("mysql", "localhost", "dbName", myUsr, myPass, false, "/var/mysql.sock", 1, true)
41
41
42
+
Example:
43
+
get revOpenDatabase("postgresql", "192.168.1.100", "dbName", myUsr, myPass, "sslmode=require", "sslcompression=0")
44
+
42
45
Parameters:
43
46
host (string): A string specifying the IP address or domain name of the system hosting the database. For SQLite databases, the host should be the full path to the database file.
44
47
port: A number specifying the port number you want to connect to, and is used only for MySQL and PostgreSQL databases. If no port is specified, MySQL database connections use port 3306 and PostgreSQL database connections use port 5432.
@@ -64,6 +67,21 @@ databaseType (enum): A string specifying the database type to use. One of the fo
64
67
- "valentina"
65
68
- "sqlite"
66
69
filename: (SQLite Only) A string specifying the path to the SQLite database.
70
+
sslOption (string): (PostgreSQL Only) A string of the form "key=value" specifying the SSL options to use when connecting. The key is the name of the option you want to set, the value is the value you want the option to take. Any number of key value pairs can be specified, each in a new parameter. The set of recognized SSL option and their expected values are as follows:
71
+
- **"sslmode"**: A string specifying the SSL connection mode to use. There are 6 options:
72
+
- "disable": Only try a non-SSL connection.
73
+
- "allow": First try a non-SSL connection; if that fails, try an SSL connection.
74
+
- "prefer": First try an SSL connection; if that fails, try a non-SSL connection.
75
+
- "require": Only try an SSL connection. If a root CA file is present, verify the certificate in the same way as if verify-ca was specified.
76
+
- "verify-ca": Only try an SSL connection, and verify that the server certificate is issued by a trusted certificate authority (CA).
77
+
- "verify-full": Only try an SSL connection, verify that the server certificate is issued by a trusted CA and that the server host name matches that in the certificate.
78
+
79
+
If no SSL mode is specified, the default will be "prefer" if the security library can be loaded, "disable" if not. If you use SSL connections in a standalone application, remember to select 'SSL Encryption' from among the available 'script libraries' in the standalone application settings panel.
80
+
- **"sslcompression"**: A string specifying the any SSL compression to use. If set to "1" (default), data sent over SSL connections will be compressed. If set to "0", compression will be disabled. This parameter is ignored if a connection without SSL is made. Compression uses CPU time, but can improve throughput if the network is the bottleneck. Disabling compression can improve response time and throughput if CPU performance is the limiting factor.
81
+
- **"sslcert"**: A string specifying the file name of the client SSL certificate, replacing the default ~/.postgresql/postgresql.crt. This parameter is ignored if an SSL connection is not made.
82
+
- **"sslkey"**: A string specifying the location for the secret key used for the client certificate. This parameter is ignored if an SSL connection is not made.
83
+
- **sslrootcert"**: A string specifying the name of a file containing SSL certificate authority (CA) certificate(s). If the file exists, the server's certificate will be verified to be signed by one of these authorities. The default is ~/.postgresql/root.crt.
84
+
- **"sslcrl"**: A string specifying the file name of the SSL certificate revocation list (CRL). Certificates listed in this file, if it exists, will be rejected while attempting to authenticate the server's certificate. The default is ~/.postgresql/root.crl.
67
85
68
86
Returns:
69
87
The <revOpenDatabase> function returns a database ID which can be used to refer to the database in other Database library commands and functions. The database ID is always an integer.
@@ -76,6 +94,8 @@ Use the <revOpenDatabase> function to start working with a database.
76
94
77
95
>*Important:* The revOpenDatabase function is part of the Database library. To ensure that the function works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions section of the General screen of the Standalone Application Settings window, make sure the Database Support checkbox is checked and the database drivers you are using are selected in the list of database drivers.
78
96
97
+
>*Important:* If you are using any of the MySQL or PostgreSQL SSL connection options in a standalone application, make sure to select 'SSL Encryption' from among the available 'script libraries' in the standalone application settings panel.
98
+
79
99
The version of SQLite has been updated to 3.8.2.
80
100
81
101
The SQLite RTREE module is now available.
@@ -86,6 +106,8 @@ Binary data can now be placed into SQLite databases verbatim (without the encodi
86
106
87
107
The SQLite revOpenDatabase() call no longer requires 5 arguments and only requires a minimum of 2.
88
108
109
+
The version of the PostgreSQL library has been updated to 9.4.5.
Copy file name to clipboardExpand all lines: docs/dictionary/property/clipboardData.lcdoc
+11-5Lines changed: 11 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -51,16 +51,22 @@ The <clipboardData> property is populated automatically when the clipboard conte
51
51
52
52
You can query the keys of the <clipboardData> to determine what types of data are on the clipboard. For example, if the clipboard contains styled text, you can put that text (in htmlText format) in a variable with the following statement:
53
53
54
-
put the clipboardData["html"] into tHTML
54
+
put the clipboardData["html"] into tHTML
55
55
56
-
>*Note:* The objects type can now be queried and will return a binary string that can be re-used. Furthermore, this type is now published to all applications and so object cut/copy/paste operaions can occur between LiveCode processes. To change the contents of the clipboard, you can set the <clipboardData> property directly. For example, the following statement places the text "Hello World" on the clipboard:
56
+
To change the contents of the clipboard, you can set the <clipboardData> property directly. For example, the following statement places the text "Hello World" on the clipboard:
57
57
58
-
set the clipboardData["text"] to "Hello World"
58
+
set the clipboardData["text"] to "Hello World"
59
59
60
60
The above statement is equivalent to selecting the text "Hello World" in a field and choosing Edit menu, or to using the <copy> command. The data you place on the clipboard is accessible to your application using the <paste> command, and to other applications (that support pasting text) using the application's Paste menu item.
61
61
62
62
>*Tip:* To quickly find out what kind of data is on the clipboard, use the <clipboard> function.
>*Tip:* The "objects" type can be used to capture the binary form of a LiveCode object that was placed on the clipboard. This binary data can be passed to another instance of LiveCode or saved to a file and re-loaded at a later time.
65
65
66
-
Tags: ui
66
+
>*Tip:* If you require low-level access to the clipboard contents, use the <rawClipboardData> property instead.
67
+
68
+
>*Tip:* To prevent the clipboard from being changed by other apps while you are accessing it, use the <lock clipboard> and <unlock clipboard> commands.
0 commit comments