CButton::GetNote

更新 : 2007 年 11 月

現在のコマンド リンク コントロールに関連付けられている注釈テキストを取得します。

CString GetNote() const;
BOOL GetNote(
          LPTSTR lpszNote, 
          UINT* cchNote
) const;

パラメータ

パラメータ

説明

[出力] lpszNote

バッファへのポインタ。このバッファは、呼び出し元が割り当てて解放する必要があります。戻り値が true の場合は、現在のコマンド リンク コントロールに関連付けられている注釈テキストがそのバッファに入ります。それ以外の場合は、バッファに変更はありません。

[入力、出力] cchNote

符号なし整数変数へのポインタ。

このメソッドが呼び出されると、lpszNote パラメータで指定されているバッファのサイズがその変数に入ります。

このメソッドの戻り値が true の場合は、現在のコマンド リンク コントロールに関連付けられている注釈のサイズがその変数に入ります。戻り値が false の場合は、その注釈を入れるために必要なバッファのサイズがその変数に入ります。

戻り値

1 番目のオーバーロードの場合は、現在のコマンド リンク コントロールに関連付けられている注釈テキストが入った CString オブジェクト。

または

2 番目のオーバーロードでは、このメソッドが成功した場合は true。それ以外の場合は false。

解説

このメソッドは、ボタン スタイルが BS_COMMANDLINK または BS_DEFCOMMANDLINK のコントロールでのみ使用します。

このメソッドは、BCM_GETNOTE メッセージを送信します。このメッセージについては、Windows SDK を参照してください。

必要条件

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

このメソッドは、Windows Vista およびそれ以降のバージョンでサポートされています。

このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。

参照

参照

CButton クラス

階層図

CButton::SetNote

CButton::GetNoteLength

BCM_GETNOTE

その他の技術情報

CButton のメンバ