Jump to content

WPUrl: Difference between revisions

From EDM2
No edit summary
Ak120 (talk | contribs)
mNo edit summary
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
(OS/2 V4) Uniform Resource Locator class (Internet addresses). These are stored as physical data files on disk, but contain additional data in their Extended Attributes.
;Default Tittle: "URL"
;DLL: [[WPINET.DLL]]
;Class definition file: WPURL.IDL
==Class hierarchy==
SOMObject
*[[WPObject]]
**[[WPFileSystem]]
***[[WPDataFile]]
****WPUrl


==Setup strings for WPUrl objects (WARP 4)==
==Setup strings for WPUrl objects (WARP 4)==
These are the setup strings for the new WPUrl objects in WARP 4. In WARP 3 you should use the object class WebExplorer_Url. (see also Default Settings for WPUrl Objects and Getting the filename of WPDatafile objects)
These are the setup strings for the new WPUrl objects in WARP 4. In WARP 3 you should use the object class WebExplorer_Url. (see also Default Settings for WPUrl Objects and Getting the filename of WPDatafile objects)


{|class="wikitable"
  Class WPUrl
|+Class WPUrl
 
!Key Name||Value||Description
  Key Name         Value         Description
|-
  ----------------------------------------------------------------------
|BROWSER||name or pathname||This specifies the executable that will be invoked to display the web page designated in the "Url" field.
  BROWSER         name or       This specifies the executable that
This field can be either a pathname or a name of a browser in the PATH. EXPLORE.EXE is the default browser for OS/2 WARP. The Java applet viewer (APPLET.EXE) can be used here to view Java applets with the URL object, but be sure to set the "Integrated browser" check box on the Browser page to NO, because APPLET.EXE does not understand the URL-specific browser options.
                  pathname      will be invoked to display the web
|-
                                  page designated in the "Url" field.
|DEFAULTBROWSER||name or pathname||This sets the default value for BROWSER for all URL objects. This value will be placed in the "Path and file name" field on the Browser page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created. Also see the definition for BROWSER.
                                  This field can be either a pathname
|-
                                  or a name of a browser in the PATH.
|rowspan=2|DEFAULTDISPLAYIMAGES||YES||This sets the default value for DISPLAYIMAGES for all URL objects. This value is used for the "Display images while loading" check box of a URL's properties notebook when the Default push button is pressed or when the URL object is first created. When this keyname is set to YES, the "Display images while loading" check box is checked. Also see the definition for DISPLAYIMAGES.
                                  EXPLORE.EXE is the default browser
|-
                                  for OS/2 WARP. The Java applet
|NO||The "Display images while loading" check box is unchecked. Also see the definition for DISPLAYIMAGES.
                                  viewer (APPLET.EXE) can be used here
|-
                                  to view Java applets with the URL
|DEFAULTEMAILADDRESS||address||This sets the default value for EMAILADDRESS for all URL objects. This value will be placed in the "Electronic mail address" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created. Also see the definition for EMAILADDRESS.
                                  object, but be sure to set the
|-
                                  "Integrated browser" check box on
|rowspan=2|DEFAULTENABLEPROXY||YES||This sets the default value for ENABLEPROXY for all URL objects. The "Proxy gateway" check box on the Server page of a URL's properties notebook is checked when the Default push button is pressed and when the URL object is first created. Also see the definition for ENABLEPROXY.
                                  the Browser page to NO, because
|-
                                  APPLET.EXE does not understand the
|NO||The "Proxy gateway" check box is unchecked. Also see the definition for ENABLEPROXY.
                                  URL-specific browser options.
|-
 
|rowspan=2|DEFAULTENABLESOCKS||YES||This sets the default value for ENABLESOCKS for all URL objects. The "Socks server" check box on the Server page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.
  DEFAULTBROWSER   name or       This sets the default value for
Also see the definition for ENABLESOCKS.
                  pathname      BROWSER for all URL objects. This
|-
                                  value will be placed in the "Path
|NO||The "Socks server" check box is unchecked. Also see the definition for ENABLESOCKS.
                                  and file name" field on the Browser
|-
                                  page of a URL's properties notebook
|rowspan=2|DEFAULTINTEGRATEDBROWSER||YES||This sets the default value for INTEGRATEDBROWSER for all URL objects. The "Integrated browser" check box on the Browser page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.
                                  when the Default push button is
Also see the definition for INTEGRATEDBROWSER.
                                  pressed and when the URL object is
|-
                                  first created.
|NO||The "Proxy gateway" check box is unchecked. Also see the definition for INTEGRATEDBROWSER.
                                  Also see the definition for BROWSER.
|-
 
|rowspan=2|DEFAULTLOADGRAPHICS||YES||This sets the default value for LOADGRAPHICS for all URL objects. The "Load graphics" check box on the Browser page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.
  DEFAULTDISPLAYIMAGES
Also see the definition for LOADGRAPHICS.
                  YES           This sets the default value for
|-
                                  DISPLAYIMAGES for all URL objects.
|NO||The "Load graphics" check box is unchecked.
                                  This value is used for the "Display
                                  images while loading" check box of a
                                  URL's properties notebook when the
                                  Default push button is pressed or
                                  when the URL object is first
                                  created. When this keyname is set
                                  to YES, the "Display images while
                                  loading" check box is checked.
                                  Also see the definition for
                                  DISPLAYIMAGES.
 
                  NO             The "Display images while loading"
                                  check box is unchecked.
                                  Also see the definition for
                                  DISPLAYIMAGES.
 
  DEFAULTEMAILADDRESS
                  address       This sets the default value for
                                  EMAILADDRESS for all URL objects.
                                  This value will be placed in the
                                  "Electronic mail address" field on
                                  the Server page of a URL's
                                  properties notebook when the Default
                                  push button is pressed and when the
                                  URL object is first created.
                                  Also see the definition for
                                  EMAILADDRESS.
 
  DEFAULTENABLEPROXY
                  YES           This sets the default value for
                                  ENABLEPROXY for all URL objects.
                                  The "Proxy gateway" check box on the
                                  Server page of a URL's properties
                                  notebook is checked when the Default
                                  push button is pressed and when the
                                  URL object is first created.
                                  Also see the definition for
                                  ENABLEPROXY.
 
                  NO             The "Proxy gateway" check box is
                                  unchecked.
                                  Also see the definition for
                                  ENABLEPROXY.
 
  DEFAULTENABLESOCKS
                  YES           This sets the default value for
                                  ENABLESOCKS for all URL objects.
                                  The "Socks server" check box on the
                                  Server page of a URL's properties
                                  notebook is checked when the Default
                                  push button is pressed or when the
                                  URL object is first created.
                                  Also see the definition for
                                  ENABLESOCKS.
 
                  NO             The "Socks server" check box is
                                  unchecked.
                                  Also see the definition for
                                  ENABLESOCKS.
 
  DEFAULTINTEGRATEDBROWSER
                  YES           This sets the default value for
                                  INTEGRATEDBROWSER for all URL
                                  objects. The "Integrated browser"
                                  check box on the Browser page of a
                                  URL's properties notebook is checked
                                  when the Default push button is
                                  pressed or when the URL object is
                                  first created.
                                  Also see the definition for
                                  INTEGRATEDBROWSER.
 
                  NO             The "Proxy gateway" check box is
                                  unchecked.
                                  Also see the definition for
                                  INTEGRATEDBROWSER.
 
  DEFAULTLOADGRAPHICS
                  YES           This sets the default value for
                                  LOADGRAPHICS for all URL objects.
                                  The "Load graphics" check box on the
                                  Browser page of a URL's properties
                                  notebook is checked when the Default
                                  push button is pressed or when the
                                  URL object is first created.
                                  Also see the definition for
                                  LOADGRAPHICS.
 
                  NO             The "Load graphics" check box is
                                  unchecked.
                                  Also see the definition for
                                  LOADGRAPHICS.
 
  DEFAULTNEWSSERVER
                  newsserver    This sets the default value for
                                  NEWSERVER for all URL objects.  This
                                  value will be placed in the
                                  "Newsserver" field on the Server
                                  page of a URL's properties notebook
                                  when the Default push button is
                                  pressed and when the URL object is
                                  first created.
                                  Also see the definition for
                                  NEWSERVER.
 
  DEFAULTPALETTEAWARE
                  YES            This sets the default value for
                                  PALETTEAWARE for all URL objects.
                                  The "Palette aware" check box on the
                                  Web page of a URL's properties
                                  notebook is checked when the Default
                                  push button is pressed or when the
                                  URL object is first created.
                                  Also see the definition for
                                  PALETTEAWARE.
 
                  NO            The "Palette aware" check box is
                                  unchecked.
                                  Also see the definition for
                                  PALETTEAWARE.
 
  DEFAULTPARAMETERS
                  parameters    This sets the default value for
                                  PARAMETERS for all URL objects.
                                  This value will be placed in the
                                  "Parameters" field on the Browser
                                  page of a URL's properties notebook
                                  when the Default push button is
                                  pressed and when the URL object is
                                  first created.
                                  Also see the definition for
                                  PARAMETERS.
 
  DEFAULTPRESENTATIONMODE
                  YES            This sets the default value for
                                  PRESENTATIONMODE for all URL
                                  objects.  The "Presentation mode"
                                  check box on the Web page of a URL's
                                  properties notebook is checked when
                                  the Default push button is pressed
                                  or when the URL object is first
                                  created.
                                  Also see the definition for
                                  PRESENTATIONMODE.
 
                  NO            The "Presentation mode" check box is
                                  unchecked.
                                  Also see the definition for
                                  PRESENTATIONMODE.
 
  DEFAULTPROXYGATEWAY
                  proxy          This sets the default value for
                                  PROXYGATEWAY for all URL objects.
                                  This value will be placed in the
                                  "Proxy gatewway" field on the Server
                                  page of a URL's properties notebook
                                  when the Default push button is
                                  pressed and when the URL object is
                                  first created.
                                  Also see the definition for
                                  PROXYGATEWAY.
 
  DEFAULTSOCKSSERVER
                  socks          This sets the default value for
                                  SOCKSERVER for all URL objects.
                                  This value will be placed in the
                                  "Socks server" field on the Server
                                  page of a URL's properties notebook
                                  when the Default push button is
                                  pressed and when the URL object is
                                  first created.
                                  Also see the definition for
                                  SOCKSERVER.
 
  DEFAULTWORKINGDIR
                  directory      This sets the default value for
                                  WORKINGDIR for all URL objects.
                                  This value will be placed in the
                                  "Working directory" field on the
                                  Server page of a URL's properties
                                  notebook when the Default push
                                  button is pressed and when the URL
                                  object is first created.
                                  Also see the definition for
                                  WORKINGDIR.
 
  DISPLAYIMAGES    YES            This specifies that the browser show
                                  the images as they are being
                                  constructed on the page while being
                                  received from the server.  This is
                                  the default value for the "Display
                                  images while loading" check box on
                                  the Web page.
 
                  NO            The "Display images while loading"
                                  check box is unchecked.  This
                                  specifies that the browser show the
                                  page when all of the images have
                                  been received from the server.
 
  EMAILADDRESS    address        This is a required field.  This
                                  specifies the user's return e-mail
                                  address to be used by the browser
                                  when responding to other users on
                                  mail-to fields of web pages or
                                  newsgroup articles.  This should be
                                  the complete internet e-mail
                                  address.  For example:
                                    marysmith.@ibm.net
 
                                  Leaving this field blank will
                                  prevent you from responding to
                                  mail-to fields and newsgroup
                                  articles.
 
  ENABLEPROXY      YES            This sets the default value for
                                  PROXYGATEWAY for all URL objects.
                                  If the "Enable proxy?" check box on
                                  the Server page is checked. the
                                  proxy server will be used.
 
                  NO            If the "Enable proxy?" check box is
                                  not checked, the proxy server will
                                  not be used.
 
  INTEGRATEDBROWSER
                  YES            This sets the default value for
                                  BROWSER for all URL objects.  If the
                                  "Integrated browser" check box on
                                  the Browser page is checked, this
                                  specified that the designated
                                  executable has been integrated with
                                  the URL object.
                                  For example, the IBM WebExplorer
                                  browser has been integrated, you
                                  would specify YES if you are using
                                  EXPLORE.EXE.  The Java Applet viewer
                                  is not integrated if you are using
                                  APPLET.EXE.
                                  Other browsers might not be
                                  integrated with the URL object.
                                  Check the documentation provided
                                  with your browser.
 
                  NO            If the "Integrated browser" check
                                  box is not checked, you will be
                                  unable to use certain browser
                                  parameters (for example, Palette
                                  Aware, Presentation Mode, and Load
                                  Graphics) because a non-integrated
                                  browser cannot interpret these
                                  command-line arguments.
 
  LOADGRAPHICS    YES            This specifies that you can load
                                  graphics and images on the web page
                                  specified by the URL if the "Load
                                  graphics" check box on the Web page
                                  is checked.
 
                  NO            If the "Load graphics" check box is
                                  not checked, will only be able to
                                  view text, but not graphics, on a
                                  web page.  This will speed up page
                                  downloads if you specific not to
                                  load graphics.
 
  LOCATOR          url            This specifies the Uniform Resource
                                  Locator that uniquely identifies
                                  each web page designated in the
                                  "Uniform Resource Locator (URL)"
                                  field on the Web page.
                                  The URL is the address for the page
                                  on the web.  For example:
                                    http://www.ibm.net
 
                                  The keywords LOCATOR and URL can be
                                  used interchangeably.
 
  NEWSERVER        news          This specifies the host name or IP
                                  address of the server that handles
                                  newsgroups for the user's company or
                                  account.  The first example is a
                                  host name and the second example is
                                  an IP address:
                                    news.company.com
                                  or
                                    128.35.89.2


  PALETTEAWARE    YES            This is the default value for
Also see the definition for LOADGRAPHICS.
                                  BROWSER for all URL objects. This
|-
                                  value will be placed in the
|DEFAULTNEWSSERVER||newsserver||This sets the default value for NEWSERVER for all URL objects. This value will be placed in the "Newsserver" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.
                                  "Paletteaware" check box on the Web
Also see the definition for NEWSERVER.
                                  page.  This specifies that the OS/2
|-
                                  palette be used to display pages and
|rowspan=2|DEFAULTPALETTEAWARE||YES||This sets the default value for PALETTEAWARE for all URL objects.
                                  images.
The "Palette aware" check box on the Web page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.


                  NO             The "Paletteaware" check box on the
Also see the definition for PALETTEAWARE.
                                  Web page will not be checked.  If
|-
                                  color problems are detected while
|NO||The "Palette aware" check box is unchecked.
                                  displaying web pages with your
                                  browser, set this value to NO.


  PARAMETERS      params        This specifies strings to be
Also see the definition for PALETTEAWARE.
                                  included on the command line
|-
                                  invocation of (passed to) the
|DEFAULTPARAMETERS||parameters||This sets the default value for PARAMETERS for all URL objects.
                                  executable designated when it is
This value will be placed in the "Parameters" field on the Browser page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.
                                  started.  If the browser being used
                                  permits optional parameters, declare
                                  them using this value.
                                  This sets the default value for
                                  BROWSER for all URL objects. This
                                  value will be placed in the
                                  "Parameters" field on the Browser
                                  page.


  PRESENTATIONMODE
Also see the definition for PARAMETERS.
                  YES            This specifies that the browser use
|-
                                  the full-screen (nonwindowed) mode.
|rowspan=2|DEFAULTPRESENTATIONMODE||YES||This sets the default value for PRESENTATIONMODE for all URL objects. The "Presentation mode" check box on the Web page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.
                                  This mode is generally used for
                                  presentations. This value is used
                                  for the "Presentation mode" check
                                  box on the Web page.  This is the
                                  default value, which specifies that
                                  the executable use the OS/2 palette
                                  to display its pages and images.


                  NO             The "Presentation mode" check box
Also see the definition for PRESENTATIONMODE.
                                  will not be checked.  If color
|-
                                  problems are detected while
|NO||The "Presentation mode" check box is unchecked.
                                  displaying web pages with your
                                  browser, set this value to NO.


  PROXYGATEWAY    proxy         This specifies the URL of the server
Also see the definition for PRESENTATIONMODE.
                                  that handles the interface to the
|-
                                  web for the user's company or
|DEFAULTPROXYGATEWAY||proxy||This sets the default value for PROXYGATEWAY for all URL objects.
                                  account.  It is the firewall for
This value will be placed in the "Proxy gatewway" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.
                                  insulation of a company from the
                                  outside world. A proxy port can
                                  also be appended to the end of the
                                  proxy string if the proxy server
                                  supports it.  For example:
                                    http://proxy.company.com/
                                  or
                                    http://128.35.89.2/


                                  A proxy port can also be appended to
Also see the definition for PROXYGATEWAY.
                                  the end of the proxy string if the
|-
                                  proxy server supports it.  For
|DEFAULTSOCKSSERVER||socks||This sets the default value for SOCKSERVER for all URL objects.
                                  example:
This value will be placed in the "Socks server" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.
                                    http://proxy.company.com:80/


                                  This value will be placed in the
Also see the definition for SOCKSERVER.
                                  "Proxy gateway" field on the Server
|-
                                  page. The slash on the end is
|DEFAULTWORKINGDIR||directory||This sets the default value for WORKINGDIR for all URL objects.
                                  required syntax.
This value will be placed in the "Working directory" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.
                                  Contact your system administrator
                                  for details about using a proxy
                                  gateway server on your system.


  SOCKSERVER      socks          This specifies the socks support
Also see the definition for WORKINGDIR.
                                  that will provide access the web
|-
                                  through a firewall, which provides
|rowspan=2|DISPLAYIMAGES||YES||This specifies that the browser show the images as they are being constructed on the page while being received from the server. This is the default value for the "Display images while loading" check box on the Web page.
                                  for insulation of a company from the
|-
                                  outside world. This value is placed
|NO||The "Display images while loading" check box is unchecked. This specifies that the browser show the page when all of the images have been received from the server.
                                  in the "Socks server" field on the
|-
                                  Server page.
|EMAILADDRESS||address||This is a required field. This specifies the user's return e-mail address to be used by the browser when responding to other users on mail-to fields of web pages or newsgroup articles. This should be the complete internet e-mail address. For example: marysmith.@ibm.net
                                  For example:
Leaving this field blank will prevent you from responding to mail-to fields and newsgroup articles.
                                    http://socks.company.com/
|-
                                  or
|rowspan=2|ENABLEPROXY||YES||This sets the default value for PROXYGATEWAY for all URL objects.
                                    http:/socks.company.com:80/
If the "Enable proxy?" check box on the Server page is checked. the proxy server will be used.
|-
|NO||If the "Enable proxy?" check box is not checked, the proxy server will not be used.
|-
|rowspan=2|INTEGRATEDBROWSER||YES||This sets the default value for BROWSER for all URL objects. If the "Integrated browser" check box on the Browser page is checked, this specified that the designated executable has been integrated with the URL object.
For example, the IBM WebExplorer browser has been integrated, you would specify YES if you are using EXPLORE.EXE. The Java Applet viewer is not integrated if you are using APPLET.EXE.
Other browsers might not be integrated with the URL object.
Check the documentation provided with your browser.
|-
|NO||If the "Integrated browser" check box is not checked, you will be unable to use certain browser parameters (for example, Palette Aware, Presentation Mode, and Load Graphics) because a non-integrated browser cannot interpret these command-line arguments.
|-
|rowspan=2|LOADGRAPHICS||YES||This specifies that you can load graphics and images on the web page specified by the URL if the "Load graphics" check box on the Web page is checked.
|-
|NO||If the "Load graphics" check box is not checked, will only be able to view text, but not graphics, on a web page. This will speed up page downloads if you specific not to load graphics.
|-
|LOCATOR||url||This specifies the Uniform Resource Locator that uniquely identifies each web page designated in the "Uniform Resource Locator (URL)" field on the Web page. The URL is the address for the page on the web. For example:
<tt><nowiki>http://www.ibm.net</nowiki></tt>


                                  The slash on the end is required
The keywords LOCATOR and URL can be used interchangeably.
                                  syntax.
|-
|NEWSERVER||news||This specifies the host name or IP address of the server that handles newsgroups for the user's company or account. The first example is a host name and the second example is an IP address: news.company.com or 128.35.89.2
|-
|rowspan=2|PALETTEAWARE||YES||This is the default value for BROWSER for all URL objects. This value will be placed in the "Paletteaware" check box on the Web page. This specifies that the OS/2 palette be used to display pages and images.
|-
|NO||The "Paletteaware" check box on the Web page will not be checked. If color problems are detected while displaying web pages with your browser, set this value to NO.
|-
|PARAMETERS||params||This specifies strings to be included on the command line invocation of (passed to) the executable designated when it is started. If the browser being used permits optional parameters, declare them using this value.
This sets the default value for BROWSER for all URL objects. This value will be placed in the "Parameters" field on the Browser page.
|-
|rowspan=2|PRESENTATIONMODE||YES||This specifies that the browser use the full-screen (nonwindowed) mode.
This mode is generally used for presentations. This value is used for the "Presentation mode" check box on the Web page. This is the default value, which specifies that the executable use the OS/2 palette to display its pages and images.
|-
|NO||The "Presentation mode" check box will not be checked. If color problems are detected while displaying web pages with your browser, set this value to NO.
|-
|PROXYGATEWAY||proxy||This specifies the URL of the server that handles the interface to the web for the user's company or account. It is the firewall for insulation of a company from the outside world. A proxy port can also be appended to the end of the proxy string if the proxy server supports it. For example:
<tt><nowiki>http://proxy.company.com/</nowiki></tt> or <tt><nowiki>http://128.35.89.2/</nowiki></tt>
A proxy port can also be appended to the end of the proxy string if the proxy server supports it. For example: <tt><nowiki>http://proxy.company.com:80/</nowiki></tt>


  WORKINGDIR      directory      This specifies OS/2 working
This value will be placed in the "Proxy gateway" field on the Server page. The slash on the end is required syntax.
                                  directory for the executable, if
Contact your system administrator for details about using a proxy gateway server on your system.
                                  required, and sets the default value
|-
                                  for BROWSER for all URL objects.
|SOCKSERVER||socks||This specifies the socks support that will provide access the web through a firewall, which provides for insulation of a company from the outside world. This value is placed in the "Socks server" field on the Server page.
                                  This value will be placed in the
For example: <tt><nowiki>http://socks.company.com/</nowiki></tt> or <tt><nowiki>http:/socks.company.com:80/</nowiki></tt>
                                  "Working directory" field on the
                                  Browser page. A working directory
                                  is required if the specified browser
                                  requires DLLs or other files from a
                                  directory not specified in the
                                  LIBPATH or other environment
                                  variables.


  URL             url           This specifies the Uniform Resource
The slash on the end is required syntax.
                                  Locator that uniquely identifies
|-
                                  each web page designated in the
|WORKINGDIR||directory||This specifies OS/2 working directory for the executable, if required, and sets the default value for BROWSER for all URL objects.
                                  "Uniform Resource Locator (URL)"
This value will be placed in the "Working directory" field on the Browser page. A working directory is required if the specified browser requires DLLs or other files from a directory not specified in the LIBPATH or other environment variables.
                                  field on the web page.
|-
                                  The URL is the address for a page on
|URL||url||This specifies the Uniform Resource Locator that uniquely identifies each web page designated in the "Uniform Resource Locator (URL)" field on the web page.
                                  the web. For example, an URL might
The URL is the address for a page on the web. For example, an URL might be:
                                  be:
<tt><nowiki>http:/www.ibm.net</nowiki></tt>
                                    http:/www.ibm.net


                                  The keywords URL and LOCATOR can be
The keywords URL and LOCATOR can be used interchangeably.
                                  used interchangeably.
|}


[[Category:The OS/2 API Project]]
[[Category:Workplace Shell Internet classes]]

Latest revision as of 03:54, 27 December 2022

(OS/2 V4) Uniform Resource Locator class (Internet addresses). These are stored as physical data files on disk, but contain additional data in their Extended Attributes.

Default Tittle
"URL"
DLL
WPINET.DLL
Class definition file
WPURL.IDL

Class hierarchy

SOMObject

Setup strings for WPUrl objects (WARP 4)

These are the setup strings for the new WPUrl objects in WARP 4. In WARP 3 you should use the object class WebExplorer_Url. (see also Default Settings for WPUrl Objects and Getting the filename of WPDatafile objects)

Class WPUrl
Key Name Value Description
BROWSER name or pathname This specifies the executable that will be invoked to display the web page designated in the "Url" field.

This field can be either a pathname or a name of a browser in the PATH. EXPLORE.EXE is the default browser for OS/2 WARP. The Java applet viewer (APPLET.EXE) can be used here to view Java applets with the URL object, but be sure to set the "Integrated browser" check box on the Browser page to NO, because APPLET.EXE does not understand the URL-specific browser options.

DEFAULTBROWSER name or pathname This sets the default value for BROWSER for all URL objects. This value will be placed in the "Path and file name" field on the Browser page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created. Also see the definition for BROWSER.
DEFAULTDISPLAYIMAGES YES This sets the default value for DISPLAYIMAGES for all URL objects. This value is used for the "Display images while loading" check box of a URL's properties notebook when the Default push button is pressed or when the URL object is first created. When this keyname is set to YES, the "Display images while loading" check box is checked. Also see the definition for DISPLAYIMAGES.
NO The "Display images while loading" check box is unchecked. Also see the definition for DISPLAYIMAGES.
DEFAULTEMAILADDRESS address This sets the default value for EMAILADDRESS for all URL objects. This value will be placed in the "Electronic mail address" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created. Also see the definition for EMAILADDRESS.
DEFAULTENABLEPROXY YES This sets the default value for ENABLEPROXY for all URL objects. The "Proxy gateway" check box on the Server page of a URL's properties notebook is checked when the Default push button is pressed and when the URL object is first created. Also see the definition for ENABLEPROXY.
NO The "Proxy gateway" check box is unchecked. Also see the definition for ENABLEPROXY.
DEFAULTENABLESOCKS YES This sets the default value for ENABLESOCKS for all URL objects. The "Socks server" check box on the Server page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.

Also see the definition for ENABLESOCKS.

NO The "Socks server" check box is unchecked. Also see the definition for ENABLESOCKS.
DEFAULTINTEGRATEDBROWSER YES This sets the default value for INTEGRATEDBROWSER for all URL objects. The "Integrated browser" check box on the Browser page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.

Also see the definition for INTEGRATEDBROWSER.

NO The "Proxy gateway" check box is unchecked. Also see the definition for INTEGRATEDBROWSER.
DEFAULTLOADGRAPHICS YES This sets the default value for LOADGRAPHICS for all URL objects. The "Load graphics" check box on the Browser page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.

Also see the definition for LOADGRAPHICS.

NO The "Load graphics" check box is unchecked.

Also see the definition for LOADGRAPHICS.

DEFAULTNEWSSERVER newsserver This sets the default value for NEWSERVER for all URL objects. This value will be placed in the "Newsserver" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.

Also see the definition for NEWSERVER.

DEFAULTPALETTEAWARE YES This sets the default value for PALETTEAWARE for all URL objects.

The "Palette aware" check box on the Web page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.

Also see the definition for PALETTEAWARE.

NO The "Palette aware" check box is unchecked.

Also see the definition for PALETTEAWARE.

DEFAULTPARAMETERS parameters This sets the default value for PARAMETERS for all URL objects.

This value will be placed in the "Parameters" field on the Browser page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.

Also see the definition for PARAMETERS.

DEFAULTPRESENTATIONMODE YES This sets the default value for PRESENTATIONMODE for all URL objects. The "Presentation mode" check box on the Web page of a URL's properties notebook is checked when the Default push button is pressed or when the URL object is first created.

Also see the definition for PRESENTATIONMODE.

NO The "Presentation mode" check box is unchecked.

Also see the definition for PRESENTATIONMODE.

DEFAULTPROXYGATEWAY proxy This sets the default value for PROXYGATEWAY for all URL objects.

This value will be placed in the "Proxy gatewway" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.

Also see the definition for PROXYGATEWAY.

DEFAULTSOCKSSERVER socks This sets the default value for SOCKSERVER for all URL objects.

This value will be placed in the "Socks server" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.

Also see the definition for SOCKSERVER.

DEFAULTWORKINGDIR directory This sets the default value for WORKINGDIR for all URL objects.

This value will be placed in the "Working directory" field on the Server page of a URL's properties notebook when the Default push button is pressed and when the URL object is first created.

Also see the definition for WORKINGDIR.

DISPLAYIMAGES YES This specifies that the browser show the images as they are being constructed on the page while being received from the server. This is the default value for the "Display images while loading" check box on the Web page.
NO The "Display images while loading" check box is unchecked. This specifies that the browser show the page when all of the images have been received from the server.
EMAILADDRESS address This is a required field. This specifies the user's return e-mail address to be used by the browser when responding to other users on mail-to fields of web pages or newsgroup articles. This should be the complete internet e-mail address. For example: marysmith.@ibm.net

Leaving this field blank will prevent you from responding to mail-to fields and newsgroup articles.

ENABLEPROXY YES This sets the default value for PROXYGATEWAY for all URL objects.

If the "Enable proxy?" check box on the Server page is checked. the proxy server will be used.

NO If the "Enable proxy?" check box is not checked, the proxy server will not be used.
INTEGRATEDBROWSER YES This sets the default value for BROWSER for all URL objects. If the "Integrated browser" check box on the Browser page is checked, this specified that the designated executable has been integrated with the URL object.

For example, the IBM WebExplorer browser has been integrated, you would specify YES if you are using EXPLORE.EXE. The Java Applet viewer is not integrated if you are using APPLET.EXE. Other browsers might not be integrated with the URL object. Check the documentation provided with your browser.

NO If the "Integrated browser" check box is not checked, you will be unable to use certain browser parameters (for example, Palette Aware, Presentation Mode, and Load Graphics) because a non-integrated browser cannot interpret these command-line arguments.
LOADGRAPHICS YES This specifies that you can load graphics and images on the web page specified by the URL if the "Load graphics" check box on the Web page is checked.
NO If the "Load graphics" check box is not checked, will only be able to view text, but not graphics, on a web page. This will speed up page downloads if you specific not to load graphics.
LOCATOR url This specifies the Uniform Resource Locator that uniquely identifies each web page designated in the "Uniform Resource Locator (URL)" field on the Web page. The URL is the address for the page on the web. For example:

http://www.ibm.net

The keywords LOCATOR and URL can be used interchangeably.

NEWSERVER news This specifies the host name or IP address of the server that handles newsgroups for the user's company or account. The first example is a host name and the second example is an IP address: news.company.com or 128.35.89.2
PALETTEAWARE YES This is the default value for BROWSER for all URL objects. This value will be placed in the "Paletteaware" check box on the Web page. This specifies that the OS/2 palette be used to display pages and images.
NO The "Paletteaware" check box on the Web page will not be checked. If color problems are detected while displaying web pages with your browser, set this value to NO.
PARAMETERS params This specifies strings to be included on the command line invocation of (passed to) the executable designated when it is started. If the browser being used permits optional parameters, declare them using this value.

This sets the default value for BROWSER for all URL objects. This value will be placed in the "Parameters" field on the Browser page.

PRESENTATIONMODE YES This specifies that the browser use the full-screen (nonwindowed) mode.

This mode is generally used for presentations. This value is used for the "Presentation mode" check box on the Web page. This is the default value, which specifies that the executable use the OS/2 palette to display its pages and images.

NO The "Presentation mode" check box will not be checked. If color problems are detected while displaying web pages with your browser, set this value to NO.
PROXYGATEWAY proxy This specifies the URL of the server that handles the interface to the web for the user's company or account. It is the firewall for insulation of a company from the outside world. A proxy port can also be appended to the end of the proxy string if the proxy server supports it. For example:

http://proxy.company.com/ or http://128.35.89.2/ A proxy port can also be appended to the end of the proxy string if the proxy server supports it. For example: http://proxy.company.com:80/

This value will be placed in the "Proxy gateway" field on the Server page. The slash on the end is required syntax. Contact your system administrator for details about using a proxy gateway server on your system.

SOCKSERVER socks This specifies the socks support that will provide access the web through a firewall, which provides for insulation of a company from the outside world. This value is placed in the "Socks server" field on the Server page.

For example: http://socks.company.com/ or http:/socks.company.com:80/

The slash on the end is required syntax.

WORKINGDIR directory This specifies OS/2 working directory for the executable, if required, and sets the default value for BROWSER for all URL objects.

This value will be placed in the "Working directory" field on the Browser page. A working directory is required if the specified browser requires DLLs or other files from a directory not specified in the LIBPATH or other environment variables.

URL url This specifies the Uniform Resource Locator that uniquely identifies each web page designated in the "Uniform Resource Locator (URL)" field on the web page.

The URL is the address for a page on the web. For example, an URL might be: http:/www.ibm.net

The keywords URL and LOCATOR can be used interchangeably.