ue4-richtextblocktooltip-sample

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

ue4-richtextblocktooltip-sample

(★ 15)

Sample of writing a custom URichTextBlockDecorator in Unreal Engine 5 for displaying a tooltip

ue4-richtextblocktooltip-sample Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ue4-richtextblocktooltip-sample

![UE5](https://img.shields.io/badge/UE5-5.2+-blue)
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/Nauja/ue4-richtextblocktooltip-sample/master/LICENSE)

Sample of writing a custom URichTextBlockDecorator in Unreal Engine 5 for displaying a tooltip.

![Preview](https://github.com/Nauja/ue4-richtextblocktooltip-sample/raw/media5.2/preview.gif)

This sample has been created to demonstrate how the **URichTextBlockDecorator** feature can be used to make a **URichTextBlock** render some text with a tooltip displayed when hovered. The goal was to keep it as simple as possible, so while some features such as **Auto Wrap** may not work correctly, it should be possible to add them.

For an Unreal Engine 4 version, check the branch [ue4.25](https://github.com/Nauja/ue4-richtextblocktooltip-sample/tree/ue4.25).

## Table of contents:

- [Writing a custom **URichTextBlockDecorator**](#writing-a-custom-urichtextblockdecorator)
- [Setting up HUD](#setting-up-hud)
- [Registering the custom decorator](#registering-the-custom-decorator)
- [Creating a **DataTable** for default style set](#creating-a-datatable-for-default-style-set)

## Writing a custom **URichTextBlockDecorator**

Based on [Advanced Text Styling with Rich Text Block](https://www.unrealengine.com/en-US/tech-blog/advanced-text-styling-with-rich-text-block) documentation, you can create and add your own **URichTextBlockDecorator** class on a **URichTextBlock** to handle custom markup. There is nothing complicated here, and you can take example on the builtin **URichTextBlockImageDecorator** class.

For this sample, I created a new decorator named **USampleRichTextBlockTooltipDecorator** that will replace any `<tooltip text="Some infos">Some text</>` tag by a **UTextBlock** that can be hovered to display a tooltip.

Here is the definition in **SampleRichTextBlockTooltipDecorator.h**:

```cpp
#pragma once

#include "CoreMinimal.h"
#include "Framework/Text/ITextDecorator.h"
#include "Components/RichTextBlockDecorator.h"

#include "SampleRichTextBlockTooltipDecorator.generated.h"

/**
 * Allows you to setup a tooltip decorator.
 * This can be subclassed as a blueprint.
 *
 * Understands the format <tooltip text="Some infos">Some text</>
 */
UCLASS(Abstract, Blueprintable)
class USampleRichTextBlockTooltipDecorator : public URichTextBlockDecorator
{
    GENERATED_BODY()

public:
    USampleRichTextBlockTooltipDecorator(const FObjectInitializer& ObjectInitializer);

virtual TSharedPtr<ITextDecorator> CreateDecorator(URichTextBlock* InOwner) override;
	
protected:
    // Style used for text
    UPROPERTY(EditAnywhere, Category=Appearance)
    FTextBlockStyle TextStyle;

// Style used for tooltip text
    UPROPERTY(EditAnywhere, Category=Appearance)
    FTextBlockStyle TooltipTextStyle;
};
```

**CreateDecorator** is the only function that you need to implement on this class. It must returns an instance of **FRichTextDecorator** that will take care of parsing and building the widget to render. I also added the two properties **TextStyle** and **TooltipTextStyle** editable in blueprint to allow for styling the text and the tooltip text independently.

Here is the implementation in **SampleRichTextBlockTooltipDecorator.cpp**:

```cpp
#include "SampleRichTextBlockTooltipDecorator.h"
#include "Widgets/SToolTip.h"
#include "Widgets/Text/STextBlock.h"

// Class charged of creating the inline tooltip
class FSampleRichInlineTooltip : public FRichTextDecorator
{
public:
    FSampleRichInlineTooltip(URichTextBlock* InOwner, const FTextBlockStyle& InTextStyle, const FTextBlockStyle& InTooltipTextStyle)
        : FRichTextDecorator(InOwner)
        , TextStyle(InTextStyle)
        , TooltipTextStyle(InTooltipTextStyle)
    {
    }

// Only valid if text is: <tooltip text="Some infos">Some text</>
    virtual bool Supports(const FTextRunParseResults& RunParseResult, const FString& Text) const override
    {
        return RunParseResult.Name == TEXT("tooltip") && RunParseResult.MetaData.Contains(TEXT("text"));
    }

protected:
    /**
    * Create a STextBlock with a tooltip text.
    * 
    * For <tooltip text="Some infos">Some text</>:
    * - RunInfo.Content is "Some text"
    * - RunInfo.MetaData[TEXT("text")] is "Some infos"
    */
    virtual TSharedPtr<SWidget> CreateDecoratorWidget(const FTextRunInfo& InRunInfo, const FTextBlockStyle& InTextStyle) const override
    {
        return SNew(STextBlock)
            .Text(InRunInfo.Content)
            .TextStyle(&TextStyle)
            .ToolTip(SNew(SToolTip)
            [
                SNew(STextBlock)
                .Text(FText::FromString(InRunInfo.MetaData[TEXT("text")]))
                .TextStyle(&TooltipTextStyle)
            ]);
    }

private:
    FTextBlockStyle TextStyle;
    FTextBlockStyle TooltipTextStyle;
};

/////////////////////////////////////////////////////
// USampleRichTextBlockTooltipDecorator

USampleRichTextBlockTooltipDecorator::USampleRichTextBlockTooltipDecorator(const FObjectInitializer& ObjectInitializer)
    : Super(ObjectInitializer)
{
}

// Return our custom class for creating the inline widget
TSharedPtr<ITextDecorator> USampleRichTextBlockTooltipDecorator::CreateDecorator(URichTextBlock* InOwner)
{
    return MakeShareable(new FSampleRichInlineTooltip(InOwner, TextStyle, TooltipTextStyle));
}

/////////////////////////////////////////////////////
```

Again, this is largerly copied from the code of **URichTextBlockImageDecorator**. As you can see, the implementation of **CreateDecorator** is really simple as it only returns a new instance of **FSampleRichInlineTooltip**.

**FSampleRichInlineTooltip** is the class that handle everything. The **Supports** function, that is called to know if the decorator can be used for a tag, returns **true** only if the tag's name is "tooltip" and if there is a "text" attribute. Then, **CreateDecoratorWidget** is called, and this is where we need to build our custom widget that will be displayed on screen.

## Setting up HUD

The **SampleMap** map has only the bare minimum. For the purpose of this sample, it only adds **WBP_SampleHUD** to viewport (see Level Blueprint):

![LevelBlueprint](https://github.com/Nauja/ue4-richtextblocktooltip-sample/raw/media5.2/editor-levelblueprint.png)

**WBP_SampleHUD** contains a **URichTextBlock** widget I added the custom decorator class to:

![HUDWidget](https://github.com/Nauja/ue4-richtextblocktooltip-sample/raw/media5.2/editor-hud-widget.png)

## Registering the custom decorator

For **USampleRichTextBlockTooltipDecorator** to be usable in Blueprint, the first thing is to subclass it as a Blueprint. For this, I created a **BP_SampleRichTextBlockTooltipDecorator** that inherits from **USampleRichTextBlockTooltipDecorator**:

![SubclassDecorator](https://github.com/Nauja/ue4-richtextblocktooltip-sample/raw/media5.2/editor-subclass-decorator.png)

This also allows for customizing the style sets used for the text and the tooltip text in Editor:

![Subclass](https://github.com/Nauja/ue4-richtextblocktooltip-sample/raw/media5.2/editor-subclass.png)

The next step is to register this decorator on our **URichTextBlock** widget:

![RegisterDecorator](https://github.com/Nauja/ue4-richtextblocktooltip-sample/raw/media5.2/editor-registerdecorator.png)

This makes the **URichTextBlock** use our decorator to parse and render `<tooltip text="...">...</>` tags.

## Creating a **DataTable** for default style set

This is required to apply a default style to the **URichTextBlock** text. For this, I created a **DT_SampleTextStyleSet** data table with a **RichTextStyleRow** row structure:

![SubclassDataTable](https://github.com/Nauja/ue4-richtextblocktooltip-sample/raw/media5.2/editor-subclass-datatable.png)

I also added a "Default" entry:

![DataTable](https://github.com/Nauja/ue4-richtextblocktooltip-sample/raw/media5.2/editor-datatable.png)

The next step is to assign this data table to our **URichTextBlock** widget:

![RegisterDataTable](https://github.com/Nauja/ue4-richtextblocktooltip-sample/raw/media5.2/editor-registerdatatable.png)

## License

Licensed under the [MIT](LICENSE) License.

ue4-richtextblocktooltip-sample

ue4-richtextblocktooltip-sample Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ue4-richtextblocktooltip-sample

ue4-richtextblocktooltip-sample Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README