{"id":29,"date":"2014-07-21T23:02:16","date_gmt":"2014-07-22T06:02:16","guid":{"rendered":"http:\/\/appinventor.pevest.com\/?p=29"},"modified":"2014-07-21T23:02:16","modified_gmt":"2014-07-22T06:02:16","slug":"using-app-inventors-official-documentation-pages","status":"publish","type":"post","link":"https:\/\/coldstreams.com\/appinventor\/2014\/07\/21\/using-app-inventors-official-documentation-pages\/","title":{"rendered":"Using App Inventor&#8217;s Official Documentation pages"},"content":{"rendered":"<h3>Using App Inventor\u2019s Official Documentation<\/h3>\n<p>App Inventor programming uses graphical components to layout program functionality. But the official App Inventor documentation uses a traditional programming textual description. When you reference the documentation you see a (mostly) textual description of \u201cProperties\u201d, \u201cMethods\u201d and \u201cEvents\u201d.<\/p>\n<p>In the App Inventor Designer, you should see a question mark inside a circle\u00a0 next to each component (just to the right) in the Palette. Clicking on the question mark brings up a pop up dialog box with a brief description of the component. At the bottom is usually a \u201cMore information\u201d hyper link. When you click on that link, documentation pages open in a new browser tab. And this is where you will see information described in \u201cProperties\u201d, \u201cMethods\u201d and \u201cEvents\u201d sections.<\/p>\n<h3>Events<\/h3>\n<p>Inside App Inventor (and within Android) lie the concept of an \u201cevent driven\u201d programming model and object oriented programming. The former is easy to understand: a \u201cWhen xxx.Click Do\u201d block describes what to do when an \u201cevent\u201d occurs such as a user presses a button on the screen. That button push is an event.\u00a0 Our program blocks respond to events &#8211; and specify what our program does when the event occurs.<\/p>\n<h3>Properties<\/h3>\n<p>You have seen properties on the Designer page \u2013 at the right hand side, you can change the color of buttons or change the text of a label. Each of these values is a \u201cproperty\u201d of the component.<\/p>\n<p>The concept of a property is easy to understand by seeing how properties apply to every day objects.\u00a0 A car might have the property &#8220;blue in color&#8221;.\u00a0 A house might have a property &#8220;yellow in color&#8221;.\u00a0 A dog might have a property like &#8220;breed is german shepherd&#8221; or &#8220;small dog&#8221; or &#8220;large dog&#8221;.<\/p>\n<p>Real world objects can have multiple properties. For example, a car could be &#8220;blue in color&#8221;, &#8220;4 wheel drive&#8221;, &#8220;4 door&#8221; and &#8220;140 horsepower engine&#8221;. Each of these attributes is a property that helps to describe the car.<\/p>\n<p>In App Inventor, each component may have a set of properties. For example, a button might be square or oval, or blue or gray in color. Each of these attributes is a property &#8211; for example, the color property might be set to &#8220;blue&#8221;.<\/p>\n<h3>Methods<\/h3>\n<p>\u201cMethods\u201d describe the actions or services the component can provide for a program. A method labeled \u201cStart()\u201d is an action that the component can perform.<\/p>\n<p>Another way to describe \u201cproperties\u201d and \u201cmethods\u201d is to describe them in terms of human language \u2013 a property is like a noun \u201csmall\u201d, \u201clarge\u201d, \u201cblue\u201d (as in color) and a method is like a verb describing an action.<\/p>\n<p>In this way, each component is an \u201cobject\u201d that has properties and can provide services and perform an action (the methods).<\/p>\n<p>In terms of real world objects, a car might have methods such as &#8220;start engine&#8221;, &#8220;stop engine&#8221;, &#8220;increase throttle&#8221;, &#8220;decrease throttle&#8221; and &#8220;set throttle&#8221; (to a specify speed).<\/p>\n<h3>Back to the Documentation<\/h3>\n<p>When you look at the App Inventor documentation online, you will see a list of properties, events and methods.<\/p>\n<p>For example, the media player plays audio or sound. It has a property \u201cVolume\u201d set between 0 and 100 to adjust the player volume. And it has methods such as \u201cStart()\u201d to begin playing the sound and \u201cStop()\u201d to end playing the sound.<\/p>\n<p>Now that you know what &#8220;properties&#8221;, &#8220;events&#8221; and &#8220;methods&#8221; actually mean, you should find reading the documentation to be a bit easier!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Using App Inventor\u2019s Official Documentation App Inventor programming uses graphical components to layout program functionality. But the official App Inventor documentation uses a traditional programming textual description. When you reference the documentation you see a (mostly) textual description of \u201cProperties\u201d, \u201cMethods\u201d and \u201cEvents\u201d. In the App Inventor Designer, you should see a question mark inside &hellip; <a href=\"https:\/\/coldstreams.com\/appinventor\/2014\/07\/21\/using-app-inventors-official-documentation-pages\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Using App Inventor&#8217;s Official Documentation pages<\/span> <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[],"class_list":["post-29","post","type-post","status-publish","format-standard","hentry","category-documentation"],"_links":{"self":[{"href":"https:\/\/coldstreams.com\/appinventor\/wp-json\/wp\/v2\/posts\/29","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/coldstreams.com\/appinventor\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/coldstreams.com\/appinventor\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/coldstreams.com\/appinventor\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/coldstreams.com\/appinventor\/wp-json\/wp\/v2\/comments?post=29"}],"version-history":[{"count":0,"href":"https:\/\/coldstreams.com\/appinventor\/wp-json\/wp\/v2\/posts\/29\/revisions"}],"wp:attachment":[{"href":"https:\/\/coldstreams.com\/appinventor\/wp-json\/wp\/v2\/media?parent=29"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/coldstreams.com\/appinventor\/wp-json\/wp\/v2\/categories?post=29"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/coldstreams.com\/appinventor\/wp-json\/wp\/v2\/tags?post=29"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}