苹果闪屏

苹果闪屏

-

2023年2月19日发(作者：)

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

1//?f=2&t=6414

RawMaterialSoftware

C++programmingtools

Skiptocontent

Search…Search

Advancedsearch

About

JUCE

Overview

Features

Licensing

Documentation

Users

Downloads

Forum

Wiki

Contact

Home»Boardindex‹General‹GeneralJUCEdiscussion

Changefontsize

Printview

ForumFAQ

Register

Login

JUCEAPIdocument-Chineseversion-Alldone!

Writecomments

Searchthistopic…Search

1014posts•Page1of68•1,2,3,4,5...68

JUCEAPIdocument-Chineseversion-Alldone!

bySwingCoder»WedJan05,20114:31am

JUCEAPI文档（中文版）

翻译：SwingCoder（中文网名：小T）

翻译蓝本基于HTML格式的JUCEAPI文档（1.52版本），由于此论坛不支持嵌入HTML，因此发布

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

2//?f=2&t=6414

的结果是纯文本，排版和格式不太美观，但是基本不影响查阅和搜索。

时间仓促，水平有限，加上是即时更新，因此，您所看到的结果仅仅是第一道草译，尚未经过

仔细审阅和严格校对，错谬和遗漏在所难免，敬请指出。谢谢！

本文档仅供在线参阅，除本人和Jules之外，任何组织和个人不得以任何名义复制、摘录、传

播、出售本文档的部分或全部内容。违者必究。

如需完整的HTML、PDF等格式的JUCE类库中文文档，请联系本人。Email：miti-net@

Remarks（备注）

Listener：译为“捕获器”、“捕获”。这个词汇是JUCE类库的核心机制之一，斟酌再三，感

觉还是“捕获”比较贴切。

Broadcaster：译为“生成器”。理由同上。

-->感谢xinhu兄的建议和讨论，关于这两个词汇的约定，我个人的初衷与想法可点此查看。

Changebroadcaster：JUCE的核心机制之一，译为“可变生成器”。它专门有一个类，名称即

为ChangeBroadcaster。这个词汇和概念在许多类中都有涉及。

ChangeListener：与上对应，译为“可变捕获器”。

Register：也是JUCE的核心机制之一，译为“绑定”，有些地方，为了上下文阅读顺利，也译

为“注册”。

Slider：按音乐制作和专业录音领域的惯例，统一翻译为“推子”。不派生子类并定制外观的

前提下，JUCE默认的推子一共有三大种类：“传统式推子（水平式、垂直式）”、“旋钮式推

子”、“进度条式推子”。其中传统式推子又可分为“单头两段式”、“双头三段式”和“三

头四段式”等三种。旋钮式推子根据其大小，也可细分为“仿真式（无外环）”和“里程表式

（有外环）”这两种。

Velocity：按电脑音乐领域的词汇使用规范，统一翻译为“力度”。这个词在MidiMessage类

中大量出现。Slider类也不少。所不同的，MIDI中的力度指的是弹奏键盘的下指力度，而

Slider中的力度则是鼠标移动的速率。二者的原理其实一致。弹琴的力度也是由下指的速率得

来的。Slider类有一些与此有关的方法，也是很实用、彰显JUCE类库出类拔萃的诸多特性中的

又一个亮点，即译文中的“力度敏感模式”……

Graphics：在不同的语境中，分别译为“图形”、“图形类”或“图形对象”。

Graphicscontext：没有采用惯用的“图形上下文”一词，统一译为“图形环境”。

Path：译为“轨迹”、“轨迹类”、“轨迹对象”等等。没有译为“路径”的原因有二，一是

为避免混淆。大部分时候，提到“路径”，往往认为是“文件路径”、“目录路径”，特别是

不熟悉JUCE类库的人。二是JUCE的这个类，主要用于“勾勒”和“搭建”各种各样的形状，而

后用图形环境进行描绘或填充。它勾勒形状的机制很像一个抽象而变化的点所游弋出的轨迹，

但却仅仅是勾勒和指明，并不实际展示出来。就好比汽车或子弹运动之后，会产生行进路线、

弹道，而路线和弹道并不是可视的东西，非常类似JUCE类中的这个Path。斟酌之后，我称其

为“轨迹”。

MidiKeyboardComponent：译为“虚拟键盘”。在音乐领域，特别是作曲、配器和器乐演奏、

现场演出等领域，包括现代音乐这个较大的子领域，键盘指的是钢琴、合成器、电钢琴、手风

琴、管风琴一类的键盘乐器。电脑音乐领域，有时也指MIDI键盘。JUCE的

MidiKeyboardComponent类的对象，即是一个标准的虚拟式MIDI键盘。

关于“AudioProcessor（音频处理类）”：该类是一个抽象基类，封装了时下比较流行的、适

用于多个操作系统的专业音频驱动，比如Steinberg公司的VST、苹果系统下的AU、DigiDesign

的RTAS等等。按专业音频界约定俗成的惯例，Plugin一律译为“插件”或“音频插件”，Host

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

3//?f=2&t=6414

一律译为“宿主”或“宿主程序”。类似的词汇还有：滤波、滤波器、采样率、延迟缓冲...

等等。恕不一一列举。

...

Class（类）按大小排序（从大到小）

Component组件类

LookAndFeel外观和感觉类

String字符串类

MidiMessageMIDI消息类

Slider推子类

File文件类

Graphics图形类

TextEditor文本编辑器类

Path轨迹类

Colours颜色类

Button按钮类

MidiKeyboardComponent虚拟键盘类

AudioProcessor音频处理类

XmlElementXML元素类

CodeEditorComponent代码编辑器类

ListBox列表框类

ComponentPeer组件对等器类

ComboBox组合框类

TableHeaderComponent表头组件类

Timer计时器类

Label标签类

BigInteger大整数类

ValueTree值树类

TreeView树形视图类

Colour色彩类

AlertWindow弹出式窗口类

AudioProcessorGraph音频处理图示类

KeyPress按键类

TreeViewItem树形视图项目类

CharacterFunctions字符函数类

ResizableWindow可调整大小的窗口类

Font字体类

ScrollBar滚动条类

Toolbar工具栏类

AudioSampleBuffer音频采样缓冲类

Image图像类

Time时间类

AffineTransform仿射变换类

AudioGraphIOProcessor音频图示进出处理类

DrawableComposite可绘制对象的容器类

StringArray字符串数组类

AudioDeviceManager音频设备管理器类

DocumentWindow文档窗口类

Viewport视图类参考

var变体类

Desktop桌面类

LowLevelGraphicsPostScriptRenderer低级图形脚本渲染类

PopupMenu弹出式菜单类

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

4//?f=2&t=6414

ApplicationCommandManager程序命令管理器类

URL类

JUCEApplication应用程序类

MouseEvent鼠标事件类

FileBrowserComponent文件浏览器

TabbedComponent标签（选项卡）组件

Drawable可绘制类

OldSchoolLookAndFeelJUCE原始的外观和感觉类

LowLevelGraphicsSoftwareRenderer低级图形软件渲染类

Expression表达式类

TableListBox表格类

TabbedButtonBar标签按钮栏

MultiDocumentPanel多文档面板

InputStream输入流类

FileBasedDocument文档基本操作类

KeyPressMappingSet键映射类

LowLevelGraphicsContext低级图形环境类

Synthesiser合成器类

AudioIODevice音频设备类

GlyphArrangement字形排列类

MidiMessageSequenceMIDI消息序列

FilenameComponent文件名组件

PlatformUtilities与平台相关的杂项类

MemoryBlock内存块类

AudioDataConverters音频数据转换类

Thread线程类

RelativeTime相对时间类

OutputStream输出流

ModifierKeys功能键类

RectangleList组合矩形

MenuBarComponent菜单栏组件

DrawableShape::FillAndStrokeState填充和描边

CodeDocument代码文档类

CarbonViewWrapperComponent封装了Carbon的视图组件

PathStrokeType轨迹描边类型

PropertySet属性集合类

ComponentBoundsConstrainer组件边界限制器

PixelARGB色素类

ToolbarItemComponent工具栏项目组件

DrawablePath::ValueTreeWrapper::Element值树封装-元素类

WavAudioFormatWAV音频格式类

QuickTimeMovieComponentQuickTime动画组件

MouseInputSource鼠标输入源

DrawableButton可绘制的按钮

FileSearchPathListComponent文件搜索路径列表组件

TopLevelWindow顶级窗口类

ResizableBorderComponent可调整大小的组件

AudioFormatReader音频格式读取器

DrawableShape可绘制的形状

CustomTypeface字型自定义

DrawableComposite::ValueTreeWrapper值树封装类

UndoManager撤销管理器类

OpenGLComponentOpenGL组件类

PixelAlpha透明像素

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

5//?f=2&t=6414

MidiOutputMIDI输出类

PropertiesFile属性文件类

AudioFormat音频格式类

ColourGradient颜色渐变类

PropertyPanel属性面板类

CodeDocument::Position代码文档::位置类

StretchableLayoutManager可伸缩的布局管理器

ChannelRemappingAudioSource通道重映射音频来源

MouseListener鼠标捕获器类

IIRFilterIIR滤波器类

AudioTransportSource音频传送来源

AudioFormatWriter音频格式写入器

FillType填充类型

KnownPluginList已知的插件列表

PixelRGB像素颜色类

DrawableImage可绘制的图像类

CallOutBox标注类

TableListBoxModel表格模型类

DrawableText可绘制的文本

AudioThumbnail音频缩略图类

DirectoryContentsList目录内容列表类

ThreadPool线程池

Image::SharedImage共享图像类

SynthesiserVoice合成器声部类

AudioCDBurner音频CD刻录类

BubbleComponent语泡组件类

FileSearchPath文件搜索路径类

FileListComponent文件列表组件类

RelativeCoordinate相对坐标类

DragAndDropContainer拖放容器类

TextLayout文本布局类

MidiFileMIDI文件类

MenuBarModel菜单栏模型类

MidiBufferMIDI缓冲类

Justification对齐类

AbstractFifo抽象的先进先出类

AudioCDReader音频CD读取器

BorderSize边框大小类

ListBoxModel列表框模型类

StringPairArray字符串键值对数组

MessageManager消息管理器类

MouseCursor鼠标指针类

Value数值类

ByteOrder字节顺序类

ApplicationCommandTarget程序命令目标类

DrawableText::ValueTreeWrapper可绘制的文本::值树封装

SystemStats系统统计类

InterprocessConnection进程连接类

PluginDescription插件描述类

RelativeParallelogram平行四边形类

StreamingSocket流式套接字类

ResizableBorderComponent::Zone可调整边框的组件::地带

AudioProcessorPlayer音频处理播放器类

RelativePointPath相对位置的点轨迹

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

6//?f=2&t=6414

SplashScreen闪屏

RecentlyOpenedFilesList最近打开的文件列表

ComponentAnimator组件动画效果

CameraDevice摄像头

RelativePoint相对位置的点

OpenGLPixelFormatOpenGL的像素格式

ProgressBar进度条

ColourSelector颜色选择器

DatagramSocket数据报套接字

LocalisedStrings本地化字符串

GroupComponent组别类

DrawableRectangle可绘制的矩形

NamedValueSet已命名的数值集合

MidiKeyboardStateMIDI键盘状态类

DrawableImage::ValueTreeWrapper可绘制的图像::值树封装类

FileChooserDialogBox文件选择对话框

KeyMappingEditorComponent按键映射编辑器组件

OggVorbisAudioFormatOggVorbis音频格式类

RectanglePlacement矩形定位类

ZipFileZIP文件类

ApplicationProperties程序属性类

UnitTest单元测试类

WebBrowserComponent网页浏览器

DragAndDropTarget拖放目标类

FileChooser文件选择器

RelativeRectangle相对位置的矩形

ResizableCornerComponent可调整大小的角落组件

DirectoryContentsDisplayComponent显示目录内容的组件

ImageButton图像按钮类

EdgeTable边缘表类

MemoryOutputStream内存输出流

PreferencesPanel属性面板

ToolbarButton工具栏按钮类

Image::BitmapData图像::位图数据

TextButton文本按钮类

BubbleMessageComponent语泡消息组件

AudioPluginFormat音频插件格式类

StretchableLayoutResizerBar可重调大小的拉伸式分栏

AudioSource音频来源类

PropertyComponent属性组件类

AppleRemoteDevice苹果遥控设备类

PositionedGlyph字形定位类

AudioIODeviceType音频接口的类型

ResamplingAudioSource重采样来源类

DummyCriticalSection虚拟临界区域类

ChoicePropertyComponent选择属性组件

BufferedInputStream输入流缓冲类

AudioFormatManager音频格式管理器

ModalComponentManager模态组件管理器

FlacAudioFormatFLAC音频格式类

MidiMessageCollectorMIDI消息收集器

ThreadPoolJob线程池工作类

OpenGLContextOpenGL环境

AiffAudioFormatAIFF音频格式类

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

7//?f=2&t=6414

PluginListComponent插件列表组件类

ComponentListener组件捕获器类

AudioFormatReaderSource音频格式读取器来源类

MidiInputMIDI输入类

XmlDocumentXML文档类

Random随机类

TabBarButton标签栏按钮类

ImageFileFormat图像文件格式类

DrawablePath可绘制的轨迹类

HyperlinkButton超级链接按钮类

Typeface字型类

ImageConvolutionKernel图像卷积内核类

CPlusPlusCodeTokeniserC++代码分析器

FileDragAndDropTarget文件拖放目标类

DialogWindow对话框窗口类

BooleanPropertyComponent具有布尔属性的组件类

MixerAudioSource音频来源混缩类

ThreadWithProgressWindow线程进度窗类

DropShadower窗口阴影类

IIRFilterAudioSourceIIR滤波音频来源类

AudioSourcePlayer音频来源播放器

SliderPropertyComponent推子属性组件类

MemoryInputStream内存输入流

DynamicObject动态对象类

PathFlatteningIterator轨迹平整迭代器

Uuid全局唯一标识符类

GZIPDecompressorInputStreamGZIP解压缩输入流

SamplerVoice采样器声部类

TemporaryFile临时文件类

ActiveXControlComponentActiveX控件组件类

AudioDeviceSelectorComponent音频设备选择器组件

BufferingAudioSource缓冲音频来源

MD5类

ShapeButton形状按钮类

Value::ValueSource数值::数值来源类

CriticalSection临界区域类

TooltipWindow实时提示窗口类

Message消息类

JPEGImageFormatJPEG图像格式

FileLogger文件日志

ReadWriteLock读写锁定类

TextPropertyComponent文本属性组件类

MultiDocumentPanelWindow多文档面板窗

AudioIODeviceCallback音频进出设备回调类

SamplerSound采样声音类

ToggleButton开关式按钮类

Identifier标识符类

AudioPluginFormatManager音频插件格式管理器

ComponentMovementWatcher组件移动关注类

PluginDirectoryScanner扫描插件目录

ImageCache图像缓存类

AsyncUpdater异步更新类

ChangeBroadcaster可变生成器类

Path::Iterator轨迹::遍历器

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

8//?f=2&t=6414

AudioProcessorListener音频处理捕获器

AudioData音频数据类

PositionableAudioSource可定位的音频来源

DrawableRectangle::ValueTreeWrapper可绘制的矩形::值树封装类

ToolbarItemFactory工具栏项目工厂类

UnitTestRunner运行单元检测

NewLine换行符

NamedPipe已命名的管道

FileTreeComponent文件树组件

FileInputStream文件输入流

FileOutputStream文件输出流

MultiTimer多重计时器

RSAKeyRSA密钥类

DirectoryIterator目录迭代器

GZIPCompressorOutputStreamGZIP压缩输出流

AudioSubsectionReader音频分段读取器

PopupMenu::MenuItemIterator弹出式菜单::菜单项目遍历器

SubregionStream数据流子区域

MACAddressMAC地址类

CodeDocument::Iterator代码文档::遍历器

TypeOfCriticalSectionToUse临界区域所使用的类型

ScopedAutoReleasePool作用域自动释放池

ListenerList::DummyBailOutChecker捕获器列表::虚拟应急

检测器类

TimeSliceThread时间片线程

ImagePreviewComponent图像预览组件

Process进程类

UndoableAction可撤销的操作类

SystemTrayIconComponent系统托盘组件

NSViewComponentNS视图组件

RelativePointPath::ElementBase相对位置的点轨迹::元素基础

TableHeaderComponent::Listener表头组件::捕获器

MessageManagerLock消息管理器锁定

StringPool字符串池

TextInputTarget文本输入目标

ToneGeneratorAudioSource音调生成器音频来源

GIFImageFormatGIF图像格式类

MessageListener消息捕获器类

ComponentDragger组件拖拽器

SystemClipboard系统剪贴板

MidiBuffer::IteratorMIDI缓冲::遍历器

PNGImageFormatPNG图像格式

StretchableObjectResizer可拉伸对象的调整器

DrawablePath::ValueTreeWrapper可绘制的轨迹::值树封装

AudioPlayHead音频播放头类

Logger日志记录类

InterprocessConnectionServer进程连接服务器类

ButtonPropertyComponent按钮属性组件

GenericAudioProcessorEditor通用音频处理编辑器

FileFilter文件过滤器类

WaitableEvent可等待的事件

PerformanceCounter性能计数类

KeyboardFocusTraverser键盘焦点转换类

DropShadowEffect阴影效果类

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

9//?f=2&t=6414

ReferenceCountedObject引用计数对象

BlowFish加密类

ValueTree::Listener值树::捕获器类

MidiKeyboardStateListenerMIDI键盘状态捕获器

AudioFormatWriter::ThreadedWriter音频格式写入器::线程写入器

Drawable::ValueTreeWrapperBase可绘制::值树封装基础类

AudioThumbnailCache音频缩略图缓存

Slider::Listener推子::捕获器

RelativePointPath::CubicTo相对的点轨迹::三次方

TextEditor::Listener文本编辑器::捕获器

SynthesiserSound合成器声音类

ArrowButton箭头按钮类

ActionBroadcaster操作生成器

MidiInputCallbackMIDI输入回调类

RelativePointPath::QuadraticTo相对的点轨迹::二次方

FileInputSource文件输入源

KeyListener按键捕获器

Expression::EvaluationContext表达式::评估内容

AudioProcessorGraph::Node音频处理图示::节点

WildcardFileFilter文件通配符过滤器

PopupMenuCustomComponent弹出式菜单自定义组件

InputSource输入源

ScopedTryLock作用域尝试锁定

RelativePointPath::CloseSubPath相对的点轨迹::开始子轨迹

GlowEffect光晕效果类

RelativePointPath::LineTo相对的点轨迹::直线

CallbackMessage回调消息类

SettableTooltipClient可变实时提示类

AudioPluginInstance音频插件实例

WeakReference::Master弱引用::主指针类

AudioData::Converter音频数据::转换器

CodeTokeniser代码权标化类

FileBrowserListener文件浏览捕获器

InterProcessLock::ScopedLockType内部进程锁定::作用域锁定类型

Decibels分贝类

InterProcessLock内部进程锁定类

ApplicationCommandManagerListener程序命令管理器的捕获器

ToolbarItemPalette工具栏项目拖放板

MenuBarModel::Listener菜单栏模型::捕获器

ImageEffectFilter图像效果过滤器

ScopedUnlock作用域解锁类

RelativePointPath::CloseSubPath相对的点轨迹::封闭式子轨迹

Drawable::ImageProvider可绘制::图像供应类

FilePreviewComponent文件预览组件

ChangeListener可变捕获器

Component::BailOutChecker组件::跳出检测器

MidiMessageSequence::MidiEventHolderMIDI消息序列::MIDI事件保持者

ModalComponentManager::Callback模态组件管理器::回调

RectangleList::Iterator矩形列表::迭代器类

ScopedReadLock作用域读取锁定

ScrollBar::Listener滚动条::捕获器类

Value::Listener数值::捕获器类

AudioProcessorEditor音频处理编辑器类

CodeDocument::Listener代码文档::捕获器

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

10//?f=2&t=6414

ComboBox::Listener组合框::捕获器

DeletedAtShutdown关闭系统时销毁

ScopedLock作用域锁定类

ScopedWriteLock作用域写入锁定

TimeSliceClient时间片客户端

Primes基础数字类

WeakReference::SharedPointer弱引用::共享指针类

Label::Listener标签::捕获器

ScopedJuceInitialiser_NonGUIJUCE作用域初始化_非GUI类

MidiDataConcatenatorMIDI数据连接器

Expression::EvaluationError表达式::评估错误

ScopedJuceInitialiser_GUIJUCE作用域初始化_GUI类

Button::Listener按钮::捕获器

AudioCDBurner::BurnProgressListener音频CD刻录器::刻录进程捕获器

CameraDevice::Listener视频设备::捕获器

TooltipClient实时提示客户端

FilenameComponentListener文件名组件捕获器

FocusChangeListener焦点改变捕获器

ActionListener操作捕获器

String::Concatenator字符串::连接器

ThreadPool::JobSelector线程池::工作选择器

ScopedXLock作用域X锁定类

Graphics::ScopedSaveState图形::作用域保存状态

Expression::ParseError表达式::解析错误

Classtemplate（类模板）按大小排序（从大到小）

Rectangle矩形类模板

Array数组类模板

OwnedArray自有数组类模板

ReferenceCountedArray引用计数数组类模

板

Line直线类模板

SortedSet排序集合类模板

Point点模板

ListenerList捕获器链表类模板

Range范围类模板

AudioData::Pointer音频数

据指针类模板

SelectedItemSet项目选择类模板

HeapBlock堆内存类模板

LassoComponent套索组件类模板

ArrayAllocationBase数组分配基础类模板

Atomic原子类模板

SparseSet稀有集合类模板

ScopedPointer作用域指针类模板

WeakReference弱引用类模板

Component::SafePointer组件::安全指针类模板

ReferenceCountedObjectPtr对象指针引用计数类模板

AudioData::ConverterInstance音频数据::转换实

例类模板

TypeHelpers::ParameterType类型辅助::参数类型类模板

ListenerList::Iterator

捕获器列表::迭代器类模板

12-12-26

/?f=2&t=6414

LassoSource套索来源类模板

AudioFormatReader::ReadHelper

>音频格式读取器::辅助读取结构体模板

AudioFormatWriter::WriteHelper

音频格式写入器::写入辅助结构体模板

DefaultElementComparator默认的元素比较类模板

LeakedObjectDetector对象泄露检测器类模板

Struct（结构体）按大小排序（从大到小）

ApplicationCommandInfo程序命令信息

AudioDeviceManager::AudioDeviceSetup设置音频设备

AudioPlayHead::CurrentPositionInfo音频播放头::当前位置信息

ApplicationCommandTarget::InvocationInfo程序命令目标::调用信息

RelativeCoordinate::Strings相对坐标::字符串

DummyCriticalSection::ScopedLockType虚拟临界区域::作用域锁定类型

DirectoryContentsList::FileInfo目录内容列表::文件信息

AudioProcessorGraph::Connection音频处理图示::连接

UnitTestRunner::TestResult运行单元检测::检测结果

LowLevelGraphicsPostScriptRenderer::SavedState低级图像张贴脚本渲染器::保存状态

AudioSourceChannelInfo音频来源通道信息

DrawableComposite::Marker可绘制的复合组件::标记

AudioIODeviceType::DeviceSetupDetails音频设备类型::设备设置细节

ZipFile::ZipEntryZIP文件::ZIP记录结构体

MidiOutput::PendingMessageMIDI输出::待定的消息结构体

Other（其它）

类简介

头文件

ARGB颜色名称与代码

数学计算方面的宏、类型重定义、函数、变量

内存分配方面的宏定义和函数

JUCE类库初始化方面的函数

杂七杂八的宏定义

...

Corrigendum（勘误）

勘误1（2011.01.08）

勘误2（2011.01.28）

勘误3（2011.02.05）

...

Addendum（补遗）

补遗1（2011.01.10）

...

LasteditedbySwingCoderonSunFeb06,20119:20pm,edited461timesintotal.

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

12-12-26

12//?f=2&t=6414

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion

bySwingCoder»WedJan05,20114:35am

Component组件类

所有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,andWebBrowserComponent.

所有成员

类

classBailOutChecker

该类密切注视一个或两个组件，在组件被销毁时进行检验。更多...

classSafePointer

保存某些组件类型的指针，当该组件被销毁时自动将其置零。更多...

Public类型

enumFocusChangeType{focusChangedByMouseClick,focusChangedByTabKey,

focusChangedDirectly}

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

更多...

LasteditedbySwingCoderonFriJan14,201111:33pm,edited2timesintotal.

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion

bySwingCoder»WedJan05,20114:36am

public成员函数

Component()

创建一个组件。

virtualActionListener::~ActionListener~Component()

析构函数。

Component(constString&componentName)

创建一个组件，同时设置其名称。

constString&getName()constthrow()

返回此组件的名称。

virtualvoidsetName(constString&newName)

设置此组件的名称。

virtualvoidsetVisible(boolshouldBeVisible)

设置此组件可见与否。

boolisVisible()constthrow()

检测该组件是否可见。

virtualvoidvisibilityChanged()

组件可见与否发生变化时，自动调用此函数。

boolisShowing()const

检测该组件和它的所有上级组件是否可视。

virtualvoidaddToDesktop(intwindowStyleFlags,void*nativeWindowToAttachTo=0)

使该组件显示为一个桌面窗口。

voidremoveFromDesktop()

如果该组件正显示在桌面上，此函数将隐藏它。

boolisOnDesktop()constthrow()

如果该组件当前显示在桌面上，则返回true。

ComponentPeer*getPeer()const

返回包含该组件的重量级窗口。

virtualvoiduserTriedToCloseWindow()

组件位于桌面的前提下，当操作系统要关闭该窗口时，将自动调用此函数。

virtualvoidminimisationStateChanged(boolisNowMinimised)

桌面组件最小化或取消最小化时，自动调用此函数。

voidtoFront(boolshouldAlsoGainFocus)

将该组件置于同级组件的最前面。

voidtoBack()

将该组件置于同级组件的最后面（改变Z-顺序）。

voidtoBehind(Component*other)

将该组件置于参数组件的后面（改变Z-顺序）。

voidsetAlwaysOnTop(boolshouldStayOnTop)

设置该组件是否始终位于同级组件的最前面。

boolisAlwaysOnTop()constthrow()

如果该组件已设置为始终位于同级组件的最前面，则返回true。

intgetX()constthrow()

返回该组件的左边缘x坐标。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

14//?f=2&t=6414

intgetY()constthrow()

返回该组件顶边缘的y坐标。

intgetWidth()constthrow()

返回组件的宽度（单位：像素）。

intgetHeight()constthrow()

返回组件的高度（单位：像素）。

intgetRight()constthrow()

返回该组件右边缘的x坐标。

constPointgetPosition()constthrow()

返回该组件的左上角位置。返回类型为Point。

intgetBottom()constthrow()

返回该组件底边缘的y坐标。

constRectangle&getBounds()constthrow()

返回此组件的边框。

constRectanglegetLocalBounds()constthrow()

返回组件的边界，相对于其自身的原点。

constRectanglegetBoundsInParent()constthrow()

返回此组件所覆盖的父级组件的区域。

voidgetVisibleArea(RectangleList&result,boolincludeSiblings)const

返回此组件未被其它组件所遮盖的、且不透明的区域。

intgetScreenX()const

返回此组件相对于屏幕原点的X坐标。

intgetScreenY()const

返回此组件相对于屏幕原点的Y坐标。

constPointgetScreenPosition()const

返回此组件的左上角相对于屏幕左上角的位置。

constRectanglegetScreenBounds()const

返回此组件相对于屏幕左上角的边界。

constPointgetLocalPoint(constComponent*sourceComponent,constPoint<

int>&pointRelativeToSourceComponent)const

根据此组件的坐标空间转换一个坐标值（Point）。

constRectanglegetLocalArea(constComponent*sourceComponent,const

Rectangle&areaRelativeToSourceComponent)const

根据此组件的坐标空间转换一个矩形区域。

constPointlocalPointToGlobal(constPoint&localPoint)const

将此组件的原点转换为屏幕坐标。

constRectanglelocalAreaToGlobal(constRectangle&localArea)const

将此组件的矩形空间转换为屏幕坐标

voidsetTopLeftPosition(intx,inty)

将此组件移动到新的位置。

voidsetTopRightPosition(intx,inty)

将此组件移动到新的位置。

voidsetSize(intnewWidth,intnewHeight)

更改组件的大小。

voidsetBounds(intx,inty,intwidth,intheight)

改变组件的位置和大小。

voidsetBounds(constRectangle&newBounds)

改变组件的位置和大小。

voidsetBoundsRelative(floatproportionalX,floatproportionalY,float

proportionalWidth,floatproportionalHeight)

根据父级组件的大小和区域更改此组件的位置和大小。

voidsetBoundsInset(constBorderSize&borders)

基于四周的空间更改此组件的位置和大小。

voidsetBoundsToFit(intx,inty,intwidth,intheight,constJustification

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

15//?f=2&t=6414

&justification,boolonlyReduceInSize)

按给定的区域定位此组件，宽高比不变。

voidsetCentrePosition(intx,inty)

更改此组件的中心位置。

voidsetCentreRelative(floatx,floaty)

更改此组件的中心位置。

voidcentreWithSize(intwidth,intheight)

更改此组件的大小，并位于父级组件的中心。

voidsetTransform(constAffineTransform&transform)

设置此组件的变换矩阵（缩放、旋转等等）。

constAffineTransformgetTransform()const

返回此组件当前所设置的变换矩阵（缩放，旋转等等）。

boolisTransformed()constthrow()

如果此组件当前应用了缩放、旋转等转换，则返回true。

intproportionOfWidth(floatproportion)constthrow()

返回此组件的宽度比例。

intproportionOfHeight(floatproportion)constthrow()

返回此组件的高度比例。

intgetParentWidth()constthrow()

返回此组件的父级组件的宽度。

intgetParentHeight()constthrow()

返回此组件的父级组件的高度。

constRectanglegetParentMonitorArea()const

返回包含此组件的显示器的屏幕坐标系。

intgetNumChildComponents()constthrow()

返回此组件包含的子组件的个数。

Component*getChildComponent(intindex)constthrow()

按索引值返回该组件所包含的某个子组件。

intgetIndexOfChildComponent(constComponent*child)constthrow()

返回此组件所包含的某个子组件的索引值。

voidaddChildComponent(Component*child,intzOrder=-1)

此组件添加一个子组件。

voidaddAndMakeVisible(Component*child,intzOrder=-1)

此组件添加一个子组件，如果子组件当前不可见，则使之可见。

voidremoveChildComponent(Component*childToRemove)

移除此组件所包含的某个子组件。

Component*removeChildComponent(intchildIndexToRemove)

按索引值移除该组件所包含的某个子组件。

voidremoveAllChildren()

移除该组件所包含的所有子组件。

voiddeleteAllChildren()

移除该组件所包含的所有子组件，并销毁它们。

Component*getParentComponent()constthrow()

返回此组件的父级组件。

template

TargetClass*findParentComponentOfClass(TargetClass*constdummyParameter=0)

const

按给定的类搜索父级组件。

Component*getTopLevelComponent()constthrow()

返回包含该组件及其父级组件的最顶级组件。

boolisParentOf(constComponent*possibleChild)constthrow()

检测该组件是否为给定组件的父级组件。

virtualvoidparentHierarchyChanged()

当此组件改变所隶属的父级组件时，自动调用此函数。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

16//?f=2&t=6414

virtualvoidchildrenChanged()

当此组件添加或移除子组件时，自动调用此函数。

virtualboolhitTest(intx,inty)

检测给定的点是否位于此组件内。

voidsetInterceptsMouseClicks(boolallowClicksOnThisComponent,bool

allowClicksOnChildComponents)throw()

改变hitTest()方法的参数，设置拦截鼠标点击事件。

voidgetInterceptsMouseClicks(bool&allowsClicksOnThisComponent,bool

&allowsClicksOnChildComponents)constthrow()

获取鼠标点击拦截标记的当前状态。

boolcontains(constPoint&localPoint)

如果给定的坐标点位于此组件或它的子组件之内，则返回true。

boolreallyContains(constPoint&localPoint,bool

returnTrueIfWithinAChild)

如果给定的点位于此组件之内则返回true，同时考虑到任何重叠的同级组件。

Component*getComponentAt(intx,inty)

返回给定的点所位于的组件。

Component*getComponentAt(constPoint&position)

返回给定的点所位于的组件。

voidrepaint()

标记整个组件需要重绘。

voidrepaint(intx,inty,intwidth,intheight)

标记组件的某个区域需要重绘。

voidrepaint(constRectangle&area)

标记组件的某个区域需要重绘。

voidsetBufferedToImage(boolshouldBeBuffered)

设置该组件使用内部缓冲来优化重绘操作。

constImagecreateComponentSnapshot(constRectangle&areaToGrab,bool

clipImageToComponentBounds=true)

生成此组件某个区域的屏幕快照。

voidpaintEntireComponent(Graphics&context,boolignoreAlphaLevel)

用给定的绘图环境重绘此组件及其所有的子组件。

voidsetPaintingIsUnclipped(boolshouldPaintWithoutClipping)throw()

此方法允许表明此组件在重绘时无需剪切图形环境。

voidsetComponentEffect(ImageEffectFilter*newEffect)

设置组件的外观。

ImageEffectFilter*getComponentEffect()constthrow()

返回此组件当前所设置的外观效果。

LookAndFeel&getLookAndFeel()constthrow()

获取该组件所使用的外观及感觉（look-and-feel）。

voidsetLookAndFeel(LookAndFeel*newLookAndFeel)

设置此组件的外观与感觉（Look-and-Feel）。

virtualvoidlookAndFeelChanged()

当该组件所使用的外观与感觉发生变化时，自动调用此函数。

voidsendLookAndFeelChange()

设置此组件和它的所有子组件调用lookAndFeelChanged()方法。

voidsetOpaque(boolshouldBeOpaque)

设置不透明。

boolisOpaque()constthrow()

如果此组件为不透明的（无任何透明的区域），则返回true。

voidsetBroughtToFrontOnMouseClick(boolshouldBeBroughtToFront)throw()

设置当鼠标点击时，此组件是否自动切换到最前面。

boolisBroughtToFrontOnMouseClick()constthrow()

如果鼠标点击时此组件自动切换到最前面，则返回true。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

17/85

voidsetWantsKeyboardFocus(boolwantsFocus)throw()

设置一个标志，以表明此组件是否需要键盘焦点。

boolgetWantsKeyboardFocus()constthrow()

如果此组件对键盘焦点感兴趣，则返回true。

voidsetMouseClickGrabsKeyboardFocus(boolshouldGrabFocus)

设置点击此组件时是否拥有键盘焦点。

boolgetMouseClickGrabsKeyboardFocus()constthrow()

返回setMouseClickGrabsKeyboardFocus()所设置的值。

voidgrabKeyboardFocus()

试图使此组件拥有键盘焦点。

boolhasKeyboardFocus(booltrueIfChildIsFocused)const

如果此组件当前拥有键盘焦点则返回true。

voidmoveKeyboardFocusToSibling(boolmoveToNext)

尝试将键盘焦点转移给下一个同级组件。

virtualKeyboardFocusTraverser*createFocusTraverser()

创建一个KeyboardFocusTraverser对象以确定此组件传递焦点的逻辑。

intgetExplicitFocusOrder()const

返回此组件的焦点顺序，如果已指定。

voidsetExplicitFocusOrder(intnewFocusOrderIndex)

按索引值设置焦点转移的顺序。

voidsetFocusContainer(boolshouldBeFocusContainer)throw()

设置此组件是否为焦点容器。

boolisFocusContainer()constthrow()

如果此组件为焦点容器，则返回true。

boolisEnabled()constthrow()

如果此组件及其所有的子组件为开启状态，则返回true。

voidsetEnabled(boolshouldBeEnabled)

启用或禁用此组件。

virtualvoidenablementChanged()

启用或禁用此组件时自动调用此函数。

voidsetAlpha(floatnewAlpha)

更改此组件的透明度。

floatgetAlpha()const

返回此组件当前所设置的透明度。

voidsetMouseCursor(constMouseCursor&cursorType)

设置鼠标指针的外观（当鼠标指向该组件时）。

virtualconstMouseCursorgetMouseCursor()

获取当前设置的鼠标指针外观（当鼠标指向该组件时）。

voidupdateMouseCursor()const

强制刷新当前的鼠标指针。

virtualvoidpaint(Graphics&g)

重写此方法以绘制此组件的内容。

virtualvoidpaintOverChildren(Graphics&g)

可重写此方法以绘制位于最前面的子组件。

virtualvoidmouseMove(constMouseEvent&e)

当鼠标在此组件中移动时，自动调用此函数。

virtualvoidmouseEnter(constMouseEvent&e)

当鼠标指针进入此组件时，自动调用此函数。

virtualvoidmouseExit(constMouseEvent&e)

当鼠标指针退出此组件时，自动调用此函数。

virtualvoidmouseDown(constMouseEvent&e)

当鼠标指针位于此组件并且点击某个鼠标键，尚未释放时，自动调用此函数。

virtualvoidmouseDrag(constMouseEvent&e)

当鼠标拖拽时，自动调用此函数。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

18//?f=2&t=6414

virtualvoidmouseUp(constMouseEvent&e)

鼠标点击并释放某个鼠标按键时自动调用此函数。

virtualvoidmouseDoubleClick(constMouseEvent&e)

鼠标在此组件中双击时自动调用此函数。

virtualvoidmouseWheelMove(constMouseEvent&e,floatwheelIncrementX,float

wheelIncrementY)

转动鼠标滚轮键时自动调用此函数。

voidsetRepaintsOnMouseActivity(boolshouldRepaint)throw()

鼠标指针进入或退出此组件时，自动重绘。

voidaddMouseListener(MouseListener*newListener,bool

wantsEventsForAllNestedChildComponents)

绑定鼠标事件捕获器。

voidremoveMouseListener(MouseListener*listenerToRemove)

移除已经绑定的鼠标事件捕获器。

voidaddKeyListener(KeyListener*newListener)

添加此组件能够接收的按键事件捕获器。

voidremoveKeyListener(KeyListener*listenerToRemove)

移除已经绑定的按键捕获器。

virtualboolkeyPressed(constKeyPress&key)

当按下某个键时，自动调用此函数。

virtualboolkeyStateChanged(boolisKeyDown)

当按下或释放某个键时自动调用此函数。

virtualvoidmodifierKeysChanged(constModifierKeys&modifiers)

按下或释放某个功能键时自动调用此函数。

virtualvoidfocusGained(FocusChangeTypecause)

此组件拥有键盘焦点时自动此函数。

virtualvoidfocusLost(FocusChangeTypecause)

此组件失去键盘焦点时自动此函数。

virtualvoidfocusOfChildComponentChanged(FocusChangeTypecause)

此组件的子组件拥有或失去键盘焦点时自动调用此函数。

boolisMouseOver(boolincludeChildren=false)const

如果鼠标指针位于此组件则返回true。

boolisMouseButtonDown()constthrow()

如果正按下鼠标的某个键，则返回true。

boolisMouseOverOrDragging()constthrow()

如果鼠标指针位于此组件，或者正在此组件中拖拽，则返回true。

constPointgetMouseXYRelative()const

返回鼠标指针的当前位置，相对于此组件的原点。

virtualvoidresized()

此组件的大小发生变化时自动调用此函数。

virtualvoidmoved()

此组件的位置发生变化时自动调用此函数。

virtualvoidchildBoundsChanged(Component*child)

当此组件的某个子组件的大小和位置发生变化时，自动调用此函数。

virtualvoidparentSizeChanged()

当此组件的上一级父组件的大小发生变化时，自动调用此函数。

virtualvoidbroughtToFront()

当此组件位于其同级组件的最前面时，自动调用此函数。

voidaddComponentListener(ComponentListener*newListener)

添加一个捕获器以告知组件的隶属关系或位置发生变化。

voidremoveComponentListener(ComponentListener*listenerToRemove)

移除已经添加的组件捕获器。

voidpostCommandMessage(intcommandId)

将某个消息发送给此组件。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

19//?f=2&t=6414

virtualvoidhandleCommandMessage(intcommandId)

处理postCommandMessage()发送过来的消息。

intrunModalLoop()

进入模态（无限循环、自动置顶状态），直到循环终止。

voidenterModalState(booltakeKeyboardFocus=true,ModalComponentManager::Callback

*callback=0)

使此组件进入模态。

voidexitModalState(intreturnValue)

结束模态。

boolisCurrentlyModal()constthrow()

如果此组件当前为模态则返回true。

boolisCurrentlyBlockedByAnotherModalComponent()const

检测是否正有一个模态组件阻碍了此组件接收消息。

virtualboolcanModalEventBeSentToComponent(constComponent*targetComponent)

当组件为模态时，此函数允许给定组件依然可以接收消息。

virtualvoidinputAttemptWhenModal()

在当前正有一个模态组件的前提下，如果尝试点击此组件，则自动调用此函数。

NamedValueSet&getProperties()throw()

获取此组件的属性设置。

constNamedValueSet&getProperties()constthrow()

获取此组件的属性设置。

constColourfindColour(intcolourId,boolinheritFromParent=false)const

查找已经注册使用的某个颜色。

voidsetColour(intcolourId,constColour&colour)

注册一个要使用的颜色。

voidremoveColour(intcolourId)

如果某个颜色是setColour()所设置的，则移除之。

boolisColourSpecified(intcolourId)const

如果给定的颜色由setColour()所设置，则返回true。

voidcopyAllExplicitColoursTo(Component&target)const

将此组件已经注册的颜色复制给其它组件。

virtualvoidcolourChanged()

当setColour()函数改变某个颜色时，自动调用此函数。

void*getWindowHandle()const

返回此组件潜在的本地窗口句柄。

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion

bySwingCoder»WedJan05,20114:39am

静态Public成员函数

staticComponent*JUCE_CALLTYPEgetCurrentlyFocusedComponent()throw()

返回当前拥有键盘焦点的某个组件。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

20//?f=2&t=6414

staticvoidbeginDragAutoRepeat(intmillisecondsBetweenCallbacks)

确保鼠标拖拽时所产生的事件数据流无停滞。

staticboolJUCE_CALLTYPEisMouseButtonDownAnywhere()throw()

如果正按下鼠标的某个键，则返回true。

staticintJUCE_CALLTYPEgetNumCurrentlyModalComponents()throw()

返回当前处于模态的组件个数。

staticComponent*JUCE_CALLTYPEgetCurrentlyModalComponent(intindex=0)throw()

返回当前处于模态的组件。

详细说明

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

枚举成员文档

enumComponent::FocusChangeType

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

枚举常量：

focusChangedByMouseClick

鼠标点击以改变焦点。

focusChangedByTabKey

按TAB键转移焦点。

focusChangedDirectly

使用grabKeyboardFocus()改变焦点。

构造函数和析构函数文档

Component::Component()

创建一个组件。

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

将其添加到父级组件中，或者使用addToDesktop()方法使之成为桌面窗口。

设置其大小和位置。

使用setVisible()方法使之可见。

要明确其具有某种使用目的，往往需要派生该类的子类，或者使用JUCE类库中已经定义的该类

的派生类（标签、按钮、组合框等等）。

virtualComponent::~Component()[virtual]

析构函数。

注意，当销毁某个组件时，它包含的所有子组件不会自动销毁。可使用delete()、

deleteAndZero()、deleteAllChildren()等方法或ScopedPointers来管理其子组件。

如果所要销毁的组件是其它组件的子组件，那么在销毁期间，其父级组件将自动移除之，并且

父级组件将自动调用childrenChanged()函数。此组件已经注册的所有ComponentListener对象

也将自动调用ComponentListener::componentBeingDeleted()方法。

Component::Component(constString&messagecomponentName)[explicit]

创建一个组件，同时设置其名称。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

21//?f=2&t=6414

参见：

getName,setName

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion

bySwingCoder»WedJan05,20114:41am

成员函数文档

constString&Component::getName()constthrow()

返回此组件的名称。

参见：

setName

virtualvoidComponent::setName(constString&messagenewName)[virtual]

设置此组件的名称。

改变组件名称时，所有已经注册的ComponentListeners将自动收到一条

ComponentListener::componentNameChanged()函数所产生的消息。

参见：

getName()

该类重写此函数：DocumentWindow

virtualvoidComponent::setVisible(boolshouldBeVisible)[virtual]

设置此组件可见与否。

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

组件不可见，那么无论如何，该组件均不可见。

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

componentVisibilityChanged()方法。

参数：

shouldBeVisible是否显示此组件。

参见：

isVisible,isShowing,visibilityChanged,

ComponentListener::componentVisibilityChanged

以下函数中引用了此函数：LassoComponent::dragLasso(),

LassoComponent::endLasso()

boolComponent::isVisible()constthrow()

检测该组件是否可见。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

22//?f=2&t=6414

注意：JUCE组件的可见和可视是两个概念。可见并不一定出现在屏幕上。而可视则是实际出现

在屏幕上，能够看到该组件。而且，组件是否可见，还取决于其父级组件当前是否已设置为可

见。可使用isShowing()方法来确定该组件当前是否可视。

参见：

isShowing,setVisible

virtualvoidComponent::visibilityChanged()[virtual]

组件可见与否发生变化时，自动调用此函数。

参见：

setVisible,isVisible

该类重写此函数：Button,ListBox,ProgressBar,WebBrowserComponent,

ResizableWindow,TopLevelWindow

boolComponent::isShowing()const

检测该组件和它的所有上级组件是否可视。

返回:

仅在此组件及其所有的父级组件均为可见状态时，才返回true。

参见：

isVisible

以下函数中引用了此函数：CarbonViewWrapperComponent::componentVisibilityChanged()

virtualvoidComponent::addToDesktop(intwindowStyleFlags,

void*nativeWindowToAttachTo=0

)[virtual]

使该组件显示为一个桌面窗口。

注意，调用此函数要确保该组件已设置为不透明的（使用setOpaque()方法）。如果组件是透

明的，或者半透明的，则操作系统的窗口机制将尝试创建一个特殊的透明区域，此举将消耗大

量的CPU和内存，并且在某些平台下，可能无法实现透明效果，或者运行出错。

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

桌面上的某个组件置于其它组件中，则首先从桌面上移除之。

参数：

windowStyleFlagsComponentPeer::StyleFlags枚举常量，用于指定窗口的各项属性。

nativeWindowToAttachTo允许传递一个操作系统的本地窗口，以用来放置此组件。Windows系

统下，此参数为一个窗口句柄HWND，MAC系统下为一个HIViewRef。此参数不一定支持所有的操

作系统，在不确定将出现什么结果时，最好采用默认的参数0。

参见：

removeFromDesktop,isOnDesktop,userTriedToCloseWindow,getPeer,

ComponentPeer::setMinimised,ComponentPeer::StyleFlags,

ComponentPeer::getStyleFlags,ComponentPeer::setFullScreen

该类重写此函数：TopLevelWindow

voidComponent::removeFromDesktop()

如果该组件正显示在桌面上，此函数将隐藏它。

也可使用setVisible()临时性的隐藏桌面窗口，但setVisible()不会释放所占用的系统资源。

因此，若隐藏的同时打算一并释放所占用的系统资源，则建议使用本函数。

参见：

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

23//?f=2&t=6414

addToDesktop,isOnDesktop

boolComponent::isOnDesktop()constthrow()

如果该组件当前显示在桌面上，则返回true。

参见：

addToDesktop,removeFromDesktop

以下函数中引用了此函数：TopLevelWindow::isUsingNativeTitleBar()

ComponentPeer*Component::getPeer()const

返回包含该组件的重量级窗口。

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

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

参见：

addToDesktop,isOnDesktop

virtualvoidComponent::userTriedToCloseWindow()[virtual]

组件位于桌面的前提下，当操作系统要关闭该窗口时，将自动调用此函数。

此函数将发出关闭窗口的信号，无论是用户点击关闭按钮，还是操作系统强行关闭窗口。默认

情况下，触发断言命令以提示该组件将发生某些事情，但可以重写此函数以忽略此命令。

重写此函数的类：AlertWindow,DocumentWindow

virtualvoidComponent::minimisationStateChanged(boolisNowMinimised)[virtual]

桌面组件最小化或取消最小化时，自动调用此函数。

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

参见：

getPeer,ComponentPeer::setMinimised,ComponentPeer::isMinimised

voidComponent::toFront(boolshouldAlsoGainFocus)

将该组件置于同级组件的最前面。

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

面，除非该组件也设置了“始终置顶”。

参数：

shouldAlsoGainFocus如果设置为true，将尝试为该组件分配键盘焦点。参见：

grabKeyboardFocus()。

参见：

toBack,toBehind,setAlwaysOnTop

引用：CarbonViewWrapperComponent：：carbonEventHandler（）。

voidComponent::toBack()

将该组件置于同级组件的最后面（改变Z-顺序）。

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

参见：

toFront,toBehind,setAlwaysOnTop

voidComponent::toBehind(Component*other)

将该组件置于参数组件的后面（改变Z-顺序）。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

24//?f=2&t=6414

参见：

toFront,toBack

voidComponent::setAlwaysOnTop(boolshouldStayOnTop)

设置该组件是否始终位于同级组件的最前面。

参见：

isAlwaysOnTop

boolComponent::isAlwaysOnTop()constthrow()

如果该组件已设置为始终位于同级组件的最前面，则返回true

参见：

setAlwaysOnTop

intComponent::getX()constthrow()

返回该组件的左边缘x坐标。

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

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不

再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

intComponent::getY()constthrow()

返回该组件顶边缘的y坐标。

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

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不

再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

intComponent::getWidth()constthrow()

返回组件的宽度（单位：像素）。

引用：CarbonViewWrapperComponent::createWindow(),LassoComponent<

SelectableItemType>::paint(),

CarbonViewWrapperComponent::setEmbeddedWindowToOurSize(),

CarbonViewWrapperComponent::setOurSizeToEmbeddedViewSize()

intComponent::getHeight()constthrow()

返回组件的高度（单位：像素）。

引用：CarbonViewWrapperComponent::createWindow(),LassoComponent<

SelectableItemType>::paint(),

CarbonViewWrapperComponent::setEmbeddedWindowToOurSize(),

CarbonViewWrapperComponent::setOurSizeToEmbeddedViewSize()

intComponent::getRight()constthrow()

返回该组件右边缘的x坐标。

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

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不

再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

constPointComponent::getPosition()constthrow()

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

25//?f=2&t=6414

返回该组件的左上角位置。返回类型为Point。

intComponent::getBottom()constthrow()

返回该组件底边缘的y坐标。

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

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不

再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

constRectangle&Component::getBounds()constthrow()

返回此组件的边界。

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

注意：如果使用了setTransform()进行缩放、旋转等“无损”变换，那么此组件的边界将不

再直接反映出它相对于父级组件的位置，无损变换将应用到此组件的边框。

引用：LassoComponent::dragLasso().

constRectangleComponent::getLocalBounds()constthrow()

返回组件的边界，相对于其自身的原点。

此函数类似于getBounds()，所不同的，参照的坐标系原点为该组件自身的左上原点，即矩形

返回值的起点坐标为(0,0)。这两个函数返回的宽度和高度一样，均为组件自身的宽度和高

度。

constRectangleComponent::getBoundsInParent()constthrow()

返回此组件所覆盖的父级组件的区域。

返回值为相对于父级组件坐标空间的区域。如果此组件使用了无损变换（仿射变换），则返回

的值为完整涵盖变换后的边框的最小区域。如果此组件没有父级组件，则与getBounds()函数

返回的值相同。

voidComponent::getVisibleArea(RectangleList&result,

boolincludeSiblings

)const

返回此组件未被其它组件所遮盖的、且不透明的区域。

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

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

intComponent::getScreenX()const

返回此组件相对于屏幕原点的X坐标。

参见：

getX,localPointToGlobal

引用：CarbonViewWrapperComponent::createWindow(),和

CarbonViewWrapperComponent::setEmbeddedWindowToOurSize().

intComponent::getScreenY()const

返回此组件相对于屏幕原点的Y坐标。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

26//?f=2&t=6414

参见：

getY,localPointToGlobal

引用：CarbonViewWrapperComponent::createWindow(),

CarbonViewWrapperComponent::setEmbeddedWindowToOurSize().

constPointComponent::getScreenPosition()const

返回此组件的左上角相对于屏幕左上角的位置。

参见：

getScreenBounds

constRectangleComponent::getScreenBounds()const

返回此组件相对于屏幕左上角的边界。

参见：

getScreenPosition

constPointComponent::getLocalPoint(constComponent*sourceComponent,

constPoint&pointRelativeToSourceComponent

)const

根据此组件的坐标空间转换一个坐标值（Point）。

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

null，则参数点为全局性的屏幕坐标。

constRectangleComponent::getLocalArea(constComponent*sourceComponent,

constRectangle&areaRelativeToSourceComponent

)const

根据此组件的坐标空间转换一个矩形区域。

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

null，则矩形参数为屏幕坐标。

如果已使用setTransform()方法进行了缩放、旋转等无损变换，那么源矩形可能无法转换为

实际的目标空间，这种情况下将返回完整包含整个变换区域的最小矩形。

constPointComponent::localPointToGlobal(constPoint&localPoint)

const

将此组件的原点转换为屏幕坐标。

参见：

getLocalPoint,localAreaToGlobal

constRectangleComponent::localAreaToGlobal(constRectangle&

localArea)const

将此组件的矩形空间转换为屏幕坐标

如果已使用setTransform()方法进行了缩放、旋转等无损变换，那么源矩形可能无法转换为

实际的目标空间，这种情况下将返回完整包含整个变换区域的最小矩形。

参见：

getLocalPoint,localPointToGlobal

voidComponent::setTopLeftPosition(intx

inty

)

将此组件移动到新的位置。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

27//?f=2&t=6414

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

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

注意，如果已使用setTransform()方法进行了无损变换，则此组件的边界将不再直接反映出它

相对于父级组件的位置，无损变换将应用到此组件所设置的边界。

参见：

setBounds,ComponentListener::componentMovedOrResized

voidComponent::setTopRightPosition(intx

inty

)

将此组件移动到新的位置。

改变组件右上角的位置（不改变其大小）。该位置相对于此组件的父级组件的左上原点。

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

注意，如果已使用setTransform()方法进行了无损变换，则此组件的边界将不再直接反映出它

相对于父级组件的位置，无损变换将应用到此组件所设置的边界。

voidComponent::setSize(intnewWidth,

intnewHeight

)

更改组件的大小。

更改组件大小后将同步调用resized()函数。

注意，如果已使用setTransform()方法进行了无损变换，则此组件的边界将不再直接反映出它

相对于父级组件的位置，无损变换将应用到此组件所设置的边界。

引用：LassoComponent::beginLasso(),and

CarbonViewWrapperComponent::setOurSizeToEmbeddedViewSize().

voidComponent::setBounds(intx

inty

intwidth

intheight

)

改变组件的位置和大小。

x、y为相对于此组件父级组件左上原点的坐标值，如果此组件为桌面窗口，则起点坐标相对于

屏幕的左上原点。

改变组件的起点坐标，将同步调用moved()函数。改变其大小，则同步调用resized()函数。

注意，如果已使用setTransform()方法进行了无损变换，则此组件的边界将不再直接反映出它

相对于父级组件的位置，无损变换将应用到此组件所设置的边界。

参见：

setTopLeftPosition,setSize,ComponentListener::componentMovedOrResized

引用：LassoComponent::dragLasso().

Windows7X64,VS2010,LatestJUCEtip

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

28//?f=2&t=6414

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion

bySwingCoder»WedJan05,20114:43am

voidComponent::setBounds(constRectangle&newBounds)

改变组件的位置和大小。

x、y为相对于此组件父级组件左上原点的坐标值，如果此组件为桌面窗口，则起点坐标相对于

屏幕的左上原点。

改变组件的起点坐标，将同步调用moved()函数。改变其大小，则同步调用resized()函数。

注意，如果已使用setTransform()方法进行了无损变换，则此组件的边界将不再直接反映出它

相对于父级组件的位置，无损变换将应用到此组件所设置的边界。

参见：

setBounds

voidComponent::setBoundsRelative(floatproportionalX,

floatproportionalY,

floatproportionalWidth,

floatproportionalHeight

)

根据父级组件的大小和区域更改此组件的位置和大小。

参数值为父级组件的比例，比如：setBoundsRelative(0.2f,0.2f,0.5f,0.5f)将设置为父

级组件的一半宽度和一半高度，左上起点则是父级组件宽度和高度20%的位置。

参见：

setBounds

voidComponent::setBoundsInset(constBorderSize&borders)

基于四周的空间更改此组件的位置和大小。

此函数通过指定该组件四个边界距离其父级组件四个边界的距离来定位该组件。

参见：

setBounds

voidComponent::setBoundsToFit(intx

inty

intwidth

intheight

constJustification&justification,

boolonlyReduceInSize

)

按给定的区域定位此组件，宽高比不变。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

29//?f=2&t=6414

如果onlyReduceInSize为false，此组件将重新调整大小以匹配给定的区域，同时，不改变其

原始宽高比。此函数不适用于大小为0的组件。如果onlyReduceInSize为true，且此组件大于

给定区域时，将仅对大于部分做减小处理，这样一来，将改变此组件的原始宽高比。

justification用来设置该组件在给定区域中的定位方式（居中、靠左、靠右）等等。

参见：

setBounds

voidComponent::setCentrePosition(intx

inty

)

更改此组件的中心位置。

不改变组件的大小，改变其位置。使该组件的中心点位于父级组件的某个坐标点处。

参见：

setBounds

voidComponent::setCentreRelative(floatx

floaty

)

更改此组件的中心位置。

不改变组件的大小，使该组件的中心点位于父级组件的某个位置处。比如：

setCentreRelative(0.5f,0.5f)将使该组件在其父级组件内自动居中。

voidComponent::centreWithSize(intwidth

intheight

)

更改此组件的大小，并位于父级组件的中心。

改变大小之后，自动移动该组件，使其在父级组件内自动居中。如果此组件为桌面窗口，或者

没有父级组件，那么将自动位于屏幕的居中位置。

voidComponent::setTransform(constAffineTransform&transform

设置此组件的变换矩阵（无损变换。缩放、旋转等等）。

如果该组件进行了无损变换，则其位置将被扭曲或改变，这意味着传递给setBounds()的参数

值将不再反映出该组件在其父级组件中的实际位置和大小，甚至，该组件有可能位于其父级组

件之外而不可视。

使用无损变换时要特别注意，特别是牵扯到坐标点和区域定位时，此时应始终使用

getLocalPoint()、getLocalArea()等函数来完成此事,绝对不要在不同的组件之间进行此类

操作。

目前，桌面窗口不支持无损变换，因此，对桌面窗口的无损转换将被忽略。

要移除某个组件的无损变换，将参数设置为AffineTransform::identity即可。

constAffineTransformComponent::getTransform()const

返回此组件当前所设置的变换矩阵（缩放，旋转等等）。

关于无损变换的更多信息，请参见：setTransform().

参见：

setTransform

boolComponent::isTransformed()constthrow()

如果此组件当前应用了缩放、旋转等转换，则返回true。

关于无损变换的更多信息，请参见：setTransform().

参见：

setTransform

intComponent::proportionOfWidth(floatproportion)constthrow()

返回此组件的宽度比例。

此函数相当于：getWidth()*proportion。

intComponent::proportionOfHeight(floatproportion)constthrow()

返回此组件的高度比例。

此函数相当于：getHeight()*proportion。

intComponent::getParentWidth()constthrow()

返回此组件的父级组件的宽度。

如果该组件没有父级组件（即桌面窗口），则返回屏幕的宽度。

intComponent::getParentHeight()constthrow()

返回此组件的父级组件的高度。

如果该组件没有父级组件（即桌面窗口），则返回屏幕的高度。

constRectangleComponent::getParentMonitorArea()const

返回包含此组件的显示器的屏幕坐标系。

如果只有一个显示器，将返回该显示器的屏幕大小（左上原点和分辨率），如果有多个显示

器，将返回该组件的中心点所位于的显示器的屏幕大小。

intComponent::getNumChildComponents()constthrow()

返回此组件包含的子组件的个数。

参见：

getChildComponent,getIndexOfChildComponent

Component*Component::getChildComponent(intindex)constthrow()

按索引值返回该组件所包含的某个子组件。

子组件的Z序列从0开始，排序越靠前，数字越大。位于最前面的子组件，其索引值为

(getNumChildComponents()-1)。

如果索引值超出范围，将返回一个空指针。

参见：

getNumChildComponents,getIndexOfChildComponent

intComponent::getIndexOfChildComponent(constComponent*child)constthrow()

返回此组件所包含的某个子组件的索引值。

该组件的第一个子组件将返回0，也即位于最后面的子组件。返回值越大，该子组件越靠前。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

31//?f=2&t=6414

如果给定的参数并非该组件的子组件，则返回-1。

参见：

getNumChildComponents,getChildComponent,addChildComponent,toFront,toBack,

toBehind

voidComponent::addChildComponent(Component*child)

intzOrder=-1

)

此组件添加一个子组件。

添加子组件并不意味着该组件将自动销毁所添加的子组件。销毁所添加的子组件是程序员要负

责的事。注意，要安全的销毁某个组件，无需首先从父级组件中移除之。销毁的时候，将自动

移除并发送相应的消息。

如果要添加的子组件已经是当前组件的子组件，那么此函数将不起任何作用，也不改变所有子

组件的Z顺序。

参数：

child要添加的新组件。如果该组件已经是另一个组件的子组件，则首先从另一个组件中移除

之。

zOrder子组件的Z序列。值为-1将置于最前面，0为置于最后面。

参见：

removeChildComponent,addAndMakeVisible,getChild,

ComponentListener::componentChildrenChanged

voidComponent::addAndMakeVisible(Component*child

intzOrder=-1

)

此组件添加一个子组件，如果子组件当前不可见，则使之可见。

相当常用的函数。相当于连续使用这两个函数：子组件->setVisible(true)，

addChildComponent()。参见addChildComponent()以获取更多信息。

voidComponent::removeChildComponent(Component*childToRemove)

移除此组件所包含的某个子组件。

如果给出的参数并非当前组件的子组件，则此函数不进行任何处理。

注意：移除一个子组件并不能销毁它！要安全的销毁某个组件，无需首先从父级组件中移除

之。销毁的时候，将自动移除并发送相应的消息。

参见：

addChildComponent,ComponentListener::componentChildrenChanged

Component*Component::removeChildComponent(intchildIndexToRemove)

按索引值移除该组件所包含的某个子组件。

此函数返回要移除的子组件的指针，如果索引越界则返回null。

注意：移除一个子组件并不能销毁它！要安全的销毁某个组件，无需首先从父级组件中移除

之。销毁的时候，将自动移除并发送相应的消息。

参见：

addChildComponent,ComponentListener::componentChildrenChanged

voidComponent::removeAllChildren()

移除该组件所包含的所有子组件。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

32//?f=2&t=6414

注意，此函数并不能销毁子组件！要移除并销毁子组件，请使用deleteAllChildren()函数。

voidComponent::deleteAllChildren()

移除该组件所包含的所有子组件，并销毁它们。

参见：

removeAllChildren

Component*Component::getParentComponent()constthrow()

返回此组件的父级组件。

如果当前组件为顶级窗口，或者没有父级组件，则返回null。

引用：LassoComponent::beginLasso(),和

CarbonViewWrapperComponent::setOurSizeToEmbeddedViewSize()

template

TargetClass*Component::findParentComponentOfClass(TargetClass*const

dummyParameter=0)const

按给定的类搜索父级组件。

比如：findParentComponentOfClass()将返回第一个可动态转换为MyComp的父级组

件，如果没有合适的父级组件，则返回0。

如果IDE使用VC6，则参数dummyParameter是必须的，否则会出现编译错误。

Component*Component::getTopLevelComponent()constthrow()

返回包含该组件及其父级组件的最顶级组件。

此函数将从当前组件开始逐层搜索，直至找到没有父级组件的最顶级组件，而后返回所找到的

最顶级组件。最顶级组件也许是桌面窗口，或者是没有父级组件的顶层组件。

引用：CarbonViewWrapperComponent::carbonEventHandler()

boolComponent::isParentOf(constComponent*possibleChild)constthrow()

检测该组件是否为给定组件的父级组件。

此函数递归检查当前组件的所有子组件，直至检查结束。

virtualvoidComponent::parentHierarchyChanged()[virtual]

当此组件改变所隶属的父级组件时，自动调用此函数。

当某个组件添加或移除子组件时，此函数将被该组件的所有子组件所自动调用。

派生的子类可重写此函数以实现更多的功能。

参见：

getParentComponent,isShowing,ComponentListener::componentParentHierarchyChanged

引用：Button,KeyMappingEditorComponent,WebBrowserComponent,DocumentWindow,

TopLevelWindow,Drawable,DrawableComposite

virtualvoidComponent::childrenChanged()[virtual]

当此组件添加或移除子组件时，自动调用此函数。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

33//?f=2&t=6414

参见：

parentHierarchyChanged

重新实现：DrawableComposite.

virtualboolComponent::hitTest(intx

inty

)[virtual]

检测给定的点是否位于此组件内。

重写此方法允许所创建的组件只拦截在设定区域中发生的鼠标点击事件。

此函数用于表明某个坐标点是否位于该组件内，并被contains()和getComponentAt()等函数

所调用，以判断鼠标点击了哪个组件。

自定义形状的组件可能需要重写此函数以执行更复杂的判断检测。

返回的真假值取决于setInterceptsMouseClicks()函数所设置的返回值（默认的返回值为

true）。

注意，hit检测与该组件是否透明无关。

应用程序不应直接调用hitTest()函数，contains()函数也许是更合适的选择。因为此函数将

一并检测该组件的父级组件所堵塞的区域。

另注意，桌面组件将忽略此函数。

参数：

x要检测的x坐标，相对于该组件的左边缘。必须确保此值大于等于0，并小于组件的宽度。

y要检测的y坐标，相对于该组件的顶边缘。必须确保此值大于等于0，并小于组件的高度。

返回值：

如果点击的位置在该组件内，则返回true。

参见：

setInterceptsMouseClicks,contains

以下类中重写此函数：ImageButton,ResizableBorderComponent,

ResizableCornerComponent,TabBarButton,LassoComponent,

CallOutBox.

voidComponent::setInterceptsMouseClicks(boolallowClicksOnThisComponent,

boolallowClicksOnChildComponents

)throw()

改变hitTest()方法的参数，设置拦截鼠标点击事件。

设置为false是一种简单的方法，使一个组件能够将鼠标点击事件传递给位于其后的所有组

件。

创建一个组件后，此函数的默认设置为true。

参数：

allowClicksOnThisComponent如果为true，hitTest()将始终返回true；如果为false，将返

回false，或者其子组件将返回true，前提是allowClicksOnChildComponents已设置为true。

allowClicksOnChildComponents如果为true并且allowClicksOnThisComponent为false，那么

子组件能够被正常点击，但是该组件内的点击将直接通过。如果为false并且

allowClicksOnThisComponent也为false，那么此组件及其所有的子组件均无法点击。

参见：

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

34//?f=2&t=6414

hitTest,getInterceptsMouseClicks

voidComponent::getInterceptsMouseClicks(boolallowsClicksOnThisComponent,

boolallowsClicksOnChildComponents

)constthrow()

获取鼠标点击拦截标记的当前状态。

返回setInterceptsMouseClicks()所设置的状态。

参见：

setInterceptsMouseClicks

boolComponent::contains(constPoint&localPoint)

如果给定的坐标点位于此组件或它的子组件之内，则返回true。

永远不要改写此函数！使用hitTest来创建自定义的点击区域。

参数：

localPoint要检测的坐标点，相对于此组件的左上原点。

返回值：

如果该点位于此组件的点击检测区域，并且该区域未被父级组件所遮盖，则返回true。注意，

此函数不考虑任何覆盖的同级组件。对于这一点，可参见：reallyContains()

参见：

hitTest,reallyContains,getComponentAt

boolComponent::reallyContains(constPoint&localPoint,

boolreturnTrueIfWithinAChild

)

如果给定的点位于此组件之内则返回true，同时考虑到任何重叠的同级组件。

参数：

localPoint要检测的坐标点，相对于此组件的左上原点。

returnTrueIfWithinAChild如果检测点位于此组件的子组件之内，此参数决定是否影响返回

结果。

参见：

contains,getComponentAt

Component*Component::getComponentAt(intx

inty

)

返回给定的点所位于的组件。

参数：

x要检测的坐标点，相对于此组件的左边缘。

y要检测的坐标点，相对于此组件的上边缘。

返回值：

检测点所在的位置有可能是一个组件，也有可能为0，或者为某个组件的子组件。注意，此函

数实际上不访问重叠的同级组件，要访问其它同级组件，则让父级组件调用此函数。

参见：

hitTest,contains,reallyContains

Component*Component::getComponentAt(constPoint&position)

返回给定的点所位于的组件。

参数：

position要检测的坐标点，相对于此组件的左上原点。

返回值：

检测点所在的位置有可能是一个组件，也有可能为0，或者为某个组件的子组件。注意，此函

数实际上不访问重叠的同级组件，要访问其它同级组件，则让父级组件调用此函数。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

35//?f=2&t=6414

参见：

hitTest,contains,reallyContains

voidComponent::repaint()

标记整个组件需要重绘。

调用此函数并不会立即进行重绘，而是提示操作系统需要重绘此组件。稍后，操作系统将发送

重绘消息，此时才进行重绘处理。无法保证操作系统在多久之后，这取决于操作系统的消息队

列。

如果已调用setBufferedToImage()函数设置了此组件的缓冲，则repaint()将使用此组件的缓

冲变成无效状态。

要重绘此组件中的某个区域，而不是全部重绘，可使用：repaint(int,int,int,int)函

数。

参见：

paint

voidComponent::repaint(intx

inty

intwidth

intheight

)

标记组件的某个区域需要重绘。

调用此函数并不会立即进行重绘，而是提示操作系统需要重绘此组件的某个区域。稍后，操作

系统将发送重绘消息，此时才进行重绘处理。无法保证操作系统在多久之后，这取决于操作系

统的消息队列。

传递的参数确定要重绘的区域。

参见：

repaint()

voidComponent::repaint(constRectangle&area)

标记组件的某个区域需要重绘。

调用此函数并不会立即进行重绘，而是提示操作系统需要重绘此组件的某个区域。稍后，操作

系统将发送重绘消息，此时才进行重绘处理。无法保证操作系统在多久之后，这取决于操作系

统的消息队列。

传递的参数确定要重绘的区域。

参见：

repaint()

voidComponent::setBufferedToImage(boolshouldBeBuffered)

设置该组件使用内部缓冲来优化重绘操作。

设置为true将导致组件分配一个内部缓冲区以绘制其本身，因此，当重绘自身时可使用该缓冲

区，而不是实际调用paint()方法。

缓冲区一直保留到该组件直接调用repaint()方法，或者直到该组件调用了resized()函数。此

后，再次绘制此组件将重新使用paint()方法。

注意，仅使用paint()方法进行绘制时才使用缓冲区，子组件不使用此缓冲区，

paintOverChildren()方法也不使用。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

36/85

参见：

repaint,paint,createComponentSnapshot

constImageComponent::createComponentSnapshot(constRectangle&

areaToGrab,

boolclipImageToComponentBounds=true

)

生成此组件某个区域的屏幕快照。

此函数将返回一个新的Image，大小为所给出的矩形区域，抓取的屏幕快照中包含所有位于该

区域的子组件。

获取的图像是否具有alpha通道取决于图像是否设置了透明效果。

如果clipImageToComponentBounds参数为true，且所抓取的快照区域超过了组件的大小，将自

动裁剪。如果clipImageToComponentBounds参数为false，则超出范围的部分不进行裁剪。

参见：

paintEntireComponent

voidComponent::paintEntireComponent(Graphics&context

boolignoreAlphaLevel

)

用给定的绘图环境重绘此组件及其所有的子组件。

通常情况下，程序员很少有机会使用此函数，仅在非常特殊的目的下才会使用定制的绘图环境

来绘制组件所显示的内容。比如：创建此组件的快照。

此函数将调用paint()、paintOverChildren()，并递归调用其子组件的

paintEntireComponent()函数。

此函数返回之后，图形环境也许将处于未定义状态，所以，下次使用之前可能需要再次定义图

形环境。

如果参数ignoreAlphaLevel为false，则组件将使用getAlpha()的返回值来设置透明度。如果

参数ignoreAlphaLevel为true，将忽略透明设置（alpha值为1.0F）。

voidComponent::setPaintingIsUnclipped(boolshouldPaintWithoutClipping)throw

()

此方法允许表明此组件在重绘时无需剪切图形环境。

通常情况下无需使用此设置，但如果有大量简单的组件需要渲染，并且这些组件的绘制确保不

会超越其自身大小，这种情况下有可能会用到此函数。如果开启此模式，则需要确保绘制函数

不被Graphics::fillAll()这样的函数所调用，并且不会进行超越组件边界的绘制，因为这样

将会产生失真。

voidComponent::setComponentEffect(ImageEffectFilter*newEffect)

设置组件的外观。

当组件设置了效果过滤器，那么该效果将自动被paint()方法所使用。有几个预设的效果，比

如阴影或发光等等，还可以自定义。

该函数的实参不会被该组件销毁，程序员必须手动销毁该对象。

要移除已经设置的效果器，实参为空指针即可。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

/?f=2&t=6414

参见：

ImageEffectFilter,DropShadowEffect,GlowEffect

ImageEffectFilter*Component::getComponentEffect()constthrow()

返回此组件当前所设置的外观效果。

参见：

setComponentEffect

LookAndFeel&Component::getLookAndFeel()constthrow()

获取该组件所使用的外观及感觉（look-and-feel）。

如果该组件没有设置LAF（外观和感觉），则返回其父级组件的外观和感觉。如果此组件没有

父级组件，则返回默认值。

参见：

setLookAndFeel,lookAndFeelChanged

voidComponent::setLookAndFeel(LookAndFeel*newLookAndFeel)

设置此组件的外观与感觉（Look-and-Feel）。

此函数将影响到尚未设置LAF的子组件。

实参对象不会被组件销毁，程序员需手工销毁之。该对象可随时调用，直至使用它的组件被销

毁。

调用此函数将一并调用sendLookAndFeelChange()函数.

参见：

getLookAndFeel,lookAndFeelChanged

virtualvoidComponent::lookAndFeelChanged()[virtual]

当该组件所使用的外观与感觉发生变化时，自动调用此函数。

当组件的外观和感觉改变时，该组件及其所有的子组件将自动调用此函数。子组件采用递归的

方式调用。

此函数也可通过sendLookAndFeelChange()方法来手动触发，如果应用程序使用了LookAndFeel

类，则有可能进行内部改变。

参见：

sendLookAndFeelChange,getLookAndFeel

重新实现：ComboBox,ProgressBar,Slider,FilenameComponent,ScrollBar,

TabbedButtonBar,TabbedComponent,AlertWindow,DocumentWindow,ResizableWindow

voidComponent::sendLookAndFeelChange()

设置此组件和它的所有子组件调用lookAndFeelChanged()方法。

此函数将递归调用所有的下级组件的lookAndFeelChanged()函数。

参见：

lookAndFeelChanged

voidComponent::setOpaque(boolshouldBeOpaque)

设置不透明。

组件始终使用纯色来绘制其内容，因而此函数将完整覆盖位于其后的所有组件的重绘事件。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

38//?f=2&t=6414

此函数用来优化绘制事件，因为不透明的窗口无需额外的绘制。

默认情况下，组件是透明的，此函数使之不透明。

参见：

isOpaque,getVisibleArea

boolComponent::isOpaque()constthrow()

如果此组件为不透明的（无任何透明的区域），则返回true。

返回值：

返回setOpaque()函数所设置的值。默认为false。

参见：

setOpaque

voidComponent::setBroughtToFrontOnMouseClick(boolshouldBeBroughtToFront)

throw()

设置当鼠标点击时，此组件是否自动切换到最前面。

设置为true，则鼠标在此组件及其子组件的区域内点击时，此组件自动置于最前面。

注意，顶级窗口是否置于最前面将取决于操作系统。

默认设置为false。

参见：

setMouseClickGrabsKeyboardFocus

boolComponent::isBroughtToFrontOnMouseClick()constthrow()

如果鼠标点击时此组件自动切换到最前面，则返回true。

参见：

setBroughtToFrontOnMouseClick

voidComponent::setWantsKeyboardFocus(boolwantsFocus)throw()

设置一个标志，以表明此组件是否需要键盘焦点。

默认情况下，组件对是否拥有键盘焦点不感兴趣，此方法使组件开启该项属性。

参见grabKeyboardFocus()方法获取使组件拥有焦点的更多信息。

参见：

grabKeyboardFocus,getWantsKeyboardFocus

boolComponent::getWantsKeyboardFocus()constthrow()

如果此组件对键盘焦点感兴趣，则返回true。

返回由setWantsKeyboardFocus()方法所设置的值。默认为false。

参见：

setWantsKeyboardFocus

voidComponent::setMouseClickGrabsKeyboardFocus(boolshouldGrabFocus)

设置点击此组件时是否拥有键盘焦点。

默认设置为true，但可以使用该函数改变这一点，即：即使用户点击某个组件，也不使其拥有

焦点。

boolComponent::getMouseClickGrabsKeyboardFocus()constthrow()

返回setMouseClickGrabsKeyboardFocus()所设置的值。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

/?f=2&t=6414

参见：setMouseClickGrabsKeyboardFocus()以获得更多信息。

voidComponent::grabKeyboardFocus()

试图使此组件拥有键盘焦点。

点击某个组件或者该组件调用grabKeyboardFocus()函数之后，以下处理判断哪个组件应获得

焦点：

如果该组件被设置为鼠标点击以获得焦点，比如调用getWantsKeyboardFocus函数，则自动拥

有焦点。

如果组件本身不希望拥有焦点，则焦点自动转移给该组件的子组件，类似于

KeyboardFocusTraverser::getDefaultComponent()函数的作用。

如果该组件的所有子组件同样不想拥有焦点，则焦点转移给该组件的父级组件，直至没有父级

组件的顶级组件，这种情况下，顶级组件将自动拥有焦点。

参见：

setWantsKeyboardFocus,getWantsKeyboardFocus,hasKeyboardFocus,

getCurrentlyFocusedComponent,focusGained,focusLost,keyPressed,keyStateChanged

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion

bySwingCoder»WedJan05,20114:46am

boolComponent::hasKeyboardFocus(booltrueIfChildIsFocused)const

如果此组件当前拥有键盘焦点则返回true。

参数：

trueIfChildIsFocused如果为true，且该组件或者其所有的子组件拥有焦点时，此函数均返

回true。如果为false，则仅当该组件实际拥有焦点时才返回true。

参见：

grabKeyboardFocus,setWantsKeyboardFocus,getCurrentlyFocusedComponent,

focusGained,focusLost

staticComponent*JUCE_CALLTYPEComponent::getCurrentlyFocusedComponent()throw

()[static]

返回当前拥有键盘焦点的某个组件。

返回值：

拥有焦点的组件，如果没有组件拥有焦点，则返回null。

voidComponent::moveKeyboardFocusToSibling(boolmoveToNext)

尝试将键盘焦点转移给下一个同级组件。

此方法将尝试把焦点转移给上一个或下一个组件。使用TAB键转移焦点时，将自动调用此函

数。

12-12-26

40//?f=2&t=6414

getWantsKeyboardFocus()返回值为false的组件将不予考虑。

参数：

moveToNext如果为true，则焦点向前转移；如果为false，则焦点向后转移。

参见：

grabKeyboardFocus,setFocusContainer,setWantsKeyboardFocus

virtualKeyboardFocusTraverser*Component::createFocusTraverser()[virtual]

创建一个KeyboardFocusTraverser对象以确定此组件传递焦点的逻辑。

默认情况下，如果此组件为setFocusContainer()方法所设置的焦点容器，则返回

KeyboardFocusTraverser的默认值。如果组件不是焦点容器，则返回其父级组件的

KeyboardFocusTraverser。

如果重写此函数以返回定制的KeyboardFocusTraverser，那么此组件及其所有的子组件将使用

新对象来确定拥有焦点方式。

此函数应返回一个新对象，当不再需要时，由程序员负责销毁之。

重新实现：Label

intComponent::getExplicitFocusOrder()const

返回此组件的焦点顺序，如果已指定。

默认情况下，组件没有焦点顺序，此时将返回0。返回的值越小，则此组件的焦点顺序越靠

前。

使用setExplicitFocusOrder()函数可改变焦点顺序。

焦点顺序也许被KeyboardFocusTraverser类所使用，作为算法的一部分以决定组件转移焦点的

顺序。参见KeyboardFocusTraverser类以获取更多信息。

参见：

moveKeyboardFocusToSibling,createFocusTraverser,KeyboardFocusTraverser

voidComponent::setExplicitFocusOrder(intnewFocusOrderIndex)

按索引值设置焦点转移的顺序。

小于等于0的值表明不显式设置焦点顺序，焦点转移将使用其它因数，比如组件的位置等等。

参见：

getExplicitFocusOrder,moveKeyboardFocusToSibling

voidComponent::setFocusContainer(boolshouldBeFocusContainer)throw()

设置此组件是否为焦点容器。

此函数被默认被createFocusTraverser()所调用，以查找第一个拥有焦点且有意成为焦点容器

的父级组件。

因此，参数设置为true将导致此组件作为顶级焦点容器组件。

参见：

isFocusContainer,createFocusTraverser,moveKeyboardFocusToSibling

boolComponent::isFocusContainer()constthrow()

如果此组件为焦点容器，则返回true。

参见：setFocusContainer()

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

41//?f=2&t=6414

参见：

setFocusContainer,moveKeyboardFocusToSibling,createFocusTraverser

boolComponent::isEnabled()constthrow()

如果此组件及其所有的子组件为开启状态，则返回true。

默认情况下，组件为开启状态，可使用setEnabled()函数禁用或开启。如何设置，取决于组

件的类型和程序员的目的。比如：按钮和滑块在开启或禁用状态下，将显示截然不同的外观。

注意，如果该组件的上级组件之一设置为禁用状态，则此函数将始终返回false，即使此组件

自身的状态为开启。

参见：

setEnabled,enablementChanged

voidComponent::setEnabled(boolshouldBeEnabled)

启用或禁用此组件。

禁用某个组件将导致该组件的所有子组件处于禁用状态。

同样，即使开启某个已禁用的组件的子组件，也不会产生任何作用，直至子组件的父组件也处

于开启状态。

参见：

isEnabled,enablementChanged

virtualvoidComponent::enablementChanged()[virtual]

启用或禁用此组件时自动调用此函数。

此组件的某个上级组件改变开启或禁用状态时将触发此函数，同时也将影响到该组件的状态。

默认情况下，此函数不起任何作用，但派生类如果需要重绘自身或利用状态改变之际做某事，

则可以重写此函数。

参见：

setEnabled,isEnabled

重新实现：Button,ToolbarButton,ComboBox,Label,Slider,TextEditor,TreeView,

GroupComponent,PropertyComponent

voidComponent::setAlpha(floatnewAlpha)

更改此组件的透明度。

进行绘制操作时可使用此函数，以设置透明度。0为完全透明（不可视），1.0F为完全不透明

（正常状态）。

参见：

getAlpha

floatComponent::getAlpha()const

返回此组件当前所设置的透明度。

参见：setAlpha()

voidComponent::setMouseCursor(constMouseCursor&cursorType)

设置鼠标指针的外观（当鼠标指向该组件时）。

注意，此函数所设置的鼠标指针能够被getMouseCursor方法重写。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

42//?f=2&t=6414

参见：

MouseCursor

virtualconstMouseCursorComponent::getMouseCursor()[virtual]

获取当前设置的鼠标指针外观（当鼠标指向该组件时）。

默认返回由setCursor()所设置的鼠标指针，可重写此函数以实现更多的目的，比如，根据鼠

标位置返回不同的指针。

参见：

MouseCursor

重新实现：TableHeaderComponent

voidComponent::updateMouseCursor()const

强制刷新当前的鼠标指针。

如果重写了getMouseCursor()函数以控制所显示的指针，那么每次移动鼠标时均自动调用此函

数。如果打算强制更新鼠标指针，而无论鼠标是否移动，则在代码中的必要位置显式调用此函

数。

如果使用setMouseCursor()函数改变了鼠标指针，则无需调用此函数。

virtualvoidComponent::paint(Graphics&g)[virtual]

重写此方法以绘制此组件的内容。

当组件的某个区域需要绘制、调用组件的repaint()方法，或者由于某些原因操作系统需要重

新显示或刷新组件内容时，均自动调用此函数。

同时，该组件的所有子组件也一并调用各自的同名方法来绘制自身。如果要绘制置于组件之前

的子组件，可使用paintOverChildren()方法来完成。

如果要显式绘制组件，则使用repaint()方法，此时将异步调用本函数，在稍后的某个时间，

执行绘制处理。Juce类库和大多数目前流行的UI框架库一样，程序员均无法进行任何同步绘制

处理。即：绘制总是异步进行的。执行的时间取决于操作系统的消息队列。

程序员也许永远无需直接调用此函数，要获取组件的快照，可使用

createComponentSnapshot()或paintEntireComponent()方法。

参数：

g图形环境，执行绘制操作所必须的参数。

参见：

repaint,paintOverChildren,Graphics

重新定义：GenericAudioProcessorEditor,Button,CodeEditorComponent,ComboBox,

Label,ListBox,ProgressBar,Slider,TableHeaderComponent,TextEditor,Toolbar,

TreeView,FileSearchPathListComponent,ImagePreviewComponent,GroupComponent,

MultiDocumentPanel,ResizableBorderComponent,ResizableCornerComponent,ScrollBar,

StretchableLayoutResizerBar,TabbedComponent,MenuBarComponent,LassoComponent<

SelectableItemType>,BooleanPropertyComponent,PropertyComponent,PropertyPanel,

ActiveXControlComponent,BubbleComponent,MidiKeyboardComponent,NSViewComponent,

OpenGLComponent,PreferencesPanel,SystemTrayIconComponent,WebBrowserComponent,

AlertWindow,CallOutBox,DocumentWindow,ResizableWindow,SplashScreen,

DrawableImage,DrawableShape,DrawableText.

virtualvoidComponent::paintOverChildren(Graphics&g)[virtual]

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

/?f=2&t=6414

可重写此方法以绘制位于最前面的子组件。

大多数绘制操作最好使用正常的paint()方法，但如果需要绘制置于最前面的子组件，则可调

用此函数。

参见：

paint,Graphics

重新实现：ListBox,TextEditor,FilenameComponent

virtualvoidComponent::mouseMove(constMouseEvent&e)[virtual]

当鼠标在此组件中移动时，自动调用此函数。

如果鼠标的某个键尚未按下并且正指向当前组件，则自动调用此函数。

在调用此函数之前，组件将始终回调mouseEnter()函数。

参数：

e关于鼠标指针的位置和状态的详细信息。

参见：

mouseEnter,mouseExit,mouseDrag,contains

改写自：MouseListener

重新实现：ListBox,TableHeaderComponent,ResizableBorderComponent,

MenuBarComponent,MidiKeyboardComponent

virtualvoidComponent::mouseEnter(constMouseEvent&e)[virtual]

当鼠标进入此组件时，自动调用此函数。

如果鼠标的某个键尚未按下并且正进入当前组件，则自动调用此函数。

当鼠标按住某个键进出一个组件时，并不产生mouseEnter或mouseExit事件，仅发送鼠标首次

按下时产生的mouseDrag消息，鼠标拖拽的消息发送给此组件，直至松开按键。

如果写了一个组件类或该类的派生类，在鼠标指针进入或退出时需要重绘自身，使用此函数也

许更方便：setRepaintsOnMouseActivity()。

参数：

e关于鼠标指针的位置和状态的详细信息。

参见：

mouseExit,mouseDrag,mouseMove,contains

改写自：MouseListener

重新实现：Button,TableHeaderComponent,ResizableBorderComponent,

MenuBarComponent,MidiKeyboardComponent

virtualvoidComponent::mouseExit(constMouseEvent&e)[virtual]

当鼠标指针退出此组件时，自动调用此函数。

当鼠标指针移动到组件的边界之外时调用此函数。

如果按住鼠标某个键进行拖拽操作，在离开组件的边界并释放鼠标按键后，将调用此函数，之

后再调用mouseUp()函数。

如果写了一个组件类或该类的派生类，在鼠标指针进入或退出时需要重绘自身，使用此函数也

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

44//?f=2&t=6414

许更方便：setRepaintsOnMouseActivity()。

参数：

e关于鼠标指针的位置和状态的详细信息。

参见：

mouseEnter,mouseDrag,mouseMove,contains

改写自：MouseListener

重新实现：Button,ListBox,TableHeaderComponent,MenuBarComponent,

MidiKeyboardComponent

virtualvoidComponent::mouseDown(constMouseEvent&e)[virtual]

当鼠标指针位于此组件并且点击某个鼠标键，尚未释放时，自动调用此函数。

参数为MouseEvent类的对象，包含大量的方法以判断哪个鼠标键被按下、同时还按下了哪个功

能键，比如Shift键、Ctrl键等等。

一旦按下了某个鼠标键并移动鼠标时，将调用mouseDrag方法，直至松开按键。

参数：

e关于鼠标指针的位置和状态的详细信息。

参见：

mouseUp,mouseDrag,mouseDoubleClick,contains

改写自：MouseListener

重新实现：Button,CodeEditorComponent,ComboBox,Slider,TableHeaderComponent,

TextEditor,Toolbar,ResizableBorderComponent,ResizableCornerComponent,

ScrollBar,StretchableLayoutResizerBar,MenuBarComponent,MidiKeyboardComponent,

AlertWindow,ResizableWindow

virtualvoidComponent::mouseDrag(constMouseEvent&e)[virtual]

当鼠标拖拽时，自动调用此函数。

当鼠标指针位于组件内并按下某个鼠标键后，则每次移动鼠标，组件将收到mouseDrag回调消

息，即使鼠标指针位于边界之外也依然如此。

如果打算执行某些离开组件边界的拖拽处理，并且组件产生滚屏效果，函数

beginDragAutoRepeat()也许更有用。

参数：

e关于鼠标指针的位置和状态的详细信息。

参见：

mouseDown,mouseUp,mouseMove,contains,beginDragAutoRepeat

改写自：MouseListener

重新实现：Button,CodeEditorComponent,ComboBox,Slider,TableHeaderComponent,

TextEditor,ResizableBorderComponent,ResizableCornerComponent,ScrollBar,

StretchableLayoutResizerBar,MenuBarComponent,MidiKeyboardComponent,AlertWindow,

ResizableWindow

virtualvoidComponent::mouseUp(constMouseEvent&e)[virtual]

鼠标点击并释放某个鼠标按键时自动调用此函数。

mouseUp回调将发送给此组件，即使当释放鼠标按键时它实际上正指向不同的组件。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

45//?f=2&t=6414

MouseEvent对象包含大量的鼠标按键信息以判断哪个鼠标键被按下了。

参数：

e关于鼠标指针的位置和状态的详细信息。

参见：

mouseDown,mouseDrag,mouseDoubleClick,contains

改写自：MouseListener

重新实现：Button,CodeEditorComponent,ComboBox,Label,ListBox,Slider,

TableHeaderComponent,TextEditor,ResizableBorderComponent,

ResizableCornerComponent,ScrollBar,MenuBarComponent,MidiKeyboardComponent

virtualvoidComponent::mouseDoubleClick(constMouseEvent&e)[virtual]

鼠标在此组件中双击时自动调用此函数。

参数为MouseEvent类的对象，包含大量的方法以判断哪个鼠标键被按下、同时还按下了哪个功

能键，比如Shift键、Ctrl键等等。

要改变两次点击的时间限定，则参见：MouseEvent::setDoubleClickTimeout。

参数：

e关于鼠标指针的位置和状态的详细信息。

参见：

mouseDown,mouseUp,MouseEvent::setDoubleClickTimeout,

MouseEvent::getDoubleClickTimeout

改写自：MouseListener

重新实现：CodeEditorComponent,Label,Slider,TextEditor,DocumentWindow

virtualvoidComponent::mouseWheelMove(constMouseEvent&e,

floatwheelIncrementX,

floatwheelIncrementY

)[virtual]

转动鼠标滚轮键时自动调用此函数。

当鼠标指针指向该组件并转动滚动键时，此自动调用此函数。

如果不重写，该组件将把消息转发给父级组件，由父级组件收集子组件不感兴趣的鼠标滚轮消

息。

参数：

e关于鼠标指针的位置和状态的详细信息。

wheelIncrementX水平滚动的速率和方向，正数代表向右滚动，负数代表向左滚动。

wheelIncrementY垂直滚动的速率和方向，正数代表向上滚动，负数代表向下滚动。

改写自：MouseListener

重新实现：CodeEditorComponent,ListBox,Slider,TextEditor,ScrollBar,Viewport,

MidiKeyboardComponent

staticvoidComponent::beginDragAutoRepeat(intmillisecondsBetweenCallbacks)

[static]

确保鼠标拖拽时所产生的事件数据流无停滞。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

46//?f=2&t=6414

此函数将确保mouseDrag()事件能够连续发送，即使鼠标处于不移动的状态。当鼠标靠近边界

时，对于具有自动卷屏性质的组件，此函数比较有用。

在mouseDown()或mouseDrag()期间，调用此函数，指定鼠标拖拽消息的最小间隔。此函数将不

间断的调用，直到松开鼠标按键，此时，间隔时间自动重置。每次开始拖拽鼠标时要确保调用

此函数。参数值小于等于0将取消自动重复。

参见：

mouseDrag,Desktop::beginDragAutoRepeat

voidComponent::setRepaintsOnMouseActivity(boolshouldRepaint)throw()

鼠标指针进入或退出此组件时，自动重绘。

如果开启，则鼠标进入、退出此组件，或者在此组件内按下某个鼠标键、释放鼠标键时，将触

发重绘。

此函数在鼠标指向按钮等控件时，对控件进行自我重绘时比较有用，可以避免覆盖所有不同的

鼠标回调，并调用repaint()。

参见：

mouseEnter,mouseExit,mouseDown,mouseUp

voidComponent::addMouseListener(MouseListener*newListener,

boolwantsEventsForAllNestedChildComponents

)

绑定鼠标事件捕获器。

如果需要获取组件内的鼠标事件，并且不打算或无法改写此函数，可为该组件附加任意数量的

捕获器。这些额外的事件将被组件自身所自动调用。

注意，MouseListener同样能够附加到多个组件。

参数：

newListener要注册的捕获器。

wantsEventsForAllNestedChildComponents如果为true，捕获器将接收此组件及其所有子组

件的回调事件，包括深层次嵌套的子组件。如果为false，则仅接收此组件的鼠标事件。

参见：

MouseListener,removeMouseListener

voidComponent::removeMouseListener(MouseListener*listenerToRemove)

移除已经绑定的鼠标事件捕获器。

参见：

addMouseListener,MouseListener

voidComponent::addKeyListener(KeyListener*newListener)

添加此组件能够接收的按键事件捕获器。

此组件已注册的捕获器被keyPressed()或keyStateChanged()所调用，前提是这两个函数未被

改写为执行其它功能。

如果添加一个捕获器对象，要注意销毁该对象之前先移除之。

参见：

keyPressed,keyStateChanged,removeKeyListener

voidComponent::removeKeyListener(KeyListener*listenerToRemove)

移除已经绑定的按键捕获器。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

47//?f=2&t=6414

参见：

addKeyListener

virtualboolComponent::keyPressed(constKeyPress&key)[virtual]

当按下某个键时，自动调用此函数。

按下某个键时，拥有键盘焦点的组件将自动此函数。可使用setWantsKeyboardFocus()方法使

组件拥有焦点。

如果该函数返回true，则按键事件将被该函数处理，而不再传递给其它捕获器。如果返回

false，则按键将传递给该组件已注册的任意KeyListeners。尽量返回true，处理将自动停

止，但是如果所有的返回均为false，事件将传递给此组件的父级组件，依此类推。

默认情况下，此函数不执行任何处理，并返回false。

参见：

keyStateChanged,getCurrentlyFocusedComponent,addKeyListener

ReimplementedinButton,CodeEditorComponent,ComboBox,ListBox,TextEditor,

TreeView,FileBrowserComponent,ScrollBar,Viewport,MenuBarComponent,

AlertWindow,andCallOutBox.

virtualboolComponent::keyStateChanged(boolisKeyDown)[virtual]

当按下或释放某个键时自动调用此函数。

每次按下或松开某个键盘键时，包括Shift、Ctrl等功能键，当前拥有键盘焦点的组件将自动

调用此函数。可使用setWantsKeyboardFocus()方法使组件拥有焦点。

如果该函数返回true，则按键事件将被该函数处理，而不再传递给其它捕获器。如果返回

false，则该组件已经注册的KeyListeners将调用keyStateChanged函数。尽量返回true，处理

将自动停止，但是如果所有的返回均为false，事件将传递给此组件的父级组件，依此类推。

默认情况下，此函数不执行任何处理，并返回false。

要获取任意时刻按下或松开的某个键，参见：KeyPress::isKeyCurrentlyDown()函数。

参数：

isKeyDowntrue为按下某个键，false为松开某个键。

参见：

keyPressed,KeyPress,getCurrentlyFocusedComponent,addKeyListener

重新实现：ComboBox,ListBox,TextEditor,MidiKeyboardComponent

virtualvoidComponent::modifierKeysChanged(constModifierKeys&modifiers)

[virtual]

按下或释放某个功能键时自动调用此函数。

每当按下或松开Shift、Ctrl、Alt、Command键时，当前拥有键盘焦点的组件将自动调用此函

数。可使用setWantsKeyboardFocus()方法使组件拥有焦点。

默认调用父级组件的modifierKeysChanged方法，这种情况下，对按键不感兴趣的组件将给予

其父级组件一个处理按键事件的机会。

参见：

keyStateChanged,ModifierKeys

重新实现Slider

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

48//?f=2&t=6414

virtualvoidComponent::focusGained(FocusChangeTypecause)[virtual]

此组件拥有键盘焦点时自动此函数。

参见：

focusLost,setWantsKeyboardFocus,getCurrentlyFocusedComponent,hasKeyboardFocus

重新实现：Button,CodeEditorComponent,ComboBox,Label,TextEditor

virtualvoidComponent::focusLost(FocusChangeTypecause)[virtual]

此组件失去键盘焦点时自动此函数。

参见：

focusGained,setWantsKeyboardFocus,getCurrentlyFocusedComponent,hasKeyboardFocus

重新实现：Button,CodeEditorComponent,ComboBox,TextEditor,MidiKeyboardComponent

virtualvoidComponent::focusOfChildComponentChanged(FocusChangeTypecause)

[virtual]

此组件的子组件拥有或失去键盘焦点时自动调用此函数。

实质上，返回值为hasKeyboardFocus(true)改变后的结果。当子组件的焦点转移时，调用此

函数。

参见：

focusGained,setWantsKeyboardFocus,getCurrentlyFocusedComponent,hasKeyboardFocus

重新实现：Slider,TopLevelWindow

boolComponent::isMouseOver(boolincludeChildren=false)const

如果鼠标指针位于此组件则返回true。

如果鼠标未指向此组件，将返回false，即使当前正在拖拽鼠标。因此，可在mouseDrag中调用

此函数以找到鼠标是否位于此组件中。

注意，当按下鼠标时，仅按下时鼠标所位于的组件返回true。

参数includeChildren为true，则鼠标位于此组件的子组件时也将返回true。

参见：

eOverOrDragging,mouseDrag

boolComponent::isMouseButtonDown()constthrow()

如果正按下鼠标的某个键，则返回true。

注意，此函数相当于一个检测，以判断鼠标是否在此组件中点击了。如果A组件调用此函数，

而当前鼠标正拖拽到B组件，则返回false。

参见：

isMouseButtonDownAnywhere,isMouseOver,isMouseOverOrDragging

boolComponent::isMouseOverOrDragging()constthrow()

如果鼠标指针位于此组件，或者正在此组件中拖拽，则返回true。

此函数相当于：(isMouseOver()||isMouseButtonDown())。

参见：

isMouseOver,isMouseButtonDown,isMouseButtonDownAnywhere

staticboolJUCE_CALLTYPEComponent::isMouseButtonDownAnywhere()throw()

[static]

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

49//?f=2&t=6414

如果正按下鼠标的某个键，则返回true。

此函数不同于isMouseButtonDown，它的作用是检测鼠标按键的当前状态。

参见：

isMouseButtonDown,ModifierKeys

引用：LassoComponent::paint()

constPointComponent::getMouseXYRelative()const

返回鼠标指针相对于此组件的原点的当前位置。

返回值以组件的左上原点作为参照。

virtualvoidComponent::resized()[virtual]

此组件的大小发生变化时自动调用此函数。

当组件的大小发生变化时，通常利用该函数来重新定位其子组件。

此函数被setBounds或setSize函数所同步调用，因此重复改变组件的大小将不断调用resized

方法。这一点与repaint截然不同，多次调用repaint只能在稍后某一时刻进行集中重绘。

如果当前组件为桌面顶级窗口，其大小由操作系统控制，程序所设置的大小也许将不起作用。

参见：

moved,setSize

重新实现：PluginListComponent,GenericAudioProcessorEditor,DrawableButton,

ToolbarButton,CodeEditorComponent,ComboBox,Label,ListBox,Slider,

TableHeaderComponent,TableListBox,TextEditor,Toolbar,ToolbarItemComponent,

ToolbarItemPalette,TreeView,FileBrowserComponent,FilenameComponent,

FileSearchPathListComponent,KeyMappingEditorComponent,MultiDocumentPanel,

ScrollBar,TabbedButtonBar,TabbedComponent,Viewport,MenuBarComponent,

PropertyComponent,PropertyPanel,AudioDeviceSelectorComponent,

MidiKeyboardComponent,PreferencesPanel,WebBrowserComponent,CallOutBox,

DialogWindow,DocumentWindow,ResizableWindow

virtualvoidComponent::moved()[virtual]

此组件的位置发生变化时自动调用此函数。

当该组件相对于其父级组件的位置发生变化时将自动调用此函数，而不是它在屏幕绝对位置发

生改变时。因此，当父级组件移动时，该组件的所有子组件将不会调用此函数。

此函数将被setBounds、setTopLeftPosition等函数同步调用，类似于resized()方法，每次调

用上述函数均自动调用本函数。

如果当前组件为桌面顶级窗口，其位置由操作系统控制，程序所设置的大小也许将不起作用。

参见：

resized,setBounds

重新实现：CallOutBox,ResizableWindow

virtualvoidComponent::childBoundsChanged(Component*child)[virtual]

当此组件的某个子组件的大小和位置发生变化时，自动调用此函数。

如果父级组件要获悉它的直接子组件的变化，则重写此函数。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

/?f=2&t=6414

参见：

moved,resized,parentSizeChanged

重新实现：AudioDeviceSelectorComponent,MagnifierComponent,CallOutBox,

ResizableWindow,DrawableComposite

virtualvoidComponent::parentSizeChanged()[virtual]

当此组件的上一级父组件的大小发生变化时，自动调用此函数。

如果组件为顶级窗口，此函数将表明屏幕分辨率的变化。

参见：

childBoundsChanged,moved,resized

重新实现：ResizableWindow

virtualvoidComponent::broughtToFront()[virtual]

当此组件位于其同级组件的最前面时，自动调用此函数。

组件也许已被toFront()函数或操作系统置于前面（如果是顶级窗口）。

参见：

toFront

重新实现：MultiDocumentPanelWindow

voidComponent::addComponentListener(ComponentListener*newListener)

添加一个捕获器以告知组件的隶属关系或位置发生变化。

当组件的大小、位置或子组件发生变化时，将自动调用Component捕获器。参见：

ComponentListener类以获取更多信息。

参数：

newListener要注册的捕获器，如果已经注册，则此函数将不起作用。

参见：

ComponentListener,removeComponentListener

voidComponent::removeComponentListener(ComponentListener*listenerToRemove)

移除已经添加的组件捕获器。

参见：

addComponentListener

voidComponent::postCommandMessage(intcommandId)

将某个消息发送给此组件。

此函数为一个快速而简单的方法，采用异步回调的方式将消息发送给当前组件。此函数是安全

的，如果接收消息的组件是空指针或野指针，将不会出现错误。

命令ID为操作系统消息队列中要处理的handleCommandMessage()事件。

参见：

handleCommandMessage

virtualvoidComponent::handleCommandMessage(intcommandId)[virtual]

处理postCommandMessage()发送过来的消息。

当命令消息到达时，消息线程自动调用此函数，组件类可重写此函数以所需的方式进行处理。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

51//?f=2&t=6414

参见：

postCommandMessage

重新实现：Button,TextEditor,MenuBarComponent,CallOutBox

intComponent::runModalLoop()

进入模态（无限循环、自动置顶状态），直到循环终止。

此函数将首先使组件可见，将其置于最前面，并给予其键盘焦点。

然后，进入无限循环状态，从操作系统消息队列中调度消息，并阻碍所有其它组件的鼠标、键

盘事件。

循环直至组件调用exitModalState()方法为止，或者销毁此组件为止。而后，此函数返回，返

回值传递给exitModalState()函数。

参见：

enterModalState,exitModalState,isCurrentlyModal,getCurrentlyModalComponent,

isCurrentlyBlockedByAnotherModalComponent,ModalComponentManager

voidComponent::enterModalState(booltakeKeyboardFocus=true,

ModalComponentManager::Callback*callback=0

)

使此组件进入模态。

组件进入模态，其它组件将无法捕获并处理鼠标和键盘事件。但是，此函数不同于

runModalLoop()，因为它并不返回值。

如果takeKeyboardFocus为true，组件将使用grabKeyboardFocus()方法强制获取键盘焦点。如

果为false，则保留当前的焦点位置。

参数callback可选，当组件退出模态时是否回调此函数。比如隐藏组件或调用

exitModalState()函数。如果此处传递了一个对象参数，在回调之后，系统将小心的销毁该对

象。

参见：

exitModalState,runModalLoop,ModalComponentManager::attachCallback

voidComponent::exitModalState(intreturnValue)

结束模态。

如果组件当前处于模态，此函数将使之处于非模态，并返回一个值给也许正处于模态的

runModalLoop()方法。

参见：

runModalLoop,enterModalState,isCurrentlyModal

boolComponent::isCurrentlyModal()constthrow()

如果此组件当前为模态则返回true。

如果当前有多个模态组件，比如一个模态对话框中打开另一个模态对话框，此函数仅判断最顶

层的组件是否模态。

参见：

getCurrentlyModalComponent

staticintJUCE_CALLTYPEComponent::getNumCurrentlyModalComponents()throw()

[static]

返回当前处于模态的组件个数。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

52//?f=2&t=6414

参见：

getCurrentlyModalComponent

staticComponent*JUCE_CALLTYPEComponent::getCurrentlyModalComponent(intindex

=0)throw()[static]

返回当前处于模态的组件。

指定的索引为所要返回的可能是模态的组件。模态组件列表中，每个模态组件均有一个索引

值。索引为0的组件始终是当前位于最前面的组件。

返回值：

模态组件，如果当前没有模态组件，或者索引越界则返回null。

参见：

getNumCurrentlyModalComponents,runModalLoop,isCurrentlyModal

boolComponent::isCurrentlyBlockedByAnotherModalComponent()const

检测是否正有一个模态组件阻碍了此组件接收消息。

如果有一个模态组件，它的canModalEventBeSentToComponent()方法将被调用，以判断是否允

许当前组件接收事件。

参见：

runModalLoop,getCurrentlyModalComponent

virtualboolComponent::canModalEventBeSentToComponent(constComponent*

targetComponent)[virtual]

当组件为模态时，此函数允许给定组件依然可以接收消息。

当激活一个模态组件并且鼠标点击一个非模态组件时，模态组件将自动调用此函数。如果返回

true，产生的事件将允许发送给目标组件。如果返回false，将阻塞所产生的事件，并回调

inputAttemptWhenModal()函数。

此函数将被isCurrentlyBlockedByAnotherModalComponent()方法所调用。默认在所有情况下

均返回false。

virtualvoidComponent::inputAttemptWhenModal()[virtual]

在当前正有一个模态组件的前提下，如果尝试点击此组件，则自动调用此函数。

当某个组件处于模态并且鼠标点击另一个组件时，模态组件将收到此回调函数。

默认情况下，此函数会发出一个警示音，并将模态组件置于最前面，重写此函数可实现其它目

的。

参见：

isCurrentlyBlockedByAnotherModalComponent,canModalEventBeSentToComponent

重新实现：Label,CallOutBox

NamedValueSet&Component::getProperties()throw()

获取此组件的属性设置。

每个组件都有一个NamedValueSet对象，可为该对象追加任意数据。

constNamedValueSet&Component::getProperties()constthrow()

获取此组件的属性设置。

每个组件都有一个NamedValueSet对象，可为该对象追加任意数据。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

53//?f=2&t=6414

constColourComponent::findColour(intcolourId,

boolinheritFromParent=false

)const

查找已经注册使用的某个颜色。

如果已经使用setColour()设置了某个颜色的ID，此函数将返回设置值。如果尚未设置颜色，

此函数将尝试调用LookAndFeel类的findColour()函数。如果外观和感觉（LAF）尚未注册该颜

色，则返回黑色。

各种各样的颜色以ID的形式存储于颜色枚举中，可参见Slider::ColourIds、

Label::ColourIds、TextEditor::ColourIds,TreeView::ColourIds等控件的颜色枚举。

参见：

setColour,isColourSpecified,colourChanged,LookAndFeel::findColour,

LookAndFeel::setColour

引用：LassoComponent::paint()

voidComponent::setColour(intcolourId,

constColour&colour

)

注册一个要使用的颜色。

更改颜色将导致同步回调colourChanged()函数，当组件所需的颜色变化时，可重写该函数以

实现更多的目的。

关于颜色ID的更多的信息，参见findColour()。

参见：

findColour,isColourSpecified,colourChanged,LookAndFeel::findColour,

LookAndFeel::setColour

voidComponent::removeColour(intcolourId)

如果某个颜色是setColour()所设置的，则移除之。

此函数将重置为默认颜色。

boolComponent::isColourSpecified(intcolourId)const

如果给定的颜色由setColour()所设置，则返回true。

voidComponent::copyAllExplicitColoursTo(Component*target)const

将此组件已经注册的颜色复制给其它组件。

virtualvoidComponent::colourChanged()[virtual]

当setColour()函数改变某个颜色时，自动调用此函数。

参见：

setColour,findColour

重新实现：HyperlinkButton,TextButton,ToggleButton,ComboBox,Label,ListBox,

ProgressBar,Slider,TextEditor,TreeView,GroupComponent,MidiKeyboardComponent

void*Component::getWindowHandle()const

返回此组件潜在的本地窗口句柄。

此函数将依赖特定的操作系统，非高级程序员不建议使用。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

54//?f=2&t=6414

引用：CarbonViewWrapperComponent::createWindow().

定义该类的头文件：

juce_Component.h

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion

bySwingCoder»WedJan05,20114:49am

******************ComponentclassEND****************************

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion(update:01-05)

bySwingCoder»WedJan05,20115:15am

LookAndFeel外观和感觉类

LookAndFeel对象用来定义所有JUCE控件的外观，其派生类可实现应用程序的“换肤”功能。

更多...

继承给：OldSchoolLookAndFeel

所有成员

public成员函数

LookAndFeel()

创建默认的JUCE外观和感觉。

virtual~LookAndFeel()

析构函数。

constColourfindColour(intcolourId)constthrow()

查找已经注册使用的某个颜色。

voidsetColour(intcolourId,constColour&colour)throw()

12-12-26

55//?f=2&t=6414

注册一个要使用的颜色。

boolisColourSpecified(intcolourId)constthrow()

如果给定的颜色由setColour()所设置，则返回true。

virtualconstTypeface::PtrgetTypefaceForFont(constFont&font)

voidsetDefaultSansSerifTypefaceName(constString&newName)

允许您更改默认的sans-serif字体。

virtualconstMouseCursorgetMouseCursorFor(Component&component)

重写此函数可使用自定义的鼠标指针。

virtualvoiddrawButtonBackground(Graphics&g,Button&button,constColour

&backgroundColour,boolisMouseOverButton,boolisButtonDown)

绘制一个具有菱形背景的标准按钮，

virtualconstFontgetFontForTextButton(TextButton&button)

virtualvoiddrawButtonText(Graphics&g,TextButton&button,bool

isMouseOverButton,boolisButtonDown)

绘制TextButton所显示的文本。

virtualvoiddrawToggleButton(Graphics&g,ToggleButton&button,bool

isMouseOverButton,boolisButtonDown)

绘制标准ToggleButton的内容。

virtualvoidchangeToggleButtonWidthToFitText(ToggleButton&button)

virtualvoiddrawTickBox(Graphics&g,Component&component,floatx,floaty,

floatw,floath,boolticked,boolisEnabled,boolisMouseOverButton,bool

isButtonDown)

virtualAlertWindow*createAlertWindow(constString&title,constString

&message,constString&button1,constString&button2,constString&button3,

AlertWindow::AlertIconTypeiconType,intnumButtons,Component

*associatedComponent)

virtualvoiddrawAlertBox(Graphics&g,AlertWindow&alert,constRectangle

&textArea,TextLayout&textLayout)

virtualintgetAlertBoxWindowFlags()

virtualintgetAlertWindowButtonHeight()

virtualconstFontgetAlertWindowFont()

virtualvoiddrawProgressBar(Graphics&g,ProgressBar&progressBar,intwidth,

intheight,doubleprogress,constString&textToShow)

绘制进度条。

virtualvoiddrawSpinningWaitAnimation(Graphics&g,constColour&colour,intx,

inty,intw,inth)

virtualvoiddrawScrollbarButton(Graphics&g,ScrollBar&scrollbar,intwidth,

intheight,intbuttonDirection,boolisScrollbarVertical,boolisMouseOverButton,

boolisButtonDown)

绘制滚动条上的按钮。

virtualvoiddrawScrollbar(Graphics&g,ScrollBar&scrollbar,intx,inty,int

width,intheight,boolisScrollbarVertical,intthumbStartPosition,int

thumbSize,boolisMouseOver,boolisMouseDown)

绘制滚动条的滑块。

virtualImageEffectFilter*getScrollbarEffect()

返回滚动条所使用的组件效果。

virtualintgetMinimumScrollbarThumbSize(ScrollBar&scrollbar)

返回滚动条滑块的最小长度，单位：像素。

virtualintgetDefaultScrollbarWidth()

返回滚动条默认的宽度。

virtualintgetScrollbarButtonSize(ScrollBar&scrollbar)

返回滚动条按钮的长度，单位：像素。

virtualconstPathgetTickShape(floatheight)

返回是否已经选择的标记形状。

12-12-26

56//?f=2&t=6414

virtualconstPathgetCrossShape(floatheight)

返回是否已经选择的交叉形状。

virtualvoiddrawTreeviewPlusMinusBox(Graphics&g,intx,inty,intw,inth,

boolisPlus,boolisMouseOver)

绘制treeview的+或-。

virtualvoidfillTextEditorBackground(Graphics&g,intwidth,intheight,

TextEditor&textEditor)

virtualvoiddrawTextEditorOutline(Graphics&g,intwidth,intheight,TextEditor

&textEditor)

virtualconstDrawable*getDefaultFolderImage()

virtualconstDrawable*getDefaultDocumentFileImage()

virtualvoidcreateFileChooserHeaderText(constString&title,constString

&instructions,GlyphArrangement&destArrangement,intwidth)

virtualvoiddrawFileBrowserRow(Graphics&g,intwidth,intheight,constString

&filename,Image*icon,constString&fileSizeDescription,constString

&fileTimeDescription,boolisDirectory,boolisItemSelected,intitemIndex,

DirectoryContentsDisplayComponent&component)

virtualButton*createFileBrowserGoUpButton()

virtualvoidlayoutFileBrowserComponent(FileBrowserComponent&browserComp,

DirectoryContentsDisplayComponent*fileListComponent,FilePreviewComponent

*previewComp,ComboBox*currentPathBox,TextEditor*filenameBox,Button

*goUpButton)

virtualvoiddrawBubble(Graphics&g,floattipX,floattipY,floatboxX,float

boxY,floatboxW,floatboxH)

virtualvoiddrawPopupMenuBackground(Graphics&g,intwidth,intheight)

填充弹出式菜单的背景。

virtualvoiddrawPopupMenuItem(Graphics&g,intwidth,intheight,bool

isSeparator,boolisActive,boolisHighlighted,boolisTicked,boolhasSubMenu,

constString&text,constString&shortcutKeyText,Image*image,constColour

*consttextColour)

绘制弹出式菜单的某个菜单项。

virtualconstFontgetPopupMenuFont()

返回弹出式菜单所使用的字型和字号。

virtualvoiddrawPopupMenuUpDownArrow(Graphics&g,intwidth,intheight,bool

isScrollUpArrow)

virtualvoidgetIdealPopupMenuItemSize(constString&text,boolisSeparator,int

standardMenuItemHeight,int&idealWidth,int&idealHeight)

找到弹出式菜单的菜单项的最佳大小。

virtualintgetMenuWindowFlags()

virtualvoiddrawMenuBarBackground(Graphics&g,intwidth,intheight,bool

isMouseOverBar,MenuBarComponent&menuBar)

virtualintgetMenuBarItemWidth(MenuBarComponent&menuBar,intitemIndex,const

String&itemText)

virtualconstFontgetMenuBarFont(MenuBarComponent&menuBar,intitemIndex,const

String&itemText)

virtualvoiddrawMenuBarItem(Graphics&g,intwidth,intheight,intitemIndex,

constString&itemText,boolisMouseOverItem,boolisMenuOpen,bool

isMouseOverBar,MenuBarComponent&menuBar)

virtualvoiddrawComboBox(Graphics&g,intwidth,intheight,boolisButtonDown,

intbuttonX,intbuttonY,intbuttonW,intbuttonH,ComboBox&box)

virtualconstFontgetComboBoxFont(ComboBox&box)

virtualLabel*createComboBoxTextBox(ComboBox&box)

virtualvoidpositionComboBoxText(ComboBox&box,Label&labelToPosition)

virtualvoiddrawLabel(Graphics&g,Label&label)

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

57//?f=2&t=6414

virtualvoiddrawLinearSlider(Graphics&g,intx,inty,intwidth,intheight,

floatsliderPos,floatminSliderPos,floatmaxSliderPos,constSlider::SliderStyle

style,Slider&slider)

virtualvoiddrawLinearSliderBackground(Graphics&g,intx,inty,intwidth,int

height,floatsliderPos,floatminSliderPos,floatmaxSliderPos,const

Slider::SliderStylestyle,Slider&slider)

virtualvoiddrawLinearSliderThumb(Graphics&g,intx,inty,intwidth,int

height,floatsliderPos,floatminSliderPos,floatmaxSliderPos,const

Slider::SliderStylestyle,Slider&slider)

virtualintgetSliderThumbRadius(Slider&slider)

virtualvoiddrawRotarySlider(Graphics&g,intx,inty,intwidth,intheight,

floatsliderPosProportional,floatrotaryStartAngle,floatrotaryEndAngle,Slider

&slider)

virtualButton*createSliderButton(boolisIncrement)

virtualLabel*createSliderTextBox(Slider&slider)

virtualImageEffectFilter*getSliderEffect()

virtualvoidgetTooltipSize(constString&tipText,int&width,int&height)

virtualvoiddrawTooltip(Graphics&g,constString&text,intwidth,intheight)

virtualButton*createFilenameComponentBrowseButton(constString&text)

virtualvoidlayoutFilenameComponent(FilenameComponent&filenameComp,ComboBox

*filenameBox,Button*browseButton)

virtualvoiddrawCornerResizer(Graphics&g,intw,inth,boolisMouseOver,bool

isMouseDragging)

virtualvoiddrawResizableFrame(Graphics&g,intw,inth,constBorderSize

&borders)

virtualvoidfillResizableWindowBackground(Graphics&g,intw,inth,const

BorderSize&border,ResizableWindow&window)

virtualvoiddrawResizableWindowBorder(Graphics&g,intw,inth,const

BorderSize&border,ResizableWindow&window)

virtualvoiddrawDocumentWindowTitleBar(DocumentWindow&window,Graphics&g,int

w,inth,inttitleSpaceX,inttitleSpaceW,constImage*icon,bool

drawTitleTextOnLeft)

virtualButton*createDocumentWindowButton(intbuttonType)

virtualvoidpositionDocumentWindowButtons(DocumentWindow&window,inttitleBarX,

inttitleBarY,inttitleBarW,inttitleBarH,Button*minimiseButton,Button

*maximiseButton,Button*closeButton,boolpositionTitleBarButtonsOnLeft)

virtualintgetDefaultMenuBarHeight()

virtualDropShadower*createDropShadowerForComponent(Component*component)

virtualvoiddrawStretchableLayoutResizerBar(Graphics&g,intw,inth,bool

isVerticalBar,boolisMouseOver,boolisMouseDragging)

virtualvoiddrawGroupComponentOutline(Graphics&g,intw,inth,constString

&text,constJustification&position,GroupComponent&group)

virtualvoidcreateTabButtonShape(Path&p,intwidth,intheight,inttabIndex,

constString&text,Button&button,TabbedButtonBar::Orientationorientation,bool

isMouseOver,boolisMouseDown,boolisFrontTab)

virtualvoidfillTabButtonShape(Graphics&g,constPath&path,constColour

&preferredBackgroundColour,inttabIndex,constString&text,Button&button,

TabbedButtonBar::Orientationorientation,boolisMouseOver,boolisMouseDown,bool

isFrontTab)

virtualvoiddrawTabButtonText(Graphics&g,intx,inty,intw,inth,const

Colour&preferredBackgroundColour,inttabIndex,constString&text,Button

&button,TabbedButtonBar::Orientationorientation,boolisMouseOver,bool

isMouseDown,boolisFrontTab)

virtualintgetTabButtonOverlap(inttabDepth)

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

58//?f=2&t=6414

virtualintgetTabButtonSpaceAroundImage()

virtualintgetTabButtonBestWidth(inttabIndex,constString&text,inttabDepth,

Button&button)

virtualvoiddrawTabButton(Graphics&g,intw,inth,constColour

&preferredColour,inttabIndex,constString&text,Button&button,

TabbedButtonBar::Orientationorientation,boolisMouseOver,boolisMouseDown,bool

isFrontTab)

virtualvoiddrawTabAreaBehindFrontButton(Graphics&g,intw,inth,

TabbedButtonBar&tabBar,TabbedButtonBar::Orientationorientation)

virtualButton*createTabBarExtrasButton()

virtualvoiddrawImageButton(Graphics&g,Image*image,intimageX,intimageY,

intimageW,intimageH,constColour&overlayColour,floatimageOpacity,

ImageButton&button)

virtualvoiddrawTableHeaderBackground(Graphics&g,TableHeaderComponent&header)

virtualvoiddrawTableHeaderColumn(Graphics&g,constString&columnName,int

columnId,intwidth,intheight,boolisMouseOver,boolisMouseDown,int

columnFlags)

virtualvoidpaintToolbarBackground(Graphics&g,intwidth,intheight,Toolbar

&toolbar)

virtualButton*createToolbarMissingItemsButton(Toolbar&toolbar)

virtualvoidpaintToolbarButtonBackground(Graphics&g,intwidth,intheight,

boolisMouseOver,boolisMouseDown,ToolbarItemComponent&component)

virtualvoidpaintToolbarButtonLabel(Graphics&g,intx,inty,intwidth,int

height,constString&text,ToolbarItemComponent&component)

virtualvoiddrawPropertyPanelSectionHeader(Graphics&g,constString&name,bool

isOpen,intwidth,intheight)

virtualvoiddrawPropertyComponentBackground(Graphics&g,intwidth,intheight,

PropertyComponent&component)

virtualvoiddrawPropertyComponentLabel(Graphics&g,intwidth,intheight,

PropertyComponent&component)

virtualconstRectanglegetPropertyComponentContentPosition

(PropertyComponent&component)

voiddrawCallOutBoxBackground(CallOutBox&box,Graphics&g,constPath&path)

virtualvoiddrawLevelMeter(Graphics&g,intwidth,intheight,floatlevel)

virtualvoiddrawKeymapChangeButton(Graphics&g,intwidth,intheight,Button

&button,constString&keyDescription)

virtualvoidplayAlertSound()

静态Public成员函数

staticLookAndFeel&getDefaultLookAndFeel()throw()

返回当前的默认look-and-feel，以供某个组件使用，如果该组件尚未显式设置LAF。

staticvoidsetDefaultLookAndFeel(LookAndFeel*newDefaultLookAndFeel)throw()

改变默认的look-and-feel。

staticvoiddrawGlassSphere(Graphics&g,floatx,floaty,floatdiameter,const

Colour&colour,floatoutlineThickness)throw()

比较有用的函数，用来绘制光晕、玻璃珠、LED式按钮等等。

staticvoiddrawGlassPointer(Graphics&g,floatx,floaty,floatdiameter,const

Colour&colour,floatoutlineThickness,intdirection)throw()

staticvoiddrawGlassLozenge(Graphics&g,floatx,floaty,floatwidth,float

height,constColour&colour,floatoutlineThickness,floatcornerSize,bool

flatOnLeft,boolflatOnRight,boolflatOnTop,boolflatOnBottom)throw()

比较有用的函数，用来绘制光晕、椭圆形按钮（文本按钮）的外观。

staticDrawable*loadDrawableFromData(constvoid*data,size_tnumBytes)

友元

JUCE_APIvoidJUCE_CALLTYPEshutdownJuce_GUI()

清除所有JUCE图形界面类的静态数据。

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion(update:01-05)

bySwingCoder»WedJan05,20115:16am

详细说明

LookAndFeel对象用来定义所有JUCE控件的外观，其派生类可实现应用程序的“换肤”功能。

构造函数和析构函数文档

LookAndFeel::LookAndFeel()

创建默认的JUCE外观和感觉。

virtualLookAndFeel::~LookAndFeel()[virtual]

析构函数。

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion(update:01-05)

bySwingCoder»WedJan05,20115:18am

成员函数文档

staticLookAndFeel&LookAndFeel::getDefaultLookAndFeel()throw()[static]

返回当前的默认look-and-feel，以供某个组件使用，如果该组件尚未显式设置LAF。

参见：

setDefaultLookAndFeel

staticvoidLookAndFeel::setDefaultLookAndFeel(LookAndFeel*

newDefaultLookAndFeel)throw()[static]

terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

60//?f=2&t=6414

改变默认的look-and-feel。

参数：

newDefaultLookAndFeel要使用的新look-and-feel对象，如果设置为0，则恢复默认。当不再

使用该对象时，要注意手工销毁之。

参见：

getDefaultLookAndFeel

constColourLookAndFeel::findColour(intcolourId)constthrow()

查找已经注册使用的某个颜色。

如果已经使用setColour()设置了某个颜色的ID，此函数将返回设置值。如果尚未设置，则返

回Colours::black。

各种各样的颜色以ID的形式存储于颜色枚举中，可参见Slider::ColourIds、

Label::ColourIds、TextEditor::ColourIds,TreeView::ColourIds等控件的颜色枚举。

如果正在寻找某个组件绘制所使用的颜色，最好不要直接调用此函数，而是使用：

Component::findColour()方法。此函数首先检测组件是否已经注册合适的颜色，如果没找

到，则随后调用组件的LookAndFeel的findColour()方法。

参见：

setColour,Component::findColour,Component::setColour

voidLookAndFeel::setColour(intcolourId,

constColour&colour

)throw()

注册一个要使用的颜色。

要获取更多信息，请参见：findColour()，

参见：

findColour,Component::findColour,Component::setColour

boolLookAndFeel::isColourSpecified(intcolourId)constthrow()

如果给定的颜色由setColour()所设置，则返回true。

virtualconstTypeface::PtrLookAndFeel::getTypefaceForFont(constFont&font

[virtual]

voidLookAndFeel::setDefaultSansSerifTypefaceName(constString&newName)

允许您更改默认的sans-serif字体。

如果打算使用你自己的Typeface对象来替代默认的字体，而不是仅仅提供名称，比如：如果打

算使用一个嵌入式字体，则必须重写getTypefaceForFont()以创建并返回一个字体。

virtualconstMouseCursorLookAndFeel::getMouseCursorFor(Component*component)

[virtual]

重写此函数可使用自定义的鼠标指针。

virtualvoidLookAndFeel::drawButtonBackground(Graphics&g,

Button&button,

constColour&backgroundColour,

boolisMouseOverButton,

boolisButtonDown

)[virtual]

绘制一个具有菱形背景的标准按钮，

12-12-26

61//?f=2&t=6414

ReimplementedinOldSchoolLookAndFeel.

virtualconstFontLookAndFeel::getFontForTextButton(TextButton&button,

[virtual]

virtualvoidLookAndFeel::drawButtonText(Graphics&g,

TextButton&button,

boolisMouseOverButton,

boolisButtonDown

)[virtual]

绘制TextButton所显示的文本。

virtualvoidLookAndFeel::drawToggleButton(Graphics&g,

ToggleButton&button,

boolisMouseOverButton,

boolisButtonDown

)[virtual]

绘制标准ToggleButton的内容。

重新实现：OldSchoolLookAndFeel

virtualvoidLookAndFeel::changeToggleButtonWidthToFitText(ToggleButton&

button,[virtual]

virtualvoidLookAndFeel::drawTickBox(Graphics&g,

Component&component,

floatx,

floaty,

floatw,

floath,

boolticked,

boolisEnabled,

boolisMouseOverButton,

boolisButtonDown

)[virtual]

ReimplementedinOldSchoolLookAndFeel.

virtualAlertWindow*LookAndFeel::createAlertWindow(constString&title,

constString&message,

constString&button1,

constString&button2,

constString&button3,

AlertWindow::AlertIconTypeiconType,

intnumButtons,

Component*associatedComponent

)[virtual]

virtualvoidLookAndFeel::drawAlertBox(Graphics&g,

AlertWindow&alert,

constRectangle&textArea,

TextLayout&textLayout

)[virtual]

virtualintLookAndFeel::getAlertBoxWindowFlags()[virtual]

virtualintLookAndFeel::getAlertWindowButtonHeight()[virtual]

virtualconstFontLookAndFeel::getAlertWindowFont()[virtual]

virtualvoidLookAndFeel::drawProgressBar(Graphics&g,

ProgressBar&progressBar,

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

62//?f=2&t=6414

intwidth,

intheight,

doubleprogress,

constString&textToShow

)[virtual]

绘制进度条。

如果进度小于0或大于1.0，将绘制一个旋转的进度块并填充整个区域。也就是说，程序正忙，

无法获取进度。可以使用当前时间为基准来播放动画效果。

(被具有进度条的AlertWindow所使用)。

ReimplementedinOldSchoolLookAndFeel.

virtualvoidLookAndFeel::drawSpinningWaitAnimation(Graphics&g,

constColour&colour,

intx,

inty,

intw,

inth,

)[virtual]

virtualvoidLookAndFeel::drawScrollbarButton(Graphics&g,

ScrollBar&scrollbar,

intwidth,

intheight,

intbuttonDirection,

boolisScrollbarVertical,

boolisMouseOverButton,

boolisButtonDown

)[virtual]

绘制滚动条上的按钮。

参数：

g要绘制的图形环境

scrollbar滚动条本身

width按钮宽度

height按钮高度

buttonDirection按钮方向：0为向上，1为向右，2为向下，3为向左

isScrollbarVerticaltrue为垂直滚动条，false为水平滚动条

isMouseOverButton鼠标是否指向按钮，如果按钮被按下，则为true

isButtonDown是否按下了鼠标按钮

重新实现：OldSchoolLookAndFeel

virtualvoidLookAndFeel::drawScrollbar(Graphics&g,

ScrollBar&scrollbar,

intx,

inty,

intwidth,

intheight,

boolisScrollbarVertical,

intthumbStartPosition,

intthumbSize,

boolisMouseOver,

boolisMouseDown

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

/?f=2&t=6414

)[virtual]

绘制滚动条的滑块。

参数：

g要绘制的图形环境

scrollbar滚动条本身

x滑块区域左边缘的X坐标

y滑块区域顶边缘的Y坐标

width滑块区域的宽度

height滑块区域的高度

isScrollbarVerticaltrue为垂直滚动条，false为水平滚动条

thumbStartPosition垂直滚动条滑块的顶边缘y坐标，水平滚动条的左边缘x坐标

thumbSize垂直滚动条的滑块高度，水平滚动条的滑块宽度。如果不打算绘制滑块，可设置为

0。

isMouseOver鼠标是否指向滑块区域，鼠标拖拉滑块时也为true

isMouseDown鼠标是否拖拉滑块

重新实现：OldSchoolLookAndFeel

virtualImageEffectFilter*LookAndFeel::getScrollbarEffect()[virtual]

返回滚动条所使用的组件效果。

重新实现：OldSchoolLookAndFeel

virtualintLookAndFeel::getMinimumScrollbarThumbSize(ScrollBar&scrollbar)

[virtual]

返回滚动条滑块的最小长度，单位：像素。

virtualintLookAndFeel::getDefaultScrollbarWidth()[virtual]

返回滚动条默认的宽度。

virtualintLookAndFeel::getScrollbarButtonSize(ScrollBar&scrollbar)[virtual]

返回滚动条按钮的长度，单位：像素。

virtualconstPathLookAndFeel::getTickShape(floatheight)[virtual]

返回是否已经选择的标记形状。

virtualconstPathLookAndFeel::getCrossShape(floatheight)[virtual]

返回是否已经选择的交叉形状。

virtualvoidLookAndFeel::drawTreeviewPlusMinusBox(Graphics&g,

intx,

inty,

intw,

inth,

boolisPlus,

boolisMouseOver

)[virtual]

绘制treeview的+或-。

virtualvoidLookAndFeel::fillTextEditorBackground(Graphics&g,

intwidth,

intheight,

TextEditor&textEditor

)[virtual]

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

64//?f=2&t=6414

virtualvoidLookAndFeel::drawTextEditorOutline(Graphics&g,

intwidth,

intheight,

TextEditor&textEditor

)[virtual]

重新实现：OldSchoolLookAndFeel

virtualconstDrawable*LookAndFeel::getDefaultFolderImage()[virtual]

virtualconstDrawable*LookAndFeel::getDefaultDocumentFileImage()[virtual]

virtualvoidLookAndFeel::createFileChooserHeaderText(constString&title,

constString&instructions,

GlyphArrangement&destArrangement,

intwidth

)[virtual]

virtualvoidLookAndFeel::drawFileBrowserRow(Graphics&g,

intwidth,

intheight,

constString&filename,

Image*icon,

constString&fileSizeDescription,

constString&fileTimeDescription,

boolisDirectory,

boolisItemSelected,

intitemIndex,

DirectoryContentsDisplayComponent&component

)[virtual]

virtualButton*LookAndFeel::createFileBrowserGoUpButton()[virtual]

virtualvoidLookAndFeel::layoutFileBrowserComponent(FileBrowserComponent&

browserComp,

DirectoryContentsDisplayComponent*fileListComponent,

FilePreviewComponent*previewComp,

ComboBox*currentPathBox,

TextEditor*filenameBox,

Button*goUpButton

)[virtual]

virtualvoidLookAndFeel::drawBubble(Graphics&g,

floattipX,

floattipY,

floatboxX,

floatboxY,

floatboxW,

floatboxH

)[virtual]

virtualvoidLookAndFeel::drawPopupMenuBackground(Graphics&g,

intwidth,

intheight

)[virtual]

填充弹出式菜单的背景。

重新实现：OldSchoolLookAndFeel

virtualvoidLookAndFeel::drawPopupMenuItem(Graphics&g,

intwidth,

intheight,

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

/?f=2&t=6414

boolisSeparator,

boolisActive,

boolisHighlighted,

boolisTicked,

boolhasSubMenu,

constString&text,

constString&shortcutKeyText,

Image*image,

constColour*consttextColour

)[virtual]

绘制弹出式菜单的某个菜单项。

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion(update:01-05)

bySwingCoder»WedJan05,20115:20am

virtualconstFontLookAndFeel::getPopupMenuFont()[virtual]

返回弹出式菜单所使用的字型和字号。

virtualvoidLookAndFeel::drawPopupMenuUpDownArrow(Graphics&g,

intwidth,

intheight,

boolisScrollUpArrow

)[virtual]

virtualvoidLookAndFeel::getIdealPopupMenuItemSize(constString&text,

boolisSeparator,

intstandardMenuItemHeight,

intidealWidth,

intidealHeight

)[virtual]

找到弹出式菜单的菜单项的最佳大小。

virtualintLookAndFeel::getMenuWindowFlags()[virtual]

virtualvoidLookAndFeel::drawMenuBarBackground(Graphics&g,

intwidth,

intheight,

boolisMouseOverBar,

MenuBarComponent&menuBar

)[virtual]

重新实现：OldSchoolLookAndFeel

virtualintLookAndFeel::getMenuBarItemWidth(MenuBarComponent&menuBar,

intitemIndex,

constString&itemText

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

66//?f=2&t=6414

)[virtual]

virtualconstFontLookAndFeel::getMenuBarFont(MenuBarComponent&menuBar,

intitemIndex,

constString&itemText

)[virtual]

virtualvoidLookAndFeel::drawMenuBarItem(Graphics&g,

intwidth,

intheight,

intitemIndex,

constString&itemText,

boolisMouseOverItem,

boolisMenuOpen,

boolisMouseOverBar,

MenuBarComponent&menuBar

)[virtual]

virtualvoidLookAndFeel::drawComboBox(Graphics&g,

intwidth,

intheight,

boolisButtonDown,

intbuttonX,

intbuttonY,

intbuttonW,

intbuttonH,

ComboBox&box

)[virtual]

重新实现：OldSchoolLookAndFeel

virtualconstFontLookAndFeel::getComboBoxFont(ComboBox&box)[virtual]

重新实现：OldSchoolLookAndFeel

virtualLabel*LookAndFeel::createComboBoxTextBox(ComboBox&box)[virtual]

virtualvoidLookAndFeel::positionComboBoxText(ComboBox&box,

Label&labelToPosition

)[virtual]

virtualvoidLookAndFeel::drawLabel(Graphics&g,

Label&label

)[virtual]

virtualvoidLookAndFeel::drawLinearSlider(Graphics&g,

intx,

inty,

intwidth,

intheight,

floatsliderPos,

floatminSliderPos,

floatmaxSliderPos,

constSlider::SliderStylestyle,

Slider&slider

)[virtual]

重新实现：OldSchoolLookAndFeel

virtualvoidLookAndFeel::drawLinearSliderBackground(Graphics&g,

intx,

inty,

intwidth,

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

67//?f=2&t=6414

intheight,

floatsliderPos,

floatminSliderPos,

floatmaxSliderPos,

constSlider::SliderStylestyle,

Slider&slider

)[virtual]

virtualvoidLookAndFeel::drawLinearSliderThumb(Graphics&g,

intx,

inty,

intwidth,

intheight,

floatsliderPos,

floatminSliderPos,

floatmaxSliderPos,

constSlider::SliderStylestyle,

Slider&slider

)[virtual]

virtualintLookAndFeel::getSliderThumbRadius(Slider&slider)[virtual]

重新实现：OldSchoolLookAndFeel

virtualvoidLookAndFeel::drawRotarySlider(Graphics&g,

intx,

inty,

intwidth,

intheight,

floatsliderPosProportional,

floatrotaryStartAngle,

floatrotaryEndAngle,

Slider&slider

)[virtual]

virtualButton*LookAndFeel::createSliderButton(boolisIncrement)[virtual]

重新实现：OldSchoolLookAndFeel

virtualLabel*LookAndFeel::createSliderTextBox(Slider&slider)[virtual]

virtualImageEffectFilter*LookAndFeel::getSliderEffect()[virtual]

重新实现：OldSchoolLookAndFeel

virtualvoidLookAndFeel::getTooltipSize(constString&tipText,

intwidth,

intheight

)[virtual]

virtualvoidLookAndFeel::drawTooltip(Graphics&g,

constString&text,

intwidth,

intheight,

)[virtual]

virtualButton*LookAndFeel::createFilenameComponentBrowseButton(constString&

text)[virtual]

virtualvoidLookAndFeel::layoutFilenameComponent(FilenameComponent&

filenameComp,

ComboBox*filenameBox,

Button*browseButton

)[virtual]

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

68//?f=2&t=6414

virtualvoidLookAndFeel::drawCornerResizer(Graphics&g,

intw,

inth,

boolisMouseOver,

boolisMouseDragging

)[virtual]

重新实现：OldSchoolLookAndFeel

virtualvoidLookAndFeel::drawResizableFrame(Graphics&g,

intw,

inth,

constBorderSize&borders

)[virtual]

virtualvoidLookAndFeel::fillResizableWindowBackground(Graphics&g,

intw,

inth,

constBorderSize&border,

ResizableWindow&window

)[virtual]

virtualvoidLookAndFeel::drawResizableWindowBorder(Graphics&g,

intw,

inth,

constBorderSize&border,

ResizableWindow&window

)[virtual]

virtualvoidLookAndFeel::drawDocumentWindowTitleBar(DocumentWindow&window,

Graphics&g,

intw,

inth,

inttitleSpaceX,

inttitleSpaceW,

constImage*icon,

booldrawTitleTextOnLeft

)[virtual]

virtualButton*LookAndFeel::createDocumentWindowButton(intbuttonType)

[virtual]

重新实现：OldSchoolLookAndFeel

virtualvoidLookAndFeel::positionDocumentWindowButtons(DocumentWindow&window,

inttitleBarX,

inttitleBarY,

inttitleBarW,

inttitleBarH,

Button*minimiseButton,

Button*maximiseButton,

Button*closeButton,

boolpositionTitleBarButtonsOnLeft

)[virtual]

重新实现：OldSchoolLookAndFeel

virtualintLookAndFeel::getDefaultMenuBarHeight()[virtual]

virtualDropShadower*LookAndFeel::createDropShadowerForComponent(Component*

component)[virtual]

virtualvoidLookAndFeel::drawStretchableLayoutResizerBar(Graphics&g,

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

69//?f=2&t=6414

intw,

inth,

boolisVerticalBar,

boolisMouseOver,

boolisMouseDragging

)[virtual]

virtualvoidLookAndFeel::drawGroupComponentOutline(Graphics&g,

intw,

inth,

constString&text,

constJustification&position,

GroupComponent&group

)[virtual]

virtualvoidLookAndFeel::createTabButtonShape(Path&p,

intwidth,

intheight,

inttabIndex,

constString&text,

Button&button,

TabbedButtonBar::Orientationorientation,

boolisMouseOver,

boolisMouseDown,

boolisFrontTab

)[virtual]

virtualvoidLookAndFeel::fillTabButtonShape(Graphics&g,

constPath&path,

constColour&preferredBackgroundColour,

inttabIndex,

constString&text,

Button&button,

TabbedButtonBar::Orientationorientation,

boolisMouseOver,

boolisMouseDown,

boolisFrontTab

)[virtual]

virtualvoidLookAndFeel::drawTabButtonText(Graphics&g,

intx,

inty,

intw,

inth,

constColour&preferredBackgroundColour,

inttabIndex,

constString&text,

Button&button,

TabbedButtonBar::Orientationorientation,

boolisMouseOver,

boolisMouseDown,

boolisFrontTab

)[virtual]

virtualintLookAndFeel::getTabButtonOverlap(inttabDepth)[virtual]

virtualintLookAndFeel::getTabButtonSpaceAroundImage()[virtual]

virtualintLookAndFeel::getTabButtonBestWidth(inttabIndex,

constString&text,

inttabDepth,

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

70//?f=2&t=6414

Button&button

)[virtual]

virtualvoidLookAndFeel::drawTabButton(Graphics&g,

intw,

inth,

constColour&preferredColour,

inttabIndex,

constString&text,

Button&button,

TabbedButtonBar::Orientationorientation,

boolisMouseOver,

boolisMouseDown,

boolisFrontTab

)[virtual]

virtualvoidLookAndFeel::drawTabAreaBehindFrontButton(Graphics&g,

intw,

inth,

TabbedButtonBar&tabBar,

TabbedButtonBar::Orientation{0}orientation{/0},

)[virtual]

virtualButton*LookAndFeel::createTabBarExtrasButton()[virtual]

virtualvoidLookAndFeel::drawImageButton(Graphics&g,

Image*image,

intimageX,

intimageY,

intimageW,

intimageH,

constColour&overlayColour,

floatimageOpacity,

ImageButton&button

)[virtual]

virtualvoidLookAndFeel::drawTableHeaderBackground(Graphics&g,

TableHeaderComponent&header

)[virtual]

virtualvoidLookAndFeel::drawTableHeaderColumn(Graphics&g,

constString&columnName,

intcolumnId,

intwidth,

intheight,

boolisMouseOver,

boolisMouseDown,

intcolumnFlags

)[virtual]

virtualvoidLookAndFeel::paintToolbarBackground(Graphics&g,

intwidth,

intheight,

Toolbar&toolbar

)[virtual]

virtualButton*LookAndFeel::createToolbarMissingItemsButton(Toolbar&toolbar)

[virtual]

virtualvoidLookAndFeel::paintToolbarButtonBackground(Graphics&g,

intwidth,

intheight,

boolisMouseOver,

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

71//?f=2&t=6414

boolisMouseDown,

ToolbarItemComponent&component

)[virtual]

virtualvoidLookAndFeel::paintToolbarButtonLabel(Graphics&g,

intx,

inty,

intwidth,

intheight,

constString&text,

ToolbarItemComponent&component

)[virtual]

virtualvoidLookAndFeel::drawPropertyPanelSectionHeader(Graphics&g,

constString&name,

boolisOpen,

intwidth,

intheight

)[virtual]

virtualvoidLookAndFeel::drawPropertyComponentBackground(Graphics&g,

intwidth,

intheight,

PropertyComponent&component

)[virtual]

virtualvoidLookAndFeel::drawPropertyComponentLabel(Graphics&g,

intwidth,

intheight,

PropertyComponent&component

)[virtual]

virtualconstRectangleLookAndFeel::getPropertyComponentContentPosition(

PropertyComponent&component)[virtual]

voidLookAndFeel::drawCallOutBoxBackground(CallOutBox&box,

Graphics&g,

constPath&path

)

virtualvoidLookAndFeel::drawLevelMeter(Graphics&g,

intwidth,

intheight,

floatlevel

)[virtual]

virtualvoidLookAndFeel::drawKeymapChangeButton(Graphics&g,

intwidth,

intheight,

Button&button,

constString&keyDescription

)[virtual]

virtualvoidLookAndFeel::playAlertSound()[virtual]

staticvoidLookAndFeel::drawGlassSphere(Graphics&g,

floatx,

floaty,

floatdiameter,

constColour&colour,

floatoutlineThickness

)throw()[static]

比较有用的函数，用来绘制光晕、玻璃珠、LED式按钮等等。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

/?f=2&t=6414

staticvoidLookAndFeel::drawGlassPointer(Graphics&g,

floatx,

floaty,

floatdiameter,

constColour&colour,

floatoutlineThickness,

intdirection

)throw()[static]

staticvoidLookAndFeel::drawGlassLozenge(Graphics&g,

floatx,

floaty,

floatwidth,

floatheight,

constColour&colour,

floatoutlineThickness,

floatcornerSize,

boolflatOnLeft,

boolflatOnRight,

boolflatOnTop,

boolflatOnBottom

)throw()[static]

比较有用的函数，用来绘制光晕、椭圆形按钮（文本按钮）的外观。

staticDrawable*LookAndFeel::loadDrawableFromData(constvoid*data,

size_tnumBytes

)[static]

友元和相关函数文档

JUCE_APIvoidJUCE_CALLTYPEshutdownJuce_GUI()[friend]

清除JUCE界面类所使用的所有静态数据。

如果采用嵌入式的方法使用JUCE类库，而不是使用START_JUCE_APPLICATION宏来启动应用程

序，在关闭事件处理代码中调用此函数，以清除程序中所使用的JUCE对象。

参见：

initialiseJuce_GUI(),initialiseJuce_NonGUI()

定义该类的头文件：

juce_LookAndFeel.h

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion(update:01-05)

bySwingCoder»WedJan05,20115:35am

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

73//?f=2&t=6414

String字符串类

JUCE字符串类。更多...

所有成员

类

classConcatenator

一个用于提高性能的辅助类，用于连接较大的字符串。更多...

Public成员函数

String()throw()

创建一个空字符串。

String(constString&other)throw()

创建另一个字符串的副本。

String(constchar*text)

由零结束符的字符数组创建一个字符串。

String(constchar*text,size_tmaxChars)

由字符数组创建一个字符串。

String(constjuce_wchar*unicodeText)

由零结束符unicode字符数组创建一个字符串。

String(constjuce_wchar*unicodeText,size_tmaxChars)

由unicode字符数组创建一个字符串。

~String()throw()

析构函数。

inthashCode()constthrow()

生成该字符串可能唯一的32位哈希编码（hashcode）。

int64hashCode64()constthrow()

生成该字符串可能唯一的64位哈希编码（hashcode）。

intlength()constthrow()

返回字符串中的字符数。

String&operator=(constString&other)throw()

用另一个字符串替换该字符串的内容。

String&operator+=(constjuce_wchar*textToAppend)

将另一个字符串追加到该字符串的末尾。

String&operator+=(constString&stringToAppend)

将另一个字符串追加到该字符串的末尾。

String&operator+=(charcharacterToAppend)

将字符追加到该字符串的末尾。

String&operator+=(juce_wcharcharacterToAppend)

将字符追加到该字符串的末尾。

String&operator+=(intnumberToAppend)

将一个十进制数字追加到此字符串的末尾。

String&operator+=(unsignedintnumberToAppend)

将一个十进制数字追加到此字符串的末尾。

voidappend(constjuce_wchar*textToAppend,intmaxCharsToTake)

将一个字符数组追加到该字符串的末尾。

boolisEmpty()constthrow()

如果该字符串不包含任何字符，则返回true。

boolisNotEmpty()constthrow()

如果该字符串至少包含一个字符，则返回true。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

74//?f=2&t=6414

boolequalsIgnoreCase(constString&other)constthrow()

字符串比较，忽略大小写。

boolequalsIgnoreCase(constjuce_wchar*other)constthrow()

字符串比较，忽略大小写。

boolequalsIgnoreCase(constchar*other)constthrow()

字符串比较，忽略大小写。

intcompare(constString&other)constthrow()

字符串比较，区分大小写。

intcompare(constchar*other)constthrow()

字符串比较，区分大小写。

intcompare(constjuce_wchar*other)constthrow()

字符串比较，区分大小写。

intcompareIgnoreCase(constString&other)constthrow()

字符串比较，忽略大小写。

intcompareLexicographically(constString&other)constthrow()

字符串比较，按字典排序。

boolstartsWith(constString&text)constthrow()

测试该字符串的开始是否为另一个字符串。

boolstartsWithChar(juce_wcharcharacter)constthrow()

测试该字符串的开头是否为特定的字符。

boolstartsWithIgnoreCase(constString&text)constthrow()

测试该字符串的开始是否为另一个字符串。

boolendsWith(constString&text)constthrow()

测试该字符串的最后部分是否为另一个字符串。

boolendsWithChar(juce_wcharcharacter)constthrow()

测试该字符串是否以特定的字符结尾。

boolendsWithIgnoreCase(constString&text)constthrow()

测试该字符串的最后部分是否为另一个字符串。

boolcontains(constString&text)constthrow()

测试该字符串是否包含另一个字符串。

boolcontainsChar(juce_wcharcharacter)constthrow()

测试该字符串是否包含特定的字符。

boolcontainsIgnoreCase(constString&text)constthrow()

测试该字符串是否包含另一个字符串。

boolcontainsWholeWord(constString&wordToLookFor)constthrow()

测试该字符串是否包含另一个字符串。

boolcontainsWholeWordIgnoreCase(constString&wordToLookFor)constthrow()

测试该字符串是否包含另一个字符串。

intindexOfWholeWord(constString&wordToLookFor)constthrow()

查找另一个字符串的实例，前提是参数字符串为字典单词（不包含数字和特殊符号的字符

串）。

intindexOfWholeWordIgnoreCase(constString&wordToLookFor)constthrow()

查找另一个字符串的实例，前提是参数字符串为字典单词（不包含数字和特殊符号的字符

串）。

boolcontainsAnyOf(constString&charactersItMightContain)constthrow()

测试两个字符串是否有相同的字符。

boolcontainsOnly(constString&charactersItMightContain)constthrow()

检测两个字符串是否有相同字符。

boolcontainsNonWhitespaceChars()constthrow()

如果此字符串中包含非空白字符则返回true。

boolmatchesWildcard(constString&wildcard,boolignoreCase)constthrow()

如果该字符串匹配给出的通配符表达式，则返回true。

intindexOfChar(juce_wcharcharacterToLookFor)constthrow()

搜索此字符串内的某个字符。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

75//?f=2&t=6414

intindexOfChar(intstartIndex,juce_wcharcharacterToLookFor)constthrow()

搜索此字符串内的某个字符。

intindexOfAnyOf(constString&charactersToLookFor,intstartIndex=0,bool

ignoreCase=false)constthrow()

返回与给出的字符串中的任意一个字符相匹配的字符的索引位置。

intindexOf(constString&text)constthrow()

在该字符串中搜索给出的子字符串。

intindexOf(intstartIndex,constString&textToLookFor)constthrow()

在该字符串中搜索给出的子字符串。

intindexOfIgnoreCase(constString&textToLookFor)constthrow()

在该字符串中搜索给出的子字符串。

intindexOfIgnoreCase(intstartIndex,constString&textToLookFor)constthrow()

在该字符串中搜索给出的子字符串。

intlastIndexOfChar(juce_wcharcharacter)constthrow()

在该字符串中搜索给出的字符（由后向前查找）。

intlastIndexOf(constString&textToLookFor)constthrow()

在该字符串中搜索给出的字符串（由后向前查找）。

intlastIndexOfIgnoreCase(constString&textToLookFor)constthrow()

在该字符串中搜索给出的字符串（由后向前查找）。

intlastIndexOfAnyOf(constString&charactersToLookFor,boolignoreCase=false)

constthrow()

由后至前搜索，如果找到给定字符串的任意一个字符，则返回该字符所在的索引位置。

constjuce_wchar&operator[](intindex)constthrow()

按索引值返回该字符串的某个字符。

juce_wchar&operator[](intindex)

返回字符串中的某个字符，此方法也可以直接给该字符赋值，以改变之。

juce_wchargetLastCharacter()constthrow()

返回字符串的最后一个字符。

constStringsubstring(intstartIndex,intendIndex)const

提取字符串的部分内容。

constStringsubstring(intstartIndex)const

提取字符串的后半部分。

constStringdropLastCharacters(intnumberToDrop)const

返回去掉最后几个字符的该字符串。

constStringgetLastCharacters(intnumCharacters)const

返回该字符串最后的部分，返回几个字符由给出的参数确定。

constStringfromFirstOccurrenceOf(constString&substringToStartFrom,bool

includeSubStringInResult,boolignoreCase)const

返回由给定的子字符串为开始的后半部分内容。

constStringfromLastOccurrenceOf(constString&substringToFind,bool

includeSubStringInResult,boolignoreCase)const

返回由给定的子字符串为结尾的一部分内容。

constStringupToFirstOccurrenceOf(constString&substringToEndWith,bool

includeSubStringInResult,boolignoreCase)const

返回此字符串开头的一部分，直至遇到给出的字符串。

constStringupToLastOccurrenceOf(constString&substringToFind,bool

includeSubStringInResult,boolignoreCase)const

返回此字符串开头的一部分，直至给出的字符串不再出现。

constStringtrim()const

删除开头和末尾的空格字符，而后返回。

constStringtrimStart()const

删除开头的空格字符，而后返回。

constStringtrimEnd()const

删除末尾的空格字符，而后返回。

constStringtrimCharactersAtStart(constString&charactersToTrim)const

从开始处删除给定的字符串，而后返回。

constStringtrimCharactersAtEnd(constString&charactersToTrim)const

由后往前删除给定的字符串，而后返回。

constStringtoUpperCase()const

返回此字符串的大写版本。

constStringtoLowerCase()const

返回此字符串的小写版本。

constStringreplaceSection(intstartIndex,intnumCharactersToReplace,const

String&stringToInsert)const

用另一个字符串替换该字符串的一部分内容。

constStringreplace(constString&stringToReplace,constString

&stringToInsertInstead,boolignoreCase=false)const

用另一个字符串替换本字符串。

constStringreplaceCharacter(juce_wcharcharacterToReplace,juce_wchar

characterToInsertInstead)const

替换该字符串的某个字符。

constStringreplaceCharacters(constString&charactersToReplace,constString

&charactersToInsertInstead)const

替换该字符串中的某些字符。

constStringretainCharacters(constString&charactersToRetain)const

仅保留参数字符串所包含的字符。

constStringremoveCharacters(constString&charactersToRemove)const

移除某些字符。

constStringinitialSectionContainingOnly(constString&permittedCharacters)

const

从该字符串的开头处返回不包含特定字符集合的内容。

constStringinitialSectionNotContaining(constString&charactersToStopAt)const

从该字符串的开头处返回不包含特定字符集合的内容。

boolisQuotedString()const

检查该字符串是否以引号开头。

constStringunquoted()const

如包含引号则删之。

constStringquoted(juce_wcharquoteCharacter=\'\"\')const

前后添加引号。

constStringpaddedLeft(juce_wcharpadCharacter,intminimumLength)const

指定的字符重复添加到该字符串的开始处，直到总长度达到所指定的长度。

constStringpaddedRight(juce_wcharpadCharacter,intminimumLength)const

指定的字符重复添加到该字符串的结束处，直到总长度达到所指定的长度。

String(intdecimalInteger)

创建一个32位整数的十进制数字文本字符串。

String(unsignedintdecimalInteger)

创建一个32位正整数的十进制数字文本字符串。

String(shortdecimalInteger)

创建一个16位整数的十进制数字文本字符串。

String(unsignedshortdecimalInteger)

创建一个16位正整数的十进制数字文本字符串。

String(int64largeIntegerValue)

创建一个64位整数的十进制数字文本字符串。

String(uint64largeIntegerValue)

创建一个64位正整数的十进制数字文本字符串。

String(floatfloatValue,intnumberOfDecimalPlaces=0)

创建一个浮点型数字的文本字符串。

String(doubledoubleValue,intnumberOfDecimalPlaces=0)

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

77//?f=2&t=6414

创建一个浮点型数字的文本字符串。

intgetIntValue()constthrow()

将字符串的值转为十进制数字（最多32位大小）。

int64getLargeIntValue()constthrow()

将字符串的值转为十进制数字（最多64位大小）。

intgetTrailingIntValue()constthrow()

提取字符串结尾的十进制数字。

floatgetFloatValue()constthrow()

提取字符串的浮点型数字。

doublegetDoubleValue()constthrow()

提取字符串的浮点型数字。

intgetHexValue32()constthrow()

提取字符串的16进制数字。

int64getHexValue64()constthrow()

提取字符串的16进制数字。

operatorconstjuce_wchar*()constthrow()

返回此字符串的unicode版本。

operatorjuce_wchar*()throw()

返回此字符串的unicode版本。

constchar*toUTF8()const

返回此字符串的UTF-8版本的指针。

intgetNumBytesAsUTF8()constthrow()

返回此字符串表示UTF8格式所需的字节数。

intcopyToUTF8(char*destBuffer,intmaxBufferSizeBytes)constthrow()

将字符串作为UTF-8字符复制到缓冲区中。

constchar*toCString()const

返回此字符串使用默认的8位多字节系统编码的版本。

intgetNumBytesAsCString()constthrow()

返回此字符串的字节数。

intcopyToCString(char*destBuffer,intmaxBufferSizeBytes)constthrow()

将字符串复制到缓冲区中。

voidcopyToUnicode(juce_wchar*destBuffer,intmaxCharsToCopy)constthrow()

将字符串复制到unicode缓冲区中。

voidpreallocateStorage(size_tnumCharsNeeded)

为此字符串增加内部分配的存储区。

voidswapWith(String&other)throw()

交换两个字符串的内容。

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion(update:01-05)

bySwingCoder»WedJan05,20115:37am

静态Public成员函数

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

78//?f=2&t=6414

staticconstStringcharToString(juce_wcharcharacter)

将单个字符转换为字符串。

staticconstStringrepeatedString(constString&stringToRepeat,int

numberOfTimesToRepeat)

将一个字符串重复多次后形成一个新的字符串。

staticconstStringcreateStringFromData(constvoid*data,intsize)

将一个未知格式的数据转换为字符串。

staticconstStringformatted(constjuce_wchar*formatString,...)

以printf样式为参数列表来创建一个字符串。

staticconstStringtoHexString(intnumber)

创建十进制数字的32位十六进制数字字符串。

staticconstStringtoHexString(int64number)

创建十进制数字的64位十六进制数字字符串。

staticconstStringtoHexString(shortnumber)

创建十进制数字的16位十六进制数字。

staticconstStringtoHexString(constunsignedchar*data,intsize,int

groupSize=1)

创建一个字符串，其中包含块的二进制数据的十六进制转储。

staticconstStringfromUTF8(constchar*utf8buffer,intbufferSizeBytes=-1)

从UTF-8编码的缓冲区中创建一个String。

静态Public属性

staticconstStringempty

清空字符串的内容，使之变成空字符串。

详细说明

JUCE字符串类。

JUCE字符串类使用引用计数的内部表示形式，提供高效而卓越的性能，包含了大量极具实用价

值的方法。

参见：

StringArray,StringPairArray

构造函数和析构函数文档

String::String()throw()

创建一个空字符串。

参见：

empty

String::String(constString&other)throw()

创建另一个字符串的副本（拷贝构造函数）。

String::String(constchar*text)

由零结束符的字符数组创建一个字符串。

假定字符串存储为系统默认的编码格式。

String::String(constchar*text,

size_tmaxChars

)

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

/?f=2&t=6414

由字符数组创建一个字符串。

字符串将使用前maxChars个字符（或少于此值，如果字符串实际上较短）。

String::String(constjuce_wchar*unicodeText)

由零结束符unicode字符数组创建一个字符串。

String::String(constjuce_wchar*unicodeText,

size_tmaxChars

)

由unicode字符数组创建一个字符串。

字符串将使用前maxChars个字符（或少于此值，如果字符串实际上较短）。

String::~String()throw()

析构函数。

String::String(intdecimalInteger)[explicit]

创建一个32位整数的十进制数字文本字符串。

参见：

getIntValue,getFloatValue,getDoubleValue,toHexString

String::String(unsignedintdecimalInteger)[explicit]

创建一个32位正整数的十进制数字文本字符串。

参见：

getIntValue,getFloatValue,getDoubleValue,toHexString

String::String(shortdecimalInteger)[explicit]

创建一个16位整数的十进制数字文本字符串。

参见：

getIntValue,getFloatValue,getDoubleValue,toHexString

String::String(unsignedshortdecimalInteger)[explicit]

创建一个16位正整数的十进制数字文本字符串。

参见：

getIntValue,getFloatValue,getDoubleValue,toHexString

String::String(int64largeIntegerValue)[explicit]

创建一个64位整数的十进制数字文本字符串。

参见：

getLargeIntValue,getFloatValue,getDoubleValue,toHexString

String::String(uint64largeIntegerValue)[explicit]

创建一个64位正整数的十进制数字文本字符串。

参见：

getLargeIntValue,getFloatValue,getDoubleValue,toHexString

String::String(floatfloatValue,

intnumberOfDecimalPlaces=0

)[explicit]

创建一个浮点型数字的文本字符串。

参数：

floatValue要转换为字符串的数值

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

80//?f=2&t=6414

numberOfDecimalPlaces如果大于0，则小数位为该值，并且不使用指数表示法。小于等于0的

情况下，如有必要则使用指数表示法。

参见：

getDoubleValue,getIntValue

String::String(doubledoubleValue,

intnumberOfDecimalPlaces=0

)[explicit]

创建一个浮点型数字的文本字符串。

参数：

doubleValue要转换为字符串的数值

numberOfDecimalPlaces如果大于0，则小数位为该值，并且不使用指数表示法。小于等于0

的情况下，如有必要，则使用指数表示法。

参见：

getFloatValue,getIntValue

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

Re:JUCEAPIdocument-Chinesevesion(update:01-05)

bySwingCoder»WedJan05,20115:39am

成员函数文档

staticconstStringString::charToString(juce_wcharcharacter)[static]

将单个字符转换为字符串。

intString::hashCode()constthrow()

生成该字符串可能唯一的32位哈希编码（hashcode）。

int64String::hashCode64()constthrow()

生成该字符串可能唯一的64位哈希编码（hashcode）。

intString::length()constthrow()

返回字符串中的字符数。

String&String::operator=(constString&other)throw()

用另一个字符串替换该字符串的内容。

String&String::operator+=(constjuce_wchar*textToAppend)

将另一个字符串追加到该字符串的末尾。

String&String::operator+=(constString&stringToAppend)

将另一个字符串追加到该字符串的末尾。

String&String::operator+=(charcharacterToAppend)

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

81//?f=2&t=6414

将字符追加到该字符串的末尾。

String&String::operator+=(juce_wcharcharacterToAppend)

将字符追加到该字符串的末尾。

String&String::operator+=(intnumberToAppend)

将一个十进制数字追加到此字符串的末尾。

String&String::operator+=(unsignedintnumberToAppend)

将一个十进制数字追加到此字符串的末尾。

voidString::append(constjuce_wchar*textToAppend,

intmaxCharsToTake

)

将一个字符数组追加到该字符串的末尾。

参数：

textToAppend要添加的字符串

maxCharsToTake添加前几个字符

boolString::isEmpty()constthrow()

如果该字符串不包含任何字符，则返回true。

注意：还可使用判断非空的函数isNotEmpty()。

参见：

containsNonWhitespaceChars()

boolString::isNotEmpty()constthrow()

如果该字符串至少包含一个字符，则返回true。

注意：还可使用判断是否为空的函数isEmpty()。

参见：

containsNonWhitespaceChars()

boolString::equalsIgnoreCase(constString&other)constthrow()

字符串比较，忽略大小写。

boolString::equalsIgnoreCase(constjuce_wchar*other)constthrow()

字符串比较，忽略大小写。

boolString::equalsIgnoreCase(constchar*other)constthrow()

字符串比较，忽略大小写。

intString::compare(constString&other)constthrow()

字符串比较，区分大小写。

返回：

如果两个字符串相同则返回0。如果此字符串的字典顺序在前，则返回负数，否则返回正数。

intString::compare(constchar*other)constthrow()

字符串比较，区分大小写。

返回：

如果两个字符串相同则返回0。如果此字符串的字典顺序在前，则返回负数，否则返回正数。

intString::compare(constjuce_wchar*other)constthrow()

字符串比较，区分大小写。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

82//?f=2&t=6414

返回：

如果两个字符串相同则返回0。如果此字符串的字典顺序在前，则返回负数，否则返回正数。

intString::compareIgnoreCase(constString&other)constthrow()

字符串比较，忽略大小写。

返回：

如果两个字符串相同则返回0。如果此字符串的字典顺序在前，则返回负数，否则返回正数。

intString::compareLexicographically(constString&other)constthrow()

字符串比较，按字典排序。

比较操作不区分大小写，并忽略非字母和数字性质的字符的排序。

返回：

如果两个字符串相同则返回0。如果此字符串的字典顺序在前，则返回负数，否则返回正数。

boolString::startsWith(constString&text)constthrow()

测试该字符串的开始是否为另一个字符串。

如果参数为空字符串，则始终返回true。此方法区分大小写。

boolString::startsWithChar(juce_wcharcharacter)constthrow()

测试该字符串的开头是否为特定的字符。

如果字符为0，则始终返回false。此方法区分大小写。

boolString::startsWithIgnoreCase(constString&text)constthrow()

测试该字符串的开始是否为另一个字符串。

如果参数为空字符串，则始终返回true。此方法区分大小写。

boolString::endsWith(constString&text)constthrow()

测试该字符串的最后部分是否为另一个字符串。

如果参数为空字符串，则始终返回true。此方法区分大小写。

boolString::endsWithChar(juce_wcharcharacter)constthrow()

测试该字符串是否以特定的字符结尾。

如果字符为0，则始终返回false。此方法区分大小写。

boolString::endsWithIgnoreCase(constString&text)constthrow()

测试该字符串的最后部分是否为另一个字符串。

如果参数为空字符串，则始终返回true。此方法区分大小写。

boolString::contains(constString&text)constthrow()

测试该字符串是否包含另一个字符串。

如果参数为空字符串，则始终返回true。此方法区分大小写。

boolString::containsChar(juce_wcharcharacter)constthrow()

测试该字符串是否包含特定的字符。

此方法区分大小写。

boolString::containsIgnoreCase(constString&text)constthrow()

测试该字符串是否包含另一个字符串。

此方法区分大小写。

boolString::containsWholeWord(constString&wordToLookFor)constthrow()

测试该字符串是否包含另一个字符串。

返回：

如果该字符串包含给出的参数，则返回true。注意参数字符串的首尾不能是非字母和数字性质

的字符。

参见：

indexOfWholeWord,containsWholeWordIgnoreCase

boolString::containsWholeWordIgnoreCase(constString&wordToLookFor)const

throw()

测试该字符串是否包含另一个字符串。

返回：

如果该字符串包含给出的参数，则返回true。注意参数字符串的首尾不能是非字母和数字性质

的字符。

参见：

indexOfWholeWordIgnoreCase,containsWholeWord

intString::indexOfWholeWord(constString&wordToLookFor)constthrow()

查找另一个字符串的实例，前提是参数字符串为字典单词（不包含数字和特殊符号的字符

串）。

返回：

此方法返回参数字符串在本字符串的起始位置。注意，参数字符串的首尾不能是非字母和数字

性质的字符。如果不包含参数字符串，则返回-1。

参见：

indexOfWholeWordIgnoreCase,containsWholeWord

intString::indexOfWholeWordIgnoreCase(constString&wordToLookFor)const

throw()

查找另一个字符串的实例，前提是参数字符串为字典单词（不包含数字和特殊符号的字符

串）。

返回：

此方法返回参数字符串在本字符串的起始位置。注意，参数字符串的首尾不能是非字母和数字

性质的字符。如果不包含参数字符串，则返回-1。

参见：

indexOfWholeWord,containsWholeWordIgnoreCase

boolString::containsAnyOf(constString&charactersItMightContain)constthrow

()

测试两个字符串是否有相同的字符。

此方法区分大小写。

返回：

如果该字符串包含参数字符串中的任意一个字符，则返回true。

boolString::containsOnly(constString&charactersItMightContain)constthrow

()

检测两个字符串是否有相同字符。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

84//?f=2&t=6414

此方法区分大小写。

返回：

如果参数字符串中的所有字符均未出现在该字符串中，则返回false。如果该字符串为空，则

始终返回true。

boolString::containsNonWhitespaceChars()constthrow()

如果此字符串中包含非空白字符则返回true。

如果字符串包含空格字符，或者为空，则返回false。

此函数等价于：().isNotEmpty()

boolString::matchesWildcard(constString&wildcard,

boolignoreCase

)constthrow()

如果该字符串匹配给出的通配符表达式，则返回true。

比如：String(\"abcdef\").matchesWildcard(\"*DEF\",true);//返回true。

注意：此函数并非规范的正则表达式，仅支持“*”和“?”这两种通配符。主要用于文件名通

配。

intString::indexOfChar(juce_wcharcharacterToLookFor)constthrow()

搜索此字符串内的某个字符。

此方法区分大小写。

返回：

返回值为第一次出现的位置。如果未找到则返回-1。

intString::indexOfChar(intstartIndex,

juce_wcharcharacterToLookFor

)constthrow()

搜索此字符串内的某个字符。

此方法区分大小写。

参数：

startIndex从该位置起向后搜索

characterToLookFor要查找的字符

返回：

返回值为第一次出现的位置。如果未找到则返回-1。

intString::indexOfAnyOf(constString&charactersToLookFor,

intstartIndex=0,

boolignoreCase=false

)constthrow()

返回与给出的字符串中的任意一个字符相匹配的字符的索引位置。

此函数从索引为startIndex的位置开始向后搜索，如果找到charactersToLookFor字符串中的

任意一个字符，则立即返回其索引位置。

如果没有找到，则返回-1。

如果ignoreCase为true，则不区分大小写。

12-12-26terialSoftwareɡViewtopic-JUCEAPIdocument-Chineseversion-Alldone!

/?f=2&t=6414

参见：

indexOfChar,lastIndexOfAnyOf

intString::indexOf(constString&text)constthrow()

在该字符串中搜索给出的子字符串。

此方法区分大小写。

返回：

参数字符串首次出现的索引位置。如果没找到，则返回-1。

Windows7X64,VS2010,LatestJUCEtip

SwingCoder

JUCEUberWeenie

Posts:1158

Joined:ThuOct07,20104:44pm

Top

NextDisplaypostsfromprevious:AllpostsSortbyPosttimeAscending

Go

Writecomments

1014posts•Page1of68•1,2,3,4,5...68

ReturntoGeneralJUCEdiscussion

Jumpto:GeneralJUCEdiscussionGo

Whoisonline

Usersbrowsingthisforum:Noregisteredusersand2guests

Home»Boardindex

Deleteallboardcookies•AlltimesareUTC[DST]

Allcontent©2010RawMaterialSoftwareLtd.

WebsitepoweredbyphpBB©2000,2002,2005,2007phpBBGroup