Removed the documentation comments from uiParent. Before we clean up the Darwin backend, we need to implement the manual destruction of parents and children, since that's a prerequisite...
This commit is contained in:
parent
c8c5edaf9d
commit
797408fe6e
29
ui.idl
29
ui.idl
|
@ -57,44 +57,15 @@ interface Control {
|
||||||
func ContainerDisable(void);
|
func ContainerDisable(void);
|
||||||
};
|
};
|
||||||
|
|
||||||
// Parent represents an OS control that hosts other OS controls.
|
|
||||||
// It is used internally by package ui and by implementations.
|
|
||||||
// Window, Tab, and Group all use uiParents to store their controls.
|
|
||||||
interface Parent {
|
interface Parent {
|
||||||
// Internal points to internal data.
|
|
||||||
// Do not access or alter this field.
|
|
||||||
field Internal *void;
|
field Internal *void;
|
||||||
|
|
||||||
// TODO destroy
|
// TODO destroy
|
||||||
// TODO object destruction debug handler
|
// TODO object destruction debug handler
|
||||||
|
|
||||||
// Handle returns the window handle of the uiParent.
|
|
||||||
// On Windows, this is a HWND.
|
|
||||||
// On GTK+, this is a GtkContainer.
|
|
||||||
// On Mac OS X, this is a NSView.
|
|
||||||
func Handle(void) uintptr_t;
|
func Handle(void) uintptr_t;
|
||||||
|
|
||||||
// TODO rename and clean this up
|
// TODO rename and clean this up
|
||||||
// SetChild sets the uiControl that this uiParent relegates.
|
|
||||||
// It calls uiControl.SetParent() which should, in turn, call uiParent.Update().
|
|
||||||
// The uiParent should already not have a child and the uiControl should already not have a parent.
|
|
||||||
//
|
|
||||||
// child can be NULL, in which case the uiParent has no children.
|
|
||||||
// This version should also call uiControl.SetParent(), passing NULL.
|
|
||||||
//
|
|
||||||
// If this uiParent has a child already, then the current child is replaced with the new one.
|
|
||||||
func SetChild(c *Control);
|
func SetChild(c *Control);
|
||||||
|
|
||||||
// SetMargins sets the margins of the uiParent to the given margins.
|
|
||||||
// It does not call uiParent.Update(); its caller must.
|
|
||||||
// The units of the margins are backend-defined.
|
|
||||||
// The initial margins are all 0.
|
|
||||||
func SetMargins(left intmax_t, top intmax_t, right intmax_t, bottom intmax_t);
|
func SetMargins(left intmax_t, top intmax_t, right intmax_t, bottom intmax_t);
|
||||||
|
|
||||||
// TODO Resize?
|
// TODO Resize?
|
||||||
|
|
||||||
// Update tells the uiParent to re-layout its children immediately.
|
|
||||||
// It is called when a widget is shown or hidden or when a control is added or removed from a container such as uiStack.
|
|
||||||
func Update(void);
|
func Update(void);
|
||||||
};
|
};
|
||||||
func NewParent(osParent uintptr_t) *Parent;
|
func NewParent(osParent uintptr_t) *Parent;
|
||||||
|
|
Loading…
Reference in New Issue