PowerBuilder 入門 · 目次 vi PowerBuilder Classic ラベルとカラムの整列..... 191 ドロップダウンデータウィンドウ編集スタイルの

PowerBuilder 入門

PowerBuilder® Classic12.5

DOCUMENT ID: DC37772-01-1250-01

LAST REVISED: July 2011

Copyright © 2011 by Sybase, Inc. All rights reserved.

本書は Sybase ソフトウェアの付属マニュアルであり、新しいマニュアルまたはテクニカルノートで特に示されないかぎり、後続のリリースにも付属します。このマニュアルの内容は、予告なく変更されることがありますが、 Sybase,Inc. およびその関連会社では内容の変更に関して一切の責任を負いません。このマニュアルに記載されているソフトウェアはライセンス契約に基づいて提供されるものであり、無断で使用することはできません。

予定したソフトウェアのリリース日にのみアップグレードを提供します。本書に記載されている内容は、 Sybase, Inc. およびその関連会社の書面による事前許可を得ずに、電子的、機械的、手作業、光学的、またはその他のいかなる手段によっても複製、転載、翻訳することを禁じます。

Sybase の商標は Sybase の商標ページの http://www.sybase.com/detail?id=1011207 に記載されています。記載の Sybase およびマークは Sybase, Inc の商標です。 ® はアメリカ合衆国における登録商標を示します。

SAP および本書で記載されている SAP の他の製品とサービス、さらにそれらに対応するロゴは、ドイツおよび世界各国における SAP AG の商標または登録商標です。

Java およびすべての Java ベースのマークは、米国および他国における Sun Microsystems, Inc. の商標または登録商標です。

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

本書で記載されている上記以外の社名および製品名は、関連各社の商標または登録商標の場合があります。

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

目次

PowerBuilder 入門 iii

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

第 1 部 POWERBUILDER の紹介

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

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

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

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

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

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

レッスン 2 PowerBuilder の環境のカスタマイズ ............................................ 53システムツリーウィンドウの操作 ............................................... 54オブジェクトを開く ....................................................................... 56ビューの操作.................................................................................. 58

目次

iv PowerBuilder Classic

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

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

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

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

指定 .................................................................................. 82コマンドボタンコントロールの追加...................................... 83コマンドボタンコントロールのプロパティの指定 ................ 84

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

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

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

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

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

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

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

コードの追加 .................................................................. 126

目次

PowerBuilder 入門 v

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

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

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

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

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

コントロール（dw_detail）の追加 ................................. 139ユーザオブジェクトから継承されたスクリプトの参照 ....... 141

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

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

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

ファイルメニューの修正 ...................................................... 154ヘルプメニュー項目の有効化............................................... 157

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

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

レッスン 7 データウィンドウオブジェクトの作成 ........................................ 171データウィンドウオブジェクトの新規作成とプレビュー .......... 172データウィンドウオブジェクトの保存 ....................................... 1781 つめのデータウィンドウオブジェクトの表示の変更 .............. 1792 つめのデータウィンドウオブジェクトの作成 ......................... 181

データソースおよびスタイルの選択 .................................... 181テーブルとカラムの選択 ....................................................... 182検索引数の定義 ..................................................................... 183WHERE 句の指定.................................................................. 184データウィンドウペインタでのデータウィンドウの

表示 ................................................................................ 186データウィンドウオブジェクトの保存 ................................ 188

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

目次

vi PowerBuilder Classic

ラベルとカラムの整列 .......................................................... 191ドロップダウンデータウィンドウ編集スタイルの

矢印の表示...................................................................... 193

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

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

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

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

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

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

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

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

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

レッスン 11 アプリケーション配布の準備 ....................................................... 251プロジェクトオブジェクトの作成 .............................................. 252実行ファイルの作成 ..................................................................... 256ショートカットの作成 ................................................................. 259実行ファイルのテスト ................................................................. 261

目次

PowerBuilder 入門 vii

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

レッスン 12 PowerBuilder チュートリアルの Web フォームアプリケーションへの変換 .................................................... 265PowerBuilder でのチュートリアルの実行.................................... 266.NET Web フォームアプリケーションへの変更 ......................... 268.NET Web フォームターゲットおよびプロジェクトの作成 ....... 271.NET Web フォームプロジェクトの配布 .................................... 275Web ブラウザからのアプリケーションの実行 ............................ 278

第 4 部 WINDOWS フォームアプリケーションの構築

レッスン 13 PowerBuilder チュートリアルの Windows フォームアプリケーションへの変換 .................................................... 285PowerBuilder でのチュートリアルの実行.................................... 286Solutions ディレクトリへのリソースファイルのコピー ............ 288.NET Windows フォームターゲットおよびプロジェクトの

作成 ................................................................................ 289Windows フォームターゲットの配布と実行............................... 292Web ブラウザへのアプリケーションの発行................................ 294Web ブラウザからのアプリケーションのインストールと実行 ... 296ほかのコンピュータへのアプリケーションのインストール........ 300アプリケーションの更新.............................................................. 302

索引.............................................................................................................................................. 305

目次

viii PowerBuilder Classic

PowerBuilder 入門 ix

本書について

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

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

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

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

• 第 3 部 .NET Web フォームターゲットを作成して実行するためのチュートリアルです。

• 第 4 部 .NET Windows フォームターゲットを作成して実行するためのチュートリアルです。

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

項目マニュアル説明

インストールインストールガイド

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

PowerBuilderの機能の概要と使用方法

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

プログラマ向けの情報

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

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

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

x PowerBuilder Classic


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

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

.NET ターゲット情報

アプリケーションとコンポーネントの .NET への配布

.NET Web フォームおよびWindows フォームのターゲットを構築、配布、デバッグ、実行する方法と、 PowerBuilder の非ビジュアルオブジェクトから.NET アセンブリコンポーネントおよび Web サービスを作成する方法を解説しています。

リファレンス情報

PowerScript® リファレンス

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

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

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

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

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

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

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

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

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

本書について

PowerBuilder 入門 xi

そのほかの情報製品に関するそのほかの詳細情報については、 PowerBuilder DVD、日本コンピュータシステム Web サイト、および Sybase® 製品マニュアルWeb サイト（英語）を参照してください。

• PowerBuilder DVD には、製品マニュアルが収められています。製品マニュアルは、 PDF 形式で提供しています。 PDF ファイルを読んだり、印刷したりするには、 Adobe Acrobat Reader が必要です。Adobe Acrobat Reader は、 Adobe Web サイトから無料でダウンロードすることができます。

• 日本コンピュータシステム Web サイトには、標準の Web ブラウザでアクセスすることができるオンライン版のマニュアルがあります。この Web サイトでは、 PDF 形式でマニュアルを見ることができます。

オンライン版のマニュアルには、日本コンピュータシステムのPowerBuilder のサイト http://www.powerbuilder.jp/ にある「技術情報」からアクセスできます。

• Sybase 製品マニュアル Web サイト（英語）は、標準の Web ブラウザからアクセスでき、 Sybase の製品マニュアルのほか、 EBF/ メンテナンス、技術文書などへのリンクも含まれています。

Sybase 製品マニュアル Web サイトには、 Product Manuals のサイト

http://www.sybase.com/support/manuals/ からアクセスできます。

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

データベース関連

データベースとの接続

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

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


xii PowerBuilder Classic

第 1 部 PowerBuilder の紹介

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

PowerBuilder 入門 3

第 1 章 PowerBuilder の概要

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

内容

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

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

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

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

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

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

項目ページ

PowerBuilder とは 3

PowerBuilder の環境 6PowerBuilder オブジェクト 12

PowerBuilder とは

4 PowerBuilder Classic

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

多層アプリケーションでは、サーバに配布するアプリケーション処理ロジックを含むモジュールをコンポーネントと呼びます。カスタムクラスユーザオブジェクトをアプリケーションサーバコンポーネントとして設計、構築、および配布できます。

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

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

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

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

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

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

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

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



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

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

.NET アプリケーション PowerBuilder の Enterprise エディションを使用している場合は、 .NET環境向けのアプリケーションおよびコンポーネントを開発できます。ASP.NET を使用して IIS サーバに配布する Web フォームアプリケーションや、スマートクライアント機能を使用して配布する Windowsフォームアプリケーションを開発できます。また、非ビジュアルカスタムクラスオブジェクトを .NET アセンブリに直接変換したり、非ビジュアルカスタムクラスオブジェクトを .NET Web サービスとして配布したりすることもできます。

.NET ターゲットについての詳細は、『アプリケーションとコンポーネントの .NET への配布』マニュアルを参照してください。

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

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

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

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

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

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

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

PowerBuilder の環境


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

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

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

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

PowerBuilder のターゲットは、以下のいずれかに当てはまります。

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

• .NET ターゲット .NET ターゲットは、アプリケーションを .NETWindows フォームまたは ASP.NET アプリケーションとして配布したり、非ビジュアルカスタムクラスコンポーネントを .NET アセンブリまたは Web サービスとして配布したりするために使用します。

• EAServer またはアプリケーションサーバコンポーネントターゲット

EAServer または J2EE 準拠の別のサーバに配布するコンポーネントです。

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



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

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

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

出力ウィンドウメインウィンドウの下部にある出力ウィンドウには、各種の操作（移行、構築、配布、プロジェクト実行、オブジェクトの保存、および検索）の出力が表示されます。出力情報が生成されると出力ウィンドウが自動的に開きますが、出力ウィンドウは、出力ウィンドウのツールバーボタンをクリックして、いつでも開くことができます。

ペインタワークスペースと PowerScript ターゲットを作成したら、ペインタを使用してターゲットのコンポーネントを構築します。ペインタには、ターゲット内のオブジェクトを拡張および微調整するための各種ツールが用意されています。



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

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

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

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

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

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

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

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



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

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

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

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

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



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

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

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

ボタン説明

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

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

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

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

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

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

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

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

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

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

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



PowerBuilder オブジェクトのライブラリの作成や管理を行う

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

アプリケーションサーバへの接続の方法を指定する

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

ファイルを編集する

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

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

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

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

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

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

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

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

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

PowerBuilder を終了する

ボタン説明

PowerBuilder オブジェクト


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

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

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

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

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

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

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

オブジェクト説明

アプリケーション

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

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

データウィンドウ

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

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

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

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

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

ユーザオブジェクト

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

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

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



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

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

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

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

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

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

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



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

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

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

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

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



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

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

以下に例を示します。

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



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

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

Web データウィンドウデータウィンドウオブジェクトは、 XML Webデータウィンドウを使用して（後続の XSLT を XHTML に変換して）XML で生成するか、 XHTML Web データウィンドウを使用してXHTML で直接生成するか、または HTML Web データウィンドウを使用して HTML で生成してブラウザで表示することができます。 Webデータウィンドウを作成するには、EAServer または COM+ で実行している PowerBuilder コンポーネントを使用します。

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

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



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

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

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

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

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

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

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

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



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

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

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

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

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

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

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

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



• 非ビジュアルユーザオブジェクトビジュアルコンポーネントを持たない、再利用可能な処理モジュールです。標準クラスユーザオブジェクトは、組み込みのシステムオブジェクトからイベントおよびプロパティを継承します。非ビジュアルオブジェクトは通常、ビジネスルールを定義したり、一連の処理を 1 つの単位として定義したりするのに使用します。

たとえば、手数料の計算や統計の分析を行う場合に使用できます。こうした処理を実行するためには、カスタムクラスユーザオブジェクトを定義します。カスタムクラスユーザオブジェクトを使用するには、スクリプトでオブジェクトのインスタンスを作成し、そのオブジェクト関数を呼び出します。

関数や変数を定義するカスタムクラスユーザオブジェクトは、PowerBuilder の多層アプリケーションの基礎になります。サーバ上で実行するアプリケーションに対しては、非ビジュアルコンポーネントを使用するのが一般的なためです。

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

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




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

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

内容

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

項目ページ

クライアント / サーバアプリケーションの構築方法の学習 21.NET Web フォームアプリケーションの構築方法の学習 23

.NET Windows フォームアプリケーションの構築方法の学習 23チュートリアルの進め方 24

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

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


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

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

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

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



.NET Web フォームアプリケーションの構築方法の学習このチュートリアルの第 2 部では、初の練習で構築したクライアントサーバアプリケーションを変換します。ただし、クライアントサーバチュートリアルを完了していなくても、 .NET Web フォームチュートリアルを実行できます。 PowerBuilder の Tutorial\Solutions ディレクトリ内にアプリケーションが用意されています。 Web フォームチュートリアルから始める場合は、クライアントサーバチュートリアルで構築するアプリケーションのかわりにこのアプリケーションを使用してください。

.NET Web フォームチュートリアルで構築するアプリケーションは、クライアントサーバチュートリアルで構築したアプリケーションとよく似ていますが、 .NET Web フォームアプリケーションは Web ブラウザで実行します。そのほかに、 Web フォームアプリケーションで選択するページナビゲーションツールバーなども少し異なります。チュートリアルでは、 PowerBuillder で構築できる .NET Web フォームアプリケーションのすべての機能については説明されていません。 Webフォームの印刷機能、テーマ設定、ユーザ管理など、そのほかの内容については、『アプリケーションとコンポーネントの .NET への配布』マニュアルで説明されています。

.NET Windows フォームアプリケーションの構築方法の学習

このチュートリアルの第 3 部では、初の練習で構築したクライアントサーバアプリケーションを変換します。ただし、クライアントサーバチュートリアルを完了していなくても、 .NET Windows フォームチュートリアルを実行できます。PowerBuilder の Tutorial\Solutions ディレクトリ内にアプリケーションが用意されています。 Windows フォームチュートリアルから始める場合は、クライアントサーバチュートリアルで構築するアプリケーションのかわりにこのアプリケーションを使用してください。

チュートリアルの進め方


.NET Windows フォームチュートリアルで構築するアプリケーションは、クライアントサーバチュートリアルで構築したアプリケーションとよく似ていますが、 .NET Windows アプリケーションはシンクライアントアプリケーションソリューションとして配布します。チュートリアルでは、 PowerBuillder で構築できる .NET Windows フォームアプリケーションのすべての機能については説明されていません。インテリジェント更新およびブートストラップの使用など、そのほかの内容については、『アプリケーションとコンポーネントの .NET への配布』マニュアルで説明されています。

チュートリアルの進め方表 2-1 に、チュートリアルの各レッスンで行う内容を示します。

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

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

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

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

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

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

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

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

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



所要時間

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

一時中断する場合それまでの作業内容を保存して、いつでも PowerBuilder を終了できます。作業を再開するときは、チュートリアルのワークスペースを開いて中断した場所から再開できます。

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

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

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

12 PowerBuilder クライアントサーバチュートリアルのアプリケーションを .NET Web フォームアプリケーションに変換する

13 PowerBuilder クライアントサーバチュートリアルのアプリケーションを .NET Windows フォームアプリケーションに変換する

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

チュートリアルの進め方


学習する内容

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

クライアント / サーバアプリケーション

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

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

機能目的

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

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

ウィンドウペインタ

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

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

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

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

レイアウトビュー

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

スクリプトビュー

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

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

プロジェクトペインタ

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



.NET アプリケーションこの .NET ターゲットチュートリアルでは、表 2-3 に示す基本動作について学習します。

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

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

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

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

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

チュートリアルを実行するために必要なすべてのファイルは、PowerBuilder のインストールディレクトリ配下にある Tutorial フォルダに格納されています。このフォルダのコピーは、インストール実行時にユーザプロファイルディレクトリ配下にも作成されます。チュートリアルでは、オリジナルのフォルダではなく、 Tutorial フォルダのコピーを使用します。 Tutorial フォルダのパスは、Windows のバージョンによって異なります。

機能目的

.NET Web フォームウィザード

クライアントサーバターゲットを Web フォームターゲットに変換し、 Web フォームプロジェクトとして配布する

グローバル変数 Web フォームアプリケーションのページナビゲーションツールバーの種類を修正する

.NET Windows フォームウィザード

クライアントサーバターゲットを Windows フォームターゲットに変換し、 Windows フォームプロジェクトとして配布する

インテリジェント更新技術

Windows フォームアプリケーションを Web ブラウザに発行し、ブラウザからアプリケーションをインストールする

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


• Windows XP、 Windows 2003 の場合

drive:\Documents and Settings\user\My Documents\Sybase\PowerBuilder12.5\Tutorial

• Vista、 Windows 2008 の場合

drive:\Users\user\Documents\Sybase\PowerBuilder 12.5\Tutorial

この文書では、全体を通じて前者（XP）のパスを使用します。 Vista または Windows 2008 のユーザは、ご自身の環境のパスに読み替えてください。

Tutorial フォルダには、次のファイルが含まれています。

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

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

Tutorial\Solutions ディレクトリ

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

ファイル内容

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

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

tutsport.bmp ビットマップ

tshirtw.jpg グラフィック

tutorial.ico アイコン

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

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


レッスン 1 PowerBuilder の起動

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

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

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

• ターゲットの作成

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

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

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

所要時間

約 20 分

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



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

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

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

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

チュートリアルをはじめる前に

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

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



PowerBuilder へようこそダイアログボックスが表示されます。

PowerBuilder へようこそダイアログボックスでは、新しいワークスペースを作成し、新しいターゲットまたは既存のターゲットをそのワークスペースに追加できます。

ダイアログボックスが再び表示されないようにするには

［開始時にワークスペースがない場合、このダイアログを開く］チェックボックスをオフにすると、PowerBuilder を起動するたびにPowerBuilder へようこそダイアログボックスを表示しません。PowerBuilder セッションを開始するたびに近使用したワークスペースをロードするには、［開始時に前回使用したワークスペースを再読込する］チェックボックスをオンにします。次に、［このダイアログボックスを閉じる］をクリックします。

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



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

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

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



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

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

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

4 tutorial フォルダを選択します。

すでにワークスペースを作成している場合は、ダイアログボックスは直前に使用されたワークスペースの場所で開きます。ここでは新規にワークスペースを作成するため、作成場所を次の段落に記載するパスに変更します。

初めてワークスペースを作成する場合は、新しいワークスペースダイアログボックスが drive:\Documents and Settings\user\MyDocuments（Windows XP、Windows 2003）、または drive:\Users\user\Documents （Vista、 Windows 2008）で開きます。この場所から、Sybase\PowerBuilder 12.5\Tutorial に移動します。チュートリアルのソリューションは Solutions サブフォルダ内にありますが、チュートリアルでは独自のソリューションを自分で作成します。



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

6 ［保存］をクリックします。

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



ターゲットの作成

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

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

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

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］テキストボックスを空白にします。

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

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



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

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

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

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

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

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

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



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

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

アプリケーションウィザードは pbtutor.pbt ターゲットおよびpbtutor.pbl ライブラリを作成し、新しい pbtutor アプリケーションをデフォルトアプリケーションとして設定します。

システムツリーを展開すると、テンプレートアプリケーションウィザードで作成されたオブジェクトをすべて表示できます。システムツリーには pbtutor ターゲットのファイル拡張子は表示されませんが、ターゲットファイルの保存先ディレクトリは表示されます。



pbtutor.pbl ライブラリはシステムツリーの pbtutor ターゲットの下に表示されます。ライブラリには、ターゲットアプリケーションオブジェクトが入っています。これは、ターゲットオブジェクトと同じ名前ですが、ライブラリファイルの下に表示されます。ウィザードによって生成されたほかのオブジェクトもライブラリファイルの下に表示されます。



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

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

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

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

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

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

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

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


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

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

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

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

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

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

拡張子 ico が見つからない場合

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



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

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

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



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

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

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

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

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

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

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



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

プロパティビューの外観が異なっている場合

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

4 プロパティビューの［その他］タブをクリックします。

5 ［幅］テキストボックスに「3000」、［高さ］テキストボックスに「2400」と入力します。

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



6 〔Tab〕を押します。

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

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

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



アプリケーションの実行

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

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

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

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

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

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

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



ウィンドウのタイトルバーの数字について

「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 内でコーディングしていた場合は、後にコーディングしていたスクリプトが開き、後に編集した行位置にカーソルが設定されます。


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

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


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

• オブジェクトを開く

• ビューの操作

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

所要時間

約 25 分

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


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

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

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

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

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

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

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

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

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

ペインタのワークスペースは灰色の（空白の）領域で、初はシステムツリーの右側にあります。オブジェクトを開くと、ここに表示されます。

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



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

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

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

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

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

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

デザイン時のプロパティのデフォルト設定に戻します。

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

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

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

オブジェクトを開く


オブジェクトを開く

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

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

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

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

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

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



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

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

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

アプリケーションオブジェクトの Open イベントは、ウィザードが生成する PowerScript コードで、PowerScript 関数を呼び出してアプリケーションのメインウィンドウを開きます。このチュートリアルの後半でこのコードを修正します。

ビューの操作


ビューの操作

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

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

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

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

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

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

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

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

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

• タブ付きビューの操作

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

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



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

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

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

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

新規スクリプトビューが表示されます。このスクリプトビューは、タブ付きペインのスタックには追加されません。左のドロップダウンリストボックスに、アプリケーションオブジェクトが一覧表示されます。ほかの 2 つのドロップダウンリストは空で、右のドロップダウンリストはグレー表示です。

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

ビューの操作


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

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

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

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

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

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

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

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



ビューの浮動化と固定化

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

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

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

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

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

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

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

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

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

タブ付きビューの操作

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

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

ビューの操作


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

ビューをスタックから浮動させる別の方法

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

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

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

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

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

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

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

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

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

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



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

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

ツールバーおよびシステムツリーのレイアウトの保存

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

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

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

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

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

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

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



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

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

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

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

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

• ツールバーの浮動化

• ツールバーの再配置

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

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

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

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

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

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

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



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

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

ツールバーの浮動化

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

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

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

ポップアップメニューについて

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



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

パワーバーが浮動型ツールバーに変わります。浮動型ツールバーの形状は調整できます。

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

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



ツールバーの再配置

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

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

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

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

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

ラジオボタンのグレー表示（指定したツールバーが表示されていない場合）

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

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

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

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



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

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

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

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

チュートリアルを中断する場合

PowerBuilder またはチュートリアルのワークスペースは、必要に応じて閉じることができます。チュートリアルを中断した場合に次のレッスンを再開するには、初にチュートリアルのワークスペースを開く必要があります。


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

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

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


• ウィンドウの新規作成

• コントロールの追加

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

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

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

所要時間

約 25 分

ウィンドウの新規作成



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

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

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

レスポンスウィンドウについて

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

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

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

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

ウィンドウペインタが開きます。スタイルバー（文字スタイルとテキスト配置ボタンを含む）、およびペインタバー 3 （色および枠のボタンとグレー表示のコントロール配置ボタンを含む）という、2 つのツールバーがあることに注意してください。

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



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

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

デフォルトのペインタレイアウトにするには

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

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

ウィンドウにグリッドを表示していない場合

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



4 プロパティビューの［全般］ページの［タイトル］テキストボックスに「Welcome」と入力します。

5 ［ウィンドウの種類］ドロップダウンリストボックスで「response!」を選択します。［タイトルバー］と［コントロールメニュー］チェックボックスがオンになっていることを確認します。［文脈ヘルプ］チェックボックスをオンにします。

文脈ヘルププロパティによって、ログインウィンドウのタイトルバー内の（コントロールメニューの）［閉じる］ボタンの横に［?］ボタンが追加されます。アプリケーションのユーザは［?］ボタンをクリックして、ウィンドウコントロールの Help イベントを発生させることができます。［?］ボタンはレスポンスウィンドウに追加できますが、メインウィンドウにはできません。

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

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

位置プロパティを入力する別の方法

値は、手動入力するかわりにスピンコントロールを使用して入力できます。

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

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

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



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

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

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

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

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

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

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

コントロールの追加



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

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

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

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

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

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

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

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

ピクチャハイパーリンク

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

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

スタティックテキスト

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



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

コントロールを 3D 表示にする

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

ここでは、コントロールを追加し、プロパティの一部を変更して、作成したログインウィドウを修正します。このレッスンでは、以下の項目について学習します。

• ピクチャコントロールの追加

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

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

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

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

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

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

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

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

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

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

マルチラインエディット

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

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



ピクチャコントロールの追加

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

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

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

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

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

コントロールを削除するには

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

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

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

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

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



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

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

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

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

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

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

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



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

このステップでは、スタティックテキストコントロールをログインウィンドウに追加します。これらのコントロールを使用して、説明ラベルをログインウィンドウに追加します。

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

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

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

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

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

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

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

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

5 3 つのコントロールの位置を変更し、少なくともグリッド線 2 つ分の間隔をあけるようにします。



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

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

1 初に追加したスタティックテキストコントロールをクリックして選択します。

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

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

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

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

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

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

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

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



スタイルバーの使い方

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

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

サイズを調整するには、レイアウトビューでコントロールの右上隅のハンドルをウィンドウの右上隅の方へドラッグします。サイズを変更する方法としてはそれ以外にも、このコントロールのプロパティビューの［その他］ページで適切な値を入力する方法があります。

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

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

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



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

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

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

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

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 つのコマンドボタンコントロールの間に適当な間隔を置くようにします。



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

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

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

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

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

ここでは、コントロールの内容を説明するためにデフォルト名「未設定」を変更して、ボタンにテキストラベル（OK）を付けています。［デフォルト］チェックボックスをオンにしたので、アプリケーションユーザが〔Enter〕を押すと、このボタンの Clicked イベントが発生します（ユーザはボタンをクリックしてイベントを発生させる必要はありません）。

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

［キャンセル］チェックボックスをオンにしたので、アプリケーションユーザが〔Esc〕を押すと、このボタンの Clicked イベントが発生します。



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

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

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

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

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

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

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

2 sle_userid コントロールの［タブ順序番号］をクリックします。コントロールのタブ順序が「10」になっていない場合は、「10」を入力します。

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

3 必要に応じて変更を加えて、ほかのコントロールの値が以下のようになるようにします。

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

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

sle_password 20

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

cb_ok 30

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

cb_cancel 40

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


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

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



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

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

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

このステップでは、スクリプトビューを使用して、ログインウィンドウに配置されているシングルラインエディットコントロールに状況依存ヘルプ（文脈ヘルプ）メッセージを追加し、そのウィンドウをプレビュー表示します。

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

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

スクリプトビューがウィンドウペインタに表示されていないときは、レイアウトビューでオブジェクトをダブルクリックして開きます。

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

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

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

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

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

現在のオブジェクトに先祖オブジェクトがある場合は、そのすべて

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

選択した関数と同じシグネチャの関数を持つ、すべての先祖オブジェクト

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

なし



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

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

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

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

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

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〕を押します。

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

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

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

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

12 ペインタバー 1 の［閉じる］ボタンをクリックして、ウィンドウペインタを閉じます。

この［閉じる］ボタンには「x」のラベルが付いています。



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

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

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

このステップでは、アプリケーション起動開始の直後にログインウィンドウを開くための、スクリプトを追加します。アプリケーションオブジェクトの Open イベント内のスクリプトを変更してログインウィンドウを開くことができますが、このチュートリアルでは、 MDI フレームウィンドウの Open イベントからログインウィンドウを開く呼び出しを作成します。このウィンドウ（w_pbtutor_frame）は、テンプレートアプリケーションウィザードで作成されたものです。

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

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

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

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



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

ここで、フレームウィンドウ Open イベントのスクリプトを、ログインウィンドウを開くように修正します。

ウィザードで生成されたスクリプト

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

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

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

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

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

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

ライブラリ pbtutor.pbl — 現在の唯一のライブラリ。ライブラリ名が完全に表示されない場合は、ダイアログボックスの端をドラッグしてボックスを拡大できます。

オブジェクト名 w_pbtutor_frameオブジェクトの種類ウィンドウ — このデータ型の名前付きオブ

ジェクトを選択するには、これが選択されていることを確認しておく必要があります。

使用ペインタ




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

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

3 スクリプトビューの上部にカーソルを移動します。

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

4 スクリプトビューのタイトルバーの［プッシュピン］ボタンをクリックします。

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

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

5 スクリプトビューで Open イベントが表示されていることを確認します。

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



コメントの使い方

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

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

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

this.Post Event ue_postopen ( )

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

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

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

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

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

9 コメントの後にカーソルを移動します。〔Enter〕を押して改行します。新規の行に「open (w_welcome)」と入力します。



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

状況依存ヘルプへのアクセス

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



スクリプトのコンパイル

ここでは、入力したスクリプトをコンパイルします。ポップアップメニュー項目を使ってスクリプトをコンパイルします。 PowerBuilder では、スクリプトビューを閉じたときや、スクリプトビューで別のオブジェクト、イベント、または関数を選択したときにも、自動的にスクリプトがコンパイルされます。

スクリプトのエラー処理

スクリプトにエラーがある場合は、スクリプトビューの下部にエラーウィンドウが開き、エラー番号とエラーメッセージが表示されます。

エラーを見つけるにはエラーメッセージをクリックすると、エラーのある行にカーソルが移動します。エラーを修正したら、スクリプトのコンパイルを再試行します。

エラーのコメントアウト PowerBuilder では、エラーのあるスクリプトは保存されません。エラーのあるスクリプトを保存するには、そのスクリプト全体を選択し、［コメント］ボタンをクリックしてコードをコメントアウトします。こうして保存しておいたスクリプトは、後で開いて、コメントを外してから、エラー箇所を修正します。

1 スクリプトビューのスクリプト領域内の任意の場所を右クリックします。ポップアップメニューで［コンパイル］を選択します。

スクリプトがコンパイルされます。このときに、スクリプトビューまたはウィンドウペインタのワークスペースを閉じたり、ほかのビューに移動したりしないでください。

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



レッスン 4 データベースへの接続

このレッスンでは、実行時にアプリケーションを EAS Demo DB（Enterprise Application Sample demonstration database）に接続するためのスクリプトを記述します。また、データベースペインタを使用してテーブル定義を参照したり、EAS Demo DB データベースのデータベースプロファイルを参照したりします。


• EAS Demo DB データベースの参照

• 接続オブジェクトウィザードの実行

• グローバル変数の宣言

• 接続情報の変更

• ログインおよびログアウトスクリプトの完了


所要時間

約 30 分

EAS Demo DB データベースの参照



現在の学習個所> EAS Demo DB データベースの参照

接続オブジェクトウィザードの実行グローバル変数の宣言接続情報の変更ログインおよびログアウトスクリプトの完了アプリケーションの実行

多くの企業には、データベース専門の管理者がいます。組織内にデータベース管理者がいれば、データベース内にテーブルを作成して管理する必要はないかもしれません。しかし、ここでは PowerBuilder の機能をフルに活用するために、データベースでの作業方法を説明します。

データソースの定義 ODBC Administrator などのデータベース接続ユーティリティを使用して、データベースをアプリケーションのデータソースとして定義できます。 ODBC Administrator には DB プロファイルダイアログボックスからアクセスできます。 ODBC データソースの定義は、 odbc.ini レジストリキーに記述されています。

データベースプロファイルを使用した接続いったんデータソースを定義したら、そのデータソース用のデータベースプロファイルを作成できます。データベースプロファイルとは、ある特定のデータソースまたはデータベースとの接続を行う際に指定するパラメータセットのことです。データベースプロファイルを使用すれば、使用頻度の高いデータベース接続の管理を容易に行うことができます。アプリケーションの開発中にデータベースプロファイルを変更してほかのデータソースに接続できます。

データベース接続を行う時期デザイン時または実行時の環境のいずれかでデータベースへの接続を確立できます。 PowerBuilder は、ペインタを開くときや、埋め込み SQL 文を含むスクリプトをコンパイルまたは保存するとき、あるいはデータベースにアクセスするアプリケーションを実行するときにデータベースへの接続を行います。

PowerBuilder でデータベース定義を管理するには、ほとんどの場合データベースペインタを使用します。データベースペインタでは以下の操作が行えます。

• テーブルの作成、変更、削除

• 主キーと外部キーの作成、変更、削除

• インデックスキーの作成、削除



• カラムの拡張属性の定義、修正

• ビューの削除


• EAS Demo DB データベースプロファイルの参照

• EAS Demo DB データベースのテーブル定義の参照

EAS Demo DB データベースプロファイルの参照

標準オプションで PowerBuilder をインストールした場合は、すでにEAS Demo DB データベース用に定義されたデータソースとデータベースプロファイルがあります。このチュートリアルでは、EAS DemoDB データベースを使用します。

EAS Demo DB は、 ODBC を介してアクセスする SQL Anywhere データベースです。このレッスンでは、 EAS Demo DB データベースのデータベースプロファイルを調べます。データベースプロファイルのパラメータは、レジストリ内に保持されます。

1 パワーバーの［DB プロファイル］ボタンをクリックします。またはメニューバーの［ツール｜ DB プロファイル］を選択します。

DB プロファイルダイアログボックスが表示されます。 DB プロファイルダイアログボックスには、インストールしたデータベースインタフェースと各インタフェースで定義したデータベースプロファイルがツリー形式で表示されています。ツリービューで項目の横にある + 記号をクリックするか、アイコンをダブルクリックして、ツリービューのノードを開いたり閉じたりできます。

2 + 記号をクリックして ODB ODBC を展開し、 EAS Demo DB V125を選択します。



このプロファイルは、インストール時に作成されます。

EAS Demo DB V125 データベースプロファイルが表示されない場合

EAS Demo DB V125 データベースのプロファイルがない場合は、データベースをインストールしていない可能性があります。インストールは、製品 DVD-ROM から行うことができます。

データベースをインストールし、 ODBC Administrator でデータソースとして定義している場合は、データベースプロファイルペインタのツリービューから「ODBC」を選択して、［新規作成］をクリックします。 DB プロファイル設定ダイアログボックスで、［データソース］ドロップダウンリストからデータソースを選択し、［プロファイル名］テキストボックスに「EAS Demo DB V125」と入力します。ユーザ ID に「dba」、パスワードに「sql」と入力し、［OK］をクリックしてペインタに戻ります。

3 ［編集］をクリックします。

DB プロファイル設定ダイアログボックスの［接続］ページが表示されます。



4 ［プレビュー］タブをクリックします。

選択したプロファイルの接続構文が［プレビュー］タブに表示されます。プロファイルの接続オプションを変更すると、それに従って構文も変更されます。

5 ［接続のテスト］ボタンをクリックします。

接続に成功したことを通知するメッセージボックスが表示されます。

接続に失敗したというメッセージボックスが表示された場合

メッセージボックスを閉じて、 DB プロファイル設定ダイアログボックスの［接続］ページの内容が正しいことを確認してから、ODBC Administrator のデータソースの設定内容をチェックしてください。 ODBC Administrator を実行するには、データベースプロファイルペインタの ODB ODBC ノードの下にある Utilities フォルダを展開して、「ODBC Administrator」項目をダブルクリックします。

6 ［OK］をクリックして、メッセージボックスを閉じます。［キャンセル］をクリックして、 DB プロファイル設定ダイアログボックスを閉じます。［閉じる］をクリックして、 DB プロファイルダイアログボックスを閉じます。



EAS Demo DB データベースのテーブル定義の参照

このステップでは、EAS Demo DB データベースの顧客情報（customer）テーブルと商品管理（product）テーブルの定義を参照します。これにより、データベースペインタとチュートリアルで使用するテーブルについてよく理解できます。

接続時の処理内容テーブル定義を参照するには、データベースに接続する必要があります。開発環境でデータベース環境に接続すると、接続パラメータが Windows レジストリに書き込まれます。

異なるデータベースに接続するたびに、レジストリ内の既存の接続パラメータが新しいデータベースの接続パラメータに置き換えられます。データベースにアクセスする PowerBuilder ペインタを開くと、後に使用したデータベースに自動的に接続されます。 PowerBuilder は、レジストリの読み出しにより、後に使用したデータベースを特定します。

1 パワーバーの［DB ペインタ］ボタンをクリックします

PowerBuilder がデータベースに接続し、データベースペインタが開きます。データベースペインタのタイトルバーにアクティブなデータベース接続が表示されます。

データベースペインタのオブジェクトビューで、「使用できる DBインタフェース」というヘッダの下に、既存の全データベースプロファイルがツリー形式で表示されています。EAS Demo DB V125データベースは、ツリービューの ODB ODBC ノードの下に表示されます。

オブジェクトビューが開いていない場合

オブジェクトビューは、デフォルトのビューレイアウトの一部です。このビューレイアウト構成をリセットするには、［ビュー｜レイアウト｜（デフォルト）］を選択します。また、メニューバーから［ビュー｜オブジェクト］を選択して、オブジェクトビューを開くこともできます。

2 オブジェクトビューで、 EAS Demo DB V125 データベースノードを展開します。



EAS Demo DB V125 データベースノードの下にあるフォルダを確認します。

3 テーブルフォルダを開きます。

データベースにあるテーブルがリスト表示されます。

テーブル名には接頭辞を付けることができます。

テーブルの選択ダイアログボックスのテーブル名に付けられる接頭辞としては、 dba や dbo などがあります。テーブル名に付けられる接頭辞は、使用しているログイン ID によって異なります。接頭辞は無視してもかまいません。

4 「customer」テーブルを右クリックして、ポップアップメニューの［レイアウトに追加］を選択します。またはオブジェクトビューから「customer」テーブルをドラッグして、オブジェクトレイアウトビューにドロップします。



現在のビューからほかのビューにオブジェクトをドラッグする方法

オブジェクトビューからほかのビューへのドラッグを始めると、ポインタの形状が斜線入りの円に変わります。オブジェクトをドロップできるほかのビューまでそのままカーソルを移動すると、斜線入りの円がポインタの形に戻り、小さなボックスの中に新しい矢印が表示されます。この矢印が表示されたら、オブジェクトをドロップすることができます。

5 手順 4 を繰り返して、 product テーブルについても同じ作業を行います。

オブジェクトレイアウトビューの拡大

オブジェクトレイアウトビューは、分割バーをペインタフレームの方へドラッグして幅を広げることができます。オブジェクトレイアウトビューがスタックの一部の場合、サイズを変更する前にスタックから切り離したほうが簡単な場合もあります。

オブジェクトレイアウトビューに、 2 つのテーブルが表示されます。



テーブルのデータ型、コメント、キー、およびインデックスの表示

オブジェクトレイアウトビューには、各カラムについての説明と、キーおよびインデックスのアイコンが表示されます。このアイコンが表示されない場合は、ビュー内の空白の領域を右クリックし、ポップアップメニューから［コメントの表示］と［参照整合性の表示］を選択してから、［インデックスの表示］を選択します。［データタイプの表示］を選択しないと、選択されているテーブル内にある各カラムのデータ型は表示されません。

6 オブジェクトレイアウトビューで customer テーブルのタイトルバーを右クリックして、ポップアップメニューの［テーブルの変更］を選択します。またはオブジェクトのツリービューで customer テーブルを右クリックして、ポップアップメニューの［テーブルの変更］を選択します。

カラムビューに、テーブルのカラム定義が表示されます。

7 オブジェクトレイアウトビューで、 customer テーブルのカラムを右クリックします。ポップアップメニューから［プロパティ］を選択します。

データベースペインタのプロパティビューは、オブジェクトの詳細ビューとも呼ばれます。

オブジェクトの詳細ビューのタイトルバーとタブヘッダは、どのオブジェクトを選択しているかによってまったく異なります。タイトルバーには、オブジェクトの種類、データベース接続、およびオブジェクトの識別子が表示されます。



カラムのオブジェクトの詳細ビューには 5 つのタブがあります。通常のデータベースのプロパティ全般に関するものが 1 つあり、カラムのヘッダ情報に関するもの、そのほかのタブはカラムの拡張属性に関するものです。

拡張属性について

PowerBuilder では、データベースのシステムテーブルの集まり（リポジトリ）に拡張属性情報を格納します。拡張属性とは、カラムのヘッダとラベル、カラムの初期値、入力条件則、表示書式のことをいいます。

データベースペインタの拡張属性ビューで、項目のポップアップメニューから、新しい拡張属性を定義したり、既存の拡張属性の定義を変更したりできます。

8 データベースペインタを閉じます。



接続オブジェクトウィザードの実行

現在の学習個所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 V125」を選択します。

5 接続オブジェクトの作成準備完了ページが表示されるまで、［次へ］をクリックします。

以下の項目についてデフォルトの設定を確認します。

ウィザードは、データベース接続の管理用にユーザオブジェクトn_pbtutor_connectservice を作成します。このオブジェクトのインスタンス変数を変更すると、接続情報のソースをレジストリまたはスクリプトファイルに変更できます。それ以外の場合は、ウィザードで作成した pbtutor.ini ファイルがアプリケーションの接続情報として使用されます。

ウィザードページオプションデフォルト設定

接続ソース情報の指定

接続情報の取得元アプリケーション INI ファイル

接続サービスオブジェクト

n_pbtutor_connectservice

アプリケーションの INI ファイルの指定

アプリケーション INIファイル

pbtutor.ini



後のウィザードページに、ウィザードで選択した内容（デフォルトのものも含む）のまとめが表示されます。

6 ［完了］ボタンをクリックします。

接続サービスオブジェクトが、ウィザードによって作成され、ユーザオブジェクトペインタで開きます。システムツリーにn_pbtutor_connectservice が表示されます。ウィザードでは、アプリケーションの INI ファイルも作成されます。To-Do リストは開いたままです。

7 To-Do リストを閉じます。



グローバル変数の宣言

現在の学習個所EAS Demo DB データベースの参照接続オブジェクトウィザードの実行

> グローバル変数の宣言接続情報の変更ログインおよびログアウトスクリプトの完了アプリケーションの実行

次のステップでは、新しい接続サービスマネージャを検証して、参照するグローバル変数を作成します。グローバル変数は、アプリケーションのすべてのオブジェクトに対して有効です。

複雑なアプリケーションでは、ローカル変数で接続サービスマネージャを参照したほうがよい場合もあります。そうすれば、ローカル変数がスコープから出たときに、より多くのメモリが解放されます。しかしこのチュートリアルでは、データベース接続が開いている限り、接続サービスマネージャのインスタンスを利用できるようにします。

接続の確立アプリケーションが実行時にデータベースに接続できるようにするために、接続サービスマネージャは、ウィザードで生成した関数を呼び出して、アプリケーションとデータベースの間の通信領域として機能するトランザクションオブジェクトのプロパティを設定します。

SQLCA トランザクションオブジェクト接続サービスマネージャは、組み込みの非ビジュアルシステムオブジェクト、 SQL 通信領域（SQLCA）オブジェクトを、デフォルトのトランザクションオブジェクトとして使用します。SQLCA オブジェクトには、いくつかのプロパティ（データベース名、ログイン ID、およびパスワードを含む）が接続サービスマネージャによってデフォルトで設定されています。

アプリケーションが複数のデータベースと通信する場合は、必要であれば、データベース接続ごとに 1 つのトランザクションオブジェクトを作成できます。



必要なものと省略可能なもの

データベースへの接続にはトランザクションオブジェクトが必要です。接続サービスマネージャは接続自体に必要なものではありませんが、トランザクションオブジェクトのプロパティを自動的に生成するため、このチュートリアルでは使用します。接続サービスマネージャがない場合、アプリケーションのスクリプトでプロパティを直接入力しなければなりません。

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 ファイルの [Database] セクションを参照し、ProfileString 関数呼び出しでデータベース接続情報を取得します。ここでは、指定した INI ファイルは pbtutor.ini です。この pbtutor.ini ファイルは、前のステップで接続オブジェクトウィザードを使用して作成したものです。

この後のステップで、pbtutor.ini ファイルと of_GetConnectionInfo 関数を変更し、ユーザ ID とパスワード情報を INI ファイルではなくログインウィンドウから取得するようにします。

4 2 番目のドロップダウンリストボックスで「of_ConnectDB」を選択します。

これは、SQLCA トランザクションオブジェクトを使用して実際にデータベースに接続する接続サービスマネージャの関数です。この関数は、レッスン 3 「ログインウィンドウの作成」で作成したログインウィンドウから呼び出すことができます。

ウィザードで生成されたこの関数のスクリプトには、データベース接続が失敗した場合にメッセージボックスを表示することも記述されています。

5 2 番目のドロップダウンリストボックスで「of_DisconnectDB」を選択します。

これは、データベース接続を解除するための、接続サービスマネージャの関数です。この関数は、アプリケーションの Close イベントから呼び出すことができます。

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 ペインタバーの［保存］ボタンをクリックします。またはメニューバーから［ファイル｜上書き保存］を選択します。



スクリプトがコンパイルされて保存されます。グローバル変数のデータ型を（システムツリーからドラッグせずに）入力した場合、入力ミスがあると、エラーメッセージが表示されます。その場合は、エラーを修正してからもう一度［上書き保存］を選択してください。



接続情報の変更

現在の学習個所EAS Demo DB データベースの参照接続オブジェクトウィザードの実行グローバル変数の宣言

> 接続情報の変更ログインおよびログアウトスクリプトの完了アプリケーションの実行

これで、接続サービスマネージャを呼び出してデータベース接続を確立できます。ただし、データベース接続を確立するのは、ログインウィンドウで有効なユーザ ID とパスワードが入力された場合のみにする必要があります。そこで、 pbtutor.ini ファイルの情報をユーザが入力した情報に置き換えて、ログインウィンドウの［OK］ボタンの Clickedイベントに接続サービス呼び出しを追加します。

ただし、［OK］ボタンにこの呼び出しを追加する前に、 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 の［コメント］ボタンをクリックします。

pbtutor.ini ファイルの DBParm パラメータには、ハードコーディングされたユーザ ID、パスワード、およびデータベース名が含まれていますが、これらの値は使用しません。そのかわりに、ユーザが入力した情報（ユーザ ID とパスワード）の値を DBParm パラメータに代入します。

SQLCA DBParm パラメータについて

DBParm の ConnectString でユーザ ID とパスワードは不要ですが、その 2 つを ConnectString に代入すると、SQL Anywhere データベースのデータソース定義にある SQLCA ユーザ ID とパスワードは上書きされます。この DBMS では、 DBParm パラメータは、 SQLCAの UserID パラメータと DBPass パラメータより優先します。

6 ペインタバー 1 の［保存］ボタンをクリックします。ペインタバー 1 の［閉じる］ボタンをクリックします。



接続サービスマネージャの呼び出し

次のステップでは、接続サービスマネージャを呼び出して、データベースに接続します。ログインウィンドウからユーザ入力情報を追加する必要があるため、接続サービスマネージャを呼び出すスクリプトを、このウィンドウの［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 エラー文が表示されます。



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 イベントに対するコードの追加



オートスクリプト用のショートカットの設定

オートスクリプトは、スクリプトを記述するときに役立ちます。たとえば、入力中の文を自動的に完成させたり、カーソル位置に挿入すべき言語要素のリストを表示したりする機能があります。

1 メニューバーから［デザイン｜オプション］を選択し、［オートスクリプト］タブをクリックします。

2 初の 3 つのグループボックス内のすべてのチェックボックスがオンになっていることを確認します。

3 4 番目のグループボックスの［ドットの直後のみ起動］チェックボックスおよび［自動的にポップアップ］チェックボックスがオフになっていることを確認して、［OK］をクリックします。

このように設定しておくと、オートスクリプトは、挿入すべきコードを判定するための十分な情報があるところで、ヘルプを表示します。ただし、カーソルを置いただけでは自動的にはポップアップしません。［ステートメントテンプレート］チェックボックスをオンにすると（デフォルトではオフ）、オートスクリプトを使用して、複数行にまたがる PowerScript 構文を入力できます。

4 メニューバーから［ツール｜ショートカット］を選択します。ツリーの［編集］ノードを展開します。

5 下にスクロールして、［オートスクリプトの有効化］を選択します。［ショートカットキー］ボックスにカーソルを合わせて、〔Ctrl〕 +〔Space〕を押します。

6 ［現在のメニュー］リストで［編集｜ジャンプ］ノードを展開し、［次のマーク］を選択します。［ショートカットキー］ボックスにカーソルを合わせて、〔Ctrl〕 +〔M〕を押します。

これで、コードの入力中にヘルプが必要な場合はいつでも、〔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 V125;"

上記の行では、ローカル変数を宣言して、値を代入しています。ConnectString テキスト内では、= 記号の前後にスペースを入れないでください。単独の単引用符は、このままで構いません。次の手順で別の単引用符を追加して、接続スクリプトを完成させます。

オートスクリプトを使用して代入文を簡単にコーディングする方法

オートスクリプトで代入文を入力するときに、変数名の中のアンダースコア（_）よりも前に英字を入力して〔Ctrl〕 + 〔Space〕を押すと、入力データ候補のリストをポップアップさせることができます。矢印キーを使用して適切な入力データ候補に移動し、これを〔Tab〕でスクリプト内に貼り付けます。まずアンダースコア（_）を入力し、その後ろに先頭の英字を入力して〔Ctrl〕 + 〔Space〕を押すと、一意の入力データ候補がある場合は、これが直接スクリプト内に貼り付けられます。



Trim 関数は、ログインウィンドウのシングルラインエディットボックスから引数として渡されたユーザ ID およびパスワードの値の前後のスペースを削除します。

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 ペインタバーの［閉じる］ボタンをクリックします。またはメニューバーから［ファイル｜閉じる］を選択します。




アプリケーションの 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 の［閉じる］ボタンをクリックします。

メッセージボックスが表示され、アプリケーションライブラリファイルのアプリケーションオブジェクトの変更内容を保存するかどうかをたずねられます。


変更内容が保存され、アプリケーションペインタが閉じます。




現在の学習個所EAS Demo DB データベースの参照接続オブジェクトウィザードの実行グローバル変数の宣言接続情報の変更ログインおよびログアウトスクリプトの完了


このステップでは、アプリケーションを実行します。

1 パワーバーの［実行］ボタンをクリックします。メッセージボックスが表示され、変更を保存するよう要求されたら、［はい］をクリックして保存します。

ワークスペースが閉じ、アプリケーションが実行されます。

2 ［ユーザ ID］テキストボックスに「dba」と入力します。［パスワード］ボックスに「sql」と入力します。

パスワードはアスタリスクで表示されます。このウィンドウのタブ順序はすでに設定してあるため、〔Tab〕を押して［ユーザ ID］ボックスから［パスワード］ボックス、さらに［OK］にフォーカスを移動できます。


データベースに接続して、 MDI フレームが開きます。

無効なユーザ ID とパスワードを入力した場合

ユーザ ID とパスワードに入力ミスがあった場合、 SQL Anywhereの接続ダイアログボックスが表示されます。このダイアログボックスの［ログイン］ページで正しいユーザ ID とパスワードを入力し直してください。パスワードとユーザ ID を変更せずに、このダイアログボックスの［ODBC］ページで［テスト接続］ボタンをクリックすると、ユーザ ID とパスワードの無効を通知するメッセージボックスが表示されます。

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

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



レッスン 5 先祖ウィンドウの変更



このレッスンでは、テンプレートアプリケーションウィザードを使用して生成したベースシートウィンドウを継承するウィンドウを作成します。まず、データウィンドウコントロールを含む定義済みのユーザオブジェクトを、継承されるウィンドウに追加します。次に、オリジナルのベースシートではなく、拡張レイヤウィンドウを継承する新規ウィンドウ w_customers と w_products を作成します。後に、これらのシートウィンドウが、デザイン時に設定したサイズで実行時に開くようにします。

その前にまず、データウィンドウコントロールを含む定義済みのユーザオブジェクトが登録されたライブラリリストに、ライブラリを追加します。このレッスンでは、以下の項目について学習します。

• 探索パスへのライブラリの追加

• 先祖シートウィンドウの新規作成

• ユーザイベントおよびイベントスクリプトの追加

• データウィンドウコントロールのデータの検索を行うスクリプトの追加

• シートウィンドウのサイズに合わせた実行時の設定の調整

所要時間

約 30 分

探索パスへのライブラリの追加


探索パスへのライブラリの追加

現在の学習個所> 探索パスへのライブラリの追加

先祖シートウィンドウの新規作成ユーザイベントおよびイベントスクリプトの追加データウィンドウコントロールのデータの検索を行うスクリプトの追加シートウィンドウのサイズに合わせた実行時の設定の調整

このステップでは、チュートリアルアプリケーションの探索パスにライブラリを追加します。アプリケーションで使用するすべてのライブラリを追加する必要があります。

現在のアプリケーションに追加するライブラリには、ベースシートウィンドウに後で追加するユーザオブジェクト（u_dwstandard）など、いくつかのコーディング済みのオブジェクトが含まれます。

1 システムツリーの pbtutor ターゲット（pbtutor アプリケーションオブジェクトではない）を右クリックします。

pbtutor ターゲットには、 pbtutor.pbl と pbtutor アプリケーションが入っています。

2 ポップアップメニューで［プロパティ］をクリックします。

pbtutor ターゲットプロパティダイアログボックスが表示されます。

3 ［ライブラリリスト］ページが表示されていることを確認します。［参照］ボタンをクリックします。

ライブラリの選択ダイアログボックスが表示されます。



4 Tutorial フォルダに移動します。「tutor_pb.pbl」を選択し、［開く］をクリックします。

［ライブラリリスト］ページに戻ります。チュートリアルアプリケーションの探索パスに tutor_pb.pbl ファイルが含まれています。


先祖シートウィンドウの新規作成



現在の学習個所探索パスへのライブラリの追加

> 先祖シートウィンドウの新規作成ユーザイベントおよびイベントスクリプトの追加データウィンドウコントロールのデータの検索を行うスクリプトの追加シートウィンドウのサイズに合わせた実行時の設定の調整

テンプレートアプリケーションウィザードを使用して生成したベースシートウィンドウを継承するウィンドウを作成し、データウィンドウコントロールを追加します。ソースエディタで、生成したシートウィンドウ（w_customers と w_products）が、上記の新規ウィンドウを継承するように変更します。

新規の先祖ウィンドウに追加するデータウィンドウコントロールは、チュートリアルアプリケーション用に作成したユーザオブジェクトから定義を継承します。このユーザオブジェクトは、先ほどターゲットライブラリリストに追加した PBL ファイルに含まれています。ユーザオブジェクトとは、カスタマイズされたデータウィンドウコントロールのことで、標準のデータベースエラーのチェックを実行するスクリプトを含みます。

ユーザオブジェクトを使用する理由

PowerBuilder では、アプリケーションでよく使用する処理を実行するためにユーザオブジェクトを構築します。定義したユーザオブジェクトは、追加作業なしで繰り返し利用できます。


• 新規シートウィンドウの継承階層の作成

• マスタデータウィンドウ用のデータウィンドウコントロール（dw_master）の追加

• 詳細データウィンドウ用のデータウィンドウコントロール（dw_detail）の追加

• ユーザオブジェクトから継承されたスクリプトの参照



新規シートウィンドウの継承階層の作成

このステップで新規に作成するウィンドウは、ベースシートウィンドウとアプリケーションシートウィンドウの間の拡張レイヤになります。後で、この拡張レイヤウィンドウに変更を加えます。この変更は、この拡張レイヤウィンドウを継承するすべての新規シートウィンドウに自動的に反映されます。

現在のチュートリアルアプリケーションでは、すでに w_customers および w_products ウィンドウが w_pbtutor_basesheet ウィンドウを継承しています。ウィザードによって生成されたこれらのシートウィンドウには（名前と表示テキストを除き）固有のプロパティ値や関数をまだ追加していないため、これらのウィンドウを上書きして新規のウィンドウを作成する際にコードをコピーする必要は一切ありません。このレッスンでは、これらのウィンドウを上書きして、拡張レイヤウィンドウを継承する新規ウィンドウを作成します。

1 PowerBuilder メニューから［ファイル｜継承］を選択します。

オブジェクトから継承ダイアログボックスが表示されます。

2 ［ライブラリ］リストボックスで pbtutor.pbl が選択されており、［オブジェクトの種類］ドロップダウンリストで「ウィンドウ」が選択されていることを確認します。

ライブラリリストが完全に表示されない場合は、ダイアログボックスの一辺をクリックしてマウスのボタンを押したまま画面の端の方にドラッグして、ダイアログボックスのサイズを拡大できます。［ライブラリ］リストボックスには 2 つのライブラリが表示され、 pbtutor.pbl は 1 番目に表示されます。

3 メインのリストボックスで、オブジェクトカラムの w_pbtutor_basesheet を選択して［OK］をクリックします。

4 ［ファイル｜名前を付けて保存］を選択してから、ウィンドウの保存ダイアログボックスで、新規ウィンドウ名の［ウィンドウ］フィールドに「w_master_detail_ancestor」を入力します。

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

w_customers および w_products シートウィンドウに使用する新規先祖ベースシート



6 ［アプリケーションライブラリ］リストボックスで「pbtutor.pbl」が選択されていることを確認して、［OK］をクリックします。［ファイル｜閉じる］を選択して、新規先祖ベースシートを閉じます。

先祖ウィンドウをウィンドウペインタ内で開いていると、子孫ウィンドウを作成できません。

7 PowerBuilder メニューから［ファイル｜継承］を選択します。

8 ［ライブラリ］リストボックスで pbtutor.pbl が選択されており、［オブジェクトの種類］ドロップダウンリストボックスで「ウィンドウ」が選択されていることを確認します。「w_master_detail_ancestor」を選択して、［OK］をクリックします。

9 プロパティビューの［全般］ページの［タグ］テキストボックスに「Maintain Customers」と入力します。 PowerBuilder メニューから［ファイル｜名前を付けて保存］を選択し、［ウィンドウ］リストボックスで「w_customers」を選択します。

10 コメントのテキストを次のように変更します。

w_master_detail_ancestor から継承する Customer シートウィンドウ

11 ［OK］をクリックして、既存の w_customers ウィンドウを置き換えるかどうかを尋ねるウィンドウの保存ダイアログボックスが表示されたら［はい］をクリックします。

w_pbtutor_basesheet ではなく w_master_detail_ancestor を継承するシートウィンドウが新規に作成されます。

12 以下の 3 つの手順を変更して、手順 7 ～ 11 を繰り返します。

手順変更指示

9 プロパティビューの［全般］ページの［タグ］テキストボックスに「Maintain Products」と入力します。 PowerBuilderメニューから［ファイル｜名前を付けて保存］を選択し、［ウィンドウ］リストボックスで「w_products」を選択します。

10 コメントのテキストを次のように変更します。w_master_detail_ancestor から継承する Product シートウィンドウ



13 新規に作成した w_customers および w_products ウィンドウを閉じます。

いずれかの子孫がウィンドウペインタに表示されている場合、その先祖ウィンドウをオープンすることはできません。

14 PowerBuilder メニューから［実行｜ワークスペースのフル構築］を選択します。

ワークスペースの再構築は、継承階層を変更した後、新規先祖ウィンドウを修正する前に行う必要があります。構築の進行状況は、PowerBuilder メインウィンドウ下部のシステムツリーの下に表示される出力ウィンドウで見ることができます。構築が終了すると、出力ウィンドウに終了したことを示すメッセージが表示されます。

15 出力ウィンドウを閉じます。

マスタデータウィンドウ用のデータウィンドウコントロール（dw_master）の追加

このステップでは、データウィンドウコントロール（ユーザオブジェクト u_dwstandard として保存）を w_master_detail_ancestor ウィンドウに追加します。このコントロールは、先祖ウィンドウおよびその子孫ウィンドウのマスタデータウィンドウとして使用されます。

u_dwstandard のようなユーザオブジェクトの作成方法

データウィンドウコントロールを基にしたユーザオブジェクトを作成するには、［新規作成］ボタンをクリックし、新規作成ダイアログボックスの［PB オブジェクト］ページから［標準ビジュアル］を選択します。これで標準ビジュアルオブジェクトのデータ型の選択ダイアログボックスが表示されます。［データ型］テキストボックスで「datawindow」を選択し、必要に応じてユーザイベントを追加します。ユーザイベントを追加する方法については、このチュートリアルの後半で説明します。

11 既存の w_products ウィンドウの置き換えを要求するメッセージボックスが表示されます。

手順変更指示



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_」はデータウィンドウコントロールの標準的な接頭辞です。

詳細データウィンドウ用のデータウィンドウコントロール（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」を選択します。



スクリプトビューに、 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 番目のドロップダウンリストボックスで「（新規イベント）」を選択します。

スクリプトビューに、新しいイベントを定義するためのプロトタイプウィンドウが表示されます。



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 イベントに対して入力したスクリプトがコンパイルされます。スクリプトビューに、別の新しいユーザイベントのプロトタイプウィンドウが表示されます。



エラーメッセージが表示された場合

スクリプトで入力ミスがあった場合はコンパイルエラーになります。コンパイルエラーを無視するかどうかを尋ねるダイアログで［いいえ］を選択すると、スクリプトビューの一番下にコンパイルエラー領域が表示され、エラーが特定されます。この場合は、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 コントロールの現在の行が削除されることを指定しています。

イベント名スクリプト

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)



6 作業内容が保存されていることを確認します。

追加した新規イベントおよびスクリプトごとに手順 4 を繰り返し実行した場合は、作業内容はすでに保存されています。

データウィンドウコントロールのデータの検索を行うスクリプトの追加



現在の学習個所探索パスへのライブラリの追加先祖シートウィンドウの新規作成ユーザイベントおよびイベントスクリプトの追加

> データウィンドウコントロールのデータの検索を行うスクリプトの追加シートウィンドウのサイズに合わせた実行時の設定の調整

先ほど入力したスクリプトは、データウィンドウコントロール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ウィンドウおよびその子孫で以下の処理を行います。

• 初めてシートウィンドウを開いたときに、上のデータウィンドウコントロールにリスト（すべての顧客または商品のリスト）が表示されます。リストの初の項目の詳細情報は、下のデータウィンドウコントロールに表示されます。

• ユーザが上矢印または下矢印キーを使用して、または行をクリックして、上のデータウィンドウコントロールのリスト内を移動すると、下のデータウィンドウコントロールに現在の行の詳細が表示されます。



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」を選択します。

イベント名に注意

RowFocusChanging イベントではなく、 RowFocusChanged イベントを選択するよう注意してください。

ここでデータウィンドウコントロール dw_master の RowFocusChanged イベントのスクリプトを追加します。このスクリプトは検索要求と選択した行の ID 番号をデータウィンドウコントロール dw_detail に送ります。

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("検索 ","詳細データの検索に失敗しました。 ")END IF

これらの行は、検索要求を、データウィンドウが期待する引数（ll_itemnum 変数に格納されている ID 番号）とともにデータウィンドウ dw_detail に送ります。 Retrieve 関数を囲む IF 文は正常に処理されたかどうかをチェックします。検索に失敗した場合は、エラーメッセージボックスが表示されます。




スクリプトがコンパイルされて保存されます。

8 パワーバーの［ワークスペースのフル構築］ボタンをクリックします。

先祖オブジェクトを変更したら、すべてのオブジェクトを再構築するようにしてください。

9 出力ウィンドウを閉じます。

シートウィンドウのサイズに合わせた実行時の設定の調整


シートウィンドウのサイズに合わせた実行時の設定の調整

現在の学習個所探索パスへのライブラリの追加先祖シートウィンドウの新規作成ユーザイベントおよびイベントスクリプトの追加データウィンドウコントロールのデータの検索を行うスクリプトの追加

> シートウィンドウのサイズに合わせた実行時の設定の調整

テンプレートアプリケーションウィザードによって作成されるシートマネージャは、シートウィンドウを開く 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! )


次回チュートリアルアプリケーションを実行すると、デザイン時に設定したサイズでシートウィンドウが開きます。ただし、開いているほかのシートと重ねて表示される点は同じです。


レッスン 6 メニューの設定

このレッスンでは、チュートリアルアプリケーションで使用するメニューの設定を行います。このレッスンでは、以下の項目について学習します。

• フレームメニューの修正

• シートメニューの新規作成

• ユーザイベントを発生させるメニュースクリプトの追加

• 新規メニューのアタッチとアプリケーションの実行

メニューは独立したオブジェクトで、メニューペインタを使用して作成します。作成したメニューは複数のウィンドウで使用できます。アプリケーション開発プロセスのどの時点でもメニューを作成できます。

所要時間

約 30 分

フレームメニューの修正



現在の学習個所> フレームメニューの修正

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

現在のフレームメニューはテンプレートアプリケーションウィザードによって自動的に作成されたメニューです。 m_pbtutor_frame メニューは、このチュートリアルで作業するほかのすべてのメニューの先祖オブジェクトなので、このメニューを変更すると自動的に子孫メニューも変更されます。

メニューペインタのプレビュービューでは、アプリケーションを実行したときに表示されるとおりにメニューが表示されます。このチュートリアルでは、プレビュービューを使用してアプリケーションメニューに変更を加えますが、ツリーメニュービューで同様の変更を加えることもできます。ツールバーボタンを変更するときはプロパティビューを使用します。


• ファイルメニューの修正

• ヘルプメニュー項目の有効化

ファイルメニューの修正

このステップでは、m_pbtutor_frame メニューのファイルカスケードメニューを変更します。

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

メニューペインタに、アプリケーションの MDI フレームウィンドウに関連付けられているメニューが表示されます。m_pbtutor_sheet は m_pbtutor_frame を継承しているので、フレームメニューに変更を加えると、シートメニューも変更されます。

プレビュービューでは、メニュー項目はビューの上部に表示されます。プレビュービューが開いていない場合は、メニューペインタのメニューバーの［ビュー］メニューから選択できます。



2 m_pbtutor_frame のプレビュービューで「ファイル」メニューをクリックします。

プレビュービューでメニュー項目をクリックすると、そのメニュー項目が実行時と同じように表示されます。

ファイルメニューのメニュー項目が表示されない場合

プレビュービューを表示するときは「ファイル」メニューが選択されています。そのほかのメニュー（編集、ウィンドウ、またはヘルプ）の 1 つをクリックしてから再び「ファイル」メニューをクリックすると、メニュー項目が表示されることがあります。

3 「ファイル」メニューの「新規作成」を右クリックします。ポップアップメニューの［メニュー項目テキストの編集］を選択します。［新規作成］フィールドをクリックし、「新規作成 (&N)」を「レポー

ト (&R)」で置換します。〔Enter〕を押します。

「新規作成」メニュー項目の表示名を「レポート」に変更します。メニュー名は m_new のまま変更されず、その目的（新しいシートを開きます）も変更されません。

アンパサンド文字を使用したアクセラレータキーの定義

アンパサンド（&）の次の文字がアクセラレータキー（ニーモニック）として使用され、プレビュー表示では下線付きで表示されます。アプリケーションの実行時には、〔Alt〕 + 〔F〕 + 〔R〕を押すと、［ファイル｜レポート］メニューにアクセスできます。

4 プロパティビューの［テキスト］テキストボックスに「レポート(&R)」と表示されていることを確認します。プロパティビューの［ツールバー］タブをクリックします。

ツールバー項目のテキストは、「新規作成 , 新規シート」です。［ピクチャ名］ボックスでは何も選択されていないので、実行時にレポートメニュー項目に対するツールバーボタンは表示されません。レポートメニュー項目は、新しいシートを開くコマンドとしてではなく、カスケードメニュー項目にアクセスするために使用するので、ここにツールバーボタンは追加しません。

5 プレビュービューで「ファイル」メニューの「開く」メニュー項目をクリックします。



プロパティビューで［全般］タブをクリックします。プロパティビューの［全般］ページで、［表示可能］および［使用可能］チェックボックスのチェックをはずします。

すべての実行時メニューで開くメニュー項目を非表示にします。［表示可能］プロパティのチェックをはずすと、プレビュービューで、このメニュー項目が淡色表示されます。実行時には表示されません。［使用可能］チェックボックスのチェックをはずすと、プレビュービューで、このメニュー項目が淡色で反転浮彫り表示されます。このメニュー項目は実行時に表示される場合でも、グレー表示のままです。

6 プロパティビューの［ツールバー］タブをクリックします。［表示可能］チェックボックスのチェックをはずします。

これで、このメニュー項目のツールバーボタンがフレームメニューのツールバーに表示されなくなります（対応するメニュー項目が表示または有効化されない場合でも、ボタンをツールバーに表示できます）。

7 プレビュービューで、「ファイル」メニューの「終了」をクリックします。

プロパティビューの［ツールバー］ページが開いたままになっていれば、［項目テキスト］および［ピクチャ名］の値が m_exit メニュー項目の値に変わります。



ヘルプメニュー項目の有効化

「ヘルプ」メニューには 3 つの項目がありますが、有効になっている項目は「バージョン情報」の 1 つだけです。このステップでは、テンプレートアプリケーションウィザードおよび Tutorial ディレクトリ内のpbtutor.hlp ファイルが提供したコメント化コードを使用して、そのほかのメニュー項目を有効にします。

ShowHelp 関数を使用してアプリケーションのヘルプトピックを呼び出し、ヘルプの目次またはインデックスを表示するか、特定のトピックまたはキーワードを表示するかを識別するカタログ値を渡します。ShowHelp は、 Windows のヘルプまたはコンパイルされた HTML ヘルプ（CHM）ファイルを開くことができます。

1 プレビュービューで「ヘルプ」メニューをクリックして、「目次」メニュー項目をダブルクリックします。

目次メニュー項目は使用可能になっていなくてもダブルクリックできます。スクリプトビューに目次メニュー項目が完全な名前（m_help.m_helpindex）で表示されます。完全な名前には、ヘルプメニューであることを示す 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 のメインメニューバーの［ファイル｜閉じる］を選択します。



シートメニューの新規作成

現在の学習個所フレームメニューの修正

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

このステップでは、ユーザが顧客または商品情報を見るために 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 および子孫オブジェクトの新しいシートメニュー


これでメニューに名前が付けられます。m_ はメニューの標準的な接頭辞です。

新規メニューに付けた名前がメニューペインタのワークスペースのタイトルバーに表示され、 m_my_sheet メニューがシステムツリーに表示されます。



新規メニューへのメニュー項目の追加

ここでは、 m_pbtutor_sheet から継承したメニューの編集メニューに項目を追加します。プレビューおよびプロパティビューを使用します。

1 新規メニューのプレビュービューで「編集」メニューをクリックします。

アプリケーション実行時と同じように編集メニューのメニュー項目のリストが表示されます。編集メニューのメニュー項目はすべて表示されますが、無効です（プレビュービューではグレーですが淡色表示にはなっていません）。

2 プレビュービューで「編集」メニューのメニュー項目を右クリックします。ポップアップメニューの［メニュー項目の後に挿入］を選択します。

「編集」メニューのリストの後に表示される空のボックスにカーソルが移動します。

3 メニューの下にあるボックスをクリックしてハイフン（-）を入力します。〔Enter〕を押します。

ハイフンが区分線に変わります。プロパティビューでは、メニュー項目の名前が m_0 に変わります。メニュー項目間の区分線も、名前は一意でなければなりません。メニュー内のほかの区分線には、接頭辞 m_- の後に一意のインデックス番号が付けられます。

4 プロパティビューで新しい区分線の［使用可能］チェックボックスのチェックをはずします。

5 プレビュービューで新しい区分線を右クリックします。ポップアップメニューの［メニュー項目の後に挿入］を選択します。新しい区分線の下に表示されるボックスに「挿入 (&I)」と入力し、〔Enter〕を押します。

メニュー項目名の［名前］が自動的に m_ 挿入 i に設定されます。デフォルトの名前が正しくないというメッセージが表示された場合は、かわりの名前が示されます。その場合、示された名前を使用するには［OK］をクリックします。



メニュー項目名を挿入する別の方法

プレビュービューではなく、プロパティビューの［テキスト］ボックスに「挿入 (&I)」と入力します。この場合、後で〔Enter〕を押す必要はありません。ただし、［名前］ボックスがグレー表示になっている場合は、まず［項目名固定］チェックボックスをオフにする必要があります。そうしないとメニュー名は m_ 挿入 i にリセットされません。

6 プロパティビューの［マイクロヘルプ］ボックスに「行の挿入」と入力します。

デフォルトでは、新規メニュー項目は表示され、有効になります。

ユーザがこのメニュー項目を選択すると、アプリケーションウィンドウの一番下の［マイクロヘルプ］行に「行の挿入」というテキストが表示されます。

7 以下のメニュー項目について、手順 5 と 6 を繰り返します。

メニュー項目マイクロヘルプテキスト

更新 (&A) データベースを更新

削除 (&D) 現在の行を削除



編集メニューに、データベースのレコードの更新および削除のためのメニュー項目を追加します。有効化されてはいませんが、文字 U はすでにメニュー項目「元に戻す」のアクセラレータキーとして使用されているので、メニュー項目「更新」に同じアクセラレータキーを使用しないでください。かわりに文字 A を使用します。

新規メニュー項目のツールバーの追加

ここでは、さきほど定義したメニュー項目に対するツールバーボタンを追加し 2 番目のツールバーに配置します。

1 プレビュービューの「編集」メニューの新しい「挿入」メニュー項目をクリックします。

2 プロパティビューの［ツールバー］タブをクリックします。［項目テキスト］ボックスに「挿入」と入力します。［ピクチャ名］ドロップダウンリストで「Insert!」と入力または選択します。



これで Insert! という組み込みピクチャを使用する挿入メニュー項目のツールバーボタンが定義されます。実行時のアプリケーションでツールバーに対して［テキストの表示］オプションが有効になっていると、「挿入」というテキストがボタンの上に表示されます。

3 ［項目の間隔］スピンコントロールに「1」と入力するか、「1」をクリックします。［項目の順序］スピンコントロールに「1」と入力するか、「1」をクリックします。［項目インデックス］スピンコントロールに「2」と入力するか、「2」をクリックします。

追加されたメニュー項目用の新しいツールバーを作成すると、［挿入］ボタンがこのツールバーの初の項目になります。

4 プレビュービューの「編集」メニューの「更新」メニュー項目をクリックします。プロパティビューのタイトルバーに表示されていることを確認します。

5 まだ［ツールバー］ページを開いていない場合は［ツールバー］タブをクリックします。［項目テキスト］ボックスに「更新」と入力します。［ピクチャ名］ドロップダウンリストボックスで「Update!」を入力または選択します。

これで、 Update! という組み込みピクチャを使用する更新メニュー項目のツールバーボタンが定義されます。ボタンのテキストは「更新」です。

6 ［項目の順序］スピンコントロールに「2」と入力するか、「2」をクリックします。［項目インデックス］スピンコントロールに「2」と入力するか、「2」をクリックします。

新規ツールバーの［挿入］ボタンの後に［更新］ボタンが追加されます。



7 プレビュービューで「編集」メニューの新しい「削除」メニュー項目をクリックします。プロパティビューのタイトルバーにも表示されていることを確認します。

8 まだ［ツールバー］ページを開いていない場合は［ツールバー］タブをクリックします。［項目テキスト］ボックスで「削除」と入力します。［ピクチャ名］ドロップダウンリストボックスで「DeleteRow!」を入力または選択します。

これで、DeleteRow! という組み込みピクチャを使用する［削除］メニュー項目のツールバーボタンが定義されます。ボタンのテキストは「削除」です。

9 ［項目の順序］スピンコントロールに「3」と入力するか、「3」をクリックします。［項目インデックス］スピンコントロールに「2」と入力するか、「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 が発生します。



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 フレームが開きます。［ファイル］メニューには、［新規作成］メニュー項目のかわりに［レポート］カスケードメニューが表示されます。［開く］メニュー項目は表示されなくなっています。

6 メニューバーの［ファイル｜レポート｜顧客情報］を選択します。

2 番目のツールバーが表示され、編集およびウィンドウカスケードメニューに使用可能なメニュー項目が表示されていることに注意してください。

7 ［編集］メニューを選択します。

［編集］メニューには、追加した挿入、更新、削除オプションがあります。顧客情報ウィンドウのデータウィンドウコントロールにはデータウィンドウオブジェクトが関連付けられていないので、これらのオプションはまだ機能しません。

8 ［ウィンドウ］メニューを選択します。

開いたシートに対応する新しいメニュー項目が追加されています。

9 メニューバーの［ファイル｜レポート｜商品管理］を選択します。

2 番目の MDI シートが開きます。このシートは 1 番目のシートに重なるようにして表示されます。メニューバーは変更されません。これは m_my_sheet が w_customers と w_products の両方のメニューであるためです。

10 ［編集］メニューを選択します。

w_products ウィンドウは m_my_sheet メニューを使用するので、商品管理ウィンドウが開いているときに挿入、更新、削除オプションも利用できます。

11 ［ウィンドウ］メニューを選択します。

開いた 2 番目のシートに対応するメニュー項目が追加されています。このメニュー項目の隣にチェックマークが表示され、アクティブなシートであることが示されます。



12 メニューバーの［ファイル｜終了］を選択します。

アプリケーションが終了し、ウィンドウペインタのワークスペースに戻ります。

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


レッスン 7 データウィンドウオブジェクトの作成

データウィンドウオブジェクトは、 PowerBuilder のもっとも強力で有用な機能の 1 つです。データウィンドウオブジェクトは、データベースと接続してデータを読み込み、さまざまな提示様式でデータを表示します。また、データベースを更新することもできます。


• データウィンドウオブジェクトの新規作成とプレビュー

• データウィンドウオブジェクトの保存

• 1 つめのデータウィンドウオブジェクトの表示の変更

• 2 つめのデータウィンドウオブジェクトの作成

• 2 つめのデータウィンドウオブジェクトの表示の変更

所要時間

約 20 分

データウィンドウオブジェクトの新規作成とプレビュー



現在の学習個所> データウィンドウオブジェクトの新規作成とプレビュー

データウィンドウオブジェクトの保存1 つめのデータウィンドウオブジェクトの表示の変更2 つめのデータウィンドウオブジェクトの作成2 つめのデータウィンドウオブジェクトの表示の変更

このステップでは、データウィンドウオブジェクトを新規作成して、データウィンドウペインタに表示します。ほかのペインタと同様に、データウィンドウペインタには、同時に開くことができるさまざまなビューがあります。

データウィンドウペインタのデザインビューについて

データウィンドウペインタのデザインビューは、ほかのペインタのレイアウトビューと似ています。一度に表示できるデザインビューは 1つだけです。

デザインビューは、ヘッダ、詳細、サマリー、およびフッタの 4 つの「区域」と呼ばれる領域に分かれています。これらの区域の内容は変更することができます。たとえば、サイズの変更や、オブジェクト（コントロール、テキスト、線、ボックス、楕円）の追加、色やフォントの変更を行うことができます。

データウィンドウペインタのプレビュービューでは、実行時におけるアプリケーションでのオブジェクトの表示をテーブルデータが挿入された状態で見ることができます。



2 ［データウィンドウ］タブをクリックします。



3 提示様式のリストで「タブラ」を選択します。


データウィンドウウィザードの［タブラデータウィンドウのためのデータソースの選択］ページが表示されます。



5 データソースとして［Quick Select］を選択し、［プレビューの度に検索］チェックボックスがオフの場合はオンにします。［次へ］をクリックします。

EAS Demo DB データベースに接続し、Quick Select ダイアログボックスが表示されます。

6 ［テーブル］リストボックスで「customer」（顧客情報テーブル）をクリックします。

テーブルが開き、カラムが一覧表示されます。このデータウィンドウでは 4 つのカラムを選択します。

7 ［カラム］リストボックスで「id」、「lname」、「fname」を、並んでいる順にクリックします。リストをスクロールして「company_name」をクリックします。

Quick Select ダイアログボックスの下のグリッドに、選択したカラムが表示されます。



選択する順序で表示される順序が決まります

各カラムは、選択した順に、データウィンドウオブジェクト内で左から右へ表示されます。誤ってカラムをクリックした場合は、もう一度クリックすると選択を取り消すことができます。

ダイアログボックスの下のグリッド領域を使用して、ソート条件（SQL ORDER BY 句の場合）や選択条件（SQL WHERE 句の場合）を指定できます。ここではソート条件だけを指定します。 id カラムを昇順にソートします。

8 Quick Select ダイアログボックスのグリッド領域で、［ソート］の横、「Id」の下のセルをクリックします。

ドロップダウンリストボックスが表示されます。

9 2 番目のドロップダウンリストボックスで「昇順」を選択します。

これで id カラムを昇順でソートするように指定されます。




データウィンドウウィザードから、データウィンドウオブジェクトの色と枠線を選択するように求められます。デフォルトでは、テキストまたはカラムの枠線はありません。


境界と色のデフォルト設定値を使用します。データウィンドウウィザードにより、選択した値が集約されます。


新規データウィンドウオブジェクトが作成され、データウィンドウペインタが開きます。

デザインビューに、デフォルトのヘッダが付いたヘッダ区域と、選択したカラムのある詳細区域がそれぞれ表示されます。

プレビュービューでは、実行時に表示されるものと同じデータウィンドウが表示されます。すべての顧客のデータが表示されます。データは、指定したとおり、顧客 ID で昇順にソートされます。



プレビュービューの表示

プレビュービューが表示されていない場合は、メニューバーから［ビュー｜プレビュー］を選択します。［プレビュー］がグレー表示の場合は、すでに表示されているので選択できません。一度に表示できるプレビュービューは 1 つだけです。

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



現在の学習個所データウィンドウオブジェクトの新規作成とプレビュー

> データウィンドウオブジェクトの保存1 つめのデータウィンドウオブジェクトの表示の変更2 つめのデータウィンドウオブジェクトの作成2 つめのデータウィンドウオブジェクトの表示の変更

このステップでは、データウィンドウオブジェクトに名前を付けて、pbtutor.pbl ライブラリに保存します。

別のライブラリへの保存

オブジェクトは別のアプリケーションライブラリに保存することができますが、複雑にならないようにするために、新しいチュートリアルオブジェクトはすべて同一のライブラリに保存します。また、ライブラリペインタを使用すると、ライブラリ間でオブジェクトをコピーしたり、移動したりすることもできます。


データウィンドウの保存ダイアログボックスが表示され、［データウィンドウ］ボックスに挿入ポイントが示されます。

2 ［アプリケーションライブラリ］ボックスで「pbtutor.pbl」が選択されていることを確認します。［データウィンドウ］ボックスに「d_custlist」と入力します。

これで、データウィンドウオブジェクトに名前が付けられます。「d_」はデータウィンドウオブジェクトの標準の接頭辞です。


このデータウィンドウオブジェクトは顧客名とその会社名を検索します。


データウィンドウオブジェクトが保存され、データウィンドウの保存ダイアログボックスが閉じます。



1 つめのデータウィンドウオブジェクトの表示の変更

現在の学習個所データウィンドウオブジェクトの新規作成とプレビューデータウィンドウオブジェクトの保存

> 1 つめのデータウィンドウオブジェクトの表示の変更2 つめのデータウィンドウオブジェクトの作成2 つめのデータウィンドウオブジェクトの表示の変更

ここでは、データウィンドウの表示を変更します。カラムとカラム見出しを移動して、現在選択されている行の左にハンドポインタを表示するスペースを作ります。また、一部のカラムを移動して見出しと揃うようにします。

これらの変更作業はデザインビューで行います。同時にプレビュービューを開いておけば、変更した結果、実行時にデータウィンドウがどのように表示されるかを確認できます。

1 メニューバーの［編集｜選択｜すべて選択］を選択します。または〔Ctrl〕 + 〔A〕を押します。

データウィンドウオブジェクト内のすべてのコントロールがデザインビューで選択されます。

2 選択したオブジェクトの 1 つにマウスポインタを移動します。右に 4 cm ほど、オブジェクトをドラッグします。

選択されているすべてのオブジェクトがいっしょに移動します。

3 デザインビューで、空白の領域をクリックします。

オブジェクトの選択が解除されます。

4 ヘッダ区域の上の顧客 ID の見出しをクリックします。〔Ctrl〕を押したまま、詳細区域の上の id カラムをクリックします。〔Ctrl〕を放し、 id カラムを左に 2.5 cm ほどドラッグします。

カラムとその見出しがいっしょに移動します。

5 スタイルバーの［中央揃え］ボタンをクリックします。デザインビューで、空白の領域をクリックします。



顧客 ID カラムの見出しテキストとカラムデータが中央に配置されます。

6 姓の見出しをクリックします。〔Ctrl〕を押したまま名および会社名の見出しをクリックします。スタイルバーの［左揃え］ボタンをクリックします。

操作を完了すると、デザインビューは次の図のようになるはずです。

7 メニューバーから［ファイル｜閉じる］を選択します。

変更内容を保存するかどうかを確認するメッセージボックスが表示されます。


データウィンドウオブジェクトが保存され、データウィンドウペインタが閉じます。



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 テーブルレイアウトビューで、ヘッダ領域を右クリックします。ポップアップメニューで［すべて選択］をクリックします。

ラベルの上の選択リスト領域にカラム名が表示されます。

カラムは、選択した順序で表示されます。ここでは一度にすべてのカラムを選択したため、データベース内でのカラムの元の順序が使用されます。カラムの表示順序は後で変更します。



Syntax ビューでは、選択順序も確認できます。生成された Select 文を表示するには、タブウィンドウの一番下にある［Syntax］タブをクリックします。

検索引数の定義

ここでは、検索引数を定義します。

1 メニューバーの［デザイン｜検索引数］を選択します。

検索引数の指定ダイアログボックスが表示されます。



2 ［名前］ボックスに「cust_id」と入力します。

デフォルトのデータ型は「Number」で、これを使用します。

検索引数名について

使用する検索引数にはどのような名前を付けてもかまいません。これは、実行時に渡す値のプレースホルダにすぎません。ただし、意味のある名前を使用するようにしたほうがよいでしょう。


検索引数が定義されます。

WHERE 句の指定

ここでは、特定の顧客を検索するために検索引数を使用して WHERE句を指定します。

1 ［Where］タブをクリックします。

Where ビューが表示されます。

2 Where ビューで、［カラム名］の下のボックスをクリックします。

下矢印が表示され、ボックスがドロップダウンリストボックスになります。



3 「"customer"."id"」を選択します。

カラム見出しのすぐ下に「"customer"."id"」が表示されます。［演算子］ボックスに等号（=）が表示されます。この演算子は正しいので、変更の必要はありません。

4 Where ビューで、［値］のカラムヘッダの下のボックスを右クリックします。ポップアップメニューから［引数］を選択し、「:cust_id」を選択して、［貼り付け］をクリックします。

5 ［Syntax］タブをクリックします。

Syntax ビューに、修正した SELECT 文が表示されます。

6 スクロールして、生成された WHERE 句を表示します。

これで、完全な SQL SELECT 文が作成されました。この文は、実行時に指定される引数に等しい id カラムがある顧客情報テーブルの複数のカラムからデータを検索します。



データウィンドウペインタでのデータウィンドウの表示

ここでは、デザインビューとプレビュービューを使用してデータウィンドウペインタでデータウィンドウを表示します。

1 ペインタバーの［ペインタに戻る］ボタンをクリックします。またはメニューバーの［ファイル｜データウィンドウペインタに戻ります］を選択します。

データウィンドウウィザードにより、新規データウィンドウオブジェクトの枠線と色を選択するように求められます。

2 カラムの［枠線］ドロップダウンリストボックスで「3D 凸表示」を選択します。［次へ］をクリックします。

データウィンドウカラムには盛り上がった枠線がつきますが、ラベルにはつきません。データウィンドウウィザードにより、選択した値が集約されます。


［プレビューの度に検索］チェックボックスをオンにしており、データウィンドウペインタのデフォルトのレイアウトにプレビューが含まれているため、検索引数の指定ダイアログボックスが表示されます。

このダイアログボックスでは、引数値の入力が求められます。このデータウィンドウオブジェクトをチュートリアルアプリケーションに入れると、必要な引数をデータウィンドウオブジェクトに渡すスクリプトが自動的に記述されます。



4 ［値］フィールドに顧客 ID （101、 102、 103 など）を入力します。［OK］をクリックします。

データウィンドウペインタが開きます。デザインビューに新しいデータウィンドウオブジェクトが表示されます。

フォントサイズの変更

ラベルの文字がすべて見えない場合は、〔Ctrl〕 + 〔A〕を押してデータウィンドウ内のすべての項目を選択してから、スタイルバーで小さいフォントサイズを選択します。



要求された顧客データがデータウィンドウプレビュービューで検索されます。

ほかのレコードの検索

ほかの顧客のレコードをプレビューする場合は、データウィンドウプレビュービューを右クリックして、ポップアップメニューの［データ検索］を選択し、検索引数の指定ダイアログボックスで別の顧客 ID を指定します。


ここではデータウィンドウオブジェクトに名前を付けて保存します。ペインタを終了するまで保存しないでおくこともできますが、頻繁に作業内容を保存するようにするのが適切です。


データウィンドウの保存ダイアログボックスが表示されます。

2 ［アプリケーションライブラリ］ボックスで「pbtutor.pbl」が選択されていることを確認します。［データウィンドウ］ボックスに「d_customer」と入力します。

以前は、データウィンドウオブジェクトを d_custlist という名前で保存しました。




このデータウィンドウは、顧客情報テーブルのすべてのカラムを検索します。詳細データウィンドウとして使うと便利です。


データウィンドウペインタに戻ります。




現在の学習個所データウィンドウオブジェクトの新規作成とプレビューデータウィンドウオブジェクトの保存1 つめのデータウィンドウオブジェクトの表示の変更2 つめのデータウィンドウオブジェクトの作成

> 2 つめのデータウィンドウオブジェクトの表示の変更

ここでは、データウィンドウオブジェクトを修正します。このレッスンでは、以下の項目について学習します。

• カラムとラベルの再配置

• ラベルとカラムの整列

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

フリーフォームデータウィンドウのカラム

フリーフォームデータウィンドウオブジェクトのデータフィールドは、テーブル形式ではありませんが、カラムと呼ばれます。

カラムとラベルの再配置

ここでは、新しいデータウィンドウオブジェクトのカラムとラベルを再配置します。デザインビューを大化すると、カラムとラベルを非常に操作しやすくなります。

1 デザインビューで「郵便番号」ラベルをクリックします。〔Ctrl〕を押したまま、 zip カラムをクリックします。

2 つの項目が選択されます。

2 〔Ctrl〕を押したまま、以下のカラムラベルとカラムコントロールをクリックします。

ラベルカラム

郵便番号 : zip

都道府県 : state市区 : city



必要であれば、スクロールしてデータウィンドウ内にすべてのカラムが表示されるようにします。

3 〔Ctrl〕を放します。選択されているオブジェクトの 1 つにカーソルを置き、データウィンドウオブジェクトの右上隅にドラッグします。

すべてのオブジェクトがいっしょに移動します。

4 この〔Ctrl〕を押したままクリックする方法を使用して、以下のラベルおよびカラムコントロールを示された位置に移動します。

5 詳細区域を後のカラムラベルの下へドラッグします。

これにより、詳細区域の下に余分なスペースがあれば削除されます。

フィールドどうしが正しく整列していない場合があります。その場合の修正は、次の練習で行います。

ラベルとカラムの整列

ここでは、新しいデータウィンドウでラベルとカラムを整列します。

1 デザインビューで「町村番地」ラベルを選択します。「町村番地」ラベルの左端を、 lname_yomi カラムの右端の近くに移動します。

2 「町村番地」ラベルが選択されている状態で、〔Ctrl〕 + クリックを使用して「郵便番号」、「都道府県」、および「市区」ラベルを選択します。

3 メニューバーの［書式｜配置］を選択します。

町村番地 : address

ラベルカラムコントロール移動先

「会社名」 company_name 「Fname Yomi:」の下

「電話番号」 phone 「会社名」の下

ラベルカラム



整列オプションのカスケードメニューが表示されます。

4 1 つ目のオプション（［左揃え］）を選択します。

選択したオブジェクトの左端が、選択した 1 つめの項目（「町村番地」ラベル）の左端に揃えられます。

ペインタバーからの整列ツールの選択

ペインタバー 2 の［配置］ボタンをクリックすると、整列ツールのドロップダウンリストにアクセスできます。

5 address のカラムを「町村番地」ラベルのすぐ横に移動します。カラムラベルのときと同じようにして、 zip、 state、 city カラムをaddress カラムに揃えます。

デザインビューでは、データウィンドウが次のように表示されるはずです。

データウィンドウプレビュービューは、次のようになります。



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

顧客の State カラムにはデータウィンドウ編集スタイルがあります。これは EAS Demo DB データベースの State カラムに関連付けられている拡張属性です。 State カラムが関連付けられている（ドロップダウン）データウィンドウには、 State と 2 文字のコードのリストがあります。

State の選択リストがアプリケーションで常に表示されるようにしたり、選択リストが利用可能であることを示す矢印を常に表示されるようにしたりすることができます。ここでは、 State カラムのプロパティを変更して、矢印が常に表示されるようにします。

1 デザインビューで State カラムをクリックします。プロパティビューが表示されることを確認します。

このプロパティビューにはカラムのプロパティが表示されます。

2 プロパティビューで［編集］タブをクリックします。

［編集］タブが見えない場合は、プロパティビューの一番上近くにある矢印キーをクリックしてください。［様式の種類］で「ドロップダウンデータウィンドウ」が選択されていることを確認します。

3 ［矢印を常時表示］チェックボックスをオンにします。デザインビューの State カラムが、矢印と 2 文字を表示できる幅であることを確認します。

デザインビューおよびプレビュービューで、State カラムの横に矢印が表示されます。カラムがデザインビューで選択されている間にカラムの幅を広げることができます。それには、カラムの右端にカーソルを置き、カーソルが双方向の矢印に変わったら、カラムの端をビューの一番右のフレームの方向にドラッグします。





レッスン 8 データウィンドウオブジェクトのアタッチ

データウィンドウオブジェクトを作成して保存すると、データウィンドウオブジェクトをウィンドウで使用できるようになります。すでに d_custlist および d_customer というデータウィンドウオブジェクトを作成しました。ここでは、これらのデータウィンドウオブジェクトを、 w_customers ウィンドウ内のデータウィンドウコントロールに関連付けます。


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

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


• 商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチ

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

所要時間

約 15 分

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



現在の学習個所> マスタデータウィンドウコントロールへのデータウィンドウオブジェク

トのアタッチ詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチアプリケーションの実行商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチアプリケーションの再実行

このステップでは、データウィンドウオブジェクトを w_customersウィンドウ上のデータウィンドウコントロールにアタッチします。

1 システムツリーで pbtutor.pbl ツリー項目を展開します。

2 w_customers を右クリックして、ポップアップメニューから［編集］を選択します。またはシステムツリーで w_customers をダブルクリックします。

ウィンドウペインタに w_customers ウィンドウが表示されます。



3 レイアウトビューで、上部にあるデータウィンドウコントロール（dw_master）を右クリックします。プロパティビューが表示されない場合は、ポップアップメニューの［プロパティ］を選択します。プロパティビューで［データオブジェクト］ボックスの隣の参照（［...］）ボタンをクリックします。


4 ［データウィンドウ］リストボックスで「d_custlist」を選択して［OK］をクリックします。

d_custlist データウィンドウオブジェクトと dw_master データウィンドウコントロールが関連付けられます。

レイアウトビューで、 dw_master コントロール内に d_custlist データウィンドウの見出しが表示されていますが、データはまだ表示されていません。アプリケーションを実行するまでは、データウィンドウは SELECT 文を実行しません。



ドラッグアンドドロップを使用してのウィンドウへのデータウィンドウオブジェクトの追加

このチュートリアルでは、エラー処理が組み込まれたカスタムデータウィンドウコントロールを使用します。標準的なデータウィンドウコントロールを使用したい場合は、このレッスンで行ったようにウィンドウにコントロールを追加してからデータウィンドウオブジェクトをアタッチする必要はありません。システムツリーでデータウィンドウオブジェクトを選択し、レイアウトビュー内のウィンドウ上にドラッグするだけで済みます。すると、データウィンドウコントロールが自動的に作成されます。



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

現在の学習個所マスタデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ

> 詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチアプリケーションの実行商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチアプリケーションの再実行

このステップでは、詳細データウィンドウコントロールへデータウィンドウオブジェクトをアタッチします。ウィンドウペインタでは、まだ w_customers ウィンドウが開いているはずです。

1 レイアウトビューで、下部にあるデータウィンドウコントロール（dw_detail）を選択します。プロパティビューで［データオブジェクト］ボックスの隣の参照（［...］）ボタンをクリックします。オブジェクト選択ダイアログボックスで「d_customer」を選択して［OK］をクリックします。

d_customer データウィンドウオブジェクトと dw_detail データウィンドウコントロールが関連付けられます。ウィンドウペインタのワークスペースでは、 dw_detail コントロール内に d_customer データウィンドウオブジェクトが表示されます。

2 レイアウトビューで、データウィンドウオブジェクトに追加したすべてのカラムを表示できるように dw_detail コントロールを拡大します。

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


必要であれば、ウィンドウも拡大します。 dw_detail コントロールを拡大する場合、 dw_master コントロールも同じ幅にします。




現在の学習個所マスタデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ

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

このステップでは、アプリケーションをもう一度実行して、 2 つめのデータウィンドウの挿入、更新、および削除機能をテストします。




アプリケーションが実行され、ログインウィンドウが表示されます。


データベースとの接続が確立され、アプリケーションの MDI フレームが開きます。



4 メニューバーから［ファイル｜レポート｜顧客情報］を選択します。

顧客情報ウィンドウが表示されます。

上部のデータウィンドウコントロール（dw_master）には Customerテーブルから検索されたすべての行が表示され、ハンドポインタはどの行が選択されているかを示します。

下部のデータウィンドウコントロール（dw_detail）には、選択した顧客についての詳細情報が表示されています。

5 実行中のアプリケーションで、ツールバーの［挿入］ボタンをクリックします。またはフレームウィンドウのメニューバーの［編集｜挿入］を選択します。

これで dw_detail データウィンドウがクリア（リセット）され、データソースに挿入する新しい行の情報を追加できるようになります。カーソルが dw_detail コントロールの顧客 ID ボックスに置かれます。

6 詳細データウィンドウのボックスに情報を入力して、新しい顧客行を追加します。



新しい顧客の情報の入力

顧客 ID の番号は一意でなければなりません。値が重複しないようにするために、新しいデータベースエントリに 4 桁の値を使用するか、マスタデータウィンドウの 3 桁の顧客番号のリストをスクロールしてリストに表示されていない ID 番号を選択します。

残りのフィールドに値を入力します。

電話番号と郵便番号では、入力する情報を表示するのにエディットマスクを使用します。これらのデータフィールドには数値だけを入力する必要があります。顧客の都道府県を指定するには、都道府県のカラムの隣の矢印をクリックしてドロップダウンリストボックスからエントリを選択する必要があります。

7 ツールバーの［更新］ボタンをクリックします。またはメニューバーの［編集｜更新］を選択します。

これで ue_update イベントのスクリプトでコーディングされたとおりに、新しい顧客のデータがデータベースに送られ、確認メッセージが表示されます。

新しい顧客は、まだマスタデータウィンドウに表示されません（この機能が含まれるようにコードを追加することもできます）。ただし、 w_customers シートのほかのインスタンスを開くと、新しい顧客のデータは、マスタおよび詳細データウィンドウコントロールの両方で表示されます。

8 メッセージボックスで［OK］をクリックします。マスタデータウィンドウで顧客をクリックします。

その顧客のデータが下のデータウィンドウに表示されます。

9 詳細データウィンドウで顧客の住所を変更します。

10 ツールバーの［更新］ボタンをクリックします。またはメニューバーの［編集｜更新］を選択します。

これで、変更した顧客データがデータベースに送られ、別の確認メッセージが表示されます。



11 メッセージボックスで［OK］をクリックします。マスタデータウィンドウでほかの顧客を選択します。

詳細データウィンドウにその顧客のデータが表示されます。

12 ツールバーの［削除］ボタンをクリックします。またはメニューバーの［編集｜削除］を選択します。

データウィンドウからはその顧客がただちに削除されますが、［編集］メニューの［更新］オプションを選択しない限り、データベースからは削除されません。その場合、 EAS Demo DB データベースのほかのテーブルの行が削除しようとしている行を参照していると、更新処理が失敗することがあります。

自分でデータベースに追加した行はすべて削除できます。

13 メニューバーの［ファイル｜終了］を選択します。

アプリケーションが終了し、ウィンドウペインタに戻ります。




商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチ

現在の学習個所マスタデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチアプリケーションの実行

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

このステップでは、 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 コントロールを拡大します。また、ウィンドウを拡大することもできます。

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



現在の学習個所マスタデータウィンドウコントロールへのデータウィンドウオブジェクトのアタッチ詳細データウィンドウコントロールへのデータウィンドウオブジェクトのアタッチアプリケーションの実行商品管理ウィンドウへのデータウィンドウオブジェクトのアタッチ

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

このステップでは、もう一度アプリケーションを実行して、商品管理ウィンドウをテストします。

この時点で、商品管理ウィンドウには顧客情報ウィンドウのすべての機能が備わっています。顧客情報ウィンドウと同様に、商品管理ウィンドウは、データベースに対する検索、挿入、更新、および削除操作のサポートを提供するマスタ / 詳細ウィンドウとして機能します。




アプリケーションが実行され、ログインウィンドウが表示されます。



4 メニューバーから［ファイル｜レポート｜商品管理］を選択します。

商品管理ウィンドウが表示されます。上部のデータウィンドウコントロールには Product テーブルから検索されたすべての行が表示されています。



下部のデータウィンドウコントロールには、上部のデータウィンドウコントロールで選択された商品についての情報が表示されています。

5 メニューバーの［編集｜挿入］を選択します。

これで dw_detail データウィンドウがクリアされ、新しい行がデータウィンドウに追加できるようになります。カーソルが dw_detailコントロールの［商品 ID］ボックスに置かれます。

6 下部のデータウィンドウのボックスに情報を入力して、新しい製品行を追加します。

ボックス間の移動には〔Tab〕を使用します。

7 メニューバーの［編集｜更新］を選択します。

これで ue_update イベントのスクリプトでコーディングされたとおりに、新しい商品のデータがデータベースに送られ、確認メッセージが表示されます。



新しい商品はまだ上部のデータウィンドウに表示されませんが、別の商品シートを開くと、新しい情報が表示されます。必要であれば、更新ボタンの Clicked イベントにコードを追加して、マスタデータウィンドウコントロールでデータが自動的に更新されるようにできます。

8 メッセージボックスで［OK］をクリックします。マスタデータウィンドウで製品をクリックします。

その商品のデータが詳細データウィンドウに表示されます。

9 商品の単価を変更します。メニューバーの［編集｜更新］を選択します。

これで変更した商品データがデータベースに送られ、別の確認メッセージが表示されます。

10 メッセージボックスで［OK］をクリックします。マスタデータウィンドウで別の商品を選択します。

その商品のデータが詳細データウィンドウに表示されます。

11 メニューバーの［編集｜削除］を選択します。

データウィンドウからはその商品がただちに削除されますが、［編集］メニューの［更新］オプションを選択するまでデータベースからは削除されません。

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

アプリケーションが終了し、ウィンドウペインタに戻ります。


レッスン 9 デバッガの実行



開発中のアプリケーションが思ったとおりに動作しないことがあります。適切な値が変数に割り当てられていない、スクリプトが間違っているなどの原因が考えられます。このような場合、デバッグモードで実行することによって、アプリケーションを調べることができます。

デバッグモードでは、ブレークポイント（ストップ）をスクリプトおよび関数に挿入したり、コードをステップごとに実行したり、変数の内容を表示したりして、実行中にエラーとなる論理エラーやエラー箇所を確認することができます。デバッグモードでアプリケーションを実行すると、ブレークポイントを設定したスクリプトの手前で実行が停止します。この時点で、変数の値を参照して変更できます。


• アプリケーションのスクリプトへのブレークポイントの追加

• デバッグモードでのアプリケーションの実行

• ウォッチと条件ブレークポイントの設定

所要時間

約 20 分

アプリケーションのスクリプトへのブレークポイントの追加



現在の学習個所> アプリケーションのスクリプトへのブレークポイントの追加

デバッグモードでのアプリケーションの実行ウォッチと条件ブレークポイントの設定

このステップでは、デバッガを開き、ブレークポイントを追加して、ログインウィンドウおよび顧客情報ウィンドウの動作をテストします。デバッグモードでアプリケーションを実行すると、アプリケーションはブレークポイントが設定されている行を実行する直前で停止します。

スクリプトにブレークポイントを挿入するときは、実行可能なステートメントを含む行を選択する必要があります。変数を宣言している行、コメント行、または空白行にブレークポイントを設定しようとすると、ブレークポイントは自動的に次の実行可能な行に設定されます。

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

デバッガが開きます。デフォルトのビューレイアウトでは、タブペインのスタックが 3 つあります。デバッグウィンドウの左上にあるペインに、ソースビューが表示されています。右上にあるペインに、ソースブラウザビューが開いています。



デバッグウィンドウの表示が異なる場合

以前にデバッグウィンドウを開いて、ビューを開いたり、移動したり、閉じたりした場合は、この画面とは表示が異なることがあります。デフォルトのビューレイアウト構成に戻すには、メニューバーの［ビュー｜レイアウト｜（デフォルト）］を選択します。

アプリケーションの 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



行の先頭にブレークポイントを示す記号が表示されます。

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 の［開始］ボタンをクリックします。またはメニューバーの［デバッグ｜ pbtutor の開始］を選択します。

アプリケーションが起動して、ブレークポイントのある行まで実行されます。ここでは、シートウィンドウのツールバータイトルの代入文の呼び出しまでです。

ブレークポイントのある行まで達すると、アプリケーションは停止してデバッグウィンドウに戻ります。黄色い矢印カーソルは、次に実行されるステートメントを指しています。

2 左下のスタックの［グローバル］タブをクリックします。

グローバル変数のビューが表示されます。



3 「transaction sqlca」をダブルクリックします。データ型が String 型の DBMS プロパティを検索します。

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 イベントのスクリプトに戻ります。 sqlcode の値が変更され、 sqlerrortext および DBMS プロパティには値が入っていますが、UserID、DBPass、および DBParmプロパティにはありません。



これらの値は、接続サービスオブジェクトの Constructor イベントの実行時に、 of_GetConnectionInfo 関数が INI ファイルからの情報を返した後で代入されますが、このチュートリアルでは、 UserID、DBPass、および DBParm プロパティの行をコメントアウトしたので、これらの値は取得されません。

10 左下のスタックで［ローカル］タブをクリックします。

Clicked スクリプトのローカル変数にはまだ値が代入されていません。

11 ［ステップイン］ボタンを使用してローカル変数の 3 つの代入文を実行します。



それぞれのステートメントを実行すると、これらのローカル変数に代入された値が予想したものであることを確認することができます。

12 左下のスタックの［グローバル］タブをもう一度クリックし、Transaction オブジェクトを展開します。［ステップイン］ボタンを使用して、 UserID、 DBPass、およびDBParm 用にユーザが入力した値を用いて Transaction オブジェクト（SQLCA）をインスタンス化する 3 つの行を実行します。

それぞれのステートメントを実行すると、ログインウィンドウで入力した値が Transaction オブジェクトに代入されているかどうかを確認できます。データベースへの接続は、接続サービスオブジェクトの of_Connect 関数を実行するまでは行われません。



13 ペインタバー 1 の［継続］ボタンをクリックします。

［継続］ボタンは、実行を再開し、次のブレークポイントまで処理を進めます。データベースに接続し、ログインウィンドウが閉じ、アプリケーションの MDI フレームが表示されます。アプリケーションはユーザからの入力を待機しています。

14 メニューバーから［ファイル｜レポート｜顧客情報］を選択します。

アプリケーションは、 RowFocusChanged イベント内の次のブレークポイントが設定されている行まで実行されます。

データウィンドウの RowFocusChanged イベントは、データウィンドウが表示される前に発生します。このため、アプリケーションの実行は顧客情報ウィンドウが開かれる前に停止します。



ウォッチと条件ブレークポイントの設定

現在の学習個所アプリケーションのスクリプトへのブレークポイントの追加デバッグモードでのアプリケーションの実行

> ウォッチと条件ブレークポイントの設定

このステップでは、ユーザが顧客情報ウィンドウで行を選択すると値が変化する変数に、ウォッチを設定します。次に、設定した単純なブレークポイントを、変数が特定の値を持つ場合にのみ発生する条件ブレークポイントに変更します。

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 の開発環境に戻ります。




レッスン 1 0 例外処理

例外処理では、プログラムの実行中に発生したエラーを捕捉し、それらのエラーに関する情報をアプリケーションユーザに提供します。このレッスンでは、ユーザ定義の例外オブジェクトを作成する方法、メソッド内で TRY-CATCH 文によって送出した例外を捕捉する方法について解説します。


• 既存のアプリケーションへの新規のシートウィンドウの追加

• ユーザ定義の例外オブジェクトの作成

• 新規のユーザ関数とユーザイベントの作成

• メソッドの呼び出しと例外の捕捉


所要時間

約 45 分

既存のアプリケーションへの新規のシートウィンドウの追加



現在の学習個所> 既存のアプリケーションへの新規のシートウィンドウの追加

ユーザ定義の例外オブジェクトの作成新規のユーザ関数とユーザイベントの作成メソッドの呼び出しと例外の捕捉アプリケーションの実行

このレッスンでは、メインのチュートリアルアプリケーションに 3 つ目のシートウィンドウを追加します。そして、埋め込み SQL コマンドから返される値、およびアプリケーションユーザがドロップダウンリストボックスコントロールで選択した値に対して（パーセンテージを計算するといった）決まった操作を実行する関数を作成して呼び出します。

作成する関数のプロトタイプでユーザ定義の例外を発生させます。コマンドボタンコントロールの Clicked イベントに記述された TRY-CATCHブロック内でこの関数を呼び出します。そして、アプリケーションコールスタックの上位に送出されたシステム例外と同じように、新規の関数によって送出されたユーザ定義の例外を捕捉する CATCH 句をClicked イベントに記述します。

さらに、新規のウィンドウシートを使用して、選択した都道府県に住んでいる顧客のパーセンテージを計算します。新規のシートウィンドウに追加するコントロールは以下のとおりです。

• 読み取り専用の結果を表示するためにプログラムで変更する 2 つのスタティックテキストボックス

• パーセンテージを計算する関数を呼び出すコマンドボタン

• 顧客の在住の都道府県をリストするドロップダウンリストボックス

• ユーザがドロップダウンリストボックスから選択した都道府県に住んでいる顧客のパーセンテージが表示されるテキストボックス

既存のアプリケーションに新規のシートウィンドウを追加するには、以下の操作を行う必要があります。

• シートウィンドウの作成

• メインアプリケーションフレームからシートウィンドウにアクセスできるようにする

レッスン 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 テキスト全体が収まるようにコントロールの幅を広げます。

11 どのコントロールも選択されていないことと、プロパティビューにシートウィンドウプロパティが表示されていることを確認します。［タグ］プロパティに「都道府県に住んでいる顧客のパーセンテージ」と入力します。

ここで入力したテキストは、実行時にシートウィンドウのタイトルとして表示されます。基本シートの ue_postopen イベントのコードで、タグのテキストがシートウィンドウのタイトルに割り当てられます。

12 PowerBuilder メニューから［ファイル｜上書き保存］を選択します。アプリケーションライブラリとして pbtutor.pbl を選択し、新規ウィンドウ名に「w_cust_pct」と入力して、［OK］をクリックします。

これで、新規のシートウィンドウとそのすべてのコントロールがメインのチュートリアルライブラリに保存されます。

メインアプリケーションフレームからシートウィンドウにアクセスできるようにする

新規のシートをシートマネージャに登録する必要があります。

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



2 ue_postopen イベントがスクリプトビューに表示されていない場合は、［イベントリスト］タブを選択して、 ue_postopen をダブルクリックします。

ue_postopen イベントスクリプトが、スクリプトビューに表示されます。

3 シート用リストを編集して、新しいウィンドウを追加します。以下のエントリは一行（改行なし）で表します。

string ls_sheets[] = { "w_customers", "w_products", "w_cust_pct" }

4 表示用リストを編集して、新しいウィンドウにラベルを追加します。以下のエントリは一行（改行なし）で表します。

string ls_display[] = { "顧客情報 ", "商品管理 ", "都道府県に住んでいる顧客のパーセンテージ " }

5 ［ファイル｜上書き保存］を選択して、w_pbtutor_frame ウィンドウを閉じます。

次回 pbtutor アプリケーションを実行すると、メインフレームウィンドウの［ファイル］メニューから新規のシートウィンドウを開くことができるはずです。開発環境では新規のシートウィンドウを即実行できますが、コンパイル済みアプリケーションでも実行できるようにする必要があります。



そのために、シートマネージャの of_registersheet スクリプトで、新規のシートウィンドウをウィンドウオブジェクトとして参照します。こうして参照することで、コンパイラは、このウィンドウオブジェクトがアプリケーションで使用されていることを認識でき、実行可能ファイルに含めることができます。

コンパイル済みアプリケーションは、レッスン 11「アプリケーション配布の準備」で作成します。

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

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」と入力して［OK］をクリックします。

5 ［ファイル｜閉じる］を選択します。

6 以下のテキストプロパティ値と例外オブジェクト名を用いて手順1 ～ 5 を繰り返します。

7 以下のテキストプロパティ値と例外オブジェクト名を用いて手順1 ～ 5 を繰り返します。

プロパティ値

テキストパーセンテージが低すぎます。この都道府県には

顧客が 1 人しかいません。担当販売マネージャ

に連絡してください。

例外オブジェクト名 exc_low_number

プロパティ値

テキスト都道府県名は 2 文字の都道府県コードで指定し

てください。

例外オブジェクト名 exc_bad_entry



新規のユーザ関数とユーザイベントの作成

現在の学習個所既存のアプリケーションへの新規のシートウィンドウの追加ユーザ定義の例外オブジェクトの作成

> 新規のユーザ関数とユーザイベントの作成メソッドの呼び出しと例外の捕捉アプリケーションの実行

ここでは、［パーセンテージ］コマンドボタンの Clicked イベントによって起動される関数と、 w_cust_pct ウィンドウのドロップダウンリストボックスからフォーカスが移動したときに起動するイベントを追加します。この関数は、特定の都道府県に住む顧客のパーセンテージを計算します。イベントは、ドロップダウンリストボックスコントロールの現在値（都道府県コード）を処理し、長さが 2 文字かどうかを確認します。

1 開いていない場合は、ウィンドウペインタ内で w_cust_pct を開きます。スクリプトビューの初のリストボックスで「(Functions)」を選択します。

プロトタイプウィンドウにスクリプトビューが表示されます。スクリプトビューの初のドロップダウンリストボックスには「(Functions)」が、 2 番目のリストボックスには「( 新規関数 )」が表示されます。

2 ［戻り値のデータ型］として「decimal」を選択し、［関数名］に「uf_percentage」と入力します。

3 ［引数データ型］として「integer」を選択し、［引数名］に「ai_custbystate」と入力します。

次の手順では、第 2 引数を追加します。

4 プロトタイプウィンドウ内のどこかで右クリックして、ポップアップメニューの［パラメータの追加］を選択します。

5 2 番目の引数のデータ型として「integer」を選択して、引数名に「ai_totalcust」と入力します。

新規のユーザ関数とユーザイベントの作成


6 ［Throws］ボックスで「exc_no_rows,exc_low_number」と入力します。

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)*100CATCH (dividebyzeroerror le_zero)

throw le_zeroEnd TRY

END 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」であることに注意してください。ue_modifiedイベントのイベント ID は選択しません。イベント 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 関数を呼び出して、これらのメソッドによって送出された例外を捕捉します。

メソッドの呼び出しと例外の捕捉



現在の学習個所既存のアプリケーションへの新規のシートウィンドウの追加ユーザ定義の例外オブジェクトの作成新規のユーザ関数とユーザイベントの作成

> メソッドの呼び出しと例外の捕捉アプリケーションの実行

ここでは、都道府県コードを EAS Demo DB データベースの customerテーブルから取得して、ドロップダウンリストボックスコントロールに設定するコードを記述します。このコントロールは編集可能にしてあるため、都道府県コードの値をアプリケーションユーザが入力することもできます。ユーザが入力した値を処理する前に、入力値がue_modified イベントに設定した条件を満たしているかどうか、すなわち長さが 2 文字であるかどうかを確認します。

また、コマンドボタンコントロールの Clicked イベントに、ドロップダウンリストボックスコントロールに入力されている都道府県コードを処理するコードを追加します。Clicked イベントでは、uf_percentage関数を呼び出して、選択されている都道府県に住んでいる顧客のパーセンテージを計算し、同関数によって送出されるすべての例外を捕捉します。

1 ウィンドウペインタ内に w_cust_pct が開いていること、スクリプトビューの初のドロップダウンリストボックスに ddlb_state が表示されていることを確認します。

2 2 番目のドロップダウンリストボックスから「losefocus ( )returns long [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 ;// リストの最初の項目を選択された項目として設定するthis.selectitem (1)

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//選択した都道府県に住む顧客の行数を取得し、//entry_1 変数に格納する// この数字を、最初の// スタティックコントロールに表示する

SELECT count(*) INTO :entry_1 FROM customerWHERE 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 メニューバーから［ファイル｜レポート｜都道府県に住んでいる顧客のパーセンテージ］を選択します。



都道府県に住んでいる顧客のパーセンテージウィンドウが表示されます。ドロップダウンリストの現在のエントリは、青森県を表す AM です。

4 ［パーセンテージ］ボタンをクリックします。

青森県に顧客が 1 人しかいないため、ユーザ定義の例外exc_low_number が発生します。この例外が発行したメッセージが、［パーセンテージ］ボタンの Clicked イベントスクリプトの CATCH句に定義されたメッセージボックスに表示されます。

5 ［OK］をクリックして、メッセージボックスを閉じます。

スタティックテキストボックス内のテキストに、青森県在住の顧客の数とデータベースに登録されている顧客の総数が表示されます。編集可能なテキストボックスに、パーセンテージが計算されなかったため、別の都道府県を選択するように促すテキストが表示されます。



6 都道府県に住んでいる顧客のパーセンテージシートウィンドウのドロップダウンリストボックスで「KG」を選択または入力して、［パーセンテージ］ボタンをクリックします。

検索結果から、神奈川県在住の顧客は 15 人存在し、データベースに登録されている全顧客の 11.9% を占めることがわかります。データベースを変更するとパーセンテージが変わります。

7 ドロップダウンリストボックスに「Ohio」と入力して、［パーセンテージ］ボタンをクリックします。

［パーセンテージ］ボタンをクリックしてドロップダウンリストボックスからフォーカスを移動すると、LoseFocus イベントが発生します。このイベントにより ue_modified イベントが起動され、ユーザ定義の例外 exc_bad_entry が発生します。 2 文字の都道府県コードを使用するように指示するこの例外メッセージが表示されます。

8 ［OK］をクリックしてメッセージボックスを閉じ、ドロップダウンリストボックスに「US」と入力して、［パーセンテージ］ボタンをクリックします。

US という都道府県コードを持つ行はデータベース内に見つからないため、 exc_no_rows 例外が発生します。該当する行が返されなかったことと、その理由を示すメッセージが表示されます。より堅牢なアプリケーションにしたい場合は、入力されたテキストを都道府県コードのリストと照合して US が都道府県コードではないことを知らせる exc_bad_entry 例外を発生させるとよいでしょう。

9 ［OK］をクリックして、メッセージボックスを閉じます。



10 Windows システムトレイに表示されている EAS Demo DB を表すデータベースアイコン（赤と黄色の SQL シンボル）を右クリックします。ポップアップメニューの［シャットダウン］を選択し、警告メッセージボックスが表示されたら［はい］をクリックします。

EAS Demo DB データベースとの接続が切断されます。

11 ドロップダウンリストボックスで再度「AM」を選択または入力して、［パーセンテージ］ボタンをクリックします。

データベースとの接続が切断されているため、exc_no_rows 例外オブジェクトのメッセージが表示されます。結果を取得し直すには、アプリケーションを終了して再起動する必要があります。アプリケーションを再起動すると、実行時環境でデータベースとの接続が再確立されます。

12 ［OK］をクリックしてメッセージボックスを閉じ、アプリケーションメニューから［ファイル｜終了］を選択して開発環境に戻ります。

データベースペインタとデータベースプロファイルペインタでは、データベース接続がオープンされたままの状態になっていることがあります。その場合は、どちらかのペインタを使用してデータベースとの接続を切断し、デザイン時環境で再接続します。

ゼロによる除算エラーのテストの追加

ここでは、w_cust_pct ウィンドウにチェックボックスを追加します。そして、このチェックボックスがオンのとき、ゼロによる除算エラーを強制的に発生させるコードを記述します。このテストにはインスタンス化されたチェックボックスオブジェクトが必要なので、新しいコードを、 null オブジェクトのエラーをチェックする TRY-CATCH 文で囲みます。

1 レイアウトビューで w_cust_pct ウィンドウが開いていることを確認します。ウィンドウペインタのメニューで［挿入｜コントロール｜チェックボックス］を選択します。

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 メニューバーから［ファイル｜レポート｜都道府県に住んでいる顧客のパーセンテージ］を選択します。ドロップダウンリストボックスから都道府県コードを選択します。



9 ［ゼロによる除算のテスト］チェックボックスをオンにします。

10 ［パーセンテージ］ボタンをクリックします。

パーセンテージの計算中にゼロによる除算エラーが発生し、［パーセンテージ］ボタンの Clicked イベントによって捕捉されます。CATCH 句に記述したこのエラーのメッセージボックスが表示されます。

11 ［いいえ］をクリックしてアプリケーションの実行を継続します。別の都道府県コードを選択しチェックボックスをオフにしてアプリケーションのテストを続行します。

チェックボックスがオンのまま［パーセンテージ］ボタンを再度クリックし、エラーメッセージボックスで［はい］を選択すると、アプリケーションが閉じ、開発環境に戻ります。

12 テストを終了したらアプリケーションを閉じます。




レッスン 1 1 アプリケーション配布の準備

このレッスンでは、アプリケーションの実行ファイル（EXE ファイル）を作成します。作成した実行ファイルは、エンドユーザがほかのアプリケーションと同じように実行できます。


• プロジェクトオブジェクトの作成

• 実行ファイルの作成

• ショートカットの作成

• 実行ファイルのテスト

所要時間

約 10 分

プロジェクトオブジェクトの作成



現在の学習個所> プロジェクトオブジェクトの作成

実行ファイルの作成ショートカットの作成実行ファイルのテスト

このステップでは、 PBTUTOR プロジェクトオブジェクトを作成します。プロジェクトオブジェクトは、アプリケーションの実行ファイルを作成するのに使用できます。

マシンコードについて PowerBuilder Enterprise 版を実行している場合は、プロジェクト実行ファイルのコンパイル方式として Pcode （擬似コード）とマシンコードのいずれかを選択できます。ただし、チュートリアルアプリケーションには Try-Catch 文が含まれているため、コンパイル方式としてマシンコードを選択することはできません。

アプリケーションをユーザに配布するときは、ループ、浮動小数点または整数演算、関数呼び出しなどの計算で実行速度を上げるためにマシンコードを使用してもよいでしょう。しかし、アプリケーションの開発の際は、通常は Pcode を使用した方が高速にコードを生成できます。

動的ライブラリについてまた、アプリケーションに動的ライブラリを作成することもできます。動的ライブラリはアプリケーションで使用するオブジェクトを格納するのに使用できます。動的ライブラリを使用することにより、アプリケーションを管理しやすいように小さなユニットに分割して、実行ファイルのサイズを小さくすることができます。

このチュートリアルで作成しているアプリケーションのような小さいアプリケーションの場合は、動的ライブラリを使用する必要はありません。

レッスン 11 アプリケーション配布の準備


1 パワーバーの［新規作成］ボタンをクリックします。新規作成ダイアログボックスの［プロジェクト］タブをクリックします。

2 ［アプリケーションウィザード］アイコンを選択して［OK］をクリックします。

プロジェクトペインタの使い方

［プロジェクト］ページで、［アプリケーションウィザード］アイコンではなく［アプリケーション］アイコンをクリックした場合は、プロジェクトペインタが開きます。プロジェクトペインタでもウィザードの場合と同様に値を選択できますが、ウィザードの場合は、ウィザードからの指示に従って必要な情報を入力することができます。


［格納先ライブラリの指定］ページが表示されます。



4 まだ選択していない場合は、［アプリケーションライブラリ］リストボックスで「pbtutor.pbl」を選択します。［構築オプションの指定］ページが表示されるまで［次へ］をクリックします。

以下のデフォルト値が選択されたプロジェクトが生成されます。

5 ［再構築オプション］で［インクリメンタル構築］を選択します。［バージョン情報の設定］ページが表示されるまで［次へ］をクリックします。

以下のデフォルト値が選択されたプロジェクトが生成されます。

6 必要であれば、独自のバージョン情報を［バージョン情報の設定］ページに入力します。

このページの情報を変更しない場合、実行ファイルのプロパティを Windows エクスプローラで参照したときにデフォルト値が表示されます。

ウィザードのプロパティデフォルト値

プロジェクト名 p_pbtutor_exe実行可能ファイル名 pbtutor.exe

リソースファイル（オプション）なし

ウィザードのプロパティデフォルト値

マシンコードの生成なし

動的ライブラリの作成なし



7 ［次へ］をクリックします。［アプリケーションの作成準備完了］ページの情報を確認します。［完了］ボタンをクリックします。

アプリケーションのプロジェクトオブジェクトが作成され、プロジェクトペインタのワークスペースに表示されます。

プロジェクトを定義し終えたら、アプリケーションの実行ファイルは簡単に作成できます。プロジェクトを使用すると、頻繁に再構築する動的ライブラリを含むアプリケーションの場合に作業時間を短縮できます。インクリメンタル構築を選択すると、いくつか変更を加えた場合に、変更されたファイルのみ、または変更されたファイルに依存するファイルのみを再構築することで、すばやくプロジェクトを再構築できます。

実行ファイルの作成



現在の学習個所プロジェクトオブジェクトの作成

> 実行ファイルの作成ショートカットの作成実行ファイルのテスト

このステップでは、アプリケーションの実行ファイルを作成します。作成する実行ファイルには、アプリケーションのすべてのオブジェクトの定義が格納されます。このチュートリアルアプリケーションでは、プロジェクトに独立したリソースファイルを含めなかったので、ログインウィンドウで使用するビットマップファイルを含みます。

プロジェクトペインタでも実行ファイルを作成できますが、通常は、一度プロジェクトの定義を終えたら、プロジェクトペインタを再度開く必要はありません。

システムツリーのワークスペースおよびターゲットでは、ポップアップメニュー項目に［インクリメンタル構築］、［フル構築］、および［配布］があり、これらを使用すると、ターゲット内またはワークスペース全体の中のプロジェクトの一部または全部を構築および配布できます。［インクリメンタル構築］および［フル構築］を選択すると、コードがコンパイルされます。［配布］を選択すると、コードがコンパイルされ、このチュートリアルで構築したようなアプリケーションの場合は、実行ファイルとオプションの動的ライブラリが作成されます。そのほかのプロジェクト（サーバコンポーネントプロジェクトなど）の場合は、［配布］を選択すると、サーバへのコンポーネントおよびサポートファイルの配布も行われます。

このレッスンでは、プロパティシートについて説明します。プロパティシートでは、構築と配布のオプションを指定し、そしてパワーバーから実行ファイルを作成します。

1 プロジェクトペインタを閉じます。変更内容を保存するかどうかを確認するメッセージが表示されたら、［はい］をクリックします。



2 システムツリーで pbtutor ターゲットを右クリックします。［プロパティ］を選択してから、［配布］タブを選択します。

このページには、このターゲット内のすべてのプロジェクト（現在は 1 つだけ）が表示されます。

ターゲット内に複数のプロジェクトがある場合は、実行される順序の変更、および構築するプロジェクトの選択ができます。



3 p_pbtutor_exe をチェックしたままで［キャンセル］ボタンをクリックします。システムツリーで MyWorkspace を右クリックします。［プロパティ］を選択し、［配布プレビュー］タブを選択します。

［配布プレビュー］タブページには、ワークスペース内のすべてのターゲット、および配布対象として選択された各ターゲット内のプロジェクトが、配布される順序で表示されます。このページでは何も変更できません。ワークスペースの配布オプションを希望どおりに設定したことを確認するためのページです。このページに表示されるすべてのプロジェクトは、パワーバーの［配布］ボタンをクリックすると配布されます。

このワークスペースにはターゲットとプロジェクトがそれぞれ 1つあるだけなので、［配布］ボタンを使用して実行ファイルを作成できます。

4 ［キャンセル］ボタンをクリックして、プロパティシートを閉じます。

5 パワーバーの［配布］ボタンをクリックします。

実行ファイルの作成には多少時間がかかります。実行ファイルを作成している間は、画面下部の出力ウィンドウで処理の状況を確認することができます。

配布のプロセスを中止したい場合は、パワーバーの［中止］ボタンをクリックします。配布が完了すると、出力ウィンドウに終了のメッセージが表示されます。



ショートカットの作成

現在の学習個所プロジェクトオブジェクトの作成実行ファイルの作成

> ショートカットの作成実行ファイルのテスト

このステップでは、実行ファイルのショートカットを作成します。アイコンは、実行ファイルを開くためのショートカットとして動作します。ショートカットは、直接デスクトップへ、または選択したプログラムグループに追加できます。

1 ［小化］ボタンをクリックして、 PowerBuilder を小化します。

PowerBuilder が小化され、タスクバーにアイコン表示されます。

2 デスクトップの空白領域でマウスの右ボタンをクリックします。ポップアップメニューから［新規作成｜ショートカット］を選択します。

3 ショートカットの作成ダイアログボックスで、［参照］ボタンをクリックして pbtutor.exe を探します。

PowerBuilder のインストール先がデフォルトの場合、ファイルはMy Documents\Sybase\Powerbuilder 12.5\Tutorial 内にあります。

4 ［OK］をクリックし、［次へ］をクリックします。

5 ショートカット名として「PowerCap 営業支援システム」と入力します。

6 ［完了］ボタンをクリックして、デスクトップ上にショートカットを作成します。

アプリケーションを実行できるように、そのショートカットのプロパティを修正します。また、アイコンを変更することもできます。

7 デスクトップ上の［PowerCap 営業支援システム］アイコンを右クリックします。

ショートカットの作成


ポップアップメニューで［プロパティ］を選択します。

8 ［ショートカット］タブを選択します。［作業フォルダ］ボックスに Powersoft の共有モジュールフォルダへのパスを入力します。［OK］をクリックします。

共有モジュールの格納場所について

PowerBuilder をインストールすると、各 DLL ファイルが共有ディレクトリにインストールされます。デフォルトのインストール先は「C:Program Files\Sybase\Shared\PowerBuilder」です。

ユーザが実行ファイルをダブルクリックしてアプリケーションを実行できるようにするには、システム環境パスに共有ディレクトリの場所を含める必要があります。



実行ファイルのテスト

現在の学習個所プロジェクトオブジェクトの作成実行ファイルの作成ショートカットの作成

> 実行ファイルのテスト

このステップでは、新しく作成した実行ファイルをテストします。

1 pbtutor.ini ファイルが実行ファイル pbtutor.exe と同じディレクトリに格納されていることを確認します。

pbtutor.ini ファイルおよび pbtutor.exe ファイルのデフォルトのインストール先は My Documents\Sybase\PowerBuilder 12.5\Tutorial です。

2 チュートリアルアプリケーションのアイコンをダブルクリックします。

アプリケーションの実行が開始されます。

3 アプリケーションをテストします。顧客情報に加えた変更に注意してください。

4 アプリケーションのテストを終えたら、［ファイル｜終了］を選択します。

次のステップについてお疲れさまでした。これでクライアントサーバチュートリアルが終了しました。このチュートリアルでは PowerBuilder でのアプリケーション構築の基本的な方法を学習しました。これで、 .NET Web フォームとWindows フォームのレッスンに進むことができます。

このマニュアルの冒頭の「このマニュアルについて」には、PowerBuilderの各マニュアルについての説明が記載されています。さらに高度な開発技術を学習するには、以下のマニュアルに進んでください。

次のステップについて


『ユーザーズガイド』『アプリケーションテクニック』『データウィンドウプログラマーズガイド』

PowerBuilder のすべてのマニュアルは、オンラインブックや日本コン

ピュータシステムのサイト http://www.powerbuilder.jp/ にある「技術情報」で利用できます。オンラインブックのインストール方法については、『インストールガイド』マニュアルを参照してください。

第 3 部 Web フォームアプリケーションの構築

第 3 部は、 .NET Web フォームターゲットの使用方法を示したチュートリアルです。クライアントサーバアプリケーションを Web フォームアプリケーションに変換する方法を手順を追って説明します。


レッスン 1 2 PowerBuilder チュートリアルの Web フォームアプリケーションへの変換

このチュートリアルでは、 PowerBuilder チュートリアルアプリケーションを ASP.NET Web フォームアプリケーションに変換するのに必要な情報を提供します。開発するコンピュータ上には、Microsoft .NET Framework および IIS サーバをインストール済みであると想定しています。ほかのコンピュータを使用して、標準のWeb ブラウザから Web フォームアプリケーションを実行できます。

このチュートリアルでは、以下のことを行います。

• PowerBuilder でのチュートリアルの実行

• .NET Web フォームアプリケーションへの変更

• .NET Web フォームターゲットおよびプロジェクトの作成

• .NET Web フォームプロジェクトの配布

• Web ブラウザからのアプリケーションの実行

所要時間

約 40 分

PowerBuilder でのチュートリアルの実行



現在の学習個所> PowerBuilder でのチュートリアルの実行

.NET Web フォームアプリケーションへの変更

.NET Web フォームターゲットおよびプロジェクトの作成

.NET Web フォームプロジェクトの配布Web ブラウザからのアプリケーションの実行

チュートリアルの要件

チュートリアルアプリケーションを正常に動作させるには、アプリケーションを配布するシステム上で、 ASP.NET を .NET Web フォームプロジェクト用に設定しておく必要があります。たとえば、 ASP.NETユーザとして SQL Anywhere を実行したり EAS Demo DB V125 データベースに接続したりするための適切な権限を設定する必要があります。 ASP.NET の設定については、『アプリケーションとコンポーネントの .NET への配布』マニュアルの第 1 章を参照してください。

PowerBuilder チュートリアルアプリケーションを ASP.NET Web アプリケーションとして配布する前に、システム開発の PowerBuilder 環境からアプリケーションを正常に実行できるかどうかを確認します。完成したチュートリアルアプリケーションは、 PowerBuilder のインストールパスの Tutorial\Solutions ディレクトリにあります。

Web フォームターゲットを solutions ワークスペースに追加するので、まず初にチュートリアルアプリケーションのワークスペースとターゲットを別のディレクトリにコピーしておきます。これをこのチュートリアルの初に行います。

1 MyDocuments\Sybase\PowerBuilder 12.5\Tutorial ディレクトリの下にサブディレクトリを作成し、 Web Forms という名前を付けます。

2 Tutorial\Solutions フォルダ内のファイルを、新しく作成した Tutorial\Web Forms フォルダにすべてコピーします。

3 Windows の［スタート］メニューから［プログラム｜ Sybase ｜PowerBuilder 12.5 ｜ PowerBuilder 12.5］を選択します。

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

レッスン 12 PowerBuilder チュートリアルの Web フォームアプリケーションへの変換


4 ［ファイル］メニューから［ワークスペースを開く］を選択します。

ワークスペースを開くダイアログボックスが表示されます。

5 手順 1 で作成した Tutorial\Web Forms フォルダに移動し、MyWorkspace.pbw を選択して［開く］をクリックします。

PowerBuilder IDE で、PowerScript ターゲットファイルの pbtutor.pbtが含まれたワークスペースが開きます。このターゲットには、2 つのライブラリファイル（pbtutor.pbl と tutor_pb.pbl）があり、チュートリアルアプリケーションのすべてのオブジェクトが含まれています。


チュートリアルアプリケーションのログインウィンドウが表示されます。

7 ユーザ ID の「dba」とパスワードの「sql」を入力します。

ログインが成功すると、メニューとツールバーのある MDI フレームウィンドウが表示されます。

8 メニューオプションが動作することを確認し、アプリケーションを終了します。




現在の学習個所PowerBuilder でのチュートリアルの実行

> .NET Web フォームアプリケーションへの変更.NET Web フォームターゲットおよびプロジェクトの作成.NET Web フォームプロジェクトの配布Web ブラウザからのアプリケーションの実行

Web フォームアプリケーションがデータベースに接続する前に、常に手動でチュートリアルのデータベースを開始する予定がない限り、ASP.NET ユーザにデータベースと SQL Anywhere データベースエンジンを含むディレクトリに対してフルコントロールの権限を付与し、それらのディレクトリ内の全ファイルにもその権限を与えておく必要があります。

注意　『アプリケーションとコンポーネントの .NET への配布』マニュアルの「ASP.NET ユーザアクセス許可の付与」の節の手順によってすでに両方または片方のディレクトリに権限を与えている場合、ここで再度、権限を与える必要はありません。

1 Windows エクスプローラで、 PowerBuilder のチュートリアルディレクトリ（27 ページの「チュートリアルディレクトリ」で説明）を参照します。

このディレクトリには、チュートリアルデータベースがあります。

2 このディレクトリを右クリックし、ポップアップメニューから［プロパティ］を選択します。

3 プロパティダイアログボックスの［セキュリティ］タブを選択し、［追加］ボタンをクリックします。

ユーザ、コンピュータまたはグループの選択ダイアログボックスが表示されます。



［セキュリティ］タブが表示されない場合

［セキュリティ］タブを表示するためには、現行ディレクトリのフォルダオプションダイアログボックスの［表示］タブの設定を変更する必要があります。Windows Explorer から［ツール｜フォルダオプション］メニュー項目を選択して、フォルダオプションダイアログボックスを開きます。［セキュリティ］タブを表示するには、［簡易ファイルの共有を使用する（推奨）］のチェックボックスをオフにします。

4 ［場所］をクリックし、場所ダイアログボックスからサーバコンピュータ名を選択して［OK］をクリックします。

5 ［選択するオブジェクト名を入力してください］リストボックスにASPNET、 IIS_WPG、または IIS_IUSRS と入力し、［OK］をクリックします。

［OK］をクリックする前に

［名前の確認］ボタンをクリックすると、入力したユーザ名がシステムによって認識されない場合にメッセージが表示されます。名前が認識されない場合は、 Microsoft NET Framework を再インストールする必要があります。

IIS 5 の場合は ASPNET、 IIS 6 の場合は IIS_WPG、 IIS 7 の場合はIIS_IUSRS と入力します。入力した ASP.NET アカウントは、現行ディレクトリの［セキュリティ］タブに追加されます。



6 ［セキュリティ］タブの一番上のリストボックスから新しいユーザアカウントを選択し、下のリストボックスの許可カラムの下にある［フルコントロール］チェックボックスをオンにします。

7 ［詳細設定］ボタンをクリックします。

現行ディレクトリのセキュリティの詳細設定ダイアログボックスが表示されます。

8 ［子オブジェクトすべてのアクセス許可エントリを、ここに表示されているエントリで子オブジェクトに適用するもので置換する］チェックボックスをオンにし、［OK］をクリックします。

セキュリティダイアログボックスに、子オブジェクトの現行のアクセス許可を削除し、継承された権限をこれらのオブジェクトに反映することを知らせる警告が表示され、応答するよう要求されます。

9 セキュリティダイアログボックスで［はい］をクリックし、［OK］をクリックして、現行ディレクトリのプロパティダイアログボックスを閉じます。

10 SQL Anywhere 11\Bin32 ディレクトリに対する変更がまだの場合は、このディレクトリに対して上記の手順 1 ～ 9 を繰り返します。




現在の学習個所PowerBuilder でのチュートリアルの実行.NET Web フォームアプリケーションへの変更

> .NET Web フォームターゲットおよびプロジェクトの作成.NET Web フォームプロジェクトの配布Web ブラウザからのアプリケーションの実行

PowerBuilder .NET Web フォームターゲットウィザードを使用して、既存の PowerBuilder アプリケーションターゲットに基づいて .NET Webフォームターゲットを作成できます。このチュートリアルでは、PowerBuilder チュートリアルターゲットに基づいて .NET Web フォームターゲットを作成します。Web フォームアプリケーションを配布するために使用する .NET Web フォームプロジェクトも作成します。

1 メニューから［ファイル｜新規作成］を選択し、［ターゲット］タブをクリックします。

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

2 ［.NET Web フォームアプリケーション］アイコンを選択して、［OK］をクリックします。

ウィザードの初のページには、実行可能な作業に関する説明があります。

3 ［次へ］をクリックしてウィザードの 2 番目のページを表示し、［既存のターゲットからライブラリリストとアプリケーションオブジェクトを使用する］ラジオボタンを選択してから、［次へ］をクリックします。

［ターゲットの選択］ウィザードページが表示されます。このページには、現行ワークスペースのターゲットのリストボックスがあります。この時点では、チュートリアルワークスペース内のターゲットは PBTutor ターゲットのみです。



4 PBTutor が選択されていることを確認し、［次へ］をクリックします。

［ターゲットファイルの指定］ページが表示されます。選択した既存のターゲットファイル名に基づいた、新しい Web フォームターゲットのデフォルト名が表示されます。デフォルトのターゲットファイル名は pbtutor_webform.pbt です。

5 デフォルトのターゲット名を使用する場合は、［次へ］をクリックします。

［プロジェクト情報の指定］ページが表示されます。新しい Webフォームプロジェクトのデフォルト名がリストされます。デフォルトのプロジェクト名は p_pbtutor_webform です。このウィザードページでは、新しいプロジェクトオブジェクトを保存するターゲットライブラリも選択できます。デフォルトでは、プロジェクトオブジェクトは、新しいターゲットのメインライブラリ（ここでは pbtutor.pbl）に保存されます。

6 デフォルトのプロジェクト名およびライブラリをそのまま使用し、［次へ］をクリックします。

［.NET Web フォームアプリケーションの設定］ページには、以下のフィールドにデフォルトの値が表示されます。

7 デフォルト値をそのまま使用し、［次へ］をクリックします。

［リソースファイル / ディレクトリの指定］ウィザードページが表示されます。

8 ［ファイルの追加］ボタンをクリックします。

PowerBuilder Tutorial アプリケーションは、イメージファイルを使用します。これらのファイルを、 Web フォームアプリケーションとともに配布するために指定する必要があります。

リソースファイルの選択ダイアログボックスが表示されます。

.NET Web フォームパラメータデフォルト値

Web アプリケーション名 pbtutorアプリケーション URL プレビュー

http://<ServerName>/pbtutor（<ServerName> は IIS サーバ名を示すプレースホルダ）



9 ［ファイルの種類］ドロップダウンリストから「すべてのファイル」を選択し、 Tutorial ディレクトリに移動します。

Tutorial ディレクトリは Web Forms ディレクトリの関連ディレクトリで、 Sybase\PowerBuilder 12.5 の配下にあります。

10 〔Ctrl〕を押したまま、tshirtw.jpg、tutsport.bmp、tutorial.icoファイルを選択し、［開く］をクリックします。

選択されたリソースは、以下のようにページに追加されます。

11 選択したリソースファイルをチュートリアル Web フォームアプリケーションとともに配布するために、［次へ］をクリックします。

［Win32 ダイナミックライブラリファイルの指定］ウィザードページが表示されます。チュートリアルアプリケーションは、外部 DLL を使用しません。

12 ［配布オプションの設定］ウィザードページを表示するために、［次へ］を 2 回クリックします。

チュートリアルアプリケーションでは JavaScript ファイルは必要ないため、［JavaScript ファイルの指定］ウィザードページで含める追加の JavaScript ファイルはありません。



［配布オプションの設定］ページが表示されます。

13 IIS サーバのアドレスに表示される「localhost」をそのまま使用するか、またはローカル IIS サーバの正式な名前に変更して、［次へ］をクリックします。

このチュートリアルでは、 Web フォームプロジェクトをローカルIIS サーバに直接配布します。［次へ］をクリックすると、ウィザードの概要ページが表示されます。


.NET Web フォームアプリケーションウィザードは、 pbtutor.pbl ライブラリのライブラリリストを使用する、 PBTutor_WebForm という.NET Web フォームターゲットを作成します。また、p_pbtutor_webformという名前の .NET Web フォームプロジェクトも作成します。



.NET Web フォームプロジェクトの配布

現在の学習個所PowerBuilder でのチュートリアルの実行.NET Web フォームアプリケーションへの変更.NET Web フォームターゲットおよびプロジェクトの作成

> .NET Web フォームプロジェクトの配布Web ブラウザからのアプリケーションの実行

Web フォームプロジェクトを作成したら、 Web フォームアプリケーションを実行したりデバッグしたりする前に、 Web フォームプロジェクトを IIS サーバに配布する必要があります。ただし、 Web フォームアプリケーションを配布する前に、アプリケーションの実行時のグローバルプロパティを修正できます。このレッスンでは、アプリケーションを配布する前に、アプリケーションのデータウィンドウコントロールでのページナビゲーションのグローバルプロパティを変更します。

1 システムツリーで、 PBTutor_WebForm ターゲットとその下の pbtutor.pbl を展開します。

pbtutor.pbl および tutor_pb.pbl ライブラリは、PBTutor ターゲットとPBTutor_WebForm ターゲットの両方の下に一覧されることに注意してください。PBTutor_WebForm ターゲットで、pbtutor.pbl に表示される唯一のプロジェクトは、作成したばかりの .NET Web フォームプロジェクトです。

このライブラリは、現行ワークスペース内でリストされる PBTutorターゲットと共有されますが、新しいプロジェクト（p_pbtutor_webform）はシステムツリーの PBTutor の下には表示されません。 PBTutor ターゲットには、標準の実行ファイルを作成するためのプロジェクトと Web データウィンドウコンテナのみが表示されます。

2 システムツリーの p_pbtutor_webform プロジェクトを右クリックして、ポップアップメニューから［編集］を選択します。

プロジェクトペインタで .NET Web フォームプロジェクトが開かれます。

3 ［設定］タブをクリックし、［システム定義の設定］ラジオボタンが選択されていることを確認します。

.NET Web フォームプロジェクトの配布


4 ［設定］タブのリストビューの［キー］カラムでグローバルプロパティ PBDataWindowPageNavigatorType を選択し、［編集］をクリックします。

設定値ダイアログボックスが表示されます。

5 設定値ダイアログボックスで、［値］ドロップダウンリストを「Numeric」に変更し、［OK］をクリックします。

ナビゲータコントロールのデータ型を「NextPrev」から「Numeric」に変更します。

ページナビゲーションのデータ型については、『アプリケーションとコンポーネントの .NET への配布』マニュアルの「.NET プロジェクトのヒント集」の章を参照してください。

6 プロジェクトの［実行］タブをクリックし、［アプリケーション］および［引数］フィールドのデフォルト値を確認します。

［アプリケーション］のデフォルトは Internet Explorer ブラウザ、［引数］のデフォルトは配布後の Web フォームアプリケーションのURL です。



7 プロジェクトのそのほかのタブページ上の選択を確認します。

プロジェクトのほとんどのプロパティは、ターゲットウィザードで設定されています。プロジェクトプロパティシートには、ウィザードで設定していないほかのプロパティのデフォルト選択もあります。このチュートリアルの場合、これらのデフォルトの設定を変更する必要はありません。これらの設定については、『アプリケーションとコンポーネントの .NET への配布』マニュアルの第 2章で説明されています。プロジェクトペインタのタブページ上で右クリックし、ポップアップメニューから［ヘルプ］を選択して、追加のプロパティの説明を参照することもできます。

8 プロジェクトペインタのメニューから［デザイン｜プロジェクトの配布］を選択するか、またはペインタバーで［配布］アイコンをクリックします。

プロジェクトを構築し、ローカル IIS サーバに配布します。出力ウィンドウの［デフォルト］タブに、成功したことを示すメッセージが表示されます。［未サポート機能］タブに、 .NET Web フォーム環境でサポートされないプロパティのリストが表示されます。このチュートリアルアプリケーションについてリストされるサポートされない機能は、ほとんどがツールバーやメニューの様式に関係する機能であるため、アプリケーションのメイン機能には影響しません。

9 開いているペインタをすべて閉じます。

Web ブラウザからのアプリケーションの実行



現在の学習個所PowerBuilder でのチュートリアルの実行.NET Web フォームアプリケーションへの変更.NET Web フォームターゲットおよびプロジェクトの作成.NET Web フォームプロジェクトの配布

> Web ブラウザからのアプリケーションの実行

Web フォームアプリケーションとしてチュートリアルを実行する準備ができました。このレッスンでは、1 つのアプリケーションセッションは PowerBuilder から開始し、もう 1 つのセッションは Web ブラウザのアドレスボックスにアプリケーション URL を入力して開始します。

1 必要であれば、手動で EAS Demo DB V120 データベースを開始します。

ASP.NET ユーザにデータベースとデータベースエンジンのディレクトリに対してフルコントロールの権限を設定してある場合（112ページの「ASP.NET ユーザに重要なディレクトリとファイルへのフルコントロールを付与する」にて説明）は、データベースを手動で開始する必要はありません。

手動によるデータベースの開始

手動でデータベースを開始するには、 Windows の［スタート］メニューから［プログラム｜ Sybase ｜ PowerBuilder 12.5 ｜デモデータベース］を選択します。

2 PowerBuilder のシステムツリーで p_pbtutor_webform プロジェクトを右クリックし、ポップアップメニューから［実行］を選択します。

プロジェクトペインタで p_pbtutor_webform プロジェクトを開いたままにすると、プロジェクトペインタメニューから［デザイン｜プロジェクトの実行］を選択したり、システムツリーのポップアップメニューを使用するかわりにペインタバーで［プロジェクトの実行］ボタンをクリックしたりできます。PowerBuilder ペインタで何かしらのプロジェクトオブジェクトを開いている間は、システムツリーのポップアップメニューからプロジェクトを開くことはできません。



チュートリアルアプリケーションへのウェルカムウィンドウ（ログイン画面）が、Web ブラウザで開かれます。 PowerBuilder 設計環境からアプリケーションを実行した場合、ブラウザのメニューとツールバーが表示されません。

3 Windows の［スタート］メニューまたはタスクバーから、 2 つ目の Internet Explorer （IE）ブラウザを開きます。

もう 1 台コンピュータを使用できる場合は、別のコンピュータ上でブラウザを開いてもかまいません。次に、チュートリアルアプリケーション用に 2 つ目のセッションを開始します。

4 IE のアドレスボックスに「http://serverName/pbtutor/default.aspx」を入力します。 serverName は、チュートリアルアプリケーションを配布した IIS サーバの名前です。

IIS サーバマシン上で Web ブラウザを開いて、「localhost」にアプリケーションを配布した場合、ブラウザのアドレスボックスでサーバ名として localhost を使用できます。 Web ブラウザからアプリケーションを開始して、 default.aspx 開始ページが含まれている場合は、Web フォームアプリケーションがブラウザウィンドウで表示されたときに、ブラウザのメニューとツールバーは表示されたままになります。

5 ユーザ ID に「dba」、パスワードに「sql」と入力し、［OK］をクリックします。

ログインの成功後、チュートリアルアプリケーションのフレームウィンドウが、 Web ブラウザに表示されます。

6 フレームウィンドウメニューから［ファイル｜レポート｜顧客情報］を選択します。

顧客情報シートウィンドウが表示されます。このページのマスタデータウィンドウは、 Numeric スタイルのページナビゲーションコントロールを使用します。ほかのページに移動するには、番号をクリックします。 IIS マネージャで PBDataWindowRowsPerPageプロパティを変更していないため、データウィンドウの 1 ページあたりに表示される行数は 20 です。



フレームウィンドウとシートウィンドウのツールバーは、別々に表示されます。

7 フレームウィンドウメニューから［ファイル｜レポート｜商品管理］を選択します。

商品管理シートウィンドウが表示されます。シートウィンドウは、独立したカスケードウィンドウではなくタブページ形式で表示されます。

データウィンドウコントロールに 20 行（グローバル PBDataWindowRowsPerPage プロパティで設定した値）以上のデータがなく、 1 ページで表示できるため、商品管理ページ上にページナビゲーションコントロールは表示されません。



以下の図は、クラシック Web 表示形式を使用したタブページ形式です。

8 チュートリアルのテストを継続するか、アプリケーションのフレームウィンドウメニューから［ファイル｜終了］を選択します。

PowerBuilder 本来のチュートリアルアプリケーションから行うのと同じように、チュートリアル Web フォームアプリケーションからデータベース項目の挿入、更新、削除を行えます。

現在の Web フォームセッションを終了した後、PBDataWindowPageNavigatorType のほかにもグローバルプロパティを変更したくなるかもしれません。たとえば、ファイルマネージャとメールプロファイルマネージャを検証するには、グローバルプロパティの PBFileManager と PBMailManager に true を設定します。

ファイルマネージャやメールプロファイルマネージャを含むWeb フォームターゲットについての詳細は、『アプリケーションとコンポーネントの .NET への配布』マニュアルを参照してください。



第 4 部 Windows フォームアプリケーションの構築

第 4 部は、 .NET Windows フォームターゲットの使用方法を示したチュートリアルです。クライアントサーバアプリケーションを Windows フォームアプリケーションに変換する方法を手順を追って説明します。


レッスン 1 3 PowerBuilder チュートリアルの Windows フォームアプリケーションへの変換

このチュートリアルでは、 PowerBuilder チュートリアルアプリケーションを Windows フォームアプリケーションに変換する方法を説明します。開発コンピュータ上には、 Microsoft .NET Framework、.NET Framework SDK、および IIS サーバをインストール済みであると想定しています。 IIS サーバは、インテリジェント更新の中央サーバとして使用します。ほかのコンピュータを使用して、Windows フォームアプリケーションを実行できます。

このチュートリアルでは、以下のことを行います。

• PowerBuilder でのチュートリアルの実行

• Solutions ディレクトリへのリソースファイルのコピー

• .NET Windows フォームターゲットおよびプロジェクトの作成

• Windows フォームターゲットの配布と実行

• Web ブラウザへのアプリケーションの発行

• Web ブラウザからのアプリケーションのインストールと実行

• ほかのコンピュータへのアプリケーションのインストール

• アプリケーションの更新

所要時間

約 40 分




現在の学習個所> PowerBuilder でのチュートリアルの実行

Solutions ディレクトリへのリソースファイルのコピー.NET Windows フォームターゲットおよびプロジェクトの作成Windows フォームターゲットの配布と実行Web ブラウザへのアプリケーションの発行Web ブラウザからのアプリケーションのインストールと実行ほかのコンピュータへのアプリケーションのインストールアプリケーションの更新

PowerBuilder チュートリアルアプリケーションを Windows フォームアプリケーションとして配布する前に、 PowerBuilder 開発環境でアプリケーションを正常に実行できるかどうかを確認します。完成したチュートリアルアプリケーションは、 PowerBuilder インストールフォルダにあります。

正常にチュートリアルアプリケーションを実行させるには、 SQLAnywhere ソフトウェアをインストールし、EAS Demo DB V125 データベースに接続できるようにする必要があります。

1 Windows の［スタート］メニューから［プログラム｜ Sybase ｜PowerBuilder 12.5 ｜ PowerBuilder 12.5］を選択します。

2 ［ファイル］メニューから［ワークスペースを開く］を選択します。

3 My Documents\Sybase\PowerBuilder 12.5\Tutorial\Solutions フォルダに移動し、 MyWorkspace.pbw を選択して［開く］をクリックします。

PowerBuilder で、 pbtutor.pbt アプリケーションターゲットを含むワークスペースが開きます。このターゲットには、 2 つのライブラリファイル（pbtutor.pbl と tutor_pb.pbl）があり、チュートリアルアプリケーションで使用されるすべてのオブジェクトが含まれています。


チュートリアルアプリケーションのログインウィンドウが表示されます。

レッスン 13 PowerBuilder チュートリアルの Windows フォームアプリケーションへの変換



チュートリアル用のメニューとツールバー付きの MDI フレームウィンドウが表示されます。

6 メニューとツールバー項目が動作することを確認し、アプリケーションを終了します。

たとえば、［ファイル｜レポート｜顧客情報］を選択し、ツールバーアイコンか［編集］メニュー項目を使用して新規顧客を挿入してデータベースを更新してから、顧客情報レポートの新しいインスタンスを開いて、追加した新しい行を確認します。

Solutions ディレクトリへのリソースファイルのコピー


Solutions ディレクトリへのリソースファイルのコピー

現在の学習個所PowerBuilder でのチュートリアルの実行

> Solutions ディレクトリへのリソースファイルのコピー.NET Windows フォームターゲットおよびプロジェクトの作成Windows フォームターゲットの配布と実行Web ブラウザへのアプリケーションの発行Web ブラウザからのアプリケーションのインストールと実行ほかのコンピュータへのアプリケーションのインストールアプリケーションの更新

PowerBuilder .NET Windows フォームアプリケーションターゲットウィザードでは、既存のターゲットのライブラリリストおよびアプリケーションオブジェクトを現行ワークスペースで再利用して、新しいWindows フォームターゲットを作成できます。

ウィザードでは、アプリケーションとともに配布する必要があるリソースファイルをどれでも選択できますが、必要なリソースファイルは、アプリケーションを作成するディレクトリ内に配置する必要があります。3 つのイメージファイルを Tutorial ディレクトリから Solutionsディレクトリにコピーし、 w_welcome ウィンドウでビットマップのパスを変更します。

1 ファイルエクスプローラで、Tutorial ディレクトリ内の tshirtw.jpg、tutorial.ico、および tutsport.bmp を選択してコピーします。

2 ファイルを Tutorial\Solutions ディレクトリにコピーします。

3 PowerBuilder で、 w_welcome ウィンドウを開いてピクチャコントロールを選択します。プロパティビューで、［ピクチャ名］ボックスに「tutsport.bmp」のみが表示されるようにパスを削除します。w_welcome ウィンドウを閉じます。



.NET Windows フォームターゲットおよびプロジェクトの作成

現在の学習個所PowerBuilder でのチュートリアルの実行Solutions ディレクトリへのリソースファイルのコピー

> .NET Windows フォームターゲットおよびプロジェクトの作成Windows フォームターゲットの配布と実行Web ブラウザへのアプリケーションの発行Web ブラウザからのアプリケーションのインストールと実行ほかのコンピュータへのアプリケーションのインストールアプリケーションの更新

ここでは、 .NET Windows フォームアプリケーションターゲットウィザードを使用して、新しい Windows フォームターゲットを作成します。

1 パワーバーの［新規作成］ボタンをクリックし、［ターゲット］タブを選択します。

2 ［.NET Windows フォームアプリケーション］アイコンを選択して、［OK］をクリックします。

ウィザードの初のページには、ウィザードで実行する作業についての情報が表示されます。

3 ［次へ］をクリックします。［アプリケーションの作成］ページで［既存のターゲットからライブラリリストとアプリケーションオブジェクトを使用する］を選択し、［次へ］をクリックします。

4 pbtutor ターゲットを選択し、［次へ］をクリックします。

デフォルトでは、新規ターゲットの名前は「pbtutor_winform.pbt」になります。

5 デフォルトのターゲット名を使用する場合は、［次へ］をクリックします。

6 ［プロジェクト情報の指定］ページで、デフォルトのプロジェクト名とライブラリをそのまま使用し、［次へ］をクリックします。

.NET Windows フォームターゲットおよびプロジェクトの作成


7 ［アプリケーションの概要情報を指定］ページで、製品名として「Acme Update」を実行ファイル名として「AcmeUpdate.exe」を指定し、［次へ］をクリックします。

8 ［リソースファイル / ディレクトリの指定］ページで、［ファイルの追加］をクリックして tutsport.bmp、thsirtw.jpg、tutorial.icoを選択し、［開く］をクリックしてから［次へ］をクリックします。

9 ［Win32 ダイナミックライブラリファイルの指定］ページで［次へ］をクリックします。

チュートリアルアプリケーションは外部関数を呼び出さないため、アプリケーションとともに配布する DLL 名を指定する必要はありません。

10 ［スマートクライアントのサポートを指定］ページで、［スマート

クライアントアプリケーションとして発行］チェックボックスをオンにし、［次へ］をクリックします。

11 ［アプリケーションの実行モードの指定］ページで［次へ］をクリックします。

ユーザがブラウザのほかに Windows の［スタート］メニューからもアプリケーションを実行できるようにするデフォルトのオプションを変更せずにそのまま使用します。

12 ［アプリケーションのインストールまたは実行方法を指定］ページで、localhost をコンピュータ名に変更し、pbtutor を acmeupdateに変更して、［次へ］をクリックします。

ほかのコンピュータから発行されたアプリケーションにアクセスする予定がない場合は、ホスト名を localhost のままにすることもできます。これについては、 300 ページの「ほかのコンピュータへのアプリケーションのインストール」で説明しています。

13 ［アプリケーションの自動更新の指定］ページで［次へ］をクリックし、後のページで［完了］をクリックします。

.NET Windows フォームアプリケーションウィザードは、pbtutor_winform ターゲットと p_pbtutor_winform プロジェクトを作成します。 MyWorkspace には、 pbtutor.pbl と tutor_pb.pbl の両方を使用した 2 つのターゲットがあります。



14 システムツリーの pbtutor ターゲットと pbtutor_winform ターゲットの両方の pbtutor.pbl を展開し、表示されたプロジェクトオブジェクトを確認します。

既存ターゲットのライブラリリストとアプリケーションオブジェクトを使用して Windows フォームプロジェクトを作成すると、ライブラリは両方のターゲットで共有されますが、システムツリーには適切なターゲット種類のプロジェクトのみが表示されます。 pbtutor ターゲットには、 p_pbtutor_exe があります。pbtutor_winform ターゲットには、 p_pbtutor_winform があります。

15 pbtutor ターゲットを折りたたみ、 pbtutor_winform ターゲットは展開したままにします。

Windows フォームターゲットの配布と実行


Windows フォームターゲットの配布と実行

現在の学習個所PowerBuilder でのチュートリアルの実行Solutions ディレクトリへのリソースファイルのコピー.NET Windows フォームターゲットおよびプロジェクトの作成

> Windows フォームターゲットの配布と実行Web ブラウザへのアプリケーションの発行Web ブラウザからのアプリケーションのインストールと実行ほかのコンピュータへのアプリケーションのインストールアプリケーションの更新

アプリケーションをスマートクライアントアプリケーションとして発行する前に、正常に作成されていることを確認するためにローカルディレクトリに配布し、配布した実行ファイルからアプリケーションを実行して開発環境と同じように動作するかどうかを確認します。

1 システムツリーの p_pbtutor_winform プロジェクトをダブルクリックして、プロジェクトペインタを開きます。

各タブページを選択すると、ペインタのみで設定できるオプション（ウィザードでは設定できなかった）があることがわかります。ここでは、ウィザードで設定したデフォルト値を使用します。

2 プロジェクトペインタのメニューから［デザイン｜プロジェクトの配布］を選択するか、またはペインタバーで［配布］ボタンをクリックします。

［配布］ボタンをクリックすると、アプリケーションが構築され、プロジェクトペインタの［全般］ページの［出力パス］フィールドで指定したローカルディレクトリに配布されます。

出力ウィンドウの［デフォルト］タブページに成功したことを示すメッセージが表示され、サポートされない機能が新しいタブに表示されます。ToolbarHighlightColor などの一部のメニュープロパティは、 Windows フォームではサポートされません。



トラブルシューティング

アプリケーションの配布に失敗した場合、コンピュータに .NETFramework SDK がインストールされていることと、bin ディレクトリがシステム PATH 環境変数にあるかどうかを確認してください。

構文エラー「予期しないトークン : '行 4:8' 予期しないトークン : -」が表示された場合は、メニューペインタで m_my_sheet を開き、PowerBuilder のメニューから［デザイン｜オプション］を選択し、オプションダイアログボックスの［スクリプト］タブページにある［識別子にハイフンを使用］チェックボックスをオンにします。

トラブルシューティングのヒントについては、『アプリケーションとコンポーネントの .NET への配布』マニュアルの「デバッグとトラブルシューティング」の章を参照してください。

3 プロジェクトペインタのメニューから［デザイン｜プロジェクトの実行］を選択するか、またはペインタバーで［プロジェクトの実行］ボタンをクリックします。

pbtutor_winform_WinFormOutput ディレクトリ内の AcmeUpdate.exeファイルが実行され、ウェルカムウィンドウが表示されます。


Windows タスクバーのアプリケーションのアイコンが Windowsフォームアプリケーションを示していることに注意してください。

5 開発環境で行っていたようにアプリケーションを実行し、データベース操作をいくつかテストします。

テストが終了したらアプリケーションを閉じます。次は、アプリケーションを Web サーバに発行し、発行ページからそのアプリケーションをインストールします。

Web ブラウザへのアプリケーションの発行


Web ブラウザへのアプリケーションの発行

現在の学習個所PowerBuilder でのチュートリアルの実行Solutions ディレクトリへのリソースファイルのコピー.NET Windows フォームターゲットおよびプロジェクトの作成Windows フォームターゲットの配布と実行

> Web ブラウザへのアプリケーションの発行Web ブラウザからのアプリケーションのインストールと実行ほかのコンピュータへのアプリケーションのインストールアプリケーションの更新

次に、インテリジェント更新テクノロジを使用して、アプリケーションを発行します。

1 p_pbtutor_winform プロジェクトをまだ開いていない場合は、開きます。

2 ［バージョン］ページで、会社名に「Acme, Inc.」を入力します。

製品名と会社名が発行ページと Windows の［スタート］メニューに表示されます。

3 ［発行］ページと［インストール / 更新］ページのオプションを調べます。

アプリケーションは、コンピュータ上で Web サイトに発行されます。 publish.htm という名前の発行ページが生成され、アプリケーションをコンピュータにインストールできるようにアプリケーションが発行されるときにそのページが開かれます。アプリケーションに変更を加えて再発行すると、自動的にリビジョン番号が増えます。

［インストール / 更新］ページのデフォルト設定では、インターネットやイントラネットに接続しているかどうかにかかわらず、アプリケーションをコンピュータの［スタート］メニューから実行できるようにアプリケーションがインストールされます。アプリケーションは、起動前に発行 Web サイト上の更新をチェックします。



4 ［通知］ページで、［デフォルト通知アイコンを使用］チェックボックスをオフにし、 Tutorial\Solutions ディレクトリを参照してtutorial.ico を選択します。

アプリケーションの実行中は、Windows タスクバーの通知領域に、チュートリアルアイコンが表示されます。更新のチェック中に表示されるウィンドウの背景画像としてほかのイメージを指定することもできます。

5 ［必須コンポーネント］ページで、Microsoft .NET Framework と SybasePowerBuilder .NET ランタイムを選択します。

Microsoft .NET Framework がインストールされていないコンピュータにアプリケーションをインストールする必要がある場合は、そのパッケージが Microsoft .NET Framework をインストールするように修正する必要があります。詳細については、『アプリケーションとコンポーネントの .NET への配布』マニュアルの「インテリジェント配布と更新」の章を参照してください。

6 プロジェクトを保存し、［デザイン｜アプリケーションの発行］を選択するか、ペインタバーの［アプリケーションの発行］ボタンをクリックします。

PowerBuilder はプロジェクトを再配布し、ローカルコンピュータの Web サーバ（一般的には、C:\Inetpub\wwwroot\AcmeUpdate）にアプリケーションを発行します。さらに、ブラウザが開き、アプリケーションとアプリケーションの必須コンポーネントをインストールすることができる publish.htm ページが表示されます。

トラブルシューティング

発行に失敗した場合は、『アプリケーションとコンポーネントの.NET への配布』マニュアルの「デバッグとトラブルシューティング」の章を参照してください。

Web ブラウザからのアプリケーションのインストールと実行



現在の学習個所PowerBuilder でのチュートリアルの実行Solutions ディレクトリへのリソースファイルのコピー.NET Windows フォームターゲットおよびプロジェクトの作成Windows フォームターゲットの配布と実行Web ブラウザへのアプリケーションの発行

> Web ブラウザからのアプリケーションのインストールと実行ほかのコンピュータへのアプリケーションのインストールアプリケーションの更新

次に、 Web ブラウザからコンピュータにアプリケーションをインストールして実行します。



1 publish.htm ページで、必要なソフトウェアをインストールするリンク部分をクリックします。

2 ファイルのダウンロードダイアログボックスやそのほかのダイアログボックスに表示される［実行］ボタンをクリックします。

表示されるダイアログボックスは、セキュリティの設定に依存します。



Acme Update をインストールダイアログボックスが表示されます。Microsoft .NET Framework は、コンピュータにすでにインストールされているため、このダイアログボックスには表示されません。［追加設定］ボタンをクリックすると、コンポーネント一覧にアプリケーションが必要とするすべてのコンポーネントが表示されます。

ランタイムライブラリパッケージがインストール済みの場合

Sybase PowerBuilder .NET ランタイムパッケージがすでにコンピュータにインストールされている場合は、コンポーネント一覧でこのパッケージのチェックボックスをオフにしてから［OK］をクリックします。

3 Acme Update のインストールダイアログボックスの［インストール］ボタンをクリックします。

Sybase PowerBuilder .NET ランタイムと Acme Update アプリケーションがコンピュータにインストールされます。ダイアログボックスに表示される指示に従い、インストールが完了したら AcmeUpdate のインストールダイアログボックスが閉じられます。

ポップアップで「アプリケーションの起動」ウィンドウが表示され、 Acme Update アプリケーションが開かれ、 AcmeUpdate というラベルが付いたアイコンがタスクバーの通知領域に表示されます。




5 アプリケーションが正常に動作することを確認するためのテストを行います。

開発コンピュータ上の IIS サーバにほかのコンピュータがアクセスできる場合、そのコンピュータを使用してクライアントコンピュータ上でインストールのテストを行うことができます。これについては、次の練習で説明しています。次の練習に取り組む場合、開発コンピュータ上のアプリケーションを閉じます。開発コンピュータで更新プロパティのテストを行う場合、アプリケーションを開いたまま、 302 ページの「アプリケーションの更新」に進みます。

ほかのコンピュータへのアプリケーションのインストール


ほかのコンピュータへのアプリケーションのインストール

現在の学習個所PowerBuilder でのチュートリアルの実行Solutions ディレクトリへのリソースファイルのコピー.NET Windows フォームターゲットおよびプロジェクトの作成Windows フォームターゲットの配布と実行Web ブラウザへのアプリケーションの発行Web ブラウザからのアプリケーションのインストールと実行

> ほかのコンピュータへのアプリケーションのインストールアプリケーションの更新

Web ページ http://hostname/acmeupdate/publish.htm （hostname は開発コンピュータ名）からクライアントコンピュータにアプリケーションをインストールできます。クライアントコンピュータは、開発コンピュータにアクセスできなければなりません。

1 クライアントコンピュータで、サーバ上の easdemodb120.db に接続する EAS Demo DB V125 という名前の ODBC システム DSN を作成します。

2 Internet Explorer を開き、アプリケーションの発行ページ http://hostname/acmeupdate/publish.htm （hostname は開発コンピュータ名）に移動します。

3 前の練習で行ったのと同様に、インストールのリンク部分をクリックし、ウィンドウの［実行］ボタンをクリックします。

4 Acme Update のインストールダイアログボックスの［インストール］ボタンをクリックします。

Sybase PowerBuilder .NET ランタイムと Acme Update アプリケーションがコンピュータにインストールされます。ダイアログボックスに表示される指示に従い、インストールが完了してアプリケーションが開かれたら、 Acme Update インストールダイアログボックスが閉じられます。


6 アプリケーションが正常に動作することを確認するためのテストを行います。



7 Acme Update 通知アイコンを右クリックし、使用可能な各メニュー項目を試します。

［更新プログラムの確認］を選択した場合、利用可能な更新がないことを示すポップアップウィンドウが表示されます。次は、アプリケーションの細部を変更してインテリジェント更新をテストします。

アプリケーションの更新



現在の学習個所PowerBuilder でのチュートリアルの実行Solutions ディレクトリへのリソースファイルのコピー.NET Windows フォームターゲットおよびプロジェクトの作成Windows フォームターゲットの配布と実行Web ブラウザへのアプリケーションの発行Web ブラウザからのアプリケーションのインストールと実行ほかのコンピュータへのアプリケーションのインストール

> アプリケーションの更新

ここでは、アプリケーションの背景色を変更し、サーバに再発行してから、通知機能のテストを行います。

1 開発コンピュータで、 w_pbtutor_basesheet を開き、背景色プロパティを「白」から使用したい色に変更し、保存してウィンドウを閉じます。

2 ［デザイン｜プロジェクトの配布］を選択するか、またはペインタバーの［配布］ボタンをクリックします。

PowerBuilder がアプリケーションを構築して配布します。

3 ［デザイン｜アプリケーションの発行］を選択するか、またはペインタバーの［アプリケーションの発行］ボタンをクリックします。

PowerBuilder が更新されたアプリケーションを発行します。Inetpub\wwwroot\acmeupdate フォルダを確認すると、 1.0.0.0 および 1.0.0.1 サブディレクトリがあります。

Windows の［スタート］メニューからアプリケーションを開始する

アプリケーションを実行していない場合は、［スタート］メニューから［すべてのプログラム｜ Acme, Inc. ｜ Acme Update］を選択します。利用可能更新プログラムダイアログボックスに、新しいバージョンの Acme Update が利用可能であるという知らせが表示されます。新しいバージョンをダウンロードしたり、［スキップ］をクリックして古いバージョンを実行したりすることができます。ここでは［スキップ］をクリックし、この練習の次の手順に進みます。



4 開発コンピュータかクライアントコンピュータで、 Acme Update通知アイコンを右クリックし、［更新ファイルを確認］を選択します。

ポップアップウィンドウに、新しいバージョンの Acme Update がサーバにあるという知らせが表示されます。

5 Acme Update 通知アイコンを再度右クリックし、［更新プログラムを取得］を選択します。

アプリケーションの更新版がダウンロードされます。

6 Acme Update 通知アイコンを再度右クリックし、［新しいバージョンで再開始］を選択します。

ウェルカムウィンドウが開きます。

7 ログイン情報を入力して［OK］をクリックし、顧客または製品のレポートを開きます。

背景色が指定した色に変更されています。




数字3D がデフォルトウィンドウオプション 75

AASP.NET、ユーザ権限の設定 268

CCHOOSE CASE 文 237Clicked イベント

CommandButton コントロール 124, 126メニュー項目 166

Close イベント、アプリケーションオブジェクト 127

COMMIT 文 146Constructor イベント、ユーザオブジェクト 113

DDBError イベント 142, 145DBParm パラメータ 118DeleteRow 関数 146

EEAS Demo DB データベース

接続 97セットアップ 27

GGetActiveSheet 関数 166

HHALT 文 126

IInsertRow 関数 146

MMDI アプリケーション 21

N.NET Web フォームチュートリアル 268.NET Windows フォームチュートリアル 285.NET アプリケーション 5.NET アプリケーションの構築 5

OOpen イベント

シートウィンドウ 149フレームウィンドウ 91

PParent （PowerScript 代名詞） 119PBL （PowerBuilder ライブラリ（PBL）を参照）Pcode （擬似コード） 252PowerBuilder ライブラリ（PBL） 19PowerScript 6, 4PowerTips 9ProfileString 関数 114

索引

索引


QQuick Select

使い方 174

RRetrieve 関数

概要 145引数の指定 150

ROLLBACK 文 146RowFocusChanged イベント 148

SSELECT 文 183Select ペインタ

概要 182タブ領域 183

SetFocus 関数 145, 146SetRowFocusIndicator 関数 145SetTransObject 関数 149SQLCA （SQL 通信領域） 111, 149SQL Select データソース 181SQL 構文、 Select ペインタ 183SQL 文

COMMIT 146ROLLBACK 146SELECT 183

SQL ペインタ 181

TThis （PowerScript 代名詞） 149To-Do リスト 108TRY-CATCH 文 237, 240

UUpdate 関数 146

WWHERE 句 184

あアイコン、アプリケーション 43アプリケーション

MDI 21インターネット 5構築 251実行 49定義 12デバッグ 211分散 5

アプリケーションオブジェクトOpen イベント 56アイコン 43, 46定義 12

アンパサンド、メニュー項目のアクセラレータキー 155

いイベント

Clicked 122, 166Close 127Constructor 113, 240DBError 142LoseFocus 240RowFocusChanged 148概要 4追加 237メニュースクリプトからの発生 166

うウィザード

接続オブジェクト 107データウィンドウ 173プロジェクト 253

索引


ウィンドウ応答 70概要 13コマンドボタンコントロール 83コントロールの削除 76サイズ 46作成 70スタティックテキストコントロール 78先祖 131タブ順序 85データウィンドウコントロール 134ピクチャコントロール 76プレビュー 89保存 70

ウィンドウペインタ、コントロールの削除 76

おオートスクリプト

ショートカットの設定 123使い方 124, 144

オブジェクト指向 5

か拡張属性 106, 193カスタムクラスユーザオブジェクト 19関数

DeleteRow 146GetActiveSheet 166InsertRow 146ProfileString 114Reset 146Retrieve 145SetFocus 145, 146SetRowFocusIndicator 145SetTransObject 149Update 146オブジェクトレベル 17概要 4グローバル 17追加 237

くクエリ 17クリップウィンドウ 7グローバル

関数 17構造体 18変数 115

グローバル変数の宣言 115

け継承

ウィンドウ 131オブジェクト指向プログラミング 5メニュー 159ユーザオブジェクト 134

検索引数WHERE 句 184作成 183

こ構造体 17コメント

ウィンドウ 73スクリプトビュー 94データウィンドウ 178, 189メニュー 160

コントロールコマンドボタン 83削除 76スタティックテキスト 78ピクチャ 76複製 78プロパティの指定 79, 82, 84

コントロールの削除 76

しシートウィンドウ、メニュー 159システムツリー 7

索引


実行ファイルアプリケーションアイコン 43, 46オブジェクトの再生成 256マシンコードの生成 252

出力ウィンドウ 7状況依存ヘルプの追加 87初期設定ファイル

odbc.ini 98pb.ini 102pbtutor.ini 114

す垂直スクロールバー 139スクリプト

エラーウィンドウ 96オートスクリプトの使い方 124, 144オートスクリプト用のショートカットの設定

123概要 4コンパイル 96ユーザイベント 143

スクリプトビューエラーウィンドウ 96形式を指定して貼り付けコマンド 122コメントの使用 94説明 87プロトタイプ 145

スクロールバー、垂直 139スタイルバー 9

せ接続サービスマネージャ 107先祖ウィンドウ 131

たターゲット 6代名詞、 PowerScript

Parent 119, 120

This 149タブ順序 85タブラ提示様式 174

ちチュートリアル

初期設定ファイル 114セットアップ 28ファイル 28

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

つツールバー

実行時のアプリケーション 164テキストの表示 65

て提示様式

タブラ 174データウィンドウオブジェクト 174, 181フリーフォーム 181

データウィンドウオブジェクトQuick Select でのカラムの選択 174WHERE 句 184概要 14, 171拡張 190カラムの再配置 190カラムの整列 191検索引数 183作成 174, 181提示様式 174, 181データウィンドウコントロールへのアタッチ

196, 199, 205データソース 174, 181表示順序 175保存 178, 188

データウィンドウオブジェクトでのカラムの整列 191

索引


データウィンドウオブジェクトのカラム再配置 190整列 191

データウィンドウオブジェクトのサマリー区域 172

データウィンドウオブジェクトの詳細区域 172データウィンドウオブジェクトのフッタ区域

172データウィンドウオブジェクトのヘッダ区域

172, 176データウィンドウコントロール 134データウィンドウデータ式 150データウィンドウペインタ

WHERE 句 184区域 172検索引数 183

データソースQuick Select 174SQL Select 181

データベース拡張属性 106実行時の接続 111接続 5データの検索、表示および操作 14表定義 102

データベース接続概要 5, 98トランザクションオブジェクト 111

データベースプロファイル 98データベースペインタの使い方 102デバッグ

ウォッチの設定 223概要 211コードのステップ実行 217デバッグモードでの実行 217ブレークポイントの追加 212

とトランザクションオブジェクト 111, 149ドロップダウンデータウィンドウ編集様式 193ドロップダウンメニュー

項目の追加 154

説明 17

は背景色、ウィンドウ 71パワーバー 8

ひビジュアルユーザオブジェクト 18非ビジュアルユーザオブジェクト 19ビュー

固定 61スタック 61操作 58タイトルバーの固定 60浮動 61レイアウトの保存 62

ビューの固定 61ビューの種類

HTML プレビュー（データウィンドウペイン

タ） 177Syntax （Select ペインタ） 183オブジェクト（データベースペインタ） 102オブジェクトの詳細（データベースペインタ）

105オブジェクトレイアウト（データベースペイ

ンタ） 104スクリプト 87テーブルレイアウト（Select ペインタ） 182デザイン（データウィンドウペインタ） 172プレビュー（データウィンドウペインタ）

177プレビュー（メニューペインタ） 154プロパティ 71レイアウト 71

標準クラスユーザオブジェクト 19

索引


ふ浮動

ツールバー 65ビュー 61

フリーフォーム提示様式カラム 190データウィンドウ定義 181

ブレークポイント 212フレームウィンドウ 91プロジェクトウィザード 253

へペインタ 7ペインタバー

コントロールの追加 74使い方 9ポップアップメニュー 65

ヘルプ状況依存メッセージ 87マイクロヘルプ 162

編集様式、ドロップダウンデータウィンドウ 193変数

gnv_connect 115インスタンス 115グローバル 115命名規約 115

ほポップアップメニュー

概要 65ペインタバー 65

まマイクロヘルプ 162マウスの右ボタン、ポップアップメニュー 65マシンコード 252マネージャ、接続サービス 107

めメインウィンドウのサイズ 46メニュー

概要 16継承 159作成 159スクリプトの追加 166ツールバー 156, 164バー 16保存 160メニュー項目 154

メニューペインタの使い方 154

ゆユーザイベント

スクリプトの追加 143定義 143メニュースクリプトからの発生 166

ユーザオブジェクト概要 18使い方 134

らライブラリ

アプリケーションの探索パス 132オブジェクトの再構築 152概要 19動的 252

れ例外

送出 237捕捉 240ユーザ定義 235

索引


わワークスペース 6

索引


PowerBuilder 入門 · 目次 vi PowerBuilder Classic ラベルとカラムの整列..... 191 ドロップダウン データウィンドウ編集スタイルの

Documents

PowerBuilder 入門 · 目次 vi PowerBuilder Classic ラベルとカラムの整列..... 191 ドロップダウンデータウィンドウ編集スタイルの