Share via


CButton::GetNote

Recupera il testo della nota associato al controllo di collegamento corrente del comando.

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

Parametri

Parametro

Descrizione

[out] lpszNote

Puntatore a un buffer, che il chiamante è responsabile per l'allocazione e il rilascio.Se il valore restituito è true, il buffer contiene il testo della nota associato al controllo di collegamento corrente del comando; in caso contrario, il buffer resti inalterato.

[in, out] cchNote

Un puntatore a una variabile di Integer senza segno.

Quando questo metodo viene chiamato, la variabile contiene la dimensione del buffer specificato dal parametro lpszNote.

Quando il metodo restituisce, se il valore restituito è true la variabile contiene la dimensione della nota associata al controllo di collegamento corrente del comando.Se il valore restituito è false, la variabile contiene le dimensioni del buffer richieste per contenere la nota.

Valore restituito

Nel primo overload, un oggetto CString che contiene il testo della nota associato al controllo di collegamento corrente del comando.

In alternativa

Nel secondo overload, true se questo metodo ha esito positivo; in caso contrario, false.

Note

Utilizzare questo metodo solo con i controlli che lo stile del pulsante è BS_COMMANDLINK o BS_DEFCOMMANDLINK.

Questo metodo invia il messaggio BCM_GETNOTE, come descritto in Windows SDK. 

Requisiti

intestazione: afxwin.h

Questo metodo è supportato in Windows Vista e versioni successive.

i requisiti aggiuntivi per questo metodo sono descritti in Requisiti di compilazione per i controlli comuni di Windows Vista.

Vedere anche

Riferimenti

Classe di CButton

Grafico della gerarchia

CButton::SetNote

CButton::GetNoteLength

BCM_GETNOTE