ChildAppWindow Class

Create child application windows.

Inheritance Hierarchy

Object
  VObject
    EventContext
      Window
        AppWindow
          ChildAppWindow
            DataWindow
            SplitWindow
            ChildWinForm

Namespace: VO
Assembly: VOGUIClasses (in VOGUIClasses.dll) Version: 2.21

Syntax

Copy

 CLASS ChildAppWindow INHERIT AppWindow

public class ChildAppWindow : AppWindow

Request Example View Source

The ChildAppWindow type exposes the following members.

Constructors

	Name	Description
	ChildAppWindow	Construct a child application window.

Top

Properties

	Name	Description
	Accelerator	The accelerator table associated with this window. (Inherited from Window.)
	Automated	A logical value determining whether the window object is to be exposed as an OLE automation server. This is a convenient shortcut for the RegisterOLEAutomationObject() function. When the window is destroyed, the UnRegisterOLEAutomationObject() is automatically called. (Inherited from Window.)
	Background	The background brush currently in use by this window. (Inherited from Window.)
	CanvasArea	The bounding box representing the current size of this window's canvas area. (Inherited from Window.)
	Caption	The string representing the caption (the text in the title bar of this window). This method can also be used to change the title of this window. (Inherited from Window.)
	ContextMenu	A menu object representing the local pop-up menu for a window or window control. (Overrides ContextMenu.)
	DragDropClient	The DragDropClient object created when Window:EnableDragDropClient(TRUE) is called. (Inherited from Window.)
	DragDropServer	The DragDropServer object created when Window:EnableDragDropServer(TRUE) is called. (Inherited from Window.)
	DragImageList	The ImageList object used for a drag-and-drop operation. (Inherited from Window.)
	Font	The font currently used by this window. This font is used by the TextObject:TextPrint() method. (Inherited from Window.)
	Foreground	The foreground brush currently in use by this window. (Inherited from Window.)
	HelpDisplay	The help display object currently used by this window. This help display object provides a connection between the help file to be displayed and this window. (Inherited from Window.)
	HyperLabel	The hyperlabel connected to this window. (Inherited from Window.)
	Icon	The large icon object used for this window. (Inherited from Window.)
	IconSm	The small icon object used for this window. (Inherited from Window.)
	Menu	(Overrides Menu.)
	MinSize	The minimum size for the window (Inherited from Window.)
	Origin	The point representing the new location of this window, in the canvas coordinates of its owner. (Inherited from Window.)
	Owner	The owner of the window, either a Window or App object. (Inherited from Window.)
	OwnerAlignment	The Owner Alignment value for the window, which is used when the window is a subwindow on another window. (Inherited from Window.)
	Pen	The pen assigned to the window and used in subsequent line and rectangle drawing operations; it should not be deleted while it is the current selection. (Inherited from Window.)
	Pointer	The pointer used by the window to represent the mouse when it enters the window. (Inherited from Window.)
	QuitOnClose	A logical value. If set to TRUE, quits the application when this (main) window is closed. The default value is FALSE. (Inherited from AppWindow.)
	Size	The dimension representing the size of this window. (Inherited from Window.)
	StatusBar	The status bar currently associated with an application window. If none is associated, the status bar of the owner window is returned. If there is no status bar in the ownership hierarchy, NIL is returned. (Overrides StatusBar.)
	TextColor	Uses a pen object and builds a pen in this window. (Inherited from Window.)
	ToolBar	The toolbar in use by the window. (Overrides ToolBar.)
	WindowArea	The bounding box representing the minimal area which encloses the entire window (canvas area and non-canvas area), in canvas coordinates. (Inherited from Window.)

Top

Methods

	Name	Description
	Activate	Provide a method that is invoked when this window is activated. (Inherited from Window.)
	AddTrayIcon	Adds a tray icon associated with the window. (Inherited from Window.)
	AnimationStart	Provide a method that is invoked when an animation control begins playback. (Inherited from Window.)
	AnimationStop	Provide a method that is invoked when an animation control ends playback. (Inherited from Window.)
	AppCommand	Provide a method that is invoked when an AppCommand event takes place. (Inherited from Window.)
	ButtonClick	Provide a method that is invoked when a check box, push button, or radio button is clicked with the mouse. (Inherited from Window.)
	ButtonDoubleClick	Provide a method that is invoked when a check box, push button, or radio button is double-clicked. (Inherited from Window.)
	CanvasErase	Erase the current canvas area of this window and repaint it using either the background brush or the system's default background color. (Inherited from Window.)
	Center	Center the window on its owner, or if the owner is the dektop, then center the window on the desktop. (Inherited from Window.)
	Close	Invoked just as the window is about to close. (Inherited from Window.)
	ComboBoxExEndEdit	A callback method that is invoked when a ComboBoxEx control sends an 'EndEdit' notification message (Inherited from Window.)
	ComboBoxExNotify	A callback method that is invoked when a ComboBoxEx control sends a notification message (Inherited from Window.)
	ControlNotify	Provide a method that is invoked when a control sends a notification to its parent window. (Inherited from Window.)
	DateTimeSelectionChanged	Provide a method that is invoked when a DateTimePicker selection is changed. (Inherited from Window.)
	DeActivate	Provide a method that is invoked when this window is deactivated. (Inherited from Window.)
	Default	Call the default windows procedure for a window and set the EventReturnValue for the object. (Overrides Default(Usual).)
	Destroy	Provide a method to free memory resources allocated for a ChildAppWindow object and its derived objects. (Overrides Destroy.)
	Disable	Disable this window (until a subsequent call to Enable()). (Inherited from Window.)
	Dispatch	Provide the dispatcher for events within the system when the window has focus; routing various events to their appropriate event handlers. (Inherited from AppWindow.)
	Draw	Display a Draw object on this window. (Inherited from Window.)
	DrawBackground	Draw the background of a window. (Inherited from Window.)
	Drop	Retrieve information about a load from the drag event and act on each file in the selection. (Inherited from Window.)
	EditChange	Provide a method that is invoked when the text in an edit control is changed. (Inherited from Window.)
	EditFocusChange	Provide a method that is invoked when the input focus changes to or from an edit control. (Inherited from Window.)
	EditScroll	Provide a method that is invoked for this window when an edit control is scrolled. (Inherited from Window.)
	Enable	Enable a previously disabled window. (Inherited from Window.)
	EnableBorder	Set the border style for an application window. (Overrides EnableBorder(Usual).)
	EnableCloseBox	Enable or Disable the close button on a window (the X ) (Inherited from Window.)
	EnableDragDropClient	Allow "draggable" windows to be dropped on this window. (Inherited from Window.)
	EnableDragDropServer	Allow this window to be dropped on windows with drag and drop capabilities. (Inherited from Window.)
	EnableHelp	Enable or disable help for a window and its child windows. (Inherited from Window.)
	EnableHelpButton	Enables the help button in the window caption bar. (Inherited from Window.)
	EnableHelpCursor	Changes the cursor to a question mark with a pointer. (Inherited from Window.)
	EnableHorizontalScroll	Enable/disable a window horizontal scroll bar in an application window. (Overrides EnableHorizontalScroll(Usual).)
	EnableMaxBox	Enable/disable a maximize box in an application window. (Inherited from AppWindow.)
	EnableMinBox	Enable/disable a minimize box in an application window. (Inherited from AppWindow.)
	EnableOleDropTarget	Register the window as an OLE drop target. (Inherited from AppWindow.)
	EnableStatusBar	Enable/disable a status bar in an application window. (Overrides EnableStatusBar(Usual).)
	EnableSystemMenu	Enable/disable a system menu in an application window. (Inherited from AppWindow.)
	EnableThemeDialogTexture	Enables or disables the visual style of a dialog window's background. (Inherited from Window.)
	EnableToolBar	Enable/disable a toolbar in an application window. (Inherited from AppWindow.)
	EnableToolTips	Enable or disable the tooltips for a window. Note that assigning a value to Control:ToolTipText automatically enables the tooltip's display on the parent window. (Inherited from Window.)
	EnableVerticalScroll	Enable/disable a window vertical scroll bar in an application window. (Overrides EnableVerticalScroll(Usual).)
	EndWindow	Remove this application window from view (passing control back to the routine which created the application window). (Inherited from AppWindow.)
	ErrorMessage	Display a message in an error box. (Inherited from AppWindow.)
	Expose	Provide a method that is invoked whenever part of the window needs repainting. (Inherited from Window.)
	FocusChange	Provide a method that is invoked when the input focus changes from the current window to another (or vice versa). (Inherited from Window.)
	GetAllChildren	Obtain an array of all X# children objects of the window. (Inherited from Window.)
	GetExStyle	Retrieve the Ex styles for the window. (Inherited from Window.)
	GetStyle	Retrieve the styles for the window. (Inherited from Window.)
	Handle	Return the handle for a window. (Inherited from Window.)
	HasExStyle	Check if an exstyle value has been set for the window (Inherited from Window.)
	HasStyle	Check if a style value has been set for the window (Inherited from Window.)
	HelpRequest	Provide a method that is invoked when the user requests help from the application using one of the available context-sensitive help mechanisms. (Inherited from Window.)
	Hide	Hide this window so it is not visible. (Inherited from Window.)
	HorizontalScroll	Provide a method that is invoked when a horizontal scroll bar is scrolled. (Inherited from Window.)
	HorizontalSlide	Provide a method that is invoked when a horizontal slider's thumb is dragged either by the mouse or the keyboard. (Inherited from Window.)
	HorizontalSpin	Provide a method that is invoked when a horizontal spinner is spun. (Inherited from Window.)
	IsEnabled	Report if this window is currently enabled. (Inherited from Window.)
	IsIconic	Report if this window is currently iconized. (Inherited from Window.)
	IsVisible	Report if this window is visible (completely or partially) or hidden. (Inherited from Window.)
	IsZoomed	Report if this window is maximized (fills the entire screen). (Inherited from Window.)
	KeyDown	Provide a method that is invoked when a key on the keyboard is pressed. (Inherited from Window.)
	KeyUp	Provide a method that is invoked when a key on the keyboard is released. (Inherited from Window.)
	LineTo	Draw a line on this window (using the current pen) from the current pen position to a specified point. (Inherited from Window.)
	ListBoxClick	Provide a method that is invoked when an item in a list box owned by this window is double-clicked. (Inherited from Window.)
	ListBoxSelect	Provide a method that is invoked when an item in a list box owned by this window is clicked. (Inherited from Window.)
	ListViewColumnClick	Provide a method that is invoked when a list view column header is clicked in a list view control. (Inherited from Window.)
	ListViewItemChanged	Provide a method that is invoked when a list view item has changed. (Inherited from Window.)
	ListViewItemChanging	Provide a method that is invoked when the state of a list view item is about to change. (Inherited from Window.)
	ListViewItemDelete	Provide a method that is invoked when a list view item is deleted in a list view control. (Inherited from Window.)
	ListViewItemDrag	Provide a method that is invoked when a list view item is dragged in a list view control. (Inherited from Window.)
	ListViewItemEdit	Provide a method that is invoked when a list view item is edited in a list view control. (Inherited from Window.)
	ListViewKeyDown	Provide a method that is invoked when a key is pressed in a list view control. (Inherited from Window.)
	ListViewMouseButtonDoubleClick	Provide a method that is invoked when a mouse button is double-clicked in a list view control. This could be used to invoke an "edit screen" for the selected item, print a report, etc. See the ListViewMouseButtonDown() method for sample syntax. (Inherited from Window.)
	ListViewMouseButtonDown	Provide a method that is invoked when a mouse button is clicked in a list view control. (Inherited from Window.)
	MenuCommand	Provide a method that is invoked when an item on a menu owned by this window is selected. (Inherited from Window.)
	MenuInit	Provide a method that is invoked when a pop-up menu owned by this window is about to "pop up." (Inherited from Window.)
	MenuSelect	Provide a method that is invoked when an item on a menu owned by this window is selected. (Inherited from Window.)
	MinMaxInfo	Provide a method that is invoked when the size or position of a window is about to change (cf WM_GETMINMAXINFO in Win API). (Inherited from Window.)
	ModifyTrayIcon	Modify the tray icon associated with the window. (Inherited from Window.)
	MonthCalSelectionChanged	Provide a method that is invoked when the selection of a MonthCalendar control is changed. (Inherited from Window.)
	MouseButtonDoubleClick	Provide a method that is invoked when the mouse pointer is positioned over the window and a mouse button is double-clicked. (Inherited from Window.)
	MouseButtonDown	Provide a method that is invoked when the mouse pointer is positioned over the window and a mouse button is clicked. (Inherited from Window.)
	MouseButtonUp	Provide a method that is invoked when the mouse pointer is positioned over the window and a mouse button is released. (Inherited from Window.)
	MouseDrag	Provide a method that is invoked when a mouse with one or more buttons clicked is moved in the window. (Inherited from Window.)
	MouseMove	Provide a method that is invoked when the mouse is moved in the window. (Inherited from Window.)
	MouseTrapOff	Disable the window from trapping MouseEvents generated outside itself. (Inherited from Window.)
	MouseTrapOn	Enable this window to trap MouseEvents generated outside itself. (Inherited from Window.)
	Move	Provide a method that is invoked when the window is moved (either by the user or by the application). (Inherited from Window.)
	MoveTo	Move the current pen to a point on the window's canvas area. (Inherited from Window.)
	OLEDragEnter	Called whenever the mouse enters the window's client area during a drag and drop operation. (Inherited from AppWindow.)
	OLEDragLeave	Called whenever the mouse leaves the window's client area during a drag and drop operation. (Inherited from AppWindow.)
	OLEDragOver	Called whenever the mouse moves within the window's client area during a drag and drop operation. (Inherited from AppWindow.)
	OLEDrop	Called whenever the mouse is released within the window's client area during a drag and drop operation. (Inherited from AppWindow.)
	OLEInPlaceActivate	Called whenever a child OLE object is about to be "inplace" activated. (Inherited from AppWindow.)
	OLEInPlaceDeactivate	Called whenever a child OLE object is about to be "inplace" deactivated. (Inherited from AppWindow.)
	Override	This is a compatibility method that is no longer used or needed. (Inherited from EventContext.)
	PaintBackground	Paint the background for a window with the brush or background object that was specified by the user. (Inherited from Window.)
	PaintBoundingBox	Paint a rectangular area in the window using a specified painting method. (Inherited from Window.)
	PostInit	Implement customized initialization code for the window. (Inherited from Window.)
	PreInit	Implement customized initialization code for the window. (Inherited from Window.)
	Print	Print the contents of the window. (Inherited from Window.)
	QueryClose	Provide a method that is invoked just before the window closes to confirm if the application really wants to close the window. (Inherited from Window.)
	RegisterTimer	Register a timer method to be invoked for the window. (Inherited from Window.)
	RePaint	Send an ExposeEvent to repaint the window's canvas area. (Inherited from Window.)
	RepaintBoundingBox	Repaint a rectangular area in the window. (Inherited from Window.)
	ReportException	This is a compatibility method that is no longer used or needed. (Inherited from AppWindow.)
	ReportNotification	Called by ReportQueue when it has a message for the owner window. (Inherited from AppWindow.)
	Resize	Provide a method that is invoked when the window changes size. (Inherited from Window.)
	RichEditProtected	Provide a method that is invoked when an attempt is made to modify text that is protected in a rich edit control. (Inherited from Window.)
	RichEditSelectionChange	Provide a method that is invoked when the current selection in a rich edit control is changed. (Inherited from Window.)
	RichEditUndoLost	Provide a method that is invoked when the undo state in a rich edit control can no longer be maintained. (Inherited from Window.)
	Scroll	Scroll a rectangular area in the window a specified amount, in a specified direction, and optionally clip the area when scrolled. (Inherited from Window.)
	SetAlignStartSize	This method is used to register the start size of a window which is used later to resize controls that have their OwnerAlignment property set. (Inherited from Window.)
	SetBackgroundBrush	Set the background brush used to paint the window. (Inherited from Window.)
	SetExStyle	Set the extended style of a window. (Inherited from Window.)
	SetFocus	Set the keyboard focus to this window. (Inherited from Window.)
	SetHandle	This methdod allows to set or change the handle of the window. This is normally done right after the window is created. (Inherited from Window.)
	SetStyle	Set the styles for the window. (Inherited from Window.)
	Show	Display a window. (Overrides Show(Usual).)
	ShowBalloonTrayTip	Display a balloon tip for an icon in the tray that is associated with this window. (Inherited from Window.)
	SizeText	Determine the space needed to print a string on the window in the current font. (Inherited from Window.)
	StatusMessage	Display a message in an application window's status bar. (Inherited from AppWindow.)
	SysLinkSelect	Provide a method that is invoked when a a user clicks on a SysLink control. (Inherited from Window.)
	TabKeyDown	Provide a method that is invoked when a key press occurs in a tab control. (Inherited from Window.)
	TabSelect	Provide a method that is invoked when a tab is selected in a tab control. (Inherited from Window.)
	TabSelectionChanging	Provide a method that is invoked when a tab selection is changing in a tab control. (Inherited from Window.)
	TextPrint	Display a given string on the window at a specified location using the current font and the current pen color. (Inherited from Window.)
	Timer	Provide a method to be invoked at specific intervals defined when the timer is registered though the RegisterTimer() method. (Inherited from Window.)
	ToolBarHeightChanged	Provide a method that is invoked when the height of the window's toolbar is changed. (Inherited from Window.)
	ToTop	Move this window "to the front" of the windows lying on the desktop, giving it the input focus. (Inherited from Window.)
	TrayIconBalloonClicked	Provide a method that is invoked when a tray icon balloon is clicked. (Inherited from Window.)
	TrayIconBalloonShown	Provide a method that is invoked when a tray icon balloon is shown. (Inherited from Window.)
	TrayIconBalloonTimeOut	Provide a method that is invoked when a tray icon balloon times out. (Inherited from Window.)
	TrayIconClicked	Provide a method that is invoked when a user clicks on a tray Icon (Inherited from Window.)
	TreeViewItemDelete	Provide a method that is invoked when a tree view item is deleted in a tree view control. (Inherited from Window.)
	TreeViewItemDrag	Provide a method that is invoked when a tree view item is dragged in a tree view control. (Inherited from Window.)
	TreeViewItemEdit	Provide a method that is invoked when a tree view item is edited in a tree view control. (Inherited from Window.)
	TreeViewItemExpanded	Provide a method that is invoked when a tree view item is expanded in a tree view control. (Inherited from Window.)
	TreeViewItemExpanding	Provide a method that is invoked when a tree view item is expanding in a tree view control. (Inherited from Window.)
	TreeViewKeyDown	Provide a method that is invoked when a key is pressed in a tree view control. (Inherited from Window.)
	TreeViewMouseButtonDoubleClick	Provide a method that is invoked when a mouse button is double-clicked in a tree view control. (Inherited from Window.)
	TreeViewMouseButtonDown	Provide a method that is invoked when a mouse button is clicked in a tree view control. (Inherited from Window.)
	TreeViewSelectionChanged	Provide a method that is invoked when the selection has changed from one tree view item to another in a tree view control. (Inherited from Window.)
	TreeViewSelectionChanging	Provide a method that is invoked when the selection is changing from one tree view item to another in a tree view control. (Inherited from Window.)
	Update	Update the client area of the specified window. (Inherited from Window.)
	VerticalScroll	Provide a method that is invoked when a vertical scroll bar is scrolled. (Inherited from Window.)
	VerticalSlide	Provide a method that is invoked when a vertical slider's thumb is dragged either by the mouse or the keyboard. (Inherited from Window.)
	VerticalSpin	Provide a method that is invoked when a vertical spinner is spun. (Inherited from Window.)
	WarningMessage	Display a message in an warning box. (Inherited from AppWindow.)

Top

Fields

	Name	Description
	EventReturnValue	(Inherited from Window.)
	oCargo	Cargo slot. (Inherited from VObject.)

Top

Remarks

A child application window is an application window that "belongs to" another window (its owner). Because a child application window is not independent of the owner window, it is always destroyed, hidden, or iconized when its owner window is destroyed, hidden, or iconized. Also note that child application windows are clipped against the owner window. Child application windows do not have a default size and position on their owner window. They must be given an origin and size before they are shown. In Windows, a child application window never displays a menu (except for the system menu). However, it can own a menu. If the child window is used as an MDI child under a shell window, its menu is displayed in the shell. This is very useful: when different child windows present different types of data, they often need different menus. The system automatically switches the owner shell window's menu according to which child window has focus.

Examples

The following example displays a child window:

Copy

 1CLASS MyTopAppWindow INHERIT TopAppWindow
 2HIDDEN oCAWNew AS OBJECT
 3METHOD Init() CLASS MyTopAppWindow
 4SUPER:Init()
 5oCAWNew := ChildAppWindow{SELF,FALSE}
 6SELF:Caption := "Top App Window"
 7oCAWNew:Origin := Point{10,10}
 8oCAWNew:Size := Dimension{100,60}
 9SELF:Show()
10oCAWNew:Caption := "Child App Window"
11oCAWNew:Show()

Reference

VO Namespace