ユニットスコープ名

RAD Studio 入門への移動

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

1 構文と説明
2 完全修飾名にはユニットスコープ名が必要
- 2.1 ユニットスコープ設定されたユニット名をコードで指定する方法
- 2.2 RAD Studio はユニットスコープを使用し、ヘルプもまたユニットスコープ名を使用するように
  - 2.2.1 例
3 ユニットスコープ
4 ユニットスコープおよび各ユニットスコープに属するユニット
5 ユニットスコープ名のないユニット
6 ユニット名とそれに対応するユニットスコープ名のアルファベット順一覧
7 トピック
8 関連項目

構文と説明

<unitscope>.<unitname>. ...

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

System.SysUtils

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

Vcl.Controls

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

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

Indy や TeeChart などのサードパーティ製品には、ユニットスコープが設定されていません。サードパーティコンポーネントで新しいコードを開発する際には、ユニットスコープ名を付ける必要はありません。uses 句に追加されるエントリには自動的にスコープが設定されるからです。

「独自作成したコンポーネントへのユニットスコープ名の追加」のセクションで説明しているように、コンポーネント開発者はユニットスコープ名を追加できます。

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

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 に用意されているウィザードやテンプレートは、ユニットスコープ設定されたユニット名を適切に使用し組み込むように既に更新されています。ヘルプでは、一部のユニット名、クラス名、メンバ名に、まだユニットスコープ名が付加されていません。ただし、VCL-FMX-RTL Libraries documentation では、ユニットスコープの完全名がページタイトルに追加されています。

例

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

 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  // System.SysUtils.GetPackageInfo を参照
  TRect           // System.Types.TRect を参照
  TNotifyEvent    // System.Classes.TNotifyEvent 参照
  TTrackBar       // FMX.Controls.TTrackBar を参照