NAME

Gapp::Widget - The base class for all Gapp widgets

OBJECT HIERARCHY

Gapp::Widget

DESCRIPTION

All Gapp widgets inherit from Gapp::Widget.

PROVIDED ATTRIBUTES

args

isa: ArrayRef|Undef

default: undef

If args is set, the contents of the ArrayRef will be passed into the constructor when the Gtk+ widget is instantiated. The example below will create a popup window instead of a standard toplevel window.

 Gapp::Window->new( args => [ 'popup' ] );

class

isa: ClassName

required: lazy

This is the class of the Gtk+ widget to be created. Most Gapp widgets provide this in their class definition, but you can override it by passing in your own value.

 Gapp::Window->new( class => 'Gtk2::Ex::CustomWindow' );

constructor

isa: Str|CodeRef

default: new

This constructor is called on the class to instantiate a Gtk+ widget. Change the constructor if you want to use the helpers provided by Gtk+ like new_with_label or new_with_mnemonic.

customize

isa: CodeRef|Undef

default: undef

Setting the customize attribute allows you to tweak the Gtk+ widget after it has been instantiated. Use this sparingly, you should define the appearnce of your widgets using Gapp::Layout.

If you find you need to use customize because parts of Gapp are incomplete, or could be remedied by more robustness, please file a bug or submit a patch.

expand

isa: Bool

default: 0

If the widget should expand inside it's container. (Tables widgets ignore this value because widget expansion is determind by the Gapp::TableMap)

fill

isa: Bool

default: 0

If the widget should fill it's container. (Tables widgets ignore this value because widget layout is determind by the Gapp::TableMap)

gtk_widget

isa: Object

default: 0

The actual Gtk+ widget. The widget will be constructed the first time it is requested. After the Gtk+ widget has been constructed, changes you make to the Gapp layer will not be reflected in the Gtk+ widget.

layout

isa: Gapp::Layout::Object

default: Gapp::Layout::Default

The layout used to determine widget positioning.

padding

isa: Int

default: 0

Padding around the widget.

parent

isa: Gapp::Widget|Undef

default: undef

The parent widget.

properties

isa: HashRef

handles:

get:

get_property

set:

set_property

The the properties supplied will be passed on to the Gtk+ widget during construction. See the documentation for the corresponding Gtk+ widget for valid properies.

AUTHORS

Jeffrey Ray Hallock <jeffrey.hallock at gmail dot com>

COPYRIGHT & LICENSE

    Copyright (c) 2011 Jeffrey Ray Hallock.

    This program is free software; you can redistribute it and/or
    modify it under the same terms as Perl itself.