CWnd::GetWindowText

CWnd にタイトルがある場合は、lpszStringBuf で示されるバッファーまたは rString で示される文字列へコピーします。

int GetWindowText(
   LPTSTR lpszStringBuf,
   int nMaxCount 
) const;
void GetWindowText(
   CString& rString 
) const;

パラメーター

  • lpszStringBuf
    ウィンドウのタイトルからコピーする文字列を受け取るバッファーを指します。

  • nMaxCount
    バッファーへコピーした最大文字数を返します。終端の null 文字も含めます。 文字列が nMaxCount で指定した文字数よりも長い場合は、文字列は切り詰められます。

  • rString
    CString オブジェクト。このオブジェクトは、ウィンドウのタイトルをコピーした文字列を受け取ります。

戻り値

コピーされた文字列の長さを文字数で返します。文字列の終わりを示す NULL 文字は数えません。 CWnd にキャプションがない場合、またはキャプションが空の場合は 0 を返します。

解説

CWnd オブジェクトがコントロールの場合、GetWindowText メンバー関数はタイトルをコピーする代わりに、コントロール内のテキストをコピーします。

このメンバー関数は、CWnd オブジェクトへ WM_GETTEXT メッセージを送信します。

使用例

CWnd::SetWindowText」の例を参照してください。

必要条件

**ヘッダー:**afxwin.h

参照

参照

CWnd クラス

階層図

CWnd::SetWindowText

WM_GETTEXT

CWnd::GetWindowTextLength

概念

CWnd のメンバー