第４回 ウィンドウに直接描画する

ビューを言葉で説明すると、ウィンドウ内の描画全般と
ユーザーとの対話を受け持つ部門であると言えます。
今回のプログラムでは文字を描画していますが、
BViewの描画機能として(カッコ内はメンバ関数名)

• 長方形の描画 (StrokeRect,FillRect)
• 三角形の描画 (StrokeTriangle,FillTriangle)
• 楕円の描画(StrokeEllipse,FillEllipse)
• 線の描画(StrokeLine)
• 弧の描画(StrokeArc,FillArc)
• 色の反転(InvertRect)
• ビットマップの描画(DrawBitmap)
• 文字の描画(DrawString,DrawChar)

が挙げられます。また、ユーザーとの対話機能として、

• キー入力受け取り(KeyUp,KeyDown)
• マウスの状態取得(GetMouse,MouseUp,MouseDown,MouseMoved等)

があります。今回は文字描画のみですが、基本的な使い方はわかると思います。

今回のサンプルソースです。
前回同様、重要な部分は強調してあります。

// sample03.cpp

#include <Application.h> // BApplicationを使うために必要
#include <Window.h>      // BWindowを使うために必要
#include <Rect.h>        // BRectを使うために必要
#include <View.h>        // BViewを使うために必要

// クラスの前方宣言
class MyApp;
class MyWindow;
class MyView;

class MyApp : public BApplication
{
public:
	MyApp();
private:
	MyWindow* m_win;
};

class MyWindow : public BWindow
{
public:
	MyWindow(BRect frame,const char* title,window_type type,uint32 flags);
	virtual bool QuitRequested();	// 終了が要求されたときに呼ばれる関数
private:
	MyView* m_view;
};

class MyView : public BView
{
public:
	MyView(BRect frame,const char *name,uint32 resizingMode,uint32 flags);
	virtual void Draw(BRect updateRect);  // 再描画要求の時に呼ばれる関数
};

MyApp::MyApp()
      :BApplication("application/x-vnd.big56-MyApp")
{
	m_win = new MyWindow(BRect(100,100,300,150),"BViewのテスト",B_DOCUMENT_WINDOW,0);
	m_win->Show();
}

MyWindow::MyWindow(BRect frame,const char* title,window_type type,uint32 flags)
		:BWindow(frame,title,type,flags)
{
	frame.OffsetTo(0,0);  // 与えられたBRectの左上が(0,0)になるようにする

	m_view = new MyView(frame,"theView",B_FOLLOW_NONE,B_WILL_DRAW);
	AddChild(m_view);
}

bool MyWindow::QuitRequested()
{
// アプリケーションを終了する
	be_app->PostMessage(B_QUIT_REQUESTED);
	return true;
}

MyView::MyView(BRect frame,const char* title,uint32 resizingMode,uint32 flags)
	  :BView(frame,title,resizingMode,flags)
{
	SetViewColor(200,200,200);  // ビューの背景色を設定する
	SetFontSize(20);            // フォントサイズを設定する
}

void MyView::Draw(BRect updateRect)
{
	MovePenTo(20,20);
	DrawString("Hello BView!");
}

int main(int argc,char** argv)
{
 	MyApp app;
	app.Run();
	return 0;
}

今回のプログラムの実行結果は次のようになります。

MyWindowのコンストラクタから見てみましょう。

MyWindow::MyWindow(BRect frame,const char* title,window_type type,uint32 flags)
		:BWindow(frame,title,type,flags)
{
	frame.OffsetTo(0,0);  // 与えられたBRectの左上が(0,0)になるようにする

	m_view = new MyView(frame,"theView",B_FOLLOW_NONE,B_WILL_DRAW);
	AddChild(m_view);	
}

まず、frame.OffsetTo(0,0);ですが、これは、BRectの矩形の座標を大きさを変えずに左上を(0,0)にスライドしています。
今回は、ウィンドウの座標を(100,100,300,150)に指定していますが、
この操作をすると、(0,0,200,50)という矩形の座標になります。

なぜこのようなことをするかというと、ビューの占める面積をウィンドウ全体にしたいからです。
ビューを作成するときに、デスクトップの座標ではなく、ウィンドウ内の座標で指定する必要があるため
矩形の左上の点を(0,0)にしているのです。

次にビューのインスタンスをnewで作成して、AddChild()関数でビューをウィンドウの子供として登録します。

ウィンドウとビューの関係、またはビューとビューの関係はフォルダ階層に似ています。
ウィンドウはルートディレクトリ(ドライブのいちばん上のこと)、ビューはフォルダと考えてください。
「子供として登録する」とは、フォルダを掘るのに似ています。
ウィンドウが複数のビュー(ルートディレクトリに複数のフォルダがある)を持ったり、
ウィンドウの子供のビューが、さらに子供にビューを持つ(フォルダの下にさらにフォルダを掘る)こともあります。

「ビューを複数持つことに意味があるのか？」と考える人もいると思いますが、
今後紹介する、ウィンドウのボタン(BButtonクラス)とかチェックボックス(BCheckBoxクラス)は
すべてビューの一部です(BViewクラスから派生している)。
ウィンドウが複数のボタンや複数のチェックボックスを持つ必要があるときに
AddChild()メンバ関数を複数呼んで、ウィンドウは子供のビューを複数持つことになります。

さて、BViewのコンストラクタについての説明をします。

MyView::MyView(BRect frame,const char* title,uint32 resizingMode,uint32 flags)
	  :BView(frame,title,resizingMode,flags)
{
	SetViewColor(200,200,200);  // ビューの背景色を設定する
	SetFontSize(20);            // フォントサイズを設定する
}

BViewのもともとのコンストラクタの引数並びは次のようになっています。

BView(BRect frame,const char* name,uint32 resizingMode,uint32 flags);

BViewでは

• ビューの大きさ(frame)
• ビューの名前(name)
• 親のウィンドウがリサイズされたときの追従する方法(resizingMode)
• その他のフラグ(flags)

ビューの名前は直接表示されることはありませんが、プログラム的にビューを識別するのに使います。
今回はビューの名前を利用していません。

resizingModeには次の定数を指定することが出来ます。

flagsには次の定数を指定できます。

ということらしいです(実は筆者も全部ためしていない)。

その次のSetViewColorメンバ関数でビュー全体の色を設定します。
SetViewColor()関数の宣言は次のようになっています。

void BView::SetViewColor(rgb_color color);
void BView::SetViewColor(uchar red,uchar green,uchar blue,uchar alpha=0);

rgb_color構造体は、パラメータにredとgreenとblueとalphaという変数名を持つ単純な構造体です。
rgb_color構造体を使用しないほうのSetViewColor関数では、
第１引数に赤成分、第２引数に緑成分、第３引数に青成分、第４引数にアルファ成分(透明度)を指定することによって、
ビューの色を指定します。

SetFontSizeでは描画に使用するフォントの大きさを指定します。
ここの引数を変えると「Hello BView!」の大きさも変化します。

さて、再描画要求にはDrawメンバ関数内で応じるわけですが、この部分のコードの解説をしましょう。

void MyView::Draw(BRect updateRect)
{
	MovePenTo(20,20);
	DrawString("Hello BView!");
}

Draw()メンバ関数の引数には、更新すべき領域の矩形が渡されます。
多くの領域を描画するようなアプリケーションなら、この部分の矩形領域を利用して
必要な所だけ描画するようにするべきでしょうが、今回はこの引数を無視してビュー全体を更新しています。

DrawString()メンバ関数で実際に文字を書いていますが、DrawStringの書き始めの位置は「ペン」と呼ばれるものの座標から始まります。
ペンの座標はMovePenTo()で指定します。
MovePenTo()関数は以下のように宣言されています。

void BView::MovePenTo(BPoint point);
void BView::MovePenTo(float x,float y);

Draw()関数以外の部分でDrawStringをすると、ほかのウィンドウをかぶせた時に
「Hello BView!」の文字が消えてしまいます。
これは、再描画の必要があるのに文字を描画していないからです。
ビューに対して描画するには、Draw()関数内で描画するのが定石です。

今回のソースについての説明は以上ですが、いかがでしたでしょうか？
ビューはBeOSプログラムにおいて非常に重要な概念なので、きっちり押さえるようにしてください。

海外旅行保険の加入はコチラ！ あなたの悩み解決します そろそろ結婚適齢期？？？