...

Application - PowerBuilder

by user

on
Category: Documents
1627

views

Report

Comments

Transcript

Application - PowerBuilder
オブジェクトとコントロール
PowerBuilder®
10.2.1
DOCUMENT ID: DC37787-01-1020-01
LAST REVISED: April 2005
Copyright ©1991-2006 by Sybase, Inc. All rights reserved.
本書に記載されているソフトウェアは、Sybase ライセンス契約に基づいて Sybase, Inc. が提供し、かかる契約の条項に従う
場合にのみ使用が許諾されます。
本書に記載されている内容は、Sybase, Inc. およびその関連会社の書面による許可なく、いかなる形態、または手段、電子
的、機械的、手作業、光学的およびその他にかかわらず、複製、転載および翻訳を禁じます。
Sybase, Sybase(ロ ゴ), AccelaTrade, ADA Workbench, Adaptable Windowing Environment, Adaptive Component Architecture,
Adaptive Server, Adaptive Server Anywhere, Adaptive Server Enterprise, Adaptive Server Enterprise Monitor, Adaptive Server
Enterprise Replication, Adaptive Server Everywhere, Adaptive Server IQ, Adaptive Warehouse, Anywhere Studio, Application
Manager, AppModeler, APT Workbench, APT-Build, APT-Edit, APT-Execute, APT-Translator, APT-Library, AvantGo, AvantGo
Application Alerts, AvantGo Mobile Delivery, AvantGo Mobile Document Viewer, AvantGo Mobile Inspection, AvantGo Mobile
Marketing Channel, AvantGo Mobile Pharma, AvantGo Mobile Sales, AvantGo Pylon, AvantGo Pylon Application Server, AvantGo
Pylon Conduit, AvantGo Pylon PIM Server, AvantGo Pylon Pro, Backup Server, BizTracker, ClearConnect, Client-Library, Client
Services, Convoy/DM, Copernicus, Data Pipeline, Data Workbench, DataArchitect, Database Analyzer, DataExpress, DataServer,
DataWindow, DB-Library, dbQueue, Developers Workbench, Direct Connect Anywhere, DirectConnect, Distribution Director, e-ADK,
E-Anywhere, e-Biz Impact, e-Biz Integrator, E-Whatever, EC Gateway, ECMAP, ECRTP, eFulfillment Accelerator, Embedded SQL,
EMS, Enterprise Application Studio, Enterprise Client/Server, Enterprise Connect, Enterprise Data Studio, Enterprise Manager,
Enterprise SQL Server Manager, Enterprise Work Architecture, Enterprise Work Designer, Enterprise Work Modeler, eProcurement
Accelerator, EWA, Financial Fusion, Financial Fusion Server, Gateway Manager, GlobalFIX, iAnywhere, ImpactNow, Industry
Warehouse Studio, InfoMaker, Information Anywhere, Information Everywhere, InformationConnect, InternetBuilder, iScript, Jaguar
CTS, jConnect for JDBC, Mail Anywhere Studio, MainframeConnect, Maintenance Express, Manage Anywhere Studio, M-Business
Channel, M-Business Network, M-Business Server, MDI Access Server, MDI Database Gateway, media.splash, MetaWorks, My
AvantGo, My AvantGo Media Channel, My AvantGo Mobile Marketing, MySupport, Net-Gateway, Net-Library, New Era of Networks,
ObjectConnect, ObjectCycle, OmniConnect, OmniSQL Access Module, OmniSQL Toolkit, Open Biz, Open Client, Open
ClientConnect, Open Client/Server, Open Client/Server Interfaces, Open Gateway, Open Server, Open ServerConnect, Open Solutions,
Optima++, Orchestration Studio, PB-Gen, PC APT Execute, PC DB-Net, PC Net Library, PocketBuilder, Pocket PowerBuilder,
Power++, power.stop, PowerAMC, PowerBuilder, PowerBuilder Foundation Class Library, PowerDesigner, PowerDimensions,
PowerDynamo, PowerJ, PowerScript, PowerSite, PowerSocket, Powersoft, PowerStage, PowerStudio, PowerTips, Powersoft Portfolio,
Powersoft Professional, PowerWare Desktop, PowerWare Enterprise, ProcessAnalyst, Rapport, RepConnector, Replication Agent,
Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit, Report-Execute, Report Workbench, Resource
Manager, RW-DisplayLib, RW-Library, S-Designor, SDF, Secure SQL Server, Secure SQL Toolset, Security Guardian, SKILS,
smart.partners, smart.parts, smart.script, SQL Advantage, SQL Anywhere, SQL Anywhere Studio, SQL Code Checker, SQL Debug,
SQL Edit, SQL Edit/TPU, SQL Everywhere, SQL Modeler, SQL Remote, SQL Server, SQL Server Manager, SQL SMART, SQL
Toolset, SQL Server/CFT, SQL Server/DBM, SQL Server SNMP SubAgent, SQL Station, SQLJ, STEP, SupportNow, S.W.I.F.T.
Message Format Libraries, Sybase Central, Sybase Client/Server Interfaces, Sybase Financial Server, Sybase Gateways, Sybase MPP,
Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Workgroup, Sybase User Workbench, SybaseWare, Syber Financial,
SyberAssist, SyBooks, System 10, System 11, System XI(ロゴ), SystemTools, Tabular Data Stream, TotalFix, TradeForce, TransactSQL, Translation Toolkit, UltraLite, UltraLite.NET, UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit for UniCode,
VisualWriter, VQL, WarehouseArchitect, Warehouse Control Center, Warehouse Studio, Warehouse WORKS, Watcom, Watcom SQL,
Watcom SQL Server, Web Deployment Kit, Web.PB, Web.SQL, WebSights, WebViewer, WorkGroup SQL Server, XA-Library, XAServer および XP Server は Sybase, Inc の登録商標です。
Unicode および Unicode のロゴは Unicode, Inc. の登録商標です。
本書で使用される会社名および製品名はそれぞれの会社の商標および登録商標です。
本書に記載されている内容は、将来予告なしに変更することがあります。また、本ソフトウェアおよび説明書を使用した
ことによる損害、または第三者からのいかなる請求についても、サイベース株式会社、その親会社である米国法人 Sybase,
Inc. またはその関連会社は、一切の責任を負わないものとします。
目次
本書について ................................................................................................................................. vii
第1章
第2章
PowerBuilder システム オブジェクトとシステム コントロール..
システム オブジェクトについて ......................................................
システム オブジェクト プロパティ、イベントおよび関数 .............
システム オブジェクト継承階層 ......................................................
マニュアルに記載されていない基本クラス オブジェクト .......
システム オブジェクトの表示 .........................................................
1
1
2
3
3
4
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
7
ADOResultSet オブジェクト .................................................... 8
Animation コントロール ............................................................ 9
Application オブジェクト ........................................................ 12
ArrayBounds オブジェクト ..................................................... 15
CheckBox コントロール ......................................................... 16
ClassDefinition オブジェクト.................................................. 22
CommandButton コントロール............................................... 24
Connection オブジェクト........................................................ 29
ContextInformation オブジェクト ........................................... 35
ContextKeyword オブジェクト ............................................... 36
CORBACurrent オブジェクト ................................................. 37
CORBAObject オブジェクト................................................... 39
DataStore オブジェクト.......................................................... 41
DataWindow コントロール ..................................................... 50
DataWindowChild オブジェクト ............................................. 68
DropDownListBox コントロール ............................................. 74
DropDownPictureListBox コントロール .................................. 81
DynamicDescriptionArea オブジェクト .................................. 90
DynamicStagingArea オブジェクト ........................................ 93
EditMask コントロール ........................................................... 95
EnumerationDefinition オブジェクト .................................... 103
EnumerationItemDefinition オブジェクト ............................. 105
オブジェクトとコントロール
iii
目次
Environment オブジェクト....................................................
Error オブジェクト................................................................
ErrorLogging オブジェクト ...................................................
Exception オブジェクト ........................................................
Graph コントロール..............................................................
grAxis オブジェクト..............................................................
grDispAttr オブジェクト........................................................
GroupBox コントロール........................................................
HProgressBar コントロール .................................................
HScrollBar コントロール.......................................................
HTrackBar コントロール.......................................................
Inet オブジェクト..................................................................
InkEdit コントロール.............................................................
InkPicture コントロール........................................................
InternetResult オブジェクト .................................................
JaguarORB オブジェクト .....................................................
Line コントロール .................................................................
ListBox コントロール ............................................................
ListView コントロール ..........................................................
ListViewItem オブジェクト ...................................................
mailFileDescription オブジェクト .........................................
mailMessage オブジェクト...................................................
mailRecipient オブジェクト ..................................................
mailSession オブジェクト ....................................................
MDIClient オブジェクト ........................................................
Menu オブジェクト...............................................................
MenuCascade オブジェクト.................................................
Message オブジェクト .........................................................
MonthCalendar コントロール ...............................................
Edit コントロール..................................................................
OLEControl コントロール .....................................................
OLECustomControl コントロール(OCX)...........................
OLEObject オブジェクト ......................................................
OLEStorage オブジェクト ....................................................
OLEStream オブジェクト .....................................................
OLETxnObject オブジェクト ................................................
Oval コントロール ................................................................
Picture コントロール.............................................................
PictureButton コントロール ..................................................
PictureHyperLink コントロール ............................................
PictureListBox コントロール.................................................
Pipeline オブジェクト ...........................................................
ProfileCall オブジェクト .......................................................
ProfileClass オブジェクト.....................................................
iv
106
108
109
110
112
118
122
124
128
132
135
139
140
147
154
155
156
158
165
177
179
180
181
182
184
186
190
194
196
202
209
216
223
225
227
228
230
232
237
243
248
256
257
259
PowerBuilder
目次
ProfileLine オブジェクト .......................................................
ProfileRoutine オブジェクト .................................................
Profiling オブジェクト...........................................................
RadioButton コントロール ....................................................
Rectangle コントロール........................................................
ResultSet オブジェクト ........................................................
ResultSets オブジェクト ......................................................
RichTextEdit コントロール ...................................................
RoundRectangle コントロール .............................................
RuntimeError オブジェクト ..................................................
ScriptDefinition オブジェクト................................................
SimpleTypeDefinition オブジェクト......................................
SingleLineEdit コントロール .................................................
SSLCallBack オブジェクト...................................................
SSLServiceProvider オブジェクト........................................
StaticHyperLink コントロール...............................................
StaticText コントロール ........................................................
Tab コントロール..................................................................
Throwable オブジェクト .......................................................
Timing オブジェクト .............................................................
TraceActivityNode オブジェクト...........................................
TraceBeginEnd オブジェクト ...............................................
TraceError オブジェクト.......................................................
TraceESQL オブジェクト .....................................................
TraceFile オブジェクト .........................................................
TraceGarbageCollect オブジェクト......................................
TraceLine オブジェクト ........................................................
TraceObject オブジェクト ....................................................
TraceRoutine オブジェクト ..................................................
TraceTree オブジェクト .......................................................
TraceTreeError オブジェクト ...............................................
TraceTreeESQL オブジェクト..............................................
TraceTreeGarbageCollect オブジェクト ..............................
TraceTreeLine オブジェクト ................................................
TraceTreeNode オブジェクト...............................................
TraceTreeObject オブジェクト.............................................
TraceTreeRoutine オブジェクト...........................................
TraceTreeUser オブジェクト................................................
TraceUser オブジェクト .......................................................
Transaction オブジェクト .....................................................
TransactionServer オブジェクト ..........................................
TreeView コントロール.........................................................
TreeViewItem オブジェクト..................................................
TypeDefinition オブジェクト.................................................
オブジェクトとコントロール
260
261
263
265
270
272
273
274
284
286
288
291
291
297
299
300
305
311
318
319
320
322
323
324
325
326
328
329
330
331
333
334
335
336
337
338
339
340
341
342
344
346
357
360
v
目次
UserObject オブジェクト......................................................
VariableCardinalityDefinition オブジェクト...........................
VariableDefinition オブジェクト............................................
VProgressBar コントロール .................................................
VScrollBar コントロール.......................................................
VTrackBar コントロール.......................................................
Window コントロール ...........................................................
362
368
369
371
375
378
382
第3章
プロパティの説明と使用法 ................................. 395
第4章
表示書式とスクロールについて .............................
表示書式に色を使用する..............................................................
日付の表示書式を使用する ..........................................................
数値の表示書式を使用する ..........................................................
文字列の表示書式を使用する ......................................................
時刻の表示書式を使用する ..........................................................
ウィンドウおよびユーザ オブジェクト内でのスクロール ..........
575
575
576
578
579
579
581
Index ........................................................................................................................................... 583
vi
PowerBuilder
本書について
対象読者
本書は、PowerBuilder® を使用してクライアント / サーバまたは多
層アプリケーションを作成するプログラマを対象に書かれていま
す。本書では、PowerBuilder のシステム定義オブジェクトと、その
デフォルト プロパティ、関数およびイベントについて解説します。
関連マニュアル
本書で記載されているプロパティ、関数、およびイベントの詳細
については、
『PowerScript リファレンス』マニュアルおよび『デー
タウィンドウ リファレンス』マニュアルを参照してください。
PowerBuilder のすべてのマニュアルの一覧については、
『PowerBuilder
入門』を参照してください。
そのほかの情報
製品に関するそのほかの詳細情報については、Sybase の テクニカ
ル ライブラリ CD、およびテクニカル ライブラリ製品マニュアル
Web サイト(英語)を参照してください。
•
ソフトウェア付属の テクニカル ライブラリ CD には、製品マ
ニュアルが収められています。製品マニュアルは、PDF 形式
にて提供しています。
テクニカル ライブラリ CD の使い方については、テクニカル
ライブラリ CD 内の Readme.txt ファイルを参照してください。
•
表記規則
テクニカル ライブラリ製品マニュアルの Web サイト(英語)
には、Product Manuals のサイト
http://www.sybase.com/support/manuals/ からアクセスできます。
このマニュアルは、以下の表記規則に準拠して記述されています。
表記例
Retrieve および
Update
意味
説明文で使用されている場合、左記フォントは次
の項目のいずれかを示します。
• コマンド名、関数名、メソッド名
• true、false、null などのキーワード
• Integer 型、Char 型などのデータ型
• emp_id、f_name などのデータベース カラム名
• dw_emp、w_main などのユーザ定義オブジェ
クト
オブジェクトとコントロール
vii
表記例
意味
変数(variable)
説明文や構文の説明で使用されている場合、斜
または
体フォントは次の項目のいずれかを示します。
ファイル名
(file name) • myCounter などの変数名
• pblname.pbd など、入力が必要な入力テキスト
の一部
[ファイル|上書き
保存]
dw_1.Update()
• ファイルとパス名
メニュー名やメニュー項目は、単純なテキスト
で記述されています。縦棒(|)は、メニュー
の選択順序を示します。たとえば、
[ファイル|
上書き保存]は、
「[ファイル]メニューから[上
書き保存]を選択する」ことを示します。
このフォントは、次の項目のいずれかを示します。
• ダイアログボックスやコマンド ラインに入力
する情報
• サンプル スクリプトの一部
• サンプル出力の一部
サポートについて
viii
製品に同梱している「サポート ハンドブック」を参照してください。
PowerBuilder
第 1 章
PowerBuilder システム オブジェクト
とシステム コントロール
この章について
この章では、PowerBuilder システム オブジェクトとシステム コン
トロールに関する情報の概要を記載します。また、本書に記載さ
れていない PowerBuilder システム オブジェクトを一覧し、記載さ
れなかった理由を説明します。
内容
項目
システム オブジェクトについて
システム オブジェクト プロパティ、イベントおよび関数
システム オブジェクト継承階層
システム オブジェクトの表示
ページ
1
2
3
4
システム オブジェクトについて
システム オブジェクト
PowerBuilder システム クラス オブジェクトは、アプリケーション
を 作 成 す る た め に 使 用 す る 組 み 込 み オ ブ ジ ェ ク ト で す。
PowerBuilder システム オブジェクトには、ウィンドウやメニュー、
グラフィカル コントロールなどのオブジェクトと、Message オブ
ジェクトや Error オブジェクトなど、アプリケーションで参照する
定義済みエンティティが含まれます。
コントロール
PowerBuilder コントロールは、ウィンドウやユーザ オブジェクト
に 配 置 す る シ ス テ ム オ ブ ジ ェ ク ト の サ ブ セ ッ ト で す。通 常、
PowerBuilder コントロールは、グラフィカル オブジェクトで、ユー
ザはこれを使うことでアプリケーションでの作業が可能になり、
開発者はウィンドウのデザインの拡張にこれを使用します。
システム構造体
PowerBuilder システム構造体は、ほかのシステム オブジェクトや
システムそのものの状態を記述するプロパティを含むシステム オ
ブジェクトのサブセットです。たとえば、Environment オブジェク
トは、実行中の PowerBuilder Application オブジェクトのプラット
フォーム情報を保持する構造体です。
オブジェクトとコントロール
1
システム オブジェクト プロパティ、イベントおよび関数
システム オブジェクト プロパティ、イベントおよび関数
プロパティ
各システム オブジェクトは、自身の特性を定義する複数のプロパティ
を持っています。たとえば、チェックボックス コントロールには、サ
イ ズ を 制 御 す る Height、Width プ ロ パ テ ィ や、背 景 色 を 制 御 す る
BackColor プロパティがあります。オブジェクト プロパティの値は、ス
クリプト内またはペインタ内で利用可能なオブジェクトのプロパティ
シートを使って設定することができます。
イベント
PowerBuilder アプリケーションは、イベント駆動型です。たとえば、
ユーザがボタンをクリックした場合、メニューから項目を選択した場
合、エディット ボックスにデータを入力した場合などに、イベントが
発 生 し ま す。イ ベ ン ト が 発 生 し た と き の 処 理 を 指 定 す る に は、
PowerBuilder 言語である PowerScript® を使ってスクリプトを記述しま
す。PowerBuilder は、ポインタの座標などの引数をイベントに渡すこ
とで、アプリケーションにユーザがイベントを発生させるために行っ
た動作を解釈させます。ほとんどのイベントでは、ほかのイベントを
発生させるなど、次の動作に作用するリターン コードを指定すること
ができます。
グループボックスを除いたコントロールと描画オブジェクト(Line(直
線)、Oval(楕円)、Rectangle(長方形)、RoundRectangle(丸長方形))
は、常に関連するイベントを持っています。システム構造体などのシ
ステム オブジェクトの中には、関連するイベントを持たないものもあ
ります。
関数
2
PowerScript は、アプリケーション内でオブジェクトやコントロールに
作用する豊富な組み込み関数を提供します。各システム オブジェクト
には、オブジェクトに作用する組み込み関数のセットがあります。こ
れらの関数をスクリプトで使ってオブジェクトを操作します。
PowerBuilder
第1章
PowerBuilder システム オブジェクトとシステム コントロール
システム オブジェクト継承階層
継承
PowerBuilder の最も強力な機能の 1 つが継承です。継承を使うと、既
存のオブジェクトから派生するウィンドウ、ユーザ オブジェクト、メ
ニューを構築することができます。別のオブジェクトから継承するオ
ブジェクトを構築する場合は、先祖オブジェクトと子孫オブジェクト
の階層構造(またはツリー構造)を作成します。
基本クラス オブジェ
クト
階層構造の最上部にあるオブジェクトは基本クラス オブジェクトで、
ほかのオブジェクトはこのオブジェクトの子孫です。それぞれの子孫
は、その先祖から定義を継承しています。基本クラス オブジェクトは、
通常、汎用処理を実装し、各子孫は継承された処理を必要に応じて修
正します。
システム オブジェク
ト階層
PowerBuilder システム オブジェクトは、階層を形成します。階層の最
上部は、PowerObject で、このマニュアルに記述されているすべての
オブジェクトとコントロールはこの基本クラスから継承されていま
す。また、この階層には、アプリケーション開発では通常使用されな
いが、論理的な階層編成に必要なほかの(汎用的な)基本クラス オブ
ジェクトも含まれています。
マニュアルに記載されていない基本クラス オブジェクト
子孫オブジェクトの汎用的なプロパティと関数を提供する主要な関数
の基本クラス オブジェクトはマニュアルに記載されていません。これ
らのオブジェクトは、通常、アプリケーションでは使用されないため
です。マニュアルに記載されていない基本クラス システム オブジェク
トは、以下のとおりです。
ClassDefinitionObject
ConnectObject
DragObject
DrawObject
DWObject
ExtObject
Function_Object
GraphicObject
NonVisualObject
OmControl
OmCustomControl
OmEmbeddedControl
OmObject
OmStorage
オブジェクトとコントロール
3
システム オブジェクトの表示
OmStream
ORB
PBtoCPPObject
PowerObject
RemoteObject
Service
Structure
WindowObject
システム オブジェクトの表示
オブジェクト ブラウ
ザの使い方
PowerBuilder から PowerBuilder オブジェクトブラウザを使用すると、
システム オブジェクトとそのプロパティ、イベント、関数に関するリ
ストを一覧することができます。
•
システム オブジェクトを表示するには、オブジェクト ブラウザの
[システム]タブを選択します。デフォルトの表示では、オブジェ
クトがアルファベット順にリストされています。
•
オブジェクトの階層構造を表示するには、左のペインにカーソル
を置き、右クリックをして[階層の表示]を選択します。
•
特定のオブジェクトのプロパティ、イベント、関数を表示するに
は、左のペインのオブジェクトを選択し、右のペインの[プロパ
ティ]、
[イベント]、[関数]をダブルクリックします。
PowerBuilder システム ブラウザの使い方については、PowerBuilder の
『ユーザーズ ガイド』マニュアルを参照してください。
オンライン ヘルプの
使い方
4
PowerBuilder オンライン ヘルプを使って、システム オブジェクトとコ
ントロールのプロパティ、イベント、関数の詳細なヘルプ トピックを
参照することもできます。
•
システム オブジェクトまたはコントロールの名前が分かっている
場合は、[キーワード]タブを使って、適切なトピックを直接表示
します。
•
ヘルプ トピックスにあるシステム オブジェクトとシステム コン
トロールのリストを表示するには、ヘルプの目次リストから「オ
ブジェクトとコントロール」を選択します。
•
ブラウザで、システム オブジェクト、システム コントロール、ま
たはその関数のいずれかのポップアップ メニューから[ヘルプ]
を選択します。
PowerBuilder
第1章
PowerBuilder システム オブジェクトとシステム コントロール
基本オブジェクトのヘルプは利用できない
カスタム クラス(NonVisualObject)から継承した基本オブジェク
トのポップアップ メニューで[ヘルプ]を選択すると、カスタム
クラス(NonVisualObject)のヘルプ トピックが表示されます。そ
のほかの基本オブジェクトについては、ブラウザのヘルプ トピッ
クが表示されます。
オブジェクトとコントロール
5
システム オブジェクトの表示
6
PowerBuilder
第 2 章
PowerBuilder システム オブジェクト
のプロパティ、イベント、関数
この章について
この章では、PowerBuilder システム オブジェクトおよびコント
ロールのプロパティ、イベント、関数について解説します。なお、
基本クラス オブジェクトについては説明しません。
内容
オブジェクトとコントロールはアルファベット順に記載されてい
ます。
オブジェクトとコントロール
7
ADOResultSet オブジェクト
ADOResultSet オブジェクト
ADOResultSet オブジェクトにより、PowerBuilder で、ADO(ActiveX
Data Object)レコード セットを使用してクライアントに結果集合を返
し、ADO Recordset を操作することができます。
プロパティ
ADOResultSet
プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する情報
を含む PowerObject 型のオブジェクトです。
イベント
ADOResultSet イベント
Constructor
Destructor
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
関数
ADOResultSet 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
GetRecordSet
PostEvent
PowerObject
Integer
Boolean
SetRecordSet
Integer
SetResultSet
Integer
TriggerEvent
Integer
TypeOf
Object
8
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
現行の ADO Recordset を返します。
オブジェクトのメッセージ キューの最後にイベントを追加
します。
渡された ADO Recordset からデータを取得するように
ADOResultSet オブジェクトを設定します。
渡された ResultSet オブジェクトのデータを新しい
ADOResultSet オブジェクトに読み込みます。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
Animation コントロール
Animation コントロールは、圧縮されていない Audio-Video Interleaved
(AVI)ファイルまたはランレングス圧縮(BI_RLE8)された AVI ファ
イルの AVI クリップを表示できます。
プロパティ
Animation プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
AnimationName
AutoPlay
AccessibleRole
(カタログ デー
タ型)
String
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
AVI クリップを格納しているファイルの名前を指定しま
す。音声を含む AVI クリップは使用できません。
AVI クリップが開かれるとすぐにアニメーションを開始
するかどうかを示します。値は以下のとおりです。
TRUE - コントロールが開かれるとアニメーションを
自動的に再生します。
FALSE - コントロールが開かれてもアニメーションを
Border
Boolean
自動的に再生しません(デフォルト)。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
オブジェクトとコントロール
9
Animation コントロール
Animation プロパティ
ClassDefinition
データ型
PowerObject
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
Height
OriginalSize
Integer
Boolean
コントロールの高さを PowerBuilder 単位系で示します。
Animation コントロールの幅と高さに AVI クリップのサイ
ズを設定するかどうかを示します。値は以下のとおりで
す。
TRUE - 幅と高さをオリジナルの値にします。
FALSE - 幅と高さを既存のままとし、オリジナルの値
にしません。
Pointer
String
PowerTipText
TabOrder
Long
Integer
Tag
String
10
ウィンドウ ペインタで OriginalSize プロパティを TRUE に
設定すると、既存の幅と高さが上書きされます。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
コントロールの PowerTip を示します。
ウィンドウ内部のアニメーションのタブ値(順序)を指定
します(0 を指定すると、ユーザはコントロールにタブ移
動できません)。
コントロールに割り当てるタグの値を示します。
PowerBuilder
第2章
Animation プロパティ
Transparent
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
コントロールの背景をそのコントロールが配置される
ウィンドウの背景と一致させることによって、コントロー
ルを透過にするかどうかを示します。値は以下のとおりで
す。
TRUE - コントロールを透過にします。
FALSE - コントロールを透過にしません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で示します。
イベント
Animation イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
Start
Stop
発生する状況
コントロールがクリックされたとき(選択されたとき)
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されて、アクティブ状態に
なるとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
アニメーションの再生が開始されたとき
アニメーションの再生が停止されたとき
オブジェクトとコントロール
11
Application オブジェクト
関数
Animation 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
Play
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Integer
Boolean
Resize
Seek
SetFocus
SetPosition
Integer
Integer
Integer
Integer
SetRedraw
Integer
Show
Stop
TriggerEvent
Integer
Integer
Integer
TypeOf
Object
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの AVI クリップの再生を開始します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールのサイズを変更します。
AVI クリップの指定されたフレームを表示します。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティまたは内容を変更するたびに、
コントロールを自動再描画するかどうかを設定します。
コントロールを表示します。
コントロールの AVI クリップの再生を停止します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
Application オブジェクト
Application(アプリケーション)オブジェクトとは、PowerBuilder ウィ
ンドウの集合であり、受発注処理や会計処理などのユーザ処理を実行
するための機能を提供するオブジェクトです。Application オブジェク
トは、アプリケーションへの入口を提供します。
ユーザがアプリケーションを実行すると、Application オブジェクトの
Open イベントが起動します。この Open イベントに対して、アプリケー
ション内のすべての処理を初期化するスクリプトが実行されます。
12
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
Application プロパティ
AppName
ClassDefinition
データ型
String
PowerObject
DDETimeOut
Integer
DisplayName
String
DWMessageTitle
String
FreeDBLibraries
Boolean
MicroHelpDefault
String
RightToLeft
Boolean
ToolbarFrameTitle
String
オブジェクトとコントロール
説明
Application オブジェクトの名前を示します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
PowerBuilder が、DDE クライアントとして DDE サーバと
通信するときに、通信を中断するまでの待ち時間を示しま
す(デフォルトは 10 秒)。
ユーザに表示するアプリケーション名を示します。たとえ
ば、この名前は OLE 関連のダイアログボックスにアプリ
ケーション名として表示されます。特に値が指定されてい
ない場合には、
DisplayName プロパティのかわりに AppName
プロパティが使用されます。
アプリケーションの実行中に発生したデータウィンドウ
エラーのメッセージ ボックスのタイトルを示します。こ
のプロパティの値をスクリプトで変更した場合、新しい値
は、その設定後に作成(またはペイント)されたデータ
ウィンドウでのみ認識されます。
PowerBuilder がデータベースとの接続を解除すると、デー
タベース インタフェース ライブラリを解放するかどうか
を示します。デフォルトは FALSE です(PowerBuilder は接
続を解除してもライブラリを解放しません)。
MicroHelp オブジェクトのデフォルト テキスト
(PowerBuilder
の各開発セッションを開始するときに表示されるマイク
ロヘルプのテキスト)を示します。デフォルトはレディで
す。
MessageBox 関数を呼び出すときに、メッセージ ボックス
に文字を右から左の向きに表示するかどうかを示します。
アプリケーションは、右から左への表示をサポートするオ
ペレーティング システム上で実行する必要があります。
値は以下のとおりです。
TRUE - メッセージ ボックスのテキストを右から左の
向きに表示します。ヘブライ語版またはアラビア語版
の PowerBuilder を実行する場合、右から左向きの言語
版(ヘブライ語版またはアラビア語版)の Windows 上
でなければ、MessageBox ボタンのテキストは表示され
ません。それ以外の場合、MessageBox ボタンのテキス
トは英語で表示されます。
FALSE - 文字を左から右の向きに表示します。
フレームバーを浮動型にしたときに、フレームバーのタイ
トルとして表示されるテキストを示します。
13
Application オブジェクト
Application プロパティ
ToolbarPopMenuText
データ型
String
ToolbarSheetTitle
String
ToolbarText
Boolean
説明
アプリケーションのツールバーのポップアップ メニュー
にあるツールバーの表示位置を示すテキスト(左端、上
端、右端、下端、浮動)を変えることができます。テキス
トはカンマで区切って指定します。
ツールバーを浮動型にしたときに、シートバーのタイトル
として表示されるテキストを示します。
ツールバーの各項目(ボタン)に関連付けられたテキスト
を表示するかどうかを示します。値は以下のとおりです。
TRUE - テキストを表示します。
FALSE - テキストを表示しません。
ToolbarTips
Boolean
ツールバーのボタンに対するテキストが表示されていな
いときに、PowerTips を表示するかどうかを示します。値
は以下のとおりです。
TRUE - PowerTips を表示します。
FALSE - PowerTips を表示しません。
ToolbarUserControl
Boolean
ツールバーの表示、非表示、移動、ボタン テキストの表
示といった機能を提供するポップアップ メニューを、使
用可能にするかどうかを示します。値は以下のとおりで
す。
TRUE - 使用できます。
FALSE - 使用できません。
イベント
Application イベント
Close
Idle
Open
SystemError
発生する状況
ユーザがアプリケーションを閉じたとき
Application オブジェクトのスクリプト内で Idle 関数が呼び出され、マウスま
たはキーボードの操作がないまま指定した秒数が経過したとき
ユーザがアプリケーションを実行するとき
重大な実行時エラーが発生したとき(存在しないウィンドウを開こうとした
ときなど)。SystemError イベントのスクリプトが記述されていない場合、
PowerBuilder は、PowerBuilder エラー番号とエラー メッセージ テキストを
メッセージ ボックスで表示します。
エラー メッセージの詳細については、PowerBuilder の『ユーザーズ ガイド』
マニュアルを参照してください。
14
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
Application 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
PostEvent
PowerObject
Boolean
SetLibraryList
Integer
SetTransPool
Integer
TriggerEvent
Integer
TypeOf
Object
説明
Application オブジェクトのクラス名を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
Application オブジェクトのメッセージ キューの最後にイ
ベントを追加します。
実行可能ファイルに PBD ライブラリ リストを設定しま
す。この関数はまだ使用できますが、できればシステム関
数 SetLibraryList を使用してください。
アプリケーションのデータベース トランザクションの
プールを設定します。SetTransPool 関数によって、データ
ベース接続に関連したオーバーヘッドを最小限に抑え、接
続可能なトランザクションの数に上限を設定できます。
Application オブジェクトで指定されたイベントを起動し、
そのイベントに関連付けられたスクリプトを実行します。
Application オブジェクトのデータ型を返します。
ArrayBounds オブジェクト
ArrayBounds オブジェクトは、配列の 1 つの次元の上限値と下限値を指定
する構造体です。ArrayBounds オブジェクトは、VariableCardinalityDefinition
オブジェクトの中で使われます。ArrayBounds にはイベントはありません。
プロパティ
ArrayBounds プロパティ データ型
ClassDefinition
PowerObject
LowerBound
Long
UpperBound
Long
オブジェクトとコントロール
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
配列の次元の下限値。可変長配列の場合は、値は常に 0 で
す。
配列の次元の上限値。可変長配列の場合は、値は常に 0 で
す。
15
CheckBox コントロール
関数
ArrayBounds 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
説明
オブジェクトのクラス名を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
CheckBox コントロール
CheckBox(チェックボックス)コントロールは、独立したオプション
を設定するために使われる小さな正方形のボックスです。選択される
とマーク(通常、X またはチェックマーク)が表示されます。選択さ
れていない場合は、空です。
チェックボックスは互いに独立しているので、それぞれの動作に影響
を与えることなくグループ化することができます。グループ化を行え
ばユーザにとってよりわかりやすく使いやすいウィンドウを作成する
ことができます。
通常、チェックボックスの状態はオンまたはオフです。ただし、不明
または未指定という第 3 の状態を指定することもできます。この状態
では、チェックボックスはグレー状態です。
プロパティ
CheckBox プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
16
AccessibleRole
(カタログ デー
タ型)
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
PowerBuilder
第2章
CheckBox プロパティ
Automatic
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
ユーザがコントロールをクリックしたときに、コントロー
ルにマークを表示するかどうかを示します。値は以下のと
おりです。
TRUE - マークを表示します。
FALSE - マークを表示しません。
BackColor
BorderStyle
BringToTop
Long
BorderStyle
(カタログ デー
タ型)
Boolean
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleLowered!
StyleRaised!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
Checked
Boolean
コントロールが選択されているかどうかを示します。値は
以下のとおりです。
TRUE - コントロールは選択されています。
FALSE - コントロールは選択されていません。
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
String
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
オブジェクトとコントロール
17
CheckBox コントロール
CheckBox プロパティ
Enabled
データ型
Boolean
説明
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 使用できます。
FALSE - 使用できません。
FaceName
String
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Height
Italic
コントロール内のテキストを表示する字体名を示します。
たとえば ARIAL や COURIER です。
コントロール内のテキストに使用されるフォント文字
セットを示します。アプリケーションの実行には、選択さ
れた文字セットをサポートしているオペレーティング シ
ステム上で、適切なバージョンの PowerBuilder を使わなけ
ればなりません。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
LeftText
Boolean
テキストをコントロールの左側に表示するかどうかを示
します。値は以下のとおりです。
TRUE - テキストを左側に表示します。
FALSE - テキストを右側に表示します。
Pointer
18
String
このプロパティは通常 FALSE で、テキストはコントロー
ルの右側に表示されます。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
PowerBuilder
第2章
CheckBox プロパティ
RightToLeft
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
TabOrder
Integer
Tag
Text
TextColor
String
String
Long
TextSize
Integer
ThirdState
Boolean
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールの隣に表示されるテキストを示します。
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。色についての詳細は、
『PowerScript リファ
レンス』マニュアルの RGB 関数を参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロールに 3 種類の状態を定義した場合、コントロー
ルを第 3 の状態(グレー状態)にするかどうかを示しま
す。値は以下のとおりです。
TRUE - 第 3 の状態です。
FALSE - 第 3 の状態ではありません。
ThreeState
Boolean
コントロール 3 種類の状態があるかどうかを示します。通
常は、CheckBox コントロールは、オンまたはオフの 2 種
類の状態しかありません。値は以下のとおりです。
TRUE - 状態は 3 種類です。
FALSE - 状態は 2 種類です。
Underline
Boolean
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
X
Integer
Integer
オブジェクトとコントロール
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
19
CheckBox コントロール
CheckBox プロパティ
Y
データ型
Integer
説明
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
CheckBox イベント
Clicked
Constructor
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
20
発生する状況
コントロールがクリックされたとき(選択または選択解除されたとき)
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
CheckBox 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
SetFocus
SetPosition
Integer
Integer
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
オブジェクトとコントロール
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルが自動的に再描画されるように設定します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
21
ClassDefinition オブジェクト
ClassDefinition オブジェクト
ClassDefinition オブジェクトは、PowerBuilder オブジェクトのクラス定
義に関する情報を提供する PowerBuilder オブジェクトです。
PowerBuilder
ライブラリの中で使われているクラスについて、またはインスタンス
化されたオブジェクトのクラスについて調べることができます。
すべてのプロパティは読み出し専用です。ClassDefinition オブジェクト
を使ってクラス定義を変更することはできません。ClassDefinition オブ
ジェクトにはイベントはありません。
ClassDefinition オブジェクトを使って調べることができる内容は以下
のとおりです。
クラスの名前
そのクラスのロード元のライブラリ
先祖がある場合には、その先祖のクラス定義
親オブジェクト、またはコンテナ オブジェクトがある場合にはそ
のクラス定義
そのクラスが自動インスタンス作成クラスかどうか
そのクラスがシステム クラスであるのか(つまり PowerBuilder が
定義しているのか)、あるいはユーザ定義のオブジェクトであるの
か(つまり PowerBuilder PBL で定義されているのか)
オブジェクトが含んでいるクラスについて(たとえばウィンドウ
に含まれているコントロール)
クラスで定義されている変数とスクリプト
クラス名は、ブラウザで表示されるように、常に小文字で記述されま
す。
グローバル関数とグローバル変数
FindFunctionDefinition を呼び出して、グローバル関数を示す ScriptDefinition
オブジェクトを取得します。グローバル変数は、Application オブジェ
クトの ClassDefinition オブジェクトにある VariableList 配列に含まれて
います。
22
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
ClassDefinition
プロパティ
Ancestor
データ型
ClassDefinition
Category
TypeCategory
ClassDefinition
PowerObject
DataTypeOf
String
IsAutoinstantiate
Boolean
IsStructure
IsSystemType
Boolean
Boolean
IsVariableLength
Boolean
IsVisualType
Boolean
説明
先祖クラスを示すオブジェクト。ClassDefinition が
PowerObject を示す場合、先祖は NULL です。
単純型かカタログ データ型か、またはクラスか構造体か
を示します。クラス定義の場合、値は ClassOrStructureType!
です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
オブジェクトのシステム クラスの名前。DataTypeOf は、
オブジェクトのカタログ データ型の値を表す文字列で
す。値は感嘆符なしの小文字です。サンプル値には以下の
ようなものがあります。
window
string
any
dropdownlistbox
開発者が定義したオブジェクトの場合、データ型はそのオ
ブジェクトの継承元のシステム クラスになります。
そのクラスが自動インスタンス作成クラスかどうかを示
します。
そのクラスが構造体かどうかを示します。
変数のクラスが、PBL でユーザが定義するクラスではな
く、PowerBuilder 内で定義されるクラスの 1 つであるシス
テム クラスであるかどうかを示します。
データ型が固定サイズかどうかを示します。値は以下のと
おりです。
TRUE - データ型は可変長です。つまり、データ型が、
string、any、blob、または可変長配列であることを示し
ます。
FALSE - データ型は固定長です。
クラスがビジュアル(表示される)か、非ビジュアルかを
示します。値は以下のとおりです。
TRUE - クラスはビジュアルです。たとえば、ウィンド
ウやコントロールです。
FALSE - クラスは非ビジュアルです。たとえば、クラ
LibraryName
Name
String
String
オブジェクトとコントロール
ス ユーザ オブジェクトや単純データ型です。
ロード元となるクラス ライブラリの絶対パス名です。
クラスの名前。ネスティッド クラスの場合、名前は
libraryEntryName`className の形式で返されます。
23
CommandButton コントロール
ClassDefinition
プロパティ
NestedClassList[ ]
データ型
ClassDefinition
ParentClass
ClassDefinition
ScriptList[ ]
ScriptDefinition
VariableList[ ]
Variable
Definition
説明
オブジェクトのネスティッド クラスとローカル構造体を
表すオブジェクトの可変長配列です。
ネスティッド クラスがない場合、配列は空になります。ネ
スティッド クラスの数を調べるには、UpperBound 関数を
呼び出してください。
そのクラスがネストされている親クラスを示すオブジェ
クト。そのクラスがネスティッド クラスでない場合、値
は NULL です。
折りたたまれたクラス階層で実装または定義されている
スクリプトを示すオブジェクトの可変長配列です。
スクリプトがない場合、配列は空です。スクリプトの数を
調べるには UpperBound 関数を呼び出します。
折りたたまれたクラス階層にあるプロパティまたは共有
変数を示すオブジェクトの可変長配列です。
変数がない場合、配列は空です。変数の数を調べるには、
UpperBound 関数を呼び出します。
関数
ClassDefinition 関数
ClassName
FindMatchingFunction
戻り値のデータ型
String
ScriptDefinition
GetContextService
Integer
GetParent
TypeOf
PowerObject
Object
説明
オブジェクトのクラス名を返します。
指定された名前と引数リストに一致する関数を検索しま
す。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
CommandButton コントロール
CommandButton(コマンドボタン)コントロールは、ユーザに何らか
のアクションを起動させるのに用います。たとえば、何かを削除する
際に[OK]ボタンで削除の確認をユーザに求め、[キャンセル]ボタ
ンで削除要求の取り消しを行わせることができます。
24
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
CommandButton
プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
BringToTop
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
Cancel
Boolean
コントロールが[キャンセル]ボタンとして機能するかど
うかを示します。(ユーザが〔Esc〕を押すと、
[キャンセ
ル]ボタンは Clicked イベントを受け取ります。)値は以下
のとおりです。
TRUE - [キャンセル]ボタンとして機能します。
FALSE - [キャンセル]ボタンとして機能しません。
ClassDefinition
PowerObject
Default
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールがデフォルト コントロールかどうかを示し
ます。デフォルト コントロールには太い枠線が表示され、
ユーザがコントロールを選択しないで〔Enter〕を押すと、
Clicked イベントを受け取ります。値は以下のとおりです。
TRUE - デフォルト コントロールとなります。
FALSE - デフォルト コントロールとなりません。
DragAuto
Boolean
編集可能なコントロール デフォルトの動作はウィンドウ
上の編集可能なコントロールの影響を受けることがあり
ます。詳細については、PowerBuilder の『ユーザーズ ガ
イド』マニュアルを参照してください。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
オブジェクトとコントロール
25
CommandButton コントロール
CommandButton
プロパティ
DragIcon
Enabled
データ型
String
Boolean
説明
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(.ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - コントロールを使用可能にします。
FALSE - コントロールを使用可能にしません。
FaceName
String
FlatStyle
Boolean
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
マウス ポインタをボタンの上に移動したときにのみボタ
ンの縁を表示するかどうかを示します。これは、Microsoft
の Rebar(Coolbar)コントロールで使用されるボタン スタ
イルです。値は以下のとおりです。
TRUE - ボタンをフラットにします。
FALSE - ボタンをフラットにしません。
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Height
26
コントロール内のテキストに使用されるフォント文字
セットを示します。アプリケーションの実行には、選択さ
れた文字セットをサポートしているオペレーティング シ
ステム上で、適切なバージョンの PowerBuilder を使わなけ
ればなりません。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
PowerBuilder
第2章
CommandButton
プロパティ
Italic
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Pointer
String
TabOrder
Integer
Tag
Text
TextSize
String
String
Integer
Underline
Boolean
コントロールで使用するポインタを、組み込みポインタ名
か、ポインタを含むファイル名で示します。
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールに表示されるテキストを指定します。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保持します。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
CommandButton
イベント
Clicked
Constructor
Destructor
発生する状況
コントロールがクリックされたとき
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
オブジェクトとコントロール
27
CommandButton コントロール
CommandButton
イベント
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
発生する状況
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(コントロールが選択されてアク
ティブ状態になる前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
関数
CommandButton
関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
SetFocus
SetPosition
Integer
Integer
Integer
Integer
SetRedraw
Integer
Show
Integer
28
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
CommandButton
関数
TriggerEvent
戻り値のデータ型
Integer
TypeOf
Object
説明
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのコントロール データ型を返します。
Connection オブジェクト
Connection(接続)オブジェクトは、PowerBuilder が EAServer に接続
するために用いるパラメータを指定します。組み込みの Connection オ
ブジェクトを継承したクラス ユーザ オブジェクトを定義することに
よって、Connection オブジェクトをカスタマイズすることができます。
ユーザ オブジェクトには 3 つのイベントがあります(Constructor、
Destructor、および Error です)
。
Connection オブジェクトをカスタマイズする方法についての詳細は、
PowerBuilder の『ユーザーズ ガイド』マニュアルのユーザ オブジェク
トに関する章を参照してください。
EJBConnection オブジェクトを使用して J2EE サーバに接続する方法に
ついての詳細は、『アプリケーション テクニック』マニュアルおよび
『PowerBuilder エクステンション リファレンス』マニュアルを参照して
ください。
プロパティ
Connection プロパティ
Application
データ型
String
ClassDefinition
PowerObject
ConnectString
String
Driver
String
オブジェクトとコントロール
説明
(オプション)EAServer コンポーネントに使用するデフォ
ルトのパッケージを示します。Application プロパティにデ
フォルトのパッケージを指定する場合は、CreateInstance
関数の 2 番目のパラメータにパッケージを指定する必要
はありません。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
廃止プロパティ。分散 PowerBuilder の接続に使用されてい
ました。
接続に使用されるコミュニケーション ドライバ。
EAServer に接続するには、jaguar を指定します。
29
Connection オブジェクト
Connection プロパティ
ErrCode
ErrText
Handle
Location
データ型
Long
String
Objhandle
String
説明
直前の操作が成功したか失敗したかを示すコードです。値
は以下のとおりです。
0 - 成功
50 - 分散サービス エラー
52 - 分散処理の通信エラー
53 - リクエスト先のサーバがアクティブではありませ
ん。
54 - サーバがリクエストを受け付けません。
55 - リクエストが異常終了しました。
56 - リクエストへの応答が不完全です。
57 - 接続していません。
58 - オブジェクト インスタンスが存在しません。
62 - サーバがビジー状態です。
75 - サーバが強制的にクライアントとの接続を解除し
ました。
80 - サーバのクライアントとの接続がタイムアウトに
なりました。
87 - サーバとの接続が切れました。
92 - 必要なプロパティがないか、または無効です。
直前の操作が成功したか失敗したかを示すテキストです。
内部使用のみ
EAServer サーバのホスト名とポート番号を示します。ま
たは、完全に修飾された URL を以下の書式のいずれかの
形式を使って指定することもできます。
iiop://host:port
iiops://host:port
http://host:port
https://host:port
Options
String
EAServer のロード バランシングとフェイルオーバ サポー
トを利用するには、サーバの場所をセミコロンで区切っ
て指定します。(たとえば、
iiop://srv1:9000;iiop://srv2:9000)
1 つまたは複数の通信オプションを示します。複数のオプ
ションを指定する場合は、オプションをカンマで区切って
ください。
EAServer クライアントは、Connection オブジェクトの
Options プロパティを使用して ORB と SSL のプロパティ
値を設定できます。指定する ORB のプロパティ値は、ORB
で始まる必要があります。たとえば、ORBLogFile の値を
指定することにより、ログ ファイルのパスと名前を指定
できます。
次の「オプション」を参照してください。
30
PowerBuilder
第2章
Connection プロパティ
Password
Trace
UserID
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
String
String
String
説明
サーバへの接続時に使用するパスワードです。
分散 PowerBuilder の接続に使用されていました。
サーバに接続するユーザの名前または ID です。
オプション
オプション
ORBHttp
ORBIdleConnectionTimeout
ORBLogIIOP
ORBLogFile
ORBCodeSet
オブジェクトとコントロール
説明
ORB で HTTP トネリングを使用してサーバに接続するかどうかを示し
ます。HTTP トネリングを使用する場合は、TRUE に設定します。デフォ
ルト値は FALSE です。このパラメータは、環境変数 JAG_HTTP に設定
することもできます。ファイアウォールによっては、IIOP パケットが
通過できない場合もありますが、ほとんどの場合、HTTP パケットは通
過できます。このようなファイアウォールを経由して接続する場合に
は、このプロパティを TRUE に設定します。
接続がアイドル状態でいられる時間を秒単位で指定します。タイムアウ
トが失効すると、ORB は接続を閉じます。デフォルトは 0 です。この
場合、接続がタイムアウトすることはありません。接続タイムアウトが
起きても、プロキシ インスタンスの参照が失効することはありません。
次のプロキシ メソッドを呼び出すまでの間に、ORB は接続を透過的に
閉じて再び開きます。クライアント アプリケーションに有限タイムア
ウトを指定すれば、サーバのパフォーマンスが向上します。クライアン
トで多数のインスタンスが同時に実行した場合、クライアントで有限タ
イムアウトが設定されていれば、アイドル状態のクライアントがサーバ
に接続する回数が制限されます。有限タイムアウトを設定することで、
サーバのクラスタを使用するアプリケーションでのサーバ負荷のバラ
ンスを調整することができます。
ORB が IIOP プロトコル トレース情報を記録するかどうかを示します。
記録する場合は、TRUE に設定します。デフォルト値は FALSE です。こ
のパラメータは、環境変数 JAG_LOGIIOP に設定することもできます。
このパラメータを有効にした場合は、ORBLogFile オプション(または
対応する環境変数)を設定して、プロトコル ログ情報を書き込むファ
イルを指定する必要があります。
クライアントの実行ステータスとエラー メッセージを記録するファイ
ルのパスとファイル名を設定します。このパラメータは、環境変数
JAG_LOGFILE に設定することもできます。デフォルト設定は、no log
です。
クライアントが使用するコード セットを設定します。このパラメータ
は、環境変数 JAG_CODESET に設定することもできます。デフォルト
設定は、utf8 です。
31
Connection オブジェクト
オプション
ORBRetryCount
ORBRetryDelay
ORBProxyHost
ORBProxyPort
ORBWebProxyHost
ORBWebProxyPort
ORBHttpExtraHeader
説明
サーバへの最初の接続に失敗してから接続を試みる回数を指定します。
このパラメータは、環境変数 JAG_RETRYCOUNT に設定することもで
きます。デフォルトは 5 です。
サーバへの最初の接続に失敗してから接続を再試行する間隔をミリ秒
単位で指定します。このパラメータは、環境変数 JAG_RETRYDELAY
に設定することもできます。デフォルトは 2000 です。
SSL プロキシのマシン名または IP アドレスを指定します。
SSL プロキシのポート番号を指定します。
汎用的な Web トネリング(接続ベースのトネリングと呼ばれます)を
サポートする HTTP プロキシ サーバのホスト名または IP アドレスを指
定します。このプロパティにはデフォルトはないので、ホスト名とポー
ト 番 号 の 2 つのプロパテ ィを指定する必要があります。環境変数
JAG_WEBPROXYHOST を設定しても、プロパティを指定することがで
きます。
ORBWebProxyHost の設定によって汎用的な Web トネリングが有効なと
き、HTTP プロキシ サーバが接続を受け入れるポートの番号を指定しま
す。このプロパティにはデフォルトはないので、ホスト名とポートを指
定する必要があります。環境変数 JAG_WEBPROXYPORT を設定して
も、プロパティを指定することができます。
(ORBWebProxyHost パラメータで指定された)プロキシ サーバに送信
される各 HTTP パケットのヘッダにどのような付加情報を追加するか
を指定するオプション設定です。JAG_HTTPEXTRAHEADER プロパ
ティを設定しても、このプロパティを指定することができます。
HTTP プロキシ サーバ経由で接続するように ORB を設定し、HTTP プ
ロキシ サーバに特殊なプロトコル要件がある場合を除けば、このプロ
パティを設定する必要はありません。デフォルトで、各パケットには次
のような行が追加されます。
User-agent:Jaguar/major.minor
major と minor はそれぞれ、EAServer クライアント ソフトウェアのメ
ジャー バージョンとマイナー バージョンを表します。
このプロパティを設定して、各 HTTP ヘッダの最後に含めるテキストを
指定できます。設定に複数行を含めるには、キャリッジ リターンとラ
インフィード記号で行を区切る必要があります。設定に「User-agent」
行を含めないと、上記のデフォルト設定が HTTP ヘッダに含まれます。
32
PowerBuilder
第2章
オプション
ORBsocketReuseLimit
ORBcertificateLabel
ORBqop
ORBcacheSize
ORBpin
ORBuserdata
ORBentrustIniFile
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
説明
1 つのサーバからメソッドを呼び出すのにネットワーク接続を再使用
できる回数を指定します。デフォルトは 0 です。この場合、再使用に制
限はありません。クライアントでのプログラムの実行時間が短い場合に
は、デフォルト設定が最適です。長時間実行し、1 つのクラスタ内の
サーバから多数のメソッドを呼び出すようなクライアント プログラム
にはデフォルト設定では不適切な場合があります。ソケットを無制限に
再使用すると、クライアントはサーバ サイドの処理負荷をクラスタ内
のすべてのサーバ間で分散するのではなく、すでに接続が確立されてい
るサーバに対してのみ負荷をかけるようになります。このような場合に
は、クラスタの負荷分散に対してクライアントのパフォーマンスが最適
になるようにこのプロパティを調整する必要があります。Sybase が実施
したテストでは、最初は 10 から 30 に設定するのが最適であることが判
明しています。再使用の回数を極端に少なく設定すると、クライアント
のパフォーマンスが低下します。
接続で相互認証が必要な場合に使用するクライアントの証明書を指定
します。このラベルは、PKCS #11 トークンの X.509 証明書 / 秘密鍵を
識別する簡単な名前です。
相互認証には必須です。
使用するセキュリティ特性の名前を指定します。
SSL には必須です。
SSL のセッション ID キャッシュのサイズを指定します。デフォルトは
100 です。
PKCS #11 トークンの PIN を指定します。PKCS #11 トークンにログイン
してクライアントの認証や信用情報を獲得するために必要になります。
SSL には必須です。
ユーザ指定のコンテキスト情報を提供するのに使用できるオプション
の文字列です。
Entrust にアクセスする方法に関する情報を提供する Entrust INI ファイ
ルのパス名を指定します。
ORBuseEntrustid プロパティが TRUE に設定されている場合は必須です。
ORBentrustUserProfile
ORBuseEntrustID
ORBentrustPassword
オブジェクトとコントロール
Entrust ユーザ プロファイルが入っているファイルへの完全パスを指定
します。Entrust シングル ログイン機能が使用可能な場合はオプション
ですが、それ以外の場合は必須です。
Entrust ID または Sybase PKCS #11 トークンのどちらを認証に使用する
かを指定します。これは、Boolean 型のプロパティです。このプロパティ
を FALSE に設定すると、Sybase PKCS #11 トークン プロパティが有効に
なり、Entrust 固有のプロパティは無視されます。このプロパティを
TRUE に設定すると、Entrust 固有のプロパティが有効になり、Sybase
PKCS #11 トークン プロパティは無視されます。
指定されたユーザ プロファイルで Entrust にログインするためのパス
ワードを指定します。Entrust シングル ログイン機能が使用可能な場合
はオプションですが、それ以外の場合は必須です。
33
Connection オブジェクト
イベント
Connection イベント
Constructor
Destructor
Error
発生する状況
Connection オブジェクトが作成されたとき
Connection オブジェクトが破棄されたとき
クライアントの要求が満たされなかったとき
関数
Connection 関数
ClassName
ConnectToServer
戻り値のデータ型
String
Long
CreateInstance
Long
DisconnectServer
Long
GetContextService
Integer
GetParent
GetServerInfo
Lookup
PowerObject
Long
Long
PostEvent
Boolean
RemoteStopConnection
RemoteStopListening
TriggerEvent
Long
Long
Integer
TypeOf
Object
34
説明
オブジェクトのクラス名を返します。
クライアント アプリケーションをサーバ アプリケーショ
ンに接続します。
サーバ上にリモート オブジェクトのインスタンスを作成
します。
クライアント アプリケーションをサーバ アプリケーショ
ンから接続解除します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
関数仕様の変更
PowerBuilder クライアントが EAServer コンポーネントの
インスタンスを作成できるようにします。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
関数仕様の変更
関数仕様の変更
オブジェクトのイベントを起動し、そのイベントに関連付
けられたスクリプトを実行します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
ContextInformation オブジェクト
ContextInformation オブジェクトは、アプリケーションの実行コンテキ
ストに関する情報を提供します。たとえば現行のバージョンについて
の情報や、アプリケーションが PowerBuilder 実行環境において Window
プラグインとして動いているのか、または Window ActiveX として動い
ているのかなどの情報が含まれます。この情報を使って、表示特性や
アプリケーションの動作を変更することができます。
プロパティ
ContextInformation
プロパティ
ClassDefinition
データ型
PowerObject
Handle
Long
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
内部使用のみ
イベント
ContextInformation
イベント
Constructor
Destructor
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
関数
ContextInformation
関数
ClassName
GetCompanyName
GetContextService
戻り値のデータ型
String
Integer
Integer
GetFixesVersion
Integer
GetHostObject
Integer
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
現行の実行コンテキストの会社名を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
現行の PowerBuilder 実行コンテキストの修正レベルを返
します。
コンテキストのホスト オブジェクトへの参照を提供します。
35
ContextKeyword オブジェクト
ContextInformation
関数
GetMajorVersion
戻り値のデータ型
Integer
GetMinorVersion
Integer
GetName
GetParent
GetShortName
Integer
PowerObject
Integer
GetVersionName
Integer
PostEvent
Boolean
TriggerEvent
Integer
TypeOf
Object
説明
現行の PowerBuilder 実行コンテキストのメジャー バー
ジョンを返します。
現行の PowerBuilder 実行コンテキストのマイナー バー
ジョンを返します。
現行の実行コンテキストの名前を返します。
親オブジェクト名への参照を返します。
現行の PowerBuilder 実行コンテキストの短い名前を返し
ます。
現行の PowerBuilder 実行コンテキストの完全なバージョ
ン情報を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
ContextKeyword オブジェクト
ContextKeyword オブジェクトは、現行のコンテキストの環境に関する
情報を提供します。デフォルトの環境では、ContextKeyword オブジェク
トはホストのワークステーションの環境変数を提供します。アプリケー
ションが Window プラグインとして動いている場合には ContextKeyword
オブジェクトを使うとプラグインの EMBED 要素に指定されているパ
ラメータにアクセスすることができます。
プロパティ
ContextKeyword
プロパティ
ClassDefinition
データ型
PowerObject
Handle
Long
36
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
内部使用のみ
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
イベント
ContextKeyword
イベント
Constructor
Destructor
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
関数
ContextKeyword 関数
ClassName
GetContextKeywords
戻り値のデータ型
String
Integer
GetContextService
Integer
GetParent
PostEvent
PowerObject
Boolean
TriggerEvent
Integer
TypeOf
Object
説明
オブジェクトに与えられた名前を返します。
指定されたキーワードに関係する 1 つまたは複数の値を
取り出します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
CORBACurrent オブジェクト
CORBACurrent サービス オブジェクトは、呼出し側スレッドに関係し
た EAServer トランザクションに関する情報を提供し、呼出し側でその
トランザクションを制御することを可能にします。CORBACurrent オ
ブジェクトは、CORBA Current インタフェースで定義されているほと
んどのメソッドをサポートします。
オブジェクトとコントロール
37
CORBACurrent オブジェクト
プロパティ
CORBACurrent
プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する情報
を含む PowerObject 型のオブジェクトです。
イベント
CORBACurrent
イベント
Constructor
Destructor
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
関数
CORBACurrent 関数
BeginTransaction
戻り値のデータ型
Boolean
ClassName
CommitTransaction
String
Integer
GetContextService
Integer
GetParent
GetStatus
PowerObject
Integer
GetTransactionName
String
Init
Integer
PostEvent
Integer
ResumeTransaction
Integer
RollbackOnly
Integer
38
説明
新しいトランザクションを作成し、そのトランザクション
を呼出し側スレッドと関連付けます。
オブジェクトのクラス名を返します。
呼出し側スレッドに関連付けられたトランザクションを
コミットします。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
呼出し側スレッドに関連付けられたトランザクションの
ステータスを返します。
呼出し側スレッドに関連付けられたトランザクションを
記述する文字列を返します。
CORBACurrent サービス オブジェクトのインスタンスを
初期化します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
渡されたトランザクションを呼出し側スレッドに関連付
けます。
呼出し側スレッドに関連付けられたトランザクションを
修正して、その結果がトランザクションにロールバックさ
れるようにします。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
CORBACurrent 関数
RollbackTransaction
戻り値のデータ型
Integer
SetTimeout
Boolean
SuspendTransaction
Unsignedlong
TriggerEvent
Integer
TypeOf
Object
説明
呼出し側スレッドに関連付けられたトランザクションを
ロールバックします。
トップ レベル トランザクションのタイムアウト値を設定
します。タイムアウトになる前にトランザクションを完了
できないと、トランザクションはロールバックされます。
呼出し側スレッドに関連付けられたトランザクションを
中断し、トランザクションにハンドルを戻します。
オブジェクトのイベントを起動し、そのイベントのスクリ
プトを実行します。
オブジェクトのデータ型を返します。
CORBAObject オブジェクト
CORBAObject オブジェクトは、いくつかの標準的な CORBA メソッド
へのアクセス権を PowerBuilder クライアントに割り当てます。EAServer
プロキシ ジェネレータを使用して EAServer コンポーネント用に生成
されるすべてのプロキシ オブジェクトは、CORBAObject の子孫です。
プロパティ
CORBAObject
プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する情報
を含む PowerObject 型のオブジェクトです。
イベント
CORBAObject イベント
Constructor
Destructor
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
オブジェクトとコントロール
39
CORBAObject オブジェクト
関数
CORBAObject 関数
ClassName
_Is_A
戻り値のデータ型
String
Boolean
_Narrow
Long
GetContextService
Integer
GetParent
PostEvent
PowerObject
Boolean
TriggerEvent
Integer
TypeOf
Object
40
説明
オブジェクトに与えられた名前を返します。
CORBA オブジェクトが、特定のインタフェースを実装し
たクラスのインスタンスかどうかをチェックします。
CORBA オブジェクトの参照を一般的なスーパータイプか
らより詳細なサブタイプに変換します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataStore オブジェクト
DataStore(データストア)オブジェクトは、非表示の DataWindow コ
ントロールです。DataStore オブジェクトはほかの DataWindow コント
ロールと同じように機能しますが、DataWindow コントロールの表示プ
ロパティの多くは、DataStore オブジェクトには適用されません。ただ
し、DataStore オブジェクトを印刷することはできるので、データを表
示するためのプロパティと関数もいくつか用意されています。
しかし、CategoryCount、CategoryName、GetData、SeriesCount などのグ
ラフ関数は、DataStore オブジェクトのために作成されたものではない
視覚的な Graph コントロールに依存します。これらの関数は、DataStore
で使用される時にエラー値か空の文字列を返します。
プロパティ
DataStore プロパティ
DataObject
データ型
String
ClassDefinition
PowerObject
Object
DWObject
説明
DataStore コントロールに関連付けられた DataWindow ま
たは Report オブジェクトの名前を示します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
DataWindow オブジェクト内のオブジェクトをスクリプト
で直接操作する場合に使用します。たとえば、カラム オ
ブジェクトやテキスト オブジェクトがこれに相当しま
す。
イベント
DataStore オブジェクトのイベントの中には、それを見てイベント発生
時にどのような動作を指定したらいいのかを決めることができるよう
なコードを返すものがあります。リターン コードを設定するには、イ
ベント スクリプト中に RETURN 文を挿入します。
DataStore イベント
Constructor
DBError
発生する状況
ウィンドウの Open イベントが発生する直前
DataStore でデータベース エラーが発生したとき
リターン コード :
Destructor
0 -(デフォルト)エラー メッセージを表示します。
1 - エラー メッセージを表示しません。
ウィンドウの Close イベントが発生した直後
オブジェクトとコントロール
41
DataStore オブジェクト
DataStore イベント
Error
ItemChanged
発生する状況
DataWindow オブジェクトのデータまたはプロパティ式にエラーが見つかっ
たとき
DataStore オブジェクトに対して AcceptText 関数と Update 関数が呼ばれたと
き
リターン コード :
ItemError
0 -(デフォルト)データ値を受け入れます。
1 - データ値を拒否し,フォーカスの変更を許可しません。
2 - データ値は拒否しますが、フォーカスの変更は許されます。
DataStore オブジェクトに文字列またはファイルからインポートされた値
が、そのカラムの入力条件則に適合しないとき。また、DataStore オブジェ
クトに対して AcceptText 関数や Update 関数が呼び出されたとき
リターン コード :
0 -(デフォルト)データ値を拒否し、エラー メッセージ ボックスを表
示します。
1 - データ値を拒否し、メッセージ ボックスは表示しません。
2 - データ値を受け入れます。
3 - データ値は拒否しますが、フォーカスの変更は許されます。
PrintEnd
PrintPage
リターン コードが 0 または 1 の場合(データ値を拒否した場合)、フォーカ
スは、条件則に適合しなかったデータのフィールドに戻ります。
DataStore オブジェクトの印刷が終了したとき
DataStore オブジェクトの各ページの印刷フォーマットが整えられる前
リターン コード :
PrintStart
RetrieveEnd
RetrieveRow
0 - そのページをスキップしません。
1 - そのページをスキップします。
DataStore オブジェクトの印刷が開始されるとき
DataStore オブジェクトの検索が完了したとき
一行が検索された後
リターン コード :
RetrieveStart
0 -(デフォルト)処理を続行します。
1 - 検索を中止します。
DataStore オブジェクトの検索が開始される直前
リターン コード :
0 -(デフォルト)処理を続行します。
1 - 検索を中止します。
2 - データベースからデータを検索する前にデータ行やバッファのリ
セットを行いません。
42
PowerBuilder
第2章
DataStore イベント
SQLPreview
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
発生する状況
Retrieve 関数、Update 関数、ReselectRow 関数を呼び出した後で、SQL 文が
DBMS に引き渡される直前
Update 関数が呼び出された後に限り、
イベントの発生時に次のアクションを
以下のリターン コードによって指定できます。
UpdateEnd
UpdateStart
0 -(デフォルト)処理を続行します。
1 - 中止します。
2 - 要求をスキップし、次の要求を実行します。
DataStore によるデータベースの更新処理がすべて完了したとき
Update 関数を呼び出した後で、DataStore の変更内容がデータベースに送信
される直前
リターン コード :
0 -(デフォルト)処理を続行します。
1 - 更新処理を実行しません。
関数
DataStore 関数
AcceptText
戻り値のデータ型
Integer
CategoryCount
Integer
CategoryName
String
ClassName
ClearValues
String
Integer
Clipboard
Integer
CopyRTF
String
Create
Integer
CreateFrom
Integer
DataCount
Long
オブジェクトとコントロール
説明
DataStore オブジェクトの Edit コントロールの内容を
DataStore バッファの現行項目に適用します。
指定されたグラフの項目数を返します。
(DataStore のエ
ラー値や空の文字列を返します。)
指定されたグラフの指定された項目の項目名を返します。
(DataStore のエラー値や空の文字列を返します。
)
DataStore オブジェクトに与えられた名前を返します。
DataStore 内の指定されたカラムに関連付けられた値リス
トの項目をすべて削除します。
DataStore 内の指定されたグラフをクリップボードにコ
ピーします。
DataStore 内の選択されたテキスト、ピクチャ、入力フィー
ルドをリッチテキスト形式の文字列として返します。ビッ
トマップと入力フィールドも文字列に含まれます。
指定されたソース コードを使って DataStore オブジェクト
を作成し、指定された DataStore 内の DataWindow オブジェ
クトと置き換えます。
渡された結果集合オブジェクトから DataStore オブジェク
ト を作成します。
DataStore 上に配置されたグラフに対し、指定された系列
のデータポイント数を返します。
(DataStore のエラー値や
空の文字列を返します。)
43
DataStore オブジェクト
DataStore 関数
DBCancel
DeletedCount
戻り値のデータ型
Integer
Long
DeleteRow
Describe
Filter
Integer
String
Integer
FilteredCount
Find
Integer
Long
FindCategory
Integer
FindGroupChange
Long
FindRequired
Integer
FindSeries
Integer
GenerateHTMLForm
Integer
GenerateResultSet
Long
GetBorderStyle
Border(カタロ
グ データ型)
GetChanges
Long
GetChild
Integer
44
説明
実行中のデータベース検索を中止します。
DataStore から削除されたが、関連したデータベース テー
ブルに対する更新がまだ行われていない行の行数を返し
ます。
指定された行を DataStore オブジェクトから削除します。
DataStore の構造に関して、要求された情報を返します。
現行のフィルタ基準に適合しない行をフィルタ バッファ
に移動します。
現行のフィルタ基準に適合していない行の行数を返します。
DataStore の詳細領域中の指定された検索範囲内で、検索
条件に適合する最初の行の行番号を返します。
DataStore の配置されたグラフに対して、指定された項目
ラベルの項目番号を取得します。
(DataStore のエラー値や
空の文字列を返します。)
DataStore 内の指定したグループの最初のブレークを指定
された行から検索します。
必ず入力しなければならないカラムのうち、未入力(Null
値)となっているものを識別します。
指定されたグラフに対して、指定された系列ラベルの系列
番号を取得します。
(DataStore のエラー値や空の文字列を
返します。)
1 つまたは複数の行のカラムを含む HTML Form 要素を作
成します。スタイル シート情報を含む HTML Style 要素も
返します。
EAServer の 1 つのコンポーネントとして実行中の PowerBuilder
ユーザ オブジェクトから EAServer 結果集合を返します。
DataStore 上の指定したカラムの枠線スタイルを示す Border
カタログ データ型を返します。Border カタログ データ型
には次のものがあります。
Box!
Lowered!
NoBorder!
Raised!
ResizeBorder!
ShadowBox!
Underline!
DataStore に行われた変更を Blob に取得します。この関数
は、主に分散アプリケーションで使用されます。
指定されたカラムの子データウィンドウの名前を、指定さ
れた変数に保持します。
PowerBuilder
第2章
DataStore 関数
GetClickedColumn
GetClickedRow
GetColumn
GetColumnName
GetContextService
GetData
GetDataPieExplode
GetDataStyle
GetDataValue
GetFormat
GetFullState
GetItemDate
GetItemDateTime
GetItemDecimal
GetItemNumber
GetItemStatus
GetItemString
GetItemTime
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
戻り値のデータ型
Integer
説明
DataStore 内でクリックまたはダブルクリックされたカラ
ムの番号を取得します。
Long
DataStore 内でクリックまたはダブルクリックされた行の
番号を取得します。
Integer
DataStore 内の現行カラムの番号を返します。
String
DataStore 内の現行のカラム名を返します。
Integer
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
Double
グラフの指定された系列番号とデータ ポイント番号の
データ値を取得します。
(DataStore のエラー値や空の文字
列を返します。)
Integer
円グラフから切り離された一片が突出する割合を返しま
す。(DataStore のエラー値や空の文字列を返します。)
Integer
グラフのデータ ポイントの表示形態を調べます。
(DataStore のエラー値や空の文字列を返します。)
Integer
グラフの指定された系列番号とデータ ポイント番号の
データ値を取得します。
(DataStore のエラー値や空の文字
列を返します。)
String
DataStore 上の指定されたカラムに対する表示書式を返し
ます。
Long
DataStore の完全な状態を Blob に取得します。この関数は、
主に分散アプリケーションで使用されます。
Date
DataStore の指定された行とカラムの日付データを返しま
す。
DateTime
DataStore の指定された行とカラムの日時データを取得し
ます。
Decimal
DataStore の指定された行とカラムの 10 進数データを取得
します。
Double
DataStore の指定された行とカラムの数値データを取得し
ます。
dwItemStatus
指定されたバッファ内の指定された行とカラムの項目の
(カタログ デー ステータスを取得します。値は以下のとおりです。
タ型)
DataModified!
New!
NewModified!
NotModified!
String
DataStore の行とカラムを指定して文字列データを取得し
ます。
Time
DataStore の行とカラムを指定して時刻データを取得します。
オブジェクトとコントロール
45
DataStore オブジェクト
DataStore 関数
GetNextModified
戻り値のデータ型
Long
GetParent
GetRow
GetRowFromRowId
PowerObject
Long
Long
GetRowIdFromRow
Long
GetSelectedRow
Integer
GetSeriesStyle
Integer
GetSQLSelect
String
GetStateStatus
Long
GetText
String
GetTrans
GetValidate
Integer
String
GetValue
String
GroupCalc
Integer
ImportClipboard
ImportFile
ImportString
InsertDocument
Long
Long
Long
Integer
説明
指定された DataStore オブジェクト バッファの、指定され
た行から検索を始めて修正状態にある最初の行の行番号
を返します。
親オブジェクト名への参照を返します。
DataStore の現行の行番号(整数)を返します。
DataStore 内の行の行番号を、その行に関連付けられた固
有の行識別子から取得します。
DataStore 内の行の固有の行識別子を、その行に関連付け
られた行番号から取得します。
DataStore の指定された行番号の後で、最初に選択されて
いる行の行番号を返します。
グラフのデータ系列の表示形態を調べます。
(DataStore の
エラー値や空の文字列を返します。)
DataStore オブジェクトの現行の SELECT 文を返します。
DataWindow に関する内部状態フラグの現行のステータス
を検索し、その情報を Blob に保管します。この関数は、
主に分散アプリケーションで使用されます。
DataStore の現行の行とカラムに対する Edit コントロール
のテキストを返します。
DataStore Transaction オブジェクトの値を取得します。
DataStore の指定されたカラムに対する入力条件則を返し
ます。
指定されたカラムに対する値リストの指定された項目の
値を返します。
DataStore 内のグループのブレークを再計算します。
クリップボードから DataStore にデータをコピーします。
ファイルから DataStore にデータをコピーします。
文字列から DataStore にデータをコピーします。
DataStore にリッチテキスト形式か通常のテキスト ファイ
ルを挿入します。挿入方法について関数のパラメータで次
のどちらかを指定します。
• 挿入ポイントに挿入する
• 既存の内容とすべて置き換える
InsertRow
46
Long
この関数は、リッチテキスト提示様式の DataStore にのみ
適用されます。
DataStore の指定された行の前に、新たに初期化した行を
挿入します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataStore 関数
IsSelected
戻り値のデータ型
Boolean
ModifiedCount
Long
Modify
String
PasteRTF
Long
PostEvent
Boolean
Print
Integer
PrintCancel
Integer
ReselectRow
Integer
Reset
Reset(グラフ)
Integer
Integer
ResetDataColors
Integer
ResetTransObject
Integer
ResetUpdate
Retrieve
Integer
Long
RowCount
Long
オブジェクトとコントロール
説明
DataStore の指定された行が選択されているとき TRUE を
返します。指定された行が選択されていないとき、または
DataStore の行数より大きい数が指定されたときは FALSE
を返します。
DataStore 上で修正されたが、データベース テーブルへの
更新がまだ行われていない行の数を返します。
DataWindow の文字列仕様を使って DataStore オブジェク
トのプロパティを変更します。
リッチテキスト提示様式の DataStore オブジェクトに、文
字列からリッチ テキスト データを貼り付けます。
DataStore のメッセージ キューの最後にイベントを追加し
ます。
DataStore の内容を現行プリンタに送信します。構文が何
種類かあります。
DataStore の内容が印刷されている場合、印刷ジョブを取
り消し、スプール ファイルがあれば削除します。
この関数には構文が 2 種類あります。Print 関数で印刷が行
われている場合には、構文 1 を使います。
データベースにアクセスして、更新可能なカラムをすべて
再選択します。DataStore の行に Timestamp 型のカラムが
ある場合は、タイムスタンプをリフレッシュします。
DataStore オブジェクトの内容をすべて消去します。
DataWindow オブジェクト内にあるグラフから、データ、
項目または系列を削除します。外部データ ソースを用い
ている場合に適用されます。
データ ポイントの色をその系列に指定された色に戻しま
す。(DataStore のエラー値や空の文字列を返します。)
プログラマが定義した Transaction オブジェクトを DataStore
オ ブ ジ ェ ク ト が 使 用 す る の を 中 止 し ま す(こ れ 以 降、
DataStore オブジェクトは内部の Transaction オブジェクト
を使用します)。
DataStore オブジェクトの更新フラグをリセットします。
DataStore オブジェクトにデータベースを検索させ、行を
取得します。
DataStore で現在使用可能な行数(検索された全行数から
削除された行数を引いたものに、挿入された行数を加え、
さらにフィルタで非表示となっている行数を引いた数)を
返します。
47
DataStore オブジェクト
DataStore 関数
RowsCopy
戻り値のデータ型
Integer
RowsDiscard
Integer
RowsMove
Integer
SaveAs(グラフ)
Integer
SaveAs
Integer
SaveAsAscii
Long
SelectRow
Integer
SeriesCount
Integer
SeriesName
String
SetBorderStyle
Integer
SetChanges
Long
SetColumn
SetDataPieExplode
Integer
Integer
SetDataStyle
Integer
SetDetailHeight
SetFilter
Integer
Integer
SetFormat
SetFullState
Integer
Long
48
説明
ある DataStore オブジェクトから別の DataStore オブジェ
クト(または DataWindow コントロール)に、指定された
範囲の行をコピーします。また、1つの DataStore オブジェ
クト内でのバッファ間のコピーにも使用できます。
指定された範囲の行を廃棄します。廃棄された行はデータ
ベースから再検索しなければ復元できません。
指定された範囲の行を DataStore オブジェクトから削除し
て、それらの行を別の DataStore オブジェクト(または
DataWindow コントロール)、もしくは同じ DataStore 内の
別のバッファにコピーします。
DataStore 上に配置されたグラフに表示されているデータ
を、指定ファイルに指定した形式で保存します。
DataStore の内容を、必要に応じてカラム ヘッダを先頭に
付け、指定された形式でファイルに保存します。
DataStore の内容を標準の ASCII テキスト ファイルに保存
します。
DataStore の指定された行の選択または選択解除を行いま
す。
指定されたグラフの系列数を返します。
(DataStore のエ
ラー値や空の文字列を返します。)
指定されたグラフに対し、指定された系列番号の系列名を
取得します。
(DataStore のエラー値や空の文字列を返しま
す。)
DataStore の指定したカラムに対する枠線スタイルを設定
します。
GetChanges で取り込まれた変更を DataStore に適用します。
この関数は、主に分散アプリケーションで使用されます。
DataStore の指定されたカラムを現行カラムにします。
円グラフから一片を切り離します。
(DataStore のエラー値
や空の文字列を返します。)
指定されたグラフに対して、系列番号とデータ ポイント
番号を指定します。
(DataStore のエラー値や空の文字列を
返します。)
指定された範囲に位置する各行の高さを設定します。
DataStore オブジェクトのフィルタ条件を定義します。実
際のフィルタ処理は、Filter 関数によって行われます。
DataStore の指定したカラムに対する表示書式を設定します。
GetFullState で取得された DataWindow の Blob の内容を
DataStore に適用します。この関数は、主に分散アプリケー
ションで使用されます。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataStore 関数
SetHTMLAction
戻り値のデータ型
Integer
SetItem
Integer
SetItemStatus
Integer
SetPosition
Integer
SetRow
SetSeriesStyle
Integer
Integer
SetSort
Integer
SetSQLPreview
SetSQLSelect
SetText
Integer
Integer
Integer
SetTrans
Integer
SetTransObject
Integer
SetValidate
Integer
SetValue
Integer
ShareData
Integer
ShareDataOff
Integer
Sort
Integer
TriggerEvent
Integer
オブジェクトとコントロール
説明
Web ブラウザ内の Web DataWindow クライアント コント
ロールとのユーザの対話に関して、アクションおよびコン
テキストの情報を受け入れて、新たに生成される HTML
が変更要求を反映できるようにします。
DataStore オブジェクトの行とカラムを指定し、その値を
設定します。
指定されたバッファ上で DataStore オブジェクトの指定さ
れたカラムと行のステータスを設定します。
DataStore 内のオブジェクトを指定された区域に移動しま
す。または、区域内でのオブジェクトの表示順序を上から
下へと変更します。
DataStore オブジェクトの指定された行を現行の行にします。
指定されたグラフに対して、指定された系列名の設定を行
います。
(DataStore のエラー値や空の文字列を返します。)
DataStore のソート条件を定義します。実際のソート処理
は、Sort 関数によって実行されます。
DataStore の現行の SQL 文を設定します。
DataStore の現行の SELECT 文を変更します。
DataStore の現行の行とカラムに位置する Edit コントロー
ルのテキストを、指定されたテキストに置き換えます。
DataStore 内部の Transaction オブジェクトの値を設定しま
す。
DataStore オブジェクトの Tansaction オブジェクトを設定
します。この設定後、スクリプトによる操作などでトラン
ザクション管理を行います。
DataStore オブジェクトの指定されたカラムに使われてい
る入力条件則を変更します。
DataStore オブジェクトの指定されたカラムの値リストま
たはコード表中の項目に値を設定します。
主 DataStore オブジェクト(または DataWindow コントロー
ル)と副 DataStore オブジェクト(または DataWindow コ
ントロール)の間でデータを共用します。
DataStore オブジェクト間のデータ共有を無効にします。
主 DataStore オブジェクトが無効にされた場合には、すべ
ての副 DataStore オブジェクト(または DataWindow コン
トロール)は接続が解除され、DataWindow オブジェクト
は保持していたデータを失います。
DataStore オブジェクトの行を、現行のソート条件を基に
してソートします。
DataStore オブジェクトのイベントを起動し、そのイベン
トに関連付けられたスクリプトを実行します。
49
DataWindow コントロール
DataStore 関数
TypeOf
Update
戻り値のデータ型
Object
Integer
説明
DataStore オブジェクトのデータ型を返します。
DataStore オブジェクトで行われた挿入、削除、更新の内
容をデータベースに送信します。
DataWindow コントロール
DataWindow(データウィンドウ)コントロールはウィンドウまたは
ユーザ オブジェクトに配置し、そこでウィンドウ内のデータを表示し
たり操作したりするために使用する DataWindow オブジェクトを指定
します。
ユーザは DataWindow オブジェクトを使ってデータベースやそのほか
の情報の表示、操作、更新を行うことができます。DataWindow オブ
ジェクトは、開発者がデータウィンドウ ペインタで構築します。
DataWindow オブジェクトの詳細については、PowerBuilder の『ユー
ザーズ ガイド』マニュアルを参照してください。
関数仕様の変更
DataWindow コントロール関数の中には「関数仕様の変更」と記述され
ているものがあります。これは、その関数が今回のバージョンで使用
することはできますが、今後のバージョンではサポートされないこと
を示しています。できるだけ早い時期に、そのような関数の使用をや
め、別の関数を使用するようにしてください。
プロパティ
DataWindow プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
50
AccessibleRole
(カタログ デー
タ型)
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
PowerBuilder
第2章
DataWindow プロパティ
Border
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BorderStyle
(カタログ デー
タ型)
BringToTop
Boolean
ClassDefinition
PowerObject
ControlMenu
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を指定します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
タイトル バーにコントロール メニュー ボックスを表示す
るかどうかを示します。値は以下のとおりです。
TRUE - コントロール メニュー ボックスを表示します。
FALSE - コントロール メニュー ボックスを表示しま
DataObject
String
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
せん。
コントロールに関連付けられた DataWindow または Report
オブジェクトの名前を示します。
コントロールを自動的にドラッグ モードにするかどうかを
示します。DragAuto には次のようなブール値があります。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - コントロールを使用可能にします。
FALSE - コントロールを使用可能にしません。
オブジェクトとコントロール
51
DataWindow コントロール
DataWindow プロパティ
Height
データ型
Integer
HScrollBar
Boolean
説明
DataWindow コントロールの高さを、PowerBuilder 単位系
で示します。
すべてのデータを表示しきれない場合に、コントロールに
水平スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - 水平スクロールバーを表示します。
FALSE - 水平スクロールバーを表示しません。
HSplitScroll
Boolean
コントロールにスプリットバーを表示するかどうかを示
します。値は以下のとおりです。
TRUE - スプリットバーを表示します。
FALSE - スプリットバーを表示しません。
Icon
String
LiveScroll
Boolean
MaxBox
Boolean
DataWindow コントロールがアイコン化されたときに表示
されるアイコンを含んだファイル(ICO ファイル)の名前
を示します。
ユーザがスクロール ボックス(つまみ)を移動すると、
DataWindow オブジェクトの行がスクロールするかどうか
を示します。
タイトル バーに最大化ボタンを表示するかどうかを示し
ます。値は以下のとおりです。
TRUE - 最大化ボタンを表示します。
FALSE - 最大化ボタンを表示しません。
MinBox
Boolean
DataWindow コントロールのタイトル バーに最小化ボタン
を表示するかどうかを示します。値は以下のとおりです。
TRUE - 最小化ボタンを表示します。
FALSE - 最小化ボタンを表示しません。
Object
DWObject
Resizable
Boolean
DataWindow オブジェクト内のオブジェクトをスクリプト
で直接操作する場合に使用します。たとえば、カラム オ
ブジェクトやテキスト オブジェクトがこれに相当しま
す。
DataWindow コントロールのサイズが変更できるかどうか
を示します。値は以下のとおりです。
TRUE - サイズを変更できます。
FALSE - サイズを変更できません。
RightToLeft
Boolean
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
52
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataWindow プロパティ
TabOrder
データ型
Integer
Tag
Title
String
String
TitleBar
Boolean
説明
DataWindow コントロールのタブ値(順序)を配置されて
いるウィンドウまたはユーザ オブジェクトに対して示し
ます(0 を指定すると、DataWindow コントロールにタブ
移動できません)。
DataWindow コントロールの持つタグ値を示します。
DataWindow コントロールのタイトル バーに表示される
テキストを示します。
DataWindow コントロールにタイトル バーを表示するか
どうかを示します。タイトル バーがないと、DataWindow
コントロールを移動することができません。値は以下のと
おりです。
TRUE - コントロールにタイトル バーを表示します。
FALSE - コントロールにタイトル バーを表示しません。
Visible
Boolean
DataWindow コントロールが表示可能かどうかを示しま
す。値は以下のとおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
VScrollBar
Boolean
すべてのデータを表示しきれない場合に、コントロールに
垂直スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - 垂直スクロールバーを表示します。
FALSE - 垂直スクロールバーを表示しません。
Width
Integer
X
Integer
Y
Integer
DataWindow コントロールの幅を、PowerBuilder 単位系で
示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を、PowerBuilder
単位系で示します。
イベント
DataWindow コントロールのイベントの中には、イベント発生時にどの
ような動作を指定したらいいのかを決めることができるようなコード
を返すものがあります。リターン コードを設定するには、イベント ス
クリプト中に RETURN 文を挿入します。
DataWindow イベント
ButtonClicked
ButtonClicking
発生する状況
ユーザがボタンをクリックしたとき。
ユーザがボタンをクリックしたとき。このイベントは ButtonClicked イベン
トの前に発生します。
オブジェクトとコントロール
53
DataWindow コントロール
DataWindow イベント
Clicked
発生する状況
DataWindow コントロール上のフィールドとフィールドの間をユーザがク
リックした時
リターン コード :
Constructor
DBError
0 -(デフォルト)処理を続行します。
1 - 処理を中断します。
ウィンドウの Open イベントが発生する直前
DataWindow コントロールでデータベース エラーが発生したとき
リターン コード :
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
EditChanged
Error
GetFocus
Help
ItemChanged
0 -(デフォルト)エラー メッセージを表示します。
1 - エラー メッセージを表示しません。
ウィンドウの Close イベントが発生した直後
ユーザが DataWindow コントロール上のフィールド間をダブルクリックし
たとき
リッチテキスト提示様式の DataWindow の場合には、テキストをユーザがダ
ブルクリックしたとき
DataWindow コントロール上にコントロールがドラッグ アンド ドロップさ
れたとき
DataWindow コントロール上にコントロールがドラッグされたとき
DataWindow コントロールからコントロールがドラッグされて出たとき
DataWindow コントロール内にコントロールがドラッグされているとき
ユーザが DataWindow コントロール上の Edit コントロールに入力を行うと
き
DataWindow オブジェクトのデータまたはプロパティ式にエラーが見つかっ
たとき
DataWindow コントロールがフォーカスを受ける直前(DataWindow コント
ロールが選択されて、アクティブ状態になる前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
DataWindow コントロール上のフィールドが修正された後で、フォーカスを
失ったとき(たとえば、ユーザが〔Enter〕、〔Tab〕、矢印キーのいずれかを
押したり、あるいは DataWindow 内の別のフィールドをマウスでクリックし
たとき)
リターン コード :
0 -(デフォルト)データ値を受け入れます。
1 - データ値を拒否し,フォーカスの変更を許可しません。
2 - データ値は拒否しますが、フォーカスの変更は許されます。
54
PowerBuilder
第2章
DataWindow イベント
ItemError
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
発生する状況
フィールドが修正された後で、フォーカスを失った(たとえば、ユーザが
〔Enter〕、
〔Tab〕、矢印キーのいずれかを押したり、別のフィールドをマウス
でクリックした)が、そのフィールドが該当するカラムの入力条件則に適合
しないとき
リターン コード :
0 -(デフォルト)データ値を拒否し、エラー メッセージ ボックスを表
示します。
1 - データ値を拒否し、メッセージ ボックスは表示しません。
2 - データ値を受け入れます。
3 - データ値は拒否しますが、フォーカスの変更は許されます。
ItemFocusChanged
LoseFocus
Other
PrintEnd
PrintPage
リターン コードが 0 または 1 の場合(データ値を拒否した場合)、フォーカ
スは、条件則に適合しなかったデータのフィールドに戻ります。
DataWindow コントロール上で現行項目が別の項目に変更されたとき
DataWindow コントロールがフォーカスを失ったとき(コントロールがアク
ティブ状態でなくなったとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
DataWindow の印刷が終了するとき
DataWindow の各ページの印刷準備を行う前
リターン コード :
PrintStart
RButtonDown
Resize
RetrieveEnd
RetrieveRow
0 - そのページをスキップしません。
1 - そのページをスキップします。
DataWindow の印刷が開始されるとき
コントロールをマウスの右ボタンでクリックしたとき
リッチテキスト提示様式の DataWindow に対してポップアップ メニューが
使用可能となっていると、マウスの右ボタンが押されてもこのイベントは起
動されません。
ユーザまたはスクリプトによって、DataWindow コントロールのサイズが変
更されたとき
DataWindow の検索が完了したとき
一行が検索された後
リターン コード :
RetrieveStart
0 -(デフォルト)処理を続行します。
1 - 検索を中止します。
DataWindow の検索が開始される直前
リターン コード :
0 -(デフォルト)処理を続行します。
1 - 検索を中止します。
2 - データベースからデータを検索する前にデータ行やバッファのリ
セットを行いません。
オブジェクトとコントロール
55
DataWindow コントロール
DataWindow イベント
RowFocusChanged
RowFocusChanging
ScrollHorizontal
ScrollVertical
SQLPreview
発生する状況
DataWindow コントロール上で現行の行が別の行に変更されるとき
現行の行が DataWindow の変更に関するものであるとき。このイベントは
RowFocusChanged イベントの前に発生します。
DataWindow コントロール内で、
〔Tab〕、矢印キー、スクロールバーのいずれ
かによって水平方向のスクロールが行われるとき
DataWindow コントロール内で、
〔Tab〕、矢印キー、スクロールバーのいずれ
かによって垂直方向のスクロールが行われるとき
Retrieve 関数、Update 関数、ReselectRow 関数を呼び出した後で、SQL 文が
DBMS に引き渡される直前
Update 関数が呼び出された後に限り、
イベントの発生時に次のアクションを
以下のリターン コードによって指定できます。
UpdateEnd
UpdateStart
0 -(デフォルト)処理を続行します。
1 - 中止します。
2 - 要求をスキップし、次の要求を実行します。
DataWindow によるデータベースの更新処理がすべて完了したとき
Update 関数を呼び出した後で、DataWindow での変更内容がデータベースに
送信される直前
リターン コード :
0 -(デフォルト)処理を続行します。
1 - 更新処理を実行しません。
関数
DataWindow 関数
AcceptText
戻り値のデータ型
Integer
CanUndo
Boolean
説明
DataWindow コントロールの Edit コントロールの内容を
DataWindow バッファの現行項目に適用します。
最後に行った編集操作を Undo 関数によって元に戻すこと
ができるかどうか指定します。現行の行とカラムに対する
Edit コントロールに適用します。値は以下のとおりです。
TRUE - 最後に行った編集操作を元に戻せます。
FALSE - 最後に行った編集操作を元に戻せません。
CategoryCount
Integer
CategoryName
String
ClassName
String
56
DataWindow コントロール上にある指定されたグラフの項
目数を返します。
DataWindow コントロール上にある指定されたグラフに対
し、指定された項目番号の項目名を取得します。
DataWindow コントロールに与えられた名前を返します。
PowerBuilder
第2章
DataWindow 関数
Clear
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
戻り値のデータ型
Integer
ClearValues
Integer
Clipboard
Integer
Copy
Integer
CopyRTF
String
Create
Integer
CrosstabDialog
Integer
Cut
Integer
DataCount
Long
DBCancel
DBErrorCode
Integer
Long
オブジェクトとコントロール
説明
DataWindow コントロールの現行フィールドで選択された
テキストを削除します。
リッチテキスト提示様式の場合は、DataWindow コント
ロール内の選択されたテキストを削除します。
DataWindow コントロールの指定されたカラムに関連付け
られた値リストの項目をすべて削除します。
DataWindow コントロール上に配置されたグラフをクリッ
プボードにコピーします。
DataWindow コントロールの現行の行とカラムの Edit コン
トロール内の選択されたテキストを、クリップボードにコ
ピーします。
リッチテキスト提示様式の場合は、DataWindow コント
ロール内の選択されたテキストをコピーします。
DataWindow コントロール上で選択されたテキスト、ピク
チャ、入力フィールドを RTF(リッチテキスト形式)の文
字列として返します。ビットマップと入力フィールドも文
字列に含まれます。
指定された DataWindow ソースコードを使って DataWindow
オブジェクトを作成し、作成した新しいオブジェクトで、
指定された DataWindow コントロールの DataWindow オブ
ジェクトを置き換えます。
クロスタブの定義 ダイアログボックスを表示して、ユー
ザが実行中にクロスタブ提示様式 DataWindow の定義を
変更できるようにします。
DataWindow コントロールの現行の行とカラムの Edit コン
トロールで選択されたテキストを切り取り、クリップボー
ドにコピーします。
リッチテキスト提示様式の DataWindow の場合は、このコ
ントロール内で選択されているテキストを切り取ります。
DataWindow コントロール上に配置されたグラフに対し、
指定された系列のデータ ポイント数を取得します。
実行中のデータベース検索を中止します。
データベース エラーによって生成されたエラー コード
(数値)を返します。
関数仕様の変更 DBErrorCode 関数は、今後のバージョンで
はサポートされなくなります。今後はデータベース エ
ラー コードは、イベントの引数として取得できます。
57
DataWindow コントロール
DataWindow 関数
DBErrorMessage
戻り値のデータ型
String
DeletedCount
Long
DeleteRow
Describe
Integer
String
Drag
Integer
Filter
Integer
FilteredCount
Find
Integer
Long
FindCategory
Integer
FindGroupChange
Long
FindNext
Integer
FindRequired
Integer
FindSeries
Integer
GenerateHTMLForm
Integer
58
説明
データベース エラーによって生成されたエラー メッセー
ジのテキスト(文字列)を返します。
関数仕様の変更 DBErrorMessage 関数は、今後のバージョ
ンではサポートされなくなります。今後はデータベース
エラー メッセージは、イベントの引数として取得できます。
DataWindow コントロール上から削除されたが、データ
ベース テーブルに対する更新が行われていない行の行数
を返します。
指定された行を DataWindow コントロールから削除します。
DataWindow コントロールの構造に関して、指定された情
報を返します。
DataWindow コントロールのドラッグを開始、または終了
します。
現行のフィルタ式を使用して、DataWindow コントロール
の特定の行を表示します。
現行のフィルタ式に適合していない行の行数を返します。
構文 1:DataWindow コントロールの中で、データが指定さ
れた条件に適合する次の行を見つけます。
構文 2: リッチテキスト提示様式の場合は、コントロール
の中から指定されたテキストを見つけて、そのテキストを
ハイライト表示します。検索の方向を指定したり、完全に
一致する単語だけの検索や大文字と小文字の区別を指定
することもできます。
DataWindow コントロール上に配置されたグラフに対し
て、指定された項目ラベルの項目番号を取得します。
DataWindow コントロールの指定されたグループ番号を指
定された行から検索を始めて次のブレーク(グループ セ
クション)の最初の行番号を返します。
Find 関数を前回呼び出したときに設定した条件を使用し
て、コントロール中にある次のテキストをハイライト表示
します。
この関数は、内容がリッチテキスト提示様式の DataWindow
コントロールにのみ適用されます。
必ず入力しなければならないカラムのうち、未入力(Null
値)となっているものを識別します。
DataWindow コントロール上に配置されたグラフに対し
て、指定された系列ラベルの系列番号を取得します。
1 つまたは複数の行のカラムを含む HTML Form 要素を作
成します。スタイル シート情報を含む HTML Style 要素も
返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataWindow 関数
GenerateResultSet
戻り値のデータ型
Long
GetBandAtPointer
String
GetBorderStyle
Border(カタロ
グ データ型)
GetChanges
Long
GetChild
Integer
GetClickedColumn
Integer
GetClickedRow
Long
GetColumn
Integer
GetColumnName
String
GetContextService
Integer
GetData
Double
GetDataPieExplode
GetDataStyle
Integer
Integer
GetDataValue
Integer
オブジェクトとコントロール
説明
EAServer の 1つのコンポーネントとして実行中の PowerBuilder
ユーザ オブジェクトから EAServer 結果集合を返します。
ポインタが現在位置している区域の名前を返します。区域
名に続いて、タブ文字(~t)とその区域に関連付けされた
行番号を返します。
DataWindow コントロール上の指定されたカラムの枠線ス
タイルを示す Border カタログ データ型を返します。値は
以下のとおりです。
Box!
Lowered!
NoBorder!
Raised!
ResizeBorder!
ShadowBox!
Underline!
データウィンドウに対して行われた変更を Blob に取得し
ます。この関数は、主に分散アプリケーションで使用され
ます。
指定されたカラムの子データウィンドウの名前を、指定さ
れた変数に保持します。
DataWindow コントロール内でクリックまたはダブルク
リックされたカラムの番号を返します。
DataWindow コントロール内でクリックまたはダブルク
リックされた行の番号を返します。
DataWindow コントロール内の現行カラムのカラム番号を
返します。
DataWindow コントロール内の現行カラムのカラム名を返
します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
DataWindow コントロール上に配置されたグラフに対し
て、指定された系列番号とデータ ポイント番号のデータ
値を取得します。GetDataValue 関数も参照してください。
円グラフから切り離された一片が突出する割合を返します。
グラフのデータ ポイントの表示形態を調べます。データ系
列内の各データ ポイントには、表示形態を個別に設定でき
ます。調べようとする属性によって構文が異なります。
DataWindow コントロール上に配置されたグラフに対し
て、指定された系列番号とデータ ポイント番号のデータ
値を取得します。
59
DataWindow コントロール
DataWindow 関数
GetFormat
戻り値のデータ型
String
GetFullState
Long
GetItemDate
Date
GetItemDateTime
DateTime
GetItemDecimal
Decimal
GetItemNumber
Double
GetItemStatus
dwItemStatus
(カタログ デー
タ型)
GetItemString
String
GetItemTime
Time
GetMessageText
String
GetNextModified
Long
GetObjectAtPointer
String
GetParent
GetRow
PowerObject
Long
GetRowFromRowId
Long
60
説明
DataWindow コントロール上の指定されたカラムに対する
表示書式を返します。
DataWindow の完全な状態を Blob に取得します。この関数
は、主に分散アプリケーションで使用されます。
DataWindow コントロールの指定された行とカラムの日付
データを取得します。
DataWindow コントロールの指定された行とカラムの日時
データを取得します。
DataWindow コントロールの指定された行とカラムの 10
進数データを取得します。
DataWindow コントロールの指定された行とカラムの数値
データを取得します。
指定されたバッファ内の指定された行とカラムの項目の
ステータスを取得します。値は以下のとおりです。
DataModified!
New!
NewModified!
NotModified!
DataWindow コントロールの指定された行とカラムの文字
列データを取得します。
DataWindow コントロールの指定された行とカラムの時刻
データを取得します。
DataWindow コントロールのクロスタブ DataWindow オブ
ジェクトによって生成されたメッセージ テキストを取得
します。
関数仕様の変更 GetMessageText 関数は、今後のバージョン
ではサポートされなくなります。メッセージ テキストは、
トークン pbm_dwnmessagetext に対応付けたユーザ定義の
DataWindow イベントの引数として取得できます。
DataWindow コントロールの指定されたバッファを、指定
された行から検索を始めて修正状態にある最初の行の行
番号を返します。
ポインタが現在位置している DataWindow コントロール
上のオブジェクトの名前を返します。オブジェクト名に続
いて、タブ文字(~t)と行番号を返します。
親オブジェクト名への参照を返します。
DataWindow コントロールの現行の行番号(整数)を返し
ます。
DataWindow コントロール内の行の行番号を、その行に関
連付けられた固有の行識別子から取得します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataWindow 関数
GetRowIdFromRow
戻り値のデータ型
Long
GetSelectedRow
Integer
GetSeriesStyle
Integer
GetSQLPreview
String
GetSQLSelect
String
GetStateStatus
Long
GetText
String
GetTrans
GetUpdateStatus
Integer
Integer
GetValidate
String
GetValue
String
GroupCalc
Integer
Hide
ImportClipboard
Integer
Long
ImportFile
Long
ImportString
Long
オブジェクトとコントロール
説明
DataWindow コントロール内の行の固有の行識別子を、そ
の行に関連付けられた行番号から取得します。
DataWindow コントロールの指定された行番号の後で、最
初に選択されている行の行番号を返します。
グラフのデータ系列の表示形態を調べます。調べたい内容
によって構文が異なります。
DataWindow コントロールがデータベースへ発行している
現行の SQL 文を返します。
関数仕様の変更 GetSQLPreview 関数は、今後のバージョン
ではサポートされなくなります。今後は SQL 文は、イベ
ントの引数として取得できます。
DataWindow コントロールの現行の SELECT 文を返しま
す。
DataWindow に関する内部状態フラグの現行のステータス
を検索し、その情報を Blob に保管します。この関数は、
主に分散アプリケーションで使用されます。
DataWindow コントロールの現行行とカラムに対する Edit
コントロールのテキストを返します。
DataWindow Transaction オブジェクトの値を取得します。
ある変数の中で更新される行の行番号と、別の変数内にそ
の行を含むバッファを識別する dwBuffer カタログ データ
型の値を格納します。
関数仕様の変更 GetUpdateStatus 関数は、今後のバージョ
ンではサポートされなくなります。更新ステータスは、
DataWindow コントロールの DBError イベントや
SQLPreview イベントの引数として取得できます。
DataWindow コントロールの指定されたカラムに対する入
力条件則を返します。
指定されたカラムに対する値リストの指定された項目の
値を返します。
DataWindow コントロール内のグループのブレークを再計
算します。
コントロールを非表示にします。
クリップボードから DataWindow コントロールにデータ
をコピーします。
ファイルから DataWindow コントロールにデータをコピー
します。
文字列から DataWindow コントロールにデータをコピー
します。
61
DataWindow コントロール
DataWindow 関数
InsertDocument
戻り値のデータ型
Integer
説明
DataWindow コントロールにリッチテキスト形式または通
常のテキスト ファイルを挿入します。挿入方法について
関数のパラメータで次のどちらかを指定します。
• 挿入ポイントに挿入する
• 既存の内容とすべて置き換える
InsertRow
Long
IsSelected
Boolean
LineCount
Integer
ModifiedCount
Long
Modify
String
Move
ObjectAtPointer
Integer
grObjectType
OLEActivate
Integer
Paste
Integer
PasteRTF
Long
PointerX
Integer
PointerY
Integer
Position
Integer
この関数は、内容がリッチテキスト提示様式の DataWindow
コントロールにのみ適用されます。
DataWindow コントロールの指定された行の前に、新たな
行を挿入します。
DataWindow の指定された行が選択されているとき TRUE
を返します。指定された行が選択されていないとき、また
は DataWindow コントロールの行数より大きい数が指定
されたときは FALSE を返します。
複数行が許されている Edit コントロールに保持されてい
る行の数を返します。
DataWindow コントロール上で修正されたが、データベー
ス テーブルへの更新がまだ行われていない行の数を返し
ます。
文字列に含まれる仕様を使って DataWindow コントロール
を変更します。
DataWindow コントロールを指定された位置に移動します。
DataWindow コントロールに配置されたグラフにおいて、
ポインタが位置している系列番号とデータ ポイント番号
を返し、グラフのオブジェクト データ型を識別します。
DataWindow コントロールの指定された行とカラムに位置
する OLE オブジェクトの OLE 機能をアクティブにします。
DataWindow コントロールの現行の行とカラムの Edit コン
トロールに、クリップボードの内容を貼り付けます。
リッチテキスト提示様式の DataWindow コントロールに、
文字列からリッチテキスト データを貼り付けます。
DataWindow コントロールの左端からポインタまでの距離
を返します。
DataWindow コントロールの上部からポインタまでの距離
を返します。
構文 1:DataWindow コントロールの現行フィールド上の
Edit コントロールでの挿入ポイントの位置を取得します。
構文 2: リッチテキスト提示様式の場合、DataWindow コン
トロール上の文書の選択されているテキストの開始点と
終了点、または挿入ポイントの行とカラムの位置を取得し
ます。
62
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataWindow 関数
PostEvent
戻り値のデータ型
Boolean
Print
Integer
PrintCancel
Integer
ReplaceText
Integer
ReselectRow
Integer
Reset
Reset(グラフ)
Integer
Integer
ResetDataColors
ResetTransObject
Integer
Integer
ResetUpdate
Resize
Retrieve
Integer
Integer
Long
RowCount
Long
RowsCopy
Integer
RowsDiscard
Integer
RowsMove
Integer
オブジェクトとコントロール
説明
DataWindow コントロールのメッセージ キューの最後に
イベントを追加します。
DataWindow コントロールの内容を現行プリンタに送信し
ます。構文が何種類かあります。
DataWindow コントロールの内容が印刷されている場合、
印刷ジョブを取り消し、スプール ファイルがあればこれ
を削除します。
この関数には構文が 2 種類あります。Print 関数で印刷が行
われている場合には、構文 1 を使います。
DataWindow コントロールの Edit コントロールで選択され
ているテキストを、指定された文字列と置き換えます。
データベースにアクセスして、更新可能なカラムをすべて
再検索します。DataWindow コントロールに Timestamp 型
のカラムがある場合は、タイムスタンプを元に戻します。
DataWindow コントロールの内容をすべて消去します。
外部データ ソースを用いている DataWindow オブジェク
ト内にあるグラフから、データ、項目または系列を削除し
ます。
データ ポイントの色をその系列に指定された色に戻します。
プログラマが定義した Transaction オブジェクトを
DataWindow オブジェクトが使用するのを中止します(こ
れ以降、DataWindow 内部の Transaction オブジェクトが使
用されます)。
DataWindow コントロールの更新フラグをリセットします。
DataWindow コントロールの幅と高さを変更します。
DataWindow コントロールにデータベースを検索させ、
データ行を表示します。
DataWindow コントロールで現在使用可能な行の数(検索
された全行数から削除された行数を引いたものに、挿入さ
れた行数を加え、さらにフィルタで非表示となっている行
数を引いた数)を返します。
ある DataWindow コントロールから別の DataWindow コン
トロールに、指定された範囲の行をコピーします。また、
1 つの DataWindow コントロール内でのバッファ間のコ
ピーにも使用できます。
指定された範囲の行を廃棄します。廃棄された行はデータ
ベースから再検索しなければ復元できません。
DataWindow コントロールから指定された範囲の行を削除
して、その行を別の DataWindow コントロール、または同
じ DataWindow コントロール内の別のバッファにコピー
します。
63
DataWindow コントロール
DataWindow 関数
SaveAs(グラフ)
戻り値のデータ型
Integer
SaveAs
Integer
SaveAsAscii
Long
Scroll
Integer
ScrollNextPage
Long
ScrollNextRow
Long
ScrollPriorPage
Long
ScrollPriorRow
Long
ScrollToRow
Integer
SelectedLength
Integer
SelectedLine
Integer
SelectedStart
Integer
SelectedText
String
SelectRow
Integer
64
説明
DataWindow コントロールの指定されたグラフにあるデー
タを、指定された形式で指定したファイルに保存します。
DataWindow コントロールの内容を指定された形式で指定
されたファイルに保存します。必要に応じて先頭にカラム
ヘッダを付けます。
DataWindow の内容を標準の ASCII テキスト ファイルに保
存します。
DataWindow コントロールの Edit コントロールを指定され
た行数だけ上下にスクロールします。
構文 1:リッチテキスト提示様式でない DataWindow コント
ロールを 1 ページ分の行数だけ前方にスクロールします。
構文 2:リッチテキスト提示様式の DataWindow コントロー
ル内の文書を次のページにスクロールします。
DataWindow コントロールを次の行へスクロールします。
ScrollNextRow 関数を使用すると現行の行は変わりますが、
現行カラムは変わりません。
構文 1:リッチテキスト提示様式でない DataWindow コント
ロールを 1 ページ分の行数だけ後方にスクロールします。
構文 2:リッチテキスト提示様式の DataWindow コントロー
ル内の文書を前のページにスクロールします。
前の行へスクロールします。ScrollPriorRow 関数を使用する
と、DataWindow コントロールの現行の行は変わりますが、
現行カラムは変わりません。
コントロールを指定された行までスクロールします。
ScrollToRow 関数を使用すると、DataWindow コントロール
の現行の行は変わりますが、現行カラムは変わりません。
DataWindow コントロールの現行フィールド上で選択され
ているテキストの文字やスペースの合計数(長さ)を返し
ます。
DataWindow コントロール上で挿入ポイントの位置する行
の行番号を取得します。
DataWindow コントロールの選択されたテキストの最初の
文字のある位置を取得します。
DataWindow コントロールの現行フィールドで選択されて
いるテキストを取得します。
DataWindow コントロールの指定した行の選択または選択
解除を行います。
PowerBuilder
第2章
DataWindow 関数
SelectText
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
戻り値のデータ型
Integer
SelectTextAll
Integer
SelectTextLine
Integer
SelectTextWord
Integer
SeriesCount
Integer
SeriesName
String
SetActionCode
Integer
SetBorderStyle
Integer
SetChanges
Long
SetColumn
Integer
GetDataPieExplode
Integer
SetDataStyle
Integer
説明
構文 1:リッチテキスト提示様式でない DataWindow コント
ロールの Edit コントロールのテキストを選択し、ハイラ
イト表示にします。選択の開始位置とバイト数を指定しま
す。
構文 2:リッチテキスト提示様式の DataWindow コントロー
ル内のテキストを指定しハイライト表示にします。選択の
開始位置と終了位置を行数とバイト数で指定します。
リッチテキスト提示様式の DataWindow コントロールの
内容をすべて選択します。
リッチテキスト提示様式の DataWindow コントロール上
の挿入ポイントの位置する行を選択します。
リッチテキスト提示様式の DataWindow コントロール上
の挿入ポイントの位置する単語を選択します。
DataWindow コントロール上に配置したグラフの系列数を
返します。
DataWindow コントロール上に配置したグラフに対し、系
列番号を指定してその系列名を取得します。
イベント発生後に DataWindow コントロールが行うアク
ションを指定します。
関数仕様の変更 SetActionCode 関数は、今後のバージョン
ではサポートされなくなります。今後はイベントのスクリ
プトに RETURN 文を記述してリターン コードを設定して
ください。
DataWindow コントロールの指定されたカラムの枠線スタ
イルを設定します。
GetChanges で取り込まれた変更を DataWindow に適用し
ます。この関数は、主に分散アプリケーションで使用され
ます。
DataWindow コントロールの指定されたカラムを現行カラ
ムにします。
円グラフから一片を切り離します。
DataWindow コントロールに配置されたグラフに対して、
指定された系列番号とデータ ポイント番号に、次のよう
な表示設定を行います。
構文 1: データ ポイントの色の設定
構文 2: データ ポイントの線種と幅の設定
SetDetailHeight
Integer
オブジェクトとコントロール
構文 3: データ ポイントに対する塗りつぶしパターンと記
号の設定
指定された範囲に位置する各行の高さを設定します。
65
DataWindow コントロール
DataWindow 関数
SetFilter
戻り値のデータ型
Integer
SetFocus
SetFormat
Integer
Integer
SetFullState
Long
SetHTMLAction
Integer
SetItem
Integer
SetItemStatus
Integer
SetPosition
Integer
SetRedraw
Integer
SetRow
Integer
SetRowFocusIndicator
Integer
SetSeriesStyle
Integer
説明
DataWindow コントロールのフィルタ条件式を定義しま
す。実際のフィルタ処理は、Filter 関数によって行われま
す。
DataWindow コントロールにフォーカスを設定します。
DataWindow コントロールの指定されたカラムの表示書式
を設定します。
GetFullState で取得された DataWindow の Blob の内容を
DataWindow に適用します。この関数は、主に分散アプリ
ケーションで使用されます。
Web ブラウザ内の Web DataWindow クライアント コント
ロールとのユーザの対話に関して、アクションおよびコン
テキストの情報を受け入れて、新たに生成される HTML
が変更要求を反映できるようにします。
指定された DataWindow コントロールの指定されたカラ
ムと行に値を設定します。
指定されたバッファ上で DataWindow コントロールの指
定されたカラム内の行のステータスを設定します。
構文 1:DataWindow コントロールを、常時ウィンドウの画
面の前面に表示するかどうかを示します。
構文 2:DataWindow 内のオブジェクトを指定された区域に
移動します。または、区域内でのオブジェクトの表示順序
を上から下へと変更します。
DataWindow コントロールのプロパティや内容を変更する
たびに、DataWindow コントロールを自動再描画するかど
うかを設定します。
DataWindow コントロールの指定された行を現行の行にし
ます。
DataWindow コントロールの現行の行に対するビジュアル
インジケータを設定します。
DataWindow コントロールに配置されたグラフに対して、
指定された系列名に次のような表示設定を行います。
構文 1: その系列に対する色の設定
構文 2: 線種や幅の設定
構文 3: その系列のデータ マーカーの塗りつぶしパターン
や記号の設定
SetSort
Integer
SetSQLPreview
Integer
66
構文 4: オーバーレイの指定
DataWindow コントロールのソート条件式を定義します。
実際のソート処理は、Sort 関数によって実行されます。
DataWindow コントロールの現行の SQL 文を設定します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataWindow 関数
SetSQLSelect
戻り値のデータ型
Integer
SetTabOrder
Integer
SetText
Integer
SetTrans
Integer
SetTransObject
Integer
SetValidate
Integer
SetValue
Integer
ShareData
Integer
ShareDataOff
Integer
Show
ShowHeadFoot
Integer
Integer
Sort
Integer
TextLine
String
TriggerEvent
Integer
TypeOf
Undo
Object
Integer
Update
Integer
オブジェクトとコントロール
説明
DataWindow コントロールの現行の SELECT 文を変更しま
す。
DataWindow コントロール上の指定されたカラムのタブ値
(順序)を変更します。
DataWindow コントロールの現行の行とカラムに対する
Edit コントロールのテキストを、指定されたテキストに置
き換えます。
DataWindow コントロールの内部 Transaction オブジェクト
の値を設定します。
DataWindow コントロールの Transaction オブジェクトを設
定します。この設定後、スクリプトによる操作などでトラ
ンザクション管理を行います。
DataWindow コントロールの指定されたカラムに使われて
いる入力条件則を変更します。
DataWindow コントロールの指定されたカラムの値リスト
またはコード表中の項目の値を設定します。
第 1 DataWindow コントロールと第 2 DataWindow コント
ロール間でデータを共有します。
DataWindow コントロール間のデータ共有を無効にしま
す。第 1 DataWindow コントロールが無効にされた場合に
は、その第 2 DataWindow コントロールは接続が解除され、
保持していたデータを失います。
DataWindow コントロールを表示します。
リッチテキスト提示様式の DataWindow コントロールに
対し、ヘッダ / フッタ編集パネルを開いて表示するか、あ
るいはパネルを閉じてメイン テキストの編集に戻ります。
DataWindow コントロールの行を、現行のソート条件を基
にしてソートします。
現行の行の現行カラム上に位置する Edit コントロールに
関する情報を取得します。
DataWindow コントロールのイベントを起動し、そのイベ
ントに関連付けられたスクリプトを実行します。
コントロールのデータ型を返します。
現行の行の現行カラム上に位置する Edit コントロールで
行った最後の編集内容を取り消します。
DataWindow コントロールで行われた挿入、削除、更新の
内容をデータベースに送信します。
67
DataWindowChild オブジェクト
DataWindowChild オブジェクト
DataWindowChild オブジェクトは、ネスティッド レポート、または
DataWindow オブジェクト内に配置されたドロップダウン データウィ
ンドウです。たとえば、ドロップダウン データウィンドウ編集様式の
カラムに割り当てられた DataWindow オブジェクトが、DataWindowChild
オブジェクトです。
DataWindowChild オブジェクトは、DataWindow の本来の機能とは独立
して DataWindow オブジェクトにアクセスするために使用されます。
DataWindowChild オブジェクトは、ストレージを持ち、自動インスタ
ンス生成も設定されているので、システムの Structure オブジェクトを
継承しています。
DataWindowChild オブジェクトにはイベントがありません。
関数仕様の変更
コントロール関数の中には「関数仕様の変更」と記述されているもの
があります。これは、その関数が今回のバージョンで使用することは
できますが、今後のバージョンではサポートされないことを示してい
ます。できるだけ早い時期に、そのような関数の使用をやめ、別の関
数を使用するようにしてください。
プロパティ
DataWindowChild
プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
DataWindowChild 関数
AcceptText
戻り値のデータ型
Integer
ClassName
ClearValues
String
String
説明
Edit コントロールの内容を DataWindowChild バッファの
現行項目に適用します。
DataWindowChild に与えられた名前を返します。
DataWindow コントロールのカラムに関連付けられた値リ
ストまたはコード表の項目をすべて削除します。
関数
68
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataWindowChild 関数
CrosstabDialog
戻り値のデータ型
Integer
DBCancel
DBErrorCode
Integer
Long
DBErrorMessage
String
DeletedCount
Long
DeleteRow
Describe
Integer
String
Filter
Integer
FilteredCount
Integer
Find
Long
FindGroupChange
Long
GetBandAtPointer
String
GetBorderStyle
Border(カタロ
グ データ型)
オブジェクトとコントロール
説明
クロスタブの定義 ダイアログボックスを表示して、ユー
ザが実行中にクロスタブ提示様式 DataWindow の定義を
変更できるようにします。
実行中のデータベース検索を中止します。
データベース エラーによって生成されたエラー コード
(数値)を返します。
関数仕様の変更 DBErrorCode 関数は、今後のバージョンで
はサポートされなくなります。今後はデータベース エ
ラー コードは、イベントの引数として取得できます。
データベース エラーによって生成されたエラー メッセー
ジのテキスト(文字列)を返します。
関数仕様の変更 DBErrorMessage 関数は、今後のバージョン
ではサポートされなくなります。今後はデータベース エ
ラー メッセージは、イベントの引数として取得できます。
DataWindowChild から削除されたが、関連するデータベー
ス テーブルではまだ未更新の行の行数を返します。
指定された行を DataWindowChild から削除します。
DataWindowChild の構造に関して指定された情報を返し
ます。
現行フィルタ式を使用して、DataWindowChild の指定され
た行を表示します。
DataWindowChild の現行フィルタ式によって、非表示と
なっている行の行数を返します。
DataWindowChild の詳細領域の中の指定した検索範囲内
で、検索条件に適合する最初の行の行番号を返します。
DataWindowChild の指定されたグループ番号の指定され
た行から検索を始めて次のブレーク(グループ セクショ
ン)の最初の行番号を返します。
ポインタが現在位置している区域の名前を返します。区域
名に続いて、タブ文字(~t)とその区域に関連付けされた
行番号を返します。
DataWindowChild 上の指定したカラムの枠線スタイルを
示す Border カタログ データ型を返します。値は以下のと
おりです。
Box!
Lowered!
NoBorder!
Raised!
ResizeBorder!
ShadowBox!
Underline!
69
DataWindowChild オブジェクト
DataWindowChild 関数
GetChanges
戻り値のデータ型
Long
GetChild
Integer
GetClickedColumn
Integer
GetClickedRow
Long
GetColumn
GetColumnName
GetContextService
Integer
String
Integer
GetFormat
String
GetItemDate
Date
GetItemDateTime
DateTime
GetItemDecimal
Decimal
GetItemNumber
Double
GetItemStatus
dwItemStatus
(カタログ デー
タ型)
GetItemString
String
GetItemTime
Time
GetNextModified
Long
GetObjectAtPointer
String
70
説明
データウィンドウに対して行われた変更を Blob に取得し
ます。この関数は、主に分散アプリケーションで使用され
ます。
子データウィンドウへの参照、またはコンポジット デー
タウィンドウのレポートへの参照を提供します。この参照
を DataWindow 関数で使用すれば、該当するデータウィン
ドウまたはレポートを操作できます。
DataWindowChild 内でクリックまたはダブルクリックさ
れたカラムの番号を返します。
DataWindowChild 内でクリックまたはダブルクリックさ
れた行の番号を返します。
DataWindowChild 内の現行カラムのカラム番号を返します。
DataWindowChild 内の現行のカラム名を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
DataWindowChild 上の指定されたカラムに対する表示書
式を返します。
DataWindowChild の指定された行とカラムの日付データ
を取得します。
DataWindowChild の指定された行とカラムの日時データ
を取得します。
DataWindowChild の指定された行とカラムの 10 進数デー
タを取得します。
DataWindowChild の指定された行とカラムの数値データ
を取得します。
指定されたバッファ内の指定された行とカラムの項目の
ステータスを取得します。値は以下のとおりです。
DataModified!
New!
NewModified!
NotModified!
DataWindowChild の指定された行とカラムの文字列デー
タを取得します。
DataWindowChild の指定された行とカラムの時刻データ
を取得します。
DataWindowChild の指定されたバッファを、指定された行
から検索を始めて修正状態にある最初の行の行番号を返
します。
ポインタが現在位置している DataWindowChild のカラム
またはグラフィック コントロールの名前を返します。続
いて、タブ文字(~t)、それから行番号を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataWindowChild 関数
GetParent
GetRow
GetRowFromRowId
戻り値のデータ型
PowerObject
Long
Long
GetRowIdFromRow
Long
GetSelectedRow
Integer
GetSQLPreview
String
GetSQLSelect
GetText
String
String
GetTrans
Integer
GetUpdateStatus
Integer
GetValidate
String
GetValue
String
GroupCalc
ImportClipboard
Integer
Long
ImportFile
ImportString
InsertRow
Long
Long
Long
IsSelected
Boolean
オブジェクトとコントロール
説明
親オブジェクト名への参照を返します。
DataWindowChild の現行の行番号(整数)を返します。
DataWindow コントロール内の行の行番号を、その行に関
連付けられた固有の行識別子から取得します。
DataWindow コントロール内の行の固有の行識別子を、そ
の行に関連付けられた行番号から取得します。
DataWindowChild の指定された行番号の後で、最初に選択
されている行の行番号を返します。
DataWindowChild の現行の SQL 文を返します。
関数仕様の変更 GetSQLPreview 関数は、今後のバージョン
ではサポートされなくなります。今後は SQL 文は、イベ
ントの引数として取得できます。
DataWindowChild の現行の SELECT 文を返します。
DataWindowChild の現行の行とカラム上の Edit コントロー
ルのテキストを返します。
DataWindowChild Transaction オブジェクトの値を取得しま
す。
ある変数の中で更新される行の行番号と、別の変数内にそ
の行を含むバッファを識別する dwBuffer カタログ データ
型の値を格納します。
関数仕様の変更 GetUpdateStatus 関数は、
今後のバージョン
ではサポートされなくなります。今後は更新ステータス
は、DataWindow コントロールの DBError イベントや
SQLPreview イベントの引数として取得できます。
DataWindowChild の指定されたカラムに対する入力条件則
を返します。
指定されたカラムに対する値リストの指定された項目の値
を返します。
DataWindowChild 内のグループのブレークを再計算します。
クリップボードから DataWindowChild にデータをコピー
します。
ファイルから DataWindowChild にデータをコピーします。
文字列から DataWindowChild にデータをコピーします。
DataWindowChild の指定された行の前に、新たな行を挿入
します。
DataWindowChild の指定された行が選択されているとき
TRUE を返します。
指定された行が選択されていないとき、
または DataWindowChild の行数より大きい数が指定され
たときは FALSE を返します。
71
DataWindowChild オブジェクト
DataWindowChild 関数
ModifiedCount
戻り値のデータ型
Long
Modify
String
OLEActivate
Integer
ReselectRow
Integer
Reset
ResetTransObject
Integer
Integer
ResetUpdate
Retrieve
Integer
Long
RowCount
Long
RowsCopy
Integer
RowsDiscard
Integer
RowsMove
Integer
SaveAs
Integer
ScrollNextPage
Long
ScrollNextRow
Long
ScrollPriorPage
Long
72
説明
DataWindowChild 上で修正されたが、関連するデータベー
ス テーブルへの更新がまだ行われていない行の数を返し
ます。
文字列に含まれる仕様を使って DataWindowChild を変更
します。
DataWindowChild の指定された行とカラムに位置する
OLE オブジェクトの OLE 機能をアクティブにします。
データベースにアクセスして、更新可能なカラムをすべて
再検索します。DataWindowChild の行に Timestamp 型のカ
ラムがある場合は、タイムスタンプを元に戻します。
DataWindowChild の内容をすべて消去します。
プログラマが定義した Transaction オブジェクトを
DataWindowChild が使用するのを中止します(これ以降、
DataWindow は内部の Transaction オブジェクトを使用しま
す)。
DataWindowChild の更新フラグをリセットします。
DataWindowChild にデータベースを検索させ、データ行を
表示します。
DataWindowChild で現在使用可能な行の数(検索された全
行数から削除された行数を引いたものに、挿入された行数
を加え、さらにフィルタで非表示となっている行数を引い
た数)を返します。
DataWindowChild オブジェクト同士や DataWindowChild 内
のバッファ同士の間で指定された範囲の行をコピーしま
す。
指定された範囲の行を廃棄します。廃棄された行はデータ
ベースから再検索しなければ復元できません。
DataWindowChild オブジェクトから指定された範囲の行
を削除して、その行を別の DataWindowChild、または同じ
DataWindowChild の別のバッファにコピーします。
DataWindowChild コントロールの内容を指定された形式
で指定されたファイルに保存します。必要に応じて先頭に
カラム ヘッダを付けます。
DataWindowChild に表示されている行数分だけ前方にス
クロールします。
DataWindowChild を次の行へスクロールします。
ScrollNextRow 関数を使用すると現行の行は変わりますが、
現行カラムは変わりません。
DataWindowChild に表示されている行数分だけ後方へス
クロールします。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DataWindowChild 関数
ScrollPriorRow
戻り値のデータ型
Long
ScrollToRow
Integer
SelectRow
Integer
SetBorderStyle
Integer
SetChanges
Long
SetColumn
Integer
SetDetailHeight
SetFilter
Integer
Integer
SetFormat
Integer
SetItem
Integer
SetItemStatus
Integer
SetPosition
Integer
SetRedraw
Integer
SetRow
SetRowFocusIndicator
Integer
Integer
SetSort
Integer
SetSQLPreview
SetSQLSelect
SetTabOrder
Integer
Integer
Integer
オブジェクトとコントロール
説明
前の行へスクロールします。ScrollPriorRow 関数を使用する
と、DataWindowChild の現行の行は変わりますが、現行カ
ラムは変わりません。
コントロールを指定された行までスクロールします。
ScrollToRow 関数を使用すると、DataWindowChild の現行の
行は変わりますが、現行カラムは変わりません。
DataWindowChild の指定された行の選択または選択解除
を行います。
DataWindowChild の指定されたカラムの枠線スタイルを
設定します。
GetChanges で取り込まれた変更を DataWindow に適用し
ます。この関数は、主に分散アプリケーションで使用され
ます。
DataWindowChild の指定されたカラムを現行カラムにし
ます。
指定された範囲に位置する各行の高さを設定します。
DataWindowChild のフィルタ条件式を定義します。実際の
フィルタ処理は、Filter 関数によって行われます。
DataWindowChild の指定されたカラムの表示書式を設定
します。
DataWindowChild の指定されたカラムと行の値を設定し
ます。
指定されたバッファ上で DataWindowChild の指定された
カラムの行のステータスを設定します。
DataWindowChild 内のオブジェクトを別の区域に移動し
ます。または、区域内の DataWindowChild オブジェクトの
ウィンドウでの表示順序を変更します。
DataWindowChild のプロパティや内容を変更するたびに、
DataWindowChild を自動再描画するかどうかを設定します。
DataWindowChild の指定された行を現行の行にします。
DataWindowChild の現行の行に対するインジケータを設定
します。
DataWindowChild のソート条件式を定義します。実際の
ソート処理は、Sort 関数によって実行されます。
DataWindowChild の現行の SQL 文を設定します。
DataWindowChild の現行の SELECT 文を変更します。
DataWindowChild 上の指定されたカラムのタブ値(順序)
を変更します。
73
DropDownListBox コントロール
DataWindowChild 関数
SetText
戻り値のデータ型
Integer
SetTrans
Integer
SetTransObject
Integer
SetValidate
Integer
SetValue
Integer
ShareData
Integer
ShareDataOff
Integer
Sort
Integer
TypeOf
Update
Object
Integer
説明
DataWindowChild の現行の行とカラムに対する Edit コン
トロールのテキストを、指定されたテキストに置き換えま
す。
DataWindowChild の内部 Transaction オブジェクトの値を
設定します。
DataWindowChild の Transaction オブジェクトを設定しま
す。この設定後、スクリプトによる操作などでトランザク
ション管理を行います。
DataWindowChild の指定されたカラムに使われている入
力条件則を変更します。
DataWindowChild オブジェクトの指定されたカラムの値
リストまたはコード表中の項目に値を設定します。
主 DataWindowChild オブジェクトと副 DataWindowChild
オブジェクト間でデータを共有します。
DataWindowChild 間のデータ共有を無効にします。主
DataWindowChild オブジェクトが無効にされた場合には、
その副 DataWindowChild オブジェクトは接続が解除され、
保持していたデータを失います。
DataWindowChild の行を、現行のソート条件を基にして
ソートします。
コントロールのデータ型を返します。
DataWindowChild で行われた挿入、削除、更新の内容を
データベースに送信します。
DropDownListBox コントロール
DropDownListBox(ドロップダウン リストボックス)コントロールは、
リストボックスとシングルライン エディットの機能をあわせ持って
います。DropDownListBox には、テキストボックス部分に項目名を入
力することによって項目を選択できるものがあります。このような操
作を行えない DropDownListBox では、リストボックスにある項目をク
リックするか、項目名の先頭の文字を入力して項目を選択します。
リストを表示するには
開発環境で ShowList が FALSE に設定されていて DropDownListBox の
リスト部分が表示されない場合は、実行環境でユーザがテキストボック
スの右端の下向き矢印をクリックするとリスト部分が表示されます。
74
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
DropDownListBox
プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
AccessibleRole
AllowEdit
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コードです。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールのテキストボックス部分への入力を許可す
るかどうかを示します。値は以下のとおりです。
TRUE - 入力を許可します。
FALSE - 入力を許可しません。
AutoHScroll
Boolean
ShowList プロパティが TRUE のときは AllowEdit プロパ
ティも TRUE でなければなりません。
データの入力や削除が行われたとき、コントロールのテキ
ストボックス部分を自動的に左右にスクロールするかど
うかを示します。値は以下のとおりです。
TRUE - 自動的にスクロールします。
FALSE - 自動的にはスクロールしません。
BackColor
Long
Border
Boolean
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。このプ
ロパティを FALSE に設定しても DropDownListBox コント
ロールには何の影響もありません。コントロールには常に
枠線が表示されます。
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
オブジェクトとコントロール
75
DropDownListBox コントロール
DropDownListBox
プロパティ
ClassDefinition
データ型
PowerObject
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - コントロールを使用可能にします。
FALSE - コントロールを使用可能にしません。
FaceName
String
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
76
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。アプリケーションの実行には、選択さ
れた文字セットをサポートしているオペレーティング シ
ステム上で、適切なバージョンの PowerBuilder を使わなけ
ればなりません。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
PowerBuilder
第2章
DropDownListBox
プロパティ
FontPitch
Height
HScrollBar
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
説明
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロールに水平スクロールバーを表示するかどうか
を示します。値は以下のとおりです。
TRUE - 水平スクロールバーを表示します。
FALSE - 水平スクロールバーを表示しません。
ImeMode
Integer
Italic
Boolean
IME(Input Method Editor)のモード設定を示します。この
プロパティは、日本語版 PowerBuilder 上で実行されている
アプリケーションにのみ適用されます。
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Item[ ]
String array
Limit
Integer
Pointer
String
RightToLeft
Boolean
DropDownListBox のリストボックス部分の項目を示しま
す。
DropDownListBox のシングルライン エディット部分に入
力可能な最大文字数を 0 から 32,767 の範囲のバイト数で
示します(0 を指定すると、文字数は制限されません)。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
ShowList
Boolean
コントロールが表示されるときに、DropDownListBox のリ
ストボックス部分のオプション リストを常時表示するか
どうかを示します。値は以下のとおりです。
TRUE - 常に表示します。
FALSE - ユーザが下向き矢印をクリックしたときだけ
表示します。
通常は、このプロパティを FALSE に設定します。ShowList
プロパティが TRUE のときは AllowEdit プロパティも
TRUE でなければならない点に注意してください。
オブジェクトとコントロール
77
DropDownListBox コントロール
DropDownListBox
プロパティ
Sorted
データ型
Boolean
説明
DropDownListBox のリストボックス部分を自動的に昇順で
ソートするかどうかを示します。値は以下のとおりです。
TRUE - 自動的にソートします。
FALSE - 自動的にソートしません。
TabOrder
Integer
Tag
Text
TextColor
String
String
Long
TextSize
Integer
Underline
Boolean
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールのテキストを示します。
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。色についての詳細は、
『PowerScript リファ
レンス』マニュアルの RGB 関数を参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
VScrollBar
Boolean
コントロールに垂直スクロールバーを表示するかどうか
を示します。値は以下のとおりです。
TRUE - 垂直スクロールバーを表示します。
FALSE - 垂直スクロールバーを表示しません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
78
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
イベント
DropDownListBox
イベント
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Modified
Other
RButtonDown
SelectionChanged
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されて、アクティブ状態に
なるとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
コントロールがフォーカスを失ったときに、テキストが変更されていて、
〔Enter〕または〔Tab〕が押されたとき
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
DropDownListBox のリストボックス部分で項目が選択されたとき
関数
DropDownListBox 関数
AddItem
戻り値のデータ型
Integer
ClassName
Clear
String
Integer
Copy
Integer
Cut
Integer
オブジェクトとコントロール
説明
コントロールのリストボックス部分の最後に新しい項目
を追加します。
AddItem 関数は、このコントロールの Item[ ] プロパティを
更新しません。
コントロールに与えられている名前を返します。
選択されたテキストをコントロールから削除します(テキ
ストはクリップボードにコピーされません)。
選択されたテキストをコントロールからクリップボード
にコピーします(ただし、削除はしません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールから切り取り(削除し)、クリップボードにコピー
します。
79
DropDownListBox コントロール
DropDownListBox 関数
DeleteItem
戻り値のデータ型
Integer
DirList
Boolean
DirSelect
Boolean
Drag
FindItem
Integer
Integer
GetContextService
Integer
GetParent
Hide
InsertItem
PowerObject
Integer
Integer
Move
Paste
Integer
Integer
PointerX
PointerY
Position
PostEvent
Integer
Integer
Integer
Boolean
Print
ReplaceText
Integer
Integer
Reset
Resize
SelectedLength
Integer
Integer
Integer
SelectedStart
Integer
SelectedText
String
80
説明
インデックスで指定された項目を、コントロールのリスト
ボックス部分から削除します。
ドロップダウン リストボックスのリストボックス部分
に、指定されたファイル パターンに適合した指定された
タイプのファイルのリストを挿入します。
コントロールで現在選択されている項目を取得し、指定さ
れた変数に代入します。
コントロールのドラッグを開始または終了します。
コントロールのリストボックス部分から、指定された文字
列で始まる項目を検索します。指定されたインデックス以
降で最初に一致する項目を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
ドロップダウン リストボックスのリストボックス部分に
新しい項目を追加します。項目は、指定されたインデック
スの指示する項目の前に挿入されます。
指定された位置にコントロールを移動します。
クリップボードの内容(保持されているものがあれば)を、
コントロールのカーソル位置に挿入します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロール内のカーソル位置を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロール内で選択されたテキストを指定された文字
列と置き換えます。
コントロール上の項目をすべて削除します。
コントロールのサイズを変更します。
コントロール内で選択されているテキストの長さを返し
ます。
コントロール内で選択されているテキストの開始位置を
返します。
コントロール内で選択されているテキストがあれば、それ
を含む文字列を返します(AllowEdit プロパティが TRUE
でなければなりません)。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DropDownListBox 関数
SelectItem
戻り値のデータ型
Integer
SelectText
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
Text
Integer
String
TotalItems
Integer
TriggerEvent
Integer
TypeOf
Control
説明
コントロール中から項目を検索し、選択(ハイライト)状
態にします。項目のテキストがわかっていて位置が不明の
場合は、構文 1 を使用します。項目がリストのどの位置に
あるかわかっていたり、現行の選択項目を非選択にする場
合には、構文 2 を使用します。
開始位置と長さで指定されたコントロール内のテキスト
を選択します。コントロールにフォーカスがあるときに、
そのテキストがハイライト表示されます。
ボックス内の最初の項目にフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
ドロップダウン リストボックスのリストボックス部分か
ら、指定されたインデックスに位置する項目のテキストを
取得します。
ドロップダウン リストボックスのリストボックス部分の
項目の数を返します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
DropDownPictureListBox コントロール
DropDownPictureListBox(ドロップダウン ピクチャ リストボックス)
コントロールは、DropDownListBox コントロールと同じ働きをします
が、リスト中の項目にピクチャが関連付けられている点が違います。
DropDownPictureListBox コントロールでは、次の形式のピクチャを使
用できます。ビットマップ(BMP ファイル)、アイコン(ICO ファイ
ル)、カーソル(CUR ファイル)、GIF(Animated GIF は使用不可)ファ
イル、または JPEG ファイル。
オブジェクトとコントロール
81
DropDownPictureListBox コントロール
リストを表示するには
開発環境で ShowList が FALSE に設定されていて
DropDownPictureListBox のリスト部分が表示されない場合は、実行環
境でユーザがテキストボックスの右端の下向き矢印をクリックすると
リスト部分が表示されます。
プロパティ
DropDownPictureList
Box プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
AccessibleRole
AllowEdit
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コードです。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールのテキストボックス部分への入力を許可す
るかどうかを示します。値は以下のとおりです。
TRUE - 入力を許可します。
FALSE - 入力を許可しません。
ShowList プロパティが TRUE のときは AllowEdit プロパ
ティも TRUE でなければなりません。
AutoHScroll
Boolean
データの入力や削除が行われたとき、コントロールのテキ
ストボックス部分を自動的に左右にスクロールするかど
うかを示します。値は以下のとおりです。
TRUE - 自動的にスクロールします。
FALSE - 自動的にはスクロールしません。
BackColor
82
Long
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
PowerBuilder
第2章
DropDownPictureList
Box プロパティ
Border
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
コントロールに枠線を付けるかどうかを示します。このプ
ロパティを FALSE に設定してもコントロールには影響は
ありません。コントロールには常に枠線が表示されます。
値は以下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - 適用されません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - コントロールを使用可能にします。
FALSE - コントロールを使用可能にしません。
FaceName
String
オブジェクトとコントロール
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
83
DropDownPictureListBox コントロール
DropDownPictureList
Box プロパティ
FontCharSet
FontFamily
FontPitch
Height
HScrollBar
データ型
FontCharSet
(カタログ デー
タ型)
FontFamily
(カタログ デー
タ型)
説明
コントロール内のテキストに使用されるフォント文字
セットを示します。アプリケーションの実行には、選択さ
れた文字セットをサポートしているオペレーティング シ
ステム上で、適切なバージョンの PowerBuilder を使わなけ
ればなりません。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロールに水平スクロールバーを表示するかどうか
を示します。値は以下のとおりです。
TRUE - 水平スクロールバーを表示します。
FALSE - 水平スクロールバーを表示しません。
ImeMode
Integer
Italic
Boolean
IME(Input Method Editor)のモード設定を示します。この
プロパティは、日本語版 PowerBuilder 上で実行されている
アプリケーションにのみ適用されます。
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Item[ ]
String array
ItemPictureIndex[ ]
Integer
84
DropDownPictureListBox のリストボックス部分の項目の
初期設定を示します。この配列は、初期化後に更新されま
せん。
Item プロパティ配列の各項目に対するピクチャ インデッ
クスの初期設定を示します。これらの値は初期設定の後は
更新されません。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DropDownPictureList
Box プロパティ
Limit
データ型
Integer
PictureHeight
Integer
PictureMaskColor
Long
説明
DropDownPictureListBox のシングルライン エディット部
分に入力可能な最大文字数を 0 から 32,767 の範囲のバイ
ト数で示します(0 を指定すると、文字数は制限されませ
ん)。
ピクチャの高さをピクセル値で示します。
このプロパティは、イメージ リストにイメージがないと
きにのみ設定可能です。最初のイメージが追加されたとき
にこの値が 0 だと、そのイメージのサイズが、その後追加
されるイメージのサイズに適用されます。
ピクチャ配列の初期設定か、または AddPicture 関数で追加
されたユーザ定義のビットマップをマスクするために使
用される色の数値を示します。システムが提供する組み込
みビットマップはマスクの色がすでに指定されており、こ
の指定は無視されます。この値はピクチャが追加されると
きに使用されるので、AddPicture 関数を呼び出す前に変更
できます。
値の範囲は -2 から 16,777,215 です。
PictureName[ ]
PictureWidth
String
Integer
Pointer
String
RightToLeft
Boolean
色についての詳細は、
『PowerScript リファレンス』マニュ
アルの RGB 関数を参照してください。
初期設定で追加されるピクチャを格納してあるファイル
名を示します。拡張子の BMP、ICO、GIF、JPG、JPEG も
必要です。
このプロパティを変更しても、初期化した後は更新されま
せん。
ピクチャの幅をピクセル値で示します。
このプロパティは、イメージ リストにイメージがないと
きにのみ設定可能です。最初のイメージが追加されたとき
にこの値が 0 だと、そのイメージのサイズが、その後追加
されるイメージのサイズに適用されます。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
オブジェクトとコントロール
85
DropDownPictureListBox コントロール
DropDownPictureList
Box プロパティ
ShowList
データ型
Boolean
説明
コントロールが表示されるときに、DropDownPictureListBox
のリストボックス部分のオプション リストを常時表示す
るかどうかを示します。値は以下のとおりです。
TRUE - 常に表示します。
FALSE - ユーザが下向き矢印をクリックしたときだけ
表示します。
Sorted
Boolean
通常は、このプロパティを FALSE に設定します。ShowList
プロパティが TRUE のときは AllowEdit プロ パティも
TRUE でなければならない点に注意してください。
DropDownPictureListBox のリストボックス部分を自動的
に昇順でソートするかどうかを示します。値は以下のとお
りです。
TRUE - 自動的にソートします。
FALSE - 自動的にソートしません。
TabOrder
Integer
Tag
Text
String
String
TextColor
Long
TextSize
Integer
Underline
Boolean
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールのテキストを示します。
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。色についての詳細は、
『PowerScript リファ
レンス』マニュアルの RGB 関数を参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
VScrollBar
Boolean
コントロールに垂直スクロールバーを表示するかどうか
を示します。値は以下のとおりです。
TRUE - 垂直スクロールバーを表示します。
FALSE - 垂直スクロールバーを表示しません。
Weight
86
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DropDownPictureList
Box プロパティ
Width
X
データ型
Integer
Integer
Y
Integer
説明
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
DropDownPictureList
Box イベント
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Modified
Other
RButtonDown
SelectionChanged
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されて、アクティブ状態に
なるとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
コントロールがフォーカスを失ったときに、テキストが変更されていて、
〔Enter〕または〔Tab〕が押されたとき
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
DropDownPictureListBox のリストボックス部分で項目が選択されたとき
オブジェクトとコントロール
87
DropDownPictureListBox コントロール
関数
DropDownPictureList
Box 関数
AddItem
戻り値のデータ型
Integer
説明
コントロールのリストボックス部分の最後に新しい項目
を追加します。
AddItem 関数は、このコントロールの Item[ ] または
AddPicture
Integer
ClassName
Clear
String
Integer
Copy
Integer
Cut
Integer
DeleteItem
Integer
DeletePicture
Integer
DeletePictures
Integer
DirList
Boolean
DirSelect
Boolean
Drag
FindItem
Integer
Integer
GetContextService
Integer
GetParent
Hide
PowerObject
Integer
88
ItemPictureIndex[ ] プロパティを更新しません。
メイン イメージ リストに、ビットマップ ファイルか、ア
イコン ファイルか、カーソル ファイルを追加します。こ
の関数を呼び出しても PictureName[ ] プロパティは更新さ
れません。
コントロールに与えられている名前を返します。
選択されたテキストをコントロールから削除します(テキ
ストはクリップボードにコピーされません)。
選択されたテキストをコントロールからクリップボード
にコピーします(ただし、削除はしません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールから切り取り(削除し)、クリップボードにコピー
します。
インデックスで指定された項目を、コントロールのリスト
ボックス部分から削除します。
指定されたピクチャをイメージ リストから削除します。
この関数を呼び出しても PictureName[ ] プロパティは更新
されません。
すべてのピクチャをイメージ リストから削除します。この
関数を呼び出しても PictureName[ ] プロパティは更新され
ません。
DropDownPictureListBox のリストボックス部分に、指定さ
れたファイル パターンに合致したファイルのリストを挿
入します。
コントロールで現在選択されている項目を取得し、指定さ
れた変数に代入します。
コントロールのドラッグを開始または終了します。
コントロールのリストボックス部分から、指定された文字
列で始まる項目を検索します。指定されたインデックス以
降で最初に一致する項目を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
PowerBuilder
第2章
DropDownPictureList
Box 関数
InsertItem
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
戻り値のデータ型
Integer
Move
Paste
Integer
Integer
PointerX
PointerY
Position
PostEvent
Integer
Integer
Integer
Boolean
Print
ReplaceText
Integer
Integer
Reset
Resize
SelectedLength
Integer
Integer
Integer
SelectedStart
Integer
SelectedText
String
SelectItem
Integer
SelectText
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
Integer
オブジェクトとコントロール
説明
DropDownPictureListBox のリストボックス部分に新しい
項目を追加します。項目は、指定したインデックスの指示
する項目の前に挿入されます。
この関数は、このコントロールの Item[ ] または
ItemPictureIndex[ ] プロパティを更新しません。
指定された位置にコントロールを移動します。
クリップボードの内容(保持されているものがあれば)を、
コントロールのカーソル位置に挿入します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロール内のカーソル位置を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロール内で選択されたテキストを指定された文字
列と置き換えます。
コントロール上の項目をすべて削除します。
コントロールのサイズを変更します。
コントロール内で選択されているテキストの長さを返し
ます。
コントロール内で選択されているテキストの開始位置を
返します。
コントロール内で選択されているテキストがあれば、それ
を含む文字列を返します(AllowEdit プロパティが TRUE
でなければなりません)。
コントロール中から項目を検索し、選択(ハイライト)状
態にします。項目のテキストがわかっていて位置が不明の
場合は、構文 1 を使用します。項目がリストのどの位置に
あるかわかっていたり、現行の選択項目を非選択にする場
合には、構文 2 を使用します。
開始位置と長さで指定されたコントロール内のテキスト
を選択します。コントロールにフォーカスがあるときに、
そのテキストがハイライト表示されます。
ボックス内の最初の項目にフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
89
DynamicDescriptionArea オブジェクト
DropDownPictureList
Box 関数
Text
戻り値のデータ型
String
TotalItems
Integer
TriggerEvent
Integer
TypeOf
Control
説明
DropDownPictureListBox のリストボックス部分から、指定
されたインデックスに位置する項目のテキストを取得し
ます。
DropDownPictureListBox のリストボックス部分の項目の
数を返します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
DynamicDescriptionArea オブジェクト
DynamicDescriptionArea オブジェクトは、動的 SQL の書式 4 で使用さ
れる入力および出力パラメータに関する情報を格納する PowerBuilder
オブジェクトです。
PowerBuilder は、SQLDA という DynamicDescriptionArea 型のグローバ
ル変数を提供しています。DynamicDescriptionArea 型の変数を使用する
必要がある場合は SQLDA を使用できます。必要に応じて、
DynamicDescriptionArea データ型の変数を独自に宣言し、
DynamicDescriptionArea オブジェクトを作成して使用することができま
す。
動的 SQL についての詳細は『PowerScript リファレンス』マニュアルを
参照してください。
プロパティ
DynamicDescription
Area プロパティ
ClassDefinition
データ型
PowerObject
NumInputs
Integer
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
動的 SQL の PREPARE 文で使用する入力パラメータの数を
示します。
PowerBuilder は DESCRIBE 文の実行時にこのプロパティ
に値を代入します。
90
PowerBuilder
第2章
DynamicDescription
Area プロパティ
NumOutputs
InParmType[ ]
OutParmType[ ]
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Integer
説明
PREPARE 文で使用する出力パラメータの数を示します。
データベースが出力パラメータの記述をサポートする時
は、DESCRIBE 文の実行後に値が代入されます。データ
ベースが出力パラメータの記述をサポートしない時は、
FETCH 文の実行後に代入されます。
ParmType(カタ 各入力パラメータのデータ型を示す値(カタログ データ
ログ データ型) 型)の配列。値は以下のとおりです。
TypeBoolean!
TypeDate!
TypeDateTime!
TypeDecimal!
TypeDouble!
TypeInteger!
TypeLong!
TypeReal!
TypeString!
TypeTime!
TypeUInt!
TypeULong!
TypeUnknown
ParmType(カタ 返される各出力パラメータのデータ型の値を示す配列で
ログ データ型) す。
イベント
DynamicDescription
Area イベント
Constructor
Destructor
発生する状況
Open イベントが発生する直前
Close イベントが発生した直後
関数
DynamicDescription
Area 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
91
DynamicDescriptionArea オブジェクト
DynamicDescription
Area 関数
GetDynamicDate
GetDynamicDateTime
GetDynamicNumber
GetDynamicString
GetDynamicTime
戻り値のデータ型
Date
DateTime
Double
String
Time
GetParent
PostEvent
PowerObject
Boolean
SetDynamicParm
Integer
説明
動的 SQL 文の実行後、DynamicDescriptionArea から Date 型
データを取得します。
OutParmType の値が、取得する配列内の値に対して
TypeDate! である場合に GetDynamicDate 関数を使用しま
す。
動的 SQL 文の実行後、DynamicDescriptionArea から
DateTime 型データを取得します。
取得したい値の OutParmType 配列プロパティのデータ型
が TypeDateTime! のときに、GetDynamicDateTime 関数を使
用します。
動的 SQL 文を実行後、DynamicDescriptionArea から数値
データを取得します。
取得したい値の OutParmType 配列プロパティのデータ型
が TypeInteger!、TypeDecimal!、TypeDouble!、TypeLong!、
TypeReal!、TypeBoolean! のいずれかのときに、
GetDynamicNumber 関数を使用します。
動的 SQL 文の実行後、DynamicDescriptionArea から String
型データを取得します。
OutParmType の値が、取得する配列内の値に対して
TypeString! である場合に GetDynamicString 関数を使用しま
す。
動的 SQL 文の実行後、DynamicDescriptionArea から Time
型データを取得します。
OutParmType の値が、取得する配列内の値に対して
TypeTime! である場合に GetDynamicTime 関数を使用しま
す。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後に指定されたイ
ベントを追加します。
SQL の OPEN 文や EXECUTE 文で使用する
DynamicDescriptionArea の入力パラメータに値を設定しま
す。
SetDynamicParm 関数を使用して、DynamicDescriptionArea
TriggerEvent
Integer
TypeOf
Object
92
の入力パラメータ記述子配列にパラメータを設定できま
す。
オブジェクトのイベントを起動し、そのイベントのスクリ
プトを実行します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
DynamicStagingArea オブジェクト
DynamicStagingArea オブジェクトは、動的 SQL 文で使用する情報を格
納する PowerBuilder のシステム オブジェクトです。
DynamicStagingArea オブジェクトは、動的 SQL 文を実行する際に、ト
ランザクション オブジェクトの情報を提供するために、PowerBuilder
が内部的に使用します。DynamicStagingArea の情報にアクセスするこ
とはできませんし、DynamicStagingArea に対するプロパティはありま
せん。
PowerBuilder は、SQLSA という DynamicStagingArea 型のグローバル変
数を提供しています。DynamicStagingArea 変数を使用する必要がある
場合は、この SQLSA を使用できます。必要に応じて、DynamicStagingArea
データ型の変数を独自に宣言し、DynamicStagingArea オブジェクトを
作成して使用することができます。
動的 SQL についての詳細は『PowerScript リファレンス』マニュアルを
参照してください。
プロパティ
DynamicStagingArea
プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
イベント
DynamicStagingArea
イベント
Constructor
Destructor
発生する状況
Open イベントが発生する直前
Close イベントが発生した直後
オブジェクトとコントロール
93
DynamicStagingArea オブジェクト
関数
DynamicStagingArea
関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
PostEvent
PowerObject
Boolean
TriggerEvent
Integer
TypeOf
Object
94
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後に指定されたイ
ベントを追加します。
オブジェクトのイベントを起動し、そのイベントのスクリ
プトを実行します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
EditMask コントロール
EditMask(エディットマスク)コントロールは、SingleLineEdit コント
ロールと同様に、ユーザが 1 行のテキストの入力や編集に使用する
ボックスです。入力できる文字の種類や数は、エディットマスクによっ
て制約され、EditMask コントロール上のテキストの表示方法は指定さ
れたエディットマスクで指定されます。たとえば、電話番号や日付表
示のためのエディットマスクを設定しておけば、ユーザの入力として
自動的に適切な書式で表示されます。
プロパティ
EditMask プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
AccessibleRole
Alignment
AutoHScroll
AccessibleRole
(カタログ デー
タ型)
Alignment
(カタログ デー
タ型)
Boolean
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コードです。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロール内にあるテキストの水平方向の位置の揃え
方を示します。値は以下のとおりです。
Center!
Justify!
Left!
Right!
コントロールに対してデータの入力または削除が行われ
るとき、コントロールを自動的に左右にスクロールするか
どうかを示します。値は以下のとおりです。
TRUE - 自動的に左右にスクロールします。
FALSE - 自動的にはスクロールしません。
AutoSkip
Boolean
エディットマスクに最後の文字が入力された後、次のコン
トロールにスキップするかどうかを示します。値は以下の
とおりです。
TRUE - 次のコントロールにスキップします。
FALSE - 次のコントロールにスキップしません。
オブジェクトとコントロール
95
EditMask コントロール
EditMask プロパティ
AutoVScroll
データ型
Boolean
説明
コントロールに対してデータの入力や削除が行われると
き、コントロールを自動的に上下にスクロールするかどう
かを示します。値は以下のとおりです。
TRUE - 自動的に上下にスクロールします。
FALSE - 自動的にはスクロールしません。
BackColor
Long
Border
Boolean
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DisplayData
DisplayOnly
String
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールの初期状態で表示するデータを示します。
コントロールのテキストを表示専用にし、ユーザが変更で
きないようにするかどうかを示します。値は以下のとおり
です。
TRUE - テキストは表示専用です。
ユーザは変更できま
せん。
DragAuto
Boolean
FALSE - テキストは変更できます。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
96
PowerBuilder
第2章
EditMask プロパティ
DragIcon
Enabled
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
String
Boolean
説明
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示します。
TRUE - コントロールを使用可能にします。
FALSE - コントロールを使用可能にしません。
FaceName
String
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Height
HScrollBar
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
すべてのデータを表示しきれない場合に、コントロールに
水平スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - 水平スクロールバーを表示します。
FALSE - 水平スクロールバーを表示しません。
HideSelection
Boolean
コントロールがフォーカスを失っても、選択されているテ
キストを選択された(ハイライト表示された)ままにする
かどうかを示します。
TRUE - テキストのハイライト表示は解除されます。
FALSE - テキストはハイライト表示されたままです。
オブジェクトとコントロール
97
EditMask コントロール
EditMask プロパティ
IgnoreDefaultButton
データ型
Boolean
ImeMode
Integer
Increment
Italic
Double
Boolean
説明
ユーザが〔Enter〕を押したときに、ウィンドウのデフォ
ルト コマンド ボタンに対する Clicked イベントを起動す
るかどうかを示します。値は以下のとおりです。
TRUE - デフォルトのコマンド ボタンの Clicked イベ
ントを起動しません。EditMask に新しい行を追加しま
す。
FALSE - デフォルトのコマンド ボタンの Clicked イベ
ントを起動します。EditMask に新しい行を追加しませ
ん(デフォルト)。
IME(Input Method Editor)のモード設定を示します。この
プロパティは、日本語版 PowerBuilder 上で実行されている
アプリケーションにのみ適用されます。
スピンの増減値を示します。
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Limit
Integer
Mask
String
MaskDataType
MaskDataType
(カタログ デー
タ型)
MinMax
Pointer
String
String
RightToLeft
Boolean
コントロールに入力可能な最大の文字数を、0 から 32,767
バイトの範囲で示します(0 を指定すると、文字数は無制
限です)。
コントロールのデータを書式化したり、入力する際に使用
するマスクを指定します。
コントロールのデータ型を示します。値は以下のとおりで
す。
DateMask!
DateTimeMask!
DecimalMask!
NumericMask!
StringMask!
TimeMask!
スピンの最小値と最大値を示します。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
98
PowerBuilder
第2章
EditMask プロパティ
Spin
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
スピンの値がスクロールされるようにするかどうかを示
します。値は以下のとおりです。
TRUE - スピンの値がスクロールします。
FALSE - スピンの値がスクロールしません。
TabOrder
TabStop[ ]
Tag
Text
TextColor
TextCase
TextSize
Underline
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
Integer
コントロール内のタブ ストップの位置を示します。
String
コントロールに割り当てるタグの値を示します。
String
コントロールに表示されるテキストを指定します。
Long
コントロールのテキストに使用する色を示します。色につ
いての詳細は、
『PowerScript リファレンス』マニュアルの
RGB 関数を参照してください。
TextCase(カタ 入力された英文テキストを大文字と小文字のどちらで表
ログ データ型) 示するかを示します。値は以下のとおりです。
AnyCase!
Lower!
Upper!
Integer
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
Integer
Boolean
TextSize と EditMask の動作については、オンライン ヘル
プを参照してください。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
UseCodeTable
Boolean
適切なデータだけが入力されるように、カラムに対して
コード表を使用するかどうかを示します。値は以下のとお
りです。
TRUE - コード表を使用します。
FALSE - コード表を使用しません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
オブジェクトとコントロール
99
EditMask コントロール
EditMask プロパティ
VScrollBar
データ型
Boolean
説明
すべてのデータを表示しきれない場合に、コントロールに
垂直スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - 垂直スクロールバーを表示します。
FALSE - 垂直スクロールバーを表示しません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
EditMask イベント
Constructor
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Modified
Other
RButtonDown
100
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
コントロールが変更されてからフォーカスを失ったとき(アクティブ状態で
なくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
EditMask 関数
CanUndo
戻り値のデータ型
Boolean
ClassName
Clear
String
Integer
Copy
Integer
Cut
Integer
Drag
GetContextService
Integer
Integer
GetData
Integer
GetParent
Hide
LineCount
LineLength
Move
Paste
PowerObject
Integer
Integer
Integer
Integer
Integer
PointerX
PointerY
Position
PostEvent
Integer
Integer
Integer
Boolean
Print
Integer
ReplaceText
Integer
Resize
Scroll
Integer
Integer
オブジェクトとコントロール
説明
コントロールで最後に行った編集を、Undo 関数によって
元に戻すことができる場合に TRUE を返します。そうでな
い場合は FALSE を返します。
コントロールに与えられている名前を返します。
選択されたテキスト(選択されたものがあれば)をコント
ロールから削除します(テキストはクリップボードにコ
ピーされません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールからクリップボードにコピーします(ただし、削除
はしません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールから切り取り(削除し)、クリップボードにコピー
します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
コントロール内のデータを書式表示されていない形で取
得します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
エディットマスク上の行数を返します。
カーソルが位置している行の長さを返します。
指定された位置にコントロールを移動します。
クリップボードの内容(コピーされているものがあれば)
を、コントロールの挿入ポイントの位置に挿入します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロール内の挿入ポイントの位置を返します。
指定されたイベントをコントロールのメッセージ キュー
の最後に追加します。
コントロールを印刷します。
現在選択されているテキストを指定した文字列と置き換
えます。テキストが選択されていない場合は、その文字列
を挿入ポイントの位置に挿入します。
コントロールの幅と高さを変更します。
コントロールの内容を指定された行数分だけ上下にスク
ロールします。
101
EditMask コントロール
EditMask 関数
SelectedLength
戻り値のデータ型
Integer
SelectedLine
Integer
SelectedStart
Integer
SelectedText
String
SelectText
Integer
SetFocus
SetMask
Integer
Integer
SetPosition
Integer
SetRedraw
Integer
Show
TextLine
Integer
String
TriggerEvent
Integer
TypeOf
Undo
Object
Integer
102
説明
コントロール上で選択されているテキストの文字やス
ペースの数(長さ)を返します。
コントロール上で挿入ポイントが位置している行の行番
号を返します。
コントロール内で選択されているテキストの先頭の文字
の位置を返します。
コントロール内で選択されているテキストがあれば、その
文字列を返します。
コントロール内の指定された開始位置と長さ(文字数)の
テキストを指定して選択します。
コントロールにフォーカスを設定します。
コントロールに対してエディットマスクの内容とデータ
型を指定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
挿入ポイントが現在位置している行のテキスト全体を返
します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
コントロールで最後に行った編集内容を元に戻します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
EnumerationDefinition オブジェクト
カタログ データ型の変数の型についての情報を保持します。
EnumerationDefinition は TypeDefinition から継承されます。イベントは
ありません。
プロパティ
EnumerationDefinition
プロパティ
Category
データ型
TypeCategory
説明
単純型かカタログ データ型か、またはクラスか構造体か
を示します。値は以下のとおりです。
SimpleType!
EnumeratedType!
ClassOrStructureType!
ClassDefinition
PowerObject
DataTypeOf
String
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
変数のシステム クラス名または単純データ型。
DataTypeOf は、オブジェクトのカタログ データ型の値を
表す文字列です。値は感嘆符なしの小文字です。サンプ
ル値には以下のようなものがあります。
window
string
any
dropdownlistbox
開発者が定義したオブジェクトの場合、データ型はそのオ
ブジェクトの継承元のシステム クラスになります。
Enumeration[ ]
IsStructure
IsSystemType
EnumerationItem
Definition
Boolean
Boolean
IsVariableLength
Boolean
列挙されているすべての項目の名前と値のペアの配列と
なります。
型が構造体かどうかを示します。常に FALSE です。
変数のクラスが、PBL でユーザが定義するクラスではな
く、PowerBuilder 内で定義されるクラスの 1 つであるシス
テム クラスであるかどうかを示します。
データ型が固定サイズかどうかを示します。常に TRUE で
す。
値は以下のとおりです。
TRUE - データ型は可変長です。つまり、データ型が、
string、any、blob、または可変長配列であることを示し
ます。
FALSE - データ型は固定長です。
オブジェクトとコントロール
103
EnumerationDefinition オブジェクト
EnumerationDefinition
プロパティ
IsVisualType
データ型
Boolean
LibraryName
String
Name
String
説明
データ型がビジュアルであるかどうかを示します。常に
FALSE です。
ロード元となるクラス ライブラリの絶対パス名です。ラ
イブラリにそのクラスが存在しない場合があるので注意
してください。つまり、プログラムによってライブラリの
内容が変えられると、ロードされた後のクラスがライブラ
リから移動または削除される場合があります。
クラスの名前。ネスティッド クラスの場合は、
libraryEntryName`className の形式で返されます。
関数
EnumerationDefinition
関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
104
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
EnumerationItemDefinition オブジェクト
カタログ データ型の値の名前と関連する数値についての情報を提供
するクラスです。EnumerationDefinition クラスで使用されます。イベン
トはありません。
プロパティ
EnumerationItem
Definition プロパティ
ClassDefinition
データ型
PowerObject
Name
String
Value
Long
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
カタログ値の名前。たとえば Left! は、カタログ データ型
Alignment の値に名前を付けたものです。
名前に関連付けられた数値。たとえば 0 は、PowerBuilder
が Left! に関連付けた数値です。
数値を使用するのは、オブジェクト用のソース コードを
作成するときだけです。PowerBuilder では、名前付きの値
を使用する方が間違いがありません。
関数
EnumerationItem
Definition 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
105
Environment オブジェクト
Environment オブジェクト
Environment(環境)オブジェクトは、PowerBuilder アプリケーション
が実行されているプラットフォームについての情報を保持するシステ
ム構造体です。このオブジェクトを取り込むには、GetEnvironment 関数
を使用します。
Environment オブジェクトにはイベントがありません。
GetEnvironment 関数についての詳細は、
『PowerScript リファレンス』マ
ニュアルを参照してください。
プロパティ
Environment プロパティ
CharSet
データ型
説明
CharSet(カタ
PowerBuilder で使用される各国の文字セットです。値は以
ログ データ型) 下のとおりです。
• CharSetAnsi!
• CharSetUnicode!
• CharSetDBCS!
• CharSetDBCSJapanese!
ClassDefinition
CPUType
Language
MachineCode
PowerObject
CPUTypes
(カタログ デー
タ型)
LanguageID
(カタログ デー
タ型)
Boolean
PowerBuilder 6 以降では、CharSetAnsiArabic! と
CharSetAnsiHebrew! を選択できません。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
プラットフォームの CPU の種類。オブジェクト ブラウザ
の[カタログ データ型]タブを参照してください。
マシンの言語設定の値を示します。LanguageID の値の詳
細については、ブラウザの[カタログ データ型]タブを
参照してください。
アプリケーションの実行ファイルがマシン コード(コン
パイル済み)かどうかを示します。値は以下のとおりです。
TRUE - 実行ファイルはマシン コードです。
FALSE - 実行ファイルはマシン コードではありません。
OSFixesRevision
Integer
OSMajorRevision
Integer
106
オペレーティング システムのメンテナンス リリース番号
です。
オペレーティング システムのメジャー バージョン番号。
たとえば、この値は Windows 95、98、ME、または NT4.x
の場合は 4、Windows 2000、XP、または .NET の場合は 5
になります。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
Environment プロパティ
OSMinorRevision
データ型
Integer
PBBuildNumber
PBFixesRevision
Integer
Integer
PBMajorRevision
PBMinorRevision
NumberOfColors
ScreenHeight
ScreenWidth
OSType
Integer
Integer
Long
Long
Long
PBType
Win16 (旧バージョンで
のみ使用可)
説明
オペレーティング システムのマイナー バージョン番号。
たとえば、この値は Windows NT 4.x と 2000 の場合は 0 に、
Windows XP の場合は 1 に、Windows .NET の場合は 2 に、
SunOS 5.5(Solaris5.5)の場合は 5 になります。
このバージョンの PowerBuilder のビルド番号です。
PowerBuilder のメンテナンス リリース番号です。
PowerBuilder のメジャー バージョン番号です。
PowerBuilder のマイナー バージョン番号です。
画面上の表示色の数です。
画面の高さ(ピクセル)です。
画面の幅(ピクセル)です。
OSTypes(カタ オペレーティング システムや環境の種類。オブジェクト
ログ データ型) ブラウザの[カタログ データ型]タブを参照してくださ
い。
PBTypes(カタ PowerBuilder 製品の種類(たとえば、Enterprise や Desktop
ログ データ型) など)。オブジェクト ブラウザの[カタログ データ型]タ
ブを参照してください。
Boolean
アプリケーションの実行ファイルが実行されているオペ
レーティング システムの種類を示します。値は以下のと
おりです。
TRUE - 16-bit 版の実行ファイルです。
FALSE - 32-bit 版の実行ファイルです。
関数
Environment 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
107
Error オブジェクト
Error オブジェクト
Error(エラー)オブジェクトは、実行時のエラーを記録するために使
用されます。スクリプトから Error オブジェクトにアクセスして、発生
し た エ ラ ー の 種 類 と 発 生 箇 所 を 知 る こ と が で き ま す(通 常 は
SystemError イベントに用います)。また、組み込みの Error オブジェク
トを継承したクラス ユーザ オブジェクトを定義することによって、
Error オブジェクトをカスタマイズしたユーザ オブジェクトを独自に
作成することもできます。
Error オブジェクトを基にユーザ オブジェクトを作成する方法は、
PowerBuilder の『ユーザーズ ガイド』マニュアルのユーザ オブジェク
トの章を参照してください。TRY-CATCH 文を使用して実行時エラー
とユーザ定義された例外を捕捉する方法については、
『アプリケーショ
ン テクニック』マニュアルと『PowerScript リファレンス』マニュアル
を参照してください。
プロパティ
Error プロパティ
ClassDefinition
データ型
PowerObject
Line
Number
Object
Integer
Integer
String
ObjectEvent
Text
WindowMenu
String
String
String
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
スクリプト内のエラーが発生した行番号を示します。
PowerBuilder エラーを示します。
エラーが発生したオブジェクトの名前が保持されます。
ウィンドウまたはメニューでエラーが発生した場合には、
Object プロパティの値は WindowMenu プロパティと同一
になります。
エラーが発生したイベント名を保持します。
エラー メッセージのテキストを保持します。
エラーが発生したウィンドウまたはメニューの名前を保
持します。
イベント
Error イベント
Constructor
Destructor
108
発生する状況
ユーザ オブジェクトが作成されるとき
ユーザ オブジェクトが破棄されるとき
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
Error 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
PostEvent
PowerObject
Boolean
TriggerEvent
Integer
TypeOf
Object
説明
ユーザ オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
ユーザ オブジェクトのメッセージ キューの最後にイベン
トを追加します。
ユーザ オブジェクトにイベントを送り、そのイベントに
関連付けられたスクリプトを実行します。
ユーザ オブジェクトのデータ型を返します。
ErrorLogging オブジェクト
ErrorLogging オブジェクトは、
EAServer の Jaguar サーバ ログや Microsoft
Transaction Server の NT システム アプリケーション ログなど、オブジェ
クトのコンテナで使用されるログ ファイルへのメッセージ書き込み
を可能にします。
プロパティ
ErrorLogging プロパティ データ型
ClassDefinition
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
イベント
ErrorLogging イベント
Constructor
Destructor
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
オブジェクトとコントロール
109
Exception オブジェクト
関数
ErrorLogging 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
Log
PowerObject
PostEvent
Boolean
TriggerEvent
Integer
TypeOf
Object
なし
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのコンテナによって保持されるログ ファイ
ルに文字列を書き込みます。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
Exception オブジェクト
Exception オブジェクトは、Throwable オブジェクトから継承したオブ
ジェクトで、ユーザ定義の例外または " 検査 " 例外の基本クラスとな
ります。関数またはユーザ定義のイベントでは、送出する検査例外を
すべて宣言しておく必要があります。また、検査例外を送出する関数
またはイベントの呼び出し側では、この検査例外を捕捉するか、検査
例外自体を送出する必要があります。
RuntimeError オブジェクトとは異なり、Exception オブジェクトには、
エラー発生場所の情報を示す組み込みのプロパティが存在しません。
CORBAUserException システム オブジェクトは、Exception から継承し
たオブジェクトです。このオブジェクトは、CORBA_USER_EXCEPTION
オブジェクトにマッピングされるもので、ユーザ定義の例外で処理さ
れなかった場合に CORBA アプリケーションから送出することができ
ます。CORBASystemException とその子孫オブジェクトとは異なり、
CORBAUserException オブジェクトは検査例外であり、そのほかの検査
例外と同様に、宣言し、捕捉する必要があります。
110
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
Exception プロパティ
ClassDefinition
データ型
PowerObject
Text
String
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
エラー メッセージのテキストを保持します。
イベント
Exception イベント
Constructor
Destructor
発生する状況
例外が送出される直前
例外が送出された直後
関数
Exception 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetMessage
String
GetParent
PostEvent
PowerObject
Boolean
SetMessage
ó
TriggerEvent
Integer
TypeOf
Object
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
Throwable 型オブジェクトからエラー メッセージを返し
ます。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
Throwable 型オブジェクト用のエラー メッセージを設定し
ます。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
111
Graph コントロール
Graph コントロール
Graph(グラフ)コントロールとは、データ ポイント(値)のデータ
系列を表したものです。グラフには 1 つまたは複数のデータ系列を与
えることができます。
プロパティ
Graph プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
BackColor
Border
BorderStyle
AccessibleRole
(カタログ デー
タ型)
Long
Boolean
BorderStyle
(カタログ デー
タ型)
BringToTop
Boolean
Category
CategorySort
ClassDefinition
grAxis
grSortType
PowerObject
Depth
Integer
112
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウまたは DataWindow コント
ロールの最前面に移動するかどうかを示します。
グラフの項目軸のプロパティを示します。
グラフ項目のソート方法を示します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
グラフの奥行きを幅に対する百分率で示します。
PowerBuilder
第2章
Graph プロパティ
DragAuto
DragIcon
Elevation
Enabled
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
String
Integer
Boolean
説明
グラフを自動的にドラッグ モードにするかどうかを指定
します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン(ICO ファイル)ファイル
の名前を指定します。デフォルトのアイコンは、コント
ロールの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
前後方向の仰角を示します。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
FocusRectangle
Boolean
コントロールがフォーカスを持っているときに、コント
ロールを破線の長方形(フォーカスを表す長方形)で囲む
かどうかを示します。値は以下のとおりです。
TRUE - コントロールがフォーカスを持っているとき
に、コントロールを破線の長方形で囲みます。
FALSE - コントロールがフォーカスを持っているとき
に、コントロールを破線の長方形で囲みません。
オブジェクトとコントロール
113
Graph コントロール
Graph プロパティ
GraphType
データ型
grGraphType
(カタログ デー
タ型)
説明
グラフの種類を示します。値は以下のとおりです。
Area3D!
AreaGraph!
Bar3DGraph!
Bar3DObjGraph!
BarGraph!
BarStack3DObjGraph!
BarStackGraph!
Col3DGraph!
Col3DObjGraph!
ColGraph!
ColStack3DObjGraph!
ColStackGraph!
Line3D!
LineGraph!
Pie3D!
PieGraph!
ScatterGraph!
Height
Legend
Integer
grLegendType
(カタログ デー
タ型)
コントロールの高さを PowerBuilder 単位系で示します。
グラフの凡例に使用するテキストの位置揃えを示します。
値は以下のとおりです。
AtBottom!
AtLeft!
AtRight!
AtTop!
NoLegend!
LegendDispAttr
grDispAttr
OverlapPercent
Integer
Perspective
Integer
PieDispAttr
grDispAttr
Pointer
String
Rotation
Series
SeriesSort
ShadeColor
Integer
grAxis
grSortType
Long
114
グラフの凡例に使用するテキストの字体スタイルを示し
ます。字体スタイルとしては、テキスト スタイル、サイ
ズ、色、回転などが設定できます。
異なる系列を表すデータ マーカーの重なり具合をマー
カー幅の百分率で示します。
グラフの遠近感の指定。ウィンドウの前面からグラフまで
の距離で示します。
円グラフ ラベルに使用するテキストの字体スタイルを示
します。字体スタイルとしては、テキスト スタイル、サ
イズ、色、回転などが設定できます。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
グラフを左から右に回転する量を示します。
グラフ内の系列を示します。
データ系列のソート方法を示します。
グラフの影に使用する色を示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
Graph プロパティ
Spacing
データ型
Integer
TabOrder
Integer
Tag
String
TextColor
Title
TitleDispAttr
Long
String
grDispAttr
Values
Visible
grAxis
Boolean
説明
データ マーカー間の距離をマーカー幅の百分率で示しま
す。
ウィンドウ内のコントロールのタブ値(順序)を示します
(0 を指定すると、そのコントロールにタブ移動できませ
ん)。
コントロールのタグ値を示します。
コントロールのテキストに使用する色を示します。
グラフのタイトル テキストを示します。
グラフのタイトルに使用するテキストの字体スタイルを
示します。字体スタイルとしては、テキスト スタイル、サ
イズ、色、回転などが設定できます。
グラフの数値軸の値を示します。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
Integer
X
Integer
Y
Integer
コントロール内のテキストの文字の太さを示します。たと
えば、400 は通常の文字、700 は太字です。
X 位置(親ウィンドウの左端からの距離)を PowerBuilder
単位系で示します。
Y 位置(親ウィンドウの上部からの距離)を PowerBuilder
単位系で指定します。
イベント
Graph イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
発生する状況
コントロールがクリックされたとき(選択または選択解除されたとき)
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択または選択解除されたとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
オブジェクトとコントロール
115
Graph コントロール
Graph イベント
LoseFocus
Other
RButtonDown
発生する状況
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
関数
Graph 関数
AddCategory
AddData
AddSeries
CategoryCount
CategoryName
ClassName
Clipboard
戻り値のデータ型
Integer
Long
Integer
Integer
String
String
Integer
DataCount
Long
DeleteCategory
DeleteData
Integer
Integer
DeleteSeries
Drag
Integer
Integer
FindCategory
FindSeries
GetContextService
Integer
Integer
Integer
GetData
Double
GetDataPieExplode
Integer
GetDataStyle
Integer
説明
グラフに項目を追加します。
グラフの指定された系列の最後に値を追加します。
グラフに系列を追加し、それに系列番号を与えます。
グラフの項目数を返します。
グラフの指定された項目番号の項目名を取得します。
コントロールに与えられている名前を返します。
グラフをビットマップ(BMP)形式でクリップボードにコ
ピーします。
グラフの指定された系列のデータ ポイント数を取得しま
す。
グラフ系列から指定された項目とデータ値を削除します。
指定されたグラフの系列とデータ ポイントのデータ値を
削除します。
指定した系列とそのデータ値をグラフから削除します。
コントロールのドラッグを開始または終了します。
グラフの指定された項目ラベルの項目番号を取得します。
グラフの指定された系列ラベルの系列番号を取得します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
グラフの指定された系列番号とデータ ポイント番号の
データ値を取得します。GetDataValue 関数の項も参照して
ください。
円グラフから切り離された一片が突出する割合を返しま
す。
グラフの指定された系列番号とデータ ポイント番号の表
示設定を取得します。データ系列内の各データ ポイント
には、表示形態を個別に設定できます。
調べたい表示設定(色、線種、塗りつぶしパターン、記
号)によって、使用する構文が異なります。
116
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
Graph 関数
GetDataValue
戻り値のデータ型
Integer
GetParent
GetSeriesStyle
PowerObject
Integer
Hide
ImportClipboard
Integer
Long
ImportFile
Long
ImportString
Long
InsertCategory
Integer
InsertData
Long
InsertSeries
Integer
ModifyData
Integer
Move
ObjectAtPointer
Integer
GrObject
Type
PointerX
PointerY
PostEvent
Integer
Integer
Boolean
Print
Reset
ResetDataColors
Integer
Integer
Integer
Resize
Integer
SaveAs
Integer
オブジェクトとコントロール
説明
グラフの指定された系列番号とデータ ポイント番号の
データ値を取得します。
親オブジェクト名への参照を返します。
グラフのデータ系列の表示形態を調べます。系列に対する
設定値より個別のデータ ポイントに対する設定値の方が
優先されるので、この関数で取得した情報が現行の表示設
定を反映しているとは限りません。
取得したい情報が、色、線種、塗りつぶしパターン、記
号、オーバーレイかによって使用する構文が異なります。
コントロールを非表示にします。
クリップボードの内容(の指定された範囲)をグラフにコ
ピーします。
指定ファイルの内容(の指定した範囲)をグラフにコピー
します。
指定された文字列の内容(の指定された範囲)をグラフに
コピーします。
新しい項目をグラフ内の指定された項目の前に挿入しま
す。
新しいデータ ポイントをグラフ内の指定されたデータ ポ
イントの前に挿入し、既存のデータ ポイントを右に移動
します。
新しい系列をグラフ内の指定された系列の前に挿入しま
す。
グラフの指定された系列とデータ ポイントの値を、指定
された値に変更します。
指定された位置にコントロールを移動します。
グラフ上でポインタが位置している系列番号とデータ ポ
イント番号を取得し、グラフ上のオブジェクトのデータ型
を返します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
グラフのデータを指定に応じて削除します。
グラフの指定された系列番号とデータ ポイント番号の
データ ポイントの色をリセットします。
コントロールのサイズを変更します。
指定されたグラフの内容を指定された形式でファイルに
保存します。
117
grAxis オブジェクト
Graph 関数
SeriesCount
SeriesName
SetDataPieExplode
SetDataStyle
戻り値のデータ型
Integer
String
Integer
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
SetSeriesStyle
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
説明
グラフ上の系列の数を返します。
グラフの指定された系列番号の系列名を取得します。
円グラフから一片を切り離します。
グラフのデータ ポイントの外観を指定します。
設定内容(色、線種と線幅、塗りつぶしパターン、記号)
によって使用する構文が異なります。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティが変更されるごとに、自動再描
画するかどうかを設定します。
グラフのデータ系列の外観を指定します。
設定内容が、色、線種と線幅、塗りつぶしパターン、記
号、オーバーレイかによって使用する構文が異なります。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
grAxis オブジェクト
grAxis オブジェクトは、Graph コントロールの一部として使用される
PowerBuilder のクラス オブジェクトです。グラフには、Category(項
目軸)、Series(系列軸)、Values(数値軸)の 3 種類の grAxis オブジェ
クトがあります。
軸のプロパティを参照するには、以下の構文を使用します。
graphcontrolname.axisname.property
使用例 :gr_1.Series.AutoScale
grAxis オブジェクトにはイベントがありません。
118
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
grAxis プロパティ
AutoScale
データ型
Boolean
説明
軸の目盛りを PowerBuilder によって自動的に作成する
かどうかを示します。値は以下のとおりです。
TRUE - 目盛りを自動的に作成します。
FALSE - 目盛りを自動的に作成しません。
ClassDefinition
PowerObject
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
軸のデータ型を示します。値は以下のとおりです。
AdtDate!
AdtDateTime!
AdtDefault!
AdtDouble!
AdtText!
AdtTime!
DataType
grAxisDataType
(カタログ デー
タ型)
DispAttr
grDispAttr
軸ラベルの表示プロパティを示します。
(オブジェクト)
Integer
軸ラベルを表示する間隔を示します。たとえば、2 を指
定すると 2 目盛りごとにラベルを表示します。0 を指定
すると、そのグラフに最適なラベル数が選択されます。
表示するラベルが長すぎるときは切り捨てられます。
LineStyle(カタ データ ポイントから軸に垂直に降ろしたドロップライ
ログ データ型) ンの種類を示します。値は以下のとおりです。
DisplayEveryNLabels
DropLines
Transparent! - 線なし
Continuous! - 実線
Dash!
Dot!
DashDot!
DashDotDot!
Frame
Label
LabelDispAttr
MajorDivisions
MajorGridLine
LineStyle(カタ 3D グラフにおけるフレーム枠に使用する線の種類を示
ログ データ型) します。線の種類については、この表の DropLines プロ
パティを参照してください。
String
軸のラベルを示します。
grDispAttr
軸ラベル テキストの表示プロパティを示します。
(オブジェクト)
Integer
軸上の大区分の数を示します。
LineStyle(カタ 大区分目盛の線種を示します。
ログ データ型) 線の種類については、この表の DropLines プロパティを
参照してください。
オブジェクトとコントロール
119
grAxis オブジェクト
grAxis プロパティ
MajorTic
データ型
grTicType
(カタログ デー
タ型)
MaximumValue
軸のデータ型が数値型のときに、軸上に表示する最大値
を示します。
DateTime
軸のデータ型が Date 型か Time 型のときに、軸上に表示
する最大値を示します。
Double
軸のデータ型が数値型のときに、軸上に表示する最小値
を示します。
Integer
軸上の小区分の数を示します。
LineStyle(カタ 副グリッドの線種を示します。線の種類については、こ
ログ データ型) の表の DropLines プロパティを参照してください。
grTicType
軸に副目盛りを付ける位置をカタログ データ型で示し
(カタログ デー ます。値は以下のとおりです。
タ型)
NoTic!
Inside!
Outside!
Straddle!
DateTime
軸のデータ型が Date 型か Time 型のときに、軸上に表示
する最小値を示します。
LineStyle(カタ 原軸の線種を示します。線の種類については、この表の
ログ データ型) DropLines プロパティを参照してください。
LineStyle(カタ 主軸の線種を示します。線の種類については、この表の
ログ データ型) DropLines プロパティを参照してください。
Double
軸の数値を丸めて表示するためのパラメータです。目盛
り間隔を示します。
grRoundToType 目盛り間隔の数値の単位を示します。この値は軸のデー
(カタログ デー タ型と一致しなければなりません。値は以下のとおりで
タ型)
す。
MaxValDateTime
MinimumValue
MinorDivisions
MinorGridLine
MinorTic
MinValDateTime
OriginLine
PrimaryLine
RoundTo
RoundToUnit
説明
軸に主目盛りを付ける位置をカタログ データ型で示し
ます。値は以下のとおりです。
NoTic!
Inside!
Outside!
Straddle!
Double
すべての型の軸(デフォルト):
RndDefault!
数値型の軸 :
RndNumber!
120
PowerBuilder
第2章
grAxis プロパティ
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
説明
Date 型と DateTime 型の軸 :
RndYears!
RndMonths!
RndDays!
Time 型と DateTime 型の軸 :
RndHours!
RndMinutes!
RndSeconds!
RndMicroseconds!
ScaleType
grScaleType(カ
タログ データ
型)
ScaleValue
grScaleValue
(カタログ デー
タ型)
SecondaryLine
ShadeBackEdge
軸に使用する座標系が線形か、常用対数か、自然対数か
を示します。値は以下のとおりです。
Linear!
Log10!
Loge!
軸上の目盛りで表示される値が、実数か、累積値か、パー
セント値か、あるいは累積パーセント値かを示します。
値は以下のとおりです。
Actual!
Cumulative!
Percentage!
CumPercent!
LineStyle(カタ 主軸に対して平行な副軸の線種を示します。線の種類に
ログ データ型) ついては、この表の DropLines プロパティを参照してく
ださい。
Boolean
軸の後部エッジ面に影を付けるかどうかを示します。値
は以下のとおりです。
TRUE - 影を付けます。
FALSE - 影を付けません。
関数
grAxis 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
121
grDispAttr オブジェクト
grDispAttr オブジェクト
grDispAttr オブジェクトは、Graph コントロール上の Text オブジェクト
に表示形態を設定するのに使用します。Graph コントロールの Text オ
ブジェクトには、TitleDispAttr(タイトル テキスト)、LegendDispAttr
(凡例テキスト)、PieDispAttr(円グラフ ラベル テキスト)の 3 種類の
grDispAttr オブジェクトがあり、グラフ軸オブジェクト(Category、
Series、Values)には、DispAttr(目盛りラベル テキスト)と LabelDispAttr
(軸ラベル テキスト)の 2 種類のテキスト オブジェクトがあります。
grDispAttr オブジェクトのプロパティを参照するには、以下の構文を使
用します。
graphcontrolname.axisname.grdispattrname.property
使用例 :
gr_1.Series.DispAttr.Italic
gr_1.Category.LabelDispAttr.DisplayExpression
grDispAttr オブジェクトにはイベントがありません。
プロパティ
grDispAttr プロパティ
Alignment
AutoSize
データ型
Alignment
(カタログ デー
タ型)
Boolean
説明
テキストの水平方向の位置の揃え方を示します。値は以下
のとおりです。
Center!
Justify!
Left!
Right!
表示されているテキストの長さに応じて、テキストのサイ
ズを自動的に調整するかどうかを示します。値は以下のと
おりです。
TRUE - 自動的に調整します。
FALSE - 自動的に調整しません。
BackColor
Long
ClassDefinition
PowerObject
122
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
grDispAttr プロパティ
DisplayExpression
データ型
String
Escapement
Integer
FaceName
String
FillPattern
FillPattern
(カタログ デー
タ型)
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Format
Italic
説明
値がグラフ コンポーネントのラベルとなる文字列式。デ
フォルトは、そのグラフ コンポーネントのテキストです。
この式は、Text プロパティを含み、ほかの変数テキストを
追加することができます。
テキストを回転して表示するときに、基準線に対する回転
角度を 0.1 度単位で示します。0 は水平です。900 は 90 度、
2700 は 270 度テキストを回転することを意味しています。
テキストを表示する字体名を示します。たとえば、ARIAL
や COURIER です。
テキストを塗りつぶすパターンを示します。値は以下のと
おりです。
BDiagonal!
Diamond!
FDiagonal!
Horizontal!
Solid!
Square!
Vertical!
FDiagonal! は左上から右下への斜線です。BDiagonal! は左
下から右上への斜線です。
使用されるフォント文字セットを示します。指定可能な値
の一覧については、オブジェクト ブラウザの[カタログ
データ型]タブにある FrontCharSet 変数リストを参照して
ください。
テキストに使用されるフォント ファミリフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ テキストに使用されるフォントのピッチ(間隔)を示しま
ログ データ型) す。値は以下のとおりです。
Default!
Fixed!
Variable!
String
テキストの表示様式を示します。
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
オブジェクトとコントロール
123
GroupBox コントロール
grDispAttr プロパティ
TextColor
データ型
Long
TextSize
Integer
Underline
Boolean
説明
テキストの色を示します。この色は、-2 から 16,777,215 の
範囲の数値です。色についての詳細は、
『PowerScript リ
ファレンス』マニュアルの RGB 関数を参照してください。
テキスト サイズをポイント数で示します。以前のバー
ジョンとの互換性を保つため、サイズは負の値で扱われま
す。たとえば 10 ポイントのテキスト サイズは -10 として
保存されます。
テキストに下線を引くかどうかを示します。値は以下のと
おりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Integer
テキストの文字の太さを示します。たとえば、400 は通常
の文字、700 は太字です。
grDispAttr 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
説明
ユーザ オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
ユーザ オブジェクトのデータ型を返します。
Weight
関数
GroupBox コントロール
GroupBox(グループボックス)コントロールは、関連する複数のコン
トロールをグループ化したい場合に使用するボックス状のコントロー
ル で す。た と え ば、GroupBox を 使 っ て、互 い に 関 連 す る 一 連 の
RadioButton や CommandButton をそれぞれ一組のグループにすることが
できます。エンド ユーザは GroupBox 自体を選択することはできません
が、GroupBox 内のコントロールを選択することができます。GroupBox
内に複数の RadioButton がある場合、GroupBox 内で一度に選択できる
RadioButton は 1 つだけです。
GroupBox の 表 示、非 表 示 を 切 り 替 え て も、PowerBuilder は、そ の
GroupBox 内のコントロールの表示 / 非表示を自動的に切り替えるわけ
ではありません。
124
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
GroupBox プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
BackColor
BorderStyle
AccessibleRole
(カタログ デー
タ型)
Long
BorderStyle
(カタログ デー
タ型)
BringToTop
Boolean
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
ユーザ インタフェース要素となるコントロールの種類に
関する説明を指定します。
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleLowered!
StyleRaised!
コントロールをウィンドウの最前面に移動するかどうか
を示します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
GroupBox のテキストが使用可能かどうかを示します。値
は以下のとおりです。
TRUE - テキストを使用できます。
FALSE - テキストを使用できません。
オブジェクトとコントロール
125
GroupBox コントロール
GroupBox プロパティ
FaceName
データ型
String
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Height
Italic
説明
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Pointer
String
RightToLeft
Boolean
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
TabOrder
Integer
Tag
Text
TextColor
String
String
Long
126
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールのタイトルに表示されるテキストを示します。
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。色についての詳細は、
『PowerScript リファ
レンス』マニュアルの RGB 関数を参照してください。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
GroupBox プロパティ
TextSize
データ型
Integer
Underline
Boolean
説明
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
GroupBox イベント
Constructor
Destructor
Help
Other
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
関数
GroupBox 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
オブジェクトとコントロール
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
127
HProgressBar コントロール
GroupBox 関数
GetParent
Hide
Move
PointerX
PointerY
PostEvent
戻り値のデータ型
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
SetFocus
SetPosition
Integer
Integer
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
説明
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスをセットします。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントに関連付けられたスクリプトを実行します。
コントロールのデータ型を返します。
HProgressBar コントロール
プログレスバーを使用すると、多数のファイルをコピーするインス
トール プログラムなど、時間のかかる操作の進行状況を示すことがで
きます。HProgressBar(水平プログレスバー)コントロールは水平方向
に延びる長方形で、操作の進行状況に応じてシステムのハイライト色
で徐々に塗りつぶされます。
プロパティ
HProgressBar
プロパティ
AccessibleDescription
128
データ型
String
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
PowerBuilder
第2章
HProgressBar
プロパティ
AccessibleName
AccessibleRole
BringToTop
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
String
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
String
Height
MaxPosition
Integer
Unsigned Integer
MinPosition
Unsigned Integer
Pointer
String
オブジェクトとコントロール
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールの高さを PowerBuilder 単位系で示します。
プログレスバーがコントロールの右端にあるときの Position
プロパティの値を示します。この値は、SetRange 関数で
設定するコントロールの範囲の上限と異なる値でもかま
いません。
プログレスバーがコントロールの左端にあるときの Position
プロパティの値を示します。この値は、SetRange 関数で
設定するコントロールの範囲の下限と異なる値でもかま
いません。
コントロールで使用するポインタを、組み込みポインタ名
か、ポインタを含むファイル名で示します。
129
HProgressBar コントロール
HProgressBar
プロパティ
Position
データ型
Integer
SetStep
Integer
SmoothScroll
Boolean
TabOrder
Integer
Tag
Visible
String
Boolean
説明
コントロールの範囲(SetRange 関数で設定)内にある現
在の位置の値を示します。コントロールは、範囲と現在の
位置から、プログレスバーをハイライト色で塗りつぶす割
合を決定します。
プログレスバーの増分値を示します。特に指定しない限り、
10 が設定されます。
進行状況が、デフォルトのセグメント化されたバーではな
く、滑らかなスクロールバーとして表示されることを示し
ます。
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で指定します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
HProgressBar イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
130
発生する状況
コントロール上でマウスの左ボタンがクリックされたとき
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上でマウスの左ボタンがダブルクリックされたとき
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
PowerBuilder
第2章
HProgressBar イベント
Help
LoseFocus
Other
RightClicked
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
発生する状況
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
関数
HProgressBar 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
OffsetPos
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Integer
Boolean
Print
Integer
Resize
SetFocus
SetPosition
Integer
Integer
Integer
SetRange
Integer
SetRedraw
Integer
Show
StepIt
Integer
Integer
TriggerEvent
Integer
TypeOf
Object
オブジェクトとコントロール
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの現在の位置を指定された量だけ移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールの範囲を設定します。コントロールは、範囲
と現在の位置から、プログレスバーをハイライト色で塗り
つぶす割合を決定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
コントロールの現在の位置を SetStep プロパティの値で指
定した量だけ移動します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
131
HScrollBar コントロール
HScrollBar コントロール
HScrollBar(水平スクロールバー)コントロールは横形の棒状のコント
ロールです。HScrollBar の両端には矢印があり、その間に位置するス
クロール ボックス(つまみ)によって、相対的な分量や変化の過程
(たとえば、作業がどのくらいまで進行しているか)などを示すことが
できます。
使用上の注意
HScrollBar コントロールは、コントロール内の情報をスクロールする
ための水平スクロールバー プロパティとは異なります。
プロパティ
HScrollBar プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
BringToTop
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
132
PowerBuilder
第2章
HScrollBar プロパティ
DragIcon
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
String
Height
MaxPosition
Integer
Integer
MinPosition
Integer
Pointer
String
Position
Integer
StdHeight
Boolean
説明
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールの高さを PowerBuilder 単位系で示します。
スクロール ボックスがコントロールの右端にあるときの
Position プロパティの値を示します。
スクロール ボックスがコントロールの左端にあるときの
Position プロパティの値を示します。
コントロールで使用するポインタを、組み込みポインタ名
か、ポインタを含むファイル名で示します。
MinPosition プロパティと MaxPosition プロパティの間の値
を指定して、スクロール ボックスの位置を決定します。
コントロールを標準スクロールバーの高さで表示するか
どうかを示します。値は以下のとおりです。
TRUE - コントロールに標準の高さを使用します。
FALSE - コントロールに標準の高さを使用しません。
TabOrder
Integer
Tag
Visible
String
Boolean
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で指定します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
HScrollBar イベント
Constructor
発生する状況
ウィンドウの Open イベントが発生する直前
オブジェクトとコントロール
133
HScrollBar コントロール
HScrollBar イベント
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LineLeft
LineRight
LoseFocus
Moved
Other
PageLeft
PageRight
RButtonDown
発生する状況
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールの左向き矢印がクリックされたとき
コントロールの右向き矢印がクリックされたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
スクロール ボックスが移動されるとき(Position プロパティによって新しい
場所が決定されるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
スクロール ボックスの左側のシャフト部分がクリックされたとき
スクロール ボックスの右側のシャフト部分がクリックされたとき
コントロールをマウスの右ボタンでクリックしたとき
関数
HScrollBar 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
SetFocus
Integer
Integer
Integer
134
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスを設定します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
HScrollBar 関数
SetPosition
戻り値のデータ型
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
説明
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
HTrackBar コントロール
トラックバーは、スクロールバーと同じようにスクロールするコント
ロールとして使用しますが、トラックバーのスライダをクリックする
と、連続的に移動せずに不連続な増分値で移動します。HTrackBar(水
平トラックバー)コントロールでは、トラックバー チャネルの下側に
一連の目盛りが表示されます。
このコントロールをキーボードから正しく使用できるようにするに
は、LineLeft、LineRight、PageLeft、PageRight の各イベントにコードを
追加する必要があります。追加するコードによって、スライダの
Position プロパティが適切な値だけ変更され、TrackBar コントロールに
関連付ける 1 つまたは複数のオブジェクトに新しいスライダ位置が渡
されます。スライダがマウスでドラッグされた後、TrackBar コントロー
ルがスライダ位置に移るようにする場合は、Moved イベントのコード
を追加する必要があります。
使用上の注意
TrackBar は、ユーザが不連続な値を選択できるようにするときに使用
します。たとえば、タイマーの間隔やウィンドウのサイズをユーザが
選択できるようにする場合に TrackBar を使用します。
オブジェクトとコントロール
135
HTrackBar コントロール
プロパティ
HTrackBar プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
BringToTop
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
String
Height
LineSize
Integer
Integer
MaxPosition
Integer
MinPosition
Integer
136
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールの高さを PowerBuilder 単位系で示します。
矢印キーによるキーボード入力に応答してスライダが移
動する距離を指定します。LineSize を 1 に設定すると、ス
ライダは、MaxPosition プロパティと MinPosition プロパ
ティに指定された値の範囲内で、1 増分値だけ移動しま
す。
スライダがコントロールの右端にあるときの Position プ
ロパティの値を示します。
スライダがコントロールの左端にあるときの Position プ
ロパティの値を示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
HTrackBar プロパティ
PageSize
データ型
Integer
Pointer
String
Position
Integer
Slider
SliderSize
Boolean
Integer
TabOrder
Integer
Tag
TickFrequency
String
Integer
TickMarks
Visible
HTickMarks
(カタログ デー
タ型)
Boolean
説明
スライダ チャネル領域のクリック、または〔Page Up〕か
〔Page Down〕によるキーボード入力に応答してスライダ
が 移 動 す る 距 離 を 示 し ま す。デ フ ォ ル ト の 距 離 は、
MaxPosition プロパティの値と MinPosition プロパティの値
の差を 5 で割った値です。
コントロールで使用するポインタを、組み込みポインタ名
か、ポインタを含むファイル名で示します。
MinPosition プロパティと MaxPosition プロパティの間の値
を指定して、スライダの位置を決定します。
TrackBar にスライダを含めるかどうかを指定します。
TrackBar のスライダのサイズを示します。
0 に設定すると、
スライダのサイズはデフォルトのサイズになります。
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
目盛りの度数を示します。TickFrequency を 1 に設定する
と、トラックバーの値の範囲内の 1 増分値に対して 1 目盛
りが割り当てられます。
目盛りが表示される位置を示します。値は以下のとおりで
す。
HTicksOnTop!
HTicksOnBottom!
HTicksOnBoth!
HTicksOnNeither!
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で指定します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
HTrackBar イベント
Constructor
発生する状況
ウィンドウの Open イベントが発生する直前
オブジェクトとコントロール
137
HTrackBar コントロール
HTrackBar イベント
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LineLeft
LineRight
LoseFocus
Moved
Other
PageLeft
PageRight
RButtonDown
発生する状況
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
左矢印キーがクリックされたとき
右矢印キーがクリックされたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
スライダが移動したとき(Position プロパティによって新しい場所が決定さ
れるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
〔Page Up〕が押されたとき。または TrackBar チャネルでスライダの左側が
クリックされたとき
〔Page Down〕が押されたとき。または TrackBar チャネルでスライダの右側
がクリックされたとき
コントロールをマウスの右ボタンでクリックしたとき
関数
HTrackBar 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
Integer
Integer
138
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
HTrackBar 関数
SelectionRange
戻り値のデータ型
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
説明
TrackBar の選択範囲を設定します。範囲を選択すると、
TrackBar のチャネルに青い線が表示され、目盛りの場所に
選択範囲の下限と上限を示す 2 つの矢印が表示されます。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
Inet オブジェクト
Inet オブジェクトは、デフォルトのブラウザで Web ページを表示し、
指定されたページの HTML 書式へアクセスし、CGI、ISAPI、NSAPI プ
ログラムにデータを送ることを可能にします。
プロパティ
Inet プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
イベント
Inet イベント
Constructor
Destructor
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
オブジェクトとコントロール
139
InkEdit コントロール
関数
Inet 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
GetURL
HyperLinkToURL
PowerObject
Integer
Integer
PostEvent
Boolean
PostURL
Integer
TriggerEvent
Integer
TypeOf
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
指定された URL の HTML を返します。
デフォルトの Web ブラウザを開き、指定された URL を表
示します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
HTTP Post 機能を実行します。これにより、PowerBuilder
アプリケーションは CGI、NSAPI または ISAPI を経由して
リクエストを送信できます。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
InkEdit コントロール
インクエディット(InkEdit)コントロールは、タブレット PC でのペ
ン入力(インク)を収集し、それをテキストに変換します。このコン
トロールは、タブレット PC プラットフォームの 1 つである手書き文
字認識エンジン(“ レコグナイザ ”)で使用されます。
プロパティ
InkEdit プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
140
AccessibleRole
(カタログ データ
型)
説明
コントロールを視覚障害者用の画面読み上げなどのアクセ
シビリティ ツールで使用する場合に、コントロールやその
目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素であ
るかを説明します。
PowerBuilder
第2章
InkEdit プロパティ
Alignment
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Alignment
(カタログ データ
型)
BackColor
Long
Border
Boolean
説明
コントロール内にあるテキストの水平方向の位置の揃え方
を示します。値は以下のとおりです。
Center!
Justify!
Left!
Right!
背景色を -2 から 16,777,215 の範囲の数値で示します。色に
ついての詳細は、
『PowerScript リファレンス』マニュアルの
RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BorderStyle
(カタログ データ
型)
BringToTop
Boolean
ClassDefinition
PowerObject
DisplayOnly
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうかを
示します。
オブジェクトまたはコントロールのクラス定義に関する情
報を含む PowerObject 型のオブジェクトです。
コントロールのテキストを表示専用にし、ユーザが変更で
きないようにするかどうかを示します。値は以下のとおり
です。
TRUE - ユーザはテキストを変更できません。
FALSE - ユーザはテキストを変更できます。
DragAuto
Boolean
コントロールを自動的にドラッグ モードにするかどうかを
示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的にはド
ラッグ モードになりません。この場合、Drag 関数を使用
して、コントロールを手動でドラッグ モードにする必要
があります。
オブジェクトとコントロール
141
InkEdit コントロール
InkEdit プロパティ
DragIcon
Enabled
データ型
String
Boolean
説明
コントロールをドラッグしているときに表示する組み込み
アイコン名、またはアイコン ファイル(ICO ファイル)の
名前を示します。デフォルトのアイコンは、コントロール
の大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示します。
値は以下のとおりです。
TRUE - コントロールが使用できます。
FALSE - コントロールが使用できません。
FaceName
String
Factoid
String
コントロール内のテキストを表示する字体名を示します。
たとえば Arial や Courier です。
インク認識用のコンテキストを示します。入力データが日
付や Web アドレスなどの既知の種類である場合にこのプロ
パティを設定して、認識結果に対して検索を制限します。
コントロール内のテキストに使用されるフォント文字セッ
トを示します。アプリケーションの実行には、選択された
文字セットをサポートしているオペレーティング システム
上で、適切なバージョンの PowerBuilder を使わなければな
りません。有効な値の一覧については、オブジェクト ブラ
ウザの[カタログデータ型]タブ ページの FontCharSet カタ
ログ データ型のプロパティの一覧を参照してください。
FontCharSet
FontCharSet
(カタログ データ
型)
FontFamily
FontFamily
コントロール内のテキストに使用されるフォント ファミリ
(カタログ データ (タイプ スタイル)を示します。値は以下のとおりです。
型)
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch
コントロール内のテキストに使用されるフォントのピッチ
(カタログ データ (間隔)を示します。値は以下のとおりです。
型)
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
水平スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
FontPitch
Height
HScrollBar
TRUE - 水平スクロールバーを表示します。
FALSE - 水平スクロールバーを表示しません。
142
PowerBuilder
第2章
InkEdit プロパティ
IgnorePressure
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
タブレットの表面でペン チップの圧力が加わると描画イン
クの幅が広くなるかを示す描画属性です。値は以下のとお
りです。
TRUE – ペン チップからの圧力は無視されます。
FALSE – ペン チップの圧力でインクの幅が広がります
InkAntiAliased
Boolean
InkColor
Long
InkHeight
Integer
InkMode
InkMode
(カタログ データ
型)
InkTransparency
Integer
InkWidth
Integer
InsertAsText
Boolean
(デフォルト)。
描画インクの輪郭で前景色と背景色を融合し(アンチエイ
リアスし)、ストロークを滑らかで鮮明にするかどうかを示
す描画属性です。値は以下のとおりです。
TRUE – インク ストロークは滑らかで鮮明になります
(デフォルト)。
FALSE – インク ストロークはアンチエイリアスされませ
ん。
現行のインクの色を示す描画属性です。デフォルトの色は
黒です。
長方形のペン チップの高さをピクセルで示す描画属性で
す。デフォルトは 1 ピクセルです。
インク収集を無効にするか、インクだけを収集するか、あ
るいはインクとジェスチャを収集するかを示します。値は
以下のとおりです。
CollectInk! – インクだけが収集されます。
CollectInkAndGestures! – インクとジェスチャが収集され
ます(デフォルト)。
InkDisabled! – インクが無効です(コントロールはマルチ
ライン エディット コントロールのように動作します)。
描画インクの透明度を示す描画属性です。値の範囲は、完
全に不透明な 0(デフォルト)から完全に透明な 255 までで
す。
ペンの幅をピクセルで示す描画属性です。デフォルトは 53
ピクセルです。IgnorePressure プロパティが設定されていな
い場合、実際の幅は最小圧力の Width プロパティの値の 0.5
倍と最大圧力のその値の 1.5 倍の間で変化します。
インクをテキストとして挿入するか、インクとして挿入す
るかを示します。値は以下のとおりです。
TRUE – インクをテキストとして挿入します(デフォル
ト)。
FALSE – インクをインクとして挿入します。
Italic
Boolean
コントロール内のテキストを斜体にするかどうかを示しま
す。値は以下のとおりです。
TRUE – テキストを斜体にします。
FALSE – テキストを斜体にしません(デフォルト)
。
オブジェクトとコントロール
143
InkEdit コントロール
InkEdit プロパティ
Limit
データ型
Integer
Modified
Boolean
説明
コントロールに入力可能な最大文字数(0 ~ 32,767)を示し
ます(0 は無制限を意味します)。
開かれた後にあるいは最後に保存された後に、コントロー
ル内のテキストが修正されたかどうかを示します。Modified
はコントロールの「ダーティ」フラグで、コントロールが
未保存の状態であることを示します。値は以下のとおりで
す。
TRUE – コントロールは修正されました。
FALSE – コントロールは修正されていません。
PenTip
最初の変更を新たに開かれたか、保存されたコントロール
にするときには、PowerBuilder は Modified プロパティを true
に設定し、Modified イベントをトリガします。
InkPenTip
ペン チップを円にするか、または長方形にするかを示す描
(カタログ データ 画属性です。値は以下のとおりです。
型)
PenTipBall! – ペン チップは円になります(デフォルト)。
Pointer
String
RecognitionTimer
Long
RightToLeft
Boolean
PenTipRectangle! – ペン チップは長方形になります。
ストック ポインタの名前またはコントロールに対して使用
するポインタを含むファイル名を指定します。
最後のインク ストロークとテキスト認識の開始の間隔をミ
リ秒で示します。デフォルトは 2000(2 秒)です。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値は
以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
Status
InkEditStatus
(カタログ データ
型)
TabOrder
Integer
Tag
Text
TextColor
String
String
Long
144
ユーザが Stroke イベントを監視する必要がないように、コ
ントロールの現行のステータスを提供する実行時に有効な
読 み 出 し 専 用 の プ ロ パ テ ィ で す。値 は、CollectingInk!、
RecognizingInk!、および Idle! です。
ウィンドウ内のコントロールのタブ値(順序)を示します
(0 を指定すると、ユーザはコントロールにタブ移動できま
せん)。
コントロールに割り当てるタグの値を示します。
コントロールに表示するテキストを示します。
テキストに使用される色を -2 から 16,777,215 の範囲の数値
で示します。
PowerBuilder
第2章
InkEdit プロパティ
TextSize
Underline
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Integer
Boolean
説明
コントロール中のテキスト サイズをポイント数で示しま
す。
以前のバージョンとの互換性を保つため、サイズは負の値
で扱われます。たとえば 10 ポイントのテキスト サイズは 10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示しま
す。値は以下のとおりです。
TRUE - テキストに下線を引きます。
FALSE - テキストに下線を引きません(デフォルト)
。
UseMouseForInput
Boolean
タブレット PC で入力にマウスを使用できるかどうかを示
します。値は以下のとおりです。
TRUE – 入力にマウスを使用できます。
FALSE – 入力にマウスを使用できません(デフォルト)
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます(デフォルト)
。
FALSE - コントロールを表示できません。
VScrollBar
Boolean
垂直スクロールバーをコントロールの右端に表示するかど
うかを示します。値は以下のとおりです。
TRUE - 垂直スクロールバーを表示します。
FALSE - 垂直スクロールバーを表示しません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で示します。
イベント
InkEdit イベント
Constructor
Destructor
DragDrop
DragEnter
発生する状況
ウィンドウの Open イベントが発生する直前に、そのオブジェクトが作成さ
れるとき
ウィンドウの Close イベントが発生した直後に、そのオブジェクトが破棄さ
れるとき
コントロール上にドラッグ中のコントロールがドロップされるとき
ドラッグ中のコントロールがコントロール上に入るとき
オブジェクトとコントロール
145
InkEdit コントロール
InkEdit イベント
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Modified
Other
RButtonDown
RecognitionResult
Stroke
発生する状況
ドラッグ中のコントロールがコントロールから離れるとき
ドラッグ中のコントロールがコントロール内にあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
コントロールが変更されてからフォーカスを失うとき
PowerBuilder イベントではない Windows メッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
認識が発生したとき
ストロークが発生したとき
関数
InkEdit 関数
ClassName
Clear
戻 り 値 の
データ型
String
Integer
Cut
Integer
Cut
Integer
Drag
GetContextService
Integer
Integer
GetParent
Hide
Move
PowerObject
Integer
Integer
Paste
Integer
PointerX
PointerY
Integer
Integer
146
説明
コントロールに与えられている名前を返します。
選択されたテキスト(選択されたものがあれば)をコント
ロールから削除します(テキストはクリップボードにコピー
されません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールからクリップボードにコピーします(ただし、削除は
しません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールから切り取り(削除し)、クリップボードにコピーし
ます。
インクエディット項目のドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタンス
への参照を作成します。
親オブジェクト名への参照を返します。
指定されたインクエディット項目を非表示にします。
指定された位置にコントロールまたはオブジェクトを移動
します。
コントロール内の挿入ポイントの位置に、クリップボードの
内容を挿入します。
オブジェクトの左端からポインタまでの距離を返します。
オブジェクトの上部からポインタまでの距離を返します。
PowerBuilder
第2章
InkEdit 関数
Position
PostEvent
Print
Resize
RecognizeText
ReplaceText
SelectedLength
SelectedText
SelectText
SetFocus
SetPosition
SetRedraw
Show
TriggerEvent
TypeOf
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
戻 り 値 の
データ型
説明
Integer
コントロール内の挿入ポイントの位置を返します。
Boolean
オブジェクトのイベント キューの最後にイベントを追加し
ます。
Integer
このオブジェクトを印刷ジョブに送ります。画面に表示され
ている部分だけが印刷されます。
Integer
指定された大きさにコントロールをサイズ変更します。
Integer
インク認識が発生する必要があることを指定します。
Integer
選択されたテキストを指定された文字列と置き換えます。テ
キストが選択されていない場合は、その文字列を挿入ポイン
トの位置に挿入します。
Integer
コントロール内で選択されているテキストの長さを返しま
す。
String
コントロールで選択されたテキストの文字列を返します。
Long
開始位置と長さで指定されたテキストを選択します。
Integer
指定されたオブジェクトあるいはコントロールにフォーカ
スを設定します。
Integer
InkEdit コントロールをウィンドウ上のほかのオブジェクト
の前面に置くか背面に置くか、位置を指定します。
Integer
オブジェクトのプロパティを変更した後に、オブジェクトを
自動再描画するかどうかを制御します。
Integer
オブジェクトまたはコントロールが非表示の場合は、それを
表示します。オブジェクトが表示されている場合は、それを
前面に表示します。
Integer
指定されたイベントをコントロール内で起動し、そのイベン
トのスクリプトを実行します。
Object
コントロールのデータ型を返します。
InkPicture コントロール
インクピクチャ(InkPicture)コントロールは、タブレット PC でのペ
ン入力(インク)を収集し、それをピクチャに重ねます。このコント
ロールは、インク注釈をピクチャまたは署名に収集するために使用さ
れます。手書き文字認識機能はありません。
オブジェクトとコントロール
147
InkPicture コントロール
プロパティ
InkPicture プロパ
ティ
AutoErase
データ型
Boolean
説明
一部のスタイラスで使用可能な自動消去機能を設定する
かどうかを示します。値は以下のとおりです。
TRUE - AutoErase を設定します。
FALSE - AutoErase を解除します(デフォルト)
。
BackColor
Long
Border
Boolean
背景色を -2 から 16,777,215 の範囲の数値で示します。色
(RGB 関数)についての詳細は、『PowerScript リファレン
ス』マニュアルを参照してください。
コントロールに枠線を付けるかどうかを示します。値は
以下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE – コントロールに枠線を付けません。
BorderStyle
BorderStyle
(カ タ ロ グ デ ー タ
型)
BringToTop
Boolean
ClassDefinition
PowerObject
CollectionMode
DragAuto
コントロールの枠線のスタイルを示します。値は以下の
とおりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
InkCollectionMode
インクだけを収集するか、ジェスチャだけを収集するか、
(カ タ ロ グ デ ー タ あるいはインクとジェスチャを収集するかを示します。値
は以下のとおりです。
型)
GestureOnly! – ジェスチャだけを収集します。
InkOnly! – インクだけを収集します(デフォルト)。
InkAndGesture! – インクとジェスチャを収集します。
Boolean
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
148
PowerBuilder
第2章
InkPicture プロパ
ティ
DragIcon
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
String
DynamicRendering
Boolean
EditMode
InkPicEditMode
Enabled
Boolean
説明
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン(ICO ファイル)ファイル
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止アイコンが表示されます。
コントロールに表示されたインクを描画するのと同じよ
うにレンダリングするかどうかを示します。デフォルトは
true です。
コントロールの編集モードをインクの描画、インクの編
集、またはインクの削除に設定するかどうかを示します。
値は以下のとおりです。
InkPicDeleteMode! - インクを削除します。
InkPicInkMode! - インクを描画できます(デフォル
ト)。
InkPicSelectMode! - 編集のためにインクを選択しま
す。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
EraserMode
Integer
インクをストロークで削除するか、ポイントで削除するか
を示します。値は以下の通りです。
0 - インクをストロークで削除します(デフォルト)
1 - インクをポイントで削除します。
EraserWidth
Integer
Height
HighContrastInk
Integer
Boolean
消しゴムペン チップの幅をピクセルで示します。デフォ
ルトは 212 ピクセルです。
コントロールの高さを PowerBuilder 単位系で示します。
システムがハイ コントラスト モードであり、ハイ コント
ラストで、選択枠を描画し、処理するときに、インクを単
色で描画するかどうかを指定します。値は以下のとおりで
す。
TRUE - インクをハイ コントラスト モードで単色で描
画します(デフォルト)。
FALSE - インクをハイ コントラスト モードで単色で
画しません。
オブジェクトとコントロール
149
InkPicture コントロール
InkPicture プロパ
ティ
IgnorePressure
データ型
Boolean
説明
タブレットの表面でペン チップの圧力が加わると描画イ
ンクの幅が広くなるかを示す描画属性です。値は以下のと
おりです。
TRUE – ペン チップからの圧力は無視されます。
FALSE – ペン チップの圧力でインクの幅が広がります
InkAntiAliased
Boolean
InkColor
Long
InkEnabled
Boolean
InkFileName
InkHeight
InkTransparency
InkWidth
MarginX
MarginY
PenTip
(デフォルト)。
描画インクの輪郭で前景色と背景色を融合し(アンチエイ
リアスし)、ストロークを滑らかで鮮明にするかどうかを
示す描画属性です。値は以下のとおりです。
TRUE – インク ストロークは滑らかで鮮明になります
(デフォルト)。
FALSE – インク ストロークはアンチエイリアスされま
せん。
現行のインクの色を示す描画属性です。デフォルトの色は
黒です。
InkPicture コントロールがペン入力を収集するかどうかを
示します。値は以下のとおりです。
TRUE – コントロールはペン入力を収集します(デフォ
ルト)。
FALSE – コントロールはペン入力を収集せず、ペン関
連のイベントが発生しません。
インクをロードしたファイル名を示します。
長方形のペン チップの高さをピクセルで示す描画属性で
す。デフォルトは 1 ピクセルです。
Integer
描画インクの透明度を示す描画属性です。値の範囲は、完
全に不透明な 0(デフォルト)から完全に透明な 255 まで
です。
Integer
ペンの幅をピクセルで示す描画属性です。デフォルトは
53 ピクセルです。IgnorePressure プロパティが設定されて
いない場合、実際の幅は最小圧力の Width プロパティの値
の 0.5 倍と最大圧力のその値の 1.5 倍の間で変化します。
Integer
コントロールの周りの x 軸の余白を PowerBuilder 単位系
で示します。デフォルト値は 0 です。
Integer
コントロールの周りの y 軸の余白を PowerBuilder 単位系
で示します。デフォルト値は 0 です。
InkPenTip
ペン チップを円にするか、または長方形にするかを示す
(カ タ ロ グ デ ー タ 描画属性です。値は以下のとおりです。
型)
PenTipBall! – ペン チップは円になります(デフォルト)。
String
Integer
PenTipRectangle! – ペン チップは長方形になります。
150
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
InkPicture プロパ
ティ
PictureFileName
データ型
String
PictureSizeMode
DisplaySizeMode
Pointer
String
PowerTipText
Status
Long
InkPicStatus
TabOrder
Integer
Tag
Visible
String
Boolean
説明
コントロールのピクチャを含むファイル名を示します。デ
フォルトは空の文字列です。サポートするフォーマット
は、BMP、GIF、JPEG、PNG、および TIF です。
ピクチャをコントロールに表示する方法を示します。値は
以下のとおりです。
InkPicAutoSize! – ピクチャ全体を表示するようにコン
トロールをサイズ変更します。
InkPicCentered! – ピクチャをコントロールの中央にしま
す。
InkPicNormal! – ピクチャをコントロールの左上端に表
示し、コントロールに収まらない部分を切り取ります
(デフォルト)。
InkPicStretched! – コントロールを埋めるようにピク
チャを伸ばします。
ストック ポインタの名前またはコントロールに対して使
用するポインタを含むファイル名を示します。
コントロールの PowerTip を示します。
ユーザが Stroke イベントを監視する必要がないように、コ
ントロールの現行のステータスを提供する実行時に有効
な読み出し専用のプロパティです。値は、CollectingInk!、
RecognizingInk!、および Idle! です。
ウィンドウ内のコントロールのタブ値(順序)を示します
(0 を指定すると、ユーザはコントロールにタブ移動でき
ません)。
コントロールに割り当てるタグの値を示します。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます(デフォルト)
。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
オブジェクトとコントロール
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で示します。
151
InkPicture コントロール
イベント
InkPicture イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
SelectionChanged
SelectionChanging
SizeChanged
Stroke
発生する状況
コントロールで左マウス ボタンがクリックされるとき
ウィンドウの Open イベントが発生する直前に、そのオブジェクトが作成さ
れるとき
ウィンドウの Close イベントが発生した直後に、そのオブジェクトが破棄さ
れるとき
コントロールをダブルクリックしたとき
コントロール上にドラッグ中のコントロールがドロップされたとき
ドラッグ中のコントロールがコントロール上に入るとき
ドラッグ中のコントロールがコントロールから離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
コントロール上で項目が選択されるとき
選択範囲を変更しようとしたとき。選択範囲の変更を中止するときには 1 を
返し、そのまま変更するときには 0 を返します。
コントロールがサイズ変更されたとき
ストロークが発生したとき
関数
InkPicture 関数
ClassName
Drag
GetContextService
戻 り 値 の
データ型
String
Integer
Integer
GetParent
Hide
LoadInk
LoadPicture
PowerObject
Integer
Integer
Integer
152
説明
コントロールの名前を返します。
InkEdit 項目のドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタンス
への参照を作成します。
親オブジェクト名への参照を返します。
指定された InkEdit 項目を非表示にします。
ファイルまたは blob からインクをロードします。
ファイルまたは blob からピクチャをロードします。
PowerBuilder
第2章
InkPicture 関数
Move
PointerX
PointerY
PostEvent
Print
ResetInk
ResetPicture
Resize
Save
SaveInk
SetFocus
SetPosition
SetRedraw
Show
TriggerEvent
TypeOf
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
戻 り 値 の
データ型
説明
Integer
コントロールまたはオブジェクトを指定された位置に移動
します。
Integer
オブジェクトの左端からポインタ位置までの距離を測定し
ます。
Integer
オブジェクトの上端からポインタ位置までの距離を測定し
ます。
Boolean
オブジェクトのイベント キューの最後にイベントを追加し
ます。
Integer
このオブジェクトを印刷ジョブに送ります。画面上に表示され
た部分だけが印刷されます。
Integer
コントロールからインクを消去します。
Integer
コントロールからピクチャを消去します。
Integer
指定された大きさにコントロールをサイズ変更します。
Integer
ピクチャおよびオプションでオーバーレイ インクをファイ
ルまたは blob に保存します。保存できる形式は、ビットマッ
プ、JPEG、GIF、TIF、または PNG です。
Integer
インクをファイルまたは blob に保存します。保存できる形式
は、Ink Serialized Format (ISF)、GIF、Base-64 encoded ISF、ま
たは Base-64 encoded GIF です。
Integer
指定されたオブジェクトまたはコントロールにフォーカス
を設定します。
Integer
InkPicture コントロールをウィンドウ上の前面に置くか背面
に置くか、位置を指定します。
Integer
オブジェクトのプロパティを変更した後でそのオブジェク
トを自動再描画するかどうかを設定します。
Integer
非表示のオブジェクトまたはコントロールを表示します。オ
ブジェクトがすでに表示されている場合には、最前面に表示
します。
Integer
指定されたイベントをコントロール内で起動し、そのイベン
トのスクリプトを実行します。
Object
コントロールのデータ型を返します。
オブジェクトとコントロール
153
InternetResult オブジェクト
InternetResult オブジェクト
InternetResult オブジェクトは、GetURL 関数と PostURL 関数の呼び出し
に反応してインターネット経由で返されるときに、非同期型のデータ
を受け取ったり、キャッシュに入れたりするバッファの役割を果たし
ます。また、このオブジェクトは、受け取ったデータの処理も行うこ
とができます。
InternetResult オブジェクトを使用するには、渡される HTML を処理す
る InternetData 関数を定義する標準クラス ユーザ オブジェクトを作成
します。
プロパティ
InternetResult
プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
イベント
InternetResult イベント
Constructor
Destructor
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
関数
InternetResult 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
InternetData
PowerObject
Integer
InternetStatus
PostEvent
Integer
Boolean
154
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
GetURL 関数や PostURL 関数が返した HTML データを処理
します。
使用されません。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
InternetResult 関数
TriggerEvent
戻り値のデータ型
Integer
TypeOf
Object
説明
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
JaguarORB オブジェクト
JaguarORB オブジェクトは、PowerBuilder のクライアントが C++ のク
ライアントと同じ方法で EAServer にアクセスすることを可能にしま
す。JaguarORB オブジェクトを使用すると、PowerBuilder のクライア
ントは、Connection オブジェクトからは利用できない CORBA の機能
を利用できます。
プロパティ
JaguarORB プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
イベント
JaguarORB イベント
Constructor
Destructor
Error
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
クライアントの要求が満たされなかったとき
関数
JaguarORB 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
PowerObject
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
155
Line コントロール
JaguarORB 関数
Init
Object_To_String
PostEvent
戻り値のデータ型
Long
String
Boolean
Resolve_Initial_Reference Long
s
String_To_Object
Long
TriggerEvent
Integer
TypeOf
Object
説明
ORB プロパティの値を設定します。
オブジェクトを文字列の形式で返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
CORBA ネーミング サービスを使用して EAServer コンポー
ネントの初期状態のネーミング コンテキストを取得しま
す。
渡された文字列を基にしてオブジェクトの参照を取得し
ます。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
Line コントロール
Line(直線)コントロールは、1 本の直線または破線を表す描画オブ
ジェクトです。
プロパティ
Line プロパティ
BeginX
データ型
Integer
BeginY
Integer
ClassDefinition
PowerObject
EndX
Integer
EndY
Integer
LineColor
Long
156
説明
Line の端点の X 位置(ウィンドウの左端からの距離)を
PowerBuilder 単位系で示します。
Line の端点の Y 位置(ウィンドウの上部からの距離)を
PowerBuilder 単位系で示します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
Line のもう一方の端点の X 位置(ウィンドウの左端から
の距離)を PowerBuilder 単位系で示します。
Line のもう一方の端点の Y 位置(ウィンドウの上部から
の距離)を PowerBuilder 単位系で示します。
コントロールの輪郭線に使用する色を -2 から 16,777,215
の 範 囲 の 数 値 で 指 定 し ま す。色 に つ い て の 詳 細 は、
『PowerScript リファレンス』マニュアルの RGB 関数を参照
してください。
PowerBuilder
第2章
Line プロパティ
LineStyle
LineThickness
Tag
Visible
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
説明
LineStyle(カ タ Line コントロールのスタイルを示します。値は以下のとお
ログ データ型) りです。
Continuous!
Dash!
DashDot!
DashDotDot!
Dot!
Transparent!
Integer
Line コントロールの太さを PowerBuilder 単位系で示しま
す。LineThickness プロパティに 1 ピクセル(PowerBuilder
単位系で約 3)より大きい値が指定されると、LineStyle プ
ロパティの値は Continuous! になります。
String
コントロールに割り当てるタグの値を示します。
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
イベント
Line イベント
Constructor
Destructor
発生する状況
ユーザ オブジェクトが作成されるとき
ユーザ オブジェクトが破棄されるとき
関数
Line 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
Hide
Move
Resize
PowerObject
Integer
Integer
Integer
Show
TypeOf
Integer
Object
オブジェクトとコントロール
説明
コントロールに与えられている名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの長さを変更します(BeginX、BeginY、EndX、
EndY の各プロパティの値を変更します)。
コントロールを表示します。
コントロールのデータ型を返します。
157
ListBox コントロール
ListBox コントロール
ListBox(リストボックス)コントロールは、選択可能な複数のオプ
ションや値の表示に用います。オプションや値が多過ぎて一度に
ListBox 内に表示できない場合や、テキストの長さが ListBox の幅を越
えた場合は(垂直または水平)スクロールバーが ListBox 内に提供さ
れます。
プロパティ
ListBox プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
AccessibleRole
BackColor
Border
AccessibleRole
(カタログ デー
タ型)
Long
Boolean
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コードです。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
158
PowerObject
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
PowerBuilder
第2章
ListBox プロパティ
DisableNoScroll
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
スクロールバーの表示方法や動き方を示します。値は以下
のとおりです。
TRUE - スクロールバーは常に表示されますが、
すべて
DragAuto
DragIcon
Enabled
Boolean
String
Boolean
の項目に、スクロールバーなしでアクセスできるとき
は使用できません。
FALSE - スクロールバーは必要なときにだけ(項目の
数やリストボックスの高さに応じて)表示されます。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
ExtendedSelect
Boolean
ユーザがリストボックスで同時に複数の項目を選択でき
るようにするかどうかを指定します。値は以下のとおりで
す。
TRUE - ユーザは複数の項目を選択できます。
連続した
項目を選択するには、項目をクリックしてマウスを上
下にドラッグします。連続していない複数の項目を選
択するには、
〔Ctrl〕を押しながらクリックしていきま
す。
FALSE - 同時に複数の項目を選択できません。
MultiSelect プロパティとの併用 MultiSelect プロパティを
指定すると、ユーザは項目をクリックするだけでリスト
ボックスの複数の項目を選択できます。MultiSelect プロパ
ティと ExtendedSelect プロパティの両方を TRUE にしたと
きは、ExtendedSelect プロパティが優先されます。
オブジェクトとコントロール
159
ListBox コントロール
ListBox プロパティ
FaceName
データ型
String
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Height
HScrollBar
説明
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
水平スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - 水平スクロールバーを表示します。
FALSE - 水平スクロールバーを表示しません。
Italic
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Item[ ]
MultiSelect
String
Boolean
コントロール内の項目を指定します。
リストボックス中の複数の項目を同時に選択できるよう
にするかどうかを示します。値は以下のとおりです。
TRUE - 複数の項目を選択できます。
FALSE - 同時に複数の項目を選択できません。
MultiSelect プロパティを指定す
ると、ユーザは項目をクリックするだけでリストボッ
クスの複数の項目を選択できます。MultiSelect プロパ
ティと ExtendedSelect プロパティの両方を TRUE にした
ときは、ExtendedSelect プロパティが優先されます。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
ExtendedSelect との併用
Pointer
160
String
PowerBuilder
第2章
ListBox プロパティ
RightToLeft
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
Sorted
Boolean
リストボックス内の項目を自動的にソートするかどうか
を示します。値は以下のとおりです。
TRUE - 項目をソートします。
FALSE - 項目をソートしません。
TabOrder
Integer
TabStop[ ]
Integer array
Tag
TextColor
String
Long
TextSize
Integer
Underline
Boolean
ウィンドウ内のコントロールのタブ値(順序)を示します
(0 を指定すると、ユーザはコントロールにタブ移動でき
ません)。
リストボックス内のタブ ストップの位置を示します。タ
ブ ストップは文字位置で指定します。タブ ストップの区
切り記号はスペースです。TabStop[1](最初のタブ ストッ
プ)だけに値を割り当てると、最初のタブ ストップに指
定された文字位置の数だけ間隔を空けて各タブ ストップ
が均等に配置されます。2 つ以上のタブ ストップを指定す
ると、各タブ ストップは指定された位置に配置されます。
コントロールの中に 16 個までのタブ ストップを定義でき
ます。デフォルトの配列は TabStop[8] で、各タブ ストッ
プは 8 文字ごとに配置されます。
コントロールに割り当てるタグの値を示します。
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。色についての詳細は、
『PowerScript リファ
レンス』マニュアルの RGB 関数を参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
オブジェクトとコントロール
161
ListBox コントロール
ListBox プロパティ
VScrollBar
データ型
Boolean
説明
垂直スクロールバーをリストボックスの右端に表示する
かどうかを示します。値は以下のとおりです。
TRUE - 垂直スクロールバーを表示します。
FALSE - 垂直スクロールバーを表示しません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
ListBox イベント
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
SelectionChanged
162
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されて、アクティブ状態に
なるとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder イベントではないコントロールのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
コントロール上で項目が選択されるとき
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
ListBox 関数
AddItem
戻り値のデータ型
Integer
説明
リストボックスの最後に、新しい項目を追加します。コン
トロールの Sorted プロパティが TRUE の場合、項目の追加
後に項目が再度ソートされます。
AddItem 関数は、このコントロールの Item[ ] プロパティを
ClassName
DeleteItem
String
Integer
DirList
Boolean
DirSelect
Boolean
Drag
FindItem
Integer
Integer
GetContextService
Integer
GetParent
Hide
InsertItem
PowerObject
Integer
Integer
Move
PointerX
PointerY
PostEvent
Integer
Integer
Integer
Boolean
Print
Reset
Resize
SelectedIndex
Integer
Integer
Integer
Integer
SelectedItem
String
オブジェクトとコントロール
更新しません。
コントロールに与えられている名前を返します。
インデックスで指定された項目を、リストボックスから削
除します。
指定したファイル パターンに合致したファイル リストを
リストボックスに挿入します。
コントロールで現在選択されている項目を取得し、指定さ
れた変数に代入します。
コントロールのドラッグを開始、または終了します。
リストボックスから、指定された文字列で始まる項目を検
索します。指定されたインデックス以降で最初に一致する
項目を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
リストボックスに新しい項目を追加します。項目は、指定
されたインデックスの指示する項目の前に挿入されます。
コントロールの Sorted プロパティが TRUE の場合、項目の
追加後に項目が再度ソートされます。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールから項目をすべて削除します。
コントロールのサイズを変更します。
リストボックス内で、現在選択されている項目のインデッ
クスを返します。複数の項目が選択されている場合、その
中で最初の項目のインデックスを返します。
最初に選択されている項目のテキストを返します。
163
ListBox コントロール
ListBox 関数
SelectItem
戻り値のデータ型
Integer
説明
コントロール中から項目を検索し、選択(ハイライト)状
態にします。項目のテキストがわかっていて位置が不明の
場合は、構文 1 を使用します。項目がリストのどの位置に
あるかわかっていたり、現行の選択項目を非選択にする場
合には、構文 2 を使用します。
SelectItem 関数は、MultiSelect プロパティが TRUE となっ
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
SetState
Integer
SetTop
Integer
Show
State
Integer
Integer
Text
String
Top
Integer
TotalItems
TotalSelected
Integer
Integer
TriggerEvent
Integer
TypeOf
Object
164
ている ListBox では何の効果ももたらしません。リスト内
のほかの項目の選択状態に影響を与えずに項目を選択す
るには、SetState 関数を使用してください。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
指定されたインデックスの指示された項目の状態(ハイラ
イト表示の有無)を設定します。SetState 関数が動作する
のは、複数選択可能なコントロール(つまり、MultiSelect
プロパティが TRUE のコントロール)に対してだけです。
コントロール内の項目をスクロールして、指定されたイン
デックスの指示された項目をコントロールの一番上に移
動します。
コントロールを表示します。
指定されたインデックスの指示された項目が選択されて
いる(ハイライト表示されている)場合は 1 を返します。
その項目が選択されていない場合は 0 を返します。
コントロール内の項目のうち、指定されたインデックスの
指示する項目のテキストを取得します。
現在、コントロールの一番上にある項目のインデックス番
号を返します。
コントロール内にある項目の総数を返します。
コントロールの中で選択されている項目の総数を返しま
す。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
ListView コントロール
ListView(リストビュー)コントロールはユーザにリストによって表示
した情報を提供します。ListView コントロールの各項目はテキストと
ピクチャから構成されており、ユーザがアプリケーション実行時に操
作することができます。
プロパティ
ListView プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
AccessibleRole
AutoArrange
AccessibleRole
(カタログ デー
タ型)
Boolean
BackColor
Long
Border
Boolean
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コードを示します。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
PowerBuilder がアイコンを自動的に配置するときに、大き
いアイコンを使用するか、小さいアイコンを使用するかを
示します。
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BorderStyle
(カタログ デー
タ型)
BringToTop
Boolean
ButtonHeader
Boolean
オブジェクトとコントロール
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を指定します。
詳細ビューのカラム タイトルをボタンとして表示するか
どうかを示します。
165
ListView コントロール
ListView プロパティ
CheckBoxes
データ型
Boolean
説明
状態イメージをチェックボックスに置き換えるかどうか
を示します。デフォルトの設定では、チェックボックスの
チェックははずれています。ListView コントロールは、マ
ウスとキーボードによる入力を処理してチェックの状態
を切り替えます。値は以下のとおりです。
• TRUE - チェックボックスを表示します。
• FALSE - チェックボックスを表示しません。
項目のチェックボックスの状態を確認するには、その項目
の状態ピクチャのインデックスをチェックします。
ClassDefinition
PowerObject
DeleteItems
Boolean
DragAuto
Boolean
DragIcon
String
EditLabels
Boolean
Enabled
Boolean
チェックがはずれている = 1
チェックされている = 2
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
ユーザが〔Delete〕を押して、ListView コントロールから
ListView 項目を削除できるようにするかどうかを示しま
す。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
選択されている項目をユーザがクリックすると、その項目
のラベルが編集できるかどうかを示します。まず項目をク
リックして選択しなければならない点に注意してくださ
い。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 使用できます。
FALSE - 使用できません。
166
PowerBuilder
第2章
ListView プロパティ
ExtendedSelect
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
ユーザがリストボックスで同時に複数の項目を選択でき
るようにするかどうかを指定します。値は以下のとおりで
す。
TRUE - ユーザは複数の項目を選択できます。
項目の指
FaceName
String
FixedLocations
Boolean
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
FullRowSelect
定は、最初の項目をクリックしたあと、連続した最後
の項目までマウスをドラッグし〔Shift〕を押してクリッ
クします。連続していない場合には〔Ctrl〕を押しなが
らクリックしていきます。
FALSE - 同時に複数の項目を選択できません。
コントロール内のテキストを表示する字体名を示します。
たとえば Arial や Courier です。
ユーザが項目をドラッグしてコントロール内の別の位置
に移動できないかどうかを示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。アプリケーションの実行には、選択さ
れた文字セットをサポートしているオペレーティング シ
ステム上で、適切なバージョンの PowerBuilder を使わなけ
ればなりません。値は以下のとおりです。
ANSI!
ChineseBig5!
DefaultCharSet!
Hangeul!
OEM!
ShiftJIS!
Symbol!
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロール内のテキストに使用されるフォントのピッ
ログ データ型) チ(間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Boolean
詳細ビューで行全体を選択できるかどうかを示します。値
は以下のとおりです。
• TRUE - 行全体を選択できます。
• FALSE - 最初のカラムの項目のみ選択できます。
オブジェクトとコントロール
167
ListView コントロール
ListView プロパティ
GridLines
データ型
Boolean
説明
詳細ビューにグリッド線を表示するかどうかを示します。
• TRUE - グリッド線を表示します。
HeaderDragDrop
Boolean
• FALSE - グリッド線を表示しません。
詳細ビューで、カラム ヘッダをドラッグしてカラムを移
動できるかどうかを示します。
• TRUE - カラム ヘッダをドラッグできます。
Height
HideSelection
Integer
Boolean
• FALSE - カラム ヘッダをドラッグしてもカラムは移動
しません。
コントロールの高さを PowerBuilder 単位系で示します。
コントロールがフォーカスを失っても、選択したテキスト
をハイライト状態にしておくかどうかを示します。値は以
下のとおりです。
TRUE - テキストのハイライト表示は解除されます。
FALSE - テキストはハイライト表示されたままです。
ImeMode
Integer
Italic
Boolean
IME(Input Method Editor)のモード設定を示します。この
プロパティは、日本語版 PowerBuilder 上で実行されている
アプリケーションにのみ適用されます。
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Item[ ]
String
ItemPictureIndex[ ]
Integer
LabelWrap
Boolean
コントロール内の項目を指定します。このプロパティは、
初期設定の後は更新されません。
項目に関連付けられているピクチャを示します。ピクチャ
インデックス自体は、特定のアイコン、ビットマップ、ま
たはカーソルに関連付けられています。このプロパティ
は、初期設定の後は更新されません。
大きいアイコン ビュー内の ListView 項目の下の長いラベ
ルをラップする(折り返す)かどうかを示します。値は以
下のとおりです。
TRUE - ラップします。
FALSE - ラップしません。
LabelWrap プロパティは、一覧ビュー、詳細ビュー、また
は小さいアイコン ビューに対しては適用されません。
168
PowerBuilder
第2章
ListView プロパティ
LargePictureHeight
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Integer
説明
大きいアイコン ビューのピクチャの高さをピクセル単位
で示します。
スクリプトでこの値が設定できるのは、大きいピクチャが
大きいピクチャのインデックス リストに追加される前だ
けです。
LargePictureMaskColor
Long
LargePictureName[ ]
String
LargePictureWidth
Integer
この値が 0 の場合は、大きいピクチャのインデックスに最
初に追加されたピクチャの高さが適用されます。
大きいアイコン ビューで使用されるマスクの色を示しま
す。この色は、初期設定もしくは AddLargePicture 関数で
ピクチャを追加するときに使用されます。
大きいアイコン ビューで使用されるピクチャ名を示しま
す。ピクチャは、アイコン、カーソル、ビットマップのう
ち、開発者が独自に作成したものか、PowerBuilder ライブ
ラリに組み込まれているものが使用できます。このプロパ
ティは、初期設定の後は更新されません。
大きいアイコン ビューのピクチャの幅をピクセル単位で
示します。
スクリプトでこの値が設定できるのは、大きいピクチャが
大きいピクチャのインデックス リストに追加される前だ
けです。
OneClickActivate
Boolean
この値が 0 のときは、大きいピクチャのインデックス リ
ストに最初に追加されたピクチャの幅が適用されます。
1 回のクリックで ItemActivate イベントが起動されるかど
うかを示します。
• TRUE - 1 回のクリックで ItemActivate イベントが起動
されます。マウス ポインタを項目の上に移動すると、
その項目の色が変わり(ホット トラッキング)、マウス
ポインタは手の形になります。
• FALSE - マウス ポインタを項目の上に移動しても、そ
の項目の色は変わらず(TrackSelect = FALSE と仮定)、
マウス ポインタは手の形になりません
(TwoClickActivate = FALSE と仮定)。
Pointer
String
オブジェクトとコントロール
ただし、項目をダブルクリックしたときには、
OneClickActivate と TwoClickActivate の両方が FALSE で
あっても常に ItemActivate イベントが起動されます。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
169
ListView コントロール
ListView プロパティ
Scrolling
データ型
Boolean
説明
コントロールのすべての項目が表示されていないとき、エ
ンド ユーザが上下にスクロールできるようにするかどう
かを示します。値は以下のとおりです。
TRUE - スクロールできます。
FALSE - スクロールできません。
ShowHeader
Boolean
詳細ビューにカラム タイトルを表示するかどうかを示し
ます。値は以下のとおりです。
TRUE - 詳細ビューにタイトルを表示します。
FALSE - 詳細ビューにタイトルを表示しません。
SmallPictureHeight
Integer
小さいアイコン ビューのピクチャの高さをピクセル単位
で示します。
スクリプトでこの値を設定できるのは、小さいピクチャが
小さいピクチャのインデックス リストに追加される前だ
けです。
SmallPictureMaskColor
Long
SmallPictureName[ ]
String
SmallPictureWidth
Integer
この値が 0 のときは、小さいピクチャのインデックス リ
ストに最初に追加されたピクチャの高さが適用されます。
小さいアイコン ビューの中に使用するマスクの色を示し
ます。この色は、初期設定もしくは AddSmallPicture 関数で
ピクチャを追加するときに使用されます。
小さいアイコン ビューで使用されるピクチャ名を示しま
す。ピクチャは、アイコン、カーソル、ビットマップのう
ち、開発者が独自に作成したものか、PowerBuilder ライブ
ラリに組み込まれているものが使用できます。このプロパ
ティは、初期設定の後は更新されません。
小さいアイコン ビューのピクチャの幅をピクセル単位で
示します。
スクリプトでこの値を設定できるのは、小さいピクチャが
小さいピクチャのインデックス リストに追加される前だ
けです。
SortType
170
grSortType
この値が 0 のときは、小さいピクチャのインデックス リ
ストに最初に追加されたピクチャの幅が適用されます。
項目を項目ラベルの順番にソートする方法を示します。値
は以下のとおりです。
Ascending!
Descending!
UserDefinedSort!
Unsorted!
PowerBuilder
第2章
ListView プロパティ
StatePictureHeight
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Integer
説明
状態ピクチャの高さをピクセル単位で示します。
スクリプトでこの値を設定できるのは、状態ピクチャが状
態ピクチャのインデックス リストに追加される前だけで
す。
StatePictureMaskColor
Long
StatePictureName[ ]
String
StatePictureWidth
Integer
状態ピクチャの高さが 0 の場合は、状態ピクチャのイン
デックス リストに最初に追加されたピクチャの高さが適
用されます。
状態ピクチャで使用されるマスクの色を示します。この色
は、初期設定もしくは AddStatePicture 関数でピクチャを追
加するときに使用されます。
状態ピクチャとして使用するピクチャの名前を示します。
ピクチャは、アイコン、カーソル、ビットマップのうち、
開発者が独自に作成したものか、PowerBuilder ライブラリ
に組み込まれているものが使用できます。このプロパティ
は、初期設定の後は更新されません。
状態ピクチャの幅をピクセル単位で示します。
スクリプトでこの値を設定できるのは、状態ピクチャが状
態ピクチャのインデックス リストに追加される前だけで
す。
TabOrder
Integer
Tag
TextColor
String
Long
TextSize
Integer
状態ピクチャの幅が 0 の場合は、状態ピクチャのインデッ
クス リストに最初に追加された状態ピクチャの幅が適用
されます。
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。
コントロール中のテキスト サイズをポイント数で示しま
す。
以前のバージョンとの互換性を保つため、サイズは負の値
で扱われます。たとえば 10 ポイントのテキスト サイズは
-10 として保存されます。
オブジェクトとコントロール
171
ListView コントロール
ListView プロパティ
TrackSelect
TwoClickActivate
データ型
Boolean
Boolean
説明
マウス ポインタを項目の上に移動したときに項目の色が
変わるかどうか(ホット トラッキング)、マウス ポインタ
を項目の上で静止させたときに項目が選択されるかどう
かを示します。値は以下のとおりです。
TRUE - マウス ポインタを項目の上に移動したときに
項目の色が変わり、マウス ポインタを項目の上で静止
すると項目が選択されます。
FALSE - マウス ポインタを項目の上に移動しても項目
の色は変わらず、マウス ポインタを項目の上で静止さ
せても項目は選択されません。
2 回のクリックで ItemActivate イベントを起動するかどう
かを示します。
TRUE - 2 回のクリックで(項目を選択するためのク
Underline
Boolean
リ ッ ク と ア ク テ ィ ブ 状 態 に す る た め の ク リ ッ ク)
ItemActivate イベントが起動され、マウス ポインタを項
目の上に移動すると、その項目の色が変わり(ホット
トラッキング)、マウス ポインタは手の形になります。
FALSE - マウス ポインタを項目の上に移動しても、そ
の項目の色は変わらず(TrackSelect = FALSE と仮定)、
マウス ポインタは手の形になりません
(OneClickActivate = FALSE と仮定)。
ただし、項目がダブルクリックされたときには、
TwoClickActivate が FALSE であっても常に ItemActivate
イベントが起動されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
UnderlineCold
Boolean
OneClickActivate プロパティが TRUE のとき、ホット ト
ラッキング(マウス ポインタが項目の上に移動されたと
きに項目の色が変わる)が有効になり、ハイライト表示さ
れていない項目に下線が引かれるようにするかどうかを
示します。
TRUE - ホット トラッキングが有効になり、ハイライ
ト表示されていない項目に下線が引かれます。
FALSE - ハイライト表示されていない項目には下線が
引かれません。
172
PowerBuilder
第2章
ListView プロパティ
UnderlineHot
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
OneClickActivate プロパティまたは TwoClickActivate プロ
パティが TRUE のとき、ホット トラッキング(マウス ポ
インタが項目の上に移動されたときに項目の色が変わる)
が有効になって、ハイライト表示されている項目に下線が
引かれるかどうかを示します。
TRUE - ホット トラッキングが有効になり、ハイライ
ト表示されている項目に下線が引かれます。
FALSE - ハイライト表示されている項目には下線が引
View
Visible
ListViewView
Boolean
かれません。
ListView のビューのレイアウトを示します。値は以下のと
おりです。
ListViewLargeIcon! - 項目を左から右に配置し、大きい
ピクチャを使用します。
ListViewSmallIcon! - 項目を左から右に配置し、小さい
ピクチャを使用します。
ListViewList! - 項目を上から下に配置し、小さいピク
チャを使用します。
ListViewReport! - 項目を上から下に配置し、小さいピ
クチャを使用します。各項目に関連した情報カラムも
付加されます。このビューにデータを表示するには 1 つ
以上の情報カラムが必要です。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
ListView イベント
BeginDrag
発生する状況
ユーザがマウスの左ボタンでドラッグ操作を開始するとき。DragAuto プロ
パティが TRUE の場合は自動的にドラッグが開始します。FALSE の場合はド
ラッグ操作をスクリプトで記述しなければなりません。
オブジェクトとコントロール
173
ListView コントロール
ListView イベント
BeginLabelEdit
BeginRightDrag
Clicked
ColumnClick
Constructor
DeleteAllItems
DeleteItem
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
EndLabelEdit
GetFocus
Help
InsertItem
ItemActivate
ItemChanged
ItemChanging
Key
LoseFocus
Other
RightClicked
174
発生する状況
ユーザが ListView の項目ラベルの編集を開始したとき。新しいテキストを
項目ラベルにしないときは、リターン コードに 1 を指定します。項目ラベ
ルにするときは 0 を指定します。
ユーザがマウスの右ボタンでドラッグ操作を開始するとき。DragAuto プロ
パティが TRUE の場合は自動的にドラッグが開始します。FALSE の場合はド
ラッグ操作をスクリプトで記述しなければなりません。
コントロールがクリックされたとき
カラムがクリックされたとき
ウィンドウの Open イベントが発生する直前に、そのオブジェクトが作成さ
れるとき
ListView のすべての項目が削除されたとき
LiveView 項目が削除されたとき
ウィンドウの Close イベントが発生した直後に、そのオブジェクトが破棄さ
れるとき
コントロールをダブルクリックしたとき
コントロール上にドラッグ中のコントロールがドロップされたとき
ドラッグ中のコントロールがコントロール上(表示領域の周りの細い枠を含
めて)に入るとき
ドラッグ中のコントロールがコントロールから離れるとき(タブ ページ表
示領域に入ったときを含めて)
コントロール内にドラッグ中のコントロールがあり、ListView の項目上にな
いとき
ユーザが ListView の項目ラベルの編集を終えたとき。新しいテキストを項
目ラベルにしないときは、リターン コードに 1 を指定します。項目ラベル
にするときは 0 を指定します。
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
項目が挿入されているとき。
OneClickActivate プロパティが TRUE の場合に項目が 1 回クリックされたと
き。または TwoClickActivate プロパティが TRUE の場合に項目が 2 回クリッ
クされるとき
項目が変更されたとき
項目が変更されているとき。項目を変更しないときは、リターン コードに
1 を指定します。項目を変更するときは、0 を指定します。
ユーザがキーを押すとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
PowerBuilder
第2章
ListView イベント
RightDoubleClicked
Sort
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
発生する状況
コントロールをマウスの右ボタンでダブルクリックしたとき
2 つの項目どうしが比較されたとき
リターン コード :
1 - 項目 1 > 項目 2 の場合
0 - 項目 1 = 項目 2 の場合
-1 - 項目 1 < 項目 2 の場合
関数
ListView 関数
AddColumn
戻り値のデータ型
Integer
AddItem
AddLargePicture
Integer
Integer
AddSmallPicture
Integer
AddStatePicture
Integer
Arrange
Integer
ClassName
DeleteColumn
DeleteColumns
String
Integer
Integer
DeleteItem
DeleteItems
DeleteLargePicture
Integer
Integer
Integer
DeleteLargePictures
Integer
DeleteSmallPicture
Integer
DeleteSmallPictures
Integer
DeleteStatePicture
Integer
オブジェクトとコントロール
説明
ListView コントロールの詳細ビューにカラムを追加しま
す。
ListView コントロールに項目を追加します。
大きいピクチャのリストにアイコン、カーソル、または
ビットマップを追加します。
小さいピクチャのリストにアイコン、カーソル、または
ビットマップを追加します。
状態ピクチャのリストにアイコン、カーソル、またはビッ
トマップを追加します。
ListView コントロールの、大きいアイコン ビューまたは小
さいアイコン ビューの項目を整列します。
コントロールの名前を返します。
ListView コントロールから、カラムを削除します。
ListView コントロールから、すべてのカラムを削除しま
す。
ListView コントロールから、項目を削除します。
ListView コントロールから、すべての項目を削除します。
指定されたアイコン、カーソル、またはビットマップを、
大きいピクチャのリストから削除します。
大きいピクチャのリストからすべてのアイコン、カーソ
ル、またはビットマップを削除します。
指定されたアイコン、カーソル、またはビットマップを、
小さいピクチャのリストから削除します。
小さいピクチャのリストからすべてのアイコン、カーソ
ル、またはビットマップを削除します。
指定されたアイコン、カーソル、またはビットマップを状
態ピクチャのリストから削除します。
175
ListView コントロール
ListView 関数
DeleteStatePictures
戻り値のデータ型
Integer
Drag
EditLabel
FindItem
GetColumn
Integer
Integer
Integer
Integer
GetContextService
Integer
GetItem
GetOrigin
GetParent
Hide
InsertColumn
Integer
Integer
PowerObject
Integer
Integer
InsertItem
Move
Integer
Integer
PointerX
Integer
PointerY
Integer
PostEvent
Boolean
Print
Integer
Resize
SelectedIndex
Integer
Integer
SetColumn
Integer
SetFocus
Integer
SetItem
SetOverlayPicture
Integer
Integer
176
説明
状態ピクチャのリストからすべてのアイコン、カーソル、
またはビットマップを削除します。
ListView 項目のドラッグを開始、または終了します。
指定された ListView の項目ラベルの編集を開始します。
指定された検索条件と合致する次の項目を検索します。
構文 1:ListView コントロールには適用されません。
構文 2:ListView コントロールの詳細ビュー内にある指定
したカラムのプロパティを返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
指定された項目の情報を取得します。
ListView 項目の左上隅の X、Y 座標を取得します。
親オブジェクト名への参照を返します。
指定された ListView 項目を非表示にします。
ListView コントロールの詳細ビューにカラムを挿入しま
す。
ListView コントロールに項目を挿入します。
コントロールまたはオブジェクトを指定された位置に移
動します。
オブジェクトの左端からポインタ位置までの距離を測定
します。
オブジェクトの上端からポインタ位置までの距離を測定
します。
オブジェクトのイベント キューの最後にイベントを追加
します。
オブジェクトの内容を印刷ジョブに追加します。画面上に
表示された部分だけが印刷されます。
コントロールのサイズを指定された寸法に変更します。
ListView コントロール内で、現在選択されている項目の数
を返します。
構文 1:ListView コントロールには適用されません。
構文 2:ListView コントロールの詳細ビューの指定したカ
ラムのプロパティを設定します。
指定されたオブジェクトまたはコントロールにフォーカ
スを設定します。
指定された ListView 項目の値を設定します。
ピクチャ インデックスをオーバーレイ ピクチャのイン
デックスにマップします。4 つまでのオーバーレイ ピク
チャ インデックスが利用可能です。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
ListView 関数
SetPosition
戻り値のデータ型
Integer
SetRedraw
Integer
Show
Integer
Sort
TotalColumns
Integer
Integer
TotalItems
TotalSelected
Integer
Integer
TriggerEvent
Integer
TypeOf
Object
説明
ListView コントロールをウィンドウ上の前面に置くか背
面に置くか、位置を指定します。
オブジェクトのプロパティを変更した後でそのオブジェ
クトを自動再描画するかどうかを設定します。
非表示のオブジェクトまたはコントロールを表示します。
オブジェクトがすでに表示されている場合には、最前面に
表示します。
ListView コントロールの項目をソートします。
ListView コントロールの詳細ビューのカラム数を返しま
す。
ListView コントロール内の項目の数を返します。
ListView コントロール内で選択されている項目の数を返
します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
ListViewItem オブジェクト
ListViewItem(リストビューアイテム)オブジェクトは、ListView コン
トロールの表示内容を形成するシステム構造体です。ListViewItem オ
ブジェクトにはイベントがありません。
プロパティ
ListViewItem プロパティ
ClassDefinition
データ型
PowerObject
CutHighlighted
Boolean
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
その項目を切り取り操作の対象にするかどうかを示しま
す。値は以下のとおりです。
TRUE - 項目は切り取り操作の対象です。
FALSE - 項目は切り取り操作の対象ではありません。
Data
Any
オブジェクトとコントロール
ユーザ定義のデータを ListView 項目に割り当てます。
177
ListViewItem オブジェクト
ListViewItem プロパティ
DropHighlighted
データ型
Boolean
説明
その項目が、ドラッグ アンド ドロップ操作の対象かどう
かを示します。値は以下のとおりです。
TRUE - 項目はドラッグ アンド ドロップ操作の対象で
す。
HasFocus
Boolean
FALSE - 項目はドラッグ アンド ドロップ操作の対象
ではありません。
その項目にフォーカスがあるかどうかを示します。値は以
下のとおりです。
TRUE - 項目にフォーカスがあります。
FALSE - 項目にフォーカスがありません。
ItemX
Integer
ItemY
Integer
Label
String
OverlayPictureIndex
Integer
PictureIndex
Selected
Integer
Boolean
コントロールの左上隅とその項目との相対的な X 位置を
示します。
コントロールの左上とその項目との相対的な Y 位置を示
します。
その項目に関連付けられている文字列ラベルを示します。
その項目に関連付けられているオーバーレイ ピクチャを
示します。
その項目に関連付けられている大小のピクチャを示します。
その項目が選択されているかどうかを示します。値は以下
のとおりです。
TRUE - 項目は選択されています。
FALSE - 項目は選択されていません。
Integer
その項目に関連付けられている状態ピクチャを示します。
ListViewItem 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
StatePictureIndex
関数
178
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
mailFileDescription オブジェクト
mailFileDescription オブジェクトは、メール メッセージに添付される
ファイルについての情報を格納するシステム構造体です。
mailFileDescription オブジェクトにはイベントがありません。
プロパティ
mailFileDescription
プロパティ
ClassDefinition
FileType
データ型
PowerObject
mailFileType
(カタログ デー
タ型)
Filename
Pathname
String
String
Position
Unsignedlong
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
添付するファイルの種類を示します。値は以下のとおりで
す。
mailAttach! - データ ファイル
mailOLE! - 埋め込み OLE オブジェクト
mailOLEStatic! - 静的 OLE オブジェクト
添付するファイルのファイル名を示します。
添付するファイルのフル パス名(ファイル名を含む)を
示します。
添付するファイルのメッセージ本文中における位置を示
します。送信する添付ファイルが複数ある場合は必須で
す。
関数
mailFileDescription
関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
オブジェクトとコントロール
説明
オブジェクトのクラス名を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
179
mailMessage オブジェクト
mailMessage オブジェクト
mailMessage オブジェクトは、特定のメール メッセージに関する情報
を格納するシステム構造体です。mailMessage オブジェクトにはイベン
トがありません。
プロパティ
mailMessage プロパティ データ型
AttachmentFile[ ]
mailFileDescription
ClassDefinition
PowerObject
ConversationID
String
DateReceived
MessageSent
String
Boolean
MessageType
String
NoteText
ReceiptRequested
String
Boolean
説明
現行のメッセージに添付されるファイルを示します。
この mailFileDescription 配列に、添付ファイルに関する
情報が格納されます。
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
現行メッセージのカンバセーション スレッド ID を示
します。
現行メッセージを受信した日付を示します。
現行メッセージをメール サーバに送信済みかどうか
を示します(実行時の読み出し専用)。
TRUE - メッセージがメール サーバに送信されま
した。
FALSE - メッセージがメール サーバに送信されて
いません。
現行メッセージの種類を示します。空文字列や NULL
値以外の値は、通常のメール以外でアプリケーション
が使用していることを示します(実行時のみ)。
メッセージ本文の内容を示します(実行時のみ)。
現行メッセージに対する受信確認が要求されたかどう
かを示します(実行時のみ)。
TRUE - 受信確認が要求されています。
FALSE - 受信確認は要求されていません。
Recipient[ ]
mailRecipient
Subject
String
180
現行メッセージの受信者を示します。mailSend の場合、
Recipient プロパティの有効な値として mailOriginator!
を使用することはできません。有効な値は、mailto!、
mailcc!、および mailbcc! です。送信者がメッセージを
受け取るためには、mailcc! を使用します。
現行メッセージ ヘッダに表示する件名を示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
mailMessage プロパティ データ型
Unread
Boolean
説明
メッセージが読まれたかどうかを示します(実行時の
読み出し専用)。
TRUE - メッセージはまだ読まれていません。
FALSE - メッセージは読まれました。
関数
mailMessage 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
説明
オブジェクトのクラス名を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
mailRecipient オブジェクト
mailRecipient オブジェクトは、メール メッセージの受信者に関する情
報を格納するシステム構造体です。mailRecipient 構造体の値を取得す
るには mailAddress 関数を使用します。mailRecipient オブジェクトには
イベントがありません。
mailAddress 関数についての詳細は、
『PowerScript リファレンス』マニュ
アルを参照してください。
プロパティ
mailRecipient
プロパティ
Address
データ型
String
ClassDefinition
PowerObject
EntryID
Name
Blob
String
オブジェクトとコントロール
説明
現行メールの受信者の電子メール アドレスを示しま
す(実行時のみ)。
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
内部的に使用されるバイナリ エントリ識別子です。
現行のメール受信者名を示します(実行時のみ)。
181
mailSession オブジェクト
mailRecipient
プロパティ
RecipientType
データ型
mailRecipientType
(カタログ データ
型)
説明
現行のメール受信者の受信形態を示します。値は以下
のとおりです。
mailBCC!
mailCC!
mailOriginator!
mailTo!
関数
mailRecipient 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
説明
オブジェクトのクラス名を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
mailSession オブジェクト
mailSession 非ビジュアル オブジェクトは、MAPI(MessagingApplication
Program Interface)にサイン オンし、セッションを開きます。
プロパティ
mailSession プロパティ
ClassDefinition
データ型
PowerObject
MessageID[ ]
String
SessionID
Long
182
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
ユーザのメール受信ボックスにメッセージの ID を格納し
ます。
現行のメッセージ セッションのハンドルを保持します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
イベント
mailSession イベント
Constructor
Destructor
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
関数
mailSession 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
mailAddress
mailDeleteMessage
PowerObject
mailReturnCode
mailReturnCode
mailGetMessages
mailReturnCode
mailHandle
mailLogoff
UnsignedLong
mailReturnCode
mailLogon
mailReturnCode
mailReadMessage
mailReturnCode
mailRecipientDetails
mailReturnCode
mailResolveRecipient
mailReturnCode
mailSaveMessage
mailReturnCode
mailSend
PostEvent
mailReturnCode
Integer
TriggerEvent
Integer
オブジェクトとコントロール
説明
オブジェクトのクラス名を返します。
指定されたサービスのコンテキストに固有のインスタ
ンスへの参照を作成します。
親オブジェクト名への参照を返します。
メール メッセージの mailRecipient 配列を更新します。
ユーザのメール受信ボックスからメール メッセージを
削除します。
ユーザの受信ボックスにあるメッセージ ID をすべて取
得して、mailSession オブジェクトの MessageID 配列に格
納します。
mailSession オブジェクトのハンドルを取得します。
PowerBuilder アプリケーションとメール システムとの
接続を解除し、メール セッションを終了します。
PowerBuilder アプリケーションのメール セッションを
確立します。
メール セッションのメッセージ配列のメッセージ ID に
対応するメール メッセージを開きます。
指定された受信者のアドレス情報をダイアログボック
スに表示します。
ユーザのフルネームまたは名前の一部に基づいて有効
な電子メール アドレスを取得します。権限を持ったユー
ザは、システムのアドレス リストにある情報をオプショ
ンで変更することができます。
ユーザの受信ボックスに新しいメッセージを作成する
か、既存のメッセージと置き換えます。
メール メッセージを送信します。
オブジェクトのメッセージ キューの最後にイベントを
追加します。
オブジェクトのイベントを起動し、そのイベントのスク
リプトを実行します。
183
MDIClient オブジェクト
mailSession 関数
TypeOf
戻り値のデータ型
Object
説明
オブジェクトのデータ型を返します。
MDIClient オブジェクト
MDI ウィンドウは、複数のドキュメント ウィンドウ(シート)を同時
に開き、シート間を自由に移動できるフレーム ウィンドウです。
MDIClient オブジェクトとは、標準 MDI フレーム上でシートを開いて
表 示 す る 領 域 の こ と で す。標 準 MDI フ レ ー ム ウ ィ ン ド ウ で は、
PowerBuilder が MDIClient オブジェクトのサイズを決定し、フレーム
上に配置します。たとえば、フレームにメニュー バーとマイクロヘル
プがある場合、MDIClient オブジェクトは、メニュー バーの下からマ
イクロヘルプの上までの領域になります。
カスタム MDI フレーム ウィンドウでは、開発者がクライアント領域
のサイズを決定しなければなりません。たとえば、フレームのメニュー
バーの下にボタンを配置している場合、クライアント領域がボタンの
位置と重複しないようにサイズを決定しなければなりません。
MDIClient オブジェクトにはイベントはありません。
プロパティ
MDIClient プロパティ
BackColor
データ型
Long
BringToTop
Boolean
説明
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
PowerBuilder が MDIClient オブジェクトを画面の最前面に
移動するかどうかを示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
Height
Integer
184
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
MDIClient オブジェクトの高さを PowerBuilder 単位系で示
します。
PowerBuilder
第2章
MDIClient プロパティ
MicroHelpHeight
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Integer
説明
MDIClient オブジェクトのマイクロヘルプの高さを示しま
す。
MDI フレーム ウィンドウのスタイルが MDI フレーム(マ
イクロヘルプなし)の場合、MicroHelpHeight プロパティ
は 0 です。そのほかの場合、MicroHelpHeight プロパティ
はマイクロヘルプの高さとなります。
Tag
String
Visible
Boolean
このプロパティに値を設定することはできません。
MDIClient オブジェクトに割り当てられているタグ値を示
します。
MDIClient オブジェクトが表示可能かどうかを示します。
値は以下のとおりです。
TRUE - オブジェクトを表示できます。
FALSE - オブジェクトを表示できません。
Width
Integer
X
Integer
Y
Integer
MDIClient オブジェクトの幅を PowerBuilder 単位系で示し
ます。
X 位置(MDI フレーム ウィンドウの左端からの距離)を
PowerBuilder 単位系で示します。
Y 位置(MDI フレーム ウィンドウの上部からの距離)を
PowerBuilder 単位系で示します。
関数
MDIClient 関数
ClassName
戻り値のデータ型
String
GetContextService
Integer
GetParent
PowerObject
Hide
Move
Resize
SetRedraw
Integer
Integer
Integer
Integer
Show
TypeOf
Integer
Object
オブジェクトとコントロール
説明
MDIClient オブジェクトに割り当てられている名前を返し
ます。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
MDIClient オブジェクトを非表示にします。
MDIClient オブジェクトを指定された場所に移動します。
MDIClient オブジェクトのサイズを変更します。
MDIClient オブジェクトのプロパティを変更するたびに、
コントロールを自動再描画するかどうかを設定します。
ユーザがすべてのシートを閉じるときに起こる画面のち
らつきを少なくするには、SetRedraw を FALSE に設定しま
す。
MDIClient オブジェクトを表示します。
オブジェクトのデータ型を返します。
185
Menu オブジェクト
Menu オブジェクト
メニューは、現在アクティブなウィンドウ内でユーザが選択できるメ
ニュー項目(通常、コマンドまたはオプション)のリストです。メ
ニューは、メニュー バー、ドロップダウン メニュー、またはカスケー
ド メニューに表示したり、あるいはポップアップ メニューとして表示
することも可能です。
PowerBuilder にはメニューを開発するために Menu システム オブジェ
クトが用意されています。Menu オブジェクトには、ほかの Menu オブ
ジェクトを含めることができ、たとえば、ドロップダウン メニューや
カスケード メニューの項目として表示することができます。ユーザが
Menu オブジェクトをクリックすると、Clicked イベントが発生します。
クリックされたオブジェクトの下にドロップダウン メニューやカス
ケード メニューが指定されている場合、オブジェクトの Clicked イベ
ントに対するスクリプトが実行された後で、下位レベルのメニューが
表示されます。Menu オブジェクトに下位レベルのメニューがない場合
は、そのオブジェクトの Clicked イベントのスクリプトが実行されま
す。
プロパティ
Menu プロパティ
Checked
データ型
Boolean
説明
Menu オブジェクトが選択されているかどうかを示しま
す。Checked プロパティはツールバー ボタンの状態に反映
されます。値は以下のとおりです。
TRUE - オブジェクトは選択されています。
FALSE - オブジェクトは選択されていません。
ClassDefinition
186
PowerObject
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
PowerBuilder
第2章
Menu プロパティ
Default
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
太字で表示されるデフォルトのメニュー項目かどうかを
示します。1 つのメニューでデフォルトに設定できる項目
は 1 つだけです。
コンテキスト メニューで Default プロパティを使用し、
ユーザがオブジェクトを右クリックせずにダブルクリック
した場合に実行されるアクションを示すことができます。
また、このプロパティを使用して、マウスの右ボタンでは
なく左ボタンで項目をドラッグした場合に実行される操
作を示すこともできます。
値は以下のとおりです。
TRUE - メニュー項目は太字で表示されます。
FALSE - メニュー項目は太字で表示されません。
Enabled
Boolean
Menu オブジェクトが使用可能(クリックできる状態)か
どうかを示します。Enabled プロパティは、ツールバー ボ
タンの状態に反映されます。値は以下のとおりです。
TRUE - オブジェクトを使用可能にします。
FALSE - オブジェクトを使用可能にしません。
Item[ ]
MenuItemType
MergeOption
MicroHelp
ParentWindow
Menu
MenuItemType
(カタログ デー
タ型)
MenuMerge
Option(カタロ
グ データ型)
String
Window
オブジェクトとコントロール
Menu オブジェクトの下位レベルの Menu オブジェクトを
配列で示します。
プラットフォームによって使用方法が異なる特別なメ
ニュー項目を識別するのに用います。値は以下のとおりで
す。
MenuItemTypeAbout!
MenuItemTypeExit!
MenuItemTypeHelp!
MenuItemTypeNormal!
OLE オブジェクトがアクティブになったとき、オブジェ
クトにどのような影響が及ぶかを示します。値は以下のと
おりです。
EditMenu!
Exclude!
FileMenu!
HelpMenu!
Merge!
WindowMenu!
MergeOption プロパティについての詳細は、『アプリケー
ション テクニック』マニュアルの OLE の使用方法に関す
る章を参照してください。
オブジェクトに対するマイクロヘルプ テキストを示します。
Menu オブジェクトを所有しているウィンドウを示します。
187
Menu オブジェクト
Menu プロパティ
ShiftToRight
データ型
Boolean
説明
ほかの Menu オブジェクトが子孫メニューに追加される
ときに、Menu オブジェクトを、右または下にシフトさせ
るかどうかを示します。値は以下のとおりです。
TRUE - オブジェクトを右にシフトします。
FALSE - オブジェクトを下にシフトします。
Shortcut
Integer
Tag
String
Text
ToolbarItemDown
String
Boolean
Menu オブジェクトに対するショートカット キーを
Integer 型で示します。このプロパティはメニュー ペイン
タで設定します。実行時には設定できません。
Menu オブジェクトに割り当てられているタグ値を示しま
す。
Menu オブジェクトのテキストを示します。
ツールバー ボタンをクリックしたときの状態を示します。
値は以下のとおりです。
TRUE - ボタンをダウン状態にします。
FALSE - ボタンをアップ状態にします。
ToolbarItemDown
Name
String
ToolbarItemBar
Index
Integer
ToolbarItemName
String
ToolbarItemOrder
ToolbarItemSpace
ToolbarItemText
Integer
Integer
String
ToolbarItemVisible
Boolean
このプロパティは、マウスでボタンをクリックすると自動
的にリセットされます。
Menu オブジェクトに関連付けられたツールバー ボタン
がダウン状態のときに表示する、アイコンの名前を示しま
す。
複数のツールバーがあるとき、どのツールバー上に Menu
オブジェクトを表示するかを示します。このインデックス
を設定した結果、新しいツールバー内の最初の項目として
オブジェクトが設定された場合は、ツールバーが暗黙的に
作成されます。インデックスを設定した結果、ツールバー
の項目が空になるとそのツールバーが暗黙的に破棄され
ます。
ツールバーに項目として表示させる組み込みツールバー
ピクチャ名、または、
ビットマップ ファイル名を示します。
ツールバー内でその項目が位置する順番を示します。
ツールバー項目の前の余白の大きさを示します。
ツールバーのテキスト表示オプションが有効な場合に、
ツールバー項目に表示するテキストを示します。
ツールバー項目を表示するかどうかを示します。値は以下
のとおりです。
TRUE - ツールバー項目を表示します。
FALSE - ツールバー項目を表示しません。
Visible
Boolean
Menu オブジェクトが表示可能かどうかを示します。値は
以下のとおりです。
TRUE - オブジェクトを表示できます。
FALSE - オブジェクトを表示できません。
188
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
イベント
Menu イベント
Clicked
Help
Selected
発生する状況
Menu オブジェクトがクリックされたとき(選択または選択解除されたとき)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
ユーザが矢印キーやマウスで Menu オブジェクトに移動するとき
関数
Menu 関数
Check
戻り値のデータ型
Integer
ClassName
Disable
String
Integer
Enable
Integer
GetContextService
Integer
GetParent
Hide
PopMenu
PostEvent
PowerObject
Integer
Integer
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Uncheck
Object
Integer
オブジェクトとコントロール
説明
Menu オブジェクトの横にチェックマークを付け、Checked
プロパティを True に設定します。
Menu オブジェクトのクラス名を返します。
Menu オブジェクトを使用不可(グレー状態)にし、ユー
ザが選択できないようにします。Enabled プロパティを
False に設定します。
Menu オブジェクトを使用可能にし、選択できるようにし
ます。Menu オブジェクトは通常どおり(非グレー状態で)
表示され、Enabled プロパティは True に設定されます。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
Menu オブジェクトを非表示にします。
指定された位置に Menu オブジェクトを表示します。
Menu オブジェクトのメッセージ キューの最後にイベン
トを追加します。
Menu オブジェクトを表示します。
指定されたイベントを Menu オブジェクト内で起動し、そ
のイベントのスクリプトを実行します。
コントロールのデータ型を返します。
Menu オブジェクトの横のチェックマークを取り除き、
Checked プロパティを FALSE に設定します。
189
MenuCascade オブジェクト
MenuCascade オブジェクト
MenuCascade オブジェクトには複数の Menu オブジェクトを格納する
ことができます。MenuCascade オブジェクトは、ドロップダウン ボタ
ン パレットとして表示されます。
プロパティ
MenuCascade
プロパティ
Checked
データ型
Boolean
説明
Menu オブジェクトが選択されているかどうかを示しま
す。Checked プロパティはツールバー ボタンの状態に反映
されます。値は以下のとおりです。
TRUE - オブジェクトは選択されています。
FALSE - オブジェクトは選択されていません。
ClassDefinition
PowerObject
Columns
Integer
CurrentItem
Menu
Default
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
ドロップダウン ボタン パレットにあるカラム数を示しま
す。
現在、ドロップダウン ボタン パレットから、アクティブ
なボタンとしてメイン ツールバー上に表示されている
Menu オブジェクトを示します。
太字で表示されるデフォルトのメニュー項目かどうかを
示します。1 つのメニューでデフォルトに設定できる項目
は 1 つだけです。
コンテキスト メニューで Default プロパティを使用し、
ユーザがオブジェクトを右クリックせずにダブルクリッ
クした場合に実行されるアクションを示すことができま
す。
また、このプロパティを使用して、マウスの右ボタンでは
なく左ボタンで項目をドラッグした場合に実行される操
作を示すこともできます。
値は以下のとおりです。
• TRUE - メニュー項目は太字で表示されます。
• FALSE - メニュー項目は太字で表示されません。
190
PowerBuilder
第2章
MenuCascade
プロパティ
DropDown
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
MenuCascade オブジェクト中の Menu オブジェクトをド
ロップダウン ボタン パレットの項目として表示するかど
うかを示します。値は以下のとおりです。
TRUE - MenuCascade オブジェクトに属する Menu オブ
Enabled
Boolean
ジェクトをドロップダウン ボタン パレットとして表示
します。
FALSE - MenuCascade オブジェクトに属する Menu オ
ブジェクトを通常のツールバー項目として表示しま
す。
Menu オブジェクトが使用可能(クリックできる状態)か
どうかを示します。Enabled プロパティは、ツールバー ボ
タンの状態に反映されます。値は以下のとおりです。
TRUE - オブジェクトを使用可能にします。
FALSE - オブジェクトを使用可能にしません。
Item[ ]
MenuItemType
MergeOption
MicroHelp
ParentWindow
Menu
MenuItemType
(カタログ デー
タ型)
MenuMerge -
Option(カタロ
グ データ型)
String
Window
オブジェクトとコントロール
Menu オブジェクトの下位レベルの Menu オブジェクトを
配列で示します。
プラットフォームによって使用方法が異なる特別なメ
ニュー項目を識別するのに用います。値は以下のとおりで
す。
MenuItemTypeAbout!
MenuItemTypeExit!
MenuItemTypeHelp!
MenuItemTypeNormal!
OLE 2.0 オブジェクトがアクティブになったとき、オブ
ジェクトにどのような影響が及ぶかを示します。値は以下
のとおりです。
EditMenu!
Exclude!
FileMenu!
HelpMenu!
Merge!
WindowMenu!
MergeOption プロパティについての詳細は、
『アプリケー
ション テクニック』マニュアルの OLE の使用方法に関す
る章を参照してください。
オブジェクトに対するマイクロヘルプ テキストを示します。
Menu オブジェクトを所有しているウィンドウを示します。
191
MenuCascade オブジェクト
MenuCascade
プロパティ
ShiftToRight
データ型
Boolean
説明
ほかの Menu オブジェクトが子孫メニューに追加される
ときに、Menu オブジェクトを、右または下にシフトさせ
るかどうかを示します。値は以下のとおりです。
TRUE - オブジェクトを右にシフトします。
FALSE - オブジェクトを下にシフトします。
Shortcut
Integer
Tag
String
Text
ToolbarItemDown
String
Boolean
Menu オブジェクトに対するショートカット キーを Integer
型で示します。このプロパティはメニュー ペインタで設
定します。実行時には設定できません。
Menu オブジェクトに割り当てられているタグ値を示しま
す。
Menu オブジェクトのテキストを示します。
ツールバー ボタンをクリックしたときの状態を示しま
す。値は以下のとおりです。
TRUE - ボタンをダウン状態にします。
FALSE - ボタンをアップ状態にします。
ToolbarItemDown
Name
String
ToolbarItemBarIndex
Integer
ToolbarItemName
String
ToolbarItemOrder
ToolbarItemSpace
ToolbarItemText
Integer
Integer
String
ToolbarItemVisible
Boolean
このプロパティは、マウスでボタンをクリックすると自動
的にリセットされます。
Menu オブジェクトに関連付けられたツールバー ボタン
がダウン状態のときに表示する、アイコンの名前を示しま
す。
複数のツールバーがあるとき、オブジェクトと関連付けら
れているツールバーのインデックスを示します。インデッ
クスを新しいツールバーの最初の項目として設定した場
合、ツールバーが新たに作成されます。インデックスを設
定した結果、ツールバーの項目が空になるとそのツール
バーが暗黙的に破棄されます。
ツールバーに項目として表示させる組み込みツールバー
ピクチャ名、または、ビットマップ ファイル名を示しま
す。
ツールバー内でその項目が位置する順番を示します。
ツールバー項目の前の余白の大きさを示します。
ツールバーのテキスト表示オプションが有効な場合に、
ツールバー項目に表示するテキストを示します。
ツールバー項目を表示するかどうかを示します。値は以下
のとおりです。
TRUE - ツールバー項目を表示します。
FALSE - ツールバー項目を表示しません。
192
PowerBuilder
第2章
MenuCascade
プロパティ
Visible
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
Menu オブジェクトが表示可能かどうかを示します。値は
以下のとおりです。
TRUE - オブジェクトを表示できます。
FALSE - オブジェクトを表示できません。
イベント
MenuCascade イベント
Clicked
Help
Selected
発生する状況
Menu オブジェクトがクリックされたとき(選択または選択解除されたとき)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
ユーザが矢印キーやマウスで Menu オブジェクトに移動するとき
関数
MenuCascade 関数
Check
戻り値のデータ型
Integer
ClassName
Disable
String
Integer
Enable
Integer
GetContextService
Integer
GetParent
Hide
PopMenu
PostEvent
PowerObject
Integer
Integer
Integer
Show
TriggerEvent
Integer
Integer
オブジェクトとコントロール
説明
Menu オブジェクトの横にチェックマークを付け、Checked
プロパティを True に設定します。
Menu オブジェクトのクラス名を返します。
Menu オブジェクトを使用不可(グレー状態)にし、ユー
ザが選択できないようにします。Enabled プロパティを
False に設定します。
Menu オブジェクトを使用可能にし、選択できるようにし
ます。Menu オブジェクトは通常どおり(非グレー状態で)
表示され、Enabled プロパティは True に設定されます。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
Menu オブジェクトを非表示にします。
指定された位置に Menu オブジェクトを表示します。
Menu オブジェクトのメッセージ キューの最後にイベン
トを追加します。
Menu オブジェクトを表示します。
指定されたイベントを Menu オブジェクト内で起動し、そ
のイベントのスクリプトを実行します。
193
Message オブジェクト
MenuCascade 関数
TypeOf
Uncheck
戻り値のデータ型
Object
Integer
説明
コントロールのデータ型を返します。
Menu オブジェクトの横のチェックマークを取り除き、
Checked プロパティを FALSE に設定します。
Message オブジェクト
Message(メッセージ)オブジェクトは、PowerBuilder に定義されてい
ないイベントに対する処理を行うときや、TriggerEvent 関数や PostEvent
関数において複数のウィンドウ間でオプション パラメータの受け渡
しが必要なときなどに使用されます。
また、組み込みの Message オブジェクトを継承したクラス ユーザ オブ
ジェクトを定義することによって、Message オブジェクトをカスタマ
イズしたユーザ オブジェクトを独自に作成することもできます。
カ ス タ ム の Message オ ブ ジ ェ ク ト の 作 成 方 法 に つ い て の 詳 細 は、
PowerBuilder の『ユーザーズ ガイド』マニュアルのユーザ オブジェク
トの章を参照してください。
プロパティ
以下の Message オブジェクトのプロパティのうちの最初の 4 つは、
Microsoft Windows のメッセージ構造体の最初の 4 つのプロパティに対
応しています。
Message プロパティ
Handle
Number
データ型
Long
UnsignedInt
WordParm
Long
LongParm
Long
ClassDefinition
PowerObject
DoubleParm
Double
194
説明
ウィンドウまたはコントロールのハンドルです。
イベントを識別する番号(この番号は Windows から取得
されます)。
イベントの Word パラメータ wParam(このパラメータは
Windows から取得されます)。パラメータの値と意味は、
イベントによって決まります。
イベントの Long パラメータ lParam(このパラメータは
Windows から取得されます)。パラメータの値と意味は、
イベントによって決まります。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
数値または数値変数です。
PowerBuilder
第2章
Message プロパティ
StringParm
PowerObjectParm
Processed
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
String
PowerObject
Boolean
説明
文字列または文字列変数です。
構造体を含む PowerBuilder オブジェクト データ型です。
ユーザ定義イベントまたは Other イベントに対するスク
リプトで設定された Boolean 型の値です。値は以下のとお
りです。
TRUE - スクリプトがイベントを処理しました(イベ
ReturnValue
Long
ント処理後、デフォルトのウィンドウ プロセス
DefWindowProc 関数を呼び出しません)。
FALSE -(デフォルト)イベントの処理の後、
DefWindowProc 関数を呼び出します。
Message.Processed が TRUE の場合、Windows に返す値を示
します。Message.Processed が FALSE の場合、このプロパ
ティは無視されます。
イベント
Message イベント
Constructor
Destructor
発生する状況
ユーザ オブジェクトが作成されるとき
ユーザ オブジェクトが破棄されるとき
関数
Message 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
PostEvent
PowerObject
Boolean
TriggerEvent
Integer
TypeOf
Object
オブジェクトとコントロール
説明
ユーザ オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
ユーザ オブジェクトのメッセージ キューの最後にイベン
トを追加します。
ユーザ オブジェクトにイベントを送り、そのイベントに
関連付けられたスクリプトを実行します。
ユーザ オブジェクトのデータ型を返します。
195
MonthCalendar コントロール
MonthCalendar コントロール
MonthCalendar(月表示カレンダ)コントロールは、カレンダ形式の
ユーザ インタフェースを提供し、ユーザが日付の入力や選択を簡単に
行えるようにします。
プロパティ
MonthCalendar
プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
AccessibleRole
AutoSize
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コードです。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
1 か月全体が収まるようにカレンダのサイズを自動的に
変更するかどうかを示します。値は以下のとおりです。
TRUE - サイズを変更します(デフォルト)
。
FALSE - サイズを変更しません。
BackColor
Long
Border
Boolean
コントロールの背景色を -2 から 16,777,215 の範囲の数値
で示します。色についての詳細は、
『PowerScript リファレ
ンス』マニュアルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
196
BorderStyle(カ
タログ データ
型)
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
PowerBuilder
第2章
MonthCalendar
プロパティ
BringToTop
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
FaceName
FirstDayOfWeek
FontCharSet
String
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
カレンダの左側に表示する曜日を指定します。
WeekDay(カタ
ログ データ型)
FontCharSet
コントロール内のテキストに使用されるフォント文字
(カタログ デー セットを示します。指定可能な値の一覧については、オブ
タ型)
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
オブジェクトとコントロール
197
MonthCalendar コントロール
MonthCalendar
プロパティ
FontFamily
FontPitch
Height
Italic
データ型
説明
FontFamily
コントロール内のテキストに使用されるフォント ファミ
(カタログ デー リ(タイプ スタイル)を示します。値は以下のとおりです。
タ型)
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
MaxSelectCount
Integer
MonthBackColor
Long
Pointer
String
ScrollRate
Integer
TabOrder
Integer
Tag
TextColor
String
Long
TextSize
Integer
198
ユーザがカレンダから選択できる最大日数を指定します。
デフォルトは 1 です。
月の背景色を -2 から 16,777,215 の範囲の数値で示します。
色についての詳細は、
『PowerScript リファレンス』マニュ
アルの RGB 関数を参照してください。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
ユーザがスクロール ボタンをクリックしたときにカレン
ダがスクロールする月数を指定します。
ウィンドウ内のコントロールのタブ値(順序)を指定しま
す(0 を指定すると、ユーザはコントロールにタブ移動で
きません)。
コントロールに割り当てるタグの値を示します。
月のテキストに使用される色を -2 から 16,777,215 の範囲
の数値で示します。色についての詳細は、
『PowerScript リ
ファレンス』マニュアルの RGB 関数を参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
MonthCalendar
プロパティ
TitleBackColor
データ型
Long
TitleTextColor
Long
TodayCircle
Boolean
説明
カレンダのタイトルの背景色を -2 から 16,777,215 の範囲
の数値で示します。色についての詳細は、
『PowerScript リ
ファレンス』マニュアルの RGB 関数を参照してください。
カレンダのタイトルのテキストに使用される色を -2 から
16,777,215 の範囲の数値で示します。色についての詳細
は、
『PowerScript リファレンス』マニュアルの RGB 関数を
参照してください。
カレンダ上の今日の日付を赤い円で囲んで表示するかど
うかを指定します。値は以下のとおりです。
TRUE - 今日を示す円を表示します。
FALSE - 今日を示す円を表示しません。
TodaySection
Boolean
カレンダの下部に、
「今日 :」というラベルに続けて今日の
日付を表示するかどうかを示します。値は以下のとおりで
す。
TRUE - 今日の日付を表示します。
FALSE - 今日の日付を表示しません。
TrailingTextColor
Long
Underline
Boolean
Visible
Boolean
カレンダの先頭部分と末尾部分の日付に使用される色を
-2 から 16,777,215 の範囲の数値で示します。色についての
詳細は、
『PowerScript リファレンス』マニュアルの RGB 関
数を参照してください。
このプロパティは、MonthCalendar コントロールには適用
されません。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
WeekNumbers
Boolean
その年の第何週であるかを示す数値を、カレンダの各行の
左側に表示するかどうかを指定します。値は以下のとおり
です。
TRUE - 週番号を表示します。
FALSE - 週番号を表示しません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
オブジェクトとコントロール
このプロパティは、MonthCalendar コントロールには適用
されません。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
199
MonthCalendar コントロール
イベント
MonthCalendar イベント
Clicked
Constructor
DateChanged
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
発生する状況
コントロールがマウスの左ボタンでクリックされたとき(選択されたとき)
ウィンドウの Open イベントが発生する直前
日付が選択された直後
ウィンドウの Close イベントが発生した直後
コントロールがマウスの左ボタンで 2 回クリックされたとき
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder イベントではないコントロールのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
関数
MonthCalendar 関数
ClassName
ClearBoldDates
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
Integer
GetDateLimits
Integer
GetDisplayRange
Integer
GetParent
GetSelectedDate
GetSelectedRange
GetToday
PowerObject
Integer
Integer
Date
Hide
Integer
200
説明
コントロールに与えられている名前を返します。
日付の太字設定をすべて解除します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
カレンダに指定された最後の日付と最初の日付を取得し
ます。
表示されている月の日付範囲を取得し、表示されている月
の数を返します。
親オブジェクト名への参照を返します。
選択されている日付を取得します。
選択されている日付の範囲を取得します。
カレンダで今日の日付として使用されている日付を返し
ます。
コントロールを非表示にします。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
MonthCalendar 関数
Move
PointerX
PointerY
PostEvent
戻り値のデータ型
Integer
Integer
Integer
Boolean
Print
Resize
SetBoldDate
SetDateLimits
SetFocus
SetPosition
Integer
Integer
Integer
Integer
Integer
Integer
SetRedraw
Integer
SetSelectedDate
SetSelectedRange
SetToday
Show
TriggerEvent
Integer
Integer
Integer
Integer
Integer
TypeOf
Object
オブジェクトとコントロール
説明
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
指定されたオブジェクトのイベント キューの最後に、指
定されたイベントを追加します。
コントロールを印刷します。
コントロールのサイズを変更します。
指定された日付を太字で表示します。
カレンダの最後の日付と最初の日付を設定します。
コントロールにフォーカスをセットします。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティまたは内容を変更するたびに、
コントロールを自動再描画するかどうかを設定します。
指定された日付を選択します。
選択された日付の範囲を設定します。
カレンダで今日の日付として使用される値を設定します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
201
Edit コントロール
Edit コントロール
MultiLineEdit(マルチライン エディット)コントロールは、複数行に
わたるテキストの入力、編集を行うことのできるテキストボックスで
す。通常、MultiLineEdit コントロールは入力フィールドとして使用し
ます。
プロパティ
MultiLineEdit プロパティ データ型
Accelerator
Integer
AccessibleDescription
String
AccessibleName
String
AccessibleRole
Alignment
AutoHScroll
AccessibleRole
(カタログ デー
タ型)
Alignment
(カタログ デー
タ型)
Boolean
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コードです。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロール内にあるテキストの水平方向の位置の揃え
方を示します。値は以下のとおりです。
Center!
Justify!
Left!
Right!
データの入力や削除が行われたとき、コントロールを自動
的に左右にスクロールするかどうかを示します。値は以下
のとおりです。
TRUE - 自動的にスクロールします。
FALSE - 自動的にスクロールしません。
AutoVScroll
Boolean
データの入力や削除が行われたとき、コントロールを自動
的に上下にスクロールするかどうかを示します。値は以下
のとおりです。
TRUE - 自動的にスクロールします。
FALSE - 自動的にスクロールしません。ラップします。
BackColor
202
Long
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
MultiLineEdit プロパティ データ型
Border
Boolean
説明
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DisplayOnly
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールのテキストを表示専用にし、ユーザが変更で
きないようにするかどうかを示します。値は以下のとおり
です。
TRUE - テキストは表示専用です。ユーザは変更できま
せん。
FALSE - テキストは変更できます。
DragAuto
DragIcon
Boolean
String
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
オブジェクトとコントロール
203
Edit コントロール
MultiLineEdit プロパティ データ型
Enabled
Boolean
説明
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
FaceName
String
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Height
HideSelection
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば Arial や Tahoma など)を示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロールがフォーカスを失っても、選択されたテキス
トをハイライト状態にしておくかどうかを示します。値は
以下のとおりです。
TRUE - テキストのハイライト表示は解除されます。
FALSE - テキストはハイライト表示されたままです。
HScrollBar
Boolean
水平スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - 水平スクロールバーを表示します。
FALSE - 水平スクロールバーを表示しません。
IgnoreDefaultButton
Boolean
ユーザが〔Enter〕を押したときに、ウィンドウのデフォル
ト コマンド ボタンに対する Clicked イベントを起動する
かどうかを示します。値は以下のとおりです。
TRUE - Clicked イベントを起動しません。
MultiLineEdit
コントロールに新しい行を追加します。
FALSE - Clicked イベントを起動します。MultiLineEdit
コントロールに新しい行を追加しません(デフォル
ト)。
204
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
MultiLineEdit プロパティ データ型
ImeMode
Integer
Italic
Boolean
説明
IME(Input Method Editor)のモード設定を示します。この
プロパティは、日本語版 PowerBuilder 上で実行されている
アプリケーションにのみ適用されます。
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Limit
Integer
Pointer
String
RightToLeft
Boolean
コントロールに入力可能な最大の文字数を、0 から 32,767
バイトの範囲で示します(0 を指定すると、文字数は無制
限です)。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
TabOrder
TabStop[ ]
Tag
Text
TextCase
TextColor
ウィンドウ内のコントロールのタブ値(順序)を指定しま
す(0 を指定すると、ユーザはコントロールにタブ移動で
きません)。
Integer
コントロール内のタブストップの位置を示します。タブ
ストップは文字位置で指定します。タブ ストップの区切
り記号はスペースです。TabStop[1](最初のタブ ストップ)
だけに値を割り当てると、最初のタブ ストップに指定さ
れた文字位置の数だけ間隔を空けて各タブ ストップが均
等に配置されます。2 つ以上のタブ ストップを指定する
と、各タブ ストップは指定された位置に配置されます。コ
ントロールの中に 16 個までのタブ ストップを定義できま
す。デフォルトの配列は TabStop[8] で、各タブ ストップ
は 8 文字ごとに配置されます。
String
コントロールに割り当てるタグの値を示します。
String
コントロールに表示されるテキストを指定します。
TextCase(カタ 入力された英文テキストを大文字と小文字のどちらで表
ログ データ型) 示するかを示します。値は以下のとおりです。
AnyCase!
Lower!
Upper!
Long
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。色についての詳細は、
『PowerScript リファ
レンス』マニュアルの RGB 関数を参照してください。
Integer
オブジェクトとコントロール
205
Edit コントロール
MultiLineEdit プロパティ データ型
TextSize
Integer
Underline
Boolean
説明
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
VScrollBar
Boolean
コントロールの右端に垂直スクロールバーを表示するか
どうかを示します。値は以下のとおりです。
TRUE - 垂直スクロールバーを表示します。
FALSE - 垂直スクロールバーを表示しません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
MultiLineEdit イベント
Constructor
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
206
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder
第2章
MultiLineEdit イベント
Modified
Other
RButtonDown
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
発生する状況
コントロールが変更されてからフォーカスを失うとき
PowerBuilder イベントではないコントロールのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
関数
MultiLineEdit 関数
CanUndo
戻り値のデータ型
Boolean
ClassName
Clear
String
Integer
Copy
Integer
Cut
Integer
Drag
GetContextService
Integer
Integer
GetParent
Hide
LineCount
LineLength
Move
Paste
PowerObject
Integer
Integer
Integer
Integer
Integer
PointerX
PointerY
Position
PostEvent
Integer
Integer
Integer
Boolean
Print
Integer
オブジェクトとコントロール
説明
コントロールで最後に行った編集を、Undo 関数によって
元に戻すことができる場合に TRUE を返します。そうでな
い場合は FALSE を返します。
コントロールに与えられている名前を返します。
選択されたテキスト(選択されたものがあれば)をコント
ロールから削除します(テキストはクリップボードにコ
ピーされません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールからクリップボードにコピーします(ただし、削除
はしません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールから切り取り(削除し)、クリップボードにコピー
します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
MultiLineEdit 上の行の数を返します。
挿入ポイントが位置している行の長さを返します。
指定された位置にコントロールを移動します。
コントロール内の挿入ポイントの位置に、クリップボード
の内容を挿入します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロール内の挿入ポイントの位置を返します。
指定されたオブジェクトのイベント キューの最後に指定
したイベントを追加します。
コントロールを印刷します。
207
Edit コントロール
MultiLineEdit 関数
ReplaceText
戻り値のデータ型
Integer
Resize
Scroll
Integer
Integer
SelectedLength
Integer
SelectedLine
Integer
SelectedStart
Integer
SelectedText
String
SelectText
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
TextLine
Integer
String
TriggerEvent
Integer
TypeOf
Undo
Object
Integer
208
説明
コントロール内で選択されたテキストを指定された文字
列と置き換えます。テキストが選択されていない場合は、
その文字列を挿入ポイントの位置に挿入します。
コントロールのサイズを変更します。
コントロールの内容を指定された行数分だけ上下にスク
ロールします。
コントロール内で選択されているテキストの長さを返し
ます。
コントロール上で挿入ポイントが位置している行の行番
号を返します。
コントロール内で選択されているテキストの開始位置を
返します。
コントロール内で選択されているテキストの文字列を返
します。
開始位置と長さで指定されたコントロールのテキストを
選択します。
コントロールにフォーカスをセットします。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
挿入ポイントが現在位置している行のテキスト全体を返
します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
コントロールで最後に行った編集内容を元に戻します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
OLEControl コントロール
ウィンドウに配置された OLEControl には、スプレッドシートやワープロ
文書などの、OLE 対応アプリケーションで作成されたオブジェクトを
保持できます。PowerBuilder アプリケーションのユーザは、OLEControl
コントロール上のオブジェクトを起動して、そのオブジェクトが作成
されたアプリケーション(OLE サーバ アプリケーション)上で編集作
業を行うことができます。
OLE コントロールは、オブジェクト ブラウザの[OLE]タブで[挿入
可能なオブジェクト]をダブルクリックすると表示されます。
アプリケーションにおける OLE の使い方についての詳細は、『アプリ
ケーション テクニック』マニュアルを参照してください。
プロパティ
OLEControl プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
Activation
AccessibleRole(カ
タログ データ型)
omActivation
BackColor
Long
BinaryIndex
BinaryKey
Border
Integer
String
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのア
クセシビリティ ツールで使用する場合に、コントロー
ルやその目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロー
ルを簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要
素であるかを説明します。
OLE オブジェクトがアクティブ化される方法を示し
ます。
背景色を -2 から 16,777,215 の範囲の数値で示します。
色についての詳細は、
『PowerScript リファレンス』マ
ニュアルの RGB 関数を参照してください。
内部使用のみ
内部使用のみ
コントロールに枠線を付けるかどうかを示します。値
は以下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
オブジェクトとコントロール
209
OLEControl コントロール
OLEControl プロパティ
BorderStyle
データ型
BorderStyle(カタ
ログ データ型)
説明
コントロールの枠線のスタイルを示します。値は以下
のとおりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
BringToTop
Boolean
コントロールをウィンドウの最前面に移動するかどう
かを示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
ClassLongName
ClassShortName
ContentsAllowed
DisplayName
DisplayType
DocFileName
210
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
String
(読み出し専用)コントロールの OLE オブジェクトに
関連付けられたサーバ アプリケーション名(長い名
前)。
String
(読み出し専用)コントロールの OLE オブジェクトに
関連付けられたサーバ アプリケーション名(短い名
前)。
omContentsAllowed 実行時に Insert 関数が呼ばれるとき、コントロールの
OLE オブジェクトが埋め込まれるか、リンクされる
か、双方が可能か、いずれかの形式を示します。
String
OLE コントロールがインプレースでアクティブ化さ
れるときの、ユーザに対する表示名を示します。この
名前は、オブジェクト名を表示する OLE ダイアログ
ボックスとウィンドウに表示されます。この値を指定
など)が
しない場合は、コントロール名(ole_1
DisplayName プロパティの値として使用されます。
omDisplayType
OLE オブジェクトがコントロールに表示される方法
を示します。コントロールは実際の内容か、そのオブ
ジェクトを表すアイコンによって表示されます。また
は、文書が ActiveX ドキュメントとして表示されます。
String
(読み出し専用)OLE オブジェクトを格納している
ファイルの名前。オブジェクトがファイルにまだ保存
されていない場合は、このプロパティの値は空文字列
(" ")となります。
PowerObject
PowerBuilder
第2章
OLEControl プロパティ
DragAuto
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
コントロールを自動的にドラッグ モードにするかど
うかを示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的に
ドラッグ モードになります。
FALSE - コントロールをクリックしても、自動的に
はドラッグ モードになりません。この場合、Drag 関
DragIcon
Enabled
String
Boolean
数を使用して、コントロールを手動でドラッグ モー
ドにする必要があります。
コントロールをドラッグしているときに表示する組み
込みアイコン名、またはアイコン ファイル(ICO ファ
イル)の名前を示します。デフォルトのアイコンは、
コントロールの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)
上にドラッグされると、指定したアイコンが表示され
ます。コントロールが有効ドロップ領域外にあるとき
には、ドロップ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示し
ます。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
FocusRectangle
Boolean
コントロールがフォーカスを持っているときに、コン
トロールを破線の長方形(フォーカスを表す長方形)
で囲むかどうかを示します。値は以下のとおりです。
TRUE - コントロールにフォーカスがあるときに、
破線の長方形で囲みます。
FALSE - コントロールにフォーカスがあるときに、
Height
Integer
IsDragTarget
Boolean
破線の長方形で囲みません。
コントロールの高さを PowerBuilder 単位系で示しま
す。
OLE オブジェクトをコントロール上にドロップでき
るかどうかを示します。値は以下のとおりです。
TRUE - OLE オブジェクトをコントロール上にド
ロップできます。
FALSE - OLE オブジェクトをコントロール上にド
LinkItem
String
オブジェクトとコントロール
ロップできません。
(読み出し専用)オブジェクトにリンクされている項目
の 完 全 な リ ン ク 名。た と え ば、オ ブ ジ ェ ク ト が
C:\FILENAME.XLS!A1:B2 にリンクされている場合、
LinkItem プロパティは C:\FILENAME.XLS!A1:B2 とな
ります。
211
OLEControl コントロール
OLEControl プロパティ
LinkUpdateOptions
データ型
omLinkUpdate
Options
Object
omObject
ObjectData
Blob
ParentStorage
Pointer
omStorage
String
Resizable
Boolean
説明
コントロール内のリンクされたオブジェクトを更新す
る方法を示します。Automatic のときは、オブジェクト
が開かれ、サーバ アプリケーションでオブジェクトが
変更されるとリンクが常に更新されます。Manual のと
きは、リンクは更新されません。
コントロール内にリンクされたり埋め込まれた OLE
オブジェクトに、サーバ コマンドを与えるスクリプト
で使用されます。
オブジェクトが埋め込まれている場合、オブジェクト
自体が Blob データとして ObjectData プロパティに格
納されます。
オブジェクトがリンクされている場合は、このプロパ
ティはリンク情報とキャッシュ イメージ(表示用)を
示します。
(読み出し専用)親ストレージを示します。
コントロールで使用するポインタを、組み込みポイン
タ名か、マウス ポインタを含むファイル名で示しま
す。
コントロールのサイズが変更できるかどうかを示しま
す。値は以下のとおりです。
TRUE - コントロールのサイズを変更できます。
FALSE - コントロールのサイズを変更できません。
SizeMode
SizeMode
(カタログ データ
型)
TabOrder
Integer
Tag
Visible
String
Boolean
OLE ドキュメントのサイズ モードを示します。指定で
きる方法は次のとおりです。
Clip! - オブジェクトのイメージは原型のサイズで
表示されます。OLE コントロールよりも大きい場合
は、コントロールの枠線からはみ出た部分が切り捨
てられます。
Stretch! - オブジェクトのイメージは、OLE コンテ
ナ コントロールに収まるようにサイズが調整され
ます。これがデフォルト値です。
コントロールのタブ値(順序)を配置されているウィ
ンドウに対して示します(0 を指定すると、そのコン
トロールにタブ移動できません)。
コントロールに割り当てるタグの値を示します。
コントロールが表示可能かどうかを示します。値は以
下のとおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
212
Integer
コントロールの幅を PowerBuilder 単位系で示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
OLEControl プロパティ
X
データ型
Integer
Y
Integer
説明
X 位置(ウィンドウの左端からの距離)を PowerBuilder
単位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder
単位系で指定します。
イベント
OLEControl イベント
Clicked
Close
Constructor
DataChange
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
Error
ExternalException
GetFocus
Help
LoseFocus
Other
PropertyChanged
PropertyRequestEdit
RButtonDown
Rename
発生する状況
コントロールがクリックされたとき(選択または選択解除されたとき)
ウィンドウが画面から破棄される直前(閉じられる直前)
ウィンドウの Open イベントが発生する直前
データが変更したことを、サーバ アプリケーションがコントロールに通知
するとき
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されてアクティブ状態にな
るとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
OLE オートメーションの実行中にエラーが発生するとき
OLE オートメーションで、OLE サーバがコマンド実行(プロパティの取得
や設定、関数呼び出し)中に例外を生成するとき
コントロールがフォーカスを受ける直前(コントロールが選択されて、アク
ティブ状態になる前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?]
)
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder イベントではない運用環境のメッセージが発生したとき
通知をサポートする OLE サーバが PropertyChanged メッセージをコント
ロールに送信するとき
通知をサポートする OLE サーバが PropertyRequestEdit メッセージをコント
ロールに送信するとき
コントロール上でマウスの右ボタンがクリックされたとき
サーバ アプリケーションが、コントロールにオブジェクトの名前が変更さ
れたことを通知するとき
オブジェクトとコントロール
213
OLEControl コントロール
OLEControl イベント
Save
SaveObject
ViewChange
発生する状況
サーバ アプリケーションが、コントロールにデータが保存されたことを通
知するとき
サーバ アプリケーションが、コントロール内のオブジェクトを保存したと
き
サーバ アプリケーションが、ユーザに対する表示が変更されたことを、コ
ントロールに通知するとき
関数
OLEControl 関数
Activate
戻り値のデータ型
Integer
ClassName
Clear
String
Integer
Copy
Cut
Integer
Integer
DoVerb
Drag
GetContextService
Integer
Integer
Integer
GetData
Integer
GetNativePointer
GetParent
Hide
InsertClass
Integer
PowerObject
Integer
Integer
InsertFile
Integer
InsertObject
Integer
LinkTo
Integer
Move
Integer
214
説明
OLE オブジェクトを、インプレースまたはオフサイトの
どちらかでアクティブにします。
コントロールに与えられている名前を返します。
OLE オブジェクトを解放し、ストレージを更新せずに
OLE オブジェクトへの参照を削除します。
コントロールの内容をクリップボードにコピーします。
コントロールの内容をクリップボードにコピーして、コン
トロールをクリアします。
指定したバーブを実行します。
オブジェクトをドラッグ モードにします。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
統一データ転送をサポートする OLE サーバから、呼び出
し側が指定したフォーマットでデータを返します。
基底の OLE オブジェクトへのポインタを取得します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
OLE クラス名を指定して、新しいオブジェクトを挿入し
ます。
ファイル名を指定して、新しいオブジェクトを挿入しま
す。
ユーザにオブジェクトの挿入 ダイアログボックスを表示
し、ユーザの選択に基づいてオブジェクトを挿入します。
ファイルとファイル内の項目(オプション)をリンクしま
す。
指定された位置にコントロールを移動します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
OLEControl 関数
Open
戻り値のデータ型
Integer
Paste
PasteLink
Integer
Integer
PasteSpecial
Integer
PointerX
PointerY
PostEvent
Integer
Integer
Boolean
Print
ReleaseNativePointer
Resize
Save
Integer
Integer
Integer
Integer
SaveAs
Integer
SelectObject
Integer
SetData
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
UpdateLinksDialog
Object
Integer
オブジェクトとコントロール
説明
OLE ドキュメント ファイルを開いて、オブジェクトをコ
ントロールにロードするか、またはその前に開かれていた
ストレージ内のサブストレージを開いて、オブジェクトを
ロードします。
クリップボードの内容をコントロールに貼り付けます。
クリップボードの内容に対するリンクを OLE コントロー
ルに貼り付けます。
ユーザに形式を選択して貼り付け ダイアログボックスを
表示し、
[貼り付け]または[リンク貼り付け]が選択で
きるようにします。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
基底の OLE オブジェクトへのポインタを解放します。
コントロールのサイズを変更します。
ストレージからロードされていたオブジェクトを保存し
ます。
コントロールに保持されているオブジェクトを、要求され
たストレージのメンバーとして、またはストレージのファ
イルに保存します。
コントロールの選択 / 選択解除を設定します(メニューの
内容が更新されます)。
統一データ転送をサポートする OLE サーバに、呼び出し
側の指定するフォーマットでデータを送信します。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
コントロールのイベントを起動し、そのイベントに関連付
けられたスクリプトを実行します。
コントロールのデータ型を返します。
リンクされたファイルが見つからないとき、リンク情報を
更新するために OLE ダイアログボックスを起動します。
215
OLECustomControl コントロール(OCX)
OLECustomControl コントロール(OCX)
PowerBuilder の OLECustomControl クラスは、OLE カスタム コントロー
ルのコンテナで ActiveX コントロール、もしくは OCX とも呼ばれま
す。PowerBuilder で OLE カスタム コントロール コンテナを作成する
には、オブジェクトの挿入 ダイアログボックス上でそのコンテナに挿
入するカスタム コントロールを指定します。ダイアログボックスで
は、システム レジストリに登録済みのコントロールのリストが表示さ
れます。そのリストから OLE カスタム コントロールを選択します。希
望するコントロールをインストール時に登録しなかった場合は、オブ
ジェクトの挿入 ダイアログボックスを使用してレジストリに新たに
登録することができます。
登録済みのコントロールはオブジェクト ブラウザでも表示すること
ができます。オブジェクト ブラウザの[OLE]タブを選択し、[OLE
カスタム コントロール]をダブルクリックしてください。
プロパティ
OLE の用語では、フォント情報と表示名をアンビエント プロパティ
(ambient property)と呼んでいます。アンビエント プロパティは カス
タム コントロールが使用するデフォルト情報を提供します。OCX がア
ンビエント プロパティを認識するようにプログラミングされていれ
ば、このデフォルト情報が使用されます。
PowerBuilder は、コントロールに対するテキストを表示しないので、
フォントと表示名を直接使用することはありません。コントロールが
アンビエント プロパティを認識するようにプログラミングされてい
る場合、コントロールは PowerBuilder の提供する値を使って、テキス
トを表示したり、タイトル バーに名前を表示することができます。
OLECustomControl
プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
216
AccessibleRole
(カタログ デー
タ型)
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
PowerBuilder
第2章
OLECustomControl
プロパティ
Alignment
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Alignment
(カタログ デー
タ型)
BackColor
Long
BinaryIndex
BinaryKey
Border
Integer
String
Boolean
説明
コントロール内にあるテキストの水平方向の位置の揃え
方を示します。値は以下のとおりです。
Center!
Justify!
Left!
Right!
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
内部使用のみ
内部使用のみ
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
Cancel
Boolean
ボタン スタイルの OLE コントロールがキャンセル ボタ
ンとして機能するかどうかを示します(Cancel プロパティ
が TRUE のとき、ユーザが〔Esc〕を押すと、そのコント
ロールが Clicked イベントを受け取ります)。値は以下のと
おりです。
TRUE - コントロールはキャンセルボタンとして機能
します。
FALSE - コントロールはキャンセルボタンとして機能
ClassDefinition
PowerObject
ClassLongName
String
ClassShortName
String
オブジェクトとコントロール
しません。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
(読み出し専用)コントロールの OLE オブジェクトに関連
付けられたサーバ アプリケーション名(長い名前)
。
(読み出し専用)コントロールの OLE オブジェクトに関連
付けられたサーバ アプリケーション名(短い名前)。
217
OLECustomControl コントロール(OCX)
OLECustomControl
プロパティ
DisplayName
データ型
String
Default
Boolean
説明
OLE コントロールがユーザに対して表示する名前を示し
ます。この名前は、オブジェクト名を表示する OLE ダイア
ログボックスとウィンドウに表示されます。この値を指定
しない場合は、コントロール名(ole_1 など)が DisplayName
プロパティの値として使用されます。
ボタン スタイルの OLE コントロールがデフォルト コン
トロールかどうかを示します(デフォルト コントロール
は太い枠線で囲まれ、ユーザがコントロールを特に選択せ
ずに〔Enter〕を押したときに、そのコントロールが Clicked
イベントを受け取ります)。
このプロパティはコマンド ボタンのように機能するコン
トロールに適用されます。
値は以下のとおりです。
DragAuto
DragIcon
Enabled
Boolean
String
Boolean
TRUE - コントロールはデフォルト コントロールとし
て機能します。
FALSE - コントロールはデフォルト コントロールとし
て機能しません。
編集可能なコントロール デフォルトの動作はウィンドウ
上の編集可能なコントロールの影響を受けることがあり
ます。詳細については、PowerBuilder の『ユーザーズ ガイ
ド』マニュアルを参照してください。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
218
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
OLECustomControl
プロパティ
FaceName
データ型
String
FocusRectangle
Boolean
説明
コントロールがテキストに使用する字体名(たとえば
ARIAL)を示します(コントロールがこのアンビエント
プロパティを使用するように設計されている場合に適用
されます)。
コントロールがフォーカスを持っているときに、コント
ロールを破線の長方形(フォーカスを表す長方形)で囲む
かどうかを示します。値は以下のとおりです。
TRUE - コントロールにフォーカスがあるときに、
破線
の長方形で囲みます。
FALSE - コントロールにフォーカスがあるときに、破
FontCharSet
FontFamily
FontPitch
Height
IsDragTarget
線の長方形で囲みません。
コントロールがテキストに使用するフォント文字セット
を示します(コントロールがこのアンビエント プロパ
ティを使用するように設計されている場合に適用されま
す)。指定可能な値の一覧については、オブジェクト ブラ
ウザの[カタログデータ型]タブにある FrontCharSet 変数
リストを参照してください。
FontFamily(カ コントロールがテキストに使用するフォント ファミリ
タログ データ (タイプ スタイル)を示します(コントロールがこのアン
型)
ビエント プロパティを使用するように設計されている場
合に適用されます)。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontCharSet
(カタログ デー
タ型)
FontPitch(カタ コントロールがテキストに使用するピッチ(間隔)を示し
ログ データ型) ます(コントロールがこのアンビエント プロパティを使
用するように設計されている場合に適用されます)。値は
以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
データをコントロール上にドロップできるかどうかを示
します。値は以下のとおりです。
TRUE - コントロール上にデータをドロップできます。
FALSE - コントロール上にデータをドロップできませ
ん。
オブジェクトとコントロール
219
OLECustomControl コントロール(OCX)
OLECustomControl
プロパティ
Italic
データ型
Boolean
説明
コントロールでテキストが斜体で表示されるように示し
ます(コントロールがこのアンビエント プロパティを使
用するように設計されている場合に適用されます)。値は
以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Object
omObject
Pointer
String
TabOrder
Integer
Tag
TextColor
String
Long
TextSize
Integer
Underline
Boolean
コントロールをサーバのデータに接続するリンク情報を
示します。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
コントロールのタブ値(順序)を配置されているウィンド
ウに対して示します(0 を指定すると、そのコントロール
にタブ移動できません)。
コントロールに割り当てるタグの値を示します。
コントロールがテキストに使用する色を指定します(コン
トロールがこのアンビエント プロパティを使用するよう
に設計されている場合に適用されます)。この色は、-2 か
ら 16,777,215 の範囲の数値です。色についての詳細は、
『PowerScript リファレンス』マニュアルの RGB 関数を参照
してください。
コントロールがテキストの表示に使用するポイント サイ
ズを示します(コントロールがこのアンビエント プロパ
ティを使用するように設計されている場合に適用されま
す)。以前のバージョンとの互換性を保つため、サイズは
負の値で扱われます。たとえば 10 ポイントのテキスト サ
イズは -10 として保存されます。
コントロールでテキストに下線が引かれるように設定し
ます(コントロールがこのアンビエント プロパティを使
用するように設計されている場合に適用されます)。値は
以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
Integer
220
コントロール内のテキストの太さを示します(コントロー
ルがこのアンビエント プロパティを使用するように設計
されている場合に適用されます)。たとえば、400 は通常
の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
OLECustomControl
プロパティ
X
データ型
Integer
Y
Integer
説明
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
PowerBuilder のスクリプト ペインタは、PowerBuilder のイベントのほ
か、OLE コントロールに挿入されたコントロールに定義されているイ
ベントも表示します。
以下のリストにないイベントについては、コントロールのマニュアル
を参照してください。
OLECustomControl
イベント
Clicked
Constructor
DataChange
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
Error
ExternalException
GetFocus
Help
LoseFocus
Other
PropertyChanged
発生する状況
コントロールがクリックされたとき(選択または選択解除されたとき)
ウィンドウの Open イベントが発生する直前
データが変更したことを、サーバ アプリケーションがコントロールに通知
するとき
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されてアクティブ状態にな
るとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
OLE オートメーションの実行中にエラーが発生するとき
OLE オートメーションで、OLE サーバがコマンド実行(プロパティの取得
や設定、関数呼び出し)中に例外を生成するとき
コントロールがフォーカスを受ける直前(コントロールが選択されて、アク
ティブ状態になる前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?]
)
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder イベントではない運用環境のメッセージが発生したとき
通知をサポートする OLE サーバが PropertyChanged メッセージを送信する
とき
オブジェクトとコントロール
221
OLECustomControl コントロール(OCX)
OLECustomControl
イベント
PropertyRequestEdit
RButtonDown
発生する状況
通知をサポートする OLE サーバが PropertyRequestEdit メッセージを送信す
るとき
コントロール上でマウスの右ボタンがクリックされたとき
関数
OLECustomControl
関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetData
Integer
GetNativePointer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
Integer
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
ReleaseNativePointer
Resize
SetData
Integer
Integer
Integer
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
222
説明
コントロールに与えられている名前を返します。
オブジェクトをドラッグ モードにします。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
統一データ転送をサポートする OLE サーバから、呼び出
し側が指定したフォーマットでデータを返します。
基底の OLE オブジェクトへのポインタを取得します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
基底の OLE オブジェクトへのポインタを解放します。
コントロールのサイズを変更します。
統一データ転送をサポートする OLE サーバに、呼び出し
側の指定するフォーマットでデータを送信します。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティまたは内容を変更するたびに、
コントロールを自動再描画するかどうかを設定します。
コントロールを表示します。
コントロールのイベントを起動し、そのイベントに関連付
けられたスクリプトを実行します。
コントロールのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
OLEObject オブジェクト
OLEObject オブジェクトは、リモート OLE オブジェクトのプロキシ オ
ブジェクトとして機能します。
また、組み込みの OLEObject を継承した標準クラス ユーザ オブジェク
トを定義することによって、OLEObject をカスタマイズしたユーザ オ
ブジェクトを独自に作成することもできます。この OLEObject の
Constructor、Destructor、Error、ExternalException イベントにアクセス
するには、該当するイベントにスクリプトを記述します。
Error イベントと ExternalException イベントのコード記述
Error イベントおよび ExternalException イベントのコードを記述する
と、RuntimeError のすべてのアクティブな例外ハンドラが処理されな
くなります。ただし、これらのイベントのスクリプトの中で例外を送
出することはできます。これらのイベントの引数を例外ハンドラに渡
すには、引数を文字列に格納し、送出処理の中でこれを例外ハンドラ
に渡します。
OLEObject オブジェクトはオブジェクト ブラウザの[OLE]タブに挿
入可能なオブジェクトとして表示されます。
OLEObject オブジェクトを基にユーザ オブジェクトを作成する方法
は、PowerBuilder の『ユーザーズ ガイド』マニュアルのユーザ オブ
ジェクトの章を参照してください。
アプリケーションでの OLEObject オブジェクトの使用方法について
は、
『アプリケーション テクニック』マニュアルを参照してください。
OLEObject は動的なオブジェクト
OLE をサポートするため、OLEObject は動的なオブジェクトとなって
います。つまり、PowerBuilder は、コンパイル時には OLEObject に対
してどのようなプロパティ名、関数名、パラメータ リストも受け入れ
ます。実行時にプロパティまたは関数が存在しない場合は、実行時エ
ラーがユーザに返されます。
オブジェクトとコントロール
223
OLEObject オブジェクト
プロパティ
OLEObject プロパティ
ClassDefinition
データ型
PowerObject
Handle
Objhandle
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
内部使用のみ
イベント
OLEObject イベント
Constructor
Destructor
Error
ExternalException
発生する状況
ユーザ オブジェクトが作成されるとき
ユーザ オブジェクトが破棄されるとき
外部オブジェクトのデータ式またはプロパティ式にエラーがあるとき
外部オブジェクトのプロパティを含む式に形式上のエラーがあるとき。この
種類のイベントは Error イベントの前に発生します。
関数
OLEObject 関数
ClassName
戻り値のデータ型
String
ConnectToNewObject
Integer
ConnectToNewRemoteObject
Integer
ConnectToObject
Integer
ConnectToRemoteObject
Integer
DisconnectObject
Integer
GetAutomationNativePointer
Integer
GetContextService
Integer
224
説明
ユーザ オブジェクトに与えられた名前を返しま
す。
そのクラスの新しいインスタンスを作成し、接続
します。
指定されたリモート サーバ アプリケーションで
新しい OLE オブジェクトを作成し、そのオブ
ジェクトを PowerBuilder OLEObject 変数に関連
付けます。
指定したファイルを開き、対応するサーバ アプ
リケーションに接続します。
OLE オブジェクトを PowerBuilder の OLEObject
変数と関連付けてサーバ アプリケーションを起
動します。
すでに接続されていたすべてのオブジェクトを
解放します。
基底の OLE オブジェクトへのポインタを取得し
ます。
指定されたサービスのコンテキストに固有のイ
ンスタンスへの参照を作成します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
OLEObject 関数
GetParent
IsAlive
戻り値のデータ型
PowerObject
Boolean
PostEvent
Boolean
ReleaseAutomationNativePointer
Integer
SetAutomationLocale
Integer
SetAutomationPointer
Integer
SetAutomationTimeout
Integer
TriggerEvent
Integer
TypeOf
Object
説明
親オブジェクト名への参照を返します。
サーバ オブジェクトが存在するかどうかを示し
ます。
ユーザ オブジェクトのメッセージ キューの最後
にイベントを追加します。
基底の OLE オブジェクトへのポインタを解放し
ます。
オブジェクトのオートメーション プログラミン
グに使用する言語のロケールを指定します。
OLEObject オブジェクトのオートメーション ポ
インタを、別のオブジェクトのオートメーション
ポインタの値に設定します。
PowerBuilder クライアントがサーバの OLE プロ
シージャを呼び出すとき、呼び出しをキャンセル
するまでの待ち時間をミリ秒単位で設定します。
ユーザ オブジェクトにイベントを送り、そのイ
ベントに関連付けられたスクリプトを実行しま
す。
ユーザ オブジェクトのデータ型を返します。
OLEStorage オブジェクト
OLEStorage オブジェクトは、開かれている OLE ストレージに対する
プロキシ オブジェクトとして機能します。
組み込みの OLEStorage オブジェクトを継承したクラス ユーザ オブ
ジェクトを定義することによって、OLEStorage システム オブジェクト
を基にしたユーザ オブジェクトを作成することができます。
OLEStorage オブジェクトを基にユーザ オブジェクトを作成する方法
は、PowerBuilder の『ユーザーズ ガイド』マニュアルのユーザ オブ
ジェクトの章を参照してください。
アプリケーションでの OLEStorage オブジェクトの使用方法について
は、
『アプリケーション テクニック』マニュアルを参照してください。
オブジェクトとコントロール
225
OLEStorage オブジェクト
プロパティ
OLEStorage プロパティ
ClassDefinition
データ型
PowerObject
DocumentName
String
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
現在開いているストレージの名前を示します。ルート レ
ベルのストレージの場合は、ストレージを含むファイル名
です。サブストレージの場合は、サブストレージのメン
バー名です。
イベント
OLEStorage イベント
Constructor
Destructor
発生する状況
ユーザ オブジェクトが作成されるとき
ユーザ オブジェクトが破棄されるとき
関数
OLEStorage 関数
ClassName
Clear
Close
戻り値のデータ型
String
Integer
Integer
GetContextService
Integer
GetParent
MemberDelete
MemberExists
MemberRename
Open
PowerObject
Integer
Integer
Integer
Integer
PostEvent
Boolean
Save
Integer
226
説明
ユーザ オブジェクトに与えられた名前を返します。
その前に開かれていたすべてのストレージを解放します。
ストレージと、そのストレージ上で開かれているコント
ロールとストリームを保存し、変更をコミットした後、ス
トレージを解放します(Save 関数を呼び出し、次に Clear
関数を呼び出すのと同じです)。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
指定されたメンバーを削除します。
指定されたメンバーが存在するかどうかを調べます。
指定されたメンバーの名前を変更します。
ファイルをストレージとして開くか、または指定されたス
トレージ オブジェクトからサブストレージを開きます。
ユーザ オブジェクトのメッセージ キューの最後にイベン
トを追加します。
ストレージとそのストレージに開かれているすべてのコ
ントロールを保存し、変更をコミットします。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
OLEStorage 関数
SaveAs
戻り値のデータ型
Integer
TriggerEvent
Integer
TypeOf
Object
説明
ストレージとそのストレージに開かれているすべてのコ
ントロールを新しいファイルまたは新しいサブストレー
ジに保存し、変更をコミットした後、オリジナルのスト
レージを解放します。
ユーザ オブジェクトにイベントを送り、そのイベントに
関連付けられたスクリプトを実行します。
ユーザ オブジェクトのデータ型を返します。
OLEStream オブジェクト
OLEStream オブジェクトは、OLE ストリームに対するプロキシ オブ
ジェクトとして機能します。
組み込みの OLEStream オブジェクトを継承したクラス ユーザ オブ
ジェクトを定義することによって、OLEStream システム オブジェクト
を基にしたユーザ オブジェクトを作成することができます。
OLEStream オブジェクトを基にユーザ オブジェクトを作成する方法
は、PowerBuilder の『ユーザーズ ガイド』マニュアルのユーザ オブ
ジェクトの章を参照してください。
アプリケーションでの OLEStream オブジェクトの使用方法について
は、
『アプリケーション テクニック』マニュアルを参照してください。
プロパティ
OLEStream プロパティ
ClassDefinition
データ型
PowerObject
Name
String
Storage
OMStorage
オブジェクトとコントロール
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
ストリームの親ストレージ内におけるメンバー名を示し
ます。
(読み出し専用)そのストリームが格納されるストレージ
を示します。ストリームは常に OLEStorage オブジェクト
の中から開かれます。
227
OLETxnObject オブジェクト
イベント
OLEStream イベント
Constructor
Destructor
発生する状況
ユーザ オブジェクトが作成されるとき
ユーザ オブジェクトが破棄されるとき
関数
OLEStream 関数
ClassName
Close
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Length
Open
PostEvent
PowerObject
Integer
Integer
Boolean
Read
Seek
TriggerEvent
Integer
Integer
Integer
TypeOf
Write
Object
Long
説明
ユーザ オブジェクトに与えられた名前を返します。
その前に開かれていたすべてのストリームを解放します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
開いているストリームの長さを返します。
指定されたストリームをストレージから開きます。
ユーザ オブジェクトのメッセージ キューの最後にイベン
トを追加します。
ストリームを読み込みます。
ストリームのポインタの位置を移動します。
ユーザ オブジェクトにイベントを送り、そのイベントに
関連付けられたスクリプトを実行します。
ユーザ オブジェクトのデータ型を返します。
ストリームに書き込みます。
OLETxnObject オブジェクト
OLETxnObject オブジェクトは、MTS トランザクションの明示的な制
御(SetComplete 関数と SetAbort 関数を使用)を PowerBuilder クライア
ントに提供します。OLETxnObject は、OLEObject オブジェクトから継
承されます。
228
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
OLETxnObject
プロパティ
ClassDefinition
データ型
PowerObject
Handle
Objhandle
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
内部使用のみ
イベント
OLETxnObject イベント
Constructor
Destructor
Error
ExternalException
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
外部オブジェクトのデータ式またはプロパティ式にエラーがあるとき
外部オブジェクトのプロパティを含む式に形式上のエラーがあるとき。この
種類のイベントは Error イベントの前に発生します。
関数
OLETxnObject 関数
ClassName
ConnectToNewObject
戻り値のデータ型
String
Integer
ConnectToNewRemoteObject
ConnectToObject
ConnectToRemoteObject
DisconnectObject
Integer
Integer
Integer
Integer
GetAutomationNativePointer
Integer
GetContextService
Integer
GetParent
IsAlive
PowerObject
Boolean
PostEvent
Boolean
オブジェクトとコントロール
説明
ユーザ オブジェクトに与えられた名前を返します。
関連するトランザクション コンテキスト内のクラ
スの新しいインスタンスを作成し、接続します。
使用されません。
使用されません。
使用されません。
すでに接続されていたすべてのオブジェクトを解
放します。
基底の OLE オブジェクトへのポインタを取得しま
す。
指定されたサービスのコンテキストに固有のイン
スタンスへの参照を作成します。
親オブジェクト名への参照を返します。
サーバ オブジェクトが存在するかどうかを示しま
す。
ユーザ オブジェクトのメッセージ キューの最後に
イベントを追加します。
229
Oval コントロール
OLETxnObject 関数
ReleaseAutomationNativePointer
戻り値のデータ型
Integer
SetAbort
SetAutomationLocale
Integer
Integer
SetAutomationPointer
Integer
SetAutomationTimeout
Integer
SetComplete
Integer
TriggerEvent
Integer
TypeOf
Object
説明
基底の OLE オブジェクトへのポインタを解放しま
す。
現行トランザクションを中断します。
オブジェクトのオートメーション プログラミング
に使用する言語のロケールを指定します。
OLETxnObject オブジェクトのオートメーション
ポインタを別のオブジェクトのオートメーション
ポインタの値に設定します。
PowerBuilder クライアントがサーバの OLE プロ
シージャを呼び出すとき、呼び出しをキャンセル
するまでの待ち時間をミリ秒単位で設定します。
現行トランザクションのコミットを試みます。
ユーザ オブジェクトにイベントを送り、そのイベ
ントに関連付けられたスクリプトを実行します。
ユーザ オブジェクトのデータ型を返します。
Oval コントロール
Oval(楕円)コントロールは、アウトラインもしくは塗りつぶされた
円形や楕円形を表す描画オブジェクトで、通常はデザイン上の効果を
与えるために使用します(たとえば、CommandButton や Picture コント
ロールを Oval コントロールで囲みます)。複数のコントロールを Oval
で囲んで表示上グループ化 しても、各コントロールの動作に影響はあ
りません。
プロパティ
Oval プロパティ
ClassDefinition
データ型
PowerObject
FillColor
Long
230
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを塗りつぶす色を -2 から 16,777,215 の範囲
の数値で示します。色についての詳細は、
『PowerScript リ
ファレンス』マニュアルの RGB 関数を参照してください。
PowerBuilder
第2章
Oval プロパティ
FillPattern
Height
LineColor
LineStyle
LineThickness
Tag
Visible
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
説明
FillPattern(カタ コントロールを塗りつぶすために使用するハッチ パター
ログ データ型) ンを示します。値は以下のとおりです。
BDiagonal!
Diamond!
FDiagonal!
Horizontal!
Solid!
Square!
Vertical!
FDiagonal! は左上から右下への斜線です。BDiagonal! は左
下から右上への斜線です。
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Long
コントロールの輪郭線に使用する色を -2 から 16,777,215
の 範 囲 の 数 値 で 指 定 し ま す。色 に つ い て の 詳 細 は、
『PowerScript リファレンス』マニュアルの RGB 関数を参照
してください。
LineStyle(カ タ コントロールの輪郭線を描画するのに使用する線のスタ
ログ データ型) イルを示します。値は以下のとおりです。
Continuous!
Dash!
DashDot!
DashDotDot!
Dot!
Transparent!
Integer
コントロールの輪郭線を描画するために使用する線の太
さを PowerBuilder 単位系で示します。LineThickness プロ
パティに 1 ピクセル(PowerBuilder 単位系で約 4)より大
きな値が指定されると、LineStyle プロパティは Continuous!
になります。
String
コントロールに割り当てるタグの値を示します。
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
オブジェクトとコントロール
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
231
Picture コントロール
イベント
Oval イベント
Constructor
Destructor
発生する状況
コントロールが作成されるとき
コントロールが破棄されるとき
関数
Oval 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
Hide
Move
PostEvent
PowerObject
Integer
Integer
Boolean
Resize
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
説明
コントロールに与えられている名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールのサイズを変更します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
Picture コントロール
Picture(ピクチャ)コントロールは、以下の形式のイメージを保持す
ることができます。
•
ビットマップ画像(拡張子が .BMP または .RLE)
•
Windows メタファイル(拡張子が .WMF)
•
GIF ファイルまたはアニメーション GIF ファイル(拡張子が .GIF)
•
JPEG ファイル(拡張子が .JPEG または .JPG)
イメージは、ほかのアプリケーションで作成するか、スキャナを使用
して作成します。
232
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
Picture プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
Border
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
オブジェクトとコントロール
233
Picture コントロール
Picture プロパティ
DragIcon
Enabled
データ型
String
Boolean
説明
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
FocusRectangle
Boolean
ピクチャがフォーカスを持っているときに、ピクチャを破
線の長方形(フォーカスを表す長方形)で囲むかどうかを
示します。値は以下のとおりです。
TRUE - コントロールがフォーカスを持っているとき
Height
Invert
Integer
Boolean
に、コントロールを破線の長方形で囲みます。
FALSE - コントロールがフォーカスを持っているとき
に、コントロールを破線の長方形で囲みません。
コントロールの高さを PowerBuilder 単位系で示します。
コントロールの色を反転して表示するかどうかを示しま
す。値は以下のとおりです。
TRUE - 色を反転表示します。
FALSE - 色を反転表示しません。
Map3DColors
Boolean
システム 3D の色をコントロールにマップするかどうかを
示します。値は以下のとおりです。
TRUE - 色をマップします。
FALSE - 色をマップしません。
OriginalSize
Boolean
ビットマップ画像(Picture コントロール)の Width プロパ
ティと Height プロパティに、オリジナルの値を設定する
かどうかを示します。値は以下のとおりです。
TRUE - 幅と高さをオリジナルの値にします。
FALSE - 幅と高さを既存のままとし、オリジナルの値
にしません。
PictureName
Pointer
String
String
PowerTipText
Long
234
ウィンドウ ペインタで OriginalSize プロパティを TRUE に
設定すると、既存の幅と高さが上書きされます。
ピクチャを格納しているファイルの名前を示します。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
コントロールの PowerTip を示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
Picture プロパティ
TabOrder
データ型
Integer
Tag
Visible
String
Boolean
説明
コントロールのタブ値(順序)を配置されているウィンド
ウに対して示します(0 を指定すると、そのコントロール
にタブ移動できません)。
コントロールに割り当てるタグの値を示します。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で示します。
イベント
Picture イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
発生する状況
コントロールがクリックされたとき(選択されたとき)
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されて、アクティブ状態に
なるとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
オブジェクトとコントロール
235
Picture コントロール
関数
Picture 関数
ClassName
Drag
Draw
GetContextService
戻り値のデータ型
String
Integer
Integer
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
SetFocus
SetPicture
SetPosition
Integer
Integer
Integer
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
236
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
現行ウィンドウ上の指定した位置にピクチャを描画します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスを設定します。
コントロールに新しいビットマップを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
PictureButton コントロール
PictureButton(ピクチャボタン)コントロールは、ピクチャ(ビット
マップや Windows メタファイル)を表示するとともに、CommandButton
のようにアクションを実行するために使用されます。たとえば、ファ
イルを保存するためのボタンにファイルのピクチャを表示したり、削
除をキャンセルするためのボタンにストップ サインのピクチャを表
示するときに用います。
以下の形式のピクチャ画像を保持することができます。
•
ビットマップ画像(拡張子が .BMP または .RLE)
•
Windows メタファイル(拡張子が .WMF)
•
GIF ファイルまたはアニメーション GIF ファイル(拡張子が .GIF)
•
JPEG ファイル(拡張子が .JPEG または .JPG)
プロパティ
PictureButton プロパティ データ型
AccessibleDescription
String
AccessibleName
AccessibleRole
BringToTop
Cancel
ClassDefinition
String
AccessibleRole
(カタログ デー
タ型)
Boolean
Boolean
PowerObject
オブジェクトとコントロール
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールをウィンドウの最前面に移動するかどうか
を示します。
コントロールがキャンセル ボタンとして機能するかどう
かを示します(Cancel プロパティが TRUE のとき、ユー
ザが〔Esc〕を押すとそのコントロールが Clicked イベント
を受け取ります)。値は以下のとおりです。
TRUE - コントロールはキャンセル ボタンとして機能
します。
FALSE - コントロールはキャンセル ボタンとして機能
しません。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
237
PictureButton コントロール
PictureButton プロパティ データ型
Default
Boolean
説明
コントロールがデフォルト コントロールかどうかを示し
ます(デフォルト コントロールは太い枠線で囲まれ、ユー
ザがコントロールを特に選択せずに〔Enter〕を押したと
きに、そのコントロールが Clicked イベントを受け取りま
す)。値は以下のとおりです。
TRUE - コントロールはデフォルトの PictureButton と
して機能します。
FALSE - コントロールはデフォルトの PictureButton と
DisabledName
String
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
しては機能しません。
編集可能なコントロール デフォルトの動作はウィンドウ
上の編集可能なコントロールの影響を受けることがあり
ます。詳細については、PowerBuilder の『ユーザーズ ガ
イド』マニュアルを参照してください。
コントロールが使用できないときに表示されるピクチャ
(ビットマップ画像)の名前を示します。拡張子の指定が
ない場合は、適切な拡張子が自動的に追加されます。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - コントロールを使用可能にします。
FALSE - コントロールを使用可能にしません。
FaceName
238
String
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
PictureButton プロパティ データ型
FlatStyle
Boolean
説明
マウス ポインタをボタンの上に移動したときにのみボタ
ンの縁を表示するかどうかを示します。これは、Microsoft
の Rebar(Coolbar)コントロールで使用されるボタン スタ
イルです。値は以下のとおりです。
TRUE - ボタンをフラットにします。
FALSE - ボタンをフラットにしません。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Alignment
コントロール内のテキストの水平方向の配置方法を示し
(カタログ デー ます。値は以下のとおりです。
タ型)
Center!
Justify!
Left!
Right!
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
Height
HTextAlign
Italic
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Map3DColors
Boolean
システム 3D の色をコントロールにマップするかどうかを
示します。値は以下のとおりです。
TRUE - 色をマップします。
FALSE - 色をマップしません。
オブジェクトとコントロール
239
PictureButton コントロール
PictureButton プロパティ データ型
OriginalSize
Boolean
説明
ビットマップ画像(ピクチャ)の Width プロパティと
Height プロパティに、オリジナルの値を設定するかどうか
を示します。値は以下のとおりです。
TRUE - 幅と高さをオリジナルの値にします。
FALSE - 幅と高さを既存のままとし、オリジナルの値
にしません。
PictureName
Pointer
String
String
PowerTipText
TabOrder
Long
Integer
Tag
Text
TextSize
String
String
Integer
Underline
Boolean
ウィンドウ ペインタで OriginalSize プロパティを TRUE に
設定すると、既存の幅と高さが上書きされます。
ピクチャを格納しているファイルの名前を示します。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
コントロールの PowerTip を示します。
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールに表示されるテキストを指定します。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
VTextAlign
VTextAlign
(カタログ デー
タ型)
Weight
Integer
Width
Integer
240
コントロール内のテキストの垂直方向の配置方法を示し
ます。値は以下のとおりです。
Bottom!
MultiLine!
Top!
VCenter!
MultiLine! を指定した場合以外は、テキストは 1 行から構
成されているものとみなされます。
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
PictureButton プロパティ データ型
X
Integer
Y
Integer
説明
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で示します。
イベント
PictureButton イベント
Clicked
Constructor
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
発生する状況
コントロールがクリックされたとき
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
関数
PictureButton 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
GetParent
Hide
Move
PointerX
PointerY
PowerObject
Integer
Integer
Integer
Integer
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
オブジェクトとコントロール
241
PictureButton コントロール
PictureButton 関数
PostEvent
戻り値のデータ型
Boolean
Print
Resize
SetFocus
SetPosition
Integer
Integer
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
242
説明
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスをセットします。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
PictureHyperLink コントロール
PictureHyperLink(ピクチャ ハイパーリンク)コントロールは、Picture
コントロールの子孫です。PictureHyperLink コントロールの URL プロ
パティを使用すると、Web ページへのホット リンクを設定できます。
このコントロールをユーザがクリックすると、ユーザの Web ブラウザ
が開いて、指定のページが表示されます。
PictureHyperLink コントロールは、以下の形式のイメージを保持するこ
とができます。
•
ビットマップ画像(拡張子が .BMP または .RLE)
•
Windows メタファイル(拡張子が .WMF)
•
GIF ファイルまたはアニメーション GIF ファイル(拡張子が .GIF)
•
JPEG ファイル(拡張子が .JPEG または .JPG)
使用上の注意
ユーザのブラウザで URL 補完機能がサポートされている場合は、アド
レスのすべてを入力する必要はありません。たとえば、次のように入
力できます。
sybase.com
完全なアドレスを入力することもできます。
http://www.sybase.com
プロパティ
PictureHyperLink
プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
AccessibleRole
(カタログ デー
タ型)
オブジェクトとコントロール
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
243
PictureHyperLink コントロール
PictureHyperLink
プロパティ
Border
データ型
Boolean
説明
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
244
PowerBuilder
第2章
PictureHyperLink
プロパティ
FocusRectangle
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
ピクチャがフォーカスを持っているときに、ピクチャを破
線の長方形(フォーカスを表す長方形)で囲むかどうかを
示します。値は以下のとおりです。
TRUE - コントロールがフォーカスを持っているとき
に、コントロールを破線の長方形で囲みます。
FALSE - コントロールがフォーカスを持っているとき
Height
Invert
Integer
Boolean
に、コントロールを破線の長方形で囲みません。
コントロールの高さを PowerBuilder 単位系で示します。
コントロールの色を反転して表示するかどうかを示しま
す。値は以下のとおりです。
TRUE - 色を反転表示します。
FALSE - 色を反転表示しません。
Map3DColors
Boolean
システム 3D の色をコントロールにマップするかどうかを
示します。値は以下のとおりです。
TRUE - 色をマップします。
FALSE - 色をマップしません。
OriginalSize
Boolean
ビットマップ画像(Picture コントロール)の Width プロパ
ティと Height プロパティに、オリジナルの値を設定する
かどうかを示します。値は以下のとおりです。
TRUE - 幅と高さをオリジナルの値にします。
FALSE - 幅と高さを既存のままとし、オリジナルの値
にしません。
PictureName
String
Pointer
String
PowerTipText
TabOrder
Long
Integer
Tag
URL
String
String
オブジェクトとコントロール
ウィンドウ ペインタで OriginalSize プロパティを TRUE に
設定すると、既存の幅と高さが上書きされます。
ピクチャを格納しているファイルの名前を示します。拡張
子の BMP、RLE、WMF、JPG、JPEG、または GIF も必要です。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
コントロールの PowerTip を示します。
コントロールのタブ値(順序)を配置されているウィンド
ウに対して示します(0 を指定すると、そのコントロール
にタブ移動できません)。
コントロールに割り当てるタグの値を示します。
ピクチャがクリックされたときにユーザの Web ブラウザ
で開く URL を示します(ただし、Clicked イベントのコー
ドが記述されていない場合)。マウス ポインタがコント
ロールの上を通過すると、状態テキストに URL が表示さ
れます。
245
PictureHyperLink コントロール
PictureHyperLink
プロパティ
Visible
データ型
Boolean
説明
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で示します。
イベント
PictureHyperLink
イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
246
発生する状況
コントロールがクリックされたとき(選択されたとき)
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されて、アクティブ状態に
なるとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
PictureHyperLink 関数
ClassName
Drag
Draw
戻り値のデータ型
String
Integer
Integer
GetContextService
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
SetFocus
SetPicture
SetPosition
Integer
Integer
Integer
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
オブジェクトとコントロール
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
現行ウィンドウ上の指定した位置にピクチャを描画しま
す。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスを設定します。
コントロールに新しいビットマップを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
247
PictureListBox コントロール
PictureListBox コントロール
PictureListBox(ピクチャ リストボックス)コントロールは、選択可能
な複数のオプションや値の表示に使用され、選択肢の中にピクチャを
含めることができます。選択肢が多すぎて一度に PictureListBox に表示
できない場合や、テキストが PictureListBox の幅を超えた場合は、(縦
または横方向の)スクロールバーが PictureListBox コントロール内に提
供されます。
PictureListBox コントロールは、以下の形式のイメージを保持すること
ができます。
•
ビットマップ(拡張子が .BMP)
•
アイコン(拡張子が .ICO)
•
カーソル(拡張子が .CUR)
•
GIF ファイル(拡張子が .GIF、Animated GIF は不可)
•
JPEG ファイル(拡張子が .JPEG または .JPG)
プロパティ
PictureListBox
プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
AccessibleRole
BackColor
Border
AccessibleRole
(カタログ デー
タ型)
Long
Boolean
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コードです。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
248
PowerBuilder
第2章
PictureListBox
プロパティ
BorderStyle
BringToTop
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
BorderStyle
(カタログ デー
タ型)
Boolean
説明
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DisableNoScroll
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
スクロールバーの表示方法や動き方を示します。値は以下
のとおりです。
TRUE - スクロールバーは常に表示されますが、
すべて
DragAuto
DragIcon
Enabled
Boolean
String
Boolean
の項目に、スクロールバーなしでアクセスできるとき
は使用できません。
FALSE - スクロールバーは必要なときにだけ(項目の
数やリスト ボックスの高さに応じて)表示されます。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
オブジェクトとコントロール
249
PictureListBox コントロール
PictureListBox
プロパティ
ExtendedSelect
データ型
Boolean
説明
ユーザがリストボックスで同時に複数の項目を選択でき
るようにするかどうかを指定します。値は以下のとおりで
す。
TRUE - ユーザは複数の項目を選択できます。
連続した
FaceName
String
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Height
HScrollBar
項目を選択するには、項目をクリックしてマウスを上
下にドラッグするか、または〔Shift〕を押しながらク
リックします。または、複数の項目上で〔Ctrl〕を押し
ながらクリックすることによっても選択できます。
FALSE - 同時に複数の項目を選択できません。
MultiSelect プロパティとの併用 MultiSelect プロパティを
指定すると、ユーザは項目をクリックするだけでリスト
ボックスの複数の項目を選択できます。MultiSelect プロパ
ティと ExtendedSelect プロパティの両方を TRUE にしたと
きは、ExtendedSelect プロパティが優先されます。
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
水平スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - 水平スクロールバーを表示します。
FALSE - 水平スクロールバーを表示しません。
250
PowerBuilder
第2章
PictureListBox
プロパティ
Italic
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Item[ ]
String
ItemPictureIndex[ ]
Integer
MultiSelect
Boolean
コントロール内の項目を指定します。このプロパティは、
初期設定の後は更新されません。
Item プロパティの各項目に対するピクチャ インデックス
の初期設定を示します。このプロパティは、初期設定の後
は更新されません。
ピクチャ リストボックス中の複数の項目を同時に選択で
きるかどうかを示します。値は以下のとおりです。
TRUE - 複数の項目を選択できます。
FALSE - 同時に複数の項目を選択できません。
MultiSelect プロパティを指定す
ると、ユーザは項目をクリックするだけでリストボッ
クスの複数の項目を選択できます。MultiSelect プロパ
ティと ExtendedSelect プロパティの両方を TRUE にした
ときは、ExtendedSelect プロパティが優先されます。
ピクチャの高さをピクセル値で示します。
ExtendedSelect との併用
PictureHeight
PictureMaskColor
Integer
Long
このプロパティは、イメージ リストにイメージがない場
合にのみスクリプトで設定可能です。最初のイメージが追
加されたときにこの値が 0 だと、そのイメージのサイズ
が、その後追加されるイメージのサイズに適用されます。
ピクチャ配列の初期設定か、または AddPicture 関数で追加
されたユーザ定義のビットマップをマスクするために使
用される色の数値を示します。システムが定義するビット
マップはそのマスク色が与えられているので、このプロパ
ティで指定した色を無視します。この値はピクチャが追加
されるときに使用されるので、AddPicture 関数を呼び出す
前に変更できます。
値の範囲は -2 から 16,777,215 です。
PictureName[ ]
String
色(RGB 関数)についての詳細は、
『PowerScript リファレ
ンス』マニュアルを参照してください。
初期設定で追加されるピクチャを格納してあるファイル
名を示します。拡張子の BMP、ICO、GIF、JPG、JPEG も
必要です。
このプロパティは、初期設定の後は更新されません。
オブジェクトとコントロール
251
PictureListBox コントロール
PictureListBox
プロパティ
PictureWidth
データ型
Integer
Pointer
String
RightToLeft
Boolean
説明
ピクチャの幅をピクセル値で示します。
このプロパティは、イメージ リストにイメージがない場
合にのみスクリプトで設定可能です。最初のイメージが追
加されたときにこの値が 0 だと、そのイメージのサイズ
が、その後追加されるイメージのサイズに適用されます。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
Sorted
Boolean
ピクチャ リストボックスの項目を自動的にソートするか
どうかを示します。値は以下のとおりです。
TRUE - 項目をソートします。
FALSE - 項目をソートしません。
TabOrder
Integer
TabStop[ ]
Integer array
Tag
TextColor
String
Long
TextSize
Integer
252
ウィンドウ内のコントロールのタブ値(順序)を示します
(0 を指定すると、ユーザはコントロールにタブ移動でき
ません)。
ピクチャ リストボックス内のタブ ストップの位置を示し
ます。タブ ストップは文字位置で指定します。タブ ストッ
プの区切り記号はスペースです。TabStop[1](最初のタブ
ストップ)だけに値を割り当てると、最初のタブ ストッ
プに指定された文字位置の数だけ間隔を空けて各タブ ス
トップが均等に配置されます。2 つ以上のタブ ストップを
指定すると、各タブ ストップは指定された位置に配置さ
れます。コントロールの中に 16 個までのタブ ストップを
定義できます。デフォルトの配列は TabStop[8] で、各タブ
ストップは 8 文字ごとに配置されます。
コントロールに割り当てるタグの値を示します。
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。色についての詳細は、
『PowerScript リファ
レンス』マニュアルの RGB 関数を参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
PowerBuilder
第2章
PictureListBox
プロパティ
Underline
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
VScrollBar
Boolean
PictureListBox の右側に垂直スクロールバーを表示するか
どうかを示します。値は以下のとおりです。
TRUE - 垂直スクロールバーを表示します。
FALSE - 垂直スクロールバーを表示しません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
PictureListBox イベント
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されて、アクティブ状態に
なるとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder イベントではないコントロールのメッセージが発生したとき
オブジェクトとコントロール
253
PictureListBox コントロール
PictureListBox イベント 発生する状況
RButtonDown
コントロールをマウスの右ボタンでクリックしたとき
SelectionChanged
コントロール上で項目が選択されるとき
関数
PictureListBox 関数
AddItem
戻り値のデータ型
Integer
説明
ピクチャ リストボックスの最後に新しい項目を追加しま
す。コントロールの Sorted プロパティが TRUE の場合、項
目の追加後に項目が再度ソートされます。
AddItem 関数は、このコントロールの Item[ ] または
AddPicture
Integer
ClassName
DeleteItem
String
Integer
DeletePicture
Integer
DeletePictures
Integer
DirList
Boolean
DirSelect
Boolean
Drag
FindItem
Integer
Integer
GetContextService
Integer
GetParent
Hide
InsertItem
PowerObject
Integer
Integer
Move
Integer
254
ItemPicture[ ] プロパティを更新しません。
メイン イメージ リストに、ビットマップ ファイルか、ア
イコン ファイルか、カーソル ファイルを追加します。
PictureName[ ] を更新しません。
コントロールに与えられている名前を返します。
インデックスで指定された項目を、ピクチャ リストボッ
クスから削除します。
指定されたピクチャをイメージ リストから削除します。
PictureName[ ] を更新しません。
すべてのピクチャをイメージ リストから削除します。
PictureName[ ] を更新しません。
ピクチャ リストボックスに、指定されたファイル パター
ンに合致したファイルのリストを挿入します。
コントロールで現在選択されている項目を取得し、指定さ
れた変数に代入します。
コントロールのドラッグを開始、または終了します。
ピクチャ リストボックスから、指定された文字列で始ま
る項目を検索します。指定されたインデックス以降で最初
に一致する項目を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
ピクチャ リストボックスに新しい項目を追加します。項
目は、指定されたインデックスの指示する項目の前に挿入
されます。コントロールの Sorted プロパティが TRUE の場
合、項目の追加後に項目が再度ソートされます。
指定された位置にコントロールを移動します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
PictureListBox 関数
PointerX
PointerY
PostEvent
戻り値のデータ型
Integer
Integer
Boolean
Print
Reset
Resize
SelectedIndex
Integer
Integer
Integer
Integer
SelectedItem
SelectItem
String
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
SetState
Integer
SetTop
Integer
Show
State
Integer
Integer
Text
String
Top
Integer
オブジェクトとコントロール
説明
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールから項目をすべて削除します。
コントロールのサイズを変更します。
ピクチャ リストボックス内で、現在選択されている項目
のインデックスを返します。複数の項目が選択されている
場合、その中で最初の項目のインデックスを返します。
最初に選択されている項目のテキストを返します。
コントロール中から項目を検索し、選択(ハイライト)状
態にします。項目のテキストがわかっていて位置が不明の
場合は、構文 1 を使用します。項目がリストのどの位置に
あるかわかっていたり、現行の選択項目を非選択にする場
合には、構文 2 を使用します。
SelectItem 関数は、MultiSelect プロパティが TRUE となっ
ている PictureListBox では何の効果ももたらしません。リ
スト内のほかの項目の選択状態に影響を与えずに項目を
選択するには、SetState 関数を使用してください。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
指定されたインデックスの指示された項目の状態(ハイラ
イト表示の有無)を設定します。SetState 関数が動作する
のは、複数選択可能なコントロール(つまり、MultiSelect
プロパティが TRUE のコントロール)に対してだけです。
コントロール内の項目をスクロールして、指定されたイン
デックスの指示された項目をコントロールの一番上に移
動します。
コントロールを表示します。
指定されたインデックスの指示された項目が選択されて
いる(ハイライト表示されている)場合は 1 を返します。
その項目が選択されていない場合は 0 を返します。
コントロール内の項目のうち、指定されたインデックスの
指示する項目のテキストを取得します。
現在、コントロールの一番上にある項目のインデックス番
号を返します。
255
Pipeline オブジェクト
PictureListBox 関数
TotalItems
TotalSelected
戻り値のデータ型
Integer
Integer
TriggerEvent
Integer
TypeOf
Object
説明
コントロール内にある項目の総数を返します。
コントロールの中で選択されている項目の総数を返しま
す。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
Pipeline オブジェクト
Pipeline(パイプライン)システム オブジェクトは、実行時にデータ パ
イプラインを管理するために使用されます。ユーザ オブジェクト ペイ
ンタで、組み込みの Pipeline オブジェクトから継承した標準クラス
ユーザ オブジェクトを定義することによって、Pipeline オブジェクト
を使用できるようになります。その後で、Pipeline イベントのコードが
含まれているスクリプトを記述すると、Pipeline イベントへのアクセス
が可能になります。
データ パイプラインについては、『アプリケーション テクニック』マ
ニュアルを参照してください。
プロパティ
Pipeline プロパティ
ClassDefinition
データ型
PowerObject
RowsInError
Long
RowsRead
RowsWritten
DataObject
Long
Long
String
Syntax
String
256
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
Pipeline が検出したエラーになったデータ行の数(たとえ
ば、重複キーを持つ行の数)です。
Pipeline によって読み込まれたデータ行の数です。
Pipeline によって書き込まれたデータ行の数です。
Pipeline オブジェクト(データ パイプライン ペインタで作
成されたオブジェクト)の名前です。
Pipeline オブジェクト(データ パイプライン ペインタで作
成されたオブジェクト)を作成するのに用いる構文です。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
イベント
Pipeline イベント
Constructor
Destructor
PipeEnd
PipeMeter
PipeStart
発生する状況
ユーザ オブジェクトが作成されるとき
ユーザ オブジェクトが破棄されるとき
Start 関数または Repair 関数の実行が完了するとき
データ行の各ブロックが読み込み、または書き込みされた後。データ パイ
プライン ペインタで指定された Commit ファクタによって各ブロックのサ
イズが決定されます。
Start 関数または Repair 関数の実行が開始されるとき
関数
Pipeline 関数
Cancel
ClassName
GetContextService
戻り値のデータ型
Integer
String
Integer
GetParent
PostEvent
PowerObject
Boolean
Repair
Integer
Start
TriggerEvent
Integer
Integer
TypeOf
Object
説明
パイプライン処理の実行を中止します。
ユーザ オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
ユーザ オブジェクトのメッセージ キューの最後にイベン
トを追加します。
Pipeline ユーザ オブジェクトのエラー データウィンドウで
行われた修正でターゲット データベースを更新します。
パイプライン処理を実行します。
ユーザ オブジェクトにイベントを送り、そのイベントに
関連付けられたスクリプトを実行します。
ユーザ オブジェクトのデータ型を返します。
ProfileCall オブジェクト
ProfileCall オブジェクトは、パフォーマンス解析モデルにおける呼び出
しに関する情報を提供します。この情報には、呼び出された側のルー
チン、呼び出し側のルーチン、呼び出し回数、経過時間(秒)などが
含まれます。このオブジェクトは ProfileRoutine オブジェクトおよび
Profiling オブジェクトとともに使用します。
ProfileCall オブジェクトには、イベントはありません。
オブジェクトとコントロール
257
ProfileCall オブジェクト
プロパティ
ProfileCall プロパティ
AbsoluteSelfTime
AbsoluteTotalTime
データ型
Decimal
Decimal
CalledRoutine
ProfileRoutine
CallingLine
ProfileLine
CallingRoutine
ProfileRoutine
ClassDefinition
PowerObject
HitCount
Long
PercentCalleeSelfTime
Double
PercentCalleeTotalTime
Double
PercentCallerTotalTime
Double
説明
呼び出された側のルーチンに費やされた時間(秒)です。
呼び出された側のルーチンとそれ以降に呼び出された
ルーチンに費やされた時間(秒)です。
呼び出し先を格納する ProfileRoutine データ型のオブジェ
クトです。
呼び出しの開始行を格納する ProfileLine データ型のオブ
ジェクト。呼び出し側オブジェクトが 1 つのルーチンから
の複数の呼び出しの集合を示す場合、無効なオブジェクト
が返されます。
呼び出しを開始したルーチンを格納する ProfileRoutine
データ型のオブジェクトです。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
呼び出し側ルーチンが、呼び出された側のルーチンを呼び
出した回数です。
呼び出し側ルーチンがアクティブ状態であった合計時間
(秒)に対する AbsoluteSelfTime の百分率で表した割合で
す。
呼び出し側ルーチンがアクティブ状態であった合計時間
(秒)に対する AbsoluteTotalTime の百分率で表した割合で
す。
呼び出し側ルーチンがアクティブ状態であった合計時間
に対して、呼び出し側のルーチンに費やされた合計時間
(秒)の百分率で表した割合です。
関数
ProfileCall 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
258
Object(カタロ
グ データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
ProfileClass オブジェクト
ProfileClass オブジェクトは、パフォーマンス解析モデルにおけるクラ
ス内にあるルーチンなど、クラスに関する情報を提供します。このオ
ブジェクトは Profiling オブジェクトとともに使用します。
ProfileClass オブジェクトには、イベントはありません。
プロパティ
ProfileClass プロパティ データ型
ClassDefinition
PowerObject
LibraryName
String
Name
String
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
クラスを格納するライブラリ名。システム クラスと埋め
込み SQL 文の値は "" です。
すべての埋め込み SQL 動作を示すクラス名、文字列、ま
たは埋め込み SQL の名前。ネストされたクラス(たとえ
ば、ウィンドウ上のコントロール)には、class
name`embedded class name という書式の名前が付きます。
関数
ProfileClass 関数
ClassName
GetContextService
GetParent
RoutineList
TypeOf
戻り値のデータ型
String
Integer
PowerObject
ErrorReturn
(カタログ デー
タ型)
Object(カタロ
グ データ型)
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
クラス内のモデルの中に存在するルーチン(ProfileRoutine
オブジェクトと定義される)のリストを提供します。
オブジェクトのデータ型を返します。
259
ProfileLine オブジェクト
ProfileLine オブジェクト
ProfileLine オブジェクトは、パフォーマンス解析モデルにおける各
ルーチンの行についての情報を提供します。この情報には、行がヒッ
トされた回数、行から呼び出しが実行されたかどうか、行と呼び出さ
れた関数に費やされた時間(秒)などが含まれます。このオブジェク
トは ProfileRoutine オブジェクトおよび Profiling オブジェクトととも
に使用します。
ProfileLine オブジェクトには、イベントはありません。
プロパティ
ProfileLine プロパティ
AbsoluteSelfTime
データ型
Decimal
AbsoluteTotalTime
Decimal
ClassDefinition
PowerObject
HitCount
LineNumber
Long
Long
MaxSelfTime
Decimal
MaxTotalTime
Decimal
MinSelfTime
Decimal
MinTotalTime
Decimal
PercentSelfTime
Double
PercentTotalTime
Double
Routine
ProfileRoutine
260
説明
この行自体に費やされた時間(秒)。行が 2 回以上実行さ
れた場合はこの行に費やされた合計時間です。
この行とこの行から呼び出された行に費やされた時間
(秒)。行が 2 回以上実行された場合は、この行と呼び出さ
れた行に費やされた合計時間です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
行が呼び出された回数です。
行番号です。行番号 0 はローカル変数(自動インスタンス
作成されたオブジェクトの呼び出しコンストラクタなど)
の初期化にかかった時間(秒)を示す特別な行です。
この行だけに費やされた最長時間(秒)。行が 1 回だけ実
行された場合は AbsoluteSelfTime と同じです。
この行と呼び出された行に費やされた最長時間(秒)。行
が 1 回だけ実行された場合は AbsoluteTotalTime と同じで
す。
この行だけに費やされた最短時間(秒)。行が 1 回だけ実
行された場合は AbsoluteSelfTime と同じです。
この行と呼び出された行に費やされた最短時間(秒)。行
が 1 回だけ実行された場合は AbsoluteTotalTime と同じで
す。
トレースがアクティブ状態であった合計時間(秒)に対す
る AbsoluteSelfTime の百分率で表した割合です。
トレースがアクティブ状態であった合計時間(秒)に対す
る AbsoluteTotalTime の百分率で表した割合です。
行が入っているルーチンです。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
ProfileLine 関数
ClassName
GetContextService
GetParent
OutgoingCallList
TypeOf
戻り値のデータ型
String
Integer
PowerObject
ErrorReturn
(カタログ デー
タ型)
Object(カタロ
グ データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
行からほかのルーチンへの呼び出し(ProfileCall オブジェ
クトと定義される)のリストを提供します。
オブジェクトのデータ型を返します。
ProfileRoutine オブジェクト
ProfileRoutine オブジェクトは、パフォーマンス解析モデルにおける
ルーチンに関する情報を提供します。この情報にはこのルーチンに費
やされた時間(秒)、呼び出されたルーチン、各ルーチンが呼び出され
た回数、ルーチンが属するクラスが含まれます。このオブジェクトは
Profiling オ ブ ジ ェ ク ト お よ び ProfileCall オ ブ ジ ェ ク ト ま た は
ProfileLine オブジェクトとともに使用します。
ProfileRoutine オブジェクトには、イベントはありません。
プロパティ
ProfileRoutine
プロパティ
AbsoluteSelfTime
データ型
Decimal
AbsoluteTotalTime
Decimal
Class
ProfileClass
オブジェクトとコントロール
説明
このルーチンに費やされた時間(秒)。ルーチンが 2 回以
上実行された場合はこのルーチンに費やされた合計時間
です。
このルーチンとこのルーチンから呼び出されたルーチン
に費やされた時間(秒)。ルーチンが 2 回以上実行された
場合は、このルーチンと呼び出されたルーチンに費やされ
た合計時間です。
このルーチンが入っているクラス。埋め込み SQL が動作
した場合の値は埋め込み SQL です。グローバル関数とシス
テム関数の場合の値は無効なオブジェクトです。
261
ProfileRoutine オブジェクト
ProfileRoutine
プロパティ
ClassDefinition
データ型
PowerObject
HitCount
Long
Kind
ProfileRoutine
Kind(カタログ
データ型)
MaxSelfTime
Decimal
MaxTotalTime
Decimal
MinSelfTime
Decimal
MinTotalTime
Decimal
Name
String
PercentSelfTime
Double
PercentTotalTime
Double
262
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
このルーチンが呼び出された回数、またはオブジェクトが
作成 / 破棄された回数です。
ルーチン ノードの種類。値は以下のとおりです。
RoutineESQL! - 埋め込み SQL 文を示します。
RoutineEvent! - イベントを示します。
RoutineFunction! - 関数を示します。
RoutineGarbageCollection! - ガベージ コレクションの
段階を示します。
RoutineObjectCreation! - オブジェクト作成を示します。
RoutineObjectDestruction! - オブジェクト破棄を示しま
す。
RoutineRoot! - ウィンドウ表示システムを示します。
このルーチン自体に費やされた最長時間(秒)。ルーチン
が 1 回だけ実行された場合は AbsoluteSelfTime と同じで
す。
このルーチンと呼び出されたルーチンに費やされた最長
時間(秒)。ルーチンが 1 回だけ実行された場合は
AbsoluteTotalTime と同じです。
このルーチン自体に費やされた最短時間(秒)。ルーチン
が 1 回だけ実行された場合は AbsoluteSelfTime と同じで
す。
このルーチンと呼び出されたルーチンに費やされた最短
時間(秒)。ルーチンが 1 回だけ実行された場合は
AbsoluteTotalTime と同じです。
引数のデータ型および戻り値を含むルーチンの名前です。
埋め込み SQL 動作の場合は、値はステートメント名
(SELECT など)です。オブジェクトの作成 / 破棄の場合
は、値は Object Create または Object Destroy です。
トレースがアクティブ状態であった合計時間(秒)に対す
る AbsoluteSelfTime の百分率で表した割合です。
トレースがアクティブ状態であった合計時間(秒)に対す
る AbsoluteTotalTime の百分率で表した割合です。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
ProfileRoutine 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
IncomingCallList
PowerObject
LineList
OutgoingCallList
TypeOf
ErrorReturn(カタ
ログ データ型)
ErrorReturn(カタ
ログ データ型)
ErrorReturn(カタ
ログ データ型)
Object(カタログ
データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタ
ンスへの参照を作成します。
親オブジェクト名への参照を返します。
ProfileRoutine の呼び出し側オブジェクト(ProfileCall オ
ブジェクトと定義される)のリストを提供します。
ProfileRoutine の中の行(ProfileLine オブジェクトと定義
される)のリストを行順に提供します。
ProfileRoutine 内からほかのルーチンに対して行った呼
び出し(ProfileCall オブジェクトと定義される)のリス
トを提供します。
オブジェクトのデータ型を返します。
Profiling オブジェクト
Profiling オブジェクトを使用すると、PowerBuilder アプリケーションの
パフォーマンスを解析できます。このオブジェクトは、指定されたト
レース ファイルに記録されたすべてのルーチン(関数とイベントの両
方)をリストしたパフォーマンス解析モデルを提供します。このオブ
ジェクトに含まれる関数を呼び出して、解析対象のトレース ファイル
を指定し、モデルを作成し、そのモデルに含めるクラスとルーチンの
リストを作成できます。Profiling オブジェクトは ProfileCall、ProfileClass、
ProfileLine、および ProfileRoutine の各オブジェクトとともに使用しま
す。
Profiling オブジェクトには、イベントはありません。
プロパティ
Profiling プロパティ
ApplicationName
データ型
String
ClassDefinition
PowerObject
オブジェクトとコントロール
説明
トレース ファイルの生成に使用したアプリケーション
の名前です。
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
263
Profiling オブジェクト
Profiling プロパティ
CollectionTime
データ型
Decimal
NumberOfActivities
Long
TraceFileName
String
説明
トレース データの収集にかかった時間(秒)。この時間
はトレース ファイルからのタイムスタンプの中ですで
に考慮されています(つまり、タイムスタンプがトレー
ス ファイルに入れられる前に適切な時間がタイムスタ
ンプから差し引かれています)。モデルが作成されな
かった場合は NULL が返されます。
トレース ファイルにある合計アクティビティ数。トレー
ス ファイルが設定される前にこのプロパティが呼び出
される場合は、この値は 0 です。
モデルの作成に使用されるトレース ファイルの名前。こ
の名前が正常に設定されなかった場合には、この値は空
の文字列となります。
関数
Profiling 関数
BuildModel
ClassList
ClassName
DestroyModel
GetContextService
GetParent
RoutineList
SetTraceFileName
SystemRoutine
TypeOf
264
戻り値のデータ型
説明
ErrorReturn(カタ 前に指定されたトレース ファイルに基づきパフォーマ
ログ データ型)
ンス解析モデルを作成します。
ErrorReturn(カタ そのモデルに含まれるクラス(ProfileClass オブジェクト
ログ データ型)
と定義される)のリストを提供します。
String
オブジェクトに与えられた名前を返します。
ErrorReturn(カタ 現行のパフォーマンス解析モデルを破棄します。
ログ データ型)
Integer
指定されたサービスのコンテキストに固有のインスタ
ンスへの参照を作成します。
PowerObject
親オブジェクト名への参照を返します。
ErrorReturn(カタ そのモデルに含まれるルーチン(ProfileRoutine オブジェ
ログ データ型)
クトと定義される)のリストを提供します。
ErrorReturn
解析に使用するトレース ファイル名を示し、ヘッダ形式
の有効性を検証します。
ProfileRoutine
システム ルートを示すルーチン ノード(ProfileRoutine
オブジェクトと定義される)を提供します。
Object(カタログ オブジェクトのデータ型を返します。
データ型)
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
RadioButton コントロール
RadioButton(ラジオボタン)とは、オプションの有効 / 無効の切り替
えに使用される小さな丸いボタンです。オプションを有効にすると、
ボタンの中央が黒になります。オプションを無効にすると、ボタンの
中央がブランクになります。
GroupBox の場合
RadioButton コントロールが複数ある場合、これらをグループ化して
GroupBox コントロールの中にまとめておくのが一般的です。RadioButton
が GroupBox の中にまとめてある場合は、そのグループの中で選択で
きるボタンは 1 つだけです。また、GroupBox コントロールに対してデ
フォルト ボタンを 1 つ設定することができます。
プロパティ
RadioButton プロパティ データ型
AccessibleDescription
String
AccessibleName
AccessibleRole
Automatic
String
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールをクリックしたときに、コントロール色が濃
くなるかどうかを示します。値は以下のとおりです。
TRUE - コントロールをクリックすると色が濃くなり
ます。
FALSE - コントロールをクリックしても色が濃くなり
BackColor
BorderStyle
Long
BorderStyle
(カタログ デー
タ型)
オブジェクトとコントロール
ません。
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleLowered!
StyleRaised!
265
RadioButton コントロール
RadioButton プロパティ データ型
BringToTop
Boolean
説明
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
Checked
Boolean
項目が選択されているかどうかを示します(中央は黒くな
ります)。値は以下のとおりです。
TRUE - コントロールは選択されています。
FALSE - コントロールは選択されていません。
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - コントロールを使用可能にします。
FALSE - コントロールを使用可能にしません。
FaceName
FontCharSet
266
String
FontCharSet
(カタログ デー
タ型)
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば HELV や COURIER など)を示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
RadioButton プロパティ データ型
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Height
Italic
説明
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
LeftText
Boolean
テキストをコントロールの左側に表示するかどうかを示
します。値は以下のとおりです。
TRUE - テキストを左側に表示します。
FALSE - テキストを左側に表示しません。
Pointer
String
RightToLeft
Boolean
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
TabOrder
Tag
Text
Integer
String
String
オブジェクトとコントロール
ウィンドウ内のコントロールのタブ値(順序)を示します
(0 を指定すると、ユーザはコントロールにタブ移動でき
ません)。グループボックス内では、上向きまたは下向き
の矢印キーを使って指定した順序でラジオボタンの間を
移動できます。
グループボックスのタブ値を 0 にしてもラジオボタンに 0
以外のタブ値を与えると、そのグループボックス内でタブ
が使用できます(グループボックス内のラジオボタンのデ
フォルトのタブ値は 0 です)。
コントロールに割り当てるタグの値を示します。
コントロールの隣に表示されるテキストを示します。
267
RadioButton コントロール
RadioButton プロパティ データ型
TextColor
Long
TextSize
Integer
Underline
Boolean
説明
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。色についての詳細は、
『PowerScript リファ
レンス』マニュアルの RGB 関数を参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
RadioButton イベント
Clicked
Constructor
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
268
発生する状況
コントロールがクリックされたとき(選択または選択解除されたとき)
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder
第2章
RadioButton イベント
Other
RButtonDown
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
発生する状況
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
関数
RadioButton 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
SetFocus
SetPosition
Integer
Integer
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
オブジェクトとコントロール
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
コントロールに指定されたイベントを起動し、そのイベン
トのスクリプトを実行します。
コントロールのデータ型を返します。
269
Rectangle コントロール
Rectangle コントロール
Rectangle(長方形)コントロールは、アウトラインもしくは塗りつぶ
された長方形を表す描画オブジェクトで、通常はデザイン上の効果を
与えるために使用します。たとえば、CommandButton や Picture コント
ロールを Rectangle で囲んだり、別のコントロールの後ろに少しずらし
て Rectangle を配置することで影をつけることができます。複数のコン
トロールを Rectangle で囲んで(表示の上で)グループ化しても、各コ
ントロールの動作に影響はありません。
プロパティ
Rectangle プロパティ
ClassDefinition
FillColor
FillPattern
Height
LineColor
270
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
Long
コントロールを塗りつぶす色を -2 から 16,777,215 の範囲
の数値で示します。色についての詳細は、
『PowerScript リ
ファレンス』マニュアルの RGB 関数を参照してください。
FillPattern(カタ コントロールを塗りつぶすために使用するハッチ パター
ログ データ型) ンを示します。値は以下のとおりです。
BDiagonal!
Diamond!
FDiagonal!
Horizontal!
Solid!
Square!
Vertical!
Integer
Long
FDiagonal! は左上から右下への斜線です。BDiagonal! は左
下から右上への斜線です。
コントロールの高さを PowerBuilder 単位系で示します。
コントロールの輪郭線に使用する色を -2 から 16,777,215
の 範 囲 の 数 値 で 指 定 し ま す。色 に つ い て の 詳 細 は、
『PowerScript リファレンス』マニュアルの RGB 関数を参照
してください。
PowerBuilder
第2章
Rectangle プロパティ
LineStyle
LineThickness
Tag
Visible
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
説明
LineStyle(カ タ コントロールの輪郭線を描画するために使用する直線の
ログ データ型) パターンを指定します。値は以下のとおりです。
Continuous!
Dash!
DashDot!
DashDotDot!
Dot!
Transparent!
Integer
コントロールの輪郭線を描画するために使用する線の太
さを PowerBuilder 単位系で示します。LineThickness プロ
パティに 1 ピクセル(PowerBuilder 単位系で約 4)より大
きな値が指定されると、LineStyle プロパティは Continuous!
になります。
String
コントロールに割り当てるタグの値を示します。
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
Rectangle イベント
Constructor
Destructor
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
関数
Rectangle 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
PowerObject
オブジェクトとコントロール
説明
コントロールに与えられている名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
271
ResultSet オブジェクト
Rectangle 関数
Hide
Move
PostEvent
戻り値のデータ型
Integer
Integer
Boolean
Resize
Show
TriggerEvent
Integer
Integer
Integer
TypeOf
Object
説明
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールのサイズを変更します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
ResultSet オブジェクト
ResultSet(結果集合)オブジェクトは、EAServer 結果集合または ActiveX
データ オブジェクト(ADO)レコード セットを使用して、結果集合
をクライアントに返すことを可能にします。ResultSet オブジェクトは、
CreateForm および GenerateResultSet DataStore 関数と組み合わせて使用
します。
プロパティ
ResultSet プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
イベント
ResultSet イベント
Constructor
Destructor
272
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
ResultSet 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
PostEvent
PowerObject
Boolean
TriggerEvent
Integer
TypeOf
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
ResultSets オブジェクト
ResultSets(結果集合)オブジェクトは、EAServer から返された複数の
結果集合を処理することを可能にします。
プロパティ
ResultSets プロパティ
ClassDefinition
データ型
PowerObject
ResultSetList
ResultSet オブ
ジェクト
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
ResultSet オブジェクトの配列
イベント
ResultSets イベント
Constructor
Destructor
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
オブジェクトとコントロール
273
RichTextEdit コントロール
関数
ResultSets 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
PostEvent
PowerObject
Boolean
TriggerEvent
Integer
TypeOf
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
RichTextEdit コントロール
RichTextEdit(リッチテキスト エディット)コントロールは、文書を格
納するためのコントロールです。文書は書式付きテキストとして表示
することができます。また、DataWindow コントロールとリンクした入
力フィールドを文書中に挿入できます。データウィンドウのデータを
RichTextEdit コントロールと共有すると、コントロールに文書のインス
タンスが 1 つ生成されます。このインスタンスはデータ行の内容に基
づいて変わり、何度も表示されます。データウィンドウ内のカラムと
名前が一致する入力フィールドには、現行の行のデータが設定されま
す。
プロパティ
RichTextEdit プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
274
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コード値です。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
PowerBuilder
第2章
RichTextEdit プロパティ
AccessibleRole
BackColor
Border
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
AccessibleRole
(カタログ デー
タ型)
Long
Boolean
説明
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
RichTextEdit のテキスト編集エリアの背景色を -2 から
16,777,215 の範囲の数値で示します。色についての詳細
は、
『PowerScript リファレンス』マニュアルの RGB 関数を
参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BottomMargin
BringToTop
BorderStyle
(カタログ デー
タ型)
Long
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
印刷ページの下余白の幅を示します。
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DisplayOnly
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
内容を変更できるようにするかどうかを示します。値は以
下のとおりです。
TRUE - テキストや入力ファイルなど、
内容は保護され
ています(ユーザは編集できません)。
FALSE - ユーザは内容を編集できます。
DocumentName
String
DragAuto
Boolean
ユーザが印刷するときに、印刷キュー(スプーラ)に表示
する文書名を示します。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
オブジェクトとコントロール
275
RichTextEdit コントロール
RichTextEdit プロパティ
DragIcon
Enabled
データ型
String
Boolean
説明
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
HeaderFooter
Boolean
RichTextEdit コントロールに、ヘッダ / フッタ セクション
があるかどうかを示します。このプロパティはペインタで
設定します。実行中は変更できません。値は以下のとおり
です。
TRUE - コントロールにはヘッダ / フッタ セクション
があります。
FALSE - コントロールにはヘッダ / フッタ セクション
がありません。
Height
HScrollBar
Integer
Boolean
文書にヘッダかフッタがあるのに、HeaderFooter プロパ
ティが No に設定されている場合は、文書のヘッダやフッ
タは無視されます。その文書をそのまま同じファイルに保
存すると、ヘッダとフッタの情報が失われるので注意が必
要です。
コントロールの高さを PowerBuilder 単位系で示します。
RichTextEdit コントロールに水平スクロールバーを表示す
るかどうかを示します。値は以下のとおりです。
TRUE - スクロールバーを表示します。
FALSE - スクロールバーを表示しません。
ImeMode
Integer
InputFieldBackColor
Long
InputFieldNamesVisible
Boolean
IME(Input Method Editor)のモード設定を示します。この
プロパティは、日本語版 PowerBuilder 上で実行されている
アプリケーションにのみ適用されます。
すべての入力フィールドのデフォルト背景色を -2 から
16,777,215 の範囲の数値で指定します。色についての詳細
は、
『PowerScript リファレンス』マニュアルの RGB 関数を
参照してください。
入力フィールド内に入力フィールドの名前を表示するか、
入力フィールドの値を表示するかを示します。値は以下の
とおりです。
TRUE - 入力フィールドにフィールド名を表示します。
FALSE - 入力フィールドにデータを表示します。
276
PowerBuilder
第2章
RichTextEdit プロパティ
InputFieldsVisible
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
このプロパティは現在使用できません。入力フィールドを
表示するかどうかを示します。値は以下のとおりです。
TRUE - 入力フィールドを表示します。
FALSE - 入力フィールドを表示しません。
LeftMargin
Modified
Long
Boolean
印刷ページの左余白の幅を示します。
文書が開かれてから、または前回保存されてから、変更が
加えられたかどうかを示します。Modified プロパティは、
その文書が保存されていないことを示すフラグとして機
能します。値は以下のとおりです。
TRUE - 文書は変更されています。
FALSE - 文書は変更されていません。
PicturesAsFrame
Boolean
Pointer
String
PopMenu
Boolean
新規に文書を作成するときや、保存済みの文書に変更が加
えられると 、Modified プロパティが TRUE に設定され、
Modified イベントが発生します。
この値が TRUE の場合、イメージ枠で表示されます。
コントロールで使用するポインタを、組み込みポインタ名
か、ポインタを含むファイル名で示します。
コントロール上でユーザが右マウス ボタンをクリックし
たときに、ポップアップ メニューを表示するかどうかを
示します。ポップアップ メニューでは、切り取りや貼り
付け、ファイルの挿入、書式オプションの選択などが行え
ます。値は以下のとおりです。
TRUE - ポップアップ メニューが使用できます。
FALSE - ポップアップ メニューは使用できません。
Resizable
Boolean
ユーザがコントロールのサイズを変更できるようにする
かどうかを示します。値は以下のとおりです。
TRUE - コントロールのサイズを変更できます。
FALSE - コントロールのサイズを変更できません。
ReturnsVisible
Boolean
改行記号を表示するかどうかを示します。値は以下のとお
りです。
TRUE - 改行記号を表示します。
FALSE - 改行記号を表示しません。
RightMargin
Long
オブジェクトとコントロール
印刷ページの右余白の幅を示します。
277
RichTextEdit コントロール
RichTextEdit プロパティ
RulerBar
データ型
Boolean
説明
編集エリアの上にルーラ バーを表示するかどうかを示し
ます。ルーラ バーを表示すると、ユーザはタブ ストップ
の位置や余白の位置をルーラを使って設定できます
(TabBar プロパティを参照してください)。値は以下のと
おりです。
TRUE - ルーラ バーを表示します。
FALSE - ルーラ バーを表示しません。
SpacesVisible
Boolean
RichTextEdit ポップアップ メニューが使用可能なときは、
ルーラ バーの表示 / 非表示が設定できます(PopMenu プ
ロパティを参照してください)。
スペース記号を表示するかどうかを示します。値は以下の
とおりです。
TRUE - スペース記号を表示します。
FALSE - スペース記号を表示しません。
TabBar
Boolean
編集エリアの上にタブ設定バーを表示するかどうかを示
します。値は以下のとおりです。
TRUE - タブ バーを表示します。
FALSE - タブ バーを表示しません。
TabOrder
TabsVisible
Integer
Boolean
ポップアップ メニューが使用可能なときは、タブ バーの
表示 / 非表示が設定できます(PopMenu プロパティを参照
してください)。
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
RichTextEdit ではその内部でタブ移動が許されるため、
ユーザはコントロールのタブ値を 0 にすることはできま
せん。
タブ記号を表示するかどうかを示します。値は以下のとお
りです。
TRUE - タブ記号を表示します。
FALSE - タブ記号を表示しません。
Tag
ToolBar
String
Boolean
コントロールに割り当てるタグの値を示します。
編集エリアの上に書式設定のためのツール バーを表示す
るかどうかを示します。値は以下のとおりです。
TRUE - ツール バーを表示します。
FALSE - ツール バーを表示しません。
TopMargin
278
Long
ポップアップ メニューが使用可能なときは、ツール
バーの表示 / 非表示が設定できます(PopMenu プロパ
ティを参照してください)。
印刷ページの上余白の幅を示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
RichTextEdit プロパティ
UndoDepth
データ型
Integer
説明
Undo 操作を最大何回繰り返すことができるかを示しま
Visible
Boolean
す。
コントロールが表示可能かどうかを示します。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
VScrollBar
Boolean
RichTextEdit コントロールに垂直スクロールバーを表示す
るかどうかを示します。値は以下のとおりです。
TRUE - スクロールバーを表示します。
FALSE - スクロールバーを表示しません。
Width
WordWrap
Integer
Boolean
コントロールの幅を PowerBuilder 単位系で示します。
テキスト行が余白の部分まで達したときに、次の行へ自動
的にラップするかどうかを示します。値は以下のとおりで
す。
TRUE - 自動的にラップします。
FALSE - 自動的にラップしません。
X
Integer
Y
Integer
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
RichTextEdit イベント
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
FileExists
GetFocus
Help
InputFieldSelected
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
ユーザが RichTextEdit コントロール上のどこかをダブルクリックするとき
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
RichTextEdit 内の文書をファイルに保存しようとしたときに、同じ名前の
ファイルがすでに存在するとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
ユーザが入力フィールドをダブルクリックするか、
〔Enter〕を押して、フィー
ルドのデータを編集しようとするとき
オブジェクトとコントロール
279
RichTextEdit コントロール
RichTextEdit イベント
Key
LoseFocus
Modified
MouseDown
MouseMove
MouseUp
Other
PictureSelected
PrintFooter
PrintHeader
RButtonDown
RButtonUp
発生する状況
ユーザがキーを押すとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
RichTextEdit コントロールの内容を初めて変更したときや、未保存の文書が
変更されるとき
Modified イベント スクリプトでは、文書の保存が必要なことを指示するフ
ラグを設定できます。
コントロール上で、マウスの左または中央ボタンが押されたとき
マウスがコントロール内で移動されるとき
コントロール上で押したマウスの左または中央ボタンを放すとき
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
ユーザが RichTextEdit 上のビットマップをダブルクリックしたり、
〔Enter〕
を押して選択するとき
RichTextEdit 上の文書のフッタが印刷されようとしているとき。ページ番号
の設定についての詳細は、次の PrintHeader の説明を参照してください。
RichTextEdit 上の文書のヘッダが印刷されようとしているとき
ページ番号の設定 PrintHeader イベントと PrintFooter イベントで、
ページ番号
の印刷用に挿入されている入力フィールドの値を設定することによって、
ページ番号の表示を変更することができます。たとえば、ページ数を連続し
てカウントしたり、文書インスタンスごとに 1 ページから開始するなどの設
定が行えます。
コントロールをマウスの右ボタンでクリックしたとき。ポップアップ メ
ニューが使用できるときは、発生しません。
コントロール上でマウスの右ボタンを放すとき
関数
RichTextEdit 関数
CanUndo
戻り値のデータ型
Boolean
ClassName
Clear
String
Long
Copy
Long
CopyRTF
String
280
説明
編集操作が Undo 関数で取り消せる場合に TRUE を返しま
す。
コントロールに与えられている名前を返します。
選択されたテキスト(選択されたものがあれば)をコント
ロールから削除します(テキストはクリップボードにコ
ピーされません)。
RichTextEdit コントロール上の選択されている内容をク
リップボードにコピーします(ただし、削除はしません)
。
RichTextEdit コントロール上の選択されている内容をリッ
チテキスト形式で文字列にコピーします 。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
RichTextEdit 関数
Cut
戻り値のデータ型
Long
DataSource
Integer
Drag
Integer
Find
FindNext
Integer
Integer
GetAlignment
Alignment
GetContextService
Integer
GetParagraphSetting
Long
GetParent
GetSpacing
GetTextColor
PowerObject
Spacing
Long
GetTextStyle
Hide
InputFieldChangeData
Boolean
Integer
Integer
InputFieldCurrentName
InputFieldDeleteCurrent
String
Integer
InputFieldGetData
InputFieldInsert
InputFieldLocate
String
Integer
String
InsertDocument
Integer
InsertPicture
Integer
IsPreview
Boolean
LineCount
Integer
オブジェクトとコントロール
説明
RichTextEdit コントロール上の選択されている内容を切り
取り(削除し)、クリップボードにコピーします。
同じ名前の入力フィールドとカラムをマッチさせて、デー
タウィンドウと RichTextEdit コントロールを関連付けま
す。
コントロールのドラッグを開始または終了します。
コントロールの中のテキストを検索します。
Find 関数で指定した条件を満たす次の文字列を検索しま
す。
選択しているテキストの水平方向の位置揃えを取得しま
す。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
挿入ポイントの位置する段落のインデント幅、左右の余白
サイズを取得します。
親オブジェクト名への参照を返します。
選択しているテキストの行間隔を取得します。
選択しているテキストの色を返します。
選択しているテキストのフォント設定を取得します。
コントロールを非表示にします。
指定された入力フィールド名の入力フィールドの持つ
データをすべて変更します。
選択されている入力フィールドの名前を取得します。
選択されている入力フィールドの現行文字列を削除しま
す(この関数では、同じ名前の入力フィールドが複数ある
場合、すべてが削除されるのではなく、現行フィールドの
文字列だけが削除されます)。
指定された入力フィールドのデータを取得します。
挿入ポイントに名前付きの入力フィールドを挿入します。
入力フィールドを検索します。入力フィールドの任意の文
字列や、特定の名前の入力フィールドを検索できます。
RichTextEdit コントロールにテキスト ファイルを挿入し
ます。挿入したファイルは現行の内容と置換するか、追加
することができます。挿入するファイルの形式は、リッチ
テキスト形式(RTF)、ASCII テキスト形式のいずれかです。
挿入ポイントに指定されたビットマップ ファイルを挿入
します。
RichTextEdit コントロールがプレビュー モードかどうか
を判別します。
文書内にある行の総数を返します。
281
RichTextEdit コントロール
RichTextEdit 関数
LineLength
Move
PageCount
Paste
戻り値のデータ型
Integer
Integer
Integer
Integer
PasteRTF
Long
PointerX
PointerY
Position
Integer
Integer
Integer
PostEvent
Integer
Preview
Integer
Print
Integer
PrintEx
Integer
ReplaceText
Integer
Resize
SaveDocument
Integer
Integer
Scroll
Integer
ScrollNextPage
Integer
ScrollNextRow
Long
ScrollPriorPage
Long
ScrollPriorRow
Long
282
説明
現行の行の長さを返します。
指定された位置にコントロールを移動します。
文書のページ数を返します。
コントロール内の挿入ポイントの位置に、クリップボード
の内容を挿入します。
リッチテキスト形式のテキストを含む文字列を、コント
ロールの挿入ポイントの位置に挿入します。文字列をヘッ
ダ区域、フッタ区域、本文のいずれに挿入するかを指定で
きます。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
挿入ポイントまたは選択されているテキストの、コント
ロール上での位置を返します。
指定されたオブジェクトのイベント キューの最後に、指
定されたイベントを追加します。
コントロールの表示を、通常の RichTextEdit コントロール
の表示とプレビュー表示(ヘッダ、フッタ、ページ サイ
ズなどが表示される)間で切り替えます。
コントロールの内容を現行プリンタに送信します。ページ
範囲、そのほかの設定を指定できます。
コントロールの内容を現行プリンタに送信します。印刷
ダイアログボックスを表示するかどうかを指定できます。
選択されているテキストを指定した文字列で置換します。
テキストが選択されていない場合には、カーソルの位置に
文字列を挿入します。
コントロールのサイズを変更します。
現行の文書を、リッチテキスト形式(RTF)か ASCII のテ
キスト ファイルの形式で保存します。
RichTextEdit 上の文書を指定した方向に、指定した行数だ
けスクロールします。
RichTextEdit 文書を 1 ページ分の行数だけ後方にスクロー
ルします。現行ページが文書インスタンスの最終ページの
場合は、次の文書インスタンスにスクロールします。
RichTextEdit を次の行とその文書インスタンスにスクロー
ルします。
RichTextEdit 文書を 1 ページ分の行数だけ前方へスクロー
ルします。現行ページが文書インスタンスの先頭ページの
場合は、前のインスタンスにスクロールします。
RichTextEdit を前の行とその文書インスタンスにスクロー
ルします。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
RichTextEdit 関数
ScrollToRow
戻り値のデータ型
Long
SelectedColumn
Integer
SelectedLength
SelectedLine
Long
Long
SelectedPage
Long
SelectedStart
Integer
SelectedText
String
SelectText
SelectTextAll
SelectTextLine
Long
Integer
Integer
SelectTextWord
SetAlignment
SetFocus
SetParagraphSetting
Integer
Integer`
Integer
Integer
SetPosition
Integer
SetRedraw
SetSpacing
SetTextColor
SetTextStyle
Integer
Integer
Integer
Integer
Show
ShowHeadFoot
Integer
Integer
TextLine
String
TriggerEvent
Integer
TypeOf
Object
オブジェクトとコントロール
説明
コントロールを、指定された行と文書インスタンスにスク
ロールします。
挿入ポイントの直後にある文字の行頭からの文字数を返
します。
選択されているテキストの長さを返します。
文書インスタンスにおいて、現在挿入ポイントが位置して
いる行の行番号を返します。
文書インスタンスにおいて、現在挿入ポイントが位置して
いるページのページ番号を返します。
選択されているテキストの先頭がその行の何文字目に位
置しているかを返します。
コントロール上の選択されているテキストを文字列とし
て返します。
RichTextEdit コントロール上のテキストを選択します。
コントロール上のテキストをすべて選択します。
現在、挿入ポイントが位置している行のテキストをすべて
選択します。
現在、挿入ポイントが位置している単語を選択します。
選択した段落の水平方向の位置揃えを設定します。
RichTextEdit コントロールにフォーカスを設定します。
段落のインデント幅、左余白、または右余白のサイズを指
定します。
コントロールを、常時、ウィンドウ画面の前面に表示する
かどうかを指定します。
コントロールを自動再描画するかどうかを制御します。
選択されている段落の行間隔を設定します。
選択されているテキストの色を設定します。
選択されているテキストのフォント プロパティを設定し
ます。
RichTextEdit コントロールを表示します。
RichTextEdit 文書のヘッダおよびフッタの編集を可能にし
ます。
挿入ポイントが現在位置している行のテキスト全体を返
します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
283
RoundRectangle コントロール
RichTextEdit 関数
Undo
戻り値のデータ型
Integer
説明
コントロールで最後に行った編集操作を取り消し、編集前
の内容に戻します(編集内容によっては取り消せないもの
があります)。
RoundRectangle コントロール
RoundRectangle(丸長方形)コントロールは、アウトラインもしくは
塗りつぶされた角の丸い長方形を表す描画オブジェクトで、通常はデ
ザイン上の効果を与えるために使用します(たとえば、CommandButton
や Picture コントロールを RoundRectangle で囲むことができます)。複
数のコントロールを RoundRectangle で囲んでグループ化(表示の上で)
しても、各コントロールの動作に影響はありません。
プロパティ
RoundRectangle
プロパティ
ClassDefinition
データ型
PowerObject
CornerHeight
Integer
CornerWidth
Integer
FillColor
Long
FillPattern
FillPattern
(カタログ デー
タ型)
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールの角丸部分の縦方向の半径を PowerBuilder
単位系で示します。
コントロールの角丸部分の横方向の半径を PowerBuilder
単位系で示します。
コントロールを塗りつぶす色を -2 から 16,777,215 の範囲
の数値で示します。色についての詳細は、
『PowerScript リ
ファレンス』マニュアルの RGB 関数を参照してください。
コントロールを塗りつぶすために使用するハッチ パター
ンを示します。値は以下のとおりです。
BDiagonal!
Diamond!
FDiagonal!
Horizontal!
Solid!
Square!
Vertical!
FDiagonal! は左上から右下への斜線です。BDiagonal! は左
下から右上への斜線です。
284
PowerBuilder
第2章
RoundRectangle
プロパティ
Height
LineColor
LineStyle
LineThickness
Tag
Visible
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Integer
Long
説明
コントロールの高さを PowerBuilder 単位系で示します。
コントロールの輪郭線に使用する色を -2 から 16,777,215
の 範 囲 の 数 値 で 指 定 し ま す。色 に つ い て の 詳 細 は、
『PowerScript リファレンス』マニュアルの RGB 関数を参照
してください。
LineStyle(カタ コントロールの輪郭線を描画するのに使用する線のスタ
ログ データ型) イルを示します。値は以下のとおりです。
Continuous!
Dash!
DashDot!
DashDotDot!
Dot!
Transparent!
Integer
コントロールの輪郭線を描画するために使用する線の太
さを PowerBuilder 単位系で示します。LineThickness プロ
パティに 1 ピクセル(PowerBuilder 単位系で約 4)より大
きな値が指定されると、LineStyle プロパティは Continuous!
になります。
String
コントロールに割り当てるタグの値を示します。
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
RoundRectangle
イベント
発生する状況
Constructor
ウィンドウの Open イベントが発生する直前
Destructor
ウィンドウの Close イベントが発生した直後
オブジェクトとコントロール
285
RuntimeError オブジェクト
関数
RoundRectangle 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
Hide
Move
Resize
Show
TypeOf
PowerObject
Integer
Integer
Integer
Integer
Object
説明
コントロールに与えられている名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールのサイズを変更します。
コントロールを表示します。
コントロールのデータ型を返します。
RuntimeError オブジェクト
RuntimeError(ランタイムエラー)オブジェクトは、Throwable オブジェ
クトの派生オブジェクトであり、PowerBuilder VM(PB VM)が実行時
エラーの送出に使用します。実行時エラーは、非検査例外と呼ぶこと
もあります。非検査例外の場合は、検査例外と異なり、送出の可能性
のある場所で宣言する必要もありませんし、捕捉する必要もありませ
ん。
RuntimeError が送出されると、その一連のプロパティには、エラーの
発生行に関する実行時情報が自動的に格納されます。RuntimeError が
処理されなかった場合は、Application オブジェクトの SystemError イベ
ントが発生し、グローバルな Error オブジェクトに、実行時情報が格納
されます。
以下の派生型を使用すると、より確実なエラー処理が可能になります。
286
•
DivideByZeroError - 0 による除算を試みると送出されます。
•
NullObjectError - NULL 参照を使用してオブジェクトにアクセス
しようとすると送出されます。
•
PBXRuntimeError - PowerBuilder エクステンションで未知のエラー
が発生した場合に送出されます。
•
CORBASystemException - EAServer から CORBA システム例外が
送出された場合に送出されます。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
•
DWRuntimeError - Error イベントのスクリプトで処理されないデー
タウィンドウ エラーが発生したときに送出されます。
•
OLERuntimeError - ocx_error、ExternalException、または Error イ
ベントのスクリプトで処理されない OLE エラーが発生したときに
送出されます。
標準的な CORBA 例外型にマッピングされるそのほかのオブジェクトは、
CORBASystemException から継承されます。PowerBuilder の例外クラス
の名前は、CORBA の例外名と基本的に同じですが、アンダースコア文字
が追加されます。たとえば、CORBAFreeMem は、CORBA_FREE_MEM
にマッピングされます。
CORBASystemException 型の一覧は、
PowerBuilder
システム ツリーかブラウザで表示できます。
RuntimeError の子孫を使用すると、特定の実行時エラーのみを処理する
ことができます。たとえば、特定のコード ブロックでは NullObjectError
例外のみを捕捉するということが可能になります。また、1 つの CATCH
文 の 中 で す べ て の 実 行 時 エ ラ ー を 捕 捉 す る こ と も で き ま す。
PBXRuntimeError の場合を除き、子孫オブジェクトで利用できるエ
ラー情報は、RuntimeError オブジェクトでも利用できます。
PBXRuntimeError には、追加のプロパティとして DLLName プロパティ
があります。このプロパティは、エラーが発生した PowerBuilder エク
ステンション DLL の名前を示します。
プロパティ
RuntimeError
プロパティ
ClassDefinition
データ型
PowerObject
Class
DLLName
String
String
Line
Number
ObjectName
RoutineName
Text
Integer
Integer
String
String
String
オブジェクトとコントロール
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
例外が発生したクラスの名前です。
(PBXRuntimeError のみ)例外が発生した PowerBuilder エ
クステンション DLL の名前です。
例外が発生した行の番号です。
PowerBuilder エラーの識別に使います。
例外が発生したオブジェクトの名前です。
例外が発生したイベントまたはルーチンの名前です。
例外タイプに関連付けられたテキストです。
287
ScriptDefinition オブジェクト
イベント
RuntimeError イベント
Constructor
Destructor
発生する状況
例外が送出されるとき
例外が送出された直後
関数
RuntimeError 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetMessage
String
GetParent
PostEvent
PowerObject
Boolean
SetMessage
—
TriggerEvent
Integer
TypeOf
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
Throwable 型オブジェクトからエラー メッセージを返し
ます。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
Throwable 型オブジェクト用のエラー メッセージを設定
します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
ScriptDefinition オブジェクト
クラス定義と関連付けられたスクリプトに関する情報です。
ScriptDefinition は ClassDefinition オブジェクトで使用します。
特定のスクリプトに対して ClassDefinition オブジェクトと無関係に
ScriptDefinition オブジェクトのインスタンスを生成できません。
ClassDefinition インスタンスの ScriptList 配列の要素である
ScriptDefinition インスタンスにアクセスしてください。
ScriptDefinition オブジェクトは以下の情報を持っています。
288
•
スクリプト名とそのスクリプトが関数用かイベント用か
•
戻り値の型、引数、ローカル変数
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
•
ソース コード
•
スクリプトがローカルで定義されているか先祖で定義されているか
•
外部関数宣言
ScriptDefinition オブジェクトにはイベントがありません。
プロパティ
ScriptDefinition
プロパティ
Access
データ型
VarAccess
説明
スクリプトのアクセス レベル(そのスクリプトを呼び出
せるオブジェクトの指定)
。値は以下のとおりです。
Private!
Public!
Protected!
System!
AliasName
String
ArgumentList
VariableDefinition
ClassDefinition
PowerObject
EventId
Long
EventIdName
String
ExternalUser
Function
String
IsExternalEvent
Boolean
IsLocallyDefined
Boolean
外部関数に対するエリアス値。エリアスを作成していな
い外部関数のスクリプトの値は空文字列(" ")となりま
す。外部関数宣言の ALIAS FOR キーワードに対応してい
ます。
VariableDefinition オブジェクトを要素とする可変長配列
で、1 つの引数に対して 1 つのオブジェクトがあります。
引数がない場合は配列は空となります。
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
イベントに対する数値イベント ID。ID のないイベント
の場合は -1 です。
イベントに対するイベント ID 名。ID のないイベントの
場合は空文字列(" ")です。
外部ユーザ関数を含む DLL のファイル名。外部ユーザ
関数でないスクリプトの値は空文字列(" ")です。外部
関数宣言の LIBRARY キーワードに対応しています。
外部イベントかどうかを示します。外部イベントは自動
的に生成されてほかの場所にディスパッチされます。
イベントが継承階層のこのレベルで定義できるかどう
かを示します。値は以下のとおりです。
TRUE - このレベルで定義できます。
FALSE - 先祖レベルで定義されます。
IsLocallyDefined は関数に適用できません。
オブジェクトとコントロール
289
ScriptDefinition オブジェクト
ScriptDefinition
プロパティ
IsLocallyScripted
データ型
Boolean
説明
スクリプトを継承階層のこのレベルで実装できるかど
うかを示します。値は以下のとおりです。
TRUE - そのイベントまたは関数のコードはこのレ
ベルにあります。
FALSE - そのイベントまたは関数のコードはこのレ
IsRPCFunction
Boolean
ベルにはありません。
RPC 関数かどうかを示します。値は以下のとおりです。
TRUE - RPC 関数です。
FALSE - RPC 関数ではありません。
IsScripted
Boolean
ストアド プロシージャ宣言の RPCFUNC キーワードに
対応しています。
その定義済みイベントのコードが、折りたたまれた継承
階層のいずれかのレベルにあるかないかを示します。値
は以下のとおりです。
TRUE - そのイベントのスクリプトが継承階層のど
こかのレベルにあります。
FALSE - そのイベントにはスクリプトがありません。
Kind
ScriptKind
LocalVariableList
VariableDefinition
Name
ReturnType
String
TypeDefinition
Source
String
SystemFunction
String
290
イベントは定義できますが、そのスクリプトは書けませ
ん。関数に対して IsScripted は常に TRUE となります。
スクリプトが関数かイベントかを示します。値は以下の
とおりです。
ScriptEvent!
ScriptFunction!
Definition オブジェクトを要素とする可変長配列で、1 つ
のローカル変数に対して 1 つのオブジェクトがありま
す。ローカル変数がない場合は、配列は空となります。
スクリプト名です。
戻り値の型情報。ReturnType は、何も返さないスクリプ
トに対しては無効なオブジェクトです。IsValid 関数を使
用して値をテストしてください。
スクリプトのソース コード。ソースが使用できない場合
(たとえば、実行ファイルを実行しているとき)は、空
文字列(" ")になります。
組み込み PowerBuilder 関数に関しては、その関数を含む
DLL のファイル名。組み込み PowerBuilder 関数でないス
クリプトの値は空文字列(" ")となります。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
ScriptDefinition 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
SimpleTypeDefinition オブジェクト
スカラ変数の型に関する情報。SimpleTypeDefinition は TypeDefinition か
ら継承され、追加のプロパティや関数はありません。
プロパティや関数については、TypeDefinition オブジェクトを参照して
ください。
SingleLineEdit コントロール
SingleLineEdit(シングルライン エディット)コントロールは、ユーザ
にテキストを 1 行入力させるためのテキストボックスです。通常、
SingleLineEdit コントロールは入力フィールドとして使用します。
プロパティ
SingleLineEdit
プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
オブジェクトとコントロール
説明
コントロールに割り当てられたアクセラレータ キーの
ASCII コードです。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
291
SingleLineEdit コントロール
SingleLineEdit
プロパティ
AccessibleRole
AutoHScroll
データ型
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
データの入力や削除が行われたとき、コントロールを自動
的に左右にスクロールするかどうかを示します。値は以下
のとおりです。
TRUE - 自動的にスクロールします。
FALSE - 自動的にスクロールしません。
BackColor
Long
Border
Boolean
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DisplayOnly
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールのテキストを表示専用にし、ユーザが変更で
きないようにするかどうかを示します。値は以下のとおり
です。
TRUE - テキストは表示専用です。
ユーザは変更できま
せん。
FALSE - テキストは変更できます。
292
PowerBuilder
第2章
SingleLineEdit
プロパティ
DragAuto
DragIcon
Enabled
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
String
Boolean
説明
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
FaceName
String
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Height
Integer
オブジェクトとコントロール
コントロールの高さを PowerBuilder 単位系で示します。
293
SingleLineEdit コントロール
SingleLineEdit
プロパティ
HideSelection
データ型
Boolean
説明
コントロールがフォーカスを失っても、選択したテキスト
をハイライト状態にしておくかどうかを示します。値は以
下のとおりです。
TRUE - テキストのハイライト表示は解除されます。
FALSE - テキストはハイライト表示されたままです。
ImeMode
Integer
Italic
Boolean
IME(Input Method Editor)のモード設定を示します。この
プロパティは、日本語版 PowerBuilder 上で実行されている
アプリケーションにのみ適用されます。
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Limit
Integer
Password
Boolean
コントロールに入力可能な最大の文字数を、0 から 32,767
バイトの範囲で示します(0 を指定すると、文字数は無制
限です)。
コントロールをパスワード フィールドにするかどうか
(入力した文字をアスタリスクで表すかどうか)を示しま
す。値は以下のとおりです。
TRUE - パスワード フィールドにします。
FALSE - パスワード フィールドにしません。
Pointer
String
RightToLeft
Boolean
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
TabOrder
Tag
Text
TextCase
294
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
String
コントロールに割り当てるタグの値を示します。
String
コントロールに表示されるテキストを指定します。
TextCase(カタ 入力された英文テキストを大文字と小文字のどちらで表
ログ データ型) 示するかを示します。値は以下のとおりです。
AnyCase!
Lower!
Upper!
Integer
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
SingleLineEdit
プロパティ
TextColor
データ型
Long
TextSize
Integer
Underline
Boolean
説明
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。色についての詳細は、
『PowerScript リファ
レンス』マニュアルの RGB 関数を参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
SingleLineEdit イベント
Constructor
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
オブジェクトとコントロール
295
SingleLineEdit コントロール
SingleLineEdit イベント 発生する状況
Modified
コントロールのテキストが変更されてから〔Enter〕または〔Tab〕などが押
されてフォーカスが別のコントロールに移るとき
Other
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
RButtonDown
コントロールをマウスの右ボタンでクリックしたとき
関数
SingleLineEdit 関数
CanUndo
戻り値のデータ型
Boolean
ClassName
Clear
String
Integer
Copy
Integer
Cut
Integer
Drag
GetContextService
Integer
Integer
GetParent
Hide
Move
Paste
PowerObject
Integer
Integer
Integer
PointerX
PointerY
Position
PostEvent
Integer
Integer
Integer
Boolean
Print
Integer
296
説明
コントロールで最後に行った編集を、Undo 関数によって
元に戻すことができる場合に TRUE を返します。そうでな
い場合は FALSE を返します。
コントロールに与えられている名前を返します。
選択されたテキスト(選択されたものがあれば)をコント
ロールから削除します(テキストはクリップボードにコ
ピーされません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールからクリップボードにコピーします(ただし、削除
はしません)。
選択されたテキスト(選択されたものがあれば)をコント
ロールから切り取り(削除し)、クリップボードにコピー
します。
コントロールのドラッグを開始、または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
クリップボードの内容(保持されているものがあれば)を、
コントロールの挿入ポイントの位置に挿入します。テキス
トが選択されていれば、そのテキストは Paste 関数によっ
て置き換えられます。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロール内の挿入ポイントの位置を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
SingleLineEdit 関数
ReplaceText
戻り値のデータ型
Integer
Resize
SelectedLength
Integer
Integer
SelectedStart
Integer
SelectedText
String
SelectText
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Undo
Object
Integer
説明
コントロール内で選択されたテキストを指定された文字
列と置き換えます。テキストが選択されていない場合は、
その文字列を挿入ポイントの位置に挿入します。
コントロールのサイズを変更します。
コントロール内で選択されているテキストの長さを返し
ます。
コントロール内で選択されているテキストの開始位置を
返します。
コントロール内で選択されているテキストの文字列を返
します。
開始位置と長さで指定されたコントロールの中にあるテ
キストを選択します。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
コントロールで最後に行った編集内容を元に戻します。
SSLCallBack オブジェクト
SSLCallBack オブジェクトは、PowerBuilder クライアントが EAServer
からのコールバックを処理することを可能にします。
プロパティ
SSLCallBack プロパティ データ型
ClassDefinition
PowerObject
オブジェクトとコントロール
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
297
SSLCallBack オブジェクト
イベント
SSLCallBack イベント
Constructor
Destructor
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
関数
SSLCallBack 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetCertificateLabel
String
GetCredentialAttribute
String
GetParent
GetPin
PostEvent
PowerObject
String
Boolean
TriggerEvent
Integer
TrustVerify
Long
TypeOf
Object
298
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
関数に引数として渡された証明書ラベル リストから、使
用する証明書ラベルを SSL クライアントが選択できるよ
うにします。
SSL クライアントがユーザ アカウント情報を動的に提供
できるようにします。
親オブジェクト名への参照を返します。
SSL 接続で使用する PIN を取得します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
使用する証明書チェーンを SSL クライアントが承認でき
るようにします。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
SSLServiceProvider オブジェクト
SSLServiceProvider オブジェクトは、PowerBuilder クライアントから
EAServer への Secure Sockets Layer(SSL)接続を確立できるようにし
ます。
プロパティ
SSLServiceProvider
プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
イベント
SSLServiceProvider
イベント
Constructor
Destructor
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
関数
SSLServiceProvider
関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetGlobalProperty
GetParent
PostEvent
String
PowerObject
Boolean
SetGlobalProperty
TriggerEvent
Long
Integer
TypeOf
Object
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
SSL グローバル プロパティの値を返します。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
SSL グローバル プロパティの値を設定します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
299
StaticHyperLink コントロール
StaticHyperLink コントロール
StaticHyperLink(ス タ テ ィ ッ ク ハ イ パ ー リ ン ク)コ ン ト ロ ー ル は、
StaticText コントロールの子孫です。StaticHyperLink コントロールの
URL プロパティを使用すると、Web ページへのホット リンクを設定で
きます。このコントロールをユーザがクリックすると、ユーザの Web
ブラウザが開いて、指定のページが表示されます。
使用上の注意
ユーザのブラウザで URL 補完機能がサポートされている場合は、
sybase.com のようにアドレスの一部のみを入力することができます。
また http://www.sybase.com のように完全なアドレスを入力すること
もできます。
プロパティ
StaticHyperLink
プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
Alignment
AccessibleRole
(カタログ デー
タ型)
Alignment
(カタログ デー
タ型)
BackColor
Long
Border
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロール内にあるテキストの水平方向の位置の揃え
方を示します。値は以下のとおりです。
Left!
Center!
Right!
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
300
PowerBuilder
第2章
StaticHyperLink
プロパティ
BorderColor
BorderStyle
BringToTop
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Long
BorderStyle
(カタログ デー
タ型)
Boolean
説明
コントロールの枠線に使用される色を -2 から 16,777,215
の範囲の数値で示します。
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DisabledLook
DragAuto
Boolean
Boolean
DragIcon
Enabled
String
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを有効時の表示にするかどうかを示します。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
FaceName
String
オブジェクトとコントロール
コントロールのテキスト表示に使用する字体の名前(たと
えば ARIAL や COURIER など)を示します。
301
StaticHyperLink コントロール
StaticHyperLink
プロパティ
FillPattern
FocusRectangle
データ型
FillPattern
(カタログ デー
タ型)
Boolean
説明
コントロールを塗りつぶすために使用するハッチ パター
ンを示します。値は以下のとおりです。
BDiagonal!
Diamond!
FDiagonal!
Horizontal!
Solid!
Square!
Vertical!
FDiagonal! は左上から右下への斜線です。BDiagonal! は左
下から右上への斜線です。
コントロールにフォーカスがあるとき、コントロールを破
線の長方形(フォーカスを表す長方形)で囲むかどうかを
示します。値は以下のとおりです。
TRUE - コントロールにフォーカスがあるときに、
破線
の長方形で囲みます。
FALSE - コントロールにフォーカスがあるときに、破
FontCharSet
FontCharSet
(カタログ デー
タ型)
FontFamily
FontFamily
(カタログ デー
タ型)
FontPitch
Height
Italic
線の長方形で囲みません。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
302
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
StaticHyperLink
プロパティ
Pointer
データ型
String
RightToLeft
Boolean
説明
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
TabOrder
Integer
Tag
Text
TextColor
String
String
Long
TextSize
Integer
Underline
Boolean
コントロールのタブ値(順序)を配置されているウィンド
ウに対して示します(0 を指定すると、コントロールにタ
ブ移動できません)。
コントロールに割り当てるタグの値を示します。
コントロールに表示されるテキストを指定します。
コントロール内のテキストに使用する色を -2 から
16,777,215 の範囲の数値で示します。色についての詳細
は、『PowerScript リファレンス』マニュアルの RGB 関数
を参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
URL
String
Visible
Boolean
テキスト コントロールがクリックされたときにユーザの
Web ブラウザで開く URL を示します(ただし、Clicked イ
ベントのコードが記述されていない場合)。マウス ポイン
タがコントロールの上を通過すると、状態テキストに
URL が表示されます。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
Integer
X
Integer
オブジェクトとコントロール
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールを格納する長方形のボックスの幅をピクセ
ル値で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
303
StaticHyperLink コントロール
StaticHyperLink
プロパティ
Y
データ型
Integer
説明
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
StaticHyperLink
イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
発生する状況
コントロールがクリックされたとき(選択されたとき)
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されて、アクティブ状態に
なるとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
関数
StaticHyperLink 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
PowerObject
Hide
Move
PointerX
Integer
Integer
Integer
304
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
StaticHyperLink 関数
PointerY
PostEvent
戻り値のデータ型
Integer
Boolean
Print
Resize
Integer
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
説明
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールを格納している長方形のサイズを変更しま
す。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
StaticText コントロール
StaticText(スタティック テキスト)コントロールは表示テキストです。
エンドユーザは StaticText を選択することができますが、これをキー
ボードから修正することはできません。StaticText は、スクリプトで明
示的に修正できます。
プロパティ
StaticText プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
AccessibleRole
(カタログ デー
タ型)
オブジェクトとコントロール
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
305
StaticText コントロール
StaticText プロパティ
Alignment
データ型
Alignment
(カタログ デー
タ型)
BackColor
Long
Border
Boolean
説明
コントロール内にあるテキストの水平方向の位置の揃え
方を示します。値は以下のとおりです。
Left!
Center!
Right!
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
BorderColor
BorderStyle
BringToTop
Long
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線に使用される色を -2 から 16,777,215
の範囲の数値で示します。
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DisabledLook
DragAuto
Boolean
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを有効時の表示にするかどうかを示します。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
306
PowerBuilder
第2章
StaticText プロパティ
DragIcon
Enabled
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
String
Boolean
説明
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
FaceName
FillPattern
FocusRectangle
String
FillPattern
(カタログ デー
タ型)
Boolean
コントロールのテキスト表示に使用する字体の名前(たと
えば ARIAL や COURIER など)を示します。
コントロールを塗りつぶすために使用するハッチ パター
ンを示します。値は以下のとおりです。
BDiagonal!
Diamond!
FDiagonal!
Horizontal!
Solid!
Square!
Vertical!
FDiagonal! は左上から右下への斜線です。BDiagonal! は左
下から右上への斜線です。
コントロールにフォーカスがあるとき、コントロールを破
線の長方形(フォーカスを表す長方形)で囲むかどうかを
示します。値は以下のとおりです。
TRUE - コントロールにフォーカスがあるときに、
破線
の長方形で囲みます。
FALSE - コントロールにフォーカスがあるときに、破
FontCharSet
FontCharSet
(カタログ デー
タ型)
オブジェクトとコントロール
線の長方形で囲みません。
コントロール内のテキストに使用されるフォント文字
セットを示します。指定可能な値の一覧については、オブ
ジェクト ブラウザの[カタログデータ型]タブにある
FrontCharSet 変数リストを参照してください。
307
StaticText コントロール
StaticText プロパティ
FontFamily
FontPitch
Height
Italic
データ型
FontFamily
(カタログ デー
タ型)
説明
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロールのテキストに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
Pointer
String
RightToLeft
Boolean
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
TabOrder
Integer
Tag
Text
TextColor
String
String
Long
TextSize
Integer
308
コントロールのタブ値(順序)を配置されているウィンド
ウに対して示します(0 を指定すると、コントロールにタ
ブ移動できません)。
コントロールに割り当てるタグの値を示します。
コントロールに表示されるテキストを指定します。
コントロール内のテキストに使用する色を -2 から
16,777,215 の範囲の数値で示します。色についての詳細
は、
『PowerScript リファレンス』マニュアルの RGB 関数を
参照してください。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
PowerBuilder
第2章
StaticText プロパティ
Underline
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
Integer
X
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールを格納する長方形のボックスの幅をピクセ
ル値で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
StaticText イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LoseFocus
Other
RButtonDown
発生する状況
コントロールがクリックされたとき(選択されたとき)
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロールがダブルクリックされたとき(選択されて、アクティブ状態に
なるとき)
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
オブジェクトとコントロール
309
StaticText コントロール
関数
StaticText 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
Integer
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
310
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールを格納している長方形のサイズを変更しま
す。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
Tab コントロール
Tab(タブ)コントロールは、複数のタブ ページ(コントロールを含
んでいるユーザ オブジェクト)から構成されています。タブ ページ
は、Tab コントロールの中で定義するか、あるいはユーザ オブジェク
ト ペインタで定義したものを、Tab コントロールに挿入します。
タブ ページは、それぞれ固有のラベル、ピクチャ、背景色を持つこと
ができます。
Tab コントロール上のタブ ページのフォント設定は、すべて共通です。
タブ ページのタブ(つまみ)の表示位置は、TabPosition プロパティに
よって決定されます。タブは、Tab コントロールの周囲の 4 辺のうち
の 1 辺に表示できます。TabPosition プロパティで、上下または左右を
組み合わせた位置を指定すると、現行タブ ページを境にその前後のタ
ブが向かい合う形で表示されます。
プロパティ
Tab プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
Alignment
AccessibleRole
(カタログ デー
タ型)
Alignment
(カタログ デー
タ型)
BackColor
Long
BoldSelectedText
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
すべてのタブに対する、テキスト ラベルの水平方向の位
置揃えを示します。値は以下のとおりです。
Left!
Center!
Right!
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
選択されたタブのテキスト ラベルを太字で表示するかど
うかを示します。値は以下のとおりです。
TRUE - 太字で表示します。
FALSE - ほかのタブと同じ設定で表示します。
オブジェクトとコントロール
311
Tab コントロール
Tab プロパティ
BringToTop
データ型
Boolean
説明
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
CreateOnDemand
Boolean
Control[ ]
UserObject
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
Tab コントロールの作成時に、すべてのタブ ページ上にコ
ントロールのグラフィック表現が作成されるようにする
かどうかを示します。値は以下のとおりです。
TRUE - タブ ページが選択されるまでは、タブ ページ
のグラフィック表現を作成しません。
FALSE -(デフォルト)Tab コントロールの作成時に、
すべてのタブ ページのグラフィック表現を作成しま
す。
Tab コントロール内におけるタブ ページを配列で示しま
す。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
FaceName
312
String
タブのテキスト ラベルを表示する字体名を示します。た
とえば、Arial や Courier です。垂直タブでは、TrueType
フォントだけが正しく表示されます。
PowerBuilder
第2章
Tab プロパティ
FixedWidth
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
タブの幅を固定するかどうかを示します。固定幅にする
と、テキスト ラベルの長さに合わせて幅を狭くはできま
せん。値は以下のとおりです。
TRUE - タブを固定幅とします。
幅は最長のテキストの
長さになります。
FALSE - タブはテキスト ラベルの長さに合わせて調整
FocusOnButtonDown
Boolean
されます。
ユーザがタブをクリックしたときに、そのタブにフォーカ
スを与えるかどうかを示します。値は以下のとおりです。
TRUE - ユーザがクリックしたタブにフォーカスが移
ります。タブは点線の長方形で囲まれます。
FALSE - タブにフォーカスは移りません。
どちらの場合も、選択されたタブ ページが前面に表示さ
れます。
FontCharSet
FontFamily
FontPitch
Height
Italic
このプロパティが FALSE に設定されていても、このタブ
を 2 回目以降にクリックしたときにはフォーカスされて
いることを示す点線の長方形が表示されます。
FontCharSet
タブのテキスト ラベルに使用されるフォント文字セットを
(カタログ デー 示します。指定可能な値の一覧については、オブジェクト
タ型)
ブラウザの[カタログデータ型]タブにある FrontCharSet
変数リストを参照してください。
FontFamily
タブのテキスト ラベルに使用されるフォント ファミリ
(カタログ デー (タイプ スタイル)を示します。値は以下のとおりです。
タ型)
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ タブのテキスト ラベルに使用されるフォントのピッチ
ログ データ型) (間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Integer
コントロールの高さを PowerBuilder 単位系で示します。
Boolean
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキスト ラベルを斜体にします。
FALSE - テキスト ラベルを斜体にしません。
オブジェクトとコントロール
313
Tab コントロール
Tab プロパティ
Multiline
データ型
Boolean
説明
タブを複数行で表示できるようにするかどうかを示しま
す。値は以下のとおりです。
TRUE - タブ全体を 1 行で表示するスペースがない場
合、複数行で表示します。
FALSE - タブ全体を 1 行で表示するスペースがない場
PerpendicularText
PictureOnRight
Boolean
Boolean
合、入りきらない部分を双方向矢印のコントロールを
使ってスクロールできるように表示します。
テキスト ラベルをタブ ページに対して縦書きに表示する
かどうかを示します。値は以下のとおりです。
TRUE - テキストをタブ ページのふちに対して縦書き
に表示します。この結果としてタブ幅は狭くなります。
FALSE - テキストをタブ ページのふちに沿って横書き
に表示します。この結果としてタブ幅は広くなります。
タブ ラベルの一部であるピクチャをテキストの左右どち
らに表示するかを示します。値は以下のとおりです。
TRUE - ピクチャをテキストの右側に表示します。
FALSE - ピクチャをテキストの左側に表示します。
Pointer
String
PowerTips
Boolean
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
マウスのポインタがタブ上に位置するとき、PowerTips
(タブのポップアップ ラベル)として タブ ページの
PowerTipText を表示するかどうかを示します。PowerTips
は、タブ ラベルがピクチャである場合に効果的です。値
は以下のとおりです。
TRUE - 各タブのポップアップ ラベルとして、
RaggedRight
Boolean
SelectedTab
Integer
ShowPicture
Boolean
PowerTipText があれば、それを表示します。
FALSE - PowerTips を表示しません。
タブの幅を広げてコントロールの幅に一致するように表
示するかどうかを示します。値は以下のとおりです。
TRUE - タブの幅はタブのテキスト ラベルと FixedWidth
プロパティによって決められる幅のままとなります。
FALSE - タブの幅をコントロールの幅に一致させます。
選択されたタブのインデックス番号を示します。デフォル
ト値は 1 で、整数の値は 1 ~ N の範囲でなければなりま
せん。ここで N はタブ ページの数です。
各タブに選択されたピクチャを表示するかどうかを示し
ます。値は以下のとおりです。
TRUE - タブのピクチャを表示します。
FALSE - タブのピクチャを表示しません。
314
PowerBuilder
第2章
Tab プロパティ
ShowText
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
各タブに指定されたテキストを表示するかどうかを示し
ます。値は以下のとおりです。
TRUE - 各タブのテキストを表示します。
FALSE - 各タブのテキストを表示しません。
TabOrder
Integer
TabPosition
TabPosition(カ
タログ データ
型)
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
タブを Tab コントロール上のどこに配置するかを示しま
す。値は以下のとおりです。
• TabsOnBottom! - すべてのタブを下部に配置します。
• TabsOnBottomAndTop! - 選択されているタブよりも前
にあるタブを上部に配置し、選択されているタブとそ
のタブよりも後ろにあるタブを下部に配置します。
• TabsOnLeft! - すべてのタブを左側に配置します。
• TabsOnLeftAndRight! - 選択されているタブ自体とその
タブよりも前にあるタブを左側に配置し、選択されてい
るタブよりも後ろにあるタブを右側に配置します。
• TabsOnRight! - すべてのタブを右側に配置します。
• TabsOnRightAndLeft! - 選択されているタブよりも前に
あるタブを左側に配置し、選択されているタブ自体とそ
のタブよりも後ろにあるタブを右側に配置します。
• TabsOnTop! - すべてのタブを上部に配置します。
Tag
TextSize
String
Integer
Underline
Boolean
• TabsOnTopAndBottom! - 選択されているタブ自体とそ
のタブよりも前にあるタブを上部に配置し、選択され
ているよりも後ろにあるタブを下部に配置します。
コントロールに割り当てるタグの値を示します。
コントロール中のテキスト サイズをポイント数で示しま
す。以前のバージョンとの互換性を保つため、サイズは負
の値で扱われます。たとえば 10 ポイントのテキスト サイ
ズは -10 として保存されます。
タブのテキストに下線を引くかどうかを指定します。値は
以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - 表示できます。
FALSE - 表示できません。
Weight
Integer
オブジェクトとコントロール
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
315
Tab コントロール
Tab プロパティ
Width
X
データ型
Integer
Integer
Y
Integer
説明
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
Tab イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
Key
LoseFocus
Other
RightClicked
RightDoubleClicked
316
発生する状況
タブ ページの表示領域以外の場所で、Tab コントロールがクリックされた
とき。そのタブ ページでは、ユーザ オブジェクトの Clicked イベント
(pbm_bnclicked)が起動されます。
ウィンドウの Open イベントが発生する直前に、そのオブジェクトが作成さ
れるとき
ウィンドウの Close イベントが発生した直後に、そのオブジェクトが破棄さ
れるとき
タブ ページの表示領域以外の場所で、Tab コントロールがダブルクリックさ
れたとき。そのタブ ページでは、ユーザ オブジェクトの DoubleClicked イベ
ント(pbm_bndoubleclicked)が起動されます。
コントロール上にドラッグ中のコントロールがドロップされるとき
ドラッグ中のコントロールがコントロール上(表示領域の周りの細い枠を含
めて)に入るとき
ドラッグ中のコントロールがコントロールから離れるとき(タブ ページ表
示領域に入ったときを含めて)
ドラッグ中のコントロールがコントロール内にあるとき(ただし、タブ ペー
ジ表示領域外で)
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
ユーザがキーを押すとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
タブ ページの表示領域以外の場所で、Tab コントロールがマウスの右ボタン
でクリックされたとき。タブ ページ上で右クリックされたときは、タブ ペー
ジのユーザ オブジェクトで RButtonDown イベントが起動されます。
タブ ページの表示領域以外の場所で、Tab コントロールがマウスの右ボタン
でダブルクリックされたとき。そのタブ ページでは、ユーザ オブジェクト
の RightDoubleClicked イベント(pbm_rbuttondblclk)が起動されます。
PowerBuilder
第2章
Tab イベント
SelectionChanged
SelectionChanging
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
発生する状況
別のタブに選択が変更された直後。SelectionChanged イベントは、タブが生
成されて最初の設定が行われるときにも起動します。
別のタブに選択が変更される直前。選択されたタブへの変更を取り止める
には、このイベントのスクリプトでリターン コードに 1 を戻します。
SelectionChanging イベントは、タブが作成されて最初に選択が行われたと
きにも発生します。
関数
Tab 関数
ClassName
CloseTab
戻り値のデータ型
String
Integer
説明
コントロールに与えられている名前を返します。
Drag
GetContextService
Integer
Integer
GetParent
Hide
Move
MoveTab
PowerObject
Integer
Integer
Integer
OpenTab
Integer
OpenTabWithParm
Integer
PointerX
PointerY
PostEvent
Integer
Integer
Integer
Print
Integer
Resize
Integer
SelectTab
SetFocus
SetPosition
Integer
Integer
Integer
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
Tab コントロールの親への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
指定されたタブ順序に従い、新しい位置にタブを移動しま
す。
指定されたユーザ オブジェクトをタブ ページとして開
き、そのプロパティにスクリプトでアクセスできるように
します。
ユーザ オブジェクトをタブ ページとして開き、そのプロ
パティにスクリプトでアクセスできるようにします。ま
た、パラメータを Message オブジェクトに格納します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
指定されたオブジェクトのイベント キューの最後に指定
したイベントを追加します。
コントロールの内容を現行プリンタに送信します。ページ
範囲、そのほかの設定を指定できます。
タブ ページのサイズを幅と高さの引数で指定されたサイ
ズに変更します。
タブ ページを選択します。
Tab コントロールにフォーカスを設定します。
コントロールを、常時、ウィンドウ画面の前面に表示する
かどうかを指定します。
オブジェクトとコントロール
OpenTab 関数で開かれたタブ ページを閉じます。
317
Throwable オブジェクト
Tab 関数
SetRedraw
Show
TabPostEvent
戻り値のデータ型
Integer
Integer
Integer
TabTriggerEvent
Integer
TriggerEvent
Integer
TypeOf
Object
説明
コントロールを自動再描画するかどうかを制御します。
コントロールを表示します。
各タブ ページに対し、メッセージ キューの最後にイベン
トを追加します。
すべてのタブ ページにイベントを送り、そのイベントに関
連付けられたスクリプトをタブ ページごとに実行します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
Throwable オブジェクト
Throwable データ型は、すべての Throwable オブジェクトの基本クラス
です。Throwable オブジェクトには、Exception オブジェクトや Error オ
ブジェクトなどがあります。
プロパティ
Throwable プロパティ
ClassDefinition
データ型
PowerObject
Text
String
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
エラー メッセージのテキストを保持します。
イベント
Throwable イベント
Constructor
Destructor
318
発生する状況
例外が送出されたとき
例外が送出された直後
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
Throwable 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetMessage
String
GetParent
PostEvent
PowerObject
Boolean
SetMessage
-
TriggerEvent
Integer
TypeOf
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
Throwable 型オブジェクトからエラー メッセージを返し
ます。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
Throwable 型オブジェクト用のエラー メッセージを設定
します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
Timing オブジェクト
Timing は、Timer イベントをウィンドウに関連付けることができない
ときに使用する非ビジュアル システム オブジェクトです。Timing(タ
イミング)オブジェクトを使用するには、Timing システム クラスから
継承される標準クラス ユーザ オブジェクトを作成して、継承された
Timing オブジェクトをインスタンス化しておきます。
プロパティ
Timing プロパティ
ClassDefinition
データ型
PowerObject
Interval
Double
Running
Boolean
オブジェクトとコントロール
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
(読み出し専用)Timer イベントの呼び出しと呼び出しの間
に Timing オブジェクトが待つ最低時間(秒)。このプロパ
ティの初期設定値は NULL ですが、Start 関数が呼び出され
るたびに変更されます。
(読み出し専用)Timing オブジェクトがすでに開始されて
いて現在実行中の場合は TRUE、Timing オブジェクトが実
行されていない場合は FALSE となります。
319
TraceActivityNode オブジェクト
イベント
Timing イベント
Constructor
Destructor
Timer
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
Start 関数が呼び出された後、指定された秒数が経過したとき
関数
Timing 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
PostEvent
PowerObject
Boolean
Start
Integer
Stop
TriggerEvent
Integer
Integer
TypeOf
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
指定された間隔で Timing オブジェクトをアクティブ化し
ます。
Timing オブジェクトを非アクティブ化します。
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
TraceActivityNode オブジェクト
TraceActivityNode オブジェクトは、トレース ファイルで使用される
ノードについて、ノードで表されたアクティビティの種類やそのほか
の情報を提供します。TraceActivityNode オブジェクトは TraceFile オブ
ジェクトとともに使用します。
TraceActivityNode オブジェクトには、イベントはありません。
320
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
TraceActivityNode
プロパティ
ActivityType
Category
データ型
TraceActivity
(カタログ デー
タ型)
TraceCategory
(カタログ デー
タ型)
ClassDefinition
PowerObject
TimerValue
Decimal
説明
カタログ データ型 TraceActivity は、ノードで表されたア
クティビティを識別します。値は以下のとおりです。
ActBegin! - ログの開始と終了
ActError! - システム エラーと警告の発生
ActESQL! - 埋め込み SQL 文のエントリと終了
ActGarbageCollect! - ガベージ コレクションの開始と
終了
ActLine! - ルーチン行のヒット
ActObjectCreate! - オブジェクトの作成
ActObjectDestroy! - オブジェクトの破棄
ActRoutine! - ルーチンのエントリと終了
ActUser! - 選択されたアクティビティの発生
ノードで表されたアクティビティの項目。値は以下のとお
りです。
TraceAtomic! - ノードは 1 つの文で発生したアクティ
ビティです。
TraceIn! - ノードはいくつかの文にまたがるアクティ
ビティの開始を表します。
TraceOut! - ノードはいくつかの文にまたがるアク
ティビティの終了を表します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
アクティビティが発生したときのタイマー値(秒数)です。
関数
TraceActivityNode 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object(カタロ
グ データ型)
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
321
TraceBeginEnd オブジェクト
TraceBeginEnd オブジェクト
TraceBeginEnd オブジェクトは、ログの開始または終了の発生として識
別される、トレース ファイル内のノードに関する情報を提供します。
TraceBeginEnd オブジェクトの追加プロパティにアクセスするには、ア
クティビティの種類が ActBegin! である TraceActivityNode オブジェク
トを TraceBeginEnd オブジェクトに割り当てます。
TraceBeginEnd オブジェクトには、イベントはありません。
プロパティ
TraceBeginEnd
プロパティ
ActivityType
Category
データ型
TraceActivity
(カタログ デー
タ型)
TraceCategory
(カタログ デー
タ型)
ClassDefinition
PowerObject
Message
String
TimerValue
Decimal
説明
ActBegin! は、ノードで表されたアクティビティをログの
開始または終了の発生として識別する値です。
ノードで表されたアクティビティの項目。値は以下のとお
りです。
TraceIn! - ノードはいくつかの文にまたがるアクティ
ビティの開始を表します。
TraceOut! - ノードはいくつかの文にまたがるアク
ティビティの終了を表します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
TraceBegin 関数に渡されるメッセージ。TraceEnd 関数で
は、値は " " となります。
アクティビティが発生したときのタイマー値(秒数)です。
関数
TraceBeginEnd 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
322
Object(カタロ
グ データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
TraceError オブジェクト
TraceError オブジェクトは、システム エラーまたは警告の発生として
識別される、トレース ファイル内のノードに関する情報を提供しま
す。これにはエラー メッセージや重要度レベルに関する情報も含まれ
ます。TraceError オブジェクトの追加のプロパティにアクセスするに
は、アクティビティの種類が ActError! である TraceActivityNode オブ
ジェクトを TraceError オブジェクトに割り当てます。
TraceError オブジェクトには、イベントはありません。
プロパティ
TraceError プロパティ
ActivityType
Category
ClassDefinition
データ型
TraceActivity
(カタログ デー
タ型)
TraceCategory
(カタログ デー
タ型)
PowerObject
Message
String
Severity
Long
TimerValue
Decimal
説明
ActError! は、ノードで表されたアクティビティをシステ
ム エラーまたは警告の発生として識別する値です。
TraceAtomic! は、ノードが 1 つの文で発生したアクティビ
ティであることを示す値です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
システム エラー メッセージまたは TraceError 関数に渡さ
れたメッセージです。
システム エラーの重要度または TraceError 関数に渡され
た重要度の引数です。
アクティビティが発生したときのタイマー値(秒数)です。
関数
TraceError 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object(カタロ
グ データ型)
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
323
TraceESQL オブジェクト
TraceESQL オブジェクト
TraceESQL オブジェクトは、Embedded SQL(ESQL)文の発生として
識別される、トレース ファイル内のノードに関する情報を提供しま
す。TraceESQL オブジェクトの追加のプロパティにアクセスするには、
アクティビティの種類が ActESQL! である TraceActivityNode オブジェ
クトを TraceESQL オブジェクトに割り当てます。
TraceESQL オブジェクトには、イベントはありません。
プロパティ
TraceESQL プロパティ
ActivityNode
データ型
TraceActivity
Category
TraceCategory
ClassDefinition
PowerObject
Name
TimerValue
String
Decimal
説明
ActESQL! は、ノードで表されたアクティビティを ESQL
文のエントリまたは終了の発生として識別する値です。
ノードで表されたアクティビティの項目。値は以下のとお
りです。
TraceIn! - ノードはいくつかの文にまたがるアクティ
ビティの開始を表します。
TraceOut! - ノードはいくつかの文にまたがるアク
ティビティの終了を表します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
ESQL 文の名前です。
アクティビティが発生したときのタイマー値(秒数)です。
関数
TraceESQL 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
324
Object(カタロ
グ データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
TraceFile オブジェクト
TraceFile オブジェクトを使うと PowerBuilder アプリケーションから作
成したトレース ファイルの内容にアクセスすることができます。Profiling
オブジェクトや TraceTree オブジェクトと違って TraceFile オブジェク
トは解析モデルを作成するためのプロパティおよび関数を提供しません。
TraceFile オブジェクトは、TraceActivityNode、TraceBeginEnd、TraceError、
TraceESQL、TraceGarbageCollect、TraceLine、TraceObject、TraceRoutine、
および TraceUser オブジェクトとともに使用します。
TraceFile オブジェクトには、イベントはありません。
プロパティ
TraceFile プロパティ
ApplicationName
データ型
String
ClassDefinition
PowerObject
CollectionTime
Decimal
LastError
NumberOfActivities
FileName
ErrorReturn
(カタログ デー
タ型)
Long
String
説明
トレース ファイルの生成に使用したアプリケーションの
名前です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
トレース データの収集にかかった時間(秒)。この時間は
トレース ファイルからのタイムスタンプの中ですでに考
慮されています。つまり、タイムスタンプがトレース ファ
イルに入れられる前に適切な時間がタイムスタンプから
差し引かれています。ファイルが開いていない場合は
NULL が返されます。
直前に発生したエラーのエラー コードです。
トレース ファイルにあるアクティビティの数です。
開いているトレース ファイルの名前。ファイルが開いて
いないと、その値は空になります。
関数
TraceFile 関数
ClassName
Close
戻り値のデータ型
String
ErrorReturn
(カタ
ログ データ型)
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
開いているトレース ファイルを閉じます。
325
TraceGarbageCollect オブジェクト
TraceFile 関数
GetContextService
戻り値のデータ型
Integer
GetParent
NextActivity
PowerObject
TraceActivityNode
Open
ErrorReturn
(カタ
ログ データ型)
ErrorReturn
(カタ
ログ データ型)
Object(カタログ
データ型)
Reset
TypeOf
説明
指定されたサービスのコンテキストに固有のインスタ
ンスへの参照を作成します。
親オブジェクト名への参照を返します。
トレース ストリーム内の次のアクティビティを提供し
ます。これ以上はアクティビティがない場合、または
ファイルが開いていない場合は、無効なオブジェクトが
返されます。発生したエラーの種類を確認するには、
LastError プロパティを使用します。
渡された名前を持つトレース ファイルを読み込み専用
で開きます。
ストリームをトレース ファイルの先頭にリセットしま
す。
オブジェクトのデータ型を返します。
TraceGarbageCollect オブジェクト
TraceGarbageCollect オブジェクトは、ガベージ コレクションの発生と
して識別される、トレース ファイル内のノードに関する情報を提供し
ます。TraceGarbageCollect オブジェクトの追加のプロパティにアクセ
ス す る に は、ア ク テ ィ ビ テ ィ の 種 類 が ActGarbageCollect! で あ る
TraceActivityNode オブジェクトを TraceGarbageCollect オブジェクトに
割り当てます。
TraceGarbageCollect オブジェクトには、イベントはありません。
326
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
TraceGarbageCollect
プロパティ
ActivityType
Category
データ型
TraceActivity
(カタログ デー
タ型)
TraceCategory
(カタログ デー
タ型)
ClassDefinition
PowerObject
TimerValue
Decimal
説明
ActGarbageCollect! は、ノードで表されたアクティビティ
をガベージ コレクションの開始または終了の発生として
識別する値です。
ノードで表されたアクティビティの項目。値は以下のとお
りです。
TraceIn! - ノードはいくつかの文にまたがるアクティ
ビティの開始を表します。
TraceOut! - ノードはいくつかの文にまたがるアク
ティビティの終了を表します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
アクティビティが発生したときのタイマー値(秒数)です。
関数
TraceGarbageCollect
関数
ClassName
GetContextService
GetParent
TypeOf
戻り値のデータ型
String
Integer
PowerObject
Object(カタロ
グ データ型)
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
327
TraceLine オブジェクト
TraceLine オブジェクト
TraceLine オブジェクトは、
ルーチン行のヒットの発生として識別される、
トレース ファイル内のノードに関する情報を提供します。TraceLine オブ
ジェクトの追加のプロパティにアクセスするには、アクティビティの種
類が ActLine! である TraceActivityNode オブジェクトを TraceLine オブ
ジェクトに割り当てます。
TraceLine オブジェクトには、イベントはありません。
プロパティ
TraceLine プロパティ
ActivityType
Category
ClassDefinition
LineNumber
TimerValue
データ型
TraceActivity
(カタログ デー
タ型)
TraceCategory
(カタログ デー
タ型)
PowerObject
UnsignedLong
Decimal
説明
ActLine! は、ノードで表されたアクティビティをルーチン
行のヒットの発生として識別する値です。
TraceAtomic! は、ノードが 1 つの文で発生したアクティビ
ティであることを示す値です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
行番号です。
アクティビティが発生したときのタイマー値(秒数)です。
関数
TraceLine 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
328
Object(カタロ
グ データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
TraceObject オブジェクト
TraceObject オブジェクトは、オブジェクトの作成または破棄として識
別される、トレース ファイル内のノードに関する情報を提供します。
TraceObject オブジェクトの追加のプロパティにアクセスするには、ア
クティビティの種類が ActObjectCreate! または ActObjectDestroy! であ
る TraceActivityNode オブジェクトを TraceObject オブジェクトに割り
当てます。TraceObject オブジェクトには、イベントはありません。
プロパティ
TraceObject プロパティ
ActivityType
データ型
TraceActivity
(カタログ デー
タ型)
Category
TraceCategory
(カタログ デー
タ型)
ClassDefinition
PowerObject
ClassName
String
IsCreate
Boolean
LibraryName
String
ObjectID
TimerValue
UnsignedLong
Decimal
オブジェクトとコントロール
説明
ActObjectCreate! は、ノードで表されたアクティビティをオ
ブジェクトの作成として識別する値です。ActObjectDestroy!
は、ノードで表されたアクティビティをオブジェクトの破
棄として識別する値です。
ノードで表されたアクティビティの項目。値は以下のとお
りです。
TraceIn! - ノードはいくつかの文にまたがるアクティ
ビティの開始を表します。
TraceOut! - ノードはいくつかの文にまたがるアク
ティビティの終了を表します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
オブジェクト型のクラスの名前です。ネストされたクラス
(たとえば、ウィンドウ上のコントロール)には、class
name`embedded class name という書式の名前が付きます。
ノードがオブジェクトの作成を表す場合は TRUE、オブ
ジェクトの破棄を表す場合には FALSE となります。
オブジェクトのクラスを含むライブラリの名前。システム
クラスの場合は、値は " " となります。
オブジェクトの固有の識別子です。
アクティビティが発生したときのタイマー値(秒数)です。
329
TraceRoutine オブジェクト
関数
TraceObject 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object(カタロ
グ データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
TraceRoutine オブジェクト
TraceRoutine オブジェクトは、ルーチンの発生として識別される、ト
レース ファイル内のノードに関する情報を提供します。TraceRoutine
オブジェクトの追加のプロパティにアクセスするには、アクティビ
ティの種類が ActRoutine! である TraceActivityNode オブジェクトを
TraceRoutine オブジェクトに割り当てます。TraceRoutine オブジェクト
には、イベントはありません。
プロパティ
TraceRoutine プロパティ
ActivityType
Category
データ型
TraceActivity
(カタログ デー
タ型)
TraceCategory
(カタログ デー
タ型)
ClassDefinition
PowerObject
ClassName
String
330
説明
ActRoutine! は、ノードで表されたアクティビティをルー
チン エントリまたは終了の発生として識別する値です。
ノードで表されたアクティビティの項目。値は以下のとお
りです。
TraceIn! - ノードはいくつかの文にまたがるアクティ
ビティの開始を表します。
TraceOut! - ノードはいくつかの文にまたがるアク
ティビティの終了を表します。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
このルーチンを含むクラスの名前です。システム関数の
場合は、値は " " となります。ネストされたクラス(たと
えば、ウィンドウ上のコントロール)には、class
name`embedded class name という書式の名前が付きます。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
TraceRoutine プロパティ
IsEvent
データ型
Boolean
LibraryName
String
Name
String
ObjectID
UnsignedLong
TimerValue
Decimal
説明
このルーチンがイベントの場合は TRUE、関数の場合は
FALSE となります。
ルーチンを含むクラスを含むライブラリの名前です。シス
テム クラスの場合は、値は " " となります。
パラメータ データ型および戻り値を含むルーチンの名前
です。
ルーチンを実行するオブジェクトのオブジェクト ID で
す。実行中のルーチンがグローバル ルーチンやシステム
ルーチンである場合には ID は 0 となります。
アクティビティが発生したときのタイマー値(秒数)です。
関数
TraceRoutine 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object(カタロ
グ データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
TraceTree オブジェクト
TraceTree オブジェクトを使用すると、PowerBuilder アプリケーション
のパフォーマンスを解析できます。このオブジェクトは、指定された
トレース ファイルにログが作成されたすべてのノードをリスト化した
ツリー モデルを提供します。また、解析するトレース ファイルの指
定、ツリー モデルの構築、およびツリー モデルのトップ レベルのエ
ントリをリストするために呼び出す関数も含まれます。TraceTree オブ
ジェクトは、TraceTreeNode、TraceTreeError、TraceTreeESQL、
TraceTreeGarbageCollect、TraceTreeLine、TraceTreeObject、
TraceTreeRoutine、および TraceTreeUser オブジェクトとともに使用しま
す。
TraceTree オブジェクトには、イベントはありません。
オブジェクトとコントロール
331
TraceTree オブジェクト
プロパティ
TraceTree プロパティ
ApplicationName
データ型
String
ClassDefinition
PowerObject
CollectionTime
Decimal
NumberOfActivities
Long
TraceFileName
String
説明
トレース ファイルの生成に使用したアプリケーションの
名前です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
トレース データの収集にかかった時間(秒)。この時間は
トレース ファイルからのタイムスタンプの中ですでに考
慮されています(つまり、タイムスタンプがトレース ファ
イルに入れられる前に適切な時間がタイムスタンプから
差し引かれています)。モデルが作成されなかった場合は
NULL が返されます。
トレース ファイルにある合計アクティビティ数。トレー
ス ファイル名の設定前にこのプロパティが呼び出される
と値は 0 となります。
モデルの作成に使用されるトレース ファイルの名前。こ
の名前が正常に設定されなかった場合には、この値は空の
文字列となります。
関数
TraceTree 関数
BuildModel
ClassName
DestroyModel
EntryList
GetContextService
GetParent
SetTraceFileName
TypeOf
332
戻り値のデータ型 説明
ErrorReturn
前に指定されたトレース ファイルに基づいてツリー モデ
(カタログ デー ルを作成します。
タ型)
String
オブジェクトに与えられた名前を返します。
ErrorReturn
現行のツリー モデルを破棄します。
(カタログ デー
タ型)
ErrorReturn
モデルに含まれるトップ レベルのエントリ
(カタログ デー (TraceTreeNode オブジェクトとして定義されている)の
タ型)
リストを作成します。
Integer
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
PowerObject
親オブジェクト名への参照を返します。
ErorReturn
解析に使用するトレース ファイルの名前を指定し、ファ
イル ヘッダの書式を作成します。
Object(カタロ オブジェクトのデータ型を返します。
グ データ型)
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
TraceTreeError オブジェクト
TraceTreeError オブジェクトは、システム エラーまたは警告の発生とし
て識別されるツリー モデル ノードに関する情報を提供します。これに
はエラー メッセージや重要度レベルに関する情報も含まれます。
TraceTreeError オブジェクトの追加のプロパティにアクセスするには、
アクティビティの種類が ActError! である TraceTreeNode オブジェクト
を TraceTreeError オブジェクトに割り当てます。
TraceTreeError オブジェクトには、イベントはありません。
プロパティ
TraceTreeError
プロパティ
ActivityType
ClassDefinition
データ型
TraceActivity
(カタログ デー
タ型)
PowerObject
Message
String
ParentNode
Severity
TraceTreeNode
Long
TimerValue
Decimal
説明
ActError! は、ノードで表されたアクティビティをシステム
エラーまたは警告の発生として識別する値です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
システム エラー メッセージまたは TraceError 関数に渡さ
れたメッセージです。
このノードの親です。
システム エラーの重要度または TraceError 関数に渡され
た重要度の引数です。
アクティビティが発生したときのタイマー値(秒数)です。
関数
TraceTreeError 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object(カタロ
グ データ型)
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
333
TraceTreeESQL オブジェクト
TraceTreeESQL オブジェクト
TraceTreeESQL オブジェクトは、埋め込み SQL(ESQL)文の発生とし
て 識 別 さ れ る ツ リ ー モ デ ル ノ ー ド に 関 す る 情 報 を 提 供 し ま す。
TraceTreeESQL オブジェクトの追加のプロパティにアクセスするに
は、アクティビティの種類が ActESQL! である TraceTreeNode オブジェ
クトを TraceTreeESQL オブジェクトに割り当てます。
TraceTreeESQL オブジェクトには、イベントはありません。
プロパティ
TraceTreeESQL
プロパティ
ActivityNode
ClassDefinition
データ型
TraceActivity(カ
タログ データ型)
PowerObject
EnterTimerValue
ExitTimerValue
Name
ParentNode
Decimal
Decimal
String
TraceTreeNode
説明
ActESQL! は、ノードで表されたアクティビティを ESQL
文のエントリと終了の発生として識別する値です。
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
この文のエントリに対してのタイマー値(秒単位)です。
この文の終了に対してのタイマー値(秒単位)です。
ESQL 文の名前です。
このノードの親です。
関数
TraceTreeESQL 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
334
Object(カタログ
データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタ
ンスへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
TraceTreeGarbageCollect オブジェクト
TraceTreeGarbageCollect オブジェクトは、ガベージ コレクションの発
生として識別されるツリー モデル ノードに関する情報を提供します。
TraceTreeGarbageCollect オブジェクトの追加のプロパティにアクセスす
るには、
アクティビティの種類が ActGarbageCollect! である TraceTreeNode
オブジェクトを TraceTreeGarbageCollect オブジェクトに割り当てます。
TraceTreeGarbageCollect オブジェクトには、イベントはありません。
プロパティ
TraceTreeGarbage
Collect プロパティ
ActivityType
ClassDefinition
EnterTimerValue
ExitTimerValue
ParentNode
データ型
説明
TraceActivity(カ ActGarbageCollect! は、ノードで表されたアクティビティ
タログ データ型) をガベージ コレクションの開始と終了として識別する
値です。
PowerObject
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
Decimal
ガベージ コレクタのエントリに対してのタイマー値(秒
単位)です。
Decimal
ガベージ コレクタの終了に対してのタイマー値(秒単
位)です。
TraceTreeNode
このノードの親です。
関数
TraceTreeGarbage
Collect 関数
ClassName
GetChildrenList
GetContextService
GetParent
TypeOf
戻り値のデータ型
String
説明
オブジェクトに与えられた名前を返します。
ErrorReturn(カタ このルーチンの子(TraceTreeNode オブジェクトとして
ログ データ型)
定義される)のリストを提供します。
Integer
指定されたサービスのコンテキストに固有のインスタ
ンスへの参照を作成します。
PowerObject
親オブジェクト名への参照を返します。
Object(カタログ オブジェクトのデータ型を返します。
データ型)
オブジェクトとコントロール
335
TraceTreeLine オブジェクト
TraceTreeLine オブジェクト
TraceTreeLine オブジェクトは、ルーチン行のヒットの発生として識別
されるツリー モデル ノードに関する情報を提供します。TraceTreeLine
オブジェクトの追加のプロパティにアクセスするには、アクティビティ
の種類が ActLine! である TraceTreeNode オブジェクトを TraceTreeLine
オブジェクトに割り当てます。
TraceTreeLine オブジェクトには、イベントはありません。
プロパティ
TraceTreeLine
プロパティ
ActivityType
ClassDefinition
データ型
TraceActivity(カ
タログ データ型)
PowerObject
LineNumber
ParentNode
TimerValue
UnsignedLong
TraceTreeNode
Decimal
説明
ActLine! は、ノードで表されたアクティビティをルーチ
ン行のヒットの発生として識別する値です。
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
行番号です。
このノードの親です。
アクティビティが発生したときのタイマー値(秒数)で
す。
関数
TraceTreeLine 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
336
Object(カタログ
データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタ
ンスへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
TraceTreeNode オブジェクト
TraceTreeNode オブジェクトは、ツリー モデル内のノードに関する情
報を提供します。これにはノードで表されたアクティビティの種類な
ども含まれます。TraceTreeNode オブジェクトは TraceTree オブジェク
トとともに使用します。
TraceTreeNode オブジェクトには、イベントはありません。
プロパティ
TraceTreeNode
プロパティ
ActivityType
データ型
TraceActivity
(カタログ デー
タ型)
ClassDefinition
PowerObject
ParentNode
TraceTreeNode
説明
カタログ データ型 TraceActivity は、ノードで表されたア
クティビティを識別します。値は以下のとおりです。
ActBegin! - ログの開始と終了
ActError! - システム エラーと警告の発生
ActESQL! - 埋め込み SQL 文のエントリと終了
ActGarbageCollect! - ガベージ コレクションの開始と
終了
ActLine! - ルーチン行のヒット
ActObjectCreate! - オブジェクトの作成
ActObjectDestroy! - オブジェクトの破棄
ActRoutine! - ルーチンのエントリと終了
ActUser! - 選択されたアクティビティの発生
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
このノードの親です。この親がトップ レベルのノード、
つまり EntryList 関数が返したノードである場合は、値は
無効なオブジェクトとなります。
関数
TraceTreeNode 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object(カタロ
グ データ型)
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタンス
への参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
337
TraceTreeObject オブジェクト
TraceTreeObject オブジェクト
TraceTreeObject オブジェクトは、オブジェクトの発生として識別される
ツリー モデル ノードに関する情報を提供します。TraceTreeObject オブ
ジェクトの追加のプロパティにアクセスするには、アクティビティの
種類が ActObjectCreate! または ActObjectDestroy! である TraceTreeNode
オブジェクトを TraceTreeObject オブジェクトに割り当てます。
TraceTreeObject オブジェクトには、イベントはありません。
プロパティ
TraceTreeObject
プロパティ
ActivityType
データ型
TraceActivity
(カタログ デー
タ型)
ClassDefinition
PowerObject
ClassName
EnterTimerValue
ExitTimerValue
IsCreate
String
Decimal
Decimal
Boolean
ObjectID
ParentNode
UnsignedLong
TraceTreeNode
説明
ActObjectCreate! は、ノードで表されたアクティビティを
オブジェクトの作成として識別する値です。
ActObjectDestroy! は、ノードで表されたアクティビティ
をオブジェクトの破棄として識別する値です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
オブジェクト型のクラスの名前です。
アクティビティ開始時のタイマー値(秒)です。
アクティビティ終了時のタイマー値(秒)です。
ノードがオブジェクトの作成を表す場合は TRUE、オブ
ジェクトの破棄を表す場合には FALSE となります。
オブジェクトの内部識別子です。
このノードの親です。
関数
TraceTreeObject 関数
ClassName
GetChildrenList
GetContextService
GetParent
338
戻り値のデータ型
String
ErrorReturn
(カタログ デー
タ型)
Integer
PowerObject
説明
オブジェクトに与えられた名前を返します。
このオブジェクトの子(TraceTreeNode オブジェクトとし
て定義される)のリストを提供します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
PowerBuilder
第2章
TraceTreeObject 関数
TypeOf
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
戻り値のデータ型
Object(カタロ
グ データ型)
説明
オブジェクトのデータ型を返します。
TraceTreeRoutine オブジェクト
TraceTreeRoutine オブジェクトは、ルーチンの発生として識別されるツ
リー モデル ノードに関する情報を提供します。TraceTreeRoutine オブ
ジェクトの追加のプロパティにアクセスするには、アクティビティの種
類が ActRoutine! である TraceTreeNode オブジェクトを TraceTreeRoutine
オブジェクトに割り当てます。
TraceTreeRoutine オブジェクトには、イベントはありません。
プロパティ
TraceTreeRoutine
プロパティ
ActivityType
ClassDefinition
データ型
TraceActivity
(カタログ デー
タ型)
PowerObject
ClassName
String
EnterTimerValue
ExitTimerValue
IsEvent
Decimal
Decimal
Boolean
LibraryName
String
Name
ObjectID
String
UnsignedLong
ParentNode
TraceTreeNode
オブジェクトとコントロール
説明
ActRoutine! は、ノードで表されたアクティビティをルー
チンのエントリと終了の発生として識別する値です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
このルーチンを含むクラスの名前です。システム関数の
場合は、値は " " となります。ネストされたクラス(たと
えば、ウィンドウ上のコントロール)には、class
name`embedded class name という書式の名前が付きます。
この呼び出しのエントリのタイマー値(秒)です。
この呼び出しの終了のタイマー値(秒)です。
このルーチンがイベントの場合は TRUE、関数の場合は
FALSE となります。
このルーチンを含むクラスを含むライブラリの名前。シス
テム クラスの場合は、値は " " となります。
引数のデータ型および戻り値を含むルーチンの名前です。
ルーチンを実行しているオブジェクトの内部 ID。グロー
バル関数およびシステム関数の場合には、この値は 0 とな
ります。
このノードの親です。
339
TraceTreeUser オブジェクト
関数
TraceTreeRoutine 関数
ClassName
GetChildrenList
GetContextService
GetParent
TypeOf
戻り値のデータ型
String
ErrorReturn
(カタログ デー
タ型)
Integer
PowerObject
Object(カタロ
グ データ型)
説明
オブジェクトに与えられた名前を返します。
このルーチンの子(TraceTreeNode オブジェクトとして定
義される)のリストを提供します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
TraceTreeUser オブジェクト
TraceTreeUser オブジェクトは、ログ用に選択されたアクティビティの
発生として識別される、ツリー モデル ノードに関する情報を提供します。
これにはアクティビティの引数やメッセージも含まれます。TraceTreeUser
オブジェクトの追加のプロパティにアクセスするには、アクティビティ
の種類が ActUser! である TraceTreeNode オブジェクトを TraceTreeUser
オブジェクトに割り当てます。
TraceTreeUser オブジェクトには、イベントはありません。
プロパティ
TraceTreeUser
プロパティ
ActivityType
Argument
データ型
TraceActivity(カ
タログ データ型)
Long
ClassDefinition
PowerObject
Message
String
ParentNode
TimerValue
TraceTreeNode
Decimal
340
説明
ActUser! は、ノードで表されたアクティビティを、選択
されたアクティビティの発生として識別する値です。
TraceUser 関数に渡された引数です。
オブジェクトまたはコントロールのクラス定義に関す
る情報を含む PowerObject 型のオブジェクトです。
TraceUser 関数に渡されたメッセージです。
このノードの親です。
アクティビティが発生したときのタイマー値(秒数)で
す。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
TraceTreeUser 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object(カタログ
データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタ
ンスへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
TraceUser オブジェクト
TraceUser オブジェクトは、ログ用に選択されたアクティビティの発生
として識別される、トレース ファイル内のノードに関する情報を提供
します。これにはアクティビティの引数やメッセージも含まれます。
TraceUser オブジェクトの追加のプロパティにアクセスするには、アク
ティビティの種類が ActUser! である TraceActivityNode オブジェクトを
TraceUser オブジェクトに割り当てます。
TraceUser オブジェクトには、イベントはありません。
プロパティ
TraceUser プロパティ
ActivityType
Argument
Category
ClassDefinition
Message
TimerValue
データ型
TraceActivity
(カタログ デー
タ型)
Long
説明
ActUser! は、ノードで表されたアクティビティを、選択さ
れたアクティビティの発生として識別する値です。
TraceCategory
(カタログ デー
タ型)
PowerObject
TraceAtomic! は、ノードが 1 つの文で発生したアクティビ
ティであることを示す値です。
String
Decimal
オブジェクトとコントロール
TraceUser 関数に渡された引数です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
TraceUser 関数に渡されたメッセージです。
アクティビティが発生したときのタイマー値(秒数)です。
341
Transaction オブジェクト
関数
TraceUser 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object(カタロ
グ データ型)
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
Transaction オブジェクト
Transaction(トランザクション)オブジェクトは、PowerBuilder がデー
タベースに接続する際のパラメータを指定するのに使われます。
また、組み込みの Transaction オブジェクトを継承したクラス ユーザ オ
ブジェクトを定義することによって、Transaction オブジェクトをカス
タマイズしたユーザ オブジェクトを独自に作成することもできます。
Transaction オブジェクトを基にユーザ オブジェクトを作成する方法に
ついては、PowerBuilder の『ユーザーズ ガイド』マニュアルのユーザ
オブジェクトの章を参照してください。
アプリケーションでの Transaction オブジェクトの使用方法について
は、
『アプリケーション テクニック』マニュアルを参照してください。
プロパティ
Transaction プロパティ
AutoCommit
データ型
Boolean
説明
自動コミット処理に対するインジケータ(SQL Server の
み)。値は以下のとおりです。
TRUE - 各データベース処理の後、
自動的にコミットし
ます。
ClassDefinition
PowerObject
Database
String
342
FALSE - 各データベース処理の後、自動的にはコミッ
トしません。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
接続先データベースの名前です。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
Transaction プロパティ
DBMS
DBParm
DBPass
Lock
LogID
LogPass
ServerName
データ型
String
String
String
String
String
String
String
SQLCode
Long
説明
PowerBuilder ベンダ識別子です。
DBMS 固有のパラメータです。
データベースとの接続に使用されるパスワードです。
排他(分離)レベルです。
サーバにログオンする際に使用するユーザ ID です。
サーバにログオンする際に使用するパスワードです。
データベース エンジンが稼動しているサーバの名前で
す。
最後の操作の成否コードです。
リターン コード :
SQLDBCode
SQLErrText
SQLNRows
Long
String
Long
SQLReturnData
UserID
String
String
0 - 正常終了
100 - 検出されません
-1 - エラー(詳細を得るには、SQLDBCode か
SQLErrText を使用してください)
データベース ベンダのエラー コードです。
データベース ベンダのエラー メッセージです。
影響のあった行の数(データベース ベンダによってこの
数値が与えられます。したがって、DBMS ごとに意味が異
なる場合もあります)。
DBMS 固有の情報です。
データベースとの接続に使用されるユーザ ID です。
イベント
Transaction イベント
Constructor
Destructor
発生する状況
ユーザ オブジェクトが作成されるとき
ユーザ オブジェクトが破棄されるとき
関数
Transaction 関数
ClassName
DBHandle
GetContextService
戻り値のデータ型
String
Long
Integer
オブジェクトとコントロール
説明
ユーザ オブジェクトに与えられた名前を返します。
DBMS に対するインタフェース ハンドルを返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
343
TransactionServer オブジェクト
Transaction 関数
GetParent
PostEvent
戻り値のデータ型
PowerObject
Boolean
SyntaxFromSQL
String
TriggerEvent
Integer
TypeOf
Object
説明
親オブジェクト名への参照を返します。
ユーザ オブジェクトのメッセージ キューの最後にイベン
トを追加します。
SQL SELECT 文に基づいて DataWindow オブジェクトの
ソース コードを生成します。
ユーザ オブジェクトにイベントを送り、そのイベントに
関連付けられたスクリプトを実行します。
ユーザ オブジェクトのデータ型を返します。
TransactionServer オブジェクト
TransactionServer(トランザクションサーバ)オブジェクトは、現行の
トランザクションのコンテキスト情報を提供し、トランザクション
サーバで実行中のコンポーネントでトランザクションおよびそのライ
フサイクルを制御できるようにします。
プロパティ
TransactionServer
プロパティ
ClassDefinition
データ型
PowerObject
説明
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
イベント
TransactionServer イベ
ント
Constructor
Destructor
344
発生する状況
オブジェクトが作成されるとき
オブジェクトが破棄されるとき
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
関数
TransactionServer 関数
ClassName
CreateInstance
戻り値のデータ型
String
Integer
DisableCommit
Integer
EnableCommit
Integer
GetContextService
Integer
GetParent
ImpersonateClient
PowerObject
Integer
IsCallerInRole
Integer
IsImpersonating
Boolean
IsInTransaction
Boolean
IsSecurityEnabled
Boolean
IsTransactionAborted
Boolean
Lookup
Long
PostEvent
Boolean
RevertToSelf
Integer
SetAbort
Integer
SetComplete
Integer
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
現行オブジェクトのすべてのトランザクションおよびセ
キュリティ属性を継承する子サーバ オブジェクトを作成
します。
コンポーネントのトランザクション更新に一貫性がない
ため、現行の状態でコミットできないことを宣言します。
コンポーネントの処理は完了していないが、トランザク
ション更新には一貫性があるため、コミットできることを
宣言します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
クライアントの呼び出し中に、コンポーネントがクライア
ントのセキュリティ属性を取得できるようにします。
オブジェクトの直接呼び出し側が指定された処理(ユーザ
別またはグループの一部として)を行っているかどうかを
示します。
コンポーネントがクライアントを偽装しているかどうか
を問い合わせます。
トランザクションでコンポーネントが実行されているか
どうかを示します。
コンポーネントのセキュリティが有効かどうかを示しま
す。
現行のトランザクションがすでに中止されたかどうか確
認します。
コンポーネントが同じ EAServer ホストで実行されている
別のコンポーネントをインスタンス化するのを許可しま
す。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
コンポーネントがクライアントを偽装している場合、コン
ポーネントのセキュリティ属性を復元します。
コンポーネントが現行のトランザクションで処理を完了
できず、トランザクションをロールバックする必要がある
ことを宣言します。メソッドが戻ると、コンポーネントの
インスタンスは非アクティブになります。
コンポーネントが参加しているトランザクションをコ
ミットし、コンポーネントのインスタンスを非アクティブ
にする必要があることを宣言します。
345
TreeView コントロール
TransactionServer 関数
TriggerEvent
戻り値のデータ型
Integer
TypeOf
Which
Object
Integer
説明
オブジェクト内で特定のイベントを起動し、そのイベント
のスクリプトを実行します。
オブジェクトのデータ型を返します。
オブジェクトがトランザクション サーバで実行されてい
ない場合は 0、EAServer で実行されている場合は 1、
Microsoft MTS または IIS4 で実行されている場合は 2 を返
します。
TreeView コントロール
TreeView(ツリービュー)コントロールは、情報を階層的に表示しま
す。TreeView コントロールの各項目はテキストとピクチャから構成さ
れ、プログラムの実行中に操作できます。
プロパティ
TreeView プロパティ
Accelerator
データ型
Integer
AccessibleDescription
String
AccessibleName
String
AccessibleRole
BackColor
Border
AccessibleRole
(カタログ デー
タ型)
Long
Boolean
説明
コントロールに割り当てられるアクセラレータ キーの
ASCII コードです。
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
コントロールに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - コントロールに枠線を付けます。
FALSE - コントロールに枠線を付けません。
346
PowerBuilder
第2章
TreeView プロパティ
BorderStyle
BringToTop
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
BorderStyle
(カタログ デー
タ型)
Boolean
説明
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
CheckBoxes
Boolean
状態イメージをチェックボックスに置き換えるかどうか
を示します。デフォルトの設定では、チェックボックスの
チェックははずれています。TreeView コントロールは、マ
ウスとキーボードによる入力を処理してチェック状態を
切り替えます。値は以下のとおりです。
TRUE - チェックボックスを表示します。
FALSE - チェックボックスを表示しません。
項目のチェックボックスの状態を確認するには、その項目
の状態ピクチャのインデックスをチェックします。
ClassDefinition
PowerObject
DeleteItems
Boolean
チェックがはずれている = 1
チェックされている = 2
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
ユーザが〔Delete〕を使用して、TreeView コントロールか
ら TreeView 項目を削除できるようにするかどうかを示し
ます。値は以下のとおりです。
TRUE - ユーザはコントロールから項目を削除できます。
FALSE - ユーザはコントロールから項目を削除できま
DisableDragDrop
Boolean
せん。
DisableDragDrop は、ユーザが項目をクリックしてドラッ
グしたときにドラッグ用のイベント(たとえば BeginDrag
など)を起動するかどうかを決定します。値は以下のとお
りです。
TRUE - ドラッグ イベントを起動しません。
FALSE - ドラッグ イベントを起動します。
オブジェクトとコントロール
347
TreeView コントロール
TreeView プロパティ
DragAuto
データ型
Boolean
説明
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
DragIcon
EditLabels
String
Boolean
いずれの場合でも、ドラッグ操作を可能にするためには
DisableDragDrop を FALSE に設定する必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
選択されている項目がクリックされたときに、コントロー
ル内の項目のラベルを編集できるようにするかどうかを
指定します。値は以下のとおりです。
TRUE - ユーザは項目ラベルを編集できます。
FALSE - ユーザは項目ラベルを編集できません。
Enabled
Boolean
コントロールが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 使用できます。
FALSE - 使用できません。
FaceName
FontCharSet
348
String
FontCharSet
(カタログ デー
タ型)
コントロール内にあるテキストの表示に使用する字体の
名前(たとえば ARIAL や COURIER など)を示します。
コントロール内のテキストに使用されるフォント文字
セットを示します。アプリケーションの実行には、選択さ
れた文字セットをサポートしているオペレーティング シ
ステム上で、適切なバージョンの PowerBuilder を使わなけ
ればなりません。値は以下のとおりです。
ANSI!
ChineseBig5!
DefaultCharSet!
Hangeul!
OEM!
ShiftJIS!
Symbol!
PowerBuilder
第2章
TreeView プロパティ
FontFamily
FontPitch
FullRowSelect
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
FontFamily
(カタログ デー
タ型)
説明
コントロール内のテキストに使用されるフォント ファミ
リ(タイプ スタイル)を示します。値は以下のとおりです。
AnyFont!
Decorative!
Modern!
Roman!
Script!
Swiss!
FontPitch(カタ コントロール内のテキストに使用されるフォントのピッ
ログ データ型) チ(間隔)を示します。値は以下のとおりです。
Default!
Fixed!
Variable!
Boolean
行全体の選択が可能かどうかを指定します。値は以下のと
おりです。
TRUE - 行の任意の場所をクリックすると、
行全体が選
択されます。また、行の任意の項目を選択すると、行
全体がハイライト表示されます。
FALSE - 行の任意の項目を選択しても、行全体のハイ
ライト表示または選択は行われません。
HasButtons
Boolean
このプロパティは、HasLines = TRUE に設定されている
場合には使用できません。
ツリー表示が展開されていることを表わす[+]ボタン、
またはツリー表示が閉じていることを表わす[-]ボタン
を TreeView の親項目に表示するかどうかを示します。値
は以下のとおりです。
TRUE - 親項目にボタンを表示します。
FALSE - 親項目にボタンを表示しません。
HasLines
Boolean
SingleExpand が TRUE(1 つの項目だけを展開できる)に
設定されている場合でも、HasButtons を TRUE に設定すれ
ば、項目ボタンをクリックすることによって複数の項目を
展開できます。
TreeView の項目を線で結ぶかどうか示します。値は以下
のとおりです。
TRUE - 項目を線で結びます。
FALSE - 項目を線で結びません。
Height
Integer
オブジェクトとコントロール
コントロールの高さを PowerBuilder 単位系で示します。
349
TreeView コントロール
TreeView プロパティ
HideSelection
データ型
Boolean
説明
コントロールがフォーカスを失っても、選択したテキスト
をハイライト状態にしておくかどうかを示します。値は以
下のとおりです。
TRUE - テキストのハイライト表示は解除されます。
FALSE - テキストはハイライト表示されたままです。
ImeMode
Integer
Indent
Integer
Italic
Boolean
IME(Input Method Editor)のモード設定を示します。この
プロパティは、日本語版 PowerBuilder 上で実行されている
アプリケーションにのみ適用されます。
TreeView の項目をインデントする大きさを PowerBuilder
単位系で示します。負の値を指定すると、項目はコント
ロールの左端の枠の外側にインデントされます。
標準のピクチャを配置する部分は必ず確保されています
が、必ずその部分が表示されているとは限りません。イン
デントを 90 以下に設定したときには標準のピクチャの幅
には何も影響はありません。この余白部分を削除するには
PictureWidth を 0 に設定してください。
コントロール内のテキストを斜体にするかどうかを示し
ます。値は以下のとおりです。
TRUE - テキストを斜体にします。
FALSE - テキストを斜体にしません。
LayoutRTL
Boolean
コントロールのレイアウトが標準レイアウトのミラー イ
メージとなることを示します。値は以下のとおりです。
TRUE – コントロール内の要素を右寄せにします。
FALSE – コントロール内の要素を左寄せにします
LinesAtRoot
Boolean
TreeView のルート項目を線で結ぶかどうかを示します。
値
は以下のとおりです。
(デフォルト)。
PictureHeight
Integer
TRUE - HasLines も TRUE のとき、
TreeView コントロー
ルのルート項目を線で結びます。
FALSE - ルート項目を線で結びません。
TreeView 項目ピクチャの高さをピクセル値で示します。
この値を設定できるのは、ピクチャがピクチャ インデッ
クス リストに追加される前だけです。
PictureMaskColor
350
Long
ピクチャの高さが 0 の場合、ピクチャのインデックス リ
ストに最初に追加されたピクチャの高さが適用されます。
TreeView 項目のピクチャに使用されるマスクの色を示し
ます。この値は、初期設定のときか、AddPicture 関数でピ
クチャが追加されるときに使用されます。この値をピク
チャが追加される前に再設定すると、追加されるピクチャ
に適用されます。
PowerBuilder
第2章
TreeView プロパティ
PictureName[ ]
PictureWidth
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
String
Integer
説明
初期設定で追加されるピクチャを格納してあるファイル
名を示します。拡張子の BMP、ICO、GIF、JPG、JPEG も
必要です。
このプロパティを変更しても、初期化した後は更新されま
せん。
TreeView のピクチャ項目の幅をピクセルで示します。
この値を設定できるのは、ピクチャがピクチャ インデッ
クス リストに追加される前だけです。
Pointer
String
RightToLeft
Boolean
SingleExpand
Boolean
ピクチャの幅が 0 の場合、ピクチャのインデックス リス
トに最初に追加されたピクチャの幅が適用されます。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
文字を右から左の向きに表示するかを示します。アプリ
ケーションは、右から左への表示をサポートするオペレー
ティング システム上で実行する必要があります。値は以
下のとおりです。
TRUE – 文字を右から左の向きに表示します。
FALSE – 文字を左から右の向きに表示します(デフォ
ルト)。
選択された TreeView 項目だけを展開できるようにするか
どうかを示します。マウスを 1 回クリックすると項目が選
択されます。
TRUE - 項目を選択すると、
その項目が自動的に展開さ
れ、その前に選択されていた項目は自動的に折りたた
まれます。
FALSE - 複数の項目が同時に展開されます。
SortType
grSortType
HasButtons が TRUE の場合、項目ボタンをクリックする
と、複数の項目を同時に展開できます。
ソート方法を選択します。値は以下のとおりです。
Ascending! - 項目名のアルファベットの昇順
Descending! - 項目名のアルファベットの降順
UserDefinedSort! - Sort イベントのスクリプトで指定さ
れた順番
Unsorted! - ソートは行われません。
SortType でソート方法を指定すると、ソートが自動的に実
行されます。Unsorted! が指定されている場合に関数を呼
び出すと、アルファベット順のソートが実行されます。
オブジェクトとコントロール
351
TreeView コントロール
TreeView プロパティ
StatePictureHeight
データ型
Integer
説明
状態ピクチャの高さをピクセル単位で示します。
この値を設定できるのは、状態ピクチャが状態ピクチャ
リストに追加される前だけです。
StatePictureMaskColor
Long
StatePictureName[ ]
String
StatePictureWidth
Integer
状態ピクチャの高さが 0 の場合は、状態ピクチャのイン
デックス リストに最初に追加されたピクチャの高さが適
用されます。
状態ピクチャで使用されるマスクの色を示します。この色
は、初期設定もしくは AddStatePicture 関数でピクチャを追
加するときに使用されます。
状態ピクチャとして使用するピクチャの名前を示します。
状態ピクチャは、標準ピクチャの左側に表示されます。状
態ピクチャ用の領域を空けるには、項目を右にずらしま
す。
ピクチャは、アイコン、カーソル、ビットマップのうち、
開発者が独自に作成したものか、PowerBuilder ライブラリ
に組み込まれているものが使用できます。このプロパティ
は、初期設定の後は更新されません。
状態ピクチャの幅をピクセルで示します。
この値を設定できるのは、状態ピクチャが状態ピクチャ
リストに追加される前だけです。
TabOrder
Integer
Tag
TextColor
String
Long
TextSize
Integer
ToolTips
Boolean
状態ピクチャの幅が 0 の場合は、状態ピクチャのインデッ
クス リストに最初に追加された状態ピクチャの幅が適用
されます。
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
テキストに使用される色を -2 から 16,777,215 の範囲の数
値で示します。
コントロール中のテキスト サイズをポイント数で示しま
す。
以前のバージョンとの互換性を保つため、サイズは負の値
で扱われます。たとえば 10 ポイントのテキスト サイズは
-10 として保存されます。
項目のラベルがコントロールの右端で切り捨てられた場
合、項目のラベルをツールチップに表示するかどうかを示
します。値は以下のとおりです。
TRUE - ラベルが右端で切り捨てられた場合、ラベル
テキストが表示されるツールチップを表示します。デ
フォルトではツールチップを表示します。
FALSE - ツールチップを表示しません。
352
PowerBuilder
第2章
TreeView プロパティ
TrackSelect
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
マウス ポインタが項目の上を移動したときに、項目の色
を変えるかどうか(ホット トラッキング)を示します。値
は以下のとおりです。
TRUE - マウス ポインタを項目の上に移動すると、項
目の色が変わります。
FALSE - マウス ポインタを項目の上に移動したり置い
Underline
Boolean
たままにしても、項目の色は変わりません。
コントロール内のテキストに下線を引くかどうかを示し
ます。値は以下のとおりです。
TRUE - 下線を引きます。
FALSE - 下線を引きません。
Visible
Boolean
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Weight
Integer
Width
X
Integer
Integer
Y
Integer
コントロール内にあるテキストの文字の太さを示します。
たとえば、400 は通常の文字、700 は太字です。
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
TreeView イベント
BeginDrag
BeginLabelEdit
BeginRightDrag
Clicked
Constructor
DeleteItem
発生する状況
ユーザがマウスの左ボタンでドラッグ操作を開始するとき。DragAuto プロ
パティが TRUE の場合は自動的にドラッグが開始します。FALSE の場合はド
ラッグ操作をスクリプトで記述しなければなりません。
ユーザが TreeView 項目ラベルの編集を開始するとき。新しいテキストを項
目ラベルにしないときは、リターン コードに 1 を指定します。項目ラベル
にするときは 0 を指定します。
ユーザがマウスの右ボタンでドラッグ操作を開始するとき。DragAuto プロ
パティが TRUE の場合は自動的にドラッグが開始します。FALSE の場合はド
ラッグ操作をスクリプトで記述しなければなりません。
コントロールがクリックされたとき
ウィンドウの Open イベントが発生する直前に、そのオブジェクトが作成さ
れるとき
TreeView 項目が削除されるとき
オブジェクトとコントロール
353
TreeView コントロール
TreeView イベント
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
EndLabelEdit
GetFocus
Help
ItemCollapsed
ItemCollapsing
ItemExpanded
ItemExpanding
発生する状況
ウィンドウの Close イベントが発生した直後に、そのオブジェクトが破棄さ
れるとき
コントロールをダブルクリックしたとき
コントロール上にドラッグ中のコントロールがドロップされるとき
ドラッグ中のコントロールがコントロール上(表示領域の周りの細い枠を含
めて)に入るとき
ドラッグ中のコントロールがコントロールから離れるとき(タブ ページ表
示領域に入ったときを含めて)
ドラッグ中のコントロールがコントロール内にあるとき。ただし TreeView
項目上にあるときを除きます。
ユーザが TreeView 項目のラベルの編集を終えるとき。新しいテキストを項
目ラベルにしないときは、リターン コードに 1 を指定します。項目ラベル
にするときは 0 を指定します。
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
項目のツリー表示を閉じたとき
項目のツリー表示を閉じているとき。閉じるのを中止するときにはリターン
コードに 1 を、そのまま閉じるときには 0 を指定します。
項目のツリー表示が展開されたとき
項目のツリー表示が展開されているとき。展開するのを中止するときにはリ
ターン コードに 1 を、そのまま展開するときには 0 を指定します。
項目のツリー表示が展開されるときに子項目を生成する場合は、ItemExpanding
イベントを使用します。
ItemPopulate
Key
LoseFocus
Notify
Other
RightClicked
RightDoubleClicked
SelectionChanged
354
ItemPopulate イベントや ItemExpanding イベントで子項目が生成されない場
合は、その項目のツリー表示は展開されません。
項目のツリー表示が初めて展開されるとき。展開するのを中止するときには
リターン コードに 1 を、そのまま展開するときには 0 を指定します。
ItemPopulate イベントや ItemExpanding イベントで子項目が生成されない場
合は、その項目のツリー表示は展開されません。
ユーザがキーを押すとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
TreeView コントロールが親に WM_NOTIFY メッセージを送信するとき
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
コントロールをマウスの右ボタンでダブルクリックしたとき
選択範囲が変更されたとき
PowerBuilder
第2章
TreeView イベント
SelectionChanging
Sort
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
発生する状況
選択範囲を変更しようとしたとき。選択範囲の変更を中止するときにはリ
ターン コードに 1 を、そのまま変更するときには 0 を指定します。
ソートが行われて、SortType プロパティが UserDefinedSort! に設定されてい
るとき。項目のペアがソートされるたびにイベントが発生します。
関数
TreeView 関数
AddPicture
戻り値のデータ型
Integer
AddStatePicture
Integer
ClassName
CollapseItem
DeleteItem
String
Integer
Integer
DeletePicture
Integer
DeletePictures
Integer
DeleteStatePicture
Integer
DeleteStatePictures
Integer
Drag
EditLabel
ExpandAll
Integer
Integer
Integer
ExpandItem
FindItem
GetContextService
Integer
Long
Integer
GetItem
GetItemAtPointer
Integer
Integer
GetParent
Hide
PowerObject
Integer
オブジェクトとコントロール
説明
イメージ リストにアイコン、カーソル、またはビットマッ
プを追加します。PictureName は更新されません。
状態ピクチャのリストにアイコン、カーソル、またはビッ
トマップを追加します。StatePictureName は更新されませ
ん。
コントロールの名前を返します。
指定された TreeView 項目を折りたたみます。
指定された TreeView 項目とその子(ある場合)をすべて
削除します。
指定されたアイコン、カーソル、ビットマップをイメージ
リストから削除します。
イメージ リストからすべてのアイコン、カーソル、ビッ
トマップを削除します。
指定されたアイコン、カーソル、またはビットマップを状
態イメージ リストから削除します。
状態イメージ リストからすべてのアイコン、カーソル、
ビットマップを削除します。
TreeView 項目のドラッグを開始または終了します。
特定の TreeView 項目のラベルの編集を開始します。
指定された TreeView 項目の子とその下のツリー表示をす
べて展開します。
指定された TreeView 項目のツリー表示を展開します。
指定された TreeView 項目のハンドルを返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
指定された項目の情報を取得します。
カーソルが置かれている項目のインデックスまたはハン
ドルを取得します。
親オブジェクト名への参照を返します。
指定された TreeView 項目を非表示にします。
355
TreeView コントロール
TreeView 関数
InsertItem
戻り値のデータ型
Long
InsertItemFirst
Long
InsertItemLast
Long
InsertItemSort
Long
Move
Integer
PointerX
Integer
PointerY
Integer
PostEvent
Boolean
Print
Resize
SelectItem
Integer
Integer
Integer
SetDropHighlight
Integer
SetFirstVisible
Integer
SetFocus
Integer
SetItem
SetLevelPictures
Integer
Integer
SetOverlayPicture
Integer
SetPosition
Integer
SetRedraw
Integer
356
説明
TreeView コントロール内の指定された位置およびレベル
に、指定された項目を挿入します。
指定された項目を、指定されたレベルの最初の項目として
挿入します。
指定された項目を、指定されたレベルの最後の項目として
挿入します。
適切なアルファベット位置にある指定されたレベルに、指
定された項目を挿入します。
コントロールまたはオブジェクトを指定された位置に移
動します。
オブジェクトの左端からポインタ位置までの距離を測定
します。
オブジェクトの上端からポインタ位置までの距離を測定
します。
オブジェクトのイベント キューの最後にイベントを追加
します。
オブジェクトあるいはテキスト行を印刷ジョブに送ります。
コントロールのサイズを指定された寸法に変更します。
コントロールの項目にフォーカス(ハイライト)を与えま
す。
指定された TreeView 項目をドラッグ アンド ドロップ操
作の対象とします。
指定された TreeView 項目を TreeView コントロールの最初
の表示項目にします。項目数が多い場合には、スクロール
して該当項目が一番上に表示されます。そうでない場合に
は、その項目が選択された状態で表示されます。
指定されたオブジェクトまたはコントロールにフォーカ
スを設定します。
指定された TreeView 項目の情報を設定します。
TreeView コントロール内の特定のレベルにあるすべての
TreeView 項目に対してピクチャ インデックスを指定しま
す。
ピクチャ インデックスをオーバーレイ ピクチャのイン
デックスにマップします。マップできるのはオーバーレイ
4 つまでです。
コントロールをウィンドウ上の前面に置くか背面に置く
か、位置を指定します。
オブジェクトのプロパティを変更した後でそのオブジェ
クトを自動再描画するかどうかを設定します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
TreeView 関数
Show
戻り値のデータ型
Integer
Sort
Integer
SortAll
Integer
TriggerEvent
Integer
TypeOf
Object
説明
オブジェクトまたはコントロールが表示されていない場
合は表示します。オブジェクトがすでに表示されている場
合には、最前面に表示します。
指定された TreeView 項目の子項目を SortType プロパティ
で指定された順序でソートします。SortType が Unsorted!
に設定されている場合にはアルファベット順にソートし
ます。
TreeView 項目の子項目以下のすべてのレベルを SortType
プロパティで指定された順序でソートします。SortType が
Unsorted! に設定されている場合にはアルファベット順に
ソートします。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
TreeViewItem オブジェクト
TreeViewItem(ツリービューアイテム)オブジェクトは TreeView コン
トロール内の個々の項目のプロパティを生成するシステム構造体で
す。TreeViewItem には、イベントはありません。
プロパティ
TreeViewItem
プロパティ
Bold
データ型
Boolean
説明
その項目が太字かどうかを示します。値は以下のとおりで
す。
TRUE - 項目は太字です。
FALSE - 項目は太字ではありません。
オブジェクトとコントロール
357
TreeViewItem オブジェクト
TreeViewItem
プロパティ
Children
データ型
Boolean
説明
その項目に子項目が存在するかどうかを示します。値は以
下のとおりです。
TRUE - 子が存在します。
FALSE - 子が存在しません。
ClassDefinition
PowerObject
CutHighLighted
Boolean
このプロパティを使用して、TreeView に子項目がない場
合でも、あるかのように処理することができます。この処
理を行う必要があるのは、その項目に子がない場合に
ItemPopulate イベントや ItemExpanding イベントを取得す
る場合です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
その項目を切り取り操作の対象にするかどうかを示しま
す。値は以下のとおりです。
TRUE - 項目は切り取り操作の対象です。
FALSE - 項目は切り取り操作の対象ではありません。
Data
DropHighLighted
Any
Boolean
ユーザ定義のデータを TreeView 項目に割り当てます。
その項目が、ドラッグ アンド ドロップ操作の対象かどう
かを示します。値は以下のとおりです。
TRUE - 項目はドラッグ アンド ドロップ操作の対象で
す。
Expanded
Boolean
FALSE - 項目はドラッグ アンド ドロップ操作の対象
ではありません。
その項目が展開されているかどうかを示します。値は以下
のとおりです。
TRUE - 項目は展開されています。
FALSE - 項目は展開されていません。
ExpandedOnce
Boolean
その項目が少なくとも 1 回は展開されたことがあるかど
うか、同時に子とともに生成されたかどうかを示します。
値は以下のとおりです。
TRUE - 項目は展開されたことがあります。
FALSE - 項目は展開されたことがありません。
HasFocus
Boolean
その項目にフォーカスがあるかどうかを示します。値は以
下のとおりです。
TRUE - 項目にフォーカスがあります。
FALSE - 項目にフォーカスがありません。
ItemHandle
Label
Long
Label
Level
Integer
358
その項目に関連付けられているハンドルを示します。
その項目に関連付けられている文字列ラベルを示します。
TreeView コントロール内での、その項目のレベルを示し
ます。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
TreeViewItem
プロパティ
OverlayPictureIndex
データ型
Integer
PictureIndex
Integer
SelectedPictureIndex
Integer
Selected
Boolean
説明
その項目に関連付けられているオーバーレイ ピクチャを
示します。オーバーレイ ピクチャは、項目のピクチャよ
りも手前に表示されます。値が 0 の場合、オーバーレイは
表示されません。
その項目ラベルの左側に表示されるピクチャを示します。
値が 0 であればピクチャは表示されず、TreeView の
PictureWidth プロパティで指定された空間はブランクとな
ります。
その項目に関連付けられている、選択されたときのピク
チャを示します。値が 0 であればピクチャを選択しても表
示されません。
その項目が選択されているかどうかを示します。値は以下
のとおりです。
TRUE - 項目は選択されています。
FALSE - 項目は選択されていません。
Integer
その項目に関連付けられている状態ピクチャを示します。
状態ピクチャは通常のピクチャの左側に表示されます。値
が 0 の場合は、状態ピクチャは表示されず、そのための空
間も確保されません。
TreeViewItem 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
StatePictureIndex
関数
オブジェクトとコントロール
359
TypeDefinition オブジェクト
TypeDefinition オブジェクト
TypeDefinition は VariableDefinition クラスの中で使用されます。
変数の型についての情報です。変数は、単一値、オブジェクト、また
は配列です。TypeDefinition は、ClassDefinition、SimpleTypeDefinition お
よび EnumerationDefinition の先祖である抽象クラスです。イベントは
ありません。
プロパティ
TypeDefinition
プロパティ
Category
データ型
TypeCategory
説明
単純型かカタログ データ型か、またはクラスか構造体か
を示します。値は以下のとおりです。
SimpleType!
EnumeratedType!
ClassOrStructureType!
ClassDefinition
PowerObject
DataTypeOf
String
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
変数のシステム クラス名または単純データ型。
DataTypeOf は、オブジェクトのカタログ データ型の値を
表す文字列です。値は感嘆符なしの小文字です。サンプ
ル値には以下のようなものがあります。
window
string
any
dropdownlistbox
IsStructure
IsSystemType
Boolean
Boolean
IsVariableLength
Boolean
開発者が定義したオブジェクトの場合、データ型はそのオ
ブジェクトの継承元のシステム クラスになります。
型が構造体かどうかを示します。
型が PowerBuilder で定義されているものかどうかを示し
ます。そうでなければユーザが PBL に定義したものです。
データ型が固定サイズかどうかを示します。値は以下のと
おりです。
TRUE - データ型は可変長です。つまり、データ型が、
string、any、blob、または可変長配列であることを示し
ます。
FALSE - データ型は固定長です。
360
PowerBuilder
第2章
TypeDefinition
プロパティ
IsVisualType
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
型が、ビジュアル(表示可能)か、非ビジュアルかを示し
ます。値は以下のとおりです。
TRUE - 型はビジュアル(たとえば、ウィンドウやコン
トロールなど)です。
FALSE - 型は非ビジュアル(たとえば、クラス ユーザ
LibraryName
String
Name
String
オブジェクトや単純データ型など)です。
型のロード元ライブラリの絶対パス名。ライブラリに型が
格納されていない場合があるので注意してください。ライ
ブラリの内容がプログラムによって処理された場合、クラ
スはロード後に移動または削除された可能性もあります。
型の名前。ネストされた型の場合、名前は
libraryEntryName`typeName のフォームで返されます。
関数
TypeDefinition 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
オブジェクトとコントロール
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
361
UserObject オブジェクト
UserObject オブジェクト
UserObject(ユーザオブジェクト)は、標準 PowerBuilder オブジェクト
を補うために開発者が構築するカスタム ビジュアル オブジェクトで
す。UserObject を使って、情報を表示したり、エンドユーザに入力を
要求したり、逆にマウスやキーボードからの入力に対して適切な応答
をする、といったことが行えます。TabPage UserObject を作成すること
もできます。UserObject を作成するにはユーザ オブジェクト ペインタ
を使用します。
表示可能な UserObject をウィンドウに配置することは、実際には、そ
のウィンドウに UserObject コントロールを配置することになります。
UserObject コ ン ト ロ ー ル は、そ の ウ ィ ン ド ウ に 対 し て 指 定 さ れ た
UserObject のインスタンスを保持しています。
プロパティ
UserObject プロパティ
BackColor
データ型
Long
Border
Boolean
説明
背景色を -2 から 16,777,215 の範囲の数値で示します。色
についての詳細は、
『PowerScript リファレンス』マニュア
ルの RGB 関数を参照してください。
オブジェクトに枠線を付けるかどうかを示します。値は以
下のとおりです。
TRUE - オブジェクトに枠線を付けます。
FALSE - オブジェクトに枠線を付けません。
BorderStyle
BringToTop
BorderStyle
(カタログ デー
タ型)
Boolean
コントロールの枠線のスタイルを示します。値は以下のと
おりです。
StyleBox!
StyleLowered!
StyleRaised!
StyleShadowBox!
オブジェクトをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
ClassName
String
362
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
(外部ユーザ オブジェクトのみ)オブジェクトに与えられ
た名前を返します。
PowerBuilder
第2章
UserObject プロパティ
ColumnsPerPage
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Integer
Control[ ]
WindowObject
DragAuto
Boolean
DragIcon
Enabled
String
Boolean
説明
1 ページのカラム数を示します。デフォルトは 0 です(1
ページに 10 カラム)
。詳細については、581 ページの「ウィ
ンドウおよびユーザ オブジェクト内でのスクロール」を
参照してください。
PowerBuilder は、ユーザがスクロールバーをクリックし
て横方向にオブジェクトをスクロールするときの
PowerBuilder 単位系の数値を、UnitsPerColumn ×
ColumnsPerPage という計算式で求めます。
コントロールのオブジェクトを示します。この配列の内容
は、スクリプトでは変更できません。
オブジェクトを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - オブジェクトをクリックすると、自動的にド
ラッグ モードになります。
FALSE - オブジェクトをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、オブジェクトを手動でドラッグ モードにす
る必要があります。
オブジェクトをドラッグしているときに表示する組み込
みアイコン名、またはアイコン(ICO ファイル)ファイル
の名前を示します。デフォルトのアイコンは、オブジェク
トの大きさのボックスです。
オブジェクトが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。オ
ブジェクトが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
オブジェクトが使用可能(選択可能)かどうかを示しま
す。値は以下のとおりです。
TRUE - 選択できます。
FALSE - 選択できません。
Height
HScrollBar
Integer
Boolean
オブジェクトの高さを PowerBuilder 単位系で示します。
水平スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - 水平スクロールバーを表示します。
FALSE - 水平スクロールバーを表示しません。
LibraryName
String
オブジェクトとコントロール
(外部ユーザ オブジェクトのみ)外部ユーザ オブジェクト
のクラスを含む、ダイナミック リンク ライブラリ(DLL)
の名前です。
363
UserObject オブジェクト
UserObject プロパティ
LinesPerPage
ObjectType
PictureMaskColor
PictureName
データ型
Integer
UserObjects
(カタログ デー
タ型)
Long
String
Pointer
String
PowerTipText
String
Style
Long
TabBackColor
Long
説明
1 ページの行数を示します。デフォルトは 0 です(1 ペー
ジに 10 行)。詳細については、581 ページの「ウィンドウ
およびユーザ オブジェクト内でのスクロール」を参照し
てください。
PowerBuilder は、ユーザがスクロールバーをクリックし
縦方向にオブジェクトをスクロールするときの
PowerBuilder 単位系の数値を UnitsPerLine × LinesPerPage
という計算式で求めます。
ユーザ オブジェクトの型を示します。値は以下のとおり
です。
CustomVisual!
ExternalVisual!
背景色に使用されるピクチャの色を数値で示します。値の
範囲は -2 から 16,777,215 です。色についての詳細は、
『PowerScript リファレンス』マニュアルの RGB 関数を参照
してください。
このプロパティは、UserObject がタブ ページで、
PictureName にビットマップが指定された場合に適用され
ます。
タブに表示されるピクチャを、Pointer カタログ データ型
か、ビットマップ、カーソル、アイコンのピクチャを示す
ファイル名で示します。
このプロパティは、UserObject がタブ ページの場合にのみ
適用されます。
オブジェクトで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
Tab コントロールの PowerTips プロパティが TRUE のと
き、タブに対する PowerTips のテキストとして表示されま
す。このプロパティは、UserObject がタブ ページの場合に
のみ適用されます。
オブジェクトの表示を制御するために補足的に使用され
るスタイル ビットを示します(外部ユーザ オブジェクト
のみ)。
タブの背景色に使用する色を -2 から 16,777,215 の範囲の
数値で示します。色についての詳細は、『PowerScript リ
ファレンス』マニュアルの RGB 関数を参照してください。
このプロパティは、UserObject がタブ ページの場合にのみ
適用されます。このプロパティは、Windows XP ではサポー
トされていません。Windows XP では、タブの外観は現行
の XP テーマによって制御されるからです。
364
PowerBuilder
第2章
UserObject プロパティ
TabTextColor
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Long
TabOrder
Integer
Tag
Text
UnitsPerColumn
String
String
Integer
説明
タブのテキストに使用する色を -2 から 16,777,215 の範囲
の数値で示します。色についての詳細は、
『PowerScript リ
ファレンス』マニュアルの RGB 関数を参照してください。
このプロパティは、UserObject がタブ ページの場合にのみ
適用されます。
オブジェクトのタブ値を配置されているユーザ オブジェ
クトに対して示します(0 を指定すると、そのオブジェク
トにタブ移動できません)。
オブジェクトの持つタグ値を示します。
オブジェクトに表示されるテキストを示します。
ユーザがウィンドウまたはユーザ オブジェクトの水平ス
クロールバーで左矢印か右矢印をクリックしたときに、左
右にスクロールする量を PowerBuilder 単位系の数値で示
します。デフォルトは 0 です(ウィンドウの幅の 1/100)。
スクロールバーの下部を内容の下部に合わせるには、
UnitsPerLine を内容の幅に合わせて設定する必要がありま
す。詳細については、581 ページの「ウィンドウおよび
ユーザ オブジェクト内でのスクロール」を参照してくだ
さい。
UnitsPerLine
Integer
PowerBuilder は、ユーザがスクロールバーをクリックして
横方向にウィンドウをスクロールするときの PowerBuilder
単位系の数値を UnitsPerColumn × ColumnsPerPage という
式で求めます。
ユーザがウィンドウまたはユーザ オブジェクトの垂直ス
クロールバーで上矢印か下矢印をクリックしたときに、上
下にスクロールする量を PowerBuilder 単位系の数値で示
します。デフォルトは 0(ウィンドウの高さの 1/100)です。
スクロールバーの下部を内容の下部に合わせるには、
UnitsPerLine を内容の長さに合わせて設定する必要があり
ます。詳細については、581 ページの「ウィンドウおよび
ユーザ オブジェクト内でのスクロール」を参照してくだ
さい。
Visible
Boolean
PowerBuilder は、ユーザがスクロールバーをクリックして
縦方向にウィンドウをスクロールするときの PowerBuilder
単位系の数値を UnitsPerLine × LinesPerPage という計算式
で求めます。
オブジェクトが表示可能とするかどうかを示します。値は
以下のとおりです。
TRUE - オブジェクトを表示できます。
FALSE - オブジェクトを表示できません。
オブジェクトとコントロール
365
UserObject オブジェクト
UserObject プロパティ
VScrollBar
データ型
Boolean
説明
垂直スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - 垂直スクロールバーを表示します。
FALSE - 垂直スクロールバーを表示しません。
Width
X
Integer
Integer
Y
Integer
オブジェクトの幅を PowerBuilder 単位系で示します。
オブジェクトの X 位置(画面の左端からの距離)を
PowerBuilder 単位系で示します。
オブジェクトの Y 位置(画面の上部からの距離)を
PowerBuilder 単位系で示します。
イベント
UserObject イベント
Constructor
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
Help
Other
RButtonDown
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
オブジェクト上にドラッグ中のコントロールがドロップされるとき
オブジェクト上にドラッグ中のコントロールが入るとき
オブジェクトからドラッグ中のコントロールが離れるとき
オブジェクト内にドラッグ中のコントロールがあるとき
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
オブジェクトをマウスの右ボタンでクリックしたとき
関数
UserObject 関数
AddItem
ClassName
CreatePage
DeleteItem
Drag
GetContextService
戻り値のデータ型
Integer
String
Integer
Integer
Integer
Integer
GetParent
PowerObject
366
説明
項目をリストに追加します。
オブジェクトに与えられた名前を返します。
タブ ページが作成されていない場合、作成します。
リストから項目を削除します。
オブジェクトのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
UserObject 関数
Hide
InsertItem
Move
戻り値のデータ型
Integer
Integer
Integer
PageCreated
PointerX
Boolean
Integer
PointerY
Integer
PostEvent
Boolean
Print
Resize
SetFocus
SetPosition
Integer
Integer
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
オブジェクトとコントロール
説明
オブジェクトを非表示にします。
項目をリストに挿入します。
オブジェクトを、引数 X および Y で指定された位置に移
動します。
タブ ページが作成されたかどうかをレポートします。
画面の左端からポインタまでの距離を PowerBuilder 単位
系で返します。
画面の上部からポインタまでの距離を PowerBuilder 単位
系で返します。
オブジェクトのメッセージ キューの最後にイベントを追
加します。
オブジェクトを印刷します。
オブジェクトのサイズ(幅と高さ)を変更します。
オブジェクトにフォーカスを設定します。
オブジェクトをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
オブジェクトのプロパティを変更するたびに、オブジェク
トを自動再描画するかどうかを設定します。
オブジェクトを表示します。
オブジェクトにイベントを送り、そのイベントに関連付け
られたスクリプトを実行します。
オブジェクトのデータ型を返します。
367
VariableCardinalityDefinition オブジェクト
VariableCardinalityDefinition オブジェクト
変数の基本情報を提供するクラスです。対象の変数が 1 つのインスタ
ンスであるか配列であるかを通知します。配列であれば、その次元に
ついての情報を取得できます。VariableCardinalityDefinition は、
VariableDefinition オブジェクトの中で使用されます。イベントはあり
ません。
プロパティ
VariableCardinality
Definition プロパティ
ArrayDefinition[ ]
データ型
ArrayBounds
説明
関連する変数の Cardinality が BoundedArray! である場合
は、記述されている配列の各次元の ArrayBounds オブジェ
クトを持った配列です。
Cardinality が UnboundedArray! である場合は、
ArrayDefinition が持つ 1 つの ArrayBounds オブジェクトの
プロパティ LowerBound と UpperBound はどちらも 0 に設
定されます。配列のサイズはクラスでは定義されません。
Cardinality が ScalarType! の場合には無効です。
関連する変数の基本情報です。値は以下のとおりです。
ScalarType!
UnboundedArray!
BoundedArray!
Cardinality
Variable
CardinalityType
ClassDefinition
PowerObject
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
VariableCardinality
Definition 関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
関数
368
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
VariableDefinition オブジェクト
変数、プロパティ、または引数の特性を記述したクラスです。
VariableDefinition は、オブジェクト ClassDefinition および
ScriptDefinition の中でプロパティとして使用できます。イベントはあ
りません。
アプリケーション内で変数から開始して、
その変数の VariableDefinition オ
ブジェクトを取得することはできません。そのためには、ClassDefinition
インスタンスの VariableList 配列または ScriptDefinition インスタンスの
ArgumentList 配列の要素である VariableDefinition インスタンスにアク
セスしなければなりません。
VariableDefinition オブジェクトには次の情報が含まれます。
•
変数の名前と型
•
変数がスカラか配列か、およびその配列の情報
•
変数の初期値、その値が先祖の値を上書きするかどうか、および
変数が定数であるかどうか
•
変数の読み込み、書き込みレベル
•
変数のスコープ(グローバル、共有、インスタンス、ローカル、引
数)、特に変数が引数であるかどうかおよびその引数の受け渡し方
法
プロパティ
VariableDefinition
プロパティ
CallingConvention
データ型
ArgCalling
Convention
説明
Kind プロパティが VariableArgument! であるときの引数の
引き渡し方法です。値は以下のとおりです。
ByReferenceArgument!
ByValueArgument!
ReadOnlyArgument!
VarListArgument!
VarListArgument! は組み込みの PowerBuilder 関数の引数に
のみ適用されます。ブラウザ上では省略記号で表示されま
す。DataWindow コントロールの ImportString 関数の項を
参照してください。
オブジェクトとコントロール
369
VariableDefinition オブジェクト
VariableDefinition
プロパティ
Cardinality
ClassDefinition
データ型
Variable
Cardinality
Definition
PowerObject
InitialValue
Any
IsConstant
Boolean
IsControl
Boolean
IsUserDefined
Boolean
Kind
VariableKind
Name
OverridesAncestor
Value
String
Boolean
ReadAccess
VarAccess
TypeInfo
370
TypeDefinition
説明
変数の基本情報です。
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
変数の初期値。Kind プロパティが VariableArgument! であ
る場合には無効です。
変数が定数であるかどうかを示します。Kind プロパティ
が VariableArgument! である場合には無効です。
変数がデータ型としてコントロール クラスを持つインス
タンス変数ではなく、親内でネストされたクラスとして定
義されているかどうかを示します。Kind プロパティが
VariableInstance! である場合にのみ有効です。
変数が PowerBuilder で定義されているプロパティや変数
ではなく、ユーザ定義の変数かどうかを示します。
ローカル変数では常に TRUE です。引数の場合は、その関
数がユーザ定義の関数でもある場合は TRUE となります。
変数のスコープ値です。値は以下のとおりです。
VariableGlobal!
VariableShared!
VariableInstance!
VariableArgument!
VariableLocal!
グローバル変数は Application オブジェクトにのみ含まれ
ます。引数とローカル変数はスクリプトにのみ含まれま
す。
変数の名前です。
現行の初期値が先祖の初期値を書き換えるかどうかを示
します。Kind プロパティが VariableInstance! である場合に
のみ有効です。
変数への読み込みアクセス値です。値は以下のとおりです。
Private!
Public!
Protected!
System!
Kind プロパティが VariableArgument! または VariableLocal!
である場合には無効です。
変数の型情報です。
PowerBuilder
第2章
VariableDefinition
プロパティ
WriteAccess
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
VarAccess
説明
変数への書き込みアクセス値です。
値は以下のとおりです。
Private!
Public!
Protected!
System!
VariableArgument! または VariableLocal! の場合には無効で
す。
関数
VariableDefinition
関数
ClassName
GetContextService
戻り値のデータ型
String
Integer
GetParent
TypeOf
PowerObject
Object
説明
オブジェクトに与えられた名前を返します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
オブジェクトのデータ型を返します。
VProgressBar コントロール
プログレスバーを使用すると、多数のファイルをコピーするインス
トール プログラムなど、時間のかかる操作の進行状況を示すことがで
きます。VProgressBar(垂直プログレスバー)コントロールは、垂直方
向に延びる長方形で、操作の進行状況に応じてシステムのハイライト
色で徐々に塗りつぶされます。
プロパティ
VProgressBar
プロパティ
AccessibleDescription
データ型
String
オブジェクトとコントロール
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
371
VProgressBar コントロール
VProgressBar
プロパティ
AccessibleName
AccessibleRole
BringToTop
データ型
String
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
String
Height
MaxPosition
Integer
Unsigned Integer
MinPosition
Unsigned Integer
Pointer
String
372
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールの高さを PowerBuilder 単位系で示します。
プログレスバーがコントロールの最上部にあるときの
Position プロパティの値を示します。この値は、SetRange
関数で設定するコントロールの範囲の上限と異なる値で
もかまいません。
デフォルト値は 100 です。
プログレスバーがコントロールの最下部にあるときの
Position プロパティの値を示します。この値は、SetRange
関数で設定するコントロールの範囲の下限と異なる値で
もかまいません。
デフォルト値は 0 です。
コントロールで使用するポインタを、組み込みポインタ名
か、ポインタを含むファイル名で示します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
VProgressBar
プロパティ
Position
データ型
Integer
SetStep
SmoothScroll
Integer
Boolean
TabOrder
Integer
Tag
Visible
String
Boolean
説明
コントロールの範囲(SetRange 関数で設定)内にある現
在の位置の値を示します。コントロールは、範囲と現在の
位置から、プログレスバーをハイライト色で塗りつぶす割
合を決定します。
プログレスバーの増分値を示します。デフォルトは 10 です。
進行状況が、デフォルトのセグメント化されたバーではな
く、滑らかなスクロールバーとして表示されることを示し
ます。
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で指定します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
VProgressBar イベント
Clicked
Constructor
Destructor
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
発生する状況
コントロール上でマウスの左ボタンがクリックされたとき
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上でマウスの左ボタンがダブルクリックされたとき
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
オブジェクトとコントロール
373
VProgressBar コントロール
VProgressBar イベント
LoseFocus
Other
RightClicked
発生する状況
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
コントロールをマウスの右ボタンでクリックしたとき
関数
VProgressBar 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
OffsetPos
PowerObject
Integer
Integer
Integer
PointerX
PointerY
PostEvent
Integer
Integer
Boolean
Print
Resize
Integer
Integer
SetFocus
SetPosition
Integer
Integer
SetRange
Integer
SetRedraw
Integer
Show
StepIt
Integer
Integer
TriggerEvent
Integer
TypeOf
Object
374
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの現在の位置を指定された量だけ移動しま
す。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールの範囲を設定します。コントロールは、範囲
と現在の位置から、プログレスバーをハイライト色で塗り
つぶす割合を決定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
コントロールの現在の位置を SetStep プロパティの値で指
定した量だけ移動します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
VScrollBar コントロール
VScrollBar(垂直スクロールバー)コントロールは縦形の棒状のコント
ロールです。両端には矢印があり、その間に位置するスクロール ボッ
クス(つまみ)によって、相対的な分量や進行状況(たとえば、作業
がどのくらいまで完了しているか)などを示すことができます。
使用上の注意
VScrollBar コントロールは、あるコントロール内の情報をスクロール
するための垂直スクロールバー プロパティとは異なります。
プロパティ
VScrollBar プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
BringToTop
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
オブジェクトとコントロール
375
VScrollBar コントロール
VScrollBar プロパティ
DragIcon
データ型
String
Height
MaxPosition
Integer
Integer
MinPosition
Integer
Pointer
String
Position
Integer
StdWidth
Boolean
説明
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールの高さを PowerBuilder 単位系で示します。
スクロール ボックスがスクロールバーの最下部にあると
きの Position プロパティの値を示します。
スクロール ボックスがスクロールバーの最上部にあると
きの Position プロパティの値を示します。
コントロールで使用するポインタを、組み込みポインタ名
か、マウス ポインタを含むファイル名で示します。
MinPosition プロパティと MaxPosition プロパティの間の値
を指定して、スクロール ボックスの位置を決めます。
VScrollBar コントロールを標準のスクロールバー幅で表
示するかどうかを示します。値は以下のとおりです。
TRUE - 標準の幅を使用します。
FALSE - 標準の幅を使用しません。
TabOrder
Integer
Tag
Visible
String
Boolean
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
376
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で示します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
イベント
VScrollBar イベント
Constructor
Destructor
DragDrop
DragEnter
DragLeave
DragWithin
GetFocus
Help
LineDown
LineUp
LoseFocus
Moved
Other
PageDown
PageUp
RButtonDown
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
コントロールの下矢印がクリックされたとき
コントロールの上矢印がクリックされたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
スクロール ボックスが移動されるとき(Position プロパティによって新しい
場所が決定されるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
スクロール ボックスの下側のシャフト部分がクリックされたとき
スクロール ボックスの上側のシャフト部分がクリックされたとき
コントロールをマウスの右ボタンでクリックしたとき
関数
VScrollBar 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Integer
オブジェクトとコントロール
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
377
VTrackBar コントロール
VScrollBar 関数
Resize
SetFocus
SetPosition
戻り値のデータ型
Integer
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
説明
コントロールのサイズを変更します。
コントロールにフォーカスをセットします。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
VTrackBar コントロール
トラックバーは、スクロールバーと同じようにスクロールするコント
ロールとして使用しますが、トラックバーのスライダをクリックする
と、連続的に移動せずに不連続な増分値で移動します。VTrackBar(垂
直トラックバー)コントロールでは、トラックバー チャネルの右側に
一連の目盛りが表示されます。
このコントロールをキーボードから正しく使用できるようにするに
は、LineDown、LineUp、PageDown、および PageUp イベントにコード
を追加する必要があります。追加するコードによって、スライダの
Position プロパティが適切な値だけ変更され、TrackBar コントロールに
関連付ける 1 つまたは複数のオブジェクトに新しいスライダ位置が渡
されます。スライダがマウスでドラッグされた後、TrackBar コントロー
ルがスライダ位置に移るようにする場合は、Moved イベントのコード
を追加する必要があります。
使用上の注意
TrackBar は、ユーザが不連続な値を選択できるようにするときに使用
します。たとえば、タイマーの間隔やウィンドウのサイズをユーザが
選択できるようにする場合に TrackBar を使用します。
378
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
プロパティ
VTrackBar プロパティ
AccessibleDescription
データ型
String
AccessibleName
String
AccessibleRole
BringToTop
AccessibleRole
(カタログ デー
タ型)
Boolean
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
コントロールをウィンドウの最前面に移動するかどうか
を示します。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
ClassDefinition
PowerObject
DragAuto
Boolean
DragIcon
String
Height
LineSize
Integer
Integer
MaxPosition
Integer
MinPosition
Integer
オブジェクトとコントロール
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
コントロールを自動的にドラッグ モードにするかどうか
を示します。値は以下のとおりです。
TRUE - コントロールをクリックすると、自動的にド
ラッグ モードになります。
FALSE - コントロールをクリックしても、自動的には
ドラッグ モードになりません。この場合、Drag 関数を
使用して、コントロールを手動でドラッグ モードにす
る必要があります。
コントロールをドラッグしているときに表示する組み込
みアイコン名、またはアイコン ファイル(ICO ファイル)
の名前を示します。デフォルトのアイコンは、コントロー
ルの大きさのボックスです。
コントロールが配置可能な領域(有効ドロップ領域)上に
ドラッグされると、指定したアイコンが表示されます。コ
ントロールが有効ドロップ領域外にあるときには、ドロッ
プ禁止 アイコンが表示されます。
コントロールの高さを PowerBuilder 単位系で示します。
矢印キーによるキーボード入力に応答してスライダが移
動する距離を指定します。
スライダがコントロールの最下部にあるときの Position
プロパティの値を示します。
スライダがコントロールの最上部にあるときの Position
プロパティの値を示します。
379
VTrackBar コントロール
VTrackBar プロパティ
PageSize
データ型
Integer
Pointer
String
Position
Integer
Slider
SliderSize
TabOrder
Boolean
Integer
Integer
Tag
TickFrequency
String
Integer
TickMarks
Visible
VTickMarks
(カタログ デー
タ型)
Boolean
説明
キーボードまたはマウスの入力に応答してスライダが移
動する距離を示します。PageSize を 1 に設定すると、スラ
イダは値の範囲内で 1 増分値だけ移動します。
コントロールで使用するポインタを、組み込みポインタ名
か、ポインタを含むファイル名で示します。
MinPosition プロパティと MaxPosition プロパティの間の値
を指定して、スライダの位置を決定します。
TrackBar にスライダを含めるかどうかを指定します。
TrackBar のスライダのサイズを示します。
ウィンドウ内部のコントロールのタブ値(順序)を指定し
ます(0 を指定すると、ユーザはコントロールにタブ移動
できません)。
コントロールに割り当てるタグの値を示します。
目盛りの度数を示します。TickFrequency を 1 に設定する
と、トラックバーの値の範囲内の 1 増分値に対して 1 目盛
りが割り当てられます。
目盛りが表示される位置を示します。値は以下のとおりで
す。
VTicksOnLeft!
VTicksOnRight!
VTicksOnBoth!
VTicksOnNeither!
コントロールが表示可能かどうかを示します。値は以下の
とおりです。
TRUE - コントロールを表示できます。
FALSE - コントロールを表示できません。
Width
X
Integer
Integer
Y
Integer
コントロールの幅を PowerBuilder 単位系で示します。
X 位置(ウィンドウの左端からの距離)を PowerBuilder 単
位系で指定します。
Y 位置(ウィンドウの上部からの距離)を PowerBuilder 単
位系で指定します。
イベント
VTrackBar イベント
Constructor
Destructor
DragDrop
380
発生する状況
ウィンドウの Open イベントが発生する直前
ウィンドウの Close イベントが発生した直後
コントロール上にドラッグ中のコントロールがドロップされたとき
PowerBuilder
第2章
VTrackBar イベント
DragEnter
DragLeave
DragWithin
GetFocus
Help
LineDown
LineUp
LoseFocus
Moved
Other
PageDown
PageUp
RButtonDown
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
発生する状況
コントロール上にドラッグ中のコントロールが入るとき
コントロールからドラッグ中のコントロールが離れるとき
コントロール内にドラッグ中のコントロールがあるとき
コントロールがフォーカスを受ける直前(選択されて、アクティブ状態にな
る前)
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
〔↓〕が押されたとき
〔↑〕が押されたとき
コントロールがフォーカスを失ったとき(アクティブ状態でなくなるとき)
スライダが移動したとき(Position プロパティによって新しい場所が決定さ
れるとき)
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
〔PageDown〕が押されたとき、または TrackBar チャネルでスライダの下側が
クリックされたとき
〔PageUp〕が押されたとき、または TrackBar チャネルでスライダの上側がク
リックされたとき
コントロールをマウスの右ボタンでクリックしたとき
関数
VTrackBar 関数
ClassName
Drag
GetContextService
戻り値のデータ型
String
Integer
Integer
GetParent
Hide
Move
PointerX
PointerY
PostEvent
PowerObject
Integer
Integer
Integer
Integer
Boolean
Print
Resize
Integer
Integer
オブジェクトとコントロール
説明
コントロールに与えられている名前を返します。
コントロールのドラッグを開始または終了します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
親オブジェクト名への参照を返します。
コントロールを非表示にします。
指定された位置にコントロールを移動します。
コントロールの左端からポインタまでの距離を返します。
コントロールの上部からポインタまでの距離を返します。
コントロールのメッセージ キューの最後にイベントを追
加します。
コントロールを印刷します。
コントロールのサイズを変更します。
381
Window コントロール
VTrackBar 関数
SelectionRange
戻り値のデータ型
Integer
SetFocus
SetPosition
Integer
Integer
SetRedraw
Integer
Show
TriggerEvent
Integer
Integer
TypeOf
Object
説明
TrackBar の選択範囲を設定します。範囲を選択すると、
TrackBar のチャネルに青い線が表示され、目盛りの場所に
選択範囲の下限と上限を示す 2 つの矢印が表示されます。
コントロールにフォーカスを設定します。
コントロールをウィンドウ上のほかのオブジェクトの前
面に置くか背面に置くか、位置を指定します。
コントロールのプロパティを変更するたびに、コントロー
ルを自動再描画するかどうかを制御します。
コントロールを表示します。
指定されたイベントをコントロール内で起動し、そのイベ
ントのスクリプトを実行します。
コントロールのデータ型を返します。
Window コントロール
Window(ウィンドウ)コントロールは、ユーザと PowerBuilder アプリ
ケーション間の主要なインタフェースです。PowerBuilder アプリケー
ションではウィンドウを使って、情報の表示、ユーザへの情報の要求、
マウスやキーボードからの入力に対する応答などを行います。
ウィンドウの定義には、プロパティ、イベントおよび関数が含まれま
す。プロパティは、ウィンドウのスタイル、つまり表示や動作の形態
を決定します。イベントは、ウィンドウ内で引き起こされるアクショ
ンです。イベントが起動されると、関連するスクリプトが実行されま
す。関数は、ウィンドウ内のイベントの起動、ウィンドウの操作や変
更、ウィンドウに関する情報の取得に使用されます。
プロパティ
すべてのウィンドウには、表示形態を決定するスタイルがあります。
スタイルは、ウィンドウのプロパティに割り当てられている値で決定
されます。
Window プロパティ
AccessibleDescription
382
データ型
String
説明
コントロールを視覚障害者用の画面読み上げなどのアク
セシビリティ ツールで使用する場合に、コントロールや
その目的に関する説明を指定します。
PowerBuilder
第2章
Window プロパティ
AccessibleName
AccessibleRole
BackColor
Border
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
String
AccessibleRole
(カタログ デー
タ型)
Long
Boolean
説明
ボタンのテキストやメニュー項目名など、コントロールを
簡単に説明するラベルを指定します。
コントロールがどのようなユーザ インタフェース要素で
あるかを説明します。
ウィンドウの背景色を -2 から 16,777,215 の範囲の数値で
示します。色についての詳細は、『PowerScript リファレン
ス』マニュアルの RGB 関数を参照してください。
ウィンドウが枠線を持つかどうかを示します。値は以下の
とおりです。
TRUE - 枠線を付けます。
FALSE - 枠線を付けません。
BringToTop
Boolean
ウィンドウが画面の最前面に移動するかどうかを示しま
す。値は以下のとおりです。
TRUE - 最前面に移動します。
FALSE - 最前面に移動しません。
Center
Boolean
ウィンドウの作成またはサイズ変更を行ったときに、その
ウィンドウを中央に配置します。値は以下のとおりです。
TRUE - ウィンドウを中央に配置します。
FALSE - ウィンドウを中央に配置しません。
ClassDefinition
PowerObject
ClientEdge
Boolean
オブジェクトまたはコントロールのクラス定義に関する
情報を含む PowerObject 型のオブジェクトです。
ウィンドウのクライアント領域を、フレーム内にくぼんだ
立体表示にするかどうかを示します。
TRUE - クライアント領域をくぼんだ立体表示にしま
す。
FALSE - クライアント領域をくぼんだ立体表示にしま
ColumnsPerPage
Integer
せん。
1 ページのカラム数を示します。デフォルトは 0 です(1
ページに 10 カラム)。詳細については、581 ページの「ウィ
ンドウおよびユーザ オブジェクト内でのスクロール」を
参照してください。
PowerBuilder は、ユーザがスクロールバーをクリックして
横方向にウィンドウをスクロールするときの PowerBuilder
単位系の数値を UnitsPerColumn × ColumnsPerPage という
式で求めます。
オブジェクトとコントロール
383
Window コントロール
Window プロパティ
ContextHelp
データ型
Boolean
Control[ ]
WindowObject
ControlMenu
Boolean
説明
WindowType = Response! のとき、タイトル バーに小さな疑
問符([?])ボタンを表示するかどうかを示します。
[?]ボ
タンをクリックしてからコントロールをクリックすると、
その Help イベントが起動します。
TRUE - レスポンス ウィンドウのタイトル バーの最小
化ボタンの隣りに[?]ボタンが表示されます。
FALSE -[?]ボタンは表示されません。
ウィンドウ内のコントロールが保持されます。この配列の
内容はスクリプトでは変更できません。
タイトル バーにコントロール メニュー ボックスを表示す
るかどうかを示します。値は以下のとおりです。
TRUE - タイトル バーに表示します。
FALSE - タイトル バーに表示しません。
Enabled
Boolean
ウィンドウを使用可能(メッセージの送信 / 受信ができる
状態)にするかどうかを示します。値は以下のとおりです。
TRUE - メッセージの送信 / 受信ができます。
FALSE - メッセージの送信 / 受信ができません。
Height
HScrollBar
Integer
Boolean
ウィンドウの高さを PowerBuilder 単位系で示します。
実行時には、最大化または最小化されているウィンドウの
サイズを変更できません。
水平スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - スクロールバーを表示します。
FALSE - スクロールバーを表示しません。
Icon
LinesPerPage
String
Integer
組み込みアイコン、またはウィンドウがアイコン化された
ときに表示される ICO ファイルを示します。
デフォルト値は AppIcon!(Application オブジェクト用に選
択されているアイコン)です。Application オブジェクト用
のアイコンが選択されていない場合は、Windows のロゴが
使用されます。
1 ページの行数を示します。デフォルトは 0 です(1 ペー
ジに 10 行)。詳細については、581 ページの「ウィンドウ
およびユーザ オブジェクト内でのスクロール」を参照し
てください。
PowerBuilder は、ユーザがスクロールバーをクリックして
縦方向にウィンドウをスクロールするときの PowerBuilder
単位系の数値を UnitsPerLine × LinesPerPage という計算式
で求めます。
384
PowerBuilder
第2章
Window プロパティ
MaxBox
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Boolean
説明
タイトル バーに最大化ボタンを表示するかどうかを示し
ます。値は以下のとおりです。
TRUE - 最大化ボタンを表示します。
FALSE - 最大化ボタンを表示しません。
MenuID
MenuName
MinBox
Menu
メニューの ID を示します。
String
MenuID は PowerBuilder が 内部的に使用するプロパティで
す。スクリプトからウィンドウのメニューを変更する場合
は、ChangeMenu 関数を使ってください。また、ポップアッ
プ メニューを表示する場合は、PopMenu 関数を使います。
どちらの関数でも、フルネームを用いてメニューやメ
ニュー項目を指定してください。
メニューの名前を示します。
Boolean
MenuName は PowerBuilder が 内部的に使用するプロパ
ティです。スクリプトからウィンドウのメニューを変更す
る場合は、ChangeMenu 関数を使ってください。また、ポッ
プアップ メニューを表示する場合は、PopMenu 関数を使
います。どちらの関数でも、フルネームを用いてメニュー
やメニュー項目を指定してください。
タイトル バーに最小化ボタンを表示するかどうかを示し
ます。値は以下のとおりです。
TRUE - 最小化ボタンを表示します。
FALSE - 最小化ボタンを表示しません。
PaletteWindow
Boolean
Pointer
String
Resizable
Boolean
WindowType = Popup! のとき、ウィンドウがそのアプリ
ケーション上に表示されるときに、小さなパレット ウィ
ンドウの外観になることを示します。
TRUE - ポップアップ ウィンドウは、タイトル バーに
小さな閉じるボタンがあり、最小化または最大化ボタン
がないウィンドウとして、最前面に表示されます。
FALSE - 外観は変更されません。
ウィンドウで使うマウス ポインタを含むファイル名を示
します。
ウィンドウのサイズが変更できるかどうかを示します。値
は以下のとおりです。
TRUE - ウィンドウのサイズを変更できます。
FALSE - ウィンドウのサイズを変更できません。
RightToLeft
Boolean
文字を右から左の向きに表示するかどうかを示します。ア
プリケーションは、右から左への表示をサポートするオペ
レーティング システム上で実行する必要があります。値
は以下のとおりです。
TRUE - 文字を右から左の向きに表示します。
FALSE - 文字を左から右の向きに表示します。
オブジェクトとコントロール
385
Window コントロール
Window プロパティ
Tag
Title
TitleBar
データ型
String
String
Boolean
説明
ウィンドウに与えられたタグ値を示します。
ウィンドウ タイトルに表示されるテキストを示します。
タイトル バーを表示するかどうかを示します。値は以下
のとおりです。
TRUE - タイトル バーを表示します。
FALSE - タイトル バーを表示しません。
ToolbarAlignment
ToolbarAlignment
(カタログ デー
タ型)
ToolbarHeight
Integer
ToolbarVisible
Boolean
ウィンドウが移動できるのは、タイトル バーがある場合
だけです。
MDI フレーム ウィンドウにおいて、ツールバーの表示場
所を示します。値は以下のとおりです。
AlignAtBottom!
AlignAtLeft!
AlignAtRight!
AlignAtTop!
Floating!
MDI フレーム ウィンドウにおいて、浮動型ツールバーが
表示されるときのツールバーの高さを示します。
MDI フレーム ウィンドウにおいて、ツールバーを表示す
るかどうかを示します。値は以下のとおりです。
TRUE - ツールバーを表示します。
FALSE - ツールバーを表示しません。
ToolbarWidth
Integer
ToolbarX
Integer
ToolbarY
Integer
386
MDI フレーム ウィンドウにおいて、浮動型ツールバーが
表示されるときのツールバーの幅を示します。
MDI フレーム ウィンドウにおいて、浮動型ツールバーの
X 座標(ウィンドウの左端からの PowerBuilder 単位系での
距離)を示します。
MDI フレーム ウィンドウにおいて、浮動型ツールバーの
Y 座標(ウィンドウの上部からの PowerBuilder 単位系での
距離)を示します。
PowerBuilder
第2章
Window プロパティ
UnitsPerColumn
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
データ型
Integer
説明
ユーザがウィンドウまたはユーザ オブジェクトの水平ス
クロールバーで左矢印か右矢印をクリックしたときに、左
右にスクロールする量を PowerBuilder 単位系の数値で示
します。デフォルトは 0 です(ウィンドウの幅の 1/100)。
スクロールバー の下部を内容の下部に合わせる には、
UnitsPerLine を内容の幅に合わせて設定する必要がありま
す。詳細については、581 ページの「ウィンドウおよび
ユーザ オブジェクト内でのスクロール」を参照してくだ
さい。
UnitsPerLine
Integer
PowerBuilder は、ユーザがスクロールバーをクリックして
横方向にウィンドウをスクロールするときの PowerBuilder
単位系の数値を UnitsPerColumn × ColumnsPerPage という
式で求めます。
ユーザがウィンドウまたはユーザ オブジェクトの垂直ス
クロールバーで上矢印か下矢印をクリックしたときに、上
下にスクロールする量を PowerBuilder 単位系の数値で示
します。デフォルトは 0(ウィンドウの高さの 1/100)です。
スクロールバー の下部を内容の下部に合わせる には、
UnitsPerLine を内容の長さに合わせて設定する必要があり
ます。詳細については、581 ページの「ウィンドウおよび
ユーザ オブジェクト内でのスクロール」を参照してくだ
さい。
Visible
Boolean
PowerBuilder は、ユーザがスクロールバーをクリックして
縦方向にウィンドウをスクロールするときの PowerBuilder
単位系の数値を UnitsPerLine × LinesPerPage という計算式
で求めます。
ウィンドウが表示可能かどうかを示します。値は以下のと
おりです。
TRUE - ウィンドウを表示できます。
FALSE - ウィンドウを表示できません。
VScrollBar
Boolean
垂直スクロールバーを表示するかどうかを示します。値は
以下のとおりです。
TRUE - スクロールバーを表示します。
FALSE - スクロールバーを表示しません。
Width
Integer
ウィンドウの幅を PowerBuilder 単位系で示します。
実行時には、最大化または最小化されているウィンドウの
サイズを変更できません。
オブジェクトとコントロール
387
Window コントロール
Window プロパティ
WindowState
WindowType
X
データ型
WindowState
(カタログ デー
タ型)
WindowType
(カタログ デー
タ型)
Integer
説明
ウィンドウを実行させる際の状態を示します。値は以下の
とおりです。
Maximized!
Minimized!
Normal!
シートとして開くウィンドウの Open イベントの
WindowState プロパティは変更しないでください。
ウィンドウの種類を示します。値は以下のとおりです。
Child!
Main!
MDI!
MDIHelp!
Popup!
Response!
ウィンドウの X 位置(画面の左端からの距離)を
PowerBuilder 単位系で示します。
チャイルド ウィンドウ以外のウィンドウの X 座標の値
は、画面の左端から測定されます。チャイルド ウィンド
ウの X 座標は、親ウィンドウのワークスペースの左端か
ら測定されます。
ワークスペースは、ウィンドウの左端および右端とウィン
ドウの上部および下部との間の部分です。左端および右端
にはフレーム、ツールバー、スクロールバーなどのある部
分を含みません。上部および下部には枠線、タイトル バー、
メニュー バー、ツールバー、スクロールバーなどのある
部分を含みません。
Y
Integer
最大化したウィンドウは実行時に移動できません。
ウィンドウの Y 位置(画面の上部からの距離)を
PowerBuilder 単位系で示します。
チャイルド ウィンドウ以外のウィンドウの Y 座標の値
は、画面の上部から測定されます。チャイルド ウィンド
ウの Y 座標は、親ウィンドウのワークスペースの上部か
ら測定されます。
ワークスペースは、ウィンドウの左端および右端とウィン
ドウの上部および下部との間の部分です。左端および右端
にはフレーム、ツールバー、スクロールバーなどのある部
分を含みません。
上部および下部には枠線、タイトル バー、
メニュー バー、ツールバー、スクロールバーなどのある
部分を含みません。
最大化したウィンドウは実行時に移動できません。
388
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
イベント
ウィンドウ内で起こったイベントに呼応する動作は、スクリプトに
よって記述します。つまり、ウィンドウの動作は、ウィンドウやその
ウィンドウ内のコントロールで起こったイベントに対するスクリプト
によって決定されます。
Window イベント
Activate
Clicked
Close
CloseQuery
Deactivate
DoubleClicked
DragDrop
DragEnter
DragLeave
DragWithin
Help
Hide
HotLinkAlarm
Key
MouseDown
MouseMove
発生する状況
ウィンドウがアクティブになる直前。Activate イベントが発生すると、ウィ
ンドウ上でタブ順序の最初のオブジェクトにフォーカスが移ります。ウィン
ドウに使用可能なオブジェクトがない場合は、ウィンドウがフォーカスを得
ます。
ウィンドウの未使用領域(表示可能で使用可能なオブジェクトが配置されて
いない領域)がクリックされたとき
ウィンドウが閉じられるとき
開発者が画面からウィンドウを除去するとき(閉じるとき)。開発者がウィ
ンドウを閉じる際、PowerBuilder は CloseQuery イベントを発生させ、
Message.ReturnValue の値を調べます。Message.ReturnValue が 1 の場合、
ウィンドウは閉じられません。
ウィンドウを閉じる際に、関連するすべてのチャイルド ウィンドウとポッ
プアップ ウィンドウも閉じられます。MDI フレーム ウィンドウを閉じる場
合、その MDI フレーム ウィンドウ内のすべてのシート ウィンドウも閉じら
れます。これらの付随するウィンドウも、Message.ReturnValue の設定によっ
て、閉じる操作を取り消せます。
ウィンドウがアクティブ状態でなくなるとき
ウィンドウの未使用領域(表示可能で使用可能なオブジェクトが配置されて
いない領域)がダブルクリックされたとき
ウィンドウ上でドラッグ中のコントロールがドロップされるとき
ウィンドウ上にドラッグ中のコントロールが入るとき
ウィンドウからドラッグ中のコントロールが離れるとき
ウィンドウ内にドラッグ中のコントロールがあるとき
ユーザが〔F1〕を押すか、タイトル バーにある状況依存ヘルプ ボタン([?])
をメニュー項目またはコントロールへドラッグしたとき
ウィンドウを隠す(非表示状態にする)直前
ダイナミック データ エクスチェンジ(DDE)サーバ アプリケーションが新
規に(または更新された)データを送り、DDE クライアント アプリケーショ
ンが送られたデータを受け取った後
挿 入 ポ イ ントがライン
エディット(RichTextEdit
コントロールや
DataWindow コントロール)にない状況で、ユーザがキーを押したとき
ユーザがウィンドウの未使用領域(表示可能で使用可能なオブジェクトが配
置されていない領域)でマウスの左ボタンを押したとき
ポインタがウィンドウ内で移動するとき
オブジェクトとコントロール
389
Window コントロール
Window イベント
MouseUp
Open
Other
RButtonDown
RemoteExec
RemoteHotLinkStart
RemoteHotLinkStop
RemoteRequest
RemoteSend
Resize
Show
SystemKey
Timer
ToolbarMoved
発生する状況
ユーザがウィンドウの未使用領域(表示可能で使用可能なオブジェクトが配
置されていない領域)でマウスの左ボタンを放すとき
スクリプトがウィンドウの Open 関数を実行するとき。Open イベントはウィ
ンドウが開かれてから表示されるまでに発生します。
PowerBuilder のイベントではないウィンドウのメッセージが発生したとき
ウィンドウの未使用領域(表示可能で使用可能なオブジェクトが配置されて
いない領域)でマウスの右ボタンが押されるとき
DDE クライアント アプリケーションがコマンドを送ったとき
DDE クライアント アプリケーションがホット リンクを開始しようとすると
き
DDE クライアント アプリケーションがホットリンクを終了しようとすると
き
DDE クライアント アプリケーションがデータを要求するとき
DDE クライアント アプリケーションがデータを送ったとき
ユーザまたはスクリプトがウィンドウを開くか、あるいは、サイズを変更す
るとき
スクリプトがウィンドウの Show 関数を実行するとき。Show イベントはウィ
ンドウが表示される直前に起こります。
挿 入 ポ イ ン ト がライン
エディット(RichTextEdit
コントロールや
DataWindow コントロール)にない状況で、ユーザが〔Alt〕、または〔Alt〕
と何か別のキーを押したとき
Timer 関数が呼び出された後、指定された秒数が経過するとき
MDI フレーム ウィンドウにおいて、ユーザがフレームバーまたはシート
バーを移動するとき
関数
以下の関数は、ウィンドウ内のイベントの起動、ウィンドウの操作や
変更、ウィンドウについての情報の取得に用いる PowerScript システム
関数です。
PowerScript システム 関数
これらは、ウィンドウのスクリプトにおいて開発者が用いることがで
きます。これらの関数のリストは、オブジェクト ブラウザで表示する
ことができます。
390
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
ウィンドウの開き方、閉じ方
Open 関数でウィンドウを開き、Close 関数でウィンドウを閉じてくだ
さい。Open 関数と Close 関数はシステム関数なので、ここには記載さ
れていません。
Window 関数
ArrangeSheets
戻り値のデータ型
Integer
ChangeMenu
ClassName
CloseChannel
CloseUserObject
Integer
String
Integer
Integer
ExecRemote
Integer
GetActiveSheet
Window
GetCommandDDE
Integer
GetCommandDDEOrigin
Integer
GetContextService
Integer
GetDataDDE
Integer
GetDataDDEOrigin
Integer
GetFirstSheet
GetNextSheet
Window
Window
GetParent
GetRemote
PowerObject
Integer
GetToolbar
Integer
GetToolbarPos
Integer
オブジェクトとコントロール
説明
指定された MDI フレーム ウィンドウ内のシートまたはア
イコンを整列します。
ウィンドウと関連付けられているメニューを変更します。
ウィンドウに与えられた名前を返します。
DDE チャネルを閉じます。
ユーザ オブジェクトの表示を止め、そのオブジェクトを
閉じて Destructor イベントを起動します。
DDE サーバ アプリケーションに、指定されたコマンドを
実行するように要求します。
指定された MDI フレーム ウィンドウ内で現在アクティブ
なシートを返します。
アプリケーションが DDE サーバのとき、クライアント ア
プリケーションから送られたコマンドを取得します。
DDE サーバ アプリケーションから呼び出されたときに、
コマンドの送信元の DDE クライアントによって使用され
るアプリケーション名のパラメータを取得します。
指定されたサービスのコンテキストに固有のインスタン
スへの参照を作成します。
ほかの DDE アプリケーションから送信されたデータを取
得し、指定された String 型の変数に格納します。
ホット リンクが設定された DDE サーバ アプリケーショ
ンまたは DDE クライアント アプリケーションのデータの
送信元を確認します。正常終了した場合、アプリケーショ
ンの DDE 識別子を指定された文字列に格納します。
MDI フレームの最前面のシートを返します。
MDI フレームにおいて、指定されたシートの背面にある
シートを返します。
親オブジェクト名への参照を返します。
DDE サーバ アプリケーションに対してデータを返し、そ
のデータを指定された変数に格納するように要求します。
ツールバーの Visible、Alignment、および Title プロパティ
の値を取得します。
浮動型ツールバーの位置情報(座標値)を取得します。
391
Window コントロール
Window 関数
Hide
Move
戻り値のデータ型
Integer
Integer
OpenChannel
OpenUserObject
Long
Integer
OpenUserObjectWithParm
Integer
ParentWindow
PointerX
PointerY
PostEvent
Window
Integer
Integer
Boolean
Print
Resize
Integer
Integer
RespondRemote
Integer
SetDataDDE
Integer
SetFocus
SetMicroHelp
Integer
Integer
SetPosition
Integer
SetRedraw
Integer
SetRemote
Integer
SetToolbar
Integer
SetToolbarPos
Integer
392
説明
ウィンドウを非表示にします。
引数 X および Y で指定された位置にウィンドウを移動し
ます。
最大化されたウィンドウは、Move 関数では移動できませ
ん。
DDE サーバ アプリケーションへのチャネルを開きます。
指定されたユーザ オブジェクトを表示します。これに
よって、オブジェクトのプロパティがスクリプトで使用で
きるようになります。
指定されたユーザ オブジェクトを表示して、そのプロパ
ティをスクリプトで使用できるようにし、さらにパラメー
タを Message オブジェクトに格納します。
そのウィンドウの親ウィンドウを返します。
画面の左端からポインタまでの距離を返します。
画面の上部からポインタまでの距離を返します。
ウィンドウのメッセージ キューの最後にイベントを追加
します。
ウィンドウを印刷します。
ウィンドウのサイズを、幅と高さの引数で指定されたサイ
ズに変更します。
最小化または最大化されたウィンドウは、Resize 関数では
サイズ変更できません。
リモート DDE アプリケーションから受け取ったコマンド
またはデータが有効かどうかを示す、DDE メッセージを
送信します。
PowerBuilder が DDE サーバとして動作しているとき、
DDE クライアント アプリケーションにデータを送信しま
す。
指定されたウィンドウにフォーカスを設定します。
指定された MDI フレーム ウィンドウにマイクロヘルプ
テキストを設定します。
アプリケーションにおいてウィンドウを常に前面に表示
するかどうか、位置を指定します。
ウィンドウのプロパティを変更するたびに、ウィンドウを
自動再描画するかどうかを設定します。
DDE サーバ アプリケーションに対して、データの受信と、
そのデータの指定位置への格納を依頼します。
ツールバーの Visible、Alignment、および Title プロパティ
に値を設定します。
固定型ツールバーの位置を設定します。
PowerBuilder
第2章
PowerBuilder システム オブジェクトのプロパティ、イベント、関数
Window 関数
Show
StartHotLink
戻り値のデータ型
Integer
Integer
StartServerDDE
StopHotLink
Integer
Integer
StopServerDDE
Integer
TriggerEvent
Integer
TypeOf
WorkSpaceHeight
Object
Integer
WorkSpaceWidth
Integer
WorkSpaceX
Integer
WorkSpaceY
Integer
オブジェクトとコントロール
説明
ウィンドウを表示します。
DDE サーバ アプリケーションとのホット リンクを確立し
て、指定されたデータに変更があれば、すぐに PowerBuilder
にその変更が通知されるようにします。
アプリケーションを DDE サーバとして確立します。
DDE サーバ アプリケーションとのホット リンクを終了し
ます。
アプリケーションの DDE サーバとしての動作を終了させ
ます。
Window コントロールにイベントを送り、そのイベントに
関連付けられたスクリプトを実行します。
ウィンドウの種類を返します。
指定されたウィンドウのワークスペースの高さを返しま
す。
ワークスペースは、ウィンドウの左端および右端とウィン
ドウの上部および下部との間の部分です。左端および右端
にはフレーム、ツールバー、スクロールバーなどのある部
分を含みません。上部および下部には枠線、タイトル
バー、メニュー バー、ツールバー、スクロールバーなど
のある部分を含みません。
指定されたウィンドウのワークスペースの幅を返します。
画面の左端を原点とし、指定されたウィンドウのワークス
ペースの左端までの距離を返します。
画面の上部を原点とし、指定されたウィンドウのワークス
ペースの上部までの距離を返します。
393
Window コントロール
394
PowerBuilder
第 3 章
プロパティの説明と使用法
この章について
この章には、PowerBuilder コントロールのプロパティを掲載して
います。データウィンドウ オブジェクト内のコントロールのプロ
パティについては、
『データウィンドウ リファレンス』マニュアル
を参照してください。
内容
プロパティはアルファベット順に記載されています。
Accelerator
対象
ユーザ入力を受け取るコントロール。リストボックス、マルチラ
イン エディット、シングルライン エディット、リストビュー、エ
ディットマスク、およびツリービューを含みます。
機能
アクセラレータ キーを使うと、ユーザはマウスを使わずにキーを
押して項目を選択する(つまり、フォーカスを変更する)ことが
できます。項目の名前またはラベル内で下線付きで示されている
文字のキーを、〔Alt〕と同時に押します。現在選択されているコ
ントロールが編集可能なコントロール(シングルライン エディッ
ト コントロール、マルチライン エディット コントロール、リスト
ボックス コントロール、ドロップダウン リストボックス コント
ロールなど)でない場合は、アクセラレータ キーだけを押します。
アクセラレータ キーはショートカット キーとは異なります。ショー
トカット キーは、特定の作業を簡単に行うために定義されたキー
の組み合わせです。
PowerBuilder の用語
アクセラレータ キー
ショートカット キー
Windows の用語
ニーモニック アクセス文字
ショートカット キーまたはアクセラレータ キー
オブジェクトとコントロール
Motif の用語
ニーモニック
アクセラレータ キー
395
AccessibleDescription
解説
ペインタの場合
❖
アクセラレータ キーとして使用する文字を選択する
•
コントロールのプロパティ ビューの[全般]ページで、
[アクセラ
レータ]ボックスに文字を入力します。
たとえば、アクセラレータとして〔M〕を設定するには、ボック
スに「m」と入力します。
ラベルなしのコントロール用のアクセラレータ ラベルなしのコント
ロールまたはボックスに使用するアクセラレータ キーをユーザに示
すには、ラベルの役割をするスタティック テキストを定義します。下
線を付けたい文字の前にアンパサンド(&)を入れます。たとえば、ア
クセラレータ キーとして m を持つドロップダウン リストの場合、スタ
ティック テキスト コントロールの[全般]ページで、[テキスト]プ
ロパティを「Edit & Maintenance Data」のような値に設定します。テ
キストとしてアンパサンドを表示するには、アンパサンドを 2 つ連続
して入力します。テキストとしてアンパサンドを表示したうえで、そ
のアンパサンドをアクセラレータ キーにするには、アンパサンドを 3
つ連続して入力します。
スクリプトの場合
Accelerator プロパティは整数で、アクセラレータ キーの ASCII コード
値です。次の 2 行はどちらも、〔M〕をマルチライン エディット コン
トロールのアクセラレータ キーとして定義します。
mle_1.Accelerator=67
mle_1.Accelerator = ASC("M")
AccessibleDescription
対象
ウィンドウ、および DragObject を継承するコントロール
機能
コントロールを視覚障害者用の画面読み上げなどのアクセシビリティ
ツールで使用する場合に、コントロールやその目的に関する説明を指
定します。
「OK」というラベルの付いたボタンのように、AccessibleName
と AccessibleRole プロパティでコントロールが十分に説明されている
場合は、説明を指定する必要はありません。ピクチャまたはレポート
コントロールに対しては、説明を指定する必要があります。
396
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
プロパティ ビューの[その他]ページで、
[アクセシブルの説明]テ
キストボックスに説明を入力します。
スクリプトの場合
AccessibleDescription プロパティの値は文字列です。次の例では、ウィ
ンドウのコマンドボタンに AccessibleDescription プロパティを設定し
ます。
cb_1.accessibledescription = "Deletes selected text"
AccessibleName
対象
ウィンドウ、および DragObject を継承するコントロール
機能
コントロールを視覚障害者用の画面読み上げなどのアクセシビリティ
ツールで使用する場合に、ボタンのテキストやメニュー項目名など、
コントロールを簡単に説明するラベルを指定します。
解説
ペインタの場合
プロパティ ビューの[その他]ページで、
[アクセシブル名]テキス
トボックスに名前を入力します。
スクリプトの場合
AccessibleName プロパティの値は文字列です。次の例では、ウィンド
ウのコマンドボタンに AccessibleName プロパティを設定します。
cb_1.accessiblename = "Delete"
AccessibleRole
対象
ウィンドウ、および DragObject を継承するコントロール
機能
コントロールを視覚障害者向けの画面読み上げなどのアクセシビリ
ティ ツールで使用する場合に、ユーザ インタフェース要素となるコン
トロールの種類(役割)に関する説明を指定します。この説明は、
AccessibleRole カタログ データ型変数のメンバーです。デフォルトの
役割 defaultrole! は、役割が特定できない場合に使用されます。次の表
に、PowerBuilder コントロール用の設定を示します。
オブジェクトとコントロール
397
AccessibleRole
表 3-1: PowerBuilder コントロール用のアクセシブル ロールの値
AccessibleRole
コントロール
animationrole!
アニメーション
checkbuttonrole!
チェックボックス
pushbuttonrole!
コマンドボタン
clientrole!
データウィンドウ
comboboxrole!
ドロップダウン リストボックス
comboboxrole!
ドロップダウン ピクチャ リストボックス
textrole!
エディットマスク
diagramrole!
グラフ
groupingrole!
グループボックス
progressbarrole!
水平プログレスバー、垂直プログレスバー
scrollbarrole!
水平スクロールバー、垂直スクロールバー
sliderrole!
水平トラックバー、垂直トラックバー
listrole!
リストボックス
listrole!
リストビュー
clientrole!
月表示カレンダ
textrole!
マルチライン エディット
graphicrole!
ピクチャ
pushbuttonrole!
ピクチャボタン
linkrole!
ピクチャ ハイパーリンク
listrole!
ピクチャ リストボックス
radiobuttonrole!
ラジオボタン
clientrole!
リッチテキスト エディット
textrole!
シングルライン エディット
linkrole!
スタティック ハイパーリンク
statictextrole!
スタティック テキスト
clientrole!
タブ
clientrole!
タブページ
outlinerole!
ツリービュー
解説
ペインタの場合
プロパティ ビューの[その他]ページで、[アクセシブル ロール]ド
ロップダウン リストから役割を選択します。
スクリプトの場合
AccessibleRole プロパティの値は、AccessibleRole カタログ データ型変
数の値です。次の例では、ウィンドウのコマンドボタンに AccessibleRole
プロパティを設定します。
cb_1.accessiblerole = pushbuttonrole!
398
PowerBuilder
第3章
プロパティの説明と使用法
Activation
対象
OLE コントロール
機能
ユーザがコントロールをアクティブにする方法を指定します。指定で
きる方法は次のとおりです。
•
Double Click ユーザがコントロールをダブルクリックすると、
サーバ アプリケーションがアクティブになります。
ユーザがコントロールをクリックするか、そのコント
ロ ー ル に タ ブ 移 動 す る と、サ ー バ が ア ク テ ィ ブ に な り ま す。
GetFocus イベントのスクリプトも記述する場合は、フォーカスに
変更を引き起こす、MessageBox などの関数を呼び出してはなりま
せん。
•
Get Focus
•
Manual
コントロールは、Activate 関数を使った場合にのみプログ
ラムによってアクティブにできます。
開発中は、オブジェクトをウィンドウ ペインタ内でアクティブにしま
す。
解説
ペインタの場合
❖
オブジェクトをアクティブにする方法を指定する
•
コントロールのプロパティ ビューの[全般]ページで、[起動方
法]ドロップダウン リストから設定を選択します。
コントロールは、
[起動方法]の設定にかかわらず、常にプログラ
ムによるアクティブ化が可能です。
スクリプトの場合
Activation プロパティの値は、omActivation カタログ データ型です。
この例では、オブジェクト ole_1 の Activation プロパティのタイプを
ActivateOnGetFocus! に変更します。
ole_1.Activation = ActivateOnGetFocus!
オブジェクトとコントロール
399
Alignment
Alignment
対象
テキストを表示するコントロール
機能
テキストを表示するコントロールのほとんどに対し、Alignment プロパ
ティでコントロール内のすべてのテキストの位置揃えを指定できま
す。テキストには、中央揃え、左揃え、右揃えを指定できます。
リッチテキスト エディット コントロールには、パラグラフごとに個別
の位置揃え設定があります。設定には、Center、Left、Right、および
Justify があります。
解説
ペインタの場合
❖
リッチテキスト エディット以外のコントロールのテキストの位置揃えを指定
する
•
コントロールのプロパティ ビューの[全般]ページで、
[配置]ド
ロップダウン リストから位置揃えを選択するか、スタイルバーの
[左寄せ]、
[中央揃え]、
[右寄せ]位置揃えボタンをクリックしま
す。スタイルバーは、選択した複数のオブジェクトに同時に位置
揃えを設定する場合に使用します。
❖
リッチテキスト エディット コントロール内のパラグラフのテキストの位置
揃えを指定する
1
パラグラフ内で位置揃えを指定するテキストを選択します。
2
選択したテキストを右クリックして、そのテキスト オブジェクト
のプロパティ シートを表示し、位置揃えの設定を選択します。
❖
実行時に位置揃えを設定する(リッチテキスト エディットのみ)
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、
[ツールバーの表示]と[ポップアップ メニュー]のどちらか
のチェックボックスをオンにします。
実行時に、ユーザは位置揃えを指定するテキストをマウスで選択
し、テキストを右クリックしてポップアップ メニューを起動する
か、スタイルバーの位置揃えボタンを 1 つ選択します。
スクリプトの場合
Alignment プロパティのデータ型は、Alignment カタログ データ型です。
こ れ に は、テ キ ス ト を 持 つ す べ て の コ ン ト ロ ー ル に 適 用 さ れ る
Center!、Left!、および Right! と、リッチテキスト エディット コント
ロールにのみ適用される Justify! の 4 つの値があります。
次の例ではマルチライン エディット コントロールに中央揃えを指定
します。
mle_1.Alignment = Center!
400
PowerBuilder
第3章
プロパティの説明と使用法
AllowEdit
対象
ドロップダウン リストボックス コントロールおよびドロップダウン
ピクチャ リストボックス コントロール
機能
AllowEdit が有効な場合、ユーザがドロップダウン リストのテキスト
ボックス内の選択内容を編集できます。
AllowEdit が無効な場合は、ユーザはリストからの選択のみができ、選
択内容を編集することはできません。
解説
ペインタの場合
❖
編集を許可する
•
コントロールのプロパティ ビューの[全般]ページで、
[編集可能]
チェックボックスをオンにします。
スクリプトの場合
AllowEdit プロパティの値はブール値です。
この例では、ドロップダウン リストボックスに AllowEdit を設定します。
ddlb_1.AllowEdit = TRUE
AnimationName
対象
アニメーション コントロール
機能
アニメーション コントロールに関連付けられたアニメーションを含
む AVI ファイルの名前を指定します。AVI ファイルは、圧縮されてい
ないファイルか、ランレングス圧縮(BI-RLE8)ファイルでなければ
なりません。音声を含む AVI ファイルは使用できません。このような
ファイルはコントロールに表示されません。
解説
ペインタの場合
❖
コントロールの AVI ファイルを指定する
• [動画ファイル名]フィールドの隣の[...]ボタンをクリックして
ファイルを選択します。
スクリプトの場合
AnimationName プロパティの値は文字列です次の例では、コントロー
ル am_1 の AnimationName プロパティを設定します。
am_1.AnimationName = "C:\work\avifiles\Search.AVI"
オブジェクトとコントロール
401
AutoArrange
AutoArrange
対象
リストビュー コントロール
機能
AutoArrange が有効な場合、アイコンが大きいアイコン ビューと小さ
いアイコン ビューに自動的に整列します。
解説
ペインタの場合
❖
アイコンの自動整列を有効にする
•
リストビュー コントロールのプロパティ ビューの[全般]ページ
で、
[アイコンの自動整列]チェックボックスをオンにします。
スクリプトの場合
AutoArrange プロパティの値はブール値です。次の例では、リスト
ビュー内のアイコンの自動整列を指定します。
lv_1.AutoArrange = TRUE
AutoHScroll
対象
ドロップダウン リストボックス コントロール、ドロップダウン ピク
チャ リストボックス コントロール、エディットマスク コントロール、
マルチライン エディット コントロール、シングルライン エディット
コントロール
機能
自動水平スクロールが有効な場合、コントロール内のテキストはユー
ザがデータを入力または削除すると、左または右に自動的にスクロー
ルします。自動水平スクロールが無効な場合は、ユーザがデータを変
更してもテキストは左右にスクロールせず、与えられた行幅を超える
データは無視されます。
解説
ペインタの場合
❖
自動水平スクロールを有効にする
•
オブジェクトのプロパティ ビューの[全般]ページで、
[自動水平
スクロール]チェックボックスをオンにします。
スクリプトの場合
AutoHScroll プロパティの値はブール値です。
この例では、ユーザがドロップダウン リストボックス コントロールの
編集ボックス内のデータを入力または修正したときの自動水平スク
ロールを有効にします。
ddlb_1.AutoHScroll = TRUE
402
PowerBuilder
第3章
プロパティの説明と使用法
このプロパティは、実行時にエディットマスク コントロールに設定で
きません。
Automatic
対象
チェックボックス コントロールおよびラジオボタン コントロール
機能
Automatic プロパティが有効な場合、ユーザがコントロールを選択した
ときに、コントロールの状態が自動的に変更されます。通常、状態は
選択と非選択の切り替えです。チェックボックスでは、ThreeState プロ
パティが有効になっている場合は、コントロールの状態が第 3 の状態
にも切り替わります。
このプロパティが有効な場合、コントロールが選択のときにはコント
ロールにマークが表示され、非選択のときにはマークは表示されませ
ん。チェックボックスについては、ThreeState プロパティが有効になっ
ている場合は、第 3 の状態は、グレー表示のマークで表示されます。
解説
ペインタの場合
❖
自動状態変更を有効にする
•
コントロールのプロパティ ビューの[全般]ページで、[自動]
チェックボックスをオンにします。
スクリプトの場合
Automatic プロパティの値はブール値です。この例では、チェックボッ
クスが選択されるたびに状態が変化するよう設定します。
cbx_1.Automatic = TRUE
AutoPlay
対象
アニメーション コントロール
機能
AutoPlay プロパティが有効な場合、アニメーション コントロールが開
かれるとすぐに AVI クリップが再生されます。
解説
ペインタの場合
❖
アニメーションを自動的に開始する
•
コントロールのプロパティ ビューの[全般]ページで、[自動実
行]チェックボックスをオンにします。
オブジェクトとコントロール
403
AutoScale
スクリプトの場合
AutoPlay プロパティの値はブール値です。次の行では、AutoPlay プロ
パティを TRUE に設定します。
am_1.AutoPlay = TRUE
AutoScale
対象
グラフ コントロールの grAxis オブジェクト
機能
AutoScale は、Category および Value の grAxis オブジェクトのプロパ
ティです。grAxis オブジェクトは、グラフ コントロールの一部で、
Category、Series、Values の 3 つがあります。
AutoScale は、グラフの軸をデータの最小値と最大値に合わせて自動的
にスケーリングするかどうかを指定します。
解説
ペインタの場合
❖
自動スケールを有効にする
1
グラフのプロパティ ビューの[軸]タブ ページを表示します。
2 [軸]ドロップダウン リストから軸を選択します。
3 [自動目盛]チェックボックスが有効になっている場合は、この
チェックボックスをオンにします。
[自動目盛]は、選択されているグラフのタイプと軸に適用可能な
場合にのみ有効になります。
スクリプトの場合
AutoScale プロパティの値はブール値です。
次の例では、グラフ gr_emp の値軸の自動スケーリングを無効にしま
す。
gr_emp.Values.AutoScale = FALSE
AutoSize
対象
月 表 示 カ レ ン ダ コ ン ト ロ ー ル、お よ び グ ラ フ コ ン ト ロ ー ル 内 の
grDispAttr オブジェクト
404
PowerBuilder
第3章
機能
プロパティの説明と使用法
月表示カレンダ コントロールでは、AutoSize プロパティを有効にする
と、1 か月全体が収まるようにカレンダのサイズが変更されます。
TextSize や TodaySectoin など、サイズに関するほかのプロパティを変
更した場合、カレンダのサイズは設計時と実行時の両方において自動
的に変更されます。
grDispAtt オブジェクトでは、AutoSize プロパティを有効にすると、表
示されるテキストの量に応じてテキスト オブジェクトのフォント サ
イズが自動的に変更されます。自動サイズ変更が有効でないときは、
テキスト サイズを設定する必要があります。
解説
ペインタの場合
❖
カレンダ コントロールの自動サイズ変更を有効にする
•
プロパティ ビューの[全般]ページで、[自動サイズ]チェック
ボックスをオンにします。
❖
グラフ コントロール内のテキスト オブジェクトの自動サイズ変更を有効に
する
1
コントロールのプロパティ ビューの[テキスト]タブ ページを表
示します。
2 [テキスト オブジェクト]リストからテキスト オブジェクトを選
択します。
3 [サイズの自動調節]チェックボックスをオンにします。
特定のテキスト オブジェクトの[サイズの自動調節]チェックボッ
クスのチェックをはずす場合は、
[サイズ]リストから値を選択し、
そのオブジェクトのテキスト サイズを設定します。
スクリプトの場合
AutoSize プロパティの値はブール値です。
月表示カレンダ コントロールの場合、AutoSize のデフォルト値は
TRUE です。この例では、月表示カレンダ コントロールの自動サイズ
変更を無効にします。
mc_1.AutoSize = false
grDispAttr オブジェクトの場合、各テキスト コンポーネントに対して
grDispAttr オブジェクトを使用して AutoSize プロパティを設定できま
す。
この例では、グラフ コントロールのタイトルの自動サイズ変更を無効
にしてから特定のテキスト サイズを設定します。
gr_1.TitleDispAttr.AutoSize = FALSE
gr_1.TitleDispAttr.TextSize = 10
オブジェクトとコントロール
405
AutoSkip
この例では、グラフ コントロールの項目軸のラベルの自動サイズ変更
を無効にしてから、特定のテキスト サイズを設定します。
gr_1.Category.LabelDispAttr.AutoSize = FALSE
gr_1.Category.LabelDispAttr.TextSize = 8
AutoSkip
対象
エディットマスク コントロール
機能
AutoSkip プロパティが有効な場合、マスクにより許容されたすべての
文字が入力されると、ユーザのカーソルが自動的にタブ順序で次のコ
ントロールに移動します。AutoSkip が有効でない場合は、カーソルは
次のコントロールに自動的には移動しません。
解説
ペインタの場合
❖
自動スキップを有効にする
•
エディットマスク コントロールのプロパティ ビューの[マスク]
タブ ページで、
[自動スキップ]チェックボックスをオンにします。
スクリプトの場合
AutoSkip プロパティの値はブール値です。この例では、次のコントロー
ルへの自動スキップを有効にします。
em_1.AutoSkip = TRUE
AutoVScroll
対象
エディットマスク コントロール、マルチライン エディット コントロー
ル
機能
自動垂直スクロールが有効な場合、コントロール内のテキストはユー
ザがデータを入力または修正したときに、自動的に上下にスクロール
します。自動垂直スクロールが有効でない場合は、ユーザがデータを
変更してもテキストは自動的に上下にスクロールせず、与えられたス
ペースの高さを超えるデータは無視されます。
406
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
自動垂直スクロールを有効にする
•
オブジェクトのプロパティ ビューの[全般]ページで、
[自動垂直
スクロール]チェックボックスをオンにします。
スクリプトの場合
AutoVScroll プロパティの値はブール値です。次の例では、自動垂直ス
クロールを有効にします。
mle_1.AutoVscroll = TRUE
このプロパティは、実行時にエディットマスク コントロールに設定で
きません。
BackColor
対象
ウィンドウおよびほとんどのコントロール
機能
BackColor プロパティは、オブジェクトの背景に使用する色を定義しま
す。ペインタで背景色を定義するときは、選択内容によっては、現在
のウィンドウ配色またはカスタム カラーから値が採用されます。色の
ドロップダウン リストに独自の色を追加するには、プロパティ ビュー
を表示する前に[デザイン|色の指定]を選択します。
解説
ペインタの場合
❖
•
❖
•
ウィンドウ、月表示カレンダ、またはグラフの背景色を設定する
ウィンドウまたはグラフのプロパティ ビューの[全般]ページで、
[背景色]ドロップダウン リストから色を選択します。
そのほかのコントロールの背景色を設定する
コントロールのプロパティ ビューの[フォント]タブ ページで、
[背景色]ドロップダウン リストから色を選択します。
❖
グラフのテキスト オブジェクトの背景色を設定する
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジで、[テキスト オブジェクト]リストボックスからテキスト オ
ブジェクトを選択します。
2 [背景色]ドロップダウン リストから色を選択します。
オブジェクトとコントロール
407
BeginX
スクリプトの場合
BackColor プロパティの値は long 型(-2 から 16,777,215)で、ウィン
ド ウ お よ び ほ か の オ ブ ジ ェ ク ト の 背 景 色 の 数 値 を 指 定 し ま す。
BackColor 値は、色の赤、緑、青(RGB)の 3 要素の値の組み合わせです。
目的の色の long 型の値がわからない場合には、
[デザイン|色の指定]
を選択して RGB 値を判別してから、スクリプトで RGB 関数を呼び出
して色を指定します。
次の例では、グラフ コントロールに背景色として黄色を設定します。
gr_1.BackColor = RGB(255, 255, 0)
グラフ内のテキスト表示では、BackColor はテキスト要素(軸上のラベ
ルなど)のプロパティです。
次の例では、グラフ コントロールの項目軸上のテキスト ラベルの背景
色として青を設定します。
gr_1.Category.LabelDispAttr.BackColor = RGB(0, 128,
255)
BeginX
対象
直線コントロール
機能
BeginX プロパティは、直線の開始の X 位置を PowerBuilder 単位系で指
定します。
X 座標は、ウィンドウまたはカスタム ユーザ オブジェクトの左端から
の距離です。オブジェクトがメイン ウィンドウまたはカスタム ユーザ
オブジェクトの場合、この距離は画面を基準とします。オブジェクト
がメイン ウィンドウでない場合、距離は親ウィンドウを基準としま
す。ただし、MDI フレーム ウィンドウ内に開かれている場合は、距離
は MDI フレームを基準とします。
解説
408
ペインタの場合
❖
直線の開始位置の X 座標を指定する
•
直線を挿入します。直線の開始位置を変更する場合は、直線のプ
ロパティ ビューの[位置]タブ ページで、
[開始 X]フィールド
の値を変更します。
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
BeginX プロパティの値は整数値です。次の例では、ウィンドウまたは
ユーザ オブジェクトの左端から 1000 PowerBuiler 単位系、上端から 500
PowerBuiler 単位系の位置に直線の開始位置を設定します。
ln_1.BeginX = 1000
ln_1.BeginY = 500
BeginY
対象
直線コントロール
機能
BeginY プロパティは、直線の開始の Y 位置を PowerBuilder 単位系で指
定します。
Y 座標は、ウィンドウまたはカスタム ユーザ オブジェクトの上端から
の距離です。オブジェクトがメイン ウィンドウまたはカスタム ユーザ
オブジェクトの場合、この距離は画面を基準とします。オブジェクト
がメイン ウィンドウでない場合、距離は親ウィンドウを基準としま
す。ただし、MDI フレーム ウィンドウ内に開かれている場合は、距離
は MDI フレームを基準とします。
解説
ペインタの場合
❖
直線の開始位置の Y 座標を指定する
•
直線を挿入します。開始位置を変更する場合は、直線のプロパティ
ビューの[位置]タブ ページで、
[開始 Y]フィールドの値を変更
します。
スクリプトの場合
BeginY プロパティの値は整数値です。次の例では、ウィンドウまたは
ユーザ オブジェクトの上端から 500 PowerBuiler 単位系、左端から 1000
PowerBuiler 単位系の位置に直線の開始位置を設定します。
ln_1.BeginY = 500
ln_1.BeginX = 1000
BoldSelectedText
対象
タブ コントロール
オブジェクトとコントロール
409
BoldSelectedText
機能
BoldSelectedText プロパティが有効な場合、ユーザがタブ ページを選択
すると、タブ ページのラベルが太字になります。このプロパティが有
効でない場合は、選択されたタブ ページのタブ テキストはほかのタブ
ページのタブ テキストと同じ外観になります。
解説
ペインタの場合
❖
BoldSelectedText プロパティを有効にする
•
タブ コントロールのプロパティ ビューの[全般]ページで、[選
択したテキストを太字]チェックボックスをオンにします。
スクリプトの場合
BoldSelectedText プロパティの値はブール値です。次の例では、tab_1 コ
ントロールのタブ ページのラベルが、選択されたときに太字になるよ
うに設定します。
tab_1.BoldSelectedText = TRUE
410
PowerBuilder
第3章
プロパティの説明と使用法
Border
対象
ウィンドウおよびそのほかのコントロール
機能
Border プロパティが有効な場合、ウィンドウまたはコントロールは枠
線を持ちます。
Border プロパティが有効かどうかにかかわらず、常に枠線を持つコン
トロールおよびウィンドウ型もあります。
解説
ペインタの場合
❖
枠線を指定する
•
ウィンドウまたはコントロールのプロパティ ビューの[全般]ペー
ジで、
[枠]チェックボックスをオンにします。
スクリプトの場合
Border プロパティの値はブール値です。次の例では、スタティック テ
キスト コントロールが枠線を表示し、枠線のスタイルを 3D 凹に設定
するように指定します。
st_1.Border = TRUE
st_1.BorderStyle = StyleLowered!
BorderColor
対象
スタティック テキスト コントロールおよびスタティック ハイパーリ
ンク コントロール
機能
BorderColor は、スタティック テキスト コントロールまたはスタティッ
ク ハイパーリンクの周囲の枠線に使用する色を指定します。色は、枠
線のスタイルが長方形の場合にのみ可視です。
[枠の色]リストに独自の色を追加するには、[デザイン|色の指定]
を選択してから、プロパティ ビューを表示します。
解説
ペインタの場合
❖
枠の色を指定する
1
コントロールのプロパティ ビューの[全般]ページで、
[枠]チェッ
クボックスをオンにします。
2 [枠のスタイル]リストから「StyleBox!」を選択します。
3 [全般]ページの[枠の色]リストから色を選択します。
オブジェクトとコントロール
411
BorderStyle
スクリプトの場合
BorderColor プロパティの値は long 型です。目的の色の long 型の値が
わからない場合には、[デザイン|色の指定]を選択して RGB 値を判
別してから、スクリプトで RGB 関数を呼び出して色を指定します。
この例では、スタティック テキスト コントロール st_1 の枠を表示し、
長方形の枠線スタイルを指定してから、枠線の色として赤を指定しま
す。
st_1.Border = TRUE
st_1.BorderStyle = StyleBox!
st_1.BorderColor = RGB(255,0,0)
BorderStyle
対象
ほとんどのコントロール
機能
BorderStyle プロパティを使って、コントロールの枠線の外観を定義し
ます。スタイルには、3D 凹、3D 凸、長方形、および影付きがあります。
解説
ペインタの場合
❖
枠線スタイルを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[枠のスタ
イル]リストからスタイルを選択します。
枠線を無効にするには、
[全般]ページの[枠]チェックボックス
をオフにします。
スクリプトの場合
枠線の外観を変更するには、
[枠]を TRUE に設定し、
[枠のスタイル]
プロパティを BorderStyle カタログ データ型の値に設定します。
次の例では、ドロップダウン リストボックスの枠線を設定します。
ddlb_1.Border = TRUE
ddlb_1.BorderStyle = StyleLowered!
412
PowerBuilder
第3章
プロパティの説明と使用法
BottomMargin
対象
リッチテキスト エディット コントロール
機能
BottomMargin プロパティは、印刷ページの下側余白のサイズをインチ
単位で指定します。
解説
ペインタの場合
❖
•
下側余白を設定する
リッチテキスト エディット コントロールのプロパティ ビューの
[ドキュメント]タブ ページで、[下余白]フィールドにインチ単
位でサイズを入力します。
スクリプトの場合
BottomMargin プロパティの値は long 型です。次の例では、リッチテキ
スト エディット コントロールの印刷ページの下側余白を 1 インチに
設定します。
rte_1.BottomMargin = 1
BringToTop
対象
ウィンドウおよびコントロール
機能
ウィンドウでは、このプロパティはウィンドウを最前面に移動するか
どうかを指定します。ウィンドウに対しては、このプロパティはスク
リプトでのみ設定できます。
コントロールでは、このプロパティはコントロールをウィンドウ内で
最前面に移動するかどうかを指定します。
解説
ペインタの場合
❖
コントロールに BringToTop プロパティを設定する
1
コントロールを選択します。
2
コントロールを右クリックし、ポップアップ メニューから[前面
に移動]または[背面に移動]を選択するか、メニューバーから
[書式|前面に移動]または[書式|背面に移動]を選択します。
スクリプトの場合
BringToTop の値はブール値です。
オブジェクトとコントロール
413
ButtonHeader
次の文は、アプリケーション中で指定したウィンドウをほかのウィン
ドウより前に移動します。
w_1.BringToTop = TRUE
ButtonHeader
対象
リストビュー コントロール
機能
ButtonHeader プロパティが有効な場合、リストビューの詳細ビューの
カラム タイトルがラベルではなくボタンとして表示されます。
解説
ペインタの場合
❖
ButtonHeader プロパティを設定する
•
リストビュー コントロールのプロパティ ビューの[全般]ページ
で、
[ボタン ヘッダ]チェックボックスをオンにします。
スクリプトの場合
ButtonHeader プロパティは、リストビュー コントロール内の詳細
ビューにのみ関係します。詳細ビューを有効にするには、カラムを設
定するスクリプトを AddColumn 関数と SetColumn 関数を使って記述
し、SetItem 関数を使ってカラムに値を与える必要があります。
詳細ビューの使い方についての詳細は、
『アプリケーション テクニッ
ク』マニュアルの「ウィンドウでのリストの使い方」を参照してくだ
さい。
ButtonHeader プロパティの値はブール値です。次の例では、リスト
ビュー コントロール内の詳細ビューにボタン ヘッダを指定します。
lv_1.ButtonHeader = TRUE
414
PowerBuilder
第3章
プロパティの説明と使用法
Cancel
対象
コマンドボタン コントロール、ピクチャボタン コントロール、OLE カ
スタム コントロール
機能
Cancel は、〔Esc〕がボタンまたはコントロールをアクティブ化するか
どうかを定義します。Cancel プロパティが有効な場合、〔Esc〕はコン
トロールの Clicked イベントを発生させます。Cancel が有効でない場合
は、コントロールは〔Esc〕に応答しません。
複数のコントロールに対して Cancel を有効にすると、最後に設定され
たものが〔Esc〕に応答します。
解説
ペインタの場合
❖
Cancel プロパティを有効にする
•
コントロールのプロパティ ビューの[全般]ページで、
[キャンセ
ル]チェックボックスをオンにします。
スクリプトの場合
Cancel プロパティの値はブール値です。次の例では、コマンドボタン
が〔Esc〕に応答するように設定します。
cb_1.Cancel = TRUE
Category
対象
グラフ コントロール
機能
グラフ コントロールの Category プロパティは、グラフの項目軸のプロ
パティを指定します。項目軸は、グラフ コントロール内のオブジェク
ト(grAxis 型)です。
解説
ペインタの場合
❖
グラフ コントロールの項目軸のプロパティを設定する
1
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示します。
2 [軸]ドロップダウン リストから「項目」を選択します。
3 [軸]タブ ページに値を設定します。
オブジェクトとコントロール
415
CategorySort
スクリプトの場合
Category プロパティのデータ型は grAxis で、これは、軸の外観の制御
のために独自のプロパティを持つオブジェクトの型です。項目軸の値
を指定するには、次の構文を使用します。
GraphControlName.Category.grAxisProperty = value
次の例では、グラフ コントロールの項目軸のラベルを設定します。
gr_1.Category.Label = “Types of Products”
CategorySort
対象
グラフ コントロール
機能
CategorySort プロパティは、カテゴリのソート方法(昇順、降順、ソー
トなし)を指定します。
解説
ペインタの場合
❖
カテゴリのソート方法を指定する
•
グラフ コントロールのプロパティ ビューの[全般]ページで、
[項
目軸のソート]ドロップダウン リストからソートの種類を選択し
ます。
スクリプトの場合
CategorySort プロパティのデータ型は grSortType カタログ データ型で、
Ascending!、Descending!、Unsorted!、UserDefinedSort! の 4 つの値があ
ります。
次の例では、項目がソートされないように設定します。
gr_1.CategorySort = Unsorted!
416
PowerBuilder
第3章
プロパティの説明と使用法
Center
対象
ウィンドウ
機能
ウィンドウの作成またはサイズ変更を行ったときに、そのウィンドウ
を画面の中央に配置します。
解説
ペインタの場合
❖
ウィンドウの Center プロパティを設定する
•
ウィンドウのプロパティ ビューの[全般]ページで、
[中央]チェッ
クボックスをオンにします。
スクリプトの場合
Center プロパティの値はブール値です。次の例では、ウィンドウ w_mine
の Center プロパティを設定します。
w_mine.Center = TRUE
Checked
対象
チェックボックス コントロールとラジオボタン コントロール、および
メニュー オブジェクト
機能
Checked プロパティの値が TRUE のとき、その項目またはコントロール
は選択されています。
コントロール
チェックボックス
メニュー項目
ラジオボタン
選択時の表示
チェックボックスにチェックマークが表示される
項目の隣にチェックマークが表示される
ボタンの中央が暗色になる
Checked が FALSE のときは、項目またはコントロールは選択されてい
ません。
解説
ペインタの場合
❖
コントロールに Checked プロパティを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[チェック
済み]チェックボックスをオンにします。
❖
メニュー項目に Checked プロパティを設定する
1
メニュー ペインタでメニュー項目を選択します。
オブジェクトとコントロール
417
CollectionMode
2 [全般]ページで[チェック済み]チェックボックスをオンにします。
スクリプトの場合
Checked プロパティの値はブール値です。次の例では、ラジオボタン
の Checked プロパティを設定し、ボタンを選択された状態にします。
rb_1.Checked = TRUE
ドロップダウン メニューまたはカスケード メニューのメニュー項目
については、Check 関数と Uncheck 関数も使用できます。同等な構文の
例については、これらの関数の解説を参照してください。
CollectionMode
対象
インクピクチャ コントロール
機能
インクのみ、ジェスチャのみ、あるいはインクとジェスチャを収集す
るかどうかを指定します。
解説
ペインタの場合
❖
インク収集のモードを指定する
•
プロパティ ビューの[インク]ページで、[コレクションモード]
ドロップダウン リストから値を選択します。
スクリプトの場合
CollectionMode プロパティの値は、InkCollectionMode カタログデータ
型変数の値です。指定できる値は以下のとおりです。
•
InkOnly! – ストロークを作成するときに、インクだけを収集しま
す。Gesture イベントを発生しません。
•
InkAndGesture! – インクと単一のストローク ジェスチャを収集し
ます(デフォルト)。
•
GestureOnly! – ジェスチャだけを収集します。ジェスチャは単一の
ストロークあるいは複数のストロークになります。ダブル タップ
ジェスチャを認識するようにするには、CollectionMode を
GestureOnly! に設定する必要があります。
次の例では、インクピクチャ コントロールはジェスチャを認識する
が、インクを収集しないように指定します。
ie_1.InkCollectionMode = GestureOnly!
418
PowerBuilder
第3章
プロパティの説明と使用法
ColumnsPerPage
対象
ウィンドウとユーザ オブジェクト
機能
ColumnsPerPage プロパティは、スクロールに使用する目的で 1 ページ
のカラム数を定義します。デフォルトは 0 です(1 ページに 10 カラ
ム)。PowerBuilder は、ユーザがスクロールバーをクリックして横方向
にウィンドウをスクロールするときの PowerBuilder 単位系の数値を
UnitsPerColumn × ColumnsPerPage という式で求めます。
ColumnsPerPage と UnitsPerColumn の計算については、581 ページの
「ウィンドウおよびユーザ オブジェクト内でのスクロール」を参照し
てください。
使用上の注意
ウィンドウまたはユーザ オブジェクトの垂直スクロールバーを制御
するには、UnitsPerLine プロパティと LinesPerPage プロパティを使用し
ます。
解説
ペインタの場合
❖
•
ColumnsPerPage プロパティを設定する
ウィンドウのプロパティ ビューの[スクロール]タブ ページで、
[1 ページのカラム数]オプションに数値(1 ~ 100)を入力します。
スクリプトの場合
ColumnsPerPage プロパティの値は、1 から 100 の間の整数値です。次
の行では、ウィンドウの ColumnsPerPage を 20 に設定します。
This.ColumnsPerPage = 20
ContentsAllowed
対象
OLE コントロール
機能
埋め込みとリンクのどちらを使用してコントロール内に OLE オブ
ジェクトを挿入するか、または、実行時にどちらのタイプの OLE オブ
ジェクトを挿入できるかを指定します。
オブジェクトとコントロール
419
ControlMenu
解説
ペインタの場合
❖
ContentsAllowed プロパティを設定する
•
コントロールのプロパティ ビューの[全般]タブ ページで、[内
容の更新可能]ドロップダウン リストからタイプを選択します。
選択できるタイプは、Any(両方)
、Embedded(埋め込み)、Linked
(リンク)です。
スクリプトの場合
ContentsAllowed プロパティのデータ型は、omContentsAllowed です。次
の例では、ContentsAllowed プロパティの値をリンク型に設定します。
ole_1.ContentsAllowed = ContainsLinkedOnly!
ControlMenu
対象
ウィンドウおよびデータウィンドウ コントロール
機能
ControlMenu プロパティは、ウィンドウまたはデータウィンドウ コン
トロールのタイトル バーに[コントロール メニュー]ボックスを表示
するかどうかを指定します。
解説
ペインタの場合
❖ [コントロール メニュー]ボックスを表示する
•
ウィンドウまたはデータウィンドウ コントロールのプロパティ
ビューの[全般]ページで、[コントロール メニュー]チェック
ボックスをオンにします。
スクリプトの場合
ControlMenu プロパティの値はブール値です。次の例では、データウィ
ンドウ コントロール dw_1 のタイトル バーに[コントロール メニュー]
ボックスを表示するように指定します。
dw_1.ControlMenu = TRUE
420
PowerBuilder
第3章
プロパティの説明と使用法
CornerHeight
対象
丸長方形コントロール
機能
CornerHeight プロパティは、丸長方形コントロールの角丸部分の縦方
向の半径を PowerBuilder 単位系で設定します。
解説
ペインタの場合
❖
CornerHeight プロパティを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[丸角部分
の高さ]フィールドに整数を入力します。
スクリプトの場合
CornerHeight プロパティのデータ型は整数値です。この例では、丸長
方形 rr_1 の角の高さを設定します。
rr_1.CornerHeight = 10
CornerWidth
対象
丸長方形コントロール
機能
CornerWidth プロパティは、丸長方形コントロールの丸角部分の横方向
の半径を PowerBuilder 単位系で設定します。
解説
ペインタの場合
❖
CornerWidth プロパティを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[丸角部分
の幅]フィールドに整数を入力します。
スクリプトの場合
CornerWidth プロパティのデータ型は、整数値です。この例では、丸長
方形 rr_1 の角の幅を設定します。
rr_1.CornerWidth = 10
オブジェクトとコントロール
421
CreateOnDemand
CreateOnDemand
対象
タブ コントロール
機能
CreateOnDemand が有効な場合には、タブ コントロール作成時にタブ
コントロールのすべてのタブ ページがインスタンス化されますが、ま
だ表示されていないタブ ページにあるコントロールの Constructor イ
ベントは、ユーザがタブ ページをクリックするか SelectTab 関数の呼び
出しによってタブ ページを表示するまでは、起動されません(SelectTab
関 数 は SelectedTab プ ロ パ テ ィ を 設 定 し ま す)。コ ン ト ロ ー ル の
Constructor イベントが実行されるまで、コントロールのグラフィック
表現は作成されないので、そのハンドルは使用できません。選択され
たタブ ページにあるコントロールの Constructor イベントはタブ コン
トロールが作成されるときには必ず起動されます。
コントロールの多いタブ ページについては、タブ ページのグラフィッ
ク表現の作成を後にした方がウィンドウをはやく開けます。ただしス
クリプトでは、コントロールの Constructor イベントが起動して、グラ
フィック表現が作成されるまではそのコントロールを参照できませ
ん。
解説
ペインタの場合
❖
CreateOnDemand プロパティを設定する
•
タブ コントロールのプロパティ ビューの[全般]ページで、[現
行タブ上のコントロールのみ生成]チェックボックスをオンにし
ます。
スクリプトの場合
CreateOnDemand プロパティの値はブール値です。次の例では、タブ
ページが選択されるまでそのタブ ページのグラフィック表現が作成
されないように指定します。
tab_1.CreateOnDemand = TRUE
スクリプトでのプロパティの使い方についての詳細は、
『アプリケー
ション テクニック』マニュアルのウィンドウにおけるタブ コントロー
ルの使い方に関する章を参照してください。
422
PowerBuilder
第3章
プロパティの説明と使用法
DataObject
対象
データウィンドウ コントロールおよびデータストア オブジェクト
機能
DataObject プロパティは、データウィンドウ コントロールに関連付け
られているデータウィンドウ オブジェクトまたはレポート オブジェ
クトの名前を指定します。
解説
ペインタの場合
❖
データウィンドウ コントロールに含まれるデータウィンドウ オブジェクト
の名前を指定する
•
データウィンドウ コントロールのプロパティ ビューの[全般]プ
ロパティ ページで、[データ オブジェクト]フィールドに既存の
データウィンドウ オブジェクトの名前を入力するか、
[...]ボタン
を使ってオブジェクトを選択します。
スクリプトの場合
DataObject プロパティのデータ型は文字列です。この例では、データ
ウィンドウ コントロール dw_1 のデータウィンドウ オブジェクトとし
て d_employ を指定します。
dw_1.DataObject = "d_employ"
データウィンドウ コントロールまたはデータストアの再初期化
DataObject を空の文字列に設定すると、データウィンドウ コントロー
ルまたはデータストアの再初期化が実行されて、それまで DataObject
に関連付けられていたストレージがすべて削除されます。
DataType
対象
グラフ コントロールの grAxis オブジェクト
機能
DataType は、グラフ コントロールの一部になることが可能な grAxis オ
ブジェクトのプロパティです。grAxis オブジェクトは、グラフ コント
ロールの一部で、Category、Series、Values の 3 つがあります。
DataType は、軸に割り当てられるデータの型を指定します。指定でき
るデータ型は、Number、Date、DateTime、Default、Double、Text、およ
び Time です。
オブジェクトとコントロール
423
Default
解説
ペインタの場合
❖
データ型を指定する
1
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示します。
2 [軸]ドロップダウン リストから軸タイプを選択します。
3 [データ型]ドロップダウン リストからデータ型を選択します。
スクリプトの場合
DataType プロパティの値は、grAxisDataType 型です。
次の行を実行すると、グラフの値軸の DataType が設定されます。
gr_1.Values.DataType = AdtDate!
Default
対象
コマンドボタン コントロール、ピクチャボタン コントロール、OLE カ
スタム コントロール
機能
Default プロパティは、コントロールをデフォルト ボタンに指定しま
す。Default が TRUE の場合は、選択されたコントロールの枠線は太く
なり、ユーザが〔Enter〕を押したときに Clicked イベントを受け取り
ます(ユーザが別のコントロールにタブ移動していない限り)。Default
が FALSE の場合は、コントロールはデフォルト ボタンにはならず、
ユーザがそのコントロールにタブ移動しない限り〔Enter〕を押しても
影響はありません。
フォーカスを設定する
ウィンドウに編集可能なフィールド(マルチライン エディットなど)
がある場合、フォーカスがその編集可能フィールド上にあるときには、
デフォルト ボタンは予期するとおりに動作します(ユーザが〔Enter〕
を押したときに Clicked イベントを受け取る)。ユーザが〔Tab〕を押し
てほかのボタン(デフォルト ボタン以外のボタン)にフォーカスを移
動した場合は、〔Enter〕を押すと、その時にフォーカスのあるボタン
の Clicked イベントが起動します。
ウィンドウに編集可能フィールドがない場合は、デフォルト ボタンが
確実に上記の動作をするには SetFocus またはタブ順序を使用します。
424
PowerBuilder
第3章
プロパティの説明と使用法
コマンドボタン、ピクチャボタン、または OLE カスタム コントロー
ルでデフォルト ボタンをコントロールして、デフォルト ボタンが
〔Enter〕に応答するようにできます。複数のコントロールに対して
Default を設定すると、最後に設定されたものがデフォルトとして働き
ます。
解説
ペインタの場合
❖
Default プロパティを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[デフォル
ト]チェックボックスをオンにします。
スクリプトの場合
Default プロパティの値はブール値です。次の例では、ピクチャボタン
をデフォルト ボタンとして設定します。
pb_1.Default = TRUE
DeleteItems
対象
リストビュー コントロール、ツリービュー コントロール
機能
DeleteItems プロパティが TRUE の場合、ユーザは〔Delete〕を使ってリ
ストビューまたはツリービューから項目を削除できます。DeleteItems
が FALSE の場合は、ユーザは項目を削除できません。
解説
ペインタの場合
❖
ユーザがコントロールから項目を削除できるようにする
•
コントロールのプロパティ ビューの[全般]ページで、
[項目の削
除]チェックボックスをオンにします。
スクリプトの場合
DeleteItems プロパティの値はブール値です。次の例では、ユーザによ
るリストビュー項目の削除を不可能にします。
lv_1.DeleteItems = FALSE
オブジェクトとコントロール
425
Depth
Depth
対象
グラフ コントロール
機能
3D グラフで、グラフの幅に対する割合で奥行きを指定します。デフォ
ルトは 100% です。
解説
ペインタの場合
❖
Depth プロパティを設定する
1
グラフ コントロールのプロパティ ビューの[全般]ページを表示
します。
2 [グラフの種類]ドロップダウン リストから 3D のグラフ タイプを
選択します。
3 [グラフの奥行き]に幅の割合を設定します。
スクリプトの場合
Depth プロパティのデータ型は整数値です。この例では、グラフの奥
行きを幅の 50% に指定します。
gr_1.Depth = 50
DisabledName
対象
ピクチャボタン コントロール
機能
DisabledName プロパティは、ピクチャボタンが無効な場合にピクチャ
ファイルの名前が表示されるように指定します。次の形式のピクチャ
を指定できます。
426
•
ビットマップ(.BMP)
•
ランレングス圧縮(.RLE)
•
Windows メタファイル(.WMF)
•
GIF(GIF)
•
JPEG(.JPG または .JPEG)
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
ボタンが無効なときにピクチャが表示されるよう指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[使用不可
時のピクチャ名]フィールドにファイル名を入力するか、
[使用不
可時のピクチャ名]フィールドの隣の[...]ボタンを使ってファイ
ルを選択します。
スクリプトの場合
DisabledName プロパティの値は、ファイル名の文字列です。文字列に
はパスを含めることができます。この例では、ピクチャボタンの無効
時の表示に、ピクチャ controls.bmp を指定します。
pb_1.DisabledName = “d:\pbhelp\controls.bmp”
DisableDragDrop
対象
ツリービュー コントロール
機能
ユーザがコントロール内の項目をクリックしてドラッグしたときにド
ラッグのイベント(BeginDrag など)が発生するかどうかは、
DisableDragDrop プロパティで決まります。DisableDragDrop は、コン
トロール内の項目のドラッグにのみ影響します。
DisableDragDrop が TRUE の場合は、ユーザが項目をドラッグしようと
したときにドラッグ イベントは発生しません。ドラッグ アンド ドロッ
プを実装するには、対応するドラッグ イベントのスクリプトを記述し
ます。
DisableDragDrop は、選択の発生時にも影響します。このプロパティが
TRUE の場合は、ユーザがクリックした項目は、マウスボタンを押した
ときに選択されます。このプロパティが FALSE の場合は、マウスボタ
ンを放したときに項目が選択されます。
解説
ペインタの場合
❖
ツリービュー コントロール内のドラッグ アンド ドロップを無効にする
•
コントロールのプロパティ ビューの[全般]ページで、
[ドラッグ
アンド ドロップの禁止]チェックボックスをオンにします。
オブジェクトとコントロール
427
DisableNoScroll
スクリプトの場合
DisableDragDrop プロパティの値はブール値です。次に、ツリービュー
コントロール内でドラッグ イベントが発生しないようにする例を示
します。
tv_1.DisableDragDrop = TRUE
DisableNoScroll
対象
リストボックス コントロール、ピクチャ リストボックス コントロール
機能
DisableNoScroll プロパティはリストボックス内のスクロールバーの動
作を指定します。このプロパティが有効な場合はスクロールバーは常
時表示されていますが、スクロールバーなしですべての項目にアクセ
スできるときには無効になります。このプロパティが無効な場合は、
スクロールバーは項目数とリストボックスまたは ピクチャ リスト
ボックスの高さに応じて、必要時にのみ表示されます。
解説
ペインタの場合
❖
スクロールバーが常時表示されるが、不要時には無効になるように設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[スクロー
ルしないを無効化]チェックボックスをオンにします。
スクリプトの場合
DisableNoScroll プロパティの値はブール値です。この例では、リスト
ボックスのスクロールバーは必要時にのみ表示されるようにします。
lb_1.DisableNoScroll = FALSE
428
PowerBuilder
第3章
プロパティの説明と使用法
DisplayEveryNLabels
対象
グラフ コントロールの grAxis オブジェクト
機能
DisplayEveryNLabels は、グラフ コントロールの一部になることのでき
る grAxis オブジェクトのプロパティです。grAxis オブジェクトは、グ
ラフ コントロールの一部で、Category、Series、Values の 3 つがあります。
このプロパティは、グラフ内の選択した軸の目盛りにラベルを付ける
間隔を指定します。たとえば、2 を設定すると 1 目盛りおきにラベル
が付きます。0 を指定すると、そのグラフに最適なラベル数が選択さ
れます。
解説
ペインタの場合
❖
軸上のラベル間隔の目盛り数を指定する
1
グラフのプロパティ ビューの[軸]タブ ページを表示します。
2 [軸]ドロップダウン リストから軸を選択します。
3
スピン コントロールを使って、
[N 個毎にラベル表示]フィールド
に 0 から 100 の数を選択します。
スクリプトの場合
DisplayEveryNLabels プロパティのデータ型は整数です。次の例では、
系列軸の 10 目盛りごとにラベルを付けるように設定します。
gr_1.Series.DisplayEveryNLabels = 10
DisplayExpression
対象
グラフ コントロール内の grDispAttr オブジェクト
機能
DisplayExpression プロパティは、グラフ コントロール内のテキスト オ
ブジェクトのラベルの表示式を指定します。
デフォルトの表示式は、グラフ コンポーネントのテキストを含むプロ
パティの値です。
解説
ペインタの場合
❖
テキスト オブジェクトの表示式を指定する
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示します。
オブジェクトとコントロール
429
DisplayName
2 [テキスト オブジェクト]リストボックスから、表示式を定義する
テキスト オブジェクトを選択します。
式の表示プロパティのデフォルト値が[式の表示]フィールドに
表示されます。
3 [式の表示]フィールドに表示式を指定するか、[...]ボタンをク
リックして式の変更 ダイアログボックスを表示します。
スクリプトの場合
DisplayExpression プロパティは、
各テキスト コンポーネントの gtDispAttr
オブジェクトを通じて設定します。DisplayExpression は文字列で、表
示式を含むことができます。
次の例では、グラフのタイトルに続けて当日の日付を付けます。
gr_1.TitleDispAttr.DisplayExpression = 'title + " " +
Today()'
DisplayName
対象
アプリケーション オブジェクト、OLE コントロール
機能
DisplayName は、ユーザに読み取り可能なアプリケーション名または
OLE コントロール名です。この名前は、オブジェクト名を表示する
OLE ダイアログボックスとウィンドウに表示されます。DisplayName
に値を指定しないと、コントロールの名前(ole_1 など)またはアプリ
ケーションの名前(AppName プロパティの値)が使用されます。
解説
ペインタの場合
❖
OLE コントロールの表示名を設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[表示の名
前]フィールドに名前を入力します。
❖
アプリケーションの表示名を設定する
1
アプリケーション ペインタでアプリケーションを開きます。
2
アプリケーションのプロパティ ビューの[全般]ページで、
[表示
名]フィールドに名前を入力します。
スクリプトの場合
DisplayName プロパティは文字列です。次の例では、OLE コントロー
ルの名前を設定します。
ole_1.DisplayName = 'My Project'
430
PowerBuilder
第3章
プロパティの説明と使用法
DisplayOnly
対象
マルチライン エディット、シングルライン エディット、リッチテキス
ト エディット、エディットマスク コントロール
機能
DisplayOnly プロパティが有効な場合は、ユーザは編集可能なコント
ロールのテキストを変更できません。このプロパティが有効でないと
きは、ユーザはテキストを変更できます。
解説
ペインタの場合
❖
テキストを読み取り専用に指定する
•
コントロールのプロパティ ビューの[全般]ページで、[編集禁
止]チェックボックスをオンにします。
スクリプトの場合
DisplayOnly プロパティの値はブール値です。次の例では、マルチライ
ン エディット コントロール内のテキストを変更できないように設定
します。
mle_1.DisplayOnly = TRUE
DisplayType
対象
OLE コントロール
機能
DisplayType プロパティは、コントロール内で OLE オブジェクトをど
のように表示するかを指定します。コントロールには、実際の内容、
オブジェクトを表すアイコン、あるいは ActiveX ドキュメントとして
表示できます。ActiveX ドキュメントはコンテナのスペースを埋めて
サーバ アプリケーションのすべての機能にアクセスします。
解説
ペインタの場合
❖
コントロールの表示タイプを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[表示の種
類]ドロップダウン リストから値を選択します。
スクリプトの場合
DisplayType プロパティのデータ型は、omDisplayType カタログ データ
型です。値は以下のとおりです。
•
DisplayAsContent!
•
DisplayAsActiveXDocument!
オブジェクトとコントロール
431
DocumentName
•
DisplayAsIcon!
次の例では、DisplayType をアイコンに設定します。
ole_1.DisplayType = DisplayAsIcon!
DocumentName
対象
リッチテキスト エディット コントロール
機能
DocumentName プロパティは、ユーザがコントロールの内容を印刷す
るときに印刷キューに表示される名前を指定します。
解説
ペインタの場合
❖
印刷用のドキュメント名を設定する
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、
[ドキュメント名]フィールドにドキュメント名を入力します。
スクリプトの場合
DocumentName プロパティは文字列です。次に、リッチテキスト エ
ディット コントロールに印刷キューのドキュメント名を指定する例
を示します。
rte_1.DocumentName = "Report 1"
DragAuto
対象
ドラッグ可能なコントロール
機能
DragAuto プロパティは、コントロールを自動的にドラッグ モードにす
るかどうかを指定します。このプロパティが有効な場合、ユーザがコ
ントロールをクリックしてドラッグを始めると、コントロールが自動
的にドラッグ モードになります。コントロールをクリックすると、
Clicked イベントではなく DragDrop イベントが発生します。
DragAuto が有効でないときは、ユーザがコントロールをクリックして
もコントロールはドラッグ モードになりません。コントロールをド
ラッグ モードにするには、Drag 関数を呼び出す必要があります。
432
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
自動ドラッグ モードを設定する
•
コントロールのプロパティ ビューの[その他]タブ ページで、
[自
動ドラッグ モード]チェックボックスをオンにします。
スクリプトの場合
ほとんどのコントロールには DragAuto プロパティがあります。このプ
ロパティの値はブール値です。次の例では、コマンドボタンにドラッ
グ モードを設定します。
cb_1.DragAuto = TRUE
DragIcon
対象
ドラッグ可能なコントロール
機能
DragIcon プロパティは、ユーザがコントロールをドラッグしたときに
アイコンを表示するように指定します。デフォルトのアイコンは、コ
ントロールの大きさのボックスです。
ユーザがコントロールをドラッグし、コントロールをドロップできる
領域(有効ドロップ領域)にカーソルが入ったときにこのアイコンが
表示されます。有効ドロップ領域でない場所にカーソルがあるときは、
ドロップ禁止のアイコンが表示されます。
解説
ペインタの場合
❖
ドラッグ アイコンを指定する
1
コントロールのプロパティ ビューの[その他]タブ ページを表示
します。
2 [ドラッグ アイコン]フィールドの下矢印をクリックして組み込み
アイコンのリストからアイコンを 1 つ選択するか、[...]ボタンを
使って別のアイコン ファイル(ICO ファイル)を選択します。
スクリプトの場合
DragIcon プロパティは、ユーザがコントロールをドラッグしたときに
表示されるアイコン ファイルの名前の文字列です。組み込みアイコン
または任意のアイコン ファイル名を指定できます。
次の例では、リストボックスのドラッグ アイコンとして arrow.ico とい
うアイコンを設定します。
オブジェクトとコントロール
433
DropLines
lb_1.DragIcon = 'c:\examples\arrow.ico’
この例では、ドラッグ アイコンとして組み込みアイコン Question を設
定します。
lb_1.DragIcon = 'Question!'
DropLines
対象
グラフ コントロールの grAxis オブジェクト
機能
ドロップラインは、データポイントから軸に下ろした線です。ドロッ
プラインは、すべてのグラフ タイプで使用可能ではありません。
解説
ペインタの場合
❖
ドロップラインのタイプを設定する
1
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示します。
2 [軸]ドロップダウン リストから軸を選択します。
3 [ドロップライン]ドロップダウン リストから線種を選択します。
スクリプトの場合
DropLines プロパティのデータ型は、LineStyle カタログ データ型です。
次の例では、系列軸のドロップラインとして破線を指定します。
gr_1.Series.DropLines = Dash!
EditLabels
対象
リストビュー コントロール、ツリービュー コントロール
機能
EditLabels が有効な場合、ユーザはリストビューまたはツリービュー内
のラベルを編集できます。編集するには、項目を選択してラベルをク
リックし、文字を追加または削除します。EditLabels が有効でないとき
は、ラベルを編集できません。
434
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
ラベルの編集を可能にする
•
コントロールのプロパティ ビューの[全般]ページで、
[ラベルの
編集]チェックボックスをオンにします。
スクリプトの場合
EditLabels プロパティの値はブール値です。次の例では、ツリービュー
内のラベルの編集を可能にします。
tv_1.EditLabels = TRUE
EditMode
対象
インクピクチャ コントロール
機能
コントロールの編集モードを、インクの描画、インクの編集、あるい
はインクの削除に設定するかどうかを指定します。
解説
ペインタの場合
❖
インク収集のモードを指定する
•
プロパティ ビューの[インク]ページで、
[編集モード]ドロップ
ダウン リストから値を選択します。
スクリプトの場合
EditMode プロパティの値は、InkPicEditMode カタログデータ型変数の
値です。指定できる値は以下のとおりです。
•
InkPicDeleteMode! – インクを削除します。
•
InkPicInkMode! – インクを描画します(デフォルト)。
•
InkPicSelectMode! – 編集のためにインクを選択します。
次の例では、インクピクチャ コントロールがスタイラスのチップの下
のインクを削除するように指定します。
ie_1.EditMode = InkPicDeleteMode!
オブジェクトとコントロール
435
Elevation
Elevation
対象
グラフ コントロール
機能
Elevation は、3D グラフの仰角の大きさを定義します。前から後ろへの
仰角の角度を指定します。
Elevation は、2D グラフには無効です。
解説
ペインタの場合
❖
3D グラフの仰角を変更する
•
グラフのプロパティ ビューの[全般]ページで、
[仰角]スライダ
を動かします。
スクリプトの場合
Elevation プロパティの値は整数値です。次の例では、仰角 35°を指定
します。
gr_1.Elevation = 35
Enabled
対象
すべてのグラフィック コントロール(ただし、描画オブジェクト、プ
ログレスバー、スクロールバー、トラックバーを除く)
機能
Enabled プロパティが有効な場合、コントロールはフォーカスを持つこ
とができます。ユーザは、そのコントロールをクリックして選択する
ことができます。コントロールがタブ順序に含まれる場合は、そのコ
ントロールにタブ移動できます。
Enabled プロパティが有効でない場合は、コントロールはフォーカスを
持つことができないので、ユーザはそのコントロールを選択できませ
ん。
月表示カレンダ コントロールでは、このプロパティはキーボード入力
を有効または無効にします。
Enabled は、そのコントロールが表示可能かどうかには影響しません
(Visible を参照)。
436
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
Enabled プロパティを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[使用可能]
チェックボックスをオンにします。
スクリプトの場合
Enabled プロパティの値はブール値です。ほとんどのコントロールには
Enabled プロパティがあります。この例では、コマンドボタンに Enabled
を設定します。
cb_1.Enabled = TRUE
EndX
対象
直線コントロール
機能
EndX プロパティは、直線の終わりの X 座標を PowerBuilder 単位系で
指定します。
X 座標は、ウィンドウまたはカスタム ユーザ オブジェクトの左端から
の距離です。オブジェクトがメイン ウィンドウまたはカスタム ユーザ
オブジェクトの場合、この距離は画面を基準とします。オブジェクト
がメイン ウィンドウでない場合、距離は親ウィンドウを基準としま
す。ただし、MDI フレーム ウィンドウ内に開かれている場合は、距離
は MDI フレームを基準とします。
解説
ペインタの場合
❖
直線の終わりの X 座標を指定する
•
直線を挿入します。直線の終わりの位置を変更するには、直線の
プロパティ ビューの[位置]タブ ページで[終了 X]フィールド
の値を変更します。
スクリプトの場合
EndX プロパティの値は整数値です。この例では、線の終わりの X 座
標を設定します。
ln_1.EndX = 1200
オブジェクトとコントロール
437
EndY
EndY
対象
直線コントロール
機能
EndY プロパティは、直線の終わりの Y 座標を PowerBuilder 単位系で
指定します。
Y 座標は、ウィンドウまたはカスタム ユーザ オブジェクトの上端から
の距離です。オブジェクトがメイン ウィンドウまたはカスタム ユーザ
オブジェクトの場合、この距離は画面を基準とします。オブジェクト
がメイン ウィンドウでない場合、距離は親ウィンドウを基準としま
す。ただし、MDI フレーム ウィンドウ内に開かれている場合は、距離
は MDI フレームを基準とします。
解説
ペインタの場合
❖
直線の終わりの Y 座標を設定する
•
直線を挿入します。直線の終わりの位置を変更するには、直線の
プロパティ ビューの[位置]タブ ページで[終了 Y]フィールド
の値を変更します。
スクリプトの場合
EndY プロパティの値は整数値です。この例では、線の終わりの Y 座
標を設定します。
ln_1.EndY = 1200
Escapement
対象
グラフ コントロールの grDispAttr オブジェクト
機能
このプロパティは、グラフ コントロール内の Axis テキスト オブジェ
クトの基準線に対する回転角度を指定します。
解説
ペインタの場合
❖
グラフ内のテキスト オブジェクトの回転角度を設定する
1
グラフのプロパティ ビューの[テキスト]タブ ページを表示しま
す。
2 [テキスト オブジェクト]リストボックスからテキスト オブジェ
クトを選択します。
3 [回転角]スピン コントロールを使って値を設定します。
438
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
Escapement の値は整数値で、指定する角度の 10 倍の値です。0 は水平
です。900 なら、テキストは 90°回転します。450 なら 45°回転しま
す。次の例では、Value Axis Label の回転角度を 90°に設定します。
gr_1.Value.LabelDispAttr.Escapement = 900
ExtendedSelect
対象
リストボックス コントロール、ピクチャ リストボックス コントロー
ル、リストビュー コントロール
機能
ExtendedSelect は、リストボックスまたはリストビューから同時に複数
の項目をユーザが選択できるかどうかを指定します。ExtendedSelect が
有効な場合、ユーザは複数の項目を選択できます。連続した項目を選
択するには、項目をクリックしてマウスを上下にドラッグして、クリッ
クするか、または〔Shift〕を押しながらクリックします。または、複
数の項目上で〔Ctrl〕を押しながらクリックすることによっても選択で
きます。ExtendedSelect が有効でないときは、ユーザは複数の項目を選
択できません。
使用上の注意
MultiSelect と ExtendedSelect の両方が有効な場合は、ExtendedSelect の
動作が優先されます。
解説
ペインタの場合
❖
拡張選択を有効にする
•
コントロールの[プロパティ]ページの[全般]ページで、
[拡張
選択]チェックボックスをオンにします。
スクリプトの場合
ExtendedSelect プロパティの値はブール値です。次の例では、ユーザが
拡張選択を使って リストボックス lb_1 の複数の項目を選択できるよ
うにします。
lb_1.ExtendedSelect = TRUE
オブジェクトとコントロール
439
FaceName
FaceName
対象
テキストを表示可能なコントロール
機能
FaceName プロパティは、コントロール内のテキストに使用されるフォ
ントを指定します。タブ コントロールでは、このプロパティはタブの
テキスト ラベルのフォントを指定します。
利用可能なフォントは、システムにインストールされているフォント
です。アプリケーションのインストール先によっては利用できない
フォントがあるので注意が必要です。
解説
ペインタの場合
❖
•
コントロール内のテキストのフォントを設定する
コントロールのプロパティ ビューの[フォント]タブ ページで、
[フォント名]リストボックスからフォントを選択します。
❖
グラフ コントロール内のテキスト オブジェクトのフォントを設定する
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示します。
2 [テキスト オブジェクト]リストボックスからテキスト オブジェ
クトを選択します。
3 [フォント名]リストボックスからフォントを選択します。
スクリプトの場合
FaceName プロパティは文字列です。次の例では、タブ コントロール
のテキスト ラベルのフォントを Arial に設定します。
tab_1.FaceName = "Arial"
Factoid
対象
インクエディット コントロール
機能
インクエディット コントロールでのインク認識のコンテキストを指
定します。入力データが日付などの既知のデータ型の場合は、認識結
果の検索を制限するためにこのプロパティを設定します。指定できる
値は、digit、email、Web、date、time、number、currency、percent、およ
び telephone です。
440
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
インクエディット コントロールの Factoid を指定する
•
ドロップダウン リストから Factoid を選択します。
以下の値を使用できます。ドロップダウン リストには Default および
None Factoid の後に、アルファベット順に特別な形式の Factoid、それ
に続いて単一文字の Factoid およびアジア言語の Factoid を表示しま
す。
Factoid
Default
None
Currency
Date
E-mail
Filename
Number
Percent
Postal Code
System Dictionary
Telephone
Time
Web
Word List
Digit
One Char
Upper Char
オブジェクトとコントロール
説明
レコグナイザをデフォルトの設定に戻します。西洋
語のデフォルト設定には、ユーザ ディクショナリ
とシステム ディクショナリ、様々な句読点、およ
び Web と Number Factoid を含みます。東洋語のデ
フォルト設定にはレコグナイザがサポートするす
べての文字を含みます。
すべての Factoid、ディクショナリ、言語モデルを
無効にします。
ポンド、ドル、ユーロ、および円の通貨
英語で記述された日付。例:8/19/2005、Aug 19, 2005、
あるいは Friday, August 19, 2005
電子メール アドレス
Windows のファイル名のパス。名前に次の文字を含
めることはできません。/ : " < > |
数値。数値は、序数、小数、分離記号、一般の接尾
辞、および数学記号を含みます。この Factoid は
Currency と Time Factoid を含みます。
パーセント記号が続く数値
英語で記述された郵便番号。例:01730 または CT17
9PW
システム ディクショナリだけの単語
英語で記述された電話番号。例: (555) 555 5555 ま
たは +44 1234 123456
英語で記述された時間。例:15:05 または 3:05 pm
様々な URL 形式
レコグナイザ コンテキストだけに関連した単語リ
ストの単語
単一数字(0-9)
単一の ANSI 文字
単一の大文字
441
FillColor
さらに、以下のアジア言語の Factoid が使用できます。
Bopomofo
Hangul Common
Hiragana
Jamo
Japanese Common
Kanji Common
Katakana
Korean Common
Simplified Chinese Common
Traditional Chinese Common
スクリプトの場合
Factoid プロパティは文字列値です。
次の例では、コントロール ie_1 の Factoid プロパティを Telephone に設
定します。
ie_1.Factoid = "Telephone"
FillColor
対象
楕円コントロール、長方形コントロール、丸長方形コントロール
機能
FillColor プロパティはコントロールの塗りつぶしに使う色を定義しま
す。ペインタで背景色を定義するときは、選択内容によっては、現在
のウィンドウ配色またはカスタム カラーから値が採用されます。
色のドロップダウン リストに独自の色を追加するには、プロパティ
ビューを表示する前に[デザイン|色の指定]を選択します。
解説
ペインタの場合
❖
塗りつぶし色を設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[塗りつぶ
し]ドロップダウン リストから色を選択します。
スクリプトの場合
FillColor プロパティの値は long 型の値(-2 から 16,777,215)で、ウィ
ン ド ウ お よ び ほ か の オ ブ ジ ェ ク ト の 背 景 色 の 数 値 を 指 定 し ま す。
FillColor 値は、色の赤、緑、青(RGB)の 3 要素の値の組み合わせで
す。目的の色の long 型の値がわからない場合には、[デザイン|色の
指定]を選択して RGB 値を判別してから、スクリプトで RGB 関数を
呼び出して色を指定します。
この例では、丸長方形 rr_display の塗りつぶし色として黄色を設定しま
す。
442
PowerBuilder
第3章
プロパティの説明と使用法
rr_display.FillColor=RGB(255,255,0)
FillPattern
対象
楕円コントロール、長方形コントロール、丸長方形コントロール、ス
タティック テキスト コントロール、スタティック ハイパーリンク コ
ントロール
機能
FillPattern プロパティは、コントロールのハッチ パターンを指定しま
す。
描画オブジェクトでは、パターンの背景に FillColor が使用され、前景
の線に LineColor が使用されます。
スタティック テキスト コントロールおよびスタティック ハイパーリンク
コントロールでは、パターンの背景に BackColor が使用され、前景線に
TextColor が使用されます。テキストとパターン線には同じ色が使用さ
れます。
解説
ペインタの場合
❖
ハッチ パターンを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[パターン
で塗りつぶし]ドロップダウン リストからハッチ パターンを選択
します。
スクリプトの場合
FillPattern プロパティのデータ型は、
FillPattern カタログ データ型です。
次の例では、スタティック テキスト コントロールにハッチ パターン
として Diamond を設定します。
st_1.FillPattern = Diamond!
オブジェクトとコントロール
443
FirstDayOfWeek
FirstDayOfWeek
対象
月表示カレンダ コントロール
機能
カレンダの左側に表示する曜日を指定します。
解説
ペインタの場合
❖
FirstDayOfWeek プロパティを設定する
•
プロパティ ビューの[全般]ページで、
[週の開始曜日]ドロップ
ダウン リストから曜日を選択します。
スクリプトの場合
FirstDayOfWeek プロパティの値は、WeekDay カタログ データ型です。
次の例では、週の最初の曜日を月曜日に設定します。
mc_1.FirstDayOfWeek = Monday!
FixedLocations
対象
リストビュー コントロール
機能
FixedLocations プロパティが有効な場合、ユーザは項目をコントロール
内の別の場所にドラッグできません。FixedLocations が有効でなく
DragAuto が有効な場合は、ユーザは項目を別の場所にドラッグできま
す。
解説
ペインタの場合
❖
FixedLocation プロパティを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[項目位置
を固定]チェックボックスをオンにします。
スクリプトの場合
FixedLocations プロパティの値はブール値です。次の例では、リスト
ビュー内で項目をドラッグできるようにします。
lv_1.DragAuto = TRUE
lv_1.FixedLocations = FALSE
444
PowerBuilder
第3章
プロパティの説明と使用法
FixedWidth
対象
タブ コントロール
機能
FixedWidth プロパティが有効な場合、タブ幅は固定されています。幅
は、最も長いタブ ラベルによって決まります。FixedWidth が有効でな
い場合は、タブ幅はそれぞれのテキスト ラベルの幅になります。
解説
ペインタの場合
❖
FixedWidth プロパティ
•
タブ コントロールのプロパティ ビューの[全般]ページで、[幅
合わせをしない]チェックボックスをオンにします。
スクリプトの場合
FixedWidth プロパティの値はブール値です。次の例では、tab_1 コント
ロール内のタブの幅を固定幅に指定します。
tab_1.FixedWidth = TRUE
FocusOnButtonDown
対象
タブ コントロール
機能
FocusOnButtonDown プロパティが有効な場合、各タブ ページはユーザ
がそのタブ ページをクリックしたときにフォーカスを受け、破線の長
方形でそのタブ ページがマークされます。FocusOnButtonDown が有効
でない場合は、クリックされたタブ ページにはフォーカスを表す長方
形が表示されません。どちらの場合も、選択されたタブ ページが前面
に表示されます。
解説
ペインタの場合
❖
•
FocusOnButtonDown プロパティを設定する
タブ コントロールのプロパティ ビューの[全般]ページで、
[フォーカス時の枠表示]チェックボックスをオンにします。
スクリプトの場合
FocusOnButtonDown プロパティの値はブール値です。次の例では、コ
ントロール tab_1 内のタブ ページをクリックしたときにフォーカスを
表す長方形が表示されるように指定します。
tab_1.FocusOnButtonDown = TRUE
オブジェクトとコントロール
445
FocusRectangle
FocusRectangle
対象
グラフ、ピクチャ、ピクチャ ハイパーリンク、OLE、OLE カスタム コ
ントロール、スタティック テキスト コントロール、スタティック ハ
イパーリンク コントロール
機能
FocusRectangle プロパティが有効な場合、コントロールにフォーカスが
あるときに破線の四角形(フォーカスを表す長方形)が表示されます。
このプロパティが有効でない場合は、フォーカスを表す長方形は表示
されません。
解説
ペインタの場合
❖
FocusRectangle プロパティを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[フォーカ
ス時の枠表示]チェックボックスをオンにします。
スクリプトの場合
FocusRectangle プロパティの値はブール値です。次の例では、スタティッ
ク テキスト コントロールにフォーカスがあるときにフォーカスを表す
長方形が表示されるように指定します。
st_1.FocusRectangle = TRUE
FontCharSet
対象
テキストを表示可能なコントロール
機能
このプロパティは、コントロール内のテキストに使用するフォントの
文字セットを指定します。文字セットとフォントは関連しているので、
不適切な文字セットを選択すると、意図したものとは異なるフォント
が使用される場合があります。
ペインタで作業している場合は、フォントの FaceName プロパティを
設定すると正しい文字セットが選択されます。
解説
ペインタの場合
❖
•
446
フォントの文字セットを設定する
コントロールのプロパティ ビューの[フォント]タブ ページで、
[文字コード]リストボックスから文字セットを選択します。
PowerBuilder
第3章
プロパティの説明と使用法
❖
グラフ コントロールのテキスト オブジェクトの文字セットを設定する
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示します。
2 [テキスト オブジェクト]リストボックスからテキスト オブジェ
クトを選択します。
3 [文字コード]リストボックスから文字セットを選択します。
スクリプトの場合
FontCharSet のデータ型は、FontCharSet カタログ データ型です。次の
例では、スタティック テキスト コントロールの文字セットを ANSI に
設定します。
st_1.FontCharSet = ANSI!
FontFamily
対象
テキストを表示可能なコントロール
機能
FontFamily プロパティは、コントロール内のテキストに使用するフォ
ント スタイルを指定します。
ペインタで作業している場合は、フォントの FaceName プロパティを
設定すると正しいフォント ファミリが選択されます。
解説
ペインタの場合
❖
•
フォント スタイルを設定する
コントロールのプロパティ ビューの[フォント]タブ ページで、
[フォントファミリー]リストボックスからフォント スタイルを選
択します。
❖
グラフ コントロール内のテキスト オブジェクトのフォント スタイルを設定
する
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示します。
2 [テキスト オブジェクト]リストボックスからテキスト オブジェ
クトを選択します。
3 [フォントファミリー]リストボックスからフォント スタイルを選
択します。
オブジェクトとコントロール
447
FontPitch
スクリプトの場合
FontFamily プロパティのデータ型は、FontFamily カタログ データ型で
す。次の例では、スタティック テキスト コントロールの FontFamily を
Roman に設定します。
st_1.FontFamily = Roman!
FontPitch
対象
テキストを表示可能なコントロール
機能
FontPitch プロパティは、コントロール内のテキストの文字間隔を指定
します。
ペインタで作業している場合は、フォントの FaceName プロパティを
設定すると正しい文字間隔が選択されます。
解説
ペインタの場合
❖
•
フォントの文字間隔を設定する
コントロールのプロパティ ビューの[フォント]タブ ページで、
[ピッチ]リストボックスから文字間隔を選択します。
❖
グラフ コントロール内のテキスト オブジェクトの文字間隔を設定する
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示します。
2 [テキスト オブジェクト]リストボックスからテキスト オブジェ
クトを選択します。
3 [ピッチ]リストボックスから文字間隔を選択します。
スクリプトの場合
FontPitch プロパティのデータ型は、FontPitch カタログ データ型です。
次の例では、スタティック テキスト コントロールの文字間隔を設定し
ます。
st_1.FontPitch = Fixed!
448
PowerBuilder
第3章
プロパティの説明と使用法
Format
対象
グラフ コントロールの grDispAttr オブジェクト
機能
Format プロパティで、グラフ内のテキスト オブジェクトの表示書式を
定義できます。表示書式とは、特別な意味を持つ文字に適用されるマ
スクのことです。
書式設定に使う文字は、データのデータ型により異なります。
PowerBuilder では、次の 4 種類の表示書式をサポートします。
•
Numbers
•
Strings
•
Dates
•
Times
書式の前にカラー キーワードを指定することにより、表示書式に色を
指定できます。
表示書式の色と種類についての詳細は、575 ページの「表示書式に色
を使用する」およびそれ以降の節を参照してください。表示書式の定
義についての詳細は、PowerBuilder の『ユーザーズ ガイド』マニュア
ルを参照してください。
解説
ペインタの場合
❖
テキスト オブジェクトの表示書式を設定する
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示します。
2 [テキスト オブジェクト]リストボックスで、テキストを選択します。
3 [式の表示]フィールドに表示式を入力するか、[書式]ドロップ
ダウン リストから書式を選択します。
スクリプトの場合
各タイプの表示書式では、書式用の特殊な意味を持つ特殊文字を使用
します。Format プロパティの値は、それらの特殊文字から構成される
文字列です。
次の例では、数値データに、常に小数点以下 2 桁で 3 桁表示するよう
書式を設定します。
gr__1.Values.DispAttr.Format = "0.00"
次の例では、英数字データの文字列書式を指定します。
gr_1.Category.dispAttr.Format = "@@@/AAA"
オブジェクトとコントロール
449
Frame
Frame
対象
グラフ コントロールの grAxis オブジェクト
機能
Frame プロパティは、3D グラフの軸のフレームに使用する線種を指定
します。フレームとは、選択されている軸に関連する 3D ボックスの
枠です。
解説
ペインタの場合
❖
軸のフレーム線種を設定する
1
グラフ コントロールのプロパティ ビューの[全般]ページで、3D
グラフのスタイルを選択します。3D グラフのすべてで Frame プロ
パティが使用可能ではありません。
2
プロパティ ビューの[軸]タブ ページを表示して、[軸]ドロッ
プダウン リストから軸を選択します。
3 [線の種類]グループの[フレーム]ドロップダウン リストから線
種を選択します。
スクリプトの場合
Frame プロパティのデータ型は、LineStyle カタログ データ型です。
この例では、グラフ gr_1 の系列軸フレームに破線を指定します。
gr_1.Series.Frame = Dash!
FreeDBLibraries
対象
アプリケーション オブジェクト
機能
PowerBuilder とデータベースの接続が解除された後で PowerBuilder ラ
イブラリをメモリ内に保持するかどうかを決めます。
解説
PowerBuilder 8 以前では、PowerBuilder とデータベースの接続を解除さ
れたときは、自動的にデータベース インタフェース ライブラリが解放
されていました。特定のデータベース管理システムのパフォーマンス
を向上させ、プロセス初期化の問題を解消するために、PowerBuilder
のデフォルトでは、接続解除の際にデータベース インタフェース ライ
ブラリを解放しなくなりました。アプリケーション オブジェクトの
FreeDBLibraries プロパティを使うと、データベースから接続が解除さ
れた時点でこれらのライブラリを強制的に解放できます。
450
PowerBuilder
第3章
プロパティの説明と使用法
これは実行時プロパティ専用です。設計時に、PowerBuilder とデータ
ベースの接続解除後にメモリ内に保持されたライブラリが解放される
ようにするには、システム オプション ダイアログボックスの[全般]
ページで[切断時にデータベース ドライバ ライブラリを解放する]
チェックボックスをオンにします。PowerBuilder シャットダウンのと
きは常に、設計時ライブラリと実行時ライブラリがメモリから消去さ
れます。
データベース インタフェース ライブラリ解放のための設計時の選択
についての詳細は、
『データベースとの接続』マニュアルを参照してく
ださい。
アプリケーション ペインタの場合
❖
データベースの接続解除の際に PowerBuilder ライブラリを解放する
•
アプリケーションのプロパティ ビューの[全般]ページで、[DB
ライブラリの解放]チェックボックスをオンにします。
スクリプトの場合
FreeDBLibraries プロパティの値はブール値です。次の例では、実行時に
データベースの接続が解除された後にメモリのクリアと PowerBuilder
ライブラリの解放が実行されるようにプロパティを設定します。
my_app.FreeDBLibraries = TRUE
GraphType
対象
グラフ コントロール
機能
GraphType プロパティは、グラフの種類を指定します。グラフの種類
には、面グラフ、横棒グラフ、縦棒グラフ、折れ線グラフ、円グラフ、
散布図があります。
解説
ペインタの場合
❖
グラフ タイプを選択する
•
グラフのプロパティ ビューの[全般]ページで、[グラフの種類]
ドロップダウン リストからグラフを選択します。
コントロールに表示されているグラフのタイプが変更され、選択
したタイプの例が表示されます。
グラフのタイプの選択は、ほかのタブでどのプロパティを利用で
きるかに影響します。
オブジェクトとコントロール
451
HasButtons
スクリプトの場合
GraphType プロパティのデータ型は、grGraphType カタログ データ型で
す。次の例では、グラフ gr_1 を 3D 円グラフに指定します。
gr_1.GraphType=Pie3D!
HasButtons
対象
ツリービュー コントロール
機能
HasButtons が有効な場合、親項目の隣に[+]ボタンと[-]ボタンが
表示されます。このボタンは、項目が展開されている([-]
)か折りた
たまれている([+])かを示します。
解説
ペインタの場合
❖
ボタンの表示を有効にする
•
コントロールのプロパティ ビューの[全般]ページで、
[+, - ボタ
ンの表示]チェックボックスをオンにします。
スクリプトの場合
HasButtons プロパティの値はブール値です。次の例では、ツリービュー
で[+]と[-]のボタンが表示されるように指定します。
tv_1.HasButtons = TRUE
HasLines
対象
ツリービュー コントロール
機能
HasLines プロパティが有効な場合、ツリー項目をつなぐ線が表示され
ます。
解説
ペインタの場合
452
❖
ツリービュー項目を線でつなげるには
•
コントロールのプロパティ ビューの[全般]ページで、
[項目ライ
ンの表示]チェックボックスをオンにします。
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
HasLines プロパティの値はブール値です。次の行を実行すると、ツリー
項目をつなぐ線が表示されるように指定されます。
tv_1.HasLines = TRUE
HeaderFooter
対象
リッチテキスト エディット コントロール
機能
HeaderFooter プロパティは、コントロールのヘッダおよびフッタ セク
ションの有無を指定します。ユーザがヘッダとフッタの編集パネルを
表示できるように、メニューまたはボタン スクリプトを記述する必要
があります。
リッチテキスト エディット コントロールの使用法についての詳細は、
『アプリケーション テクニック』マニュアルの「リッチテキストの作
成方法」を参照してください。
注
リッチテキスト エディット コントロールにヘッダまたはフッタ セク
ションがなく、開いたドキュメントにヘッダとフッタのセクションが
ある場合は、ヘッダとフッタは無視されます。その後、コントロール
内から同じファイル名でドキュメントを保存すると、元のドキュメン
トのヘッダとフッタは失われます。
解説
ペインタの場合
❖
コントロールのヘッダおよびフッタ セクションを有効にする
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、[ヘッダ / フッタ]チェックボックスをオンにします。
スクリプトの場合
HeaderFooter プロパティの値はブール値ですが、コントロールのプロ
パティ ビューでのみ設定できます。この値は実行中には変更できませ
ん。
実行中にヘッダとフッタの編集パネルを表示するには、ShowHeadFoot
関数を使用します。
オブジェクトとコントロール
453
Height
Height
対象
表示可能なコントロール、ウィンドウ
機能
Height プロパティは、コントロールまたはウィンドウの高さを
PowerBuilder 単位系で指定します。
解説
ペインタの場合
❖
コントロールまたはウィンドウの高さを設定する
•
オブジェクトのプロパティ ビューの[その他]タブ ページで、
[高
さ]編集ボックスに高さを入力するか、コントロールまたはウィ
ンドウを選択して、カーソルでサイズを変更します。
スクリプトの場合
Height プロパティの値は整数値で、オブジェクトの高さを PowerBuilder
単位系で指定します。次の例では、データウィンドウ コントロール
dw_1 の高さを設定します。
dw_1.Height = 750
最小化または最大化されたシートまたはフレームのサイズの変更は不
正な処理です。最小化または最大化されたウィンドウについては、
Width プロパティまたは Height プロパティの変更はサポートされませ
ん。
HideSelection
対象
シングルライン エディット コントロール、マルチライン エディット
コントロール、エディットマスク コントロール、リストビュー コント
ロール、ツリービュー コントロール
機能
HideSelection プロパティが有効な場合、コントロールがフォーカスを
受けていないときは、選択されているテキストは選択された状態(反
転表示)を維持しません。このプロパティが有効でない場合、コント
ロールがフォーカスを受けていないとき、選択されているテキストは
反転表示のままになります。
解説
ペインタの場合
454
❖
HideSelection を有効にする
•
コントロールのプロパティ ビューの[全般]ページで、[選択解
除]チェックボックスをオンにします。
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
HideSelection プロパティの値はブール値です。次の例では、シングル
ライン エディット内の選択されているテキストが常に反転表示され
るように指定します。
sle_1.HideSelection = FALSE
HScrollBar
対象
データウィンドウ コントロール、ドロップダウン リストボックス コ
ントロール、ドロップダウン ピクチャ リストボックス コントロール、
エディットマスク コントロール、InkaEdit コントロール、リストボッ
クス コントロール、ピクチャ リストボックス コントロール、マルチ
ライン エディット コントロール、リッチテキスト エディット コント
ロール、ユーザ オブジェクト、ウィンドウ
機能
HScrollBar プロパティが有効な場合、すべてのデータを同時に表示で
きないときには水平スクロールバーが表示されます。このプロパティ
が有効でない場合は、水平スクロールバーは表示されません。
解説
ペインタの場合
❖
コントロールの水平スクロールバーを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[水平スク
ロールバー]チェックボックスをオンにします。
❖
ウィンドウまたはユーザ オブジェクトに水平スクロールバーを設定する
•
ウィンドウまたはオブジェクトのプロパティ ビューの[スクロー
ル]タブ ページで、
[水平スクロールバー]チェックボックスをオ
ンにします。
スクリプトの場合
HScrollBar プロパティの値はブール値です。次の例では、必要に応じ
てリストボックスに水平スクロールバーが表示されるように指定しま
す。
lb_1.HScrollBar = TRUE
このプロパティは、実行時にエディットマスク コントロールに設定で
きません。
オブジェクトとコントロール
455
HSplitScroll
HSplitScroll
対象
データウィンドウ コントロール
機能
HSplitScroll プロパティが有効な場合、ユーザはデータウィンドウ コン
トロールを、別々のスクロールバーを持つ 2 つのペインに分割するこ
とができます。ユーザはスプリットバーを動かしてデータウィンドウ
コントロールを 2 つのペインに分割します。
このプロパティが有効でない場合、ユーザはデータウィンドウ コント
ロールを分割できません。
解説
ペインタの場合
❖
コントロールを 2 つのペインに分割できるようにする
•
コントロールのプロパティ ビューの[全般]ページで、
[水平スク
ロールバーの分割可能]チェックボックスをオンにします。
スクリプトの場合
HSplitScroll プロパティの値はブール値です。次の例では、データウィ
ンドウ コントロール dw_1 を分割できるようにします。
dw_1.HSplitScroll = TRUE
HTextAlign
対象
ピクチャボタン コントロール
機能
HTextAlign プロパティは、ピクチャボタン コントロール内のテキスト
の水平位置揃えを指定します。位置揃えは、右揃え、左揃え、または
中央揃えです。
解説
ペインタの場合
❖
テキストの水平位置揃えを指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[水平テキ
スト配置]ドロップダウン リストから位置揃えを選択するか、ス
タイルバーの[左寄せ]、
[中央揃え]、
[右寄せ]位置揃えボタン
を使用します。
スクリプトの場合
HTextAlign プロパティのデータ型は、Alignment カタログ データ型で
す。
456
PowerBuilder
第3章
プロパティの説明と使用法
次の例では、ピクチャボタンのテキストに右揃えを指定します。
pb_1.HTextAlign = Right!
Icon
対象
データウィンドウ コントロールおよびウィンドウ
機能
Icon プロパティは、データウィンドウ コントロールまたはウィンドウ
が最小化されているときにアイコンが表示されるように指定します。
組み込みアイコンまたは任意のアイコン ファイル名を指定できます。
解説
ペインタの場合
❖
最小化時のアイコンを指定する
1
ウィンドウまたはコントロールのプロパティ ビューの[全般]タ
ブ ページを表示します。
2 [アイコン]リストボックスから組み込みアイコンを選択すること
によりアイコン名を指定するか、[...]ボタンを使って別のアイコ
ン ファイル(ICO ファイル)を選択します。
アイコンを選択すると、
[アイコン]リストボックスに画像が表示
されます。
スクリプトの場合
Icon プロパティは、ウィンドウまたはコントロールが最小化されたと
きに表示するアイコンのファイル名の文字列です。組み込みアイコン
または任意のアイコン ファイル名を指定できます。
次の例では、ウィンドウに arrow.ico というアイコン ファイルを指定し
ます。
w_1.Icon = 'c:\examples\arrow.ico’
この例では、ウィンドウに組み込みアイコン Rectangle を指定します。
w_1.Icon = 'Rectangle!'
オブジェクトとコントロール
457
IgnoreDefaultButton
IgnoreDefaultButton
対象
エディットマスク コントロール、マルチライン エディット コントロー
ル
機能
IgnoreDefaultButton プロパティは、ユーザが〔Enter〕を押したときに、
ウィンドウのデフォルト ボタンの Clicked イベントを発生させるかど
うかを指定します。
このプロパティが有効な場合、
〔Enter〕を押しても Clicked イベントは
発生せずに、コントロールに新しい行が挿入されます。
このプロパティが有効でない場合は、
〔Enter〕を押すと Clicked イベン
トが発生し、コントロールに新しい行は挿入されません。
解説
ペインタの場合
❖
IgnoreDefaultButton プロパティを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[デフォル
ト ボタンを無視]チェックボックスをオンにします。
スクリプトの場合
IgnoreDefaultButton プロパティの値はブール値です。デフォルト値は
FALSE です。
次の例では、
〔Enter〕を押したときにウィンドウのデフォルト ボタン
の Clicked イベントを発生させずにマルチライン エディット コント
ロールに新しい行が挿入されるように指定します。
mle_1.IgnoreDefaultButton = TRUE
IgnorePressure
対象
インクエディット コントロール、インクピクチャ コントロール
機能
タブレットの表面でペン チップの圧力が加わると描画インクの幅が
広くなるかを示す描画属性です。
解説
ペインタの場合
458
❖
ペン チップの圧力を無視するように指定する
•
プロパティ ビューの[インク]ページで、
[圧力を無視]チェック
ボックスを選択します。
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
IgnorePressure プロパティは boolean 値です。
次の例は、コントロール ie_1 の IgnorePressure プロパティを true に設定
します。
ie_1.IgnorePressure = TRUE
Increment
対象
エディットマスク コントロール
機能
エディットマスク コントロールがスピン コントロール(ユーザがク
リックして、あらかじめ定義されている値を調べることのできる、上
下方向の矢印の付いたコントロール)として定義されているときは、
Increment プロパティは、スピンの矢印の増減値を定義します。
Increment は、数値と日付のデータ型でのみ有効です。日付データ型で
は、増減値は年にのみ適用されます。
解説
ペインタの場合
❖
スピン コントロールの増減値を設定する
1
コントロールのプロパティ ビューの[マスク]タブ ページで、
[ス
ピン]チェックボックスをオンにします。
[増減値]フィールドがアクティブになります。
2 [マスク データ型]ドロップダウン リストからマスク データ型を
選択します。
3 [増減値]フィールドに増減値を入力します。
スクリプトの場合
Increment プロパティの値は double 型です。次の例では、エディットマ
スクの増減値を 10 に設定します。
em_1.Increment = 10.0
オブジェクトとコントロール
459
Indent
Indent
対象
ツリービュー コントロール
機能
Indent プロパティは、ツリービューの各レベルのインデント幅を指定
します。インデント幅は、PowerBuilder 単位系で指定します。
解説
ペインタの場合
❖
ツリービュー コントロールの項目のインデント幅を設定する
•
コントロールのプロパティ ビューで、
[全般]ページの[インデン
ト]フィールドに PowerBuilder 単位系でインデント幅を入力しま
す。
スクリプトの場合
Indent プロパティの値は整数値です。次に、100 PowerBuilder 単位系の
インデントを設定するスクリプトを示します。
tv_1.Indent = 100
InkAntiAliased
対象
インクエディット コントロール、インクピクチャ コントロール
機能
描画インクの輪郭で前景色と背景色を融合し(アンチエイリアスし)、
ストロークを滑らかで鮮明にするかどうかを示す描画属性です。
解説
ペインタの場合
❖
前景色と背景色を融合しないように指定する
•
プロパティ ビューの[インク]ページで、[インク アンチエイリ
アス]チェックボックスをオフにします。
スクリプトの場合
InkAntiAliased プロパティの値は boolean 値です。
次の例では、コントロール ie_1 の InkAntiAliased プロパティを false に
設定します。
ie_1.InkAntiAliased = FALSE
460
PowerBuilder
第3章
プロパティの説明と使用法
InkColor
対象
インクエディット コントロール、インクピクチャ コントロール
機能
現行のインクの色を示す描画属性です。デフォルトの色は黒です。
解説
ペインタの場合
❖
インクエディットあるいはインクピクチャ コントロールで描くインクの色を
指定する
•
プロパティ ビューの[インク]ページで、
[インクの色]ドロップ
ダウン リストから色を選択します。
スクリプトの場合
InkColor プロパティの値は long 値です。
次の例は、コントロール ip_1 の InkColor プロパティをマジェンダの
long 値に設定します。
ip_1.InkColor = 16711935
次の例は、トラック バー コントロールの Moved イベントで、RGB 関
数とユーザが選択したスクロール位置を使用して InkColor プロパティ
を設定します。
ip_1.InkColor = RGB(scrollpos/4, scrollpos/16,
scrollpos/64)
InkEnabled
対象
インクピクチャ コントロール
機能
インク収集を有効にするかどうかを指定します。
解説
ペインタの場合
❖
インクピクチャ コントロールがインクを収集できるように指定する
•
プロパティ ビューの[インク]ページで、
[インク有効]チェック
ボックスを選択します。
スクリプトの場合
InkEnabled プロパティの値は boolean 値です。
オブジェクトとコントロール
461
InkHeight
タブレット PC SDK をインストールしていないシステムでは、プロパ
ティの値は常に false になります。MarginX および MarginY プロパティ
を変更する前に、このプロパティを false に設定しなければなりませ
ん。そして、アプリケーションを閉じる前に false に設定する必要があ
ります。このプロパティを変更する前に、コントロールが Status プロ
パティをチェックしてインクを収集していないことを確認してくださ
い。
次の例は、ip_1 コントロールがインクを収集していないことを確認し、
それからインク収集を無効にします。
IF ip_1.Status = Idle! THEN
ip_1.InkEnabled = FALSE
ELSE
MessageBox("Please try again later",
"Ink is being collected.")
END IF
&
InkHeight
対象
インクエディット コントロール、インクピクチャ コントロール
機能
長方形のペン チップの高さをピクセルで示す描画属性です。デフォル
トは 1 ピクセルです。このプロパティはボール ペン チップには影響し
ません。
解説
ペインタの場合
❖
インクエディットあるいはインクピクチャ コントロールで描画するインクの
高さを指定する
•
プロパティ ビューの[インク]ページで、
[インクの高さ]スピン
コントロールの値を入力あるいは選択します。
スクリプトの場合
InkHeight プロパティの値は整数値です。
次の例は、トラックバー コントロールの Moved イベントで、ユーザが
選択したトラックバーのスクロール位置を使用して InkHeight プロパ
ティを設定します。
ip_1.InkHeight = int(scrollpos)
462
PowerBuilder
第3章
プロパティの説明と使用法
InkMode
対象
インクエディット コントロール
機能
インク収集を無効にするか、インクだけを収集するか。あるいはイン
クとジェスチャを収集するかを指定します。
解説
ペインタの場合
❖
インク収集のモードを指定する
•
プロパティ ビューの[インク]ページで、
[インク モード]ドロッ
プダウン リストから値を選択します。
スクリプトの場合
InkMode プロパティの値は InkMode カタログ データ型変数の値です。
指定できる値は以下の通りです。
•
CollectInk! – インクだけが収集されます。
•
CollectInkAndGestures! – インクとジェスチャが収集されます(デ
フォルト)
•
InkDisabled! – インク収集が無効です。
インク レコグナイザをインストールしていないシステムでは、プロパ
ティの値は常に InkDisabled! です。
次の例は、インクエディット コントロールはインクを収集するが、
ジェスチャを無視するように指定します。
ie_1.InkMode = CollectInk!
InkWidth
対象
インクエディット コントロール、インクピクチャ コントロール
機能
ペンの幅をピクセルで指定する描画属性です。デフォルトは 53 ピクセ
ルです。IgnorePressure プロパティが設定されていない場合は、実際の
幅は最小圧力の Width プロパティの値の 0.5 倍と最大圧力のその値の
1.5 倍の間で変化します。
ペン チップはボールまたは長方形です。InkWidth プロパティは、ボー
ル チップの直径および長方形チップの幅を指定します。
オブジェクトとコントロール
463
InputFieldBackColor
解説
ペインタの場合
❖
インクエディットまたはインクピクチャ コントロールで描画されるインクの
幅を指定する
•
プロパティ ビューの[インク]ページで、[インクの幅]スピン
コントロールの値を入力あるいは選択します。
スクリプトの場合
InkWidth プロパティの値は整数値です。
次の例は、ie_1 の InkWidth プロパティを 106 に設定します。
ie_1.InkWidth = 106
InputFieldBackColor
対象
リッチテキスト エディット コントロール
機能
InputFieldBackColor プロパティは、リッチテキスト エディット コント
ロールの入力フィールドの背景色を設定します。この項目は、実行時
にユーザがポップアップ メニューの[プロパティ]項目から選択する
こともできます。
解説
ペインタの場合
❖
•
入力フィールドの背景色を設定する
コントロールのプロパティ ビューの[ドキュメント]ページで、
[入力フィールドの背景色]ドロップダウン リストから色を選択し
ます。
色のドロップダウン リストに独自の色を追加するには、プロパ
ティ ビューを表示する前に[デザイン|色の指定]を選択します。
スクリプトの場合
InputFieldBackColor プロパティの値は long 型(-2 から 16,777,215)で、
入力フィールドの背景色の数値を指定します。この値は、色の赤、緑、
青(RGB)の 3 要素の値の組み合わせです。目的の色の long 型の値が
わからない場合には、[デザイン|色の指定]を選択して RGB 値を判
別してから、スクリプトで RGB 関数を呼び出して色を指定します。
この例では、入力フィールドを赤に設定します。
rte_1.InputFieldBackColor = RGB(255, 0, 0)
464
PowerBuilder
第3章
プロパティの説明と使用法
InputFieldNamesVisible
対象
リッチテキスト エディット コントロール
機能
InputFieldNamesVisible プロパティが有効な場合、コントロールには入
力フィールド名が表示され、入力フィールドの値は表示されません。
このプロパティが有効でない場合は、リッチテキスト エディット コン
トロールには入力フィールドの値が表示されます。
このプロパティは、実行時にのみスクリプトを使ってリッチテキスト
エディットに設定できます。また、ユーザが実行時にポップアップ メ
ニューからこのプロパティの有効化と無効化を行うこともできます。
解説
ペインタの場合
InputFieldNamesVisible プロパティは、リッチテキスト エディット コン
トロールの設計時には設定できません。
スクリプトの場合
InputFieldNamesVisible プロパティの値はブール値です。次の例では、
入力フィールドにフィールド名ではなくデータを表示するよう設定し
ます。
rte_1.InputFieldNamesVisible = FALSE
InputFieldsVisible
対象
リッチテキスト エディット コントロール
機能
InputFieldVisible プロパティが有効な場合、リッチテキスト エディット
コントロールに入力フィールドが表示されます。
解説
ペインタの場合
❖
入力フィールドを表示する
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、[入力フィールドの表示]チェックボックスをオンにします。
スクリプトの場合
InputFieldsVisible プロパティの値はブール値です。次の例では、リッチ
テキスト エディット コントロールで入力フィールドが表示されるよ
うに指定します。
rte_1.InputFieldsVisible = TRUE
オブジェクトとコントロール
465
InsertAsText
InsertAsText
対象
インクエディット コントロール
機能
インクをテキストとして挿入するか、インクとして挿入するかを指定
します。
解説
ペインタの場合
❖
インクエディット コントロールに追加されるインクがテキストに変換されな
いように指定する
•
プロパティ ビューの[インク]ページで、[テキストとして挿入]
チェックボックスをオフにします。
スクリプトの場合
InsertAsText プロパティの値は boolean 値です。デフォルトでは、短い
中断の後にインクはテキストに変換されます。インクをテキストに変
換するかわりに、コントロールにインクとして表示されるようにした
い場合は、InsertAsText プロパティの値を false に設定します。
ie_1.InsertAsText = FALSE
Invert
対象
ピクチャ コントロールとピクチャ ハイパーリンク コントロール
機能
Invert プロパティが有効な場合、ピクチャの色が反転して表示されま
す。このプロパティが有効でない場合は、通常の色で表示されます。
解説
ペインタの場合
❖
ピクチャ コントロールの色を反転する
•
コントロールの[プロパティ]ページの[全般]ページで、
[反転]
チェックボックスをオンにします。
スクリプトの場合
Invert プロパティの値はブール値です。次の例では、ピクチャ コント
ロール p_1 を通常の色で表示するように指定します。
p_1.Invert = FALSE
466
PowerBuilder
第3章
プロパティの説明と使用法
Italic
対象
テキストを表示するコントロール
機能
Italic は、コントロール内のテキストのプロパティです。
解説
ペインタの場合
❖
•
コントロール内のすべてのテキスト項目を斜体にする
コントロールのプロパティ ビューの[フォント]タブ ページで、
[斜体]チェックボックスをオンにするか、コントロールを選択し
てから、スタイルバーの[I]ボタンをクリックします。
❖
グラフ コントロール内のテキスト オブジェクトを斜体にする
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示します。
2 [テキスト オブジェクト]リストボックスからテキスト オブジェ
クトを選択します。
3 [斜体]チェックボックスをオンにします。
スクリプトの場合
Italic プロパティの値はブール値です。次の例では、スタティック テキ
スト コントロールのテキストを斜体にします。
st_1.Italic = TRUE
この例では、グラフ コントロールの値軸のラベルを斜体にします。
gr_1.Values.LabelDispAttr.Italic = TRUE
Item[ ]
対象
リストビュー コントロール、リストボックス コントロール、ピクチャ
リストボックス コントロール、ドロップダウン リストボックス コン
トロール、ドロップダウン ピクチャ リストボックス コントロール、
ツールバー コントロール
機能
Item プロパティ配列は、コントロール内の項目を指定します。この配
列は、初期化後に更新されません。
オブジェクトとコントロール
467
ItemPictureIndex[ ]
解説
ペインタの場合
❖
コントロールに項目を追加する
•
コントロールのプロパティ ビューの[項目]タブ ページに、項目
を入力します。
スクリプトの場合
Item[] プロパティは文字列の配列ですが、初期化後に更新されません。
AddItem または適切な InsertItem 関数をかわりに使用してください。
ItemPictureIndex[ ]
対象
ピクチャ リストボックス コントロール、ドロップダブン ピクチャ リ
ストボックス コンロトール、リストビュー コントロール
機能
ItemPictureIndex プロパティ配列は、コントロール内の項目に関連する
ピクチャを指定します。この配列は、初期化後に更新されません。
解説
ペインタの場合
❖
リスト項目にピクチャを関連付けるには
1
コントロールのプロパティ ビューで、コントロールで使用するピ
クチャを[ピクチャ名]リストに追加します。
リストビュー コントロールでは、
[大きいピクチャ]、
[小さいピク
チャ]、[状態]タブ ページの[ピクチャ名]リストにピクチャを
追加します。
2
プロパティ ビューの[項目]タブ ページを表示して、[項目]リ
ストにテキストを追加します。
3 [ピクチャ インデックス]リストの、ピクチャを関連付ける項目に
対応する行に、
([ピクチャ名]リストからの)ピクチャのインデッ
クス番号を追加します。
スクリプトの場合
AddPicture 関数でコントロールにピクチャを追加し、AddItem または
InsertItem 関数でそれらのコントロールに項目を追加します。AddItem 関
数または InsertItem 関数のピクチャ インデックスを使ってピクチャを
項目に関連付けます。詳細については、
『アプリケーション テクニッ
ク』マニュアルの「ウィンドウでのリストの使い方」を参照してくだ
さい。
468
PowerBuilder
第3章
プロパティの説明と使用法
Label
対象
グラフ コントロール内の grAxis オブジェクト、ListViewItem オブジェ
クト、TreeViewItem オブジェクト
機能
グラフ内の場合
す。
Label プロパティは、グラフの軸のラベルを指定しま
リストビュー コントロールとツリービュー コントロール内の場合
Label プロパティは、ListViewItem または TreeViewItem オブジェクトに
関連付けるラベルを指定します。ペインタの中では、ツリービュー コ
ントロール内の項目を操作できません。ツリービューに項目を追加す
るにはスクリプトを記述する必要があります。
解説
ペインタの場合
❖
グラフ コントロールに軸ラベルを指定する
1
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示します。
2 [軸]ドロップダウン リストから軸を選択します。
3 [ラベル]テキスト フィールドに、ラベル テキストを入力します。
❖
リストビュー コントロールの項目のラベルを指定する
1
リストビュー コントロールのプロパティ ビューの[項目]タブ
ページを表示します。
2
項目ごとに、対応する[テキスト]フィールドにラベル テキスト
を入力します。
スクリプトの場合
Label プロパティの値は文字列です。次の例では、グラフ gr_1 の値軸
のラベルにテキストを設定します。
gr_1.Values.Label = 'Lawsuits per 1000'
リストビュー コントロールにラベル付きの項目を追加または挿入す
るには、AddItem または InsertItem 関数を使用します。たとえば、次の
行はリストビュー コントロール 1v_1 に項目を追加し、その項目にラベ
ルとピクチャを指定します。
lv_1.AddItem ( “Oranges”, 1)
ラベルを変更するには、リストビューから項目を取得し、その項目の
Label プロパティを設定します。
ListViewItem lvi
lv_1.GetItem(4, lvi)
オブジェクトとコントロール
469
Label
lvi.Label = "Apples"
lv_1.SetItem(4, lvi)
ツ リ ー ビ ュ ー コ ン ト ロ ー ル に 項 目 を 追 加 ま た は 挿 入 す る に は、
InsertItem、InsertItemFirst、InsertItemLast、InsertItemSort 関数を使用します。
詳細については、
『アプリケーション テクニック』マニュアルの「ツ
リービュー コントロールの使い方」および「リストビュー コントロー
ルの使い方」を参照してください。
470
PowerBuilder
第3章
プロパティの説明と使用法
LabelWrap
対象
リストビュー コントロール
機能
LabelWrap プロパティが有効な場合、リストビュー項目の長いラベル
は大きいアイコン ビューでは折り返されます。LabelWrap が有効でな
い場合は、ラベルは 1 行に表示されます。LabelWrap プロパティは、詳
細ビュー、一覧ビュー、または小さいアイコン ビューに対しては適用
されません。
解説
ペインタの場合
❖
リストビュー コントロールのラベルのワードラップを指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[ラベルの
折り返し]チェックボックスをオンにします。
スクリプトの場合
LabelWrap プロパティの値はブール値です。次の例では、リストビュー
内のラベルのワードラップを指定します。
lv_1.LabelWrap = TRUE
LargePictureName[ ]
対象
リストビュー コントロール
機能
PowerBuilder では、リストビュー画像はいくつかの画像のインデック
ス付き配列に格納されます。ペインタでリストビューを作成するとき、
または実行時に AddItem および InsertItem 関数を使用するときに、画像
を特定のリストビュー項目に関連付けることができます。
特定の画像はインデックス番号で識別します。選択したビューによっ
ては、項目の大きいピクチャと小さいピクチャに同一のインデックス
番号が使用されるため、配列の各位置の画像に互換性があるかどうか
を確認する必要があります。使用される画像のタイプは、コントロー
ルの View プロパティの値によって決まります。
解説
ペインタの場合
❖
大きいアイコン ビューの画像を指定する
1
リストビュー コントロールのプロパティ ビューの[大きいピク
チャ]タブ ページを表示します。
オブジェクトとコントロール
471
LargePictureWidth
2
次のいずれかの操作を実行します。
• [大きいピクチャ名]フィールドの所定の行に、ピクチャを含
むファイルの完全なパスとファイル名を入力します。
• [...]ボタンを使用します。
•
リストボックスから 1 つまたは複数のピクチャを選択します。
ここで指定するピクチャ名の順序は、小さいアイコン ビューで使
用されるピクチャ名の順序と一致する必要があります。
3 [大きいピクチャ名]リストの行番号を使用して、
[項目]タブ ペー
ジの各リストビュー項目に対するピクチャのインデックスを指定
します。
スクリプトの場合
LargePictureName プロパティの値は文字列です。実行中に
LargePictureName プロパティを使って画像リストを更新することはで
きません。AddLargePicture 関数を使ってリストビュー コントロールに
大きいピクチャを追加します。その例を次に示します。
lv_1.AddLargePicture(“c:\ArtGal\bmps\celtic.bmp”)
リストビュー コントロールに大きいピクチャを追加すると、そのピク
チャにはリストビュー内で再利用可能なピクチャ インデックスが与
えられます。
リストビュー コントロールのスクリプトについての詳細は、
『アプリ
ケーション テクニック』マニュアルの「リストビュー コントロールの
使い方」を参照してください。
LargePictureWidth
対象
リストビュー コントロール
機能
LargePictureWidth プロパティは、リストビュー コントロールの大きい
アイコン ビュー内のすべてのピクチャの表示幅を指定します。サイズ
はピクセル単位で指定します。
ペインタで値「デフォルト」を選択した場合、または値を 0 に設定し
た場合は、すべてのピクチャの幅として、配列内の先頭のピクチャの
幅が使用されます。ペインタでこのほかに選択できる値は「16」と
「32」で、これらの値はアイコンの標準的な幅のピクセル数です。
472
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
大きいピクチャの幅を設定する
•
コントロールのプロパティ ビューの[大きいピクチャ]タブ ペー
ジで、
[大きいピクチャの幅]ドロップダウン リストから値を選択
します。
スクリプトの場合
LargePictureWidth プロパティの値は整数値です。この値は、
AddLargePicture 関数への最初の呼び出しの前か、DeleteLargePictures 関
数の呼び出しの後にのみ設定できます。この値を 0 に設定すると、大
きいピクチャのサイズとして最初のピクチャのサイズが使用されます。
次の例では、リストビュー内の大きいピクチャの幅を 32 ピクセルに設
定します。
lv_1.LargePictureWidth = 32
リストビュー コントロールのスクリプトについての詳細は、『アプリ
ケーション テクニック』マニュアルの「リストビュー コントロールの
使い方」を参照してください。
LargePictureHeight
対象
リストビュー コントロール
機能
LargePictureHeight プロパティは、リストビュー コントロールの大きい
アイコン ビュー内のすべてのピクチャの表示の高さを指定します。サ
イズはピクセル単位で指定します。
ペインタで値「デフォルト」を選択した場合、または値を 0 に設定し
た場合は、すべてのピクチャの高さとして、配列内の先頭のピクチャ
の高さが使用されます。ペインタでこのほかに選択できる値は「16」
と「32」で、これらの値はアイコンの標準的な高さのピクセル数です。
解説
ペインタの場合
❖
大きいピクチャの高さを設定する
•
コントロールのプロパティ ビューの[大きいピクチャ]タブ ペー
ジで、
[大きいピクチャの高さ]ドロップダウン リストから値を選
択します。
オブジェクトとコントロール
473
LargePictureMaskColor
スクリプトの場合
LargePictureHeight プロパティの値は整数値です。この値は、
AddLargePicture 関数への最初の呼び出しの前か、DeleteLargePictures 関
数の呼び出しの後にのみ設定できます。この値を 0 に設定すると、大
きいピクチャのサイズとして最初のピクチャのサイズが使用されます。
次の例では、リストビュー内の大きいピクチャの高さを 32 ピクセルに
設定します。
lv_1.LargePictureHeight = 32
リストビュー コントロールのスクリプトについての詳細は、
『アプリ
ケーション テクニック』マニュアルの「リストビュー コントロールの
使い方」を参照してください。
LargePictureMaskColor
対象
リストビュー コントロール
機能
マスクの色は、ピクチャが表示されるときに透過になる、ピクチャ内
の色です。
新しく追加するユーザ定義のビットマップにマスクする色を選択しま
す。スクリプトでは、各ピクチャを追加する前にマスクの色を変更で
きます。各画像では、その画像が追加された時点で有効だったマスク
の色が使用されます。
解説
ペインタの場合
❖
ピクチャのマスクの色を指定する
•
コントロールのプロパティ ビューの[大きいピクチャ]タブ ペー
ジで、
[大きいピクチャのマスク色]ドロップダウン リストから色
を選択します。
色のドロップダウン リストに独自の色を追加するには、プロパティ
ビューを表示する前に[デザイン|色の指定]を選択します。
スクリプトの場合
LargePictureMaskColor プロパティの値は、背景色の数値を指定する
long 型の値(-2 から 16,777,215)です。このプロパティは、各ビット
マップを追加するときに使用されるため、複数の AddLargePicture の呼
び出しの間に変更できます。
474
PowerBuilder
第3章
プロパティの説明と使用法
LargePictureMaskColor の値は、色の赤、緑、青(RGB)の 3 要素の値
の組み合わせです。目的の色の long 型の値がわからない場合には、
[デ
ザイン|色の指定]を選択して RGB 値を判別してから、スクリプトで
RGB 関数を呼び出して色を指定します。
次の例では、リストビュー内のユーザ定義のビットマップのマスクの
色として黄色を設定します。
lv_1.LargePictureMaskColor = RGB(255, 255, 0)
LayoutRTL
対象
リストビュー コントロール、ツリービュー コントロール
機能
LayoutRTL プロパティでは、標準レイアウトのミラー イメージとなる
コントロールのレイアウトを指定します。スクロールバーはコント
ロールの左側に表示されます。リストビューでは、アイコンは右寄せ
です。ツリービューでは、ルートレベルのアイコンは右寄せで、ラベ
ルはアイコンの左側に表示されます。下位レベルは右からインデント
されます。文字表示に影響する RightToLeft プロパティとは異なり、
LayoutRTL プロパティは右から左への表示をサポートするオペレー
ティング システムは不要です。値は以下のとおりです。
•
TRUE — コントロール内の要素を右寄せにします。
•
FALSE — コントロール内の要素を左寄せにします(デフォルト)
。
良い結果を得るためには、このプロパティの効果を確認することがで
きるようにペインタで設定します。このプロパティを実行時に設定す
ると予期せぬ結果となります。
解説
ペインタの場合
❖
•
LayoutRTL プロパティを設定する
コントロールのプロパティ ビューの[その他]タブ ページにある
[RTL レイアウト]チェックボックスをオンにします。
スクリプトの場合
LayoutRTL プロパティの値はブール値です。
次の行では、リストビュー コントロールの LayoutRTL プロパティを
TRUE に設定します。
lv_1.LayoutRTL = TRUE
オブジェクトとコントロール
475
LeftMargin
次の行では、ツリービュー コントロールの LayoutRTL プロパティの値
を調べます。
boolean bRTL
bRTL = tv_1.LayoutRTL
LeftMargin
対象
リッチテキスト エディット コントロール
機能
LeftMargin プロパティは、印刷ページの左余白のサイズをインチ単位
で指定します。
解説
ペインタの場合
❖
左余白を設定する
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、
[左余白]フィールドにインチ単位でサイズを入力します。
スクリプトの場合
LeftMargin プロパティの値は long 型です。次の例では、リッチテキス
ト エディットの左余白を 1 インチに設定します。
rte_1.LeftMargin = 1
LeftText
対象
チェックボックス コントロール、ラジオボタン コントロール
機能
LeftText プロパティが有効な場合、チェックボックスまたはラジオボ
タンのテキストはボタンの左側に表示されます。LeftText が有効でな
い場合は、テキストはコントロールの右側に表示されます。左右の位置
揃えは、スタイルバーの左ボタンと右ボタンを使っても指定できます。
使用上の注意
LeftText プロパティが有効なときに複数のチェックボックスまたはラジ
オボタンに左揃えを指定すると、テキストは左揃えになりますが、ボッ
クスまたはボタンは左揃えにはなりません。この理由は、PowerBuilder
では完全なコントロールが位置揃え設定の対象になるためです。
476
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
テキストを左側に表示する
•
コントロールのプロパティ ビューの[全般]ページで、
[テキスト
を左に表示]チェックボックスをオンにします。
スクリプトの場合
LeftText プロパティの値はブール値です。次の例では、チェックボッ
クスのテキストをボックスの左側に設定します。
cbx_1.LeftText = TRUE
Legend
対象
グラフ コントロール
機能
Legend プロパティの値は、グラフの凡例の有無と位置を指定します。
解説
ペインタの場合
❖
凡例の位置を設定する
•
コントロールのプロパティ ビューの[全般]タブ ページで、[凡
例]ドロップダウン リストから位置を選択します。
スクリプトの場合
Legend プロパティのデータ型は、grLegendType カタログ データ型で
す。次の例では、凡例の位置をグラフの下に設定します。
gr_1.Legend = AtBottom!
Limit
対象
ドロップダウン リストボックス コントロール、ドロップダウン ピク
チャ リストボックス コントロール、エディットマスク コントロール、
インクエディット コントロール、マルチライン エディット コントロー
ル、シングルライン エディット コントロール
機能
Limit プロパティは、ユーザがコントロールに入力できる文字の数を制
限します。
オブジェクトとコントロール
477
LineColor
解説
ペインタの場合
❖
入力可能な最大文字数を設定する
•
コントロールのプロパティ ビューで[全般]ページの[最大値]
フィールドに、ユーザが入力できる文字数を入力します。
0 を設定すると、文字数は無制限になります。
スクリプトの場合
Limit プロパティの値は整数値です。
次の例では、マルチライン エディット mle_1 の最大文字数を 256 に設
定します。
mle_1.Limit = 256
LineColor
対象
直線コントロール、楕円コントロール、長方形コントロール、丸長方
形コントロール
機能
線色は、枠線とコントロールの塗りつぶしパターンの線の色です。
解説
ペインタの場合
❖
線色を変更する
•
コントロールのプロパティ ビューの[全般]ページで、[線の色]
ドロップダウン リストから色を選択するか、スタイルバーの[前
景色]オプションから色を選択します。
スタイルバーを使うと、選択した複数のオブジェクトの線色を同時に
変更できます。色のドロップダウン リストに独自の色を追加する場合
は、プロパティ ビューを開く前に[デザイン|色の指定]を選択しま
す。
スクリプトの場合
LineColor プロパティの値は long 型です。目的の色の long 型の値がわ
からない場合には、[デザイン|色の指定]を選択して RGB 値を判別
してから、スクリプトで RGB 関数を呼び出して色を指定します。
次の例では、長方形の線色として赤を設定します。
r_1.LineColor = RGB(255,0,0)
478
PowerBuilder
第3章
プロパティの説明と使用法
LinesAtRoot
対象
ツリービュー コントロール
機能
LinesAtRoot が有効な場合、ツリービュー内のすべてのルート項目が線
でつながれます。
解説
ペインタの場合
❖
ツリービュー内のルート項目が線でつながれるよう指定する
•
コントロールの[プロパティ]ページの[全般]ページで、
[ルー
ト項目ラインの表示]チェックボックスをオンにします。
スクリプトの場合
LinesAtRoot プロパティの値はブール値です。
次の例では、ツリービュー内のすべてのルート項目が線でつながれる
ように指定します。
tv_1.LinesAtRoot = TRUE
LinesPerPage
対象
ユーザ オブジェクトとウィンドウ
機能
LinesPerPage プロパティは、スクロールに使用する目的で 1 ページの
行数を定義します。PowerBuilder では、UnitsPerLine と LinesPerPage を
乗算して、ユーザがスクロールバーをクリックしたときにウィンドウ
を垂直スクロールする PowerBuilder 単位系の数を決定します。
LinesPerPage と UnitsPerLine の計算については、581 ページの「ウィン
ドウおよびユーザ オブジェクト内でのスクロール」を参照してくださ
い。
ウィンドウまたはユーザ オブジェクトの水平スクロールバーをコン
トロールするには、UnitsPerColumn プロパティと ColumnsPerPage プロ
パティを使用します。
解説
ペインタの場合
❖
•
オブジェクトとコントロール
LinesPerPage プロパティを設定する
ウィンドウのプロパティ ビューの[スクロール]タブ ページで、
[1 ページの行数]オプションに目的の数(1 ~ 100)を入力します。
479
LineStyle
スクリプトの場合
LinesPerPage プロパティの値は、1 から 100 の間の整数値です。次の例
では、ウィンドウの LinesPerPage を 20 に設定します。
This.LinesPerPage = 20
LineStyle
対象
直線コントロール、楕円コントロール、長方形コントロール、丸長方
形コントロール
機能
LineStyle プロパティは、直線オブジェクトまたはほかの描画オブジェ
クトの周囲の枠線の外観を指定します。
解説
ペインタの場合
❖
線種を設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[線の種類]
ドロップダウン リストから線種を選択します。
スクリプトの場合
LineStyle プロパティのデータ型は、LineStyle カタログ データ型です。
次の例では、長方形に破線を設定します。
r_1.LineStyle = Dash!
LinkUpdateOptions
対象
OLE コントロール
機能
LinkUpdateOptions プロパティは、OLE コントロール内のリンクされた
オブジェクトの更新方法を指定します。自動と手動の 2 つの選択肢が
あります。自動を選択すると、オブジェクトが開かれたときと、サー
バ アプリケーション内でそのオブジェクトが変更されるたびに、リン
クが更新されます。手動を選択すると、リンクは更新されません。
480
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
Link Update オプションを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[リンクの
更新オプション]ドロップダウン リストから「自動」または「手
動」を選択します。
スクリプトの場合
LinkUpdateOptions プロパティのデータ型は、omLinkUpdateOptions カタ
ログ データ型です。
次の例では、OLE コントロールの更新オプションを自動に設定します。
ole_1.LinkUpdateOptions = LinkUpdateAutomatic!
LiveScroll
対象
データウィンドウ コントロール
機能
LiveScroll プロパティが有効な場合、データウィンドウ コントロール
内の行は、ユーザがスクロールボックスを動かしている間スクロール
します。このプロパティが有効でないときは、行はユーザがスクロー
ルボックスを放すまでスクロールしません。
解説
ペインタの場合
❖
データウィンドウ コントロールの LiveScroll を有効にする
•
コントロールのプロパティ ビューの[全般]ページで、
[つまみと
連動してスクロール]チェックボックスをオンにします。
スクリプトの場合
LiveScroll プロパティの値はブール値です。
次の例では、データウィンドウ コントロールでユーザがスクロール
ボックスを動かしている間に、行がスクロールするよう設定します。
This.LiveScroll = TRUE
オブジェクトとコントロール
481
MajorGridLine
MajorGridLine
対象
グラフ コントロールの grAxis オブジェクト
機能
軸の主グリッドは、軸の目盛りからグラフのデータ領域全体に引かれ
ます。副グリッド線は目盛りと目盛りの間を通り、区分数が 2 以上の
場合に表示されます。
MajorGridLine プロパティは、主グリッドの線種を指定します。
解説
ペインタの場合
❖
主グリッド線の線種を設定する
1
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示して、[軸]ドロップダウン リストから軸を選択します。
2 [大区分]グループの[大区分グリッド線]ドロップダウン リスト
から線種を選択します。
スクリプトの場合
MajorGridLine プロパティのデータ型は、LineStyle カタログ データ型
です。
この例では、グラフ gr_1 の値軸の主グリッド線に破線を指定します。
gr_1.Value.MajorGridLine = Dash!
MajorDivisions
対象
グラフ コントロールの grAxis オブジェクト
機能
MajorDivisions プロパティは、軸上の、原点を除いた区分数または目盛
り数を指定します。
デフォルト値 0 は、グラフで使用されるデータ用に最適化された
MajorDivision 値が使用され、MinorDivision の目盛り数が省略されるこ
とを意味します。
解説
ペインタの場合
❖
軸上の大区分数を指定する
1
グラフのプロパティ ビューの[軸]タブ ページを表示して、
[軸]
ドロップダウン リストから軸を選択します。
2 [大区分]グループの[大区分]フィールド内のスピン コントロー
ルを使用して、区分数を指定します。
482
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
MajorDivisions プロパティは、軸上の主区分の数を指定する整数をとり
ます。
次の例では、グラフの値軸の主グリッド上に 10 個の目盛りを設定しま
す。
gr_1.Values.MajorDivisions = 10
MajorTic
対象
グラフ コントロールの grAxis オブジェクト
機能
MajorTic プロパティには、目盛りが主グリッドの軸にどのように重な
るかを指定します。目盛りは、軸線の内側、外側、または軸線をまた
ぐ位置に配置できます。また、目盛りを表示しないこともできます。
解説
ペインタの場合
❖
1
主目盛りの種類を指定する
コントロールのプロパティ ビューの[軸]タブ ページを表示して、
[軸]ドロップダウン リストから軸を選択します。
2 [大区分]グループの[大区分目盛刻み]ドロップダウン リストか
ら目盛りの種類を選択します。
スクリプトの場合
MajorTic プロパティの値は、grTicType カタログ データ型です。
次の行では、主グリッドの目盛りがグリッドにまたがるように設定し
ます。
gr_1.Values.MajorTic = Straddle!
オブジェクトとコントロール
483
Map3DColors
Map3DColors
対象
ピクチャ コントロール、ピクチャ ハイパーリンク コントロール、ピ
クチャボタン コントロール
機能
コントロールに関連付けられているビットマップの中のグレー系の色
(たとえばシルバーなど)を、Windows コントロール パネルに設定さ
れているボタンのハイライト、ボタンの表面、またはボタンの影の色
にマッピングします。このプロパティが FALSE(デフォルト)の場合、
ビットマップに定義されている PowerBuilder のボタンの標準色がコン
トロールに使用されます。
3D 効果の 3D オブジェクトをウィンドウの背景に使用している場合、
ピクチャが含まれているコントロールをウィンドウ上に配置して、そ
のピクチャをウィンドウの背景色に調和させるには、この機能を使用
し ま す。こ の 機 能 を 使 用 し た 場 合、コ ン ト ロ ー ル の ピ ク チ ャ は、
Windows コントロール パネルの画面のプロパティ ダイアログボック
スの[デザイン]ページで選択されている 3D の色になります。
ウィンドウの背景色は、3D オブジェクトに設定する必要があります。
画像をウィンドウに調和させるには、背景色を RGB(160,160,160) と
RGB(223,223,223) の範囲内(たとえばシルバーなど)にします。ボタ
ンのハイライトの色には明るいグレーの影を、ボタンの影の色には暗
い影をマッピングします。
このオプションは、ビットマップ内で使用されているほかの色にも影
響を与える可能性があります。コントロールの枠線の設定には影響は
ありません。また、コントロールに関連付けられている画像がない場
合は何の影響もありません。
解説
ペインタの場合
❖
3DColor マッピングの設定 :
•
コントロールのプロパティ ビューの[全般]ページで、
[3D カラー
を使用]チェックボックスをオンにします。
スクリプトの場合
Map3DColors プロパティの値はブール値です。次の例では、ピクチャ
ボタン用に 3D の色のマッピングを設定します。
pb_1.Map3DColors = TRUE
484
PowerBuilder
第3章
プロパティの説明と使用法
Mask
対象
エディットマスク コントロール
機能
Mask プロパティは、ユーザがコントロール内に入力できる文字および
文字の書式指定を制御します。マスクを定義するには、MaskDataType
プロパティで定義したマスク型に応じて、特殊文字を使用する必要が
あります。
PowerBuilder では、次の 4 種類の表示書式をサポートします。
•
Numbers
•
Strings
•
Dates
•
Times
書式用の特殊な意味のない文字は、ユーザが入力したとおりにエ
ディットマスク コントロールに表示されます。
それぞれの表示書式の使い方についての詳細は、第 4 章「表示書式と
スクロールについて」を参照してください。表示書式の定義について
の詳細は、PowerBuilder の『ユーザーズ ガイド』マニュアルを参照し
てください。
解説
ペインタの場合
❖
エディット マスクを指定する
1
コントロールのプロパティ ビューの[マスク]タブ ページを表示
します。
2 [マスク データ型]ドロップダウン リストからマスク データ型を
選択します。
3 [マスク]フィールドにマスク文字を入力するか、
[マスク]フィー
ルドの端の右矢印をクリックして、ポップアップ メニューに表示
されたマスク文字例から 1 つまたは複数を選択します。
ポップアップ メニューの例は、[マスク データ型]リストで選択
したマスクのデータ型に応じて変わります。
スクリプトの場合
Mask プロパティの値は文字列です。Mask プロパティでは、マスクの
値は取得できますが、設定はできません。
次の例では、SetMask 関数でマスクのデータ型と文字列書式を設定し、
次に Mask プロパティで文字列書式の値を取得します。
オブジェクトとコントロール
485
MaskDataType
string ls_mask
em_1.SetMask(StringMask!, '@@@,@@')
ls_mask = em_1.Mask
MaskDataType
対象
エディットマスク コントロール
機能
このプロパティは、コントロールのデータ型を指定します。マスクの
定義に使用される特殊文字は、マスク コントロールのデータ型によっ
て異なります。
解説
ペインタの場合
❖
マスクのデータ型を選択する
• [マスク]タブの[マスク データ]ドロップダウン リストボック
スから型を選択します。
[マスク]フィールドに表示される特殊文字の例は、選択したマス
クのデータ型に関連する文字を表示するために変更されます。
スクリプトの場合
MaskDataType プロパティの値は、MaskDataType カタログ データ型で
す。MaskDataType プロパティでは、マスクのデータ型は取得できます
が、設定はできません。
次の例では、SetMask 関数でマスクのデータ型と日付書式を設定し、次
に MaskDataType プロパティで日付書式の値を取得します。
MaskDataType l_mdt
em_1.SetMask(DateMask!, 'mm/dd/yy')
l_mdt = em_1.MaskDataType
486
PowerBuilder
第3章
プロパティの説明と使用法
MaxBox
対象
データウィンドウ コントロール、ウィンドウ
機能
MaxBox プロパティには、コントロールのタイトル バーに[最大化]
ボックスが表示されるかどうかを指定します。
解説
ペインタの場合
❖
データウィンドウ コントロールに[最大化]ボックスを表示する
1
コントロールのプロパティ ビューの[全般]ページで、
[タイトル
バー]チェックボックスをオンにします。
2 [全般]ページの[最大化ボタン]チェックボックスをオンにしま
す。
❖
ウィンドウに[最大化]ボックスを表示する
• [最大化ボタン]チェックボックスがグレー表示されている場合
は、ウィンドウのプロパティ ビューの[全般]ページで、
[タイト
ル バー]チェックボックスをオンにして、次に[最大化ボタン]
チェックボックスをオンにします。
一部の種類のウィンドウでは、デフォルトでタイトル バーが表示
されないため、
[タイトル バー]チェックボックスをオンにしない
と[最大化ボタン]チェックボックスを使用できない場合があり
ます。
スクリプトの場合
MaxBox プロパティの値はブール値です。
次の例では、データウィンドウ コントロールに、[最大化]ボックス
付きのタイトル バーが表示されるように指定します。
dw_1.TitleBar = TRUE
dw_1.MaxBox = TRUE
MaximumValue
対象
グラフ コントロールの grAxis オブジェクト
機能
MaximumValue プロパティは、軸のデータ型が Numeric 型である場合
の軸の最大値を指定します。このプロパティは、Autoscale プロパティ
が有効な場合は使用されません。
オブジェクトとコントロール
487
MaxPosition
解説
ペインタの場合
❖
数値データ型の軸の最大値を設定する
1
グラフのプロパティ ビューの[軸]タブ ページを表示して、
[軸]
ドロップダウン リストから軸を選択します。
2 [自動目盛]チェックボックスがオフになっていることを確認しま
す。
3 [データ型]ドロップダウン リストから「adtDouble!」を選択します。
4 [最大値]フィールドに最大値を指定します。
この値は、グラフ化されるデータの最大値より大きい値にする必
要があります。
スクリプトの場合
MaximumValue プロパティの値は、double 型です。
次の行では、軸の最大値を double 型のデータで設定します。
gr_1.Values.DataType = AdtDouble!
gr_1.Values.MaximumValue = 500000.00
MaxPosition
対象
水平プログレスバー コントロール、垂直プログレスバー コントロー
ル、水平スクロールバー コントロール、垂直スクロールバー コント
ロール、水平トラックバー コントロール、垂直トラックバー コント
ロール
機能
MaxPosition プロパティには、プログレス インジケータ、スクロール
ボックス、あるいはスライダが垂直コントロールの下部または水平ス
クロールバーの右端にあるときの Position プロパティの値を指定しま
す。プログレスバーのこの値は、SetRange 関数で設定されるコント
ロールの範囲の最後と異なることがあります。
解説
ペインタの場合
488
❖
プログレス インジケータ、スクロール ボックス、あるいはスライダの最大
位置を指定する
•
コントロールのプロパティ ビューの[全般]タブで、[最大位置]
フィールドに整数値を入力します。
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
MaxPosition プロパティの値は、整数値です。
次の例では、スクロール ボックスが最大位置にあるときの Position プ
ロパティの値を 120 に指定します。
vsb_1.MaxPosition = 120
MaxSelectCount
対象
月表示カレンダ コントロール
機能
ユーザがカレンダで選択できる最大日数を指定します。
解説
ペインタの場合
❖
MaxSelectCount プロパティを設定する
•
プロパティ ビューの[全般]ページで、
[最大の選択可能日数]ス
ピン コントロールから数を選択します。
スクリプトの場合
MaxSelectCount プロパティの値は、1 から 360 の間の整数値です。デ
フォルトは 31 です。ユーザがカレンダで選択できる最大日数を 31 日
より多くまたは少なくするには、この値を変更します。別の制限を設
定する場合は SetSelectedRange 関数を呼び出す前に変更します。次の
例では、MaxSelectCount の値を 7 に設定します。
mc_1.MaxSelectCount = 7
MaxValDateTime
対象
グラフ コントロールの grAxis オブジェクト
機能
MaxValDateTime プロパティには、軸のデータ型が Date 型または Time
型である場合の軸の最大値を指定します。このプロパティは、Autoscale
プロパティが有効な場合は使用されません。
オブジェクトとコントロール
489
MenuName
解説
ペインタの場合
❖
日付または時刻データ型の軸の最大値を設定する
1
グラフのプロパティ ビューの[軸]タブ ページを表示して、
[軸]
ドロップダウン リストから軸を選択します。
2 [自動目盛]チェックボックスがオフになっていることを確認しま
す。
3 [データ型]ドロップダウン リストから「adtDate!」、
「adtTime!」、
または「adtDateTime!」を選択します。
4 [最大値]フィールドに日付または時刻の最大値を指定します。
この値は、グラフ化されるデータの最大値より大きい値にする必
要があります。
スクリプトの場合
MaxValDateTime プロパティの値は、DateTime 型です。
次の例では、軸の MaxValDateTime プロパティを Date 型のデータで設
定します。
gr_1.Values.DataType = AdtDate!
gr_1.Values.MaxValDateTime = 12/31/1999
MenuName
対象
ウィンドウ
機能
MenuName プロパティには、ウィンドウのメニューとなるメニュー オ
ブジェクトを指定します。
解説
ペインタの場合
490
❖
メニューを指定する
•
ウィンドウのプロパティ ビューの[全般]ページで、
[メニュー名]
フィールドにメニュー名を入力するか、[...]ボタンを使用して、
現行または別の PBL からメニュー オブジェクトを選択します。
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
MenuName プロパティは、メニュー オブジェクトの名前を含む文字列
をとります。この文字列は、PowerBuilder で内部的にメニューを識別
するのに使われます。このプロパティはスクリプトで変更しないでく
ださい。そのかわりに、ChangeMenu 関数か PopMenu 関数を使用して
メニューを表示します。
オブジェクトとコントロール
491
MinBox
MinBox
対象
データウィンドウ コントロール、ウィンドウ
機能
MinBox プロパティには、コントロールのタイトル バーに[最小化]
ボックスが表示されるかどうかを指定します。
解説
ペインタの場合
❖
データウィンドウ コントロールに[最小化]ボックスを表示する
1
コントロールのプロパティ ビューの[全般]ページで、
[タイトル
バー]チェックボックスをオンにします。
2 [全般]ページの[最小化ボタン]チェックボックスをオンにしま
す。
❖
ウィンドウに[最小化]ボックスを表示する
• [最小化ボタン]チェックボックスがグレー表示されている場合
は、ウィンドウのプロパティ ビューの[全般]ページで、
[タイト
ル バー]チェックボックスをオンにして、次に[最小化ボタン]
チェックボックスをオンにします。
一部の種類のウィンドウでは、デフォルトでタイトル バーが表示
されないため、
[タイトル バー]チェックボックスをオンにしない
と[最小化ボタン]チェックボックスを使用できない場合があり
ます。
スクリプトの場合
MinBox プロパティの値はブール値です。
次の例では、データウィンドウ コントロールに、[最小化]ボックス
付きのタイトル バーが表示されるように指定します。
dw_1.TitleBar = TRUE
dw_1.MinBox = TRUE
492
PowerBuilder
第3章
プロパティの説明と使用法
MinimumValue
対象
グラフ コントロールの grAxis オブジェクト
機能
MinimumValue プロパティには、軸のデータ型が数値型である場合の軸
の最小値を指定します。このプロパティは、Autoscale プロパティが有
効な場合は使用されません。
解説
ペインタの場合
❖
数値データ型の軸の最小値を設定する
1
グラフのプロパティ ビューの[軸]タブ ページを表示して、
[軸]
ドロップダウン リストから軸を選択します。
2 [自動目盛]チェックボックスがオフになっていることを確認しま
す。
3 [データ型]ドロップダウン リストから「adtDouble!」を選択します。
4 [最小値]フィールドに最小値を指定します。
この値は、グラフ化されるデータの最小値より小さい値にする必
要があります。
スクリプトの場合
MinimumValue プロパティの値は、double 型です。
次の行では、軸の最小値を double 型のデータで設定します。
gr_1.Values.DataType = AdtDouble!
gr_1.Values.MinimumValue = 0.00
MinMax
対象
エディットマスク コントロール
機能
MinMax プロパティの値では、エディットマスクがスピン コントロー
ルとして機能するときに使用可能な最小値と最大値を指定します。
最小値と最大値は、Date 型と Numeric 型でのみ指定できます。日付の
場合は、完全な日付(たとえば 1/1/2003)を入力します。ただし、最
小値と最大値は年にしか影響しません。ユーザは日と月を自由にスク
ロールできます。
オブジェクトとコントロール
493
MinorGridLine
解説
ペインタの場合
❖
最小および最大スピン値を設定する
1
コントロールのプロパティ ビューの[マスク]タブ ページで、
[ス
ピン]チェックボックスをオンにします。
2 [最小]および[最大]フィールドに、最小値と最大値を入力します。
スクリプトの場合
MinMax プロパティの値は、文字列です。最小値と最大値は 2 つのティ
ルダ(~~)で区切ります。
次の例では、エディットマスク em_1 に最小および最大スピン値を設
定します。
em_1.MinMax = ("100 ~~ 10000")
MinorGridLine
対象
グラフ コントロールの grAxis オブジェクト
機能
軸の副グリッドは、軸の目盛りからグラフのデータ領域上全体に引か
れます。副グリッド線は目盛りと目盛りの間を通り、区分数が 2 以上
の場合に表示されます。
MinorGridLine プロパティは、副グリッドの線種を指定します。
解説
ペインタの場合
❖
副グリッド線の線種を設定する
1
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示して、[軸]ドロップダウン リストから軸を選択します。
2 [小区分]グループの[小区分グリッド線]ドロップダウン リスト
から線種を選択します。
スクリプトの場合
MinorGridLine プロパティのデータ型は、LineStyle カタログ データ型
です。
この例では、グラフ gr_1 の値軸上の副グリッド線に点線を指定します。
gr_1.Value.MinorGridLine = Dot!
494
PowerBuilder
第3章
プロパティの説明と使用法
MinorDivisions
対象
グラフ コントロールの grAxis オブジェクト
機能
MinorDivisions プロパティには、主目盛りのスペース数を指定します。
最後の副目盛りは次の主目盛りによってオーバーレイされるため、副
目盛りを表示するには 2 以上の値を指定します。
[大区分]フィールドのデフォルト値 0 は、グラフで使用されるデータ
用に最適化された MajorDivision 値が使用され、MinorDivision の目盛り
数が省略されることを意味します。
解説
ペインタの場合
❖
軸上の副区分の数を指定する
1
グラフのプロパティ ビューの[軸]タブ ページを表示して、
[軸]
ドロップダウン リストから軸を選択します。
2 [小区分]グループの[小区分]フィールド内のスピン コントロー
ルを使用して、区分数を指定します。
スクリプトの場合
MinorDivisions プロパティは、軸上の副区分の数を指定する整数をとり
ます。
次の例では、グラフの値軸の副グリッド上に 10 個の目盛りを設定します。
gr_1.Values.MinorDivisions = 10
MinorTic
対象
グラフ コントロールの grAxis オブジェクト
機能
MinorTic プロパティには、目盛りが副グリッドの軸にどのように重な
るかを指定します。目盛りは、軸線の内側、外側、または軸線をまた
ぐ位置に配置できます。また、目盛りを表示しないこともできます。
解説
ペインタの場合
❖
1
副目盛りの種類を指定する
コントロールのプロパティ ビューの[軸]タブ ページを表示して、
[軸]ドロップダウン リストから軸を選択します。
2 [小区分]グループの[小区分目盛刻み]ドロップダウン リスト
ボックスから目盛りの種類を選択します。
オブジェクトとコントロール
495
MinPosition
スクリプトの場合
MinorTic プロパティの値は、grTicType カタログ データ型です。
次の行では、副グリッドの目盛りをグリッドの外側に設定します。
gr_1.Values.MinorTic = Outside!
MinPosition
対象
水平プログレスバー コントロール、垂直プログレスバー コントロー
ル、水平スクロールバー コントロール、垂直スクロールバー コント
ロール、水平トラックバー コントロール、垂直トラックバー コント
ロール
機能
MinPosition プロパティには、プログレス インジケータ、スクロール
ボックス、あるいはスライダが垂直スクロールバー コントロールの上
部または水平スクロールバーの左端にあるときの Position プロパティ
の値を指定します。プログレスバーのこの値は、SetRange 関数で設定
されるコントロールの範囲の開始と異なることがあります。
解説
ペインタの場合
❖
プログレス インジケータ、スクロール ボックス、あるいはスライダの最小
位置を指定する
•
コントロールのプロパティ ビューの[全般]タブで、[最小位置]
フィールドに整数値を入力します。
スクリプトの場合
MinPosition プロパティの値は、整数値です。
次の例では、スクロール ボックスが最小位置にあるときの Position プ
ロパティの値を 0 に指定します。
vsb_1.MinPosition = 0
MinValDateTime
対象
496
グラフ コントロールの grAxis オブジェクト
PowerBuilder
第3章
プロパティの説明と使用法
機能
MinValDateTime プロパティには、軸のデータ型が Date 型または Time
型である場合の軸の最小値を指定します。このプロパティは、Autoscale
プロパティが有効な場合は使用されません。
解説
ペインタの場合
❖
日付または時刻データ型の軸の最小値を設定する
1
グラフのプロパティ ビューの[軸]タブ ページを表示して、
[軸]
リストから軸を選択します。
2 [自動目盛]チェックボックスがオフになっていることを確認しま
す。
3 [データ型]ドロップダウン リストから「adtDate!」、「adtTime!」、
または「adtDateTime!」を選択します。
4 [最小値]フィールドに日付または時刻の最小値を指定します。
この値は、グラフ化されるデータの最小値より小さい値にする必
要があります。
スクリプトの場合
MinValDateTime プロパティの値は、DateTime 型です。
次の例では、データ型が Date 型の軸の MinValDateTime プロパティを
設定します。
gr_1.Values.DataType = AdtDate!
gr_1.Values.MinValDateTime = 01/31/1900
Modified
対象
インクエディット コントロール、リッチテキスト コントロール
機能
開かれた後にあるいは最後に保存された後に、コントロール内のテキ
ストが修正されたかどうかを指定します。Modified はコントロールの
「ダーティ」フラグで、コントロールが未保存の状態であることを示し
ます。
解説
Modified プロパティの値は、Modified イベントを制御します。プロパ
ティが false の場合は、最初の変更がコントロールの内容で起こるとイ
ベントが発生します。変更はまたプロパティを true に設定します。こ
のプロパティの値は、Modified イベントを抑制します。プロパティの
設定を false に戻すことによって変更の確認を再度開始できます。
オブジェクトとコントロール
497
MonthBackColor
スクリプトの場合
Modified プロパティの値は boolean 値です。次の例では、Modified イベ
ントが有効になるように、インクエディット コントロール ie_1 の
Modified プロパティを false に設定します。
ie_1.Modified = FALSE
MonthBackColor
対象
月表示カレンダ コントロール
機能
MonthBackColor プロパティは、カレンダの月の背景に使用する色を定
義します。
解説
ペインタの場合
プロパティ ビューの[全般]ページで、[月の背景色]ドロップダウ
ン リストから色を選択します。
スクリプトの場合
MonthBackColor プロパティの値は long 型(-2 から 16,777,215)で、カ
レンダの月の背景色の数値を指定します。MonthBackColor の値は、色
の赤、緑、青(RGB)の 3 要素の値の組み合わせです。
目的の色の long 型の値がわからない場合には、
[デザイン|色の指定]
を選択して RGB 値を判別してから、スクリプトで RGB 関数を呼び出
して色を指定します。
次の例では、月の背景色として黄色を設定します。
mc_1.MonthBackColor = RGB(255, 255, 0)
498
PowerBuilder
第3章
プロパティの説明と使用法
MultiSelect
対象
リストボックス コントロール、ピクチャ リストボックス コントロール
機能
MultiSelect プロパティは、ユーザがリストボックス内の項目を一度に
複数個選択できるかどうかを指定します。MultiSelect が有効な場合、
ユーザは複数の項目をクリックすることによって選択できます。MultiSelect
が無効な場合は、ユーザは一度に複数の項目を選択できません。
MultiSelect と ExtendedSelect が両方有効になっている場合は、
ExtendedSelect の動作が優先されます。ExtendedSelect では、ユーザは
追加の項目をクリックするときに〔Shift〕または〔Ctrl〕を押す必要
があります。
解説
ペインタの場合
❖
リストからの複数項目の選択を有効にする
•
コントロールのプロパティ ビューの[全般]ページで、
[複数選択]
チェックボックスをオンにします。
スクリプトの場合
MultiSelect プロパティの値はブール値です。次の例では、リストボッ
クス lb_1 の複数項目の選択を有効にします。
lb_1.MultiSelect = TRUE
Multiline
対象
タブ コントロール
機能
Multiline が有効な場合、タブ全体を 1 行で表示するスペースがない場
合、複数行で表示します。Multiline が無効な場合は、双方向矢印コン
トロールが表示され、ユーザは 1 行に表示されないタブをスクロール
することができます。
解説
ペインタの場合
❖
タブの複数行表示を有効にする
•
コントロールのプロパティ ビューの[全般]ページで、[複数行]
チェックボックスをオンにします。
スクリプトの場合
Multiline プロパティの値はブール値です。次の行では、必要に応じて
タブを複数の行に配置できるように設定します。
tab_1.Multiline = TRUE
オブジェクトとコントロール
499
OriginalSize
OriginalSize
対象
ピクチャ コントロール、ピクチャボタン コントロール、ピクチャ ハ
イパーリンク コントロール、アニメーション コントロール
機能
OriginalSize プロパティには、ピクチャの幅と高さが元の値に設定され
るかどうかを指定します。
アニメーション コントロールでは、アニメーション コントロールの幅
と高さが AVI クリップのサイズに設定されるかどうかを指定します。
ペインタで、マウスを使用してコントロールのサイズを変更した場合、
または[その他]タブの[幅]または[高さ]プロパティを設定した
場合には、OriginalSize プロパティは無効になり、チェックボックスは
オフになります。
解説
ペインタの場合
❖
ピクチャを元のサイズに設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[元のサイ
ズ]チェックボックスをオンにします。
スクリプトの場合
OriginalSize プロパティの値はブール値です。次の行では、OriginalSize
プロパティを FALSE に設定します。
p_1.OriginalSize = FALSE
OriginalSize が TRUE の場合は、ピクチャ コントロールの幅または高さ
を変更しないでください。この変更を行うと、予期しない動作を引き
起こす可能性があります。次の例では、OriginalSize プロパティを
チェックして FALSE に設定します。その後でコントロールのサイズが
2 倍になります。
integer li_width, li_height
li_width = p_1.width * 2
li_height = p_1.height * 2
parent.setredraw(false)
p_1.setredraw(false)
if p_1.originalsize then p_1.originalsize = FALSE
p_1.width = li_width
p_1.height = li_height
p_1.setredraw(TRUE)
parent.setredraw(TRUE)
500
PowerBuilder
第3章
プロパティの説明と使用法
画像が非常に大きい場合にのみ、Setredraw 関数を呼び出す必要があり
ます。大きな JPEG 画像のサイズ変更操作を何回にもわたって実行す
る際は、事前にピクチャの名前を空の文字列に設定しておく必要があ
ります。これは、不要な再コンパイルに長い時間を費やすのを回避す
るためです。
OriginLine
対象
グラフ コントロールの grAxis オブジェクト
機能
OriginLine プロパティには、グラフ内の軸で値 0 を表す線の線種を指
定します。ペインタで、軸がグラフの種類に適していない場合、その
軸の線種設定は無効です。
解説
ペインタの場合
❖
基準線の線種を選択する
1
グラフのプロパティ ビューの[軸]タブ ページを表示して、
[軸]
ドロップダウン リストから軸を選択します。
2 [線の種類]グループ内の[主線]リストから線種を選択します。
スクリプトの場合
OriginLine プロパティのデータ型は、LineStyle カタログ データ型です。
次の文では、値軸の基準線を破線にします。
gr_1.Values.OriginLine = Dash!
OverlapPercent
対象
グラフ コントロール
機能
OverlapPercent は、グラフ内のさまざまな系列の 2D 横棒および縦棒
データ マーカーのオーバーラップの大きさを指定します。指定する数
値はデータ マーカーの幅の割合です。一部のグラフの種類には適用で
きません。
オブジェクトとコントロール
501
Password
解説
ペインタの場合
❖
横棒または縦棒グラフのオーバーラップを設定する
1
コントロールのプロパティ ビューの[全般]ページで、
[グラフの
種類]リストから 2D グラフの種類を選択します。
2 [グラフの重なり]を使用して、オーバーラップの割合を選択しま
す。
スクリプトの場合
OverlapPercent プロパティの値は整数値です。次の行では、オーバー
ラップを 10% に設定します。
gr_1.OverlapPercent = 10
Password
対象
シングルライン エディット コントロール
機能
Password プロパティは、コントロールがパスワード フィールドである
かどうかを指定します。パスワード フィールドでは、ユーザが入力し
た文字がアスタリスク(*)で表示されます。Password が無効な場合
は、文字はユーザが入力したとおりに表示されます。
解説
ペインタの場合
❖
コントロールをパスワード フィールドにする
•
コントロールのプロパティ ビューの[全般]ページで、
[パスワー
ド]チェックボックスをオンにします。
スクリプトの場合
Password プロパティの値は、ブール値です。
次の例では、ユーザが入力した文字がアスタリスクで表示されるよう
に、シングルライン エディットをパスワード フィールドに設定しま
す。
sle_1.Password = TRUE
502
PowerBuilder
第3章
プロパティの説明と使用法
PerpendicularText
対象
タブ コントロール
機能
PerpendicularText が有効な場合、タブ ラベルがタブ ページに垂直に描
画されるため、タブの幅が小さくなります。PerpendicularText が無効な
場合は、テキストはタブ ページの端に平行に表示されるため、タブの
幅が大きくなります。
解説
ペインタの場合
❖
タブ テキスト用に垂直方向を選択する
•
コントロールのプロパティ ビューの[全般]ページで、
[テキスト
をタブに対して垂直に表示]チェックボックスをオンにします。
スクリプトの場合
PerpendicularText プロパティの値は、ブール値です。
次の行では、タブ ラベルがタブ ページに垂直になるように指定します。
tab_1.PerpendicularText = TRUE
Perspective
対象
グラフ コントロールのプロパティ ビュー
機能
Perspective は、ウィンドウの前面からの 3D グラフの距離を制御しま
す。2D グラフでは使用できません。
解説
ペインタの場合
❖
3D グラフの透視角を変更する
1
グラフ コントロールのプロパティ ビューの[全般]ページで、
[グ
ラフの種類]リストから 3D グラフの種類を選択します。
2 [透視角]スライド コントロールを使用して、グラフの透視角を変
更します。
スクリプトの場合
Perspective プロパティの値は、1 ~ 100 の整数値です。数値が大きくな
ると、ウィンドウの前面からの距離が大きくなり、グラフの外観が小
さくなります。
グラフの距離(およびサイズ)を設定するには、次のような行を使用
します。
gr_1.Perspective = 25
オブジェクトとコントロール
503
PicturesAsFrame
PicturesAsFrame
対象
リッチテキスト エディット コントロール
機能
PicturesAsFrame が有効な場合、コントロール内で使用される任意の
ビットマップが空のフレームで表示されます。このプロパティが無効
な場合は、グラフィックは通常どおり表示されます。
また、PicturesAsFrame は、ユーザが実行時にポップアップ メニューの
[プロパティ]項目から有効にすることができます。
解説
ペインタの場合
❖
グラフィックを空のフレームで表示する
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、
[図をイメージ枠で表示]チェックボックスをオンにします。
スクリプトの場合
PicturesAsFrame プロパティの値は、ブール値です。
次の行では、リッチテキスト エディット内のグラフィックがフレーム
で表示されるように指定します。
rte_1.PicturesAsFrame = TRUE
PictureHeight
対象
ピクチャ リストボックス コントロール、ドロップダウン ピクチャ リ
ストボックス コントロール、ツリービュー コントロール、ツールバー
コントロール
機能
PictureHeight プロパティは、コントロール内のすべてのピクチャの表
示の高さをピクセル単位で指定します。スクリプトでは、PictureName
プロパティ配列内に画像がない場合にのみ、このプロパティを設定で
きます。ペインタでは、
[ピクチャ]リスト内に画像があるかどうかに
かかわらず、この値を変更できます。
解説
ペインタの場合
❖
•
ピクチャの高さを設定する
コントロールのプロパティ ビューの[ピクチャ]タブ ページで、
[ピクチャの高さ]ドロップダウン リストから値を選択します。
「16」と「32」は、アイコンの高さの標準的なピクセル数です。
「デ
フ ォ ル ト」を 選 択 す る と、す べ て の ピ ク チ ャ の 高 さ と し て
PictureName 配列の先頭のピクチャの高さが使用されます。
504
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
PictureHeight プロパティの値は、整数値です。この値は、AddPicture 関
数への最初の呼び出しの前か、または DeletePictures の呼び出しの後に
のみ設定できます。この値を 0 に設定すると、すべてのピクチャの高
さとして PictureName プロパティ配列の先頭のピクチャのサイズが使
用されます。
次の行では、ツリービューのピクチャの高さを 16 ピクセルに設定しま
す。
tv_1.PictureHeight = 16
PictureIndex
対象
リストビュー項目、ツリービュー項目
機能
PictureIndex プロパティは、コントロールの[ピクチャ]リスト内のピ
クチャを識別します。リストビュー項目の場合、項目に関連付けられ
た大きいピクチャ、小さいピクチャ、および状態ピクチャがインデッ
クスによって識別されます。
ツリービュー項目の場合、項目ラベルの左側に表示されるピクチャが
インデックスによって識別されます。インデックスが 0 の場合は、ピ
クチャは表示されません。ツリービュー項目に対する PictureIndex プロ
パティはスクリプトでしか設定できませんが、ペインタでコントロー
ルの[ピクチャ]リストにピクチャを追加できます。
解説
ペインタの場合
❖
ピクチャをリストビュー項目に関連付ける
1
リストビュー コントロールのプロパティ ビューの[大きいピク
チャ]タブ ページ、[小さいピクチャ]タブ ページ、または[状
態]タブ ページを選択します。
2
次のいずれかの操作を実行します。
•
各ピクチャ名フィールドの所定の行に、ピクチャを含むファイ
ルの完全なパスとファイル名を入力します。
• [...]ボタンを使用します。
•
3
オブジェクトとコントロール
リストボックスから 1 つまたは複数のピクチャを選択します。
リストビュー コントロールのプロパティ ビューの[項目]タブ
ページを選択します。
505
PictureMaskColor
4 [ピクチャ名]リストの行番号を使用して、[項目]タブ ページの
各リストビュー項目に対するピクチャ インデックスを指定しま
す。
❖
ツリービュー コントロールのピクチャ リストにピクチャを追加する
1
ツリービュー コントロールのプロパティ ビューの[ピクチャ]タ
ブ ページを選択します。
2
次のいずれかの操作を実行します。
• [ピクチャ名]フィールドの所定の行に、ピクチャを含むファ
イルの完全なパスとファイル名を入力します。
• [...]ボタンを使用します。
•
リストボックスから 1 つまたは複数のピクチャを選択します。
スクリプトを使用して、ツリービュー コントロールのピクチャ リスト
内のピクチャをツリービュー項目に関連付けます。
スクリプトの場合
この例では、ListViewItem オブジェクトを取得して、PictureIndex の値
を変更する方法を説明します。
listviewitem lvi
lv_1.GetItem(4, lvi)
lvi.PictureIndex = 2
lv_1.SetItem(4, lvi)
リストビューおよびツリービュー コントロールのスクリプトについ
ての詳細は、
『アプリケーション テクニック』マニュアルの「リスト
ビュー コントロールの使い方」および「ツリービュー コントロールの
使い方」を参照してください。
PictureMaskColor
対象
ピクチャ リストボックス コントロール、ドロップダウン ピクチャ リ
ストボックス コントロール、ツリービュー コントロール、TabPage ユー
ザ オブジェクト
機能
PictureMaskColor プロパティは、ピクチャが表示されるときに透過にな
る、ピクチャ内の色を指定します。スクリプトでは、各ピクチャを追
加する前にマスクの色を変更できます。各画像では、その画像が追加
された時点で有効だったマスクの色が使用されます。
506
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
色のドロップダウン リストに独自の色を追加するには、プロパティ
ビューを表示する前に[デザイン|色の指定]を選択します。
❖
リストボックスおよびツリービュー コントロールに対してピクチャのマスク
の色を設定する
1
コントロールのプロパティ ビューの[ピクチャ]タブ ページを選
択します。
2 [ピクチャのマスク色]ドロップダウン リストから色を選択します。
❖
タブ コントロールの TabPage オブジェクトに対してピクチャのマスクの色
を設定する
1
タブ コントロールの TabPage オブジェクトを選択します。
2
TabPage オブジェクトのプロパティ ビューの[タブページ]タブ
ページを選択します。
3 [ピクチャのマスク色]ドロップダウン リストから色を選択します。
❖
TabPage ユーザ オブジェクトで使用するピクチャのマスクの色を設定する
1
ユーザ オブジェクトのプロパティ ビューの[タブページ]タブ
ページを選択します。
2 [ピクチャのマスク色]ドロップダウン リストから色を選択します。
ユーザ オブジェクトに対して選択したマスクの色は、タブ コント
ロールに挿入した後に変更できます。
スクリプトの場合
PictureMaskColor プロパティの値は、マスクの色の数値を指定する long
型の値(-2 ~ 16,777,215)です。PictureMaskColor の値は、色の赤、緑、
青(RGB)の 3 要素の値の組み合わせです。目的の色の long 型の値が
わからない場合には、[デザイン|色の指定]を選択して RGB 値を判
別してから、スクリプトで RGB 関数を呼び出して色を指定します。こ
のプロパティは、各ビットマップを追加するときに使用されるため、
複数の AddPicture の呼び出しの間に変更できます。
次の例では、ドロップダウン ピクチャ リストボックス内のピクチャの
マスクの色として黄色を設定します。
ddplb_1.PictureMaskColor = RGB(255, 255, 0)
オブジェクトとコントロール
507
PictureName
PictureName
対象
ピクチャ コントロール、ピクチャボタン コントロール、ピクチャ ハ
イパーリンク コントロール、タブ ページとして使用されるユーザ オ
ブジェクト
機能
PictureName プロパティは、コントロールに表示されるピクチャを含む
ファイルの名前を指定します。ピクチャボタン コントロールの場合、
PictureName プロパティによって指定されたピクチャは、ボタンが有効
な場合に表示されます。
次の形式のピクチャを指定できます。
解説
•
ビットマップ(.BMP)
•
ランレングス圧縮(.RLE)
•
Windows メタファイル(.WMF)
•
GIF(GIF)
•
JPEG(.JPG または .JPEG)
ペインタの場合
❖
ピクチャ コントロールで、およびピクチャボタンの有効時に使用されるピク
チャを指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[ピクチャ
名]フィールドにファイル名を入力するか、
[ピクチャ名]フィー
ルドの隣の[...]ボタンを使ってファイルを選択します。
スクリプトの場合
PictureName プロパティの値は、文字列です。
次の行では、ピクチャボタン pb_1 で使用するピクチャ ファイルを選
択します。
pb_1.PictureName = "c:\pictures\pb1.bmp"
508
PowerBuilder
第3章
プロパティの説明と使用法
PictureName[ ]
対象
ツリービュー コントロール、ピクチャ リストボックス コントロール、
ドロップダウン ピクチャ リストボックス コントロール、ツールバー
コントロール
機能
PictureName[ ] プロパティは、コントロール内で使用されるピクチャを
含むファイルのインデックス付き配列を指定します。ペインタで配列
にピクチャを追加したり、実行時に AddPicture 関数を使用したりする
ことができます。ただし、実行時にピクチャを追加または削除しても、
PictureName プロパティの配列は更新されません。
次の形式のピクチャを指定できます。
解説
•
ビットマップ(.BMP)
•
GIF(GIF)
•
JPEG(.JPG または .JPEG)
•
アイコン (.ICO)
ペインタの場合
❖
PictureName 配列にピクチャを追加する
1
コントロールのプロパティ ビューの[ピクチャ]タブ ページを選
択します。
2
次のいずれかの操作を実行します。
• [ピクチャ名]フィールドの所定の行に、ピクチャを含むファ
イルの完全なパスとファイル名を入力します。
• [...]ボタンを使用します。
•
リストボックスから 1 つまたは複数のピクチャを選択します。
スクリプトの場合
PictureName プロパティ配列は、初期設定時に与えられ、実行時には更
新できません。
次の例では、ツリービュー コントロールにピクチャを追加して、その
ピクチャを新規ツリービュー項目に関連付けます。
long ll_tvi
integer li_pic
li_pic = tv_1.AddPicture("c:\images\new.gif")
ll_tvi = tv_1.FindItem(RootTreeItem!, 0)
tv_1.InsertItemFirst(ll_tvi, "New", li_picture)
オブジェクトとコントロール
509
PictureOnRight
PictureOnRight
対象
タブ コントロール
機能
PictureOnRight プロパティが有効な場合、タブ ラベルの一部としてピ
クチャがあれば、そのピクチャはテキストの右側に配置されます。
PictureOnRight が無効な場合は、ピクチャはタブ ラベル テキストの左
側に配置されます。
解説
ペインタの場合
❖
ピクチャの位置をタブ ラベル上のテキストの右側に指定する
•
タブ コントロールのプロパティ ビューの[全般]ページで、[ピ
クチャを右側に表示]チェックボックスをオンにします。
スクリプトの場合
PictureOnRight プロパティの値は、ブール値です。
次の行では、ピクチャをタブ ラベルの右側に配置するように指定しま
す。
tab_1.PictureOnRight = TRUE
PictureWidth
対象
ピクチャ リストボックス コントロール、ドロップダウン ピクチャ リ
ストボックス コントロール、ツリービュー コントロール、ツールバー
コントロール
機能
PictureWidth プロパティは、コントロール内のすべてのピクチャの表示
幅をピクセル単位で指定します。スクリプトでは、PictureName プロパ
ティ配列内に画像がない場合にのみ、このプロパティを設定できます。
ペインタでは、
[ピクチャ]リスト内に画像があるかどうかにかかわら
ず、この値を変更できます。
解説
ペインタの場合
❖
•
ピクチャの幅を設定する
コントロールのプロパティ ビューの[ピクチャ]タブ ページで、
[ピクチャの幅]ドロップダウン リストから値を選択します。
「16」と「32」は、アイコンの幅の標準的なピクセル数です。「デ
フォルト」を選択すると、すべてのピクチャの幅として
PictureName 配列の先頭のピクチャの幅が使用されます。
510
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
PictureWidth プロパティの値は、整数値です。この値は、AddPicture 関
数への最初の呼び出しの前か、または DeletePictures の呼び出しの後に
のみ設定できます。この値を 0 に設定すると、すべてのピクチャの幅
として PictureName プロパティ配列の先頭のピクチャのサイズが使用
されます。
次の行では、ツリービューのピクチャの幅を 16 ピクセルに設定しま
す。
tv_1.PictureWidth = 16
Pointer
対象
すべてのコントロール
機能
Pointer プロパティは、ポインタがコントロール上にあるときに表示さ
れるポインタ画像を指定します。
解説
ペインタの場合
❖
ポインタを指定する
1
コントロールのプロパティ ビューの[その他]タブ ページを選択
します。
2
次のいずれかの操作を実行します。
• [ポインタ]テキストボックスに、ポインタ画像を含むファイ
ルの完全なパスとファイル名を入力します。
• [...]ボタンを使用します。
•
下矢印をクリックしてリストボックスを表示して、そのリスト
からポインタを選択します。
スクリプトの場合
Pointer プロパティの値は、ファイル名を含む文字列か、または Pointer
カタログ データ型の名前の文字列です。
次の行はいずれも、I-beam をコマンドボタン cb_1 のポインタとして設
定します。
cb_1.Pointer = 'Beam!'
cb_1.Pointer = 'd:\archive\IBEAM.BMP'
オブジェクトとコントロール
511
PopMenu
PopMenu
対象
リッチテキスト エディット コントロール
機能
PopMenu が有効な場合、ユーザはコントロール上でマウスの右ボタン
をクリックすることによって、ポップアップ メニューにアクセスでき
ます。ポップアップ メニューを使用すると、ユーザは切り取りと貼り
付け、ファイルの挿入、および書式指定プロパティの選択を行うこと
ができます。
ポップアップ メニューは、ユーザが実行時にポップアップ メニューの
[プロパティ]項目で無効にすることができます。
解説
ペインタの場合
❖
ポップアップ メニューを有効にする
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、
[ポップアップ メニュー]チェックボックスをオンにします。
スクリプトの場合
PopMenu プロパティの値は、ブール値です。
次の行では、リッチテキスト エディットに対してポップアップ メ
ニューを有効にします。
rte_1.PopMenu = TRUE
Position
対象
水平プログレスバー コントロール、垂直プログレスバー コントロー
ル、水平スクロールバー コントロール、垂直スクロールバー コント
ロール、水平トラックバー コントロール、垂直トラックバー コント
ロール
機能
Position では、実行中スクロールバーまたはトラックバーが最初に表示
されるときの、スクロール ボックスまたはつまみの表示位置を指定し
ます。プログレスバーでは、Position はコントロールの範囲内(SetRange
関数で設定)の現行の位置の値を指定します。コントロールは、範囲
と現行の位置を使用して、強調色で塗りつぶすプログレスバーの割合
を決めます。
512
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
プログレス インジケータ、スクロール ボックス、またはつまみの初期位置
を設定する
• [最小位置]と[最大位置]に指定した 2 つの値の間の数値を[位
置]フィールドに入力します。
スクリプトの場合
Position プロパティの値は整数値です。このプロパティは、MaxPosition
と MinPosition と関連して使う必要があります。
たとえば、垂直スクロールバーの最小位置が 0、最大位置が 100 の場
合、この文では、スクロールバーの下部方向に 80% の位置にスクロー
ル ボックスを配置します。
vsb_1.Position = 80
PowerTipText
対象
いんくピクチャ コントロール、ピクチャ コントロール、ピクチャボタ
ン コントロール、ピクチャ ハイパーリンク コントロール、およびタ
ブ ページ付きのユーザ オブジェクト
機能
コントロールの上またはタブ ページのタブ領域の上にユーザがカー
ソルを移動したときに、PowerTip を表示します。
解説
ペインタの場合
❖
PowerTip の設定
1
ウィンドウ ペインタで、コントロールのプロパティ ビューの[全
般]ページを表示するか、ユーザ オブジェクト ペインタで、ユー
ザ オブジェクトのプロパティ ビューの[タブページ]タブ ページ
を表示します。
2 [PowerTip テキスト]フィールドのボックスに PowerTip を入力し
ます。
スクリプトの場合
PowerTipText プロパティの値は、文字列です。
次の行は、タブ コントロール tab_1 上の tabpage_2 に対して PowerTip
を追加するステートメントです。
tab_1.tabpage_2.PowerTipText = "Cancel the operation"
オブジェクトとコントロール
513
PowerTips
次のステートメントを実行すると、ピクチャボタン コントロールの
PowerTip が追加されます。
pb_1.PowerTipText = "This button opens a new form"
PowerTips
対象
タブ コントロール
機能
PowerTips プロパティが有効な場合、タブ ページに定義された PowerTip
テキストは、マウス ポインタがタブ上に停止したときにポップアップ
テキストとして表示されます。PowerTips は、タブ ラベルがピクチャ
である場合に効果的です。
解説
ペインタの場合
❖
•
PowerTip テキストの表示を有効にする
タブ コントロールのプロパティ ビューの[全般]ページで、
[PowerTips]チェックボックスをオンにします。
スクリプトの場合
PowerTips プロパティの値はブール値です。次の行では、各タブ ペー
ジでの PowerTip の表示を可能にします。
tab_1.PowerTips = TRUE
PrimaryLine
対象
グラフ コントロールの grAxis オブジェクト
機能
PrimaryLine プロパティには、軸自体に使用される主線の線種を指定し
ます。軸がグラフの種類に適していない場合、その軸の線種設定は無効
です。
線種が transparent! に設定されている場合、
主線は表示されません。
解説
ペインタの場合
514
❖
軸の主線の線種を設定する
1
グラフのプロパティ ビューの[軸]タブ ページを表示して、
[軸]
ドロップダウン リストから軸を選択します。
PowerBuilder
第3章
プロパティの説明と使用法
2 [線の種類]グループ内の[主線]ドロップダウン リストから線種
を選択します。
スクリプトの場合
PrimaryLine プロパティのデータ型は、LineStyle カタログ データ型で
す。次の行では、グラフの値軸の PrimaryLine プロパティを破線に設定
します。
gr_1.Values.PrimaryLine = Dash!
RaggedRight
対象
タブ コントロール
機能
RaggedRight が有効な場合、タブのサイズはラベル テキストと Fixed
Width 設定によって決定されます。RaggedRight が無効な場合は、タブ
の幅はコントロールの端と等しくなります。
解説
ペインタの場合
❖
RaggedRight プロパティを設定する
•
タブ コントロールのプロパティ ビューの[全般]ページで、[幅
合わせをしない]チェックボックスをオンにします。
このチェックボックスをオンにすると、ラベル テキストおよび[均
等なタブ幅]チェックボックスがオンになっているかどうかに基
づいて、タブのサイズが変更されます。
スクリプトの場合
RaggedRight プロパティの値は、ブール値です。次の行では、タブの幅
がコントロールの端と等しくなるように指定します。
tab_1.RaggedRight = FALSE
RecognitionTimer
対象
インクエディット コントロール
機能
最後のインク ストロークとテキスト認識の開始の間隔をミリ秒で指
定します。
オブジェクトとコントロール
515
Resizable
解説
ペインタの場合
❖
インクエディット コントロールに追加されたインクをテキストに変換する
までの時間を指定する
•
プロパティ ビューの[インク]ページで[認識タイマ]チェック
ボックスをオフにします。
スクリプトの場合
RecognitionTimer プロパティの値は long 値です。デフォルトでは、イ
ンクを 2 秒(2000 ミリ秒)後にテキストに変換します。テキストを入
力するまでの時間を長くしたい場合は、RecognitionTimer 値を増やし
ます。
次の例は、最後のストロークとテキスト認識の開始の間隔を 1 分
(60000 ミリ秒)に設定します。
ie_1.RecognitionTimer = 60000
Resizable
対象
データウィンドウ コントロール、OLE コントロール、リッチテキスト
エディット コントロールおよびウィンドウ
機能
サイズ可変なウィンドウまたはコントロールには太枠があり、ユーザ
はマウスまたはキーボードを使用してサイズを変更できます。
解説
ペインタの場合
❖
ユーザがウィンドウまたはコントロールのサイズを変更できるようにする
•
ウィンドウまたはコントロールのプロパティ ビューの[全般]ペー
ジで、[サイズ可変]チェックボックスをオンにします。
スクリプトの場合
Resizable プロパティの値は、ブール値です。
この文では、データウィンドウ コントロール dw_1 をサイズ可変にし
ます。
dw_1.Resizable = TRUE
516
PowerBuilder
第3章
プロパティの説明と使用法
ReturnsVisible
対象
リッチテキスト エディット コントロール
機能
ReturnsVisible プロパティが有効な場合、テキスト内の改行記号が表示
されます。
また、ユーザが実行時にポップアップ メニューの[プロパティ]項目
から、またはツールバーからこのプロパティの有効化と無効化を行う
こともできます。
解説
ペインタの場合
❖
改行(キャリッジ リターン)記号を表示可能にする
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、[改行記号の表示]チェックボックスをオンにします。
スクリプトの場合
ReturnsVisible プロパティの値は、ブール値です。
次の行では、リッチテキスト エディット コントロール内で改行記号を
表示可能にします。
rte_1.ReturnsVisible = TRUE
RightMargin
対象
リッチテキスト エディット コントロール
機能
RightMargin プロパティには、印刷ページの右余白のサイズをインチ単
位で指定します。
解説
ペインタの場合
❖
•
右余白を設定する
リッチテキスト エディット コントロールのプロパティ ページの
[ドキュメント]タブ ページで、[右余白]フィールドにサイズを
インチ単位で入力します。
スクリプトの場合
RightMargin プロパティの値は、long 型です。
次の行では、リッチテキスト エディットの右余白を 1 インチに設定し
ます。
rte_1.RightMargin = 1
オブジェクトとコントロール
517
RightToLeft
RightToLeft
対象
アプリケーション オブジェクト、ウィンドウ オブジェクト、チェック
ボックス コントロール、ドロップダウン リストボックス コントロー
ル、ドロップダウン ピクチャ リストボックス コントロール、エディッ
トマスク コントロール、グループボックス コントロール、インクエ
ディット コントロール、リストボックス コントロール、リストビュー
コントロール、マルチライン エディット コントロール、ピクチャ リ
ストボックス コントロール、ラジオボタン コントロール、シングルラ
イン エディット コントロール、スタティック ハイパーリンク コント
ロール、スタティック テキスト コントロール、およびツリービュー コ
ントロール
機能
RightToLeft プロパティでは、文字を右から左の向きに表示するかどう
かを指定します。アプリケーションは、右から左への表示をサポート
するオペレーティング システム上で実行する必要があります。値は以
下のとおりです。
•
TRUE - 文字を右から左の向きに表示します。
•
FALSE - 文字を左から右の向きに表示します(デフォルト)
。
メッセージとボタンのテキストをアラビア語またはヘブライ語で表示
するには、アプリケーション オブジェクトの RightToLeft プロパティ
を TRUE に設定します。メッセージは右から左方向へ表示されるよう
になります。ただし、PowerBuilder のローカライズ版を使っていない
場合、ボタンに表示されるテキストは、英語のままです。
このプロパティは、コントロールのレイアウトのそのほかの外観には
影響しません。リストビュー コントロールとツリービュー コントロー
ルの場合、標準レイアウトのミラー イメージを表示するためには、
LayoutRTL プロパティを使用します。
良い結果を得るためには、このプロパティの効果を確認することがで
きるようにペインタで設定します。このプロパティを実行時に設定す
ると予期せぬ結果となります。
解説
ペインタの場合
❖
RightToLeft プロパティを設定する
•
コントロールのプロパティ ビューの[全般]ページにある[右か
ら左]チェックボックスをオンにします。
スクリプトの場合
RightToLeft プロパティの値はブール値です。
518
PowerBuilder
第3章
プロパティの説明と使用法
次の行では、シングルライン エディット コントロールの RightToLeft
プロパティを TRUE に設定します。
sle_1.RightToLeft = TRUE
Rotation
対象
グラフ コントロール
機能
Rotation プロパティでは、3D グラフの左から右への回転を指定します。
2D グラフでは回転は無効です。
解説
ペインタの場合
❖
グラフの回転を設定する
1
グラフ コントロールのプロパティ ビューの[全般]ページで、
[グ
ラフの種類]リストから 3D グラフの種類を選択します。
2 [回転]スライダを移動して、グラフの回転を変更します。
スクリプトの場合
Rotation プロパティの値は、整数値です。
次の例では、グラフを左に 45°回転します。
gr_1.Rotation = -45
RulerBar
対象
リッチテキスト エディット コントロール
機能
RulerBar プロパティが有効な場合、ルーラバーがコントロールの編集
領域の上に表示されます。ユーザはルーラバーを使用して、タブバー
上のタブと余白を設定できます。
また、コントロールの PopMenu プロパティが TRUE に設定されている
場合、ユーザが実行時にポップアップ メニューの[プロパティ]項目
からルーラバーの有効化と無効化を行うこともできます。
オブジェクトとコントロール
519
RoundTo
解説
ペインタの場合
❖
ルーラバーを表示可能にする
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、
[ルーラの表示]チェックボックスをオンにします。
スクリプトの場合
RulerBar プロパティの値は、ブール値です。
次の行では、ルーラバーをリッチテキスト エディットに表示します。
rte_1.RulerBar = TRUE
RoundTo
対象
グラフ コントロールの grAxis オブジェクト
機能
AutoScale プロパティが有効な場合、軸の端点と目盛りの数値をどのよ
うに丸めるかは、RoundTo プロパティと RoundToUnit プロパティで指
定します。数値の丸めは、グラフ データでなく軸ラベルに作用します。
RoundTo プロパティには、軸の値を丸めた結果の値を、RoundToUnit プ
ロパティで指定した単位で指定します。
解説
ペインタの場合
❖
軸の値を丸めた結果の値を設定する
1
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示して、[軸]リストから軸を選択します。
2 [自動目盛]チェックボックスをオンにして、自動スケーリングを
有効にします。
3 [データ型]ドロップダウン リストからオプションを選択して、軸
のデータ型を選択します。
4 [丸め]編集フィールドに値を入力します。
スクリプトの場合
RoundTo プロパティの値は、軸の目盛りを丸めた結果の倍数を示す
double 型の値をとります。
次の例では、値軸のデータ型を Date 型に設定して、丸めの単位を月に
設定し、次に丸めの値を 6 か月に設定します。
gr_1.Values.DataType = AdtDate!
520
PowerBuilder
第3章
プロパティの説明と使用法
gr_1.Values.RoundToUnit = RndMonths!
gr_1.Values.RoundTo = 6
RoundToUnit
対象
グラフ コントロールの grAxis オブジェクト
機能
AutoScale プロパティが有効な場合、軸の端点と目盛りの数値をどのよ
うに丸めるかは、RoundTo プロパティと RoundToUnit プロパティで指
定します。数値の丸めは、グラフ データでなく軸ラベルに作用します。
RoundToUnit プロパティは、丸めに使用する単位の種類を指定します。
指定できる単位の種類は、軸のデータ型に基づきます。たとえば、Date
型の軸では、目盛りを過去 5 年間や 3 か月ごとに丸めることができま
す。
解説
ペインタの場合
❖
丸めに使用する単位の種類を指定する
1
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示して、[軸]リストから軸を選択します。
2 [自動目盛]チェックボックスをオンにして、自動スケーリングを
有効にします。
3 [データ型]ドロップダウン リストからオプションを選択して、軸
のデータ型を選択します。
4 [丸めの単位]ドロップダウン リストから単位を選択します。
スクリプトの場合
RoundToUnit プロパティの値は、grRoundToType カタログ データ型で
す。スクリプトでこのプロパティを設定する場合は、指定する値と軸
のデータ型に互換性があることを確認してください。
次の例では、値軸のデータ型を Date 型に設定して、丸めの単位を月に
設定し、次に丸めの月数を設定します。
gr_1.Values.DataType = AdtDate!
gr_1.Values.RoundToUnit = RndMonths!
gr_1.Values.RoundTo = 6
オブジェクトとコントロール
521
ScaleType
ScaleType
対象
グラフ コントロールの grAxis オブジェクト
機能
ScaleType プロパティには、軸に使用する目盛りを指定します。軸には、
線形目盛りまたは対数目盛りを使用できます。デフォルトは線形目盛
り(Linear)です。そのほかの値は Log10 と LogE です。
解説
ペインタの場合
❖
軸の目盛りの種類を選択する
1
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示して、[軸]リストから軸を選択します。
2 [目盛]グループ内の[目盛の型]ドロップダウン リストから目盛
りの種類を選択します。
スクリプトの場合
ScaleType プロパティの値は、grScaleType カタログ データ型です。
gr_1 の値軸の目盛りの種類を Log10 に設定するには、次のような行を
使用します。
gr_1.Values.ScaleType=Log10!
ScaleValue
対象
グラフ コントロールの grAxis オブジェクト
機能
ScaleValue プロパティには、軸上の目盛りに表示される値を設定しま
す。このプロパティは、ペインタでは設定できません。
解説
スクリプトの場合
ScaleValue プロパティの値は、grScaleValue カタログ データ型です。
次の行では、グラフの値軸の ScaleValue を設定します。
gr_1.Values.ScaleValue = Actual!
522
PowerBuilder
第3章
プロパティの説明と使用法
Scrolling
対象
リストビュー コントロール
機能
Scrolling が有効な場合、ユーザはリストビュー コントロール内の項目
の一部が表示されていないとき、上下にスクロールできます。Scrolling
が無効な場合は、ユーザはスクロールできません。
解説
ペインタの場合
❖
スクロールを有効にする
•
コントロールのプロパティ ビューの[全般]ページで、
[スクロー
ル]チェックボックスをオンにします。
スクリプトの場合
Scrolling プロパティの値は、ブール値です。次の行では、リストビュー
での必要に応じたスクロールを有効にします。
lv_1.Scrolling = TRUE
ScrollRate
対象
月表示カレンダ コントロール
機能
ユーザがスクロール ボタンをクリックしたときにカレンダがスク
ロールする月数を指定します。
解説
ペインタの場合
❖
ScrollRate プロパティを設定する
•
プロパティ ビューの[全般]ページで、
[スクロール単位(月)]ス
ピン コントロールから数を選択します。
スクリプトの場合
ScrollRate プロパティの値は整数値です。デフォルトは 1 です。この場
合、表示される月の数が多くても、カレンダは 1 か月ずつスクロール
します。次の例では、ScrollRate の値を 3 に設定します。
mc_1.ScrollRate = 3
オブジェクトとコントロール
523
SecondaryLine
SecondaryLine
対象
グラフ コントロールの grAxis オブジェクト
機能
SecondaryLine プロパティは、グラフ内の主軸に平行な軸内で使用され
る線の線種を指定します。
解説
ペインタの場合
軸がグラフの種類に適していない場合、ペインタでのその軸の線種設
定は無効になります。
❖
1
副軸の線種を設定する
グラフ コントロールのプロパティ ビューの[軸]タブを表示して、
[軸]リストから軸を選択します。
2 [線の種類]グループ内の[二次線]ドロップダウン リストから線
種を選択します。
スクリプトの場合
SecondaryLine プロパティの値は、LineStyle カタログ データ型です。次
の例では、グラフの値軸の SecondaryLine プロパティを破線に設定しま
す。
gr_1.Values.SecondaryLine = Dash!
SelectedTab
対象
タブ コントロール
機能
SelectedTab プロパティには、タブ コントロール内で選択されたタブ
ページのインデックス番号を指定します。ユーザがタブ コントロール
内のタブを選択するたびに、SelectedTab の値は現在選択しているタブ
を反映するために変更されます。
解説
ペインタの場合
❖
選択したタブを指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[選択する
タブ ページ]フィールドに番号を入力します。
番号は 1 ~ N の範囲の値にする必要があります。ここで N はタブ
コントロール内のタブ ページの数です。
524
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
SelectedTab プロパティの値は、整数値です。デフォルト値は 1 で、整
数は 1 ~ N の範囲の値にする必要があります。ここで N はタブ ページ
の数です。
次の行では、タブ コントロール tab_1 内で選択したタブ ページのイン
デックス番号を 3 に設定します。
tab_1.SelectedTab = 3
Series
対象
グラフ コントロール
機能
Series プロパティは、グラフ内の系列軸のプロパティを定義するため
に使用します。系列軸は、3D グラフに対してのみ有効です。
解説
ペインタの場合
❖
3D グラフの系列軸のプロパティを定義する
1
グラフ コントロールのプロパティ ビューの[全般]ページで、
[グ
ラフの種類]リストから 3D グラフの種類を選択します。
2
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示して、[軸]リストから「数値」を選択します。
系列軸のすべてのプロパティは、
[軸]タブ ページから設定できま
す。
スクリプトの場合
系列軸は、グラフ コントロール内の grAxis オブジェクトです。Series
オブジェクトには、軸の外観を制御するための独自のプロパティがあ
ります。
次の行では、gr_1 の系列軸の目盛りの種類を Log10 に設定します。
gr_1.Series.Scaletype = Log10!
オブジェクトとコントロール
525
SeriesSort
SeriesSort
対象
グラフ コントロール
機能
SeriesSort プロパティには、系列のソート方法(昇順、降順、または
ソートなし)を指定します。
解説
ペインタの場合
❖
系列のソート方法を指定する
•
グラフ コントロールのプロパティ ビューの[全般]ページで、
[系
列軸のソート]ドロップダウン リストからソートの種類を選択し
ます。
スクリプトの場合
CategorySort プロパティのデータ型は grSortType カタログ データ型で、
Ascending!、Descending!、Unsorted!、UserDefinedSort! の 4 つの値があ
ります。
次の例では、系列がソートされないように指定します。
gr_1.SeriesSort = Unsorted!
SetStep
対象
水平プログレスバー コントロールと垂直プログレスバー コントロール
機能
プログレスバーは、範囲と現行位置から構成されます。SetStep プロパ
ティを使用すると、進行状況が表示される際の現行位置の遷移の基準
となる増分のサイズを設定できます。デフォルト値は 10 です。
解説
ペインタの場合
❖
増分のサイズを設定する
•
コントロールのプロパティ ビューの[全般]ページで、
[ステップ
を設定]テキストボックス内のスピン コントロールを使用するか、
整数を入力します。
スクリプトの場合
SetStep の値は、整数値です。次の例では、プログレスバーの範囲を 0
~ 500 に設定し、増分のサイズを 50 に設定します。
hpb_1.setrange(0,500)
hpb_1.setstep = 50
526
PowerBuilder
第3章
プロパティの説明と使用法
ShadeBackEdge
対象
グラフ コントロールの grAxis オブジェクト
機能
ShadeBackEdge プロパティには、軸の後部エッジ面に影を付けるかど
うかを指定します。このプロパティは 3D グラフにのみ適用されます。
影の色は、軸ではなくグラフのプロパティです。
解説
ペインタの場合
❖
3D グラフの軸の後部エッジ面に影を付ける
1
グラフ コントロールのプロパティ ビューの[全般]ページで、
[グ
ラフの種類]リストから 3D グラフの種類を選択します。
2 [全般]ページの[影の色]リストから影の色を選択します。
3
グラフ コントロールのプロパティ ビューの[軸]タブ ページを表
示して、[軸]リストから軸を選択します。
4 [軸]タブ ページの[エッジ面の影付け]チェックボックスをオン
にします。
スクリプトの場合
ShadeBackEdge プロパティの値は、ブール値です。
次の例では、グラフの影の色を選択して、次に 3D グラフの項目軸の
後部エッジ面に影を付けるように指定します。
gr_1.ShadeColor = RGB(240,250,150)
gr_1.Category.ShadeBackEdge = TRUE
ShowList
対象
ドロップダウン リストボックス コントロール、ドロップダウン ピク
チャ リストボックス コントロール
機能
ShowList プロパティが有効な場合、オプション リストが常に表示され
ます。このプロパティが無効な場合は、オプション リストはユーザが
コントロールの下矢印をクリックしたときにのみ表示されます。
解説
ペインタの場合
❖
オプション リストが常に表示されるよう指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[リストを
表示]チェックボックスをオンにします。
オブジェクトとコントロール
527
ShowHeader
スクリプトの場合
ShowList プロパティの値は、ブール値です。次の例では、ドロップダ
ウン リストボックスのオプション リストが常に表示されるように指
定します。
ddlb_1.ShowList = TRUE
ShowList が TRUE の場合、AllowEdit プロパティも TRUE でなければな
らない点に注意してください。
ShowHeader
対象
リストビュー コントロール
機能
ShowHeader プロパティが有効な場合、カラム タイトルがリストビュー
コントロールの詳細ビューに表示されます。ShowHeader が無効な場合
は、カラム タイトルは詳細ビューに表示されません。
リストビュー コントロールで詳細ビューを有効にするには、カラムを
作成してカラムに値を与えるスクリプトを記述する必要があります。
詳細ビューの有効化についての詳細は、
『アプリケーション テクニッ
ク』マニュアルの「リストビュー コントロールの使い方」を参照して
ください。
解説
ペインタの場合
❖
詳細ビューのヘッダを指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[ヘッダの
表示]チェックボックスをオンにします。
スクリプトの場合
ShowHeader プロパティの値は、ブール値です。次の行では、詳細ビュー
でのヘッダの表示を有効にします。
lv_1.ShowHeader = TRUE
528
PowerBuilder
第3章
プロパティの説明と使用法
ShowPicture
対象
タブ コントロール
機能
ShowPicture プロパティが有効な場合、各タブに指定されたピクチャが
あれば表示されます。このプロパティが無効な場合は、ピクチャは表
示されません。
ShowPicture を ShowText とともに使用して、ピクチャとテキスト ラベ
ル、ピクチャのみ、またはテキスト ラベルのみを表示したり、いずれ
も表示しないことができます。
解説
ペインタの場合
❖
タブ コントロール内のタブ ページのピクチャを表示する
•
タブ コントロールのプロパティ ビューの[全般]ページで、[ピ
クチャの表示]チェックボックスをオンにします。
スクリプトの場合
ShowPicture プロパティの値は、ブール値です。次の行では、各タブの
ピクチャがあれば表示します。
tab_1.ShowPicture = TRUE
ShowText
対象
タブ コントロール
機能
ShowText プロパティが有効な場合、各タブに指定されたテキストがあ
れば表示されます。このプロパティが無効な場合は、テキストは表示
されません。
ShowText を ShowPicture とともに使用して、ピクチャとテキスト ラベ
ル、ピクチャのみ、またはテキスト ラベルのみを表示したり、いずれ
も表示しないことができます。
解説
ペインタの場合
❖
タブ コントロール内のタブ ページのテキストを表示する
•
タブ コントロールのプロパティ ビューの[全般]ページで、[テ
キストの表示]チェックボックスをオンにします。
オブジェクトとコントロール
529
SmallPictureHeight
スクリプトの場合
ShowText プロパティの値は、ブール値です。次の行では、各タブのテ
キストがあれば表示します。
tab_1.ShowText = TRUE
SmallPictureHeight
対象
リストビュー コントロール
機能
SmallPictureHeight プロパティには、リストビュー コントロールの小さ
いアイコン ビュー内のすべてのピクチャの表示の高さを指定します。
サイズはピクセル単位で指定します。
ペインタで値「デフォルト」を選択した場合、または値を 0 に設定し
た場合は、すべてのピクチャの高さとして、配列内の先頭のピクチャ
の高さが使用されます。ペインタでこのほかに選択できる値は「16」
と「32」で、これらの値はアイコンの標準的な高さのピクセル数です。
使用されるピクチャの種類は、コントロールの View プロパティの値に
よって決定されます。
解説
ペインタの場合
❖
小さいピクチャの高さを設定する
•
コントロールのプロパティ ビューの[小さいピクチャ]タブ ペー
ジで、
[小さいピクチャの高さ]ドロップダウン リストから値を選
択します。
スクリプトの場合
SmallPictureHeight プロパティの値は整数値です。
この値は、
AddSmallPicture
関数への最初の呼び出しの前か、DeleteSmallPictures 関数の呼び出しの
後にのみ設定できます。この値を 0 に設定すると、小さいピクチャの
サイズとして最初のピクチャのサイズが使用されます。
次の行では、リストビューの小さいピクチャの高さを 16 ピクセルに設
定します。
lv_1.SmallPictureHeight = 16
リストビュー コントロールのスクリプトについての詳細は、
『アプリ
ケーション テクニック』マニュアルの「リストビュー コントロールの
使い方」を参照してください。
530
PowerBuilder
第3章
プロパティの説明と使用法
SmallPictureMaskColor
対象
リストビュー コントロール
機能
マスクの色は、ピクチャが表示されるときに透過になる、ピクチャ内
の色です。
新しく追加するユーザ定義のビットマップにマスクする色を選択しま
す。スクリプトでは、各ピクチャを追加する前にマスクの色を変更で
きます。各画像では、その画像が追加された時点で有効だったマスク
の色が使用されます。
解説
ペインタの場合
❖
ピクチャのマスクの色を指定する
•
コントロールのプロパティ ビューの[小さいピクチャ]タブ ペー
ジで、
[小さいピクチャのマスク色]ドロップダウン リストから色
を選択します。
色のドロップダウン リストに独自の色を追加するには、プロパティ
ビューを表示する前に[デザイン|色の指定]を選択します。
スクリプトの場合
SmallPictureMaskColor プロパティの値は、背景色の数値を指定する long
型の値(-2 ~ 16,777,215)です。このプロパティは、各ビットマップを
追加するときに使用されるため、複数の AddSmallPicture の呼び出しの
間に変更できます。
SmallPictureMaskColor の値は、色の赤、緑、青(RGB)の 3 要素の値
の組み合わせです。目的の色の long 型の値がわからない場合には、
[デ
ザイン|色の指定]を選択して RGB 値を判別してから、スクリプトで
RGB 関数を呼び出して色を指定します。
次の例では、リストビュー内のユーザ定義のビットマップのマスクの
色として黄色を設定します。
lv_1.SmallPictureMaskColor = RGB(255, 255, 0)
オブジェクトとコントロール
531
SmallPictureName[ ]
SmallPictureName[ ]
対象
リストビュー コントロール
機能
PowerBuilder では、リストビュー画像はいくつかの画像のインデック
ス付き配列に格納されます。ペインタでリストビューを作成するとき、
または実行時に AddItem および InsertItem 関数を使用するときに、画像
を特定のリストビュー項目に関連付けることができます。
特定の画像はインデックス番号で識別します。選択したビューによっ
ては、項目の大きいピクチャと小さいピクチャに同一のインデックス
番号が使用されるため、配列の各位置の画像に互換性があるかどうか
を確認する必要があります。コントロール内で使用されるピクチャの
種類は、コントロールの View プロパティの値によって決定されます。
解説
ペインタの場合
❖
小さいアイコン ビューの画像を指定する
1
リストビュー コントロールのプロパティ ビュー[小さいピクチャ]
タブ ページを選択します。
2
次のいずれかの操作を実行します。
• [小さいピクチャ名]フィールドの所定の行に、ピクチャを含
むファイルの完全なパスとファイル名を入力します。
• [...]ボタンを使用します。
•
リストボックスから 1 つまたは複数のピクチャを選択します。
ここで指定するピクチャ名の順序は、大きいアイコン ビューで使
用したピクチャ名の順序と一致させる必要があります。
3 [小さいピクチャ名]リストの行番号を使用して、
[項目]タブ ペー
ジの各リストビュー項目に対するピクチャのインデックスを指定
します。
スクリプトの場合
SmallPictureName プロパティの値は、文字列です。実行中に
SmallPictureName プロパティを使用して画像リストを更新することは
できません。リストビュー コントロールに小さいピクチャを追加する
には、AddSmallPicture 関数を使用します。その例を次に示します。
lv_1.AddSmallPicture(“c:\ArtGal\bmps\celtic.bmp”)
リストビュー コントロールに小さいピクチャを追加すると、リスト
ビュー コントロールで次に使用可能なピクチャのインデックスが与
えられます。
532
PowerBuilder
第3章
プロパティの説明と使用法
リストビュー コントロールのスクリプトについての詳細は、『アプリ
ケーション テクニック』マニュアルの「リストビュー コントロールの
使い方」を参照してください。
SmallPictureWidth
対象
リストビュー コントロール
機能
SmallPictureWidth プロパティには、リストビュー コントロールの小さ
いアイコン ビュー内のすべてのピクチャの表示幅を指定します。サイ
ズはピクセル単位で指定します。
ペインタで値「デフォルト」を選択した場合、または値を 0 に設定し
た場合は、すべてのピクチャの幅として、配列内の先頭のピクチャの
幅が使用されます。ペインタでこのほかに選択できる値は「16」と
「32」で、これらの値はアイコンの標準的な幅のピクセル数です。
解説
ペインタの場合
❖
小さいピクチャの幅を設定する
•
コントロールのプロパティ ビューの[小さいピクチャ]タブ ペー
ジで、
[小さいピクチャの幅]ドロップダウン リストから値を選択
します。
スクリプトの場合
SmallPictureWidth プロパティの値は整数値です。この値は、AddSmallPicture
関数への最初の呼び出しの前か、DeleteSmallPictures 関数の呼び出しの
後にのみ設定できます。この値を 0 に設定すると、小さいピクチャの
サイズとして最初のピクチャのサイズが使用されます。
次の行では、リストビューの小さいピクチャの幅を 16 ピクセルに設定
します。
lv_1.SmallPictureWidth = 16
リストビュー コントロールのスクリプトについての詳細は、『アプリ
ケーション テクニック』マニュアルの「リストビュー コントロールの
使い方」を参照してください。
オブジェクトとコントロール
533
Sorted
Sorted
対象
ドロップダウン リストボックス コントロール、ドロップダウン ピク
チャ リストボックス コントロール、リストボックス コントロール、ピ
クチャ リストボックス コントロール
機能
リストボックス内の項目は、アルファベット順にソートできます。
Sorted プロパティが有効な場合、リストボックス内の項目は昇順に
ソートされます。このプロパティが無効な場合は、リストボックス内
の項目はソートされず、追加された順序で表示されます。
解説
ペインタの場合
❖
自動ソートを有効にする
•
コントロールのプロパティ ビューの[全般]ページで、[ソート]
チェックボックスをオンにします。
スクリプトの場合
Sorted プロパティの値は、ブール値です。次の行では、リストボック
ス lb_1 内の項目がソートされるように指定します。
lb_1.Sorted = TRUE
SortType
対象
リストビュー コントロール、ツリービュー コントロール
機能
SortType プロパティには、項目のソート方法を指定します。項目は、項
目名のアルファベット順に、またはユーザ定義の規則に従ってソート
できます。ユーザ定義または非ソートのソート方法を指定する場合は、
コントロールの Sort イベントにソート条件を定義します。
ツリービュー コントロールでは、各親項目の子孫は、独自のソート方
法によるリストを形成しています。詳細については、
『アプリケーショ
ン テクニック』マニュアルを参照してください。
解説
534
ペインタの場合
❖
項目のソート方法を指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[ソートの
種類]ドロップダウン リストからソートの種類を選択します。
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
SortType プロパティの値は、grSortType カタログ データ型です。次の
行では、リストビュー内の項目に Unsorted を指定します。
lv_1.SortType = Unsorted!
SpacesVisible
対象
リッチテキスト エディット コントロール
機能
SpacesVisible が有効な場合は、リッチテキスト エディット コントロー
ルのテキスト内のスペースがドットで表示されます。このプロパティ
が無効な場合、スペースは単に空白で表示されます。
PopMenu プロパティが TRUE に設定されている場合、ユーザが実行時
にポップアップ メニューの[プロパティ]項目およびツールバーで、
この項目の有効化と無効化を行うことができます。
解説
ペインタの場合
❖
リッチテキスト エディット コントロールのテキスト内のスペースを表示可
能にする
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、[空白記号の表示]チェックボックスをオンにします。
スクリプトの場合
SpacesVisible プロパティの値は、ブール値です。
次の行では、リッチテキスト エディット コントロール内でスペースを
表示可能にします。
rte_1.SpacesVisible = TRUE
オブジェクトとコントロール
535
Spacing
Spacing
対象
グラフ コントロール
機能
Spacing では、グラフ内のデータ マーカー間の間隔(空白)をマーカー
の幅のパーセンテージで定義します。たとえば横棒グラフで、1 つの
横棒の幅を 100 とすると、50 は横棒の幅の半分です。
解説
ペインタの場合
❖
•
データ マーカー間の空白を変更する
グラフ コントロールのプロパティ ビューの[全般]ページにある
[間隔]で、空白の割合を選択します。
スクリプトの場合
Spacing プロパティの値は、整数値です。
次の行では、横棒の幅の 120% を横棒グラフの横棒間の間隔として指
定します。
gr_1.Spacing = 120
Spin
対象
エディットマスク コントロール
機能
Spin プロパティには、コントロールをスピン コントロールとして定義
するかどうかを指定します。スピン コントロールは、ユーザが複数の
固定値を循環させるためにクリックする上矢印と下矢印を含むコント
ロールです。
解説
ペインタの場合
❖
エディットマスクをスピン コントロールにする
•
コントロールのプロパティ ビューの[マスク]タブ ページで、
[ス
ピン]チェックボックスをオンにします。
スクリプトの場合
Spin プロパティの値は、ブール値です。
次の行では、ユーザがエディットマスク内の値を循環させることがで
きるように指定します。
em_1.Spin = TRUE
536
PowerBuilder
第3章
プロパティの説明と使用法
StatePictureHeight
対象
リストビュー コントロール、ツリービュー コントロール
機能
StatePictureHeight プロパティには、すべての状態ピクチャの表示の高
さを指定します。サイズはピクセル単位で指定します。
ペインタで値「デフォルト」を選択した場合、または値を 0 に設定し
た場合は、すべてのピクチャの高さとして、配列内の先頭のピクチャ
の高さが使用されます。ペインタでこのほかに選択できる値は「16」
と「32」で、これらの値はアイコンの標準的な高さのピクセル数です。
解説
ペインタの場合
❖
状態ピクチャの高さを設定する
•
コントロールのプロパティ ビューの[状態]タブ ページで、[状
態ピクチャの高さ]ドロップダウン リストから値を選択します。
スクリプトの場合
StatePictureHeight プロパティの値は、整数値です。この値は、AddStatePicture
関数への最初の呼び出しの前か、DeleteStatePictures 関数の呼び出しの
後にのみ設定できます。この値を 0 に設定すると、状態ピクチャのサ
イズとして先頭のピクチャのサイズが使用されます。
次の行では、リストビューの状態ピクチャの高さを 16 ピクセルに設定
します。
lv_1.StatePictureHeight = 16
リストビュー コントロールのスクリプトについての詳細は、『アプリ
ケーション テクニック』マニュアルの「リストビュー コントロールの
使い方」を参照してください。
StatePictureMaskColor
対象
リストビュー コントロール、ツリービュー コントロール
機能
マスクの色は、ピクチャが表示されるときに透過になる、ピクチャ内
の色です。
新しく追加するユーザ定義のビットマップにマスクする色を選択しま
す。スクリプトでは、各ピクチャを追加する前にマスクの色を変更で
きます。各画像では、その画像が追加された時点で有効だったマスク
の色が使用されます。
オブジェクトとコントロール
537
StatePictureName[ ]
解説
ペインタの場合
❖
ピクチャのマスクの色を指定する
•
コントロールのプロパティ ビューの[状態]タブ ページで、[状
態ピクチャのマスク色]ドロップダウン リストから色を選択しま
す。
色のドロップダウン リストに独自の色を追加するには、プロパティ
ビューを表示する前に[デザイン|色の指定]を選択します。
スクリプトの場合
StatePictureMaskColor プロパティの値は、背景色の数値を指定する long
型の値(-2 ~ 16,777,215)です。このプロパティは、各ビットマップを
追加するときに使用されるため、複数の AddStatePicture の呼び出しの
間に変更できます。
StatePictureMaskColor の値は、色の赤、緑、青(RGB)の 3 要素の値の
組み合わせです。目的の色の long 型の値がわからない場合には、
[デ
ザイン|色の指定]を選択して RGB 値を判別してから、スクリプトで
RGB 関数を呼び出して色を指定します。
次の例では、リストビュー内のユーザ定義のビットマップのマスクの
色として黄色を設定します。
lv_1.StatePictureMaskColor = RGB(255, 255, 0)
StatePictureName[ ]
対象
リストビュー コントロール、ツリービュー コントロール
機能
PowerBuilder では、リストビュー画像はいくつかの画像のインデック
ス付き配列に格納されます。状態ピクチャはリストビュー項目と、そ
の項目にピクチャがあればそれらの左側に表示されます。
状態画像は、スクリプトでのみリストビュー コントロールに関連付け
ることができます。
特定の画像はインデックス番号で識別します。
解説
538
ペインタの場合
❖
状態画像を指定する
1
リストビュー コントロールのプロパティ ビューの[状態]タブ
ページを選択します。
PowerBuilder
第3章
2
プロパティの説明と使用法
次のいずれかの操作を実行します。
• [状態ピクチャ名]フィールドの所定の行に、ピクチャを含む
ファイルの完全なパスとファイル名を入力します。
• [...]ボタンを使用します。
•
リストボックスから 1 つまたは複数のピクチャを選択します。
3 [状態ピクチャ名]リストの行番号を、スクリプトで状態ピクチャ
のインデックスを設定するときのインデックス番号として使用し
ます。
スクリプトの場合
StatePictureName プロパティの値は、文字列です。実行中に
StatePictureName プロパティを使用して画像リストを更新することはで
きません。リストビュー コントロールに状態ピクチャを追加するには、
AddStatePicture 関数を使用します。その例を次に示します。
integer index
index = lv_1.AddStatePicture(“c:\ArtGal\ico\star.ico”)
lv_1.StatePictureIndex = index
リストビュー コントロールのスクリプトについての詳細は、『アプリ
ケーション テクニック』マニュアルの「リストビュー コントロールの
使い方」を参照してください。
StatePictureWidth
対象
リストビュー コントロール、ツリービュー コントロール
機能
StatePictureWidth プロパティは、すべての状態ピクチャの表示幅を指定
します。サイズはピクセル単位で指定します。
ペインタで値「デフォルト」を選択した場合、または値を 0 に設定し
た場合は、すべてのピクチャの幅として、配列内の先頭のピクチャの
幅が使用されます。ペインタでこのほかに選択できる値は「16」と
「32」で、これらの値はアイコンの標準的な幅のピクセル数です。
解説
ペインタの場合
❖
状態ピクチャの幅を設定する
•
コントロールのプロパティ ビューの[状態]タブ ページで、[状
態ピクチャの幅]ドロップダウン リストから値を選択します。
オブジェクトとコントロール
539
Status
スクリプトの場合
StatePictureWidth プロパティの値は、整数値です。この値は、AddStatePicture
関数への最初の呼び出しの前か、DeleteStatePictures 関数の呼び出しの
後にのみ設定できます。この値を 0 に設定すると、状態ピクチャのサ
イズとして先頭のピクチャのサイズが使用されます。
次の行では、リストビューの状態ピクチャの幅を 16 ピクセルに設定し
ます。
lv_1.StatePictureWidth = 16
リストビュー コントロールのスクリプトについての詳細は、
『アプリ
ケーション テクニック』マニュアルの「リストビュー コントロールの
使い方」を参照してください。
Status
対象
インクエディット コントロール、インクピクチャ コントロール
機能
ストロークが完了したことを確認するために、ユーザが Stroke イベン
トを監視する必要がないように、コントロールの現行のステータスを
提供する実行時に有効な読み出し専用のプロパティです。
解説
スクリプトの場合
インクエディット コントロールの Status プロパティの値は、
InkEditStatus カタログデータ型変数の値です。プロパティの値は、
InkEditCollectingInk!、InkEditRecognizingInk!、および InkEditIdle! で
す。
インクピクチャ コントロールの Status プロパティの値は、InkPicStatus
カタログデータ型変数の値です。プロパティの値は、CollectingInk! お
よび Idle! です。
ボタンの Clicked イベントのこのコードは、UseMouseForInput プロパ
ティを true に設定する前に、インクエディット コントロールのステー
タスがアイドルであることを確認します。
IF ie_1.Status = InkEditIdle! THEN
ie_1.UseMouseForInput = TRUE
ELSE
MessageBox("Please try again later",
"Text is being recognized.")
END IF
540
&
PowerBuilder
第3章
プロパティの説明と使用法
StdHeight
対象
水平スクロールバー コントロール
機能
StdHeight プロパティを有効にすると、水平スクロールバーはシステム
標準の高さで表示されます。
解説
ペインタの場合
❖
標準の高さを有効にする
•
コントロールのプロパティ ビューの[全般]ページで、
[標準高さ]
チェックボックスをオンにします。
スクリプトの場合
StdHeight プロパティの値は、ブール値です。実行時に、StdHeight が TRUE
である間は、Height プロパティの設定が無効になります。StdHeight プ
ロパティを TRUE に設定すると、スクロールバーは標準の高さで表示
されます。StdHeight プロパティを FALSE に設定すると、スクロール
バーは、Height プロパティで指定した高さで表示されます。
次の行では、水平スクロールバーが標準の高さではなく、Height プロ
パティで指定した高さに設定されるように指定します。
hsb_1.StdHeight = FALSE
StdWidth
対象
垂直スクロールバー コントロール
機能
StdWidth オプションを有効にすると、垂直スクロールバーはシステム
標準の幅で表示されます。
解説
ペインタの場合
❖
標準幅を有効にする
•
コントロールのプロパティ ビューの[全般]ページで、[標準幅]
チェックボックスをオンにします。
スクリプトの場合
StdWidth プロパティの値は、ブール値です。実行時に、StdWidth が TRUE
である間は、Width プロパティの設定が無効になります。StdWidth プ
ロパティを TRUE に設定すると、スクロールバーは標準の幅で表示さ
れます。StdWidth プロパティを FALSE に設定すると、スクロールバー
は、Width プロパティで指定した幅で表示されます。
オブジェクトとコントロール
541
TabOrder
次の行では、垂直スクロールバーが標準の幅ではなく、Width プロパ
ティで指定した幅に設定されるように指定します。
vsb_1.StdWidth = FALSE
TabOrder
対象
ウィンドウ内の表示可能なコントロール
機能
TabOrder には、ユーザがウィンドウ内のコントロール間をタブ移動す
るときにコントロールがフォーカスを受け取る順序を指定します。コ
ントロールの TabOrder を 0 に設定すると、そのコントロールにタブ移
動できません。
解説
ペインタの場合
❖
ウィンドウ内のコントロールのタブ順序を設定する
1
メニューバーの[書式|タブ順序を表示]を選択します。
表示可能な各コントロールのタブ順序を示す数値が、ウィンドウ
に赤で表示されます。
2
変更したい数値を選択して、0 ~ 9999 の新しい数値を入力します。
数値の実際の値は重要ではなく、コントロール間の相対値を表し
ているだけです。
3
再びメニューバーの[書式|タブ順序を表示]を選択して、タブ
順序を保存します。
スクリプトの場合
TabOrder プロパティの値は、0 ~ 9999 の整数値です。値 0 を指定する
と、そのコントロールがタブ順序から削除されます。
次の例では、3 つのコントロールのタブ順序を設定します。エディッ
トマスク コントロールは、リストビュー コントロールの後でコマンド
ボタン コントロールの前にタブ移動されます。
lv_1.TabOrder = 10
em_1.TabOrder = 15
cb_1.TabOrder = 20
542
PowerBuilder
第3章
プロパティの説明と使用法
TabPosition
対象
タブ コントロール
機能
タブは、タブ コントロール内の任意の側(上部、下部、左、右)また
は 2 つの向かい合った側に表示することができます。
2 つの側、たとえば上部と下部を選択した場合は、選択したタブを基
準にタブが分割されて、前のタブが片側に表示され、後続のタブが反
対側に表示されます。選択したタブ自体は、最初の側に表示されます。
解説
ペインタの場合
❖
タブ コントロール内のタブ ページの位置を設定する
•
タブ コントロールのプロパティ ビューの[全般]ページで、[タ
ブの位置]ドロップダウン リストから位置の種類を選択します。
スクリプトの場合
TabPosition プロパティのデータ型は、TabPosition カタログ データ型で
す。
次の例では、タブをタブ コントロールの上部と下部に配置します。選
択したタブより前のタブと選択したタブ自体は上部に配置されます。
選択したタブの後に続くタブは下部に配置されます。
tab_1.TabPosition = TabsOnTopAndBottom!
TabStop[ ]
対象
マルチライン エディット コントロール、エディットマスク コントロー
ル、リストボックス コントロール、ピクチャ リストボックス コント
ロール
機能
TabStop プロパティ配列を使用すると、繰り返しのタブ ストップまた
は複数のタブ ストップを任意の位置に指定できます。タブ ストップ
は、文字の位置で示されます。
値を 1 つ指定した場合は、タブ ストップはこの値を使用して均等な間
隔で配置されます。複数のタブ ストップを指定した場合は、タブ ス
トップは入力した文字位置に配置されます。デフォルトは 8 文字位置
ごとのタブ ストップです。
オブジェクトとコントロール
543
TabTextColor
解説
ペインタの場合
❖
タブ ストップを指定する
•
コントロールのプロパティ ビューの[全般]ページで、[タブス
トップの位置]フィールドに各タブ ストップに対する文字位置を
入力します。
スクリプトの場合
TabStop[ ] プロパティは、タブ ストップの位置を含む符号付き整数配
列です。タブ ストップは文字位置で指定します。
次の行では、2 つのタブ ストップを文字位置 5 と 15 に定義します。
lb_1.tabstop[1] = 5
lb_1.tabstop[2] = 15
TabTextColor
対象
TabPage オブジェクトとタブ ページのユーザ オブジェクト
機能
TabTextColor プロパティを使用すると、タブのテキストの色を選択で
きます。
解説
ペインタの場合
色のドロップダウン リストに独自の色を追加するには、プロパティ
ビューを表示する前に[デザイン|色の指定]を選択します。
❖
タブのテキストの色を変更する
1
タブ コントロールのタブ ページを選択します。
2
プロパティ ビューの[タブページ]タブを選択します。
3 [タブの文字の色]ドロップダウン リストから色を選択します。
スクリプトの場合
TabTextColor プロパティは、色の数値を指定する long 型の値(-2 ~
16,777,215)をとります。TabTextColor の値は、色の赤、緑、青(RGB)
の 3 要素の値の組み合わせです。
目的の色の long 型の値がわからない場合には、
[デザイン|色の指定]
を選択して RGB 値を判別してから、スクリプトで RGB 関数を呼び出
して色を指定します。
次の例では、タブのテキストの色として黄色を設定します。
544
PowerBuilder
第3章
プロパティの説明と使用法
tab_1.tabpage_2.TabTextColor = RGB(255, 255, 0)
TabBackColor
対象
TabPage オブジェクトとタブ ページのユーザ オブジェクト
機能
TabBackColor プロパティを使用すると、タブ ページ上のタブの色を選
択できます。
Windows XP
このプロパティは、Windows XP ではサポートされていません。
Windows XP では、タブ ページ上のタブの外観は現行の XP テーマに
よって制御されるからです。
解説
ペインタの場合
色のドロップダウン リストに独自の色を追加するには、プロパティ
ビューを表示する前に[デザイン|色の指定]を選択します。
❖
タブの背景色を設定する
1
タブ コントロールのタブ ページを選択します。
2
プロパティ ビューの[タブページ]タブを選択します。
3 [タブの背景色]ドロップダウン リストから色を選択します。
[全般]タブでは、タブ ページ本体の色を設定できます。
スクリプトの場合
TabBackColor プロパティは、色の数値を指定する long 型の値(-2 ~
16,777,215)をとります。TabBackColor の値は、色の赤、緑、青(RGB)
の 3 要素の値の組み合わせです。
目的の色の long 型の値がわからない場合には、
[デザイン|色の指定]
を選択して RGB 値を判別してから、スクリプトで RGB 関数を呼び出
して色を指定します。
次の例では、タブの背景色として青を設定します。
tab_1.tabpage_2.TabBackColor = RGB(0, 0, 255)
オブジェクトとコントロール
545
TabsVisible
TabsVisible
対象
リッチテキスト エディット コントロール
機能
TabsVisible プロパティが有効な場合は、リッチテキスト エディット コ
ントロールのテキストにタブのテキスト記号が表示されます。ユーザ
が実行時にツールバーまたはポップアップ メニューの[プロパティ]
項目から(PopMenu が有効な場合)このプロパティの有効化と無効化
を行うことができます。
解説
ペインタの場合
❖
•
タブ記号を表示可能にする
リッチテキスト エディット コントロールのプロパティ ビューの
[ドキュメント]タブ ページで、[タブ記号の表示]チェックボッ
クスをオンにします。
スクリプトの場合
TabsVisible プロパティの値は、ブール値です。次の行では、リッチテ
キスト エディット コントロールでタブ記号の表示を有効にします。
rte_1.TabsVisible = TRUE
Tag
対象
すべてのコントロール、ユーザ オブジェクト、およびメニュー
機能
Tag プロパティには、コントロールに関連付ける任意のテキストを格
納できます。テキストの用途は自由に決めることができます。
解説
ペインタの場合
❖
コントロールのタグを指定する
•
オブジェクトのプロパティ ビューの[全般]ページで、[タグ]
フィールドにテキストを入力します。
スクリプトの場合
Tag プロパティの値は、文字列です。
次の行では、オブジェクトの Tag プロパティを使用して、MDI フレー
ムに MicroHelp を設定します(コードは GetFocus イベント内に存在す
る可能性があります。また、Menu オブジェクトの場合は Selected イベ
ント内に存在する可能性があります)。
546
PowerBuilder
第3章
プロパティの説明と使用法
w_frame.SetMicroHelp(This.Tag)
Text
対象
テキストを表示するメニューとコントロール
機能
Text プロパティには、メニュー オブジェクトまたはコントロールに表
示されるテキストを指定します。
メニュー項目にショートカット キー(たとえば〔F1〕や〔Alt〕+〔A〕
)
がある場合は、Text にもそのショートカット キーを指定します。メ
ニュー項目の Text プロパティがシングル ダッシュ(-)の場合、その
項目はセパレータ(メニュー幅の水平線)として表示され、この項目
のそのほかのプロパティはすべて無視されます。
解説
ペインタの場合
❖
表示されるテキストを指定する
•
オブジェクトのプロパティ ビューの[全般]ページで、[テキス
ト]フィールドにテキストを入力します。
スクリプトの場合
Text プロパティの値は、文字列です。次の行では、チェックボックス
のテキストを Male に指定します。
cb_1.Text = "Male"
TextCase
対象
エディットマスク コントロール、マルチライン エディット コントロー
ル、シングルライン エディット コントロール
機能
TextCase プロパティを使用すると、ユーザが入力するテキストの大文
字と小文字の処理を制御できます。テキストは、ユーザが入力したと
おり、すべて小文字、またはすべて大文字で表示することができます。
オブジェクトとコントロール
547
TextCase
解説
ペインタの場合
❖
ユーザが入力するテキストの表示に使用される、大文字と小文字の処理を選
択する
•
コントロールのプロパティ ビューの[全般]タブ ページで、[大
文字 / 小文字]ドロップダウン リストから大文字と小文字の処理
方法を選択します。
スクリプトの場合
TextCase プロパティの値は、TextCase カタログ データ型です。次の行
では、マルチライン エディットのユーザ入力テキストをすべて大文字
に設定します。
mle_1.TextCase = Upper!
548
PowerBuilder
第3章
プロパティの説明と使用法
TextColor
対象
テキストを表示するコントロールとオブジェクト
機能
TextColor プロパティには、コントロール内のテキストに使用される色
を指定します。
月表示カレンダ コントロールの場合、TextColor プロパティに指定され
た色は、月のテキストの表示に使用されます。
解説
ペインタの場合
❖
ほとんどのコントロールのテキストの色を設定する
•
コントロールとオブジェクトの[フォント]タブ ページで、
[文字
の色]ドロップダウン リストから色を選択します。
❖
グラフ オブジェクトと月表示カレンダ コントロールのテキストの色を設定
する
•
プロパティ ビューの[全般]ページで、
[文字の色]ドロップダウ
ン リストから色を選択します。
❖
グラフ内のテキスト オブジェクトのテキストの色を設定する
1
グラフのプロパティ ビューの[テキスト]タブ ページを選択しま
す。
2 [テキスト オブジェクト]ドロップダウン リストからテキスト オ
ブジェクトを選択します。
3 [文字の色]ドロップダウン リストから色を選択します。
スクリプトの場合
TextColor プロパティは、オブジェクトの背景に使用される色を示す
long 型の値をとります。目的の色の long 型の値がわからない場合には、
[デザイン|色の指定]を選択して RGB 値を判別してから、スクリプ
トで RGB 関数を呼び出して色を指定します。
グラフでは、TextColor プロパティは、グラフ内の grDispAttr オブジェ
クトとグラフ オブジェクトのプロパティです。たとえば、次の行では、
系列軸のすべてのテキスト オブジェクトのテキストの色を設定しま
す。
gr_1.Series.DispAttr.TextColor = RGB(0,0,255)
オブジェクトとコントロール
549
TextSize
TextSize
対象
テキストを表示可能なコントロール
機能
TextSize プロパティには、コントロール内のテキストのポイント サイ
ズを指定します。
解説
ペインタの場合
❖
コントロール内のすべてのテキストのサイズを設定する
•
コントロールのプロパティ ビューの[フォント]タブ ページを表
示して、
[サイズ]ドロップダウン リストからポイント サイズを
選択するか、コントロールを選択して、スタイルバーの[フォン
ト サイズ]リスト ボックスを使用してポイント サイズを設定しま
す。
❖
グラフ コントロール内のテキスト オブジェクトのサイズを設定する
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示して、[テキスト オブジェクト]リストからテキスト オ
ブジェクトを選択します。
2 [サイズ]リストからポイント サイズを選択します。
スクリプトの場合
TextSize プロパティは、ポイント サイズを示す整数値をとります。次
の例では、スタティック テキスト コントロールのポイント サイズを
設定します。
st_1.TextSize = 12
次の例では、グラフ コントロールの値軸のラベルのポイント サイズを
設定します。
gr_1.Values.LabelDispAttr.TextSize = 12
ThreeState
対象
チェックボックス コントロール
機能
ThreeState プロパティには、コントロールに 3 つの状態を表示可能かど
うかを指定します。通常、状態は選択と非選択の切り替えです。チェッ
クボックスでは、ThreeState プロパティが有効になっている場合は、コ
ントロールの状態が第 3 の状態にも切り替わります。第 3 の状態は、
グレー表示のマークで表示されます。
550
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
チェックボックスに 3 つの状態を表示可能にする
•
コントロールのプロパティ ビューの[全般]ページで、
[3 種類の
状態]チェックボックスをオンにします。
スクリプトの場合
ThreeState プロパティの値は、ブール値です。次の行では、チェック
ボックスに 3 つの状態が表示され、デフォルトで第 3 の状態になって
いるように指定します。
cbx_1.ThreeState = TRUE
cbx_1.ThirdState = TRUE
ThirdState
対象
チェックボックス コントロール
機能
ThirdState プロパティには、チェックボックスが(選択状態でも非選択
状態でもなく)第 3 の状態になっているかどうかを指定します。
チェックボックスを第 3 の状態にするには、ThreeState プロパティも有
効になっている必要があります。
解説
ペインタの場合
❖
チェックボックスが第 3 の状態になるよう指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[3 種類の
状態]および[グレー状態]チェックボックスをオンにします。
スクリプトの場合
ThirdState プロパティの値は、ブール値です。次の行では、チェック
ボックスに 3 つの状態が表示され、デフォルトで第 3 の状態になって
いるように指定します。
cbx_1.ThreeState = TRUE
cbx_1.ThirdState = TRUE
オブジェクトとコントロール
551
Title
Title
対象
データウィンドウ コントロール、グラフ コントロール、ウィンドウ
機能
Title プロパティには、コントロールまたはウィンドウのタイトル テキ
ストを指定します。ウィンドウまたはデータウィンドウ コントロール
では、この値は TitleBar プロパティも有効な場合にのみ表示されます。
解説
ペインタの場合
❖
タイトル テキストを指定する
•
コントロールのプロパティ ビューの[全般]ページで、
[タイトル]
フィールドにタイトル テキストを入力し、
[タイトル バー]チェッ
クボックスをオンにします。
スクリプトの場合
Title プロパティの値は、文字列です。次の行では、データウィンドウ
コントロール dw_1 のタイトルを設定します。
dw_1.TitleBar = TRUE
dw_1.Title = "Monthly Report"
TitleBackColor
対象
月表示カレンダ コントロール
機能
TitleBackColor プロパティは、カレンダのタイトルの背景に使用する色
を定義します。
解説
ペインタの場合
プロパティ ビューの[全般]ページで、[タイトルの背景色]ドロッ
プダウン リストから色を選択します。
スクリプトの場合
TitleBackColor プロパティの値は long 型(-2 から 16,777,215)で、カレ
ンダのタイトルの背景色の数値を指定します。TitleBackColor の値は、
色の赤、緑、青(RGB)の 3 要素の値の組み合わせです。
目的の色の long 型の値がわからない場合には、
[デザイン|色の指定]
を選択して RGB 値を判別してから、スクリプトで RGB 関数を呼び出
して色を指定します。
552
PowerBuilder
第3章
プロパティの説明と使用法
次の例では、タイトルの背景色として薄緑を設定します。
mc_1.TitleBackColor = RGB(128, 255, 128)
TitleBar
対象
データウィンドウ コントロール、ウィンドウ
機能
TitleBar プロパティには、データウィンドウ コントロールまたはウィ
ンドウにタイトル バーが表示されるかどうかを指定します。ウィンド
ウまたはデータウィンドウ コントロールにタイトル バーがある場合
のみ、ユーザはこれらのウィンドウまたはコントロールを移動できま
す。
ウィンドウの種類が MicroHelp 付きまたは MicroHelp なしのメイン
ウィンドウまたは MDI フレーム ウィンドウの場合、TitleBar プロパ
ティは常に有効です。タイトル バーが有効な場合は、コントロール メ
ニューと最大化および最小化ボックスをタイトル バーに組み込むか
どうかを選択できます。
解説
ペインタの場合
❖
タイトル バーを表示する
•
データウィンドウ コントロールまたはウィンドウのプロパティ
ビューの[全般]ページで、[タイトル バー]チェックボックス
をオンにします。
スクリプトの場合
データウィンドウ コントロールの場合は、TitleBar プロパティをスク
リプトで変更できますが、ウィンドウの場合は変更できません。
TitleBar プロパティの値は、ブール値です。次の行では、データウィン
ドウ コントロール dw_1 にタイトル バーが表示されるように指定しま
す。
dw_1.TitleBar = TRUE
オブジェクトとコントロール
553
TitleTextColor
TitleTextColor
対象
月表示カレンダ コントロール
機能
TitleTextColor プロパティは、カレンダのタイトルのテキストに使用さ
れる色を指定します。
解説
ペインタの場合
プロパティ ビューの[全般]ページで、[タイトルの色]ドロップダ
ウン リストから色を選択します。
スクリプトの場合
TitleTextColor プロパティは、カレンダのタイトルに使用される色を示
す long 型の値をとります。目的の色の long 型の値がわからない場合に
は、[デザイン|色の指定]を選択して RGB 値を判別してから、スク
リプトで RGB 関数を呼び出して色を指定します。
たとえば、次の行では、コントロール mc_1 のタイトルのテキストの
色を設定します。
mc_1.TitleTextColor = RGB(0,0,255)
TodayCircle
対象
月表示カレンダ コントロール
機能
カレンダ上の今日の日付を赤い円または長方形で囲んでハイライト表
示するかどうかを指定します。このインジケータの形は、オペレーティ
ング システムとディスプレイの設定によって決まります。TodaySection
プロパティが TRUE の場合、インジケータは今日の日付の左側に表示
されます。
解説
ペインタの場合
❖
TodayCircle プロパティを設定する
•
プロパティ ビューの[全般]ページで、
[今日の位置表示]チェッ
クボックスをオンまたはオフにします。
スクリプトの場合
TodayCircle プロパティの値はブール値です。デフォルト値は TRUE で
す。次の例では、TodayCircle プロパティをオフにします。
mc_1.TodayCircle = false
554
PowerBuilder
第3章
プロパティの説明と使用法
TodaySection
対象
月表示カレンダ コントロール
機能
カレンダの下部に、「今日 :」というラベルに続けて今日の日付を表示
するかどうかを指定します。TodayCircle プロパティが TRUE の場合、
この Today セクションの左側に赤い長方形が表示されます。
解説
ペインタの場合
❖
TodaySection プロパティを設定する
•
プロパティ ビューの[全般]ページで、
[今日の日付表示]チェッ
クボックスをオンまたはオフにします。
スクリプトの場合
TodaySection プロパティの値はブール値です。デフォルト値は TRUE で
す。次の例では、TodaySection プロパティをオフにします。
mc_1.TodaySection = false
ToolbarAlignment
対象
ウィンドウ
機能
ToolbarAlignment では、MDI フレーム ウィンドウでのツールバーの表
示位置を指定します。
解説
ペインタの場合
❖
•
ツールバーの配置を指定する
ウィンドウのプロパティ ビューの[ツールバー]タブ ページで、
[ツールバーの配置]ドロップダウン リストから配置の種類を選択
します。
スクリプトの場合
ToolbarAlignment プロパティの値は、ToolbarAlignment カタログ データ
型です。
次の行では、ウィンドウ w_1 のツールバーがツールバー ドック内にど
のように配置されるかを指定します。
This.ToolbarAlignment = AlignAtRight!
オブジェクトとコントロール
555
ToolbarHeight
ToolbarHeight
対象
ウィンドウ
機能
ToolbarHeight プロパティには、MDI フレーム ウィンドウのツールバー
が浮動型ツールバーである場合に、その高さを指定します。
解説
ペインタの場合
❖
•
ツールバーの高さを指定する
ウィンドウのプロパティ ビューの[ツールバー]タブ ページで、
[ツールバーの高さ]フィールドに高さを入力します。
スクリプトの場合
ToolbarHeight プロパティの値は、整数値です。
次の行では、ウィンドウのツールバーの高さを設定します。
This.ToolbarHeight = 100
ToolbarVisible
対象
ウィンドウ
機能
ToolbarVisible では、MDI フレーム ウィンドウのツールバーが表示され
るかどうかを指定します。
解説
ペインタの場合
❖
•
ツールバーを表示可能にする
ウィンドウのプロパティ ビューの[ツールバー]タブ ページで、
[ツールバーの表示]チェックボックスをオンにします。
スクリプトの場合
ToolbarVisible プロパティの値は、ブール値です。
次の行では、ウィンドウのツールバーが表示されるように指定します。
This.ToolbarVisible = TRUE
556
PowerBuilder
第3章
プロパティの説明と使用法
ToolbarWidth
対象
ウィンドウ
機能
ToolbarWidth プロパティは、MDI フレーム ウィンドウのツールバーが
浮動型ツールバーである場合に、その幅を指定します。
解説
ペインタの場合
❖
•
ツールバーの幅を指定する
ウィンドウのプロパティ ビューの[ツールバー]タブ ページで、
[ツールバーの幅]フィールドに幅を入力します。
スクリプトの場合
ToolbarWidth プロパティの値は、整数値です。
次の行では、ウィンドウのツールバーの幅を設定します。
This.ToolbarWidth = 500
ToolbarX
対象
ウィンドウ
機能
ToolbarX プロパティは、ツールバーが浮動型ツールバーである場合に、
その X 座標を PowerBuilder 単位系で指定します。X 座標は、ウィンド
ウまたは画面の左端からの距離です。
解説
ペインタの場合
❖
•
ツールバーの X 座標を指定する
ウィンドウのプロパティ ビューの[ツールバー]タブ ページで、
[ツールバー X]フィールドに値を PowerBuilder 単位系で入力しま
す。
スクリプトの場合
ToolbarX プロパティの値は、整数値です。
次の行では、ウィンドウの左端から約 5 ピクセルの距離をツールバー
に指定します。
This.ToolbarX = 20
オブジェクトとコントロール
557
ToolbarY
ToolbarY
対象
ウィンドウ
機能
ToolbarY プロパティには、ツールバーが浮動型ツールバーである場合
に、その Y 座標を PowerBuilder 単位系で指定します。Y 座標は、ウィ
ンドウまたは画面の上部からの距離です。
解説
ペインタの場合
❖
•
ツールバーの Y 座標を指定する
ウィンドウのプロパティ ビューの[ツールバー]タブ ページで、
[ツールバー Y]フィールドに値を PowerBuilder 単位系で入力しま
す。
スクリプトの場合
ToolbarY プロパティの値は、整数値です。次の行では、ウィンドウの
上部から約 4 ピクセルの距離をツールバーに指定します。
This.ToolbarX = 15
ToolBar
対象
リッチテキスト エディット コントロール
機能
ToolBar プロパティが有効な場合は、テキストの書式指定用のツール
バーがリッチテキスト エディット コントロールの編集領域の上に表
示されます。ツールバーには、太字、斜体、アンダースコア、取り消
し線、位置揃え、間隔調整、上付き文字、添え字、タブ、パラグラフ
リターンなどのテキスト記号表示、およびテキストの色が含まれます。
コントロールの幅が十分でない場合、ツールバーは切り捨てられます。
PopMenu プロパティが TRUE に設定されている場合、ユーザが実行時
にポップアップ メニューの[プロパティ]項目からツールバーの有効
化と無効化を行うことができます。
解説
558
ペインタの場合
❖
リッチテキスト エディット コントロールにツールバーを表示する
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、
[ツールバーの表示]チェックボックスをオンにします。
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
ToolBar プロパティの値は、ブール値です。次の行では、ツールバーを
リッチテキスト エディットに表示させます。
rte_1.ToolBar = TRUE
TopMargin
対象
リッチテキスト エディット コントロール
機能
TopMargin プロパティには、印刷ページの上余白のサイズをインチ単
位で指定します。
解説
ペインタの場合
❖
•
上余白を設定する
リッチテキスト エディット コントロールのプロパティ ビューの
[ドキュメント]タブ ページで、[上余白]フィールドにサイズを
インチ単位で入力します。
スクリプトの場合
TopMargin プロパティの値は long 型です。次の行では、リッチテキス
ト エディットの上余白を 1 インチに設定します。
rte_1.TopMargin = 1
TrailingTextColor
対象
月表示カレンダ コントロール
機能
TrailingTextColor プロパティは、カレンダの先頭部分の日付と末尾部分
の日付のテキストに使用される色を指定します。
解説
ペインタの場合
プロパティ ビューの[全般]ページで、[トレイル部分の色]ドロッ
プダウン リストから色を選択します。
オブジェクトとコントロール
559
Transparent
スクリプトの場合
TrailingTextColor プロパティは、カレンダの先頭部分の日付と末尾部分
の日付に使用される色を示す long 型の値をとります。これらの日付は、
カレンダに一部が表示されている月の日付です。カレンダに 1 か月が
表示されている場合、これらの日付は前月の最後の数日と次月の最初
の数日です。カレンダに 7 月から 9 月までの 3 か月が表示されている
場合、先頭部分の日付は 6 月の最後の数日、末尾部分の日付は 10 月の
最初の数日です。デフォルトの色は、選択の無効を示す色です。
目的の色の long 型の値がわからない場合には、
[デザイン|色の指定]
を選択して RGB 値を判別してから、スクリプトで RGB 関数を呼び出
して色を指定します。
次の例では、コントロール mc_1 の末尾部分の日付の色を「非アクティ
ブ タイトル バー」の色に設定します。
mc_1.TrailingTextColor = 134217731
Transparent
対象
アニメーション コントロール
機能
Transparent プロパティが有効な場合、アニメーション コントロールは、
そのコンテナと同じ背景色を使用することによって透過になります。
この場合、Border プロパティを False に設定する必要があります。
解説
ペインタの場合
❖
コントロールを透過にする
•
コントロールのプロパティ ビューの[全般]ページで、
[透過]チェッ
クボックスをオンにします。
スクリプトの場合
Transparent プロパティの値はブール値です。次の例では、Transparent
プロパティを TRUE に設定します。
am_1.Transparent = TRUE
560
PowerBuilder
第3章
プロパティの説明と使用法
Underline
対象
テキストを表示するコントロール
機能
Underline は、コントロール内のテキストのプロパティです。
解説
ペインタの場合
❖
•
コントロール内のすべてのテキスト項目を下線付きにする
コントロールのプロパティ ページの[フォント]タブ ページで、
[下線]チェックボックスをオンにするか、コントロールを選択し
て、スタイルバーの[U]ボタンをクリックします。
❖
グラフ コントロール内のテキスト オブジェクトを下線付きにする
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示して、[テキスト オブジェクト]リストからテキスト オ
ブジェクトを選択します。
2 [テキスト]タブ ページの[下線]チェックボックスをオンにします。
スクリプトの場合
Underline プロパティの値は、ブール値です。次の例では、スタティッ
ク テキスト コントロール内のテキストを下線付きにします。
st_1.Underline = TRUE
次の例では、グラフ コントロール内の値軸のラベルを下線付きにしま
す。
gr_1.Values.LabelDispAttr.Underline = TRUE
UndoDepth
対象
リッチテキスト エディット コントロール
機能
UndoDepth プロパティには、Undo 関数によって取り消される編集上の
変更の最大回数を指定します。Undo を 1 回呼び出すたびに、編集上の
変更が 1 回ずつ元に戻ります。取り消す変更がなくなると、CanUndo
関数によって FALSE が返されます。
解説
ペインタの場合
❖
取り消し可能な編集上の変更回数を指定する
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、[元に戻す回数]フィールドに回数を入力します。
オブジェクトとコントロール
561
UnitsPerColumn
スクリプトの場合
UndoDepth プロパティの値は、整数値です。次の行では、UndoDepth
を 5 レベルに設定します。
rte_1.UndoDepth = 5
UnitsPerColumn
対象
ウィンドウとユーザ オブジェクト
機能
UnitsPerColumn では、ユーザがウィンドウまたはユーザ オブジェクト
の水平スクロールバーの左矢印または右矢印をクリックしたときに、
右または左にスクロールされる PowerBuilder 単位系の数を指定しま
す。デフォルトは 0(ウィンドウまたはユーザ オブジェクトの幅の
1/100)です。UnitsPerColumn が 0 の場合、自動的に水平スクロールが
制御されます。
PowerBuilder では、ユーザがスクロールバー内をクリックしたときに
ウィンドウが左右にスクロールされる PowerBuilder 単位系の数を決定
するには、UnitsPerColumn と ColumnsPerPage を乗算します。
ColumnsPerPage と UnitsPerColumn の計算については、581 ページの
「ウィンドウおよびユーザ オブジェクト内でのスクロール」を参照し
てください。
使用上の注意
ウィンドウまたはユーザ オブジェクトの垂直スクロールバーを制御す
るには、UnitsPerLine プロパティと LinesPerPage プロパティを使用します。
解説
ペインタの場合
❖
•
UnitsPerColumn プロパティを指定する
ウィンドウのプロパティ ビューの[スクロール]タブ ページで、
[カラムの単位]フィールドに数値を PowerBuilder 単位系で入力し
ます。
スクリプトの場合
UnitsPerColumn プロパティの値は、整数値です。
次の文では、UnitsPerColumn を、内容幅 1650 に合わせて 12 に設定し
ます。
This.UnitsPerColumn = 12
562
PowerBuilder
第3章
プロパティの説明と使用法
UnitsPerLine
対象
ウィンドウ、ユーザ オブジェクト
機能
UnitsPerLine では、ユーザがウィンドウまたはユーザ オブジェクトの
垂直スクロールバーの上矢印または下矢印をクリックしたときに、上
または下にスクロールされる PowerBuilder 単位系の数を指定します。
デフォルトは 0(ウィンドウまたはユーザ オブジェクトの高さの
1/100)です。UnitsPerLine が 0 の場合、PowerBuilder によって自動的に
垂直スクロールが制御されます。
PowerBuilder では、ユーザがスクロールバー内をクリックしたときに
ウィンドウまたはユーザ オブジェクトが上下にスクロールされる
PowerBuilder 単位系の数を決定するには、UnitsPerPage と UnitsPerLine
を乗算します。
LinesPerPage と UnitsPerLine の計算については、581 ページの「ウィン
ドウおよびユーザ オブジェクト内でのスクロール」を参照してくださ
い。
使用上の注意
ウィンドウまたはユーザ オブジェクトの水平スクロールを制御する
には、UnitsPerColumn プロパティと ColumnsPerPage プロパティを使用
します。
解説
ペインタの場合
❖
•
UnitsPerLine プロパティを設定する
ウィンドウのプロパティ ビューの[スクロール]タブ ページで、
[行の単位]フィールドに数値を PowerBuilder 単位系で入力しま
す。
スクリプトの場合
UnitsPerLine プロパティの値は、整数値です。
次の文では、UnitsPerLine を、内容の長さ 2400 に合わせて 17 に設定し
ます。
lb_1.UnitsPerLine = 17
オブジェクトとコントロール
563
UseCodeTable
UseCodeTable
対象
エディットマスク コントロール
機能
エディットマスク コントロールがスピン コントロール(ユーザが複数
の定義済みの値を循環させるためにクリックする上矢印と下矢印を含
むコントロール)として定義されている場合は、コード表をデータの
検証に使用できます。
UseCodeTable プロパティには、コントロールでコード表がデータの検
証に使用されるかどうかを指定します。
解説
ペインタの場合
❖
エディットマスク コントロールでのコード表の使用を指定する
1
コントロールのプロパティ ビューの[マスク]タブ ページで、
[ス
ピン]および[コード表を使用]チェックボックスをオンにします。
タブ ページの下半分に領域が表示され、そこにコード表の値を入
力できます。
2 [表示の値]とそれに対応する[データの値]を指定します。
〔Enter〕を押して、このリストに項目を挿入します。
スクリプトの場合
UseCodeTable プロパティの値は、ブール値です。次の例では、エディッ
トマスク コントロールでコード表がデータの検証に使用されるよう
に指定します。
em_1.UseCodeTable = TRUE
スクリプトで DisplayData プロパティを使用して、コード表の内容を指
定することができます。Display 値とそれに対応する Data 値をテキス
ト文字列で入力します。Display 値と Data 値をタブで区切って組み合
わせ、各組み合わせはスラッシュで区切ります。その例を次に示しま
す。
em_1.DisplayData = "Black
564
1/White
2/Red
3"
PowerBuilder
第3章
プロパティの説明と使用法
UseMouseForInput
対象
インクエディット コントロール、インクピクチャ コントロール
機能
タブレット PC で入力にマウスを使用できるかどうかを指定します。こ
のプロパティはほかのコンピュータには影響しません。
解説
ペインタの場合
❖
インクをマウスを使用して追加できることを指定する
•
プロパティ ビューの[インク]ページで、[マウスを入力に使用]
チェックボックスを選択します。
スクリプトの場合
UseMouseForInput プロパティの値は boolean 値です。実行時に、コン
トロールがインクを収集または認識している間は、このプロパティを
変更しないでください。
ボタンの Clicked イベントのこのコードは、UseMouseForInput プロパ
ティを true に設定する前に、インクエディット コントロールのステー
タスがアイドルであることを確認します。
IF ie_1.Status = InkEditIdle! THEN
ie_1.UseMouseForInput = TRUE
ELSE
MessageBox("Please try again later",
"Text is being recognized.")
END IF
&
View
対象
リストビュー コントロール
機能
リストビューには、次の 4 つの項目表示方法があります。
項目は左から右に配置され、ドラッグ アン
ド ドロップが有効な場合には、ユーザは項目を自由に移動できま
す。各項目のピクチャは大きいピクチャのリストから取得され、項
目ラベルがピクチャの下に表示されます。
•
大きいアイコン ビュー
•
小さいアイコン ビュー 大きいアイコン ビューと同じですが、各項
目のピクチャは小さいピクチャ リストから取得され、項目ラベル
はピクチャの右側に表示されます。
オブジェクトとコントロール
565
View
解説
項目は上から下に配置されます。各項目のピクチャは
小さいピクチャの配列から取得されます。
•
一覧ビュー
•
詳細ビュー 項目は上から下に配置され、各項目に 1 つまたは複数
の情報カラムが付けられます。カラムを設定するスクリプトを作
成する必要があります。
ペインタの場合
❖
ビューの種類を選択する
•
コントロールのプロパティ ビューの[全般]ページで、[ビュー]
ドロップダウン リストからビューの種類を選択します。
スクリプトの場合
View プロパティの値は、ListViewView カタログ データ型です。
次の行では、リストビューの項目が小さいアイコン ビューで表示され
るように指定します。
lv_1.View = ListViewSmallIcon!
566
PowerBuilder
第3章
プロパティの説明と使用法
Visible
対象
コントロール、ウィンドウ、ユーザ オブジェクト、メニュー
機能
Visible プロパティには、オブジェクト、ウィンドウ オブジェクト、ま
たはメニュー オブジェクトが表示可能かどうかを指定します。
解説
ペインタの場合
❖
Visible プロパティを設定する
•
オブジェクトのプロパティ ビューの[全般]ページで、
[表示可能]
チェックボックスをオンにします。
スクリプトの場合
Visible プロパティの値は、ブール値です。次の行では、マルチライン
エディット mle_1 が表示可能になるように指定します。
mle_1.Visible = TRUE
Show 関数と Hide 関数を使用してオブジェクトの可視性を変更するこ
とができます。
使用上の注意
Visible プロパティまたは Show 関数か Hide 関数を使用して、MDI シー
ト、またはドロップダウン メニューやカスケード メニューなど、MDI
フレーム ウィンドウを親ウィンドウとして持つメニューを表示また
は非表示にすることはできません。
VScrollBar
対象
データウィンドウ コントロール、ドロップダウン リストボックス コ
ントロール、ドロップダウン ピクチャ リストボックス コントロール、
エディットマスク コントロール、インクエディット コントロール、リ
ストボックス コントロール、マルチライン エディット コントロール、
ピクチャ リストボックス コントロール、リッチテキスト エディット
コントロール、ウィンドウ、ユーザ オブジェクト
機能
VScrollBar プロパティが有効な場合、オブジェクトの内容がウィンド
ウまたはコントロールの枠線外にあるとき、垂直スクロールバーが
ウィンドウまたはそのほかのコントロールの右側に追加されます。
オブジェクトとコントロール
567
VTextAlign
解説
ペインタの場合
❖
垂直スクロールバーの表示を有効にする
•
オブジェクトのプロパティ ビューの[全般]または[スクロール]
タブ ページで、
[垂直スクロールバー]チェックボックスをオンに
します。
スクリプトの場合
VScrollBar プロパティの値は、ブール値です。
次の例では、データウィンドウ コントロールに垂直スクロールバーを
表示します。
dw_1.VScrollBar = TRUE
このプロパティは、実行時にエディットマスク コントロールに設定で
きません。
VTextAlign
対象
ピクチャボタン コントロール
機能
HTextAlign プロパティには、ピクチャボタン コントロールのテキスト
ラベルがピクチャに対してどのように配置されるかを指定します。
解説
ペインタの場合
❖
テキストの垂直方向の配置を設定する
•
コントロールのプロパティ ビューの[全般]タブで、
[垂直テキス
ト配置]ドロップダウン リストから配置を選択します。
スクリプトの場合
VTextAlign プロパティの値は、VTextAlign カタログ データ型です。
次の例では、ピクチャボタンのテキストに下部の配置を指定します。
pb_1.VTextAlign = Bottom!
568
PowerBuilder
第3章
プロパティの説明と使用法
WeekNumbers
対象
月表示カレンダ コントロール
機能
日付がその年の第何週であるかを示す数値を、その日付の行の左側に
表示するかどうかを指定します。たとえば、1 月 1 日は第 1 週です。
解説
ペインタの場合
❖
WeekNumbers プロパティを設定する
•
プロパティ ビューの[全般]ページで、
[週番号の表示]チェック
ボックスをオンまたはオフにします。
スクリプトの場合
WeekNumbers プロパティの値はブール値です。デフォルト値は False
です。次の例では、WeekNumbers プロパティをオンにします。
mc_1.WeekNumbers = true
Weight
対象
テキストを表示可能なコントロール
機能
Weight プロパティには、コントロール内のテキストの文字の太さを指
定します。
解説
ペインタの場合
❖
コントロール内のすべてのテキストの文字の太さを設定する
•
コントロールのプロパティ ビューの[フォント]タブ ページを表
示して、
[太字]チェックボックスをオンにするか、コントロール
を選択して、スタイルバーの[B]ボタンをクリックします。
❖
グラフ コントロール内のテキスト オブジェクトの文字の太さを設定する
1
グラフ コントロールのプロパティ ビューの[テキスト]タブ ペー
ジを表示して、
[テキスト オブジェクト]リストボックスからテキ
スト オブジェクトを選択します。
2 [太字]チェックボックスをオンにします。
スクリプトの場合
Weight プロパティの値は、整数値です。400 は標準の太さ、700 は太字
を示します。次の例では、タブ コントロールのタブ ページのテキスト
ラベルを太字に設定します。
tab_1.Weight = 700
オブジェクトとコントロール
569
Width
Width
対象
表示可能なコントロール、ウィンドウ
機能
Width プロパティには、コントロールまたはウィンドウの幅を
PowerBuilder 単位系で指定します。
解説
ペインタの場合
❖
コントロールまたはウィンドウの幅を設定する
•
オブジェクトのプロパティ ビューの[その他]タブ ページで、
[幅]
編集ボックスに幅を入力するか、コントロールまたはウィンドウ
を選択して、カーソルでサイズを変更します。
スクリプトの場合
Width プロパティは、オブジェクトの幅を指定する、PowerBuilder 単位
系の整数値をとります。次の例では、データウィンドウ コントロール
dw_1 の幅を設定します。
dw_1.Width = 750
最小化または最大化されたシートまたはフレームのサイズの変更は不
正な処理です。最小化または最大化されたウィンドウについては、
Width プロパティまたは Height プロパティの変更はサポートされませ
ん。
WindowState
対象
ウィンドウ
機能
WindowState プロパティには、ウィンドウが最初に表示される状態を指
定します。次の状態を指定できます。
•
Maximized ウィンドウを最大サイズに拡大します。
•
Minimized ウィンドウをアイコンに縮小します。
•
Normal(デフォルト) ウィンドウをペインタに定義されているサ
イズで表示します。
解説
570
ペインタの場合
❖
ウィンドウの状態を設定する
•
ウィンドウのプロパティ ビューの[全般]ページで、
[ウィンドウ
の状態]ドロップダウン リストから状態を選択します。
PowerBuilder
第3章
プロパティの説明と使用法
スクリプトの場合
ウィンドウの初期状態は、ウィンドウが開き終えてからでないと指定
できません。ウィンドウが開いてからは、開いている間いつでも表示
状態を変更できます。
WindowState プロパティの値は、WindowState カタログ データ型です。
次の行では、現在のウィンドウに Maximized 状態を設定します。
This.WindowState = Maximized!
WindowType
対象
ウィンドウ
機能
このプロパティの値によって、ウィンドウの種類を指定します。
表 3-2: ウィンドウの種類
Child
メイン ウィンドウに従属し、メイン(親)ウィンドウ内に
のみ存在可能なウィンドウ
Main
ほかのウィンドウすべてに従属しない、独立型のオーバー
ラップ ウィンドウ
MDI
MicroHelp ステータスバーのない MDI フレーム
MDIHelp
MicroHelp ステータスバーがある MDI フレーム
Popup
通常ウィンドウ内のイベントに応じて表示されるが、ウィ
ンドウ外部に存在可能なウィンドウ。ウィンドウが開いた
後に閉じられる場合がある
Response
ユーザからの情報を取得するために表示され、ユーザが応
答するまでフォーカスを失ったり閉じたりすることがない
ウィンドウ
解説
ペインタの場合
❖
ウィンドウの種類を指定する
•
ウィンドウのプロパティ ビューの[全般]ページで、
[ウィンドウ
の種類]ドロップダウン リストから種類を選択します。
スクリプトの場合
ウィンドウの WindowType プロパティは、実行時に動的に変更するこ
とはできません。
オブジェクトとコントロール
571
WordWrap
WordWrap
対象
リッチテキスト エディット コントロール
機能
WordWrap が有効な場合、テキストがリッチテキスト エディット コン
トロールの右余白に到達したとき、自動的に次の行に折り返されます。
WordWrap が無効な場合は、テキストは右余白に到達した後も折り返さ
れず、水平スクロールバーが有効な場合は水平スクロールバーが表示
されます。
また、PopMenu プロパティが有効な場合、ユーザが実行時にポップアッ
プ メニューの[プロパティ]項目から WordWrap の有効化を行うこと
もできます。
解説
ペインタの場合
❖
ワードラップを有効にする
•
コントロールのプロパティ ビューの[ドキュメント]タブ ページ
で、
[折り返し]チェックボックスをオンにします。
スクリプトの場合
WordWrap プロパティの値は、ブール値です。
次の行では、リッチテキスト エディット コントロールのワードラップ
を有効にします。
rte_1.WordWrap = TRUE
X
対象
コントロール、ウィンドウ
機能
X プロパティには、オブジェクトまたはコントロールの X 座標を
PowerBuilder 単位系で指定します。
X 座標は、ウィンドウまたはカスタム ユーザ オブジェクトの左端から
の距離です。オブジェクトがメイン ウィンドウまたはカスタム ユーザ
オブジェクトの場合、この距離は画面を基準とします。オブジェクト
がメイン ウィンドウでない場合、距離は親ウィンドウを基準としま
す。ただし、MDI フレーム ウィンドウ内に開かれている場合は、距離
は MDI フレームを基準とします。
572
PowerBuilder
第3章
解説
プロパティの説明と使用法
ペインタの場合
❖
X 座標を設定する
•
オブジェクトのプロパティ ビューの[その他]タブ ページで、
[X]
フィールドに X 座標を PowerBuilder 単位系で入力するか、コント
ロールを目的の位置にドラッグ アンド ドロップします。
スクリプトの場合
X プロパティの値は、整数値です。次の行では、データウィンドウ コ
ントロール dw_1 のウィンドウの左端からの距離を設定します。
dw_1.X = 215
コントロールの X プロパティと Y プロパティは、Move 関数を使って
設定することもできます。
最大化されたシートまたはフレームの移動は不正な処理です。最大化
されたウィンドウの X プロパティか Y プロパティを変更した場合は、
無視されます。
Y
対象
コントロール、ウィンドウ
機能
Y プロパティには、オブジェクトまたはコントロールの Y 座標を
PowerBuilder 単位系で指定します。Y 座標は、ウィンドウまたはユー
ザ オブジェクトの上部からの距離です。オブジェクトがメイン ウィン
ドウまたはカスタム ユーザ オブジェクトの場合、この距離は画面を基
準とします。オブジェクトがメイン ウィンドウでない場合、距離は親
ウィンドウを基準とします。ただし、MDI フレーム ウィンドウ内に開
かれている場合は、距離は MDI フレームを基準とします。
解説
ペインタの場合
❖
Y 座標を設定する
•
オブジェクトのプロパティ ビューの[その他]タブ ページで、
[Y]
フィールドに Y 座標を PowerBuilder 単位系で入力するか、コント
ロールを目的の位置にドラッグ アンド ドロップします。
スクリプトの場合
Y プロパティの値は、整数値です。次の行では、データウィンドウ コ
ントロール dw_1 のウィンドウの上部からの距離を設定します。
dw_1.Y = 215
オブジェクトとコントロール
573
Y
コントロールの X プロパティと Y プロパティは、Move 関数を使って
設定することもできます。
最大化されたシートまたはフレームの移動は不正な処理です。最大化
されたウィンドウの X プロパティか Y プロパティを変更した場合は、
無視されます。
574
PowerBuilder
第 4 章
表示書式とスクロールについて
この章について
この章では、PowerBuilder コントロールで特定の表示書式を使用
する方法と、PowerBuilder ウィンドウおよびユーザ オブジェクト
内でのスクロールについて説明します。
内容
項目
表示書式に色を使用する
日付の表示書式を使用する
数値の表示書式を使用する
文字列の表示書式を使用する
時刻の表示書式を使用する
ウィンドウおよびユーザ オブジェクト内でのスクロール
ページ
575
576
578
579
579
581
表示書式に色を使用する
対象
表示書式
説明
表示書式の前にカラー キーワードを指定することにより、各表示
書式セクション用の色を定義することができます。カラー キー
ワードは色の名前または色の RGB 値の数値で、角カッコで囲みま
す。その例を次に示します。
[RED]m/d/yy
[255]m/d/yy
次の表に、名前が付いている色のキーワードの一覧を示します。
表 4-1: 名前が付いている色のキーワード
[BLACK]
[MAGENTA]
[BLUE]
[RED]
[CYAN]
[WHITE]
[GREEN]
[YELLOW]
オブジェクトとコントロール
575
日付の表示書式を使用する
3 原色の値を組み合わせて色の数値を計算する式は、次のとおりです。
256 * 256 * blue + 256 * green + red = number
ここで、各原色の値は 0 から 255 の間の値で指定します。たとえば、
シアンを指定するには、blue に 255、green に 255、red に 0 を代入しま
す。結果は 16776960 です。
次の表に、ほかの色を指定する場合に式に使用できる Blue、Green、Red
の値の一覧を示します。
表 4-2: 色の指定に使用できる値
Blue
Green
Red
0
0
255
0
255
0
0
128
255
255
0
0
0
255
255
0
128
128
255
255
0
192
192
192
数値
255
65280
32768
16711680
65535
328896
16776960
12632256
色
赤
緑
深緑
青
黄
茶
シアン
明るい灰色
日付の表示書式を使用する
対象
表示書式
説明
日付の表示書式は 2 つの部分に分けることができます。最初のセク
ションは必須です。2 つ目のセクションはオプションで、NULL の表現
方法を指定します。
日付書式 ;NULL の書式
次の表に、日付の表示書式の中で特殊な意味を持つ文字を示します。
576
PowerBuilder
第4章
表示書式とスクロールについて
表 4-3: 日付の表示書式の中の特殊な文字
文字
d
dd
ddd
dddd
m
mm
mmm
mmmm
yy
yyyy
gg
nn
意味
先頭に 0 が付かない日付
適宜先頭に 0 が付く日付
曜日の英文名称の短縮形
曜日の和文名称
先頭に 0 が付かない月
適宜先頭に 0 が付く月
月の英文名称の短縮形
月の英文名称
西暦の下 2 桁
西暦
元号
2 桁の年号
例
9
09
Mon
月曜日
6
06
Jun
June
97
1997
平成
09
コロン、スラッシュ、およびスペースは、マスクに入力したとおりに
表示されます。
解説
データウィンドウ オブジェクトに 2 桁の年号を指定すると、50 以上の
年号は 20 世紀として認識されます。50 未満の年号は、21 世紀として
認識されます。
その例を次に示します。
例
•
1/1/85 は、1985 年 1 月 1 日と認識されます。
•
1/1/40 は、2040 年 1 月 1 日と認識されます。
2003 年 1 月 30 日の金曜日が、異なる書式を設定した場合にどのよう
に表示されるかを次の表に示します。
表 4-4: 日付書式の例
書式
表示
[red]m/d/yy
d-mmm-yy
1/30/03(赤で表示)
30-Jan-03
dd-mmmm
30-January
mmm-yy
Jan-03
dddd, mmm d, yyyy
金曜日 , Jan 30, 2003
ggnn' 年 'mm' 月 'dd' 日 '
平成 13 年 01 月 30 日
オブジェクトとコントロール
577
数値の表示書式を使用する
数値の表示書式を使用する
対象
表示書式
説明
数値の表示書式には、最大 4 セクションを指定できます。最初のセク
ションのみが必須です。
正の値の書式 ; 負の値の書式 ; ゼロの書式 ;NULL の書式
次の表に、数値の表示書式の中で特殊な意味を持つ文字を示します。
表 4-5: 数値の表示書式の中の特殊な文字
文字
#
0
意味
数値
必要な数値。数値はマスクの 0 の位置に表示される
ドル記号、% 記号、小数点、カッコ、およびスペースはマスクに入力
したとおりに表示されます。
次のキーワードによって、システム設定に基づいて適切な書式を判別
するよう、PowerBuilder に通知されます。
例
•
[General]
•
[Currency]
次の表に、さまざまな書式マスクが適用された場合の値 5、-5、および
5 の表示方法を示します。
表 4-6: 数値書式の例
578
サンプル書式
5
-5
.5
[General]
5
-5
0.5
0
5
-5
1
0.00
5.00
-5.00
0.50
#,##0
5
-5
1
#,##0.00
5.00
-5.00
0.50
$#,##0;($#,##0)
$5
($5)
$1
$#,##0;-$#,##0
$5
-$5
$1
$#,##0;[RED]($#,##0)
$5
($5)
$1
$#,##0.00;($#,##0.00)
$5.00
($5.00)
$0.50
$#,##0.00;[RED]($#,##0.00)
$5.00
($5.00)
$0.50
0%
500%
-500%
50%
0.00%
500.00%
-500.00%
50.00%
0.00E+00
5.00E+00
-5.00E+00
5.00E-01
PowerBuilder
第4章
表示書式とスクロールについて
文字列の表示書式を使用する
対象
表示書式
説明
文字列表示書式には 2 つのセクションを指定できます。最初のセク
ションは必須です。2 つ目のセクションはオプションで、NULL の表
現方法を指定します。
文字列の書式 ;NULL の書式
次の表に、文字列の表示書式の中で特殊な意味を持つ文字を示します。
表 4-7: 文字列の表示書式の中の特殊な文字
文字
@
意味
文字
そのほかの文字はすべて(スペースを含め)、マスクに入力したとおり
に表示されます。
例
次の書式マスクを使用すると
[red](@@@) @@@-@@@@
赤の文字列 800YESCELT は赤で次のように表示されます。
(800) YES-CELT
時刻の表示書式を使用する
対象
表示書式
説明
時刻表示書式には、2 つのセクションを指定できます。最初のセクショ
ンは必須で、時刻の書式を格納します。2 つ目のセクションはオプショ
ンで、NULL の表現方法を指定します。
時刻の書式 ;NULL の書式
次の表に、時刻の表示書式の中で特殊な意味を持つ文字を示します。
オブジェクトとコントロール
579
時刻の表示書式を使用する
表 4-8: 時刻の表示書式の中の特殊な文字
文字
h
hh
m
mm
s
ss
ffffff
AM/PM
am/pm
A/P
a/p
意味
先頭に 0 が付かない時間(たとえば 1)
適宜先頭に 0 が付く時間(たとえば 01)
先頭に 0 が付かない分(h または hh の後に指定する)
適宜先頭に 0 が付く分(h または hh の後に指定する)
先頭に 0 が付かない秒(m または mm の後に指定する)
適宜先頭に 0 が付く秒(m または mm の後に指定する)
先頭に 0 が付かないマイクロ秒。1 ~ 6 個の f を入力でき
る。各 f は秒の少数部を表す(s または ss の後に指定する)
2 文字の英大文字の省略形(適宜 AM または PM が表示さ
れる)
2 文字の英小文字の省略形(適宜 am または pm が表示され
る)
1 文字の英大文字の省略形(適宜 A または P が表示される)
1 文字の英小文字の省略形(適宜 a または p が表示される)。
コロン、スラッシュ、およびスペースは、マスクに入力したとおりに
表示されます。
キーワード [Time] を指定すると、Microsoft Windows のコントロール パ
ネルで指定されている時刻書式が使用されます。
解説
24 時間制がデフォルトです。AM か PM、am か pm、A か P、または a
か p を指定しない限り、時刻は 24 時間制で表示されます。
例
次の表には、さまざまな書式マスクが適用されたときの時刻
9:45:33:234567 PM の表示方法を示します。
表 4-9: 時刻書式の例
580
書式
表示
h:mm AM/PM
9:45 PM
hh:mm A/P
09:45 P
h:mm:ss am/pm
9:45:33 pm
h:mm
21:45
h:mm:ss
21:45:33
h:mm:ss:f
21:45:33:2
h:mm:ss:fff
21:45:33:234
h:mm:ss:ffffff
21:45:33:234567
m/d/yy h:mm
1/30/03 21:45
PowerBuilder
第4章
表示書式とスクロールについて
ウィンドウおよびユーザ オブジェクト内でのスクロール
PowerBuilder では、スクロールで使用する目的で、ウィンドウの内容
が 100 行、100 カラムに分割されます。スクロール用の行、カラム、お
よびページは、ウィンドウの表示可能なアスペクト(表示可能領域な
ど)とは関係がありません。
行またはカラムは、スクロールバーの矢印をクリックすることによっ
てスクロールされる大きさです。ウィンドウまたはユーザ オブジェク
トの内容が表示されている領域に関係なく、コントロール内にはスク
ロール可能な 100 行と 100 カラムがあります。ユーザはスクロール
バーの矢印を 100 回クリックすると、スクロールバーの末尾に到達で
きます。
ページは、スクロールバーの矢印ではなく、スクロールバー内をクリッ
クすることによってスクロールされる大きさです。
垂直スクロールと水平
スクロール
次の節の手順では、UnitsPerLine および LinesPerPage プロパティによっ
て決定する垂直スクロールを定義していますが、UnitsPerColumn およ
び ColumnsPerPage プロパティによって決定する水平スクロールにも、
同じ式を適用できます。
スクロールをウィンド
ウの内容の高さに関連
付ける
ユーザがスクロールバーの末尾に到達したときにウィンドウ内の下端
の内容を表示できるようにする場合は、コントロールの UnitsPerLine
プロパティの値を、100 行に内容全体が含まれるように設定する必要
があります。
❖
UnitsPerLine の値を決定する
1
内容すべてが表示されるように、ウィンドウのサイズを変更しま
す。
2
ウィンドウのプロパティ ビューの[その他]タブ ページにある
[高さ]オプションの値を参照します。
高さの値は PowerBuilder 単位系(PBU)で表示されます。
3 [高さ]オプションの値の 75% を 100 で割り、各行に割り当てる
PBU の数を求めます。
UnitsPerLine = 高さ * .75 / 100
表示不可能な位置にスクロールされることなく、スクロールバー
が末尾に到達したときに内容の端の部分が表示可能になるように
するために、高さ全体の 75% をこの計算で使用します。
オブジェクトとコントロール
581
ウィンドウおよびユーザ オブジェクト内でのスクロール
ユーザがスクロールバーの矢印ではなく、スクロールバー内をクリッ
クすると、コントロールはページ単位でスクロールされます。ページ
のサイズは次の式を使って計算します。
スクロールをページの
サイズに関連付ける
ページサイズ = LinesPerPage * UnitsPerLine
したがって、LinesPerPage プロパティを UnitsPerLine プロパティととも
に使用すると、スクロール用のページのサイズを設定できます。
❖
LinesPerPage の値を決定する
1
UnitsPerLine プロパティの値を上記の方法で計算します。
2
ウィンドウのサイズを最終的なサイズに変更します。
3
ウィンドウのプロパティ ビューの[その他]タブ ページにある
[高さ]オプションの値を参照して、表示可能なウィンドウ領域の
高さを決定します。
4
スクロールバーを 1 回クリックするたびにスクロールさせるウィ
ンドウの大きさの割合を決定します。これによって PBU のページ
のサイズが決まります。
たとえば、表示可能なウィンドウ領域の高さが 1200 PBU で、1 回
のクリックごとにウィンドウの 1/4 をスクロールさせる場合、ペー
ジのサイズは 300 PBU になります。
5
LinesPerPage プロパティの値を計算します。
その例を次に示します。
LinesPerPage = 300 / UnitsPerLine
スクロールのクリック
回数を固定させる
ユーザが表示可能なウィンドウ領域に関係なく、所定のクリック回数
で内容の下端に到達できるようにする場合には、LinesPerPage を次の
ように設定します。
LinesPerPage = 100 / クリック数
582
PowerBuilder
索引
A
Accelerator プロパティ 395
AccessibleDescription プロパティ 396
AccessibleName プロパティ 397
AccessibleRole プロパティ 397
Activation プロパティ 399
ADOResultSet オブジェクト 8
Alignment プロパティ 400
AllowEdit プロパティ 401
AnimationName プロパティ 401
Application プロパティ 29
AppName プロパティ 13
AutoArrange プロパティ 402
AutoHScroll プロパティ 402
Automatic プロパティ 403
AutoPlay プロパティ 403
AutoScale プロパティ 404
AutoSize プロパティ 404
AutoSkip プロパティ 406
AutoVScroll プロパティ 406
CategorySort プロパティ 416
Category プロパティ 415
Center プロパティ 417
CharSet プロパティ 106
Checked プロパティ 417
CollectionMode プロパティ 418
ColumnsPerPage プロパティ 419
Connection オブジェクト 29
ConnectString プロパティ 29
ContentsAllowed プロパティ 419
ContextInformation オブジェクト 35
ContextKeyword オブジェクト 36
ControlMenu プロパティ 420
CORBACurrent オブジェクト 37
CORBAObject オブジェクト 39
CORBASystemException オブジェクト 286
CORBASystemException クラス 286
CORBAUserException オブジェクト 110
CORBAUserException クラス 110
CornerHeight プロパティ 421
CornerWidth プロパティ 421
CPUType プロパティ 106
CreateOnDemand プロパティ 422
B
BackColor プロパティ 407
BeginX プロパティ 408
BeginY プロパティ 409
BoldSelectedText プロパティ 409
BorderColor プロパティ 411
BorderStyle プロパティ 412
Border プロパティ 411
BottomMargin プロパティ 413
BringToTop プロパティ 413
ButtonHeader プロパティ 414
C
Cancel プロパティ
415
オブジェクトとコントロール
D
DataObject プロパティ 41, 423
DataType プロパティ 423
DataWindow コントロール プロパティ
Default プロパティ 424
DeleteItems プロパティ 425
Depth プロパティ 426
DisabledName プロパティ 426
DisableDragDrop プロパティ 427
DisableNoScroll プロパティ 428
DisplayData プロパティ 96
DisplayEveryNLabels プロパティ 429
DisplayExpression プロパティ 429
DisplayName プロパティ 430
50
583
索引
DisplayOnly プロパティ 431
DisplayType プロパティ 431
DivideByZeroError オブジェクト 286
DocumentName プロパティ 432
DragAuto プロパティ 432
DragIcon プロパティ 433
Driver プロパティ 29
DropLines プロパティ 434
DWRuntimeError オブジェクト 286, 287
E
EditLabels プロパティ 434
EditMode プロパティ 435
Elevation プロパティ 436
Enabled プロパティ 436
EndX プロパティ 437
EndY プロパティ 438
ErrCode プロパティ 30
ErrorLogging オブジェクト 109
Escapement プロパティ 438
Exception オブジェクト 110
ExtendedSelect プロパティ 439
F
FaceName プロパティ 440
Factoid プロパティ 440
FillColor プロパティ 442
FillPattern プロパティ 443
FirstDayOfWeek プロパティ 444
FixedLocations プロパティ 444
FixedWidth プロパティ 445
FlatStyle プロパティ 26, 239
FocusOnButtonDown プロパティ 445
FocusRectangle プロパティ 446
FontCharSet プロパティ 446
FontFamily プロパティ 447
FontPitch プロパティ 448
Format プロパティ 449
Frame プロパティ 450
FreeDBLibraries プロパティ 450
584
G
GetItemAtPointer 関数 355
GraphType プロパティ 451
H
HasButtons プロパティ 452
HasLines プロパティ 452
HeaderFooter プロパティ 453
Height プロパティ 454
HideSelection プロパティ 454
HScrollBar プロパティ 455
HSplitScroll プロパティ 456
HTextAlign プロパティ 456
I
Icon プロパティ 457
IgnoreDefaultButton プロパティ 458
IgnorePressure プロパティ 458
Increment プロパティ 459
Indent プロパティ 460
Inet オブジェクト 139
InkAntiAliased プロパティ 460
InkColor プロパティ 461
InkHeight プロパティ 462
InkMode プロパティ 461, 463
InkWidth プロパティ 463
InputFieldBackColor プロパティ 464
InputFieldNamesVisible プロパティ 465
InputFieldsVisible プロパティ 465
InsertAsText プロパティ 466
InternetResult オブジェクト 154
Invert プロパティ 466
Italic プロパティ 467
Item[ ] プロパティ 467
ItemPictureIndex[ ] プロパティ 468
J
JaguarORB オブジェクト
155
PowerBuilder
索引
L
LabelWrap プロパティ 471
Label プロパティ 469
Language プロパティ 106
LargePictureHeight プロパティ 473
LargePictureMaskColor プロパティ 474
LargePictureName[ ] プロパティ 471
LargePictureWidth プロパティ 472
LayoutRTL property 475
LeftMargin プロパティ 476
LeftText プロパティ 476
Legend プロパティ 477
Limit プロパティ 477
LineColor プロパティ 478
LinesAtRoot プロパティ 479
LinesPerPage プロパティ 479
LineStyle プロパティ 480
LinkUpdateOptions プロパティ 480
LiveScroll プロパティ 481
Location プロパティ 30
LowerBound プロパティ 15
M
MachineCode プロパティ 106
MajorDivisions プロパティ 482
MajorGridLine プロパティ 482
MajorTic プロパティ 483
Map3DColors プロパティ 484
MaskDataType プロパティ 486
Mask プロパティ 485
MaxBox プロパティ 487
MaximumValue プロパティ 487
MaxPosition プロパティ 488
MaxSelectCount プロパティ 489
MaxValDateTime プロパティ 489
MenuName プロパティ 490
MinBox プロパティ 492
MinimumValue プロパティ 493
MinMax プロパティ 493
MinorDivisions プロパティ 495
MinorGridLine プロパティ 494
MinorTic プロパティ 495
MinPosition プロパティ 496
MinValDateTime プロパティ 496
オブジェクトとコントロール
Modified プロパティ 497
MonthBackColor プロパティ 498
Multiline プロパティ 499
MultiSelect プロパティ 499
N
NullObjectError オブジェクト
286
O
OLERuntimeError オブジェクト 286, 287
OLERuntime オブジェクト 286
OLETxnObject オブジェクト 228
Options プロパティ 30
ORB プロパティ 31
OriginalSize プロパティ 500
OriginLine プロパティ 501
OSFixesRevision プロパティ 106
OSMajorRevision プロパティ 106
OSMinorRevision プロパティ 107
OSType プロパティ 107
OverlapPercent プロパティ 501
P
Password プロパティ 31, 502
PBFixesRevision プロパティ 107
PBMajorRevision プロパティ 107
PBMinorRevision プロパティ 107
PBType プロパティ 107
PBXRuntimeError オブジェクト 286
PerpendicularText プロパティ 503
Perspective プロパティ 503
PictureHeight プロパティ 504
PictureIndex プロパティ 505
PictureMaskColor プロパティ 506
PictureName[ ] プロパティ 509
PictureName プロパティ 508
PictureOnRight プロパティ 510
PicturesAsFrame プロパティ 504
PictureWidth プロパティ 510
Pointer プロパティ 511
585
索引
PopMenu プロパティ 512
Position プロパティ 512
PowerBuilder オブジェクト ブラウザ
PowerTips プロパティ 514
PowerTipText プロパティ 513
PrimaryLine プロパティ 514
4
R
RaggedRight プロパティ 515
RecognitionTimer プロパティ 515
Resizable プロパティ 516
ResultSets オブジェクト 273
ReturnsVisible プロパティ 517
RightMargin プロパティ 517
RightToLeft property 144
RightToLeft プロパティ 13, 19, 52, 77, 85, 98, 126, 161,
198, 205, 252, 267, 294, 303, 308, 385, 518
Rotation プロパティ 519
RoundToUnit プロパティ 521
RoundTo プロパティ 520
RulerBar プロパティ 519
RuntimeError オブジェクト 286
S
ScaleType プロパティ 522
ScaleValue プロパティ 522
Scrolling プロパティ 523
ScrollRate プロパティ 523
SecondaryLine プロパティ 524
SelectedTab プロパティ 524
SeriesSort プロパティ 526
Series プロパティ 525
SetStep プロパティ 526
ShadeBackEdge プロパティ 527
ShowHeader プロパティ 528
ShowList プロパティ 527
ShowPicture プロパティ 529
ShowText プロパティ 529
SmallPictureHeight プロパティ 530
SmallPictureMaskColor プロパティ 531
SmallPictureName[ ] プロパティ 532
SmallPictureWidth プロパティ 533
586
Sorted プロパティ 534
SortType プロパティ 534
SpacesVisible プロパティ 535
Spacing プロパティ 536
Spin プロパティ 536
SSLCallback オブジェクト 297
SSLServiceProvider オブジェクト 299
StatePictureHeight プロパティ 537
StatePictureMaskColor プロパティ 537
StatePictureName[ ] プロパティ 538
StatePictureWidth プロパティ 539
Status プロパティ 540
StdHeight プロパティ 541
StdWidth プロパティ 541
T
TabBackColor プロパティ 545
TabOrder プロパティ 542
TabPosition プロパティ 543
TabStop[ ] プロパティ 543
TabsVisible プロパティ 546
TabTextColor プロパティ 544
Tag プロパティ 546
TextCase プロパティ 547
TextColor プロパティ 549
TextSize プロパティ 550
Text プロパティ 547
ThirdState プロパティ 551
ThreeState プロパティ 550
Throwable オブジェクト 318
Timing オブジェクト 319
TitleBackColor プロパティ 552
TitleBar プロパティ 553
TitleTextColor プロパティ 554
Title プロパティ 552
TodayCircle プロパティ 554
TodaySection プロパティ 555
ToolbarAlignment プロパティ 555
ToolbarHeight プロパティ 556
ToolbarTips プロパティ 14
ToolbarUserControl プロパティ 14
ToolbarVisible プロパティ 556
ToolbarWidth プロパティ 557
ToolbarX プロパティ 557
PowerBuilder
索引
ToolbarY プロパティ 558
ToolBar プロパティ 558
TopMargin プロパティ 559
Trace プロパティ 31
TrailingTextColor プロパティ 559
TransactionServer オブジェクト 344
Transparent プロパティ 560
U
Underline プロパティ 561
UndoDepth プロパティ 561
UnitsPerColumn プロパティ 562
UnitsPerLine プロパティ 563
UpperBound プロパティ 15
UseCodeTable プロパティ 564
UseMouseForInput プロパティ 565
UserID プロパティ 31
V
View プロパティ 565
Visible プロパティ 567
VscrollBar プロパティ 567
VTextAlign プロパティ 568
Y
Y プロパティ
573
イ
印刷上の表記規則
vii
ウ
ウィンドウおよびユーザ オブジェクト内でのスク
ロール 581
オ
オブジェクト、TransactionServer
概要 155
シ
時刻の表示書式
579
ス
数値の表示書式
W
WeekNumbers プロパティ 569
Weight プロパティ 569
Width プロパティ 570
WindowState プロパティ 570
WindowType プロパティ 571
WordWrap プロパティ 572
ヒ
日付の表示書式 576
表記規則 vii
表示書式の色 575
モ
X
X プロパティ
578
572
オブジェクトとコントロール
文字列の表示書式
579
587
索引
588
PowerBuilder
Fly UP