xref: /haiku/docs/user/locale/Country.dox (revision 0044a8c39ab5721051b6279506d1a8c511e20453)
1/*
2 * Copyright 2011, Haiku, Inc. All Rights Reserved.
3 * Distributed under the terms of the MIT License.
4 *
5 * Authors:
6 *		Axel Dörfler, axeld@pinc-software.de.
7 *		Adrien Destugues, pulkomandy@gmail.com.
8 *		John Scipione, jscipione@gmail.com
9 *
10 * Corresponds to:
11 *		/trunk/headers/os/locale/Country.h	 rev 42274
12 *		/trunk/src/kits/locale/Country.cpp	 rev 42274
13 */
14
15
16/*!	\file Country.h
17	\brief BCountry class definition.
18*/
19
20
21/*!	\class BCountry
22	\ingroup locale
23	\brief Class representing a country
24
25	BCountry provides all the information about a particular country.
26	This includes the country flag (as an HVIF icon), the localized name
27	of the country, and the ISO country code.
28
29	Date, time, and numer formatting also depends to some extent on the
30	language used, so they are found in the BLocale class instead.
31*/
32
33
34/*!
35	\fn BCountry::BCountry(const char* countryCode)
36	\brief Initialize a BCountry from a country code.
37
38	\param countryCode The country code to initialize from.
39*/
40
41
42/*!
43	\fn BCountry::BCountry(const BCountry& other)
44	\brief Initialize a BCountry from another BCountry object.
45
46	\param other The BCountry object to initialize from.
47*/
48
49
50/*!
51	\fn BCountry& BCountry::operator=(const BCountry& other)
52*/
53
54
55/*!
56	\fn BCountry::~BCountry()
57	\brief Destructor method.
58*/
59
60
61/*!
62	\fn bool BCountry::GetName(BString& name) const
63	\brief Get the name of the country.
64
65	Fills in the name parameter with the name of the country in the
66	language set by the user's locale.
67*/
68
69
70/*!
71	\fn const char* BCountry::Code() const
72	\brief Gets the ISO country code for the country.
73
74	\returns The ISO country code for the country.
75*/
76
77
78/*!
79	\fn status_t BCountry::GetIcon(BBitmap* result) const;
80	\brief Render the country's flag to the given BBitmap.
81
82	This function renders the country's flag to the given BBitmap. The bitmap
83	should already be set to the pixel format and size you want to use.
84
85	The flag is stored in HVIF format so it can be rendered at any size and
86	color depth.
87
88	\param result The BBitmap to drag the flag into.
89
90	\returns \c B_OK if the drawing was successful.
91*/
92