Differences

This shows you the differences between two versions of the page.

--- built_in:webview [2014/09/17 19:08]
stevegarman created
+++ built_in:webview [2018/08/16 08:46] (current)
@@ Line 1: / Line 1: @@
 ====== WebView control ======
-===== Create =====
-You can create a control to display local or remote web pages in your App using the CreateWebView method of the app object:
-<code>web = app.CreateWebView( width, height );</code>
-If you are loading remote web pages, then you might want to use the SetOnProgress method to set the name of a callback function that you want called to report the progress of loading the page.
-You can use the LoadUrl method to load an internal or external web page or the LoadHtml method to load text directly from within your App.
+//(Information and examples taken from the DroidScript documentation)//
-<code> web.LoadUrl( url );</code>
+===== Description =====
-<code> web.LoadHtml( html, baseFolder );</code>
+You can create a control to display local or remote web pages in your App using the **CreateWebView** method of the **[[built_in:app|app]]** object:
-Note: Using a WebView can be a good way of displaying colored and formatted text areas in your App. If you set the BackColor to a transparent color you can show formatted text over a background image.
+<code>web = app.CreateWebView( width, height, options, zoom );</code>
+options include **"IgnoreErrors", "NoScrollBars", "ScrollFade", "Overview", "AllowZoom", "UseBrowser"**.
-If you need to, you can use the Execute method to execute JavaScript code within the WebView.
+If you are loading remote web pages, then you might want to use the **SetOnProgress** method to set the name of a callback function that you want called to report the progress of loading the page.
+You can use the **LoadUrl** method to load an internal or external web page or the **LoadHtml** method to load text directly from within your App.
+<code> web.LoadUrl( url,options );</code>
+<code> web.LoadHtml( html,baseFolder,options );</code>
+Note: Using a WebView can be a good way of displaying colored and formatted text areas in your App. If you set the BackColor to a transparent color you can show formatted text over a background image.
+If you need to, you can use the **Execute** method to execute JavaScript code within the WebView.
 <code> web.Execute( text );</code>
 ===== Methods =====
+Some controls use the same methods.\\
+For examples of the **[[same methods]]** look here.
 ^Method ^Description ^
-|web.Back| |
+|[[tips_tricks:webview_navigate|WebView.Back()]] | |
-|web.Execute| |
+|[[tips_tricks:webview_navigate|WebView.CanGoBack()]] | |
-|web.Forward| |
+|WebView.CanGoForward() | |
-|web.GetHeight| |
+|WebView.Capture(filename) |captures jpeg of visible page |
-|web.GetVisibility| |
+|WebView.ClearHistory() | |
-|web.GetWidth| |
+|WebView.Execute( code ) | |
-|web.LoadHtml| |
+|WebView.Forward() | |
-|web.LoadUrl| |
+|WebView.GetAbsHeight() | |
-|web.Release| |
+|WebView.GetAbsWidth() | |
-|web.SetBackColor| |
+|WebView.GetHeight() | |
-|web.SetBackGradient| |
+|WebView.GetPosition() | |
-|web.SetBackGradientRadial| |
+|WebView.GetType() | |
-|web.SetBackground| |
+|WebView.GetUrl() | returns the current url|
-|web.SetMargins| |
+|WebView.GetVisibility() | |
-|web.SetOnProgress| |
+|WebView.GetWidth() | |
-|web.SetPadding| |
+|WebView.LoadHtml( html,base,options ) | |
-|web.SetPosition| |
+|WebView.LoadUrl( url,options ) | |
-|web.SetSize| |
+|WebView.Print() |KitKat or later only |
-|web.SetVisibility| |
+|WebView.SetBackColor( color ) | |
+|WebView.SetBackGradient( color1,color2,color3,p4,p5,p6,p7 ) | |
+|WebView.SetBackGradientRadial( x,y,r,color1,color2,color3,p7 ) | |
+|WebView.SetBackground( imagefile,options ) | |
+|WebView.SetMargins( left,top,right,bottom ) | |
+|WebView.SetOnProgress( callback ) | |
+|WebView.SetPadding( width,height,top,bottom ) | |
+|WebView.SetPosition( left,top,width,height ) | |
+|WebView.SetScale( x,y ) | |
+|WebView.SetSize( width,height ) | |
+|WebView.SetVisibility( HideShow ) | |
+===== Example - Remote =====
+<code javascript>
+function OnStart()
+{
+  lay = app.CreateLayout( "linear", "VCenter,FillXY" );
+   web = app.CreateWebView( 0.8, 0.8 );
+   web.SetOnProgress( web_OnProgess );
+   lay.AddChild( web );
+   app.AddLayout( lay );
+   app.ShowProgress("Loading...");
+   web.LoadUrl( "http:///www.google.com" );
+}
+function web_OnProgess( progress )
+{
+   app.Debug( "progress = " + progress );
+   if( progress==100 ) app.HideProgress();
+}
+</code>
+===== Example - Local =====
+<code javascript>
+function OnStart()
+{
+  lay = app.CreateLayout( "linear", "VCenter,FillXY" );
+   web = app.CreateWebView( 0.8, 0.8 );
+   web.SetBackColor( "#00000000" );
+   lay.AddChild( web );
+   app.AddLayout( lay );
+   web.LoadUrl( "file:///Sys/Html/Page.htm" );
+}
+</code>
+===== Example - Direct =====
+<code javascript>
+function OnStart()
+{
+  lay = app.CreateLayout( "linear", "VCenter,FillXY" );
+   web = app.CreateWebView( 0.8, 0.8 );
+   web.SetBackColor( "#00000000" );
+   lay.AddChild( web );
+   app.AddLayout( lay );
+   var html = "<html><head>";
+   html += "<meta name='viewport' content='width=device-width'>";
+   html += "</head><body style='color:#fff'>Hello World!<br>";
+   html += "<img src='Img/Droid2.png'>";
+   html += "</body></html>";
+   web.LoadHtml( html, "file:///Sys/" );
+}
+</code>

DroidScript Wiki

User Tools

Site Tools

Differences

Page Tools