v2 – fyne.io/fyne/v2/container Index | Files

package container

import "fyne.io/fyne/v2/container"

Package container provides container widgets that are used to lay out and organise applications

Index

Constants 

const (
	// ScrollBoth supports horizontal and vertical scrolling.
	ScrollBoth ScrollDirection = widget.ScrollBoth
	// ScrollHorizontalOnly specifies the scrolling should only happen left to right.
	ScrollHorizontalOnly = widget.ScrollHorizontalOnly
	// ScrollVerticalOnly specifies the scrolling should only happen top to bottom.
	ScrollVerticalOnly = widget.ScrollVerticalOnly
	// ScrollNone turns off scrolling for this container.
	//
	// Since: 2.1
	ScrollNone = widget.ScrollNone
)

Constants for valid values of ScrollDirection.

Functions

func New 

func New(layout fyne.Layout, objects ...fyne.CanvasObject) *fyne.Container

New returns a new Container instance holding the specified CanvasObjects which will be laid out according to the specified Layout.

Since: 2.0

func NewAdaptiveGrid 

func NewAdaptiveGrid(rowcols int, objects ...fyne.CanvasObject) *fyne.Container

NewAdaptiveGrid creates a new container with the specified objects and using the grid layout. When in a horizontal arrangement the rowcols parameter will specify the column count, when in vertical it will specify the rows. On mobile this will dynamically refresh when device is rotated.

Since: 1.4

func NewBorder 

func NewBorder(top, bottom, left, right fyne.CanvasObject, objects ...fyne.CanvasObject) *fyne.Container

NewBorder creates a new container with the specified objects and using the border layout. The top, bottom, left and right parameters specify the items that should be placed around edges, the remaining elements will be in the center. Nil can be used to an edge if it should not be filled.

Since: 1.4

func NewCenter 

func NewCenter(objects ...fyne.CanvasObject) *fyne.Container

NewCenter creates a new container with the specified objects centered in the available space.

Since: 1.4

func NewGridWithColumns 

func NewGridWithColumns(cols int, objects ...fyne.CanvasObject) *fyne.Container

NewGridWithColumns creates a new container with the specified objects and using the grid layout with a specified number of columns. The number of rows will depend on how many children are in the container.

Since: 1.4

func NewGridWithRows 

func NewGridWithRows(rows int, objects ...fyne.CanvasObject) *fyne.Container

NewGridWithRows creates a new container with the specified objects and using the grid layout with a specified number of rows. The number of columns will depend on how many children are in the container.

Since: 1.4

func NewGridWrap 

func NewGridWrap(size fyne.Size, objects ...fyne.CanvasObject) *fyne.Container

NewGridWrap creates a new container with the specified objects and using the gridwrap layout. Every element will be resized to the size parameter and the content will arrange along a row and flow to a new row if the elements don't fit.

Since: 1.4

func NewHBox 

func NewHBox(objects ...fyne.CanvasObject) *fyne.Container

NewHBox creates a new container with the specified objects and using the HBox layout. The objects will be placed in the container from left to right.

Since: 1.4

func NewMax 

func NewMax(objects ...fyne.CanvasObject) *fyne.Container

NewMax creates a new container with the specified objects filling the available space.

Since: 1.4

func NewPadded 

func NewPadded(objects ...fyne.CanvasObject) *fyne.Container

NewPadded creates a new container with the specified objects inset by standard padding size.

Since: 1.4

func NewVBox 

func NewVBox(objects ...fyne.CanvasObject) *fyne.Container

NewVBox creates a new container with the specified objects and using the VBox layout. The objects will be stacked in the container from top to bottom.

Since: 1.4

func NewWithoutLayout 

func NewWithoutLayout(objects ...fyne.CanvasObject) *fyne.Container

NewWithoutLayout returns a new Container instance holding the specified CanvasObjects that are manually arranged.

Since: 2.0

Types

type AppTabs 

type AppTabs struct {
	widget.BaseWidget

	Items []*TabItem

	// Deprecated: Use `OnSelected func(*TabItem)` instead.
	OnChanged    func(*TabItem)
	OnSelected   func(*TabItem)
	OnUnselected func(*TabItem)
	// contains filtered or unexported fields
}

AppTabs container is used to split your application into various different areas identified by tabs. The tabs contain text and/or an icon and allow the user to switch between the content specified in each TabItem. Each item is represented by a button at the edge of the container.

Since: 1.4

func NewAppTabs 

func NewAppTabs(items ...*TabItem) *AppTabs

NewAppTabs creates a new tab container that allows the user to choose between different areas of an app.

Since: 1.4

func (*AppTabs) Append 

func (t *AppTabs) Append(item *TabItem)

Append adds a new TabItem to the end of the tab bar.

func (*AppTabs) CreateRenderer 

func (t *AppTabs) CreateRenderer() fyne.WidgetRenderer

CreateRenderer is a private method to Fyne which links this widget to its renderer

Implements: fyne.Widget

func (*AppTabs) CurrentTab 

func (t *AppTabs) CurrentTab() *TabItem

CurrentTab returns the currently selected TabItem.

Deprecated: Use `AppTabs.Selected() *TabItem` instead.

func (*AppTabs) CurrentTabIndex 

func (t *AppTabs) CurrentTabIndex() int

CurrentTabIndex returns the index of the currently selected TabItem.

Deprecated: Use `AppTabs.SelectedIndex() int` instead.

func (*AppTabs) ExtendBaseWidget 

func (t *AppTabs) ExtendBaseWidget(wid fyne.Widget)

ExtendBaseWidget is used by an extending widget to make use of BaseWidget functionality.

Deprecated: Support for extending containers is being removed

func (*AppTabs) Hide 

func (t *AppTabs) Hide()

Hide hides the widget.

Implements: fyne.CanvasObject

func (*AppTabs) MinSize 

func (t *AppTabs) MinSize() fyne.Size

MinSize returns the size that this widget should not shrink below

Implements: fyne.CanvasObject

func (*AppTabs) Remove 

func (t *AppTabs) Remove(item *TabItem)

Remove tab by value.

func (*AppTabs) RemoveIndex 

func (t *AppTabs) RemoveIndex(index int)

RemoveIndex removes tab by index.

func (*AppTabs) Select 

func (t *AppTabs) Select(item *TabItem)

Select sets the specified TabItem to be selected and its content visible.

func (*AppTabs) SelectIndex 

func (t *AppTabs) SelectIndex(index int)

SelectIndex sets the TabItem at the specific index to be selected and its content visible.

func (*AppTabs) SelectTab 

func (t *AppTabs) SelectTab(item *TabItem)

SelectTab sets the specified TabItem to be selected and its content visible.

Deprecated: Use `AppTabs.Select(*TabItem)` instead.

func (*AppTabs) SelectTabIndex 

func (t *AppTabs) SelectTabIndex(index int)

SelectTabIndex sets the TabItem at the specific index to be selected and its content visible.

Deprecated: Use `AppTabs.SelectIndex(int)` instead.

func (*AppTabs) Selected 

func (t *AppTabs) Selected() *TabItem

Selected returns the currently selected TabItem.

func (*AppTabs) SelectedIndex 

func (t *AppTabs) SelectedIndex() int

SelectedIndex returns the index of the currently selected TabItem.

func (*AppTabs) SetItems 

func (t *AppTabs) SetItems(items []*TabItem)

SetItems sets the container’s items and refreshes.

func (*AppTabs) SetTabLocation 

func (t *AppTabs) SetTabLocation(l TabLocation)

SetTabLocation sets the location of the tab bar

func (*AppTabs) Show 

func (t *AppTabs) Show()

Show this widget, if it was previously hidden

Implements: fyne.CanvasObject

type DocTabs 

type DocTabs struct {
	widget.BaseWidget

	Items []*TabItem

	CreateTab      func() *TabItem
	CloseIntercept func(*TabItem)
	OnClosed       func(*TabItem)
	OnSelected     func(*TabItem)
	OnUnselected   func(*TabItem)
	// contains filtered or unexported fields
}

DocTabs container is used to display various pieces of content identified by tabs. The tabs contain text and/or an icon and allow the user to switch between the content specified in each TabItem. Each item is represented by a button at the edge of the container.

Since: 2.1

func NewDocTabs 

func NewDocTabs(items ...*TabItem) *DocTabs

NewDocTabs creates a new tab container that allows the user to choose between various pieces of content.

Since: 2.1

func (*DocTabs) Append 

func (t *DocTabs) Append(item *TabItem)

Append adds a new TabItem to the end of the tab bar.

func (*DocTabs) CreateRenderer 

func (t *DocTabs) CreateRenderer() fyne.WidgetRenderer

CreateRenderer is a private method to Fyne which links this widget to its renderer

Implements: fyne.Widget

func (*DocTabs) Hide 

func (t *DocTabs) Hide()

Hide hides the widget.

Implements: fyne.CanvasObject

func (*DocTabs) MinSize 

func (t *DocTabs) MinSize() fyne.Size

MinSize returns the size that this widget should not shrink below

Implements: fyne.CanvasObject

func (*DocTabs) Remove 

func (t *DocTabs) Remove(item *TabItem)

Remove tab by value.

func (*DocTabs) RemoveIndex 

func (t *DocTabs) RemoveIndex(index int)

RemoveIndex removes tab by index.

func (*DocTabs) Select 

func (t *DocTabs) Select(item *TabItem)

Select sets the specified TabItem to be selected and its content visible.

func (*DocTabs) SelectIndex 

func (t *DocTabs) SelectIndex(index int)

SelectIndex sets the TabItem at the specific index to be selected and its content visible.

func (*DocTabs) Selected 

func (t *DocTabs) Selected() *TabItem

Selected returns the currently selected TabItem.

func (*DocTabs) SelectedIndex 

func (t *DocTabs) SelectedIndex() int

SelectedIndex returns the index of the currently selected TabItem.

func (*DocTabs) SetItems 

func (t *DocTabs) SetItems(items []*TabItem)

SetItems sets the container’s items and refreshes.

func (*DocTabs) SetTabLocation 

func (t *DocTabs) SetTabLocation(l TabLocation)

SetTabLocation sets the location of the tab bar

func (*DocTabs) Show 

func (t *DocTabs) Show()

Show this widget, if it was previously hidden

Implements: fyne.CanvasObject

type Scroll 

type Scroll = widget.Scroll

Scroll defines a container that is smaller than the Content. The Offset is used to determine the position of the child widgets within the container.

Since: 1.4

func NewHScroll 

func NewHScroll(content fyne.CanvasObject) *Scroll

NewHScroll create a scrollable parent wrapping the specified content. Note that this may cause the MinSize.Width to be smaller than that of the passed object.

Since: 1.4

func NewScroll 

func NewScroll(content fyne.CanvasObject) *Scroll

NewScroll creates a scrollable parent wrapping the specified content. Note that this may cause the MinSize to be smaller than that of the passed object.

Since: 1.4

func NewVScroll 

func NewVScroll(content fyne.CanvasObject) *Scroll

NewVScroll a scrollable parent wrapping the specified content. Note that this may cause the MinSize.Height to be smaller than that of the passed object.

Since: 1.4

type ScrollDirection 

type ScrollDirection = widget.ScrollDirection

ScrollDirection represents the directions in which a Scroll container can scroll its child content.

Since: 1.4

type Split 

type Split struct {
	widget.BaseWidget
	Offset     float64
	Horizontal bool
	Leading    fyne.CanvasObject
	Trailing   fyne.CanvasObject
}

Split defines a container whose size is split between two children.

Since: 1.4

func NewHSplit 

func NewHSplit(leading, trailing fyne.CanvasObject) *Split

NewHSplit creates a horizontally arranged container with the specified leading and trailing elements. A vertical split bar that can be dragged will be added between the elements.

Since: 1.4

func NewVSplit 

func NewVSplit(top, bottom fyne.CanvasObject) *Split

NewVSplit creates a vertically arranged container with the specified top and bottom elements. A horizontal split bar that can be dragged will be added between the elements.

Since: 1.4

func (*Split) CreateRenderer 

func (s *Split) CreateRenderer() fyne.WidgetRenderer

CreateRenderer is a private method to Fyne which links this widget to its renderer

func (*Split) ExtendBaseWidget 

func (s *Split) ExtendBaseWidget(wid fyne.Widget)

ExtendBaseWidget is used by an extending widget to make use of BaseWidget functionality.

Deprecated: Support for extending containers is being removed

func (*Split) SetOffset 

func (s *Split) SetOffset(offset float64)

SetOffset sets the offset (0.0 to 1.0) of the Split divider. 0.0 - Leading is min size, Trailing uses all remaining space. 0.5 - Leading & Trailing equally share the available space. 1.0 - Trailing is min size, Leading uses all remaining space.

type TabItem 

type TabItem struct {
	Text    string
	Icon    fyne.Resource
	Content fyne.CanvasObject
}

TabItem represents a single view in a tab view. The Text and Icon are used for the tab button and the Content is shown when the corresponding tab is active.

Since: 1.4

func NewTabItem 

func NewTabItem(text string, content fyne.CanvasObject) *TabItem

NewTabItem creates a new item for a tabbed widget - each item specifies the content and a label for its tab.

Since: 1.4

func NewTabItemWithIcon 

func NewTabItemWithIcon(text string, icon fyne.Resource, content fyne.CanvasObject) *TabItem

NewTabItemWithIcon creates a new item for a tabbed widget - each item specifies the content and a label with an icon for its tab.

Since: 1.4

type TabLocation 

type TabLocation int

TabLocation is the location where the tabs of a tab container should be rendered

Since: 1.4 

const (
	TabLocationTop TabLocation = iota
	TabLocationLeading
	TabLocationBottom
	TabLocationTrailing
)

TabLocation values

Source Files

apptabs.go container.go doctabs.go layouts.go scroll.go split.go tabs.go

Version
v2.1.2-rc2
Published
Dec 2, 2021
Platform
windows/amd64
Imports
9 packages
Last checked
22 minutes ago –

Tools for package owners.