IFont::Clone メソッド (ocidl.h)
現在のフォントと同じ状態の重複するフォント オブジェクトを作成します。
構文
HRESULT Clone(
[out] IFont **ppFont
);
パラメーター
[out] ppFont
新しいフォント オブジェクトへのインターフェイス ポインターを受け取る IFont ポインター変数のアドレス。 この新しいフォント オブジェクトが不要になった場合、呼び出し元は IFont::Release を呼び出す必要があります。
戻り値
メソッドは、E_UNEXPECTEDおよびE_OUTOFMEMORYの標準戻り値と、次の値をサポートしています。
| リターン コード | 説明 |
|---|---|
|
新しいフォント オブジェクトが正常に作成されました。 |
|
このフォント オブジェクトは複製をサポートしていません。 |
|
ppfont のアドレスが無効です。 たとえば、 NULL にすることができます。 |
注釈
呼び出し元へのメモ
新しいフォント オブジェクトは、最初の フォント オブジェクトから完全に独立しています。 呼び出し元は、不要になったこの新しいオブジェクトを解放する必要があります。 このメソッドは、複製されるフォントの参照カウントには影響しません。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ocidl.h |