powerbuilder 入門 · pdf file目次 powerbuilder 入門 v アプリケーションの close...

PowerBuilder 入門

PowerBuilder®

9

DOCUMENT ID: 37772-01-0900-01

LAST REVISED: March 2003

Copyright © 1989-2004 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 ServerEnterprise Replication, Adaptive Server Everywhere, Adaptive Server IQ, Adaptive Warehouse, Anywhere Studio, ApplicationManager, AppModeler, APT Workbench, APT-Build, APT-Edit, APT-Execute, APT-FORMS, APT-Translator, APT-Library, BackupServer, BizTracker, ClearConnect, Client-Library, Client Services, Convoy/DM, Copernicus, Data Pipeline, Data Workbench,DataArchitect, Database Analyzer, DataExpress, DataServer, DataWindow, DB-Library, dbQueue, Developers Workbench, DirectConnect Anywhere, DirectConnect, Distribution Director, e-ADK, E-Anywhere, 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,ImpactNow, Industry Warehouse Studio, InfoMaker, Information Anywhere, Information Everywhere, InformationConnect,InternetBuilder, iScript, Jaguar CTS, jConnect for JDBC, MainframeConnect, Maintenance Express, MDI Access Server, MDIDatabase Gateway, media.splash, MetaWorks, 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++, PB-Gen, PC APTExecute, PC Net Library, 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, Report Workbench,Report-Execute, Replication Agent, Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit, ResourceManager, RW-DisplayLib, 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, SQLEdit/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, SybaseSQL Lifecycle, Sybase SQL Workgroup, Sybase User Workbench, SybaseWare, Syber Financial, SyberAssist, SyBooks, System 10,System 11, System XI ( ロゴ ), SystemTools, Tabular Data Stream, TradeForce, Transact-SQL, Translation Toolkit, UltraLite.NET,UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit for UniCode, Viewer, Visual Components, VisualSpeller,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, XA-Server および XP Server は Sybase, Inc. の登録商標です。

Unicode および Unicode のロゴは Unicode, Inc. の登録商標です。

本書で使用される会社名および製品名はそれぞれの会社の商標および登録商標です。

本書に記載されている内容は、将来予告なしに変更することがあります。また、本ソフトウェアおよび説明書を使用したことによる損害、または第三者からのいかなる請求についても、サイベース株式会社、その親会社である米国法人 Sybase,Inc. またはその関連会社は、一切の責任を負わないものとします。

目次

本書について .................................................................................................................................. ix

第 1 部 PowerBuilder の紹介

第 1 章 PowerBuilder の概要 ................................................................................................. 3PowerBuilder とは............................................................................ 3PowerBuilder の環境 ........................................................................ 6PowerBuilder オブジェクト ........................................................... 11

第 2 章 PowerBuilder チュートリアルについて ........................................................ 21クライアント / サーバーアプリケーションの構築方法の学習 ...... 21PowerDynamo Web アプリケーションの構築方法の学習............. 23JSP Web サービスアプリケーションの構築方法の学習 .............. 24チュートリアルの進め方................................................................ 25

所要時間 .................................................................................. 26学習する内容 ........................................................................... 26

チュートリアルのセットアップ ..................................................... 27

第 2 部クライアント / サーバーアプリケーションの構築

レッスン 1 PowerBuilder の起動 ..................................................................... 31ワークスペースの新規作成 ............................................................ 32ターゲットの作成 .......................................................................... 35アプリケーションのアイコンの指定.............................................. 40メインウィンドウのサイズ変更 .................................................... 43アプリケーションの実行................................................................ 46

レッスン 2 PowerBuilder の環境のカスタマイズ ............................................ 49システムツリーウィンドウの操作 ............................................... 50オブジェクトのオープン ................................................................ 52ビューの操作.................................................................................. 54

PowerBuilder 入門 iii

目次

新規スクリプトビューの追加................................................. 55ビューのタイトルバーの表示................................................. 56ビューの浮動化と固定化 ......................................................... 56タブ付きビューの操作 ............................................................ 57ビューのレイアウト構成の保存 .............................................. 58ビューレイアウト構成を標準設定に戻す............................... 59

ツールバーのセットアップ ............................................................ 60ツールバーボタン上へのラベルの表示 .................................. 60ツールバーの浮動化 ................................................................ 61ツールバーの再配置 ................................................................ 62

レッスン 3 ログインウィンドウの作成............................................................. 65ウィンドウの新規作成 ................................................................... 66コントロールの追加 ....................................................................... 70

ピクチャの追加 ....................................................................... 72スタティックテキストコントロールの追加 .......................... 74スタティックテキストコントロールのプロパティの指定 .... 74シングルラインエディットコントロールの追加................... 76シングルラインエディットコントロールのプロパティの

指定 .................................................................................. 77コマンドボタンコントロールの追加...................................... 78コマンドボタンコントロールのプロパティの指定 ................ 79

ウィンドウのタブ順序の変更 ........................................................ 80Help イベントのコーディングとウィンドウのプレビュー ............ 82ログインウィンドウを開くスクリプトの記述 .............................. 86

フレームウィンドウの Open イベントの修正 ....................... 87スクリプトのコンパイル ......................................................... 90

レッスン 4 データベースへの接続 ..................................................................... 91EAS Demo DB データベースの参照 .............................................. 92

EAS Demo DB データベースプロファイルの参照................. 93EAS Demo DB データベースのテーブル定義の参照 .............. 96

接続オブジェクトウィザードの実行........................................... 101グローバル変数の宣言 ................................................................. 104接続情報の変更 ............................................................................ 109

of_GetConnectionInfo 関数の変更 ........................................ 109接続サービスマネージャの呼び出し .................................... 111

ログインおよびログアウトスクリプトの完了 ............................ 114オートスクリプトショートカットの設定............................. 115［OK］ボタンの Clicked イベントに対するコードの追加 ..... 116［キャンセル］ボタンの Clicked イベントに対するコード

の追加............................................................................. 118

iv PowerBuilder

目次

アプリケーションの Close イベントに対するコードの追加 ................................................................................ 119

アプリケーションの実行.............................................................. 121

レッスン 5 先祖ウィンドウの変更 .................................................................. 123探索パスへのライブラリの追加 ................................................... 124先祖シートウィンドウの新規作成 .............................................. 126

新規シートウィンドウの継承階層の作成............................. 127マスターデータウィンドウ用のデータウィンドウ

コントロール（dw_master）の追加 .............................. 129詳細データウィンドウ用のデータウィンドウコントロール

（dw_detail）の追加 ........................................................ 131ユーザオブジェクトから継承されたスクリプトの参照 ....... 132

ユーザイベントおよびイベントスクリプトの追加 .................... 134データウィンドウコントロールのデータの検索を行う

スクリプトの追加 ........................................................... 138シートウィンドウのサイズに合わせた実行時の設定の調整....... 142

レッスン 6 メニューの設定 ............................................................................. 143フレームメニューの修正............................................................. 144

［ファイル］メニューの修正 ................................................. 145［ヘルプ］メニュー項目の有効化 .......................................... 147

シートメニューの新規作成 ......................................................... 149継承される新規メニューの作成および保存 .......................... 150新規メニューへのメニュー項目の追加 ................................. 151新規メニュー項目のツールバーの追加 ................................. 154

ユーザイベントを発生させるメニュースクリプトの追加 ......... 156新規メニューのアタッチとアプリケーションの実行 .................. 158

レッスン 7 データウィンドウオブジェクトの作成 ........................................ 161データウィンドウオブジェクトの新規作成とプレビュー .......... 162データウィンドウオブジェクトの保存 ....................................... 1661 つめのデータウィンドウオブジェクトの表示の変更 .............. 1672 つめのデータウィンドウオブジェクトの作成 ......................... 169

データソースおよびスタイルの選択 .................................... 169テーブルとカラムの選択 ....................................................... 170検索引数の定義 ..................................................................... 171WHERE 句の指定.................................................................. 172データウィンドウペインタでのデータウィンドウの表示 ... 173データウィンドウオブジェクトの保存 ................................ 176

2 つめのデータウィンドウオブジェクトの表示の変更 .............. 178カラムとラベルの再配置 ....................................................... 178ラベルとカラムの整列 .......................................................... 180

PowerBuilder 入門 v

目次

ドロップダウンデータウィンドウ編集スタイルの矢印の表示 ................................................................................ 181

レッスン 8 データウィンドウオブジェクトのアタッチ ................................. 183マスターデータウィンドウコントロールへの

データウィンドウオブジェクトのアタッチ .................. 184詳細データウィンドウコントロールへのデータウィンドウ

オブジェクトのアタッチ ................................................ 187アプリケーションの実行.............................................................. 189商品管理ウィンドウへのデータウィンドウオブジェクトの

アタッチ ......................................................................... 193アプリケーションの再実行 .......................................................... 195

レッスン 9 デバッガの実行.............................................................................. 199アプリケーションのスクリプトへのブレークポイントの追加 .... 200デバッグモードでのアプリケーションの実行 ............................ 204ウォッチと条件ブレークポイントの設定 .................................... 209

レッスン 10 例外処理 ........................................................................................ 211既存のアプリケーションへの新規のシートウィンドウの追加 ... 212

シートウィンドウの作成 ...................................................... 213メインアプリケーションフレームからシートウィンドウ

にアクセスできるようにする ......................................... 215ユーザ定義の例外オブジェクトの作成 ........................................ 218新規のユーザ関数とユーザイベントの作成 ................................ 220メソッドの呼び出しと例外の捕捉 ............................................... 223アプリケーションの実行.............................................................. 226

新規のシートウィンドウのテスト ....................................... 226ゼロによる除算エラーのテストの追加 ................................. 229

レッスン 11 アプリケーション配布の準備 ........................................................ 233プロジェクトオブジェクトの作成 .............................................. 234実行ファイルの作成 ..................................................................... 237ショートカットの作成 ................................................................. 239実行ファイルのテスト ................................................................. 241

vi PowerBuilder

第 3 部 WEB アプリケーションの構築

レッスン 12 Web ページの作成 ........................................................................ 245PowerDynamo Web サイトの作成 ............................................... 247基本 Web ページの作成と修正..................................................... 250

4GL を用いた Web ページの作成.......................................... 250フォントの変更...................................................................... 253グラフィックの追加 .............................................................. 254グラフィックへの絶対位置の追加......................................... 255

ページナビゲーションの追加...................................................... 257商品情報の Web ページの作成.............................................. 257ハイパーリンクの追加........................................................... 258ボタンの追加 ......................................................................... 259

検証とリダイレクトを行うログインページの作成 ..................... 261基本ログインページの作成................................................... 262セッション変数の追加........................................................... 263シングルラインテキストコントロールの追加.................... 264パスワードの検証の追加 ....................................................... 266サーバリダイレクトの追加................................................... 268

スタートページの指定................................................................. 269Web サイトの配布と実行............................................................. 270

レッスン 13 Web データウィンドウの使い方................................................... 273EAServer 接続プロファイルのセットアップ ............................... 275Web データウィンドウコンテナの構築 ...................................... 277Web データウィンドウコンテナを使用しての Web ページの

作成................................................................................. 279データウィンドウ Web ページへのほかのコントロールの追加 .. 282

新規の商品情報ボタンの有効化 ............................................ 282データベースを更新するボタンの追加.................................. 285［商品情報］ページへのハイパーリンクの追加 ..................... 285

既存の Web ページへのデータウィンドウの追加........................ 287商品情報の検索機能の追加 .......................................................... 290Web アプリケーションのテストと実行 ....................................... 292

Addproduct.htm Web ページのテスト ................................... 292データベースへの新しい商品の追加 ..................................... 294Web アプリケーションの実行............................................... 295

PowerBuilder 入門 vii

第 4 部 JSP WEB サービスアプリケーションの作成

レッスン 14 JSP Web サービスアプリケーションの作成............................... 303JSP ターゲットの作成 ................................................................. 304簡単な JSP アプリケーションでの Web サービスの利用............ 307

JSP アプリケーションの非 4GL ページの作成..................... 307アプリケーションのスタートページを完成させる............... 310JSP Web サービスプロキシウィザードを使用する ............ 312Web サービスへの呼び出しの追加........................................ 314アプリケーションの構築、配布、実行.................................. 317

4GL JSP アプリケーションでの Web サービスの利用................ 3184GL JSP ページの作成.......................................................... 3184GL ページへの Web サービスとページ変数の追加............. 3194GL JSP ページへのテーブルの追加 .................................... 320Web サービスへの呼び出しの完了........................................ 3234GL JSP ページの構築、配布、実行 .................................... 325

索引............................................................................................................................................. 327

viii PowerBuilder

本書について

目的このマニュアルは、 PowerBuilder を使用して開発を始めるための情報を提供しています。

• 第 1 部 PowerBuilder 開発環境の概要です。

• 第 2 部 PowerBuilder アプリケーションを初めて構築される方のためのチュートリアルです。

• 第 3 部 PowerDynamo Web ターゲットの作成、 Web サイトの配布と実行、および Web データウィンドウの使い方についてのチュートリアルです。

• 第 4 部 Web サービスのクライアントページを含む JSP Webターゲットを作成および実行するチュートリアルです。

対象とする読者このマニュアルは、 PowerBuilder を使用してアプリケーションを構築するあらゆる開発者を対象としています。

オンラインヘルプ PowerBuilder を使用して開発しているときはいつでも、オンラインヘルプを参照できます。オンラインヘルプでは、以下のことを参照できます。

• 操作手順アプリケーション作成の操作手順

• リファレンス情報トピックやコンポーネントに対するリファレンス情報

• 状況依存ヘルプスクリプト中の関数や予約語に対する状況依存ヘルプ

関連マニュアル次の表に、 PowerBuilder のマニュアルセットを、項目ごとに分けて示します。

項目マニュアル説明

インストール、機能ガイド、およびチュートリアル

PowerBuilder インストールガイド

PowerBuilder のインストール方法を解説しています。

PowerBuilder 入門 PowerBuilder について概説し、基本的な使い方を段階的に学べるチュートリアルです。

PowerBuilder 入門 ix

アプリケーション開発

ユーザーズガイド PowerBuilder でペインタを使用してオブジェクトを構築する方法を解説しています。

アプリケーションテクニック

共通のアプリケーション機能を実装するためのテクニック集のほか、配布に関する詳細や、クロスプラットフォームアプリケーションの開発と配布のためのアドバイスを紹介しています。

データウィンドウプログラマーズガイド

サポートしているすべての環境（PowerBuilder、 Web ページ、 Java）でデータウィンドウを使用する方法や、データのアクセス、表示、操作、更新に関するプログラミングのテクニックを説明します。

Web ターゲットと JSP ターゲットでの作業

PowerBuilder の Web ターゲットをビルド、配布、デバッグ、実行する方法を解説しています。

プログラマーズリファレンス

PowerScript リファレンス

PowerScript 言語（変数、式、ステートメント、関数、イベント）の構文と使い方を解説しています。

データウィンドウリファレンス

データウィンドウオブジェクトのリファレンス情報（たとえば、式のプロパティや関数、データやプロパティにアクセスするための構文、すべてのサポート環境におけるデータウィンドウコントロールやデータストアのメソッド、イベント、およびプロパティのリファレンスなど）を掲載しています。

Web ターゲットと JSP ターゲットリファレンス

Web ターゲットオブジェクトモデルのオブジェクトおよびクラスのリファレンスが載っています。

オブジェクトとコントロール

PowerBuilder システムのオブジェクトおよびコントロールのプロパティ、イベント、関連する関数のリストを示します。

PowerBuilder ネイティブインタフェース（PBNI）プログラマーズガイドとリファレンス

PBNI を使用して PowerBuilder エクステンションを作成し、 C++ アプリケーションと対話する方法およびリファレンス情報を掲載しています。


x PowerBuilder

本書について

そのほかの参考資料製品に関するそのほかの詳細情報については、 Sybase のテクニカルライブラリ CD、およびテクニカルライブラリ製品マニュアル Web サイト（英語）を参照してください。

• ソフトウェア付属のテクニカルライブラリ CD には、製品マニュアルが含まれています。製品マニュアルは、 PDF 形式にて提供しています。

テクニカルライブラリ CD の使い方については、テクニカルライブラリ CD 内の Readme.txt ファイルを参照してください。

• テクニカルライブラリ製品マニュアルの Web サイト（英語）には、Product Manuals http://www.sybase.com/support/manuals/ からアクセスできます。

サポートについて製品に同梱している「サポートハンドブック」を参照してください。

PowerBuilder エクステンションリファレンス

PBNI を使用して作成した PowerBuilder 拡張モジュール（PBDOM、 EJBClient、 Web サービスなど）についてのリファレンスです。

データベース関連

データベースとの接続

PowerBuilder からのデータベースへの接続方法のほか、 PowersoftODBC インタフェースまたはネイティブの Powersoft データベースインタフェースのいずれかを介してアクセスされるデータベース接続のセットアップ、定義、管理方法について解説しています。

接続リファレンスデータベース接続を作成、定義、確立、保守、トラブルシューティングするための手順を掲載しています。

PowerBuilder Foundation Class Library (PFC)

PFC ユーザーズガイド

アプリケーション開発プロセスを加速するためのオブジェクト、サービス、およびユーティリティを含むPFC（PowerBuilder Foundation Class）の使用方法と拡張方法について解説しています。

PFC オブジェクトリファレンス

PFC で提供しているオブジェクト、インスタンス変数、イベント、関数について解説しています。


PowerBuilder 入門 xi

xii PowerBuilder

第 1 部 PowerBuilder の紹介

第 1 部は、 PowerBuilder 開発環境の概要です。

第 1 章 PowerBuilder の概要

この章についてこの章では、チュートリアルの第 2 部から第 4 部で使用するPowerBuilder 開発環境について解説します。また、 PowerBuilder の構築ブロックについても解説します。

内容

詳細について PowerBuilder 開発環境についての詳細は、『PowerBuilder ユーザーズガイド』マニュアルを参照してください。

PowerBuilder とはPowerBuilder は、多くの種類のアプリケーションおよびコンポーネントを構築するための企業向け開発ツールです。PowerBuilder を使用すれば、クライアント / サーバアプリケーション、多層アプリケーション、およびインターネットアプリケーションを開発できます。

PowerBuilder アプリケーションの構成について

PowerBuilder クライアントアプリケーションの構成内容は以下のとおりです。

• ユーザインタフェースメニュー、ウィンドウ、およびウィンドウコントロールです。ユーザはこれらと対話することでアプリケーションを制御します。

• アプリケーション処理ロジックイベントおよび関数のスクリプトです。ビジネスルールや入力条件則などの処理コードをこの中に記述します。 PowerBuilder では、アプリケーション処理ロジックのコードをユーザインタフェースの一部として、またはカスタムクラスユーザオブジェクトと呼ばれる別のモジュールとして記述できます。

項目ページ

PowerBuilder とは 3PowerBuilder の環境 6

PowerBuilder オブジェクト 12

PowerBuilder 入門 3

PowerBuilder とは

PowerBuilder アプリケーションのコンポーネントについて

多層アプリケーションでは、アプリケーション処理ロジックが含まれているモジュールをサーバに配布できます。また EAServer コンポーネントまたは COM コンポーネントとして機能するように設計されたコンポーネントを構築することもできます。

PowerBuilder イベント駆動型のアプリケーション

クライアントアプリケーションでは、ユーザがとるアクションによって処理内容が制御されます。たとえば、ユーザがボタンをクリックしたり、メニュー項目を選択したり、テキストボックスにデータを入力すると、 1 つまたは複数のイベントが発生します。開発者はイベント発生時に実行する処理をスクリプトに記述します。

ウィンドウやコントロールなど、 PowerBuilder で作成するアプリケーションコンポーネントには、定義済みイベントのセットが用意されています。たとえば、各ボタンには Clicked イベント、各テキストボックスには Modified イベントが関連付けられています。たいていの場合は定義済みのイベントだけあれば十分ですが、場合によっては独自のイベントを定義する必要が生じることもあります。

PowerScript 言語スクリプトは、PowerBuilder の PowerScript 言語を使用して記述します。スクリプトは、イベントに応答して処理を実行するための PowerScriptコマンド、関数、およびステートメントから構成されます。

たとえば、ボタンの Clicked イベント用スクリプトを使用して、データベースから情報を取り出して表示したり、テキストボックスのModified イベント用スクリプトを使用して、データを評価してそのデータに基づいて処理を実行できます。

また、あるイベントスクリプトを実行して、別のイベントを発生させることも可能です。たとえば、ボタンの Clicked イベント用スクリプトを実行し、別のウィンドウの Open イベントを発生させてそのウィンドウを開くこともできます。

PowerScript 関数 PowerScript には豊富な組み込み関数が用意されており、これらの関数を使用することでアプリケーションの各種コンポーネントの操作を行うことができます。たとえば、関数にはウィンドウを開く関数、ウィンドウを閉じる関数、ボタンを有効にする関数、データベースを更新する関数などがあります。

また、 PowerBuilder では開発者が独自の関数を作成して、アプリケーション固有の処理を定義することもできます。

4 PowerBuilder


PowerBuilder でのオブジェクト指向プログラミング

PowerBuilder で作成されるメニューやウィンドウは、それぞれ独立したモジュールであり、オブジェクトと呼ばれます。これらの作成オブジェクトを組み合わせてアプリケーションを構築します。各オブジェクトには、そのオブジェクトに適した特性および動作（プロパティ、イベント、関数）が含まれています。カプセル化、継承、多相性（ポリモフィズム）のようなオブジェクト指向プログラミングテクニックを利用することにより、作成された各オブジェクトを大限に活用して、再利用性が高く、拡張性に富み、高性能なオブジェクトを使用することができます。

インターネットアプリケーション

Enterprise エディションを使用している場合は、 Web ターゲットテクノロジを利用して Web 上で稼働する PowerBuilder アプリケーションを開発できます。Web ターゲットを使用すると、クライアントサイドスクリプト、サーバサイドスクリプト、データベースコンテンツ、 Webデータウィンドウ、および EAServer コンポーネントを含む複雑な Webページを構築できます。

どのエディションの PowerBuilder でも、データウィンドウおよびPowerBuilder ウィンドウプラグイン、PowerBuilder ウィンドウ ActiveX、および ActiveX 対応のデータウインドウ Web コントロールを使用できます。

Web ターゲットについては、『Web ターゲットと JSP ターゲットでの作業』マニュアルを参照してください。 PowerBuilder のプラグインについては、『アプリケーションテクニック』マニュアルを参照してください。ActiveX 対応のデータウィンドウ Web コントロールについては、『データウィンドウプログラマーズガイド』マニュアルおよび『データウィンドウリファレンス』マニュアルを参照してください。

多層アプリケーション PowerBuilder を使用すれば、分散コンピューティング環境で稼働するアプリケーションを開発できます。多層アプリケーションには以下の利点があります。

• ビジネスロジックをサーバ（EAServer サーバまたは MTS）に集中させることができる

• アプリケーション機能をクライアントとサーバに分割できるため、クライアントの負荷を軽減できる

• 保守が容易なスケーラブルアプリケーションを構築できる

多層アプリケーションについては、『アプリケーションテクニック』マニュアルの分散型アプリケーションテクニックに関する節を参照してください。


PowerBuilder の環境

データベース接続 PowerBuilder では、さまざまなデータベースに格納された企業の情報に簡単にアクセスできます。データは、 PowerBuilder ODBC またはJDBC インタフェース、中間層のデータアクセスサーバを介して、あるいはデータベースへのネイティブ（直接）接続によってアクセスできます。

データベース接続については、『データベースとの接続』マニュアルを参照してください。

オンラインヘルプとドキュメント

PowerBuilder のオンラインヘルプは、インタフェースの［ヘルプ］ボタンおよびメニュー項目、または〔F1〕キーによって、 PowerBuilderのどこからでもアクセスできます。オンラインヘルプのさまざまな場所から HTML 形式のブックにジャンプできます。オンラインヘルプには、 HTML 形式のマニュアルへのジャンプ項目があります。

PowerBuilder の環境ワークスペースとターゲット

PowerBuilder では、ワークスペース内で 1 つまたは複数のターゲットを操作します。ターゲットを必要なだけワークスペースに追加して、複数のターゲット内のオブジェクトを開いて編集し、それぞれのターゲットを一度に構築して配布できます。

PowerBuilder のターゲットは、以下の 2 種類のいずれかです。

• PowerScript ターゲットクライアント /サーバ実行アプリケーション、多層実行可能アプリケーション、またはサーバコンポーネントです。

• Web ターゲット Web アプリケーションです。Web サイト構築に必要な要素（HTML ファイル、スクリプト、画像、ダウンロードされたコンポーネント）のほか、構築オプション、データベース接続、配布の設定などが含まれています。

チュートリアルの初のレッスンでは、ワークスペースと PowerScriptターゲットの作成方法を案内します。以降のレッスンでは、 Web ターゲットの作成方法を学びます。

6 PowerBuilder


開発環境 PowerBuilder を起動すると、上部にメニューバーとパワーバー、左端にシステムツリーとクリップウィンドウのあるウィンドウが開きます。

システムツリーシステムツリーウィンドウは、開発活動の中心として機能します。システムツリーウィンドウを使用して、ターゲットのオープン、実行、デバッグ、および構築や、ドラッグアンドドロッププログラミングを行います。

クリップウィンドウクリップウィンドウには、頻繁に使用するコードフラグメントを保存できます。

出力ウィンドウメインウィンドウの下部にある出力ウィンドウには、各種の操作（移行、構築、配布、プロジェクト実行、オブジェクトの保存、および検索）の出力が表示されます。

ペインタワークスペースと PowerScript ターゲットを作成したら、ペインタを使用してターゲットのコンポーネントを構築します。ペインタにはオブジェクトを作成するためのツールが提供されています。

PowerBuilder では、作成するオブジェクトの種類に対してそれぞれペインタが用意されています。たとえば、ウィンドウはウィンドウペインタで作成します。ウィンドウペインタでウィンドウのプロパティを定義し、ボタンやテキストボックスなどのコントロールを追加できます。



エディタ Web ターゲットには、HTML、スタイルシート、フレームセットエディタが用意されています。 HTML エディタでは、ソース形式や表示形式でページを編集したり、結果をプレビューできます。スタンドアロン型のスクリプトエディタ、または HTML エディタに組み込まれたエディタを使用できます。

ウィザードウィザードを使用すると、アプリケーション、オブジェクト、コンポーネント、 Web サイト、および Web ページを簡単に作成できます。

デザインタイムコントロール

デザインタイムコントロール（DTC）では、プロパティシートで指定した情報に基づいて、基本的な HTML およびスクリプトを作成できます。プロパティシートは、 HTML エディタで DTC を Web ページ上にドロップすると表示されます。

Web データウィンドウの DTC を使用すると、 Web ページからデータベースに簡単にアクセスできます。 DTC を使用すると、動的なデータベースコンテンツがさまざまな形式で表示されます。また、 DTC によって、データベースに対する挿入、更新、削除がサポートされます。

To-Do リスト To-Do リストには、現在のターゲットに対して実行する必要のある開発タスクのリストが表示されます。 To-Do リスト上のエントリは、ほとんどの PowerBuilder ウィザードで自動的に作成できます。エントリを入力、またはテキストファイルからエントリをインポートした後で、それらのエントリを遂行するタスクにリンクすることも可能です。

ブラウザブラウザを使用すると、オブジェクト、メソッド、変数、および構造体のうち、PowerScript ターゲット用に定義したものや PowerScript ターゲットで使えるものをすべて表示できます。ブラウザ内のオブジェクトは、アルファベット順または階層順に表示できます。メソッドとともに、（あらゆる引数および戻り値のデータ型を含む）完全な署名も、ブラウザに表示されます。

パワーバーパワーバーは、PowerBuilder セッションを開始すると表示されます。パワーバーは、アプリケーション構築に際して中心的な役割を果たします。パワーバーで［新規作成］、［オブジェクトの継承］、または［開く］ボタンをクリックすると、すべての PowerBuilder ペインタを開くことができます。パワーバーでは、ブラウザを開いて、現行アプリケーションのデバッグや実行、およびワークスペースの構築や配布を行えます。

8 PowerBuilder


ペインタバーペインタまたはエディタを開くと、ワークスペースのあるウィンドウが表示されます。構築するオブジェクトの設計は、このワークスペースで行います。また、 PowerBuilder では、ボタン付きのペインタバーが 1 つまたは複数表示されます。このボタンを使用すると、ペインタまたはエディタで使用可能なツールに簡単にアクセスできます。

スタイルバーテキストコントロールを含めることができるペインタ（たとえばウィンドウペインタ）を開くと、スタイルバーが表示されます。スタイルバー上のボタンを使用して、フォントやポイントサイズなどのテキストプロパティを変更できます。

PowerTips ボタンの上にマウスポインタを数秒置くと、ボタンについての簡単な説明（PowerTips）が表示されます。 PowerTips の表示と非表示は、任意のツールバーのポップアップメニューで［PowerTips の表示］メニュー項目を選択して切り替えます。

また、任意のツールバーのポップアップメニューで［テキストの表示］を選択すれば、機能を簡単に示すテキストをそれぞれのツールバーボタン上に表示することもできます。

環境のカスタマイズツールバーボタンのテキスト表示に加えて、ツールバーの配置場所を変更したり、新規ツールバーの追加や既存のツールバーのカスタマイズを行うこともできます。また「ペインタを開く」などの作業を実行するボタンを追加することもできます。

システムツリー、クリップビュー、および出力ビューの並べ替え、各ペインタのカスタムレイアウトのセットアップ、後に使用したワークスペースをペインタやエディタの起動時に開くかどうかの選択、ショートカットキーのカスタマイズ、さらにスクリプトに使用する色とフォントの変更なども行うことができます。

パワーバーのボタンパワーバー上のボタンを使用すれば、頻繁に使用する PowerBuilder のタスクにすばやくアクセスできます。



表 1-1: パワーバーのボタン

ボタン説明

ワークスペース、ターゲット、コンポーネントなどのオブジェクトを新規作成するか、またはツールを開く

メニュー、ユーザオブジェクト、またはウィンドウを継承する

既存のアプリケーション、データウィンドウ、関数、メニュー、パイプライン、プロジェクト、クエリ、構造体、ユーザオブジェクト、ウィンドウ、 HTML ページ、 HTML フレーム、スタイルシート、またはスクリプトファイルを開く

ウィンドウオブジェクトまたはデータウィンドウオブジェクトをプレビュー表示する

システムツリーウィンドウの表示と非表示を切り替える

出力ウィンドウの表示と非表示を切り替える

出力ウィンドウ内の次の行に移動する

出力ウィンドウ内の直前の行に移動する

実行する必要のある開発タスクのリストを表示する。これらはユーザが手動で入力するか、 PowerBuilder ウィザードで自動的に入力が可能

オブジェクトプロパティやグローバル変数のようなオブジェクト情報を参照したり、コピー、エクスポート、印刷を行う

クリップウィンドウの表示と非表示を切り替える

オブジェクトを格納するライブラリの作成や管理を行う

データベースへの接続の方法を指定する

EAServer への接続の方法を指定する

10 PowerBuilder


データベースの管理、データベースへのユーザアクセスの制御、データベース内のデータの操作を行う

ファイルを編集する

ワークスペースのインクリメンタル構築を開始する

ワークスペースのフル構築を開始する

ワークスペースを配布する

ワークスペースのフル配布などの一連の操作が進行している間に、次の操作に飛ぶことも可能

構築や配布の操作、または一連の操作を停止する

現在のターゲットに対してデバッグを実行する

ターゲットを選択し、そのデバッグを実行する

現在のターゲットを実行する

ターゲットを選択して実行する

PowerBuilder を終了する

ボタン説明


PowerBuilder オブジェクト

PowerBuilder オブジェクトPowerScript ターゲットの基本構築ブロックとしてのオブジェクトには、以下のものがあります。

表 1-2: PowerScript ターゲットの基本構築ブロック

これらのオブジェクトについては、以降の節で詳しく解説します。

アプリケーションオブジェクト

PowerBuilder では、アプリケーションの構築作業の前にアプリケーションオブジェクトを作成します。アプリケーションオブジェクトとは、ウィンドウ、メニュー、関数、データウィンドウオブジェクトなどと同様に、ライブラリ（PBL ファイル）内に保存される独立したオブジェクトです。

アプリケーションオブジェクトには、アプリケーションレベルの動作形態を定義します。たとえば、テキストのデフォルトフォントとしてどのフォントを使用するか、アプリケーションを開始するときと終了するときに行う処理の内容などを定義します。

オブジェクト説明

アプリケーションアプリケーションの構築作業の前にアプリケーションオブジェクトを作成する

ウィンドウユーザと PowerBuilder アプリケーション間の主要なインタフェース

データウィンドウリレーショナルデータベースやほかのデータリソースからデータを取得および操作する

メニュー現行のアクティブウィンドウで選択可能なコマンドやオプションを一覧表示する

グローバル関数一般的な目的の処理を実行する

クエリデータウィンドウオブジェクトのデータソースとして繰り返し使用される SQL 文

構造体 1 つまたは複数の関連する変数を 1 つの名前でグループ化したコレクション

ユーザオブジェクト再使用可能な処理モジュール、またはビジュアルあるいは非ビジュアルなコントロールのセット

パイプライン 1 つのデータベースまたは複数のデータベース間でデータを複製（転送）する

プロジェクトユーザ配布用にアプリケーションをパッケージ化する

12 PowerBuilder


ユーザがアプリケーションを実行すると、アプリケーションオブジェクトの Open イベントが発生します。アプリケーション内のアクティビティは、Open イベント用に記述したスクリプトによって開始されます。ユーザがアプリケーションを終了すると、アプリケーションオブジェクトの Close イベントが発生します。

通常は、アプリケーションの終了に必要な作業（データベースを閉じる、環境設定ファイルに書き込みをするなど）をすべて、 Close イベント用に記述したスクリプトで実行します。実行中に PowerBuilder の例外処理メカニズムによって捕捉できない深刻なエラーが発生した場合は、アプリケーションオブジェクトの SystemError イベントが発生します。

図 1-1: アプリケーションのライフサイクル

ウィンドウウィンドウは、ユーザと PowerBuilder アプリケーション間の主要なインタフェースです。ウィンドウは、情報を表示したり、ユーザに情報を要求したり、ユーザによるマウスやキーボードの操作に応答します。

ウィンドウは以下の内容から構成されます。

• プロパティ : ウィンドウの外観や動作を定義する（たとえば、ウィンドウにタイトルバーや小化ボタンを付けることも可能）。

• イベント : ユーザのアクションによって発生する



• コントロール : ウィンドウ上に配置されるスタティックテキストやコマンドボタンなどの総称

ウィンドウには、以下の図のように、いろいろな種類のコントロールがあります。

ウィンドウの左端には、水平トラックバーおよび垂直トラックバーが付いたデータウィンドウコントロールがあります。右端には、グループボックス（スタティックテキストコントロール、スピンコントロールプロパティをオンにしたエディットマスクコントロール、チェックボックスを含む）と、そのグループボックスよりも小さな、ラジオボタン付きグループボックス 2 つがあります。グループボックスの下部には、コマンドボタンがあります。

データウィンドウオブジェクト

データウィンドウオブジェクトは、リレーショナルデータベースやほかのデータソース（たとえば、 Excel のワークシートや dBASE ファイル）のデータの検索や操作を行うオブジェクトです。

提示様式データウィンドウオブジェクトでは、ユーザがいくつかの種類の中から提示様式を選択し、その提示様式を使用してデータを処理します。たとえば、タブラ提示様式やフリーフォーム提示様式でデータを表示できます。

14 PowerBuilder


データウィンドウオブジェクトのデータの提示および操作を向上させるには、たくさんの方法があります。たとえば、データウィンドウの検索データに直接結び付けられた計算フィールドやピクチャ、グラフなども使用できます。

表示様式、編集様式、入力条件則カラムに対する表示様式、編集様式、入力条件則を定義することによって、カラムにデータを表示するときの書式を指定したり、データウィンドウオブジェクトで入力されたデータを確認できます。

以下に例を示します。

• 数個の決まった値しか入力できないカラムの場合、データをラジオボタンとして表示し、エンドユーザに値を選択させます。



• データが電話番号、給与額、日付の場合、データに適した表示様式を指定できます。

• 限られた範囲の数値しか入力できないカラムには、入力条件則を指定します。入力条件則を使用すれば、入力されたデータが有効かどうかを判定するコードを記述する必要がなくなります。

Web データウィンドウ EAServer または MTS で実行される PowerBuilderコンポーネントを使用して HTML を生成することにより、HTML 形式のデータウィンドウオブジェクトを生成してブラウザで表示できます。 Web ターゲットでの Web データウィンドウの使用方法については、チュートリアルのレッスンの 1 つで案内します。

メニューメニューは、ユーザが現行のアクティブなウィンドウのメニューバーで選択できるメニュー項目のリストです。通常、メニュー項目はそれぞれ関連があります。メニューには、コマンドが用意されたり、あるタスクを実行するための代替手段が用意されます。コマンドとは、たとえば、 PowerBuilder の［ファイル］メニューの［開く］や［名前を付けて保存］などです。代替手段とはたとえば、ウィンドウペインタの［編集］メニューの項目などであり、各項目はそれぞれペインタバーのボタンに対応します。

マウスやキーボードでメニュー項目を選択したり、メニュー項目に対して定義してあるアクセラレータ（ニーモックアクセス）キーを使用できます。［ツール｜ショートカット］メニュー項目を選択して開いたダイアログボックスで、任意の PowerBuilder メニュー項目のキーボードショートカットを独自に定義できます。

16 PowerBuilder


ドロップダウンメニューは、メニューバーのメニュー項目の下に表示されるメニューです。カスケードメニューは、ドロップダウンメニューの隣に表示されるメニューです。

PowerBuilder では、メニューの選択肢をそれぞれ、メニューオブジェクトとして定義します。上図のウィンドウではメニューバーに 2 つのメニューオブジェクト（［ファイル］と［データ］）があります。［データ］のドロップダウンメニューには 3 つのメニューオブジェクト（［更新］、［削除］、［キャンセル］）があり、［更新］メニューのカスケードメニューに 2 つのメニューオブジェクト（［現在の行］、［すべての行］）があります。

グローバル関数 PowerBuilder では、以下の 2 種類の関数を定義できます。

• オブジェクト関数は、特定のオブジェクト型（たとえば、ウィンドウやメニュー）用に定義され、そのオブジェクト関数が定義されているオブジェクトの内部にカプセル化されます。さらに、システム関数（特定のオブジェクトクラスのオブジェクトがいつでも使用できる関数）とユーザ定義関数に分類されます。

• グローバル関数は、どのオブジェクト内にもカプセル化されず、独立したオブジェクトとして格納されます。

グローバル関数は、オブジェクト関数とは異なり、特定のオブジェクトインスタンスでは使用しません。そのかわり、計算や文字列処理などの一般的な処理に使用します。

クエリクエリとは、データウィンドウオブジェクトのデータソースとして再利用できるように名前を付けて保存した SQL 文です。クエリは、一度コードを記述すれば必要に応じて再利用できるので、開発の効率を高めることができます。



構造体構造体とは、 1 つ以上の関連し合う変数を 1 つの名前のもとにグループ化した集合体です。 Pascal や COBOL のような言語では、構造体はレコードと呼ばれています。

構造体では、関連し合う変数を個々にではなく 1 つの集合体として参照できます。たとえば、従業員のユーザ ID、住所、アクセスレベル、ピクチャ（ビットマップ）を user_struct という構造体として定義すると、これらの変数の集合を user_struct として参照できます。

構造体には以下の 2 種類があります。

• オブジェクト構造体は、ウィンドウやメニューのように特定のオブジェクトの種類に関連付けられ、常にそのオブジェクトのスクリプトで使用できます。また、構造体をほかのスクリプトからアクセスできるように設定することもできます。

• グローバル構造体は、アプリケーション内のオブジェクトやオブジェクトタイプには関連付けられていません。グローバル構造体のインスタンスを宣言すると、アプリケーションの任意のスクリプトでそのインスタンスを参照できます。

ユーザオブジェクトアプリケーションにはたいてい共通の機能があります。たとえば、多くのアプリケーションは、一連の操作を実行した後でウィンドウを閉じるボタン（［閉じる］ボタン）や、同じ種類のエラーチェックを行う複数のデータウィンドウコントロールを備えています。アプリケーションには、標準ファイルビューアが必要なものもあります。

同じアプリケーション機能を繰り返し利用する場合は、ユーザオブジェクトを定義します。ユーザオブジェクトを一度定義しておくと、必要なときに再利用できます。

ユーザオブジェクトは、ビジュアルまたは非ビジュアル（クラス）です。さらに標準ユーザオブジェクトとカスタムユーザオブジェクトに分類できます。標準ユーザオブジェクトは、ビジュアルであるか非ビジュアルであるかに関係なく、 PowerBuilder システムで常に使用できるオブジェクトです。 PowerBuilder の外部で作成された外部ビジュアルオブジェクト用のコントロールを使用することもできます。ユーザオブジェクトは、以下の 2 つに大別されます。

• ビジュアルユーザオブジェクト : 再利用可能なコントロール、または一貫性のある動作を行う一連のコントロールです。たとえば、 1つの単位として機能する複数のボタンから 1 つのビジュアルユーザオブジェクトの作成が可能です。ボタンには標準的な処理を実行するスクリプトを割り当てておくことができます。一度オブジェクトを定義しておくと、必要な時に使用できます。

18 PowerBuilder


• クラスユーザオブジェクト : ビジュアルコンポーネントを持たない、再利用可能な処理モジュールです。クラスオブジェクトは通常、ビジネスルールを定義したり、一連の処理を 1 つの単位として定義するのに使用します。たとえば、手数料の計算や統計の分析を行う場合に使用できます。こうした処理を実行するためには、クラスユーザオブジェクトを定義します。クラスユーザオブジェクトを使用するには、スクリプトでオブジェクトのインスタンスを作成し、そのオブジェクト関数を呼び出します。

関数や変数を定義するカスタムクラスオブジェクトは、PowerBuilderの多層アプリケーションの基礎になっています。

ライブラリウィンドウやメニューのようなオブジェクトはライブラリ（PBL ファイル）に格納します。アプリケーションを実行すると、ライブラリからオブジェクトが検索されます。また、アプリケーションでは必要な数だけライブラリを使用できます。アプリケーションで使用するライブラリは、アプリケーションを作成するときに指定します。

プロジェクト実行可能アプリケーションを構築するプロジェクトオブジェクト、サーバへの配布が可能なコンポーネント、および EAServer アプリケーションで使用するプロキシオブジェクトを作成できます。



20 PowerBuilder

第 2 章 PowerBuilder チュートリアルについて

この章についてこの章では、チュートリアルの内容とセットアップの方法について解説します。

内容

クライアント /サーバーアプリケーションの構築方法の学習PowerBuilder チュートリアルは、 4 部構成になっています。このチュートリアルの第 1 部では、 10 通りの演習を行います。この一連の演習では、 MDI （マルチドキュメントインタフェース）データベースアプリケーションを構築します。このアプリケーションでは、顧客情報や商品情報をデータベースから検索および取得したり、顧客および商品のデータに対して、データの挿入、更新、および削除を実行したりできます。

項目ページ

クライアント / サーバーアプリケーションの構築方法の学習 21

PowerDynamo Web アプリケーションの構築方法の学習 23JSP Web サービスアプリケーションの構築方法の学習 23

チュートリアルの進め方 25所要時間 26

学習する内容 26チュートリアルのセットアップ 27


クライアント / サーバーアプリケーションの構築方法の学習

顧客情報ウィンドウと商品管理ウィンドウ

この MDI アプリケーションには、 EAS Demo DB データベースのCustomer テーブルおよび Product テーブルにアクセスするための、2 つのウィンドウがあります。

この 2 つのウィンドウが、マスタウィンドウと詳細ウィンドウです。各ウィンドウでは、ある特定のテーブルから検索したマスタのリストを表示し、そのマスタのリストで選択した項目の詳細情報を表示できます。たとえば、商品管理ウィンドウでは、上部に商品リストが表示され、 1 つの製品がポインタで指し示されます。ウィンドウの下部には上部で選択された商品の詳細情報が表示されます。

ログインウィンドウ MDI アプリケーションには、起動時にデータベースに接続するためのログインウィンドウも含まれています。

22 PowerBuilder


PowerDynamo Web アプリケーションの構築方法の学習第 2 部の一連の演習では、同じデータベースに対して情報の追加および検索を実行できる Web インタフェースを構築します。ただし、今回はブラウザを使用しません。

チュトリアル Web ページ

PowerDynamo Web ターゲットの作成チュートリアルでは、 5 つの Webページを使用して、ログイン、ウェルカムページへのアクセス、データベースへの商品の追加、商品情報の表示を行います。次にその一例としてウェルカムページを取り上げます。

Web ページを使用すると、データソースにアクセスしたり、以前に作成した Web データウィンドウを表示できます。

PowerBuilder Enterpriseチュートリアルの Web アプリケーション部分を完了させるには、以下の準備が必要です。

• PowerBuilder Enterprise エディション

• PowerBuilder の Web ターゲットオプションのインストール

• EAServer と PowerDynamo へのアクセス


JSP Web サービスアプリケーションの構築方法の学習

JSP Web サービスアプリケーションの構築方法の学習JSP Web ターゲットの作成チュートリアルでは、4GL JSP ページを含む3 つの JSP ページを作成します。このうち 2 つのページで、為替レートを計算する Web サービスを呼び出します。

このチュートリアルで作成する 4GL Web ページの画面を以下に示します。

24 PowerBuilder


チュートリアルの進め方表 2-1: チュートリアルを構成する各レッスンとその内容

PowerDynamo または JSP Web ターゲットのみを学習したい場合は、チュートリアルの第 1 部で開発したソリューションを利用できます。このソリューションは、 Tutorial¥Solutions ディレクトリにあります。

レッスンチュートリアルの内容

1 PowerBuilder を起動し、PowerBuilder 開発環境をよく理解した上で、PowerBuilder ワークスペースおよびターゲットでテンプレートアプリケーションウィザードを使用してアプリケーションオブジェクト、ウィンドウ、およびメニューを作成する

2 PowerBuilder 環境を詳しく調べ、ワークスペースをカスタマイズする

3 データベースに接続するログインウィンドウを作成する。ユーザにデータベース接続パラメータ（ユーザ ID およびパスワード）を入力させる

4 トランザクションオブジェクトとユーザ入力パラメータを使用してデータベースに接続する。PowerBuilder 環境におけるデータベースプロファイルの定義方法も参照する

5 マスター / 詳細データウィンドウコントロールを追加して基本のベースシートウィンドウを変更する。また、データを検索したり、データベースに対して挿入、更新、および削除の処理を行うスクリプトを記述する

6 アプリケーションのフレームメニューの修正、新しいシートメニューの作成を行う

7-8 顧客情報や商品情報を検索するデータウィンドウオブジェクトを作成し、顧客情報ウィンドウと商品管理ウィンドウに追加する

9 作成したアプリケーションをデバッグモードで実行する。ここでは、スクリプトに対するブレークポイントの設定、ステップ実行、変数の表示について学習する

10 新規のウィンドウを作成して、PowerBuilder の例外処理をテストする

11 PowerBuilder 開発環境外でアプリケーションを実行する場合に使用できる実行ファイルを作成する

12 PowerDynamo Web ターゲットの作成、ハイパーリンクおよびグラフィック付きの Web ページの作成、検証スクリプトを用いたログインページの作成、 Web ページの配布および構築を行う

13 Web データウィンドウを既存の Web ページに追加する。データソースに商品情報を追加し、情報を表示できるようにする

14 4GL および非 4GL ページを使用して JSP Web ターゲットを作成し、インターネットで利用可能な Web サービスを呼び出す


チュートリアルの進め方

所要時間

チュートリアルは約 5、 6 時間で全体を学べますが、あるレッスンを終えた時点で中断して、後で残りを引き続き学ぶこともできます。

学習する内容クライアント / サーバアプリケーション

この PowerBuilder チュートリアルでは、以下の基本動作について学習します。

表 2-2: PowerScript チュートリアルで紹介する機能

PowerDynamo または JSP Web アプリケーション

Web ターゲットの基本的な技術および概念として、以下の内容を学びます。

機能目的

アプリケーションペインタ

アプリケーションオブジェクトとアプリケーションレベルでのスクリプトを定義

ウィンドウペインタシングルラインエディットコントロール、スタティックテキストコントロール、コマンドボタンコントロール、データウィンドウコントロール、ウィンドウレベルのスクリプト、およびコントロールレベルのスクリプトを作成

データウィンドウペインタ

選択オプションと表示オプションを定義

メニューペインタメニュー、メニュー項目、アクセラレータキー、およびショートカットキーを定義

レイアウトビューアプリケーション実行時のウィンドウ、メニュー、およびデータウィンドウの外観を設計

スクリプトビューアプリケーション、ウィンドウ、ウィンドウコントロール、およびメニューのスクリプトを定義

デバッガアプリケーション実行時に問題を引き起こすロジックエラーを検出

プロジェクトペインタ

アプリケーションの実行ファイルを作成

26 PowerBuilder


表 2-3: Web ターゲットチュートリアルで紹介する機能

このチュートリアルを学習しても、 PowerBuilder を完璧に習得できるわけではありません。習得のためには、実際にアプリケーションを構築する経験を重ねる必要があります。しかし、このチュートリアルで実際にアプリケーションを構築することにより、今後の学習に必要な基礎を固めることができます。

チュートリアルのセットアップチュートリアル開始前に、データベースへのアクセスが可能なことと、チュートリアルファイルがあることを確認してください。

データベースとの接続チュートリアルでは、 PowerBuilder とともにインストールされる EASDemo DB V9 データベースを使用します。このデータベースは、AdaptiveServer Anywhere データベースであり、 Sybase Adaptive Server Anywhereエンジンを必要とします。

ローカルマシンまたはサーバ上に Sybase Adaptive Server Anywhere をまだインストールしていない場合は、すぐにインストールする必要があります。インストールは、 PowerBuilder の CD-ROM から行うことができます。 PowerBuilder をデフォルト以外の場所にインストールしてある場合は、EAS Demo DB をデータソースとして定義する odbc.ini レジストリエントリが Adaptive Server Anywhere エンジンの場所を正しく参照していることを確認してください。

チュートリアルディレクトリ

チュートリアルでは、以下のファイルを使用します。

機能目的

Web ターゲットウィザード

Web ページの設計やサーバとの対話処理の追加、およびブラウザ環境で作業するためのその他の要件を満たす

スクリプトビューアプリケーション、 Web ページ、および Web コントロール用のスクリプトを定義する

HTML エディタページビューとソースビューを用いて Web ページを編集し、 4GL ページ設計の利用法を学ぶ


チュートリアルのセットアップ

表 2-4: PowerScript チュートリアルに必要なファイル

PowerBuilder をインストールすると、上記のファイルが Tutorial ディレクトリにインストールされます。このディレクトリは、 PowerBuilderのインストールディレクトリのサブディレクトリです。

チュートリアル終了後は、これらのファイルを削除してもかまいません。

Tutorial¥Solutions ディレクトリ

Tutorial¥Solutions ディレクトリ内には、 pbtutor.pbl という PowerBuilderライブラリがあります。この PowerBuilder ライブラリ内には、チュートリアルの第 1 部で作成したすべてのオブジェクトおよびスクリプトだけでなく、ワークスペースおよびターゲットファイルも含まれています。チュートリアルの第 1 部が完了するまでの間は、このソリューションライブラリをリファレンスとして使用できます。

チュートリアルの Web アプリケーションの部分のみを学習する場合には、このソリューションライブラリを出発点として使用できます。246 ページの「このチュートリアルに必要なファイルの入手」を参照してください。

Web ターゲットのチュートリアル

PowerDynamo Web ターゲットおよび JSP Web サービスのチュートリアルを開始する際は、以下のツールがコンピュータにインストールされていることを事前に確認してください。

• EAServer 4.2 以降

• PowerDynamo 3.6 以降（PowerDynamo チュートリアルの場合のみ）

• Adaptive Server Anywhere 8.0 以降

• PowerBuilder の Web ターゲット機能

• Internet Explorer 6.0

ファイル内容

tutor_pb.pbl チュートリアルで使用するオブジェクトを含んだ PowerBuilder ライブラリ

pbtutor.hlp チュートリアルで構築されたウィンドウに状況依存ヘルプを提供するヘルプファイル

tutsport.bmp ビットマップ

tshirtw.jpg グラフィック

tutorial.ico アイコン

28 PowerBuilder

第 2 部クライアント / サーバーアプリケーションの構築

第 2 部は、 PowerBuilder の基本操作を示したチュートリアルです。簡単なデータベースアプリケーションの作成のしかたを、手順を追って説明しています。

レッスン 1 PowerBuilder の起動

このレッスンでは、 PowerBuilder を起動してアプリケーションを開発するための必要事項について説明します。

このレッスンでは、以下の項目について学習します。

• ワークスペースの新規作成

• ターゲットの作成

• アプリケーションのアイコンの指定

• メインウィンドウのサイズ変更

• アプリケーションの実行

所要時間約 15 分


ワークスペースの新規作成


現在の学習個所> ワークスペースの新規作成

ターゲットの作成アプリケーションのアイコンの指定メインウィンドウのサイズ変更アプリケーションの実行

ワークスペースは、 PowerBuilder のターゲットを構築、配置、デバッグ、実行する場所です。 1 つのワークスペース内に複数のターゲット（このチュートリアルの第 3 部で取り上げている Web ターゲットも含む）を構築できます。

まず、 PowerBuilder を起動して、新規ワークスペースを作成します。

チュートリアルをはじめる前にインストールマニュアルには新の情報が記載されています。チュートリアルをはじめる前に必ず目を通すようにしてください。チュートリアルを完了するのに必要なファイルがすべて揃っていることを確認するには、 27 ページの「チュートリアルのセットアップ」を参照してください。

1 Sybase¥PowerBuilder 9.0 のパス内の PowerBuilder アイコン（PB90J.EXE を表す）をダブルクリックします。またはWindows の［スタート］メニューから［プログラム｜ Sybase ｜PowerBuilder 9.0 ｜ PowerBuilder 9.0］を選択します。

PowerBuilder へようこそダイアログボックスが表示された場合このダイアログボックスが PowerBuilder 起動のたびに表示されないようにするには、［次回からこのウィンドウを表示しない］チェックボックスをオンにします。PowerBuilder セッションを開始して［このウィンドウを閉じる］をクリックするたびに、近使用されたワークスペースがロードされるようにするには、［スタート時に前回使用したワークスペースをロードする］チェックボックスをオンにします。

PowerBuilder 開発環境が表示されます。

32 PowerBuilder


マシン上で初めて PowerBuilder を開いた場合は、システムツリー内に上位エントリしか表示されません。これは、現在どのワークスペースも開いていないということです。開いているワークスペースがあれば、システムツリーの内部にターゲットおよびオブジェクトが表示されます。

2 ［ファイル］メニューから［新規作成］を選択します。またはパワーバーの［新規作成］ボタンをクリックします。

新規作成ダイアログボックスの［ワークスペース］ページが表示されます。



新規作成ダイアログボックスに、さまざまなページが表示された場合新規作成ダイアログボックスでは、前回ダイアログを閉じたときに使用していたタブページが表示されます。このステップでは、［ワークスペース］タブをクリックして［ワークスペース］ページが表示されるかどうかを確認します。

3 新規作成ダイアログボックスの［ワークスペース］ページから「ワークスペース」を選択します。［OK］をクリックします。

新しいワークスペースダイアログボックスが表示されます。

4 Tutorial フォルダに移動します。

Tutorial フォルダは、 PowerBuilder 9.0 フォルダの直下にあります。

5 ［ファイル名］テキストボックスに「MyWorkspace」と入力します。［保存］をクリックします。

新しいワークスペースダイアログボックスが閉じ、作成したワークスペースがシステムツリー内の初の項目として表示されます。

34 PowerBuilder


ターゲットの作成

現在の学習個所ワークスペースの新規作成

> ターゲットの作成アプリケーションのアイコンの指定メインウィンドウのサイズ変更アプリケーションの実行

ここでは、テンプレートアプリケーションウィザードを使用して、新規ターゲットを作成します。選択された内容に基づいて、テンプレートアプリケーションウィザードでは、コーディング済みのイベント、メニュー、ウィンドウ、およびアプリケーションオブジェクトとユーザオブジェクトが作成されます。

1 ［ファイル］メニューから［新規作成］を選択し、［ターゲット］タブをクリックします。またはシステムツリー内の MyWorkspace を右クリックし、ポップアップメニューの［新規作成］を選択して、［ターゲット］タブをクリックします。

新規作成ダイアログボックスの［ターゲット］ページが表示されます。

2 ［テンプレートアプリケーション］アイコンを選択して、［OK］をクリックします。

テンプレートアプリケーションウィザードが表示されます。ほとんどのウィザードでは、初のページでウィザードの使用目的が説明されます。ウィザードの使用中は、〔F1〕を押すことでたいていのフィールドのヘルプ情報を表示できます。



3 ［次へ］を 2 回クリックして、新規アプリケーションとライブラリの指定ページを表示します。

4 ［アプリケーション名］テキストボックスに「pbtutor」と入力します。

このアプリケーション名を使用するライブラリおよびターゲットには、ウィザードにより自動的にファイル名が割り当てられます。ライブラリには PBL 拡張子が、ターゲットには PBT 拡張子が割り当てられます。

5 ［次へ］をクリックします。

［アプリケーションの種類の指定］ページが表示されます。［マイクロヘルプ付き MDI アプリケーション］ラジオボタンが選択されています。 MDI テンプレートアプリケーションを作成するので、このラジオボタンの選択を変更する必要はありません。

MDI とはMDI は、マルチドキュメントインタフェースの略称です。MDI アプリケーションでは、アプリケーション用のメインウィンドウのことを MDI フレームと呼びます。 MDI フレームメニューバーを使用して、さらにシートウィンドウという、フレームウィンドウの内部に表示されるウィンドウを開くこともできます。

6 ［次へ］を 4 回クリックして、［シート名の指定］ページを表示します。

このチュートリアルでは、アプリケーションの種類、ライブラリ探索パス、フレームとフレームメニュー名、シートメニューとシート管理サービス名、および MDI ベースシート名に、デフォルト値をそのまま使用します。

［次へ］をクリックしすぎた場合ウィザードの［戻る］ボタンをクリックすれば、目的のウィザードページに戻ることができます。

7 ［シート名の指定］ページで、［シート 1］テキストボックスに「w_customers」、［シート 2］テキストボックスに「w_products」と入力し、［シート 3］テキストボックスを空白にします。

36 PowerBuilder


デフォルトのベースシート（w_pbtutor_basesheet）を基に 2 つのウィンドウが作成されます。 1 つが顧客情報用、もう 1 つが商品管理用です。例外処理のレッスンで、 3 つ目のシートウィンドウを追加します。

8 ［次へ］をクリックします。シート 1 の表示名として「顧客情報」と入力します。シート 2 の表示名として「商品管理」と入力します。

ここで入力した名前は、それぞれのシートウィンドウのタイトルバーに表示されます。



9 ［次へ］を 2 回クリックします。

バージョン情報ウィンドウおよびツールバーウィンドウの名前を変更する必要はありません。

10 ［接続の指定］ページで「なし」を選択します。

接続オブジェクトは後で追加します。

11 ［次へ］を 2 回クリックして、［アプリケーションの作成準備完了］ページを表示します。

プロジェクトは後で作成します。

後のウィザードページが表示されます。ウィザードページに、現在の選択内容がリストされます。もう一度見直して、必要であれば［戻る］ボタンを使用して前のページに戻り、変更を行うこともできます。

12 ［To-Do リストの作成］チェックボックスがオンになっていることを確認します。［完了］ボタンをクリックします。

38 PowerBuilder


アプリケーションウィザードは pbtutor.pbt ターゲットおよびpbtutor.pbl ライブラリを作成し、新しい pbtutor アプリケーションをデフォルトアプリケーションとして設定します。システムツリーを展開すると、テンプレートアプリケーションウィザードで作成されたオブジェクトをすべて表示できます。


アプリケーションのアイコンの指定


現在の学習個所ワークスペースの新規作成ターゲットの作成

> アプリケーションのアイコンの指定メインウィンドウのサイズ変更アプリケーションの実行

このステップでは、アプリケーションのアイコンを指定します。アイコンは、実行中にアプリケーションを小化したときにワークスペースに表示されます。実行ファイルを作成すると、アイコンは自動的に設定されます。アイコンの指定は、アプリケーションペインタのプロパティビューから行います。

1 システムツリーの pbtutor アプリケーション項目をダブルクリックします。またはpbtutor アプリケーション項目を右クリックして、ポップアップメニューから［編集］を選択します。

pbtutor アプリケーション項目は、テンプレートアプリケーションウィザードで作成した pbtutor.pbl および pbtutor ターゲットオブジェクトの下にあります。アプリケーションペインタに、アプリケーションオブジェクトのさまざまなビューが表示されます。

2 アプリケーションペインタにプロパティビューが表示されていることを確認してください。

40 PowerBuilder


プロパティビューが開いていない場合は、アプリケーションペインタのメニューバーから［ビュー｜プロパティ］を選択して開くことができます。プロパティビューが開いている場合は、メニュー項目がグレー表示されます。

3 プロパティビューの［付加的なプロパティ］ボタンをクリックします。

タブ付きのアプリケーションプロパティシートが表示されます。

4 ［アイコン］タブをクリックします。

5 ［アイコンの参照］をクリックします。Tutorial ディレクトリが開きます。

6 tutorial.ico ファイルを選択します。［開く］をクリックします。

拡張子 ico が見つからない場合Windows エクスプローラのオプションダイアログボックス（Windows 98 ではフォルダオプションダイアログボックス）で、［登録されているファイルの拡張子は表示しない］チェックボックスをオンにした場合、 ICO ファイルの拡張子は表示されません。



アプリケーションプロパティシートの［アイコン］ページにチュートリアルアイコンが表示されます。

7 ［OK］をクリックします。ペインタバー 1 の［保存］ボタンをクリックするか、［ファイル｜上書き保存］を選択します。ペインタバー 1 の［閉じる］ボタンをクリックするか、［ファイル｜閉じる］を選択します。

42 PowerBuilder


メインウィンドウのサイズ変更

現在の学習個所ワークスペースの新規作成ターゲットの作成アプリケーションのアイコンの指定

> メインウィンドウのサイズ変更アプリケーションの実行

ここでは、アプリケーションのメインウィンドウのサイズを変更します。アプリケーションを実行すると、指定した位置に指定したサイズでメインウィンドウが表示されます。

1 システムツリーで w_pbtutor_frame をダブルクリックします。

アプリケーションのフレームウィンドウが開きます。

2 プロパティビューの［全般］ページで［中央］チェックボックスをオンにします。

これで、アプリケーションを実行すると、フレームウィンドウが中央に表示されます。


メインウィンドウのサイズ変更

3 ［ウィンドウの状態］ドロップダウンリストボックスを下にスクロールして、「normal!」を選択します。

プロパティビューの外観が異なっている場合プロパティビューのラベルの位置を変更するには、プロパティビューを右クリックし、ポップアップメニューから変更後のラベル位置を選択します。（上の図のように）全フィールドの左側、またはテキストフィールド上部とチェックボックスの右側にラベルを配置する 2 通りの表示ができます。

4 プロパティビューの［その他］タブをクリックします。［幅］テキストボックスに「3000」、［高さ］テキストボックスに「2400」と入力します。〔Tab〕キーを押します。

レイアウトビュー内にある長方形のウィンドウのサイズが変更されます。入力する値は、 PowerBuilder 単位系（PBU）です。

5 メニューバーから［ファイル｜閉じる］を選択します。変更内容を保存するように要求されたら、［はい］ボタンをクリックします。

ウィンドウペインタが閉じます。

44 PowerBuilder


次のステップでは、アプリケーションを実行します。アプリケーションを実行すると、フレームウィンドウが中央に表示され、指定したサイズになります。


アプリケーションの実行


現在の学習個所ワークスペースの新規作成ターゲットの作成アプリケーションのアイコンの指定メインウィンドウのサイズ変更

> アプリケーションの実行

このステップでは、アプリケーションを実行して、それがどのように動作するのかを確認します。この時点では、アプリケーションで実行される処理はあまり多くありません。アプリケーションを実行することで、テンプレートアプリケーションウィザードでアプリケーションを作成する際に自動的に生成されるウィンドウとメニューを確認できます。このウィンドウとメニューを後で変更します。

1 パワーバーの［実行］ボタンをクリックします。

MDI フレームウィンドウが画面に大化表示されます。ウィザードを使用して作成したすべての MDI アプリケーションには、メニューバーとツールバーがあり、一部の項目はすでにコーディングされています。

2 ［ファイル｜新規作成｜顧客情報］を選択します。

アプリケーションによってシートウィンドウが開きます。シート1 のテンプレートアプリケーションウィザードで入力した表示名がタイトルバーに表示されます。シートウィンドウのタイトルの後ろには、表示中のウィンドウのインスタンスを示す番号が付きます。

46 PowerBuilder


ウィンドウのタイトルバーの数字について「1」という数字がウィンドウタイトルの後に表示されるのは、開いている w_customers のシートウィンドウの初のインスタンスであることを示すためです。タイトルバーにインスタンス番号を追加するスクリプトは、ベースシートウィンドウであるw_master_detail_ancestor の ue_postopen イベントに記述されています。

3 ［ファイル｜新規作成｜商品管理］を選択します。

2 つ目のアプリケーションシートウィンドウが表示されます。

4 ［ウィンドウ｜縦に並べて表示］を選択します。

2 つのシートウィンドウが MDI フレーム内で上下に並べて表示されます。アクティブな方が上に配置されます。

5 メニューバーから［ファイル｜ツールバー］を選択します。

ツールバーダイアログボックスが表示されます。

6 ツールバーダイアログボックスの［浮動］を選択します。

MDI フレーム内でツールバーが浮動状態になります。ツールバーダイアログボックスの背後に浮動ツールバーが隠れている場合もあります。

7 ［上端］を選択します。

フレームの上部にツールバーが再配置されます。



8 ［完了］をクリックして、ツールバーダイアログボックスを閉じます。

9 ［ファイル｜終了］を選択します。

アプリケーションが閉じ、 PowerBuilder 開発環境に戻ります。

次に PowerBuilder を起動するとき、前回の PowerBuilder 終了時の状態でワークスペースおよびペインタを開くには、以下のように操作します。

10 メニューバーから［ツール｜システムオプション］を選択し、［ワークスペース］タブをクリックします。

11 ［開始時にワークスペースを再度開く］および［ワークスペースを開く時にペインタを再ロードする］チェックボックスがオンになっていることを確認します。［OK］をクリックします。

これで PowerBuilder を起動すると、終了時に開いていたワークスペースおよびペインタが開くようになります。終了時にPowerBuilder 内でコーディングしていた場合は、後にコーディングしていたスクリプトが開き、後に編集した行位置にカーソルが設定されます。

48 PowerBuilder

レッスン 2 PowerBuilder の環境のカスタマイズ

レッスン 2 では、 PowerBuilder の環境をよく理解しワークスペースをカスタマイズするための必要事項について説明します。レッスン 2 は必須ではないので、このレッスンを省略したい場合はレッスン 3 に飛んでもかまいません。


• システムツリーウィンドウの操作

• オブジェクトのオープン

• ビューの操作

• ツールバーのセットアップ



システムツリーウィンドウの操作

システムツリーウィンドウの操作

現在の学習個所> システムツリーウィンドウの操作

オブジェクトのオープンビューの操作ツールバーのセットアップ

システムツリーの［ワークスペース］ページに、作業の概要が表示されます（システムツリーのほかのページは Web ターゲット関連のもので、 PowerScript ターゲットとは無関係です）。ワークスペースとその内部のオブジェクトを展開すると、ターゲットの内容および構造を確認できます。

ワークスペース内のオブジェクトは、すべて直接操作できます。たとえば、システムツリーのポップアップメニューを使用して、ウィンドウの編集、実行、検索、再生成などを行うことができます。このステップでは、システムツリーを別の位置に移動したり、閉じたり開いたりする練習をします。ドラッグバーを使用すると、メインウィンドウを基準にシステムツリーを別の位置に移動できます。システムツリー、クリップウィンドウ、および出力ウィンドウの並べ方を変更することもできます。

1 パワーバーの［出力］ボタンをクリックします。出力ウィンドウが表示されます。

2 メニューバーから［ツール｜システムオプション］を選択します。［全般］ページの［水平ドックウィンドウを大幅にする］ボタンをクリックしてオフにします。

メインウィンドウの上部から下部まで、システムツリーおよびクリップウィンドウが表示されます。

3 システムツリーの上部で、ドラッグバーをクリックしてマウスボタンを押した状態にします。システムツリーをドラッグして、ペインタワークスペースの上部、下部、または右の方へ移動します。

ドラッグを開始すると、システムツリーの周囲にグレーの四角形が表示されます。マウスボタンを放したときの範囲が、システムツリーが占める領域となります。

50 PowerBuilder


4 グレーの矩形アウトラインがシステムツリーを表示する位置に移動したら、マウスのボタンを放します。

新しい場所にシステムツリーが表示されます。

5 パワーバーの［システムツリー］ボタンをクリックして、システムツリーを閉じます。

システムツリーが閉じた後も、現在のワークスペースは開いたままです。システムツリーを閉じると、ペインタのワークスペースビューのスペースが増大します。

6 パワーバーの［システムツリー］ボタンをクリックして、もう一度システムツリーを開きます。

7 パワーバー上にある各ウィンドウ用のボタンをクリックするか、各ウィンドウの隅にある小さな x をクリックして、クリップウィンドウおよび出力ウィンドウを閉じます。

8 MyWorkspace を右クリックして、ポップアップメニューから［閉じる］を選択します。

ワークスペースが閉じます。システムツリーにワークスペースが表示されていない状態になります。


オブジェクトのオープン

オブジェクトのオープン

現在の学習個所システムツリーウィンドウの操作

> オブジェクトのオープンビューの操作ツールバーのセットアップ

ここでは、テンプレートアプリケーションウィザードによって作成されたオブジェクトを開きます。

1 メニューバーから［ファイル｜近使用したワークスペース］を選択し、カスケードメニューから「MyWorkspace」を選択します。

2 システムツリーで、 MyWorkspace、 pbtutor ターゲット、および pbtutor.pbl を展開します。

3 pbtutor アプリケーションターゲットをダブルクリックします。または pbtutor アプリケーションオブジェクトを右クリックして、ポップアップメニューから［編集］を選択します。

52 PowerBuilder


アプリケーションペインタに、pbtutor アプリケーションオブジェクトのさまざまなビューが表示されます。ビューのレイアウト構成は、ユーザによって異なります。デフォルトのレイアウトを表示するには、［ビュー｜レイアウト｜（デフォルト）］を選択します。

デフォルトのアプリケーションペインタのレイアウトに、 2 つのタブ付きペインのスタックが表示されます。左のスタックにはスクリプトビュー（［Open］タブが選択されており、アプリケーションオブジェクトの Open イベントのスクリプトが表示されている）、イベントリストビュー、関数リストビュー、およびインスタンス変数の宣言ビューが含まれています。右のスタックには、プロパティビュー、および非ビジュアルオブジェクトリストビューが含まれています。

4 スクリプトビューで、 Open イベントのコードを確認します。

このコードは、メインウィンドウを開くためのコードで、ウィザードで自動的に生成されたものです。このチュートリアルの後半でこのコードを修正します。


ビューの操作

ビューの操作

現在の学習個所システムツリーウィンドウの操作オブジェクトのオープン

> ビューの操作ツールバーのセットアップ

ここでは、 PowerBuilder ペインタビューの位置や外観の調整方法について学習します。メニューバーの［ビュー］メニューからビューを選択してペインタのワークスペースに追加できます。

種類が同じ複数のビューを追加し、それらのビューを結合して下部に選択タブを持つペインスタックを作成できます。ペインタのワークスペース内でビューやその隣のビューの周囲にある分割バーをつかんでドラッグすることで、ビューのサイズを変更できます。

ここでは、アプリケーションペインタを使用して、ペインタビューの外観を変える方法を実際に説明しますが、どのペインタにおいても同様にビューに対する操作を行うことができます。

この練習では以下の操作を行います。

• 新規スクリプトビューの追加

• ビューのタイトルバーの表示

• ビューの浮動化と固定化

• タブ付きビューの操作

• ビューのレイアウト構成の保存

• ビューレイアウト構成を標準設定に戻す

54 PowerBuilder


新規スクリプトビューの追加

デフォルトのアプリケーションペインタのレイアウトには、スクリプトビューが 2 つあります。スクリプトビューの 1 つには、アプリケーションオブジェクトのイベント用スクリプトが表示されます。もう 1つのスクリプトビューには、オブジェクトインスタンス用に宣言された変数、またはアプリケーション全体に対して宣言された変数が表示されます。これらのスクリプトビューは、同一のタブ付きビュー（ペイン）のスタック内に存在します。

ここでは、3 つ目のスクリプトビューとして、タブ付きペインのスタックに含まれないビューを追加します。ペインタのレイアウトには複数のスクリプトビューを追加できますが、同一スクリプトを複数のビューで開くことはできません。

1 メニューバーから［ビュー｜スクリプト］を選択します。

新規スクリプトビューが表示されます。このスクリプトビューは、タブ付きペインのスタックには追加されません。このスクリプトビューの初のドロップダウンリストボックス内にはアプリケーションオブジェクトがリストされますが、 2 番目のドロップダウンリストボックス内は空です。

既存のスクリプトビューに Open イベントが表示されている場合、新規スクリプトビューは空になります。既存のスクリプトビューに Open イベントが表示されていない場合は、新規スクリプトビューに Open イベントが表示されます。


ビューの操作

2 2 番目のドロップダウンリストボックスから Close イベントを選択します。

別のスクリプトビューがすでに Close イベントを開いている場合は、 PowerBuilder ステータスバー内にエラーメッセージが表示されます。

ビューのタイトルバーの表示

ここでは、ビューのタイトルバーをペインタワークスペースの背景に固定させて表示します。固定されていないタイトルバーが表示されるのは、ビューの上端近くにマウスポインタを置いたままにした場合だけです。

1 先ほど追加した新規スクリプトビューの上部にマウスポインタを移動します。

ビューのタイトルバーが表示されます。タイトルバーの左端には、［プッシュピン］ボタン、右端には［大化］ボタンおよび［閉じる］ボタンがあります。タイトルバーの左端にある［プッシュピン］ボタンの横に、ビューの名前が表示されます。

2 タイトルバーの［プッシュピン］ボタンをクリックします。またはビュータイトルバーを右クリックして、ポップアップメニューから［タイトルバー固定］を選択します。

［プッシュピン］ボタンと［タイトルバー固定］メニュー項目は、クリックするたびにオンとオフが切り替わります。［プッシュピン］ボタンまたは［タイトルバー固定］をもう一度クリックすると、ビュータイトルバーが固定状態から解放されます。

ビューの浮動化と固定化

このステップでは、ペインタのワークスペースでビューの浮動化と固定化を行います。ビューを浮動化すると、ペインタフレームの外にビューを移動できるようになります。

1 浮動化する非スタックビューのタイトルバーを右クリックします。またはタブ付きペインのスタックで、ビューのタブを右クリックします。

56 PowerBuilder


タイトルバーが固定されていない場合は、マウスポインタをタイトルバー領域の上に移動し、タイトルバーが表示されてから右クリックします。

2 ポップアップメニューで［浮動］をクリックします。

ビューが浮動状態にある場合は、［浮動］メニュー項目は選択できません。ビューが固定状態にある場合は、［固定］メニュー項目は選択できません。

3 画面の周囲にビューをドラッグします。

浮動型ビューは、ペインタのワークスペースの外にも配置できます。

4 浮動型ビューのタイトルバーを右クリックします。ポップアップメニューで［固定］をクリックします。

ビューが元の位置に戻ります。

タブ付きビューの操作

このステップでは、タブ付きペインのスタックからビューを切り離し、独立したビューにする作業を行います。その後で、そのビューを元のスタックに戻し、スタック内のビューの位置を変更します。

1 ［関数リスト］タブ上でマウスボタンを押したままにします。アプリケーションペインタの 2 つのデフォルトスタックを区切る分割バー上に、タブをドラッグします。マウスボタンを放します。

マウスボタンを放すと、関数リストビューがスタックから切り放されます。タブをかなり遠くの位置にドラッグして、プロパティビューおよび非ビジュアルオブジェクトリストの右スタック上でマウスボタンを放すと、関数リストがそのスタックの一部になります。

ビューをスタックから浮動させる別の方法〔Ctrl〕または〔Shift〕を押した状態でスタックからタブ付きペインのタブの部分をドラッグすると、そのペインが浮動型ビューになります。


ビューの操作

2 ［関数リスト］タイトルバー上でマウスボタンを押した状態にします。浮動型ビューを、元のスタック上にドラッグします。関数リストビューのグレーの矩形アウトラインが、スタックの上に重なり合ったら、マウスボタンを放します。

関数リストビューが元のスタックに戻り、スタック内の後のペインとして追加されます。

3 ［関数リスト］タブ上でマウスボタンを押したままにします。この後のペインを、同じスタック内にあるほかのペインの上にドラッグします。小さなグレーの矩形アウトラインが、タブウィンドウ内の別のタブの上に重なり合ったら、マウスボタンを放します。

マウスボタンを放したスタック内の位置に、関数リストビューが移動します。

ビューのレイアウト構成の保存

ペインタビューのレイアウト構成を保存して、ペインタを開くたびに使用できるようにします。

1 ペインタ内でビューを使いやすい配置に並べます。

2 メニューバーから［ビュー｜レイアウト｜管理］を選択します。

3 レイアウトダイアログボックスの［新しいレイアウト］ボタンをクリックします。

4 テキストフィールドにレイアウト名を入力し、ダイアログボックスの背景をクリックして、ダイアログボックスの右上隅にある［x］ボタンをクリックして閉じます。

レイアウト構成が保存されます。これで、［ビュー｜レイアウト］を選択すると、カスケードメニューに保存したレイアウトが表示されます。

ツールバーおよびシステムツリーのレイアウトの保存ツールバーおよびシステムツリーのカスタマイズ内容は、ビューのレイアウトとは別個に保存されます。これらの設定値はPowerBuilder に保持され、ユーザがアクセスしたワークスペースおよび選択したビューレイアウトのすべてに再適用されます。

58 PowerBuilder


ビューレイアウト構成を標準設定に戻す

PowerBuilder ペインタには、デフォルトのビューレイアウトがあります。レイアウト構成は、いつでもこのデフォルトのレイアウトにリセットすることができます。

1 メニューバーから［ビュー｜レイアウト］を選択します。

2 カスケードメニューから「デフォルト」を選択します。

デフォルトのビューレイアウトがペインタワークスペースに適用されます。


ツールバーのセットアップ


現在の学習個所システムツリーウィンドウの操作オブジェクトのオープンビューの操作

> ツールバーのセットアップ

ペインタのワークスペースには、パワーバーなど、作業時に使用できるペインタバーツールバーが常に含まれています。ツールバーのボタンは、使用中のターゲットまたはオブジェクトの種類に応じて変わります。ツールバーをカスタマイズして、機能を追加することもできます。

ここでは、ツールバーの外観を以下のように変更します。

• ツールバーボタン上へのラベルの表示

• ツールバーの浮動化

• ツールバーの再配置

ツールバーボタン上へのラベルの表示

ツールバーボタンの上にカーソルを置いて PowerTip を表示することで、ツールバーボタンの機能を知ることができます。 PowerTip は、ボタンの機能を示すポップアップテキストです。

ツールバーの各ボタン上に、ラベルを表示することもできます。

1 パワーバーにあるボタンのいずれかの上にマウスポインタを合わせます。ここではクリックしないでください。

ボタンの PowerTip が表示されます。

2 メニューバーから［ツール｜ツールバー］を選択します。

ツールバーダイアログボックスが表示されます。

60 PowerBuilder


3 ［テキストの表示］チェックボックスをオンにしてから、［閉じる］ボタンをクリックします。

パワーバーとペインタバーにある各ボタンにラベルが表示されます。

ツールバーの浮動化

作業時などには、ツールバーを浮動化して、ペインタのワークスペースの周辺に移動させることができます。

1 パワーバー内の任意の場所を右クリックします。

ツールバーのポップアップメニューが表示されます。ポップアップメニューで、ワークスペースの上下左右の位置にツールバーを設定できます。ツールバーを浮動状態に設定することもできます。

ポップアップメニューについてPowerBuilder では、ポップアップメニューを用いてすばやく処理を行うことができます。ポップアップされるメニュー項目は、どのペインタを使用しているか、およびワークスペース内のどこで右マウスボタンをクリックしたかによって異なります。

2 ポップアップメニューで［浮動］をクリックします。

ペインタバーが浮動型ツールバーに変わります。浮動型ツールバーの形状は調整できます。



3 パワーバーの端または境界にマウスポインタを移動します。パワーバー上で左マウスボタンを押し、ワークスペースの左側にドラッグします。パワーバーが垂直バーに変わったら、マウスボタンを放します。

フレームの左部にパワーバーが固定されます。

ツールバーの再配置

ツールバーの位置は、作業スタイルに合わせてカスタマイズできます。

1 メニューバーから［ツール｜ツールバー］を選択します。

ツールバーダイアログボックスが表示されます。現在選択されているツールバーの位置は、［移動］ラジオボタンのうちのどれがチェックされているかを調べればわかります。

62 PowerBuilder


2 ［上部］をクリックします。

この操作により、パワーバーがワークスペースの上部に再配置されます。

ラジオボタンのグレー表示（指定したツールバーが表示されていない場合）指定したツールバーがペインタに表示されていない場合は、そのツールバーをワークスペース内のどの位置に表示するかを選択できません。この場合は、ラジオボタンがグレー表示になります。ラジオボタンを選択可能な状態にするには、先に［表示］ボタンをクリックする必要があります。

3 ［ツールバーの選択］リストボックスで「ペインタバー 1」を選択し、［右端］をクリックします。ツールバーダイアログボックスで［閉じる］をクリックします。

4 「ペインタバー 2」を右クリックして、ポップアップメニューから［左端］を選択します。

この操作により、 2 つのペインタバーの位置が入れ替わります。

5 ツールバーを目的の場所に配置します。

ツールバーは、ペインタのワークスペースの上下左右にドラッグできます。ツールバーの位置を固定すると、ツールバーボタンの左または上部にドラッグバーができます。ドラッグバーをクリックしてマウスを移動することで、ペインタのワークスペースの周辺にツールバーを移動できます。

ツールバー設定は、すべてのペインに適用されます。また、この設定は保存され、次回 PowerBuilder を開いた時にもこの設定が適用されます。

6 アプリケーションペインタを閉じます。



64 PowerBuilder

レッスン 3 ログインウィンドウの作成

ウィンドウは、ユーザと PowerBuilder アプリケーションを結ぶ主要なインタフェースです。情報の表示、情報の入力要求、マウスやキーボードの操作への応答は、ウィンドウによって実現されます。

ウィンドウは、ウィンドウペインタを使用して作成する独立したオブジェクトです。 PowerBuilder では、アプリケーションを開発している間、いつでもウィンドウを作成できます。


• ウィンドウの新規作成

• コントロールの追加

• ウィンドウのタブ順序の変更

• Help イベントのコーディングとウィンドウのプレビュー

• ログインウィンドウを開くスクリプトの記述



ウィンドウの新規作成


現在の学習個所> ウィンドウの新規作成

コントロールの追加ウィンドウのタブ順序の変更Help イベントのコーディングとウィンドウのプレビューログインウィンドウを開くスクリプトの記述

このステップでは、アプリケーションのウィンドウを新規に作成します。ここで作成するウィンドウは、ユーザ ID およびパスワードの入力と、データベースへの接続が可能なログインウィンドウです。このログインウィンドウはレスポンスウィンドウです。

レスポンスウィンドウについてレスポンスウィンドウとは、ユーザに情報を要求するダイアログボックスです。レスポンスウィンドウはアプリケーションモーダルです。レスポンスウィンドウは、表示されるとアクティブ（フォーカスされている状態）になり、ユーザが応答するまでそのアプリケーション以外のウィンドウにアクセスできなくなります。ただし、ほかの Windowsアプリケーションにはアクセスできます。この場合、元のアプリケーションに戻ってもレスポンスウィンドウはアクティブな状態を保ちます。

1 パワーバーの［新規作成］ボタンをクリックします。

新規作成ダイアログボックスが表示されます。

2 ［PB オブジェクト］タブをクリックします。［ウィンドウ］アイコンを選択して［OK］をクリックします。

ウィンドウペインタが開きます。スタイルバーとペインタバー 3という、 2 つのツールバーがあることに注意してください。

3 ウィンドウペインタにレイアウトビューとプロパティビューが表示されていることを確認します。

これらのビューは、［ビュー］メニューから選択して表示します。これらのビューがメニュー内でグレー表示されている場合は、すでにペインタに表示されています。

デフォルトのビューレイアウトには、両方のビューがあります。

66 PowerBuilder


デフォルトのペインタレイアウトにするにはワークスペースのメニューバーから［ビュー｜レイアウト｜（デフォルト）］を選択します。

レイアウトビュー内の四角形は、作成しているウィンドウを表します。プロパティビューのデフォルトプロパティは、ウィンドウが表示可能かつ使用可能になっており、ウィンドウの種類がウィンドウ型であることを示します。プロパティビューをスクロールしないと、ウィンドウの種類が表示されない場合もあります。

ウィンドウがペグボード状になっていない場合レイアウトビュー内のウィンドウの外観が無地で表示されている場合は、［グリッドの表示］オプションが無効になっています。このオプションを有効にするには、メニューバーから［デザイン｜オプション］を選択します。次に、オプションダイアログボックスの［全般］ページで［グリッドの表示］チェックボックスをオンにします。［更新］をクリックし、［OK］をクリックして変更を保存し、ダイアログボックスを閉じます。

4 プロパティビューの［全般］ページの［タイトル］テキストボックスに「Welcome」と入力します。［ウィンドウの種類］ドロップダウンリストボックスで「response!」を選択します。



5 ［タイトルバー］と［コントロールメニュー］チェックボックスがオンになっていることを確認します。［文脈ヘルプ］チェックボックスをオンにします。

文脈ヘルププロパティによって、ログインウィンドウのタイトルバー内の［閉じる］ボタンの横に［？］ボタンが追加されます。［？］ボタンをクリックすると、ウィンドウコントロールの Helpイベントを発生させることができます。

6 プロパティビューの［その他］タブをクリックします。［幅］テキストボックスに「2300」、［高さ］テキストボックスに「1000」と入力します。〔Tab〕キーを押します。

レイアウトビュー内にある長方形のウィンドウのサイズが変更されます。入力する値は、 PowerBuilder 単位系（PBU）です。この値は、後でコントロールをウィンドウに追加するときに修正できます。

位置プロパティを入力する別の方法値は、手動入力するかわりにスピンコントロールを使用して入力できます。

レイアウトビュー内のログインウィンドウのサイズを変更する方法としてはそれ以外にも、ポインタをウィンドウの下部または右端に移動する方法があります。ポインタが双方向の矢印に変わったら、ドラッグしてウィンドウのサイズを変更できます。

7 メニューバーから［ファイル｜上書き保存］を選択します。

ウィンドウの保存ダイアログボックスが表示されます。［アプリケーションライブラリ］テキストボックスには、唯一のライブラリとして「Pbtutor.pbl」が選択されています。

8 ウィンドウ名に「w_welcome」と入力します。

「w_」は、ウィンドウを表す標準的な接頭辞です。

9 （オプション）［コメント］テキストボックスに以下のコメントを入力します。

これはログインウィンドウです。続行するには ID とパスワードを入力する必要があります。

68 PowerBuilder


このコメントは、ライブラリペインタのリストビューで表示できます。

10 ［OK］をクリックします。

新しいログインウィンドウが保存されます。システムツリー内のMyWorkspace、 pbtutor、および pbtutor.pbl を展開すると、その下部に w_welcome が表示されます。


コントロールの追加


現在の学習個所ウィンドウの新規作成

> コントロールの追加ウィンドウのタブ順序の変更Help イベントのコーディングとウィンドウのプレビューログインウィンドウを開くスクリプトの記述

ユーザはコントロールを介して、ウィンドウやデータウィンドウなどの PowerBuilder オブジェクトと対話できます。まずこれらのコントロールのプロパティを設定し、後でコントロールイベントおよび関数のスクリプトを追加します。

ペインタバーからのコントロールボタンの選択コントロールを追加するには、［挿入］メニューか、またはペインタバー 1 のコントロールボタンを選択します。ツールバーをカスタマイズしない限り、ペインタバーに表示されるコントロールボタンは 1 つだけです。ペインタを初に開いたときに、ペインタバー 1 の中にコマンドボタンコントロールボタンが表示され、その右側に下矢印が表示されます。その下矢印をクリックすると、コントロールボタンのドロップダウンリストが表示されます。

ドロップダウンリストから選択できるコントロールの一部を、以下の表に示します。

ボタンの外観コントロールの種類チュートリアルでの使用法

コマンドボタンペインタバー 1 のコントロールボタンのデフォルトアイコン。コマンドボタンの追加については、このレッスンの後半を参照

ピクチャログインウィンドウにピクチャを追加する

ピクチャハイパーリンク

このチュートリアルでは使用しない。Web サイトへのリンクを指定するときに使用する

ピクチャボタンこのチュートリアルでは使用しない。コマンドボタンに似ているが、テキストだけではなく、ピクチャも表示される

スタティックテキスト

ログインウィンドウにテキストラベルを追加する

70 PowerBuilder


コントロールを選択すると、ペインタバー 1 上にある［コマンドボタン］ボタンのかわりに、選択したコントロールが表示されます。

コントロールを 3D 表示にするコントロールの外観を 3 次元表示にするには、メニューバーから［デザイン｜オプション］を選択し、オプションダイアログボックスで［全般］ページの［3D がデフォルト］チェックボックスがオンになっていることを確認します。ウィンドウの背景色は、ウィンドウペインタのプロパティビューで、デフォルトの「3D オブジェクトグレー」から別の色に変更できます。

ここでは、コントロールを追加し、プロパティの一部を変更して、作成したログインウィドウを修正します。このレッスンの内容は以下のとおりです。

• ピクチャの追加

• スタティックテキストコントロールの追加

• スタティックテキストコントロールのプロパティの指定

• シングルラインエディットコントロールの追加

• シングルラインエディットコントロールのプロパティの指定

• コマンドボタンコントロールの追加

• コマンドボタンコントロールのプロパティの指定

スタティックハイパーリンク

Web サイトへのリンクを提供する

シングルラインエディット

ログインウィンドウにユーザ入力用テキストボックスを追加する

マルチラインエディット

このチュートリアルでは使用しない。マルチライン編集用のテキストボックスを追加する

ボタンの外観コントロールの種類チュートリアルでの使用法



ピクチャの追加

ここでは、ピクチャコントロールをログインウィンドウに追加します。

1 コントロールのドロップダウンリストから［ピクチャ］ボタンを選択します。またはメニューバーから［挿入｜コントロール｜ピクチャ］を選択します。

2 レイアウトビューの長方形ウィンドウの内側をクリックします。

選択した場所に、ピクチャコントロールが表示されます。コントロールを追加すると同時に、プロパティビューが、ウィンドウプロパティの表示からコントロールプロパティの表示に切り替わります。

プロパティビューが表示されない場合は、メニューバーから［ビュー｜プロパティ］を選択します。プロパティビューにコントロールのプロパティが表示されない場合は、レイアウトビューのピクチャコントロールをクリックします。

コントロールを削除するにはコントロールをウィンドウに追加した後で不要になった場合は、コントロールを選択して、〔Delete〕キーを押します。コントロールとそれに記述されているスクリプトが削除されます。

3 プロパティビューで、［全般］タブ上の［名前］テキストボックスから「p_1」を選択します。［名前］テキストボックスに「p_sports」と入力します。

「p_sports」はピクチャ名です。「p_」はピクチャコントロールを表す標準的な接頭辞です。

4 ［ピクチャ名］テキストボックスの隣にある参照（［...］）ボタンをクリックします。

ピクチャの選択ダイアログボックスが表示されます。

5 現行のディレクトリが Tutorial でない場合は、Tutorial ディレクトリに移動します。tutsport.bmp ファイルを選択して［開く］をクリックします。

72 PowerBuilder


選択したビットマップが、レイアウトビューに追加したコントロールの内部に表示されます。プロパティビューでは、デフォルトで［表示可能］、［使用可能］、および［元のサイズ］チェックボックスがオンになります。

6 レイアウトビューでピクチャコントロールが選択されていることを確認します。プロパティビューの［その他］タブをクリックします。［X］テキストボックスに「40」、［Y］テキストボックスに「50」と入力します。

［X］および［Y］テキストボックスのスピンコントロールを使用して、これらの数値を入力することもできます。このレッスンの後にウィンドウをプレビューした後で、必要ならピクチャコン

トロールの位置を調整します。

7 ［幅］テキストボックスに「300」、［高さ］テキストボックスに「250」と入力します。

ピクチャコントロールのサイズを変更します。このピクチャのサイズも、ウィンドウをプレビューした後で、必要に応じて調整できます。



スタティックテキストコントロールの追加

このステップでは、スタティックテキストコントロールをログインウィンドウに追加します。

1 コントロールのドロップダウンリストから［テキスト］ボタンを選択します。またはメニューバーから［挿入｜コントロール｜スタティックテキスト］を選択します。

2 レイアウトビューに追加したピクチャコントロールの右側のワークスペースをクリックします。

スタティックテキストコントロールが、選択した場所に表示されます。

3 スタティックテキストコントロールを右クリックして、ポップアップメニューから［複製］を選択します。

選択しているコントロールが複製されます。

4 もう一度スタティックテキストコントロールのポップアップメニューから［複製］を選択します。

3 つ目のスタティックテキストコントロールが複製されます。

ウィンドウ上部にスタティックテキストコントロールが縦に 3 つ並んで配置されます。

5 3 つのコントロールの間隔を十分に取って配置し直します。

スタティックテキストコントロールのプロパティの指定

このステップでは、スタティックテキストコントロール（ラベルテキストボックス）のプロパティを指定して、それらのコントロールのログインウィンドウ上での表示方法を定義します。

1 追加した一番上のスタティックテキストコントロールを選択します。

プロパティビューに、スタティックテキストコントロールのプロパティが表示されます。プロパティビューが表示されない場合は、メニューバーから［ビュー｜プロパティ］を選択します。

74 PowerBuilder


2 プロパティビューで、［全般］ページ上の［名前］テキストボックスから「st_1」を選択します。［名前］テキストボックスに「st_welcome」と入力します。

これで、コントロールの名前に意味を持たせることができました。「st_」はスタティックテキストコントロールの標準的な接頭辞です。

3 ［テキスト］テキストボックスの「未設定」を選択します。「PowerCAP 営業支援システム」と入力します。

〔Enter〕を押したり、プロパティビューのほかのページを選択するか、または別のビューをクリックすると、入力したテキストがレイアウトビューで「未設定」が入力したテキストに置き換わります。

4 プロパティビューの［フォント］タブをクリックします。このコントロールの［サイズ］プロパティを 18 ポイントに変更します。

コントロール内のテキストのサイズが変更されます。

デフォルトの書体は「MS ゴシック」です。ただし、システムにこのフォントとサイズが用意されていないときは、ほかのものを選択してかまいません。

スタイルバーの使い方スタイルバーを使用してフォントを変更することもできます。スタイルバーが表示されていない場合は、メニューバーから［ツール｜ツールバー］を選択して、［ツールバーの選択］リストボックスの「スタイルバー」をクリックし、［表示］ボタンをクリックしてください。

5 スタティックテキストコントロールのサイズを、入力したテキストに合わせて調整します。入力したテキストの全体が表示されるように調整してください。

サイズを調整するには、レイアウトビューでコントロールの右上隅のハンドルをウィンドウの右上隅の方へドラッグします。

サイズを変更する方法としてはそれ以外にも、このコントロールのプロパティビューの［その他］ページで適切な値を入力する方法があります。

6 レイアウトビューで追加した 2 番目のスタティックテキストコントロールを選択します。



プロパティビューで、［全般］ページの［名前］テキストボックスに「st_userid」と入力します。［テキスト］テキストボックスに「ユーザ ID:」と入力し、〔Tab〕を押します。

コントロール内に表示されているテキストが変更されます。

7 レイアウトビューで追加した 3 番目のスタティックテキストコントロールを選択します。プロパティビューで、［全般］ページの［名前］テキストボックスに「st_password」と入力します。［テキスト］テキストボックスに「パスワード :」と入力し、〔Tab〕を押します。

変更内容がレイアウトビューに表示されます。

シングルラインエディットコントロールの追加

このステップでは、 2 つのシングルラインエディットコントロールをウィンドウに追加して、データベースへの接続に必要なユーザ ID とパスワードを入力できるようにします。シングルラインエディットコントロールとは、 1 行分のテキストを入力できるテキストボックスのことです。通常、シングルラインエディットコントロールはデータの入出力に使用されます。

1 コントロールのドロップダウンリストから［シングルラインエディット］ボタンを選択します。またはメニューバーから［挿入｜コントロール｜シングルラインエディット］を選択します。

76 PowerBuilder


2 レイアウトビューに追加した st-userid スタティックテキストコントロールの右側のワークスペースをクリックします。

選択した場所にシングルラインエディットコントロールが表示されます。

3 シングルラインエディットコントロールの幅を広げてサイズを調整します。

4 シングルラインエディットコントロールを右クリックして、ポップアップメニューから［複製］を選択します。複製したシングルラインエディットコントロールを、スタティックテキストコントロール st_password の右隣に移動します。

スタティックテキストコントロールの右側に、シングルラインエディットコントロールが縦に 2 つ並んで配置されます。

シングルラインエディットコントロールのプロパティの指定

このステップでは、前のステップでログインウィンドウに追加したシングルラインエディットコントロールの各プロパティを定義します。

1 1 番目のシングルラインエディットコントロールを選択します。

プロパティビューの［全般］ページにシングルラインエディットコントロールのプロパティが表示されます。プロパティビューが表示されない場合は、メニューバーから［ビュー｜プロパティ］を選択します。

2 ［名前］テキストボックスから「sle_1」を選択します。［名前］テキストボックスに「sle_userid」と入力します。



［テキスト］テキストボックスのデフォルトテキスト「未設定」をクリアします。

「sle_」はシングルラインエディットコントロールの標準的な接頭辞です。

3 2 番目のシングルラインエディットコントロールを選択します。［名前］テキストボックスに「sle_password」と入力します。［テキスト］テキストボックスのデフォルトテキスト「未設定」をクリアします。［パスワード］チェックボックスをオンにします。

［パスワード］チェックボックスをチェックしていると、実行時にユーザが入力するパスワードがアスタリスクで表示されます。

コマンドボタンコントロールの追加

このステップでは、コマンドボタンコントロールを追加します。これらのボタンをクリックしたときに実行するスクリプトは、後で定義します。

1 コントロールのドロップダウンリストから［コマンドボタン］ボタンを選択します。またはメニューバーから［挿入｜コントロール｜コマンドボタン］を選択します。

2 シングルラインエディットコントロール sle_userid の右側のワークスペースをクリックします。

選択した場所にコマンドボタンコントロールが表示されます。

3 コマンドボタンコントロールを右クリックして、ポップアップメニューから［複製］を選択します。

選択しているコントロールが複製されます。

4 必要に応じてコマンドボタンコントロールの位置を変更し、2 つのコマンドボタンコントロールの間に適当な間隔を置くようにします。

78 PowerBuilder


コマンドボタンコントロールのプロパティの指定

このステップでは、コマンドボタンコントロールのプロパティを定義します。

1 1 番目のコマンドボタンコントロールを選択します。

プロパティビューの［全般］ページに、コマンドボタンコントロールのプロパティが表示されます。

2 プロパティ　ビューで、［全般］ページの［名前］テキストボックスに「cb_ok」と入力します。［テキスト］テキストボックスに「OK」と入力します。［デフォルト］チェックボックスをオンにします。

ここではコントロールの内容を説明するために、デフォルト名「未設定」を変更して、ボタンにラベルを付けています。［デフォルト］チェックボックスをオンにしたので、〔Enter〕を押したときに、このボタンの Clicked イベントが発生します。

3 2 番目のコマンドボタンコントロールを選択します。［名前］テキストボックスに「cb_cancel」と入力します。［テキスト］テキストボックスに「キャンセル」と入力します。［キャンセル］チェックボックスをオンにします。

［キャンセル］チェックボックスをオンにしたので、〔Esc〕を押したときに、このボタンの Clicked イベントが発生します。


ウィンドウのタブ順序の変更

ウィンドウのタブ順序の変更

現在の学習個所ウィンドウの新規作成コントロールの追加

> ウィンドウのタブ順序の変更Help イベントのコーディングとウィンドウのプレビューログインウィンドウを開くスクリプトの記述

ウィンドウ上にコントロールを配置すると、デフォルトのタブ順序が割り当てられます。タブ順序は、〔Tab〕を押した際に、複数のコントロールをフォーカスが移動する順序を決めるものです。

このステップでは、作成したウィンドウのタブ順序を変更します。

1 メニューバーから［書式｜タブ順序を表示］を選択します。

デフォルトのタブ順序が表示されます。タブ順序はコントロールの相対位置に基づいて設定され、コントロールの右上に赤い数字で表示されます。タブ順序が 0 のコントロールは、タブを押したときにフォーカスされないコントロールです。

2 sle_userid コントロールの［タブ順序番号］をクリックします。このコントロールのタブ順序の値として「10」と入力します。

新しいタブ順序の番号を入力できるのは、古い番号が赤い背景の青字に変わった場合のみです。

3 ほかのコントロールの値が以下のとおりであることを確認します。

設定対象のコントロールコントロール名適用される値

パスワードを入力するためのシングルラインエディットコントロール

sle_password 20

［OK］ボタンのコマンドボタンコントロール

cb_ok 30

［キャンセル］ボタンのコマンドボタンコントロール

cb_cancel 40

80 PowerBuilder


4 メニューバーから［書式｜タブ順序を表示］を選択します。

これはトグルスイッチになっています。このメニュー項目を選択すると、変更内容が保存され、タブ順序の番号がログインウィンドウから消去されます。ペインタバー上の［タブ順序］ボタンを使用しても同じ処理ができます。


Help イベントのコーディングとウィンドウのプレビュー


現在の学習個所ウィンドウの新規作成コントロールの追加ウィンドウのタブ順序の変更

> Help イベントのコーディングとウィンドウのプレビューログインウィンドウを開くスクリプトの記述

このステップでは、スクリプトビューを使用して、ログインウィンドウに配置されているシングルラインエディットコントロールに状況依存ヘルプメッセージを追加し、そのウィンドウをプレビュー表示します。スクリプトビューがウィンドウペインタに表示されていないときは、レイアウトビューでオブジェクトをダブルクリックして開きます。

スクリプトビューの使い方スクリプトビューには、 3 つのドロップダウンリストボックスがあります。初のドロップダウンリストボックスには、現在のオブジェクトで利

用可能なコントロールのリストおよび特殊エントリである「Functions」と「Declare」が表示されています。2 番目のドロップダウンリストボックスの内容は、初のドロップダウンリストボックスで何を選択したかによって変わります。3 番目のドロップダウンリストボックスには、現在のオブジェクトの先祖オブジェクトが存在する場合は、そのオブジェクトすべてが含まれています。

1 レイアウトビューで、一番上のシングルラインエディットコントロールをダブルクリックします。

初のドロップダウンリストボックスでの選択

2 番目のドロップダウンリストボックスの内容

3 番目のドロップダウンリストボックスの内容

オブジェクトまたはコントロール名

選択したオブジェクトまたはコントロールのイベントのリスト

現在のオブジェクトとそのすべての先祖オブジェクト

Functions 編集可能な関数のリスト。編集可能な関数が存在しない場合は、「新しい関数」が表示される

選択した関数と同じ署名の関数を持つ、すべての先祖オブジェクト

Declare グローバル、共有、およびインスタンス変数の宣言型のリストとローカル外部関数

なし

82 PowerBuilder


スクリプトビューの 1 番目のドロップダウンリストボックスにオブジェクト名 sle_userid が表示されます。

2 スクリプトビューの 2 番目のドロップダウンリストボックスで Help イベントを選択します。

Help イベントのプロトタイプは次のとおりです。 help (integerxpos, integer ypos) returns long [pbm_help]

3 スクリプト領域内に、次の行を入力します。

ShowPopupHelp("pbtutor.hlp", this, 100)

pbtutor.hlp ファイルは、Tutorial ディレクトリ内にあります。2 番目の引数は現在のシングルラインエディットコントロールを、後の引数は pbtutor.hlp ファイルのコンテキスト ID を表します。

スクリプトビューにテキストを入力すると、入力した構文要素の種類（キーワード、変数、コメントなど）によってテキストの色が変わります。

4 スクリプトビューの初のドロップダウンリストボックスから「sle_password」を選択します。2 番目のドロップダウンリストボックスで Help イベントを選択します。

sle_userid のシングルラインエディットテキストボックスの Helpイベント用に入力したスクリプトが、コンパイルされます。ここで、［sle_password］シングルラインエディットテキストボックスの Help イベントを追加します。

5 スクリプト領域内に、次の行を入力します。

ShowPopupHelp("pbtutor.hlp", this, 200)

6 メニューバーから［ファイル｜実行 / プレビュー］を選択します。またはパワーバーの［オブジェクトの実行 / プレビュー］をクリックします。

実行ダイアログボックスが表示されます。［オブジェクトの種類］リストボックスに「ウィンドウ」が表示されていることと、w_welcome オブジェクトが選択されていることを確認します。



ウィンドウのプレビュースクリプトを実行せずにウィンドウをプレビューするには、メニューバーの［デザイン｜プレビュー］を選択するか、ペインタバー 1 （パワーバーの［オブジェクトの実行 / プレビュー］と同じアイコン）の［プレビュー］ボタンをクリックします。ただし、直前に入力した Help イベントスクリプトの結果を表示したい場合は、いずれの操作も使用しないでください。


変更内容を保存するかどうかを問い合わせるメッセージボックスが表示されます。

8 ［はい］をクリックします。

ログインウィンドウの実行時の外観がプレビュー表示されます。ウィンドウレイアウトを変更したい場合は、ウィンドウペインタのワークスペースに戻って、ウィンドウコントロールのサイズ、配置、フォントを変更できます。

9 ログインウィンドウのタイトルバーで［？］ボタンをクリックします。シングルラインエディットテキストボックス sle_userid の内側をクリックします。

「ここにユーザー ID を入力します。」というメッセージが表示されます。このメッセージは、 pbtutor.hlp ファイルのコンテキスト ID 100に対応しています。このコンテキスト ID は、 Help イベントsle_userid の ShowPopupHelp 関数の引数として指定したものです。

10 ウィンドウ内の任意の場所をクリックすると、メッセージが閉じます。シングルラインエディットテキストボックス sle_password の内側をクリックして、〔F1〕を押します。

84 PowerBuilder


「ここにパスワードを入力します。」というメッセージが表示されます。このメッセージは、 pbtutor.hlp ファイルのコンテキスト ID 200 に対応しています。

11 ウィンドウ内の任意の場所をクリックすると、メッセージが閉じます。ログインウィンドウのタイトルバーで［閉じる］ボタンをクリックします。

ウィンドウペインタのワークスペースに戻ります。

後で、アプリケーションを閉じる［キャンセル］ボタンの Clickedイベントに、スクリプトを追加します。

12 ウィンドウペインタを閉じます。


ログインウィンドウを開くスクリプトの記述


現在の学習個所ウィンドウの新規作成コントロールの追加ウィンドウのタブ順序の変更Help イベントのコーディングとウィンドウのプレビュー

> ログインウィンドウを開くスクリプトの記述

このステップでは、アプリケーション起動開始の直後にログインウィンドウを開くための、スクリプトを追加します。このスクリプトは、MDI フレームウィンドウの Open イベントに追加します。このウィンドウ（w_pbtutor_frame）は、テンプレートアプリケーションウィザードで作成されたものです。

MDI フレームは、アプリケーションの Open イベントによって呼び出されます。しかし、ログインウィンドウはレスポンスウィンドウであるため、フレームウィンドウからログインウィンドウを呼び出すと、フレームウィンドウより先に表示されたままになります。

この練習では、以下の操作を行います。

• フレームウィンドウの Open イベントの修正

• スクリプトのコンパイル

86 PowerBuilder


フレームウィンドウの Open イベントの修正

フレームウィンドウは、アプリケーションオブジェクトの Open イベントによって呼び出されます。ここで、フレームウィンドウ Open イベントのスクリプトを、ログインウィンドウを開くように修正します。ログインウィンドウはレスポンスウィンドウであるため、フレームウィンドウよりも先に表示されたままになります。このため、フレームウィンドウの Open イベントのスクリプトは、（ユーザが応答するまで一時的に）処理がブロックされます。

ウィザードで生成されたスクリプトフレームウィンドウの Open イベントには、テンプレートアプリケーションウィザードによって生成されたスクリプトがすでに関連付けられています。このスクリプトは、シート（ウィンドウ）マネージャとして機能するウィザードが生成したユーザオブジェクトのインスタンスを作成します。その後で、 Open スクリプトが ue_postopen イベントを呼び出します。

ue_postopen イベントは、シートウィンドウをシートマネージャに登録します。ue_postopen イベントはウィンドウのメッセージキューの後にポストされ、（このレッスンで追加された） Open スクリプトの残りが実行された後で処理されます。

1 メニューバーから［ファイル｜開く］を選択します。開くダイアログボックスで、以下の項目を選択するか、または選択されている項目を確認します。

w_pbtutor_frame オブジェクトは、テンプレートアプリケーションウィザードで作成されたアプリケーションのメインウィンドウです。


開くダイアログボックスの項目選択（確認）項目

ターゲット pbtutor — 現在の唯一のターゲット

ライブラリ pbtutor.pbl — 現在の唯一のライブラリ

オブジェクトの種類ウィンドウ

オブジェクト名 w_pbtutor_frame

使用ペインタ



ウィンドウペインタが開き、ペインタのワークスペースにアプリケーションのメインウィンドウのビューが表示されます。

スクリプトビューが開いていない場合、ワークスペースのメニューバーで［ビュー｜スクリプト］を選択するか、またはレイアウトビューの内側をダブルクリックして開きます。

3 スクリプトビューで Open イベントが表示されていることを確認します。スクリプトビューのタイトルバーをペインタの背景に固定させて表示します。

スクリプトビューのタイトルバーに、次の文字列が表示されます。

スクリプト w_pbtutor_frame の open の戻り値のデータ型は Long です。

スクリプトビューのスクリプトコードの前にコメントが記述されています。

コメントの使い方PowerScript では、 2 つの方法でコメントをあらわします。 1 行のコメントには、その行の先頭にスラッシュを 2 個（//）を付けます。1 行または複数行のコメントには、先頭にスラッシュとアスタリスク（/*）を、末尾にアスタリスクとスラッシュ（*/）を付けます。コメントは、コンパイラの解析の対象にはなりません。

ここで、ログインウィンドウを表示するための Open イベントのスクリプトを修正します。

4 次に示す行の中にあるカッコの後ろにカーソルを合わせてクリックします。

this.Post Event ue_postopen ( )

ue_postopen イベントは引数をとりません。

88 PowerBuilder


5 〔Enter〕を 2 回押します。

スクリプトビューの中に空白行を挿入して、読みやすくします。カーソルが空白行の次の行に移動します。

6 スクリプトビューで、新しい行に「ログインウィンドウを開く」と入力します。ペインタバー 2 の［コメント］ボタンをクリックします。

入力した行の前に 2 個のスラッシュが表示され、その行のスラッシュ以降の領域がコメントに変わります。

7 〔Enter〕を押して改行します。スクリプトビューで、次の行に「open (w_welcome)」と入力します。

この文は、Open 関数を呼び出し、作成したログインウィンドウを表示します。

状況依存ヘルプへのアクセス状況依存ヘルプにアクセスするには、スクリプトビューで関数や予約語（たとえば Open）を選択して〔Shift〕 + 〔F1〕を押します。〔F1〕を押すと、状況に関係なく常にメインヘルプ画面が開きます。



スクリプトのコンパイル

ここでは、入力したスクリプトをコンパイルします。 PowerBuilder では、スクリプトビューを閉じたときや、スクリプトビューで別のオブジェクト、イベント、または関数を選択したときに、自動的にスクリプトがコンパイルされます。

このステップでは、スクリプトビューを閉じたり別のスクリプトに変更したりせず、ポップアップメニューの項目を使用してスクリプトをコンパイルします。

スクリプトのエラー処理スクリプトにエラーがある場合は、スクリプトビューの下部にエラーウィンドウが開き、エラー番号とエラーメッセージが表示されます。

エラーを見つけるにはエラーメッセージをクリックすると、エラーのある行にカーソルが移動します。エラーを修正したら、スクリプトのコンパイルを再試行します。

エラーのコメント化 PowerBuilder では、エラーのあるスクリプトは保存されません。エラーのあるスクリプトを保存するには、そのスクリプト全体を選択して、［コメント］ボタンをクリックします。こうして保存しておいたスクリプトは、後で開いて、コメントを外してから、エラー箇所を修正します。

1 スクリプトビューのスクリプト領域内の任意の場所を右クリックします。ポップアップメニューで［コンパイル］を選択します。

スクリプトがコンパイルされます。このときに、スクリプトビューまたはウィンドウペインタのワークスペースを閉じたり、ほかのビューに移動したりしないでください。

2 メニューバーから［ファイル｜上書き保存］を選択します。メニューバーから［ファイル｜閉じる］を選択します。


90 PowerBuilder

レッスン 4 データベースへの接続

このレッスンでは、実行時にアプリケーションをエンタープライズアプリケーションサンプル（EAS Demo DB）データベースに接続するためのスクリプトを記述します。また、データベースペインタを使用してテーブル定義を参照したり、EAS Demo DB データベースのデータベースプロファイルを参照します。


• EAS Demo DB データベースの参照

• 接続オブジェクトウィザードの実行

• グローバル変数の宣言

• 接続情報の変更

• ログインおよびログアウトスクリプトの完了




EAS Demo DB データベースの参照


現在の学習個所> EAS Demo DB データベースの参照

接続オブジェクトウィザードの実行グローバル変数の宣言接続情報の変更ログインおよびログアウトスクリプトの完了アプリケーションの実行

多くの企業には、データベース専門の管理者がいます。組織内にデータベース管理者がいれば、データベース内にテーブルを作成して管理する必要はないかもしれません。しかし、ここでは PowerBuilder の機能をフルに活用するために、データベースでの作業方法を説明します。

データソースの定義 ODBC Administrator などのデータベース接続ユーティリティを使用して、データベースをデータソースとして定義できます。 ODBC Administrator には DB プロファイルダイアログボックスからアクセスできます。ODBC データソースの定義は、odbc.ini レジストリキーに記述されています。

データベースプロファイルを使用した接続いったんデータソースを定義したら、そのデータソース用のデータベースプロファイルを作成できます。データベースプロファイルとは、ある特定のデータソースまたはデータベースとの接続を行う際に指定するパラメータセットのことです。データベースプロファイルを使用すれば、使用頻度の高いデータベース接続の管理を容易に行うことができます。アプリケーションの開発中にデータベースプロファイルを変更してほかのデータソースに接続できます。

データベース接続を行う時期デザイン時または実行時の環境のいずれかでデータベースへの接続を確立できます。 PowerBuilder は、ペインタを開くときや、埋め込み SQL 文を含むスクリプトをコンパイルまたは保存するとき、あるいはデータベースにアクセスするアプリケーションを実行するときにデータベースへの接続を行います。

PowerBuilder でデータベース定義を管理するには、ほとんどの場合データベースペインタを使用します。データベースペインタでは以下の操作が行えます。

• テーブルの作成、変更、削除

• 主キーと外部キーの作成、変更、削除

• インデックスキーの作成、削除

92 PowerBuilder


• カラムの拡張属性の定義、修正

• ビューの削除


• EAS Demo DB データベースプロファイルの参照

• EAS Demo DB データベースのテーブル定義の参照

EAS Demo DB データベースプロファイルの参照

標準オプションで PowerBuilder をインストールした場合は、すでにEAS Demo DB データベース用に定義されたデータソースとデータベースプロファイルがあります。このチュートリアルでは、EAS DemoDB データベースを使用します。

EAS Demo DB データベースは、ODBC を介してアクセスする AdaptiveServer Anywhere です。このレッスンでは、 EAS Demo DB データベースのデータベースプロファイルを調べます。データベースプロファイルのパラメータは、レジストリ内に保持されます。

1 パワーバーの［DB プロファイル］ボタンをクリックします。またはメニューバーの［ツール｜ DB プロファイル］を選択します。

DB プロファイルダイアログボックスが表示されます。 DB プロファイルダイアログボックスには、インストールしたデータベースインタフェースと各インタフェースで定義したデータベースプロファイルがツリー形式で表示されています。

2 EAS Demo DB V9 を選択します。

このプロファイルは、インストール時に作成されます。



EAS Demo DBV9 データベースプロファイルが表示されない場合EAS Demo DBV9 データベースのプロファイルがない場合は、データベースをインストールしていない可能性があります。インストールは、製品 CD-ROM から行うことができます。

EAS Demo DB V9 データベースをインストールし、 ODBCAdministrator でデータソースとして定義している場合は、データベースプロファイルペインタのツリービューから「ODB ODBC」を選択して、［新規作成］をクリックします。 DB プロファイル設定ダイアログボックスで、［データソース］ドロップダウンリストボックスからデータソースを選択し、［プロファイル名］テキストボックスに「EAS Demo DB V9」と入力します。ユーザ ID に「dba」、パスワードに「sql」と入力し、［OK］をクリックしてペインタに戻ります。

94 PowerBuilder


3 ［編集］をクリックします。

DB プロファイル設定ダイアログボックスの［接続］ページが表示されます。

4 ［プレビュー］タブをクリックします。

選択した各オプションの接続構文が［プレビュー］タブに表示されます。オプションを変更すると、構文も変わります。

5 ［接続のテスト］ボタンをクリックします。

接続に成功したことを通知するメッセージボックスが表示されます。



接続に失敗したというメッセージボックスが表示された場合メッセージボックスを閉じて、 DB プロファイル設定ダイアログボックスの［接続］ページの内容が正しいことを確認してから、ODBC Administrator のデータソースの設定内容をチェックしてください。

6 ［OK］をクリックして、メッセージボックスを閉じます。［キャンセル］をクリックして、 DB プロファイル設定ダイアログボックスを閉じます。［閉じる］をクリックして、 DB プロファイルダイアログボックスを閉じます。

EAS Demo DB データベースのテーブル定義の参照

このステップでは、EAS Demo DB データベースの顧客情報（customer）テーブルと商品管理（product）テーブルの定義を参照します。これにより、データベースペインタとチュートリアルで使用するテーブルについてよく理解できます。

接続時の処理内容テーブル定義を参照するには、データベースに接続する必要があります。開発環境でデータベース環境に接続すると、接続パラメータが Windows レジストリに書き込まれます。

異なるデータベースに接続するたびに、レジストリ内の既存の接続パラメータが新しいデータベースの接続パラメータに置き換えられます。データベースにアクセスする PowerBuilder ペインタを開くと、後に使用したデータベースに自動的に接続されます。 PowerBuilder は、レジストリの読み出しにより、後に使用したデータベースを特定します。

1 パワーバーの［データベース］ボタンをクリックします

PowerBuilder がデータベースに接続し、データベースペインタが開きます。データベースペインタのタイトルバーにアクティブなデータベース接続が表示されます。

96 PowerBuilder


データベースペインタのオブジェクトビューで、「使用できる DBインタフェース」というヘッダの下に、既存の全データベースプロファイルがツリー形式で表示されています。ツリービューで項目の横にある + 記号をクリックするか、アイコンをダブルクリックして、ツリービューのノードを開いたり閉じたりできます。EASDemo DB V9 データベースは、ツリービューの ODB ODBC ノードの下に表示されます。

オブジェクトビューが開いていない場合オブジェクトビューは、デフォルトのビューレイアウトの一部です。このビューレイアウト構成をリセットするには、［ビュー｜レイアウト｜（デフォルト）］を選択します。また、メニューバーから［ビュー｜オブジェクト］を選択して、オブジェクトビューを開くこともできます。

2 オブジェクトビューで、EAS Demo DBV9 データベースノードを展開します。

EAS Demo DBV9 データベースノードの下にあるフォルダを確認します。

3 テーブルフォルダを開きます。

データベースにあるテーブルがリスト表示されます。



テーブル名には接頭辞を付けることができます。テーブルの選択ダイアログボックスのテーブル名に付けられる接頭辞としては、 dba や dbo などがあります。テーブル名に付けられる接頭辞は、使用しているログイン ID によって異なります。接頭辞は無視してもかまいません。

4 「customer」テーブルを右クリックして、ポップアップメニューの［レイアウトに追加］を選択します。またはオブジェクトビューから「customer」テーブルをドラッグして、オブジェクトレイアウトビューにドロップします。

現在のビューからほかのビューにオブジェクトをドラッグする方法オブジェクトビューからほかのビューへのドラッグを始めると、ポインタの形状が斜線入りの円に変わります。オブジェクトをドロップできるほかのビューまでそのままカーソルを移動すると、斜線入りの円がポインタの形に戻り、小さなボックスの中に新しい矢印が表示されます。この矢印が表示されたら、オブジェクトをドロップすることができます。

5 手順 4 を繰り返して、 product テーブルについても同じ作業を行います。

オブジェクトレイアウトビューの拡大オブジェクトレイアウトビューは、分割バーをペインタフレームの方へドラッグして幅を広げることができます。オブジェクトレイアウトビューがスタックの一部の場合、サイズを変更する前にスタックから切り離したほうが簡単な場合もあります。

オブジェクトレイアウトビューに、 2 つのテーブルが表示されます。

98 PowerBuilder


テーブルのデータ型、コメント、キー、およびインデックスの表示オブジェクトレイアウトビューには、各カラムについての説明と、キーおよびインデックスのアイコンが表示されます。このアイコンが表示されない場合は、ビュー内の空白の領域を右クリックし、ポップアップメニューから［コメントの表示］と［参照整合性の表示］を選択してから、［インデックスの表示］を選択します。［データタイプの表示］を選択しないと、選択されているテーブル内にある各カラムのデータ型は表示されません。

6 オブジェクトレイアウトビューで customer テーブルのタイトルバーを右クリックして、ポップアップメニューの［テーブルの変更］を選択します。またはオブジェクトビューで customer テーブルを右クリックして、ポップアップメニューの［テーブルの変更］を選択します。

カラムビューに、テーブルのカラム定義が表示されます。

7 オブジェクトレイアウトビューで、 customer テーブルのカラムを右クリックします。ポップアップメニューから［プロパティ］を選択します。

データベースペインタのプロパティビューは、オブジェクトの詳細ビューとも呼ばれます。

オブジェクトの詳細ビューのタイトルバーとタブヘッダは、どのオブジェクトを選択しているかによってまったく異なります。タイトルバーには、オブジェクトの種類、データベース接続、およびオブジェクトの識別子が表示されます。



カラムのオブジェクトの詳細ビューには 5 つのタブがあります。通常のデータベースのプロパティ全般に関するものが 1 つ、カラムのヘッダ情報に関するもの、そのほかのタブはカラムの拡張属性に関するものです。

拡張属性についてPowerBuilder では、データベースのシステムテーブルの集まり（リポジトリ）に拡張属性情報を格納します。拡張属性とは、カラムのヘッダとラベル、カラムの初期値、入力条件則、表示書式のことをいいます。

データベースペインタの拡張属性ビューで、項目のポップアップメニューから、新しい拡張属性を定義したり、既存の拡張属性の定義を変更できます。

8 データベースペインタを閉じます。

100 PowerBuilder


接続オブジェクトウィザードの実行

現在の学習個所EAS Demo DB データベースの参照

> 接続オブジェクトウィザードの実行グローバル変数の宣言接続情報の変更ログインおよびログアウトスクリプトの完了アプリケーションの実行

このステップでは、接続オブジェクトウィザードを実行して、実行時のデータベース接続の確立に使用する接続サービスマネージャを作成します。

接続サービスマネージャは、非ビジュアルユーザオブジェクトです。「非ビジュアル」とは実行時にグラフィックで表示されないことを示し、「ユーザオブジェクト」とはユーザによってカスタマイズされていることを示します。接続サービスマネージャは、 PowerBuilder アプリケーションでのデータベース接続処理を実行するために使用します。

2 番目のウィザードを実行する理由テンプレートアプリケーションウィザードで接続情報を指定していた場合は、アプリケーションの生成時に接続サービスマネージャを作成します。アプリケーションの構築には複数のウィザードを使用できます。

1 パワーバーの［To-Do リスト］ボタンをクリックします。

すると、 To-Do リストがテンプレートアプリケーションウィザードによって生成されます。


接続オブジェクトウィザードの実行

2 リスト内の接続オブジェクトウィザードを実行し、追加の接続オブジェクトを作成する項目をダブルクリックします。または接続オブジェクトウィザードを実行し、追加の接続オブジェクトを作成する項目を右クリックします。ポップアップメニューの［リンク先へ］を選択します。

これは、リスト内の後から 2 番目の項目です。 To-Do リストに、アプリケーションを完成させるための必要事項が一覧表示されます。このリストを使用して、自分自身やほかのアプリケーション開発者へのコメントを付けることもできます。

新規作成ダイアログボックスの［PB オブジェクト］ページから接続オブジェクトウィザードを実行することもできます。新規作成ダイアログボックスからテンプレートアプリケーションウィザードを実行する方法については、レッスン 1 「PowerBuilder の起動」で説明されています。

ウィザードの初のページには、実行可能な作業に関する説明があります。

3 データベースプロファイルの選択ページが表示されるまで［次へ］をクリックします。

格納先ライブラリ（pbtutor.pbl）とデータベースコネクティビティオプション（SQL）は、ウィザードによりデフォルトで選択された値をそのまま使用してください。データベースプロファイルの選択ページに、レジストリ内に保存されているすべてのデータベースプロファイルが一覧表示されます。

4 「EAS Demo DB V9」がまだ選択されていない場合は、［データベースプロファイル］リストボックスから選択します。

PowerBuilder をインストールした時点では、このデータベースプロファイルしか一覧表示されません。

5 接続オブジェクトの作成準備完了ページが表示されるまで、［次へ］をクリックします。

以下の項目についてデフォルトの設定を確認します。

102 PowerBuilder


ウィザードは、データベース接続の管理用にユーザオブジェクトn_pbtutor_connectservice を作成します。このオブジェクトのインスタンス変数を変更すると、接続情報のソースをレジストリまたはスクリプトファイルに変更できます。それ以外の場合は、ウィザードで作成した pbtutor.ini ファイルがアプリケーションの接続情報として使用されます。

後のウィザードページに、ウィザードで選択した内容（デフォルトのものも含む）のまとめが表示されます。

6 ［完了］ボタンをクリックします。

接続サービスオブジェクトが、ウィザードによって作成され、開きます。それ以外に、アプリケーションの INI ファイルも作成されます。 To-Do リストは開いたままです。

7 To-Do リストを閉じます。

ウィザードページオプションデフォルト設定

接続ソース情報の指定

接続情報の取得元アプリケーション INI ファイル

接続サービスオブジェクト

n_pbtutor_connectservice

アプリケーションの INI ファイルの指定

アプリケーション INI ファイル

pbtutor.ini


グローバル変数の宣言


現在の学習個所EAS Demo DB データベースの参照接続オブジェクトウィザードの実行

> グローバル変数の宣言接続情報の変更ログインおよびログアウトスクリプトの完了アプリケーションの実行

次のステップでは、新しい接続サービスマネージャを検証して、参照するグローバル変数を作成します。グローバル変数は、アプリケーションのすべてのオブジェクトに対して有効です。

複雑なアプリケーションでは、ローカル変数で接続サービスマネージャを参照したほうがよい場合もあります。そうすれば、ローカル変数がスコープから出たときに、より多くのメモリが解放されます。しかしこのチュートリアルでは、データベース接続が開いている限り、接続サービスマネージャのインスタンスを利用できるようにします。

接続の確立アプリケーションが実行時にデータベースに接続できるようにするために、接続サービスマネージャは、ウィザードで生成した関数を呼び出して、アプリケーションとデータベースの間の通信領域として機能するトランザクションオブジェクトのプロパティを設定します。

SQLCA トランザクションオブジェクト接続サービスマネージャは、組み込みの-非ビジュアルシステムオブジェクト、 SQL 通信領域（SQLCA）オブジェクトを、デフォルトのトランザクションオブジェクトとして使用します。SQLCA オブジェクトには、いくつかのプロパティ（データベース名、ログイン ID、およびパスワードを含む）が接続サービスマネージャによってデフォルトで設定されています。

アプリケーションが複数のデータベースと通信する場合は、必要であれば、データベース接続ごとに 1 つのトランザクションオブジェクトを作成できます。

104 PowerBuilder


必要なものと省略可能なものデータベースへの接続にはトランザクションオブジェクトが必要です。接続サービスマネージャは接続自体に必要なものではありませんが、トランザクションオブジェクトのプロパティを自動的に生成するため、このチュートリアルでは使用します。接続サービスマネージャがない場合、アプリケーションのスクリプトでプロパティを直接入力しなければなりません。

1 ユーザオブジェクトペインタの「n_pbtutor_connectservice」が開いていることを確認します。

接続サービスマネージャを開くユーザオブジェクトペインタの n_pbtutor_connectservice オブジェクトが開いていない場合は、システムツリーの「n_pbtutor_connectservice」をダブルクリックしてください。

このペインタの場合、デフォルトのビューレイアウト構成に、タブ付きペインのスタックの一部としてのスクリプトビューとインスタンス変数の宣言ビューが含まれています。

2 スクリプトビューの初のドロップダウンリストボックス内で「n_pbtutor_connectservice」が選択されていることを確認します。2 番目のドロップダウンリストボックスで Constructor イベントが選択されていることを確認します。

スクリプトビューに、接続オブジェクトウィザードで作成したConstructor イベントのスクリプトが表示されます。



スクリプトは、 of_GetConnectionInfo 関数を呼び出して、接続情報を取得します。次に、この関数のスクリプトを参照します。

3 スクリプトビューの初のドロップダウンリストボックスで「Functions」を選択します。2 番目のドロップダウンリストボックスで「of_GetConnectionInfo」を選択します。

この関数のスクリプトは、データベース接続情報を接続サービスマネージャの Constructor イベントに渡します。渡される情報は、インスタンス変数によって異なります。ここでは、is_connectionfrom変数の値は 1 です。これを確認します。インスタンス変数は、すべての関数および n_pbtutor_connectservice オブジェクトのすべてのイベントに対して有効です。

is_connectfrom 変数が 1 であるため、接続サービスマネージャは、INI ファイルの［データベース］セクションを参照し、 ProfileString関数呼び出しでデータベース接続情報を取得します。ここでは、指定した INI ファイルは pbtutor.ini です。この pbtutor.ini ファイルは、前のステップで接続オブジェクトウィザードを使用して作成したものです。

この後のステップで、 pbtutor.ini ファイルと of_GetConnectionInfo関数を変更し、ユーザ ID とパスワード情報を INI ファイルではなくログインウィンドウから取得するようにします。

4 2 番目のドロップダウンリストボックスで「of_ConnectDB」を選択します。

これは、SQLCA トランザクションオブジェクトを使用して実際にデータベースに接続する接続サービスマネージャの関数です。この関数は、レッスン 3 「ログインウィンドウの作成」で作成したログインウィンドウから呼び出すことができます。

ウィザードで生成されたこの関数のスクリプトには、データベース接続が失敗した場合にメッセージボックスを表示することも記述されています。

5 2 番目のドロップダウンリストボックスで「of_DisconnectDB」を選択します。

これは、データベース接続を解除するための、接続サービスマネージャの関数です。この関数は、アプリケーションの Close イベントから呼び出すことができます。

106 PowerBuilder


6 ［インスタンス変数の宣言］タブをクリックします。2 番目のドロップダウンリストボックスで「Instance Variables」が選択されていることを確認します。

スクリプトビューでの「Declare」の選択インスタンス変数の宣言ビューは、スクリプトビューの特殊なインスタンスです。スクリプトビューの初のドロップダウンリストボックスで「Declare」を選択すると表示されます。 2 番目のスクリプトビューにすでにインスタンス変数が表示されている場合は、「Declare」を選択できません。

ここで、 is_connectionfrom 変数の値が 1 であることが分かります。

7 2 番目のドロップダウンリストボックスで「Global Variables」を選択します。システムツリーの「n_pbtutor_connectservice」をスクリプトビューにドラッグします。

システムツリーのオブジェクト名と関数名をスクリプトビューにドラッグすると、時間の節約と誤入力の回避に役立ちます。

8 オブジェクト名のあとに変数名を入力して行を完成させます。

n_pbtutor_connectservice gnv_connect

このオブジェクトは、n_pbtutor_connectservice ユーザオブジェクトのスクリプトビューで宣言しますが、アプリケーションのどこからでも利用できます。



変数の命名規約スクリプトをより読みやすくするには、一般的な命名ルールに従うのが適な方法と言えます。一般的なルールでは、 2 文字か 3 文字の接頭辞の後にアンダースコア（ _ ）が付きます。接頭辞の先頭の英字は変数のアクセスレベルの範囲（g は global、 l は local）を表し、後ろの文字は変数のデータ型（s は String 型、l は Long 型、nv は非ビジュアルオブジェクト）を表します。

9 ペインタバーの［保存］ボタンをクリックします。またはメニューバーから［ファイル｜上書き保存］を選択します。

スクリプトがコンパイルされて保存されます。グローバル変数のデータ型を（システムツリーからドラッグせずに）入力した場合、入力ミスがあると、エラーメッセージが表示されます。その場合は、エラーを修正してからもう一度［上書き保存］を選択してください。

108 PowerBuilder


接続情報の変更

現在の学習個所EAS Demo DB データベースの参照接続オブジェクトウィザードの実行グローバル変数の宣言

> 接続情報の変更ログインおよびログアウトスクリプトの完了アプリケーションの実行

これで、接続サービスマネージャを呼び出してデータベース接続を確立できます。ただし、データベース接続を確立するのは、ログインウィンドウで有効なユーザ ID とパスワードが入力された場合のみにする必要があります。そこで、 pbtutor.ini ファイルの情報をユーザが入力した情報に置き換えて、ログインウィンドウの［OK］ボタンの Clickedイベントに接続サービス呼び出しを追加します。

この作業を行う前に、ProfileString 呼び出しが記述されている行を削除してコメント化します。ProfileString 呼び出しは、INI ファイルからユーザ ID とパスワード情報を取得するために接続サービスマネージャが作成するものです。さらに、ユーザ ID とパスワードの値は、pb.ini ファイルから取得されてハードコードになっているため、 pbtutor.ini ファイルで DBParm パラメータのそれぞれの値を変更します。


• of_GetConnectionInfo 関数の変更

• 接続サービスマネージャの呼び出し

of_GetConnectionInfo 関数の変更

前のステップで、 of_GetConnectionInfo 関数について触れました。ここでは、ユーザ ID とパスワード情報用にこの関数が返す情報をコメント化する方法について説明します。

ユーザオブジェクトペインタを閉じている場合は、もう一度開いてn_pbtutor_connectservice ユーザオブジェクトを表示してください。［ファイル｜近使用したオブジェクト］メニューを選択すれば、再表示できます。



1 スクリプトビューの初のドロップダウンリストボックスで「Functions」を選択します。2 番目のドロップダウンリストボックスで「of_GetConnectionInfo」を選択します。

2 ProfileString が代入されている 2 行を選択します。

as_userid = ProfileString (...)as_dbpass = ProfileString (...)

ProfileString 呼び出しで指定する引数は、 INI ファイル名または変数、 INI ファイルセクション、 INI ファイルキー、およびそれらが正しくない場合に使用するデフォルト値の 4 つです。これらの行は、 of_GetConnectionInfo 関数の CHOOSE CASE 文にある IS_USE_INIFILE の一部です。

3 ペインタバー 2 の［コメント］ボタンをクリックします。

これらの行をコメント化することで、ユーザ ID とパスワード情報が pbtutor.ini から取得されなくなります。

4 以下のコードで始まる行で、任意の場所をクリックします。

as_dbparm = ProfileString ( ... )

5 ペインタバー 2 の［コメント］ボタンをクリックします。

ptutor.ini ファイルの DBParm パラメータには、ハードコーディングされたユーザ ID、パスワード、およびデータベース名が含まれていますが、これらの値は使用しないでください。そのかわりに、ユーザが入力した情報（ユーザ ID とパスワード）の値を DBParmパラメータに代入します。

SQLCA DBParm パラメータDBParm の ConnectString でユーザ ID とパスワードは不要ですが、その 2 つを ConnectString に代入すると、 Adaptive Server Anywhereデータベースのデータソース定義にあるユーザ ID とパスワードは上書きされます。この DBMS では、 DBParm パラメータは、SQLCA の UserID パラメータと DBPass パラメータより優先します。

6 ペインタバー 1 の［保存］ボタンをクリックします。ペインタバー 1 の［閉じる］ボタンをクリックします。

110 PowerBuilder


接続サービスマネージャの呼び出し

次のステップでは、接続サービスマネージャを呼び出して、データベースに接続します。ログインウィンドウからユーザ入力情報を追加する必要があるため、接続サービスマネージャを呼び出すスクリプトを、このウィンドウの［OK］ボタンの Clicked イベントに追加します。

オブジェクトは、そこに追加されたコントロールの親と見なされます。したがって、ログインウィンドウは［OK］ボタンの親ということになります。

スクリプトで親オブジェクトを参照する場合は通常、明示的にオブジェクト名で指定するよりも限定子 parent を使用する方が適切です。parent を使用すると、ほかのオブジェクト上に配置されているコントロールに対して、そのコードを再利用しやすくなります。 Clicked イベントのスクリプトでは、ログインウィンドウを親として参照します。

単一のウィザードでアプリケーションと接続サービスオブジェクトを作成した場合テンプレートアプリケーションウィザードで接続サービスのユーザオブジェクトがすでに作成してあれば、このステップで入力する接続サービスマネージャを呼び出すためのコードは自動的に生成されています。ただし、そのコードは、ログインウィンドウの Clicked イベントではなく、アプリケーションの Open イベントに追加されています。なお、このコードには、グローバル変数ではなくローカル変数が使用されます。

1 システムツリーの w_welcome をダブルクリックします。

ウィンドウペインタが開きます。

2 スクリプトビューの初のドロップダウンリストボックスで「cb_ok」を選択します。またはレイアウトビューの［OK］ボタンをダブルクリックします。

2 番目のドロップダウンリストボックスでは Clicked イベントが選択されていなければなりません。 Clicked イベントが選択されていない場合は選択します。 Clicked イベントのスクリプトには何も記述されていません。



3 以下の行を入力します。

// 1) トランザクションオブジェクトをインスタンス化// 2) 接続が成功ならばログインウィンドウを閉じる

この 2 行は、 Clicked イベントに追加するコードの説明です。行の先頭にスラッシュを 2 個付けると、コメントが入力できるようになります。

4 コメントの下に次の代入文を入力します。

gnv_connect = CREATE &n_pbtutor_connectservice

このスクリプトの行を 1 行にまとめる場合、アンパサンド（&）は入力しないでください。アンパサンドは、スクリプト行が次の行に続くことを示す文字です。

CREATE 文は、 of_GetConnectionInfo 関数が pbtutor.ini ファイルから取り出したすべての値を持つ SQLCA トランザクションオブジェクトをインスタンス化します。ユーザ ID とパスワードの行は、すでにコメント化されているので取り出されません。

スクリプトをより読みやすく理解しやすくするには、コメントと、グローバル変数 gnv_connect の代入文の間に空白行を挿入します。

5 CREATE 文の下に以下の行を入力します。

IF gnv_connect.of_ConnectDB ( ) = 0 THENClose (parent)

END IF

of_ConnectDB 関数はアプリケーションをデータベースに接続します。このレッスンの始めの方で説明したように、接続が失敗した場合（SQL コードが 0 以外の場合）は、メッセージボックスが開き、そのボックスに SQL エラー文が表示されます。

112 PowerBuilder


of_ConnectDB が 0 （接続の成功を表す SQL コード）を返した場合は、IF-THEN 文の次の行から解析が続けられます。この場合、cb_okコントロールの親ウィンドウ（w_welcome）が閉じられます。

6 ペインタバー 2 の［コンパイル］ボタンをクリックします。またはスクリプトビューの内部を右クリックして、ポップアップメニューから［コンパイル］をクリックします。

このスクリプトでは、コンパイルエラーは発生しないはずです。エラーメッセージが表示された場合は、オブジェクト名と関数名を正しく入力していること、および gnv_connect をグローバル変数として保存したことを確認してください。

スクリプトビューのエラーウィンドウの表示 / 非表示スクリプトビューで、タイトルバーの下の右端にあるアイコンをクリックすると、エラーウィンドウの表示 / 非表示を切り替えられます。

この後で、 Clicked イベントのスクリプトを記述し、ユーザが入力した接続情報を持つトランザクションオブジェクトをインスタンス化する必要があります。


ログインおよびログアウトスクリプトの完了


現在の学習個所EAS Demo DB データベースの参照接続オブジェクトウィザードの実行グローバル変数の宣言接続情報の変更

> ログインおよびログアウトスクリプトの完了アプリケーションの実行

このレッスンの初めの方で、ログインウィンドウの［OK］ボタンのClicked イベントから接続サービスマネージャを呼び出す手順を説明しました。次のステップでは、ユーザが入力した情報を使用して、トランザクションオブジェクトをインスタンス化するためのスクリプトを、同じ Clicked イベントに追加します。

ログインウィンドウの［キャンセル］ボタンの Clicked イベントおよびアプリケーション Closed イベントに、コードを追加することもできます。

スクリプトビューの入力ミスを減らすにはスクリプトの作成領域内を右クリックすると、［形式を指定して貼り付け］コマンドを含むポップアップメニューが開きます。これらのコマンドを使用して、ステートメント、オブジェクト、関数、またはテキストファイルの内容をイベントスクリプトに貼り付けることができます。この操作によって手動入力によるエラーの可能性を減らすことができます。オートスクリプトを使用してコードにデータを入力することも可能です。この入力方法については、このレッスンで説明します。


• オートスクリプトショートカットの設定

• ［OK］ボタンの Clicked イベントに対するコードの追加

• ［キャンセル］ボタンの Clicked イベントに対するコードの追加

• アプリケーションの Close イベントに対するコードの追加

114 PowerBuilder


オートスクリプトショートカットの設定

オートスクリプトは、スクリプトを記述するときに役立ちます。たとえば、入力中の文を自動的に完成させたり、カーソル位置に挿入すべき言語要素のリストを表示する、などの機能があります。

1 メニューバーから［デザイン｜オプション］を選択し、［オートスクリプト］タブをクリックします。

2 初の 3 つのグループボックス内のすべてのチェックボックスがオンになっていることを確認します。［ドットの直後のみ起動］チェックボックスおよび［自動的にポップアップ］チェックボックスがオフになっていることを確認して、［OK］をクリックします。

このように設定しておくと、オートスクリプトは、挿入すべきコードを判定するための十分な情報があるところで、ヘルプを表示します。ただし、カーソルを置いただけでは自動的にはポップアップしません。［ステートメントテンプレート］チェックボックスをオンにすると（デフォルトではオフ）、オートスクリプトを使用して、複数行にまたがる PowerScript 構文を入力できます。

3 メニューバーから［ツール｜ショートカット］を選択します。ツリーの［編集］ノードを展開します。

4 下にスクロールして、［オートスクリプトを有効にする］を選択します。［ショートカットキー］ボックスにカーソルを合わせて、〔Ctrl〕+ 〔Space〕キーを押します。

5 ［編集］メニューの［ジャンプ］ノードを展開し、［次のマーク］を選択します。［ショートカットキー］ボックスで〔Ctrl〕 + 〔M〕を押します。［OK］をクリックします。

これで、コードの入力中にヘルプが必要な場合はいつでも、〔Ctrl〕+ 〔Space〕を押して、入力データ候補のリストをポップアップさせることができます。文または関数の中にコメントを貼り付けるときは、〔Ctrl〕 + 〔M〕を押して次のコメントに移動できます。



［OK］ボタンの Clicked イベントに対するコードの追加

本番アプリケーション開発の際には、ある接続プロパティを初期設定ファイルから、別の接続プロパティをユーザ入力から取得することがよくあります。

このチュートリアルアプリケーションのユーザ ID とパスワードは、チュートリアルの INI ファイルから取得しないでください。この 2 つはログインウィンドウで入力するようにし、データベースに関する情報はスクリプトで用意してください。

1 cb_ok コントロールの Clicked イベントスクリプトが表示されていることを確認します。

これは、接続サービスオブジェクトの呼び出しを追加するスクリプトです。

2 IF-THEN 文の前をクリックします。以下の行を入力します。

// ローカル変数宣言string ls_database, ls_userid, ls_password

// 代入文ls_userid = Trim ( sle_userid.text )ls_password = Trim ( sle_password.text )ls_database = "ConnectString='DSN=EAS Demo DB V9;"

ここではローカル変数を宣言して、値を代入しています。ConnectStringテキスト内では、 = 記号の前後にスペースを入れないでください。

オートスクリプトを使用して代入文を簡単にコーディングする方法オートスクリプトで代入文を入力するときに、変数名の中のアンダースコア（_）よりも前に英字を入力して〔Ctrl〕 + 〔Space〕キーを押すと、入力データ候補のリストをポップアップさせることができます。矢印キーを使用して適切な入力データ候補に移動し、これを〔Tab〕キーでスクリプト内に貼り付けます。まずアンダースコア（_）を入力し、その後ろに先頭の英字を入力して〔Ctrl〕 +〔Space〕を押すと、一意の入力データ候補がある場合は、これが直接スクリプト内に貼り付けられます。

Trim 関数は、ログインウィンドウのシングルラインエディットボックスから引数として渡されたユーザ ID およびパスワードの値の前後のスペースを削除します。

116 PowerBuilder


3 追加した行（および CREATE 文）よりも後ろ、 IF-THEN 文よりも前の位置でクリックします。以下の行を入力します。

// ユーザ入力の値でインスタンス化SQLCA.userid = ls_useridSQLCA.dbpass = ls_passwordSQLCA.dbparm = ls_database + "UID=" + &

ls_userid + ";PWD=" + ls_password + "'"

上記の行によって、［シングルラインエディット］テキストボックスから取得した値で SQLCA パラメータがインスタンス化されます。

上記の行は、 CREATE 文よりも後ろに追加する必要があります。これは、接続サービスマネージャの Constructor イベントで取得した空の値が上記の行を上書きしてしまうのを防ぐためです。上記の行を IF-THEN 文よりも前に追加することも必要です。そうしないと、接続サービスマネージャの of_ConnectDB 関数によって上記の行が呼び出されたときに、トランザクションオブジェクトによってこれらの値が使用されません。

4 ペインタバー 2 の［コンパイル］ボタンをクリックします。またはスクリプトビューの内部を右クリックして、ポップアップメニューから［コンパイル］をクリックします。



このスクリプトでは、コンパイルエラーは発生しないはずです。エラーメッセージが表示された場合は、オブジェクトと関数名を正しく入力しているか確認します。

［キャンセル］ボタンの Clicked イベントに対するコードの追加

このステップでは、コードを［キャンセル］ボタンに追加して、ボタンをクリックしたときにアプリケーションの実行が中止されるようにします。

1 レイアウトビューで［キャンセル］ボタンをダブルクリックします。またはスクリプトビューの初のドロップダウンリストボックスで「cb_cancel」を選択します。

［キャンセル］ボタンのスクリプト領域は空白になっています。

2 Clicked イベントのスクリプトを 1 行入力します。

HALT

このスクリプトは、ログインウィンドウで［キャンセル］ボタンをクリックすると、すぐにアプリケーションを強制終了します。

3 ペインタバーの［保存］ボタンをクリックします。またはメニューバーから［ファイル｜上書き保存］を選択します。

スクリプトがコンパイルされます。

4 ペインタバーの［閉じる］ボタンをクリックします。またはメニューバーから［ファイル｜閉じる］を選択します。


118 PowerBuilder


アプリケーションの Close イベントに対するコードの追加

接続サービスマネージャは、グローバル変数によって呼び出されているため、このままアプリケーションで利用できます。（ローカル変数を使用した場合とは異なり）インスタンス化し直す必要はありません。

このステップでは、接続サービスマネージャで接続を解除する関数を呼び出して、データベース接続を終了します。

1 システムツリーの pbtutor アプリケーションアイコンをダブルクリックします。

アプリケーションペインタに、チュートリアルアプリケーションオブジェクトのさまざまなビューが表示されます。スクリプトビューがデフォルトレイアウト内のスタックの一部である場合は、スタックから切り離すか、 2 番目のスクリプトビューを開くほうが簡単な場合もあります。

2 スクリプトビューの 2 番目のドロップダウンリストボックスで「close( ) returns (none)」を選択します。

アプリケーションの Close イベントには、まだ何もコードが記述されていません。

3 Close イベントのコメントとして以下の行を入力します。

// アプリケーションを閉じるためのスクリプト// データベースとの接続解除

4 追加した行の一部または全部を選択します。［コメント］ボタンをクリックします。

5 入力したコメントの下の行に、次の行を入力します（オートスクリプトを使用すると簡単に変数名と関数名を入力できます）。

gnv_connect.of_DisconnectDB ( )



グローバル変数を null に設定してメモリを解放する場合アプリケーションの Close イベントがなく、接続グローバル変数のインスタンスを必要としない場合は、 SetNull 関数を呼び出して、割り当てられていたメモリを解放できます。

PowerBuilder には、オブジェクトインスタンスを破棄する DESTROY文も用意されています。非ビジュアルオブジェクトのローカル変数またはグローバル変数には DESTROY 文を使用しないでください。 PowerBuilder ガベージコレクションは、スコープの外に出たローカル変数を削除します。

6 スクリプトビューのスクリプト領域内の任意の場所を右クリックします。ポップアップメニューで［コンパイル］をクリックします。

Close スクリプトがコンパイルされます。エラーメッセージが表示された場合は、入力済みの行をチェックして、変数またはオブジェクト名に入力ミスがないかどうかを確認してください。

7 ペインタバー 1 の［閉じる］ボタンをクリックします。

メッセージボックスが表示され、アプリケーションライブラリファイルのアプリケーションオブジェクトの変更内容を保存するかどうかをたずねられます。


変更内容が保存され、アプリケーションペインタが閉じます。

120 PowerBuilder



現在の学習個所EAS Demo DB データベースの参照接続オブジェクトウィザードの実行グローバル変数の宣言接続情報の変更ログインおよびログアウトスクリプトの完了


このステップでは、アプリケーションを実行します。

1 パワーバーの［実行］ボタンをクリックします。メッセージボックスが表示され、変更を保存するよう要求されたら、［はい］をクリックして保存します。

ワークスペースが閉じ、アプリケーションが実行されます。

2 ［ユーザ ID］テキストボックスに「dba」と入力します。［パスワード］ボックスに「sql」と入力します。

パスワードはアスタリスクで表示されます。このウィンドウのタブ順序はすでに設定してあるため、〔Tab〕を押して［ユーザ ID］ボックスから［パスワード］ボックス、さらに［OK］にフォーカスを移動できます。


データベースに接続して、 MDI フレームが開きます。

無効なユーザ ID とパスワードを入力した場合ユーザ ID とパスワードに入力ミスがあった場合、ODBC の設定ダイアログボックスが表示されます。このダイアログボックスの［ログイン］ページで正しいユーザ ID とパスワードを入力し直してください。パスワードとユーザ ID を変更せずに、このダイアログボックスの［ODBC］ページで［テスト接続］ボタンをクリックすると、ユーザ ID とパスワードの無効を通知するメッセージボックスが表示されます。

4 メニューバーから［ファイル｜終了］を選択します。

アプリケーションが終了し、 PowerBuilder 開発環境に戻ります。



122 PowerBuilder

レッスン 5 先祖ウィンドウの変更

このレッスンでは、テンプレートアプリケーションウィザードを使用して生成したベースシートウィンドウを継承するウィンドウを作成します。まず、データウィンドウコントロールを含む定義済みのユーザオブジェクトを、継承されるウィンドウに追加します。次に、オリジナルのベースシートではなく、拡張レイヤウィンドウを継承する新規ウィンドウ w_customers と w_products を作成します。後に、これらのシートウィンドウが、デザイン時に設定したサイズで実行時にオープンされるようにします。

その前にまず、データウィンドウコントロールを含む定義済みのユーザオブジェクトが登録されたライブラリリストに、ライブラリを追加します。このレッスンでは、以下の項目について学習します。

• 探索パスへのライブラリの追加

• 先祖シートウィンドウの新規作成

• ユーザイベントおよびイベントスクリプトの追加

• データウィンドウコントロールのデータの検索を行うスクリプトの追加

• シートウィンドウのサイズに合わせた実行時の設定の調整



探索パスへのライブラリの追加

探索パスへのライブラリの追加

現在の学習個所> 探索パスへのライブラリの追加

先祖シートウィンドウの新規作成ユーザイベントおよびイベントスクリプトの追加データウィンドウコントロールのデータの検索を行うスクリプトの追加シートウィンドウのサイズに合わせた実行時の設定の調整

このステップでは、チュートリアルアプリケーションの探索パスにライブラリを追加します。アプリケーションで使用するすべてのライブラリを追加する必要があります。

現在のアプリケーションに追加するライブラリには、ベースシートウィンドウに後で追加するユーザオブジェクト（u_dwstandard）など、いくつかのコーディング済みのオブジェクトが含まれます。

1 システムツリーで pbtutor ターゲットを右クリックします。ポップアップメニューで［プロパティ］をクリックします。

pbtutor ターゲットプロパティダイアログボックスが表示されます。

2 ［ライブラリリスト］ページが表示されていることを確認します。［参照（…）］をクリックします。

ライブラリの選択ダイアログボックスが表示されます。

3 Tutorial フォルダに移動します。「tutor_pb.pbl」を選択し、［開く］をクリックします。

124 PowerBuilder


［ライブラリリスト］ページに戻ります。チュートリアルアプリケーションの探索パスに tutor_pb.pbl ファイルが含まれています。



先祖シートウィンドウの新規作成


現在の学習個所探索パスへのライブラリの追加

> 先祖シートウィンドウの新規作成ユーザイベントおよびイベントスクリプトの追加データウィンドウコントロールのデータの検索を行うスクリプトの追加シートウィンドウのサイズに合わせた実行時の設定の調整

テンプレートアプリケーションウィザードを使用して生成したベースシートウィンドウを継承するウィンドウを作成し、データウィンドウコントロールを追加します。ソースエディタで、生成したシートウィンドウ（w_customers と w_products）が、上記の新規ウィンドウを継承するように変更します。

新規の先祖ウィンドウに追加するデータウィンドウコントロールは、チュートリアルアプリケーション用に作成したユーザオブジェクトから定義を継承します。このユーザオブジェクトは、先ほどターゲットライブラリリストに追加した PBL ファイルに含まれています。ユーザオブジェクトとは、カスタマイズされたデータウィンドウコントロールのことで、標準のデータベースエラーのチェックを実行するスクリプトを含みます。

ユーザオブジェクトを使用する理由PowerBuilder では、アプリケーションでよく使用する処理を実行するためにユーザオブジェクトを構築します。定義したユーザオブジェクトは、追加作業なしで繰り返し利用できます。


• 新規シートウィンドウの継承階層の作成

• マスターデータウィンドウ用のデータウィンドウコントロール（dw_master）の追加

• 詳細データウィンドウ用のデータウィンドウコントロール（dw_detail）の追加

• ユーザオブジェクトから継承されたスクリプトの参照

126 PowerBuilder


新規シートウィンドウの継承階層の作成

このステップでは、ベースシートウィンドウを継承するウィンドウを新規に作成します。このレッスンでは、この新規ウィンドウを、ベースシートウィンドウとアプリケーションシートウィンドウの間の拡張レイヤとして使用します。後で、この拡張レイヤウィンドウに変更を加えます。この変更は、この拡張レイヤウィンドウを継承するすべての新規シートウィンドウに自動的に反映されます。

現在のチュートリアルアプリケーションでは、すでに w_customers および w_products ウィンドウが w_pbtutor_basesheet ウィンドウを継承しています。ウィザードによって生成されたこれらのシートウィンドウには（名前と表示テキストを除き）固有のプロパティ値や関数をまだ追加していないため、これらのウィンドウを上書きして新規のウィンドウを作成する際にコードをコピーする必要は一切ありません。このレッスンでは、これらのウィンドウを上書きして、拡張レイヤウィンドウを継承する新規ウィンドウを作成します。

1 PowerBuilder メニューから［ファイル｜継承］を選択します。

オブジェクトから継承ダイアログボックスが表示されます。

2 ［ライブラリ］リストボックスで pbtutor.pbl が選択されており、［オブジェクトの種類］ドロップダウンリストボックスで「ウィンドウ」が選択されていることを確認します。「w_pbtutor_basesheet」を選択して、［OK］をクリックします。

3 ［ファイル｜上書き保存］を選択し、新規ウィンドウ名に「w_master_detail_ancestor」と入力します。

4 （オプション）［コメント］ボックスに以下のコメントを入力します。

w_customers および w_products シートウィンドウに使用する新規先祖ベースシート

5 ［アプリケーションライブラリ］リストボックスで「pbtutor.pbl」が選択されていることを確認して、［OK］をクリックします。［ファイル｜閉じる］を選択して、新規先祖ベースシートを閉じます。

先祖ウィンドウがウィンドウペインタ内で開いていると、子孫ウィンドウを作成できません。

6 PowerBuilder メニューから［ファイル｜継承］を選択します。



7 ［ライブラリ］リストボックスで pbtutor.pbl が選択されており、［オブジェクトの種類］ドロップダウンリストボックスで「ウィンドウ」が選択されていることを確認します。「w_master_detail_ancestor」を選択して、［OK］をクリックします。

8 プロパティビューの［全般］ページの［タグ］テキストボックスに「Maintain Customers」と入力します。 PowerBuilder メニューから［ファイル｜名前を付けて保存］を選択し、［ウィンドウ］リストボックスで「w_customers」を選択します。

9 コメントのテキストを次のように変更します。

w_master_detail_ancestor から継承する Customer シートウィンドウ

10 ［OK］をクリックして、既存の w_customers ウィンドウを置き換えるかどうかを尋ねるウィンドウの保存ダイアログボックスが表示されたら［はい］をクリックします。

w_pbtutor_basesheet ではなく w_master_detail_ancestor を継承するシートウィンドウが新規に作成されます。

11 以下の 2 つの手順を変更して、手順 6 ～ 10 を繰り返します。

12 新規に作成した w_customers および w_products ウィンドウを閉じます。

いずれかの子孫がウィンドウペインタに表示されている場合、その先祖ウィンドウをオープンすることはできません。

13 PowerBuilder メニューから［実行｜ワークスペースのフル構築］を選択します。

手順変更指示

8 プロパティビューの［全般］ページの［タグ］テキストボックスに「Maintain Products」と入力します。 PowerBuilderメニューから［ファイル｜名前を付けて保存］を選択し、［ウィンドウ］リストボックスで「w_products」を選択します。

9 コメントのテキストを次のように変更します。w_master_detail_ancestor から継承する Product シート

ウィンドウ

128 PowerBuilder


ワークスペースの再構築は、継承階層を変更した後、新規先祖ウィンドウを修正する前に行う必要があります。構築の進行状況は、PowerBuilder メインウィンドウ下部のシステムツリーの下に表示される出力ウィンドウで見ることができます。構築が終了すると、出力ウィンドウに「終了ワークスペースのフル構築 MyWorkspace」と表示されます。

マスターデータウィンドウ用のデータウィンドウコントロール（dw_master）の追加

このステップでは、データウィンドウコントロール（ユーザオブジェクト u_dwstandard として保存）を w_master_detail_ancestor ウィンドウに追加します。このコントロールは、先祖ウィンドウおよびその子孫ウィンドウのマスタデータウィンドウとして使用されます。

u_dwstandard のようなユーザオブジェクトの作成方法データウィンドウコントロールを基にしたユーザオブジェクトを作成するには、［新規作成］ボタンをクリックし、新規作成ダイアログボックスの［PB オブジェクト］ページから［標準ビジュアル］を選択します。これで標準ビジュアルオブジェクトのデータ型の選択ダイアログボックスが表示されます。［データ型］テキストボックスで「datawindow」を選択し、必要に応じてユーザイベントを追加します。ユーザイベントを追加する方法については、このチュートリアルの後半で説明します。

1 システムツリーで w_master_detail_ancestor をダブルクリックします。

ウィンドウペインタに w_master_detail_ancestor ウィンドウが開きます。このウィンドウはテンプレートアプリケーションウィザードによって作成されたウィンドウです。同ウィザードによって、メニューが作成され、このウィンドウ m_pbtutor_sheet にアタッチされています。このメニューは、ウィンドウのプロパティビューに表示されます。このプロパティは後で変更します。

2 ウィンドウペインタにレイアウトビューが見えていることを確認してください。

3 システムツリー内の tutor_pb.pbl を展開します。システムツリーからレイアウトビューの w_master_detail_ancestorウィンドウに u_dwstandard をドラッグします。



4 ウィンドウを広げて、コントロール全体がウィンドウ内に表示されるようにします。

ユーザオブジェクトの定義を継承するデータウィンドウコントロールが作成されます。

5 レイアウトビューで新しいコントロールが選択されていることを確認します。

隅に小さな黒い正方形が表示されていれば、そのコントロールは選択されています。プロパティビューには選択されているコントロールのプロパティが表示されます。

6 プロパティビューの［名前］テキストボックスで「dw_1」を選択します。［名前］テキストボックスに「dw_master」と入力します。［垂直スクロールバー］チェックボックスをオンにします。

データウィンドウコントロールに垂直スクロールバーが追加され、コントロール名が dw_master に変更されます。

「dw_」はデータウィンドウコントロールの標準的な接頭辞です。

130 PowerBuilder


詳細データウィンドウ用のデータウィンドウコントロール（dw_detail）の追加

このステップでは、アプリケーションの詳細データウィンドウである2 番目のデータウィンドウコントロールを追加します。

1 2 番目のデータウィンドウコントロールを 1 番目のコントロールの下に追加するスペースを確保するために、ウィンドウのサイズを変更します。システムツリーからレイアウトビューの dw_master コントロールの下に u_dwstandard をドラッグします。

ユーザオブジェクト u_dwstandard の定義を継承する別のデータウィンドウコントロールが作成されます。

2 全体がウィンドウ内に表示されるようにデータウィンドウコントロールを移動します。

必要に応じて、レイアウトビューを大化し、その中のウィンドウオブジェクトを拡大して、データウィンドウコントロールを表示するスペースを大きくします。

3 レイアウトビューで新しいコントロールが選択されていることを確認します。

プロパティビューには選択されているコントロールのプロパティが表示されます。

4 プロパティビューの［名前］テキストボックスで「dw_1」を選択します。［名前］テキストボックスに「dw_detail」と入力します。

コントロール名が dw_detail に変更されます。



ユーザオブジェクトから継承されたスクリプトの参照

このステップでは、データウィンドウコントロールが u_dwstandard から継承したスクリプトを参照します。

1 レイアウトビューで dw_detail データウィンドウをダブルクリックします。またはまだ選択していない場合は、スクリプトビューの初のドロップダウンリストから「dw_detail」を選択します。

スクリプトビューで、 dw_detail コントロールの ItemChanged イベントに対するスクリプトが開きます。このスクリプトは空です（何も記述されていません）。

スクリプトが記述されていないイベントは、スクリプトが記述されたイベントとは別にアルファベット順に並べられます。スクリプトが記述されたイベントが、ドロップダウンリストボックスの先頭に一覧表示されます。先祖スクリプトが記述された dberror イベントはここに表示されます（表示されない場合は、イベントのドロップダウンリストボックスを上方にスクロールしてください）。

2 スクリプトビューの 2 番目のドロップダウンリストボックスで「dberror」を選択します。

このスクリプトも何も記述されていませんが、イベント名の横のスクリプトアイコンが紫色で表示されています。これは、先祖コントロール（u_dwstandard）に、関連付けられたスクリプトがあることを意味します。

3 メニューバーの［編集｜ジャンプ｜先祖スクリプト］を選択します。または3 番目のドロップダウンリストボックスで「u_dwstandard」を選択します。

132 PowerBuilder


スクリプトビューに、 DBError イベントに対するスクリプトが表示されます。先祖スクリプトは、子孫ウィンドウのスクリプトビューからアクセスするときは読み込み専用になります。

4 適宜ウィンドウをスクロールして、 DBError イベントに定義されたデータベースのエラー処理を見ます。

このスクリプトでは、DBError イベントが通常表示するデフォルトのエラーメッセージを抑制して、発生する可能性のあるデータベースエラーごとに適切なメッセージを表示しています。また、ユーザオブジェクトに宣言されたユーザイベントを呼び出しています。

dw_master と dw_standard は、ともに u_dwstandard を継承したコントロールなので、このロジックは両方のコントロールで自動的に再利用されます。

5 メニューバーの［編集｜ジャンプ｜子孫スクリプト］を選択します。またはスクリプトビューのスクリプト領域を右クリックします。ポップアップメニューの［ジャンプ｜子孫スクリプト］を選択します。

3 番目のドロップダウンリストボックスに、現在のコントロールを含むオブジェクトの識別子である「w_master_detail_ancestor」が再度表示されます。このコントロール（dw_detail）の DBError イベントのスクリプトはまだ記述されていません。


ユーザイベントおよびイベントスクリプトの追加


現在の学習個所探索パスへのライブラリの追加先祖シートウィンドウの新規作成

> ユーザイベントおよびイベントスクリプトの追加データウィンドウコントロールのデータの検索を行うスクリプトの追加シートウィンドウのサイズに合わせた実行時の設定の調整

ウィンドウ、ユーザオブジェクト、およびコントロールは、定義済みのイベントを持ちます。必要とするイベントはほとんど定義済みイベントで提供されていますが、必要に応じて独自のイベントを宣言することができます。このようなイベントをユーザイベントと呼びます。

ユーザイベントの使い方ユーザイベントを定義する目的の 1 つは、あるアプリケーションが同じタスクをいくつかの異なる場所に記述している場合に、それらを 1 箇所にまとめてコード記述を減らすことです。たとえば、データベースを更新するというタスクは、ボタンをクリックしたり、メニュー項目を選択したり、ウィンドウを閉じたりすると実行されます。こうした場合に、ボタンやメニュー項目やウィンドウといった各場所にデータベースを更新するスクリプトを記述しなくても、ユーザイベントを 1 つ定義しておき、データベースを更新する各場所でそのイベントを起動すればよいのです。

このステップでは、チュートリアルデータベースに対して検索、挿入、更新、削除の処理を行うユーザイベントを定義します。これらの変更はウィンドウペインタのスクリプトビューで行います。このチュートリアルの後半で、これらのイベントを発生させるコードをメニューペインタで追加します。

1 スクリプトビューの初のドロップダウンリストボックスで「w_master_detail_ancestor」を選択します。

2 メニューバーの［挿入｜イベント］を選択します。またはスクリプトビューの 2 番目のドロップダウンリストボックスで「（新規イベント）」を選択します。

スクリプトビューに、新しいイベントを定義するためのプロトタイプウィンドウが表示されます。

134 PowerBuilder

3 番目のドロップダウンリストボックスの右にある 1 番目のボタンは、プロトタイプウィンドウの表示 / 非表示を切り替えるトグルスイッチです。

3 プロトタイプウィンドウの［イベント名］テキストボックスに「ue_retrieve」と入力します。プロトタイプウィンドウ下部のスクリプトビュー内をクリックします。次のように入力します（または、次に説明しているオートスクリプトを使用します）。

IF dw_master.Retrieve() <> -1 THEN dw_master.SetFocus()

dw_master.SetRowFocusIndicator(Hand!)END IF

オートスクリプトの使い方オートスクリプトを使用すると、次のように IF THEN テンプレート、および変数や関数名を貼り付けることができます。

「IF」と入力してから、〔Ctrl〕 + 〔Space〕を押します。〔Tab〕を押して IF THEN 文を貼り付けます。「dw_m」と入力してから、〔Ctrl〕 + 〔Space〕を押します。「dw_master」の後ろにカーソルを置き、ドットを 1 個入力してから、〔Ctrl〕 + 〔Space〕を押します。スクロールして retrieve( ) を選択し、〔Tab〕を押し、行の残りを入力します。〔Ctrl〕 + 〔M〕を押して次のコメントに移動します。別の関数呼び出しを入力するか、オートスクリプトを使用して入力します。


スクリプト領域をクリックすると、スクリプトビューの 2 番目のドロップダウンリストボックスのテキストが「（新規イベント）」から「ue_retrieve」に変わります。この関数に引数はなく、値は返しません。また、ユーザ定義の例外も送出しません。ユーザ定義の例外の送出についての詳細は、レッスン 10 「例外処理」を参照してください。

入力したスクリプト行は Retrieve 関数を実行し、検索した行をデータウィンドウコントロール dw_master に配置します。検索に成功した場合は、データウィンドウコントロールの 1 行目にフォーカスがセットされ、現在の行を示すハンドポインタが表示されます。

検索に失敗した場合検索に成功しなかった場合は、 DBError イベントが発生します。DBError イベントはユーザオブジェクト u_dwstandard で処理されます。このスクリプトについては以前の練習で説明しました。

4 メニューバーから［ファイル｜上書き保存］を選択します。プロトタイプウィンドウを右クリックして、ポップアップメニューの「新規イベント」を選択します。

ue_retrieve イベントに対して入力したスクリプトがコンパイルされます。スクリプトビューに、別の新しいユーザイベントのプロトタイプウィンドウが表示されます。

136 PowerBuilder


エラーメッセージが表示された場合スクリプトで入力ミスがあった場合はコンパイルエラーになります。コンパイルエラーを無視するかどうかを尋ねるダイアログで［いいえ］を選択すると、スクリプトビューの一番下にコンパイルエラー領域が表示され、エラーが特定されます。この場合は、ue_retrieve イベントのスクリプトを入力し直します。

コンパイルエラー領域の表示 / 非表示を切り替えるには、スクリプトビューの右上の 2 番目のトグルスイッチをクリックします。

5 以下を入力して手順 3 と 4 を繰り返します。

スクリプトの処理内容 ue_insert イベントのスクリプトの 1 行目は、データウィンドウコントロール dw_detail をクリアします。 2 行目ではデータウィンドウコントロールの終行の後に新規の行を挿入します（引数 0 は終行を指定）。3 行目ではカーソルを dw_detailコントロールに置きます。

ue_insert および ue_delete イベントはデータベースではなく、データウィンドウバッファを操作します。これらのイベントが発生しても、データベースへの行の挿入や、データベースからの行の削除は行われません。一緒に Update 関数も呼び出されて初めてデータベースが更新されます（Update 関数は ue_update イベントによって呼び出されます）。 Update 関数が整数 1 を返すと、バッファに対する変更はデータベースにコミットされます。ほかの整数値が返されると、バッファに対する変更はロールバックされます。

ue_delete イベントのスクリプトでは、 DeleteRow 関数の引数 0 によって、 dw_detail コントロールの現在の行が削除されることを指定しています。

6 ［保存］ボタンをクリックします。

イベント名スクリプト

ue_insert dw_detail.Reset()

dw_detail.InsertRow(0)

dw_detail.SetFocus()

ue_update IF dw_detail.Update() = 1 THEN

COMMIT using SQLCA;

MessageBox （"保存 ","保存に成功しました "）ELSE

ROLLBACK using SQLCA;

END IF

ue_delete dw_detail.DeleteRow(0)


データウィンドウコントロールのデータの検索を行うスクリプトの追加


現在の学習個所探索パスへのライブラリの追加先祖シートウィンドウの新規作成ユーザイベントおよびイベントスクリプトの追加

> データウィンドウコントロールのデータの検索を行うスクリプトの追加シートウィンドウのサイズに合わせた実行時の設定の調整

先ほど入力したスクリプトはデータウィンドウコントロールdw_master に対して何も作用しませんが、ue_retrieve イベントのスクリプトがあるので、このイベントを発生させるだけでデータウィンドウdw_master にデータを取り出すことができます。

ue_retrieve イベントは、シートウィンドウの Open イベントから発生させます。これでウィンドウ（またはその子孫ウィンドウ）が開くと同時に、データウィンドウ dw_master にデータが取り出されます。次に、dw_master の RowFocusChanged イベントに、データウィンドウ dw_detailにデータを取り出すためのスクリプトを追加します。データウィンドウ dw_master 内でフォーカスが変更されるたびに RowFocusChanged イベントが発生します。

データウィンドウ表示と同時に RowFocusChanged イベントが発生初めてデータウィンドウ w_master が表示されるときにも RowFocusChanged イベントが発生します。これにより、アプリケーションはマスタデータウィンドウで検索された初の行についての詳細情報を検索および表示できます。

この節での作業が完了すると、スクリプトは w_master_detail_ancestorウィンドウおよびその子孫で以下の処理を行います。

• 初めてシートウィンドウを開いたときに、上のデータウィンドウコントロールにリスト（すべての顧客または商品のリスト）が表示されます。リストの初の項目の詳細情報は、下のデータウィンドウコントロールに表示されます。

• ユーザが上矢印または下矢印キーを使用して、または行をクリックして、上のデータウィンドウコントロールのリスト内を移動すると、下のデータウィンドウコントロールに現在の行の詳細が表示されます。

138 PowerBuilder


1 w_master_detail_ancestor のスクリプトビューで、2 番目のドロップダウンリストボックスから「open」を選択します。

Open イベントのスクリプトアイコンは紫色になっています。これは、先祖スクリプトがあることを示しています。先祖スクリプトを確認してみると、 ue_postopen イベントを呼び出し、それをウィンドウのメッセージキューの後にポストしていることがわかります。

2 次のコードを、 w_master_detail_ancestor の Open イベントスクリプト領域に入力します。

dw_master.settransobject ( sqlca )dw_detail.settransobject ( sqlca )this.EVENT ue_retrieve()

初の 2 行で、データウィンドウ dw_master および dw_detail に対して、SQLCA トランザクションオブジェクト内のデータベース変数の値を検索するように指示しています。3 行目は ue_retrieve イベントを発生させます。代名詞 This は現在のオブジェクトを参照します。この例では、w_master_detail_ancestor ウィンドウが現在のオブジェクトです。

3 スクリプトビューの初のドロップダウンリストボックスで「dw_master」を選択します。2 番目のドロップダウンリストボックスで「rowfocuschanged」を選択します。

ここでデータウィンドウコントロール dw_master の RowFocusChanged イベントのスクリプトを追加します。このスクリプトは検索要求と選択した行の ID 番号をデータウィンドウコントロール dw_detail に送ります。

イベント名に注意RowFocusChanging イベントではなく、 RowFocusChanged イベントを選択するよう注意してください。

4 RowFocusChanged イベントのスクリプト領域に次の行を入力します。

long ll_itemnum

この行は、 long 型のローカル変数 ll_itemnum （l は文字であり、数字ではない）を宣言します。



5 手順 4 で入力した変数宣言の下に次の行を入力します。

ll_itemnum = this.object.data[currentrow, 1]

角括弧（[ ]）の使用上記の式では、 ( ) ではなく [ ] を使用します。

この行は、データウィンドウのデータ式を使用して、 dw_master で現在選択されている行のカラム 1 の項目番号を取得します。値は変数 ll_itemnum に格納されます。

CurrentRow は RowFocusChanged イベントに渡される引数で、データウィンドウコントロール内の現在の行を指定します。現在の行とは、クリックしたり、矢印キーや〔Tab〕を使用してスクロールしたりしてユーザが選択した行です。

6 手順 5 で入力したデータ式の下に以下の行を入力します。

IF dw_detail.Retrieve(ll_itemnum) = -1 THEN

MessageBox ("検索 ","検索が失敗しました -detail")END IF

これらの行は、検索要求を、データウィンドウが期待する引数（ll_itemnum 変数に格納されている ID 番号）とともにデータウィンドウ dw_detail に送ります。 Retrieve 関数を囲む IF 文は正常に処理されたかどうかをチェックします。検索に失敗した場合は、エラーメッセージボックスが表示されます。

140 PowerBuilder



スクリプトがコンパイルされて保存されます。

8 パワーバーの［ワークスペースのフル構築］ボタンをクリックします。

先祖オブジェクトを変更したら、すべてのオブジェクトを再構築するようにしてください。


シートウィンドウのサイズに合わせた実行時の設定の調整

シートウィンドウのサイズに合わせた実行時の設定の調整

現在の学習個所探索パスへのライブラリの追加先祖シートウィンドウの新規作成ユーザイベントおよびイベントスクリプトの追加データウィンドウコントロールのデータの検索を行うスクリプトの追加

> シートウィンドウのサイズに合わせた実行時の設定の調整

テンプレートアプリケーションウィザードによって作成されるシートマネージャは、シートウィンドウを開く OpenSheet 関数を作成します。 OpenSheet 関数は、実行時のシートウィンドウサイズを設定する引数をとります。ウィザードはこの引数にデフォルトで Cascaded! という値を設定します。この値は、デザイン時に設定したシートウィンドウのサイズを上書きします。ここでは、この値を変更して、実行時のウィンドウサイズがデザイン時のサイズと同じになるようにします。

1 システムツリーで n_pbtutor_sheetmanager をダブルクリックします。またはシステムツリーの n_pbtutor_sheetmanager を右クリックして、ポップアップメニューから［編集］を選択します。

2 スクリプトビューの初のドロップダウンリストボックスで「（Functions）」を選択します。2 番目のドロップダウンリストボックスで「of_opensheet」を選択します。

3 スクリプト領域内の次の行に移動します。

li_rc = OpenSheet ( lw_sheet, as_sheetname, w_pbtutor_frame, 0, Cascaded! )

4 Cascaded! 引数を Original! に変更します。

li_rc = OpenSheet ( lw_sheet, as_sheetname, w_pbtutor_frame, 0, Original! )


次回チュートリアルアプリケーションを実行すると、デザイン時に設定したサイズでシートウィンドウが開きます。ただし、開いているほかのシートと重ねて表示される点は同じです。

142 PowerBuilder

レッスン 6 メニューの設定

このレッスンでは、チュートリアルアプリケーションで使用するメニューの設定を行います。このレッスンでは、以下の項目について学習します。

• フレームメニューの修正

• シートメニューの新規作成

• ユーザイベントを発生させるメニュースクリプトの追加

• 新規メニューのアタッチとアプリケーションの実行

メニューは独立したオブジェクトで、メニューペインタを使用して作成します。作成したメニューは複数のウィンドウで使用できます。アプリケーション開発プロセスのどの時点でもメニューを作成できます。



フレームメニューの修正


現在の学習個所> フレームメニューの修正

シートメニューの新規作成ユーザイベントを発生させるメニュースクリプトの追加新規メニューのアタッチとアプリケーションの実行

現在のフレームメニューはテンプレートアプリケーションウィザードによって自動的に作成されたメニューです。 m_pbtutor_frame メニューは、チュートリアルで作業するほかのすべてのメニューの先祖オブジェクトなので、このメニューを変更すると自動的に子孫メニューも変更されます。

メニューペインタのプレビュービューでは、アプリケーションを実行したときに表示されるとおりにメニューが表示されます。このチュートリアルでは、プレビュービューを使用してアプリケーションメニューに変更を加えますが、ツリーメニュービューで同様の変更を加えることもできます。ツールバーボタンを変更するときはプロパティビューを使用します。


• ［ファイル］メニューの修正

• ［ヘルプ］メニュー項目の有効化

144 PowerBuilder


［ファイル］メニューの修正

このステップでは、 m_pbtutor_frame メニューの［ファイル］カスケードメニューを変更します。

1 システムツリーで m_pbtutor_frame をダブルクリックします。

メニューペインタに、アプリケーションの MDI フレームウィンドウに関連付けられているメニューが表示されます。m_pbtutor_sheet は m_pbtutor_frame を継承しているので、フレームメニューに変更を加えると、シートメニューも変更されます。

プレビュービューが開いていない場合は、メニューペインタのメニューバーの［ビュー］メニューから選択できます。

2 m_pbtutor_frame のプレビュービューで［ファイル］メニューをクリックします。

プレビュービューでメニュー項目をクリックすると、そのメニュー項目が実行時と同じように表示されます。

［ファイル］メニューのメニュー項目が表示されない場合プレビュービューを表示するときは［ファイル］メニューが選択されています。そのほかのメニュー（編集、ウィンドウ、またはヘルプ）の 1 つをクリックしてから再び［ファイル］メニューをクリックすると、メニュー項目が表示されることがあります。

3 ［ファイル］メニューの［新規作成］を右クリックします。ポップアップメニューの［メニュー項目テキストの編集］を選択します。「レポート (&R)」と入力して〔Enter〕を押します。

［新規作成］メニュー項目の表示名を［レポート］に変更してください。メニュー名は m_new のまま変更されず、その目的（新しいシートを開きます）も変更されません。

アンパサンド文字を使用したアクセラレータキーの定義アンパサンド（&）の次の文字がアクセラレータキー（ニーモニック）として使用され、プレビュー表示では下線付きで表示されます。アプリケーションの実行時には、〔Alt〕 + 〔F〕 + 〔R〕を押すと、［ファイル｜レポート］メニューにアクセスできます。

4 プロパティビューの［テキスト］テキストボックスに「レポート (&R)」と表示されていることを確認します。



プロパティビューの［ツールバー］タブをクリックします。

ツールバー項目のテキストは、「新規作成 , 新規シート」です。［ピクチャ名］ボックスでは何も選択されていないので、実行時に［レポート］メニュー項目でツールバーボタンは表示されません。［レポート］メニュー項目は、新しいシートを開くコマンドとしてではなく、カスケードメニュー項目にアクセスするために使用するので、ここにツールバーボタンは追加しません。

5 プレビュービューで［ファイル］メニューの［開く］メニュー項目をクリックします。プロパティビューで［全般］タブをクリックします。プロパティビューの［全般］ページで［表示可能］チェックボックスのチェックをはずします。プロパティビューの［全般］ページで［使用可能］チェックボックスのチェックをはずします。

すべての実行時メニューでこの項目を非表示にします。［表示可能］プロパティのチェックをはずすと、プレビュービューで、このメニュー項目が淡色表示されます。実行時には表示されません。

6 プロパティビューの［ツールバー］タブをクリックします。［表示可能］チェックボックスのチェックをはずします。

これで、このメニュー項目のツールバーボタンがフレームメニューのツールバーに表示されなくなります（対応するメニュー項目が表示または有効化されない場合でも、ボタンをツールバーに表示できます）。

7 プレビュービューで、［ファイル］メニューの［終了］をクリックします。

プロパティビューの［ツールバー］ページが開いたままになっていれば、［項目テキスト］および［ピクチャ名］の値が m_exit メニュー項目の値に替わります。

146 PowerBuilder


［ヘルプ］メニュー項目の有効化

［ヘルプ］メニューには 3 つの項目がありますが、有効になっている項目は［バージョン情報］の 1 つだけです。このステップでは、テンプレートアプリケーションウィザードおよび Tutorial ディレクトリ内のpbtutor.hlp ファイルが提供したコメント化コードを使用して、そのほかのメニュー項目を有効にします。

ShowHelp 関数を使用してアプリケーションのヘルプトピックを呼び出し、ヘルプの目次またはインデックスを表示するか、特定のトピックまたはキーワードを表示するかを識別するカタログ値を渡します。ShowHelp は、 Windows のヘルプまたはコンパイルされた HTML ヘルプ（CHM）ファイルを開くことができます。

1 プレビュービューの［ヘルプ］メニューの［目次］メニュー項目をダブルクリックします。

［目次］メニュー項目は使用可能になっていなくてもダブルクリックできます。スクリプトビューに［目次］メニュー項目がフルネームで表示されます。フルネームには、［ヘルプ］メニューであることを示す m_help 接頭辞も含まれます。

2 まだ選択されていない場合は 2 番目のドロップダウンリストボックスで「Clicked」を選択します。

3 ShowHelp 関数を含む行にカーソルを置き、パワーバーの［コメント解除］ボタンをクリックします。次のように myapp.hlp を pbtutor.hlp に変更します。

ShowHelp ("pbtutor.hlp", Index!)

すると、ヘルプファイルにデフォルトトピックが表示されます。

4 プロパティビューの［全般］ページで、 m_helpindex メニュー項目の［使用可能］チェックボックスをオンにします。

5 ［トピックの検索］メニュー項目についても以上の手順を繰り返します。

ShowHelp 呼び出しは次のようになります。

ShowHelp ("pbtutor.hlp", Keyword!, "")

ヘルプファイルのキーワードである文字列がこの呼び出しの 3 番目の引数に含まれている場合は、関連付けられたトピックが表示されます。ここではこの引数が空の文字列なので、トピックの検索ウィンドウが表示されます。



6 PowerBuilder のメインメニューバーの［ファイル｜上書き保存］を選択します。PowerBuilder のメインメニューバーの［ファイル｜閉じる］を選択します。

148 PowerBuilder


シートメニューの新規作成

現在の学習個所フレームメニューの修正

> シートメニューの新規作成ユーザイベントを発生させるメニュースクリプトの追加新規メニューのアタッチとアプリケーションの実行

このステップでは、ユーザが顧客または商品情報を見るために MDIシートを開いたときに表示されるメニューを新規作成します。作成するメニューは、テンプレートアプリケーションウィザードによって生成された m_pbtutor_sheet メニューの子孫オブジェクトです。

m_pbtutor_sheet メニューは m_pbtutor_frame を継承していますが、いくつかのメニュー項目が追加されています。作成するメニューには、先祖メニューにないメニュー項目を追加します。


• 継承される新規メニューの作成および保存

• 新規メニューへのメニュー項目の追加

• 新規メニュー項目のツールバーの追加



継承される新規メニューの作成および保存

アプリケーションのシートメニューから継承すれば、先祖メニューを変更せずにそのシートメニューの特性を保持できます。新しいメニューをただちに保存し、修正した後で再び保存することをお勧めします。

1 パワーバーの［オブジェクトの継承］ボタンをクリックします。

オブジェクトから継承ダイアログボックスが表示されます。

2 ［オブジェクトの種類］ドロップダウンリストボックスで「メニュー」が選択されていることを確認します。［オブジェクト］リストボックスで「m_pbtutor_sheet」を選択して［OK］をクリックします。

m_pbtutor_sheet のすべての性質を備えたタイトル未設定のメニューが表示されます。

継承されたシートメニューでは［ウィンドウ］メニュー項目が有効になっており、 m_pbtutor_sheet メニューの場合と同じようにウィンドウを並べて表示したり、重ねて表示したりすることができます。これらのメニュー項目は m_pbtutor_frame メニューでは無効化されていました。

MDI フレームメニューに対する変更プレビュービューで［ファイル］メニューをクリックすると、 1番目のメニュー項目が［レポート］になっています。［開く］項目は、淡色表示の場合は非表示であることを示し、グレー表示の場合は無効化されていることを示します。これらの性質はm_pbtutor_frame から継承チェーンを通じて伝えられたものです。

3 メニューバーの［ファイル｜上書き保存］を選択します。

メニューの保存ダイアログボックスが表示されます。

4 ［メニュー］ボックスにメニュー名として「m_my_sheet」と入力します。［コメント］ボックスに次のように入力します。

w_master_detail_ancestor および子孫オブジェクトの新しいシートメニュー

150 PowerBuilder



これでメニューに名前が付けられます。m_ はメニューの標準的な接頭辞です。

新規メニューに付けた名前がメニューペインタのワークスペースのタイトルバーに表示され、 m_my_sheet メニューがシステムツリーに表示されます。

新規メニューへのメニュー項目の追加

ここでは、 m_pbtutor_sheet から継承したメニューの［編集］メニューに項目を追加します。プレビューおよびプロパティビューを使用します。

1 新規メニューのプレビュービューで［編集］メニューをクリックします。

アプリケーション実行時と同じように［編集］メニューのメニュー項目のリストが表示されます。［編集］メニューのメニュー項目はすべて表示されますが、無効です（プレビュービューではグレーですがディザ表示にはなっていません）。

2 プレビュービューで［編集］メニューのメニュー項目を右クリックします。ポップアップメニューの［メニュー項目の後に挿入］を選択します。

［編集］メニューのリストの後に表示される空のボックスにカーソルが移動します。

3 ハイフン（-）を入力して〔Enter〕を押します。

ハイフンが区分線に変わります。プロパティビューでは、メニュー項目の名前が m_- に変わります。メニュー項目間の区分線も、名前は一意でなければなりません。メニュー内のほかの区分線には、接頭辞 m_- の後に一意のインデックス番号が付けられます。

4 プロパティビューで新しい区分線の［使用可能］チェックボックスのチェックをはずします。

5 プレビュービューで新しい区分線を右クリックします。ポップアップメニューの［メニュー項目の後に挿入］を選択します。新しい区分線の下に表示されるボックスに「挿入(&I)」と入力し、〔Enter〕を押します。



メニュー項目名の［名前］が自動的に m_ 挿入 i に設定されます。デフォルトの名前が正しくないというメッセージが表示された場合は、かわりの名前が示されます。その場合、示された名前を使用するには［OK］をクリックします。

メニュー項目名を挿入する別の方法プレビュービューではなく、プロパティビューの［テキスト］ボックスに「挿入（&I）」と入力します。この場合、後で〔Enter〕を押す必要はありません。ただし、［名前］ボックスがグレー表示になっている場合は、まず［項目名固定］チェックボックスをオフにする必要があります。そうしないとメニュー名は m_ 挿入 i にリセットされません。

6 プロパティビューの［マイクロヘルプ］ボックスに「行の挿入」と入力します。

デフォルトでは、新規メニュー項目は表示され、有効になります。

ユーザがこのメニュー項目を選択すると、アプリケーションウィンドウの一番下の［マイクロヘルプ］行に「行の挿入」というテキストが表示されます。

7 以下のメニュー項目について、手順 5 と 6 を繰り返します。

メニュー項目マイクロヘルプテキスト

更新 (&A) データベースを更新

削除 (&D) 現在の行を削除

152 PowerBuilder


［編集］メニューに、データベースのレコードの更新および削除のためのメニュー項目を追加します。有効化されてはいませんが、文字 U はすでにメニュー項目［元に戻す］のアクセラレータキーとして使用されているので、メニュー項目［更新］に同じアクセラレータキーを使用しないでください。かわりに文字 A を使用します。



新規メニュー項目のツールバーの追加

ここでは、さきほど定義したメニュー項目に対するツールバーボタンを追加し 2 番目のツールバーに配置します。

1 プレビュービューの［編集］メニューの新しい［挿入］メニュー項目をクリックします。

2 プロパティビューの［ツールバー］タブをクリックします。［項目テキスト］ボックスに「挿入」と入力します。［ピクチャ名］ドロップダウンリストボックスで「Insert!」と入力または選択します。

これで Insert! という組み込みピクチャを使用する［挿入］メニュー項目のツールバーボタンが定義されます。実行時のアプリケーションでツールバーに対して［テキストの表示］オプションが有効になっていると、「挿入」というテキストがボタンの上に表示されます。

3 ［項目の間隔］スピンコントロールに「1」と入力します。［項目の順序］スピンコントロールに「1」と入力します。［項目インデックス］スピンコントロールに「2」と入力します。

追加されたメニュー項目用の新しいツールバーを作成し、［挿入］ボタンをこのツールバーの初の項目にします。

4 プレビュービューの［編集］メニューの［更新］メニュー項目をクリックします。プロパティビューでも選択されていることを確認します。

5 まだ［ツールバー］ページを開いていない場合は［ツールバー］タブをクリックします。［項目テキスト］ボックスに「更新」と入力します。［ピクチャ名］ドロップダウンリストボックスで「Update!」を入力または選択します。

これで、 Update! という組み込みピクチャを使用する［更新］メニュー項目のツールバーボタンが定義されます。ボタンのテキストは「更新」です。

6 ［項目の順序］スピンコントロールに「2」と入力します。［項目インデックス］スピンコントロールに「2」と入力します。

154 PowerBuilder


新規ツールバーの［挿入］ボタンの後に［更新］ボタンを追加します。

7 プレビュービューで［編集］メニューの新規［削除］メニュー項目をクリックします。プロパティビューでも同じメニュー項目が選択されていることを確認します。

8 まだ［ツールバー］ページを開いていない場合は［ツールバー］タブをクリックします。［項目テキスト］ボックスで「削除」と入力します。［ピクチャ名］ドロップダウンリストボックスで「DeleteRow!」を入力または選択します。

これで、DeleteRow! という組み込みピクチャを使用する［削除］メニュー項目のツールバーボタンが定義されます。ボタンのテキストは「削除」です。

9 ［項目の順序］スピンコントロールに「3」と入力します。［項目インデックス］スピンコントロールに「2」と入力します。

新規ツールバーの［更新］ボタンの後に［削除］ボタンを追加します。

10 PowerBuilder メニューバーの［ファイル｜上書き保存］を選択します。


ユーザイベントを発生させるメニュースクリプトの追加

ユーザイベントを発生させるメニュースクリプトの追加

現在の学習個所フレームメニューの修正シートメニューの新規作成

> ユーザイベントを発生させるメニュースクリプトの追加新規メニューのアタッチとアプリケーションの実行

このステップでは、シートウィンドウのメニューバーからユーザイベントを発生させるスクリプトを追加します。これらのユーザイベントはレッスン 5「先祖ウィンドウの変更」で追加したものです。メニューペインタでは、 m_my_sheet メニューがまだ開いているはずです。開いていない場合は、パワーバーの［開く］ボタンを使用して開きます。

1 スクリプトビューの初のリストボックスで「m_edit.m_ 挿入 i」を選択します。またはプレビュービューの［挿入］メニュー項目をダブルクリックします。

スクリプトビューに［挿入］メニュー項目がフルネームで表示されます。フルネームには、［編集］メニューであることを示す m_edit接頭辞も含まれます。

2 まだ選択されていない場合は 2 番目のドロップダウンリストボックスで「Clicked」を選択します。Clicked イベントに以下の行を入力します。

w_master_detail_ancestor lw_activesheetlw_activesheet = w_pbtutor_frame.GetActiveSheet()lw_activesheet.EVENT ue_insert()

初の 2 行では、現在 MDI フレーム内のどのシートがアクティブであるかを判定します。 3 行目では、アクティブシートに対してユーザイベント ue_insert が発生します。

156 PowerBuilder


3 以下のメニュー項目およびスクリプトを使用して、手順 1 と 2 を繰り返します。

4 PowerBuilder メニューバーの［ファイル｜上書き保存］を選択します。

メニュースクリプトがコンパイルされ、保存されます。

5 ペインタバー 1 の［閉じる］ボタンをクリックします。またはPowerBuilder メニューバーの［ファイル｜閉じる］を選択します。

メニュー名 Clicked イベントのスクリプト

m_edit.m_ 更新 a w_master_detail_ancestor lw_activesheetlw_activesheet = w_pbtutor_frame.GetActiveSheet()lw_activesheet.EVENT ue_update()

m_edit.m_ 削除 d w_master_detail_ancestor lw_activesheetlw_activesheet = w_pbtutor_frame.GetActiveSheet()lw_activesheet.EVENT ue_delete()


新規メニューのアタッチとアプリケーションの実行


現在の学習個所フレームメニューの修正シートメニューの新規作成ユーザイベントを発生させるメニュースクリプトの追加

> 新規メニューのアタッチとアプリケーションの実行

このステップでは、新規シートメニューをアタッチして、もう一度アプリケーションを実行します。

1 システムツリーで w_master_detail_ancestor をダブルクリックします。

ウィンドウペインタのプロパティビューの［メニュー名］ボックスにリストされているメニューはまだ m_pbtutor_sheet です。

プロパティビューが表示されていない場合メニューバーの［ビュー｜プロパティ］を選択します。

2 プロパティビューの［メニュー名］ボックスの隣の参照（［...］）ボタンをクリックします。

オブジェクト選択ダイアログボックスが表示されます。

3 ［メニュー］リストボックスで「m_my_sheet」を選択して［OK］をクリックします。

これは m_pbtutor_sheet から継承した後で変更したシートメニューです。これでプロパティビューでメニューとしてリストされます。

4 ペインタバー 1 の［保存］ボタンをクリックします。パワーバーの［実行］ボタンをクリックします。

アプリケーションログインウィンドウが表示されます。

5 ［ユーザ ID］ボックスに「dba」と入力します。［パスワード］ボックスに「sql」と入力して、［OK］ボタンをクリックします。

データベースとの接続が確立され、アプリケーションの MDI フレームが開きます。［ファイル］メニューには、［新規作成］メニュー項目のかわりに［レポート］カスケードメニューが表示されます。［開く］メニュー項目は表示されなくなっています。

158 PowerBuilder


6 メニューバーの［ファイル｜レポート｜顧客情報］を選択します。

2 番目のツールバーが表示され、［編集］および［ウィンドウ］カスケードメニューに使用可能なメニュー項目が表示されていることに注意してください。

7 ［編集］メニューを選択します。

［編集］メニューには、追加した［挿入］、［更新］、［削除］オプションがあります。顧客情報ウィンドウのデータウィンドウコントロールにはデータウィンドウオブジェクトが関連付けられていないので、これらのオプションはまだ機能しません。

8 ［ウィンドウ］メニューを選択します。

開いたシートに対応する新規メニュー項目が追加されています。

9 メニューバーの［ファイル｜レポート｜商品情報］を選択します。

2 番目の MDI シートが開きます。このシートは 1 番目のシートに重なるようにして表示されます。メニューバーは変更されません。これは m_my_sheet が w_customers と w_products の両方のメニューであるためです。

10 ［編集］メニューを選択します。

w_products ウィンドウは m_my_sheet メニューを使用するので、商品管理ウィンドウが開いているときに［挿入］、［更新］、［削除］オプションも利用できます。

11 ［ウィンドウ］メニューを選択します。

開いた 2 番目のシートに対応するメニュー項目が追加されています。このメニュー項目の隣にチェックマークが表示され、アクティブなシートであることが示されます。

12 メニューバーの［ファイル｜終了］を選択します。

アプリケーションが終了し、ウィンドウペインタのワークスペースに戻ります。




160 PowerBuilder

レッスン 7 データウィンドウオブジェクトの作成

データウィンドウオブジェクトは、 PowerBuilder のもっとも強力で有用な機能の 1 つです。データウィンドウオブジェクトは、データベースと接続してデータを読み込み、さまざまな提示様式でデータを表示します。また、データベースを更新することもできます。


• データウィンドウオブジェクトの新規作成とプレビュー

• 1 つめのデータウィンドウオブジェクトの表示の変更

• 2 つめのデータウィンドウオブジェクトの作成

• 2 つめのデータウィンドウオブジェクトの表示の変更



About this lesson

データウィンドウオブジェクトの新規作成とプレビュー

現在の学習個所> データウィンドウオブジェクトの新規作成とプレビュー

データウィンドウオブジェクトの保存1 つめのデータウィンドウオブジェクトの表示の変更2 つめのデータウィンドウオブジェクトの作成2 つめのデータウィンドウオブジェクトの表示の変更

このステップでは、データウィンドウオブジェクトを新規作成して、データウィンドウペインタに表示します。ほかのペインタと同様に、データウィンドウペインタには、同時に開くことができるさまざまなビューがあります。

データウィンドウペインタのデザインビューについてデータウィンドウペインタのデザインビューは、ほかのペインタのレイアウトビューと似ています。一度に表示できるデザインビューは 1つだけです。

デザインビューは、ヘッダ、詳細、サマリ、およびフッタの 4 つの「区域」と呼ばれる領域に分かれています。これらの区域の内容は変更することができます。たとえば、サイズの変更や、オブジェクト（コントロール、テキスト、線、ボックス、楕円）の追加、色やフォントの変更を行うことができます。

データウィンドウペインタのプレビュービューでは、実行時におけるアプリケーションでのオブジェクトの表示をテーブルデータが挿入された状態で見ることができます。



2 ［データウィンドウ］タブをクリックします。提示様式のリストで「タブラ」を選択して［OK］をクリックします。

データウィンドウウィザードのタブラデータウィンドウのためのデータソースの選択ページが表示されます。

3 データソースとして「Quick Select」を選択します。［プレビュー時に検索する］チェックボックスをオンにします。［次へ］をクリックします。

162 PowerBuilder


EAS Demo DB データベースに接続し、Quick Select ダイアログボックスが表示されます。

4 ［テーブル］リストボックスで「customer （顧客情報テーブル）」をクリックします。

テーブルが開き、カラムが一覧表示されます。このデータウィンドウでは 4 つのカラムを選択します。

5 ［カラム］リストボックスで「id」、「lname」、「fname」を、並んでいる順にクリックします。リストをスクロールして「company_name」をクリックします。

Quick Select ダイアログボックスの下のグリッドに、選択したカラムが表示されます。

選択する順序で表示される順序が決まります各カラムは、選択した順に、データウィンドウオブジェクト内で左から右へ表示されます。誤ってカラムをクリックした場合は、もう一度クリックすると選択を取り消すことができます。


データウィンドウオブジェクトの新規作成とプレビュー

ダイアログボックスの下のグリッド領域を使用して、ソート条件（SQL ORDER BY 句の場合）や選択条件（SQL WHERE 句の場合）を指定できます。ここではソート条件だけを指定します。 id カラムを昇順にソートします。

6 Quick Select ダイアログボックスのグリッド領域で、［ソート］の横、［Id］の下のセルをクリックします。

ドロップダウンリストボックスが表示されます。

7 2 番目のドロップダウンリストボックスで「昇順」を選択します。

これで id カラムを昇順でソートするように指定されます。


データウィンドウウィザードから、新規データウィンドウオブジェクトの色と境界を選択するように求められます。デフォルトでは、テキストまたはカラムの境界はありません。


境界と色のデフォルト設定値を使用します。データウィンドウウィザードにより、選択した値が集約されます。


新規データウィンドウオブジェクトが作成され、データウィンドウペインタが開きます。

デザインビューに、デフォルトのヘッダが付いたヘッダ区域と、選択したカラムのある詳細区域がそれぞれ表示されます。

164 PowerBuilder


プレビュービューでは、実行時に表示されるものと同じデータウィンドウが表示されます。すべての顧客のデータが表示されます。データは、指定したとおり、顧客 ID で昇順にソートされます。

プレビュービューの表示プレビュービューが表示されていない場合は、メニューバーから［ビュー｜プレビュー］を選択します。［プレビュー］がグレー表示の場合は、すでに表示されているので選択できません。一度に表示できるプレビュービューは 1 つだけです。


データウィンドウオブジェクトの保存


現在の学習個所データウィンドウオブジェクトの新規作成とプレビュー

> データウィンドウオブジェクトの保存1 つめのデータウィンドウオブジェクトの表示の変更2 つめのデータウィンドウオブジェクトの作成2 つめのデータウィンドウオブジェクトの表示の変更

このステップでは、データウィンドウオブジェクトに名前を付けて、pbtutor.pbl ライブラリに保存します。

別のライブラリへの保存オブジェクトは別のアプリケーションライブラリに保存することができますが、複雑にならないようにするために、新規チュートリアルオブジェクトはすべて同一のライブラリに保存します。また、ライブラリペインタを使用すると、ライブラリ間でオブジェクトをコピーしたり、移動したりすることもできます。


データウィンドウの保存ダイアログボックスが表示され、［データウィンドウ］ボックスに挿入ポイントが示されます。

2 ［アプリケーションライブラリ］ボックスで「pbtutor.pbl」が選択されていることを確認します。［データウィンドウ］ボックスに「d_custlist 」と入力します。

これで、データウィンドウオブジェクトに名前が付けられます。「d_」はデータウィンドウオブジェクトの標準の接頭辞です。


このデータウィンドウオブジェクトは顧客名とその会社名を検索します。


データウィンドウオブジェクトが保存され、データウィンドウの保存ダイアログボックスが閉じます。

166 PowerBuilder


1 つめのデータウィンドウオブジェクトの表示の変更

現在の学習個所データウィンドウオブジェクトの新規作成とプレビューデータウィンドウオブジェクトの保存

> 1 つめのデータウィンドウオブジェクトの表示の変更2 つめのデータウィンドウオブジェクトの作成2 つめのデータウィンドウオブジェクトの表示の変更

ここでは、データウィンドウの表示を変更します。カラムとカラム見出しを移動して、現在選択されている行の左にハンドポインタを表示するスペースを作ります。また、一部のカラムを移動して見出しと揃うようにします。

これらの変更作業はデザインビューで行います。同時にプレビュービューを開いておけば、変更した結果、実行時にデータウィンドウがどのように表示されるかを確認できます。

1 メニューバーの［編集｜選択｜すべて選択］を選択します。または〔Ctrl〕 + 〔A〕を押します。

データウィンドウオブジェクト内のすべてのコントロールがデザインビューで選択されます。

2 選択したオブジェクトの 1 つにマウスポインタを移動します。右に 4 cm ほど、オブジェクトをドラッグします。

選択されているすべてのオブジェクトがいっしょに移動します。

3 デザインビューで、空白の領域をクリックします。

オブジェクトの選択が解除されます。

4 ヘッダ区域の上の［顧客 ID］ヘッダをクリックします。〔Ctrl〕を押したまま［id］カラムをクリックします。左に 2.5 cm ほど［id］カラムをドラッグします。

カラムとそのヘッダがいっしょに移動します。



5 スタイルバーの［中央揃え］ボタンをクリックします。デザインビューで、空白の領域をクリックします。

カラムヘッダのテキストとカラムデータの中央揃えを行ってから、オブジェクトの選択を解除します。

6 ［姓］ヘッダをクリックします。〔Ctrl〕を押したまま［名］および［会社名］ヘッダをクリックします。スタイルバーの［左寄せ］ボタンをクリックします。

操作を完了すると、デザインビューは次の図のようになるはずです。

7 メニューバーから［ファイル｜閉じる］を選択します。

変更内容を保存するかどうかを確認するメッセージボックスが表示されます。


データウィンドウオブジェクトが保存され、データウィンドウペインタが閉じます。

168 PowerBuilder


2 つめのデータウィンドウオブジェクトの作成

現在の学習個所データウィンドウオブジェクトの新規作成とプレビューデータウィンドウオブジェクトの保存1 つめのデータウィンドウオブジェクトの表示の変更

> 2 つめのデータウィンドウオブジェクトの作成2 つめのデータウィンドウオブジェクトの表示の変更

1 つめのデータウィンドウオブジェクトを作成したときには、 QuickSelect を使用してテーブルとカラムを指定しました。 Quick Select を使用すると、 Select ペインタを使用しないですべての顧客を検索できます。

2 つめのデータウィンドウオブジェクトの作成では、 Select ペインタを使用します。実行時に引数をデータウィンドウオブジェクトに渡すために、検索引数と WHERE 条件を定義する必要があります。ここでは、顧客 ID を渡します。

ここでは以下の内容について学習します。

• データソースおよびスタイルの選択

• テーブルとカラムの選択

• 検索引数の定義

• WHERE 句の指定

• データウィンドウペインタでのデータウィンドウの表示

• データウィンドウオブジェクトの保存

データソースおよびスタイルの選択

ここでは、データソースを選択して、データの表示方法を指定します。



2 まだ選択していない場合は、［データウィンドウ］タブをクリックします。提示様式のリストで「フリーフォーム」を選択して［OK］をクリックします。



3 データソースとして［SQL Select］を選択します。［プレビュー時に検索する］チェックボックスをオンにします。［次へ］をクリックします。

データソースが［SQL Select］なので、 Select ペインタに移動します。テーブルの選択ダイアログボックスが表示されます。

［プレビュー時に検索する］チェックボックスをオンにすると、開発環境でクエリによって返されたデータを表示できますが、指定するすべての検索引数に初期値を与える必要があります。

テーブルとカラムの選択

ここでは、データウィンドウオブジェクトで使用するテーブルとそのテーブル内のカラムを選択します。

1 ［テーブルの選択］リストで「customer」を選択して［開く］をクリックします。

Select ペインタに、customer テーブルとそのテーブルのカラムが表示されます。

別の方法customer テーブルを選択して［開く］をクリックするかわりに、customer テーブルをダブルクリックした場合は、テーブルの選択ダイアログボックスは開いたままになります。この場合、次の操作に進むには［キャンセル］をクリックする必要があります。

2 テーブルレイアウトビューで、 customer テーブルのヘッダ領域を右クリックします。ポップアップメニューで［すべて選択］をクリックします。

テーブルレイアウトビューでテーブルの上の［選択リスト］領域にカラム名が表示されます。

［選択リスト］内でのカラムの順序は、カラムを選択した順序になります。一度にすべてのカラムを選択した場合は、データベース内でのカラムの元の順序で表示されます。カラムの表示順序は後で変更します。

170 PowerBuilder


Syntax ビューでは、選択の順序を確認することもできます。Syntaxビューを表示するには、タブウィンドウの一番下にある［Syntax］タブをクリックします。 Syntax ビューに、生成された Select 文が表示されます。

検索引数の定義

ここでは、検索引数を定義します。

1 メニューバーの［デザイン｜検索引数］を選択します。

検索引数の指定ダイアログボックスが表示されます。

2 ［名前］ボックスに「cust_id」と入力します。

デフォルトのデータ型は「Number」で、これを使用します。



検索引数名について使用する検索引数にはどのような名前を付けてもかまいません。これは、実行時に渡す値のプレースホルダにすぎません。ただし、意味のある名前を使用するようにしたほうがよいでしょう。


検索引数が定義されます。

WHERE 句の指定

ここでは、特定の顧客を検索するために検索引数を使用して WHERE句を指定します。

1 ［Where］タブをクリックします。

Where ビューが表示されます。

2 Where ビューで、［カラム名］の下のボックスをクリックします。

下矢印が表示され、ボックスがドロップダウンリストボックスになります。

3 下矢印をクリックします。「"customer"."id"」を選択します。

カラム見出しのすぐ下に「"customer"."id"」が表示されます。［演算子］ボックスに等号（=）が表示されます。この演算子は正しいので、変更の必要はありません。

4 Where ビューで、［値］のカラムヘッダの下のボックスを右クリックします。

172 PowerBuilder


ポップアップメニューから［引数］を選択し、「:cust_id」を選択して、［貼り付け］をクリックします。

5 ［Syntax］タブをクリックします。

Syntax ビューに、修正した SELECT 文が表示されます。

6 スクロールして、生成された WHERE 句を表示します。

これで、完全な SQL SELECT 文が作成されました。この文は、実行時に指定される引数に等しい id カラムがある顧客情報テーブルの複数のカラムからデータを検索します。

データウィンドウペインタでのデータウィンドウの表示

ここでは、デザインビューとプレビュービューを使用してデータウィンドウペインタでデータウィンドウを表示します。

1 ペインタバーの［ペインタに戻る］ボタンをクリックします。またはメニューバーの［ファイル｜データウィンドウペインタに戻ります］を選択します。

データウィンドウウィザードにより、新規データウィンドウオブジェクトの枠線と色を選択するように求められます。

2 カラムの［枠線］ドロップダウンリストボックスで「3D 凸表示」を選択します。［次へ］をクリックします。

カラムには盛り上がった枠線が付きますが、データウィンドウオブジェクトのラベルには付きません。データウィンドウウィザードにより、選択した値が集約されます。




［プレビュー時に検索する］チェックボックスをオンにしており、データウィンドウペインタのデフォルトのレイアウトにプレビューが含まれているため、検索引数の指定ダイアログボックスが表示されます。

このダイアログボックスでは、引数値の入力が求められます。このデータウィンドウオブジェクトをチュートリアルアプリケーションに入れると、必要な引数をデータウィンドウオブジェクトに渡すスクリプトが自動的に記述されます。

4 ［値］フィールドに顧客 ID （101、 102、 103 など）を入力します。［OK］をクリックします。

174 PowerBuilder


データウィンドウペインタが開きます。デザインビューに新しいデータウィンドウオブジェクトが表示されます。

フォントサイズの変更ラベルの文字がすべて見えない場合は、〔Ctrl〕 + 〔A〕を押してデータウィンドウ内のすべての項目を選択してから、スタイルバーで小さいフォントサイズを選択します。



要求された顧客データがデータウィンドウプレビュービューで検索されます。

ほかのレコードの検索ほかの顧客のレコードをプレビューする場合は、データウィンドウプレビュービューを右クリックして、ポップアップメニューの［データ検索］を選択し、検索引数の指定ダイアログボックスで別の顧客 ID を指定します。


ここではデータウィンドウオブジェクトに名前を付けて保存します。ペインタを終了するまで保存しないでおくこともできますが、頻繁に作業内容を保存するようにするのが適切です。


データウィンドウの保存ダイアログボックスが表示されます。

2 ［アプリケーションライブラリ］ボックスで「pbtutor.pbl」が選択されていることを確認します。［データウィンドウ］ボックスに「d_customer」と入力します。

以前は、データウィンドウオブジェクトを d_custlist という名前で保存しました。

176 PowerBuilder



このデータウィンドウは、顧客情報テーブルのすべてのカラムを検索します。詳細データウィンドウとして使うと便利です。


データウィンドウペインタに戻ります。




現在の学習個所データウィンドウオブジェクトの新規作成とプレビューデータウィンドウオブジェクトの保存1 つめのデータウィンドウオブジェクトの表示の変更2 つめのデータウィンドウオブジェクトの作成

> 2 つめのデータウィンドウオブジェクトの表示の変更

ここでは、データウィンドウオブジェクトを修正します。このレッスンでは、以下の項目について学習します。

• カラムとラベルの再配置

• ラベルとカラムの整列

• ドロップダウンデータウィンドウ編集スタイルの矢印の表示

フリーフォームデータウィンドウのカラムフリーフォームデータウィンドウオブジェクトのデータフィールドは、テーブル形式ではありませんが、カラムと呼ばれます。

カラムとラベルの再配置

ここでは、新規データウィンドウオブジェクトのカラムとラベルを再配置します。デザインビューを大化すると、カラムとラベルを非常に操作しやすくなります。

1 デザインビューで「郵便番号」ラベルをクリックします。〔Ctrl〕を押したまま、 zip カラムをクリックします。

2 つの項目が選択されます。

2 〔Ctrl〕を押したまま、以下のカラムラベルとカラムコントロールをクリックします。

ラベルカラム

郵便番号 : zip

都道府県 : state市区 : city

町村番地 : address

178 PowerBuilder


3 〔Ctrl〕を放します。選択されているオブジェクトの 1 つにカーソルを置き、データウィンドウオブジェクトの右上隅にドラッグします。

すべてのオブジェクトがいっしょに移動します。

4 この〔Ctrl〕を押したままクリックする方法を使用して、以下のラベルおよびカラムコントロールを示された位置に移動します。

必要であれば、スクロールしてデータウィンドウ内にすべてのカラムが表示されるようにします。

5 詳細区域を後のカラムラベルの下へドラッグします。

詳細区域に余分なスペースがあれば削除します。

フィールドどうしが重なる場合があります。その場合の修正は、次の練習で行います。デザインビューでは、データウィンドウが次のように表示されるはずです。

データウィンドウプレビュービューは、次のようになります。

ラベルカラムコントロール移動先

［会社名］ company_name ［Fname Yomi:］の下

［電話番号］ phone ［会社名］の下



ラベルとカラムの整列

ここでは、新規データウィンドウでラベルとカラムを整列します。

1 デザインビューで［町村番地］ラベルを選択します。［町村番地］ラベルを lname_yomi カラムのできるだけ近くに移動します。

ラベルボックスの左端とカラムボックスの右端に小さなスペースが残るくらいに間を詰めます。

2 ［町村番地］ラベルが選択されている状態で、〔Ctrl〕 + クリックを使用して［郵便番号］、［都道府県］、および［市区］ラベルを選択します。

3 メニューバーの［書式｜オブジェクトの配置］を選択します。

整列オプションのカスケードメニューが表示されます。

4 1 つめのオプション（［左端］）を選択します。

選択したオブジェクトの左端が、選択した 1 つめの項目（［町村番地］ラベル）の左端に揃えられます。

ペインタバーからの整列ツールの選択ペインタバー 2 の［配置］ボタンをクリックすると、整列ツールのドロップダウンリストにアクセスできます。

5 address のカラムを［町村番地］ラベルのすぐ横に移動します。カラムラベルのときと同じようにして、zip、state、city カラムを addressカラムに揃えます。

180 PowerBuilder


ドロップダウンデータウィンドウ編集スタイルの矢印の表示

顧客の State カラムにはデータウィンドウ編集スタイルがあります。これは EAS Demo DB データベースの State カラムに関連付けられている拡張属性です。 State カラムが関連付けられている（ドロップダウン）データウィンドウには、 State と 2 文字のコードのリストがあります。

State の選択リストがアプリケーションで常に表示されるようにしたり、選択リストが利用可能であることを示す矢印を常に表示されるようにしたりすることができます。ここでは、 State カラムのプロパティを変更して、矢印が常に表示されるようにします。

1 デザインビューで State カラムをクリックします。プロパティビューが表示されることを確認します。

このプロパティビューにはカラムのプロパティが表示されます。

2 プロパティビューで［編集］タブをクリックします。

［編集］タブが見えない場合は、プロパティビューの一番上近くにある矢印キーをクリックしてください。［様式の種類］で「ドロップダウンデータウィンドウ」が選択されていることを確認します。

3 ［矢印を常時表示］チェックボックスをオンにします。デザインビューの State カラムが、矢印プラス 2 文字を表示できる幅であることを確認します。

デザインビューおよびプレビュービューで、State カラムの横に矢印が表示されます。




182 PowerBuilder

レッスン 8 データウィンドウオブジェクトのアタッチ

データウィンドウオブジェクトを作成して保存すると、データウィンドウオブジェクトをウィンドウで使用できるようになります。すでに d_custlist および d_customer というデータウィンドウオブジェクトを作成しました。ここでは、これらのデータウィンドウオブジェクトを、 w_customers ウィンドウ内のデータウィンドウコントロールに関連付けます。


• マスターデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ

• 詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ


• 商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチ

• アプリケーションの再実行



マスターデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ


現在の学習個所> マスターデータウィンドウコントロールへのデータウィンドウオブジェ

クトのアタッチ詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチアプリケーションの実行商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチアプリケーションの再実行

このステップでは、データウィンドウオブジェクトを w_customersウィンドウ上のデータウィンドウコントロールにアタッチします。

1 システムツリーで pbtutor.pbl ツリー項目を展開します。

184 PowerBuilder


2 w_customers を右クリックして、ポップアップメニューから［編集］を選択します。またはシステムツリーで w_customers をダブルクリックします。

ウィンドウペインタに w_customers ウィンドウが表示されます。

3 レイアウトビューで dw_master データウィンドウコントロールを右クリックします。ポップアップメニューで［プロパティ］をクリックします。プロパティビューで［データオブジェクト］ボックスの隣の参照（［...］）ボタンをクリックします。


4 ［データウィンドウ］リストボックスで「d_custlist」を選択して［OK］をクリックします。

d_custlist データウィンドウオブジェクトと dw_master データウィンドウコントロールが関連付けられます。

レイアウトビューで、 dw_master コントロール内に d_custlist データウィンドウの見出しが表示されていますが、データはまだ表示されていません。アプリケーションを実行するまでは、データウィンドウは SELECT 文を実行しません。



ドラッグアンドドロップを使用してのウィンドウへのデータウィンドウオブジェクトの追加このチュートリアルでは、エラー処理が組み込まれたカスタムデータウィンドウコントロールを使用します。標準的なデータウィンドウコントロールを使用したい場合は、このレッスンで行ったようにウィンドウにコントロールを追加してからデータウィンドウオブジェクトをアタッチする必要はありません。システムツリーでデータウィンドウオブジェクトを選択し、レイアウトビュー内のウィンドウ上にドラッグするだけで済みます。すると、データウィンドウコントロールが自動的に作成されます。

186 PowerBuilder


詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ

現在の学習個所マスターデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ

> 詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチアプリケーションの実行商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチアプリケーションの再実行

このステップでは、詳細データウィンドウコントロールへデータウィンドウオブジェクトをアタッチします。ウィンドウペインタでは、まだ w_customers ウィンドウが開いているはずです。

1 レイアウトビューで「dw_detail」コントロールを選択します。プロパティビューで［データオブジェクト］ボックスの隣の参照（［...］）ボタンをクリックします。オブジェクト選択ダイアログボックスで「d_customer」を選択して［OK］をクリックします。

d_customer データウィンドウオブジェクトと dw_detail データウィンドウコントロールが関連付けられます。ウィンドウペインタのワークスペースでは、 dw_detail コントロール内に d_customer データウィンドウオブジェクトが表示されます。

2 レイアウトビューで、データウィンドウオブジェクトに追加したすべてのカラムを表示できるように dw_detail コントロールを拡大します。


詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ

必要であれば、ウィンドウも拡大します。 dw_detail コントロールを拡大する場合、 dw_master コントロールも同じ幅にします。

188 PowerBuilder



現在の学習個所マスターデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ

> アプリケーションの実行商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチアプリケーションの再実行

このステップでは、アプリケーションをもう一度実行して、 2 つめのデータウィンドウの挿入、更新、および削除機能をテストします。




アプリケーションが実行され、ログインウィンドウが表示されます。


データベースとの接続が確立され、アプリケーションの MDI フレームが開きます。

4 メニューバーから［ファイル｜レポート｜顧客情報］を選択します。



顧客情報ウィンドウが表示されます。

上部のデータウィンドウコントロール（dw_master）には Customerテーブルから検索されたすべての行が表示され、ハンドポインタはどの行が選択されているかを示します。

下部のデータウィンドウコントロール（dw_detail）には、選択した顧客についての詳細情報が表示されています。

5 ツールバーの［挿入］ボタンをクリックします。またはメニューバーの［編集｜挿入］を選択します。

これで dw_detail データウィンドウがクリア（リセット）され、新しい行がデータウィンドウに追加されます。カーソルが dw_detailコントロールの［顧客 ID］ボックスに置かれます。

6 詳細データウィンドウのボックスに情報を入力して、新しい顧客行を追加します。

190 PowerBuilder


新しい顧客の情報の入力［顧客 ID］の番号は一意でなければなりません。値が重複しないようにするために、新しいデータベースエントリに 4 桁の値を使用するか、マスターデータウィンドウの顧客のリストをスクロールしてリストに表示されていない ID 番号を選択します。

電話番号と郵便番号では、入力する情報を表示するのにエディットマスクを使用します。これらのデータフィールドには数値だけを入力する必要があります。顧客の都道府県を指定するには、都道府県のカラムの隣の矢印をクリックしてドロップダウンリストボックスからエントリを選択する必要があります。

データベースで NULL 値を使用できるのは「会社名」フィールドだけです。そのほかのすべてのフィールドでは、新しい顧客の［更新］ボタンをクリックする前に、値を入力しなければなりません。

7 ツールバーの［更新］ボタンをクリックします。またはメニューバーの［編集｜更新］を選択します。

これで ue_update イベントのスクリプトでコーディングされたとおりに、新しい顧客のデータがデータベースに送られ、確認メッセージが表示されます。

新しい顧客はまだマスターデータウィンドウに表示されません（この機能が含まれるようにコードを追加することもできます）。ただし、 w_customers シートのほかのインスタンスを開くと、新しい顧客のデータは、マスターおよび詳細データウィンドウコントロールの両方で表示されます。

8 メッセージボックスで［OK］をクリックします。マスターデータウィンドウで顧客をクリックします。

その顧客のデータが下のデータウィンドウに表示されます。

9 詳細データウィンドウで顧客の住所を変更します。

10 ツールバーの［更新］ボタンをクリックします。またはメニューバーの［編集｜更新］を選択します。

これで、変更した顧客データがデータベースに送られ、別の確認メッセージが表示されます。



11 メッセージボックスで［OK］をクリックします。マスターデータウィンドウでほかの顧客を選択します。

詳細データウィンドウにその顧客のデータが表示されます。

12 ツールバーの［削除］ボタンをクリックします。またはメニューバーの［編集｜削除］を選択します。

データウィンドウからはその顧客がただちに削除されますが、［編集］メニューの［更新］オプションを選択しない限り、データベースからは削除されません。その場合、 EAS Demo DB データベースのほかのテーブルの行が削除しようとしている行を参照していると、更新処理が失敗することがあります。

自分でデータベースに追加した行はすべて削除できます。


アプリケーションが終了し、ウィンドウペインタに戻ります。


192 PowerBuilder


商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチ

現在の学習個所マスターデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチアプリケーションの実行

> 商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチアプリケーションの再実行

このステップでは、 w_products ウィンドウに 2 つのデータウィンドウオブジェクトを追加します。これらのデータウィンドウオブジェクトは、 tutor_pb.pbl ライブラリに用意されています。

1 システムツリーの w_products を右クリックして、ポップアップメニューから［編集］を選択します。またはシステムツリーで w_products をダブルクリックします。

ウィンドウペインタに w_products ウィンドウが表示されます。

2 コントロールリストビューで dw_master データウィンドウコントロールを選択します。プロパティビューで［データオブジェクト］ボックスの隣の参照（［...］）ボタンをクリックします。


3 ［アプリケーションライブラリ］ボックスで「tutor_pb.pbl」を選択します。［データウィンドウ］ボックスで「d_prodlist」を選択して［OK］をクリックします。

ウィンドウペインタのプロパティビューの［データオブジェクト］ボックスに、 d_prodlist が表示されます。


商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチ

d_prodlist データウィンドウオブジェクトと、 w_products ウィンドウ内の dw_master データウィンドウコントロールとが関連付けられます。レイアウトビューで、データウィンドウオブジェクトの見出しが表示されます。コントロールまたはウィンドウのサイズ変更が必要な場合もあります。

4 コントロールリストビューで dw_detail データウィンドウコントロールをクリックします。プロパティビューで［データオブジェクト］ボックスの隣の参照（［...］）ボタンをクリックします。


5 ［アプリケーションライブラリ］ボックスで「tutor_pb.pbl」を選択します。［データウィンドウ］リストボックスで「d_product」を選択して［OK］をクリックします。

ウィンドウペインタに戻ります。

d_product データウィンドウオブジェクトと dw_detail データウィンドウコントロールが関連付けられます。レイアウトビューでは、 dw_detail コントロール内に d_product データウィンドウオブジェクトが表示されます。 d_product データウィンドウオブジェクトには、「商品 ID」、「商品名」、「商品内容」、「サイズ」、「色」、「在庫数」、および「単価」というラベルの付いた 7 つのカラムがあります。

必要であれば、レイアウトビューでデータウィンドウオブジェクト内のすべてのカラムを表示できるように dw_detail コントロールを拡大します。また、ウィンドウを拡大することもできます。

194 PowerBuilder


アプリケーションの再実行

現在の学習個所マスターデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチアプリケーションの実行商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチ

> アプリケーションの再実行

このステップでは、もう一度アプリケーションを実行して、商品管理ウィンドウをテストします。

この時点で、商品管理ウィンドウには顧客情報ウィンドウのすべての機能が備わっています。顧客情報ウィンドウと同様に、商品管理ウィンドウは、データベースに対する検索、挿入、更新、および削除操作のサポートを提供するマスター / 詳細ウィンドウとして機能します。




アプリケーションが実行され、ログインウィンドウが表示されます。

3 ［ユーザ ID］テキストボックスに「dba」と入力します。［パスワード］ボックスに「sql」と入力して、［OK］ボタンをクリックします。


4 メニューバーから［ファイル｜レポート｜商品管理］を選択します。

商品管理ウィンドウが表示されます。上部のデータウィンドウコントロールには Product テーブルから検索されたすべての行が表示されています。



下部のデータウィンドウコントロールには、上部のデータウィンドウコントロールで選択された商品についての情報が表示されています。

5 メニューバーの［編集｜挿入］を選択します。

これで dw_detail データウィンドウがクリアされ、新しい行がデータウィンドウに追加できるようになります。カーソルが dw_detailコントロールの［商品 ID］ボックスに置かれます。

6 下部のデータウィンドウのボックスに情報を入力して、新しい製品行を追加します。

ボックス間の移動には〔Tab〕を使用します。

7 メニューバーの［編集｜更新］を選択します。

これで ue_update イベントのスクリプトでコーディングされたとおりに、新しい商品のデータがデータベースに送られ、確認メッセージが表示されます。

新しい商品はまだ上部のデータウィンドウに表示されませんが、別の商品シートを開くと、新しい情報が表示されます。必要であれば、更新ボタンの Clicked イベントにコードを追加して、マスターデータウィンドウコントロールでデータが自動的に更新されるようにできます。

196 PowerBuilder


8 メッセージボックスで［OK］をクリックします。マスターデータウィンドウで製品をクリックします。

その商品のデータが詳細データウィンドウに表示されます。

9 商品の単価を変更します。メニューバーの［編集｜更新］を選択します。

これで変更した商品データがデータベースに送られ、別の確認メッセージが表示されます。

10 メッセージボックスで［OK］をクリックします。マスターデータウィンドウで別の商品を選択します。

その商品のデータが詳細データウィンドウに表示されます。

11 メニューバーの［編集｜削除］を選択します。

データウィンドウからはその商品がただちに削除されますが、［編集］メニューの［更新］オプションを選択するまでデータベースからは削除されません。


アプリケーションが終了し、ウィンドウペインタに戻ります。




198 PowerBuilder

レッスン 9 デバッガの実行

開発中のアプリケーションが思ったとおりに動作しないことがあります。適切な値が変数に割り当てられていない、スクリプトが間違っているなどの原因が考えられます。このような場合、デバッグモードで実行することによって、アプリケーションを調べることができます。

デバッグモードでは、ブレークポイント（ストップ）をスクリプトおよび関数に挿入したり、コードをステップごとに実行したり、変数の内容を表示したりして、実行中にエラーとなる論理エラーやエラー箇所を確認することができます。デバッグモードでアプリケーションを実行すると、ブレークポイントを設定したスクリプトの手前で実行が停止します。この時点で、変数の値を参照して変更できます。


• アプリケーションのスクリプトへのブレークポイントの追加

• デバッグモードでのアプリケーションの実行

• ウォッチと条件ブレークポイントの設定



アプリケーションのスクリプトへのブレークポイントの追加


現在の学習個所> アプリケーションのスクリプトへのブレークポイントの追加

デバッグモードでのアプリケーションの実行ウォッチと条件ブレークポイントの設定

このステップでは、デバッガを開き、ブレークポイントを追加して、ログインウィンドウおよび顧客情報ウィンドウの動作をテストします。デバッグモードでアプリケーションを実行すると、アプリケーションはブレークポイントが設定されている行を実行する直前で停止します。

スクリプトにブレークポイントを挿入するときは、実行可能な文を含む行を選択する必要があります。変数を宣言している行、コメント行、または空白行にブレークポイントを設定しようとすると、ブレークポイントは自動的に次の実行可能な行に設定されます。

1 パワーバーの［デバッグ］ボタンをクリックします。

デバッガが開きます。デフォルトのビューレイアウトでは、タブペインのスタックが 3 つあります。デバッグウィンドウの左上にあるペインに、ソースビューが表示されています。

200 PowerBuilder


デバッグウィンドウの表示が異なる場合以前にデバッグウィンドウを開いて、ビューを開いたり、移動したり、閉じたりした場合は、この画面とは表示が異なることがあります。デフォルトのビューレイアウト構成に戻すには、メニューバーの［ビュー｜レイアウト｜ ( デフォルト )］を選択します。

アプリケーションの Open イベントのソースコードが、左上のソースビューに表示されます。表示されない場合は、ソースブラウザビューのツリービューのアプリケーションノードを展開し、pbtutor アプリケーションの下の Open イベントをダブルクリックします。

2 ソースビューで、次の代入文を含む行をダブルクリックします。

this.ToolBarSheetTitle = "MDI アプリケーションツールバー "



行の先頭に赤い記号が表示され、その文にブレークポイントが設定されていることを示します。

3 ソースブラウザビューで次のノードを展開します。ウィンドウ >w_welcome>cb_ok

ソースブラウザビューには、コーディングされたイベントだけが一覧表示されます。ログインウィンドウの［OK］ボタンのイベントは Clicked イベントだけです。

4 ソースブラウザビューで cb_ok ボタンの Clicked イベントをダブルクリックします。

ソースビューに Clicked イベントのコードが表示されます。

5 次の行をダブルクリックします。

gnv_connect = CREATE & n_pbtutor_connectservice

行の先頭にブレークポイントを示す記号が表示されます。

202 PowerBuilder


6 ソースブラウザビューで w_master_detail_ancestor をダブルクリックします。dw_master、続いて rowfocuschanged をダブルクリックします。

ソースビューに、 dw_master データウィンドウコントロールのRowFocusChanged イベントのスクリプトが表示されます。

7 次の行をダブルクリックします。

IF dw_detail.Retrieve(ll_itemnum) = -1 THEN

行の先頭にブレークポイントを示す記号が表示されます。

8 右下のスタックの［ブレークポイント］タブを選択します。

ブレークポイントビューに、設定したブレークポイントが表示されます。このレッスンの作業を進めるには、これらのブレークポイントが正しく設定されている必要があります。

余分なブレークポイントがある場合余分なブレークポイントは、ブレークポイントビューのポップアップメニューを使用して取り消すことができます。


デバッグモードでのアプリケーションの実行


現在の学習個所アプリケーションのスクリプトへのブレークポイントの追加

> デバッグモードでのアプリケーションの実行ウォッチと条件ブレークポイントの設定

このステップでは、アプリケーションをデバッグモードで実行します。コードを 1 行ずつ実行します。

ステップ実行ボタンについてアプリケーションを 1 文ずつ実行するには、［ステップイン］または［ステップオーバー］のいずれかを使用します。次の文に関数の呼び出しが記述されていない場合は、どちらも同じ結果になります。

［ステップオーバー］は、関数を単独の文として実行する場合に使用します。

［ステップイン］は、関数の中に入って、関数内の各文の結果を確認したい場合に使用します。関数内に［ステップイン］した場合は、［ステップアウト］することによって、その関数の残りの部分を 1 ステップずつ実行できます。［ステップアウト］すると、その関数を呼び出したスクリプトの次の文に制御が移ります。

1 ペインタバー 1 の［開始］ボタンをクリックします。またはメニューバーの［デバッグ｜開始］を選択します。

アプリケーションが起動して、ブレークポイントのある行まで実行されます。ここでは、シートウィンドウのツールバータイトルの代入文の呼び出しまでです。

ブレークポイントのある行まで達すると、アプリケーションは停止してデバッグウィンドウに戻ります。黄色い矢印カーソルは、次に実行される文を指しています。

2 左下のスタックの［グローバル］タブをクリックします。

グローバル変数のビューが表示されます。

3 「transaction sqlca」をダブルクリックします。dbms のプロパティを表示します。

204 PowerBuilder


dbms プロパティのデータ型は String 型です。ProfileString 関数が実行される前に中断されたので、 dbms プロパティには何も値がありません。

4 次の文を実行するために、ペインタバー 1 の［ステップイン］ボタンをクリックします。またはメニューバーの［デバッグ｜ステップイン］を選択します。

アプリケーションが MDI フレームウィンドウの Open イベントの実行を開始します。

5 このフレームウィンドウの Open イベントのスクリプトで次の文に到達するまで［ステップイン］または［ステップオーバー］を使用してコードを実行します。

open(w_welcome)

このステートメントを実行し終えると、ログインウィンドウが表示され、デバッグウィンドウが小化されます。

また、このフレームウィンドウの Open イベントには、ポストされた ue_postopen 関数の呼び出しもあります（確認せずに実行したもの）。これがシートマネージャの関数を呼び出します。これらの関数は Open イベントのスクリプトの後で（ログインウィンドウの表示後に）処理されます。

6 ログインウィンドウが表示され、デバッガが小化されるまで、［ステップオーバー］をクリックします。ログインウィンドウの［ユーザ ID］ボックスに「dba」と入力します。［パスワード］ボックスに「sql」と入力して、［OK］をクリックします。



デバッグウィンドウに戻ります。ソースビューの黄色い矢印は、次の実行可能な文である接続サービスオブジェクトの CREATE 文を指します。これが cb_ok コマンドボタンの Clicked イベントのスクリプトで初の実行可能な行です。

7 右下のスタックの［コールスタック］タブを選択します。

コールスタックビューの黄色い矢印は、コールスタック内での現在の位置を表します。コールスタック内の別の行をダブルクリックすると、ソースビューと変数ビューがその行のコンテキストを表示するように変更され、ソースビューでは緑色の矢印がその行を示します。次に、コールスタック内の別の行を 1 回クリックすると、コールスタックビューに緑色の矢印が表示され、コンテキストが表示されている行を指します。コードの実行を続けると、ソースビューと変数ビューが現在のコンテキストに戻ります。

8 ［ステップイン］ボタンをクリックします。

接続サービスオブジェクトの Constructor イベントのスクリプトに移動します。

9 ［ステップアウト］ボタンをクリックします。左下のスタックの［グローバル］タブをクリックします。もう一度、 Transaction オブジェクトのプロパティを確認します。

ステップアウトを実行することで、 Constructor イベントから 1 ステップで抜けて、［OK］ボタンの Clicked イベントのスクリプトに戻ります。 DBMS プロパティには値が入っていますが、 UserID、DBPass、および DBParm プロパティには入っていません。

206 PowerBuilder


これらの値は、接続サービスオブジェクトの Constructor イベントの実行時に、 of_GetConnectionInfo 関数が INI ファイルからの情報を返した後で代入されますが、このチュートリアルでは、 UserID、DBPass、および DBParm プロパティの行をコメントアウトしたので、これらの値は取得されません。

10 左下のスタックで［ローカル］タブをクリックします。

Clicked スクリプトのローカル変数にはまだ値が代入されていません。

11 ［ステップイン］ボタンを使用してローカル変数の 3 つの代入文を実行します。

それぞれの文を実行すると、これらのローカル変数に代入された値が予想したものであることを確認することができます。



12 左下のスタックの［グローバル］タブをもう一度クリックし、Transactionオブジェクトを展開します。［ステップイン］ボタンを使用して、Transaction オブジェクト（SQLCA）をユーザが入力した値を用いてインスタンス化する 3 つの行を実行します。

それぞれの文を実行すると、ログインウィンドウで入力した値がTransaction オブジェクトに代入されているかどうかを確認できます。データベースへの接続は、接続サービスオブジェクトのof_Connect 関数を実行するまでは行われません。

13 ペインタバー 1 の［実行の継続］ボタンをクリックします。

［実行の継続］ボタンは、実行を再開し、次のブレークポイントまで処理を進めます。データベースに接続し、ログインウィンドウが閉じ、アプリケーションの MDI フレームが表示されます。アプリケーションはユーザからの入力を待機しています。

14 メニューバーから［ファイル｜レポート｜顧客情報］を選択します。

アプリケーションは、 RowFocusChanged イベント内の次のブレークポイントが設定されている行まで実行されます。

データウィンドウの RowFocusChanged イベントは、データウィンドウが表示される前に発生します。このため、アプリケーションの実行は顧客情報ウィンドウが開かれる前に停止します。

208 PowerBuilder


ウォッチと条件ブレークポイントの設定

現在の学習個所アプリケーションのスクリプトへのブレークポイントの追加デバッグモードでのアプリケーションの実行

> ウォッチと条件ブレークポイントの設定

このステップでは、ユーザが顧客情報ウィンドウで行を選択すると値が変化する変数に、ウォッチを設定します。次に、設定した単純なブレークポイントを、変数が特定の値を持つ場合にのみ発生する条件ブレークポイントに変更します。

1 右下のスタックで［ウォッチ］タブをクリックします。左下のスタックで［ローカル］タブをクリックします。ローカルビューで ll_itemnum 変数を選択し、ウォッチビューにドラッグします。

ll_itemnum 変数に、検索された初の顧客 ID の値である 101 がセットされます。ウォッチビューで ll_itemnum 変数を表示させると、その値の変化を簡単に調べることができます。ウォッチビューには、グローバル変数、インスタンス変数、および Parent 変数をドラッグできるため、種類の異なる変数の値を簡単に追跡することができます。

2 ［実行の継続］ボタンをクリックします。

再びアプリケーションが実行されます。顧客情報ウィンドウが表示されて、データベースから検索した顧客リストが表示されます。詳細データウィンドウには顧客 ID が 101 の顧客情報が表示されます。

3 顧客情報ウィンドウのマスターデータウィンドウで別の行を選択します。

デバッグウィンドウに戻ります。ローカル変数ビューとウォッチビューの両方で ll_itemnum の値が更新されます。

4 右下のスタックで［ブレークポイント］タブをクリックします。rowfocuschanged ブレークポイントをダブルクリックします。

ブレークポイントの編集ダイアログボックスが表示されて、RowFocusChanged イベント内のブレークポイントが選択されます。


ウォッチと条件ブレークポイントの設定

5 ［条件］テキストボックスに次の行を入力して［OK］ボタンをクリックします。

ll_itemnum = 107

RowFocusChanged イベントスクリプト内のブレークポイントが条件ブレークポイントに設定されます。アプリケーションの実行中にこのステートメントに達し、かつ、 ll_itemnum の値が 107 である場合にのみ、そのアプリケーションが停止します。

6 ［OK］をクリックして、ダイアログボックスを閉じます。［実行の継続］ボタンをクリックします。

再びアプリケーションが実行されます。顧客情報ウィンドウで別の行を選択すると、顧客 ID が 107 の顧客を選んだ場合に限り、ブレークポイントに達した時点でデバッグウィンドウが開きます。

顧客 ID が 107 の顧客情報を選択した場合は、もう一度［実行の継続］ボタンをクリックして元のアプリケーションに戻ります。

7 アプリケーションのメニューバーから［ファイル｜終了］を選択します。

アプリケーションを終了して、デバッグウィンドウに戻ります。

8 メニューバーから［ファイル｜閉じる］を選択します。

PowerBuilder の開発環境に戻ります。

210 PowerBuilder

レッスン 1 0 例外処理

例外処理では、プログラムの実行中に発生したエラーを捕捉し、それらのエラーに関する情報をアプリケーションユーザに提供します。このレッスンでは、ユーザ定義の例外オブジェクトを作成する方法、メソッド内で TRY-CATCH 文によって送出した例外を捕捉する方法について解説します。


• 既存のアプリケーションへの新規のシートウィンドウの追加

• ユーザ定義の例外オブジェクトの作成

• 新規のユーザ関数とユーザイベントの作成

• メソッドの呼び出しと例外の捕捉




既存のアプリケーションへの新規のシートウィンドウの追加


現在の学習個所> 既存のアプリケーションへの新規のシートウィンドウの追加

ユーザ定義の例外オブジェクトの作成新規のユーザ関数とユーザイベントの作成メソッドの呼び出しと例外の捕捉アプリケーションの実行

このレッスンでは、メインのチュートリアルアプリケーションに 3 つ目のシートウィンドウを追加します。そして、埋め込み SQL コマンドから返される値、およびアプリケーションユーザがドロップダウンリストボックスコントロールで選択した値に対して（パーセンテージを計算するといった）決まりきった操作を実行する関数を作成して呼び出します。

作成する関数のプロトタイプでユーザ定義の例外を発生させます。コマンドボタンコントロールの Clicked イベントに記述されたTRY-CATCH ブロック内でこの関数を呼び出します。そして、アプリケーションコールスタックの上位に送出されたシステム例外と同じように、新規の関数によって送出されたユーザ定義の例外を捕捉するCATCH 句を Clicked イベントに記述します。

さらに、新規のウィンドウシートを使用して、選択した都道府県に住んでいる顧客のパーセンテージを計算します。新規のシートウィンドウに追加するコントロールは以下のとおりです。

• 読み取り専用の結果を表示するためにプログラムで変更する 2 つのスタティックテキストボックス

• パーセンテージを計算する関数を呼び出すコマンドボタン

• 顧客の在住の都道府県をリストするドロップダウンリストボックス

• ユーザがドロップダウンリストボックスから選択した都道府県に住んでいる顧客のパーセンテージが表示されるテキストボックス

既存のアプリケーションに新規のシートウィンドウを追加するには、以下の操作を行う必要があります。

• シートウィンドウの作成

• メインアプリケーションフレームからシートウィンドウにアクセスできるようにする

212 PowerBuilder

レッスン 10 例外処理

シートウィンドウの作成

シートウィンドウは、w_pbtutor_basesheet ウィンドウから継承します。このウィンドウはシートウィンドウの基本クラスで、テンプレートアプリケーションウィザードによって生成されたものです。拡張レイヤウィンドウ w_master_detail_ancestor は、変更を加えたために新規のシートウィンドウでは再利用できないので、使用しません。

1 PowerBuilder メニューから［ファイル｜継承］を選択します。PBTutor.PBL ライブラリ内の使用可能なウィンドウから w_pbtutor_basesheet を選択して、［OK］をクリックします。

2 ウィンドウペインタにレイアウトビューが表示されていることを確認してください。［挿入｜コントロール｜スタティックテキスト］を選択し、レイアウトビューの左上隅をクリックします。

3 プロパティビューで、［テキスト］テキストボックスに入力されているデフォルトのテキストを選択して、次のように入力します。

1. ドロップダウンリストボックスで都道府県コードを選択または入力してください。

4 テキスト全体が収まるように、またウィンドウの右上にドロップダウンリストボックスコントロールを配置できるように、コントロールの幅とシートウィンドウの幅を広げます。

シートウィンドウの幅は 2250 あれば十分です。

5 レイアウトビュー内のスタティックテキストコントロールを右クリックして、ポップアップメニューから［複製］を選択します。プロパティビューで、新規のスタティックテキストコントロールの［テキスト］テキストボックスに入力されているデフォルトのテキストを選択して、次のように入力します。

2. ［パーセンテージ］ボタンをクリックしてください。



6 ［挿入｜コントロール｜ドロップダウンリストボックス］を選択し、レイアウトビューの右上隅にあるスタティックテキストボックスの右側をクリックします。

7 ドロップダウンリストボックスのプロパティビューで、コントロールの名前に「ddlb_state」と入力します。［編集可能］と［垂直スクロールバー］の 2 つのチェックボックスをオンにします。

8 ペインタバーのコマンドボタンをクリックし、2 つのスタティックテキストボックスの下をクリックします。プロパティビューで、ボタン名に「cb_percent」、ボタンのテキストに「パーセンテージ」と入力します。

9 ［挿入｜コントロール｜シングルラインエディット］を選択して、レイアウトビューのコマンドボタンの下クリックします。プロパティビューで、コントロールの名前に「sle_result」と入力し、コントロールのテキストに以下の説明文を入力します。

選択した都道府県に住んでいる顧客のパーセンテージを表示するテキストボックス

10 テキスト全体が収まるようにコントロールの幅を広げます。

214 PowerBuilder


11 どのコントロールも選択されていないこと、プロパティビューにシートウィンドウプロパティが表示されていることを確認します。［タグ］プロパティに「都道府県に住んでいる顧客のパーセンテージ」と入力します。

ここで入力したテキストは、実行時にシートウィンドウのタイトルとして表示されます。基本シートの ue_postopen イベントのコードで、タグのテキストがシートウィンドウのタイトルに割り当てられます。

12 PowerBuilder メニューから［ファイル｜上書き保存］を選択します。アプリケーションライブラリとして PBTUTOR.PBL を選択し、新規ウィンドウ名に「w_cust_pct」と入力して、［OK］をクリックします。

新規のシートウィンドウとそのすべてのコントロールを、メインのチュートリアルライブラリに保存します。

メインアプリケーションフレームからシートウィンドウにアクセスできるようにする

新規のシートはシートマネージャに登録します。

1 システムツリーで w_pbtutor_frame をダブルクリックします。

2 ue_postopen イベントがスクリプトビューに表示されていない場合は、［イベントリスト］タブを選択して、ue_postopen をダブルクリックします。

ue_postopen イベントスクリプトが、スクリプトビューに表示されます。

3 登録済みシートウィンドウのリストに以下の行を入力します。

ls_sheets[3] = "w_cust_pct"

4 登録済みシートウィンドウのリストの下に以下の行を入力します。

ls_display[3] = "都道府県に住んでいる顧客のパーセンテージ "



より良いコーディングの習慣シートウィンドウと表示名を定義する 6 行のコードは、次の 2 行のコードに短縮できます。

// シートウィンドウと表示名を定義するstring ls_sheets[]={"w_customers", "w_products",&

"w_cust_pct"}

string ls_display[]={"顧客情報 ", &"商品管理 ", &

"都道府県に住んでいる顧客のパーセンテージ " }

5 ［ファイル｜上書き保存］を選択して、 w_pbtutor_frame ウィンドウを閉じます。

次回 pbtutor アプリケーションを実行すると、メインフレームウィンドウの［ファイル］メニューから新規のシートウィンドウを開くことができるはずです。開発環境では新規のシートウィンドウを即実行できますが、コンパイル済みアプリケーションでも実行できるようにする必要があります。

そのために、シートマネージャの of_registersheet スクリプトで、新規のシートウィンドウをウィンドウオブジェクトとして参照します。こうして参照することで、コンパイラは、このウィンドウオブジェクトがアプリケーションで使用されていることを認識でき、実行可能ファイルに含めることができます。

コンパイル済みアプリケーションは、レッスン 11「アプリケーション配布の準備」で作成します。

6 システムツリーで n_pbtutor_sheetmanager をダブルクリックします。

216 PowerBuilder


7 ［関数リスト］タブを選択し、of_registersheet をダブルクリックします。

スクリプトビューに、 of_registersheet 関数のスクリプトが表示されます。

8 w_customers と w_products の各シートウィンドウ変数を宣言している行の後に以下のように入力します。

w_cust_pct lw_sheet3

9 ［上書き保存］を選択して、ユーザオブジェクトn_pbtutor_sheetmanager を閉じます。


ユーザ定義の例外オブジェクトの作成

ユーザ定義の例外オブジェクトの作成

現在の学習個所既存のアプリケーションへの新規のシートウィンドウの追加

> ユーザ定義の例外オブジェクトの作成新規のユーザ関数とユーザイベントの作成メソッドの呼び出しと例外の捕捉アプリケーションの実行

ここでは、ユーザが w_cust_pct ウィンドウ上のコマンドボタンをクリックしたときに起動される関数から送出される 2 つのユーザ定義の例外オブジェクトを作成します。また、 w_cust_pct ウィンドウに追加したドロップダウンリストボックスコントロールのユーザイベントから送出されるユーザ定義の例外オブジェクトも作成します。

1 PowerBuilder メニューから［ファイル｜新規作成］を選択し、新規作成ダイアログボックスの［PB オブジェクト］タブをクリックします。

2 ［標準クラス］アイコンを選択して［OK］をクリックします。［データ型］リストボックスから「throwable」を選択して、［OK］をクリックします。

新規例外オブジェクトがユーザオブジェクトペインタに表示されます。

3 プロパティビューの［テキスト］ボックスに以下のように入力します。

データベースに該当する行がありません。ドロップダウンリストボックスで都道府県コードを入力または選択した場合で、データベースとの接続が切断されていなければ、入力した都道府県に顧客が住んでいないか、入力した都道府県コードが間違っています。

例外オブジェクトには、テキストプロパティの取得および設定用メソッドが定義されていますが、ここではユーザインタフェースに直接テキストプロパティを設定します。

4 ［ファイル｜上書き保存］を選択して、 PBTUTOR.PBL アプリケーションライブラリを選択し、新規のユーザオブジェクト名に「exc_no_rows」と入力します。

5 ［ファイル｜閉じる］を選択します。

218 PowerBuilder


6 以下のテキストプロパティ値と例外オブジェクト名を用いて手順 1 ～ 5を繰り返します。

7 以下のテキストプロパティ値と例外オブジェクト名を用いて手順 1 ～ 5を繰り返します。

プロパティ値

テキストパーセンテージが低すぎます。この都道府県には

顧客が 1 人しかいません。担当販売マネージャ

に連絡してください。

例外オブジェクト名 exc_low_number

プロパティ値

テキスト都道府県名は 2 文字の都道府県コードで指定し

てください。

例外オブジェクト名 exc_bad_entry


新規のユーザ関数とユーザイベントの作成


現在の学習個所既存のアプリケーションへの新規のシートウィンドウの追加ユーザ定義の例外オブジェクトの作成

> 新規のユーザ関数とユーザイベントの作成メソッドの呼び出しと例外の捕捉アプリケーションの実行

ここでは、［パーセンテージ］コマンドボタンの Clicked イベントによって起動される関数と、 w_cust_pct ウィンドウのドロップダウンリストボックスからフォーカスが移動したときに起動するイベントを追加します。ここで作成する関数は、特定の都道府県に住む顧客のパーセンテージを計算します。イベントは、ドロップダウンリストボックスコントロールの現在値（都道府県コード）を処理し、長さが 2 文字かどうかを確認します。

1 ウィンドウペインタ内で w_cust_pct が開いていない場合はそれを開きます。ウィンドウペインタのメニューで［挿入｜関数］を選択します。

プロトタイプウィンドウにスクリプトビューが表示されます。スクリプトビューの初のドロップダウンリストボックスには「(Functions)」が、 2 番目のリストボックスには「( 新規関数 )」が表示されます。

2 戻り値の型として「decimal」を選択し、関数名に「uf_percentage」と入力します。

3 第 1 引数の型として「integer」を選択し、第 1 引数名に「ai_custbystate」と入力します。

4 プロトタイプウィンドウ内のどこかで右クリックして、ポップアップメニューの［パラメータの追加］を選択します。

5 第 2 引数の型として「integer」を選択して、第 2 引数名に「ai_totalcust」と入力します。

6 ［Throws］ボックスで「exc_no_rows,exc_low_number」と入力します。

220 PowerBuilder


7 以下のスクリプトを新規関数に入力します。

Decimal my_resultexc_no_rows le_nrexc_low_number le_ex

/* パラメータとして渡された 2 つの整数を処理する。初の整数が 0 または 1 の場合は、例外をインスタンス化して送出する。それ以外の場合は、パーセンテージを小数点以下第一位まで計算して返す。 2 番目の整数が 0 の場合は、計算中に、実行時のゼロによる除算例外を捕捉して再送出する。 */CHOOSE CASE ai_custbystateCASE 0

le_nr = create exc_no_rowsthrow le_nr

CASE 1le_ex = create exc_low_numberthrow le_ex

CASE ELSETRY

my_result= (ai_custbystate/ai_totalcust) *100

CATCH (dividebyzeroerror le_zero)throw le_zero

End TRYEND CHOOSEreturn truncate (my_result,1)

後述するコマンドボタンの Clicked イベントスクリプトでは、2 つの整数を引数として uf_percentage 関数を呼び出し、戻り値を処理します。

次に、ユーザが入力した都道府県コードがちょうど 2 文字でない場合に exc_bad_entry 例外オブジェクトを送出する、ドロップダウンリストボックスのユーザイベントを追加します。

8 スクリプトビューの初のドロップダウンリストボックスで「ddlb_state」を、 2 番目のドロップダウンリストボックスで「( 新規イベント )」を選択します。

9 戻り値の型として「integer」を選択し、イベント名に「ue_modified」と入力します。引数の型として「string」を選択し、引数名に「as_statecode」と入力します。「exc_bad_entry」を［Throws］ボックスに入力するか、システムツリーから［Throws］ボックスにドラッグします。


イベント ID は、「None」であることに注意してください。イベント ID は、Throws 句にユーザ定義の例外オブジェクトを含まないプロトタイプを定義します。

10 新規の ue_modified のスクリプトを以下のように入力します。

exc_bad_entry le_ex

// ドロップダウンリストボックスに入力されている// テキストの長さが 2 文字であることを確認し、//2 文字でなければ exc_bad_entry 例外オブジェクト// をインスタンス化して送出するIF len (this.text)<>2 Then

le_ex = create exc_bad_entrythrow le_ex

END IFReturn 1

次に、 ue_modified イベントと uf_percentage 関数を呼び出して、これらのメソッドによって送出された例外を捕捉します。

222 PowerBuilder


メソッドの呼び出しと例外の捕捉

現在の学習個所既存のアプリケーションへの新規のシートウィンドウの追加ユーザ定義の例外オブジェクトの作成新規のユーザ関数とユーザイベントの作成

> メソッドの呼び出しと例外の捕捉アプリケーションの実行

ここでは、都道府県コードを EAS Demo DB データベースの customer表から取得して、ドロップダウンリストボックスコントロールに設定するコードを記述します。このコントロールは編集可能にしてあるため、都道府県コードの値をアプリケーションユーザが入力することもできます。ユーザが入力した値を処理する前に、入力値が ue_modifiedイベントに設定した条件を満たしているかどうか、すなわち長さが 2文字であるかどうかを確認します。

また、コマンドボタンコントロールの Clicked イベントに、ドロップダウンリストボックスコントロールに入力されている都道府県コードを処理するコードを追加します。Clicked イベントでは、uf_percentage関数を呼び出して、選択されている都道府県に住んでいる顧客のパーセンテージを計算し、同関数によって送出されるすべての例外を捕捉します。

1 ウィンドウペインタ内に w_cust_pct が開いていること、スクリプトビューの初のドロップダウンリストボックスに ddlb_state が表示されていることを確認します。

2 2 番目のドロップダウンリストボックスから「losefocus ( ) returnslong ［pbm_cbnkillfocus]」を選択します。

3 losefocus イベントスクリプトでは、ue_modified イベントを呼び出し、そのイベントによって送出される例外オブジェクトを捕捉します。コードは以下のようになります。

Try this.EVENT ue_modified (this.text)

Catch (exc_bad_entry le_be)

messagebox ("exc_bad_entry から ", & le_be.getmessage ())

End Try

return 1


メソッドの呼び出しと例外の捕捉

4 ddlb_state コントロールのスクリプトビュープロトタイプウィンドウの 2 番目のドロップダウンリストボックスから「constructor ( )returns long [pbm_constructor]」を選択します。

5 Constructor イベントに以下のコードを入力して、ドロップダウンリストボックスコントロールに設定します。

int li_nrows, nstring ls_state

//customer テーブルに存在する//すべての都道府県の数を取得するSELECT count (distinct state) INTO :li_nrows FROM customer;

//customer テーブル内のすべての都道府県を選択する//SQL カーソルを宣言する。ただし、//同じ都道府県を含む 2 つ以上の行を重複して選択しないDECLARE custstatecursor CURSOR FOR SELECT state FROM customerGROUP BY state HAVING count (state) =1UNION SELECT state FROM customerGROUP BY stateHAVING count (state) >1;OPEN custstatecursor ;

//customer テーブル内の各都道府県につき 1 つのエントリを// コントロールに設定するFOR n=1 TO li_nrows

FETCH NEXT custstatecursor INTO :ls_state;this.additem (ls_state)

NEXTCLOSE custstatecursor ;

6 スクリプトビューの初のドロップダウンリストから「cb_percent」を選択します。2 番目のドロップダウンリストボックスに「clicked ( ) returnslong [pbm_bnclicked]」が表示されていることを確認します。

7 Clicked イベントスクリプトに以下のコードを入力します。

Decimal my_resultDouble entry_1, entry_2Int li_int, li_rtnString sel_state

sel_state=ddlb_state.text

//選択した都道府県に住む顧客の行数を取得し、

224 PowerBuilder


//entry_1 変数に格納する。// この数字を、初の// スタティックコントロールに表示するSELECT count (*) INTO :entry_1 FROM customer

WHERE customer.state=:sel_state;

st_1.text="選択した都道府県に住む顧客数 : " + string (entry_1)

//entry_2 変数に格納されている//総顧客数を取得する。// この数字を 2 番目のスタティックコントロールに表示するSELECT count(*) INTO :entry_2 FROM customer;

st_2.text="総顧客数 : " &+ string(entry_2)

//uf_percentage 関数を呼び出し、例外を捕捉するTRY

my_result = uf_percentage (entry_1, entry_2)CATCH (exc_no_rows e_nr )

MessageBox("exc_no_rows から ", &e_nr.getmessage())

CATCH (exc_low_number e_ln )li_int=1

MessageBox("exc_low_number から ", & e_ln.getmessage())

CATCH (dividebyzeroerror e_zero)

li_rtn = MessageBox("顧客なし ", &" アプリケーションを終了しますか ?", Stopsign!,

YesNo!)IF li_rtn=1 THEN

HALTEND IF

END TRY

// テキストボックス内のメッセージを表示する。//選択した都道府県に住んでいる顧客が 1 人しかいないのか、//2 人以上いるのかによって、// メッセージの内容を変えるIF li_int=1 THEN

sle_result.text = sel_state + &

" に住んでいる顧客は 1 人です。 " + & " 別の都道府県を選択してください。 "

ELSEsle_result.text = String (my_result) + &

" % の顧客が " + sel_state + & " に住んでいます。 "

END IF




現在の学習個所既存のアプリケーションへの新規のシートウィンドウの追加ユーザ定義の例外オブジェクトの作成新規のユーザ関数とユーザイベントの作成メソッドの呼び出しと例外の捕捉


ここまでで、アプリケーションを実行して、選択した都道府県に住んでいる顧客のパーセンテージを計算する準備ができました。

ここでは記述したスクリプトの例外条件をテストしますが、「ゼロによる除算」エラー条件をテストするには、データベース内の顧客数を故意にゼロに設定する必要があります。そのために、シートウィンドウにチェックボックスを追加し、そのチェックボックスがオンの場合は顧客数をゼロに設定するようにします。

ここでは次の作業を行います。

• 新規のシートウィンドウのテスト

• ゼロによる除算エラーのテストの追加

新規のシートウィンドウのテスト


変更内容を保存するかどうかを問い合わせるメッセージボックスが表示されたら、［はい］をクリックします。



3 メニューバーから［ファイル｜レポート｜都道府県に住んでいる顧客のパーセンテージ］を選択します。

226 PowerBuilder


都道府県に住んでいる顧客のパーセンテージウィンドウが表示されます。

4 都道府県に住んでいる顧客のパーセンテージシートウィンドウのドロップダウンリストボックスで「AM」を選択または入力して、［パーセンテージ］ボタンをクリックします。

青森県に顧客が 1 人しかいないため、ユーザ定義の例外exc_low_number が発生します。この例外が発行したメッセージが、［パーセンテージ］ボタンの Clicked イベントスクリプトの CATCH句に定義されたメッセージボックスに表示されます。

5 ［OK］をクリックして、メッセージボックスを閉じます。

スタティックテキストボックス内のテキストに、青森県在住の顧客の数とデータベースに登録されている顧客の総数が表示されます。編集可能なテキストボックスに、パーセンテージが計算されなかったため、別の都道府県を選択するように促すテキストが表示されます。



6 都道府県に住んでいる顧客のパーセンテージシートウィンドウのドロップダウンリストボックスで「KG」を選択または入力して、［パーセンテージ］ボタンをクリックします。

検索結果から、神奈川県在住の顧客は 15 人存在し、データベースに登録されている全顧客の 11.8% を占めることがわかります。データベースを変更するとパーセンテージが変わります。

7 ドロップダウンリストボックスに「Ohio」と入力して、［パーセンテージ］ボタンをクリックします。

［パーセンテージ］ボタンをクリックしてドロップダウンリストボックスからフォーカスを移動すると、LoseFocus イベントが発生します。このイベントにより ue_modified イベントが起動され、ユーザ定義の例外 exc_bad_entry が発生します。ドロップダウンリストボックスで 2 文字の都道府県コードを選択するように指示する例外メッセージが表示されます。

8 ［OK］をクリックしてメッセージボックスを閉じ、ドロップダウンリストボックスに「US」と入力して、［パーセンテージ］ボタンをクリックします。

US という都道府県コードを持つ行はデータベース内に見つからないため、 exc_no_rows 例外が発生します。該当する行が返されなかったことと、その理由を示すメッセージが表示されます。より堅牢なアプリケーションにしたい場合は、入力されたテキストを都道府県コードのリストと照合して US が都道府県コードではないことを知らせる exc_bad_entry 例外を発生させるとよいでしょう。

9 ［OK］をクリックして、メッセージボックスを閉じます。

228 PowerBuilder


10 ウィンドウシステムトレイにある EAS Demo DB を表すデータベースアイコンを右クリックし、ポップアップメニューの［終了］を選択します。警告メッセージボックスが表示されたら［はい］をクリックします。

データベースアイコンは、赤と黄色の SQL シンボルです。 EASDemo DB データベースとの接続が切断されます。

11 ドロップダウンリストボックスで再度「AM」を選択または入力して、［パーセンテージ］ボタンをクリックします。

データベースとの接続が切断されているため、exc_no_rows 例外オブジェクトのメッセージが表示されます。結果を取得し直すには、アプリケーションを終了して再起動する必要があります。アプリケーションを再起動すると、実行時環境でデータベースとの接続が再確立されます。

12 ［OK］をクリックしてメッセージボックスを閉じ、アプリケーションメニューから［ファイル｜終了］を選択して開発環境に戻ります。

開発環境ではデータベース接続がオープンされたままの状態になっていることがあります。その場合は、データベースペインタを使用してデータベースとの接続を切断し、デザイン時環境で再接続します。

ゼロによる除算エラーのテストの追加

ここでは、w_cust_pct ウィンドウにチェックボックスを追加します。そして、このチェックボックスがオンのとき、ゼロによる除算エラーを強制的に発生させるコードを記述します。このテストにはインスタンス化されたチェックボックスオブジェクトが必要なので、新しいコードを、 Null オブジェクトのエラーをチェックする TRY-CATCH 文で囲みます。

1 レイアウトビューで w_pct_cust ウィンドウが開いていることを確認します。ウィンドウペインタのメニューで［挿入｜コントロール｜チェックボックス］を選択します。

2 ［パーセンテージ］コマンドボタンの右側をクリックします。

3 プロパティビューの［名前］ボックスに、「cbx_zero」と入力します。［テキスト］ボックスに、「ゼロによる除算のテスト」と入力します。



4 ［関数リスト］タブをクリックします。uf_percentage 関数をダブルクリックします。

5 CHOOSE CASE 文の上に以下のコードを入力します

//分母にゼロを設定してエラー条件をテストする。//分子は何でもよいが、ユーザ定義の例外が発生しないようにするTRYIF cbx_zero.checked=TRUE THEN

ai_totalcust=0ai_custbystate=2

END IFCATCH (nullobjecterror e_no)

MessageBox ("Null オブジェクト ", "不正なテストです。")END TRY

Null オブジェクトエラーのテストこのレッスンを終えたら、DESTROY cbx_zero という 1 行を TRY 文の上に追加して、 Null オブジェクトエラーのテストができます。


変更内容を保存するかどうかを問い合わせるメッセージボックスが表示されたら、［はい］をクリックします。



8 メニューバーから［ファイル｜レポート｜都道府県に住んでいる顧客のパーセンテージ］を選択します。ドロップダウンリストボックスから都道府県コードを選択します。

230 PowerBuilder


9 ［ゼロによる除算のテスト］チェックボックスをオンにします。

10 ［パーセンテージ］ボタンをクリックします。

パーセンテージの計算中にゼロによる除算エラーが発生し、［パーセンテージ］ボタンの Clicked イベントによって捕捉されます。CATCH 句に記述したこのエラーのメッセージボックスが表示されます。

11 ［いいえ］をクリックしてアプリケーションの実行を継続します。別の都道府県コードを選択しチェックボックスをオフにしてアプリケーションのテストを続行します。

チェックボックスがオンのまま［パーセンテージ］ボタンを再度クリックし、エラーメッセージボックスで［はい］を選択すると、アプリケーションが閉じ、開発環境に戻ります。

12 テストを終了したらアプリケーションを閉じます。



232 PowerBuilder

レッスン 1 1 アプリケーション配布の準備

このレッスンでは、アプリケーションの実行ファイル（EXE ファイル）を作成します。作成した実行ファイルは、エンドユーザがWindows のほかのアプリケーション（たとえば、Microsoft Excel やWord for Windows など）と同じように実行できます。


• プロジェクトオブジェクトの作成

• 実行ファイルの作成

• ショートカットの作成

• 実行ファイルのテスト



プロジェクトオブジェクトの作成


現在の学習個所> プロジェクトオブジェクトの作成

実行ファイルの作成ショートカットの作成実行ファイルのテスト

このステップでは、 PBTUTOR プロジェクトオブジェクトを作成します。プロジェクトオブジェクトは、アプリケーションの実行ファイルを作成するのに使用できます。

マシンコードについて PowerBuilder Enterprise 版を実行している場合は、プロジェクト実行ファイルのコンパイル方式として Pcode （疑似コード）とマシンコードのいずれかを選択できます。ただし、チュートリアルアプリケーションには Try-Catch 文が含まれているため、コンパイル方式としてマシンコードを選択することはできません。

アプリケーションをユーザに配布するときは、ループ、浮動小数点または整数演算、関数呼び出しなどの計算で実行速度を上げるためにマシンコードを使用してもよいでしょう。しかし、アプリケーションの開発の際は、通常は Pcode を使用した方が高速にコードを生成できます。

動的ライブラリについてまた、アプリケーションに動的ライブラリを作成することもできます。動的ライブラリはアプリケーションで使用するオブジェクトを格納するのに使用できます。動的ライブラリを使用することにより、アプリケーションを管理しやすいように小さなユニットに分割して、実行ファイルのサイズを小さくすることができます。

このチュートリアルで作成しているアプリケーションのような小さいアプリケーションの場合は、動的ライブラリを使用する必要はありません。

1 パワーバーの［新規作成］ボタンをクリックします。新規作成ダイアログボックスの［プロジェクト］タブをクリックします。

2 ［アプリケーションウィザード］アイコンを選択して［OK］をクリックします。

234 PowerBuilder

レッスン 11 アプリケーション配布の準備

プロジェクトペインタの使い方［プロジェクト］ページで、［アプリケーションウィザード］アイコンではなく［アプリケーション］アイコンをクリックした場合は、プロジェクトペインタが開きます。プロジェクトペインタでもウィザードの場合と同様に値を選択できますが、ウィザードの場合は、ウィザードからの指示に従って必要な情報を入力することができます。


［格納先ライブラリの指定］ページが表示されます。

4 まだ選択していない場合は、［アプリケーションライブラリ］リストボックスで「pbtutor.pbl」を選択します。［構築オプションの指定］ページが表示されるまで［次へ］をクリックします。

以下のデフォルト値が選択されたプロジェクトが生成されます。

5 ［構築オプションの指定］で［インクリメンタル構築］を選択します。［バージョン情報の指定］ページが表示されるまで［次へ］をクリックします。

以下のデフォルト値が選択されたプロジェクトが生成されます。

6 必要であれば、独自のバージョン情報を［バージョン情報の設定］ページに入力します。

このページの情報を変更しない場合、実行ファイルのプロパティを Windows エクスプローラで参照したときにデフォルト値が表示されます。

ウィザードのプロパティデフォルト値

プロジェクト名 p_pbtutor_exe

実行可能ファイル名 pbtutor.exeリソースファイル（オプション）なし

ウィザードのプロパティデフォルト値

マシンコードの生成いいえ、マシンコードで生成しません

動的ライブラリの作成チェックなし



7 ［次へ］をクリックします。［アプリケーションの作成準備完了］ページの情報を確認します。［完了］ボタンをクリックします。

アプリケーションのプロジェクトオブジェクトが作成され、プロジェクトペインタのワークスペースに表示されます。

プロジェクトを定義し終えたら、アプリケーションの実行ファイルは簡単に作成できます。プロジェクトを使用すると、頻繁に再構築する動的ライブラリを含むアプリケーションの場合に作業時間を短縮できます。インクリメンタル構築を選択すると、いくつか変更を加えた場合に、変更されたファイルのみ、または変更されたファイルに依存するファイルのみを再構築することで、すばやくプロジェクトを再構築できます。

236 PowerBuilder


実行ファイルの作成

現在の学習個所プロジェクトオブジェクトの作成

> 実行ファイルの作成ショートカットの作成実行ファイルのテスト

このステップでは、アプリケーションの実行ファイルを作成します。作成する実行ファイルには、アプリケーションのすべてのオブジェクトの定義が格納されます。このチュートリアルアプリケーションでは、プロジェクトに独立したリソースファイルを含めなかったので、ログインウィンドウで使用するビットマップファイルが含まれます。

プロジェクトペインタでも実行ファイルを作成できますが、通常は、一度プロジェクトの定義を終えたら、プロジェクトペインタを再度開く必要はありません。

システムツリーのワークスペースおよびターゲットでは、ポップアップメニュー項目に［インクリメンタル構築］、［フル構築］、および［配布］があり、これらを使用すると、ターゲット内またはワークスペース全体の中のプロジェクトの一部または全部を構築および配布できます。［インクリメンタル構築］および［フル構築］を選択すると、コードがコンパイルされます。［配布］を選択すると、コードがコンパイルされ、このチュートリアルで構築したようなアプリケーションの場合は、実行ファイルとオプションの動的ライブラリが作成されます。そのほかのプロジェクト（サーバコンポーネントプロジェクトなど）の場合は、［配布］を選択すると、サーバへのコンポーネントおよびサポートファイルの配布も行われます。

このレッスンでは、プロパティシートについて説明します。プロパティシートでは、構築と配布のオプションを指定し、そしてパワーバーから実行ファイルを作成します。

1 プロジェクトペインタを閉じます。変更内容を保存するかどうかを確認するメッセージが表示されたら、［はい］をクリックします。

2 システムツリーで pbtutor ターゲットを右クリックします。［プロパティ］を選択し、［配布］タブを選択します。


実行ファイルの作成

このページには、このターゲット内のすべてのプロジェクト（現在は 1 つだけ）が表示されます。ターゲット内に複数のプロジェクトがある場合は、実行される順序の変更、および構築するプロジェクトの選択ができます。

3 p_pbtutor_exe をチェックしたままで［キャンセル］ボタンをクリックします。システムツリーで MyWorkspace を右クリックします。［プロパティ］を選択し、［配布プレビュー］タブを選択します。

［配布プレビュー］タブページには、ワークスペース内のすべてのターゲット、および配布対象として選択された各ターゲット内のプロジェクトが、配布される順序で表示されます。このページでは何も変更できません。ワークスペースの配布オプションを希望どおりに設定したことを確認するためのページです。このページに表示されるすべてのプロジェクトは、パワーバーの［配布］ボタンをクリックすると配布されます。

このワークスペースにはターゲットとプロジェクトがそれぞれ 1つあるだけなので、［配布］ボタンを使用して実行ファイルを作成できます。

4 ［キャンセル］ボタンをクリックして、プロパティシートを閉じます。パワーバーの［配布］ボタンをクリックします。

実行ファイルの作成には多少時間がかかります。実行ファイルを作成している間は、画面下部の出力ウィンドウで処理の状況を確認することができます。

配布のプロセスを中止したい場合は、パワーバーの［中止］ボタンをクリックします。配布が完了すると、出力ウィンドウに「終了ワークスペースの配布 MyWorkspace」と表示されます。

238 PowerBuilder


ショートカットの作成

現在の学習個所プロジェクトオブジェクトの作成実行ファイルの作成

> ショートカットの作成実行ファイルのテスト

このステップでは、実行ファイルのショートカットを作成します。アイコンは、実行ファイルを開くためのショートカットとして動作します。ショートカットは、直接デスクトップへ、または選択したプログラムグループに追加できます。

1 ［小化］ボタンをクリックして、 PowerBuilder を小化します。

PowerBuilder が小化され、タスクバーにアイコン表示されます。

2 デスクトップの空白領域でマウスの右ボタンをクリックします。ポップアップメニューから［新規作成｜ショートカット］を選択します。

ショートカットの作成ダイアログボックスが表示されます。

3 ［コマンドライン］テキストボックスに、 EXE ファイルへのパスをドライブ名から入力します。

たとえば、PowerBuilder のインストール先がデフォルトのフォルダの場合は、次のように入力します。

C:¥Program Files¥Sybase¥PowerBuilder 9.0¥Tutorial¥pbtutor.exe

また、［参照］ボタンをクリックして pbtutor.exe を探すこともできます。


5 ［ショートカットの名前を指定してください］テキストボックスに「PowerCap 営業支援システム」と入力します。


デスクトップ上に、ショートカットのアイコンとその名前が表示されます。


ショートカットの作成

アプリケーションを実行できるように、そのショートカットのプロパティを修正します。また、アイコンを変更することもできます。

7 デスクトップ上の［PowerCap 営業支援システム］アイコンを右クリックします。ポップアップメニューで［プロパティ］を選択します。

デスクトップショートカットのプロパティシートが表示されます。

8 ［ショートカット］タブを選択します。［作業フォルダ］ボックスに Powersoft の共有モジュールフォルダへのパスを入力します。［OK］をクリックします。

共有モジュールの格納場所についてPowerBuilder をインストールすると、各 DLL ファイルが共有ディレクトリにインストールされます。デフォルトのインストール先は「C:¥Program Files¥Sybase¥Shared¥PowerBuilder」です。

ユーザが実行ファイルをダブルクリックしてアプリケーションを実行できるようにするには、システム環境パスに共有ディレクトリの場所を含める必要があります。

240 PowerBuilder


実行ファイルのテスト

現在の学習個所プロジェクトオブジェクトの作成実行ファイルの作成ショートカットの作成

> 実行ファイルのテスト

このステップでは、新しく作成した実行ファイルをテストします。

1 pbtutor.ini ファイルが実行ファイル pbtutor.exe と同じディレクトリに格納されていることを確認します。

2 チュートリアルアプリケーションのアイコンをダブルクリックします。

アプリケーションの実行が開始されます。

3 アプリケーションをテストします。顧客情報に加えた変更に注意してください。

4 アプリケーションのテストを終えたら、［ファイル｜終了］を選択します。

次のステップについてお疲れさまでした。これでチュートリアルの第 1 部と第 2 部が終了しました。このチュートリアルでは PowerBuilder でのアプリケーション構築の基本的な方法を学習しました。 PowerBuilder Enterprise 版を使用する開発者の場合は、 Web ターゲットのレッスンに進むことができます。

このマニュアルの冒頭の「本書について」には、 PowerBuilder の各マニュアルについての説明が記載されています。さらに高度な開発技術を学習するには、以下のマニュアルに進んでください。

『ユーザーズガイド』『アプリケーションテクニック』『データウィンドウプログラマーズガイド』


次のステップについて

242 PowerBuilder

第 3 部 Web アプリケーションの構築

第 3 部は、 PowerDynamo Web ターゲットの使用方法を示したチュートリアルです。簡単な Web アプリケーションの作成方法を手順を追って説明します。

レッスン 1 2 Web ページの作成

PowerBuilder の Web ターゲットを使用すると、 Web ページ、スクリプト、マルチメディア、画像、およびさまざまなソースのデータへのリンクを格納するワークスペース内で Web サイトを開発できます。


• PowerDynamo Web サイトの作成

• 基本 Web ページの作成と修正

• ページナビゲーションの追加

• 検証とリダイレクトを行うログインページの作成

• スタートページの指定

• Web サイトの配布と実行


このチュートリアルを開始する前にインストールが必要なもの Web ターゲットチュートリアルでは、ローカルマシンに以下のソ

フトウェアがインストールされている必要があります。


• PowerDynamo 3.6 以降

• Internet Explorer 6.0 以降

Jaguar Manager でサーバの設定を変更すれば、 PowerDynamo サーバを EAServer に組み込んで実行することもできますが、このチュートリアルでは、 PowerDynamo Personal Web Server を独立したプロセスとして実行します。


このチュートリアルを開始する前に

このチュートリアルに必要なファイルの入手

Web ターゲットチュートリアルでは、第 2 部で作成したいくつかのファイルを使用する必要があります。

第 2 部を近学習した場合必要なファイルはすでに用意できているはずです。開始する前に、 myworkspace.pbw、 pbtutor.pbt、 pbtutor.pbl、tshirtw.jpg、 tutor_pb.pbl、および Tutorial.ico ファイルが Tutorial ディレクトリにあることを確認してください。

第 3 部だけを学習する場合必要なファイルは Solutions ディレクトリに入っています。開始する前に、 myworkspace.pbw、 pbtutor.pbt、およびpbtutor.pbl をご自分の Tutorial ディレクトリにコピーしてください。

246 PowerBuilder

レッスン 12 Web ページの作成

PowerDynamo Web サイトの作成

現在の学習個所> PowerDynamo Web サイトの作成

基本 Web ページの作成と修正ページナビゲーションの追加検証とリダイレクトを行うログインページの作成スタートページの指定Web サイトの配布と実行

PowerDynamo Web サイトは、 HTML ドキュメントやデータを作成、格納、管理、およびアクセスできるファイルまたはデータベースリポジトリです。PowerDynamo を使用すると、Web ページにサーバサイドの命令を埋め込むことができます。 Web クライアントが、そのページを表示したりそのページと対話したりすると、この命令が処理されます。

PowerDynamo は、動的な Web コンテンツを生成するアプリケーションサーバです。データベースから情報を検索したり、検索結果を見やすい形式に整えて Web サーバに返したりします。また、開発時に使用する Personal Web サーバも提供します。

PowerDynamo に配布すると、配布構成によって HTML ページが処理され、アプリケーションサーバが使用する書式との互換性がとられます。 HTML 要素のリンクが更新され、実際の配布ファイル構造が反映されます。この処理には、以下のものが含まれます。

• サーバスクリプト内で使用される Web ターゲットオブジェクトと、アプリケーションサーバ上のオブジェクトおよびメソッド（オブジェクトモデル）とのマッピング

• HTML エディタ内のサーバスクリプト用の区切り記号（<% と %>）を PowerDynamo スクリプト用の区切り記号（）と置換

1 PowerBuilder で［ファイル｜ワークスペースを開く］を選択し、Tutorialフォルダに移動します。 MyWorkspace.pbw を選択し、［開く］をクリックします。

初のチュートリアルを近学習した場合は、このワークスペースがすでに開いている可能性があります。初のチュートリアルを近学習していないため、 MyWorkspace.pbw が見つからない場合は、27 ページの「チュートリアルのセットアップ」の手順に従ってください。

PowerDynamo Web サイトの作成

2 パワーバーの［新規作成］ボタンをクリックします。新規作成ダイアログボックスの［ターゲット］タブをクリックし、［PowerDynamo Web サイト］を選択します。［OK］をクリックします。

PowerDynamo Web サイトウィザードの紹介ページが表示されます。


［ターゲットの場所とフォルダの選択ウィザード］ページが表示されます。 Web ターゲットのデフォルト名は Target1 です。

4 Target1.pbt のかわりに「Customer.pbt」と入力します。

5 ［HTTP サーバ情報の指定］ページが表示されるまで［次へ］をクリックします。

以下の項目についてデフォルトの設定をそのまま使用します。

6 ［HTTP サーバ情報の指定］ページの［HTTP サーバ名］に「localhost」と入力します。デフォルトポート番号の 80 を使用します。

localhost という指定は、作成する Web サイトをローカルマシン上に置くことを意味します。

統合サーバの使用EAServer に統合されている PowerDynamo Web サーバを使用する場合は、HTTP リスナ用に HTTP サーバ名とポート番号を選択する必要があります。デフォルトでは、ご使用のマシン名が HTTP サーバ名になり、ポート番号は 8080 になります。

ウィザードオプションデフォルト

［URL 接頭辞マッピング］ /Customer

［ODBC データソース名］ Customer［新しいローカルデータベースファイル名］

Customer.db

［ユーザ ID］および［パスワード］ dba と ***［Web サイトへ PowerDynamo ヘルプファイルとサンプルをロードする］

チェックなし

［配布構成の名前］および［説明］ CustomerDeployConfiguration1配布構成

248 PowerBuilder


7 ［PowerDynamo Web サイトの作成準備完了］ページが表示されるまで［次へ］をクリックします。


デフォルトの Web ターゲットオブジェクトモデルを使用すると、1 つのソースから複数のサーバプラットフォームに配布できるサーバサイドロジックを記述できます。配布エンジンによって、これらのターゲットプラットフォームに適した構文にソースが変換されます。

8 ［PowerDynamo Web サイトの作成準備完了］ページの選択内容を確認します。［完了］をクリックして選択内容を受け入れます。

Customer ターゲット、ファイルを格納するディレクトリ構造、Adaptive Server Anywhere データベースを使用する PowerDynamoWeb サイト、および配布構成が作成されます。システムツリーでMyWorkspace を展開すると、新規の Web ターゲットである Customerがその下に置かれていることがわかります。


［オブジェクトモデル］

［デフォルトのオブジェクトモデルを使用する］

［デバッグを有効にする］

チェックなし

［配布対象］［すべて配布または、配布しない］

［再構築］［Incremental］［コピーフォルダ］ Program Files¥Sybase¥PowerBuilder 9.0¥Tutorial

¥Customer¥CustomerDeployConfiguration1


基本 Web ページの作成と修正


現在の学習個所 PowerDynamo Web サイトの作成> 基本 Web ページの作成と修正

ページナビゲーションの追加検証とリダイレクトを行うログインページの作成スタートページの指定Web サイトの配布と実行

このレッスンでは、ウェルカムページを作成し、そのページのルックアンドフィールを修正します。すべての機能がこの時点で追加されるわけではありません。実際に使用できる Web サイトを非常に簡単に作成できることを示すことが目的です。

• 4GL を用いた Web ページの作成

• フォントの変更

• グラフィックの追加

• グラフィックへの絶対位置の追加

4GL を用いた Web ページの作成

このレッスンでは、 Welcome.htm ページを作成します。このページから、このチュートリアルで作成するその他のページにアクセスできます。 4GL Web/JSP ページウィザードを使用して、このウェルカムページを作成します。 4GL 機能を使用すると、ユーザ主導の動的なコンテンツを持つページを簡単に開発できます。

4GL Web ページは、拡張 Web ターゲットオブジェクトモデルが組み込まれた高度な Web ページです。この拡張モデルによって、（Web ページを変更せずに Web ページのコンテンツの一部を変更する）動的 Webページのテンプレート（ソース）ファイルを作成できます。 4GL Webページは、オブジェクトモデルに基づいて、データ転送、HTML 生成、およびサーバスクリプトの JavaScript 生成を処理します。

250 PowerBuilder


1 Customer ターゲットアイコンを右クリックし、［新規作成］を選択します。新規作成ダイアログボックスで［Web］タブをクリックします。

Web ページを作成するウィザードは、 Quick Web/JSP ページ、Web/JSP ページ、 4GL Web/JSP ページ、 Web/JSP データウィンドウページ、およびフレームセットページの 5 つから選択できます。このチュートリアルでは、 Web/JSP ページ、 4GL Web/JSP ページ、および Web/JSP データウィンドウページウィザードを使用します。

ターゲット名の確認ターゲットウィザードによって作成されたターゲットは、新規作成ダイアログボックス下部の［ターゲット］リストボックスに追加されます。作成した Customer ターゲットが表示されます。

2 ［4GL Web/JSP ページ］アイコンをダブルクリックします。

3 ［次へ］をクリックします。［タイトル］テキストボックスにタイトルの「Welcome」を入力し、〔Tab〕を押します。

［ファイル名］テキストボックスのファイル名は、デフォルトでWelcome.htm になります。

4 ［背景属性の指定］ページが表示されるまで［次へ］をクリックします。［背景の色］に「Yellow」を指定します。

5 ［ページパラメータの定義］ページが表示されるまで［次へ］をクリックし、ウィザードのデフォルトを受け入れていきます。［パラメータ名］に「ID」と入力し、［デフォルト値］を空白のままにします。［次へ］をクリックします。



6 ［EAServer コンポーネントのスキップ］チェックボックスをオンにします。

EAServer 情報は、次のレッスンで追加します。

7 ［次へ］をクリックします。［完了］ボタンをクリックします。

新規の Web ページが作成され、ページ編集ビューに表示されます。ファイル名は Welcome.htm です。

8 ページ編集ビューで、デフォルトテキストの「ここにデータを置きます」を選択します。「PowerCAP 営業支援システム」と入力します。

このチュートリアルでは、 Web ページに対するすべての変更をページ編集ビューで行います。同じ変更を HTML ソースビューで行うには HTML の知識が必要です。

9 メニューバーから［ファイル｜保存］を選択して、変更内容を保存します。

252 PowerBuilder


フォントの変更

HTML エディタで Web ページの見た目を変更するのは簡単です。

1 テキストの末尾にカーソルを置き、〔Enter〕を押します。テキスト「PowerCap 営業支援システム」の中にカーソルを置きます。ポップアップメニューから「段落プロパティ」を右クリックして選択します。

2 ［インラインスタイル］タブをクリックします。［インライン］を選択し、［編集］ボタンをクリックしてから、［フォント］タブをクリックします。

3 ［使用できるフォント］リストをスクロールして、「MS ゴシック」フォントを選択します。矢印ボタンをクリックして「MS ゴシック」を［選択されたフォント］リストボックスに移動します。

4 ［フォントサイズ］で［単位を指定］ラジオボタンをクリックします。「20」と入力し、［単位を指定］ラジオボタンの横のボックスから「pt （ポイントサイズ）」を選択します。［色］ドロップダウンリストボックスから「Red」を選択します。

5 ［背景］タブをクリックしてから、［相対］ラジオボタンをクリックします。［横方向の位置］と［縦方向の位置］の下のドロップダウンリストボックスから「center」を選択します。［背景色］の横のドロップダウンリストボックスから「Blue」を選択します。

6 ［OK］を 2 回クリックします。

フォントの変更内容がテキストに適用されます。

ページ編集ビューポップアップメニューの「非表示タグを表示」がチェックされている場合だけ、段落タグが表示されます。ページ編集ビュー内のページを右クリックして、ポップアップメニューを表示します。

7 メニューバーから［ファイル｜保存］を選択します。



グラフィックの追加

このステップでは、ウェルカムページに画像ファイルを追加します。

1 システムツリーで Customer ターゲットを右クリックします。ポップアップメニューで［新規フォルダ］をクリックします。

2 フォルダ名に「Graphics」と入力し、〔Enter〕を押します。

3 Graphics フォルダを右クリックし、［ファイルのインポート］を選択します。［ファイルの種類］ドロップダウンリストボックスから「すべてのファイル」を選択します。

4 Tutorial フォルダに移動し、ファイルの種類として「画像ファイル」を選択します。tshirtw.jpg を選択し、［開く］をクリックします。

この画像ファイルが Graphics フォルダにコピーされます。

5 Welcome.htm ページの中をクリックします。PowerCap タイトルの下の段落にカーソルを置きます。〔Enter〕を押して、タイトルの下にスペースを追加します。

6 PowerCap タイトルの下の段落に再びカーソルを置きます。メニューバーの［挿入｜画像］を選択します。

7 ［画像ファイル］テキストボックスの横の参照（［...］）ボタンをクリックします。

8 URL の選択ダイアログボックスの［ターゲット］ページの Graphics フォルダを展開します。

254 PowerBuilder


9 このフォルダからファイル名「tshirtw.jpg」を選択します。

10 URL の選択ダイアログボックスで［OK］をクリックし、画像プロパティダイアログボックスでも［OK］をクリックします。

白い T シャツ（tshirtw.jpg）の画像がウェルカムページに表示されます。

グラフィックへの絶対位置の追加

このステップでは、ページ上の特定の位置に画像を固定します。絶対位置を使用すると、画面サイズに関係なく、ページ上にグラフィックを表示する位置を固定できます。

1 T シャツのグラフィックを右クリックします。ポップアップメニューで［位置｜絶対位置を使用］を選択します。

2 見出しの下にあるグラフィックをドラッグして、青いバーの下の中央に揃えます。



3 ［プレビュー］タブをクリックし、配布時のページの見た目を確認します。


256 PowerBuilder


ページナビゲーションの追加

現在の学習個所 PowerDynamo Web サイトの作成基本 Web ページの作成と修正

> ページナビゲーションの追加検証とリダイレクトを行うログインページの作成スタートページの指定 Web サイトの配布と実行

このレッスンでは、商品情報を表示する新規の Web ページを追加します。さらに、この新規ページにアクセスするハイパーリンクをウェルカムページに追加します。後に、新規の商品情報を追加できる Webページまで終的に移動するボタンを新規ページに追加します。そのほかの機能をこの Web ページへ追加する作業は、後のレッスンで行います。

• 商品情報の Web ページの作成

• ハイパーリンクの追加

• ボタンの追加

商品情報の Web ページの作成

このステップでは、商品情報を表示および追加する Web ページを作成します。この新規の Web ページには、ウェルカムページからアクセスします。この新規のページは 4GL ウィザードを使用しなくても作成できますが、4GL Web ページを使用すると、サーバサイドスクリプト機能が埋め込まれ、データベース情報に容易にアクセスできるようになります。

1 システムツリーで Customer ターゲットを右クリックします。ポップアップメニューから［新規作成］を選択します。

2 ［4GL Web/JSP ページ］アイコンをクリックし、［OK］をクリックします。

4GL Web ページウィザードについてページが表示されます。

3 ［次へ］をクリックします。［タイトル］テキストボックスにタイトルの「Product」を入力し、〔Tab〕を押します。



［ファイル名］テキストボックスのファイル名は、デフォルトでProduct.htm になります。

4 ［ページパラメータの定義］ページが表示されるまで［次へ］をクリックします（ウィザードのデフォルトを受け入れていきます）。［パラメータ名］に「ID」と入力し、［デフォルト値］を空白のままにします。［次へ］をクリックします。

［EAServer プロファイルの選択］ページが表示されます。


6 ［次へ］をクリックします。ページプロパティのまとめを確認し、［完了］をクリックします。

Product.htm ページがページ編集ビューに表示されます。

7 デフォルトテキストの「ここにデータを置きます」をハイライト表示します。「商品情報」と入力します。〔Enter〕を押します。

8 ［ファイル｜保存］を選択して、これまでの変更内容を保存します。

ハイパーリンクの追加

このステップでは、商品 Web ページにアクセスするハイパーリンクをウェルカムページに追加します。

1 ウェルカムページ（Welcome.htm）を表示します。「PowerCap 営業支援システム」の 2 つ下の段落の中にカーソルを置き、〔Enter〕を 2 回押します。

258 PowerBuilder


2 メニューバーから［書式｜ハイパーリンク］を選択します。

ハイパーリンクプロパティダイアログボックスが表示されます。

3 ［リンク文字列］テキストボックスに「商品情報を表示」と入力します。［行先］テキストボックスの横の参照（［...］）ボタンをクリックします。

URL の選択ダイアログボックスが開き、Customer ターゲット内ですでに作成された Web ページが表示されます。

4 「Product.htm」を選択し、［OK］をクリックします。

5 ［OK］を再度クリックして Web ページにハイパーリンクを追加します。

下線付きのハイパーリンク「商品情報を表示」がウェルカムページに表示されます。

6 メニューバーから［ファイル｜保存］を選択します。ウェルカムページを閉じます。

ボタンの追加

このステップでは、商品ページにボタンを追加します。ボタンは Webページ上での一般的なナビゲーションツールです。このチュートリアルの後の方では、ナビゲーションロジックをこのボタンに追加します。



1 商品ページ（Product.htm）を表示します。「商品情報」の見出しの下の段落にカーソルを置きます。

2 メニューバーから［挿入｜フォームフィールド｜コマンドボタン］を選択します。

Button プロパティダイアログボックスが表示されます。

3 ［ボタンの種類］ドロップダウンリストから「Button」を選択します。［名前］テキストボックスに「cb_addproduct」と入力します。［ラベル］テキストボックスに「商品の追加」と入力します。


Product.htm ページにボタンが表示されます。

次のレッスンではこのボタンを Web ページに接続します。


6 商品ページを閉じます。

260 PowerBuilder


検証とリダイレクトを行うログインページの作成

現在の学習個所PowerDynamo Web サイトの作成基本 Web ページの作成と修正ページナビゲーションの追加

> 検証とリダイレクトを行うログインページの作成スタートページの指定Web サイトの配布と実行

このステップでは、 4GL 機能を持つログイン Web ページ（Login.htm）を追加します。このログインページは単純な設計です。このチュートリアルでは、サーバサイドの検証スクリプトによってユーザ名とパスワードが同じかどうか判別されます。これは検証ロジックによって判別されます。本番アプリケーションでは、より高度な検証ロジックを使用します。

ログイン情報が入力条件則を満たしたら、サーバリダイレクトを追加してウェルカムページに移動します。

ユーザ名とパスワードはセッション変数として保存されます。このセッション変数は、 Web セッション全体にわたって有効となります。

この練習では以下の操作を行います。

• 基本ログインページの作成

• セッション変数の追加

• シングルラインテキストコントロールの追加

• パスワードの検証の追加

• サーバリダイレクトの追加



基本ログインページの作成

まず、 4GL ウィザードを使用してログインページを作成します。

1 Customer ターゲットを選択した状態で、メニューバーから［ファイル｜新規作成］を選択します。［Web］タブをクリックします。

2 ［4GL Web/JSP ページ］アイコンをクリックします。［OK］をクリックします。

［4GL Web ページウィザードについて］ページが表示されます。

3 ［次へ］をクリックします。［タイトル］テキストボックスにタイトルの「Login」を入力し、〔Tab〕を押します。

［ファイル名］テキストボックスのファイル名は、デフォルトでLogin.htm になります。

4 ［ページパラメータの定義］ページが表示されるまで［次へ］をクリックします（ウィザードのデフォルトを受け入れていきます）。

5 ［パラメータ名］に「ID」と入力し、［デフォルト値］を空白のままにします。［次へ］をクリックします。

［EAServer プロファイルの選択］ページが表示されます。


7 ［次へ］をクリックします。ページプロパティのまとめを確認し、［完了］をクリックします。

Login.htm ページがページ編集ビューに表示されます。


262 PowerBuilder


セッション変数の追加

セッション変数では、ユーザログイン情報や、ユーザのブラウザセッション中に Web アプリケーション内すべてのページで利用したいそのほかのデータを追跡できます。

1 ページ編集ビューで、デフォルトテキストの「ここにデータを置きます」をハイライト表示します。このハイライト表示したテキストを、次のテキストで置き換えます。

ログインしてください

2 〔Enter〕を押します。新しい行に、以下のテキストを入力し、各行の末尾で〔Enter〕を押します。

名前

パスワード

3 Login.htm ページを右クリックして、ポップアップメニューから［ページプロパティ］を選択します。［変数］タブをクリックします。

4 ［変数名］の下でクリックし、もう一度クリックし、新規の変数名を「user」と入力します。

5 〔Tab〕を押して［ライフタイム］カラムに移動し、ドロップダウンリストボックスから「session」を選択します。〔Tab〕を押して［クライアントアクセス］カラムに移動し、ドロップダウンリストボックスから「Read/Write」を選択します。

6 ［変数名］カラム内の user の下でクリックし、もう一度クリックし、新規の変数名を「pswd」と入力します。



7 〔Tab〕を押して［ライフタイム］カラムに移動し、ドロップダウンリストボックスから「session」を選択します。〔Tab〕を押して［クライアントアクセス］カラムに移動し、ドロップダウンリストボックスから「Read/Write」を選択します。


これでユーザログイン情報のための 2 つのセッション変数が定義されました。

シングルラインテキストコントロールの追加

テキストコントロールは、サーバスクリプトによって操作できる特殊なテキストフィールドです。クライアントはこのテキストの値を変更できません。これは 4GL Web ページでのみ使用可能です。

1 Login.htm ページで、名前という文字の後にカーソルを置き、スペースを2 つ入力します。メニューバーから［挿入｜フォームフィールド｜シングルラインテキスト］を選択します。

テキストコントロールプロパティダイアログボックスが表示されます。

2 ［名前］テキストボックスに「sle_user」と入力し、［サーバに処理を記述する］チェックボックスがオンになっていることを確認します。

264 PowerBuilder

3 ［バインド］タブをクリックします。［コンポーネント名］ドロップダウンリストボックスから「SessionVariable」を選択します。［プロパティ名］ドロップダウンリストボックスから「user」を選択して、［OK］をクリックします。

名前というテキストの後にテキストボックスが挿入されます。

4 ページ編集ビューで、パスワードという文字の後にカーソルを置き、スペースを 2 つ入力します。［挿入｜フォームフィールド｜シングルラインテキスト］を選択します。

5 ［名前］テキストボックスに「sle_pswd」と入力します。［パスワード］チェックボックスをオンにします。［サーバに処理を記述する］チェックボックスがオンになっていることを確認します。

［パスワード］チェックボックスをオンにすると、ユーザが入力したパスワードがアスタリスクで表示されます。テキストボックスを Web ページに追加した後でこの機能を追加することはできません。

6 ［バインド］タブをクリックします。［コンポーネント名］ドロップダウンリストボックスから「<SessionVariable>」を選択します。［プロパティ名］ドロップダウンリストボックスから「pswd」を選択して、［OK］をクリックします。

パスワードというテキストの後にテキストボックスが挿入されます。


パスワードの検証の追加

検証にはクライアントサイドまたはサーバサイドのスクリプトを使用できます。この練習では、サーバサイドスクリプトを使用して、ユーザが入力したユーザ名が、ユーザが入力したパスワードと同じかどうかを判別します。この検証用コードはあくまで例です。通常は、ユーザ名とパスワードをデータベースと照合して検証します。

次のレッスンでは、ログインが完了した後にウェルカムページを表示するコードを追加します。ユーザ名とパスワードが一致しない場合は、再試行するようユーザに依頼するエラーメッセージを表示します。

1 ログインページ上で［パスワード］テキストボックスの下の段落にカーソルを置き、〔Enter〕を押します。メニューバーから［挿入｜フォームフィールド｜コマンドボタン］を選択します。


2 ［ボタンの種類］ドロップダウンリストボックスで「Button」を選択します。［名前］テキストボックスに「cb_login」と入力します。［ラベル］テキストボックスに「ログイン」と入力します。

4GL Web ページでは、送信（Submit）ボタンの種類と標準ボタンの種類（ボタン）は同じように機能し、どちらにもクライアントサイドの onclick イベントとサーバサイドの Server Action イベントがあります。


［パスワード］テキストボックスの下に新しい［ログイン］ボタンが表示されます。

266 PowerBuilder


4 ページ編集ビュー下部のスクリプトエディタの初のドロップダウンリストボックスで、「cb_login」を選択します。

5 中央のドロップダウンリストボックスをスクロールして、「ServerAction（）」を選択します。

サーバサイドイベントは青い文字で表示されます。

6 スクリプトエディタに以下のように入力します。

if (sle_user.value == sle_pswd.value){user = sle_user.value;pswd = sle_pswd.value;

このスクリプトは、ユーザ名とパスワードが同じかどうかを判別し、同じであれば、クライアントが入力したユーザ名とパスワードを、セッション変数に代入します。

7 〔Enter〕を押します。今入力したスクリプトの下に、次のコメント行を入力します。

// リダイレクトをここに追加する

リダイレクト呼び出しの追加は、このチュートリアルの次のレッスンで行います。

8 〔Enter〕を 2 回押します。次の else 文を入力してエラーメッセージを追加します。

} else {

psPage.Alert （"ユーザ名とパスワードは無効です。再入力してください "） ;

}

9 ペインタバーの［保存］ボタンをクリックします。



サーバリダイレクトの追加

大部分の 4GL Web ページは、サーバリダイレクトによってほかのページに移動します。サーバリダイレクトは、ページ間を移動する方法としてはもっとも柔軟性の高いものです。

サーバリダイレクトが使用されるのは、ほかのページに渡されるパラメータ値がユーザ入力に依存する場合、またはユーザ入力を検証したい場合です。このステップでは、ターゲットページ（ウェルカムページ）の指定およびログインページのユーザ入力値の検証を行うサーバスクリプトを含めるように、 4GL ログインページを変更します。

1 Login.htm ページ下部のスクリプトエディタで、コメント行「// リダイレクトをここに追加する」の 2 行下にカーソルを置きます。右クリックし、ポップアップメニューから［リダイレクトの挿入］を選択します。

リダイレクトプロパティダイアログボックスが表示されます。

2 ［ロケーション］テキストボックスの横の参照（［...］）ボタンをクリックします。コンテンツ Customer ツリービューから Welcome.htm を選択します。


スクリプトエディタでコードのブロックが挿入されます。ポップアップメニューの［リダイレクトの編集］または［リダイレクトの削除］コマンドを使用して、このコードのブロックを修正または削除できます。


268 PowerBuilder


スタートページの指定

現在の学習個所PowerDynamo Web サイトの作成基本 Web ページの作成と修正ページナビゲーションの追加検証とリダイレクトを行うログインページの作成

> スタートページの指定Web サイトの配布と実行

このステップでは、Web サイトを PowerBuilder から直接テストおよび実行できるスタートページを選択します。

1 システムツリーで、 Customer を右クリックします。ポップアップメニューで［プロパティ］を選択します。

ターゲット Customer のプロパティダイアログボックスが表示されます。

2 ［実行 / デバッグ］タブをクリックし、［スタートページ］テキストボックスの横の参照（［...］）ボタンをクリックします。

3 URL の選択ダイアログボックスの［ターゲット］ページで、 Login.htmを選択し、［OK］をクリックします。

4 ターゲット Customer のプロパティダイアログボックスの［データベース］タブをクリックします。

5 ［プロファイル名］リスト内の［EAS Demo DB V9 ］チェックボックスをオンにします。［OK］をクリックします。

PowerDynamo Web Site ウィザードで作成した Customer データベースには、 Web のメタデータが含まれます。 EAS Demo データベースをアプリケーションデータベースとして使用します。

データベースプロファイルの設定EAS Demo DB V9 は、PowerBuilder をインストールするときに使用可能なデータベースプロファイルです。詳細については、レッスン 3、 EAS Demo DB データベースの参照を参照してください。

これで Customer ターゲットを配布する準備ができました。



Web サイトの配布と実行


現在の学習個所PowerDynamo Web サイトの作成基本 Web ページの作成と修正ページナビゲーションの追加検証とリダイレクトを行うログインページの作成スタートページの指定

> Web サイトの配布と実行

このステップでは、 Web サイトを配布します。

1 システムツリーで、 Customer ターゲットを右クリックします。ポップアップメニューで［配布］を選択します。

配布が終了すると、出力ビューに「終了ターゲットの配布 Customer」と表示されます。

2 Windows の［スタート］メニューをクリックしてから、［プログラム｜Sybase ｜ PowerDynamo 3.6 ｜ Personal Web Server］を選択します。

PowerDynamo Personal Web Server が起動します。［Personal WebServer］アイコンが Windows のタスクバーに表示されます。

3 メニューバーから［実行｜選択して実行］を選択します。ターゲットの選択ダイアログボックスで［Customer］を選択します。［OK］をクリックします。

270 PowerBuilder


デフォルトのブラウザが開きます。 URL アドレスボックスには、作成した Login.htm Web ページのファイルパスが入っています。ログインページが表示されます。

4 ［名前］テキストボックスに「Hello」と入力し、［パスワード］テキストボックスに「Good-bye」と入力します。［ログイン］ボタンをクリックします。

ユーザ名とパスワードが一致しないため、エラーメッセージが表示されます。

5 ［OK］をクリックします。［名前］テキストボックスと［パスワード］テキストボックスの両方に「Hello」と入力します。［ログイン］ボタンをクリックします。



今度はウェルカムページが表示されます。

6 ［商品情報を表示］ハイパーリンクをクリックします。

商品情報 Web ページ（Product.htm）が表示されます。

次のレッスンでは、商品情報ページに Web データウィンドウを追加します。

7 ブラウザを閉じます。

272 PowerBuilder

レッスン 1 3 Web データウィンドウの使い方

Web データウィンドウでは、データソースとクライアントブラウザとのインタフェースが提供され、データソースからの結果セットが Web ページ上に表示されます。


• EAServer 接続プロファイルのセットアップ

• Web データウィンドウコンテナの構築

• Web データウィンドウコンテナを使用しての Web ページの作成

• データウィンドウ Web ページへのほかのコントロールの追加

• 既存の Web ページへのデータウィンドウの追加

• 商品情報の検索機能の追加

• Web アプリケーションのテストと実行


このレッスンを開始する前に

Web データウィンドウのレッスン中に問題が起きないように、Sybase¥EAServer¥Html¥Classes フォルダが、ご使用のシステムのCLASSPATH 環境変数にリストされていることを確認してください。

以下の点も確認する必要があります。

• Sybase¥Shared¥Sun¥Jdknnn¥JRE¥Bin¥Client ディレクトリがPATH 環境変数にリストされている（nnn は使用する JDK のバージョンを表す）こと。 JDK 1.4 を使用する場合は、かわりに、Sybase¥Shared¥PowerBuilder¥JDK14¥JRE¥Bin¥Client ディレクトリを PATH 環境変数のリストに追加する。

• PowerDynamo で正しいバージョンの Java VM が使用されている


チェックするには、まず Sybase Central を開き、 PowerDynamo 3.6の下のユーティリティフォルダと設定フォルダを展開します。左ペインのデフォルトの JAVA 設定および右ペインの Java VM をダブルクリックし、ドロップダウンリストボックスから「Sun JavaVM 1.2」を選択します。

274 PowerBuilder

レッスン 13 Web データウィンドウの使い方

EAServer 接続プロファイルのセットアップ

現在の学習個所> EAServer 接続プロファイルのセットアップ

Web データウィンドウコンテナの構築Web データウィンドウコンテナを使用しての Web ページの作成データウィンドウ Web ページへのほかのコントロールの追加既存の Web ページへのデータウィンドウの追加商品情報の検索機能の追加Web アプリケーションのテストと実行

このステップでは、 EAServer の接続プロファイルをセットアップします。このチュートリアルでは、読者がローカルマシンで EAServer を使用していることを前提としています。

1 Windows の［スタート］メニューから、［プログラム｜ Sybase ｜EAServer 4.2 ｜ Jaguar Server］を選択して EAServer を起動します。

DOS ウィンドウが表示され、サーバが起動されます。「AcceptingConnections」というメッセージが表示されたら、DOS ウィンドウを小化します。

2 PowerBuilder のメニューバーから、［ツール｜ EAServer プロファイル］を選択します。

次の画面が表示されます。

3 ［追加］をクリックします。


EAServer 接続プロファイルのセットアップ

EAServer プロファイルの編集ダイアログボックスが開きます。

4 以下の情報を入力します。

5 入力を終えたら［テスト］をクリックします。

「Connection Successful」というメッセージが表示されます。

6 ［OK］を 2 回クリックし、［終了］をクリックします。

プロファイルのプロパティ入力する値

プロファイル名 local

サーバ名マシン名（ローカルマシンの名前を入力する。デフォルトでは、このサーバ名へのリスナがインストールされる）

ポート番号 9000ログイン jagadmin

パスワードなし（空白のままにする）

276 PowerBuilder


Web データウィンドウコンテナの構築

現在の学習個所EAServer 接続プロファイルのセットアップ

> Web データウィンドウコンテナの構築Web データウィンドウコンテナを使用しての Web ページの作成データウィンドウ Web ページへのほかのコントロールの追加既存の Web ページへのデータウィンドウの追加商品情報の検索機能の追加Web アプリケーションのテストと実行

Web データウィンドウコンテナでは、ページに必要なすべてのサポートファイルとプロパティが、サーバ上にインストールされた 1 つの領域に集められます。

Web データウィンドウコンテナウィザードでは、HTMLGenerator90 インタフェースを実装してすべてのデータウィンドウオブジェクトをデータベース接続情報と一緒にパッケージするカスタム EAServer コンポーネントが作成されます。

このレッスンでは、Web データウィンドウコンテナウィザードを使用して Web データウィンドウコンテナを構築し、サーバにコンポーネントを直接配布して Web アプリケーションが使用できるようにします。

1 メニューバーから［ファイル｜新規作成］を選択し、新規作成ダイアログボックスの［プロジェクト］タブをクリックします。

2 ［Web DW コンテナウィザード］アイコンを選択して［OK］をクリックします。ウィザードの初のページで［次へ］をクリックします。

3 ［アプリケーションライブラリ］リストで「pbtutor.pbl」ファイルが選択されていることを確認して、［次へ］をクリックします。

［プロジェクトの指定］ページが表示されます。


デフォルトのプロジェクト名「p_pbtutor_webdw」を使用します。

5 まだ選択されていない場合は、［データベースプロファイル］リストから「EAS Demo DB V9」を選択します。


Web データウィンドウコンテナの構築

6 後のウィザードページが表示されるまで［次へ］をクリックし、以下のデフォルトを受け入れていきます。


p_pbtutor_webdw プロジェクトがプロジェクトペインタに表示されます。

8 メニューバーの［デザイン｜プロジェクトの配布］を選択します。

これにより、ローカルマシンで稼働している EAServer のパッケージおよびコンポーネントとして、プロジェクトを構築して配布します。このコンポーネントは、 DataWindow::HTMLGenerator90 インタフェースを使用したカスタムの Web データウィンドウコンテナです。

9 メニューバーから［ファイル｜閉じる］を選択して、プロジェクトを閉じます。プロジェクトファイルを保存するように要求されたら、［はい］を選択します。

ウィザードオプションデフォルト値

EAServer プロファイルの選択

local （今追加したプロファイル）

EAServer コンテナとパッケージ名の指定

pbtutor_component pbtutor_package

インスタンスプーリングオプションの指定

サポートする

その他のコンポーネントオプションの指定

指定なし

動的ライブラリオプションの指定

統合動的ライブラリ（PBD）の構築（選択）

統合 PBD に参照されないオブジェクトを含める（選択）

pbtutor.pbd （統合化 PBD ファイル名）

278 PowerBuilder


Web データウィンドウコンテナを使用しての Web ページの作成

現在の学習個所EAServer 接続プロファイルのセットアップWeb データウィンドウコンテナの構築

> Web データウィンドウコンテナを使用しての Web ページの作成データウィンドウ Web ページへのほかのコントロールの追加既存の Web ページへのデータウィンドウの追加商品情報の検索機能の追加Web アプリケーションのテストと実行

このレッスンでは、先ほど作成した Web データウィンドウコンテナを使用して、新規の Web ページ Addproduct.htm を作成します。

1 システムツリーの Customer ターゲットを右クリックして、ポップアップメニューから［新規作成］を選択します。

2 新規作成ダイアログボックスで［Web］タブをクリックします。［Web/JSP データウィンドウページ］アイコンをダブルクリックし、ウィザードの先頭ページで［次へ］をクリックします。

［新規 HTML ファイルの指定］ページが表示されます。

3 ［タイトル］テキストボックスに「Addproduct」と入力して、［次へ］を2 回クリックします。

ファイル名は、ページタイトルに入力したテキストに自動的に変わります。これで Web ページファイルの名前が Addproduct.htm になりました。このレッスンでは、新規のページに対してスタイルシートは指定しません。

4 「ローカルの EAServer プロファイル」をまだ選択していなければ選択してから、［次へ］をクリックします。

［Web DW コンポーネント形式の選択］ページが表示されます。

5 ［Web DW コンテナ］ラジオボタンを選択し、［次へ］をクリックします。

［EAServer データウィンドウコンポーネントの選択］ページが表示されます。


Web データウィンドウコンテナを使用しての Web ページの作成

6 ローカルサーバの下の項目を展開します。 pbtutor_package の下で、 pbtutor_component を選択します。


［データウィンドウオプジェクトの選択］ページが表示されます。

8 d_product を選択します。

280 PowerBuilder


9 ［次へ］をクリックします。［完了］をクリックして選択内容を受け入れます。

Addproduct.htm Web ページがページ編集ビューに表示されます。


データウィンドウ Web ページへのほかのコントロールの追加


現在の学習個所EAServer 接続プロファイルのセットアップWeb データウィンドウコンテナの構築Web データウィンドウコンテナを使用しての Web ページの作成

> データウィンドウ Web ページへのほかのコントロールの追加既存の Web ページへのデータウィンドウの追加商品情報の検索機能の追加Web アプリケーションのテストと実行

ここでは、商品情報テーブルに行を挿入してデータベースを更新するためのボタンコントロールを追加して、 Addproduct.htm ページを完成せさます。また、 Product.htm ページにハイパーリンクを追加します。

ページを完成させるには、次の作業を行います。

• 新規の商品情報ボタンの有効化

• データベースを更新するボタンの追加

• ［商品情報］ページへのハイパーリンクの追加

新規の商品情報ボタンの有効化

ここまでの作業によって、 Addproduct.htm ページには Web データウィンドウが含まれています。このステップでは、テキストとリンクをデータベースへ追加して、データベースへの商品情報の追加と、追加した情報をユーザが参照できる Product.htm ページへのリンクを作成します。

1 Addproduct.htm ページを右クリックして、ポップアップメニューから［ページプロパティ］を選択します。［4GL Web サーバサイドイベントモデルを使用する］チェックボックスをオンにして、［OK］をクリックします。

これでこのページは 4GL を使用できるようになりました。したがって、サーバサイドイベントのコーディング、および Web ページ上のコントロールへの変数とコンポーネントのバインドができます。

282 PowerBuilder


2 データウィンドウの左下隅にカーソルを置き、〔Enter〕を押します。Web データウィンドウの上の段落に、次のテキストを挿入します。

ここをクリックして商品情報を追加します

次に、データウィンドウに空白行を表示する新しいボタンを、このテキストの下に追加します。

3 このテキストの後ろで〔Enter〕を押します。メニューバーから［挿入｜フォームフィールド｜コマンドボタン］を選択します。

［Button プロパティ］ページが表示されます。

4 ［ボタンの種類］ドロップダウンリストボックスから「Button」を選択します。［ボタンの名前］テキストボックスに「cb_addproduct」と入力します。［ラベル］テキストボックスに「商品情報の追加」と入力します。

5 ［OK］をクリックして、Button プロパティダイアログボックスを閉じます。スクリプトエディタの初のドロップダウンリストボックスから「cb_addproduct」を選択します。

ページ編集ビュー内の［商品情報の追加］ボタンをクリックすると、スクリプトエディタの初のドロップダウンリストボックスに「cb_addproduct」が表示されます。

6 中央のドロップダウンリストボックスから「ServerAction()」を選択します。次のスクリプトを入力します。

webDW.InsertRow(0);

エンドユーザが Web ページ上の［商品情報の追加］ボタンをクリックすると、ユーザが入力できる空のテキストボックスを持つWeb データウィンドウが表示されます。

7 ページ編集ビューで「商品情報の追加」ボタンの右にカーソルを置いて、〔Enter〕を押します。次のテキストを入力します。

商品を追加してください。すべてのテキストボックスに情報を入力してから、［データベースの更新］をクリックしてください。



8 Web データウィンドウを右クリックします。ドロップダウンリストボックスから「Sybase Web DataWindow DTC 9.0プロパティ」を選択します。

9 ［コントロール］タブをクリックし、［重み］パネルの横の［上書き］ボックスをチェックします。［重み］パネルの項目をすべて選択します。

生成される HTML ページには、選択したクライアントサイド機能をすべてサポートする JavaScript コードが含まれます。

生成されるページのサイズ選択した各機能に対応する JavaScript コードが生成されます。必要な機能だけを選択すれば、Web ページのサイズを小さくできます。

10 ［ページあたりの行数］フィールドの［上書き］チェックボックスをオンにします。［ぺージあたりの行数］ボックスに「1」と入力します。

これによって、表示される商品情報の量が 1 レコードに制限されます。

11 ［検索］タブをクリックします。［自動検索］オプションをオフにして、［OK］をクリックします。

12 ペインタバーの［保存］ボタンをクリックします。

284 PowerBuilder


データベースを更新するボタンの追加

商品情報を追加したらデータベースを更新しなければならないので、このステップではデータベースを更新するボタンを追加します。

1 Web データウィンドウの右下の段落にカーソルを置き、〔Enter〕を押します。メニューバーから［挿入｜フォームフィールド｜コマンドボタン］を選択します。

Button プロパティページが表示されます。

2 ［ボタンの種類］ドロップダウンリストボックスから「Button」を選択します。［名前］テキストボックスに「cb_update」と入力します。［ラベル］テキストボックスに「データベースの更新」と入力します。

3 ［OK］をクリックして、Button プロパティダイアログボックスを閉じます。

4 スクリプトエディタの初のドロップダウンリストボックスで「cb_update」を選択します。中央のドロップダウンリストボックスから「ServerAction()」を選択します。

5 スクリプトエディタウィンドウに次のように入力します。

webDW.Update();

Web ページから［データベースの更新］ボタンを押すと、エンドユーザが入力した情報がデータベースに追加されます。

［商品情報］ページへのハイパーリンクの追加

ここでは、商品情報が更新されたことをユーザが確認できるように、Product.htm ページにリンクを追加します。

1 ページ編集ビューで［データベースの更新］ボタンの右にカーソルを置いて、〔Enter〕を押します。［書式｜ハイパーリンク］を選択します。



2 ［リンク文字列］テキストボックスに「商品情報」と入力します。［行先］テキストボックスの横の参照（［...］）ボタンをクリックします。

すでに作成された Web ページのターゲットリストを表示するウィンドウが開きます。

3 商品情報ページ（Product.htm）を選択します。

4 ［OK］を 2 回クリックして Web ページにハイパーリンクを追加します。

「商品情報」が、下線付きのハイパーリンクとして Addproduct.htmページに表示されます。


286 PowerBuilder


既存の Web ページへのデータウィンドウの追加

現在の学習個所EAServer 接続プロファイルのセットアップWeb データウィンドウコンテナの構築Web データウィンドウコンテナを使用しての Web ページの作成データウィンドウ Web ページへのほかのコントロールの追加

> 既存の Web ページへのデータウィンドウの追加商品情報の検索機能の追加Web アプリケーションのテストと実行

このステップでは、既存の Web ページにデータウィンドウを追加します。このデータウィンドウの［自動検索］チェックボックスをオフにします。これによって、 Web データウィンドウにアクセスするスクリプトがページに自動挿入されなくなります。次に、特定のデータウィンドウ検索引数を Web ページ上のパラメータにリンクし、そのデータウィンドウをプログラムによって検索します。

1 Product.htm ファイルを開きます。

2 商品情報段落の末尾にカーソルを置き、〔Enter〕を押します。メニューバーから［挿入｜フォームフィールド｜データウィンドウ］を選択します。

Sybase Web データウィンドウ DTC プロパティダイアログボックスが表示されます。

3 データウィンドウページ上の［PowerBuilder ライブラリ］ラジオボタンを選択します。［データウィンドウライブラリ］テキストボックスの横の参照（［...］）ボタンをクリックします。

4 「tutor_pb.pbl」を選択し、［開く］をクリックします。

tutor_pb.pbl ライブラリへのパスが、 Sybase Web データウィンドウDTC プロパティダイアログボックスの［ライブラリ］テキストボックスに表示されます。

5 ［スクリプト内に絶対パスを生成］チェックボックスをオンにします。［データウィンドウ］ドロップダウンリストボックスで「d_product」を選択します。


既存の Web ページへのデータウィンドウの追加

ここではチュートリアルのため、絶対パスの生成を使用します。本番環境では、相対パスを使用する必要があります。

6 ［接続］タブをクリックします。ドロップダウンリストボックスから「EAS Demo DB V9」を選択します。

7 ［検索］タブをクリックします。［自動検索］オプションをオフにして、［OK］をクリックします。

ボタンの Clicked イベントが発生したときに製品データを検索するスクリプトは、後で作成します。

8 スクリプトエディタの初のドロップダウンリストボックスから「cb_addproduct」を選択します。 2 番目のドロップダウンリストボックスで「ServerAction()」を選択します。

9 スクリプトエディタの中を右クリックします。ドロップダウンリストボックスから「リダイレクトの挿入」を選択します。

10 ［ロケーション］テキストボックスの横の参照（［...］）ボタンをクリックします。［コンテンツ Customer］リストボックスから「Addproduct.htm」を選択します。

このページから新しい商品ページへのリンクが追加されます。

288 PowerBuilder

商品情報の検索機能の追加

商品情報の検索機能の追加

現在の学習個所EAServer 接続プロファイルのセットアップWeb データウィンドウコンテナの構築Web データウィンドウコンテナを使用しての Web ページの作成データウィンドウ Web ページへのほかのコントロールの追加既存の Web ページへのデータウィンドウの追加

> 商品情報の検索機能の追加Web アプリケーションのテストと実行

このステップでは、 Product.htm ページに検索関数を追加します。これによって、データベース内の製品の商品 ID を要求すればページ上に商品情報を表示できるようになります。

1 ページ編集ビュー内で Product.htm が開いていない場合は開きます。 Web データウィンドウの上の段落の末尾にカーソルを置き、〔Enter〕を押します。

2 メニューバーから［テーブル｜テーブルウィザード］を選択します。［テーブル当たりの行数］に「1」と入力して、［次へ］をクリックします。［テーブル当たりの列数］に「2」と入力します。［完了］をクリックし、［OK］をクリックします。

Web ページ上にテーブルが表示されます。

3 1 番目のカラムの「Cell」という単語をハイライト表示し、「商品 ID で商品情報を表示」と入力します。

4 2 番目のカラムの「Cell」という単語をハイライト表示します。［挿入｜フォームフィールド｜シングルラインテキスト］を選択し、［OK］をクリックします。

290 PowerBuilder


5 テーブルの後にカーソルを置きます。〔Enter〕を 1 回押して次の行に移動します。メニューバーから［挿入｜フォームフィールド｜コマンドボタン］を選択します。

Button プロパティページが表示されます。

6 ［ボタンの種類］から「Button」を選択します。［名前］テキストボックスに「cb_get」と入力します。［ラベル］テキストボックスに「商品 ID」と入力して、［OK］をクリックします。

7 スクリプトエディタの初のドロップダウンリストボックスで「cb_get」を選択します。中央のドロップダウンリストボックスから「ServerAction()」を選択します。

8 以下のコードをスクリプトウィンドウに追加します。

dw_1.Reset();dw_1.Retrieve(sle_1.value);



Web アプリケーションのテストと実行


現在の学習個所EAServer 接続プロファイルのセットアップWeb データウィンドウコンテナの構築Web データウィンドウコンテナを使用しての Web ページの作成データウィンドウ Web ページへのほかのコントロールの追加既存の Web ページへのデータウィンドウの追加商品情報の検索機能の追加

> Web アプリケーションのテストと実行

このレッスンでは、新しい Web ページをテストし、データベースに商品を追加できることを確認します。商品を正しく追加できたら、［ログイン］ページから、 Web アプリケーション全体を実行します。


• Addproduct.htm Web ページのテスト

• データベースへの新しい商品の追加

• Web アプリケーションの実行

Addproduct.htm Web ページのテスト

作成した Web アプリケーションをテストする前に、まず Addproduct.htm Web ページをテストして、商品を追加できるかどうかを確認します。それには、 Customer ターゲットのスタートページを一時的に変更してから、 Customer ターゲットを配布および実行します。



2 ［実行 / デバッグ］タブをクリックし、参照（［...］）ボタンをクリックします。URL の選択ダイアログボックスの［ターゲット］タブが表示されていることを確認します。

3 ［コンテンツ Customer］リストボックスから「Addproduct.htm」を選択し、［OK］を 2 回クリックします。

292 PowerBuilder


4 Personal Web Server およびローカルの EAServer が稼働していることを確認します。

5 システムツリーで、 Customer を右クリックします。ポップアップメニューで［配布］を選択します。Addproduct ページを保存するかどうかを問い合わせるメッセージボックスが表示されたら、［はい］をクリックします。

出力ウィンドウが開き、ターゲットの構築および配布の進行状況を知らせる情報メッセージが表示されます。

6 メニューバーから［実行｜実行 Customer］を選択します。

デフォルトのブラウザが開きます。 URL アドレスボックスには、Addproduct.htm Web ページのファイルパスが入っています。

次のステップでは、この Web ページを使用して新しい商品情報を追加します。



データベースへの新しい商品の追加

ここでは、新しい商品情報を追加し、この新しい情報でデータベースを更新します。

1 Addproduct.htm ページ上の［商品情報の追加］ボタンをクリックします。

Web ページが再読み込みされ、空の Web データウィンドウ行が表示されます。

2 以下の情報を Web データウィンドウに入力します。

3 ［データベースの更新］ボタンをクリックします。

これでこの情報がデータベースに入力されました。次に、この情報を確認します。

テキストボックス値

商品 ID 9999

商品名シャツ

商品内容デニムシャツ

サイズ L サイズ

色 Blue （ドロップダウンリストから選択）

在庫数 6単価 3000

294 PowerBuilder


4 ［商品情報］ハイパーリンクをクリックします。

Product.htm ページが表示されます。

5 ［商品 ID で商品情報を表示］テキストボックスに「9999」と入力します。［商品 ID］ボタンをクリックします。

Product.htm Web ページが再読み込みされ、前の練習で入力した商品情報が表示されます。

Web アプリケーションの実行

これで Web アプリケーションの開発が完了しました。このステップでは、スタートページを Login.htm ページに戻してから、Web アプリケーションを再配布、実行、およびテストします。



2 ［実行 / デバッグ］タブをクリックし、参照（［...］）ボタンをクリックします。URL の選択ダイアログボックスの［ターゲット］タブをクリックします。

3 ［コンテンツ Customer］リストボックスから「Login.htm」を選択し、［OK］を 2 回クリックします。



4 Personal Web Server およびローカルの EAServer が稼働していることを確認します。

5 システムツリーで、 Customer を右クリックします。ポップアップメニューで［配布］を選択します。

出力ウィンドウに配布の完了を知らせるメッセージが表示されたら、アプリケーションを実行します。


デフォルトのブラウザに Login.htm ページが表示されます。

7 ［名前］テキストボックスと［パスワード］テキストボックスの両方に自分の名前を入力します。［ログイン］ボタンをクリックします。

ウェルカムページが表示されます。

296 PowerBuilder


8 ［商品情報を表示］ハイパーリンクをクリックします。

商品情報 Web ページ（Product.htm）が表示されます。

9 ［商品の追加］ボタンをクリックします。

Addproduct.htm ページが表示されます。



10 ［商品情報の追加］ボタンをクリックします。

空白行のある Web データウィンドウが表示されます。

11 以下の情報を Web データウィンドウに入力します。

12 ［データベースの更新］ボタンをクリックします。

13 ［商品情報］ハイパーリンクをクリックします。

Product.htm ページが表示されます。

14 ［商品 ID で商品情報を表示］テキストボックスに「4321」と入力します。［商品 ID］ボタンをクリックします。

テキストボックス値

商品 ID 4321商品名 T シャツ

商品内容コットン T シャツ

サイズ S サイズ

色 White （ドロップダウンリストから選択）

在庫数 100

単価 1600

298 PowerBuilder


Product.htm Web ページが再読み込みされ、先ほど入力した製品情報が表示されます。

15 ブラウザを閉じます。



次のステップについてお疲れさまでした。これでチュートリアルの第 3 部が終了しました。PowerBuilder での PowerDynamo Web ターゲットの基本的な使い方を理解できたことと思います。チュートリアルの第 4 部では、JSP Web ターゲットの作成および使用方法について学習します。

次に使用する Web ターゲットのマニュアル

このマニュアルの冒頭の「このマニュアルについて」には、PowerBuilderの各マニュアルについての説明が記載されています。 Web ターゲットと Web データウィンドウについてさらに高度な開発技術を学習するには、以下のマニュアルに進んでください。

『Web ターゲットと JSP ターゲットでの作業』『Web および JSP ターゲットリファレンス』『データウィンドウプログラマーズガイド』『データウィンドウリファレンス』

PowerBuilder のすべてのマニュアルは、ソフトウェア付属のテクニカルライブラリ CD、およびテクニカルライブラリ製品マニュアルのSybase Web サイト http://www.sybase.com/support/manuals/ （英語）を参照してください。

Web ターゲットのサンプルの参照

PowerBuilder のコード例（Web ターゲットのサンプルを含む）については、 Windows のスタートメニューで［プログラム｜ Sybase ｜PowerBuilder 9.0 ｜ PB 9 コードサンプル］を選択して参照してください。

300 PowerBuilder

第 4 部 JSP Web サービスアプリケーションの作成

第 4 部は、JSP Web ターゲットの使用方法を示したチュートリアルです。 JSP クライアントから Web サービスを使用する方法を手順を追って説明します。

レッスン 1 4 JSP Web サービスアプリケーションの作成

JSP ターゲットは、カスタマイズされたコマンドライン構成を用いて、任意の JSP 1.2 サーバに配布できます。ただし、 EAServer やTomcat に配布する場合は、サーバへの接続情報を入力するだけです。このチュートリアルでは、4GL JSP ページを含む JSP Web サービスアプリケーションを作成し、 EAServer に配布します。


• JSP ターゲットの作成

• 簡単な JSP アプリケーションでの Web サービスの利用

• 4GL JSP アプリケーションでの Web サービスの利用


このチュートリアルを開始する前に

JSP Web サービスチュートリアルでは、ローカルマシンに以下のソフトウェアがインストールされている必要があります。


• Internet Explorer 6.0 以降

また、 PowerBuilder 内で EAServer 接続プロファイルをセットアップする必要もあります。 EAServer プロファイルのセットアップについては、 PowerDynamo Web ターゲットのチュートリアルで設定しました。 PowerDynamo Web ターゲットのチュートリアルを読み飛ばした人は、 275 ページの「 EAServer 接続プロファイルのセットアップ」の手順を実行してください。

JSP Web サービスアプリケーションを実行するときは、インターネットに接続している必要があります。デザイン時には、このチュートリアルで使用する Web サービス定義言語（WSDL）ファイルをご使用のローカルマシンにコピーしておけば、インターネットに接続している必要はありません。 WSDL ファイルについては、このレッスンで解説します。


JSP ターゲットの作成


現在の学習個所> JSP ターゲットの作成

簡単な JSP アプリケーションでの Web サービスの利用4GL JSP アプリケーションでの Web サービスの利用

PowerBuilder で JSP ターゲットを作成するには、 JSP ターゲットウィザードを実行します。

1 PowerBuilder で［ファイル｜ワークスペースを開く］を選択し、Tutorialフォルダに移動します。 MyWorkspace.pbw を選択し、［開く］をクリックします。

クライアント / サーバまたは Web ターゲットのチュートリアルを近学習した場合は、このワークスペースがすでに開いている可

能性があります。初のチュートリアルを近学習していないため、MyWorkspace.pbw が見つからない場合は、27 ページの「チュートリアルのセットアップ」の手順に従ってください。

2 パワーバーの［新規作成］ボタンをクリックします。新規作成ダイアログボックスの［ターゲット］タブをクリックし、［JSPターゲット］を選択します。［OK］をクリックします。

JSP Web ターゲットウィザードの紹介ページが表示されます。


［新規 JSP ターゲットの指定ウィザード］ページが表示されます。Web ターゲットのデフォルト名は Target1 です。

4 Target1.pbt のかわりに「jspTutorial.pbt」と入力します。

［次へ］をクリックすると、ソースフォルダ名と構築フォルダ名が上記のターゲット名を反映して自動的に変更されます。

304 PowerBuilder

レッスン 14 JSP Web サービスアプリケーションの作成

5 ［EAServer プロファイルの選択］ページが表示されるまで［次へ］をクリックします。


6 目的の EAServer プロファイルが選択されていることを確認します。

PowerDynamo Web ターゲットのチュートリアルを終えている場合は、「local」という名前のプロファイルを選択してください。このプロファイルは、ローカルマシンの名前をサーバ名として使用します。 EAServer プロファイルがない場合は、［キャンセル］をクリックしてウィザードを終了し、 275 ページの「 EAServer 接続プロファイルのセットアップ」の手順を実行した後、このレッスンを初からやり直してください。

ウィザードの［EAServer プロファイルの選択］ページの［HTTPPort］フィールドには、デフォルト値として 8080 が入力されています。このポート番号は変更しないでください。変更する場合は、Jaguar Manager で EAServer の HTTP リスナポートも変更しなければなりません。

7 ［JSP ターゲットの作成準備完了］ページが表示されるまで、［次へ］をクリックします。

以下の項目についてデフォルトの設定を使用します。

ウィザードオプション標準設定

［配布構成の名前］ jspTutorialDeployConfiguration1［説明］［配布構成］

［オブジェクトモデル］デフォルトのオブジェクトモデルを使用する

［JSP サーバ一覧］ EAServer


［配布対象］［すべて配布または、配布しない］

［再構築］［Incremental］［ローカルコピーフォルダ］

Program Files¥Sybase¥PowerBuilder 9.0¥Tutorial¥jspTutorial¥jspTutorialDeployConfiguration1

［WAR ファイル名］ jspTutorial.war



8 ［JSP ターゲットの作成準備完了］ページの選択内容を確認します。［完了］をクリックして選択内容を受け入れます。

jsp チュートリアルターゲット、ファイルを格納するディレクトリ構造、配布構成が作成されます。システムツリーには、ソースフォルダと構築フォルダは表示されませんが、ウィザードが作成した WEB-INF ディレクトリとその 2 つのサブディレクトリ、およびターゲットの web.xml ファイルが表示されます。

306 PowerBuilder


簡単な JSP アプリケーションでの Web サービスの利用

現在の学習個所JSP ターゲットの作成

> 簡単な JSP アプリケーションでの Web サービスの利用4GL JSP アプリケーションでの Web サービスの利用

このレッスンでは、簡単な JSP アプリケーションを作成します。この非 4GL アプリケーションはスタートページとターゲットページから成ります。スタートページでは、ページパラメータとして渡す項目をドロップダウンリストから選択し、ターゲットページでは Web サービスを呼び出します。このレッスンでは、 XMethods Web サイト

www.xmethods.net （英語）で提供されている為替レート計算 Web サービスを利用します。

• JSP アプリケーションの非 4GL ページの作成

• アプリケーションのスタートページを完成させる

• JSP Web サービスプロキシウィザードを使用する

• Web サービスへの呼び出しの追加

• アプリケーションの構築、配布、実行

JSP アプリケーションの非 4GL ページの作成

このチュートリアルの非 4GL 部分では、2 つのページ、すなわちスタートページとメインページを作成します。そして、アプリケーションのメインページにページパラメータを追加します。このパラメータで、スタートページから送信された値を受け取ります。

1 メニューバーから［ファイル｜新規作成］を選択し、［Web］タブをクリックします。新規作成ダイアログボックス下部の［ターゲット］ドロップダウンリストボックスで、「jspTutorial」が選択されていることを確認します。

ワークスペース内にほかの Web ターゲットがなければ、［Web］タブをクリックしたときに「jspTutorial」が自動的に選択されます。

2 ［Web/JSP ページ］アイコンを選択して、［OK］をクリックし、さらに［次へ］をクリックします。

［新規 HTML ファイルの指定］ページが表示されます。



3 ［タイトル］テキストボックスに「simplestart」と入力して、［次へ］を 4 回クリックします。

［ファイル名］フィールドのファイル名が、 simplestart.jsp に変わります。

残りのウィザードページでは、デフォルトの設定をそのまま受け入れます。


jspTutorial ターゲット内に simplestart.jsp ページが作成され、HTML エディタ内に開きます。このページは、システムツリーの jspTutorial ターゲットの下に表示されます。

5 手順 3 で入力するファイル名を simplestart から「simple」に変更して、手順 1 ～ 4 を繰り返します。

simple.jsp ページが作成されます。ページ編集ビューに、デフォルトテキストとして「ここにデータを置きます」が表示されます。

6 simple.jsp ページのデフォルトのテキストをハイライト表示します。〔Enter〕を押し、新しいテキストとして「通貨変換」と入力します。

7 入力したテキスト内にカーソルを置いて、メニューバーから［書式｜段落］を選択します。

Paragraph ダイアログボックスが表示されます。

8 ［段落スタイル］ドロップダウンリストから「見出し 1」を選択します。［テキスト配置］フィールドから「中央」を選択して、［OK］をクリックします。

入力したテキストが、見出し 1 フォントスタイルで表示されます。

9 テキストの末尾にカーソルを置き、〔Enter〕を押します。「(Simple Version)」と入力します。

308 PowerBuilder


次のレッスンで、このページの 4GL バージョンを作成します。

ページ編集ビューにパラグラフ記号が表示されない場合は、そのページを右クリックして、ポップアップメニューから「非表示タグを表示」を選択してください。

10 ページ編集ビューでこのページを右クリックして、ポップアップメニューから［ページプロパティ］を選択します。［パラメータ］タブをクリックします。

11 ［パラメータ名］カラムの下の初の行をクリックし、「column_2」と入力して、［OK］をクリックします。

非 4GL ページのページパラメータにデフォルト値を入力することはできません。このチュートリアルアプリケーションでは、column_2 パラメータを simplestart.jsp ページから simple.jsp ページに渡します。

12 HTML エディタツールバーの［保存］ボタンをクリックします。



アプリケーションのスタートページを完成させる

ここでは、ドロップダウンリストと［送信］ボタンを追加して、simplestart.jsp ページを完成させます。

1 PowerBuilder の［ウィンドウ］メニューから simplestart.jsp ページを選択します。

simplestart.jsp ページが、HTML エディタ内でフォーカスされます。simplestart.jsp ページを閉じてしまっている場合は、システムツリー内で simplestart.jsp をダブルクリックして再度開いてください。

2 デフォルトのテキストをハイライト表示して、〔Enter〕を押します。ページ編集ビューまたはソースビュー内に以下の行を直接入力します。

出張予定の国を選択してください。

3 テキストを入力したら〔Enter〕を押します。メニューバーから［挿入｜フォームフィールド｜リストボックス］を選択します。

4 ［サーバに送る名前］テキストボックスに「country_2」と入力します。

5 ［オプション］タブをクリックし、以下の表示テキストと値を入力して、［OK］をクリックします。

リストボックスがページに追加され、開き FORM タグと閉じFORM タグで囲まれます。

6 このリストボックスの後、閉じ FORM タグの前にカーソルを置きます。〔Enter〕を押します。

この操作は、ページ編集ビューまたはソースビューで行うことができます。ページに追加する［送信］ボタンは、このドロップダウンリストと同じ FORM タグ内に存在しなければなりません。

テキスト値

中国 china

フランス euroドイツ euro

イギリス united kingdomシンガポール singapore

310 PowerBuilder


7 以下のテキストを入力して〔Enter〕を押します。

［クエリ送信］ボタンを押すと、選択した国の基本通貨の米国ドルに対する為替レートが検索されます。

8 メニューバーから［挿入｜フォームフィールド｜コマンドボタン］を選択し、［OK］をクリックします。

［送信］ボタンには、デフォルトのラベル「クエリ送信」が付けられます。 simple.jsp ページにボタン名を渡す必要はないので、ボタンに名前を付ける必要はありません。ただし、ドロップダウンリストの値は渡す必要があります。

9 このボタンまたはドロップダウンリストを右クリックして、ポップアップメニューから［フォームプロパティ］を選択します。

Form Properties ダイアログボックスが表示されます。

10 ［フォーム情報の送り先 URL］テキストボックスに、「simple.jsp」と入力します。

入力するかわりに、同テキストボックスの横の参照ボタンをクリックして、 URL の選択ダイアログボックスを開き、［ターゲット］タブで「simple.jsp」を選択して［OK］をクリックすることもできます。

11 ［送信メソッド］ドロップダウンリストボックスで「GET」を選択して［OK］をクリックします。

送信メソッドを POST のままにすると、［クエリ送信］ボタンをクリックしたとき simple.jsp ページにアクセスするための URL にパラメータが含まれません。



ポップアップメニューから「非表示タグを表示」を選択しなかった場合、 simplestart.jsp ページはページ編集ビュー内で次のように表示されます。

［クエリ送信］ボタンが FORM タグの内側にあることを確認してください。

HTML エディタの［プレビュー］タブをクリックすると、simplestart.jsp がクライアントのブラウザ内でどのように表示されるかを確認できます。プレビューでは、ページ編集ビューに表示されていた FORM タグは表示されません。

12 変更内容を simplestart.jsp ページに保存します。［ファイル｜閉じる］を選択して、 simplestart.jsp ページを閉じます。

simple.jsp ページは、 HTML エディタ内で開いたままです。

JSP Web サービスプロキシウィザードを使用する

ここでは、 JSP ターゲットに Web サービスを追加します。

1 システムツリーの jspTutorial ターゲットを右クリックして、ポップアップメニューから［新規作成］を選択します。まだ表示されていない場合は、［Web］タブをクリックします。

2 ［JSP Web サービスプロキシウィザード］をダブルクリックして、［次へ］をクリックします。

ウィザードの［WSDL ファイルの選択］ページが表示されます。

312 PowerBuilder


3 以下の URL を［WSDL ファイル名］テキストボックスに入力して、［次へ］をクリックします。

http://www.xmethods.net/sd/2001/CurrencyExchangeService.wsdl

ウィザードの［Select Services］ページに、入力した WSDL ファイルに記述されている Web サービスが表示されます。

4 ウィザードの［プロキシの作成準備完了］ページに達するまで［次へ］をクリックします。

以下のデフォルト情報を受け入れます。


ターゲットの WEB-INF ディレクトリのサブディレクトリに以下のファイルが作成されます。

CurrencyExchangeService.tld ファイルがカスタムのタグライブラリ検索パスに追加されます。また、システムツリーの［コンポーネント］タブにも追加されます。

ウィザードオプションデフォルト設定

［サービス］ CurrencyExchangeService （WSDL ファイルに記述されている唯一のサービス）

［操作名］ getRate［パラメータ名］ CurrencyExchangeService_getRate_returnValue

［ポート名］ CurrencyExchangePort［パッケージ名］ CurrencyExchangeService

［TLD ファイル名］ CurrencyExchangeService.tld［TLD ファイルをカスタムタグ検索パスに追加］

選択されている

［JAR ファイル名］ CurrencyExchangeService.jar［JAR ファイルを PB Java クラスパスに追加］

Selected

サブディレクトリ作成されるファイル

Classes CurrencyExchangeService.wsdl、 esdweblogger.props、syuproxy.props、 user.encoding.props

Lib CurrencyExchangeService.jar、 log4j-1.2.3.jar、swsclient.jar

Tlds CurrencyExchangeService.tld



Web サービスへの呼び出しの追加

ここでは、 TLD を simple.jsp で使用するためのページディレクティブを追加します。まず、Web サービスの getRate クラスの引数を定義するカスタムタグを追加し、次に、その Web サービスによって計算された変換レートを返すサーバスクリプトを追加します。

1 プロパティツリーの［コンポーネント］タブをクリックします。

2 カスタムタグライブラリのリストを展開して、CurrencyExchangeService.tld を表示します。

3 CurrencyExchangeService.tld ファイルを、 HTML エディタ内のsimple.jsp ページにドラッグします。

TLD ファイルの省略名として使用する接頭辞を入力するように求めるダイアログボックスが表示されます。

4 接頭辞として「cur」と入力し、［OK］をクリックします。

ページに taglib ディレクティブが追加されます。

5 システムツリーの［コンポーネント］タブで、CurrencyExchangeService.tld ファイルを展開します。

6 getRate クラスを、ページ編集ビューの simple.jsp ページの下部にドラッグします。

cur:getRate プロパティダイアログボックスが表示されます。

7 リストされた各属性の値カラムに以下の値を入力して、［OK］をクリックします。

314 PowerBuilder

ページ編集ビューの simple.jsp ページに、カスタムの JSP アクションが追加されたことを示す <ctl:/> 記号が表示されます。ソースビューには、以下に示すカスタムのアクションタグのコードが表示されます。

<cur:getRate country1="usa" country2='<%= request.getParameter ("country_2") %>' />

8 ソースビューに表示されたページの末尾に以下のコードを入力します。

米国 1 ドルに対する <%= request.getParameter ("country_2") %>

通貨の変換レート : 

この行には、サーバスクリプトと HTML スクリプトの両方が含まれています。 HTML スクリプトに現れる " " は、その位置に改行なしのスペースを挿入します。

9 ページ編集ビューに切り替えて、入力した行の <%=> 記号をクリックします。

スクリプトビューの初のドロップダウンリストに「ServerScript[0]」が表示されます。このサーバスクリプトは、ソースビューに入力したスクリプトです。

10 ページ編集ビューで、入力した行の末尾にカーソルを置きます。

ソースビューで、コロンの後に改行なしのスペースを挿入しなかった場合は、ここで〔Space〕を押して挿入します。

11 スクリプトビューを右クリックして、ポップアップメニューから［新規スクリプト｜サーバ｜ JSP ｜ "<%= ... %>"］を選択します。

スクリプトビューの初のドロップダウンリストボックスに、今度は ServerScript[1] が表示されます。ページ編集ビューには、 2 つめの <%=> 記号が表示されます。

この 2 つめの <%=> 記号がテキスト行の末尾に表示されない場合は、それを選択して行の末尾にドラッグします。このとき、コロンと <%=> 記号がスペース 1 文字で区切られていることを確認します。

属性名値

country1 usacountry2 <%= request.getParameter ("country_2") %>


12 システムツリーの［コンポーネント］タブで、CurrencyExchangeService.tld の下にある getRate クラスを展開します。

13 CurrencyExchangeService_getRate_returnValue 変数を、スクリプトビューの ServerScript[1] にドラッグします。

14 HTML エディタツールバーの［保存］ボタンをクリックします。（オプション） simple.jsp ページと HTML エディタを閉じます。

316 PowerBuilder


アプリケーションの構築、配布、実行

このステップでは、 JSP アプリケーションを配布および実行します。

1 ターゲットプロファイルで選択した EAServer が起動されていることを確認してください。

2 システムツリーの［ワークスペース］タブで、［jspTutorial］を右クリックします。ポップアップメニューで［配布］を選択します。

配布が終了すると、出力ウィンドウに「終了ターゲットの配布

jspTutorial」と表示されます。

3 jspTutorial ターゲットの中を再度右クリックします。ポップアップメニューで［プロパティ］を選択します。

4 ターゲットプロパティダイアログボックスで［実行］タブをクリックします。［スタートページ］テキストボックスの横にある参照ボタンをクリックします。

URL の選択ダイアログボックスが表示されます。

5 jspTutorial ターゲットの中身を示すリストボックスで「simplestart.jsp」を選択し、［OK］をクリックします。

ターゲットプロパティダイアログボックスに、ターゲットのスタートページとして /simplestart.jsp が表示されます。

6 ［実行用の配布構成］ドロップダウンリストで「jspTutorialDeployConfiguration1」を選択し、［OK］をクリックします。

7 メニューバーから［実行｜選択して実行］を選択します。ターゲットの選択ダイアログボックスで「jspTutorial」を選択します。［OK］をクリックします。

デフォルトのブラウザに、 simplestart.jsp Web ページが表示されます。

8 ドロップダウンリストで国を選択して［クエリ送信］をクリックします。

選択した国の通貨の為替レートが計算され、結果が simple.jsp ページに表示されます。


4GL JSP アプリケーションでの Web サービスの利用


現在の学習個所JSP ターゲットの作成簡単な JSP アプリケーションでの Web サービスの利用

> 4GL JSP アプリケーションでの Web サービスの利用

このレッスンでは、 4GL JSP を作成し、それに Web サービスを追加します。 simple.jsp ページで使用したのと同じ Web サービスを利用します。

• 4GL JSP ページの作成

• 4GL ページへの Web サービスとページ変数の追加

• 4GL JSP ページへのテーブルの追加

• Web サービスへの呼び出しの完了

• 4GL JSP ページの構築、配布、実行

4GL JSP ページの作成

1 メニューバーから［ファイル｜新規作成］を選択し、［Web］タブをクリックします。

2 ［ターゲット］ドロップダウンリストで「jspTutorial」が選択されていることを確認します。［4GL Web/JSP ページ］アイコンを選択して、［OK］をクリックし、さらに［次へ］をクリックします。

4GL Web Page ウィザードが開き、［新規 HTML ファイルの指定］ページが表示されます。

3 ［タイトル］テキストボックスに「fourgl」と入力し、［次へ］を何度かクリックして［EAServer プロファイルの選択］ページを表示します。

初に［次へ］をクリックしたときに［ファイル名］フィールドのファイル名が、 fourgl.jsp に変わります。以降、［次へ］をクリックして表示される各ページでは、デフォルト値を受け入れます。

318 PowerBuilder


4 ウィザードの［EAServer プロファイルの選択］ページにある［EAServerコンポーネントのスキップ］チェックボックスをオンにして、［次へ］をクリックします。


jspTutorial ターゲット内に fourgl.jsp ページが作成されます。作成されたページが HTML エディタ内に開きます。また、ターゲット用に作成したほかのページと一緒にシステムツリーにもリスト表示されます。

6 fourgl.jsp ページのデフォルトのテキストの「ここにデータを置きます」をハイライト表示します。新しいテキストとして「通貨変換」と入力します。

7 入力したテキスト内にカーソルを置いて、メニューバーから［書式｜段落］を選択します。

段落ダイアログボックスが表示されます。

8 ［段落スタイル］ドロップダウンリストから「見出し 1」を選択し、［テキスト配置］フィールドから「中央」を選択して、［OK］をクリックします。

入力したテキストが、見出し 1 フォントスタイルで表示されます。

9 テキストの末尾にカーソルを置き、〔Enter〕を押します。「（4GL Version）」と入力して〔Enter〕を押します。


4GL ページへの Web サービスとページ変数の追加

1 プロパティツリーの［コンポーネント］タブをクリックします。

2 カスタムタグライブラリのリストを展開して、CurrencyExchangeService.tld ファイルを表示します。

JSP Web サービスプロキシウィザードによって、 Currency Exchange Service ライブラリがカスタムタグライブラリのリストに追加されます。このライブラリは、 simple.jsp ページの taglib ディレクティブで追加したライブラリと同じものです。



3 CurrencyExchangeService.tld ファイルを、 HTML エディタ内のfourgl.jsp ページにドラッグします。

TLD ファイルの省略名として使用する接頭辞を入力するように求めるダイアログボックスが表示されます。

4 接頭辞として「cur」と入力し、［OK］をクリックします。

ページに taglib ディレクティブが追加されます。

5 ページ編集ビューで fourgl.jsp ページを右クリックします。ポップアップメニューで［ページプロパティ］を選択し、［変数］タブをクリックします。

6 変数に以下のプロパティを追加して、［OK］をクリックします。


4GL JSP ページへのテーブルの追加

1 ページ編集ビューの fourgl.jsp ページで、入力したテキストを含む行の下にカーソルを置きます。

2 メニューバーから［テーブル｜テーブルウィザード］を選択します。

3 テーブル内の行数に「2」と入力して、［次へ］をクリックします。テーブル内の行数に「3」と入力して、［完了］、［OK］をクリックします。

fourgl.jsp ページにテーブルが追加されます。テーブル内の各セルには、「Cell」という単語がデフォルトで設定されます。

4 テーブルの左上隅のセルでデフォルトのテキストをハイライト表示します。セル内に、「通貨 From:」と入力します。

カラム入力または選択する値

変数名 v_unitsData Type double

イニシャル値 100.ライフタイム page

クライアントアクセス NONE

320 PowerBuilder


5 テーブルの左下隅のセルでデフォルトのテキストをハイライト表示します。セル内に、「通貨 To: 」と入力します。

6 テーブルの上中央のセルでデフォルトのテキストをハイライト表示します。メニューバーから［挿入｜フォームフィールド｜リストボックス］を選択します。

リストボックスプロパティダイアログボックスが表示されます。

7 ［サーバに送る名前］テキストボックスに「country_from」と入力します。リストボックスプロパティダイアログボックスで［オプション］タブをクリックします。［オプション］リストに以下の表示テキストと値を入力します。

8 アメリカのエントリの横にある［選択済み］カラムのチェックボックスをオンにして、［OK］をクリックします。

テーブルの上中央のセルにリストボックスが表示されます。ページ編集ビューには、アメリカの値だけが表示されます。プレビュービューでは、ドロップダウンリストで入力したすべての国が表示されます。ただし、プレビュービューで編集はできません。編集を続けるには、ページ編集ビューに戻る必要があります。

9 テーブルの下中央のセルでデフォルトのテキストをハイライト表示します。メニューバーから［挿入｜フォームフィールド｜リストボックス］を選択します。

10 ［サーバに送る名前］テキストボックスに「country_to」と入力します。リストボックスプロパティダイアログボックスで［オプション］タブをクリックします。手順 7 で入力したのと同じ表示テキストと値を入力します。

テキスト値

中国 chinaフランス euro

イギリス united kingdomシンガポール singapore

アメリカ usa


11 フランスのエントリの横の［選択済み］カラムのチェックボックスをオンにして、［OK］をクリックします。

テーブルの下中央のセルにリストボックスが表示されます。ページ編集ビューには、フランスの値だけが表示されます。

12 テーブルの右上隅のセルでデフォルトのテキストをハイライト表示します。メニューバーから［挿入｜フォームフィールド｜シングルラインテキスト］を選択します。

13 テキストコントロールプロパティダイアログボックスの［名前］テキストボックスに「units」と入力します。

14 テキストコントロールプロパティダイアログボックスの［バインド］タブをクリックします。コンポーネント名に「<Page Variable>」、プロパティ名に「v_units」を選択して、［OK］をクリックします。

fourgl.jsp ページが次のように表示されるはずです。

15 テーブルの右下のセルでデフォルトのテキストをハイライト表示して、〔Delete〕を押します。

デフォルトのテキストが削除されます。この後の手順で、このセルに getRate Web サービスへの呼び出しを入力し、返された計算結果をこのセルに設定します。

322 PowerBuilder

Web サービスへの呼び出しの完了

1 システムツリーの［コンポーネント］タブで、CurrencyExchangeService.tld ファイルを展開します。getRate クラスを、 fourgl.jsp ページのテーブルの右下のセルにドラッグします。

cur:getRate プロパティダイアログボックスが表示されます。

2 リストされた各属性の値カラムに以下の値を入力して、［OK］をクリックします。

ページ編集ビューのテーブルの右下のセルに、カスタムの JSP アクションが追加されたことを示す <ctl:/> 記号が表示されます。ソースビューには、後のセル内のコードが次のように表示されます。

<cur:getRate country1="<%= country_from.value %>" country2="<%= country_to.value %>" />

3 スクリプトビューの内部を右クリックして、ポップアップメニューから［新規スクリプト｜サーバ｜ JSP ｜ "<%= ... %>"］を選択します。

スクリプトビューの初のドロップダウンリストボックスに、ServerScript[0] が表示されます。

4 ［コンポーネント］タブで、 CurrencyExchangeService.tld の下の getRate クラスを展開します。CurrencyExchangeService_getRate_returnValue 変数を、スクリプトビューの ServerScript[0] にドラッグします。

スクリプトビューに、“CurrencyExchangeService_getRate_returnValue” というテキストが表示されます。

5 スクリプトビューにドラッグしたテキストの直後に「.floatValue()*v_units」と入力します。

属性名値

country1 <%= country_from.value %>country2 <%= country_to.value %>

サーバスクリプトは、ドット表記を使用して floatValue メソッドを呼び出し、戻り値をキャストしてから、それに v_units ページ変数の値を掛けて終結果を得ます。スクリプト全体は次のようになります。

CurrencyExchangeService_getRate_returnValue.floatValue()* v_units

6 サーバスクリプト記号 “<%=>” が、テーブル右下のセル内の “<ctl:/>”記号の後ろに表示されていることを確認します。

ページ編集ビューで、サーバスクリプト記号 <%=> を移動したい場所にドラッグアンドドロップします。この記号は、ページ編集ビューの <ctl:/> 記号によって表されるカスタムタグライブラリへの呼び出しの後に置く必要があります。

7 テーブルの右にカーソルを置き、〔Enter〕を押します。新しい行にカーソルを置いた状態で、［挿入｜フォームフィールド｜コマンドボタン］を選択します。


8 ［ラベル］テキストボックスに「変換レートの取得」と入力して、［OK］をクリックします。

9 （オプション）ソースビューの［Submit］ボタンのコードの後、閉じ Bodyタグの前に、次のテキストを入力します。

<HR id="HR1">

通貨変換 Web サービス： <A href="http://www.xmethods.net">www.xmethods.net</A> wsdl: <A id="WSDLURL" href= "http://www.xmethods.net/sd/2001/CurrencyExchangeService.wsdl">http://www.xmethods.net/sd/2001/CurrencyExchangeService.wsdl</A>

Web サービスを利用するにあたって、 Web サービスの所有者を明示しておきます。

10 fourgl.jsp ページに対する変更を保存します。

324 PowerBuilder


4GL JSP ページの構築、配布、実行

このステップでは、 JSP アプリケーションを配布および実行します。

1 EAServer が起動されていることを確認します。

2 システムツリーの［ワークスペース］タブで、 jspTutorial ターゲットを右クリックして、ポップアップメニューから［配布］を選択します。

配布が終了すると、出力ウィンドウに「終了ターゲットの配布

jspTutorial」と表示されます。

3 jspTutorial ターゲットを再度右クリックします。ポップアップメニューで［プロパティ］を選択します。

4 ターゲットプロパティダイアログボックスで［実行］タブをクリックします。［スタートページ］テキストボックスの横にある参照ボタンをクリックします。

URL の選択ダイアログボックスが表示されます。

5 jspTutorial ターゲットの中身を示すリストボックスで「fourgl.jsp」を選択し、［OK］をクリックします。

ターゲットプロパティダイアログボックスに、ターゲットのスタートページとして /fourgl.jsp が表示されます。

6 システムツリーで jspTutorial ターゲットを右クリックします。ポップアップメニューで［実行］を選択します。

デフォルトのブラウザが開きます。 URL アドレスボックスには、作成した fourgl.jsp Web ページのファイルパスが入っています。選択した以下のデフォルト値で変換レートが計算され、表示されます。

7 ブラウザで、［通貨 From］または［通貨 To］ドロップダウンリストで別の国を選択します。［Get Conversion Result］ボタンをクリックします。

パラメータまたは変数デフォルト値

country1 United Statescountry2 Francev_units 100



fourgl.jsp Web ページのテーブルの右下セルに新しい計算結果が表示されます。

8 fourgl.jsp Web ページのテーブルの右上セルに別の単位を入力して、［変更レートの取得］ボタンをクリックします。

入力した単位を使って計算が実行されます。

次のステップについてお疲れさまでした。これでチュートリアルの第 4 部が終了しました。PowerBuilder での JSP ターゲットと JSP Web サービスの基本的な使い方が理解できたことと思います。

さらに練習を積むために、このチュートリアルで説明した JSP アプリケーションを Tomcat サーバや、別の JSP 1.2 互換のサーバに配布してください。また、ユーザ定義のデータ型を使用した別の Web サービスを利用してください。ユーザ定義のデータ型については、『Web ターゲットと JSP ターゲットでの作業』マニュアルの「JSP ターゲット」の章を参照してください。

このマニュアルの冒頭の「本書について」に、PowerBuilder の各マニュアルについての説明が記載されています。

PowerBuilder のコード例（Web ターゲットのサンプルを含む）については、 Windows のスタートメニューで［プログラム｜ Sybase ｜PowerBuilder 9.0 ｜ PB 9 コードサンプル］を選択して参照してください。

326 PowerBuilder

索引

CCHOOSE CASE 文 220Clicked イベント

CommandButton コントロール 116, 118メニュー項目 156

Close イベント、アプリケーションオブジェクト 119

COMMIT 文 137Constructor イベント、ユーザオブジェクト 105

DDBError イベント 133, 136DBParm パラメータ 110DeleteRow 関数 137

EEAS Demo DB データベース

接続 91セットアップ 27

EAServer 275

GGetActiveSheet 関数 156

HHALT 文 118

PowerBuilder 入門

IInsertRow 関数 137

JJSP Web サービス

ウィザード 312カスタムタグライブラリの呼び出し 314, 323

JSP ターゲットウィザード 304, 307, 318

MMDI アプリケーション 21, 23

OOpen イベント

シートウィンドウ 139フレームウィンドウ 87

PParent （PowerScript 代名詞） 111PBL （PowerBuilder Library （PBL）を参照）Pcode （疑似コード） 234PowerBuilder Library （PBL） 19PowerDynamo Web サイト 247PowerScript 4PowerTips 9Profile String 関数 106

327

索引

QQuick Select

ソート条件 164使い方 163

RRetrieve 関数

概要 136引数の指定 140

ROLLBACK 文 137RowFocusChanged イベント 138

SSELECT 文 171Select ペインタ

概要 170タブ領域 171

SetFocus 関数 136, 137SetRowFocusIndicator 関数 136SetTransObject 関数 139SQL Select データソース 169SQLCA （SQL 通信領域） 104, 139SQL 構文、 Select ペインタ 171SQL 文

COMMIT 137ROLLBACK 137SELECT 171

SQL ペインタ 169

Tthis （PowerScript 代名詞） 139To-Do リスト 101TRY-CATCH 文 220, 223

UUpdate 関数 137

328

WWeb ターゲット

JSP 303PowerDynamo 245概要 6

Web データウィンドウ 287Web データウィンドウコンテナ 277Web ページ

概要 245グラフィック 254データウィンドウの使用 279配布 292

Web ページの作成 245WHERE 句 172

アアイコン、アプリケーション 40アプリケーション

MDI 21, 23インターネット 5構築 233実行 46, 275定義 12デバッグ 199分散 5

アプリケーションオブジェクトOpen イベント 52アイコン 40, 43定義 12

アンパサンド、メニュー項目のアクセラレータキー 145

イイベント

Clicked 114, 156Close 119Constructor 105DBError 133LoseFocus 223RowFocusChanged 138

PowerBuilder

索引

概要 4Constructor 223追加 220メニュースクリプトからの発生 156

ウウィザード

4GL 262JSP Web サービス 312JSP Web ページ 307JSP ターゲット 304Web ページ 251, 279接続オブジェクト 101データウィンドウ 162テーブル 320プロジェクト 235

ウィンドウ応答 66概要 13コマンドボタンコントロール 78コントロールの削除 72作成 66スクリプトを開く 86スタティックテキストコントロール 74先祖 123タブ順序 80データウィンドウコントロール 126ピクチャコントロール 72プレビュー 83保存 66

ウィンドウペインタ、コントロールの削除 72

オオートスクリプト

設定のショートカット 115使い方 116, 135

オブジェクト指向 5オブジェクトレベル

関数 17

PowerBuilder 入門

構造体 18

カ拡張属性 100, 181関数

DeleteRow 137GetActiveSheet 156InsertRow 137ProfileString 106Reset 137Retrieve 136SetFocus 136, 137SetRowFocusIndicator 136SetTransObject 139Update 137オブジェクトレベル 17概要 4グローバル 17追加 220

ククエリ 17クラスユーザオブジェクト 19グラフィック 254クリップウィンドウ 7グローバル

関数 17構造体 18変数 107

グローバル変数の宣言 107

ケ継承

ウィンドウ 123オブジェクト指向プログラミング 5メニュー 149ユーザオブジェクト 126

検索、データベースのデータ 290検索引数

329

索引

WHERE 句 172作成 171

検証 266

コ構造体 18コメント

ウィンドウ 68スクリプトビュー 88データウィンドウ 166, 177メニュー 150

コンテキストヘルプ、追加 82コントロール

コマンドボタン 78削除 72スタティックテキスト 74ピクチャ 72複製 74プロパティの指定 74, 77, 79

コントロールの削除 72

ササイズ、メインウィンドウ 43

シシートウィンドウ、メニュー 150システムツリー 7実行ファイル

アプリケーションアイコン 40, 43オブジェクトの再生成 237マシンコードの生成 234

出力ウィンドウ 7初期化ファイル

odbc.ini 92pb.ini 96pbtutor.ini 106

330

ス垂直スクロールバー 130スクリプト

エラーウィンドウ 90オートスクリプトの設定ショートカット 115オートスクリプトの使い方 116, 135概要 4コンパイル 90先祖スクリプトの表示 132ユーザイベント 134

スクリプトビューエラーウィンドウ 90形式を指定して貼り付けコマンド 114コメントの使用 88説明 82プロトタイプ領域 136

スクロールバー、垂直 130スタイルバー 9

セ接続サービスマネージャ 101先祖

ウィンドウ 123スクリプト 132

タターゲット 6代名詞、 PowerScript

this 139親 111, 112

タブ順序 80タブラ提示様式 163

チチュートリアル

初期化ファイル 106セットアップ 27ファイル 27

PowerBuilder

索引

チュートリアルのセットアップ 27

ツツールバー

実行時のアプリケーション 154テキストの表示 61

テ提示様式

タブラ 163データウィンドウオブジェクト 163, 169フリーフォーム 169

データウィンドウオブジェクトQuick Select でのカラムの選択 163WHERE 句 172概要 14, 161拡張 178カラムの再配置 178カラムの整列 180検索引数 171作成 163, 169提示様式 163, 169データウィンドウコントロールへのアタッチ

184, 187, 193データソース 163, 169表示順序 163保存 166, 176

データウィンドウオブジェクトでのカラムの整列 180

データウィンドウオブジェクトのカラム再配置 178整列 180

データウィンドウオブジェクトのサマリ区域 162

データウィンドウオブジェクトの詳細区域 162データウィンドウオブジェクトのフッタ区域

162データウィンドウオブジェクトのヘッダ区域

162, 164データウィンドウコントロール 126

PowerBuilder 入門

データウィンドウデータ式 140データウィンドウペインタ

WHERE 句 172区域 162検索引数 171

データソースQuick Select 163SQL Select 169

データベース拡張属性 100更新 294, 295実行時のデータベースへの接続 104接続 6データの検索、表示および操作 14表定義 96

データベース接続概要 6, 92トランザクションオブジェクト 104

データベースプロファイル 92データベースペインタ、使い方 96テーブルウィザード 320デバッグ

ウォッチの設定 209概要 199コードのステップ実行 204デバッグモードでの実行 204ブレークポイントの追加 200

トトランザクションオブジェクト 104, 139ドロップダウンデータウィンドウ編集様式 181ドロップダウンメニュー

項目の追加 144説明 17

ハ背景色、 3D がデフォルトオプション 71背景色、ウィンドウ 67パワーバー 8

331

索引

ヒビジュアルユーザオブジェクト 18ビュー

スタック 57操作 54タイトルバーの固定 56ドッキング 56浮動 56レイアウトスキーマの保存 58

ビュー、タイプHTML プレビュー（データウィンドウペインタ）

165Syntax （Select ペインタ） 171オブジェクト（データベースペインタ） 97オブジェクトの詳細（データベースペインタ）

99オブジェクトレイアウト（データベースペイン

タ） 98スクリプト 82テーブルレイアウト（Select ペインタ） 170デザイン（データウィンドウペインタ） 162プレビュー（データウィンドウペインタ） 165プレビュー（メニューペインタ） 144プロパティ 67レイアウト 67

ビューのドッキング 56

フ浮動

ツールバー 61ビュー 56

フリーフォーム提示様式カラム 178データウィンドウ定義 169

ブレークポイント 200フレームウィンドウ 87プロジェクトウィザード 235

332

ヘペインタ 7ペインタバー

コントロールの追加 70使い方 9ポップアップメニュー 61

ヘルプコンテキストメッセージ 82マイクロヘルプ 152

編集様式、ドロップダウンデータウィンドウ 181

変数gnv_connect 107インスタンス 107グローバル 107検証 266命名規約 108

ホボタン、追加 285ポップアップメニュー

概要 61ペインタバー 61

ママイクロヘルプ 152マウスの右ボタン、ポップアップメニュー 61マシンコード 234マネージャ、接続サービス 101

メメインウィンドウ、サイズ 43メニュー

概要 16継承 149作成 149スクリプトの追加 156ツールバー 146, 154

PowerBuilder

索引

保存 150メニュー項目 144

メニュー項目スクリプトの追加 156説明 16定義 144

メニューバー、説明 16メニューペインタ、使い方 144

ユユーザイベント

スクリプトの追加 134定義 134メニュースクリプトからの発生 156

ユーザオブジェクト概要 18使い方 126

ラライブラリ

JSP カスタムタグ 314アプリケーションの探索パス 124オブジェクトの再構築 142概要 19動的 234

レ例外

送出 220捕捉 223ユーザ定義 218

ワワークスペース 6

PowerBuilder 入門
333

334 PowerBuilder

powerbuilder 入門 · pdf file目次 powerbuilder 入門 v アプリケーションの close...

Documents