Microsoft Visual C++ Web Site

初心者のための Microsoft Visual C++

Ranga Narasimhan
Microsoft Corporation

適用対象: Microsoft Visual C++ Version 6.0

Visual C++ について
 Visual C++ AppWizard
コンソールプロジェクトと Windows^® プロジェクト
 ワークスペースとプロジェクト
 Win32^® コンソールアプリケーションの作成
 プロジェクトへのファイルの追加
 ナビゲーション
 コンパイルとリンク
 プロジェクトのクリーニングとコピー
 ビルドエラーのトラブルシューティング
 ワークスペースへの新しいプロジェクトと既存のプロジェクトの追加
 ヒント
 結論
 関連情報

要約: この記事は、C/C++ プログラミングと Visual C++ に初めて接する人のために書かれています。C/C++ プログラミングに関する教則本ではありません。この記事は、読者に Visual C++ 環境を紹介し、以下の作業を行えるようにすることを目的としています。

AppWizard を使って簡単な Win32 コンソールベースのプログラムを作成する。
プロジェクトとワークスペースの構造を理解する。
コンパイラとリンカのエラーのトラブルシューティングを行う。

Visual C++ について

Microsoft Visual C++ 6.0 は、Visual Studio^® 6.0 開発プロダクトファミリーのメンバです。Standard、Professional、および Enterprise の 3 つの Edition があります。詳細については、MSDN ライブラリの "Visual C++ の各 Edition" を参照してください。

Visual C++ には、32 ビットの C/C++ プログラムの作成、ビルド、およびデバッグが行える統合開発環境 (IDE) が用意されています。また、この IDE では、ソースコードのナビゲーションを簡単に行うことができます (詳細については、この記事のナビゲーションのセクションを参照してください)。

Visual C++ AppWizard

Visual C++ には、新しいプログラムの作成をガイドする AppWizard (アプリケーションウィザード) のセットが用意されています。これらの AppWizard では、基本的な設定およびコードが提供されるため、かなりの時間を節約することができます。作成するアプリケーションのタイプに応じて、適切な AppWizard を選択することが重要です。

AppWizard を表示するには

[ファイル] メニューの [新規作成] をクリックします。
[プロジェクト] タブをクリックします。
図 1 のように、AppWizard が表示されます。
リストから、[Win32 Console Application] を選択します。
AppWizard は、コンソールウィンドウでのキャラクタモードサポートを提供しているコンソール API 関数を使用するコンソールプログラムの作成を支援します。

図 1. Win32 Console Application AppWizard
上の画像をクリックすると大きい画像を表示します。
ヒント 詳細については、MSDN ライブラリの "概要: コンソールプログラムの作成" を参照してください。

コンソールプロジェクトと Windows プロジェクト

コンソールプログラムは MS-DOS コマンドプロンプトのもとで実行されることを想定しています。これは 32 ビットプログラムですが、Windows プログラムではありません。C/C++ のコンソールベースプログラムで最初に呼び出される関数は次のものです。

int main(int argc, char *argv[])

Windows ベースのプログラムで最初に呼び出される関数は次のものです。

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)

コンソールアプリケーションは、ダイアログなどのユーザーインターフェイスは表示しません。C/C++ プログラミングの初心者は、コンソールアプリケーションの作成に集中することをお勧めします。

ワークスペースとプロジェクト

Visual C++ は、AppWizard を使って作成されたプログラムを、ワークスペースの中でプロジェクト単位に整理します。つまり、ワークスペースは複数のプロジェクトから構成され、個々のプロジェクトはファイルを含んでいます。プロジェクトはファイルを共有することができます。この構造を次の図に示します。

図 2. Visual C++ におけるワークスペースとプロジェクトの構造

上の図の Sample ワークスペースは、A、B、および C の 3 つのプロジェクトを含んでいます。これらのプロジェクトは、それぞれ a.cpp、b.cpp、および c.cpp の異なる C++ ファイルを含んでいます。これらのファイルは 3 つのプロジェクトの間で共有されています。

ワークスペース情報は.dsw の拡張子を持つファイルに、プロジェクト情報は.dsp の拡張子を持つファイルに格納されています。AppWizard は、デフォルトではワークスペースとプロジェクトを 1 つずつ作成します。ワークスペースに複数のプロジェクトを追加する方法については、後のセクションで説明します。Visual C++ がプロジェクトのために作成する初期ファイルの詳細については、MSDN ライブラリの "Visual C++ プロジェクトに対して作成されるファイルの種類" を参照してください。

ワークスペースを開くには

[ファイル] メニューの [ワークスペースを開く] をクリックします。
.dsw の拡張子を持つワークスペースファイルを探します。

別の方法として、プロジェクトファイル (*.dsp) を開くこともできます。.dsw と.dsp のファイル名拡張子にはシェルエクステンションが関連付けられているので、Windows エクスプローラを使って.dsw または.dsp ファイルを探し、ファイルをダブルクリックすれば、Visual C++ でワークスペースを開くことができます。

Win32 コンソールアプリケーションの作成

以下に、新しいコンソールプロジェクトを作成する手順を示します。

新しいコンソールプロジェクトを作成するには

[ファイル] メニューの [新規作成] をクリックし、[プロジェクト] タブをクリックします。
[Win32 Console Application] をクリックします。
[位置] エディットボックスで、プロジェクトの位置を指定します。
[プロジェクト名] テキストボックスにプロジェクト名を入力します。
[位置] エディットボックスは、ステップ 2 で入力したプロジェクト名の後に円記号 (¥) を追加します。プロジェクトファイルは、[位置] で指定したディレクトリの中のサブディレクトリに格納されます。
図 3 は、C:¥My Programs¥TestProgram ディレクトリの中に作成される、TestProgram という名前の Win32 コンソールプロジェクトを示しています。

図 3. 新しいコンソールプロジェクトの作成
上の画像をクリックすると大きい画像を表示します。
[OK] をクリックします。
[Win32 Console Application - ステップ 1/1] ダイアログボックスが表示されます。
デフォルトの選択項目である [空のプロジェクト] を受け入れて、[終了] をクリックします。
他の選択項目では、いくつかのファイルとその他の設定が作成されます。図 4 を参照してください。

図 4. [Win32 Console Application - ステップ 1/1] ダイアログボックス
上の画像をクリックすると大きい画像を表示します。
Visual C++ 5.0 ユーザーのための注 このダイアログボックスは表示されないので、ステップ 6 は省略してください。デフォルトでは、AppWizard は空のプロジェクトを作成します。
最後の [新規プロジェクト情報] ダイアログボックスに、作成されたプロジェクトの内容と要約が表示されます。[OK] をクリックします。

Visual C++ は、TestProgram プロジェクトの一部として、以下に示すファイルのセットを作成します (これらのファイルは C:¥My Programs¥TestProgram ディレクトリに格納されます)。

TestProgram.DSW: ワークスペースファイル
TestProgram.DSP: プロジェクトファイル
TestProgram.OPT: ワークスペース設定ファイル
TestProgram.NCB: ClassView ファイル (AutoCompletion のための情報も含まれています)

Visual C++ がプロジェクトのために作成する初期ファイルの詳細については、MSDN ライブラリの "Visual C++ プロジェクトに対して作成されるファイルの種類" を参照してください。

注 .dsw および.dsp ファイルは削除しないでください。.opt および.ncb ファイルは、ワークスペースを開いたときに Visual C++ によって再生成されるので、名前の変更や削除を行ってもかまいません。

上記の操作を行うと、空のプロジェクトを含んだワークスペースが作成されます。空のプロジェクトは、ソースファイルを何も含んでいません。プロジェクトとワークスペースの両方が TestProgram という名前になります。空のプロジェクトにファイルを追加するには、次の操作を行います。

空のプロジェクトにファイルを追加するには

[ファイル] メニューの [新規作成] をクリックし、[ファイル] タブをクリックします。
[C++ ソースファイル] をクリックします。
[ファイル名] テキストボックスにファイル名を指定します。デフォルトでは、[プロジェクトへ追加] チェックボックスがオンになっています。また、デフォルトのファイル名拡張子は.cpp です。たとえば、Test と入力すると、ファイル名は Test.cpp になります。.c というファイル名拡張子を与えたい場合には、明示的に指定する必要があります。図 5 を参照してください。

図 5. [新規作成] ダイアログボックス
上の画像をクリックすると大きい画像を表示します。
[OK] をクリックします。
空のファイルに、次のコードを入力します。
#include<stdio.h>
float ver;
void main()
{
ver = 6.0;
printf("Welcome to Visual C++ %.1f¥n",ver);
}
[ビルド] メニューの [ビルド TestProgram.exe] をクリックするか、F7 キーを押します。
これにより、プロジェクト全体のコンパイルとリンクを行うビルドプロセスが開始されます。プロジェクトに複数のファイルが含まれている場合には、そのすべてのファイルがビルドされます。ビルドの進捗状況は、Visual C++ IDE の下部のアウトプットウィンドウに表示されます。このプロジェクトでは、図 6 のような内容が表示されるはずです。

図 6. アウトプットウィンドウ
上の画像をクリックすると大きい画像を表示します。

図 6 の情報は、TestProgram.exe という実行可能ファイルの作成が、エラーや警告なしに成功したということを示しています。プログラムにエラーが含まれている場合には、このウィンドウに適切なメッセージが表示されます。また、"構成: TestProgram - Win32 Debug" という表示もあります。これはデフォルトの構成であり、"Win32 Release" またはカスタム構成に変更することもできます。詳細については、この記事のコンパイルとリンクを参照してください。

開かれているファイルのコンパイルだけを行いたい場合には、[ビルド] メニューの [コンパイル Test.cpp] を選択します。この操作では、実行可能ファイルは生成されません。詳細については、この記事のコンパイルとリンクを参照してください。

TestProgram.exe を実行するには

[ビルド] メニューの [実行 TestProgram.exe] を選択するか、Ctrl+F5 を押します。
MS-DOS プロンプトと、"Welcome to Visual C++ 6.0" というメッセージが表示されます。
適当なキーを押します。

プロジェクトへのファイルの追加

前に述べたように、プロジェクトは.h や.rc といったさまざまな拡張子のファイルをいくつも持つことができます。TestProgram コンソールプロジェクト (「Win32 コンソールアプリケーションの作成」のセクションを参照) にヘッダーファイル (.h) を追加するには、次の操作を行います。

TestProgram コンソールプロジェクトにヘッダーファイル (.h) を追加するには

[ファイル] メニューの [新規作成] をクリックし、[ファイル] タブをクリックします。
[C/C++ ヘッダーファイル] を選択します。
[ファイル名] テキストボックスにファイル名を入力します。
デフォルトのファイル名拡張子は.h です。たとえば、Test と入力すると、ファイル名は Test.h になります。別の拡張子を付けたい場合には、明示的に指定する必要があります。
[OK] をクリックします。
注デフォルトでは [プロジェクトへ追加] チェックボックスがオンになっています。このチェックボックスはオフにしないでください。オフにすると、そのファイルはビルドプロセスの中でビルドされない可能性があります。

既存のファイルを追加するには

Visual C++ で、ファイルを追加したいプロジェクトを開きます。
[プロジェクト] メニューの [プロジェクトへ追加] をクリックします。
[ファイル] をクリックします。
[プロジェクトへファイルを追加] ダイアログボックスで、ファイルを選択し、[OK] をクリックします。

これで、既存のファイルを再利用することができます。コードの再利用は、C++ を強力な言語としている特長の 1 つです。

Visual C++ のワークスペースウィンドウでは、きわめて簡単にナビゲーションを行うことができます。このウィンドウを起動するには、[表示] メニューの [ワークスペース] をクリックします。すでに TestProgram コンソールプロジェクト (「Win32 コンソールアプリケーションの作成」のセクションを参照) を作成している場合には、ワークスペースウィンドウには [ClassView] と [FileView] の 2 つのタブがあります (図 7 を参照)。

図 7. ワークスペースウィンドウ

ClassView

[ClassView] タブには、プロジェクトに含まれている C++ クラスとグローバルデータが表示されます。TestProgram プロジェクトでは、TestProgram クラス と表示されるはずです (図 7 を参照)。+ 記号をクリックすると、ノードが展開され、[グローバル] フォルダが表示されます。このフォルダをクリックすると、main と ver が表示されます。main 関数を含んでいるファイルを見るには、main をダブルクリックします。これにより、main 関数のところにカレットが置かれた状態で、Test.cpp ファイルが開かれます。

ClassView の詳細については、MSDN ライブラリの "概要: ClassView" を参照してください。

FileView

[FileView] タブには、プロジェクトに属しているファイルが表示されます。TestProgram プロジェクトでは、TestProgram ファイルと表示されるようになります。これを (+ 記号をクリックして) 展開すると、[Source Files]、[Header Files]、および [Resource Files] が表示されます。プロジェクトは、[Source Files] フォルダの下に 1 つのファイル (Test.cpp) しか含んでいません。プロジェクトに Test.h という別のファイルを追加すれば、このファイルは [Header Files] フォルダの下に表示されるはずです。これらのフォルダは、それぞれ該当する拡張子を持つファイルを含んでいます。ソースファイルは通常は.c または.cpp のファイル名拡張子を持ち、ヘッダーファイルは.h のファイル名拡張子を持ちます。ファイルをダブルクリックすると、ソースエディタでそのファイルが開かれます (図 8 を参照)。

図 8. [FileView] タブ

FileView の詳細については、MSDN ライブラリの "FileView" を参照してください。

また、ウィザードバーをナビゲーションに使用することもできます。ウィザードバーをアクティブにするには、次の操作を行います。

ウィザードバーをアクティブにするには

[ツール] メニューの [カスタマイズ] をクリックします。
[ツールバー] タブをクリックします。
[ツールバー] ウィンドウで、ダイアログの左側の [ウィザードバー] をクリックします。

詳細については、MSDN ライブラリの "概要: ウィザードバー" を参照してください。

コンパイルとリンク

コンパイルプロセスは、オブジェクト (.obj) ファイルとその他の中間ファイルを作成します。Visual C++ コンパイラの CL.EXE は、すべてのプロジェクトファイルを入力として受け取り、それらに対応する.obj ファイルを生成します。前のセクションで作成したコンソールプロジェクトでは、選択した構成によって、C:¥My Program¥TestProgram の下にターゲットディレクトリが作成されます。このディレクトリには、.obj ファイル、中間ファイル、および実行可能ファイルが格納されます。

デフォルト構成は Win32 Debug です。この構成では、実行可能ファイルは C:¥My Programs¥TestProgram¥Debug ディレクトリに格納されます。デバッグ構成では、アプリケーションのデバッグを支援するデバッグ情報がコードに追加されます。デバッグ構成では、コードの最適化は行われません。Visual C++ がアプリケーションのために用意しているもう 1 つの構成は Win32 Release です。この構成は、コードの最適化設定を持っており、デバッグ情報は含んでいません。リリース構成でビルドされたコードは、C:¥My Programs¥TestProgram¥Release ディレクトリに格納されます。詳細については、MSDN ライブラリの "プロジェクトワークスペースの要素" を参照してください。

リンカ (LINK.EXE) は、.obj ファイルとその他の中間ファイルを入力として受け取り、最終的な.exe を生成します。ビルドプロセスは、まずコンパイラを実行し、次にリンカを実行します。実行可能ファイルを生成するには、プロジェクトのビルドを行わなくてはなりません。ファイルのコンパイルだけを行うと、.obj ファイルが生成されます。

ビルドプロセスは次の図のように示すとわかりやすいでしょう (図 9)。

図 9. ビルドプロセスの図

図 10 のアウトプットウィンドウは、ビルドの結果を示しています。

図 10. ビルドの結果を表示するアウトプットウィンドウ
上の画像をクリックすると大きい画像を表示します。

この例では、TestProgram.exe 実行可能ファイルが C:¥My Programs¥TestProgram¥Debug ディレクトリに格納されています。

ビルドの結果は、.plg という拡張子を持つファイルにも格納されています。TestProgram プロジェクトでは、TestProgram.plg ファイルにこの情報が含まれています。詳細については、MSDN ライブラリの "コンパイルとリンク" を参照してください。

プロジェクトのクリーンとコピー

プロジェクトのクリーンを行うには、[ビルド] メニューの [クリーン] をクリックします。プロジェクトのクリーンを行うと、実行可能ファイルを含めて、ターゲットディレクトリ (プロジェクトの構成によって、Debug ディレクトリと Release ディレクトリのどちらか) に含まれるすべてのファイルが削除されます。プロジェクトをフロッピーディスクなどの別の場所に移すような場合には、プロジェクトのクリーンを行うといいでしょう。これにより、プロジェクトのサイズが減り、コピーが高速化されます。TestProgram プロジェクトの例では、ディレクトリ全体を別の位置にドラッグアンドドロップで移動することができます。クリーン後に実行可能ファイルを生成するには、再度ビルドを行う必要があります。

ビルドエラーのトラブルシューティング

コンパイラやリンカのエラーが発生する理由にはさまざまなものが考えられます。たとえば、正しいヘッダーファイルがインクルードされていない、入力ミスがあった、コンパイラ／リンカスイッチが正しく使われていなかったなどです。どのようなエラーであれ、エラーに関する情報はアウトプットウィンドウに表示されます。

このセクションでは、この記事の「Win32 コンソールアプリケーションの作成」のセクションの操作を行って、すでに TestProgram プロジェクトを作成しているとします。次に、Test.cpp ファイルにわざと間違いを入れてみましょう。ファイルの内容を削除し、代わりに次のコードを入力します。

#include<stdio.h>

float ver;

void main()

{

ver = 6.0;

print("Welcome to Visual C++ %.1f¥n",ver); //printf を print に置き換えた

}

プロジェクトをビルドします。アウトプットウィンドウには、図 11 に示すメッセージが表示されます。

図 11. アウトプットウィンドウにエラーが表示されている様子
上の画像をクリックすると大きい画像を表示します。

このウィンドウは、Test.cpp ファイルの 8 行目でエラーが発生したことを示しています。この場所に移動するには、アウトプットウィンドウでエラーメッセージをダブルクリックするか、F4 キーを押します。これは、特に大きなファイルを扱っている場合に便利な機能です。

個々のエラー番号は何らかの意味を持っています。これは Visual C++ のヘルプシステム (MSDN ライブラリ) で調べることができます。この例のエラーは C2065 です。このエラーの原因となるさまざまな理由を調べるには、次の操作を行います。

エラーの原因を調べるには

マウスを使って、キーボードカレットをアウトプットウィンドウの C2065 コンパイラエラーコードの上に置きます。エラーコードの上でカレットが点滅していることを確認してください。正しいヘルプトピックに移動できません。
F1 キーを押します。
C2065 に関しては、2 つのトピックがあります。『Visual C++ プログラマーズガイド』に含まれている方のトピックを選択してください。
トピックが右側に表示されます。「識別子の名前が正しく入力されているかどうかを確認してください」という記述があり、これが原因だったことがわかります。

別の方法として、次の手順を実行しても同じ情報を得ることができます。

Visual C++ で、[ヘルプ] メニューの [キーワード] をクリックします。
[キーワードを入力してください] エディットボックスに C2065 と入力します。
この番号に対応するトピックがエディットボックスの下のリストボックスに表示されます。
C2065 トピックをダブルクリックします。
C2065 に関しては、2 つのトピックがあります。
『Visual C++ プログラマーズガイド』に含まれている方のトピックを選択してください。
トピックが右側に表示されます。「識別子の名前が正しく入力されているかどうかを確認してください」という記述があり、これが原因だったことがわかります。

printf に関する情報は、最初の行でインクルードされていた stdio.h ファイルに含まれています。stdio.h ファイルを開くと、"print" という名前の関数はないことがわかります。これが、コンパイラがエラーと判断した理由に他なりません。"print" という名前の関数が存在していたとしたら、コンパイルエラーは発生しなかったはずですが、実行可能ファイルの実行時の動作は予期しないものになった可能性があります。

エラー番号の情報は、必ず MSDN ライブラリで確認するようにしてください。MSDN Library Online は http://msdn2.microsoft.com/ja-jp/library/default.aspx でアクセスすることができます。

ワークスペースへの新しいプロジェクトと既存のプロジェクトの追加

以下のセクションでは、新しいプロジェクトを追加する方法と、既存のプロジェクトを追加する方法について説明します。

新しいプロジェクトの追加

既存のワークスペースに新しいプロジェクトを追加するには、TestProgram プロジェクトの作成 (「Win32 コンソールアプリケーションの作成」を参照) で使ったステップを、以下の変更を加えて実行します。

[新規作成] ダイアログボックスで、[現在のワークスペースへ追加] オプションを選択します。
新しいプロジェクトの位置がただちに変更されます。

たとえば、TestProgram プロジェクトに AnotherTestProgram という名前の新しいプロジェクトを追加する場合、[現在のワークスペースへ追加] を選択すると、パス は C:¥My Programs¥AnotherTestProgram から C:¥My Programs¥TestProgram¥AnotherTestProgram に変化します (図 12 を参照)。

図 12. 既存のワークスペースへの新しいプロジェクトの追加
上の画像をクリックすると大きい画像を表示します。

既存のプロジェクトの追加

既存のプロジェクトを追加するには、次の操作を行います。

既存のプロジェクトを追加するには

[プロジェクト] メニューの [プロジェクトをワークスペースへ挿入] をクリックします。
[ワークスペースへプロジェクトの挿入] ダイアログボックスで、挿入するプロジェクトを選択します。
このステップでは、プロジェクトを表している DSP ファイルを参照して探します。

既存のプロジェクトに別のプロジェクトを追加した場合、ワークスペースウィンドウにはすべてのプロジェクトが表示されます。たとえば、TestProgram プロジェクトに AnotherTestProgram プロジェクトを追加すると、FileView には両方のプロジェクトが表示されます (図 13)。

図 13. 既存のプロジェクトへの追加

AnotherTestProgram files が太字になっていることに注意してください。これは、このプロジェクトがアクティブプロジェクトであることを示しています。ビルドを実行したときには、アクティブプロジェクトがビルドされます。アクティブプロジェクトを設定するには、[プロジェクト] メニューの [アクティブプロジェクトに設定] サブメニューを使用します。

詳細については、MSDN ライブラリの "ホームページ : プロジェクトの操作" を参照してください。

ヒント

以下の操作は避けてください。
- フロッピーディスク上にプロジェクトを直接作成し、ビルドする。ディスクスペースが足りなくなります。
- 同じマシン上で、Visual C++ の 2 つの異なるインスタンスで同じプロジェクトを開く。
- Visual C++ の.dsp および.dsw ファイルの削除や変更。Visual C++ がプロジェクトのために生成する初期ファイルの詳細については、MSDN ライブラリの "Visual C++ プロジェクトに対して作成されるファイルの種類" を参照してください。
Visual C++ には最新のサービスパックを適用してください。サービスパックは、次の場所からダウンロードまたは注文することができます: http://www.microsoft.com/japan/msdn/vstudio/
キーボードショートカットの一覧を見るには、[ヘルプ] メニューの [キーボードマップ] を選択してください。

結論

この記事では、Visual C++ IDE のナビゲーションと、簡単な C/C++ プログラムの作成に関する基本的な概念を、わかりやすい例を使って説明しました。以下に、読者のために参考資料のリストを示します。この記事の目的は、初心者のプログラマが Visual C++ を使って C/C++ プログラムを作成しようとするときの最初の壁を突破することにあります。