JUCE API document - Chinese version - All done!

SwingCoder · January 5, 2011, 3:31am

OK, 做个广告。

欢迎访问JUCE类库中文技术支持：

http://blog.sina.com.cn/jucecn

SwingCoder · January 5, 2011, 3:35am

[size=150]Component 组件类[/size]

所有JUCE用户界面对象的基类。更多…

继承自：MouseListener

继承给：ActiveXControlComponent, AudioDeviceSelectorComponent, AudioProcessorEditor, BubbleComponent, Button, CallOutBox, CarbonViewWrapperComponent, CodeEditorComponent, ColourSelector, ComboBox, Drawable, FileBrowserComponent, FileChooserDialogBox::ContentComponent, FilenameComponent, FilePreviewComponent, FileSearchPathListComponent, GroupComponent, KeyMappingEditorComponent, Label, LassoComponent< SelectableItemType >, ListBox, MagnifierComponent, MenuBarComponent, MidiKeyboardComponent, MultiDocumentPanel, NSViewComponent, OpenGLComponent, PluginListComponent, PopupMenuCustomComponent, PreferencesPanel, ProgressBar, PropertyComponent, PropertyPanel, ResizableBorderComponent, ResizableCornerComponent, ScrollBar, Slider, SplashScreen, StretchableLayoutResizerBar, SystemTrayIconComponent, TabbedButtonBar, TabbedComponent, TableHeaderComponent, TextEditor, Toolbar, ToolbarItemPalette, TooltipWindow, TopLevelWindow, TreeView, Viewport, and WebBrowserComponent.

所有成员

类

class BailOutChecker
该类密切注视一个或两个组件，在组件被销毁时进行检验。更多…
class SafePointer
保存某些组件类型的指针，当该组件被销毁时自动将其置零。更多…

Public类型

enum FocusChangeType { focusChangedByMouseClick, focusChangedByTabKey, focusChangedDirectly }

被focusChanged()和focusLost()等函数所使用的枚举常量。

更多…

SwingCoder · January 5, 2011, 3:36am

public成员函数

Component ()
创建一个组件。

virtual ActionListener::~ActionListener ~Component ()
析构函数。
Component (const String &componentName)
创建一个组件，同时设置其名称。
const String & getName () const throw ()
返回此组件的名称。
virtual void setName (const String &newName)
设置此组件的名称。
virtual void setVisible (bool shouldBeVisible)
设置此组件可见与否。
bool isVisible () const throw ()
检测该组件是否可见。
virtual void visibilityChanged ()
组件可见与否发生变化时，自动调用此函数。
bool isShowing () const
检测该组件和它的所有上级组件是否可视。
virtual void addToDesktop (int windowStyleFlags, void *nativeWindowToAttachTo=0)
使该组件显示为一个桌面窗口。
void removeFromDesktop ()
如果该组件正显示在桌面上，此函数将隐藏它。
bool isOnDesktop () const throw ()
如果该组件当前显示在桌面上，则返回true。
ComponentPeer * getPeer () const
返回包含该组件的重量级窗口。
virtual void userTriedToCloseWindow ()
组件位于桌面的前提下，当操作系统要关闭该窗口时，将自动调用此函数。
virtual void minimisationStateChanged (bool isNowMinimised)
桌面组件最小化或取消最小化时，自动调用此函数。
void toFront (bool shouldAlsoGainFocus)
将该组件置于同级组件的最前面。
void toBack ()
将该组件置于同级组件的最后面（改变Z-顺序）。
void toBehind (Component *other)
将该组件置于参数组件的后面（改变Z-顺序）。
void setAlwaysOnTop (bool shouldStayOnTop)
设置该组件是否始终位于同级组件的最前面。
bool isAlwaysOnTop () const throw ()
如果该组件已设置为始终位于同级组件的最前面，则返回true。
int getX () const throw ()
返回该组件的左边缘x坐标。
int getY () const throw ()
返回该组件顶边缘的y坐标。
int getWidth () const throw ()
返回组件的宽度（单位：像素）。
int getHeight () const throw ()
返回组件的高度（单位：像素）。
int getRight () const throw ()
返回该组件右边缘的x坐标。
const Point< int > getPosition () const throw ()
返回该组件的左上角位置。返回类型为Point。
int getBottom () const throw ()
返回该组件底边缘的y坐标。
const Rectangle< int > & getBounds () const throw ()
返回此组件的边框。
const Rectangle< int > getLocalBounds () const throw ()
返回组件的边界，相对于其自身的原点。
const Rectangle< int > getBoundsInParent () const throw ()
返回此组件所覆盖的父级组件的区域。
void getVisibleArea (RectangleList &result, bool includeSiblings) const
返回此组件未被其它组件所遮盖的、且不透明的区域。
int getScreenX () const
返回此组件相对于屏幕原点的X坐标。
int getScreenY () const
返回此组件相对于屏幕原点的Y坐标。
const Point< int > getScreenPosition () const
返回此组件的左上角相对于屏幕左上角的位置。
const Rectangle< int > getScreenBounds () const
返回此组件相对于屏幕左上角的边界。
const Point< int > getLocalPoint (const Component *sourceComponent, const Point< int > &pointRelativeToSourceComponent) const
根据此组件的坐标空间转换一个坐标值（Point）。
const Rectangle< int > getLocalArea (const Component *sourceComponent, const Rectangle< int > &areaRelativeToSourceComponent) const
根据此组件的坐标空间转换一个矩形区域。
const Point< int > localPointToGlobal (const Point< int > &localPoint) const
将此组件的原点转换为屏幕坐标。
const Rectangle< int > localAreaToGlobal (const Rectangle< int > &localArea) const
将此组件的矩形空间转换为屏幕坐标
void setTopLeftPosition (int x, int y)
将此组件移动到新的位置。
void setTopRightPosition (int x, int y)
将此组件移动到新的位置。
void setSize (int newWidth, int newHeight)
更改组件的大小。
void setBounds (int x, int y, int width, int height)
改变组件的位置和大小。
void setBounds (const Rectangle< int > &newBounds)
改变组件的位置和大小。
void setBoundsRelative (float proportionalX, float proportionalY, float proportionalWidth, float proportionalHeight)
根据父级组件的大小和区域更改此组件的位置和大小。
void setBoundsInset (const BorderSize &borders)
基于四周的空间更改此组件的位置和大小。
void setBoundsToFit (int x, int y, int width, int height, const Justification &justification, bool onlyReduceInSize)
按给定的区域定位此组件，宽高比不变。
void setCentrePosition (int x, int y)
更改此组件的中心位置。
void setCentreRelative (float x, float y)
更改此组件的中心位置。
void centreWithSize (int width, int height)
更改此组件的大小，并位于父级组件的中心。
void setTransform (const AffineTransform &transform)
设置此组件的变换矩阵（缩放、旋转等等）。
const AffineTransform getTransform () const
返回此组件当前所设置的变换矩阵（缩放，旋转等等）。
bool isTransformed () const throw ()
如果此组件当前应用了缩放、旋转等转换，则返回true。
int proportionOfWidth (float proportion) const throw ()
返回此组件的宽度比例。
int proportionOfHeight (float proportion) const throw ()
返回此组件的高度比例。
int getParentWidth () const throw ()
返回此组件的父级组件的宽度。
int getParentHeight () const throw ()
返回此组件的父级组件的高度。
const Rectangle< int > getParentMonitorArea () const
返回包含此组件的显示器的屏幕坐标系。
int getNumChildComponents () const throw ()
返回此组件包含的子组件的个数。
Component * getChildComponent (int index) const throw ()
按索引值返回该组件所包含的某个子组件。
int getIndexOfChildComponent (const Component *child) const throw ()
返回此组件所包含的某个子组件的索引值。
void addChildComponent (Component *child, int zOrder=-1)
此组件添加一个子组件。
void addAndMakeVisible (Component *child, int zOrder=-1)
此组件添加一个子组件，如果子组件当前不可见，则使之可见。
void removeChildComponent (Component *childToRemove)
移除此组件所包含的某个子组件。
Component * removeChildComponent (int childIndexToRemove)
按索引值移除该组件所包含的某个子组件。
void removeAllChildren ()
移除该组件所包含的所有子组件。
void deleteAllChildren ()
移除该组件所包含的所有子组件，并销毁它们。
Component * getParentComponent () const throw ()
返回此组件的父级组件。
template
TargetClass * findParentComponentOfClass (TargetClass *const dummyParameter=0) const
按给定的类搜索父级组件。
Component * getTopLevelComponent () const throw ()
返回包含该组件及其父级组件的最顶级组件。
bool isParentOf (const Component *possibleChild) const throw ()
检测该组件是否为给定组件的父级组件。
virtual void parentHierarchyChanged ()
当此组件改变所隶属的父级组件时，自动调用此函数。
virtual void childrenChanged ()
当此组件添加或移除子组件时，自动调用此函数。
virtual bool hitTest (int x, int y)
检测给定的点是否位于此组件内。
void setInterceptsMouseClicks (bool allowClicksOnThisComponent, bool allowClicksOnChildComponents) throw ()
改变hitTest()方法的参数，设置拦截鼠标点击事件。
void getInterceptsMouseClicks (bool &allowsClicksOnThisComponent, bool &allowsClicksOnChildComponents) const throw ()
获取鼠标点击拦截标记的当前状态。
bool contains (const Point< int > &localPoint)
如果给定的坐标点位于此组件或它的子组件之内，则返回true。
bool reallyContains (const Point< int > &localPoint, bool returnTrueIfWithinAChild)
如果给定的点位于此组件之内则返回true，同时考虑到任何重叠的同级组件。
Component * getComponentAt (int x, int y)
返回给定的点所位于的组件。
Component * getComponentAt (const Point< int > &position)
返回给定的点所位于的组件。
void repaint ()
标记整个组件需要重绘。
void repaint (int x, int y, int width, int height)
标记组件的某个区域需要重绘。
void repaint (const Rectangle< int > &area)
标记组件的某个区域需要重绘。
void setBufferedToImage (bool shouldBeBuffered)
设置该组件使用内部缓冲来优化重绘操作。
const Image createComponentSnapshot (const Rectangle< int > &areaToGrab, bool clipImageToComponentBounds=true)
生成此组件某个区域的屏幕快照。
void paintEntireComponent (Graphics &context, bool ignoreAlphaLevel)
用给定的绘图环境重绘此组件及其所有的子组件。
void setPaintingIsUnclipped (bool shouldPaintWithoutClipping) throw ()
此方法允许表明此组件在重绘时无需剪切图形环境。
void setComponentEffect (ImageEffectFilter *newEffect)
设置组件的外观。
ImageEffectFilter * getComponentEffect () const throw ()
返回此组件当前所设置的外观效果。
LookAndFeel & getLookAndFeel () const throw ()
获取该组件所使用的外观及感觉（look-and-feel）。
void setLookAndFeel (LookAndFeel *newLookAndFeel)
设置此组件的外观与感觉（Look-and-Feel）。
virtual void lookAndFeelChanged ()
当该组件所使用的外观与感觉发生变化时，自动调用此函数。
void sendLookAndFeelChange ()
设置此组件和它的所有子组件调用lookAndFeelChanged()方法。
void setOpaque (bool shouldBeOpaque)
设置不透明。
bool isOpaque () const throw ()
如果此组件为不透明的（无任何透明的区域），则返回true。
void setBroughtToFrontOnMouseClick (bool shouldBeBroughtToFront) throw ()
设置当鼠标点击时，此组件是否自动切换到最前面。
bool isBroughtToFrontOnMouseClick () const throw ()
如果鼠标点击时此组件自动切换到最前面，则返回true。
void setWantsKeyboardFocus (bool wantsFocus) throw ()
设置一个标志，以表明此组件是否需要键盘焦点。
bool getWantsKeyboardFocus () const throw ()
如果此组件对键盘焦点感兴趣，则返回true。
void setMouseClickGrabsKeyboardFocus (bool shouldGrabFocus)
设置点击此组件时是否拥有键盘焦点。
bool getMouseClickGrabsKeyboardFocus () const throw ()
返回setMouseClickGrabsKeyboardFocus()所设置的值。
void grabKeyboardFocus ()
试图使此组件拥有键盘焦点。
bool hasKeyboardFocus (bool trueIfChildIsFocused) const
如果此组件当前拥有键盘焦点则返回true。
void moveKeyboardFocusToSibling (bool moveToNext)
尝试将键盘焦点转移给下一个同级组件。
virtual KeyboardFocusTraverser * createFocusTraverser ()
创建一个KeyboardFocusTraverser对象以确定此组件传递焦点的逻辑。
int getExplicitFocusOrder () const
返回此组件的焦点顺序，如果已指定。
void setExplicitFocusOrder (int newFocusOrderIndex)
按索引值设置焦点转移的顺序。
void setFocusContainer (bool shouldBeFocusContainer) throw ()
设置此组件是否为焦点容器。
bool isFocusContainer () const throw ()
如果此组件为焦点容器，则返回true。
bool isEnabled () const throw ()
如果此组件及其所有的子组件为开启状态，则返回true。
void setEnabled (bool shouldBeEnabled)
启用或禁用此组件。
virtual void enablementChanged ()
启用或禁用此组件时自动调用此函数。
void setAlpha (float newAlpha)
更改此组件的透明度。
float getAlpha () const
返回此组件当前所设置的透明度。
void setMouseCursor (const MouseCursor &cursorType)
设置鼠标指针的外观（当鼠标指向该组件时）。
virtual const MouseCursor getMouseCursor ()
获取当前设置的鼠标指针外观（当鼠标指向该组件时）。
void updateMouseCursor () const
强制刷新当前的鼠标指针。
virtual void paint (Graphics &g)
重写此方法以绘制此组件的内容。
virtual void paintOverChildren (Graphics &g)
可重写此方法以绘制位于最前面的子组件。
virtual void mouseMove (const MouseEvent &e)
当鼠标在此组件中移动时，自动调用此函数。
virtual void mouseEnter (const MouseEvent &e)
当鼠标指针进入此组件时，自动调用此函数。
virtual void mouseExit (const MouseEvent &e)
当鼠标指针退出此组件时，自动调用此函数。
virtual void mouseDown (const MouseEvent &e)
当鼠标指针位于此组件并且点击某个鼠标键，尚未释放时，自动调用此函数。
virtual void mouseDrag (const MouseEvent &e)
当鼠标拖拽时，自动调用此函数。
virtual void mouseUp (const MouseEvent &e)
鼠标点击并释放某个鼠标按键时自动调用此函数。
virtual void mouseDoubleClick (const MouseEvent &e)
鼠标在此组件中双击时自动调用此函数。
virtual void mouseWheelMove (const MouseEvent &e, float wheelIncrementX, float wheelIncrementY)
转动鼠标滚轮键时自动调用此函数。
void setRepaintsOnMouseActivity (bool shouldRepaint) throw ()
鼠标指针进入或退出此组件时，自动重绘。
void addMouseListener (MouseListener *newListener, bool wantsEventsForAllNestedChildComponents)
绑定鼠标事件捕获器。
void removeMouseListener (MouseListener *listenerToRemove)
移除已经绑定的鼠标事件捕获器。
void addKeyListener (KeyListener *newListener)
添加此组件能够接收的按键事件捕获器。
void removeKeyListener (KeyListener *listenerToRemove)
移除已经绑定的按键捕获器。
virtual bool keyPressed (const KeyPress &key)
当按下某个键时，自动调用此函数。
virtual bool keyStateChanged (bool isKeyDown)
当按下或释放某个键时自动调用此函数。
virtual void modifierKeysChanged (const ModifierKeys &modifiers)
按下或释放某个功能键时自动调用此函数。
virtual void focusGained (FocusChangeType cause)
此组件拥有键盘焦点时自动此函数。
virtual void focusLost (FocusChangeType cause)
此组件失去键盘焦点时自动此函数。
virtual void focusOfChildComponentChanged (FocusChangeType cause)
此组件的子组件拥有或失去键盘焦点时自动调用此函数。
bool isMouseOver (bool includeChildren=false) const
如果鼠标指针位于此组件则返回true。
bool isMouseButtonDown () const throw ()
如果正按下鼠标的某个键，则返回true。
bool isMouseOverOrDragging () const throw ()
如果鼠标指针位于此组件，或者正在此组件中拖拽，则返回true。
const Point< int > getMouseXYRelative () const
返回鼠标指针的当前位置，相对于此组件的原点。
virtual void resized ()
此组件的大小发生变化时自动调用此函数。
virtual void moved ()
此组件的位置发生变化时自动调用此函数。
virtual void childBoundsChanged (Component *child)
当此组件的某个子组件的大小和位置发生变化时，自动调用此函数。
virtual void parentSizeChanged ()
当此组件的上一级父组件的大小发生变化时，自动调用此函数。
virtual void broughtToFront ()
当此组件位于其同级组件的最前面时，自动调用此函数。
void addComponentListener (ComponentListener *newListener)
添加一个捕获器以告知组件的隶属关系或位置发生变化。
void removeComponentListener (ComponentListener *listenerToRemove)
移除已经添加的组件捕获器。
void postCommandMessage (int commandId)
将某个消息发送给此组件。
virtual void handleCommandMessage (int commandId)
处理postCommandMessage()发送过来的消息。
int runModalLoop ()
进入模态（无限循环、自动置顶状态），直到循环终止。
void enterModalState (bool takeKeyboardFocus=true, ModalComponentManager::Callback *callback=0)
使此组件进入模态。
void exitModalState (int returnValue)
结束模态。
bool isCurrentlyModal () const throw ()
如果此组件当前为模态则返回true。
bool isCurrentlyBlockedByAnotherModalComponent () const
检测是否正有一个模态组件阻碍了此组件接收消息。
virtual bool canModalEventBeSentToComponent (const Component *targetComponent)
当组件为模态时，此函数允许给定组件依然可以接收消息。
virtual void inputAttemptWhenModal ()
在当前正有一个模态组件的前提下，如果尝试点击此组件，则自动调用此函数。
NamedValueSet & getProperties () throw ()
获取此组件的属性设置。
const NamedValueSet & getProperties () const throw ()
获取此组件的属性设置。
const Colour findColour (int colourId, bool inheritFromParent=false) const
查找已经注册使用的某个颜色。
void setColour (int colourId, const Colour &colour)
注册一个要使用的颜色。
void removeColour (int colourId)
如果某个颜色是setColour()所设置的，则移除之。
bool isColourSpecified (int colourId) const
如果给定的颜色由setColour()所设置，则返回true。
void copyAllExplicitColoursTo (Component &target) const
将此组件已经注册的颜色复制给其它组件。
virtual void colourChanged ()
当setColour()函数改变某个颜色时，自动调用此函数。
void * getWindowHandle () const
返回此组件潜在的本地窗口句柄。

SwingCoder · January 5, 2011, 3:39am

静态Public成员函数

static Component *JUCE_CALLTYPE getCurrentlyFocusedComponent () throw ()
返回当前拥有键盘焦点的某个组件。
static void beginDragAutoRepeat (int millisecondsBetweenCallbacks)
确保鼠标拖拽时所产生的事件数据流无停滞。
static bool JUCE_CALLTYPE isMouseButtonDownAnywhere () throw ()
如果正按下鼠标的某个键，则返回true。
static int JUCE_CALLTYPE getNumCurrentlyModalComponents () throw ()
返回当前处于模态的组件个数。
static Component *JUCE_CALLTYPE getCurrentlyModalComponent (int index=0) throw ()
返回当前处于模态的组件。

[size=150]详细说明[/size]

所有JUCE用户界面对象的基类。

枚举成员文档

enum Component::FocusChangeType
被focusChanged()和focusLost()等函数所使用的枚举常量。

枚举常量：
focusChangedByMouseClick
鼠标点击以改变焦点。

focusChangedByTabKey
按TAB键转移焦点。

focusChangedDirectly
使用grabKeyboardFocus()改变焦点。

构造函数和析构函数文档

Component::Component ( )
创建一个组件。

要让此组件实际显示出来，尚需：

将其添加到父级组件中，或者使用addToDesktop()方法使之成为桌面窗口。
设置其大小和位置。
使用setVisible()方法使之可见。
要明确其具有某种使用目的，往往需要派生该类的子类，或者使用JUCE类库中已经定义的该类的派生类（标签、按钮、组合框等等）。

virtual Component::~Component ( ) [virtual]
析构函数。

注意，当销毁某个组件时，它包含的所有子组件不会自动销毁。可使用delete()、deleteAndZero()、deleteAllChildren()等方法或ScopedPointers来管理其子组件。

如果所要销毁的组件是其它组件的子组件，那么在销毁期间，其父级组件将自动移除之，并且父级组件将自动调用childrenChanged()函数。此组件已经注册的所有ComponentListener对象也将自动调用ComponentListener::componentBeingDeleted()方法。

Component::Component ( const String & message componentName ) [explicit]
创建一个组件，同时设置其名称。

参见：
getName, setName

SwingCoder · January 5, 2011, 3:41am

成员函数文档

const String& Component::getName ( ) const throw ()
返回此组件的名称。

参见：
setName
virtual void Component::setName ( const String & message newName ) [virtual]
设置此组件的名称。

改变组件名称时，所有已经注册的ComponentListeners将自动收到一条ComponentListener::componentNameChanged()函数所产生的消息。

参见：
getName()
该类重写此函数：DocumentWindow

virtual void Component::setVisible ( bool shouldBeVisible ) [virtual]
设置此组件可见与否。

此方法将显示或隐藏此组件。注意，组件第一次创建时，默认是不可见的。同时，如果其父级组件不可见，那么无论如何，该组件均不可见。

此函数将调用对此有兴趣的组件捕获器的visibilityChanged()和componentVisibilityChanged()方法。

参数：
shouldBeVisible 是否显示此组件。
参见：
isVisible, isShowing, visibilityChanged, ComponentListener::componentVisibilityChanged
以下函数中引用了此函数：LassoComponent< SelectableItemType >::dragLasso(), LassoComponent< SelectableItemType >::endLasso()

bool Component::isVisible ( ) const throw ()
检测该组件是否可见。

注意：JUCE组件的可见和可视是两个概念。可见并不一定出现在屏幕上。而可视则是实际出现在屏幕上，能够看到该组件。而且，组件是否可见，还取决于其父级组件当前是否已设置为可见。可使用isShowing()方法来确定该组件当前是否可视。

参见：
isShowing, setVisible
virtual void Component::visibilityChanged ( ) [virtual]
组件可见与否发生变化时，自动调用此函数。

参见：
setVisible, isVisible
该类重写此函数：Button, ListBox, ProgressBar, WebBrowserComponent, ResizableWindow, TopLevelWindow

bool Component::isShowing ( ) const
检测该组件和它的所有上级组件是否可视。

返回:
仅在此组件及其所有的父级组件均为可见状态时，才返回true。
参见：
isVisible
以下函数中引用了此函数：CarbonViewWrapperComponent::componentVisibilityChanged()

virtual void Component::addToDesktop ( int windowStyleFlags,
void * nativeWindowToAttachTo = 0
) [virtual]
使该组件显示为一个桌面窗口。

注意，调用此函数要确保该组件已设置为不透明的（使用setOpaque()方法）。如果组件是透明的，或者半透明的，则操作系统的窗口机制将尝试创建一个特殊的透明区域，此举将消耗大量的CPU和内存，并且在某些平台下，可能无法实现透明效果，或者运行出错。

如果该组件是其它组件的子组件，则调用此函数时将首先从父级组件中移除之。同样，如果将桌面上的某个组件置于其它组件中，则首先从桌面上移除之。

参数：
windowStyleFlags ComponentPeer::StyleFlags枚举常量，用于指定窗口的各项属性。
nativeWindowToAttachTo 允许传递一个操作系统的本地窗口，以用来放置此组件。Windows系统下，此参数为一个窗口句柄HWND，MAC系统下为一个HIViewRef。此参数不一定支持所有的操作系统，在不确定将出现什么结果时，最好采用默认的参数0。
参见：
removeFromDesktop, isOnDesktop, userTriedToCloseWindow, getPeer, ComponentPeer::setMinimised, ComponentPeer::StyleFlags, ComponentPeer::getStyleFlags, ComponentPeer::setFullScreen
该类重写此函数：TopLevelWindow

void Component::removeFromDesktop ( )
如果该组件正显示在桌面上，此函数将隐藏它。

也可使用setVisible()临时性的隐藏桌面窗口，但setVisible()不会释放所占用的系统资源。因此，若隐藏的同时打算一并释放所占用的系统资源，则建议使用本函数。

参见：
addToDesktop, isOnDesktop
bool Component::isOnDesktop ( ) const throw ()
如果该组件当前显示在桌面上，则返回true。

参见：
addToDesktop, removeFromDesktop
以下函数中引用了此函数：TopLevelWindow::isUsingNativeTitleBar()

ComponentPeer* Component::getPeer ( ) const
返回包含该组件的重量级窗口。

如果此组件位于桌面上，将返回它所使用的窗口对象。否则，返回其顶级父级组件的窗口。

如果应用程序连一个桌面组件都没有，则返回值也许为0。

参见：
addToDesktop, isOnDesktop
virtual void Component::userTriedToCloseWindow ( ) [virtual]
组件位于桌面的前提下，当操作系统要关闭该窗口时，将自动调用此函数。

此函数将发出关闭窗口的信号，无论是用户点击关闭按钮，还是操作系统强行关闭窗口。默认情况下，触发断言命令以提示该组件将发生某些事情，但可以重写此函数以忽略此命令。

重写此函数的类： AlertWindow, DocumentWindow

virtual void Component::minimisationStateChanged ( bool isNowMinimised ) [virtual]
桌面组件最小化或取消最小化时，自动调用此函数。

仅在此组件为桌面窗口的前提下才调用此函数。

参见：
getPeer, ComponentPeer::setMinimised, ComponentPeer::isMinimised
void Component::toFront ( bool shouldAlsoGainFocus )
将该组件置于同级组件的最前面。

如果其它同级组件已设置为“始终置顶”，那么此函数不能将该组件置于这些置顶组件的前面，除非该组件也设置了“始终置顶”。

参数：
shouldAlsoGainFocus 如果设置为true，将尝试为该组件分配键盘焦点。参见：grabKeyboardFocus()。
参见：
toBack, toBehind, setAlwaysOnTop
引用：CarbonViewWrapperComponent：：carbonEventHandler（）。

void Component::toBack ( )
将该组件置于同级组件的最后面（改变Z-顺序）。

如果该组件已设置为“始终置顶”，此函数仅将该组件置于其它“始终置顶”组件的后面。

参见：
toFront, toBehind, setAlwaysOnTop
void Component::toBehind ( Component * other )
将该组件置于参数组件的后面（改变Z-顺序）。

参见：
toFront, toBack
void Component::setAlwaysOnTop ( bool shouldStayOnTop )
设置该组件是否始终位于同级组件的最前面。

参见：
isAlwaysOnTop
bool Component::isAlwaysOnTop ( ) const throw ()
如果该组件已设置为始终位于同级组件的最前面，则返回true

参见：
setAlwaysOnTop
int Component::getX ( ) const throw ()
返回该组件的左边缘x坐标。

返回的值为该组件距离其父级组件左边缘的像素值。

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

int Component::getY ( ) const throw ()
返回该组件顶边缘的y坐标。

返回的值为该组件距离其父级组件顶边缘的像素值。

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

int Component::getWidth ( ) const throw ()
返回组件的宽度（单位：像素）。

引用：CarbonViewWrapperComponent::createWindow(), LassoComponent< SelectableItemType >::paint(), CarbonViewWrapperComponent::setEmbeddedWindowToOurSize(), CarbonViewWrapperComponent::setOurSizeToEmbeddedViewSize()

int Component::getHeight ( ) const throw ()
返回组件的高度（单位：像素）。

引用： CarbonViewWrapperComponent::createWindow(), LassoComponent< SelectableItemType >::paint(), CarbonViewWrapperComponent::setEmbeddedWindowToOurSize(), CarbonViewWrapperComponent::setOurSizeToEmbeddedViewSize()

int Component::getRight ( ) const throw ()
返回该组件右边缘的x坐标。

返回的值为该组件距离其父级组件左边缘的像素值。

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

const Point Component::getPosition ( ) const throw ()
返回该组件的左上角位置。返回类型为Point。

int Component::getBottom ( ) const throw ()
返回该组件底边缘的y坐标。

返回的值为该组件距离其父级组件顶边缘的像素值。

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

const Rectangle& Component::getBounds ( ) const throw ()
返回此组件的边界。

返回的值为该组件相对于其父级组件左上原点的像素值。

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

引用：LassoComponent< SelectableItemType >::dragLasso().

const Rectangle Component::getLocalBounds ( ) const throw ()
返回组件的边界，相对于其自身的原点。

此函数类似于getBounds()，所不同的，参照的坐标系原点为该组件自身的左上原点，即矩形返回值的起点坐标为(0, 0)。这两个函数返回的宽度和高度一样，均为组件自身的宽度和高度。

const Rectangle Component::getBoundsInParent ( ) const throw ()
返回此组件所覆盖的父级组件的区域。

返回值为相对于父级组件坐标空间的区域。如果此组件使用了无损变换（仿射变换），则返回的值为完整涵盖变换后的边框的最小区域。如果此组件没有父级组件，则与getBounds()函数返回的值相同。

void Component::getVisibleArea ( RectangleList & result,
bool includeSiblings
) const
返回此组件未被其它组件所遮盖的、且不透明的区域。

RectangleList代表所返回的未被此组件的子组件所遮盖的可视区域。

如果参数includeSiblings为true，将一并考虑覆盖此组件的同级组件。

int Component::getScreenX ( ) const
返回此组件相对于屏幕原点的X坐标。

参见：
getX, localPointToGlobal
引用：CarbonViewWrapperComponent::createWindow(), 和CarbonViewWrapperComponent::setEmbeddedWindowToOurSize().

int Component::getScreenY ( ) const
返回此组件相对于屏幕原点的Y坐标。

参见：
getY, localPointToGlobal
引用：CarbonViewWrapperComponent::createWindow(), CarbonViewWrapperComponent::setEmbeddedWindowToOurSize().

const Point Component::getScreenPosition ( ) const
返回此组件的左上角相对于屏幕左上角的位置。

参见：
getScreenBounds
const Rectangle Component::getScreenBounds ( ) const
返回此组件相对于屏幕左上角的边界。

参见：
getScreenPosition
const Point Component::getLocalPoint ( const Component * sourceComponent,
const Point< int > & pointRelativeToSourceComponent
) const
根据此组件的坐标空间转换一个坐标值（Point）。

该点的坐标相对于其它组件，返回的点则是相对于此组件的。如果参数sourceComponent为null，则参数点为全局性的屏幕坐标。

const Rectangle Component::getLocalArea ( const Component * sourceComponent,
const Rectangle< int > & areaRelativeToSourceComponent
) const
根据此组件的坐标空间转换一个矩形区域。

该矩形的坐标相对于其它组件，返回的点则是相对于此组件的。如果参数sourceComponent为null，则矩形参数为屏幕坐标。

如果已使用setTransform ()方法进行了缩放、旋转等无损变换，那么源矩形可能无法转换为实际的目标空间，这种情况下将返回完整包含整个变换区域的最小矩形。

const Point Component::localPointToGlobal ( const Point< int > & localPoint ) const
将此组件的原点转换为屏幕坐标。

参见：
getLocalPoint, localAreaToGlobal
const Rectangle Component::localAreaToGlobal ( const Rectangle< int > & localArea ) const
将此组件的矩形空间转换为屏幕坐标

如果已使用setTransform ()方法进行了缩放、旋转等无损变换，那么源矩形可能无法转换为实际的目标空间，这种情况下将返回完整包含整个变换区域的最小矩形。

参见：
getLocalPoint, localPointToGlobal
void Component::setTopLeftPosition ( int x
int y
)
将此组件移动到新的位置。

此函数改变组件的左上原点位置，不改变其大小。左上原点为相对于其父级组件的位置。

如果此组件发生了实质上的移动，则同步调用moved()函数。