# ChatWindowConfiguration

Roblox Engine API class from Roblox Studio 0.744.0.7441077 (version-7aaa6838d36c4448).

- Inherits from, nearest first: [TextChatConfigurations](https://rapi.sleaze.dev/classes/TextChatConfigurations.md), [Instance](https://rapi.sleaze.dev/classes/Instance.md), [Object](https://rapi.sleaze.dev/classes/Object.md)
- Tags: Not creatable
- Memory category: Instances
- HTML page: https://rapi.sleaze.dev/classes/ChatWindowConfiguration/
- Roblox documentation: https://create.roblox.com/docs/reference/engine/classes/ChatWindowConfiguration

Configures properties of the default chat window.

## Properties

### BackgroundColor3

```luau
ChatWindowConfiguration.BackgroundColor3: Color3 = Color3.new(0.0980392, 0.105882, 0.113725)
```

- Tags: Read capabilities: Chat

Background color of the default chat window.

### BackgroundTransparency

```luau
ChatWindowConfiguration.BackgroundTransparency: number = 0.2999999999999999889
```

- Tags: Read capabilities: Chat

Background transparency of the default chat window.

### FontFace

```luau
ChatWindowConfiguration.FontFace: Font
```

- Tags: Read capabilities: Chat

Font used to render text in the default chat window.

### TextColor3

```luau
ChatWindowConfiguration.TextColor3: Color3 = Color3.new(1, 1, 1)
```

- Tags: Read capabilities: Chat

Color of the text in default chat window.

### TextSize

```luau
ChatWindowConfiguration.TextSize: number = 14
```

- Tags: Read capabilities: Chat

Size of the text in default chat window.

### TextStrokeColor3

```luau
ChatWindowConfiguration.TextStrokeColor3: Color3 = Color3.new(0, 0, 0)
```

- Tags: Read capabilities: Chat

Color of the text stroke for text in default chat window.

### TextStrokeTransparency

```luau
ChatWindowConfiguration.TextStrokeTransparency: number = 0.5
```

- Tags: Read capabilities: Chat

Transparency of the text stroke for text in default chat window.

### Enabled

```luau
ChatWindowConfiguration.Enabled: boolean = true
```

- Tags: Read capabilities: Chat

Whether to show the default chat window.

### HeightScale

```luau
ChatWindowConfiguration.HeightScale: number = 1
```

- Tags: Read capabilities: Chat

Factor by which the height of the default chat window should be scaled.

### TextChannelDisplayMode

```luau
ChatWindowConfiguration.TextChannelDisplayMode: Enum.TextChannelDisplayMode = Enum.TextChannelDisplayMode.AllTextChannels
```

- Tags: Read capabilities: Chat, Write capabilities: PluginOrOpenCloud

### WidthScale

```luau
ChatWindowConfiguration.WidthScale: number = 1
```

- Tags: Read capabilities: Chat

Factor by which the width of the default chat window should be scaled.

### AbsolutePosition

```luau
ChatWindowConfiguration.AbsolutePosition: Vector2 = Vector2.zero
```

- Tags: Read only, Thread unsafe, Read capabilities: Chat

Actual screen position of the default chat window, in pixels.

### AbsolutePositionWrite

```luau
ChatWindowConfiguration.AbsolutePositionWrite: Vector2 = Vector2.zero
```

- Tags: Hidden, Roblox script security, Read capabilities: Chat

### AbsoluteSize

```luau
ChatWindowConfiguration.AbsoluteSize: Vector2 = Vector2.zero
```

- Tags: Read only, Thread unsafe, Read capabilities: Chat

Actual screen size of the default chat window, in pixels.

### AbsoluteSizeWrite

```luau
ChatWindowConfiguration.AbsoluteSizeWrite: Vector2 = Vector2.zero
```

- Tags: Hidden, Roblox script security, Read capabilities: Chat

### HorizontalAlignment

```luau
ChatWindowConfiguration.HorizontalAlignment: Enum.HorizontalAlignment = Enum.HorizontalAlignment.Left
```

- Tags: Thread unsafe, Read capabilities: Chat

Horizontal alignment of the chat window.

### VerticalAlignment

```luau
ChatWindowConfiguration.VerticalAlignment: Enum.VerticalAlignment = Enum.VerticalAlignment.Top
```

- Tags: Thread unsafe, Read capabilities: Chat

Vertical alignment of the chat window.

## Methods

### DeriveNewMessageProperties

```luau
ChatWindowConfiguration:DeriveNewMessageProperties(): ChatWindowMessageProperties
```

- Tags: Capabilities: Chat

Creates a new [`ChatWindowMessageProperties`](https://rapi.sleaze.dev/classes/ChatWindowMessageProperties.md) instance that can be used to customize the appearance of messages in the chat window.

Returns: A new [`ChatWindowMessageProperties`](https://rapi.sleaze.dev/classes/ChatWindowMessageProperties.md) instance whose values you can modify and return from a [`TextChatService.OnChatWindowAdded`](https://rapi.sleaze.dev/classes/TextChatService.md) callback to customize how individual messages appear in the chat window.

## Inherited members

- From [Instance](https://rapi.sleaze.dev/classes/Instance.md): `Archivable`, `archivable`, `Attributes`, `AttributesReplicate`, `AttributesSerialize`, `HistoryId`, `Name`, `Parent`, `PredictionMode`, `PropertyStatusStudio`, `RobloxLocked`, `SerializedOverrides`, `SourceAssetId`, `Tags`, `UniqueId`, `numExpectedDirectChildren`, `DataCost`, `Capabilities`, `DefinesCapabilities`, `IsInSandbox`, `Sandboxed`, `AddTag`, `ClearAllChildren`, `Clone`, `Destroy`, `FindFirstAncestor`, `FindFirstAncestorOfClass`, `FindFirstAncestorWhichIsA`, `FindFirstChild`, `FindFirstChildOfClass`, `FindFirstChildWhichIsA`, `FindFirstDescendant`, `GetActor`, `GetAttribute`, `GetAttributeChangedSignal`, `GetAttributes`, `GetChildren`, `GetDebugId`, `GetDescendants`, `GetFullName`, `GetStyled`, `GetStyledPropertyChangedSignal`, `GetTags`, `HasTag`, `IsAncestorOf`, `IsDescendantOf`, `IsPropertyModified`, `QueryDescendants`, `RemoveTag`, `ResetPropertyToDefault`, `SetAttribute`, `WaitForChild`, `Remove`, `children`, `clone`, `destroy`, `findFirstChild`, `getChildren`, `isDescendantOf`, `remove`, `AncestryChanged`, `AttributeChanged`, `ChildAdded`, `ChildRemoved`, `DescendantAdded`, `DescendantRemoving`, `Destroying`, `StyledPropertiesChanged`, `childAdded`
- From [Object](https://rapi.sleaze.dev/classes/Object.md): `ClassName`, `className`, `GetPropertyChangedSignal`, `IsA`, `isA`, `Changed`