CWnd::GetWindowText

lpszStringBuf が指し示すバッファーまたはコピー先文字列 rStringに CWnd のキャプション タイトル (1 の場合) をコピーします。

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

パラメーター

  • lpszStringBuf
    ウィンドウのタイトル文字列のコピーを受け取ることになっているバッファーへのポインター。

  • nMaxCount
    終端の null 文字を含めて、バッファーにコピーする文字の最大数を指定します。文字列が nMaxCountで指定された文字数よりも長い場合は省略されます。

  • rString
    ウィンドウのタイトル文字列のコピーを受信することである CString のオブジェクト。

戻り値

コピーの文字列 (終端の null 文字を含む文字で、長さを指定します。CWnd にキャプションがない場合、またはキャプションが空の場合は 0 になります。

解説

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

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

使用例

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

必要条件

ヘッダー: afxwin.h

参照

関連項目

CWnd クラス

階層図

CWnd::SetWindowText

WM_GETTEXT

CWnd::GetWindowTextLength