464
Chapter 12: Methods
postNetText
Usage
postNetText(
url
,
propertyList
{,
serverOSString
} {,
serverCharSetString
})
postNetText(
url
,
postText
{,
serverOSString
} {,
serverCharSetString
})
Description
Command; sends a
POST
request to a URL, which is an HTTP URL, with specified data.
This command is similar to
getNetText()
. As with
getNetText()
, the server’s response is
returned by
netTextResult(
netID
)
once
netDone(
netID
)
becomes 1, and if
netError(
netID
)
is 0, or okay.
The optional parameters may be omitted without regard to position.
This command also has an additional advantage over
getNetText()
: a
postNetText()
query
can be arbitrarily long, whereas the
getNetText()
query is limited to the length of a URL (1K or
4K, depending on the browser).
Note:
If you use
postNetText
to post data to a domain different from the one the movie is playing
from, the movie will display a security alert when playing back in Shockwave Player.
To see an example of
postNetText
used in a completed movie, see the Forms and Post movie in
the Learning/Lingo folder inside the Director application folder.
Parameters
url
Required. Specifies the URL to send the
POST
request to.
propertyList
or
postText
Required. Specifies the data to send with the request. When a
property list is used instead of a string, the information is sent in the same way a browser posts an
HTML form, with
METHOD=POST
. This facilitates the construction and posting of form data
within a Director title. Property names correspond to HTML form field names and property
values to field values.
The property list can use either strings or symbols as the property names. If a symbol is used, it is
automatically converted to a string without the # at the beginning. Similarly, a numeric value is
converted to a string when used as the value of a property.
Note:
If a program uses the alternate form—a string instead of property list—the string postText is sent
to the server as an HTTP POST request using MIME type “text/plain.” This will be convenient for
some applications, but is not compatible with HTML forms posting. PHP scripts, for example, should
always use a property list.
serverOSString
Optional. Defaults to
UNIX
but may be set to
Windows
or
Mac
and translates
any carriage returns in the
postText
argument into those used on the server to avoid confusion.
For most applications, this setting is unnecessary because line breaks are usually not used in
form responses.
serverCharSetString
Optional. Applies only if the user is running on a Shift-JIS (Japanese)
system. Its possible settings are
"JIS"
,
"EUC"
,
"ASCII"
, and
"AUTO"
. Posted data is converted
from Shift-JIS to the named character set. Returned data is handled exactly as by
getNetText()
(converted from the named character set to Shift-JIS). If you use
"AUTO"
, the posted data from
the local character set is not translated; the results sent back by the server are translated as they are
for
getNetText()
.
"ASCII"
is the default if
serverCharSetString
is omitted.
"ASCII"
provides no translation for posting or results.
Содержание DIRECTOR MX 2004-DIRECTOR SCRIPTING
Страница 1: ...DIRECTOR MX 2004 Director Scripting Reference...
Страница 48: ...48 Chapter 2 Director Scripting Essentials...
Страница 100: ...100 Chapter 4 Debugging Scripts in Director...
Страница 118: ...118 Chapter 5 Director Core Objects...
Страница 594: ...594 Chapter 12 Methods...
Страница 684: ...684 Chapter 14 Properties See also DVD...
Страница 702: ...702 Chapter 14 Properties See also face vertices vertices flat...
Страница 856: ...856 Chapter 14 Properties JavaScript syntax sprite 15 member member 3 4...
Страница 889: ...netPresent 889 _player alert Sorry the Network Support Xtras could not be found See also Player...
Страница 1102: ...1102 Chapter 14 Properties...