C# Class Descent.GUI.GUIElement

A single element of the user interface that, itself, can contain sub-elements

Inheritance: Microsoft.Xna.Framework.DrawableGameComponent

Afficher le fichier Open project: nezbo/Descent Class Usage Examples

Protected Properties

Свойство	Type	Description
children	Collection
defaultBG	Microsoft.Xna.Framework.Graphics.Texture2D
manager	Descent.Messaging.Events.EventManager
texts	Collection

Méthodes publiques

Méthode	Description
AddChild ( GUIElement child ) : void	Adds the given GUIElement to the set of children within this one.
AddDrawable ( string target, Drawable visual, Rectangle rectangle ) : void	Add the drawable to be displayed on the screen bounding the given rectangle.
AddDrawable ( string target, Drawable visual, Vector2 position ) : void	Add the drawable to be displayed at the given position in this GUIElement.
AddText ( string target, string text, Vector2 position ) : void	Adds the given string to be drawn on the screen on all children (or this) with the target name.
AddText ( string target, string text, Vector2 position, Color color ) : void	Adds the given string to be drawn on the screen on all children (or this) with the target name.
ClearChildren ( ) : void	Removes all children.
Disable ( string target ) : void	Disables all elements below (and including) the target element. They will not take inputs or display anything.
Draw ( SpriteBatch draw ) : void	Draws this GUIElement and then all children on top of it
GUIElement ( Microsoft.Xna.Framework.Game game, string name, int x, int y, int width, int height ) : System	Creates a GUIElement with the given boundaries.
HandleClick ( int x, int y ) : bool	Determines if a click is within the GUIElement and acts upon the click if possible.
HandleKeyPress ( Keys key ) : void	Reacts to the given key type if this GUIElement is focused.
HasFocus ( ) : bool	Tells if the element handled the last click request.
HasPoint ( int x, int y ) : bool	Checks if the given point is within the boundaries of the GUIElement.
LostFocus ( ) : void	Indicate to the element (and all its children) that it has lost focus.
Move ( int x, int y ) : void	Moves this element (and all sub-elements) by the specified amount.
SetBackground ( string assetName ) : void	Changes the background to the given asset and enables background drawing.
SetClickAction ( string target, GUIElement>.Action action ) : void	Replace (if any) the current On Click action with the one given.
SetDrawBackground ( bool toDraw ) : void	Makes the current GUIElement draw a background beneath itself.
SetFont ( SpriteFont newFont ) : void	Sets the font that this GUIElement draws its texts with.
Update ( GameTime gameTime ) : void

Méthodes protégées

Méthode	Description
ActOnDirectClick ( int x, int y ) : void	This memthod can be overwritten if you need to act on clicks that are directly targetting this guielement and not its sub-elements.
WordWrap ( string text, Vector2 position ) : string	Word Wraps the given string so when displayed at the given position, it will not draw outside the width of the GUIElement. If too long, the text will however draw outside the bottom of the box.

Private Methods

Méthode	Description
DrawsBackground ( ) : bool
VisualClicked ( int x, int y ) : bool

Method Details

ActOnDirectClick() protected méthode

This memthod can be overwritten if you need to act on clicks that are directly targetting this guielement and not its sub-elements.

protected ActOnDirectClick ( int x, int y ) : void
x	int	The x-coordinate of the direct click.
y	int	The y-coordinate of the direct click.
Résultat	void

AddChild() public méthode

Adds the given GUIElement to the set of children within this one.

public AddChild ( GUIElement child ) : void
child	GUIElement	The new child
Résultat	void

AddDrawable() public méthode

Add the drawable to be displayed on the screen bounding the given rectangle.

public AddDrawable ( string target, Drawable visual, Rectangle rectangle ) : void
target	string	The target GUIElement for the action
visual	Drawable	The drawable to display
rectangle	Microsoft.Xna.Framework.Rectangle	The drawable should be stretched to be drawn at the rectangle
Résultat	void

AddDrawable() public méthode

Add the drawable to be displayed at the given position in this GUIElement.

public AddDrawable ( string target, Drawable visual, Vector2 position ) : void
target	string	The target GUIElement for the action
visual	Drawable	The drawable to display
position	Vector2	Where the upper-left corner of the drawable should be
Résultat	void

AddText() public méthode

Adds the given string to be drawn on the screen on all children (or this) with the target name.

public AddText ( string target, string text, Vector2 position ) : void
target	string	Only GUIElements with this name should display the text.
text	string	The text to be drawn to the screen.
position	Vector2	Where the upper-left corner of the text should be
Résultat	void

AddText() public méthode

Adds the given string to be drawn on the screen on all children (or this) with the target name.

public AddText ( string target, string text, Vector2 position, Color color ) : void
target	string	Only GUIElements with this name should display the text.
text	string	The text to be drawn to the screen.
position	Vector2	Where the upper-left corner of the text should be
color	Color	The color that the text should be drawn in
Résultat	void

ClearChildren() public méthode

Removes all children.

public ClearChildren ( ) : void
Résultat	void

Disable() public méthode

Disables all elements below (and including) the target element. They will not take inputs or display anything.

public Disable ( string target ) : void
target	string	What to disable.
Résultat	void

Draw() public méthode

Draws this GUIElement and then all children on top of it

public Draw ( SpriteBatch draw ) : void
draw	Microsoft.Xna.Framework.Graphics.SpriteBatch	The SpriteBatch to draw on
Résultat	void

GUIElement() public méthode

Creates a GUIElement with the given boundaries.

public GUIElement ( Microsoft.Xna.Framework.Game game, string name, int x, int y, int width, int height ) : System
game	Microsoft.Xna.Framework.Game
name	string	The name of the element
x	int	The x-coordinate of the upper-left corner
y	int	The y-coordinate of the upper-left corner
width	int	The width of the element
height	int	The height of the element
Résultat	System

HandleClick() public méthode

Determines if a click is within the GUIElement and acts upon the click if possible.

public HandleClick ( int x, int y ) : bool
x	int	The x-coordinate of the click
y	int	The y-coordinate of the click
Résultat	bool

HandleKeyPress() public méthode

Reacts to the given key type if this GUIElement is focused.

public HandleKeyPress ( Keys key ) : void
key	Keys	The key that has been pressed and wasn't pressed before
Résultat	void

HasFocus() public méthode

Tells if the element handled the last click request.

public HasFocus ( ) : bool
Résultat	bool

HasPoint() public méthode

Checks if the given point is within the boundaries of the GUIElement.

public HasPoint ( int x, int y ) : bool
x	int	The x-coordinate of the point
y	int	The y-coordinate of the point
Résultat	bool

LostFocus() public méthode

Indicate to the element (and all its children) that it has lost focus.

public LostFocus ( ) : void
Résultat	void

Move() public méthode

Moves this element (and all sub-elements) by the specified amount.

public Move ( int x, int y ) : void
x	int	The number of pixels it should be moved on the x-axis.
y	int	The number of pixels it should be moved on the y-axis.
Résultat	void

SetBackground() public méthode

Changes the background to the given asset and enables background drawing.

public SetBackground ( string assetName ) : void
assetName	string	The name of the asset in the Content project.
Résultat	void

SetClickAction() public méthode

Replace (if any) the current On Click action with the one given.

public SetClickAction ( string target, GUIElement>.Action action ) : void
target	string	The target GUIElement for the action
action	GUIElement>.Action	The new On Click action
Résultat	void

SetDrawBackground() public méthode

Makes the current GUIElement draw a background beneath itself.

public SetDrawBackground ( bool toDraw ) : void
toDraw	bool	True if the current GUIElement should draw background
Résultat	void

SetFont() public méthode

Sets the font that this GUIElement draws its texts with.

public SetFont ( SpriteFont newFont ) : void
newFont	Microsoft.Xna.Framework.Graphics.SpriteFont	The new font to draw with.
Résultat	void

Update() public méthode

public Update ( GameTime gameTime ) : void
gameTime	Microsoft.Xna.Framework.GameTime
Résultat	void

WordWrap() protected méthode

Word Wraps the given string so when displayed at the given position, it will not draw outside the width of the GUIElement. If too long, the text will however draw outside the bottom of the box.

protected WordWrap ( string text, Vector2 position ) : string
text	string	The text to word wrap
position	Vector2	Where the upper-left corner of the drawable should be
Résultat	string

Property Details

children protected_oe property

protected Collection children
Résultat	Collection

defaultBG protected_oe static_oe property

protected static Texture2D,Microsoft.Xna.Framework.Graphics defaultBG
Résultat	Microsoft.Xna.Framework.Graphics.Texture2D

manager protected_oe static_oe property

protected static EventManager,Descent.Messaging.Events manager
Résultat	Descent.Messaging.Events.EventManager

texts protected_oe property

protected Collection texts
Résultat	Collection