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' ] );

gclass

isa: ClassName

required: lazy

This is the class of the CGObject> 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( gclass => 'Gtk2::Ex::CustomWindow' );

constructor

isa: Str|CodeRef

default: new

This constructor is called on the gclass 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. (Table 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. (Table widgets ignore this value because widget layout is determind by the Gapp::TableMap)

gobject

isa: Object

default: 0

The actual GObject instance. The GObject will be constructed the first time it is requested. After the object 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

traits

isa: ArrayRef

default: []

The traits to apply to the widget.

AUTHORS

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

COPYRIGHT & LICENSE

    Copyright (c) 2011-2012 Jeffrey Ray Hallock.

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