1 #ifndef CONTACT_CARD_LAYOUTER_H
2 #define CONTACT_CARD_LAYOUTER_H
5 * Copyright (c) 2016 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
24 #include <dali/public-api/common/intrusive-ptr.h>
25 #include <dali/public-api/math/vector2.h>
28 #include "contact-card-layout-info.h"
33 * @brief This class lays out contact cards on the screen appropriately.
35 * The contact cards are added to the stage directly and it uses the stage size to figure out exactly how to layout them.
36 * It supports a minimum of 3 items on each row or column.
38 * Relayouting is not supported.
40 class ContactCardLayouter
47 ContactCardLayouter();
52 ~ContactCardLayouter();
55 * @brief Creates a contact card with the given information.
56 * @param[in] contactName The name of the contact to display.
57 * @param[in] contactAddress The address of the contact to display.
58 * @param[in] imagePath The path to the image to display.
60 void AddContact( const std::string& contactName, const std::string& contactAddress, const std::string& imagePath );
65 * @brief Calculates the next position of the contact card that's about to be added to our container.
66 * @return A reference to the next position.
68 const Dali::Vector2& NextCardPosition();
70 ContactCardLayoutInfo mContactCardLayoutInfo; ///< The common layouting information used by all contact cards. Set up when AddContact is first called.
72 typedef Dali::IntrusivePtr< ContactCard > ContactCardPtr; ///< Better than raw pointers as these are ref counted and the memory is released when the count reduces to 0.
73 typedef std::vector< ContactCardPtr > ContactCardContainer;
74 ContactCardContainer mContactCards; ///< Contains all the contact cards.
76 Dali::Vector2 mLastPosition; ///< The last position a contact card was added.
77 Dali::Vector2 mPositionIncrementer; ///< Calculated once when AddContact is first called.
78 size_t mItemsPerRow; ///< Calculated once when AddContact is first called and stores the number of items we have in a row.
80 bool mInitialized; ///< Whether initialization has taken place or not.
85 #endif // CONTACT_CARD_LAYOUTER_H