OpenTTD Source 20241224-master-gf74b0cf984
NewsItem Struct Reference

Information about a single item of news. More...

#include <news_type.h>

Public Member Functions

 NewsItem (StringID string_id, NewsType type, NewsFlag flags, NewsReferenceType reftype1, uint32_t ref1, NewsReferenceType reftype2, uint32_t ref2, std::unique_ptr< NewsAllocatedData > &&data)
 Create a new newsitem to be shown.
 

Data Fields

StringID string_id
 Message text.
 
TimerGameCalendar::Date date
 Calendar date to show for the news.
 
TimerGameEconomy::Date economy_date
 Economy date of the news item, never shown but used to calculate age.
 
NewsType type
 Type of the news.
 
NewsFlag flags
 NewsFlags bits.
 
NewsReferenceType reftype1
 Type of ref1.
 
NewsReferenceType reftype2
 Type of ref2.
 
uint32_t ref1
 Reference 1 to some object: Used for a possible viewport, scrolling after clicking on the news, and for deleting the news when the object is deleted.
 
uint32_t ref2
 Reference 2 to some object: Used for scrolling after clicking on the news, and for deleting the news when the object is deleted.
 
std::unique_ptr< NewsAllocatedDatadata
 Custom data for the news item that will be deallocated (deleted) when the news item has reached its end.
 
std::vector< StringParameterData > params
 Parameters for string resolving.
 

Detailed Description

Information about a single item of news.

Definition at line 128 of file news_type.h.

Constructor & Destructor Documentation

◆ NewsItem()

NewsItem::NewsItem ( StringID  string_id,
NewsType  type,
NewsFlag  flags,
NewsReferenceType  reftype1,
uint32_t  ref1,
NewsReferenceType  reftype2,
uint32_t  ref2,
std::unique_ptr< NewsAllocatedData > &&  data 
)

Create a new newsitem to be shown.

Parameters
string_idString to display.
typeThe type of news.
flagsFlags related to how to display the news.
reftype1Type of ref1.
ref1Reference 1 to some object: Used for a possible viewport, scrolling after clicking on the news, and for deleting the news when the object is deleted.
reftype2Type of ref2.
ref2Reference 2 to some object: Used for scrolling after clicking on the news, and for deleting the news when the object is deleted.
dataPointer to data that must be released once the news message is cleared.
See also
NewsSubtype

Definition at line 876 of file news_gui.cpp.

References _settings_client, GUISettings::coloured_news_year, CopyOutDParam(), ClientSettings::gui, NF_INCOLOUR, params, and TimerGameCalendar::year.

Field Documentation

◆ data

std::unique_ptr<NewsAllocatedData> NewsItem::data

Custom data for the news item that will be deallocated (deleted) when the news item has reached its end.

Definition at line 140 of file news_type.h.

Referenced by NewsWindow::DrawWidget(), and NewsWindow::OnResize().

◆ date

TimerGameCalendar::Date NewsItem::date

Calendar date to show for the news.

Definition at line 130 of file news_type.h.

Referenced by MessageHistoryWindow::DrawWidget(), and NewsWindow::SetStringParameters().

◆ economy_date

TimerGameEconomy::Date NewsItem::economy_date

Economy date of the news item, never shown but used to calculate age.

Definition at line 131 of file news_type.h.

◆ flags

NewsFlag NewsItem::flags

NewsFlags bits.

See also
NewsFlag

Definition at line 133 of file news_type.h.

Referenced by ChangeVehicleNews(), and ShowNewspaper().

◆ params

std::vector<StringParameterData> NewsItem::params

Parameters for string resolving.

Definition at line 142 of file news_type.h.

Referenced by ChangeVehicleNews(), DrawNewsString(), NewsWindow::DrawWidget(), NewsItem(), and NewsWindow::UpdateWidgetSize().

◆ ref1

uint32_t NewsItem::ref1

Reference 1 to some object: Used for a possible viewport, scrolling after clicking on the news, and for deleting the news when the object is deleted.

Definition at line 137 of file news_type.h.

Referenced by ChangeVehicleNews(), DeleteIndustryNews(), DeleteInvalidEngineNews(), DeleteStationNews(), DeleteVehicleNews(), NewsWindow::DrawWidget(), NewsWindow::OnClick(), NewsWindow::OnResize(), and NewsWindow::UpdateWidgetSize().

◆ ref2

uint32_t NewsItem::ref2

Reference 2 to some object: Used for scrolling after clicking on the news, and for deleting the news when the object is deleted.

Definition at line 138 of file news_type.h.

Referenced by ChangeVehicleNews(), DeleteIndustryNews(), DeleteInvalidEngineNews(), DeleteStationNews(), and DeleteVehicleNews().

◆ reftype1

◆ reftype2

◆ string_id

StringID NewsItem::string_id

Message text.

Definition at line 129 of file news_type.h.

Referenced by DeleteVehicleNews(), DrawNewsString(), and NewsWindow::UpdateWidgetSize().

◆ type

NewsType NewsItem::type

Type of the news.

Definition at line 132 of file news_type.h.

Referenced by ShowNewspaper().


The documentation for this struct was generated from the following files: