概要 - ウィンドウのプロパティ

  • [アーティクル]

ウィンドウ プロパティは、ウィンドウに割り当てられた任意のデータです。 通常、window プロパティはウィンドウ固有のデータのハンドルですが、任意の値を指定できます。 各ウィンドウ プロパティは、文字列名で識別されます。 アプリケーションでウィンドウ プロパティを使用できるようにする関数がいくつかあります。 この概要では、次のトピックについて説明します。

ウィンドウ プロパティを使用する利点

ウィンドウ プロパティは、通常、サブクラス化されたウィンドウまたは複数ドキュメント インターフェイス (MDI) アプリケーションのウィンドウにデータを関連付けるために使用されます。 どちらの場合も、次の 2 つの理由から、 CreateWindow 関数またはクラス構造で指定された余分なバイトを使用するのは便利ではありません。

  • アプリケーションでは、使用可能な余分なバイト数や、スペースの使用方法がわからない場合があります。 ウィンドウ プロパティを使用すると、アプリケーションは余分なバイトにアクセスすることなく、データをウィンドウに関連付けることができます。
  • アプリケーションは、オフセットを使用して余分なバイトにアクセスする必要があります。 ただし、ウィンドウ プロパティには、オフセットではなく文字列識別子によってアクセスされます。

サブクラス化の詳細については、「 ウィンドウ プロシージャのサブクラス化」を参照してください。 MDI ウィンドウの詳細については、「 複数のドキュメント インターフェイス」を参照してください。

ウィンドウプロパティの割り当て

SetProp 関数は、ウィンドウ プロパティとその文字列識別子をウィンドウに割り当てます。 GetProp 関数は、指定した文字列で識別されるウィンドウ プロパティを取得します。 RemoveProp 関数は、ウィンドウとウィンドウ プロパティの間の関連付けを破棄しますが、データ自体は破棄しません。 データ自体を破棄するには、適切な関数を使用して 、RemoveProp によって返されるハンドルを解放します。

ウィンドウのプロパティの列挙

EnumProps 関数と EnumPropsEx 関数は、アプリケーション定義のコールバック関数を使用して、ウィンドウのすべてのプロパティを列挙します。 コールバック関数の詳細については、「 PropEnumProc」を参照してください。

EnumPropsEx には、コールバック関数で使用されるアプリケーション定義データの追加パラメーターが含まれています。 コールバック関数の詳細については、「 PropEnumProcEx」を参照してください。