Sei sulla pagina 1di 17

Le Classi

Le classi rappresentano lelemento principale della programmazione ad oggetti; queste


possono a loro volta contenere ed essere definite da propriet, operatori ed eventi.
Per riconoscere questi ultimi elementi, nel presente manuale si utilizzano delle icone:
Propriet,
Operatore;
Evento.

INDICE DELLE CLASSI


Array
Clock
Controls
Desktop
Dictionary
File
Flickr
GraphicsWindows
ImageList
Math
Mouse
Network
Program
Shapes
Sound
Stack
TextWindows
Text
Time
Turtle

Array
Questo oggetto fornisce un modo per memorizzare pi di un valore per un dato nome. Si pu accedere a
questi valori tramite un indice.
Operations
ContainsIndex
Array.ContainsIndex(array, index)

Restituisce se il vettore contiene l'indice specificato o


meno. Ci molto utile per decidere se tale indice del
vettore stato inizializzato a qualche valore o meno.
array
Il vettore da verificare.

index
L'indice da controllare.

Returns
"True" o "False" a seconda che l'indice sia presente nel vettore
specificato o meno.

ContainsValue
Array.ContainsValue(array, value)

Restituisce se il vettore contiene o meno il valore


specificato. Ci molto utile per decidere se il valore
stato memorizzato in qualche elemento del vettore.

Il vettore di cui richiesta la dimensione.

Returns
Il numero di elementi nel vettore specificato.

IsArray
Array.IsArray(array)

Restituisce se una variabile un vettore o meno.


array
La variabile da verificare.

Returns
"True" se la variabile specificata un vettore. Altrimenti "False" .

SetValue
Array.SetValue(arrayName, index, value)

Imposta un valore dato uno specifico vettore e indice.


arrayName
Il nome del vettore.

index
Il nome dell'indice.

value
il valore da impostare.

array

Returns

Il vettore da verificare.

Nothing

value
Il valore da controllare.

Returns
"True" o "False" a seconda che il valore sia presente nel vettore
specificato.

GetAllIndices

GetValue
Array.GetValue(arrayName, index)

Restituisce un valore dato un vettore e un indice.


arrayName
Il nome del vettore.

index

Array.GetAllIndices(array)

Il nome dell'indice.

Restituisce tutti gli indici del vettore come un altro


vettore.

Returns

array

Il valore all'indice specificato del vettore specificato.

RemoveValue

Il vettore i cui indici sono richiesti.

Array.RemoveValue(arrayName, index)

Returns

Rimuove l'elemento del vettore all'indice specificato.

Un vettore caricato con tutti gli indici del vettore specificato. L'indice
del vettore restituito inizia da 1.

GetItemCount

arrayName
Il nome del vettore.

index

Array.GetItemCount(array)

L'indice dell'elemento da rimuovere.

Restituisce il numero di elementi del vettore.

Returns

array

Nothing

Clock
Questa classe fornisce accesso all'orologio di sistema
Properties
Time (This property is read-only.)
Clock.Time

Ottiene l'ora di sistema.


Date (This property is read-only.)
Clock.Date

Ottiene la data di sistema.


Year (This property is read-only.)
Clock.Year

Ottiene l'anno corrente.


Month (This property is read-only.)
Clock.Month

Ottiene il mese corrente.

Day (This property is read-only.)


Clock.Day

Ottiene il giorno del mese.


WeekDay (This property is read-only.)
Clock.WeekDay

Ottiene il giorno della settimana.


Hour (This property is read-only.)
Clock.Hour

Ottiene l'ora corrente.


Minute (This property is read-only.)
Clock.Minute

Ottiene il minuto corrente.


Second (This property is read-only.)
2

Clock.Second

Restituisce il Secondo corrente.


Millisecond (This property is read-only.)
Clock.Millisecond

Restituisce il Millisecondo corrente.

ElapsedMilliseconds (This property is read-only.)


Clock.ElapsedMilliseconds

Restituisce il numero di millisecondi a partire dal


1900.

Controls
L'oggetto Controls consente di aggiungere, spostare e interagire con i controlli.
Properties
LastClickedButton (This property is read-only.)

Aggiunge una casella di testo dell'altezza e larghezza


specificate alla Finestra Grafica.

Controls.LastClickedButton

left

Restituisce l'ultimo Button che stato cliccato nella


Finestra Grafica.
LastTypedTextBox (This property is read-only.)

La coordinata X della casella di testo.

Controls.LastTypedTextBox

La casella di testo che stata appena aggiunta alla Finstra Grafica.

Restituisce l'ultimo TextBox in cui stato digitato del


testo.

Events
ButtonClicked
Controls.ButtonClicked

Solleva un evento quando qualsiasi controllo Button


viene cliccato.
TextTyped

top
La coordinata Y della casella di testo.

Returns

AddMultiLineTextBox
Controls.AddMultiLineTextBox(left, top)

Aggiunge alla finestra grafica una casella di testo


multiriga dell'altezza e larghezza specificata.
left
La coordinata X della casella di testo.

top
La coordinata Y della casella di testo.

Returns

Controls.TextTyped

La casella di testo che appena stata aggiunta alla Finestra


Grafica.

Solleva un evento quando del testo viene digitato in


qualsiasi controllo TextBox.

Controls.GetTextBoxText(textBoxName)

GetTextBoxText
Restituisce il testo attuale del TextBox specificato.

Operations
AddButton

textBoxName

Controls.AddButton(caption, left, top)

Il testo nel TextBox

Aggiunge un pulsante alla Finestra Grafica con la


larghezza e altezza specificati.
caption
Il testo da mostrare nel pulsante.

left
La coordinata x del pulsante.

top
La coordinata y del pulsante.

Returns
Il pulsante che stato appena aggiunto alla Finestra Grafica.

GetButtonCaption
Controls.GetButtonCaption(buttonName)

Restituisce il testo corrente del pulsante specificato.


buttonName
Il Button di cui si richiede il testo.

Returns
Il testo attuale del pulsante.

SetButtonCaption
Controls.SetButtonCaption(buttonName, caption)

Imposta il testo del pulsante specificato.


buttonName
Il Button il cui testo dev'essere impostato.

caption
Il nuovo testo del pulsante.

Returns
Nothing

AddTextBox

Il TextBox il cui testo richiesto.

Returns

SetTextBoxText
Controls.SetTextBoxText(textBoxName, text)

Imposta il testo del TextBox specificato.


textBoxName
Il TextBox di cui necessario specificare il testo.

text
Il nuovo testo per il TextBox.

Returns
Nothing

Remove
Controls.Remove(controlName)

Rimuove un controllo dalla Finestra Grafica.


controlName
Il nome del controllo che dev'essere rimosso.

Returns
Nothing

Move
Controls.Move(control, x, y)

Sposta il controllo specificato in una nuova posizione.


control
Il nome del controllo da spostare.

x
La coordinata x della nuova posizione.

y
La coordinata y della nuova posizione.

Returns
Nothing

Controls.AddTextBox(left, top)

SetSize

Nasconde un controllo gi aggiunto.

Controls.SetSize(control, width, height)

controlName

Imposta la dimensione del controllo.

Il nome del controllo.

control
Il nome del controllo da ridimensionare.

width

Returns
Nothing

ShowControl

La larghezza del controllo.

Controls.ShowControl(controlName)

height

Mostra un controllo precedentemente nascosto.

L'altezza del controllo.

controlName

Returns
Nothing

HideControl

Il nome del controllo.

Returns
Nothing

Controls.HideControl(controlName)

Desktop
Questa classe fornisce metodi per interagire con il desktop.
Properties
Width (This property is read-only.)

Operations
SetWallPaper

Desktop.Width

Desktop.SetWallPaper(fileOrUrl)

Restituisce la larghezza dello schermo del desktop


primario.
Height (This property is read-only.)

Imposta l'immaigne specificata come lo sfondo del


desktop. Questo file potrebbe essere un file locale, un
file dalla rete o anche un indirizzo internet.

Desktop.Height

fileOrUrl

Restituisce l'altezza dello schermo del desktop


primario.

Il nome del file o l'indirizzo dell'immagine.

Returns
Nothing

Dictionary
Questa classe fornisce accesso ad un servizio di Dizionario online.
Operations
GetDefinition
Dictionary.GetDefinition(word)

Restituisce la definizione di una parola inglese (in


Inglese).
word
La parola di cui cercare la definizione.

Returns

GetDefinitionInFrench
Dictionary.GetDefinitionInFrench(word)

Restituisce la definizione di una parola francese (in


Francese).
word
La parola di cui cercare la definizione.

Returns
La/le definizione/i della parola specificata.

La/le definizione/i della parola specificata.

File
L'oggetto File fornisce metodi per accedere, leggere e scrivere informazioni da/ad un file su disco.
Utilizzando questo oggetto, possibile salvare e leggere impostazioni tra diverse sessioni del vostro
programma.
Properties
LastError
File.LastError

Imposta o restituisce il messaggio di errore relativo a


operazioni su file incontrato pi di recente. Questa
propriet utile per capire quando l'esecuzione di
qualche metodo fallita.

Operations
ReadContents
File.ReadContents(filePath)

Apre un file e ne legge il contenuto completo. Questo


metodo sar veloce per file fino ad 1 MB, ma il
rallentamento aumenter proporzionalmente alle
dimensioni del file e saranno rilevanti per file con
dimensioni superiori a 10MB.
filePath
Il percorso completo del file da leggere. Ad esempio
c:\temp\settings.data.

Returns
L'intero contenuto del file.

WriteContents
File.WriteContents(filePath, contents)

Apre un file e scrive il contenuto specificato in esso,


sostituendo il contenuto originale con il nuoco
contenuto.
filePath
Il percorso completo del file da scrivere. Ad esempio
c:\temp\settings.data.

contents
il contenuto da scrivere nel file specificato.

Returns
Restituir "SUCCESS" se l'operazione stata eseguita
correttamente. Altrimenti restituir "FAILED".

ReadLine
File.ReadLine(filePath, lineNumber)

locazione inesistente, il metodo cercher di crearla


automaticamente. File esistenti saranno sovrascritti.
Se non si desidera sovrascrivere un file opportuno
controllare in anticipo se il file destinazione esiste.
sourceFilePath
Il percorso completo del file da copiare. Ad esempio
c:\temp\settings.data.

destinationFilePath
La locazione di destinazione o il persorso del file.

Returns
Restituir "SUCCESS" se l'operazione stata eseguita
correttamente. Altrimenti restituir "FAILED".

DeleteFile

Apre il file e ne legge il contenuto alla riga specificata.

File.DeleteFile(filePath)

filePath

Cancella il file specificato.

Il percorso completo del file da leggere. Ad esempio


c:\temp\settings.data.

filePath

lineNumber

La locazione di destinazione o il percorso del file. Un esempio di


percorso completo c:\temp\settings.data.

Il numero di riga del testo da leggere.

Returns

Returns
il testo alla riga specificata del file indicato.

WriteLine

Restituir "SUCCESS" se l'operazione stata eseguita


correttamente. Altrimenti restituir "FAILED".

CreateDirectory

File.WriteLine(filePath, lineNumber, contents)

File.CreateDirectory(directoryPath)

Apre il file specificato e scrive il contenuto al numero


di riga specificato. Questa operazione sovrascrive
qualsiasi contenuto preesistente alla riga specificata.

Crea la cartella specificata.

filePath
Il percorso completo del file da leggere. Ad esempio
c:\temp\settings.data.

lineNumber

directoryPath
il persorso completo della cartella da creare.

Returns
Restituir "SUCCESS" se l'operazione stata eseguita
correttamente. Altrimenti restituir "FAILED".

DeleteDirectory

Il numero di riga del testo da scrivere.

File.DeleteDirectory(directoryPath)

contents

Elimina la cartella specificata.

il contenuto da scrivere alla riga specificata del file speciicato.

Returns
Restituir "SUCCESS" se l'operazione stata eseguita
correttamente. Altrimenti restituir "FAILED".

InsertLine
File.InsertLine(filePath, lineNumber, contents)

directoryPath
Il percorso completo della cartella da eliminare.

Returns
Restituir "SUCCESS" se l'operazione stata eseguita
correttamente. Altrimenti restituir "FAILED".

GetFiles

Apre il file dpecificato e inserisce il contenuto allo


specifico numero di riga. L'operazione non sovrascrive
alcun contenuto preesistente alla riga specificata.

File.GetFiles(directoryPath)

filePath

directoryPath

Il percorso completo del file da leggere. Ad esempio


c:\temp\settings.data.

La cartella ove cercare i file.

lineNumber

Restituir "SUCCESS" se l'operazione stata eseguita


correttamente. Altrimenti restituir "FAILED".

Il numero di riga del testo da inserire.

contents
il contenuto da inserire nel file.

Returns
Restituir "SUCCESS" se l'operazione stata eseguita
correttamente. Altrimenti restituir "FAILED".

AppendContents
File.AppendContents(filePath, contents)

Apre il file specificato e appende il contenuto alla fine


del file.
filePath
Il percorso completo del file da leggere. Ad esempio
c:\temp\settings.data.

contents
Il contenuto da appendere alla fine del file.

Returns
Restituir "SUCCESS" se l'operazione stata eseguita
correttamente. Altrimenti restituir "FAILED".

CopyFile
File.CopyFile(sourceFilePath, destinationFilePath)

Copia il file sorgente specificato nel percorso di


destinazione. Se la destinazione si riferisce ad una

Restituisce il percorso di tutti i file nella cartella


specificata.
Returns

GetDirectories
File.GetDirectories(directoryPath)

Restituisce il percorso di tutte le cartelle nella cartella


specificata.
directoryPath
La cartella ove cercare le sottocartelle.

Returns
Restituir "SUCCESS" se l'operazione stata eseguita
correttamente. Altrimenti restituir "FAILED".

GetTemporaryFilePath
File.GetTemporaryFilePath()

Crea un nuovo file temporaneo in una cartella


temporanea e restituisce il percorso completo del file.
Returns
Il percorso completo del file temporaneo.

GetSettingsFilePath
File.GetSettingsFilePath()

Restituisce il percorso completo del file di


impostazioni di questo programma. Il nome del file di
5

impostazioni basato sul nome del programma e si


trova nella stessa locazione del programma.

Il percorso completo del file di impostazioni specifico per questo


programma.

Returns

Flickr
Questa classe fornisce accesso ai servizi di Flickr.
Operations
GetPictureOfMoment

GetRandomPicture
Flickr.GetRandomPicture(tag)

Ottiene l'URL per l'immagine del momento.

Ottiene l'URL di una immagine casuale qualificata con


il tag specifico.

Returns

tag

L'URL del file dell'immagine Flickr del momento

Il tag dell'immagine richiesta.

Flickr.GetPictureOfMoment()

Returns
L'URL del file dell'immagine casuale di Flickr

GraphicsWindow
La finestra Grafica fornisce funzionalit di input e output grafiche. Per esempio, usando questa
classe, possibile disegnare e riempire cerchi e rettangoli.
Properties
BackgroundColor
GraphicsWindow.BackgroundColor

Restituisce o imposta il colore di sfondo della finestra


Grafica.
BrushColor

Ottiene o imposta il corsivo nel font utilizzato per


disegnare testo nella finestra Grafica.
Title
GraphicsWindow.Title

Ottiene o imposta il titolo della finestra Grafica.


Height

GraphicsWindow.BrushColor

GraphicsWindow.Height

Ottiene o imposta il colore del pennello usato per


riempire figure geometriche disegnate nellla finestra
Grafica.
CanResize

Ottiene o imposta l'altezza della finestra Grafica.


Width

GraphicsWindow.CanResize

Specifica se la finestra Grafica pu essere


ridimensionata dall'utente o meno.
PenWidth
GraphicsWindow.PenWidth

Ottiene o imposta la larghezza della penna utilizzata


per disegnare le forme geometriche all'interno della
finestra Grafica.
PenColor
GraphicsWindow.PenColor

Restituisce o imposta il colore della penna utilizzata


per disegnare forme nella finestra Grafica.
FontName
GraphicsWindow.FontName

Restituisce o imposta il nome del Font da utilizzare


per disegnare testo nella finestra Grafica.
FontSize
GraphicsWindow.FontSize

Restituisce o imposta la dimensione del Font da


utilizzare per disegnare testo nella finestra Grafica.
FontBold

GraphicsWindow.Width

Ottiene o imposta la larghezza della finestra Grafica.


Left
GraphicsWindow.Left

Ottiene o imposta la posizione di sinistra della finestra


Grafica.
Top
GraphicsWindow.Top

Ottiene o imposta la posizione pi in alto della


finestra Grafica.
LastKey (This property is read-only.)
GraphicsWindow.LastKey

Ottiene l'ultimo tasto che stato premuto o rilasciato.


LastText (This property is read-only.)
GraphicsWindow.LastText

Restituisce l'ultimo testo che perch stato inserito


nella finestra Grafica.
MouseX (This property is read-only.)
GraphicsWindow.MouseX

Ottiene la posizione x del mouse relativa alla finestra


Grafica.
MouseY (This property is read-only.)
GraphicsWindow.MouseY

Ottiene o imposta il grassetto nel font utilizzato per


disegnare testo nella finestra Grafica.
FontItalic

Restituisce la posizione Y del mouse relativa alla


finestra Grafica.
Events
KeyDown

GraphicsWindow.FontItalic

GraphicsWindow.KeyDown

GraphicsWindow.FontBold

Richiama un evento quando un tasto viene premuto


sulla tastiera.
KeyUp

La coordinata X dell'ellisse.

GraphicsWindow.KeyUp

La larghezza dell'ellisse.

Richiama un evento quando un tasto della tastiera


viene rilasciato.
MouseDown
GraphicsWindow.MouseDown

Lancia un evento quando il pulsante del mouse viene


premuto.
MouseUp
GraphicsWindow.MouseUp

Lancia un evento quando il pulsante del mouse viene


rilasciato.
MouseMove

y
La coordinata Y dell'ellisse.

width
height
L'altezza dell'ellisse.

Returns
Nothing

FillEllipse
GraphicsWindow.FillEllipse(x, y, width, height)

Riempie un ellisse usando il Pennello selezionato.


x
La coordinata X dell'ellisse.

y
La coordinata Y dell'ellisse.

width

GraphicsWindow.MouseMove

La larghezza dell'ellisse.

Lancia un evento quando il mouse viene mosso.


TextInput

height

GraphicsWindow.TextInput

Nothing

Lancia un evento quando del testo viene inserito nella


finestra Grafica.
Operations
Show

L'altezza dell'ellisse.

Returns

DrawTriangle
GraphicsWindow.DrawTriangle(x1, y1, x2, y2, x3, y3)

Disegna un triangolo usando la Penna selezionata.


x1

GraphicsWindow.Show()

La coordinata x del primo punto.

Mostra la finestra Grafica per consentire l'interazione


con la stessa.

y1

Returns
Nothing

Hide
GraphicsWindow.Hide()

Nasconde la finestra Grafica.

La coordinata y del primo punto.

x2
La coordinata x del secondo punto.

y2
La coordinata y del secondo punto.

x3
La coordinata x del terzo punto.

Returns

y3

Nothing

La coordinata y del terzo punto.

DrawRectangle

Returns

GraphicsWindow.DrawRectangle(x, y, width, height)

Nothing

Disegna un rettangolo sullo schermo utilizzando la


Penna selezionata.

GraphicsWindow.FillTriangle(x1, y1, x2, y2, x3, y3)

FillTriangle

La coordinata x del rettangolo.

Disegna e riempie un triangolo usando il Pennello


selezionato.

x1

La coordinata Y del rettangolo.

La coordinata x del primo punto.

width

y1

La larghezza del rettangolo.

La coordinata y del primo punto.

height

x2

L'altezza del rettangolo.

La coordinata x del secondo punto.

Returns

y2

Nothing

La coordinata y del secondo punto.

FillRectangle

x3

GraphicsWindow.FillRectangle(x, y, width, height)

La coordinata x del terzo punto.

Riempie un rettangolo usando il Pennello selezionato.

y3

x
La coordinata x del rettangolo.

La coordinata y del terzo punto.

Returns
Nothing

DrawLine

La coordinata Y del rettangolo.

width

GraphicsWindow.DrawLine(x1, y1, x2, y2)

La larghezza del rettangolo.

Disegna una linea da un punto a un'altro.

height

x1

L'altezza del rettangolo.

La coordinata x del primo punto.

Returns

y1

Nothing

La coordinata y del primo punto.

DrawEllipse

x2

GraphicsWindow.DrawEllipse(x, y, width, height)

La coordinata x del secondo punto.

Disegna un ellisse usando la Penna selezionata.

y2

La coordinata y del secondo punto.


7

Returns
Nothing

DrawText
GraphicsWindow.DrawText(x, y, text)

Disegna una linea di testo alla locazione specificata.


x
La coordinata X del punto di inizio del testo.

y
La coordinata Y del punto di inizio del testo.

text
Il testo da disegnare

Returns

SetPixel
GraphicsWindow.SetPixel(x, y, color)

Disegna il pixel individuato dalle coordinate x e y


usando il colore specificato.
x
La coordinata x del pixel.

y
La coordinata y del pixel.

color
Il colore del pixel.

Returns
Nothing

Nothing

DrawBoundText
GraphicsWindow.DrawBoundText(x, y, width, text)

Disegna una linea di testo alla locazione specificata.


x
La coordinata X del punto di inizio del testo.

y
La coordinata Y del punto di inizio del testo.

width
La larghezza massima disponibile. Questo parametro aiuta a
definire quando il testo deve andare accapo.

text
Il testo da disegnare.

GetPixel
GraphicsWindow.GetPixel(x, y)

Restituisce il colore del pixel individuato dalle


coordinate x e y .
x
La coordinata x del pixel.

y
la coordinata y del pixel.

Returns
Il colore del pixel.

GetRandomColor
GraphicsWindow.GetRandomColor()

Returns

Ottiene un colorecasuale valido.

Nothing

Returns

DrawResizedImage

Un colore casuale valido.

GetColorFromRGB

GraphicsWindow.DrawResizedImage(imageName, x, y, width, height)

Disegna l'immagine specificata dalla memoria allo


schermo, nella dimensione specificata.
imageName
Il nome dell'immagine da disegnare

x
La coordinata x del punto in cui disegnare l'immagine.

y
La coordinata y del punto in cui disegnare l'immagine.

width
La larghezza in cui disegnare l'immagine.

height
L'altezza in cui disegnare l'immagine.

GraphicsWindow.GetColorFromRGB(red, green, blue)

Costruisce un colore dati i valori di Rosso, Verde e Blu.


red
Il componente rosso del colore (0-255).

green
Il componente verde del colore (0-255).

blue
Il componente blu del colore (0-255).

Returns
Restituisce un colore che pu essere utilizzato per per impostare il
colore di una penna o un pennello.

Clear

Returns

GraphicsWindow.Clear()

Nothing

Pulisce la finestra.

DrawImage

Returns

GraphicsWindow.DrawImage(imageName, x, y)

Nothing

Disegna l'immagine specificata dalla memoria allo


schermo.

GraphicsWindow.ShowMessage(text, title)

ShowMessage

imageName

Mostra una finestra di dialogo all'utente.

Il nome dell'immagine da disegnare.

text

Il testo da mostrare all'interno della finestra di dialogo.

La coordinata x del punto in cui disegnare l'immagine.

title

Il titolo della finestra di dialogo.

La coordinata y del punto in cui disegnare l'immagine.

Returns

Returns

Nothing

Nothing

ImageList
Questa classe aiuta a caricare e memorizzare immagini in memoria.
Operations
LoadImage

Il nome del file da cui caricare l'immagine. Potrebbe essere un file


locale o un indirizzo ad una locazione internet.

ImageList.LoadImage(fileNameOrUrl)

Restituisce il nome dell'immagine che stata caricata.

Carica un'immaigne da un file o da internet in


memoria.
fileNameOrUrl

Returns

GetWidthOfImage
ImageList.GetWidthOfImage(imageName)

Ottiene la larghezza dell'immagine memorizzata.

ImageList.GetHeightOfImage(imageName)

imageName

Ottiene l'altezza dell'immagine memorizzata.

Il nome dell'immagine in memoria.

imageName

Returns

Il nome dell'immagine in memoria.

La larghezza dell'immagine specificata.

Returns

GetHeightOfImage

L'altezza dell'immagine specificata.

Math
La classe Math fornisce numerosi metodi matematici utili
Properties
Pi (This property is read-only.)
Math.Pi

Returns
Il coseno dell'angolo dato.

Sin

Restituisce il valore di Pi greco


Operations
Abs

Math.Sin(angle)

Math.Abs(number)

Returns

Restituisce il valore assoluto di un dato numero. Ad


esempio, applicato a -32,233 restituir 32,233.

Ottiene il seno dell'angolo specificato in radianti.


angle
L'angolo di cui si desidera il seno (in radianti)
Il seno dell'angolo specificato

Tan

number

Math.Tan(angle)

Il numero di cui ottenere il valore assoluto.

Ottiene la tangente dell'angolo specificato in radianti.

Returns
Il valore assoluto del numero dato.

Ceiling

angle
L'angolo di cui richiesta la tangente (in radianti).

Returns

Math.Ceiling(number)

La tangente dell'angolo dato.

Restituisce un intero che maggiore o uguale al


numero decimale specificato. Ad esempio, applicato a
32,233 restituir 33.

Math.ArcSin(sinValue)

ArcSin

number

Restituisce l'angolo in radianti, dato il valore del suo


seno.

Il numero di cui richiesto l'arrotondamento per eccesso.

sinValue

Returns

Il valore del seno di cui richiesto l'angolo.

Il valore arrotondato per eccesso del numero dato.

Returns

Floor
Math.Floor(number)

L'angolo (in radianti) per il dato valore del seno.

ArcCos

Restituisce un interno che minore o uguale al


numero decimale specificato. Ad esempio, applicato a
32,233 restituir 32.

Math.ArcCos(cosValue)

number

cosValue

Il numero di cui richiesto il valore base.

Il valore del coseno di cui richiesto l'angolo.

Returns

Returns

Il valore base del numero dato.

L'angolo (in radianti) per il dato valore del coseno.

NaturalLog

Restituisce l'angolo in radianti, dato il valore del


coseno.

ArcTan

Math.NaturalLog(number)

Math.ArcTan(tanValue)

Ottiene il valore del logaritmo naturale di un dato


numero.

Restituisce l'angolo in radianti dato il valore della


tangente.

number

tanValue

Il numero di cui richiesto il logaritmo naturale.

Il valore della tangente di cui si desidera l'angolo.

Returns

Returns

Il valore del logaritmo naturale del numero dato.

L'angolo (in radianti) per un dato valore tangente.

Log

GetDegrees

Math.Log(number)

Math.GetDegrees(angle)

Ottiene il valore del logaritmo (in base 10) del numero


specificato.

Converte l'angolo specificato da radianti a gradi.

number
Il numero di cui si desidera il valore del logaritmo

Returns
Il valore del logaritmo del numero specificato

Cos

angle
L'angolo in radianti.

Returns
L'angolo convertito in gradi.

GetRadians
Math.GetRadians(angle)

Math.Cos(angle)

Converte un angolo specificato da gradi a radianti.

Ottiene il coseno dell'angolo specificato in radianti.

angle

angle
L'angolo di cui richiesto il coseno (in radianti).

L'angolo in gradi.

Returns
L'angolo convertito in radianti.
9

SquareRoot
Math.SquareRoot(number)

Ottiene la radice quadrata di un numero specificato.


number

number2
Il secondo dei due numeri da confrontare.

Returns
Il maggiore dei due numeri.

Min

Il numero di cui si desidera ottenere la radice quadrata.

Returns
La radice quadrata del valore dato.

Math.Min(number1, number2)

Confronta due numeri e restituisce il minore dei due.


number1
Il primo dei due numeri da confrontare.

Power
Math.Power(baseNumber, exponent)

Eleva baseNumber alla potenza specificata.


baseNumber

number2
Il secondo dei due numeri da confrontare.

Returns
Il minore dei due numeri.

Remainder

Il numero che si desidera elevare a potenza.

exponent

Math.Remainder(dividend, divisor)

La potenza cui elevare baseNumber.

Divide il primo numero per il secondo e restituisce il


resto.

Returns
baseNumber elevato allo specifico esponente.

Round

dividend
Il numero da dividere.

Math.Round(number)

divisor

Arrotonda un dato numero all'intero pi vicino. Ad


esempio 32,233 verr arrotondato a 32,0 mentre
32,566 verr arrotondato a 33.

Il numero che divide.

number
Il numero di cui si richiede l'approssimazione.

Returns
Il valore arrotondato del numero dato.

Max

Returns
Il resto della divisione.

GetRandomNumber
Math.GetRandomNumber(maxNumber)

Restituisce un valore casuale tra 1 e maxNumber


(incluso).
maxNumber

Math.Max(number1, number2)

Il valore massimo del numero casuale.

Confronta due numeri e restituisce il maggiore dei


due.

Returns

number1

Un numero casuale minore o uguale del valore massimo


specificato.

Il primo dei due numeri da confrontare.

Mouse
La classe mouse fornisce accessori per recuperare o impostare le propriet relative al mouse, quali la
posizione del cursore, il puntatore, ecc.
Properties
MouseX
Mouse.MouseX

Ottiene o imposta la coordinata x del cursore del


mouse.
MouseY
Mouse.MouseY

Mouse.IsRightButtonDown

Restituisce se il pulsante di destra del mouse stato


premuto o meno.
Operations
HideCursor
Mouse.HideCursor()

Nasconde il cursore del mouse.

Ottiene o imposta la coordinata y del cursore del


mouse.
IsLeftButtonDown (This property is read-only.)

Returns

Mouse.IsLeftButtonDown

Mostra il cursore del mouse.

Restituisce se il pulsante di sinistra del mouse stato


premuto o meno.
IsRightButtonDown (This property is read-only.)

Nothing

ShowCursor
Mouse.ShowCursor()

Returns
Nothing

Network
Questa classe privata fornisce metodi per l'acceso alla rete
Operations
DownloadFile
Network.DownloadFile(url)

Scarica un file dalla rete ad un file locale temporaneo.

url
L'indirizzo del file sulla rete.

Returns
Il nome del file locale su cui il file remoto stato scaricato.

GetWebPageContents
10

Network.GetWebPageContents(url)

L'URL della pagina web

Ottiene il contenuto di una specifica pagina web.

Returns

url

I contenuti della pagina web specificata.

Program
La classe Program fornisce metodi per controllare l'esecuzione del programma.
Properties
ArgumentCount (This property is read-only.)

Returns
Nothing

End

Program.ArgumentCount

Restituisce il numero degli argomenti di linea di


comando passati a questo programma.
Directory (This property is read-only.)
Program.Directory

Ottiene la cartella del programma in esecuzione.


Operations
Delay
Program.Delay(milliSeconds)

Ritarda l'esecuzione del programma della quantit


specificata di millisecondi.
milliSeconds

Program.End()

Termina il programma.
Returns
Nothing

GetArgument
Program.GetArgument(index)

Restituisce l'argomento specifico passato a questo


programma.
index
Indice dell'argomento.

Returns
L'argomento della linea di comando all'indice specificato.

La quantit di ritardo.

Shapes
L'oggetto Shapes consente di aggiungere, spostare e ruotare forme nella finestra Grafica.
Operations
AddRectangle
Shapes.AddRectangle(width, height)

Aggiunge un rettangolo dell'altezza e larghezza


specificati.
width
La larghezza del rettangolo.

height
L'altezza del rettangolo.

Returns
Il rettangolo che stato appena aggiunto alla finestra Grafica.

AddEllipse
Shapes.AddEllipse(width, height)

Aggiunge una ellisse della larghezza e altezza


specificate.
width
La larghezza dell'ellisse.

y3
La coordinata y del terzo punto.

Returns
Il triangolo che appena stato aggiunto alla finestra Grafica.

AddLine
Shapes.AddLine(x1, y1, x2, y2)

Aggiunge una riga tra i punti specificati.


x1
La coordinata x del primo punto.

y1
La coordinata y del primo punto.

x2
La coordinata x del secondo punto.

y2
La coordinata y del secondo punto.

Returns
La linea che appena stata aggiunta alla finestra Grafica.

AddImage

height

Shapes.AddImage(imageName)

L'altezza dell'ellisse.

Aggiunge un'immagine come una forma che pu


essere spostata, animata o ruotata.

Returns
L'ellisse che appena stata aggiunta alla finestra Grafica.

AddTriangle
Shapes.AddTriangle(x1, y1, x2, y2, x3, y3)

Aggiunge un triangolo rappresentato dai punti


specificati.

imageName
Il nome dell'immagine da disegnare.

Returns
L'immagine che appena stata aggiunta alla finestra Grafica.

AddText

x1

Shapes.AddText(text)

La coordinata x del primo punto.

Aggiunge del testo come forma che pu essere


spostata, animata o ruotata.

y1
La coordinata y del primo punto.

x2
La coordinata x del secondo punto.

y2
La coordinata y del secondo punto.

x3
La coordinata x del terzo punto.

text
Il testo da aggiungere.

Returns
La forma del testo che stata appena aggiunta alla Finestra
Grafica.

SetText
11

Shapes.SetText(shapeName, text)

Imposta il testo di una forma di testo.

La coordinata x della nuova posizione.

shapeName

Il nome di una forma di testo.

La coordinata y della nuova posizione.

text

duration

Il nuovo valore di testo da impostare.

Il tempo dell'animazione, in millisecondi.

Returns

Returns

Nothing

Nothing

Remove

GetLeft

Shapes.Remove(shapeName)

Shapes.GetLeft(shapeName)

Rimuove una forma geometrica dalla finestra Grafica.

Ottiene la coordinata di sinistra della forma specifica.

shapeName

shapeName

Il nome della forma geometrica che si vuole rimuovere.

Il nome della forma.

Returns

Returns

Nothing

La coordinata di sinistra della forma.

Move

GetTop

Shapes.Move(shapeName, x, y)

Shapes.GetTop(shapeName)

Sposta in una nuova posizione la forma specificata dal


nome.

Ottiene la coordinata pi alta della forma specifica.

shapeName
Il nome della forma da spostare.

x
La coordinata x della nuova posizione.

shapeName
Il nome della forma.

Returns
La coordinata pi alta della forma.

GetOpacity

Shapes.GetOpacity(shapeName)

La coordinata y della nuova posizione.

Restituisce l'opacit della forma.

Returns

shapeName

Nothing

Rotate
Shapes.Rotate(shapeName, angle)

Ruota la forma indicata dal nome dell'angolo


specificato.
shapeName
Il nome dell'immagine da ruotare.

Il nome della forma.

Returns
L'opacit dell'oggetto come valore tra 0 e 100. 0 equivale a
completamente trasparente, mentre 100 corrisponde a
completamente opaco.

SetOpacity
Shapes.SetOpacity(shapeName, level)

angle

Imposta l'opacit di una forma.

L'angolo della forma da ruotare.

shapeName

Returns

Il nome della forma.

Nothing

level

Zoom
Shapes.Zoom(shapeName, scaleX, scaleY)

Scala la forma utilizzando i livelli di zoom specificati. Il


minimo 0,1 e il massimo 20.
shapeName
Il nome dell'immagine da ruotare.

scaleX
Il livello di zoom dell'asse X.

scaleY
Il livello di zoom dell'asse Y.

Returns
Nothing

Animate
Shapes.Animate(shapeName, x, y, duration)

Anima la forma indicata dal nome nella nuova


posizione.
shapeName
Il nome dell'immagine da spostare.

Il livello di opacit espresso come valore tra 0 e 100.


Completamente trasparente se 0 e completamente opaco se 100.

Returns
Nothing

HideShape
Shapes.HideShape(shapeName)

Nasconde una forma gi aggiunta.


shapeName
Il nome della forma.

Returns
Nothing

ShowShape
Shapes.ShowShape(shapeName)

Mostra una forma precedentemente nascosta.


shapeName
Il nome della forma.

Returns
Nothing

Sound
L'oggetto Sound fornisce operazioni che consentono la riproduzione di suoni. Alcuni suoni di esempio
sono forniti con la libreria.
Operations
PlayClick
Sound.PlayClick()

Riproduce il suono Clic.

Returns
Nothing

PlayClickAndWait
Sound.PlayClickAndWait()

12

Riproduce il suono Clic e ne attende il


completamento.

Nothing

Returns

Sound.Play(filePath)

Nothing

PlayChime
Sound.PlayChime()

Riproduce il suono Carillon.


Returns
Nothing

PlayChimeAndWait
Sound.PlayChimeAndWait()

Riproduce il suono Carillon e ne attende il


completamento.
Returns
Nothing

PlayChimes
Sound.PlayChimes()

Riproduce il suono Organo.


Returns
Nothing

PlayChimesAndWait

Play
Riproduce il suono Clic.
filePath
Returns
Nothing

PlayAndWait
Sound.PlayAndWait(filePath)

Riproduce un file audio e attende fino al termine della


riproduzione. Questo potrebbe essere un file mp3,
wav o wma. Altri formati di file potrebbero essere
riprodotti o meno a seconda dei codec audio installati
sul computer dell'utente. Se il file stato messo in
pausa, questa operazione riprender dalla posizione
da cui la riproduzione era stata interrotta.
filePath
Il percorso del file audio. Questo potrebbe essere un file locale (ad
es: c:\music\track1.mp3) o un file sulla rete (ad es:
http://contoso.com/track01.wma).

Returns

Sound.PlayChimesAndWait()

Nothing

Riproduce il suono Organo e ne attende il


completamento.

Sound.Pause(filePath)

Returns
Nothing

PlayBellRing

Pause
Pausa la riproduzione di un file audio. Se il file non era
in fase di riproduzione, questa operazione non far
nulla.

Sound.PlayBellRing()

filePath

Riproduce il suono Rintocco Campana.

Il percorso del file audio. Questo potrebbe essere un file locale (ad
es.: c:\musica\traccia1.mp3) o un file sulla rete (ad es.:
http://contoso.com/traccia01.wma).

Returns
Nothing

PlayBellRingAndWait
Sound.PlayBellRingAndWait()

Riproduce il suono Rintocco Campana e ne attende il


completamento.
Returns
Nothing

PlayMusic
Sound.PlayMusic(notes)

Suona note musicali.


notes
Un insieme di note musicali da suonare. Il formato un
sottoinsieme del linguaggio Music Markup Language supportato
da QBasic.

Returns
Nothing

Stop
Sound.Stop(filePath)

Ferma la riproduzione di un file audio. Se il file non


era in fase di riproduzione, questa operazione non
far nulla.
filePath
Il percorso del file audio. Questo potrebbe essere un file locale (ad
es.: c:\musica\traccia1.mp3) o un file sulla rete (ad es.:
http://contoso.com/traccia01.wma).

Returns
Nothing

Returns

Stack
Questo oggetto fornisce un metodo di memorizzazione dei valori simile ad impilare piatti. possibile
aggiungere un valore in cima alla pila e poi rimuoverlo. Si possono solo rimuovere valori ad uno ad uno
dalla cima della pila, quindi l'ultimo valore aggiunto sar il primo ad essere rimosso.
Operations
PushValue
Stack.PushValue(stackName, value)

Aggiunge un valore alla pila specificata.


stackName
Il nome della pila.

value
Il valore da rimovere.

Returns
Nothing

GetCount

Stack.GetCount(stackName)

Ottiene il numero di valori nella pila specificata.


stackName
Il nome della pila.

Returns
Il numero di elementi nella pila specificata.

PopValue
Stack.PopValue(stackName)

Estrae il valore dalla pila specificata.


stackName
Il nome della pila.
13

Returns

Il calore dalla pila.

TextWindow
La finestra Testo fornisce funzionalit di input e output di tipo testo. Ad esempio, utilizzando questa
classe possibile scrivere o leggere testo o numeri nella/dalla finestra di testo.
Properties
ForegroundColor
TextWindow.ForegroundColor

Ottiene o imposta il colore del testo di cui eseguire


l'output nella finestra Testo.
BackgroundColor
TextWindow.BackgroundColor

Attende l'input dell'utente prima di ritornare.


Returns
Nothing

PauseIfVisible
TextWindow.PauseIfVisible()

Attende l'input dell'utente solo quando la finestra


testo gi aperta.

Ottiene o imposta il colore di sfondo del testo di cui


eseguire l'output nella finestra Testo.
CursorLeft

Returns

TextWindow.CursorLeft

Attende l'unput dell'utente prima di ritornare.

Ottiene o imposta la colonna della posizione del


cursore nella finestra Testo.
CursorTop

Nothing

PauseWithoutMessage
TextWindow.PauseWithoutMessage()

Returns
Nothing

Read

TextWindow.CursorTop

TextWindow.Read()

Ottiene o imposta la riga della posizione del cursore


nella finestra Testo.
Left

Legge una riga di testo dalla Finestra Testo. Questa


funzione rester in attesa fino a che l'utente non
premer Invio.

TextWindow.Left

Returns

Ottiene o imposta la posizione di sinistra della finestra


Testo.
Title

Il testo che stato letto dalla finestra Testo

TextWindow.Title

Ottiene o imposta il titolo della finestra Testo.


Top

ReadNumber
TextWindow.ReadNumber()

Legge un numero dalla Finestra Testo. Questa


funzione rester in attesa fino a che l'utente non
premer Invio.

TextWindow.Top

Returns

Ottiene o imposta la posizione pi in alto della


finestra Testo.
Operations
Show

Il numero che stato letto dalla finestra Testo

TextWindow.Show()

Mostra la finestra Testo per consentire l'interazione


con essa.
Returns
Nothing

Hide
TextWindow.Hide()

Nasconde la finestra Testo.


Returns
Nothing

Clear
TextWindow.Clear()

Pulisce la finestra Testo.


Returns
Nothing

Pause
TextWindow.Pause()

WriteLine
TextWindow.WriteLine(data)

Scrive testo o numeri nella finestra di testo. Un


carattere di ritorno sar appeso all'output, in modo
che ci che verr scritto nella finestra di testo
successivamente, sar visualizzato in una nuova riga.
data
Il testo o numero da scrivere nella finestra di testo.

Returns
Nothing

Write
TextWindow.Write(data)

Scrive testo o numeri nella finestra di testo. Un


carattere di ritorno sar appeso all'output, in modo
che ci che verr scritto nella finestra di testo
successivamente, sar visualizzato in una nuova riga.
data
Il testo o numero da scrivere nella finestra di testo.

Returns
Nothing

14

Text
L'oggetto Text fornisce utili operazioni per lavorare con testi.
Operations
Append
Text.Append(text1, text2)

Concatena due testi e restituisce il risultato in un altro


testo. L'operazione particolarmente utile quando si
ha a che fare con testi che potrebbero essere trattati
come numeri e venire addizionati invece che
concatenati.

Specifica il punto di partenza.

length
Specifica la lunghezza del sotto-testo.

Returns
Il sotto-testo richiesto

GetSubTextToEnd
Text.GetSubTextToEnd(text, start)

Restituisce un sotto-testo dal un dato testo, a partire


da una specifica posizione alla fine.

text1

text

La prima parte del testo che deve essere appeso.

Il testo da cui derivare il sotto-testo.

text2

start

La seconda parte del testo che deve essere appeso.

Specifica la posizione da cui partire.

Returns

Returns

Il testo che contiene entrambi le parti di testo appese.

Il sotto-testo richiesto.

GetLength

GetIndexOf

Text.GetLength(text)

Text.GetIndexOf(text, subText)

Ottiene la lunghezza del testo specificato.

Trova la posizione in cui il sotto-testo appare


all'interno del testo specificato.

text
Il testo di cui si richiede la lunghezza .

Returns
La lunghezza del testo dato.

IsSubText

text
Il testo in cui cercare.

subText
Il testo da trovare.

Text.IsSubText(text, subText)

Returns

Individua se un testo un sottoinsieme di un altro o


meno.

La posizione cui il sotto-testo compare all'interno del testo


specificato. Se il testo non non compare, viene restituito 0.

text

ConvertToLowerCase

Il testo all'interno del quale cercare il sotto-testo.

Text.ConvertToLowerCase(text)

subText

Converte il testo specificato in minuscolo.

Il sotto-testo da cercare.

text

Returns

Il testo da convertire in minuscolo.

True se il sotto-testo stato trovato in un dato testo.

Returns

EndsWith
Text.EndsWith(text, subText)

La versione minuscola del testo dato.

ConvertToUpperCase

Restituisce se un certo testo termina con il sottotesto


specificato o meno.

Text.ConvertToUpperCase(text)

text

text

Il testo all'interno del quale eseguire la ricerca.

Il testo da convertire in maiuscolo.

subText

Returns

Il sotto-testo da cercare.

La versione maiuscola del testo dato.

Returns
True se il sotto-testo stato trovato alla fine di un dato testo.

StartsWith
Text.StartsWith(text, subText)

Restituisce se un testo inizia con il testo cercato.


text
Il testo all'interno del quale eseguire la ricerca.

subText
Il sotto-testo da cercare.

Returns
True se il sotto-testo stato trovato all'inizio di un dato testo.

GetSubText
Text.GetSubText(text, start, length)

Resituisce un sotto-testo del testo specificato.


text
Il testo da cui derivare il sotto-testo.

start

Converte il testo specificato in maiuscolo.

GetCharacter
Text.GetCharacter(characterCode)

Dato il codice del carattere Unicode, restituisce il


carattere corrispondente, che pu poi essere usato
misto a normale testo.
characterCode
Il codice del carattere (basato su Unicode) per il carattere
desiderato.

Returns
Il carattere Unicode che corrisponde al codice specificato.

GetCharacterCode
Text.GetCharacterCode(character)

Dato un carattere unicode, restituisce il relativo


codice.
character
Il carattere il cui codice stato richiesto.

Returns
15

Un codice Unicode che corrisponde al carattere specificato.

Timer
L'oggetto Timer fornisce un modo semplice per eseguire operazioni in modo ripetuto e ad un intervallo
costante.
Properties
Interval

Operations
Pause

Timer.Interval

Timer.Pause()

Restituisce o imposta l'intervallo (in millisecondi) che


specifica ogni quanto l'evento Tick verr lanciato.
Questo valore pu andare da 10 a 100000000
Events
Tick

Mette il timer in pausa. Eventi Tick non verrano


lanciati.

Timer.Tick

Lancia un evento quando il timer scocca.

Returns
Nothing

Resume
Timer.Resume()

Ripristina il timer da uno stato di pausa. Ora verranno


lanciati eventi Tick.
Returns
Nothing

Turtle
La Tartaruga fornisce funzionalit come il linguaggio Logo per disegnare forme manipolando le
propriet di una penna e fornisce primitive per il disegno.
Properties
Speed

Nothing

PenDown

Turtle.Speed

Turtle.PenDown()

Specifica quanto velocemente si muover la tartaruga.


Valori validi sono da 1 a 10. Se Speed impostata a
10, la tartaruga si muove e ruota istantaneamente.
Angle

Returns

Turtle.Angle

Restituisce o imposta l'angolo corrente della


tartaruga. Durante l'impostazione, questo far girare
la tartaruga istantamenamente al nuovo angolo.
X

Appoggia la penna per consentire alla tartaruga di


disegnare mentre si sposta.
Nothing

PenUp
Turtle.PenUp()

Alza la penna per far smettere alla tartaruga di


disegnare quando si sposta.
Returns
Nothing

Turtle.X

Restituisce o imposta la posizione X della Tartaruga.


Durante l'impostazione, questo sposter
istantaneamente la tartaruga nella nuova posizione.
Y

Move
Turtle.Move(distance)

Sposta la tartaruga ad una distanza specificata. Se la


penna gi, disegner una riga durante il movimento.
distance

Turtle.Y

La distanza di cui muovere la tartaruga.

Restituisce o imposta la posizione Y della Tartaruga.


Durante l'impostazione, questo sposter
istantaneamente la tartaruga nella nuova posizione.
Operations
Show

Returns

Turtle.Show()

Mostra la Tartaruga per abilitarne l'uso.


Returns
Nothing

Hide
Turtle.Hide()

Nasconde la Tartaruga e ne disabilita l'uso.


Returns

Nothing

MoveTo
Turtle.MoveTo(x, y)

Gira e sposta la tartaruga alla locazione specifica. Se la


penna gi, disegner una riga durante il movimento.
La coordinata X del punto di destinazione.

y
La coordinata Y del punto di destinazione.

Returns
Nothing

Turn
Turtle.Turn(angle)

16

Gira la tartaruga dell'angolo specificato. L'angolo in


gradi e pu essere sia positivo che negativo, Se
l'angolo positivo, la tartaruga gira alla sua destra, Se
negarivo, la tartaruga gira alla sua sinistra.
angle
L'angolo di cui ruotare la tartaruga.

Returns
Nothing

TurnRight
Turtle.TurnRight()

Ruota la tartaruga di 90 gradi a destra.


Returns
Nothing

TurnLeft
Turtle.TurnLeft()

Ruota la tartaruga di 90 gradi a sinistra.


Returns
Nothing

17