# DialogueCharacterNameView

Class in [Yarn.Unity](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity)

Inherits from [`DialogueViewBase`](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialogueviewbase)

## Summary

A subclass of [DialogueViewBase](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialogueviewbase) that displays character names.

```csharp
public class DialogueCharacterNameView : Yarn.Unity.DialogueViewBase
```

## Remarks

This class uses the `character` attribute on lines that it receives to determine its content. When the view's [RunLine(LocalizedLine,Action)](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialoguecharacternameview/yarn.unity.dialoguecharacternameview.runline) method is called with a line whose [Text](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.localizedline/yarn.unity.localizedline.text) contains a `character` attribute, the [onNameUpdate](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialoguecharacternameview/yarn.unity.dialoguecharacternameview.onnameupdate) event is fired. If the line does not contain such an attribute, the [onNameNotPresent](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialoguecharacternameview/yarn.unity.dialoguecharacternameview.onnamenotpresent) event is fired instead.

This view does not present any options or handle commands. It's intended to be used alongside other subclasses of DialogueViewBase.

## Fields

| Name                                                                                                                                                                    | Description                                                                                         |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| [onDialogueStarted](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialoguecharacternameview/yarn.unity.dialoguecharacternameview.ondialoguestarted) | Invoked when the dialogue is started.                                                               |
| [onNameNotPresent](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialoguecharacternameview/yarn.unity.dialoguecharacternameview.onnamenotpresent)   | Invoked when a line is received that doesn't contain a character name.                              |
| [onNameUpdate](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialoguecharacternameview/yarn.unity.dialoguecharacternameview.onnameupdate)           | Invoked when a line is received that contains a character name. The name is given as the parameter. |

## Methods

| Name                                                                                                                                                                      | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| [DialogueStarted()](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialoguecharacternameview/yarn.unity.dialoguecharacternameview.dialoguestarted)     |             |
| [RunLine(LocalizedLine,Action)](https://docs.yarnspinner.dev/2.4/api/csharp/yarn.unity/yarn.unity.dialoguecharacternameview/yarn.unity.dialoguecharacternameview.runline) |             |

## See Also

* DialogueUI
