> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyLocalChatControl::SendText

> Transmet une chaîne de texte de clavardage à chaque contrôle de clavardage cible spécifié.

Transmet une chaîne de texte de clavardage à chaque contrôle de clavardage cible spécifié.

## Syntaxe

```cpp theme={null}
PartyError SendText(  
    uint32_t targetChatControlCount,  
    PartyChatControlArray targetChatControls,  
    PartyString chatText,  
    uint32_t dataBufferCount,  
    const PartyDataBuffer* dataBuffers  
)  
```

### Paramètres

**`targetChatControlCount`**   uint32\_t

Le nombre de contrôles de clavardage cibles dans le tableau `targetChatControls`.

**`targetChatControls`**   [PartyChatControlArray](/fr-CA/services/playfab/multiplayer/networking/reference/typedefs)\
*input array of size `targetChatControlCount`*

Le tableau de `targetChatControlCount` entrées des PartyChatControls cibles.

**`chatText`**   [PartyString](/fr-CA/services/playfab/multiplayer/networking/reference/typedefs)

Le texte à envoyer.

**`dataBufferCount`**   uint32\_t

Le nombre de structures de mémoire tampon fournies dans le tableau `dataBuffers`.

**`dataBuffers`**   [PartyDataBuffer\*](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partydatabuffer)\
*input array of size `dataBufferCount`*

Le tableau de `dataBufferCount` entrées de structures PartyDataBuffer décrivant une charge utile de message auxiliaire à envoyer. Il est ignoré lorsque `dataBufferCount` vaut zéro.

### Valeur de retour

PartyError

`c_partyErrorSuccess` si l'appel a réussi; sinon, un code d'erreur. La forme lisible du code d'erreur peut être obtenue au moyen de [PartyManager::GetErrorMessage()](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## Remarques

L'envoi de texte de clavardage à des contrôles de clavardage locaux n'est actuellement pas pris en charge. Si le tableau des contrôles de clavardage cibles inclut des cibles locales, cet appel échoue de façon synchrone. <br /><br /> Aucune traduction, localisation ni filtrage des propos offensants du contenu texte n'est garanti; la chaîne de texte de clavardage est présentée telle quelle.   <br /><br /> La chaîne de texte n'est remise qu'aux contrôles de clavardage cibles qui ont configuré leurs propres instances pour recevoir les messages texte du contrôle de clavardage local au moyen de [PartyLocalChatControl::SetPermissions()](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setpermissions).   <br /><br /> Si un contrôle de clavardage cible n'est pas connecté à au moins un réseau en commun avec le contrôle de clavardage source, la chaîne de texte n'est pas remise. Cela est possible s'il existe deux contrôles de clavardage locaux. Un contrôle de clavardage cible connecté à l'un des contrôles de clavardage locaux peut ne pas être connecté à tous les autres contrôles de clavardage locaux.   <br /><br /> Les structures PartyDataBuffer du tableau `dataBuffers` sont destinées aux données auxiliaires associées au texte de clavardage, comme des métadonnées indiquant la couleur à utiliser pour afficher le texte, ou un blob binaire contenant les données d'image d'une icône à afficher avec le texte de clavardage. Pour envoyer des données de jeu sans rapport avec le clavardage textuel, consultez [PartyLocalEndpoint::SendMessage()](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalEndpoint/methods/partylocalendpoint_sendmessage), une option de messagerie qui offre un contrôle plus précis du comportement de transmission des messages.   <br /><br /> Les appelants fournissent 0 ou plusieurs structures PartyDataBuffer dans le tableau `dataBuffers`. La mémoire référencée par ces structures n'a pas besoin d'être contiguë, ce qui permet par exemple d'avoir facilement une mémoire tampon d'en-tête fixe suivie d'une charge utile variable. Les mémoires tampons sont assemblées dans l'ordre, transmises et remises aux contrôles de clavardage cibles sous la forme d'un bloc de données contigu unique, distinct du texte de clavardage, dans un [PartyChatTextReceivedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange). La bibliothèque Party ne consomme pas de bande passante pour transmettre des métadonnées décrivant la segmentation d'origine en PartyDataBuffer.

## Configuration requise

**En-tête :** Party.h

## Voir aussi

[PartyLocalChatControl](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyChatTextReceivedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange)


## Related topics

- [PartyChatTextReceivedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange.md)
- [Comprendre le fonctionnement du clavardage de PlayFab Party](/fr-CA/services/playfab/community/voice-communications/concepts-chat.md)
- [PartyLocalChatControl](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)
- [PartyLocalChatControl::SetPermissions](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setpermissions.md)
- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)