IDebugDocumentHelper::AddDeferredTextIDebugDocumentHelper::AddDeferredText

Notifie l’application d’assistance que le texte donné est disponible, mais il ne fournit pas les caractères.Notifies the helper that the given text is available, but it does not provide the characters.

SyntaxeSyntax

HRESULT AddDeferredText(  
   ULONG  cChars,  
   DWORD  dwTextStartCookie  
);  

ParamètresParameters

cChars
[in] Nombre de caractères (Unicode) à ajouter.[in] Number of (Unicode) characters to add.

dwTextStartCookie
[in] Cookies définis par l’hôte qui représente la position de départ du texte.[in] Host-defined cookie that represents the starting position of the text.

Valeur de retourReturn Value

La méthode retourne HRESULT.The method returns an HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.Possible values include, but are not limited to, those in the following table.

ValueValue DescriptionDescription
S_OK La méthode a réussi.The method succeeded.
E_FAIL La méthode a échoué.The method failed.

NotesRemarks

Cette méthode permet à l’hôte de différer la pour ajouter jusqu'à ce qu’ils sont nécessaires, tout en autorisant l’assistance générer des notifications précises et des informations sur la taille de caractères non valides.This method allows the host to defer providing the characters to add until they are needed, while allowing the helper to generate accurate notifications and size information. Le dwTextStartCookie paramètre est un cookie, défini par l’hôte, qui représente la position de départ du texte.The dwTextStartCookie parameter is a cookie, defined by the host, which represents the starting position of the text. Les appels suivants à IDebugDocumentText::GetText doit fournir ce cookie.Subsequent calls to IDebugDocumentText::GetText must provide this cookie. Par exemple, dans un hôte qui représente le texte en DBCS, le cookie peut être un décalage d’octet.For example, in a host that represents text in DBCS, the cookie could be a byte offset.

Il est supposé qu’un seul appel à IDebugDocumentText::GetText peut obtenir des caractères à partir de plusieurs appels à AddDeferredText.It is assumed that a single call to IDebugDocumentText::GetText can get characters from multiple calls to AddDeferredText. Classes d’assistance peuvent également demander la même plage de caractères différées plusieurs fois.Helper classes may also ask for the same range of deferred characters more than once.

Note

Les appels à AddDeferredText ne doivent pas être mélangées avec les appels à AddUnicodeText ou AddDBCSText.Calls to AddDeferredText should not be mixed with calls to AddUnicodeText or AddDBCSText. Si cela se produit, E_FAIL est retournée.If this occurs, E_FAIL is returned.

Voir aussiSee Also

Interface IDebugDocumentHelper IDebugDocumentHelper Interface
IDebugDocumentHelper::AddUnicodeText IDebugDocumentHelper::AddUnicodeText
IDebugDocumentHelper::AddDBCSText IDebugDocumentHelper::AddDBCSText
IDebugDocumentText::GetTextIDebugDocumentText::GetText