ユニットスコープ名

RAD Studio 入門への移動

ユニットスコープ名は、RAD Studio ライブラリ群（VCL-FMX-RTL）に含まれているユニット名の先頭に付けられる接頭辞です。つまり、ユニット、関数、クラス、メンバの名前では、以下のように、ユニット名の先頭にユニットスコープ名が付きます。

構文と説明

次のように、ユニット名の前にユニットスコープ名が付くようになりました。

<unitscope>.<unitname>. ...

たとえば、以下のように、SysUtils ユニットは System ユニットスコープの一部になりました。

System.SysUtils

また、次のように、Controls ユニットは Vcl やFMX ユニットスコープの一部になっています。Vcl.Controls

FMX.Controls

1 構文と説明
2 完全修飾名にはユニットスコープ名が必要
- 2.1 ユニットスコープ設定されたユニット名をコードで指定する方法
- 2.2 RAD Studio ではユニットスコープを使用しヘルプでもユニットスコープ名を使用
  - 2.2.1 例
3 ユニットスコープ
4 ユニットスコープおよび各ユニットスコープに属するユニット
5 トピック
6 関連項目

ユニットスコープ名の特徴は以下のとおりです。

ユニットを、Vcl、System、FMX などの基本グループに分類します（ユニットスコープはこの後の「ユニットスコープ」セクションで分類されています）。
IDE を使って作成するコードの互換性を確保します。
あいまい（複数の解釈が可能）な名前のメンバを識別します（つまり、メンバの名前が別のユニットのメンバの名前と一致したときでも、名前の解決を必ず正しく行えるようにします）。
通常、大文字の 1 文字で始まり、その後に小文字の文字列が続きます（たとえば、Data など）。
通常は 1 つの要素（たとえば DataSnap など）で構成されますが、2 つの要素で構成されるものもあります（たとえば System.Generics など）。

コンポーネント開発者は、ユニットスコープ名を追加することができます（「独自作成したコンポーネントへのユニットスコープ名の追加」で説明）。

完全修飾名にはユニットスコープ名が必要

1 つの注目すべき例外を除き、従来のコードは変更しなくても引き続き動作するはずです。1 つの例外というのは、コードそのものに含まれているスコープ付き識別子つまり修飾識別子です。完全修飾識別子名には、ユニットスコープ設定が必要になりました。つまり、（ユニットスコープを設定していない）既存のコードで修飾識別子を使用した場合は、コンパイルするのに変更が必要です。ユニット名にユニットスコープ名を付加する必要があります。

たとえば、TStream クラスの完全修飾識別子は、以前の製品リリースであれば次のように指定しました。

Classes.TStream

Classes.TStream という名前は完全修飾クラス名とは見なされません。完全修飾名はユニットスコープ設定されている、つまり、ユニットスコープ名を含んでいる必要があるからです。この場合、ユニットスコープ設定された名前つまり完全修飾名にするには、次のように、ユニットスコープ名 System を Classes ユニット名に付加する必要があります。

Delphi では、TStream の完全修飾識別子名は次のようになります。
System.Classes.TStream
C++ では、C++ スコープ演算子（::）がユニットスコープ名で使用されます。TStream クラスの完全修飾名は、C++ コードでは次のようになります。
System::Classes::TStream

考えられるコードの変更： 既存のコードに修飾識別子（Classes.TStream.Seek など）が含まれている場合は、その名前を修正して、識別子がユニットスコープ設定され完全修飾されたもの（System.Classes.TStream.Seek など）になるようにする必要があります。

ユニットスコープ設定されたユニット名をコードで指定する方法

新規開発の場合は、アプリケーション内のユニットにユニットスコープを指定する必要があります。それには、以下のいずれかの方法を選択します。

あらゆる場所で：
コード全体を通して、すべてのメンバの名前を完全修飾します。アプリケーション全体を通して完全修飾名を使用しユニットスコープ名を名前に含めることで、コンパイル時間は確実に短縮されます。
uses 句または #include 指令で：
uses 句または #include 指令で、（ユニットスコープ名とユニット名を使って）ユニット名を完全修飾します。そうすれば、コードでは、uses 句または #include 指令で（ユニットスコープを使って）完全修飾したユニットのメンバの名前については、部分修飾で済ませることができます。
［<プロジェクト名> のプロジェクトオプション］ダイアログボックスで：
［<プロジェクト名> のプロジェクトオプション］ダイアログボックスの［Delphi コンパイラ］ページの［ユニットスコープ名］オプションにユニットスコープ名を追加します。

注意： 部分修飾名を使用すると、コンパイル中にコンパイラがすべての部分修飾名を解決する必要があるため、コンパイルが著しく遅くなるおそれがあります。

RAD Studio ではユニットスコープを使用しヘルプでもユニットスコープ名を使用

RAD Studio に用意されているウィザードやテンプレートでは、適切にユニットスコープ設定されたユニット名を使用し組み込んでいます。ヘルプでは、一部のユニット名、クラス名、メンバ名に、まだユニットスコープ名が付加されていません。ただし、ライブラリのドキュメントでは、完全なユニットスコープ名がページタイトルに示されています。

例

コードに以下が記述されている場合

 uses
   System.SysUtils, System.Types, System.Classes, FMX.Controls;

または

#include <System.SysUtils.hpp>
#include <System.Types.hpp>
#include <System.Classes.hpp>
#include <FMX.Controls.hpp>

コードでは、たとえば次のような修飾されていないメンバ名を指定することができます。

  GetPackageInfo  // referring to System.SysUtils.GetPackageInfo
  TRect           // referring to System.Types.TRect
  TNotifyEvent    // referring to System.Classes.TNotifyEvent
  TTrackBar       // referring to FMX.Controls.TTrackBar